XmlElement注解在Java的数组属性上，以产生多个相同的XML元素

例如，下面这段XML数据，有多个data元素，并且它们级别相同:

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

<request>
    <reqtype>05</reqtype>
    <secret>test</secret>
    <body>
        <userid>15</userid>
        <seeid>1001</seeid>
        <time>202311201510</time>
        <data>
            <type>01</type>
            <value>219</value>
        </data>
        <data>
            <type>02</type>
            <value>217</value>
        </data>
    </body>
</request>

要用JAXB注解将Java类映射到上面的XML，示例如下：

映射xml request元素、及下面一级子元素的Java类：

package com.thb.server.fulldata;

import jakarta.xml.bind.annotation.XmlElement;
import jakarta.xml.bind.annotation.XmlRootElement;
import jakarta.xml.bind.annotation.XmlType;

/**
 * 该类映射到http请求的xml
 * @author thb
 *
 */
// 使用了JAXB注解，映射到xml中的request元素
@XmlRootElement(name = "request")
@XmlType(propOrder = {"reqtype", "secret", "fullDataContent"})
public class FullDataRequest {

    private String reqtype;
    private String secret;
    private FullDataContent fullDataContent;

    // 使用了JAXB注解，映射到xml中的reqtype元素
    @XmlElement(name="reqtype", required = true)
    public String getReqtype() {
        return this.reqtype;
    }

    // 此处的setter函数要有，否则从xml反序列到java对象的时候无法赋值
    public void setReqtype(String reqtype) {
        this.reqtype = reqtype;
    }

    // 使用了JAXB注解，映射到xml中的secret元素
    @XmlElement(name="secret", required = true)
    public String getSecret() {
        return this.secret;
    }

    // 此处的setter函数要有，否则从xml反序列到java对象的时候无法赋值
    public void setSecret(String secret) {
        this.secret = secret;
    }

    // 使用了JAXB注解，映射到xml中的body元素
    @XmlElement(name="body", required = true)
    public FullDataContent getFullDataContent() {
        return this.fullDataContent;
    }

    public void setFullDataContent(FullDataContent fullDataContent) {
        this.fullDataContent = fullDataContent;
    }
}

映射xml body子元素、及下面一级子元素的Java类：

package com.thb.server.fulldata;

import jakarta.xml.bind.annotation.XmlElement;
import jakarta.xml.bind.annotation.XmlType;

@XmlType(propOrder = {"userid", "seeid", "time", "items"})
class FullDataContent {

    private String userid;
    private String seeid;
    private String time;
    private Item[] items;

    // 使用了JAXB注解，映射到xml中body元素下面的userid元素
    @XmlElement(name="userid", required = true)
    public String getUserid() {
        return this.userid;
    }

    // 此处的setter函数要有，否则从xml反序列到java对象的时候无法赋值
    public void setUserid(String userid) {
        this.userid = userid;
    }

    // 使用了JAXB注解，映射到xml中body元素下面的seeid元素
    @XmlElement(name="seeid", required = true)
    public String getSeeid() {
        return this.seeid;
    }

    // 此处的setter函数要有，否则从xml反序列到java对象的时候无法赋值
    public void setSeeid(String seeid) {
        this.seeid = seeid;
    }

    // 使用了JAXB注解，映射到xml中body元素下面的time元素
    @XmlElement(name="time", required = true)
    public String getTime() {
        return this.time;
    }

    // 此处的setter函数要有，否则从xml反序列到java对象的时候无法赋值
    public void setTime(String time) {
        this.time = time;
    }

    // 使用了JAXB注解，映射到xml中body元素下面的data元素
    @XmlElement(name="data", required = true)
    public Item[] getItems() {
        return this.items;
    }

    // 此处的setter函数要有，否则从xml反序列到java对象的时候无法赋值
    public void setItems(Item[] items) {
        this.items = items;
    }
}

映射到xml data子元素、及下面一级子元素的Java类：

package com.thb.server.fulldata;

import jakarta.xml.bind.annotation.XmlElement;
import jakarta.xml.bind.annotation.XmlType;

@XmlType(propOrder = {"type", "value"})
public class Item {

    private String type;
    private String value;

    // 使用了JAXB注解，映射到xml中body元素下面-》data子元素下面-》type子元素
    @XmlElement(name="type", required = true)
    public String getType() {
        return this.type;
    }

    // 此处的setter函数要有，否则从xml反序列到java对象的时候无法赋值
    public void setType(String type) {
        this.type = type;
    }

    // 使用了JAXB注解，映射到xml中body元素下面-》data子元素下面-》value子元素
    @XmlElement(name="value", required = true)
    public String getValue() {
        return this.value;
    }

    // 此处的setter函数要有，否则从xml反序列到java对象的时候无法赋值
    public void setValue(String value) {
        this.value = value;
    }
}

下面来生成Java类的xml schema文件，运行

schemagen -d D:\temp\outschema -cp D:\temp\eclipse-workspace\java_work\power-restful-webservice-server\src\main\java D:\temp\eclipse-workspace\java_work\power-restful-webservice-server\src\main\java\com\thb\server\fulldata\FullDataRequest.java

在这里插入图片描述

生成的schema文件内容：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<xs:schema version="1.0" xmlns:xs="http://www.w3.org/2001/XMLSchema">

  <xs:element name="request" type="fullDataRequest"/>

  <xs:complexType name="fullDataRequest">
    <xs:sequence>
      <xs:element name="reqtype" type="xs:string"/>
      <xs:element name="secret" type="xs:string"/>
      <xs:element name="body" type="fullDataContent"/>
    </xs:sequence>
  </xs:complexType>

  <xs:complexType name="fullDataContent">
    <xs:sequence>
      <xs:element name="userid" type="xs:string"/>
      <xs:element name="seeid" type="xs:string"/>
      <xs:element name="time" type="xs:string"/>
      <xs:element name="data" type="item" maxOccurs="unbounded"/>
    </xs:sequence>
  </xs:complexType>

  <xs:complexType name="item">
    <xs:sequence>
      <xs:element name="type" type="xs:string"/>
      <xs:element name="value" type="xs:string"/>
    </xs:sequence>
  </xs:complexType>
</xs:schema>