java痛苦學習之路[九]---Java Annotation

Java中的註解的應用越來越廣泛，測試框架JUnit4，以及Spring，Hibernate，Struts，MyBatis，JPA等等都包含了對註解的支持。在C#中的Attribute特性就是和Java中的註解是對應的。使用註解是爲了編程更簡便。但是我們得知道註解是做什麼的，最好是能夠自己的代碼中可以自定義註解，提高生產率。

　　下面就來說一下Annotation，先說一下基本知識，然後用一個例子把這些串起來。

-------------------------------------------------------元註解----------------------------------------------------------------------------

　　Java註解分類：元註解、一般的註解。元數據，是數據的數據，數據的信息。那麼元註解同樣道理，是註解的註解，註解的信息。java中的元註解有：@Retention @Target @Document @Inherited：

　　@Document 是用於javadoc的。一般很少使用。

　　@Retention: 定義註解的保留策略：

SOURCE ：只是在源代碼中保留。編譯後的class文件中就不會有的。

CLASS：會保留到Class文件中，在類的加載器把類加載到JVM中，就會去掉了。

RUNTIME：保留至運行時，也就是可以在JVM中使用了。這種最常用。

@Target：定義註解的作用目標：

@Target(ElementType.TYPE) //接口、類、枚舉、註解

@Target(ElementType.FIELD) //字段、枚舉的常量

@Target(ElementType.METHOD) //方法

@Target(ElementType.PARAMETER) //方法參數

@Target(ElementType.CONSTRUCTOR) //構造函數

@Target(ElementType.LOCAL_VARIABLE)//局部變量

@Target(ElementType.ANNOTATION_TYPE)//註解

@Target(ElementType.PACKAGE) ///包

@Inherited 繼承其他的註解

這些都元註解。

------------------------------------------------------------註解---------------------------------------------------------------------------

Annotation本身不是個註解，但是我們寫的註解都會隱藏的繼承這個類。

註解的聲明：

@Retention @Target

public @interface 註解名{

}

@interface，用於表示註解。由interface知道註解中都是以接口的方式書寫的，就是以接口中方法的書寫方式書寫。
註解中的方法，稱爲註解的元素。它的語法是：

public elementType elementName() [default value];

elementName, 元素名，命名方式就是java中方法的命名方式。

elementType ，元素的類型，可以使用的元素類型有：

　　原生類型：byte,short,int,long,float,double

　　字符串：String,

　　日期：Date

　　Class

　　enum

可以設置默認值。

如何使用就不用說了。

對於註解的處理，是通過Java中的反射來的。

題外話：如果沒有反射，就沒有Java中的各種框架。可見反射多麼的重要。

-----------------------------------------------------示例--------------------------------------------------------------------------------

設計一個Input註解，用於將Java bean中屬性輸出成HTML中的Input元素。這個是我即是寫的，沒有什麼實際意義，但是用於說明註解，就夠用了，它包括了註解的各種用法：

Input註解：

