前言:對于服務器后端開發,接口返回的數據格式一般要求都是json,但是也有使用xml格式
RequestBody注解
對于SpringMVC,很多人會認為接口方法使用@Controller搭配@ResponseBody和@RequestMapping注解后,java對象會轉換成json格式返回。
但實際上配合@ResponseBody注解后,接口返回的數據類型是根據HTTP Request Header中的Accept屬性來確定的,可以是XML或者JSON數據
通過適當的HttpMessageConverter對java對象進行格式轉換,常用的有:
ByteArrayHttpMessageConverter
負責讀取二進制格式的數據和寫出二進制格式的數據;
StringHttpMessageConverter
負責讀取字符串格式的數據和寫出二進制格式的數據;
ResourceHttpMessageConverter
負責讀取資源文件和寫出資源文件數據;
FormHttpMessageConverter
負責讀取form提交的數據;
MappingJacksonHttpMessageConverter
負責讀取和寫入json格式的數據;
SouceHttpMessageConverter
負責讀取和寫入 xml 中javax.xml.transform.Source定義的數據;
Jaxb2RootElementHttpMessageConverter
負責讀取和寫入xml 標簽格式的數據;
AtomFeedHttpMessageConverter
負責讀取和寫入Atom格式的數據;
RssChannelHttpMessageConverter
負責讀取和寫入RSS格式的數據
具體使用哪個怎么判斷這里就不細講了,我們關心的是Jaxb2RootElementHttpMessageConverter這個方法,后面會講為啥會提
java對象與xml之間互相轉換
使用Java自帶注解的方式實現(@XmlRootElement,@XmlAccessorType,@XmlElement,@XmlAttribute),具體使用方法網上有很多
這里直接代碼舉例
import javax.xml.bind.annotation.XmlElement;
import javax.xml.bind.annotation.XmlRootElement;
import javax.xml.bind.annotation.XmlType;
@XmlRootElement(name = "city")
@XmlType(propOrder = { "name","province"})
public class City {
private String name;
private String province;
public City() {
}
public City(String name, String province) {
this.name = name;
this.province = province;
}
public String getName() {
return name;
}
@XmlElement
public void setName(String name) {
this.name = name;
}
public String getProvince() {
return province;
}
@XmlElement
public void setProvince(String province) {
this.province = province;
}
}
controller
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;
@Controller
public class IndexController {
@RequestMapping(path = "/get")
@ResponseBody
public City getXml(){
City city= new City("太原","山西");
return city;
}
}
請求http://localhost:8080/get 返回結果如下

是不很容易就實現接口返回xml格式
使用<![CDATA[]]>
對象屬性中有可能存在計算邏輯'<‘或'>',而在xml文件中這兩個符號是不合法的,會轉換為<和>,這樣數據就'壞'了,所以<![CDATA[]]>的加入是非常有必要的!
一般實現:使用XmlAdapter定義一個CDataAdapter類,網上也有很多代碼
大概的實現如下
public class CDataAdapter extends XmlAdapter<String, String> {
@Override
public String unmarshal(String v) throws Exception {
// 我們這里沒有xml轉java對象,這里就不具體實現了
return v;
}
@Override
public String marshal(String v) throws Exception {
return new StringBuilder("<![CDATA[").append(v).append("]]>").toString();
}
}
然后使用注解XmlJavaTypeAdapter作用于屬性變量上
@XmlJavaTypeAdapter(value=CDataAdapter.class)
@XmlElement
public void setProvince(String province) {
this.province = province;
}
結果

但是實際上看源碼

