JAXB（Java Architecture for XML Binding）下载、使用

2023-09-21 16:48:41

简介

JAXB（Java Architecture for XML Binding）就是XML数据绑定的java架构。JAXB可以根据XML Schema生成java类，也能根据java类生成XML Schema，XML数据绑定指定了XML请求和XML响应如何映射成java对象。
JAXB提供了API和工具，可以自动在XML文档和java对象之间映射。

JAXB框架可以使开发者进行如下操作：

  • 将XML内容解包为java表示。
  • 访问和更新java表示。
  • 将java表示的XML内容打包回XML内容。

JAXB为开发者提供了一个高效、标准的方式来映射XML和java代码。java开发者的效率可以更高，因为他们可以写更少的代码，而且不必是XML专家。JAXB使开发者结合XML和Web服务技术更加容易扩展他们的应用。

各版本参考资源

JAXB 2.0版本参考资源

https://jcp.org/en/jsr/detail?id=222
在这里插入图片描述
JAXB 2.3版本详情页：
https://jcp.org/aboutJava/communityprocess/mrel/jsr222/index3.html
在这里插入图片描述

从该页面可以下载规范文档、和javadoc文档：
在这里插入图片描述
在这里插入图片描述
JAXB 2.3版本规范：
https://download.oracle.com/otn-pub/jcp/jaxb-2_3-mrel3-eval-spec/JAXB-2.3-spec.pdf
在这里插入图片描述

JAXB 3.0版本参考资源

https://jakarta.ee/specifications/xml-binding/3.0/
在这里插入图片描述

JAXB 4.0版本参考资源

https://jakarta.ee/specifications/xml-binding/4.0/
在这里插入图片描述

JAXB参考实现

旧版本（已经归档，只读）

https://github.com/javaee/jaxb-v2

这个项目库2019年2月份已经归档了，现在只读。新的项目这已经转移到https://github.com/eclipse-ee4j/jaxb-ri
在这里插入图片描述

新版本

代码库：https://github.com/eclipse-ee4j/jaxb-ri
主页：https://eclipse-ee4j.github.io/jaxb-ri/
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

下载zip独立发行包版本

打开主页：https://eclipse-ee4j.github.io/jaxb-ri/
点击右边的Download，可以下载最新的版本，例如jaxb-ri-4.0.3.zip：
在这里插入图片描述

将下载下来的压缩包解压，目录结构为：
在这里插入图片描述

bin子目录下的内容：
在这里插入图片描述

docs子目录下的内容：
在这里插入图片描述

mod子目录下的内容：
在这里插入图片描述

samples子目录下的内容：
在这里插入图片描述

对JDK版本的要求

参考实现4.0.3版本需要Java SE 11及以上。

利用运行时绑定框架

Schema到Java：开发应用的基本步骤

Schema转Java是将1个或多个schema文件编译为生成java类的过程。用这种方式开发一个应用的基本步骤如下：

  • 开发或者定位到schema
  • 如果需要的话，用绑定定制化注解schema，或者将它们放在一个外部的绑定文件
  • 用xjc绑定编译器编译schema，生成java内容类
    在这里插入图片描述
  • 用上面生成的java内容类和jakarta.xml.bind运行时框架来开发JAXB应用
  • 设置CLASSPATH变量，将下面的jar文件包含到路径中
    https://eclipse-ee4j.github.io/jaxb-ri/4.0.3/docs/ch02.html#jars
    在这里插入图片描述

上面的jar文件在下载包解压后的mod子目录下可以找到：
在这里插入图片描述

  • 用javac编译所有的java源文件
  • 运行程序

Java到Schema：开发应用的基本步骤

Java到Schema是利用jakarta.xml.bind.annotation包中的注解来增强已经存在的java类的过程，由此JAXB运行时绑定框架可以进行解包/打包的操作。用这种方式开发一个应用的基本步骤如下：

  • 用java开发数据模型
  • 利用jakarta.xml.bind.annotation包中的注解来控制绑定过程
  • 设置CLASSPATH变量，将下面的jar文件包含到路径中
    https://eclipse-ee4j.github.io/jaxb-ri/4.0.3/docs/ch02.html#jars
    在这里插入图片描述
  • 用javac编译数据模型
  • 编译生成的class文件会包含自己手动增加的注解和JAXB绑定框架需要的其它默认注解
  • 用数据模型开发应用；编写代码，用JAXB运行时框架的打包/解包操作持久化数据模型
  • 编译、运行应用

