JAXB解析xml 的注解说明

1.将 xml 文件中的各个节点和属性信息创建对应的Java模型

2.在Java模型中的创建与 xml 文件对应的节点和属性需要用注解来表示
@XmlRootElement   将一个Java类映射为一段XML的根节点
参数:
name  定义这个根节点的名称
    namespace   定义这个根节点命名空间

@XmlAccessorType  定义映射这个类中的何种类型需要映射到XML。可接收四个参数,分别是:
XmlAccessType.PROPERTY:映射这个类中的属性(get/set方法)到XML
XmlAccessType.PUBLIC_MEMBER:将这个类中的所有public的field或property同时映射到XML(默认)
XmlAccessType.NONE:不映射

@XmlElement  指定一个字段或get/set方法映射到XML的节点。如,当一个类的XmlAccessorType 被标注为PROPERTY时,在某一个没有get/set方法的字段上标注此注解,即可将该字段映射到XML。
参数:
defaultValue  指定节点默认值
name          指定节点名称
namespace     指定节点命名空间
    required     是否必须(默认为false)
    nillable     该字段是否包含 nillable="true" 属性(默认为false)
    type        定义该字段或属性的关联类型

@XmlAttribute  指定一个字段或get/set方法映射到XML的属性。
参数:
name             指定属性名称
namespace    指定属性命名空间
required         是否必须(默认为false)

@XmlTransient  定义某一字段或属性不需要被映射为XML。
如,当一个类的XmlAccessorType 被标注为PROPERTY时,在某一get/set方法的字段上标注此注解,那么该属性则不会被映射。

@XmlType  定义映射的一些相关规则
参数:
propOrder        指定映射XML时的节点顺序
factoryClass     指定UnMarshal时生成映射类实例所需的工厂类,默认为这个类本身
factoryMethod  指定工厂类的工厂方法
name               定义XML Schema中type的名称 
namespace      指定Schema中的命名空间

@XmlElementWrapper  为数组元素或集合元素定义一个父节点。
如,类中有一元素为List items,若不加此注解,该元素将被映射为
    <items>...</items>
    <items>...</items>
这种形式,此注解可将这个元素进行包装,如:
    @XmlElementWrapper(name="items")
    @XmlElement(name="item")
    public List items;
将会生成这样的XML样式:
    <items>
        <item>...</item>
        <item>...</item>
    </items>

@XmlJavaTypeAdapter  自定义某一字段或属性映射到XML的适配器。
如,类中包含一个接口,我们可以定义一个适配器(继承自 javax.xml.bind.annotation.adapters.XmlAdapter类),指定这个接口如何映射到XML。

@XmlSchema 配置整个包的namespace,这个注解需放在package-info.java文件中
    <items>...</items>
这种形式,此注解可将这个元素进行包装,如:
    @XmlElementWrapper(name="items")
    @XmlElement(name="item")
    public List items;
将会生成这样的XML样式:
    <items>
        <item>...</item>
        <item>...</item>
    </items>

@XmlJavaTypeAdapter  自定义某一字段或属性映射到XML的适配器。
如,类中包含一个接口,我们可以定义一个适配器(继承自 javax.xml.bind.annotation.adapters.XmlAdapter类),指定这个接口如何映射到XML。

@XmlSchema 配置整个包的namespace,这个注解需放在package-info.java文件中
        <item>...</item>
    </items>

@XmlJavaTypeAdapter  自定义某一字段或属性映射到XML的适配器。
如,类中包含一个接口,我们可以定义一个适配器(继承自 javax.xml.bind.annotation.adapters.XmlAdapter类),指定这个接口如何映射到XML。

@XmlSchema 配置整个包的namespace,这个注解需放在package-info.java文件中

3.示例代码
//Java Entity
@XmlAccessorType(XmlAccessType.FIELD)
@XmlRootElement(name = "automation")
public class JavaBean
{
    @XmlAttribute(name = "service")
    private String serviceName;
    
    @XmlElementWrapper(name = "rules")
    @XmlElement(name = "rule")
    private List<Rule> rules;
    
    @XmlElementWrapper(name = "actions")
    @XmlElement(name = "action")
    private List<Action> actions;
    
    public List<Rule> getRules()
    {
        return rules;
    }
    
    public String getServiceName()
    {
        return serviceName;
    }
    
