1. @Retention(value=RUNTIME)
  2. @Target(value=TYPE)
  3. public @interface XmlRootElement
  4. @Inherited
  5. @Retention(value=RUNTIME)
  6. @Target(value={PACKAGE,TYPE})
  7. public @interface XmlAccessorType

XmlRootElement: 将类或枚举类型映射到 XML 元素。JAXB中的注解,用来根据java类生成xml内容。

当使用 @XmlRootElement 注释对顶层类或枚举类型进行注释时,类型值被表示为 XML 文档中的 XML 元素。

JAXB Annotation

  • @XmlRootElement   // xml 文件的根元素
  • @XmlElement
  • @XmlAccessorType  // 控制默认情况下是否对字段或 Javabean 属性进行系列化。
  • @XmlTransient
  • @XmlJavaTypeAdaptor:参考Using JAXB 2.0's XmlJavaTypeAdapter

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 注释。

应用参考:http://blog.sina.com.cn/s/blog_4051f5dc0100ju0a.html

  1. package jaxb;
  2. import javax.xml.bind.annotation.XmlAccessorType;
  3. import javax.xml.bind.annotation.XmlRootElement;
  4. import javax.xml.bind.annotation.XmlAccessType;
  5. @XmlRootElement // 必须要标明这个元素
  6. @XmlAccessorType(XmlAccessType.FIELD)
  7. public class Boy {
  8. String name = "CY";
  9. }
  10. package jaxb;
  11. import java.io.StringReader;
  12. import javax.xml.bind.JAXBContext;
  13. import javax.xml.bind.JAXBException;
  14. import javax.xml.bind.Marshaller;
  15. import javax.xml.bind.Unmarshaller;
  16. public class JAXBTest {
  17. public static void main(String[] args) throws JAXBException {
  18. JAXBContext context = JAXBContext.newInstance(Boy.class);
  19. Marshaller marshaller = context.createMarshaller();
  20. Unmarshaller unmarshaller = context.createUnmarshaller();
  21. Boy boy = new Boy();
  22. marshaller.marshal(boy, System.out);
  23. System.out.println();
  24. String xml = "<boy><name>David</name></boy>";
  25. Boy boy2 = (Boy) unmarshaller.unmarshal(new StringReader(xml));
  26. System.out.println(boy2.name);
  27. }
  28. }

执行结果: 
<?xml version="1.0" encoding="UTF-8" standalone="yes"?><boy><name>CY</name></boy> 
David 
(先 是marshall成 xml文件,再是把 xml 文件 unmarshal 成 java object。)

改动一: 
修改@XmlAccessorType(XmlAccessType.FIELD)  --> @XmlAccessorType(XmlAccessType.PROPERTY) 
意思是只有 属性 才能被转换成 xml 中的标签。

所以再运行的结果是: 
<?xml version="1.0" encoding="UTF-8" standalone="yes"?><boy/> 
CY 
就是说 java object 转换成 xml 的时候,name 不是属性(因为没有 get set方法),所以name不转换成标签。

改动二: 
在 改动一 的基础上,给name属性添加 get set 方法。 再运行,结果为: 
<?xml version="1.0" encoding="UTF-8" standalone="yes"?><boy><name>CY</name></boy> 
David 
由 此 可见 @XmlAccessorType 这个annotation 的作用。

改动三: 
在改动二 的基础上,给Boy 再添加一个field, int age=10, 即:

  1. package jaxb;
  2. import javax.xml.bind.annotation.XmlAccessorType;
  3. import javax.xml.bind.annotation.XmlRootElement;
  4. import javax.xml.bind.annotation.XmlAccessType;
  5. @XmlRootElement
  6. @XmlAccessorType(XmlAccessType.PROPERTY)
  7. public class Boy {
  8. String name = "CY";
  9. int age = 10;
  10. public String getName() {
  11. return name;
  12. }
  13. public void setName(String name) {
  14. this.name = name;
  15. }
  16. }

显然,这个age 是不会被 转化 到xml 文件中的。解决办法是:

  1. import javax.xml.bind.annotation.XmlAccessorType;
  2. import javax.xml.bind.annotation.XmlElement;
  3. import javax.xml.bind.annotation.XmlRootElement;
  4. import javax.xml.bind.annotation.XmlAccessType;
  5. @XmlRootElement // bixude
  6. @XmlAccessorType(XmlAccessType.PROPERTY)
  7. public class Boy {
  8. String name = "CY";
  9. @XmlElement
  10. int age = 10;
  11. public String getName() {
  12. return name;
  13. }
  14. public void setName(String name) {
  15. this.name = name;
  16. }
  17. }

加上 @XmlElement annotation. 运行结果为: 
<?xml version="1.0" encoding="UTF-8" standalone="yes"?><boy><age>10</age> <name>CY</name></boy> 
David

对于根元素,可以设置属性: 
@XmlRootElement(name="b" nameSpace="http://test") 
这样,在生成的xml文件中,<boy> 标签 就会变为 <b> 标签。并且加上一个命名空间。