xjc（根据xml schema生成java代码）

备注：xjc命令行脚本只存在于JAXB的zip独立发行包版本中。

拉起xjc的方式

以在Windows下使用为例，可以运行bin目录下的批处理文件xjc.bat、或者mod目录下的jaxb-xjc.jar文件来拉起xjc。

xjc.bat文件在解压包的bin子目录下：
在这里插入图片描述
jaxb-xjc.jar文件在解压包的mod子目录下：
在这里插入图片描述

运行xjc.bat文件，例如：
在这里插入图片描述

运行jaxb-xjc.jar文件，例如：
在这里插入图片描述

xjc语法

可以通过运行xjc.bat文件、或者jaxb-xjc.jar文件，后面加上-help参数，来查看具体的用法，有哪些选项。
也可以查询官网来了解具体用法：
https://eclipse-ee4j.github.io/jaxb-ri/4.0.3/docs/ch04.html#tools-xjc

xjc [OPTION]... <schema file/URL/dir/jar> [-b <binding>...]

在这里插入图片描述
在这里插入图片描述

举例

根据一个schema文件生成java文件

例如，在cmd窗口下执行如下命令：

xjc D:\temp\xmlschema\test.xsd -d D:\temp\outcode

其中：
D:\temp\xmlschema\test.xsd指定schema文件
-d D:\temp\outcode指定生成的java文件存放目录。注意，输出目录必须已经存在，xjc编译器不会创建。
在这里插入图片描述

schema文件的内容：

<?xml version="1.0" encoding="UTF-8"?>
<!--

    Copyright (c) 1997, 2021 Oracle and/or its affiliates. All rights reserved.

    This program and the accompanying materials are made available under the
    terms of the Eclipse Distribution License v. 1.0, which is available at
    http://www.eclipse.org/org/documents/edl-v10.php.

    SPDX-License-Identifier: BSD-3-Clause

-->

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">

  <xs:import namespace="http://www.w3.org/XML/1998/namespace"
             schemaLocation="http://www.w3.org/2001/xml.xsd"/>

  <xs:complexType name="foo">
    <xs:sequence>
      <xs:element name="age" type="xs:int"/>
    </xs:sequence>
  </xs:complexType>

  <xs:element name="root" type="foo"/>

</xs:schema>

到输出目录下查看生成的内容：
在这里插入图片描述
其中generated是默认生成的包名。

在这里插入图片描述

生成的Foo.java文件的内容：

//
// 此文件是由 Eclipse Implementation of JAXB v4.0.3 生成的
// 请访问 https://eclipse-ee4j.github.io/jaxb-ri 
// 在重新编译源模式时, 对此文件的所有修改都将丢失。
//


package generated;

import jakarta.xml.bind.annotation.XmlAccessType;
import jakarta.xml.bind.annotation.XmlAccessorType;
import jakarta.xml.bind.annotation.XmlType;


/**
 * <p>foo complex type的 Java 类。
 * 
 * <p>以下模式片段指定包含在此类中的预期内容。
 * 
 * <pre>{@code
 * <complexType name="foo">
 *   <complexContent>
 *     <restriction base="{http://www.w3.org/2001/XMLSchema}anyType">
 *       <sequence>
 *         <element name="age" type="{http://www.w3.org/2001/XMLSchema}int"/>
 *       </sequence>
 *     </restriction>
 *   </complexContent>
 * </complexType>
 * }</pre>
 * 
 * 
 */
@XmlAccessorType(XmlAccessType.FIELD)
@XmlType(name = "foo", propOrder = {
    "age"
})
public class Foo {

    protected int age;

    /**
     * 获取age属性的值。
     * 
     */
    public int getAge() {
        return age;
    }

    /**
     * 设置age属性的值。
     * 
     */
    public void setAge(int value) {
        this.age = value;
    }

}

生成的ObjectFactory.java文件的内容：

//
// 此文件是由 Eclipse Implementation of JAXB v4.0.3 生成的
// 请访问 https://eclipse-ee4j.github.io/jaxb-ri 
// 在重新编译源模式时, 对此文件的所有修改都将丢失。
//


package generated;

import javax.xml.namespace.QName;
import jakarta.xml.bind.JAXBElement;
import jakarta.xml.bind.annotation.XmlElementDecl;
import jakarta.xml.bind.annotation.XmlRegistry;


