> For the complete documentation index, see [llms.txt](https://www.psmonkey.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.psmonkey.org/ruan-ti-kai-fa/java/jaxb.md).

# 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 的時候，基本上就是單純的組字串...... ＝＝"