Tutorialspoint examples

Learn java tutorial with examples for beginners online

Built-in Java Annotations


Dictionary meaning of Annotation

Annotation refers to a note by way of explanation or comment added to a text or diagram.

Java Annotations:

Java annotations are used to provide the meta data to our Java code. Meta data is the additional information which can be used for any class, interface, method or field. Java annotations can be used as an alternative option for XML and java marker interfaces. Java annotations were added to Java from Java 5.

Built-in Java Annotations:

Java provides three built-in annotations which are used to give certain instructions to the compiler. Built-in java annotations are as follows:

  • @Deprecated
  • @Override
  • @SuppressWarnings

@Deprecated java annotation:

The deprecated terms in software development is refers to classes, interfaces, functions or elements that are in the process of being replaced by newer ones. The @Deprecated java annotation signals that the marked element is deprecated and should no longer be used. It is better not to use deprecated methods because these methods can be removed from future versions.

Note: We can use @deprecated Javadoc tag in the comment section to inform the developers about the reason of deprecation and what can be used in place of this deprecated method, class or field.

package com.tutorialspointexamples;
 
class DerecatedTestClass{  
	void display(){
		System.out.println("Display Method.");
	}  
 
	/* 
	 * @deprecated replaced by display()
         */
	@Deprecated  
	void show(){
		System.out.println("Show Method is deprecated.");
	}  
}  
 
public class DeprecatedTest {
	public static void main(String args[]){
		DerecatedTestClass obj = new DerecatedTestClass();
		obj.show();
		obj.display();
	}
}

Output:

Show Method is deprecated.
Display Method.

Download this example.

@Override java annotation:

The @Override java annotation indicates that the subclass method is overriding the parent class method. Compile time error occurs if it not overrides the specified method. As override annotation is not mandatory to use while overriding the method so if we are not using override annotation it may be the case someone changed the name of the overridden method in the superclass. In that case subclass method would no longer override it. So we always have to use @Override annotation which signals the compiler that the method in the subclass is not overriding any method in the superclass.

package com.tutorialspointexamples;
 
class ParentClass{  
	void display(){
		System.out.println("Parent Class Display Method.");
	}  
}  
 
public class SubClass extends ParentClass{
	@Override
	void display(){
		System.out.println("Sub Class Display Method.");
	}
	public static void main(String args[]){
		SubClass obj = new SubClass();
		obj.display();
	}
}

Output:

Sub Class Display Method.

Download this example.

@SuppressWarningsjava annotation:

The deprecated terms in software development is refers to classes, interfaces, functions or elements that are in the process of being replaced by newer ones. The @Deprecated java annotation signals that the marked element is deprecated and should no longer be used. It is better not to use deprecated methods because these methods can be removed from future versions.

Note: We can use @deprecated Javadoc tag in the comment section to inform the developers about the reason of deprecation and what can be used in place of this deprecated method, class or field.

package com.tutorialspointexamples;
 
class DerecatedTestClass{  
	void display(){
		System.out.println("Display Method.");
	}  
 
	/* 
	 * @deprecated replaced by display()
     */
	@Deprecated  
	void show(){
		System.out.println("Show Method is deprecated.");
	}  
}  
 
public class SuppressWarningTest {
	@SuppressWarnings("deprecation")
	public static void main(String args[]){
		DerecatedTestClass obj = new DerecatedTestClass();
		obj.show();
		obj.display();
	}
}

Output:

Show Method is deprecated.
Display Method.

Download this example.

Download tutorialspointexamples Android App
Copyright © 2018 Tutorialspoint examples DMCA.com Protection Status