/**
 * This object contains factory methods for each 
 * Java content interface and Java element interface 
 * generated in the generated package. 
 * <p>An ObjectFactory allows you to programmatically 
 * construct new instances of the Java representation 
 * for XML content. The Java representation of XML 
 * content can consist of schema derived interfaces 
 * and classes representing the binding of schema 
 * type definitions, element declarations and model 
 * groups.  Factory methods for each of these are 
 * provided in this class.
 * 
 */
@XmlRegistry
public class ObjectFactory {

    private static final QName _Root_QNAME = new QName("", "root");

    /**
     * Create a new ObjectFactory that can be used to create new instances of schema derived classes for package: generated
     * 
     */
    public ObjectFactory() {
    }

    /**
     * Create an instance of {@link Foo }
     * 
     * @return
     *     the new instance of {@link Foo }
     */
    public Foo createFoo() {
        return new Foo();
    }

    /**
     * Create an instance of {@link JAXBElement }{@code <}{@link Foo }{@code >}
     * 
     * @param value
     *     Java instance representing xml element's value.
     * @return
     *     the new instance of {@link JAXBElement }{@code <}{@link Foo }{@code >}
     */
    @XmlElementDecl(namespace = "", name = "root")
    public JAXBElement<Foo> createRoot(Foo value) {
        return new JAXBElement<>(_Root_QNAME, Foo.class, null, value);
    }

}

schemagen（根据java文件生成schema）

备注：schemagen命令行脚本只存在于JAXB的zip独立发行包版本中。

介绍

schemagen可以处理java源文件、或者class文件。

拉起schemagen的方式

以windows为例，可以运行bin目录下的schemagen.bat文件来拉起schemagen。
如果java源文件或者类文件引用了其它的类，那么被引用的类必须通过系统环境变量CLASSPATH可以访问到，否则就必须在工具命令中通过-classpath/ -cp可选参数来指定。
例如：
在这里插入图片描述

schemagen语法

介绍

schemagen [-options ...] <java files>

可以通过官网查看命令参数详细介绍：
https://eclipse-ee4j.github.io/jaxb-ri/4.0.3/docs/ch04.html#tools-schemagen
在这里插入图片描述

或者执行schemagen -help命令查看帮助信息：
在这里插入图片描述

查看帮助信息

执行命令：

schemagen -help

在这里插入图片描述

查看版本信息

执行命令：

schemagen -version

在这里插入图片描述

查看完整版本信息

执行命令：

schemagen -fullversion

在这里插入图片描述

举例

根据java源文件生成schema文件

java源文件的内容如下。其中属性name用了JavaBeans样式（get和set），属性age用了JAXB的注释：

package com.thb;

import jakarta.xml.bind.annotation.XmlElement;

public class Demo {

    private String name;

    @XmlElement
    private int age;

    public String getName() {
        return this.name;
    }

    public void setName(String name) {
        this.name = name;
    }
}

执行命令及输出：

schemagen D:\temp\eclipse-workspace\java_work\java_test2\src\com\thb\Demo.java -d D:\temp\outschema

其中 -d D:\temp\outschema指定了生成的schema文件、class文件的存放路径。
在这里插入图片描述
到outschema目录下查看生成的内容：
在这里插入图片描述
可以看到，生成了schema文件schema1.xsd，另外，也将java源文件编译成了class文件。

打开生成的schema1.xsd文件，内容如下：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<xs:schema version="1.0" xmlns:xs="http://www.w3.org/2001/XMLSchema">

  <xs:complexType name="demo">
    <xs:sequence>
      <xs:element name="age" type="xs:int"/>
      <xs:element name="name" type="xs:string" minOccurs="0"/>
    </xs:sequence>
  </xs:complexType>
</xs:schema>

通过maven下载JAXB的Eclipse实现

在maven工程的pom.xml文件中依赖部分增加如下片段：

  <dependencies>
    <dependency>
      <groupId>jakarta.xml.bind</groupId>
      <artifactId>jakarta.xml.bind-api</artifactId>
      <version>4.0.0</version>
    </dependency>
    <dependency>
      <groupId>com.sun.xml.bind</groupId>
      <artifactId>jaxb-impl</artifactId>
      <version>4.0.3</version>
    </dependency>
  </dependencies>
更多推荐

聚观早报 | 飞书签约韵达速递；蔚来首颗自研芯片“杨戬”量产

