Java Reflection API

Java Reflection is a process of examining or modifying the run time behavior of a class at run time

The java.lang.Class class provides many methods that can be used to get metadata, examine and change the run time behavior of a class.

The java.lang and java.lang.reflect packages provide classes for java reflection

The java.lang.Class class performs mainly two tasks:

• provides methods to get the metadata of a class at run time.
• provides methods to examine and change the run time behavior of a class.

How to get the object of Class class?

There are 3 ways to get the instance of Class class. They are as follows:

• forName() method of Class class
• getClass() method of Object class
• the .class syntax

1) forName() method of Class class

• is used to load the class dynamically.
• returns the instance of Class class.
• It should be used if you know the fully qualified name of class.This cannot be used for primitive types.

Let's see the simple example of forName() method.

1. class Simple{}  
2.   
3. class Test{  
4.  public static void main(String args[]){  
5.   Class c=Class.forName("Simple");  
6.   System.out.println(c.getName());  
7.  }  
8. }  

Simple

---

2) getClass() method of Object class

It returns the instance of Class class. It should be used if you know the type. Moreover, it can be used with primitives.

1. class Simple{}  
2.   
3. class Test{  
4.   void printName(Object obj){  
5.   Class c=obj.getClass();    
6.   System.out.println(c.getName());  
7.   }  
8.   public static void main(String args[]){  
9.    Simple s=new Simple();  
10.    
11.    Test t=new Test();  
12.    t.printName(s);  
13.  }  
14. }  
15.    

Simple

---

3) The .class syntax

If a type is available but there is no instance then it is possible to obtain a Class by appending ".class" to the name of the type.It can be used for primitive data type also.

1. class Test{  
2.   public static void main(String args[]){  
3.    Class c = boolean.class;   
4.    System.out.println(c.getName());  
5.   
6.    Class c2 = Test.class;   
7.    System.out.println(c2.getName());  
8.  }  
9. }  

       boolean
       Test

---

Determining the class object

Following methods of Class class is used to determine the class object:

1) public boolean isInterface(): determines if the specified Class object represents an interface type.

2) public boolean isArray(): determines if this Class object represents an array class.

3) public boolean isPrimitive(): determines if the specified Class object represents a primitive type.

Let's see the simple example of reflection api to determine the object type.

1. class Simple{}  
2. interface My{}  
3.   
4. class Test{  
5.  public static void main(String args[]){  
6.   try{  
7.    Class c=Class.forName("Simple");  
8.    System.out.println(c.isInterface());  
9.      
10.    Class c2=Class.forName("My");  
11.    System.out.println(c2.isInterface());  
12.     
13.   }catch(Exception e){System.out.println(e);}  
14.   
15.  }  
16. }  

 false
 true

Commonly used methods of Class class:

Method	Description
1) public String getName()	returns the class name
2) public static Class forName(String className)throws ClassNotFoundException	loads the class and returns the reference of Class class.
3) public Object newInstance()throws InstantiationException,IllegalAccessException	creates new instance.
4) public boolean isInterface()	checks if it is interface.
5) public boolean isArray()	checks if it is array.
6) public boolean isPrimitive()	checks if it is primitive.
7) public Class getSuperclass()	returns the superclass class reference.
8) public Field[] getDeclaredFields()throws SecurityException	returns the total number of fields of this class.
9) public Method[] getDeclaredMethods()throws SecurityException	returns the total number of methods of this class.
10) public Constructor[] getDeclaredConstructors()throws SecurityException	returns the total number of constructors of this class.
11) public Method getDeclaredMethod(String name,Class[] parameterTypes)throws NoSuchMethodException,SecurityException	returns the method class instance.

newInstance() method

The newInstance() method of Class class and Constructor class is used to create a new instance of the class.

The newInstance() method of Class class can invoke zero-argument constructor whereas newInstance() method of Constructor class can invoke any number of arguments. So Constructor class is preferred over Class class.

Syntax of newInstance() method of Class class

public T newInstance()throws InstantiationException,IllegalAccessException

Here T is the generic version. We can think it like Object class

Example of newInstance() method

Let's see the simple example to use newInstance() method.

1. class Simple{  
2.  void message(){System.out.println("Hello Java");}  
3. }  
4.   
5. class Test{  
6.  public static void main(String args[]){  
7.   try{  
8.   Class c=Class.forName("Simple");  
9.   Simple s=(Simple)c.newInstance();  
10.   s.message();  
11.   
12.   }catch(Exception e){System.out.println(e);}  
13.   
14.  }  
15. }  

Output:Hello java