您好,登錄后才能下訂單哦!
今天就跟大家聊聊有關怎么理解WebService CXF中傳輸文件MTOM,可能很多人都不太了解,為了讓大家更加了解,小編給大家總結了以下內容,希望大家根據這篇文章可以有所收獲。
一、幾個相關的概念
1、MTOM基礎概念
官方介紹:http://cxf.apache.org/docs/mtom-attachments-with-jaxb.html
MTOM(Message Transmission Optimization Mechanism)消息優化傳輸機制。
它提出的模型適用于大量數據的交互情況。針對Base64編碼情況帶來的開銷提出的解決方案。當數據量小的時候,SOAP依然使用XML進行消息的傳遞。
消息傳輸優化機制 (MTOM) 標準允許將消息中包含的大型數據元素外部化,并將其作為無任何特殊編碼的二進制數據隨消息一起傳送。MTOM 消息會打包為多部分/相關 MIME 序列,放在SOAP 消息中一起傳送。
但是在大量數據情況下,如果數據依然進行Base64編碼,會帶來33%的額外開銷,這樣的情況對于大量數據交換的情況是無法容忍的。MTOM 就是針對SOAP 消息傳輸的基礎上提出的改進辦法。對于大量數據的傳遞,不會進行進行Base64編碼,而是直接以附件的二進制原始數據的形式封裝在SOAP消息的 MIME 部分,進行傳輸。SOAP 消息通過指向隨其發送的 MIME 部分來引用二進制內容,另外包括SOAP基本的XML 數據,這些還是Base64編碼。因為此模型與簡單郵件協議SMTP 模型基本一致。
MTOM通過簡化大量數據的編碼過程,從而提高數據的處理效率。因為SOAP消息等必要的信息,MTOM 也有一些必要的開銷。MTOM僅在二進制數據元素的大小超過大約 1 KB 時,才能體現出其優勢。
什么是BASE64編碼、MTOM消息優化傳輸機制、MIME。這些對于我們理解MTOM消息優化傳輸機制問題非常的必要。
2、BASE64編碼
BASE64編碼 的原理很簡單,其方法是,將輸入數據流每次取6 bit(每bit代表1位二進制),不足6bit的補0,這樣,每3個8位字節將編碼為4個6位字節(3×8 → 4×6);不滿4個字節的以“=”填充。其實這4個六位字節 仍然是8位,只不過高兩位被設置為0。當一個字節只有6位有效時,它的取值空間為0 到 2的6次方減1 即63,也就是說被轉換的Base64編碼的每一個編碼的取值空間為(0~63)。
這樣就可以將3個8位字節,轉換為4個字節,這4個轉換的字節都可以映射到字符中。也即數據都可以使用字符編碼代替。 因為轉換后的字符串要比原來的多一個字節,長1/3。因此編碼后的數據長度增加到4/3倍。這里也是為什么使用SOAP消息效率比MTOM低的原因。因為 SOAP使用XML語言進行消息傳遞,XML是基于BASE64編碼的語言。
3、MIME
MIME表示多用途Internet郵件擴允協議。MIME擴允了基本的面向文本的Internet郵件系統,以便可以在消息中包含二進制附件。MIME(Multipurpose Internet Mail Extentions),一般譯作"多用途的網絡郵件擴充協議"。顧名思義,它可以傳送多媒體文件。 MIME (Multipurpose Internet Mail Extensions,多目的Internet郵件擴展)是創建用于電子郵件交換,網絡文檔,及企業網和Internet上的其他應用程序中的文件格式的規范。
二、MTOM之旅
1、POJO
Java代碼
package org.wy.pojo;
import javax.activation.DataHandler;
import javax.xml.bind.annotation.XmlAccessType;
import javax.xml.bind.annotation.XmlAccessorType;
import javax.xml.bind.annotation.XmlMimeType;
import javax.xml.bind.annotation.XmlRootElement;
import javax.xml.bind.annotation.adapters.XmlJavaTypeAdapter;
@XmlRootElement
@XmlAccessorType(XmlAccessType.FIELD)
public class User {
private String name = "wy";
private String sex = "man";
public int age = 20;
//private Address address;
//注這是一個附件類型的數據
@XmlMimeType("application/octet-stream")
private DataHandler dataHandler;
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
//處理復雜的對象
/*@XmlJavaTypeAdapter(AddressAdapter.class)
public Address getAddress() {
return address;
}
public void setAddress(Address address) {
this.address = address;
}*/
public DataHandler getDataHandler() {
return dataHandler;
}
public void setDataHandler(DataHandler dataHandler) {
this.dataHandler = dataHandler;
}
}
MTOM 方式中要傳輸的附件必須使用javax.activation.DataHandler 類,還要注意必須在類上使用@XmlAccessorType(XmlAccessType.FIELD)注解,標注JAXB 在進行JAVA 對象與XML 之間進行轉換時只關注字段,而不關注屬性(getXXX()方法)。
然后使用@XmlMimeType 注解標注這是一個附件類型的數據,這里我們標注imageData 是一個二進制文件,當然你也可以使用具體的MIME類型,譬如:image/jpg、image/gif 等,但要考慮到客戶端是否支持。
2、接口類
Java代碼
package org.wy.service;
import javax.jws.WebService;
import javax.jws.soap.SOAPBinding;
import javax.xml.ws.soap.MTOM;
import org.wy.pojo.User;
@WebService(name="userService") //name屬性標注在接口類上,可以指定wsdl中接口名稱,也就是生成的客戶端代碼中接口類的名字。
@SOAPBinding(style = SOAPBinding.Style.RPC) //指定SOAP消息樣式
@MTOM //開啟MTOM功能
public interface IUserService {
public User getUser();
}
@MTOM注解用于開啟MTOM功能。
@WebService注解中的name屬性標注在接口類上,可以指定wsdl中接口名稱,也就是生成的客戶端代碼中接口類的名字。
@SOAPBinding(style = SOAPBinding.Style.RPC)指定SOAP消息樣式,有兩個枚舉值:SOAPBinding.Style.DOCUMENT(默認)和 SOAPBinding.Style.RPC,可以對比這兩種方式生成的wsdl會有所不同,而且生成的客戶端代碼也會有所不同。
實現類:
Java代碼
package org.wy.service.impl;
import java.io.File;
import javax.activation.DataHandler;
import javax.activation.FileDataSource;
import javax.jws.WebService;
import org.wy.pojo.User;
import org.wy.service.IUserService;
/**
*
* @author wy
*
*/
@WebService
public class UserServiceImpl implements IUserService{
public User getUser()
{
User user = new User();
user.setName("wy");
user.setDataHandler(new DataHandler(new FileDataSource(new File("D:\\resume\\logo.gif"))));
return user;
}
}
3、服務端配置
applicationContext-cxf.xml
Xml代碼
<?xml version="1.0" encoding="UTF-8" ?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:jaxws="http://cxf.apache.org/jaxws"
xsi:schemaLocation="
http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
http://cxf.apache.org/jaxws
http://cxf.apache.org/schemas/jaxws.xsd">
<!-- 導入資源 -->
<import resource="classpath:META-INF/cxf/cxf.xml" />
<import resource="classpath:META-INF/cxf/cxf-extension-soap.xml" />
<import resource="classpath:META-INF/cxf/cxf-servlet.xml" />
<!-- <jaxws:endpoint implementor="org.wy.service.impl.UserServiceImpl" address="/UserService"/> -->
<!-- 使用bean -->
<jaxws:endpoint implementor="#userService" address="/UserService" />
</beans>
在命令行鍵入“wsimport -p org.wy.client -keep http://localhost:8080/WebServiceCXF/services/UserService?wsdl”生成客戶端代碼,拷貝到工程相應文件夾
當然也可以使用CXF中的wsdl2java命令生成客戶端。
這時,就可以調用這個服務了:
測試類:
Java代碼
package org.wy.jdkclienttest;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import javax.activation.DataHandler;
import org.wy.jdkclient.User;
import org.wy.jdkclient.UserServiceImplService;
/**
*
* @author wy
*
*/
public class Test {
public static void main(String[] args) throws IOException {
UserServiceImplService userService = new UserServiceImplService();
User user = userService.getUserServiceImplPort().getUser();
String name = user.getName();
int age = user.getAge();
String sex = user.getSex();
System.out.println(name+"\r\n"+age+"\r\n"+sex);
//輸出傳遞過來的文件
DataHandler dataHandler = user.getDataHandler();
String fileName = dataHandler.getName();
String fileType = dataHandler.getContentType();
Object content = dataHandler.getContent();
System.out.println(fileName+"\r\n"+fileType+"\r\n"+content.toString());
//Streaming Mode
InputStream is = dataHandler.getInputStream();
FileOutputStream fos = new FileOutputStream("D:\\logo.gif");
byte[] bytes = new byte[2048];
int len = 0;
while((len = is.read(bytes))!=-1){
fos.write(bytes, 0, len);
}
fos.flush();
fos.close();
is.close();
}
}
來看下結果:
Java代碼
2011-12-25 14:03:49 org.apache.cxf.service.factory.ReflectionServiceFactoryBean buildServiceFromWSDL
信息: Creating Service {http://impl.service.wy.org/}UserServiceImplService from WSDL: http://localhost:8080/WebServiceCXF/services/UserService?wsdl
name= wy
age= 20
sex= man
fileName= null
fileType= image/gif
fileContent= org.apache.cxf.attachment.DelegatingInputStream@11e1bbf
看完上述內容,你們對怎么理解WebService CXF中傳輸文件MTOM有進一步的了解嗎?如果還想了解更多知識或者相關內容,請關注億速云行業資訊頻道,感謝大家的支持。
免責聲明:本站發布的內容(圖片、視頻和文字)以原創、轉載和分享為主,文章觀點不代表本網站立場,如果涉及侵權請聯系站長郵箱:is@yisu.com進行舉報,并提供相關證據,一經查實,將立刻刪除涉嫌侵權內容。