【聚观365】9月22日消息飞书签约韵达速递蔚来首颗自研芯片“杨戬”10月量产靳玉志接任华为车BUCEO亚马逊发布全新Alexa语音助手OpenAI推出图像生成器DALL-E3飞书签约韵达速递近日，国内物流服务公司韵达快递宣布全员上飞书。飞书解决方案副总裁何斌表示，“飞书将助力韵达快递进行全方面的数字化变革，包括：全场

MySQL数据库操作以及sql语句总结

一、MySQL数据库知识点补充一个数据库就是一个完整的业务单元，可以包含多张表，数据被存储在表中在表中为了更加准确的存储数据，保证数据的正确有效，可以在创建表的时候，为表添加一些强制性的验证，包括数据字段的数据类型、约束（重点，后面要用）数据类型可以通过查看帮助文档查阅所有支持的数据类型：mysql--help使用数据

解决Vue项目中的“Cannot find module ‘vue-template-compiler‘”错误

1.问题描述在Vue项目中，当我们使用Vue的单文件组件（.vue文件）时，有时会遇到以下错误信息：ERROR:Cannotfindmodule'vue-template-compiler'这个错误通常发生在我们使用Vue的版本不匹配或者缺少必要的依赖模块时。本文将介绍如何解决这个问题。2.解决方法方法一：安装vue-

2023中国智能产业高峰论坛丨文档图像大模型的思考与探索

#前言随着人工智能技术的不断发展，尤其是深度学习技术的广泛应用，多模态数据处理和大模型训练已成为当下研究的热点之一，这些技术也为文档图像智能处理和分析领域带来了新的发展机遇。近期，2023第十二届中国智能产业高峰论坛(CIIS2023)在江西南昌开幕，政企研学各界学者专家同台交流，在成果分享、观点碰撞、经验互鉴中，共促

pytest一些常见的插件

Pytest拥有丰富的插件架构，超过800个以上的外部插件和活跃的社区，在PyPI项目中以“pytest-*”为标识。本篇将列举github标星超过两百的一些插件进行实战演示。插件库地址：http://plugincompat.herokuapp.com/1、pytest-html：用于生成HTML报告一次完整的测试，

GRACE球谐数据滤波处理（利用matlab实现GRACE月水储量的二维傅里叶变化滤波）

GRACE的全球重力场产品以球谐系数（SHCs）的形式表现出明显的南北条带噪声问题，这种噪声被认为来源于它的极轨道、缺乏横向敏感性以及采样频率引起的混叠效应。空间滤波器的例子包括各向同性高斯滤波器（Wahretal.，1998）及其非各向同性变体（Hanetal.，2005；Zhangetal.，2009），维纳滤波器

Springboot 集成WebSocket作为客户端，含重连接功能，开箱即用

