Admin: 1 версия

2010-06-01T05:06:46Z

1 версия

в 17:44, 31 мая 2010

2010-05-31T17:44:27Z

Новая страница

== A demo for SuppressWarnings: unchecked and fallthrough warnings ==

Uses the SuppressWarnings annotation type to prevent the compiler from issuing unchecked and fallthrough warnings



<source lang="java">
import java.io.File;
import java.io.Serializable;
import java.util.ArrayList;
@SuppressWarnings (value={"unchecked", "serial"})
public class SuppressWarningsTest implements Serializable {
public void openFile () {
ArrayList a = new ArrayList ();
File file = new File ("X:/java/doc.txt");
}
}</source>



== Documented ==

<OL><LI>Documented is a marker annotation type used to annotate the declaration of an annotation type so that instances of the annotation type will be included in the documentation.</LI><LI>Override annotation type is not annotated using Documented.</LI><LI>Deprecated annotation type is annotated @Documented.</LI></OL>

== How do I mark method as deprecated? ==



<source lang="java">
import java.util.Calendar;
import java.util.Date;
public class Main {
public static void main(String[] args) {
getDate();
getMonthFromDate();
}
/**
* Get current system date.
*
* @return current system date.
* @deprecated This method will removed in the near future.
*/
@Deprecated
public static Date getDate() {
return new Date();
}
public static int getMonthFromDate() {
return Calendar.getInstance().get(Calendar.MONTH);
}
}</source>



== Inherited ==

<OL><LI>Use Inherited to annotate an annotation type, any instance of the annotation type will be inherited.</LI><LI>Use Inherited to annotate a class, the annotation will be inherited by any subclass of the annotated class. If the user queries the annotation type on a class declaration, and the class declaration has no annotation of this type, then the class"s parent class will automatically be queried for the annotation type. This process will be repeated until an annotation of this type is found or the root class is reached.</LI></OL>

== Insert an annotation to suppress warning ==



<source lang="java">
import java.util.ArrayList;
import java.util.Iterator;
public class Main {
@SuppressWarnings("unchecked")
public static void main(String[] args) {
ArrayList data = new ArrayList();
data.add("hello");
data.add("world");
Iterator it = data.iterator();
while (it.hasNext()) {
System.out.println(it.next());
}
}
}</source>



== Retention ==

<OL><LI>@Retention indicates how long annotations whose annotated types are annotated @Retention are to be retained.</LI><LI>The value of @Retention can be one of the members of the java.lang.annotation.RetentionPolicy enum:</LI></OL>
<OL><LI>SOURCE. Annotations are to be discarded by the Java compiler.</LI><LI>CLASS. Annotations are to be recorded in the class file but not be retained by the JVM. This is the default value.</LI><LI>RUNTIME. Annotations are to be retained by the JVM so you can query them using reflection.</LI></OL>



<source lang="java">
@Retention(value=SOURCE)
public @interface SuppressWarnings</source>



== Standard Annotations: Deprecated ==

Deprecated is a marker annotation type that can be applied to a method or a type (class/interface) to indicate that the method or type is deprecated.
Deprecating a method:



<source lang="java">
public class DeprecatedTest {
@Deprecated
public void serve() {
}
}</source>



== Standard Annotations: Override ==

Override is a marker annotation type that can be applied to a method to indicate to the compiler that the method overrides a method in a superclass.
This annotation type guards the programmer against making a mistake when overriding a method.
For example, consider this class Parent:



<source lang="java">
class Parent {
public float calculate (float a, float b) {
return a * b;
}
}
Whenever you want to override a method, declare the Override annotation type before the method:
public class Child extends Parent {
@Override
public int calculate (int a, int b) {
return (a + 1) * b;
}
}</source>



== Standard Annotations: SuppressWarnings ==

SuppressWarnings is used to suppress compiler warnings.
You can apply @SuppressWarnings to types, constructors, methods, fields, parameters, and local variables.
The following are valid parameters to @SuppressWarnings:
<OL><LI>unchecked. Give more detail for unchecked conversion.</LI><LI>path. Warn about nonexistent path (classpath, sourcepath, etc) directories.</LI><LI>serial. Warn about missing serialVersionUID definitions on serializable classes.</LI><LI>finally. Warn about finally clauses that cannot complete normally.</LI><LI>fallthrough. Check switch blocks for fall-through cases.</LI></OL>



<source lang="java">
switch (i) {
case 1:
System.out.println("1");
break;
case 2:
System.out.println ("2");
// falling through
case 3:
System.out.println ("3");
}</source>



== Standard Meta-Annotations ==

<OL><LI>Meta annotations are annotations that are applied to annotations.</LI><LI>There are four meta-annotation types: Documented, Inherited, Retention, and Target.</LI><LI>All the four are part of the java.lang.annotation package.</LI></OL>

== Target ==

Target indicates which program element(s) can be annotated using instances of the annotated annotation type.
The value of Target is one of the members of the java.lang.annotation.ElementType enum:
<OL><LI>ANNOTATION_TYPE. The annotated annotation type can be used to annotate annotation type declaration.</LI><LI>CONSTRUCTOR. The annotated annotation type can be used to annotate constructor declaration.</LI><LI>FIELD. The annotated annotation type can be used to annotate field declaration.</LI><LI>LOCAL_VARIABLE. The annotated annotation type can be used to annotate local variable declaration.</LI><LI>METHOD. The annotated annotation type can be used to annotate method declaration.</LI><LI>PACKAGE. The annotated annotation type can be used to annotate package declarations.</LI><LI>PARAMETER. The annotated annotation type can be used to annotate parameter declarations.</LI><LI>TYPE. The annotated annotation type can be used to annotate type declarations.</LI></OL>



<source lang="java">
@Target(value=METHOD)</source>



You can have multiple values in the Target annotation.
@Target(value={TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE})

== The Built-In Annotations ==


<OL><LI>Java defines seven built-in annotations.</LI><LI>Four are imported from java.lang.annotation: @Retention, @Documented, @Target, and @Inherited.</LI><LI>Three, @Override, @Deprecated, and @SuppressWarnings, are included in java.lang.</LI></OL>

== Use Override annotation ==



<source lang="java">
public class Main {
private String field;
private String attribute;
@Override
public int hashCode() {
return field.hashCode() + attribute.hashCode();
}
@Override
public String toString() {
return field + " " + attribute;
}
}</source>



== What is SuppressWarnings annotation? ==



<source lang="java">
import java.util.Date;

public class Main {
@SuppressWarnings(value={"deprecation"})
public static void main(String[] args) {
Date date = new Date(2009, 9, 30);

System.out.println("date = " + date);
}
}</source>

← Предыдущая	Версия 05:06, 1 июня 2010
(нет различий)

Java Tutorial/Language/Standard Annotations - История изменений

Admin: 1 версия

в 17:44, 31 мая 2010