Clover Coverage Report - FEST Reflection 1.2
Coverage timestamp: Tue Nov 24 2009 20:12:25 PST
Overview   Package   File
    FRAMES   NO FRAMES     
../../../../img/srcFileCovDistChart10.png 0% of files have more coverage
8   198   8   1
0   29   1   8
8     1  
1    
5.9% of code in this file is excluded from these metrics.
 
  Reflection       Line # 123 8 5.9% 8 0 100% 1.0
 
No Tests
 
1    /*
2    * Created on Oct 31, 2006
3    *
4    * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with
5    * the License. You may obtain a copy of the License at
6    *
7    * http://www.apache.org/licenses/LICENSE-2.0
8    *
9    * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
10    * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
11    * specific language governing permissions and limitations under the License.
12    *
13    * Copyright @2006-2009 the original author or authors.
14    */
15    package org.fest.reflect.core;
16   
17    import static org.fest.reflect.beanproperty.PropertyName.startPropertyAccess;
18    import static org.fest.reflect.constructor.TargetType.startConstructorAccess;
19    import static org.fest.reflect.field.FieldName.beginFieldAccess;
20    import static org.fest.reflect.field.StaticFieldName.beginStaticFieldAccess;
21    import static org.fest.reflect.innerclass.StaticInnerClassName.startStaticInnerClassAccess;
22    import static org.fest.reflect.method.MethodName.startMethodAccess;
23    import static org.fest.reflect.method.StaticMethodName.startStaticMethodAccess;
24    import static org.fest.reflect.type.Type.newType;
25   
26    import org.fest.reflect.beanproperty.PropertyName;
27    import org.fest.reflect.beanproperty.PropertyType;
28    import org.fest.reflect.constructor.TargetType;
29    import org.fest.reflect.field.*;
30    import org.fest.reflect.innerclass.StaticInnerClassName;
31    import org.fest.reflect.method.*;
32    import org.fest.reflect.method.Invoker;
33    import org.fest.reflect.reference.TypeRef;
34    import org.fest.reflect.type.Type;
35   
36    /**
37    * Understands the entry point for the classes in this package.
38    * The following is an example of proper usage of the classes in this package:
39    * <pre>
40    * // Loads the class 'org.republic.Jedi'
41    * Class&lt;?&gt; jediType = {@link org.fest.reflect.core.Reflection#type(String) type}("org.republic.Jedi").{@link Type#load() load}();
42    *
43    * // Loads the class 'org.republic.Jedi' as 'org.republic.Person' (Jedi extends Person)
44    * Class&lt;Person&gt; jediType = {@link org.fest.reflect.core.Reflection#type(String) type}("org.republic.Jedi").{@link Type#loadAs(Class) loadAs}(Person.class);
45    *
46    * // Loads the class 'org.republic.Jedi' using a custom class loader
47    * Class&lt;?&gt; jediType = {@link org.fest.reflect.core.Reflection#type(String) type}("org.republic.Jedi").{@link Type#withClassLoader(ClassLoader) withClassLoader}(myClassLoader).{@link org.fest.reflect.type.TypeLoader#load() load}();
48    *
49    * // Gets the inner class 'Master' in the declaring class 'Jedi':
50    * Class&lt;?&gt; masterClass = {@link org.fest.reflect.core.Reflection#staticInnerClass(String) staticInnerClass}("Master").{@link org.fest.reflect.innerclass.StaticInnerClassName#in(Class) in}(Jedi.class).{@link org.fest.reflect.innerclass.Invoker#get() get}();
51    *
52    * // Equivalent to call 'new Person()'
53    * Person p = {@link org.fest.reflect.core.Reflection#constructor() constructor}().{@link TargetType#in in}(Person.class).{@link org.fest.reflect.constructor.Invoker#newInstance(Object...) newInstance}();
54    *
55    * // Equivalent to call 'new Person("Yoda")'
56    * Person p = {@link org.fest.reflect.core.Reflection#constructor() constructor}().{@link TargetType#withParameterTypes(Class...) withParameterTypes}(String.class).{@link org.fest.reflect.constructor.ParameterTypes#in(Class) in}(Person.class).{@link org.fest.reflect.constructor.Invoker#newInstance(Object...) newInstance}("Yoda");
57    *
58    * // Retrieves the value of the field "name"
59    * String name = {@link org.fest.reflect.core.Reflection#field(String) field}("name").{@link org.fest.reflect.field.FieldName#ofType(Class) ofType}(String.class).{@link org.fest.reflect.field.FieldType#in(Object) in}(person).{@link org.fest.reflect.field.Invoker#get() get}();
60    *
61    * // Sets the value of the field "name" to "Yoda"
62    * {@link org.fest.reflect.core.Reflection#field(String) field}("name").{@link org.fest.reflect.field.FieldName#ofType(Class) ofType}(String.class).{@link org.fest.reflect.field.FieldType#in(Object) in}(person).{@link org.fest.reflect.field.Invoker#set(Object) set}("Yoda");
63    *
64    * // Retrieves the value of the field "powers"
65    * List&lt;String&gt; powers = {@link org.fest.reflect.core.Reflection#field(String) field}("powers").{@link FieldName#ofType(TypeRef) ofType}(new {@link TypeRef TypeRef}&lt;List&lt;String&gt;&gt;() {}).{@link FieldTypeRef#in(Object) in}(jedi).{@link org.fest.reflect.field.Invoker#get() get}();
66    *
67    * // Equivalent to call 'person.setName("Luke")'
68    * {@link org.fest.reflect.core.Reflection#method(String) method}("setName").{@link org.fest.reflect.method.MethodName#withParameterTypes(Class...) withParameterTypes}(String.class)
69    * .{@link org.fest.reflect.method.MethodParameterTypes#in(Object) in}(person)
70    * .{@link org.fest.reflect.method.Invoker#invoke(Object...) invoke}("Luke");
71    *
72    * // Equivalent to call 'jedi.getPowers()'
73    * List&lt;String&gt; powers = {@link org.fest.reflect.core.Reflection#method(String) method}("getPowers").{@link MethodName#withReturnType(TypeRef) withReturnType}(new {@link TypeRef TypeRef}&lt;List&lt;String&gt;&gt;() {})
74    * .{@link MethodReturnTypeRef#in(Object) in}(person)
75    * .{@link Invoker#invoke(Object...) invoke}();
76    *
77    * // Retrieves the value of the static field "count" in Person.class
78    * int count = {@link org.fest.reflect.core.Reflection#staticField(String) staticField}("count").{@link StaticFieldName#ofType(Class) ofType}(int.class).{@link StaticFieldType#in(Class) in}(Person.class).{@link org.fest.reflect.field.Invoker#get() get}();
79    *
80    * // Sets the value of the static field "count" to 3 in Person.class
81    * {@link org.fest.reflect.core.Reflection#staticField(String) staticField}("count").{@link StaticFieldName#ofType(Class) ofType}(int.class).{@link StaticFieldType#in(Class) in}(Person.class).{@link org.fest.reflect.field.Invoker#set(Object) set}(3);
82    *
83    * // Retrieves the value of the static field "commonPowers" in Jedi.class
84    * List&lt;String&gt; commmonPowers = {@link org.fest.reflect.core.Reflection#staticField(String) staticField}("commonPowers").{@link StaticFieldName#ofType(TypeRef) ofType}(new {@link TypeRef TypeRef}&lt;List&lt;String&gt;&gt;() {}).{@link StaticFieldTypeRef#in(Class) in}(Jedi.class).{@link org.fest.reflect.field.Invoker#get() get}();
85    *
86    * // Equivalent to call 'person.concentrate()'
87    * {@link org.fest.reflect.core.Reflection#method(String) method}("concentrate").{@link org.fest.reflect.method.MethodName#in(Object) in}(person).{@link org.fest.reflect.method.Invoker#invoke(Object...) invoke}();
88    *
89    * // Equivalent to call 'person.getName()'
90    * String name = {@link org.fest.reflect.core.Reflection#method(String) method}("getName").{@link org.fest.reflect.method.MethodName#withReturnType(Class) withReturnType}(String.class)
91    * .{@link org.fest.reflect.method.MethodReturnType#in(Object) in}(person)
92    * .{@link org.fest.reflect.method.Invoker#invoke(Object...) invoke}();
93    *
94    * // Equivalent to call 'Jedi.setCommonPower("Jump")'
95    * {@link org.fest.reflect.core.Reflection#staticMethod(String) staticMethod}("setCommonPower").{@link org.fest.reflect.method.StaticMethodName#withParameterTypes(Class...) withParameterTypes}(String.class)
96    * .{@link org.fest.reflect.method.StaticMethodParameterTypes#in(Class) in}(Jedi.class)
97    * .{@link org.fest.reflect.method.Invoker#invoke(Object...) invoke}("Jump");
98    *
99    * // Equivalent to call 'Jedi.addPadawan()'
100    * {@link org.fest.reflect.core.Reflection#staticMethod(String) staticMethod}("addPadawan").{@link org.fest.reflect.method.StaticMethodName#in(Class) in}(Jedi.class).{@link org.fest.reflect.method.Invoker#invoke(Object...) invoke}();
101    *
102    * // Equivalent to call 'Jedi.commonPowerCount()'
103    * String name = {@link org.fest.reflect.core.Reflection#staticMethod(String) staticMethod}("commonPowerCount").{@link org.fest.reflect.method.StaticMethodName#withReturnType(Class) withReturnType}(String.class)
104    * .{@link org.fest.reflect.method.StaticMethodReturnType#in(Class) in}(Jedi.class)
105    * .{@link org.fest.reflect.method.Invoker#invoke(Object...) invoke}();
106    *
107    * // Equivalent to call 'Jedi.getCommonPowers()'
108    * List&lt;String&gt; powers = {@link org.fest.reflect.core.Reflection#staticMethod(String) staticMethod}("getCommonPowers").{@link StaticMethodName#withReturnType(TypeRef) withReturnType}(new {@link TypeRef TypeRef}&lt;List&lt;String&gt;&gt;() {})
109    * .{@link StaticMethodReturnTypeRef#in(Class) in}(Jedi.class)
110    * .{@link Invoker#invoke(Object...) invoke}();
111    *
112    * // Retrieves the value of the property "name"
113    * String name = {@link org.fest.reflect.core.Reflection#property(String) property}("name").{@link PropertyName#ofType(Class) ofType}(String.class).{@link PropertyType#in(Object) in}(person).{@link org.fest.reflect.beanproperty.Invoker#get() get}();
114    *
115    * // Sets the value of the property "name" to "Yoda"
116    * {@link org.fest.reflect.core.Reflection#property(String) property}("name").{@link PropertyName#ofType(Class) ofType}(String.class).{@link PropertyType#in(Object) in}(person).{@link org.fest.reflect.beanproperty.Invoker#set(Object) set}("Yoda");
117    * </pre>
118    * </p>
119    *
120    * @author Alex Ruiz
121    * @author Yvonne Wang
122    */
 