使用演示publicstaticvoidmain(String[]args)throwsException{//初始化socket客户端BaseWebSocketClientsocketClient=BaseWebSocketClient.init("传入链接");//发送消息socketClient.sendMess

电磁散射模拟的体积积分方程求解器：使用MATLAB中的ceviche_challenges模块进行光子器件逆向设计详解

第一部分：电磁散射模拟与体积积分方程求解器简介在现代光子学领域，电磁散射模拟是一个核心技术，它涉及到光子器件的设计、分析和优化。为了准确地模拟电磁波在复杂介质中的传播，研究者们开发了多种数值方法。其中，体积积分方程求解器是一个强大的工具，它可以为复杂的光子器件提供精确的模拟结果。MATLAB，作为一个广泛使用的数值计算

讯飞星火认知大模型Java后端接口

文章目录1.免费申请星火大模型套餐2.Java后端接口说明2.1项目地址2.2项目说明2.3项目结构2.4项目代码🍀maven依赖🍀application.yml配置文件🍀config包📌XfXhConfig🍀dto包📌MsgDTO📌RequestDTO📌ResponseDTO🍀listener包📌

详细介绍下路由器的LAN接口

路由器的LAN口（LocalAreaNetworkport）是指用于连接局域网（LAN）设备的接口。它提供了有线连接的接口，允许局域网内的设备通过以太网线连接到路由器，并与其他局域网设备进行通信。以下是对路由器的LAN口的详细介绍：功能：LAN口的主要功能是提供有线网络连接，用于连接局域网内的设备，如台式电脑、网络打印

探索状态驱动开发的奇妙世界——Cola-StateMachine的介绍与使用

文章目录1.前言2.Cola-StateMachine概述3.Cola-StateMachine相关API4.Cola-StateMachine实战5.其他1.前言前面接受了Spring实现的状态机SpringStateMachine，这个状态机的优点在于功能很完备，缺点也是功能十分完备。完备到什么程度了，提供了状态机

热文推荐
  1. 激活函数总结（四十一）：激活函数补充(ShiLU、ReLUN)

    激活函数总结（四十一）：激活函数补充1引言2激活函数2.1ShiLU激活函数2.2ReLUN激活函数3.总结1引言在前面的文章中已经介绍了介绍了一系列激活函数(Sigmoid、Tanh、ReLU、LeakyReLU、PReLU、Swish、ELU、SELU、GELU、Softmax、Softplus、Mish、Maxo

  2. [C++ 网络协议] 套接字和标准I/O

    1.标准I/O函数的优缺点优点一：标准I/O函数具有良好的移植性。为了支持所有系统，标准I/O函数都是按照标准来定义的。适用于所有编程领域。优点二：标准I/O函数可以利用缓冲提高性能。使用标准I/O函数会得到额外的缓冲支持，当创建套接字时，操作系统将会生成一个用于I/O的缓冲，同时，当你使用标准I/O函数，将会得到另一

  3. 8.gec6818开发板通过并发多线程实现电子相册 智能家居 小游戏三合一完整项目

    并发前面编写的程序都是从mian函数开始，从上往下执行，称为顺序执行假设一个程序需要I输入C计算P输出，以顺序执行三个上述程序，则其执行过程如下：程序内部的语句是一条一条的执行，如果要运行多个程序，这些程序也是一个一个的依次执行，若上述的三种操作，每种操作需要的时间都是t，则执行上述三个程序共需要9t而在上述程序的执行

  4. 探索AI图像安全，助力可信AI发展

    探索AI图像安全，助力可信AI发展0.前言1.人工智能发展与安全挑战1.1人工智能及其发展1.2人工智能安全挑战2.WAIC2023多模态基础大模型的可信AI2.1WAIC2023专题论坛2.2走进合合信息3.AI图像安全3.1图像篡改检测3.2生成式图像鉴别3.3OCR对抗攻击技术4.可信AI技术标准小结相关链接0.

  5. 具体项目下解决Echarts多端同步开发和维护的问题

    具体问题场景PC端和移动端需要同时上线图表功能（没有多余工时）之后的版本迭代（功能、样式、配置等）默认双端同步，开发人员只希望维护一套代码Echarts在移动端有部分功能不兼容不支持Echarts在移动端的坑①移动端页面使用echarts4中的地图组件，并添加省份的点击事件，响应click无效，eharts也不支持ta

  6. 在Ubuntu 系统下开发GUI,用哪种开发工具比较好？

    在Ubuntu系统下开发GUI，你可以考虑使用以下几种开发工具：QtCreator：QtCreator是一个跨平台的集成开发环境，专门用于开发基于Qt框架的应用程序。它提供了丰富的图形界面设计工具和代码编辑器，支持C++和QML编程。QtCreator具有良好的跨平台支持和强大的功能，适用于开发各种类型的GUI应用程序

  7. 每天一个注解之@WebService

    @WebService@WebService是JavaAPIforXMLWebServices（JAX-WS）中的注解，用于标识一个类或接口作为一个可通过网络访问的Web服务。通过使用@WebService注解，你可以将普通的Java类转换成可发布为Web服务的类。以下是@WebService注解的一些常见用法和示例：

  8. webpack：详解代码分离以及插件SplitChunksPlugin的使用

    文章目录背景入口起点分离基本使用防重复SplitChunksPlugin插件分离背景基本使用splitChunks.chunkssplitChunks.minChunkssplitChunks.minSizesplitChunks.maxSizesplitChunks.namesplitChunks.cacheGrou

  9. AI绘图提示词Stable Diffusion Prompt 笔记

    基础提示词分为正向提示词（positiveprompt）和反向提示词（negativeprompt），用来告诉AI哪些需要，哪些不需要词缀的权重默认值都是1，从左到右依次减弱，权重会影响画面生成结果。AI会依照概率来选择性执行，如提示词之间有冲突，AI会根据权重确定的概率来随机选择执行哪个提示词。生成图片的大小会影响P