15-基础加强2-xml(约束)&枚举&注解

奋斗吧
奋斗吧
擅长邻域:未填写

标签: 15-基础加强2-xml(约束)&枚举&注解 jQuery博客 51CTO博客

2023-05-29 18:24:14 73浏览

15-基础加强2-xml(约束)&枚举&注解,万维网联盟(W3C)万维网联盟(W3C)创建于1994年,又称W3C理事会。1994年10月在麻省理工学集)



文章目录

  • 1.xml
  • 1.1概述【理解】(不用看)
  • 1.2标签的规则【应用】
  • 1.3语法规则【应用】
  • 1.4xml解析【应用】
  • 1.5DTD约束【理解】
  • 1.5.1 引入DTD约束的三种方法
  • 1.5.2 DTD语法(会阅读,然后根据约束来写)
  • 1.6 schema约束【理解】
  • 1.6.1 编写schema约束
  • 1.6.2 引入schema约束
  • 2.枚举
  • 2.1概述【理解】
  • 2.2定义格式【应用】
  • 2.3枚举的特点【理解】
  • 2.4枚举的方法【应用】
  • 3.注解
  • 3.1概述【理解】
  • 3.2自定义注解【理解】
  • 3.3元注解【理解】


properties文件变量名指定定义一个,多个对象全路径名时不方便阅读
xml就方便许多了,对配置有自己的一套语法格式,很健全,很强大实用

1.xml

1.1概述【理解】(不用看)

  • 万维网联盟(W3C)
    万维网联盟(W3C)创建于1994年,又称W3C理事会。1994年10月在麻省理工学院计算机科学实验室成立。
    建立者: Tim Berners-Lee (蒂姆·伯纳斯·李)。
    是Web技术领域最具权威和影响力的国际中立性技术标准机构。
    到目前为止,W3C已发布了200多项影响深远的Web技术标准及实施指南,
  • 如广为业界采用的超文本标记语言HTML(标准通用标记语言下的一个应用)、
  • 可扩展标记语言XML(标准通用标记语言下的一个子集)
  • 以及帮助残障人士有效获得Web信息的无障碍指南(WCAG)等

15-基础加强2-xml(约束)&枚举&注解_xml文件

  • xml概述
    XML的全称为(EXtensible Markup Language),是一种可扩展的标记语言
    标记语言: 通过标签来描述数据的一门语言(标签有时我们也将其称之为元素)
    可扩展:标签的名字是可以自定义的,XML文件是由很多标签组成的,而标签名是可以自定义的
  • 作用
  • 用于进行存储数据和传输数据
  • 作为软件的配置文件
  • 作为配置文件的优势
  • 可读性好
  • 可维护性高

1.2标签的规则【应用】

  • 标签由一对尖括号和合法标识符组成
<student>
  • 标签必须成对出现
<student> </student>
前边的是开始标签,后边的是结束标签
  • 特殊的标签可以不成对,但是必须有结束标记
<address/>
  • 标签中可以定义属性,属性和标签名空格隔开,属性值必须用引号引起来
<student id="1"> </student>
  • 标签需要正确的嵌套
这是正确的: <student id="1"> <name>张三</name> </student>
这是错误的: <student id="1"><name>张三</student></name>

1.3语法规则【应用】

  • 语法规则
  • XML文件的后缀名为:xml
  • 文档声明必须是第一行第一列 <?xml version=“1.0” encoding=“UTF-8” standalone=“yes”?> version:该属性是必须存在的 (值也固定1.0吧 不要写别的)
    encoding:该属性不是必须的
    打开当前xml文件的时候应该是使用什么字符编码表(一般取值都是UTF-8)
    standalone: 该属性不是必须的,描述XML文件是否依赖其他的xml文件,取值为yes/no
  • 必须存在一个根标签,有且只能有一个
  • XML文件中可以定义注释信息
  • XML文件中可以存在以下特殊字符
< < 小于
> > 大于
& & 和号
' ' 单引号
" " 引号
  • XML文件中可以存在CDATA区
  • 示例代码
