【Java SE】9. 枚举类与注解

最新推荐文章于 2023-09-27 12:47:06 发布

coolcoo1cool

最新推荐文章于 2023-09-27 12:47:06 发布

阅读量110

点赞数

分类专栏： JavaSE 文章标签：枚举类注解

原文链接：https://blog.csdn.net/Qmilumilu/article/details/119518425

版权

JavaSE 专栏收录该内容

14 篇文章 1 订阅

订阅专栏

9. 枚举类与注解

- 9.1 枚举类的使用
- 9.2 注解

9.1 枚举类的使用

什么是枚举类：
1. 类的对象只有有限个，确定的类
  
  如：星期： Monday(星期一)、 …、 Sunday(星期天)
  
  性别： Man(男)、 Woman(女)
  
  季节： Spring(春节)…Winter(冬天)
  
  订单状态： Nonpayment（未付款）、 Paid（已付款）、 Delivered（已发货）、Return（退货）、 Checked（已确认） Fulfilled（已配货）
2. 当需要定义一组常量时，强烈建议使用枚举类
3. 若枚举只有一个对象, 则可以作为一种单例模式的实现方式
4. 如和定义枚举类：
  1. jdk5.0 之前，自定义枚举类
  2. jdk5.0 之后，可以使用关键字enum定义枚举类

如何自定义枚举类：

步骤：
1. 声明Season对象的属性：private final修饰
2. 私有化类的构造器，并给对象属性赋值
3. 提供当前枚举类的多个对象：public static final的
4. 其他诉求1：getXxx( )
5. 其他诉求2：toString( )

示例：

class Season{
    private String seasonName;
    private String seasonDesc;
		
    //属性和构造器位private，只能再类内new对象
    private Season(String seasonName, String seasonDesc) {
        this.seasonName = seasonName;
        this.seasonDesc = seasonDesc;
    }

    public static final Season SPRING = new Season("春天","春暖花开");
    public static final Season SUMMER = new Season("夏天","夏日炎炎");
    public static final Season ATUMN = new Season("秋天","秋高气爽");
    public static final Season WINTER = new Season("冬天","冰天雪地");

    public String getSeasonName() {
        return seasonName;
    }

    public String getSeasonDesc() {
        return seasonDesc;
    }

    @Override
    public String toString() {
        return "Season{" +
                "seasonName='" + seasonName + '\'' +
                ", seasonDesc='" + seasonDesc + '\'' +
                '}';
    }
}

public class StringTest {
    public static void main(String[] args) {
        
        //直接调用已经造好的有限个、确定的对象
        Season summer = Season.SUMMER;
        System.out.println(summer);
        //Season{seasonName='夏天', seasonDesc='夏日炎炎'}
    }
}

如何 使用关键字enum定义枚举类：

步骤：
1. 提供当前枚举类的对象，多个对象之间用",“隔开，末尾对象用”;"结束
2. 声明Season对象的属性：private final修饰
3. 私有化类的构造器，并给对象属性赋值
4. 其他诉求1：getXxx( )
5. 定义的枚举类默认继承class java.lang.Enum，无需写toString( )了

示例：

enum Season{
    SPRING("春天","春暖花开"),
    SUMMER ("夏天","夏日炎炎"),
    ATUMN ("秋天","秋高气爽"),
    WINTER("冬天","冰天雪地");

    private String seasonName;
    private String seasonDesc;

    private Season(String seasonName, String seasonDesc) {
        this.seasonName = seasonName;
        this.seasonDesc = seasonDesc;
    }

    public String getSeasonName() {
        return seasonName;
    }

    public String getSeasonDesc() {
        return seasonDesc;
    }
}

public class StringTest {
    public static void main(String[] args) {
        Season summer = Season.SUMMER;
        System.out.println(summer);//SUMMER
        System.out.println(Season.class.getSuperclass());
        //class java.lang.Enum
    }
}

Enum类的主要方法：
1. values()方法：返回枚举类型的对象数组。该方法可以很方便地遍历所有的枚举值
```
Season summer = Season.SUMMER;
Season[] values = Season.values();
for (int i = 0; i < values.length; i++) {
    System.out.println(values[i]);
}
```
2. valueOf(String str)：可以把一个字符串转为对应的枚举类对象（找打对于的对象）要求字符串必须是枚举类对象的“名字”。如不是，会有运行时异常：IllegalArgumentException
```
Season summer = Season.SUMMER;
Season summer1 = Season.valueOf("SUMMER");
System.out.println(summer1);//SUMMER
```
3. toString()：返回当前枚举类对象常量的名称

使用关键字enum定义枚举类实现接口：

情况一：实现接口，在enum类中实现抽象方法

情况二：实现接口,让枚举类的对象分别去实现接口中的抽象方法

interface Info{
    void show();
}

enum Season implements Info{
    SPRING("春天","春暖花开"){
        @Override
        public void show() {
            System.out.println("这是春天");
            //每个对象分别重写自己的show方法
        }
    },
    SUMMER ("夏天","夏日炎炎") {
        @Override
        public void show() {
            System.out.println("这是夏天");
        }
    },
    ATUMN ("秋天","秋高气爽") {
        @Override
        public void show() {
            System.out.println("这是秋天");
        }
    },
    WINTER("冬天","冰天雪地") {
        @Override
        public void show() {
            System.out.println("这是冬天");
        }
    };
}