123    public final class Reflection {
124   
125    /**
126    * Starting point of the fluent interface for loading a class dynamically.
127    * @param name the name of the class to load.
128    * @return the starting point of the method chain.
129    * @throws NullPointerException if the given name is <code>null</code>.
130    * @throws IllegalArgumentException if the given name is empty.
131    * @since 1.1
132    */
 
133  1 toggle public static Type type(String name) { return newType(name); }
134   
135    /**
136    * Starting point of the fluent interface for accessing static inner class via reflection.
137    * @param name the name of the static inner class to access.
138    * @return the starting point of the method chain.
139    * @throws NullPointerException if the given name is <code>null</code>.
140    * @throws IllegalArgumentException if the given name is empty.
141    * @since 1.1
142    */
 
143  1 toggle public static StaticInnerClassName staticInnerClass(String name) { return startStaticInnerClassAccess(name); }
144   
145    /**
146    * Starting point of the fluent interface for accessing fields via reflection.
147    * @param name the name of the field to access.
148    * @return the starting point of the method chain.
149    * @throws NullPointerException if the given name is <code>null</code>.
150    * @throws IllegalArgumentException if the given name is empty.
151    */
 
152  2 toggle public static FieldName field(String name) { return beginFieldAccess(name); }
153   
154    /**
155    * Starting point of the fluent interface for accessing static fields via reflection.
156    * @param name the name of the static field to access.
157    * @return the starting point of the method chain.
158    * @throws NullPointerException if the given name is <code>null</code>.
159    * @throws IllegalArgumentException if the given name is empty.
160    */
 
161  1 toggle public static StaticFieldName staticField(String name) { return beginStaticFieldAccess(name); }
162   
163    /**
164    * Starting point of the fluent interface for invoking methods via reflection.
165    * @param name the name of the method to invoke.
166    * @return the starting point of the method chain.
167    * @throws NullPointerException if the given name is <code>null</code>.
168    * @throws IllegalArgumentException if the given name is empty.
169    */
 
170  3 toggle public static MethodName method(String name) { return startMethodAccess(name); }
171   
172    /**
173    * Starting point of the fluent interface for invoking static methods via reflection.
174    * @param name the name of the static method to invoke.
175    * @return the starting point of the static method chain.
176    * @throws NullPointerException if the given name is <code>null</code>.
177    * @throws IllegalArgumentException if the given name is empty.
178    */
 
179  1 toggle public static StaticMethodName staticMethod(String name) { return startStaticMethodAccess(name); }
180   
181    /**
182    * Starting point of the fluent interface for invoking constructors via reflection.
183    * @return the starting point of the method chain.
184    */
 
185  3 toggle public static TargetType constructor() { return startConstructorAccess(); }
186   
187    /**
188    * Starting point of the fluent interface for accessing properties via Bean Instrospection.
189    * @param name the name of the property to access.
190    * @return the starting point of the method chain.
191    * @throws NullPointerException if the given name is <code>null</code>.
192    * @throws IllegalArgumentException if the given name is empty.
193    * @since 1.2
194    */
 
195  1 toggle public static PropertyName property(String name) { return startPropertyAccess(name); }
196   
 
197    toggle private Reflection() {}
198    }
 
CloverReport generated by Clover Code Coverage v2.6.3
Tue Nov 24 2009 20:13:57 PST.		   Clover: Open Source License registered to FEST (Fixtures for Easy Software Testing) .