JAXB

從 XSD 產生 VO

XML ←→ VO

Todo list

• @XmlSeeAlso 與 @XmlElementRef 的差別與使用時機。

• child element 有 attribute 的解法

通則

掛 @XmlRootElement 必須要有 empty constructor（不論哪種 modifier）

Marshal（XML→Java）

還沒有測試過用 XSD 產生 entity 檔案，以下是手動寫 entity 的心得。

class 掛 @XmlRootElement，如果 class name 跟 XML root name 不一樣，加 name = foo 來指定。

field 掛 @XmlElement，如果 field name 跟 XML tag name 不一樣，加 name = foo 來指定。 如果該 field 有 setter，field 就不能掛 @XmlElement、setter 也不用掛。 如果 setter 名字跟 tag name 不一樣的解決招數相同。

如果 field 的 data type 需要參考到 Foo 這個 class， Foo 必須有掛 @XmlRootElement。

至於 @XmlSeeAlso 的寫法：

@XmlSeeAlso(Foo.class)
public class Wtf {
    private Foo foo;
    public Foo getFoo() {}
    public void setFoo(Foo foo) {}
}

跟 @XmlElementRef 的寫法：

public class Wtf {
    private Foo foo;
    public Foo getFoo() {}

    @XmlElementRef
    public void setFoo(Foo foo) {}
}

好像都不需要... 也不確定哪個比較好 / 使用時機。

field / setter 如果掛 @XmlAttribute，則視為 root element 的 attribute。 （所以看起來如果 child element 有 attribute，就只能用 @XmlSeeAlso 的方法另外開一個 class？）

例外狀況 ###

目前測試的結果，只有 @XmlRootElement 的設定值跟 XML 對不上才會炸 exception， 如果 root 相同，其他 field 都對不上也不會怎樣，頂多值都是 null。

Unmarshal（Java→XML）

marshal 得到的 XML 未必可以成功 unmarshal 回 entity。例如：

@XmlRootElement
class Foo {
    private String str;

    public String getStr() { return str; }

    @XmlElement(name="str+")
    public void setStr1(String str) {
        this.str = str;
    }
}

在 marshal 的時候可以正常吐出 XML

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<foo>
    <str+>String</str+>
</foo>

但是拿這個 output 去 unmarshal 就會炸 SAXParseException。 因為 XML 標準中，element 的名稱不允許 +。 這似乎也表示 JAXB 在做 marshal 的時候，基本上就是單純的組字串...... ＝＝"