這個不是我們希望的,產生原因是Jaxb默認會把字符'<', '>'進行轉義, 下面解決這個問題
我們使用org.eclipse.persistence.oxm.annotations.XmlCDATA注解來解決
使用EclipseLink JAXB (MOXy)
pom文件增加
<dependency> <groupId>org.eclipse.persistence</groupId> <artifactId>org.eclipse.persistence.moxy</artifactId> <version>xx版本</version> </dependency>
上一節中的屬性使用注解
...
import org.eclipse.persistence.oxm.annotations.XmlCDATA;
...
...
@XmlCDATA
@XmlElement
public void setProvince(String province) {
this.province = province;
}
注意:一定要設置jaxb.properties文件,并且要放在要轉換成xml的java對象所在目錄,并且要編譯到target中,不然XmlCDATA注解不生效
jaxb.properties文件內容,就是指定創建JAXBContext對象的工長
javax.xml.bind.context.factory=org.eclipse.persistence.jaxb.JAXBContextFactory
到這里配置完成!
補充知識:Java Document生成和解析XML
一)Document介紹
API來源:在JDK中javax.xml.*包下
使用場景:
1、需要知道XML文檔所有結構
2、需要把文檔一些元素排序
3、文檔中的信息被多次使用的情況
優勢:由于Document是java中自帶的解析器,兼容性強
缺點:由于Document是一次性加載文檔信息,如果文檔太大,加載耗時長,不太適用
二)Document生成XML
實現步驟:
第一步:初始化一個XML解析工廠
DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
第二步:創建一個DocumentBuilder實例
DocumentBuilder builder = factory.newDocumentBuilder();
第三步:構建一個Document實例
Document doc = builder.newDocument();
doc.setXmlStandalone(true);
standalone用來表示該文件是否呼叫其它外部的文件。若值是 ”yes” 表示沒有呼叫外部文件
第四步:創建一個根節點,名稱為root,并設置一些基本屬性
Element element = doc.createElement("root");
element.setAttribute("attr", "root");//設置節點屬性
childTwoTwo.setTextContent("root attr");//設置標簽之間的內容
第五步:把節點添加到Document中,再創建一些子節點加入
doc.appendChild(element);
第六步:把構造的XML結構,寫入到具體的文件中
實現源碼:
package com.oysept.xml;
import java.io.File;
import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;
import javax.xml.parsers.ParserConfigurationException;
import javax.xml.transform.OutputKeys;
import javax.xml.transform.Transformer;
import javax.xml.transform.TransformerConfigurationException;
import javax.xml.transform.TransformerException;
import javax.xml.transform.TransformerFactory;
import javax.xml.transform.dom.DOMSource;
import javax.xml.transform.stream.StreamResult;
import org.w3c.dom.Document;
import org.w3c.dom.Element;
/**
* Document生成XML
* @author ouyangjun
*/
public class CreateDocument {
public static void main(String[] args) {
// 執行Document生成XML方法
createDocument(new File("E:\\person.xml"));
}
public static void createDocument(File file) {
try {
// 初始化一個XML解析工廠
DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
// 創建一個DocumentBuilder實例
DocumentBuilder builder = factory.newDocumentBuilder();
// 構建一個Document實例
Document doc = builder.newDocument();
doc.setXmlStandalone(true);
// standalone用來表示該文件是否呼叫其它外部的文件。若值是 ”yes” 表示沒有呼叫外部文件
// 創建一個根節點
// 說明: doc.createElement("元素名")、element.setAttribute("屬性名","屬性值")、element.setTextContent("標簽間內容")
Element element = doc.createElement("root");
element.setAttribute("attr", "root");
// 創建根節點第一個子節點
Element elementChildOne = doc.createElement("person");
elementChildOne.setAttribute("attr", "personOne");
element.appendChild(elementChildOne);
// 第一個子節點的第一個子節點
Element childOneOne = doc.createElement("people");
childOneOne.setAttribute("attr", "peopleOne");
childOneOne.setTextContent("attr peopleOne");
elementChildOne.appendChild(childOneOne);
// 第一個子節點的第二個子節點
Element childOneTwo = doc.createElement("people");
childOneTwo.setAttribute("attr", "peopleTwo");
childOneTwo.setTextContent("attr peopleTwo");
elementChildOne.appendChild(childOneTwo);
// 創建根節點第二個子節點
Element elementChildTwo = doc.createElement("person");
elementChildTwo.setAttribute("attr", "personTwo");
element.appendChild(elementChildTwo);
// 第二個子節點的第一個子節點
Element childTwoOne = doc.createElement("people");
childTwoOne.setAttribute("attr", "peopleOne");
childTwoOne.setTextContent("attr peopleOne");
elementChildTwo.appendChild(childTwoOne);
// 第二個子節點的第二個子節點
Element childTwoTwo = doc.createElement("people");
childTwoTwo.setAttribute("attr", "peopleTwo");
childTwoTwo.setTextContent("attr peopleTwo");
elementChildTwo.appendChild(childTwoTwo);
// 添加根節點
doc.appendChild(element);
// 把構造的XML結構,寫入到具體的文件中
TransformerFactory formerFactory=TransformerFactory.newInstance();
Transformer transformer=formerFactory.newTransformer();
// 換行
transformer.setOutputProperty(OutputKeys.INDENT, "YES");
// 文檔字符編碼
transformer.setOutputProperty(OutputKeys.ENCODING, "utf-8");
// 可隨意指定文件的后綴,效果一樣,但xml比較好解析,比如: E:\\person.txt等
transformer.transform(new DOMSource(doc),new StreamResult(file));
System.out.println("XML CreateDocument success!");
} catch (ParserConfigurationException e) {
e.printStackTrace();
} catch (TransformerConfigurationException e) {
e.printStackTrace();
} catch (TransformerException e) {
e.printStackTrace();
}
}
}
XML文件效果圖:

