xml
xml 是 java 實現的 xml 框架。
希望以最優雅的方式進行 xml 和 java 之間的轉換處理,一行代碼搞定一切。
特點
-
對象的和 xml 的互相映射
-
支持註解
@Alias
指定別名 - 支持註解
@Ignore
指定忽略的字段
變更日誌
快速開始
準備
jdk 1.7+
maven 3.x+
maven 引入
<dependency>
<groupId>com.github.houbb</groupId>
<artifactId>xml-mapping</artifactId>
<version>0.0.3</version>
</dependency>
轉換爲 xml
User user = defaultUser();
String xml = XmlMappingBs.newInstance().toXml(user);
User 參見類 User.java
轉換爲 java 對象
XML 爲對應的 xml 字符串內容。
User user = XmlMappingBs.newInstance().toBean(XML, User.class);
指定別名
註解說明
@Alias
可以放在指定類和字段上,用於指定我們想要的別稱信息。
使用案例
- 對象定義
@Alias("user")
public class AliasUser {
@Alias("nickname")
private String name;
private String hobby;
}
- 測試代碼
AliasUser user = defaultAliasUser();
String xml = XmlMappingBs.newInstance().toXml(user);
詳情參見 XmlMappingBsAliasTest.java
- 生成效果
<?xml version="1.0" encoding="UTF-8"?>
<user>
<nickname>hello</nickname>
<hobby>world</hobby>
</user>
忽略指定字段
說明
有時候我們希望某些字段不參與 xml 的轉換,那麼可以通過 @Ignore
指定忽略的字段。
使用案例
- 對象定義
public class IgnoreUser {
private String name;
@Ignore
private String hobby;
}
- 測試代碼
和原來使用完全相同,詳情參見 XmlMappingBsIgnoreTest.java
IgnoreUser user = defaultIgnoreUser();
String xml = XmlMappingBs.newInstance().toXml(user);
結果
<?xml version="1.0" encoding="UTF-8"?>
<IgnoreUser>
<name>hello</name>
</IgnoreUser>