    public void setServiceName(String serviceName)
    {
        this.serviceName = serviceName;
    }
    
    public void setRules(List<Rule> rules)
    {
        this.rules = rules;
    }
    
    public List<Action> getActions()
    {
        return actions;
    }
    
    public void setActions(List<Action> actions)
    {
        this.actions = actions;
    }
}
//ObjectFactory
@XmlRegistry
public class ObjectFactory
{
    private final static QName _Configurations_SCALERULE_QNAME = new QName(
            "http://www.huawei.com/cloudCube/cloudview", "entities");
    
    public ObjectFactory()
    {
    }
    
    public Action createAction()
    {
        return new Action();
    }
    
    public ActionProperty createActionProperty()
    {
        return new ActionProperty();
    }
    
    public JavaBean createJavaBean()
    {
        return new JavaBean();
    }
    
    public Dimension createDimension()
    {
        return new Dimension();
    }
    
    public Rule createRule()
    {
        return new Rule();
    }
    
}
//解析
public static Object unmarshal(InputStream input, String classPath,
            String schemaResPath, ClassLoader classLoader)
            throws JAXBException, SAXException
    {
        JAXBContext jaxbContext = JAXBContext.newInstance(classPath,
                classLoader);
        
        SchemaFactory schemaFactory = SchemaFactory.newInstance(XMLConstants.W3C_XML_SCHEMA_NS_URI);
        
        Unmarshaller unmarshaller = jaxbContext.createUnmarshaller();
        
        if (schemaResPath != null && !schemaResPath.isEmpty())
        {
            URL schemaURL = classLoader.getResource(schemaResPath);
            Schema schema = schemaFactory.newSchema(schemaURL);
            unmarshaller.setSchema(schema);
        }
        Object obj = unmarshaller.unmarshal(input);
        return obj;
    }
//转换
public static Object convertor(String fi) throws Exception
    {
        ClassLoader classLoader = ObjectFactory.class.getClassLoader();
        String contextPath = ObjectFactory.class.getPackage().getName();
        File file = new File(fi);
        if (!file.isDirectory())
        {
            InputStream input = new FileInputStream(file);
            JavaBean bean = (JavaBean) XMLMarshallUtil.unmarshal(input,
                    contextPath,
                    null,
                    classLoader);
            return bean;
        }
        else
        {
            File[] fs = file.listFiles();
            List<Object> list = new ArrayList<Object>();
            for (int i = 0; i < fs.length; i++)
            {
                InputStream input = new FileInputStream(fs[i]);
                JavaBean bean = (JavaBean) XMLMarshallUtil.unmarshal(input,
                        contextPath,
                        null,
                        classLoader);
                list.add(bean);
            }
            return list;
        }
    }
//main函数
public static void main(String[] args) throws Exception
    {
        Object obj = Test.convertor("bin/conf/");
        if (obj instanceof JavaBean)
        {
            JavaBean bean = (JavaBean) obj;
            System.out.println(bean.getServiceName());
        }
        if (obj instanceof List<?>)
        {
            List<JavaBean> list = (List<JavaBean>) obj;
            for (JavaBean bean : list)
            {
                System.out.println(bean.getActions().get(1).getActionName());
            }
        }
    }

4.解析过程中出现异常
1)解析文件中JAXBContext.newInstance(Service.class)创建新的实例错误,正确的是 (ServiceMetric.class)
javax.xml.bind.UnmarshalException
- with linked exception:
[java.io.IOException: Stream closed]
2)使用 StreamSource 类出现的异常

StreamSource streamSource = new StreamSource(read);
    root = (Service) um.unmarshal(streamSource);
javax.xml.bind.UnmarshalException
- with linked exception:
[org.xml.sax.SAXParseException: Premature end of file.]
3)解析过程中返回的对象中有引用类型的属性,需要将里面所有的引用类型属性,全都实例化(ObjectFactory作用)。

Exception in thread "main" javax.xml.bind.JAXBException: "bean.javaBean" doesnt contain ObjectFactory.class or jaxb.index

原文地址:https://www.cnblogs.com/liushuchen/p/10270606.html

时间: 2024-08-15 07:01:38

JAXB解析xml 的注解说明的相关文章

JAXB解析XML为对象