9.2 注解

注解(Annotation)概述：
1. 其实就是代码里的特殊标记，这些标记可以在编译，类加载，运行时被读取，并执行相应的处理
2. 可以像修饰符一样被使用, 可用于修饰包,类, 构造器, 方法, 成员变量, 参数, 局部变量的声明, 这些信息被保存在 Annotation的 “name=value” 对中
3. 注解的使用目的比较简单，例如标记过时的功能，忽略警告等。在JavaEE/Android中注解占据了更重要的角色，例如用来配置应用程序的任何切面，代替JavaEE旧版中所遗留的繁冗代码和XML配置等
4. 框架 = 注解 + 反射 + 设计模式
常见的Annotation示例：
1. 示例一：生成文档相关的注解
  
  @author 标明开发该类模块的作者，多个作者之间使用,分割
  @version 标明该类模块的版本
  @see 参考转向，也就是相关主题
  @since 从哪个版本开始增加的
  @param 对方法中某参数的说明，如果没有参数就不能写
  @return 对方法返回值的说明，如果方法的返回值类型是void就不能写
  @exception 对方法可能抛出的异常进行说明，如果方法没有用throws显式抛出的异常就不能写
2. 示例二：在编译时进行格式检查(JDK内置的三个基本注解)
  1. @Override: 限定重写父类方法, 该注解只能用于方法
  2. @Deprecated: 用于提示所修饰的元素(类, 方法等)已过时。通常是因为所修饰的结构危险或存在更好的选择
  3. @SuppressWarnings: 抑制编译器警告
3. 示例三：跟踪代码依赖性，实现替代配置文件功能
  1. Servlet3.0提供了注解(annotation),使得不再需要在web.xml文件中进行Servlet的部署
```
<servlet>
	<servlet-name>LoginServlet</servlet-name>
	<servlet-class>com.servlet.LoginServlet</servlet-class>
</servlet>
<servlet-mapping>
	<servlet-name>LoginServlet</servlet-name>
	<url-pattern>/login</url-pattern>
</servlet-mapping>
```
    $\to$
```
@WebServlet("/login")
public class LoginServlet extends HttpServlet {
	private static final long serialVersionUID = 1L;
	protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException,IOException { }
	protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
	doGet(request, response);
	} 
}
```
  2. spring框架中关于“事务” 的管理

自定义Annotation

步骤：
1. 注解声明为：@interface
2. 内部定义成员，通常使用value表示
3. 可以指定成员的默认值，使用default定义
4. 如果自定义注解没有成员，表明是一个标识作用

示例：

public @interface myAnnotation {
    String value();
    //String value() default "hello";
}

//如果注解有成员，则在使用时需要赋值
@myAnnotation("使用时指定一个值")
public class myAnnotationTest {
    
}

JDK中的元注解
1. 元 Annotation 用于修饰其他 Annotation 定义，（修饰其他注解的注解）
2. JDK5.0提供了4个标准的meta-annotation类型，分别是：
  1. Retention：指定该 Annotation 的生命周期
    1. SOURCE：编译器直接丢弃这种策略的注释
    2. CLASS：当运行 Java 程序时, JVM不会保留注解。这是默认值
    3. RUNTIME：当运行 Java 程序时, JVM 会保留注释。程序可以通过反射获取该注释
```
@Retention(RetentionPolicy.SOURCE)
@interface MyAnnotation1{ }

@Retention(RetentionPolicy.RUNTIME)
@interface MyAnnotation2{ }
```
  2. Target：用于指定被修饰的 Annotation 能用于修饰哪些结构
  3. Documented：用于指定被该元 Annotation 修饰的 Annotation类将被javadoc 工具提取成文档
  4. Inherited：被它修饰的 Annotation 将具有继承性。如果某个类使用了被@Inherited修饰的 Annotation, 则其子类将自动具有该注解
利用反射获取注解信息（在反射部分涉及）

JDK 8中注解的新特性

可重复注解：

在myAnnotation上声明@Repeatable，成员值为myAnnotations.class
myAnnotation 的Target和Retention等元注解应该与myAnnotations的相同

public @interface myAnnotations {
    myAnnotation[] value();
}

@Repeatable(myAnnotations.class)
public @interface myAnnotation {
    String value();
}

@myAnnotation("使用时指定一个值")
@myAnnotation("可重复注解")
public class StringTest {
    
}

类型注解：

ElementType.TYPE_PARAMETER 表示该注解能写在类型变量的声明语句中（如：泛型声明）

public class TestTypeDefine<@TypeDefine() U> {
	private U u;
	public <@TypeDefine() T> void test(T t){
	}
}

@Target({ElementType.TYPE_PARAMETER})
@interface TypeDefine{
}

ElementType.TYPE_USE 表示该注解能写在使用类型的任何语句中

@MyAnnotation
public class AnnotationTest<U> {
		
    @MyAnnotation
		private String name;
		
    public static void main(String[] args) {
				AnnotationTest<@MyAnnotation String> t = null;
				int a = (@MyAnnotation int) 2L;
				@MyAnnotation
				int b = 10;
		}
		public static <@MyAnnotation T> void method(T t) {
		}
		public static void test(@MyAnnotation String arg) throws @MyAnnotation Exception {
		}
}

@Target(ElementType.TYPE_USE)
@interface MyAnnotation {
}