@Target(value={ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
public @interface Input {
   public String value() default "";        // 元素是普通類型
   public String style() default "";
   public String clazz() default "";
   public String id() default "";
   public String title() default "";
   public String volidator() default "";
   public Checked checked() default @Checked(checked=false);    // 元素是註解
   public InputType type() default InputType.text;                // 元素是枚舉
   
   
   enum InputType {
       text, radio, checkbox, button, password, file;
   }
}

@Target(value={ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
public @interface Checked {
   public boolean checked() default false;
}

上面這兩個類定義了兩個註解，Checked註解又是作爲Input註解的元素的。

@Target(value={ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
public @interface DateType {
   public String format() default "yyyy-MM-dd";
}

這個註解，是一個日期類型的註解。

定義一個Java bean，使用上面定義的三個註解：

public class Person {
   
   @Input(title="編號")
   private int id;
   @Input(title="姓名")
   private String name;
   @Input(title="年齡")
   private int age;
   @Input(title="出生日期")
   @DateType(format="yyyy-MM-dd HH:mm:ss")
   private Date birthday;
   @Input(title="地址")
   private String address;
   @Input(title="性別", checked=@Checked(checked=true))
   private String gender;
   @Input(title="口令", type=InputType.password)
   private String password;
   
   public String getGender() {
       return gender;
   }
   public void setGender(String gender) {
       this.gender = gender;
   }
   public int getId() {
       return id;
   }
   public void setId(int id) {
       this.id = id;
   }
   public String getName() {
       return name;
   }
   public void setName(String name) {
       this.name = name;
   }
   public int getAge() {
       return age;
   }
   public void setAge(int age) {
       this.age = age;
   }
   public Date getBirthday() {
       return birthday;
   }
   public void setBirthday(Date birthday) {
       this.birthday = birthday;
   }
   public String getAddress() {
       return address;
   }
   public void setAddress(String address) {
       this.address = address;
   }
   
   
}

定義一個Writer，處理上面的註解，：

package com.fjn.tools.annotation;

import java.io.PrintWriter;
import java.lang.reflect.Field;
import java.util.Date;
/**
* 包裝PrintWriter
*/
import com.fjn.tools.common.DateHelper;
@SuppressWarnings("rawtypes")
public class BeanWriter<T> extends PrintWriter{
   private PrintWriter out;
   private T bean;
   public BeanWriter(PrintWriter out) {
       super(out);
       this.out=out;
   }
   
   public void write(){
       if(bean==null) return;
       
       Class clazz=bean.getClass();
       Field[] fields=clazz.getDeclaredFields();
       StringBuffer sbf=new StringBuffer();;
       for (int i = 0; i < fields.length; i++) {
       
           Input input=fields[i].getAnnotation(Input.class);
           if(input == null) continue;
           fields[i].setAccessible(true);
           Object value=null;
           // 日期要判斷格式
           if(fields[i].getType()==Date.class || fields[i].getType()==java.sql.Date.class){
               value=getDateString(fields[i], bean);
           }else {
               try {
                   value=fields[i].get(bean);
               } catch (Exception e1) {
                   e1.printStackTrace();
               }
           }
           
           sbf.append("<input type='")
               .append(input.type().name())
               .append("' name='")
               .append(fields[i].getName())
               .append("' id='")
               .append(input.id())
               .append("' style='")
               .append(input.style())
               .append("' title='")
               .append(input.title())
               .append("' validator='")
               .append(input.volidator())
               .append("' class='")
               .append(input.clazz())
               .append("' value='")
               .append(value).
           append("'>");
           out.write(sbf.toString());
           out.flush();
           sbf.delete(0, sbf.length());
       }
   }
   
   private String getDateString(Field field, Object bean){
       DateType dateType=field.getAnnotation(DateType.class);
       String pattern=null;
       if(dateType==null){
           pattern="yyyy-MM-dd";
       }else
           pattern=dateType.format();
       field.setAccessible(true);
       String value=null;
       try {
           value=DateHelper.parseString((Date)field.get(bean), pattern);
       } catch (IllegalArgumentException e) {
           // TODO Auto-generated catch block
           e.printStackTrace();
       } catch (IllegalAccessException e) {
           // TODO Auto-generated catch block
           e.printStackTrace();
       }
       return value;
   }

   public PrintWriter getOut() {
       return out;
   }

   public void setOut(PrintWriter out) {
       this.out = out;
   }

   public T getBean() {
       return bean;
   }

   public void setBean(T bean) {
       this.bean = bean;
   }
   
   
}

最後是一個測試：

package com.fjn.tools.annotation.test;

import java.io.PrintWriter;
import java.util.Date;

import com.fjn.tools.annotation.BeanWriter;
import com.fjn.tools.annotation.Person;

public class InputTest {
    public static void main(String[] args) {
        Person person=new Person();
        person.setAddress("海淀西苑");
        person.setAge(25);
        person.setName("張三");
        person.setId(23);
        person.setBirthday(new Date());
        
        BeanWriter<Person> inputWriter=new BeanWriter<Person>(new PrintWriter(System.out));
        inputWriter.setBean(person);
        
        inputWriter.write();
    }
}

感興趣的朋友可以拿去執行以下這段代碼。

上面的代碼執行結果：

<input type='text' name='id' id='' style='' title='編號' validator='' class='' value='23'>
<input type='text' name='name' id='' style='' title='姓名' validator='' class='' value='張三'>
<input type='text' name='age' id='' style='' title='' validator='' class='' value='25'>
<input type='text' name='birthday' id='' style='' title='' validator='' class='' value='2014-07-17 12:26:15'>
<input type='text' name='address' id='' style='' title='' validator='' class='' value='海淀西苑'>

java痛苦學習之路[九]---Java Annotation

日常工作工具和網址

開發工具收藏

Idea工具和使用

chrome 插件和使用

java痛苦學習之路[六]---Struts.properties

Mac下配置sublime實現LaTeX

https://yachay.unat.edu.pe/blog/index.php?comment_area=format_blog&comment_component=blog&comment_co

linux以太網驅動總結