JAXB支持注解将XML转化为对象,具体看一个简单的例子: <?xml version="1.0" encoding="utf-8"?> <Api> <algos> <!-- 算法类型 --> <algo name="YYFY" text="运营费用"> </algo> </algos> </Api> XML对应的pojo对象: p

Jaxb解析XML

传统方式下,我们都是通过dom4j或者jdom方式来解析xml,一般都是将整个xml解析成内存中的document,再分层次遍历document树,这样有以下几个不好的地方,首先是占内存,还有就是代码死板,不能针对通用的xml进行解析,但是Jaxb却不一样,可以针对任何类型的xml进行解析,即使xml发生改变,可以只用该少量的代码,而不用更改代码逻辑,具体方法如下: 1,生成xsd 首先,我们按照现有的xml文件生成改文件对应的xsd文件,方法是采用xsd.exe方式,这个exe文件由微软提供,

1-spring xml 和 注解 解析过程

spring mvc 入口 DispatcherServlet,类关系图如下所示 DispatcherServlet 就是一个 Servlet,那Servlet 的初始化方法 init()在哪里,通过类图可知,可以查看 HttpServletBean 中的 init() 方法,进行 Servlet初始化. xml解析和注解 解析入口 经过一些xml和spring 初始化配置加载后,进入AbstractApplicationContext#refresh()方法 ConfigurableLista

利用Xstream注解生成和解析xml

实体类: @XStreamAlias("person") public class PersonBean {     @XStreamAlias("firstName")     private String firstName;     @XStreamAlias("lastName")     private String lastName;       @XStreamAlias("telphone")     priv

XML学习笔记(二):使用 DOM和SAX 解析XML :

一.XML解析的简介 1.一般来说xml解析的方式有两种,Dom与SAX,且各有优缺点.pull是第三种方法见:pull解析XML 1)DOM:dom对象树 ①.整个XML放入内存,转换为Document对象: ②.每个元素,转换成Element对象 ③.文本,转换成Text对象 ④.属性,转换成Attribute对象 优缺点:元素的CRUD比较简单,但是内存消耗大,大的xml文档不适合. 补充:内存不足时,可以修改参数,调整JVM的内存大小 1.java.lang.OutOfMemoryErr

XStream解析xml和json

XStream是一个在我看来比较好的一个第三方包了.因为它在解析时支持注解.这样很是方便,并且xml跟json这两种格式的文件都能进行解析,XStream本属于java的一个第三方包,甚是好用,若是拿它在android开发环境,也是能正常解析,但有点美中不足,因为android开发环境时,XStream不太支持json转对象,只支持对象转json,其他xml与对象的互转都支持.这样的话双解析就有了那么一点瑕疵之处,不过话说回来,没多少需求的数据交互会用json跟xml切来切去的,当只是json转

JAXB学习(二): 对JAXB支持的主要注解的说明

我们在上一篇中对JAXB有了一个大致的认识,现在我们来了解JAXB的一些主要注解. 顶层元素:XmlRootElement 表示整个XML文档的类应该使用XmlRootElement修饰,其实就像之前那个简单例子那样,XmlRootElement也是最简单JAXB应用唯一需要用到的注解. 控制元素的选择:XmlAccessorType XmlTransient 如果JAXB绑定一个java类为XML,那么默认的会绑定所有public成员,包括 public的getter和setter对(必须同时

Spring中管理Bean以及解析XML

Spring是分层的轻量级框架 以IoC(Inverse of Control 反转控制)和AOP(Aspect Oriented Programming 面向切面编程)为核心 应用Spring的好处: 方便解耦,简化开发 Spring就是一个大工厂,可以将所有对象创建和依赖关系维护,交给Spring管理 AOP编程的支持 Spring提供面向切面编程,可以方便的实现对程序进行权限拦截.运行监控等功能 声明式事务的支持 只需要通过配置就可以完成对事务的管理,而无需手动编程 方便集成各种优秀框架

XStream解析XML文本并用反射机制转换为对象

xml文本格式是网络通信中最常用的格式,最近特别研究了一下如何解析xml文本并转换为对象,现在分享一下我最近的学习成果~ 先列一下本例中需要解析的xml文本: Xml代码   <results name="list"> <row pubtime="2016-04-13 16:40:13" author="APP"  id="140" title="什么是公告" content="