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    *      http://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.juneau.annotation;
18  
19  import static org.apache.juneau.TestUtils.*;
20  import static org.apache.juneau.junit.bct.BctAssertions.*;
21  import static org.junit.jupiter.api.Assertions.*;
22  
23  import org.apache.juneau.*;
24  import org.junit.jupiter.api.*;
25  
26  class ExampleAnnotation_Test extends TestBase {
27  
28  	private static final String CNAME = ExampleAnnotation_Test.class.getName();
29  
30  	private static class X1 {}
31  
32  	//------------------------------------------------------------------------------------------------------------------
33  	// Basic tests
34  	//------------------------------------------------------------------------------------------------------------------
35  
36  	Example a1 = ExampleAnnotation.create()
37  		.description("a")
38  		.on("b")
39  		.onClass(X1.class)
40  		.value("c")
41  		.build();
42  
43  	Example a2 = ExampleAnnotation.create()
44  		.description("a")
45  		.on("b")
46  		.onClass(X1.class)
47  		.value("c")
48  		.build();
49  
50  	@Test void a01_basic() {
51  		assertBean(a1, "description,on,onClass,value", "[a],[b],[X1],c");
52  	}
53  
54  	@Test void a02_testEquivalency() {
55  		assertEquals(a2, a1);
56  		assertNotEqualsAny(a1.hashCode(), 0, -1);
57  		assertEquals(a1.hashCode(), a2.hashCode());
58  	}
59  
60  	//------------------------------------------------------------------------------------------------------------------
61  	// PropertyStore equivalency.
62  	//------------------------------------------------------------------------------------------------------------------
63  
64  	@Test void b01_testEquivalencyInPropertyStores() {
65  		var bc1 = BeanContext.create().annotations(a1).build();
66  		var bc2 = BeanContext.create().annotations(a2).build();
67  		assertSame(bc1, bc2);
68  	}
69  
70  	//------------------------------------------------------------------------------------------------------------------
71  	// Other methods.
72  	//------------------------------------------------------------------------------------------------------------------
73  
74  	public static class C1 {
75  		public int f1;
76  		public void m1() {}  // NOSONAR
77  	}
78  	public static class C2 {
79  		public int f2;
80  		public void m2() {}  // NOSONAR
81  	}
82  
83  	@Test void c01_otherMethods() throws Exception {
84  		var c1 = ExampleAnnotation.create(C1.class).on(C2.class).build();
85  		var c2 = ExampleAnnotation.create("a").on("b").build();
86  		var c3 = ExampleAnnotation.create().on(C1.class.getField("f1")).on(C2.class.getField("f2")).build();
87  		var c4 = ExampleAnnotation.create().on(C1.class.getMethod("m1")).on(C2.class.getMethod("m2")).build();
88  
89  		assertBean(c1, "on", "["+CNAME+"$C1,"+CNAME+"$C2]");
90  		assertBean(c2, "on", "[a,b]");
91  		assertBean(c3, "on", "["+CNAME+"$C1.f1,"+CNAME+"$C2.f2]");
92  		assertBean(c4, "on", "["+CNAME+"$C1.m1(),"+CNAME+"$C2.m2()]");
93  	}
94  
95  	//------------------------------------------------------------------------------------------------------------------
96  	// Comparison with declared annotations.
97  	//------------------------------------------------------------------------------------------------------------------
98  
99  	@Example(
100 		description={ "a" },
101 		on="b",
102 		onClass=X1.class,
103 		value="c"
104 	)
105 	public static class D1 {}
106 	Example d1 = D1.class.getAnnotationsByType(Example.class)[0];
107 
108 	@Example(
109 		description={ "a" },
110 		on="b",
111 		onClass=X1.class,
112 		value="c"
113 	)
114 	public static class D2 {}
115 	Example d2 = D2.class.getAnnotationsByType(Example.class)[0];
116 
117 	@Test void d01_comparisonWithDeclarativeAnnotations() {
118 		assertEqualsAll(a1, d1, d2);
119 		assertNotEqualsAny(a1.hashCode(), 0, -1);
120 		assertEqualsAll(a1.hashCode(), d1.hashCode(), d2.hashCode());
121 	}
122 }