<?xml version="1.0" encoding="UTF-8" ?>
<!--文档声明必须第一行第一列 上面连空格 空行都不能有-->

<students> <!--根标签 有且只能有一个-->

    <!--学生1 通过id区分是哪个学生-->
    <student id="1">
        <name>张三</name>
        <age>23</age>
        <info>张三信息[特殊字符:小于:< 大于:">> 且:& 单引号:' 双引号:"]</info>
        <message><![CDATA[直接用CDATA域: 这里的所有东西都当做简简单单的文本,不会被转义 < > & ' "]]></message>
    </student>

    <!--学生2 id=2-->
    <student id="2">
        <name>李四</name>
        <age>24</age>
    </student>


</students>

1.4xml解析【应用】

  • 概述
    xml解析就是从xml中获取到数据
  • 常见的解析思想
    DOM(Document Object Model)文档对象模型:就是把文档的各个组成部分看做成对应的对象。
    会把xml文件全部加载到内存,在内存中形成一个树形结构,再获取对应的值
  • 常见的解析工具
  • JAXP: SUN公司提供的一套XML的解析的API
  • JDOM: 开源组织提供了一套XML的解析的API-jdom
  • DOM4J: 开源组织提供了一套XML的解析的API-dom4j,全称:Dom For Java
  • pull: 主要应用在Android手机端解析XML
  • 解析的准备工作
  1. 我们可以通过网站:https://dom4j.github.io/ 去下载dom4j
    今天的资料中已经提供,我们不用再单独下载了,直接使用即可
  2. 将提供好的dom4j-1.6.1.zip解压,找到里面的dom4j-1.6.1.jar
  3. 在idea中当前模块下新建一个libs文件夹,将jar包复制到文件夹中
  4. 选中jar包 -> 右键 -> 选择add as library即可
  • 需求
  • 解析提供好的xml文件
  • 将解析到的数据封装到学生对象中
  • 并将学生对象存储到ArrayList集合中
  • 遍历集合
  • 代码实现

注意,新建目录,复制好jar包之后得,右键导入一下才能使用

15-基础加强2-xml(约束)&枚举&注解_xml_02


导入成功后就可以展开了

15-基础加强2-xml(约束)&枚举&注解_java_03

  • student.xml
<?xml version="1.0" encoding="UTF-8" ?>
<students> 
    <!--学生1 通过id区分是哪个学生-->
    <student id="1">
        <name>张三</name>
        <age>23</age>
    </student>

    <!--学生2 id=2-->
    <student id="2">
        <name>李四</name>
        <age>24</age>
    </student>
</students>
  • Student.java
public class Student {
    private String id;
    private String name;
    private int age;
    
	//全参构造,无参构造,set/get, toString\
}
  • XmlParse.java
/**
 * 利用dom4j解析xml文件
 */
public class XmlParse {

    public static void main(String[] args) throws Exception {
        //1.获取Document对象
        //1.1先得获取一个解析器对象(SAXReader)
        SAXReader saxReader = new SAXReader();
        //1.2利用解析器把xml文件加载到内存中,并返回一个文档对象(Document对象)
        Document document = saxReader.read(new File("myxml/xml/student.xml"));

        //2.逐步获取标签对象
        //2.1 获取根标签
        Element rootElement = document.getRootElement();
        //2.2 通过根标签获取Student标签
        //方法1:elements(),返回调用者所有子标签,放在一个List中
        /*List list = rootElement.elements();
        System.out.println(list.size());//3  不仅<student>,连<aaa>也都获取到了*/
        //方法2:★ elements("标签名"),返回调用者所有指定名称子标签,放在一个List中
        /*List list = rootElement.elements("student");
        System.out.println(list.size());//2 只有所有<student>了*/
        List<Element> studentElements = rootElement.elements("student");

        //用来装学生对象
        ArrayList<Student> list = new ArrayList<>();

        //2.3 遍历集合得每一个student标签
        for (Element studentElement : studentElements) {
            // 2.4 继续读取每一个student子标签以及属性
            //2.4.1 获取id属性,以及其值
            Attribute attribute = studentElement.attribute("id");//获取id属性
            String id = attribute.getValue();//获取id属性值
            //2.4.2 获取各个子标签 以及其值(标签体内容)
            //element("标签名"): 获取调用者指定子标签(单个)
            Element nameElement = studentElement.element("name");//name标签
            String name = nameElement.getText();//name标签体内容(需要的值)
            Element ageElement = studentElement.element("age");
            String age = ageElement.getText();

            //3. 最后根据获取到的值 封装对象了
            //System.out.println(id+" "+name+" "+age);
            Student stu = new Student(id, name, Integer.parseInt(age));
            list.add(stu);
        }
        
        System.out.println(list);

    }

}

15-基础加强2-xml(约束)&枚举&注解_xml_04

1.5DTD约束【理解】

  • 什么是约束
    用来限定xml文件中可使用的标签以及属性
  • 约束的分类
  • DTD
  • schema
  • 编写DTD约束
  • 步骤
  1. 创建一个文件,这个文件的后缀名为.dtd
  2. 看xml文件中使用了哪些元素
  3. 判断元素是简单元素还是复杂元素
    简单元素:没有子元素。
    复杂元素:有子元素的元素;
  • 代码实现
  • persondtd.dtd
<!ELEMENT persons (person)>
<!ELEMENT person (name,age)>
<!ELEMENT name (#PCDATA)>
<!ELEMENT age (#PCDATA)>
  • person.xml
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE persons SYSTEM 'persondtd.dtd'>
<!--persons根标签  SYSTEM表示引入本地约束-->

<!--引入之后再编写也有提示了-->
<persons>
    <person>
        <name>张三</name>
        <age>18</age>
    </person>
</persons>

1.5.1 引入DTD约束的三种方法

  • 引入本地dtd
<!DOCTYPE 根元素名称 SYSTEM ‘DTD文件的路径'>
  • 在xml文件内部引入
<!DOCTYPE 根元素名称 [ dtd文件内容 ]>
  • 引入网络dtd
<!DOCTYPE 根元素的名称 PUBLIC "DTD文件名称" "DTD文档的URL">
  • 代码实现
  • 引入本地DTD约束
<!DOCTYPE 根元素名称 SYSTEM ‘DTD文件的路径'>

persondtd.dtd

<!ELEMENT persons (person)>
<!ELEMENT person (name,age)>
<!ELEMENT name (#PCDATA)>
<!ELEMENT age (#PCDATA)>

person1.xml

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE persons SYSTEM 'persondtd.dtd'>
<!--方法1:引入本地约束-->

<persons>
    <person>
        <name>张三</name>
        <age>18</age>
    </person>
</persons>
  • 在xml文件内部引入
<!DOCTYPE 根元素名称 [ dtd文件内容 ]>

person2.xml

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE persons [
        <!ELEMENT persons (person)>
        <!ELEMENT person (name,age)>
        <!ELEMENT name (#PCDATA)>
        <!ELEMENT age (#PCDATA)>
        ]>
<!--方法2:xml文件内部引入约束-->

<persons>
    <person>
        <name>张三</name>
        <age>18</age>
    </person>
</persons>
  • 引入网络dtd
<!DOCTYPE 根元素的名称 PUBLIC "DTD文件名称" "DTD文档的URL">

暂时了解 后面使用

1.5.2 DTD语法(会阅读,然后根据约束来写)

  • 定义元素
    定义一个元素的格式为:<!ELEMENT 元素名 元素类型>
    简单元素:
    EMPTY: 表示标签体为空
    ANY: 表示标签体可以为空也可以不为空
    PCDATA: 表示该元素的内容部分为字符串
    复杂元素:
    直接写子元素名称. 多个子元素可以使用",“或者”|"隔开;
    ","表示定义子元素的顺序 ; “|”: 表示子元素只能出现任意一个
    "?"零次或一次, "+"一次或多次, "*"零次或多次;如果不写则表示出现一次

    不限制个数,就是只能写一次
  • 定义属性
    格式
    定义一个属性的格式为:<!ATTLIST 元素名称 属性名称 属性的类型 属性的约束>
    属性的类型:
    CDATA类型:普通的字符串
    属性的约束:
    // #REQUIRED: 必须的
    // #IMPLIED: 属性不是必需的
    // #FIXED value:属性值是固定的
  • 代码实现
  • 代码实现
<!ELEMENT persons (person+)>
<!--person+ 1个或多个   person 只能写一个-->
<!ELEMENT person (name,age)>
<!ELEMENT name (#PCDATA)>
<!ELEMENT age (#PCDATA)>
<!ATTLIST person id CDATA #REQUIRED>
<!ATTLIST name id CDATA #FIXED "p1"> <!-- 属性值定死为name了 -->

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE persons SYSTEM 'persondtd.dtd'>

<persons>
    <person id="001">
        <name>张三</name>
        <age>23</age>
    </person>

    <person id = "002">
        <name>张三</name>
        <age>23</age>
    </person>

</persons>

1.6 schema约束【理解】

  • schema和dtd的区别
  1. schema约束文件也是一个xml文件,符合xml的语法,这个文件的后缀名.xsd
  2. 一个xml中可以引用多个schema约束文件,多个schema使用名称空间区分(名称空间类似于java包名)
  3. dtd里面元素类型的取值比较单一常见的是PCDATA类型,但是在schema里面可以支持很多个数据类型
  4. schema 语法更加的复杂

15-基础加强2-xml(约束)&枚举&注解_spring_05

1.6.1 编写schema约束

  • 步骤
    1,创建一个文件,这个文件的后缀名为.xsd。
    2,定义文档声明
    3,schema文件的根标签为: <schema>
  • 4,在<schema>中定义属性:
    xmlns=http://www.w3.org/2001/XMLSchema
  • 5,在<schema>中定义属性 :
    targetNamespace =唯一的url地址,指定当前这个schema文件的名称空间。
    6,在<schema>中定义属性 :
    elementFormDefault="qualified“,表示当前schema文件是一个质量良好的文件。
    7,通过element定义元素
    8,判断当前元素是简单元素还是复杂元素

1.5.2也有约束文件 定义元素 的说明

15-基础加强2-xml(约束)&枚举&注解_XML_06

  • 代码实现
  • person.xsd
<?xml version="1.0" encoding="UTF-8" ?>
<!--根标签有三个固定属性-->
<schema
    xmlns="http://www.w3.org/2001/XMLSchema"
    targetNamespace="http://www.whu.cn/javase"
    elementFormDefault="qualified"
>
    <!--定义persons复杂元素-->
    <element name="persons">
        <complexType>
            <!--sequence表示子标签必须按顺序来-->
            <sequence>
                <!--定义person复杂元素-->
                <element name="person">
                    <complexType>
                        <sequence>
                            <!--定义name和age简单元素-->
                            <element name="name" type="string"></element>
                            <element name="age" type="string"></element>
                        </sequence>
                    </complexType>
                </element>
            </sequence>
        </complexType>
    </element>
    
</schema>

1.6.2 引入schema约束

  • 步骤
    1,在根标签上定义属性xmlns=“http://www.w3.org/2001/XMLSchema-instance”
    2,通过xmlns引入约束文件的名称空间
    3,给某一个xmlns属性添加一个标识,用于区分不同的名称空间
    格式为: xmlns:标识=“名称空间地址” ,标识可以是任意的,但是一般取值都是xsi
    4,通过xsi:schemaLocation指定名称空间所对应的约束文件路径
    格式为:xsi:schemaLocation = "名称空间url 文件路径“

15-基础加强2-xml(约束)&枚举&注解_spring_07

  • 代码实现
<?xml version="1.0" encoding="UTF-8" ?>

<persons
    xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance"
    xmlns = "http://www.whu.cn/javase"
    xsi:schemaLocation = "http://www.whu.cn/javase person.xsd"

>
    <person>
        <name>张三</name>
        <age>18</age>
    </person>
</persons>

15-基础加强2-xml(约束)&枚举&注解_XML_08

1.5.2也有约束文件 定义属性 的说明

  • schema约束定义属性
  • 代码示例
    person.xsd
<!--此处定义person的属性约束-->
<attribute name="id" type="string" use="required"></attribute>
<!--表示person标签必须有一个string类型的id属性-->

2.枚举

2.1概述【理解】

为了间接的表示一些固定的值,Java就给我们提供了枚举
是指将变量的值一一列出来,变量的值只限于列举出来的值的范围内

2.2定义格式【应用】

  • 格式
public enum s {   
	枚举项1,枚举项2,枚举项3;
}
注意: 定义枚举类要用关键字enum
  • 示例代码
// 定义一个枚举类,用来表示春,夏,秋,冬这四个固定值
public enum Season {
    SPRING,SUMMER,AUTUMN,WINTER;
}

2.3枚举的特点【理解】

  • 特点
  • 所有枚举类都是Enum的子类
  • 我们可以通过"枚举类名.枚举项名称"去访问指定的枚举项
  • 每一个枚举项其实就是该枚举的一个对象
  • 枚举也是一个类,也可以去定义成员变量
  • 枚举类的第一行上必须是枚举项,最后一个枚举项后的分号是可以省略的,但是如果枚举类有其他的东西,这个分号就不能省略。建议不要省略
  • 枚举类可以有构造器,但必须是private的,它默认的也是private的。
    枚举项的用法比较特殊:枚举(“”);
  • 枚举类也可以有抽象方法,但是枚举项必须重写该方法
  • 示例代码
  • Season.java 定义枚举类+定义枚举项 非常简单
public enum Season {
    SPRING,SUMMER,AUTUMN,WINTER;
}

就行了

  • EnumDemo.java 使用定义好的枚举类
public static void main(String[] args) {
        //1.所有枚举类都是Enum的子类
        /*不必演示了*/

        //2.我们可以通过"枚举类名.枚举项名称"去访问指定的枚举项
        System.out.println(Season.SPRING); // SPRING
        System.out.println(Season.AUTUMN); // AUTUMN
        System.out.println(Season.SUMMER); // SUMMER
        System.out.println(Season.WINTER); // WINTER

        //3.每一个枚举项其实就是该枚举的一个对象
        Season spring = Season.SPRING;//看类型 竟然就是Season枚举类型

        //4.枚举也是一个类,也可以去定义成员变量
        //sea = new Season();//报错 枚举类不可以被实例化
        Season.SPRING.name = "张三";
        System.out.println(Season.SPRING.name);//张三

        //5.枚举类的第一行上必须是枚举项,最后一个枚举项后的分号是可以省略的,但是如果枚举类有其他的东西,这个分号就不能省略。建议不要省略
        /*将public String name;放在四个枚举项之前定义 会报错*/

        //6.枚举类可以有构造器,但必须是private的,它默认的也是private的。
        // 枚举项的用法比较特殊:枚举(“”);
        /*空参构造最为方便,没有也行*/
        System.out.println(Season.WINTER);//WINTER
        System.out.println(Season.WINTER.name);//冬

        //7.枚举类也可以有抽象方法,但是枚举项必须重写该方法
    }

枚举类也可以定义成员变量

15-基础加强2-xml(约束)&枚举&注解_java_09

枚举只有有参构造时的写法
//每一个枚举项其实就是该枚举的一个对象,所以创建枚举必须调用对应的构造器

package cn.whu.demo01;

public enum Season {
    SPRING("春"){},
    SUMMER("夏"){},
    AUTUMN("秋"),//大括号都可写可不写
    WINTER("冬");

    public String name;

    Season(String name) {
        this.name = name;
    }
}
//6.枚举类可以有构造器,但必须是private的,它默认的也是private的。
/*空参构造最为方便,没有也行*/
System.out.println(Season.WINTER);//WINTER
System.out.println(Season.WINTER.name);//冬

枚举类也可以有抽象方法,但是枚举项必须重写该方法

package cn.whu.demo01;

public enum Season {

    //核心,每一个枚举项其实就是该枚举类的一个对象
    SPRING("春"){
        //如果枚举类中有抽象方法,那么在枚举项中必须全部重写
        @Override
        public void show() {
            System.out.println(this.name);
        }
    },
    SUMMER("夏"){
        @Override
        public void show() {
            System.out.println(this.name);
        }
    },
    AUTUMN("秋") {
        @Override
        public void show() {
            System.out.println(this.name);
        }
    },//大括号都可写可不写
    WINTER("冬") {
        @Override
        public void show() {
            System.out.println(this.name);
        }
    };

    public String name;

    Season(String name) {
        this.name = name;
    }

    public abstract void show();
}
//7.枚举类也可以有抽象方法,但是枚举项必须重写该方法
Season.WINTER.show();//冬

2.4枚举的方法【应用】

  • 方法介绍

方法名

说明

String name()

获取枚举项的名称

int ordinal()

返回枚举项在枚举类中的索引值(枚举的好处 自动有0 1 2 3… 索引值)

int compareTo(E o)

比较两个枚举项,返回的是索引值的差值

String toString()

返回枚举常量的名称

static T valueOf(Class type,String name)

获取指定枚举类中的指定名称的枚举值

values()

获得所有的枚举项

  • 示例代码
  • String name() 获取枚举项的名称
public static void main(String[
        //String name()	获取枚举项的名称   
        String name = Season.SPRING
        System.out.println(name); 
    }

输出

SPRING
  • int ordinal() 返回枚举项在枚举类中的索引值
    (枚举的好处 自动有0 1 2 3… 索引值)
//int ordinal()	返回枚举项在枚举类中的索引值    
/*枚举的好处 自动有0 1 2 3... 索引值*/       
int index1 = Season.SPRING.ordinal
int index2 = Season.SUMMER.ordinal
int index3 = Season.AUTUMN.ordinal
int index4 = Season.WINTER.ordinal
System.out.println(index1);//【0】  
System.out.println(index2);//【1】  
System.out.println(index3);//【2】  
System.out.println(index4);//【3】

15-基础加强2-xml(约束)&枚举&注解_spring_10

  • int compareTo(E o) 比较两个枚举项,返回的是索引值的差值
//int compareTo(E o)	比较两个枚举项,返回的是索引值的差值
int result = Season.SPRING.compareTo(Season.WINTER); //0-3
System.out.println(result);//-3 
result = Season.SPRING.compareTo(Season.SPRING);
System.out.println(result);//0

15-基础加强2-xml(约束)&枚举&注解_spring_11

  • String toString() 返回枚举常量的名称
//String toString()	返回枚举常量的名称
String s = Season.SPRING.toString();
System.out.println(s);//SPRING 
/*一般用name方法就行了,toString()方法一般不直接用二十打印类对象时自动调用的
也就是说,我们打印枚举项时,打印的不是地址值,而是变量名称*/

15-基础加强2-xml(约束)&枚举&注解_spring_12


不难理解:下面这两条语句是完全等价的

System.out.println(Season.SPRING);//SPRING
System.out.println(Season.SPRING.toString());//SPRING
  • static T valueOf(Class type,String name) 获取指定枚举类中的指定名称的枚举值
//static T valueOf(Class type,String name)	获取指定枚举类中的指定名称的枚举值
Season spring = Enum.valueOf(Season.class, "SPRING");//有点反射的意思了(可以动态获取了)
System.out.println(spring);//SPRING
System.out.println(spring == Season.SPRING);//true

15-基础加强2-xml(约束)&枚举&注解_XML_13

  • values() 获得所有的枚举项(名称)
//values()	获得所有的枚举项(名称)
Season[] values = Season.values();
for (Season value : values) {
    System.out.println(value);
}

15-基础加强2-xml(约束)&枚举&注解_xml_14

3.注解

3.1概述【理解】

  • 概述
    对我们的程序进行标注和解释
  • 注解和注释的区别
  • 注释: 给程序员看的
  • 注解: 给编译器看的
  • 使用注解进行配置的优势
    代码更加简洁,方便

方法过时的横线提醒,就是用@Deprecated注解实现的

  • 简单体会注解作用
package cn.whu.myanno1;


@SuppressWarnings(value = "all") //压制(忽略)类中所有的警告
public class Zi extends Fu {


    @Override //此注解告诉我们的编译器这个方法是重写了父类中的show方法 那么我们在进行方法定义的时候,就需要按照重写方法的要求进行方法定义
    //改名字(父类没有此名方法)  改参数   就都会报错了
    public void show() {
        super.show();
    }


    @Deprecated //表示这是一个过时的方法
    public void method() {
        System.out.println("method");
    }

    @SuppressWarnings(value = "all") //压制(忽略)本方法中所有警告 (eg: 变量未被使用过的警告)  写在类上面就压制了类中所有的警告
    public void function() {
        int a = 10;
        int b = 20;
        /*System.out.println(a);
        System.out.println(b);*/
    }


    public static void main(String[] args) {
        Zi zi = new Zi();
        zi.method();
    }
}

3.2自定义注解【理解】

  • 格式
public @interface 注解名称 {

  		public 属性类型 属性名() default 默认值 ;

  }

属性名后面有一个小括号

  • 属性类型
  • 基本数据类型
  • String
  • Class
  • 注解
  • 枚举
  • 以上类型的一维数组
  • 代码演示
  • Anno1.java
package cn.whu.myanno1;


//创建一个注解类
public @interface Anno1 {
    //可以给注解类定义各种属性
    //属性访问修饰符只能是public,可以省略不写

    //定义一个基本类型的属性
    int a() default 23; //public省略不写

    //定义一个String类型的属性
    public String name();//不给默认值

    //定义一个Class类型的属性
    public Class clazz() default Anno2.class;

    //定义一个注解类型的属性
    public Anno2 anno() default @Anno2;

    //定义一个枚举类型的属性
    public Season season() default Season.SPRING;

    //以上类型的一维数组
    //eg: int[]
    public int[] arr() default {1,2,3,4,5};
    //eg: 枚举数组
    public Season[] seasons() default {Season.SPRING,Season.SUMMER,Season.AUTUMN,Season.WINTER};
}
  • Anno2.java
package cn.whu.myanno1;

public @interface Anno2 {
}
  • AnnoDemo.java
//使用我们自定义的注解Anno1
//发现报错,原来注解内有属性没有给出默认值,我们使用注解时就得手动给出默认值
@Anno1(name="whu")  //执行不会出错 编译器出bug可能瞎报
public class AnnoDemo {

}
  • 注意
    如果只有一个属性需要赋值,并且属性的名称是value,则value可以省略,直接定义值即可

Anno1.java

public @interface Anno1 {

    public String name() default "whu";//不给默认值

    public String value();
    //仅仅value属性没有初始值,也就表示使用注解时也只用给value提供一个值就行了

}

AnnoDemo .java

//@Anno1(value = "abc")
@Anno1("abc") //只用给名为value的属性赋值时,可以简写
public class AnnoDemo {

}
  • 自定义注解案例
  • 需求
    自定义一个注解@Test,用于指定类的方法上,如果某一个类的方法上使用了该注解,就执行该方法
  • 实现步骤
  1. 自定义一个注解Test,并在类中的某几个方法上加上注解
  2. 在测试类中,获取注解所在的类的Class对象
  3. 获取类中所有的方法对象
  4. 遍历每一个方法对象,判断是否有对应的注解
  • 代码实现
    UseTest
package cn.whu.demo1;

public class UseTest {

    //只执行用@Test注解了的2个方法  不执行第一个没@Test注解的方法


    public void show(){
        System.out.println("UseTest....show....");
    }

    @Test
    public void method(){
        System.out.println("UseTest....method....");
    }

    @Test
    public void function(){
        System.out.println("UseTest....function....");
    }

}

Test

package cn.whu.demo1;


import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;

//表示Test注解的存活时间
@Retention(value = RetentionPolicy.RUNTIME)
public @interface Test {
}

ReflectRun

package cn.whu.demo1;

import java.lang.reflect.Method;

public class ReflectRun {

    public static void main(String[] args) throws Exception {
        //1.通过反射获取UserTest类的字节码文件对象 (也就是Class对象)
        Class clazz = Class.forName("cn.whu.demo1.UseTest");

        //2.通过反射获取这个类里面的所有方法
        Method[] methods = clazz.getDeclaredMethods();

        //3.下面要执行方法,就先创建一个对象
        UseTest useTest = (UseTest) clazz.newInstance();//空参构造 简写形式 跳过了获取空参构造的那步

        //4.遍历方法
        for (Method method : methods) {
            //4.1判断方法有无@Test注解
            /*isAnnotationPresent(Class<? extends Annotation> annotationClass)
              判断当前方法上是否有指定的注解。
              参数:注解的字节码文件对象
              返回值:布尔结果。  true 存在  false 不存在*/
            boolean b = method.isAnnotationPresent(Test.class);
            if(b) method.invoke(useTest);
        }
    }

}

15-基础加强2-xml(约束)&枚举&注解_spring_15

3.3元注解【理解】

  • 概述
    元注解就是描述注解的注解
  • 元注解介绍

元注解名

说明

@Target

指定了注解能在哪里使用

@Retention

可以理解为保留时间(生命周期)

@Inherited

表示修饰的自定义注解可以被子类继承

@Documented

表示该自定义注解,会出现在API文档里面。(了解)

  • 示例代码

@Target(位置1,位置2,位置3) 指定注解可以使用的位置
ElementType.FIELD: 成员变量
ElementType.TYPE: 类
ElementType.METHOD: 方法

@Retention(生存周期)
不写,默认仅仅能在.java文件中存在 .class文件中不存在, 编译好后就消失了
RetentionPolicy.RUNTIME 运行时存在(.class文件中存在)

@Inherited 指定该注解可以被继承

Anno

import java.lang.annotation.*;

// @Target(位置1,位置2,位置3) 指定注解可以使用的位置
// ElementType.FIELD: 成员变量
// ElementType.TYPE: 类
// ElementType.METHOD: 方法
@Target({ElementType.FIELD,ElementType.TYPE,ElementType.METHOD})
// @Retention(生存周期)
// 不写,默认仅仅能在.java文件中存在 .class文件中不存在, 编译好后就消失了
// RetentionPolicy.RUNTIME 运行时存在(.class文件中存在)
@Retention(RetentionPolicy.RUNTIME)
//@Inherited 指定该注解可以被继承
@Inherited
public @interface Anno {

}

下面简单判断一下注解有没有被继承

Person

@Anno
public class Person {
}

Student

public class Student extends Person{
    public void show(){
        System.out.println("Student........show.........");
    }
}

Demo

public class Demo {
    public static void main(String[] args) throws Exception {
        //获得到Student类的字节码文件对象
        Class clazz = Class.forName("cn.whu.myanno3.Student");

        //获取注解
        boolean b = clazz.isAnnotationPresent(Anno.class);//有没有Anno注解
        System.out.println(b);//true Student确实继承了父类Person的注解 [也可以反向推出注解Anno肯定被@Inherited标注了]
    }
}


好博客就要一起分享哦!分享海报

此处可发布评论

评论(0展开评论

暂无评论,快来写一下吧

展开评论

您可能感兴趣的博客

客服QQ 1913284695