私はJAXBを使用してJavaクラスからXMLスキーマを生成しているので、他の開発者はJavaの知識がなくてもクラスのインスタンスを簡単に作成できます。
コードの関連部分は次のとおりです。
package-info.java
@XmlSchema(xmlns = @XmlNs(prefix = "p", namespaceURI = "http://mygame.com"),
namespace = "http://mygame.com")
package com.mygame.entity.properties;
import javax.xml.bind.annotation.XmlNs;
import javax.xml.bind.annotation.XmlSchema;
Model.class
package com.mygame.entity.properties;
@XmlType(name = "model", namespace = "http://mygame.com")
@XmlRootElement(name = "model", namespace = "http://mygame.com")
public class Model {
@XmlAttribute(required = true)
public String path;
public Model() {
}
}
Unit.class
@XmlType(name="unit", namespace="http://mygame.com")
@XmlRootElement(name="unit", namespace="http://mygame.com")
public class Unit extends GameObject {
}
GameObject.class
@XmlType(name = "gameobject", namespace = "http://mygame.com")
public abstract class GameObject extends Thing {
// Attributes
public Armor armor;
public Short maxHp;
public Boolean walkable = false;
public AbstractModel model;
}
Thing.class
@XmlType(name="thing", namespace="http://mygame.com")
public abstract class Thing {
// Constants
// Attributes
@XmlElement(required=false)
public String icon;
}
生成されたXMLスキーマ
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<xs:schema version="1.0" targetNamespace="http://mygame.com" xmlns:e="http://mygame.com" xmlns:s="http://mygame.com" xmlns:tns="http://mygame.com" xmlns:p="http://mygame.com" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="model" type="tns:model"/>
<xs:element name="unit" type="tns:unit"/>
<xs:complexType name="thing" abstract="true">
<xs:sequence>
<xs:element name="icon" type="xs:string" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="unit">
<xs:complexContent>
<xs:extension base="tns:gameobject">
<xs:sequence/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
<xs:complexType name="gameobject" abstract="true">
<xs:complexContent>
<xs:extension base="tns:thing">
<xs:sequence>
<xs:element ref="tns:armor" minOccurs="0"/>
<xs:element name="maxHp" type="xs:short" minOccurs="0"/>
<xs:element name="walkable" type="xs:boolean" minOccurs="0"/>
<xs:element ref="tns:model" minOccurs="0"/>
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
<xs:complexType name="model">
<xs:sequence/>
<xs:attribute name="path" type="xs:string" use="required"/>
</xs:complexType>
</xs:schema>
この時点まで、すべてが正常です。必要なXMLを正しく生成します(これらの迷惑なTNSプレフィックスを使用して考えられますが、それで問題ありません)。
問題は、UNITをアンマーシャリングしようとすると、いずれかのケースでエラーが発生することです。
ケース1-作業中
このXML入力が与えられると、すべてが正常に機能し、クラスのインスタンスが正しく取得されます。
<?xml version="1.0" encoding="UTF-8"?><tns:unit xmlns:tns="http://mygame.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="/home/shirkit/jMonkeyProjects/Fortress Wars/Core/schema/full.xsd">
<maxHp>100</maxHp>
<walkable>false</walkable>
<model path="Models/Oto/Oto.mesh.xml"/></tns:unit>
ケース2-機能しない
これを考えると、以下に説明するエラーが発生します
<?xml version="1.0" encoding="UTF-8"?><tns:unit xmlns:tns="http://mygame.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="/home/shirkit/jMonkeyProjects/Fortress Wars/Core/schema/full.xsd">
<maxHp>100</maxHp>
<walkable>false</walkable>
<tns:model path="Models/Oto/Oto.mesh.xml"/></tns:unit>
unexpected element (uri:"http://mygame.com", local:"model"). Expected elements are <{}icon>,<{}model>,<{}walkable>,<{}armor>,<{}maxHp>
2つのXML入力の唯一の違いは、一方には要素モデルがあり、もう一方には要素tns:modelがあることです。ケース2でこのエラーが発生する理由がわかりませんが、誰かに説明してもらえますか?