三)Document解析XML
實現步驟:
第一步:先獲取需要解析的文件,判斷文件是否已經存在或有效
第二步:初始化一個XML解析工廠
DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
第三步:創建一個DocumentBuilder實例
DocumentBuilder builder = factory.newDocumentBuilder();
第四步:創建一個解析XML的Document實例
Document doc = builder.parse(file);
第五步:先獲取根節點的信息,然后根據根節點遞歸一層層解析XML
實現源碼:
package com.oysept.xml;
import java.io.File;
import java.io.IOException;
import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;
import javax.xml.parsers.ParserConfigurationException;
import org.w3c.dom.Attr;
import org.w3c.dom.Document;
import org.w3c.dom.Element;
import org.w3c.dom.NamedNodeMap;
import org.w3c.dom.Node;
import org.w3c.dom.NodeList;
import org.xml.sax.SAXException;
/**
* Document解析XML
* @author ouyangjun
*/
public class ParseDocument {
public static void main(String[] args){
File file = new File("E:\\person.xml");
if (!file.exists()) {
System.out.println("xml文件不存在,請確認!");
} else {
parseDocument(file);
}
}
public static void parseDocument(File file) {
try{
// 初始化一個XML解析工廠
DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
// 創建一個DocumentBuilder實例
DocumentBuilder builder = factory.newDocumentBuilder();
// 創建一個解析XML的Document實例
Document doc = builder.parse(file);
// 獲取根節點名稱
String rootName = doc.getDocumentElement().getTagName();
System.out.println("根節點: " + rootName);
System.out.println("遞歸解析--------------begin------------------");
// 遞歸解析Element
Element element = doc.getDocumentElement();
parseElement(element);
System.out.println("遞歸解析--------------end------------------");
} catch (ParserConfigurationException e) {
e.printStackTrace();
} catch (SAXException e) {
e.printStackTrace();
} catch (IOException e) {
e.printStackTrace();
}
}
// 遞歸方法
public static void parseElement(Element element) {
System.out.print("<" + element.getTagName());
NamedNodeMap attris = element.getAttributes();
for (int i = 0; i < attris.getLength(); i++) {
Attr attr = (Attr) attris.item(i);
System.out.print(" " + attr.getName() + "=\"" + attr.getValue() + "\"");
}
System.out.println(">");
NodeList nodeList = element.getChildNodes();
Node childNode;
for (int temp = 0; temp < nodeList.getLength(); temp++) {
childNode = nodeList.item(temp);
// 判斷是否屬于節點
if (childNode.getNodeType() == Node.ELEMENT_NODE) {
// 判斷是否還有子節點
if(childNode.hasChildNodes()){
parseElement((Element) childNode);
} else if (childNode.getNodeType() != Node.COMMENT_NODE) {
System.out.print(childNode.getTextContent());
}
}
}
System.out.println("</" + element.getTagName() + ">");
}
}
XML解析效果圖:

以上這篇Java xml數據格式返回實現操作就是小編分享給大家的全部內容了,希望能給大家一個參考,也希望大家多多支持億速云。
免責聲明:本站發布的內容(圖片、視頻和文字)以原創、轉載和分享為主,文章觀點不代表本網站立場,如果涉及侵權請聯系站長郵箱:is@yisu.com進行舉報,并提供相關證據,一經查實,將立刻刪除涉嫌侵權內容。