XML标记语言：标签和语法规则、利用dom4j对XML进行解析、XML的DTD约束和schema约束；自定义枚举；自定义注解和元注解

1. XML标记语言

XML的全称为(EXtensible Markup Language)，是一种可扩展的标记语言

标记语言: 通过标签来描述数据的一门语言(标签有时我们也将其称之为元素)

可扩展：标签的名字是可以自定义的

作用：用于进行存储数据和传输数据；作为软件的配置文件

1.1 XML规则

标签规则：

• 标签由一对尖括号和合法标识符组成
• 标签必须成对出现
• 特殊的标签可以不成对,但是必须有结束标记   “
  ”
• 标签中可以定义属性,属性和标签名空格隔开,属性值必须用引号引起来
• 标签需要正确的嵌套

语法规则：

• XML文件的后缀名为：xml
• 文档声明必须是第一行第一列 <?xml version="1.0" encoding="UTF-8" standalone="yes”?>
• 必须存在一个根标签，有且只能有一个
• XML文件中可以定义注释信息
• XML文件中可以存在CDATA区   …内容…
• XML文件中可以存在以下特殊字符

< < 小于
> > 大于
& & 和号
' ' 单引号
" " 引号 

<?xml version="1.0" encoding="UTF-8" ?>
<students>
    <student id="yulu001">
        <name>小龙女</name>
        <age>18</age>
        <info>小龙女的年龄&gt;王语嫣</info>
        <massege><![CDATA[>>>>>>>> & 可以写任意字符]]></massege>
    </student>

    <student id="yulu002">
        <name>王语嫣</name>
        <age>16</age>
    </student>
</students>

1.2 XML解析

解析思想：

DOM(Document Object Model)文档对象模型:就是把文档的各个组成部分看做成对应的对象。 会把xml文件全部加载到内存,在内存中形成一个树形结构,再获取对应的值

常见解析工具：

• JAXP: SUN公司提供的一套XML的解析的API
• JDOM: 开源组织提供了一套XML的解析的API-jdom
• DOM4J: 开源组织提供了一套XML的解析的API-dom4j,全称：Dom For Java
• pull: 主要应用在Android手机端解析XML

可以通过网站：https://dom4j.github.io/ 去下载dom4j

public class MyXmlParse {
    public static void main(String[] args) throws DocumentException {
        //获取一个解析器对象
        SAXReader saxReader = new SAXReader();
        //利用解析器把xml文件加载到内存中，并返回一个文档对象
        Document document = saxReader.read(new File("day17_exercise\\xml\\student.xml"));
        //获取根标签对象
        Element rootElement = document.getRootElement();
        //获取所有根标签下指定的子标签，返回一个集合对象
        List<Element> studentElements = rootElement.elements("student");
        //用于存放学生对象
        ArrayList<Student> list = new ArrayList<>();
        //获取每一个student标签对象
        for (Element element : studentElements) {
            //获取id这个属性对象
            Attribute attribute = element.attribute("id");
            //获取id属性的值
            String id = attribute.getValue();
            //获取调用者指定的子标签name
            Element name = element.element("name");
            //获取标签对应的标签体内容
            String nameText = name.getText();

            //获取age标签以及标签体内容
            Element age = element.element("age");
            String ageText = age.getText();
            //将得到的标签体内容加入list集合
            Student stu = new Student(id, nameText, Integer.parseInt(ageText));
            list.add(stu);
        }
        System.out.println(list);
    }
}

1.3 XML约束

约束用来限定xml文件中可使用的标签以及属性

约束的分类：DTD、schema

1.3.1 DTD约束

DTD语法：

定义一个简单元素：

• EMPTY: 表示标签体为空
• ANY: 表示标签体可以为空也可以不为空
• PCDATA: 表示该元素的内容部分为字符串

定义一个复杂元素：  

• 多个子元素可以使用","或者"|"隔开；
• ","表示定义子元素的顺序 ;
• "|": 表示子元素只能出现任意一个 ​
• "?"零次或一次,
• "+"一次或多次,
• "*"零次或多次;
• 如果不写则表示出现一次

定义一个属性：

• 属性的类型： ​ CDATA类型：普通的字符串
• 属性的约束:  #REQUIRED：属性是必须的；#IMPLIED：属性不是必需的；#FIXED value：属性值是固定的

