10.1
枚举类的使用
主要内容
:
如何自定义枚举类
如何使用关键字
enum
定义枚举类
Enum
类的主要方法
实现接口的枚举类
10.1.1
枚举类的使用:入门
类的对象只有有限个,确定的。
举例如下:
星期:
Monday(
星期一
)
、
......
、
Sunday(
星期天
)
性别:
Man(
男
)
、
Woman(
女
)
季节:
Spring(
春节
)......Winter(
冬天
)
支付方式:
Cash
(现金)、
WeChatPay
(微信)、
Alipay(
支付宝
)
、
BankCard(
银
行卡
)
、
CreditCard(
信用卡
)
就职状态:
Busy
、
Free
、
Vocation
、
Dimission
订单状态:
Nonpayment
(未付款)、
Paid
(已付款)、
Delivered
(已发货)、
Return
(退货)、
Checked
(已确认)
Fulfilled
(已配货)、
线程状态:创建、就绪、运行、阻塞、死亡
当需要定义一组常量时,强烈建议使用枚举类
10.1.1
枚举类的使用
枚举类的实现
JDK1.5
之前需要自定义枚举类
JDK 1.5
新增的
enum
关键字
用于定义枚举类
若枚举只有一个对象
,
则可以作为一种单例模式的实现方
式。
枚举类的属性
枚举类对象的属性不应允许被改动
,
所以应该使用
private final
修饰
枚举类的使用
private final
修饰的属性应该在构造器中为其赋值
若枚举类显式的定义了带参数的构造器
,
则在列出枚举值时也必须对应的
传入参数
10.1.2
自定义枚举类
1.
私有化
类的构造器,保证不能在类的外部创建其对象
2.
在类的内部创建枚举类的实例。声明为:
public static final
3.
对象如果有实例变量,应该声明为
private final
,并在构造器中初始化
class
Season{
private final
String
SEASONNAME
;
//
季节的名称
private final
String
SEASONDESC
;
//
季节的描述
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
AUTUMN
=
new
Season(
"
秋天
"
,
"
秋高气爽
"
);
public static final
Season
WINTER
=
new
Season(
"
冬天
"
,
"
白雪皑皑
"
);
}
使用说明
使用
enum
定义的枚举类
默认继承
了
java.lang.Enum
类,因此不能再
继承其他类
枚举类的构造器只能使用
private
权限修饰符
枚举类的所有实例必须在枚举类中显式列出
(
,
分隔
;
结尾
)
。列出的
实例系统会
自动添加
public static final
修饰
必须在枚举类的第一行声明枚举类对象
JDK 1.5
中可以在
switch
表达式中使用
Enum
定义的枚举类的对象
作为表达式
, case
子句可以直接使用枚举值的名字
,
无需添加枚举
类作为限定。
10.1.3
使用
enum
定义枚举类
10.1.3
使用
enum
定义枚举类
public enum
SeasonEnum {
SPRING
(
"
春天
"
,
"
春风又绿江南岸
"
),
SUMMER
(
"
夏天
"
,
"
映日荷花别样红
"
),
AUTUMN
(
"
秋天
"
,
"
秋水共长天一色
"
),
WINTER
(
"
冬天
"
,
"
窗含西岭千秋雪
"
);
private final
String
seasonName
;
private final
String
seasonDesc
;
private
SeasonEnum(String
seasonName
, String
seasonDesc
) {
this
.
seasonName
=
seasonName
;
this
.
seasonDesc
=
seasonDesc
;
}
public
String getSeasonName() {
return
seasonName
;
}
public
String getSeasonDesc() {
return
seasonDesc
;
}
}
10.1.4 Enum
类的主要方法
10.1.4 Enum
类的主要方法
Enum
类的主要方法:
values()
方法
:返回枚举类型的对象数组。该方法可以很方便地遍历所有的
枚举值。
valueOf(String str)
:可以把一个字符串转为对应的枚举类对象。要求字符
串必须是枚举类对象的“名字”。如不是,会有运行时异常:
IllegalArgumentException
。
toString()
:返回当前枚举类对象常量的名称
10.1.5
实现接口的枚举类
和普通
Java
类一样,枚举类可以实现一个或多个接口
若每个枚举值在调用实现的接口方法呈现相同的行为方式,则只
要统一实现该方法即可。
若需要每个枚举值在调用实现的接口方法呈现出不同的行为方式
,
则可以让每个枚举值分别来实现该方法
10-2
注解
(Annotation)
10.2
注解
(Annotation)
主要内容:
注解
(Annotation)
概述
常见的
Annotation
示例
自定义
Annotation
JDK
中的元注解
利用反射获取注解信息(在反射部分涉及)
JDK 8
中注解的新特性
10.2.1
注解
(Annotation)
概述
从
JDK 5.0
开始
, Java
增加了对元数据
(MetaData)
的支持
,
也就是
Annotation(
注解
)
Annotation
其实就是代码里的
特殊标记
,
这些标记可以在编译
,
类加
载
,
运行时被读取
,
并执行相应的处理。通过使用
Annotation,
程序员
可以在不改变原有逻辑的情况下
,
在源文件中嵌入一些补充
信息。代
码分析工具、开发工具和部署工具可以通过这些补充信息进行验证
或者进行部署。
Annotation
可以像修饰符一样被使用
,
可用于
修饰包
,
类
,
构造器
,
方
法
,
成员变量
,
参数
,
局部变量的声明
,
这些信息被保存在
Annotation
的
“name=value”
对中。
10.2.1
注解
(Annotation)
概述
在
JavaSE
中,注解的使用目的比较简单,例如标记过时的功能,
忽略警告等。在
JavaEE/Android
中注解占据了更重要的角色,例如
用来配置应用程序的任何切面,代替
JavaEE
旧版中所遗留的繁冗
代码和
XML
配置等。
未来的开发模式都是基于注解的,
JPA
是基于注解的,
Spring2.5
以
上都是基于注解的,
Hibernate3.x
以后也是基于注解的,现在的
Struts2
有一部分也是基于注解的了,注解是一种趋势,一定程度上
可以说:
框架
=
注解
+
反射
+
设计模式。
10.2.2
常见的
Annotation
示例
使用
Annotation
时要在其前面增加
@
符号
,
并
把该
Annotation
当成
一个修饰符使用。
用于修饰它支持的程序元素
示例一:生成文档相关的注解
@author
标明开发该类模块的作者,多个作者之间使用
,
分割
@version
标明该类模块的版本
@see
参考转向,也就是相关主题
@since
从哪个版本开始增加的
@param
对方法中某参数的说明,如果没有参数就不能写
@return
对方法返回值的说明,如果方法的返回值类型是
void
就不能写
@exception
对方法可能抛出的异常进行说明 ,如果方法没有用
throws
显式抛出的异常就不能写
其中
@param @return
和
@exception
这三个标记都是只用于方法的。
@param
的格式要求:
@param
形参名 形参类型 形参说明
@return
的格式要求:
@return
返回值类型 返回值说明
@exception
的格式要求:
@exception
异常类型 异常说明
@param
和
@exception
可以并列多个
10.2.2
常见的
Annotation
示例
package
com.annotation.javadoc;
/**
*
@author
shkstart
*
@version
1.0
*
@see
Math.java
*/
public class
JavadocTest {
/**
*
程序的主方法,程序的入口
*
@param
args String[]
命令行参数
*/
public static void
main(String[]
args
) {
}
/**
*
求圆面积的方法
*
@param
radius double
半径值
*
@return
double
圆的面积
*/
public static double
getArea(
double
radius
){
return
Math.
PI
*
radius
*
radius
;
}
}
10.2.2
常见的
Annotation
示例
示例二:在编译时进行格式检查
(JDK
内置的三个基本注解
)
@Override:
限定重写父类方法
,
该注解只能用于方法
@Deprecated:
用于表示所修饰的元素
(
类
,
方法等
)
已过时。通常是因为
所修饰的结构危险或存在更好的选择
@SuppressWarnings:
抑制编译器警告
10.2.2
常见的
Annotation
示例
package
com.annotation.javadoc;
public class
AnnotationTest{
public static void
main(String[]
args
) {
@SuppressWarnings
(
"unused"
)
int
a
= 10;
}
@Deprecated
public void
print(){
System.
out
.println(
"
过时的方法
"
);
}
@Override
public
String toString() {
return
"
重写的
toString
方法
()"
;
}
}
10.2.2
常见的
Annotation
示例
示例三:跟踪代码依赖性,实现替代配置文件功能
Servlet3.0
提供了注解
(annotation),
使得不再需要在
web.xml
文件中进行
Servlet
的部署。
@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
);
} }
<
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
>
10.2.2
常见的
Annotation
示例
spring
框架中关于“事务”的管理
@Transactional(propagation=Propagation.REQUIRES_NEW,
isolation=Isolation.READ_COMMITTED,readOnly=false,timeout=3)
public void buyBook(String username, String isbn) {
//1.
查询书的单价
int price = bookShopDao.findBookPriceByIsbn(isbn);
//2.
更新库存
bookShopDao.updateBookStock(isbn);
//3.
更新用户的余额
bookShopDao.updateUserAccount(username, price);
}
isolation="READ_COMMITTED" read-only="false" timeout="3" />
10.2.3
自定义
Annotation
定义新的
Annotation
类型使用
@interface
关键字
自定义注解自动继承了
java.lang.annotation.Annotation
接口
Annotation
的成员变量在
Annotation
定义中以无参数方法的形式来声明。其
方法名和返回值定义了该成员的名字和类型。我们称为配置参数。类型只能
是八种基本数据类型、
String
类型、
Class
类型、
enum
类型、
Annotation
类型、
以上所有类型的数组
。
可以在定义
Annotation
的成员变量时为其指定初始值
,
指定成员变量的初始
值可使用
default
关键字
如果只有一个参数成员,建议使用
参数名为
value
如果定义的注解含有配置参数,那么使用时必须指定参数值,除非它有默认
值。格式是“参数名
=
参数值”,如果只有一个参数成员,且名称为
value
,
可以省略“
value=
”
没有成员定义的
Annotation
称为
标记
;
包含成员变量的
Annotation
称为元数
据
Annotation
注意:
自定义注解必须配上注解的信息处理流程才有意义。
10.2.3
自定义
Annotation
@MyAnnotation
(value=
"
尚硅谷
"
)
public class
MyAnnotationTest {
public static void
main(String[]
args
) {
Class
clazz
= MyAnnotationTest.
class
;
Annotation
a
=
clazz
.getAnnotation(
MyAnnotation
.
class
);
MyAnnotation
m
= (
MyAnnotation
)
a
;
String
info
=
m
.value();
System.
out
.println(
info
);
}
}
@Retention
(RetentionPolicy.
RUNTIME
)
@Target
(ElementType.
TYPE
)
@interface
MyAnnotation
{
String value()
default
"auguigu"
;
}
10.2.4 JDK
中的元注解
JDK
的元
Annotation
用于修饰其他
Annotation
定义
JDK5.0
提供了
4
个标准的
meta-annotation
类型,分别是:
Retention
Target
Documented
Inherited
元数据的理解:
String name = “atguigu”;
10.2.4 JDK
中的元注解
@Retention
:
只能用于修饰一个
Annotation
定义
,
用于指定该
Annotation
的生命
周期
, @Rentention
包含一个
RetentionPolicy
类型的成员变量
,
使用
@Rentention
时必须为该
value
成员变量指定值
:
RetentionPolicy.SOURCE:
在源文件中有效(即源文件保留),
编译器直接丢弃这种策略的
注释
RetentionPolicy.CLASS
:
在
class
文件中有效(即
class
保留)
, 当运行
Java
程序时
, JVM
不会保留注解。 这是默认值
RetentionPolicy.RUNTIME:
在运行时有效(即运行时保留),
当运行
Java
程序时
, JVM
会
保留注释。程序可以通过反射获取该注释。
10.2.4 JDK
中的元注解
public enum RetentionPolicy{
SOURCE,
CLASS,
RUNTIME
}
@Retention(RetentionPolicy.SOURCE)
@interface MyAnnotation1{ }
@Retention(RetentionPolicy.RUNTIME)
@interface MyAnnotation2{ }
10.2.4 JDK
中的元注解
@Target
:
用于修饰
Annotation
定义
,
用于指定被修饰的
Annotation
能用于
修饰哪些程序元素。
@Target
也包含一个名为
value
的成员变量。
10.2.4 JDK
中的元注解
@Documented:
用于指定被该元
Annotation
修饰的
Annotation
类将被
javadoc
工具提取成
文档。默认情况下,
javadoc
是不包括注解的。
定义为
Documented
的注解必须设置
Retention
值为
RUNTIME
。
@Inherited:
被它修饰的
Annotation
将具有
继承性
。如果某个类使用了被
@Inherited
修饰的
Annotation,
则其子类将自动具有该注解。
比如:如果把标有
@Inherited
注解的自定义的注解标注在类级别上,子类则可以
继承父类类级别的注解
实际应用中,使用较少
练 习
1.
编写一个
Person
类,使用
Override
注解它的
toString
方法
2.
自定义一个名为“
MyTiger
”的注解类型,它只可以使用在方法上,带一
个
String
类型的
value
属性,然后在第
1
题中的
Person
类上正确使用。
10.2.5
利用反射获取注解信息
JDK 5.0
在
java.lang.reflect
包下新增了
AnnotatedElement
接口
,
该接口
代
表程序中可以接受注解的程序元素
当一个
Annotation
类型被定义为运行时
Annotation
后
,
该注解才是运行时
可见
,
当
class
文件被载入时保存在
class
文件中的
Annotation
才会被虚拟
机读取
程序可以调用
AnnotatedElement
对象的如下方法来访问
Annotation
信息
10.2.6 JDK8
中注解的新特性
Java 8
对注解处理提供了两点改进:
可重复的注解
及
可用于类型的注解
。此外,
反射也得到了加强,在
Java8
中能够得到方法参数的名称。这会简化标注在方法
参数上的注解。
可重复注解示例:
10.2.6 JDK8
中注解的新特性
类型注解:
JDK1.8
之后,关于元注解
@Target
的参数类型
ElementType
枚举值多了两个:
TYPE_PARAMETER,TYPE_USE
。
在
Java 8
之前,注解只能是在声明的地方所使用,
Java8
开始,注解可以应用
在任何地方。
ElementType.TYPE_PARAMETER
表示该注解能写在类型变量的声明语
句中(如:泛型声明)。
ElementType.TYPE_USE
表示该注解能写在使用类型的任何语句中。
public class
TestTypeDefine<
@TypeDefine
() U> {
private
U
u
;
public
<
@TypeDefine
() T>
void
test(T
t
){
}
}
@Target
({ElementType.
TYPE_PARAMETER
})
@interface
TypeDefine
{
}
10.2.6 JDK8
中注解的新特性
@MyAnnotation
public class
AnnotationTest {
@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
{