annotation定义字段默认值

java1.5引入了annotation,初看起来非常cool,但是仔细想想它可以被用在什么地方呢?什么样的需求才是用annotation的最佳方式呢?

偶先举几个例子吧:
1. O/R Mapping
比如EJB3的持久化映射, 具体就不用说了, 规范里面非常清楚了, 看代码:

Java代码 复制代码  收藏代码
  1. @NamedQueries({   
  2.     @NamedQuery(   
  3.         name="authorPosts",   
  4.         queryString="select p from Post p where p.author = :author"  
  5.     );,   
  6.     @NamedQuery(   
  7.         name="allPosts",   
  8.         queryString="select p from Post p"  
  9.     );   
  10. });   
  11.   
  12. @Entity  
  13. @Table(name="FORUM_POST", schema="javaeye");   
  14. public class Post {   
  15.     private Long _id;   
  16.     private String _title;   
  17.     private String _content;   
  18.     private User _author;   
  19.        
  20.     @Id(generate=SEQUENCE, generator ="POST_SEQ");       
  21.     public Long getId(); {   
  22.         return _id;   
  23.     }   
  24.        
  25.     @Column(name="TITLE", nullable=false, length=255);   
  26.     public String getTitle(); {   
  27.         return _title;      
  28.     }   
  29.        
  30.     @Column(name="CONTENT", columnDefinition="CLOB NOT NULL");   
  31.     public String getContent(); {   
  32.         return _content;   
  33.     }   
  34.        
  35.     @ManyToOne(optional=false);   
  36.     @JoinColumn(name="AUTHOR_ID", nullable=false, updatable=false);   
  37.     public User getAuthor(); {   
  38.         return _author;   
  39.     }   
  40. }  
@NamedQueries({
    @NamedQuery(
        name="authorPosts",
        queryString="select p from Post p where p.author = :author"
    );,
    @NamedQuery(
        name="allPosts",
        queryString="select p from Post p"
    );
});

@Entity
@Table(name="FORUM_POST", schema="javaeye");
public class Post {
    private Long _id;
    private String _title;
    private String _content;
    private User _author;
    
    @Id(generate=SEQUENCE, generator ="POST_SEQ");    
    public Long getId(); {
        return _id;
    }
    
    @Column(name="TITLE", nullable=false, length=255);
    public String getTitle(); {
        return _title;   
    }
    
    @Column(name="CONTENT", columnDefinition="CLOB NOT NULL");
    public String getContent(); {
        return _content;
    }
    
    @ManyToOne(optional=false);
    @JoinColumn(name="AUTHOR_ID", nullable=false, updatable=false);
    public User getAuthor(); {
        return _author;
    }
}



2. 校验
比如WebWork的visitor方式校验,能够将action的校验,转发到Entity上, 以前的写法是写一个Post-validation.xml:

Xml代码 复制代码  收藏代码
  1. <!DOCTYPE validators PUBLIC "-//OpenSymphony Group//XWork Validator 1.0//EN" "http://www.opensymphony.com/xwork/xwork-validator-1.0.dtd">  
  2. <validators>  
  3.     <field name="title">  
  4.         <field-validator type="requiredstring">  
  5.             <message>Please input title.</message>  
  6.         </field-validator>  
  7.     </field>  
  8.     <field name="content">  
  9.         <field-validator type="requiredstring">  
  10.             <message>Please input content.</message>  
  11.         </field-validator>  
  12.     </field>  
  13. </validators>  
<!DOCTYPE validators PUBLIC "-//OpenSymphony Group//XWork Validator 1.0//EN" "http://www.opensymphony.com/xwork/xwork-validator-1.0.dtd">
<validators>
	<field name="title">
        <field-validator type="requiredstring">
            <message>Please input title.</message>
        </field-validator>
    </field>
    <field name="content">
        <field-validator type="requiredstring">
            <message>Please input content.</message>
        </field-validator>
    </field>
</validators>



改用annotation成:

Java代码 复制代码  收藏代码
  1. @Validator(type="requiredstring", message="Please input title.");   
  2. public String getTitle(); {   
  3.     return _title;      
  4. }   
  5.   
  6. @Validator(type="requiredstring", message="Please input content.");   
  7. public String getContent(); {   
  8.     return _content;   
  9. }  
    @Validator(type="requiredstring", message="Please input title.");
    public String getTitle(); {
        return _title;   
    }
    
    @Validator(type="requiredstring", message="Please input content.");
    public String getContent(); {
        return _content;
    }



