# java-xml

**Repository Path**: trignit/java-xml

## Basic Information

- **Project Name**: java-xml
- **Description**: No description available
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2019-01-20
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Java XML操作的五种方式总结

* ** 技巧提示 **：  
    我想知道某个类在当前那一个jar包当中，打开Eclipse，并使用快捷键Ctrl+Shift+T。

* ** Maven项目打包fatjar **

```xml
<build>
	<plugins>
	  <plugin>
		<groupId>org.apache.maven.plugins</groupId>
		<artifactId>maven-shade-plugin</artifactId>
		<version>3.2.0</version>
		<configuration>
			<createDependencyReducedPom>false</createDependencyReducedPom>
		</configuration>
		<executions>
		  <execution>
			<goals>
			  <goal>shade</goal>
			</goals>
			<configuration>
			  <transformers>
				<transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
				  <manifestEntries>
					<Main-Class>${app.main.class}</Main-Class>
					<X-Compile-Source-JDK>${maven.compile.source}</X-Compile-Source-JDK>
					<X-Compile-Target-JDK>${maven.compile.target}</X-Compile-Target-JDK>
				  </manifestEntries>
				</transformer>
			  </transformers>
			</configuration>
		  </execution>
		</executions>
	  </plugin>
	</plugins>
</build>
```

## 1-DOM  
javax 自带方式无需引入额外依赖

## 2-DOM4J  
引入Maven依赖

```xml
<dependency>
	<groupId>org.dom4j</groupId>
	<artifactId>dom4j</artifactId>
	<version>2.0.0</version>
</dependency>
```
## 3-JDOM2  
引入Maven依赖

```xml
<dependency>
	<groupId>org.jdom</groupId>
	<artifactId>jdom2</artifactId>
	<version>2.0.6</version>
</dependency>
```
## 4-SAX  
无需引入依赖

## 5-JAXB  
[参考文章](https://www.cnblogs.com/chenbenbuyi/p/8283657.html)  
JAXB是jdk的扩展包javax中自带的类库，不需要你引入第三方jar包
1. 常用API  
    * JAXBContext类，是应用的入口，通过该类创建序列化和反序列化对象，也即编组对象和解组对象
    * Marshaller 编组接口，将Java对象序列化为XML数据；
    * Unmarshaller 解组接口，将XML数据反序列化为Java对象。
2. 常见注解  
    * @XmlRootElement，将Java类或枚举映射成XML元素根节点，是唯一一个必须注解，name属性指定根节点名称，不指定默认为类名的小写；
    * @XmlElement，将Java类的一个属性映射为XML节点元素，name属性可自定义元素名；
    * @XmlAttribute，将Java类的一个属性映射为XML节点元素的属性，name属性可自定义属性名；
    * @XmlType，将Java类或枚举类型映射到XML模式类型，常与@XmlRootElement、@XmlAccessorType共用，propOrder属性定义字段生成的XML节点顺序；
    * @XmlAccessorType，控制字段或属性的序列化。属性XmlAccessType有4个常量值:FIELD表示JAXB将自动绑定Java类中的每个非静态的（static）、非瞬态的（由@XmlTransient标注）字段到XML；PROPERTY表示java对象中所有通过getter/setter方式绑定成属性到XML；PUBLIC_MEMBER表示Java对象中所有的public访问权限的成员变量和通过getter/setter方式访问的成员变量，该值为默认值；NONE表示Java对象的所有属性都不映射为XML的元素；
    * @XmlAccessorOrder，控制JAXB 绑定类中属性和字段的排序，有两个属性，AccessorOrder.ALPHABETICAL——对生成的XML元素按字母书序排序，XmlAccessOrder.UNDEFINED——不排序，默认为该值；
    * @XmlJavaTypeAdapter，自定义适配器（即扩展抽象类XmlAdapter并覆盖marshal()和unmarshal()方法），解决日期（Date）,数字（Number）格式化问题；
    * @XmlElementWrapper ，对于数组或集合（即包含多个元素的成员变量），生成一个包装该数组或集合的XML元素（称为包装器），该注解只能用在集合上；
    * @XmlTransient ，用于标示在由Java对象映射XML时，忽略此属性，在生成的XML文件中将不出现此元素。
3. 实际应用中注意的问题  
    1. 如果JavaBean中定义了有参的构造器，那么必须同时定义无参构造器，否则转XML会抛无默认构造函数的异常;
    2. 成员变量值为NULL时，将不会映射成对应的XML元素——由于基本数据类型默认值不为空，所以基本数据类型不设值也会映射成XML元素，值为默认值,所以如果模型需要基本数据，在属性定义的时候尽量使用包装类型；
    3. @XmlAccessorType 注解中如果属性值为XmlAccessType.FIELD，则表示通过成员变量来映射，set/get方法上的映射注解就是多余的，所以如果此时set/get方法上再标注元素或者属性映射注解，将抛属性重复性异常；属性值为XmlAccessType.NONE不映射为XML元素的前提是Java字段或set/get方法上都没有映射注解；
    4. @XmlType propOrder属性能够自定义字段的排序，该属性如果设置，要么写成{}的形式，否则在就必须将所有@XmlElement标注或者没有@XmlElement标注的但实际上会被映射为XML节点的字段添加到排序列表，不然会抛异常；如果propOrder属性设置有值，@XmlAccessorOrder注解的元素排序规则将失效；