student.xml

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE students SYSTEM 'student.dtd'>
<students>
    <student id="yulu001">
        <name>小龙女</name>
        <age>18</age>
        <info>小龙女的年龄&gt;王语嫣</info>
        <massege><![CDATA[>>>>>>>> & 可以写任意字符]]></massege>
    </student>

    <student id="yulu002">
        <name>王语嫣</name>
        <age>16</age>
        <info></info>
        <massege></massege>
    </student>
</students

student.dtd 

<!ELEMENT students (student+)>
<!ELEMENT student (name, age, info, massege)>
<!ELEMENT name (#PCDATA)>
<!ELEMENT age (#PCDATA)>
<!ELEMENT info (#PCDATA)>
<!ELEMENT massege (#PCDATA)>
<!ATTLIST student id CDATA #REQUIRED>

XML文件引入DTD约束的三种方法

• 引入本地dtd：#39;student.dtd'>
• 在xml文件内部引入： 约束内容 ] >
• 引入网络dtd：件的名称" "dtd文档的URL">

1.3.2 schema约束

schema和dtd的区别：

• schema约束文件也是一个xml文件可以被其他文件约束，符合xml的语法，后缀名.xsd
• 一个xml中可以引用多个schema约束文件，多个schema使用名称空间区分（名称空间类似于java包名）
• dtd里面元素类型的取值比较单一，常见的是PCDATA类型，schema支持很多数据类型
• schema 语法更加的复杂

编写schema约束步骤：

1，创建一个文件，这个文件的后缀名为.xsd。

2，定义文档声明，通xml文件文档声明

3，schema文件的根标签为：

4，在中定义属性： xmlns=http://www.w3.org/2001/XMLSchema 表示约束其他文件

5，在中定义属性 ： targetNamespace =唯一的url地址，指定当前这个schema文件的名称空间

6，在中定义属性 ： ​elementFormDefault="qualified“，表示当前schema文件是一个质量良好的文件。

7，通过element定义元素

8，判断当前元素是简单元素还是复杂元素

person.xml

<?xml version="1.0" encoding="UTF-8" ?>

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

</persons>

person.xsd

<?xml version="1.0" encoding="UTF-8" ?>
<schema
    xmlns="http://www.w3.org/2001/XMLSchema"
    targetNamespace="http://www.yulu.com/javase"
    elementFormDefault="qualified"
>

    <!--定义persons复杂元素-->
    <element name="persons">
        <complexType>
            <sequence>
                <!--定义person复杂元素-->
                <element name = "person">
                    <complexType>
                        <sequence>
                            <!--定义name和age简单元素-->
                            <element name = "name" type = "string"></element>
                            <element name = "age" type = "string"></element>
                        </sequence>
                        <!--定义属性，required(必须的)/optional( 可选的)-->
                        <attribute name="id" type="string" use="required"></attribute>
                    </complexType>
                </element>
            </sequence>
        </complexType>

    </element>

</schema>

xml文件引入schema约束：

• xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 表示本文件是被别人约束
• xmlns="http://www.yulu.com/javase"  schema约束文件的名称空间
• xsi:schemaLocation="http://www.yulu.com/javase person.xsd" 名称空间url  文件路径

<?xml version="1.0" encoding="UTF-8" ?>

<persons
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://www.yulu.com/javase"
    xsi:schemaLocation="http://www.yulu.com/javase person.xsd"
>
    <person id="001">
        <name>张三</name>
        <age>23</age>
    </person>

</persons>

2. 枚举

为了间接表示一些固定的值（例如：春夏秋冬，星期几），Java提供了枚举类

枚举类的特点：

• 所有枚举类都是Enum的子类
• 我们可以通过"枚举类名.枚举项名称"去访问指定的枚举项
• 每一个枚举项其实就是该枚举类的一个对象
• 枚举也是一个类，也可以去定义成员变量
• 枚举类的第一行上必须是枚举项，最后一个枚举项后的分号是可以省略的，但是如果枚举类有其他的东西，这个分号就不能省略。建议不要省略
• 枚举类可以有构造器，但必须是private的，它默认的也是private的。
• 枚举项的用法比较特殊：枚举("");
• 枚举类也可以有抽象方法，但是枚举项必须重写该方法

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;

    //空参构造
    //private Season(){}
  
    //有参构造
    private Season(String name){
        this.name = name;
    }
  
    //抽象方法
    public abstract void show();
}

枚举常用方法：

方法名	说明
String name()	获取枚举项的名称
int ordinal()	返回枚举项在枚举类中的索引值
int compareTo(E o)	比较两个枚举项，返回的是索引值的差值
String toString()	返回枚举常量的名称
static T valueOf(Class type,String name)	获取指定枚举类中的指定名称的枚举值
values()	获得所有的枚举项

public enum Season {
    SPRING,SUMMER,AUTUMN,WINTER;
}

public class EnumDemo {
    public static void main(String[] args) {
//        String name() 获取枚举项的名称
        String name = Season.SPRING.name();
        System.out.println(name);
        System.out.println("-----------------------------");

//        int ordinal() 返回枚举项在枚举类中的索引值
        int index1 = Season.SPRING.ordinal();
        int index2 = Season.SUMMER.ordinal();
        int index3 = Season.AUTUMN.ordinal();
        int index4 = Season.WINTER.ordinal();
        System.out.println(index1);
        System.out.println(index2);
        System.out.println(index3);
        System.out.println(index4);
        System.out.println("-----------------------------");

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

//        String toString()   返回枚举常量的名称
        String s = Season.SPRING.toString();
        System.out.println(s);
        System.out.println("-----------------------------");

//        static <T> T valueOf(Class<T> type,String name)
//        获取指定枚举类中的指定名称的枚举值
        Season spring = Enum.valueOf(Season.class, "SPRING");
        System.out.println(spring);
        System.out.println(Season.SPRING == spring);
        System.out.println("-----------------------------");

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

3. 注解

注解：对我们的程序进行标注和解释

注解优势：再次简化properties文件和xml文件，直接在方法上加上@Test就可以运行方法，不需要有主方法

Java中的注解：

注解名	说明
@Override	描述子类重写父类的方法
@Deprecated	描述过时方法
@SuppressWarings	压制警告

@SuppressWarnings(value = "all")//压制此类中所有的警告
public class Zi extends Fu{
    //告诉编译器这个方法是重写父类的方法
            //那么我们在定义方法的时候就需要按照重写方法的规则
    @Override
    public void show() {
        super.show();
    }
    @Deprecated//表示这是一个过时的方法
    public void method1(){
        System.out.println("落霞与孤鹜齐飞");
    }

    //压制本方法中所有的警告
    @SuppressWarnings(value = "all")
    public void method2(){
        int a = 0;
        int b = 1;
    }
}

自定义注解：

格式：

public @interface 注解名称 {

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

}

属性类型：基本数据类型、String、Class、注解、枚举、以上类型的一维数组

代码示例：

public @interface Anno2 {
}

public enum Season {
    SPRING,SUMMER,AUTUMN,WINTER;
}

public @interface Anno1 {

    //定义一个基本类型的属性
    int a () default 23;

    //定义一个String类型的属性
    public String name() default "yulufeng";

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

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

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

    //以上类型的一维数组
    //int数组
    public int[] arr() default {1,2,3,4,5};

    //枚举数组
    public Season[] seasons() default {Season.SPRING,Season.SUMMER};

    //value。后期我们在使用注解的时候，如果我们只需要给注解的value属性赋值。
    //那么value就可以省略
    public String value();

}

//在使用注解的时候如果注解里面的属性没有指定默认值。
//那么我们就需要手动给出注解属性的设置值。
//@Anno1(name = "yulufeng")
@Anno1("abc")
public class AnnoDemo {
}

元注解：元注解就是描述注解的注解

元注解名	说明
@Target	指定了注解能在哪里使用
@Retention	可以理解为保留时间(生命周期)
@Inherited	表示修饰的自定义注解可以被子类继承
@Documented	表示该自定义注解，会出现在API文档里面。

@Target({ElementType.FIELD,ElementType.TYPE,ElementType.METHOD})  //指定注解使用的位置（成员变量，类，方法）
@Retention(RetentionPolicy.RUNTIME) //指定该注解的存活时间
@Inherited //指定该注解可以被继承
public @interface Anno {
}

@Anno
public class Person {
}

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

public class StudentDemo {
    public static void main(String[] args) throws ClassNotFoundException {
        //获取到Student类的字节码文件对象
        Class clazz = Class.forName("com.itheima.myanno4.Student");

        //获取注解。
        boolean result = clazz.isAnnotationPresent(Anno.class);
        System.out.println(result);
    }
}

如有错误欢迎留言评论，及时更正。2021年6月23日。