Define your own Annotation Type

Michał Kuklis — Sat, 25 Oct 2008 05:13:40 +0000

I’ve been using build-in Java annotation types (like @Overrides or @Deprecated) and those created by different vendors/services for a while now but I’ve never built my own. Here is an example of how you can define very simple annotation type and use it:

 
import java.lang.annotation.Retention;
 
public @interface SimpleMessageAnnotation {
     public String message();
}

As you can see a declaration of the new annotation type is very similar to the Java interface declaration (add ‘@’ symbol in front of the interface) There are some additional rules you have to follow:

Method declarations should not have any parameters
Method declarations should not have any throws clauses
Return types of the method should be one of the following:
primitives, String, Class, enum, array of the above types

In order to annotate a class with the new type you can write:

 
@SimpleMessageAnnotation(message = "hello world!!!")
public class TestAnnotation {
 
}

Now in order to access the message value during the runtime we can use reflection API. Before we can do that we need to change the RetentionPolicy of our new annotation type to RUNTIME. We can do it by adding Retention annotation to our SimpleMessageAnnotation:

 
import java.lang.annotation.Retention;
import static java.lang.annotation.RetentionPolicy.RUNTIME;
 
@Retention(RUNTIME)
public @interface SimpleMessageAnnotation {
     public String message();
}

This will inform the compiler about the new policy. There are 3 policies which can be used by the compiler (default is CLASS):

SOURCE—Annotations are to be discarded by the compiler.
CLASS—Annotations are to be recorded in the class file by the compiler but need not be retained by the VM at runtime. This is the default behavior.
RUNTIME—Annotations are to be recorded in the class file by the compiler and retained by the VM at runtime, so they may be read reflectively.

Now by using reflection API we can access our message value like this:

public class Run {
 
	public static void main(String[] args) {
 
		Class<TestAnnotation> clazz = TestAnnotation.class;
		System.out.println(clazz.getAnnotation(SimpleMessageAnnotation.class).message());
 
	}
}

What can be annotated?

package
class ( including interface, enum)
method
field
local variable, formal parameter (compile time only)

FLEX + SPRING + IBATIS + CAIRNGORM

Michał Kuklis — Tue, 29 May 2007 20:31:28 +0000

Chris Giametta wrote about how to connect all of the above together.

update:
Christophe Coenraets shows how to use flex with Spring here
Peter Martin describes how to deploy flex on WebSphere here

Make Ant easy with Eclipse

Michał Kuklis — Tue, 13 Feb 2007 02:05:44 +0000

I found this nice article about Ant in Eclipse.

MyFunnyDev » Java

SCJA and SCJP

SCJA

SCJP

Define your own Annotation Type

FLEX + SPRING + IBATIS + CAIRNGORM

Make Ant easy with Eclipse