Intro to Java Annotations

An Introduction to Java Annotations

ByM. M. Islam ChistyOctober 14, 2005The objective of changing older JDK versions to JDK5 largely centered on enhancingease-of-development. In other words, the new features shift the responsibility for writing theboilerplate code from the programmer to the compiler. If the source code is boilerplate free, itbecomes easier to maintain. The resulting codes are also less likely to be bug-prone. One of thesenew ease-of-development features in JDK5 are annotations. Annotations are like meta-tags that youcan add to your code and apply them to package declarations, type declarations, constructors,methods, fields, parameters, and variables. As a result, you will have helpful ways to indicatewhether your methods are dependent on other methods, whether they are incomplete, whetheryour classes have references to other classes, and so on.Annotation-based development is certainly one of the latest Java development trends.Annotation-based development relieves Java developers from the pain of cumbersomeconfiguration. Quoting from Sun's official site, "It (annotation-based development) lets us avoidwriting boilerplate code under many circumstances by enabling tools to generate it from annotationsin the source code. This leads to a declarative programming style where the programmer says whatshould be done and tools emit the code to do it." Simply speaking, annotation is a mechanism forassociating a meta-tag with program elements and allowing the compiler or the VM to extractprogram behaviors from these annotated elements and generate interdependent codes whennecessary. In the first part of this three-article series, I'll describe some basics of annotation, theirbenefits, as well as some example usages.

The Basics

There are two things you need to consider with annotations. One is the "annotation" itself; anotheris the "annotation type." An annotation is the meta-tag that you will use in your code to give it somelife. Annotation type is used for defining an annotation. You will use it when you want to create yourown custom annotation. The type is the actual construct used, and the annotation is the specificusage of that type.An annotation type definition takes an "at" (@) sign, followed by the interface keyword plus theannotation name. On the other hand, an annotation takes the form of an "at" sign (@), followed bythe annotation type. This is simplest form of annotation. Additionally, you can put data withinparenthesis after the annotation name. An example of each can be seen below:

Example to Define an Annotation (Annotation type)

public @interface MyAnnotation {String doSomething();}

Example to Annotate Your Code (Annotation)

MyAnnotation (doSomething="What to do")public void mymethod() {....}

Annotation Types

There are three annotation types:

Marker:

Marker type annotations have no elements, except the annotation name itself.

Example:

public @interface MyAnnotation {}

Usage:

@MyAnnotationpublic void mymethod() {....}

Single-Element:

Single-element, or single-value type, annotations provide a single piece of data only. This can be represented with a data=value pair or, simply with the value (a shortcutsyntax) only, within parenthesis.

Example:

public @interface MyAnnotation{String doSomething();}

Usage:

@MyAnnotation ("What to do")public void mymethod() {....}

Full-value or multi-value:

Full-value type annotations have multiple data members.Therefore, you must use a full data=value parameter syntax for each member.

Example:

public @interface MyAnnotation {String doSomething();int count; String date();}

Usage:

@MyAnnotation (doSomething="What to do", count=1,date="09-09-2005")public void mymethod() {....}

Rules of Thumb for Defining Annotation Type

Here are some rules-of-thumb when defining an annotation type:Annotation declaration should start with an 'at' sign like @, following with an interfacekeyword, following with the annotation name.1.Method declarations should not have any parameters.2.Method declarations should not have any throws clauses.3.Return types of the method should be one of the following:primitivesStringClass4.

enumarray of the above types

Annotations

There are two types of annotations available with JDK5:

Simple annotations:

These are the basic types supplied with Tiger, which you can use toannotate your code only; you cannot use those to create a custom annotation type.

Meta annotations:

These are the annotation types designed for annotating annotation-typedeclarations. Simply speaking, these are called the annotations-of-annotations.

Category:	Uncategorized.
Rating:
Upload Date:	10/25/2009
Copyright:	Attribution Non-commercial
Tags:	This document has no tags.

Documents

People