Java注解

1、 概述:
    a. 概念:提供对元数据的支持,可以在编译、加载和运行时被读取,并执行相应的处理.
     b. 作用范围:用于修饰包、类、构造器、方法、成员变量、参数和局部变量的声明.
     c. 使用形式:name = value形式
     d. 特点:不会影响代码的执行.
2、 基本注解(Java提供的注解):
      这三个注解都在java.lang包下.
* 分类:
      * @Override:限定重写父类方法.
* 当前类必须具有一个或多个父类.
* 利用 @Override修饰的方法一定重写父类的方法.
* 使用场景:只能使用在方法上.
      * @Deprecated:标示已过时.
* 原因:
  * Java的版本更新时,向下兼容.(工程代码最初时使用Java 1.4, 更新为1.5依旧可以)
  * 软件开发时,在新版本的软件代码中,不再不要曾经的一些方法时,使用该注解.
* 含义:当一个方法被标识为已过时,表示一定存在一个新方法替代.(依旧使用被标识过时的方法,也可以)
* 使用场景:用于方法、类等,一般在方法上使用.
      * @SuppressWarnings:抑制编译器警告.
* 使用方式: @SuppressWarnings(value = { "b" })
   * 自定义注解类:
    * 通过观察Java底层提供的注解内容,注解的定义类似于接口的定义.
      public @interface Override {
 String[] values() default 默认值;
      }
      * 注解类使用的是 @interface,接口使用的是 interface.
      * 注解类定义的必要属性,类似于接口中定义的方法.
     * 自定义注解类:
      * 是public修饰的.
      * 使用 @interface 关键字
    * 作用范围:用于类、方法、成员变量及局部变量等.
   * 限制注解类的注解:
    * @Target
      * 作用:指定当前自定义注解类可以应用在哪里(注解使用的范围).
      * 备选值:
* ElementType.TYPE：指定该策略的Annotation可以修饰类、接口或枚举定义.
* ElementType.PARAMETER：指定该策略的Annotation只能修饰参数.
* ElementType.PACKAGE：指定该策略的Annotation只能修饰包定义.
* ElementType.METHOD：指定该策略的Annotation只能修饰方法定义.
* ElementType.LOCAL_VARIABLE：指定该策略的Annotation只能修饰局部变量.
* ElementType.FIELD：指定该策略的Annotation只能修饰成员变量.
* ElementType.CONSTRUCTOR：指定该策略的Annotation只能修饰构造器.
* ElementType.ANNOTATION_TYPE：指定该策略的Annotation只能修饰Annotation.
    * @Retention
      * 作用:指定当前自定义注解类的生命周期.
      * 备选值:
* RetentionPolicy.CLASS:当前注解内容只保留在Class文件中,JVM虚拟机不能获取注解内容.
* RetentionPolicy.RUNTIME:当前注解内容可以保留到运行,JVM虚拟机可以获取注解内容.
* RetentionPolicy.SOURCE:当前注解内容只保留在源码中,编译后失效.
 
* 生命周期由短到长:SOURCE -> CLASS -> RUNTIME
    * @Documented
3、 反射读取注解:
    * 注意:
      * 利用反射读取的注解的生命周期,一定是RUNTIME.
      * 反射与注解的父接口:
* 反射:AnnotatedElement接口,提供反射获取注解信息的方法.
  * getAnnotation(Class<T> annotationClass)方法:获取指定注解信息.
  * getAnnotations()方法:获取所有注解信息.
  * isAnnotationPresent()方法:判断指定注解是否作用在当前元素(Class\Method\Field等)上
* 注解:Annotation接口
      * 看具体注解作用在哪里(例如在方法上,使用Method的getAnnotation())
 
实例：自定义一个注解类,用于定义连接MySQL数据库使用的四个参数.
  1. package app.java.anno.demo;
  3. import java.lang.annotation.ElementType;
  4. import java.lang.annotation.Retention;
  5. import java.lang.annotation.RetentionPolicy;
  6. import java.lang.annotation.Target;
  8. /*
  9. * 自定义一个注解类,用于定义连接MySQL数据库使用的四个参数.
  10. * * driverClassName
  11. * * url
  12. * * username
  13. * * password
  14. */
  15. @Target(ElementType.TYPE)
  16. @Retention(RetentionPolicy.SOURCE)
  17. public@interfaceJdbcinfo{
  19. String driverClassName()default"com.mysql.jdbc.Driver";
  21. String url();
  23. String username()default"root";
  25. String password();
  27. }
  1. package app.java.anno.demo;
  3. import java.io.InputStream;
  4. import java.sql.Connection;
  5. import java.sql.DriverManager;
  6. import java.sql.ResultSet;
  7. import java.sql.SQLException;
  8. import java.sql.Statement;
  9. import java.util.Properties;
  11. /**
  12. * 封装利用JDBC连接MySQL数据库的工具类.
  13. * @author JYL
  14. */
  15. @Jdbcinfo(password ="root", url ="jdbc:mysql://localhost:3306/day0402")
  16. publicclassJDBCUtils{
  18. privatestaticJdbcinfo jdbcinfo =null;
  20. static{
  21. //利用反射读取对应注解信息
  22. Class<JDBCUtils> clazz1 =JDBCUtils.class;
  23. Class<Jdbcinfo> clazz2 =Jdbcinfo.class;
  25. Jdbcinfo jdbcinfo = clazz1.getAnnotation(clazz2);
  27. try{
  28. Class.forName(jdbcinfo.driverClassName());
  29. }catch(Exception e){
  30. e.printStackTrace();
  31. }
  32. }
  34. publicstaticConnection getConnection()throwsSQLException{
  35. returnDriverManager.getConnection(jdbcinfo.url(),jdbcinfo.username(),jdbcinfo.password());
  36. }
  38. publicstaticvoid close(Connection conn,Statement stmt){
  39. try{
  40. if(stmt !=null){stmt.close();}
  41. if(conn !=null){conn.close();}
  42. }catch(SQLException e){
  43. e.printStackTrace();
  44. }
  45. }
  47. publicstaticvoid close(Connection conn,Statement stmt,ResultSet rs){
  48. try{
  49. if(rs !=null){rs.close();}
  50. if(stmt !=null){stmt.close();}
  51. if(conn !=null){conn.close();}
  52. }catch(SQLException e){
  53. e.printStackTrace();
  54. }
  55. }
  57. }
 
 





posted @ 2015-04-02 22:30  DoIStarry  阅读(232)  评论(0)    收藏  举报