下面解释 @XmlJavaTypeAdaptor 的作用:

  1. @XmlRootElement
  2. @XmlAccessorType(XmlAccessType.PROPERTY)
  3. public class Boy {
  4. private String name = "CY";
  5. private Address address; // 是一个接口
  6. public String getName() {
  7. return name;
  8. }
  9. public void setName(String name) {
  10. this.name = name;
  11. }
  12. }

在 java object 转换成 xml 的时候,接口Address 无法被转换。 
所以 这里要加上 @XmlJavaTypeAdapter(AddressAdapter.class) 
所以 要多写一个AddressAdaptor 类。 
这个类会返回Address接口的一个具体实现类的对象。

这 就是 @XmlJavaTypeAdapter 的作用。

JAXB注解 @XmlRootElement 及XML文件解析详解的更多相关文章

  1. Android学习笔记之AndroidManifest.xml文件解析(详解)

    一.关于AndroidManifest.xml AndroidManifest.xml 是每个android程序中必须的文件.它位于整个项目的根目录,描述了package中暴露的组件(activiti ...

  2. 史上最全的maven pom.xml文件教程详解

    <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/20 ...

  3. 【maven】 maven的setting.xml文件的详解

    1       Maven的安装 安装Maven之前要确保已经安装好了jdk,并且配置好了环境变量JAVA_HOME.具体安装步骤如下: 从apache网上下载maven项目的压缩包.下载地址为:ht ...

  4. web.xml文件配置详解以及实例说明

    1.web.xml学名叫部署描述符文件,是在Servlet规范中定义的,是web应用的配置文件. 2.部署描述符文件就像所有XML文件一样,必须以一个XML头开始.这个头声明可以使用的XML版本并给出 ...

  5. [安卓学习]AndroidManifest.xml文件内容详解

    一,重要性 AndroidManifest.xml是Android应用程序中最重要的文件之一.它是Android程序的全局配置文件,是每个 android程序中必须的文件.它位于我们开发的应用程序的根 ...

  6. AndroidManifest.xml文件综合详解(转)

    一,重要性AndroidManifest.xml是Android应用程序中最重要的文件之一.它是Android程序的全局配置文件,是每个 android程序中必须的文件.它位于我们开发的应用程序的根目 ...

  7. Android的AndroidManifest.xml文件的详解

    一.关于AndroidManifest.xml AndroidManifest.xml 是每个android程序中必须的文件.它位于整个项目的根目录,描述了package中暴露的组件(activiti ...

  8. [转]xxx.hbm.xml文件配置详解

    潜龙写 xml代码: <?xml version="1.0"?> <!DOCTYPE hibernate-mapping PUBLIC "-//Hibe ...

  9. yaml文件解析详解

    前言 yaml文件是什么?yaml文件其实也是一种配置文件类型,相比较ini,conf配置文件来说,更加的简洁,操作也更加简单,同时可以存放不同类型的数据,不会改变原有数据类型,所有的数据类型在读取时 ...

随机推荐

  1. 从Nexus私服下载和上传资源(一)

    从私服中下载资源 首先要明确将资源下载到哪里 找到maven 配置文件settings.xml 文件,添加如下配置:1.添加镜像配置:将所有访问外网仓库的请求指向私服: <mirror> ...

  2. Fragment与Activity之间的相互通信

    https://blog.csdn.net/u012702547/article/details/49786417 https://blog.csdn.net/carson_ho/article/de ...

  3. 之手算KD-tree

    转自:https://zhuanlan.zhihu.com/p/27453420 本文来源于Machine Learning: Clustering & Retrieval | Courser ...

  4. char *与const char **函数参数传参问题

    传参方法 ## 函数 extern void f2 ( const char ** ccc ); const char ch = 'X'; char * ch_ptr; const char ** c ...

  5. redis学习笔记(面试题)

    1. 什么是redis Redis是一个数据库,他和我们传统的oracle数据库差别是它是基于内存的数据库:因为是基于内存,所以效率就高,在某些场景下就可以对我们传统的关系型数据库做一个补充 2. r ...

  6. windows系统上搭建redis集群哨兵及主从复制

    搭建master 修改redis配置redis.windows.conf: 修改监听端口:  port 26379 修改绑定IP: bind 127.0.0.1 添加redis日志:logfile & ...

  7. 017_nginx重定向需求

    重定向的各种需求 需求一. 前端同事需要把特定的url进行重定向,实现如下: location / { root /data/base.apiportal_opsweb; index index.ht ...

  8. sipML5聊天功能实现

    一.环境说明:在阅读sipML5的API文档时,发现它具有聊天的功能,于是在sipML5的源码中进行设定,实现了注册之后可以英文聊天(中文聊天需要在FreeSWITCh中进行设定). 二.具体配置: ...

  9. 取消Eclipse控制台显示行数的限制

    --------------------------------------------------------------------------------------------------- ...

  10. Mac配置Java开发环境

    笔者从Window上转到Mac上做开发,一切配置都要重新开始,开发环境配置介绍如下: 1. 下载JDK 从下面链接选择合适版本的安装包进行下载...笔者下载的是jdk-9.0.1 链接:http:// ...