使用JAXB相关注意问题

最近在调快递接口的时候，因为大多数请求及返回值都是以xml格式进行的，所以需要用到工具来对xml和bean两者进行相互转化，这里用到了JAXB技术。

这里有对应的utils可以使用，点击查看。

我在调用的时候并没有用这个工具类，因为之前代码里有别人写好的工具类，用的也是JAXB，但是封装形式不一样，而且打在了jar包里，和其他类还有依赖，就不贴代码了，同事用了上面的代码也是可以实现的。

这里要注意以下几点

1. 要序列化的类加上 @XmlRootElement注解，否则会报错(错误提示很清晰，这里就不贴出来了)
2. JAXB序列化XML时  默认序列化getter和setter，且getter和setter必须成对出现才会被序列化
3. 属性名称，默认序列化出来的类和属性名称默认是首字母转换为小写，若需要控制属性名称需要在getter或setter上使用 @XmlElement(name="ClassAId") 指定名称，这里要注意的是@XmlElement放置在getter或setter上都行，但只能放一个，也就是说不能同时在getter和setter上使用@XmlElement注解
4. 如何控制根节点名称？
   使用@XmlRootElement指定name属性即可，如@XmlRootElement(name="ClassA")
5. 怎么添加命名空间 即使xml节点带有：，也是可以解决的
   使用@XmlRootElement(name = "CEB604Message", namespace = "http://www.chinaport.gov.cn/ceb")) 指定namespace属性
6. 怎么精确控制每个属性名称
   JAXB自动转化为首字母小写会导致不可预料的属性名称出现， 不嫌麻烦的话为每个属性设置@XmlElement(name="")，想省事的话使用Field
7. 怎么样实现序列化时使用Field字段而不是使用setter和getter
   在要使用的类上面加上@XmlAccessorType(XmlAccessType.FIELD)注解，并指定为XmlAccessType.FIELD，这里强烈推荐使用@XmlAccessorType(XmlAccessType.FIELD)注解，因为这样你可以精确的控制每个元素的名称，而不需要为每个属性去设置@XmlElement(name="")注解，当然也可以在Field上使用@XmlElement注解
8. XmlAccessorType 
   默认规则：
   默认情况下，如果包中不存在 @XmlAccessorType，那么假定使用以下包级别注释。
   @XmlAccessorType(XmlAccessType.PUBLIC_MEMBER)
   默认情况下，如果类中不存在 @XmlAccessorType，并且没有任何超类是使用 @XmlAccessorType 注释的，则假定在类中使用以下默认注释：
   @XmlAccessorType(XmlAccessType.PUBLIC_MEMBER)
   可能值：
   FIELD:    JAXB 绑定类中的每个非静态、非瞬态字段将会自动绑定到 XML，除非由 XmlTransient 注释。
   NONE:     所有字段或属性都不能绑定到 XML，除非使用一些 JAXB 注释专门对它们进行注释。
   PROPERTY: JAXB 绑定类中的每个获取方法/设置方法对将会自动绑定到 XML，除非由 XmlTransient 注释。
   PUBLIC_MEMBER:每个公共获取方法/设置方法对和每个公共字段将会自动绑定到 XML，除非由 XmlTransient 注释。
9. 当报错时，Exception in thread “main” com.sun.xml.internal.bind.v2.runtime.IllegalAnnotationsException:
   2 counts of IllegalAnnotationExceptions或者是有两个名为 "**" 的属性,类的两个属性具有相同名称 "**""，这时我们就要用到另一个注释：@XmlTransient，用来防止映射使用@XmlTransient注释的字段或者javabean的属性，从而解决名称冲突。
   具体的用法是将@XmlElement和@XmlTransient分别加到javabean属性前和对应的getter方法前，就可以正常转换了。