3. 索引
比如用lucene做全文搜索,以前是写一个Post-lucene.xml, 当一个Post被持久化的时候,能够自动根据这个配置文件对相应的属性做不同的索引处理:

Xml代码 复制代码  收藏代码
  1. <lucene>  
  2.     <field type="Keyword" fieldName="title"/>  
  3.     <field type="Text" fieldName="content"/>  
  4. </lucene>  
<lucene>
    <field type="Keyword" fieldName="title"/>
    <field type="Text" fieldName="content"/>
</lucene>



改用annotation成:

Java代码 复制代码  收藏代码
  1. @LuceneIndex(type="KEYWORD");   
  2. public String getTitle(); {   
  3.     return _title;      
  4. }   
  5.   
  6. @LuceneIndex(type="TEXT");   
  7. public String getContent(); {   
  8.     return _content;   
  9. }  
    @LuceneIndex(type="KEYWORD");
    public String getTitle(); {
        return _title;   
    }
    
    @LuceneIndex(type="TEXT");
    public String getContent(); {
        return _content;
    }





如果将3种annotation都混合在一起,整个Post Entity将会变成:

Java代码 复制代码  收藏代码
  1. @NamedQueries({   
  2.     @NamedQuery(   
  3.         name="authorPosts",   
  4.         queryString="select p from Post p where p.author = :author"  
  5.     );,   
  6.     @NamedQuery(   
  7.         name="allPosts",   
  8.         queryString="select p from Post p"  
  9.     );   
  10. });   
  11.   
  12. @Entity  
  13. @Table(name="FORUM_POST", schema="javaeye");   
  14. public class Post {   
  15.     private Long _id;   
  16.     private String _title;   
  17.     private String _content;   
  18.     private User _author;   
  19.        
  20.     @Id(generate=SEQUENCE, generator ="POST_SEQ");       
  21.     public Long getId(); {   
  22.         return _id;   
  23.     }   
  24.        
  25.     @Column(name="TITLE", nullable=false, length=255);   
  26.     @Validator(type="requiredstring", message="Please input title.");   
  27.     @LuceneIndex(type="KEYWORD");   
  28.     public String getTitle(); {   
  29.         return _title;      
  30.     }   
  31.        
  32.     @Column(name="CONTENT", columnDefinition="CLOB NOT NULL");   
  33.     @Validator(type="requiredstring", message="Please input content.");   
  34.     @LuceneIndex(type="TEXT");   
  35.     public String getContent(); {   
  36.         return _content;   
  37.     }   
  38.        
  39.     @ManyToOne(optional=false);   
  40.     @JoinColumn(name="AUTHOR_ID", nullable=false, updatable=false);   
  41.     public User getAuthor(); {   
  42.         return _author;   
  43.     }   
  44. }  
@NamedQueries({
    @NamedQuery(
        name="authorPosts",
        queryString="select p from Post p where p.author = :author"
    );,
    @NamedQuery(
        name="allPosts",
        queryString="select p from Post p"
    );
});

@Entity
@Table(name="FORUM_POST", schema="javaeye");
public class Post {
    private Long _id;
    private String _title;
    private String _content;
    private User _author;
    
    @Id(generate=SEQUENCE, generator ="POST_SEQ");    
    public Long getId(); {
        return _id;
    }
    
    @Column(name="TITLE", nullable=false, length=255);
    @Validator(type="requiredstring", message="Please input title.");
    @LuceneIndex(type="KEYWORD");
    public String getTitle(); {
        return _title;   
    }
    
    @Column(name="CONTENT", columnDefinition="CLOB NOT NULL");
    @Validator(type="requiredstring", message="Please input content.");
    @LuceneIndex(type="TEXT");
    public String getContent(); {
        return _content;
    }
    
    @ManyToOne(optional=false);
    @JoinColumn(name="AUTHOR_ID", nullable=false, updatable=false);
    public User getAuthor(); {
        return _author;
    }
}



本来干干净净的一个Post POJO,变成了充满annotation的怪家伙,这可以称之为annotation的滥用么?难道又一个AOP出现了?难道以后偶们打开一个Java文件必须用Eclipse之类的IDE,好让它自动将annotation fold,免得花了眼睛么?

你对annotation的意见如何?

你可能感兴趣的:(annotation)