Java 클래스에서 XSD를 생성하는 방법

지난 몇 개의 게시물에서 우리는 XSD에서 자바 클래스에 대해 배웠습니다. 오늘 우리는 자바 클래스에서 XSD를 생성하는 방법을 배울 것입니다.

Java 클래스에서 XSD 생성

JAXB2 Maven 플러그인은 JAXB SchemaGenerator 유틸리티를 사용하여 Java 클래스에서 XSD를 생성합니다.
Java 클래스에는 이 플러그인에서 사용할 JAXB 주석이 있어야 합니다.
필요한 최소 Java 버전은 Java 5입니다.

<project xmlns="https://maven.apache.org/POM/4.0.0" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="https://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
	<modelVersion>4.0.0</modelVersion>
	<groupId>jaxb-schemagen</groupId>
	<artifactId>jaxb-schemagen</artifactId>
	<version>0.0.1-SNAPSHOT</version>
	<dependencies>
		<dependency>
			<groupId>javax.xml.bind</groupId>
			<artifactId>jaxb-api</artifactId>
			<version>2.1</version>
		</dependency>
	</dependencies>

	<build>
		<pluginManagement>
			<plugins>
				<plugin>
					<groupId>org.apache.maven.plugins</groupId>
					<artifactId>maven-compiler-plugin</artifactId>
					<version>2.5.1</version>
				</plugin>
			</plugins>
		</pluginManagement>

		<plugins>
			<plugin>
				<groupId>org.codehaus.mojo</groupId>
				<artifactId>jaxb2-maven-plugin</artifactId>
				<version>1.5</version>
				<executions>
					<execution>
						<id>schemagen</id>
						<goals>
							<goal>schemagen</goal>
						</goals>
					</execution>
				</executions>

				<configuration>
					<transformSchemas>
						<transformSchema>
							<uri>https://www.example.org/employee</uri>
							<toPrefix>empns</toPrefix>
							<toFile>employee.xsd</toFile>
						</transformSchema>
						<transformSchema>
							<uri>https://www.example.org/address</uri>
							<toPrefix>addrns</toPrefix>
							<toFile>address.xsd</toFile>
						</transformSchema>
					</transformSchemas>
					<includes>
						<include>com/journaldev/bean/*</include>
					</includes>
					<verbose>true</verbose>

				</configuration>
			</plugin>
		</plugins>
	</build>
</project>

주목해야 할 사항은 jaxb 종속성, schemagen 실행 목표 및 transformSchema 구성입니다. transformSchema 구성은 생성된 XSD 파일 이름과 XSD 파일에서 사용할 네임스페이스 접두사를 지정하는 데 사용됩니다. 다음은 XSD를 생성하는 데 사용할 Java 클래스입니다. Employee.java

package com.journaldev.bean;


import javax.xml.bind.annotation.XmlAttribute;
import javax.xml.bind.annotation.XmlType;

@XmlType(namespace = "https://www.example.org/employee")
public class Employee {
    private String name;
    private int id;
    private String role;
    private Address address;


    public String getName() {
        return name;
    }


    public void setName(String name) {
        this.name = name;
    }


    @XmlAttribute
    public int getId() {
        return id;
    }


    public void setId(int id) {
        this.id = id;
    }


    public String getRole() {
        return role;
    }


    public void setRole(String role) {
        this.role = role;
    }


    public Address getAddress() {
        return address;
    }


    public void setAddress(Address address) {
        this.address = address;
    }
}

클래스에 사용된 네임스페이스와 필드 ID에 대한 XmlAttribute가 있는 XmlType 주석을 확인하십시오. 이 클래스는 프로젝트를 빌드하면 employee.xsd 스키마를 생성합니다. 보시다시피 또 다른 사용자 지정 클래스인 주소 필드가 있으므로 성공적인 스키마 생성을 위해 이 클래스에도 주석을 달아야 합니다. 다음은 jaxb 주석이 있는 주소 클래스입니다. 주소.자바

package com.journaldev.bean;

import javax.xml.bind.annotation.XmlType;

@XmlType(namespace = "https://www.example.org/address")
public class Address {
    private String city;
    private int zip;
    private String addressLine1;
    private String addressLine2;
    public String getCity() {
        return city;
    }
    public void setCity(String city) {
        this.city = city;
    }
    public int getZip() {
        return zip;
    }
    public void setZip(int zip) {
        this.zip = zip;
    }
    public String getAddressLine1() {
        return addressLine1;
    }
    public void setAddressLine1(String addressLine1) {
        this.addressLine1 = addressLine1;
    }
    public String getAddressLine2() {
        return addressLine2;
    }
    public void setAddressLine2(String addressLine2) {
        this.addressLine2 = addressLine2;
    }
    
}

이 클래스는 이름이 pom.xml 파일의 transformSchema와 일치하기 때문에 address.xsd를 생성합니다. 프로젝트 설정이 준비되었습니다. mvn clean install 명령을 사용하여 프로젝트를 빌드하면 XSD 파일이 생성됩니다. 내 프로젝트의 경우 생성된 XSD 파일은 다음과 같습니다. 직원.xsd

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<xs:schema xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns:addrns="https://www.example.org/address" targetNamespace="https://www.example.org/employee" version="1.0">

  <xs:import namespace="https://www.example.org/address" schemaLocation="address.xsd"/>

  <xs:complexType name="employee">
    <xs:sequence>
      <xs:element minOccurs="0" name="address" type="ns1:address"/>
      <xs:element minOccurs="0" name="name" type="xs:string"/>
      <xs:element minOccurs="0" name="role" type="xs:string"/>
    </xs:sequence>
    <xs:attribute name="id" type="xs:int" use="required"/>
  </xs:complexType>
</xs:schema>

<코드>주소.xsd

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

  <xs:complexType name="address">
    <xs:sequence>
      <xs:element minOccurs="0" name="addressLine1" type="xs:string"/>
      <xs:element minOccurs="0" name="addressLine2" type="xs:string"/>
      <xs:element minOccurs="0" name="city" type="xs:string"/>
      <xs:element name="zip" type="xs:int"/>
    </xs:sequence>
  </xs:complexType>
</xs:schema>

이것이 자바 클래스에서 XSD를 생성하기 위한 전부입니다. 자바 클래스에서 XSD 생성을 위한 매우 간단하고 훌륭한 방법입니다. 유용하고 이해하기 쉽기를 바랍니다.