View Javadoc
1   /*
2    * Licensed to the Apache Software Foundation (ASF) under one or more
3    * contributor license agreements.  See the NOTICE file distributed with
4    * this work for additional information regarding copyright ownership.
5    * The ASF licenses this file to You under the Apache License, Version 2.0
6    * (the "License"); you may not use this file except in compliance with
7    * the License.  You may obtain a copy of the License at
8    *
9    *      https://www.apache.org/licenses/LICENSE-2.0
10   *
11   * Unless required by applicable law or agreed to in writing, software
12   * distributed under the License is distributed on an "AS IS" BASIS,
13   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14   * See the License for the specific language governing permissions and
15   * limitations under the License.
16   */
17  package org.apache.commons.lang3;
18  
19  import static org.apache.commons.lang3.LangAssertions.assertNullPointerException;
20  import static org.junit.jupiter.api.Assertions.assertEquals;
21  import static org.junit.jupiter.api.Assertions.assertFalse;
22  import static org.junit.jupiter.api.Assertions.assertNotNull;
23  import static org.junit.jupiter.api.Assertions.assertTrue;
24  
25  import java.lang.reflect.Constructor;
26  import java.lang.reflect.Modifier;
27  
28  import org.junit.jupiter.api.Test;
29  
30  /**
31   */
32  class ClassPathUtilsTest extends AbstractLangTest {
33  
34      private static Package unnamedPackage() {
35          return new ClassLoader() {
36              Package defineUnnamedPackage() {
37                  return definePackage("", null, null, null, null, null, null, null);
38              }
39          }.defineUnnamedPackage();
40      }
41  
42      @Test
43      void testConstructor() {
44          assertNotNull(new ClassPathUtils());
45          final Constructor<?>[] cons = ClassPathUtils.class.getDeclaredConstructors();
46          assertEquals(1, cons.length);
47          assertTrue(Modifier.isPublic(cons[0].getModifiers()));
48          assertTrue(Modifier.isPublic(ClassPathUtils.class.getModifiers()));
49          assertFalse(Modifier.isFinal(ClassPathUtils.class.getModifiers()));
50      }
51  
52      @Test
53      void testPackageToPath() {
54          assertEquals("a", ClassPathUtils.packageToPath("a"));
55          assertEquals("a/b", ClassPathUtils.packageToPath("a.b"));
56          assertEquals("a/b/c", ClassPathUtils.packageToPath("a.b.c"));
57      }
58  
59      @Test
60      void testPathToPackage() {
61          assertEquals("a", ClassPathUtils.pathToPackage("a"));
62          assertEquals("a.b", ClassPathUtils.pathToPackage("a/b"));
63          assertEquals("a.b.c", ClassPathUtils.pathToPackage("a/b/c"));
64      }
65  
66      @Test
67      void testToFullyQualifiedNameArrayAndPrimitiveClass() throws ClassNotFoundException {
68          assertNullPointerException(() -> ClassPathUtils.toFullyQualifiedName(String[].class, "Test.properties"));
69          assertNullPointerException(() -> ClassPathUtils.toFullyQualifiedName(int.class, "Test.properties"));
70          assertNullPointerException(() -> ClassPathUtils.toFullyQualifiedName(void.class, "Test.properties"));
71          assertNullPointerException(() -> ClassPathUtils.toFullyQualifiedName(int[].class, "Test.properties"));
72          final Class<?> unnamedPackageArray = Class.forName("[LClassPathUtilsDefaultPackage;");
73          assertNullPointerException(() -> ClassPathUtils.toFullyQualifiedName(unnamedPackageArray, "Test.properties"));
74      }
75  
76      @Test
77      void testToFullyQualifiedNameClassNull() {
78          assertNullPointerException(() -> ClassPathUtils.toFullyQualifiedName(ClassPathUtils.class, null));
79      }
80  
81      @Test
82      void testToFullyQualifiedNameClassString() {
83          final String expected = "org.apache.commons.lang3.Test.properties";
84          final String actual = ClassPathUtils.toFullyQualifiedName(ClassPathUtils.class, "Test.properties");
85  
86          assertEquals(expected, actual);
87      }
88  
89      @Test
90      void testToFullyQualifiedNameNullClassString() {
91          assertNullPointerException(
92                  () -> ClassPathUtils.toFullyQualifiedName((Class<?>) null, "Test.properties"));
93      }
94  
95      @Test
96      void testToFullyQualifiedNameNullPackageString() {
97          assertNullPointerException(
98                  () -> ClassPathUtils.toFullyQualifiedName((Package) null, "Test.properties"));
99      }
100 
101     @Test
102     void testToFullyQualifiedNamePackageNull() {
103         assertNullPointerException(
104                 () -> ClassPathUtils.toFullyQualifiedName(ClassPathUtils.class.getPackage(), null));
105     }
106 
107     @Test
108     void testToFullyQualifiedNamePackageString() {
109         final String expected = "org.apache.commons.lang3.Test.properties";
110         final String actual = ClassPathUtils.toFullyQualifiedName(ClassPathUtils.class.getPackage(), "Test.properties");
111 
112         assertEquals(expected, actual);
113     }
114 
115     @Test
116     void testToFullyQualifiedNameUnnamedPackage() {
117         assertEquals("Test.properties", ClassPathUtils.toFullyQualifiedName(unnamedPackage(), "Test.properties"));
118     }
119 
120     @Test
121     void testToFullyQualifiedNameUnnamedPackageClass() throws ClassNotFoundException {
122         assertEquals("Test.properties", ClassPathUtils.toFullyQualifiedName(
123                 Class.forName("ClassPathUtilsDefaultPackage"), "Test.properties"));
124     }
125 
126     @Test
127     void testToFullyQualifiedNameUnnamedPackageClassEmptyResource() throws ClassNotFoundException {
128         assertEquals("", ClassPathUtils.toFullyQualifiedName(Class.forName("ClassPathUtilsDefaultPackage"), ""));
129     }
130 
131     @Test
132     void testToFullyQualifiedNameUnnamedPackageClassNullResource() throws ClassNotFoundException {
133         final Class<?> context = Class.forName("ClassPathUtilsDefaultPackage");
134         assertNullPointerException(() -> ClassPathUtils.toFullyQualifiedName(context, null));
135     }
136 
137     @Test
138     void testToFullyQualifiedNameUnnamedPackageEmptyResource() {
139         assertEquals("", ClassPathUtils.toFullyQualifiedName(unnamedPackage(), ""));
140     }
141 
142     @Test
143     void testToFullyQualifiedNameUnnamedPackageNullResource() {
144         assertNullPointerException(() -> ClassPathUtils.toFullyQualifiedName(unnamedPackage(), null));
145     }
146 
147     @Test
148     void testToFullyQualifiedPathArrayAndPrimitiveClass() throws ClassNotFoundException {
149         assertNullPointerException(() -> ClassPathUtils.toFullyQualifiedPath(String[].class, "Test.properties"));
150         assertNullPointerException(() -> ClassPathUtils.toFullyQualifiedPath(int.class, "Test.properties"));
151         assertNullPointerException(() -> ClassPathUtils.toFullyQualifiedPath(void.class, "Test.properties"));
152         assertNullPointerException(() -> ClassPathUtils.toFullyQualifiedPath(int[].class, "Test.properties"));
153         final Class<?> unnamedPackageArray = Class.forName("[LClassPathUtilsDefaultPackage;");
154         assertNullPointerException(() -> ClassPathUtils.toFullyQualifiedPath(unnamedPackageArray, "Test.properties"));
155     }
156 
157     @Test
158     void testToFullyQualifiedPathClass() {
159         final String expected = "org/apache/commons/lang3/Test.properties";
160         final String actual = ClassPathUtils.toFullyQualifiedPath(ClassPathUtils.class, "Test.properties");
161 
162         assertEquals(expected, actual);
163     }
164 
165     @Test
166     void testToFullyQualifiedPathClassNull() {
167         assertNullPointerException(() -> ClassPathUtils.toFullyQualifiedPath(ClassPathUtils.class, null));
168     }
169 
170     @Test
171     void testToFullyQualifiedPathClassNullString() {
172         assertNullPointerException(
173                 () -> ClassPathUtils.toFullyQualifiedPath((Class<?>) null, "Test.properties"));
174     }
175 
176     @Test
177     void testToFullyQualifiedPathPackage() {
178         final String expected = "org/apache/commons/lang3/Test.properties";
179         final String actual = ClassPathUtils.toFullyQualifiedPath(ClassPathUtils.class.getPackage(), "Test.properties");
180 
181         assertEquals(expected, actual);
182     }
183 
184     @Test
185     void testToFullyQualifiedPathPackageNull() {
186         assertNullPointerException(
187                 () -> ClassPathUtils.toFullyQualifiedPath(ClassPathUtils.class.getPackage(), null));
188     }
189 
190     @Test
191     void testToFullyQualifiedPathPackageNullString() {
192         assertNullPointerException(
193                 () -> ClassPathUtils.toFullyQualifiedPath((Package) null, "Test.properties"));
194     }
195 
196     @Test
197     void testToFullyQualifiedPathUnnamedPackage() {
198         assertEquals("Test.properties", ClassPathUtils.toFullyQualifiedPath(unnamedPackage(), "Test.properties"));
199     }
200 
201     @Test
202     void testToFullyQualifiedPathUnnamedPackageClass() throws ClassNotFoundException {
203         assertEquals("Test.properties", ClassPathUtils.toFullyQualifiedPath(
204                 Class.forName("ClassPathUtilsDefaultPackage"), "Test.properties"));
205     }
206 
207     @Test
208     void testToFullyQualifiedPathUnnamedPackageClassEmptyResource() throws ClassNotFoundException {
209         assertEquals("", ClassPathUtils.toFullyQualifiedPath(Class.forName("ClassPathUtilsDefaultPackage"), ""));
210     }
211 
212     @Test
213     void testToFullyQualifiedPathUnnamedPackageClassNullResource() throws ClassNotFoundException {
214         final Class<?> context = Class.forName("ClassPathUtilsDefaultPackage");
215         assertNullPointerException(() -> ClassPathUtils.toFullyQualifiedPath(context, null));
216     }
217 
218     @Test
219     void testToFullyQualifiedPathUnnamedPackageEmptyResource() {
220         assertEquals("", ClassPathUtils.toFullyQualifiedPath(unnamedPackage(), ""));
221     }
222 
223     @Test
224     void testToFullyQualifiedPathUnnamedPackageNullResource() {
225         assertNullPointerException(() -> ClassPathUtils.toFullyQualifiedPath(unnamedPackage(), null));
226     }
227 }