← Zurück zum Blog

Java: Java-Klassen aus einer DTD-Datei erzeugen

Übersetzter Artikel. Original lesen

Einleitung

Aus einer DTD-Datei sollen die passenden Java-Klassen entstehen. Statt den Code von Hand zu schreiben, verwenden wir den integrierten XML-Binding-Compiler xjc.

Java XML Binding Compiler

Die Hilfe des Befehls xjc sieht so aus:

Usage: xjc [-options ...] <schema_file/URL/dir> ... [-b <bindinfo>] ...
Options:
 -nv                  : do not perform strict validation of the input schema(s)
 -extension           : allow vendor extensions - do not strictly follow the
                        Compatibility Rules and App E.2 from the JAXB Spec
 -b <file/dir>        : specify external bindings files (each <file> must have its own -b)
                        If a directory is given, **/*.xjb is searched
 -d <dir>             : generated files will go into this directory
 -p <pkg>             : specifies the target package
 -httpproxy <proxy>   : set HTTP/HTTPS proxy. Format is [user[:password]@]proxyHost:proxyPort
 -httpproxyfile <file>: set the proxy string (same format as above).
 -classpath <arg>     : specify where to find user class files
 -catalog <file>      : specify catalog files to resolve external entity references
                        support TR9401, XCatalog, and OASIS XML Catalog format.
 -readOnly            : generated files will be in read-only mode
 -npa                 : suppress generation of package level annotations (**/package-info.java)
 -no-header           : suppress generation of a file header with timestamp
 -target 2.0          : behave like XJC 2.0 and generate code that doesnt use any 2.1 features.
 -xmlschema           : treat input as W3C XML Schema (default)
 -relaxng             : treat input as RELAX NG (experimental,unsupported)
 -relaxng-compact     : treat input as RELAX NG compact syntax (experimental,unsupported)
 -dtd                 : treat input as XML DTD (experimental,unsupported)
 -wsdl                : treat input as WSDL and compile schemas inside it (experimental,unsupported)
 -verbose             : be extra verbose
 -quiet               : suppress compiler output
 -help                : display this help message
 -version             : display version information

Quelle: Oracle

Der Parameter -dtd legt eine DTD als Eingabeformat fest.

Beispiel-DTD

Die folgende DTD wird als example.dtd gespeichert:

<!ELEMENT people_list (person)*>
<!ELEMENT person (name, birthdate?, gender?, socialsecuritynumber?)>
<!ELEMENT name (#PCDATA)>
<!ELEMENT birthdate (#PCDATA)>
<!ELEMENT gender (#PCDATA)>
<!ELEMENT socialsecuritynumber (#PCDATA)>

Beispiel-DTD aus der Wikipedia

Java-Klassen aus der DTD erzeugen

xjc -dtd -d targetDirectoy example.dtd

In unserem Fall sieht der Aufruf ungefähr so aus:

xjc -dtd -d /Users/myUser/Development/Java/DTDExample/ example.dtd
parsing a schema...
compiling a schema...
generated/ObjectFactory.java
generated/PeopleList.java
generated/Person.java
Laptop:DTDExample myUser$ cd generated
Laptop:generated myUser$ ls
ObjectFactory.java	PeopleList.java		Person.java

Mit -p your.package kann zusätzlich das Package angegeben werden. Es wird automatisch in die generierten Java-Klassen eingetragen.