Overview

Option category

• java
• java.jaxp
• java.xml
• java.pattern

Option list

The Java generator supports various options shown in Table 7.1.2.1[Java options].

Formal name of options would be pretty long to represent meaning of option. To specify options more conveniently, some options has nick names shown as Table 7.1.2.2[Nicknames].

Base Schema

In the reference manual, two types of schemas are used. One is a plain shcema, which does not use a namespace. Another one is a namespace schema, which uses a namespace.

If nessesary, these base schemas are altered for explanatory purposes. You can recognize more deeply to see what part of a schema is modified for explanation.

Plain

List 7.1.3.1.1[base.rng] is a base schema that does not use a namespace. This schema is used because it is simple enough to recognize and complex enough to explain an option's feature.

<grammar xmlns="http://relaxng.org/ns/structure/1.0"
         datatypeLibrary="http://www.w3.org/2001/XMLSchema-datatypes">
  <start>
    <ref name="account"/>
  </start>
  <define name="account">
    <element name="account">
      <attribute name="accountNo">
        <data type="token"/>
      </attribute>
      <element name="balance">
        <data type="int"/>
      </element>
      <element name="owner">
        <data type="token"/>
      </element>
      <optional>
        <ref name="address"/>
      </optional>
      <zeroOrMore>
        <ref name="phone"/>
      </zeroOrMore>
    </element>
  </define>
  <define name="address">
    <element name="address">
      <attribute name="zip">
        <data type="token"/>
      </attribute>
      <text/>
    </element>
  </define>
  <define name="phone">
    <element name="phone">
      <attribute name="area">
        <data type="token"/>
      </attribute>
      <data type="token"/>
    </element>
  </define>
</grammar>

List 7.1.3.1.2[base.xml] is an XML document that is valid with regard to the schema.

<account accountNo="12345">
  <balance>102030</balance>
  <owner>XML Taro</owner>
  <address zip="213">Yokohama</address>
  <phone area="123">456-7890</phone>
  <phone area="090">123-4567</phone>
</account>

Namespace

List 7.1.3.2.1[baseNs.rng] is a base schema that uses a namespace. This schema is an extension from the plain schema shown in List 7.1.3.1.1[base.rng]. The namespace name is http://example.com/account, which is specified in the element grammar.

This schema is used when a namespace is an importernt factor.

<grammar xmlns="http://relaxng.org/ns/structure/1.0"
         datatypeLibrary="http://www.w3.org/2001/XMLSchema-datatypes"
         ns="http://example.com/account">
  <start>
    <ref name="account"/>
  </start>
  <define name="account">
    <element name="account">
      <attribute name="accountNo">
        <data type="token"/>
      </attribute>
      <element name="balance">
        <data type="int"/>
      </element>
      <element name="owner">
        <data type="token"/>
      </element>
      <optional>
        <ref name="address"/>
      </optional>
      <zeroOrMore>
        <ref name="phone"/>
      </zeroOrMore>
    </element>
  </define>
  <define name="address">
    <element name="address">
      <attribute name="zip">
        <data type="token"/>
      </attribute>
      <text/>
    </element>
  </define>
  <define name="phone">
    <element name="phone">
      <attribute name="area">
        <data type="token"/>
      </attribute>
        <data type="token"/>
    </element>
  </define>
</grammar>

There are two sort of XML documents to explain. One is not using a prefix. Another one is using a prefix.

List 7.1.3.2.2[baseNs.xml] is an XML document for the shcema. In this document, an explicit prefix is not used. The namespace is declared as a default namespace with http://example.com/account.

<account xmlns="http://example.com/account" accountNo="12345">
  <balance>102030</balance>
  <owner>XML Taro</owner>
  <address zip="213">Yokohama</address>
  <phone area="123">456-7890</phone>
  <phone area="090">123-4567</phone>
</account>

When a prefix is an important issue, List 7.1.3.2.3[baseNsPrefix.xml] is also used for a document. In the document, prefix z is declared with the namespace http://example.com/account.

<z:account xmlns:z="http://example.com/account" accountNo="12345">
  <z:balance>102030</z:balance>
  <z:owner>XML Taro</z:owner>
  <z:address zip="213">Yokohama</z:address>
  <z:phone area="123">456-7890</z:phone>
  <z:phone area="090">123-4567</z:phone>
</z:account>

Java

List 7.1.3.3.1[Base.java] is a Java program that explains target features. This program composed of three static methods, main, makeAccount, and printAccount.

The main method is a main routine for the program. The method handles command line parameters and controls work flows.

The makeAccount method creates an instance of the Relaxer object Account. When such an option is related to object creation, this method will be modified.

The printAccount method prints the contents of the Account object. This method demonstrates effects of the option.

The showAccount method prints an Relaxer Object itself. Normally an XML document is showed.

import java.io.IOException;
import javax.xml.parsers.ParserConfigurationException;
import org.xml.sax.SAXException;

public class Base {
    public static void main(String[] args)
	throws IOException, SAXException, ParserConfigurationException {

	String uri = args[0];
	Account account = makeAccount(uri);
	printAccount(account);
	showAccount(account);
    }

    private static Account makeAccount(String uri)
	throws IOException, SAXException, ParserConfigurationException {

	System.out.println("*** makeAccount ***");
	Account account = new Account(uri);
	return (account);
    }

    private static void printAccount(Account account) {
	System.out.println("*** printAccount ***");
	String accountNo = account.getAccountNo();
	long balance = account.getBalance();
	String owner = account.getOwner();
	System.out.println("AccountNo:" + accountNo);
	System.out.println("Balance:" + balance);
	System.out.println("Owner:" + owner);
	Address address = account.getAddress();
	if (address != null) {
	    String zip = address.getZip();
	    String place = address.getContent();
	    System.out.println("Address: [" + zip + "] " + place);
	}
	Phone[] phones = account.getPhone();
	for (int i = 0;i < phones.length;i++) {
	    Phone phone = phones[i];
	    String area = phone.getArea();
	    String number = phone.getContent();
	    System.out.println("Phone: [" + area + "] " + number);
	}
    }

    private static void showAccount(Account account) {
	System.out.println("*** showAccount ***");
	System.out.println("XML:" + account);
    }
}