带有MTOM的JAX-WS附件

最新推荐文章于 2022-11-15 16:11:59 发布
最新推荐文章于 2022-11-15 16:11:59 发布
阅读量338 收藏 1
点赞数
文章标签： java 数据库 php

一个完整的基于JAX-WS SOAP的示例，展示了如何使用消息传输优化机制（MTOM）和XML二进制优化打包（XOP）技术将二进制附件（图像）从服务器发送到客户端，反之亦然。

注意
关于MTOM及其用途的好处有很多文章（请参见下面的参考站点 ），但是在JAX-WS中缺少使用MTOM的完整示例，希望该示例可以填补整个图片中的一些遗漏之处。

在服务器上启用MTOM

使服务器通过MTOM发送附件非常容易，只需使用javax.xml.ws.soap.MTOM注释Web服务实现类即可。

1. WebService端点

这是一个RPC样式的Web服务，发布了两个方法downloadImage(String name)和uploadImage(Image data) ，以允许用户上载或下载图像文件。

文件：ImageServer.java 

package com.mkyong.ws;

import java.awt.Image;

import javax.jws.WebMethod;
import javax.jws.WebService;
import javax.jws.soap.SOAPBinding;
import javax.jws.soap.SOAPBinding.Style;

//Service Endpoint Interface
@WebService
@SOAPBinding(style = Style.RPC)
public interface ImageServer{
	
	//download a image from server
	@WebMethod Image downloadImage(String name);
	
	//update image to server
	@WebMethod String uploadImage(Image data);
	
}

文件：ImageServerImpl.java 

package com.mkyong.ws;

import java.awt.Image;
import java.io.File;
import java.io.IOException;

import javax.imageio.ImageIO;
import javax.jws.WebService;
import javax.xml.ws.WebServiceException;
import javax.xml.ws.soap.MTOM;

//Service Implementation Bean
@MTOM
@WebService(endpointInterface = "com.mkyong.ws.ImageServer")
public class ImageServerImpl implements ImageServer{

	@Override
	public Image downloadImage(String name) {
		
		try {
			
			File image = new File("c:\\images\\" + name);
			return ImageIO.read(image);
			
		} catch (IOException e) {
			
			e.printStackTrace();
			return null; 
			
		}
	}

	@Override
	public String uploadImage(Image data) {

		if(data!=null){
			//store somewhere
			return "Upload Successful";
		}
		
		throw new WebServiceException("Upload Failed!");
		
	}

}

文件：ImagePublisher.java 

package com.mkyong.endpoint;

import javax.xml.ws.Endpoint;
import com.mkyong.ws.ImageServerImpl;

//Endpoint publisher
public class ImagePublisher{
	
    public static void main(String[] args) {
		
	Endpoint.publish("http://localhost:9999/ws/image", new ImageServerImpl());
		
	System.out.println("Server is published!");
	   
    }

}

2. WebService客户端

这是一个Web服务客户端，用于通过URL“ http：// localhost：9999 / ws / image ”访问已发布的Web服务。

文件：ImageClient.java 

package com.mkyong.client;

import java.awt.Image;
import java.io.File;
import java.net.URL;
import javax.imageio.ImageIO;
import javax.swing.ImageIcon;
import javax.swing.JFrame;
import javax.swing.JLabel;
import javax.xml.namespace.QName;
import javax.xml.ws.BindingProvider;
import javax.xml.ws.Service;
import javax.xml.ws.soap.MTOMFeature;
import javax.xml.ws.soap.SOAPBinding;

import com.mkyong.ws.ImageServer;

public class ImageClient{
	
	public static void main(String[] args) throws Exception {
	   
	URL url = new URL("http://localhost:9999/ws/image?wsdl");
        QName qname = new QName("http://ws.mkyong.com/", "ImageServerImplService");

        Service service = Service.create(url, qname);
        ImageServer imageServer = service.getPort(ImageServer.class);
 
        /************  test download  ***************/
        Image image = imageServer.downloadImage("rss.png");
        
        //display it in frame
        JFrame frame = new JFrame();
        frame.setSize(300, 300);
        JLabel label = new JLabel(new ImageIcon(image));
        frame.add(label);
        frame.setVisible(true);

        System.out.println("imageServer.downloadImage() : Download Successful!");

    }

}

3. HTTP和SOAP流量

这是客户端生成的HTTP和SOAP流量，由流量监控工具捕获。

PS省略第一个wsdl请求以节省空间。
客户发送请求： 

POST /ws/image HTTP/1.1
SOAPAction: ""
Accept: text/xml, multipart/related, text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2
Content-Type: text/xml; charset=utf-8
User-Agent: Java/1.6.0_13
Host: localhost:9999
Connection: keep-alive
Content-Length: 209

<?xml version="1.0" ?>
	<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
		<S:Body>
			<ns2:downloadImage xmlns:ns2="http://ws.mkyong.com/">
				<arg0>rss.png</arg0>
			</ns2:downloadImage>
		</S:Body>
	</S:Envelope>

服务器发送响应： 

HTTP/1.1 200 OK
Transfer-encoding: chunked
Content-type: multipart/related;
start="<rootpart*c73c9ce8-6e02-40ce-9f68-064e18843428@example.jaxws.sun.com>";
type="application/xop+xml";
boundary="uuid:c73c9ce8-6e02-40ce-9f68-064e18843428";
start-info="text/xml"

--uuid:c73c9ce8-6e02-40ce-9f68-064e18843428
Content-Id: <rootpart*c73c9ce8-6e02-40ce-9f68-064e18843428@example.jaxws.sun.com>
Content-Type: application/xop+xml;charset=utf-8;type="text/xml"
Content-Transfer-Encoding: binary

<?xml version="1.0" ?>
  <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
     <S:Body>
	<ns2:downloadImageResponse xmlns:ns2="http://ws.mkyong.com/">
	  <return>
	    <xop:Include xmlns:xop="http://www.w3.org/2004/08/xop/include" 
		href="cid:012eb00e-9460-407c-b622-1be987fdb2cf@example.jaxws.sun.com">
	    </xop:Include>
	  </return>
	</ns2:downloadImageResponse>
     </S:Body>
   </S:Envelope>
--uuid:c73c9ce8-6e02-40ce-9f68-064e18843428
Content-Id: <012eb00e-9460-407c-b622-1be987fdb2cf@example.jaxws.sun.com>
Content-Type: image/png
Content-Transfer-Encoding: binary

Binary data here.............

在客户端上启用MTOM

需要一些额外的努力来使客户端能够通过MTOM将附件发送到服务器，请参见以下示例： 

//codes enable MTOM in client
BindingProvider bp = (BindingProvider) imageServer;
SOAPBinding binding = (SOAPBinding) bp.getBinding();
binding.setMTOMEnabled(true);

1. WebService客户端

这是一个Web服务客户端，用于通过MTOM将映像文件发送到上面发布的终结点（http：// localhost：8888 / ws / image）。

文件：ImageClient.java 

package com.mkyong.client;

import java.awt.Image;
import java.io.File;
import java.net.URL;
import javax.imageio.ImageIO;
import javax.swing.ImageIcon;
import javax.swing.JFrame;
import javax.swing.JLabel;
import javax.xml.namespace.QName;
import javax.xml.ws.BindingProvider;
import javax.xml.ws.Service;
import javax.xml.ws.soap.MTOMFeature;
import javax.xml.ws.soap.SOAPBinding;

import com.mkyong.ws.ImageServer;

public class ImageClient{
	
	public static void main(String[] args) throws Exception {
	   
	URL url = new URL("http://localhost:8888/ws/image?wsdl");
        QName qname = new QName("http://ws.mkyong.com/", "ImageServerImplService");

        Service service = Service.create(url, qname);
        ImageServer imageServer = service.getPort(ImageServer.class);

        /************  test upload ****************/
        Image imgUpload = ImageIO.read(new File("c:\\images\\rss.png"));
        
        //enable MTOM in client
        BindingProvider bp = (BindingProvider) imageServer;
        SOAPBinding binding = (SOAPBinding) bp.getBinding();
        binding.setMTOMEnabled(true);
   
        String status = imageServer.uploadImage(imgUpload);
        System.out.println("imageServer.uploadImage() : " + status);
        
    }

}

2. HTTP和SOAP流量

这是客户端生成的HTTP和SOAP流量，由流量监控工具捕获。

PS省略第一个wsdl请求以节省空间。
客户发送请求： 

POST /ws/image HTTP/1.1
Content-type: multipart/related;
start="<rootpart*751f2e5d-47f8-47d8-baf0-f793c29bd931@example.jaxws.sun.com>";
type="application/xop+xml";
boundary="uuid:751f2e5d-47f8-47d8-baf0-f793c29bd931";

start-info="text/xml"
Soapaction: ""
Accept: text/xml, multipart/related, text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2
User-Agent: JAX-WS RI 2.1.6 in JDK 6
Host: localhost:9999
Connection: keep-alive
Content-Length: 6016

--uuid:751f2e5d-47f8-47d8-baf0-f793c29bd931
Content-Id: <rootpart*751f2e5d-47f8-47d8-baf0-f793c29bd931@example.jaxws.sun.com>
Content-Type: application/xop+xml;charset=utf-8;type="text/xml"
Content-Transfer-Encoding: binary

<?xml version="1.0" ?>
  <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
     <S:Body>
	<ns2:uploadImage xmlns:ns2="http://ws.mkyong.com/">
	  <arg0>
	    <xop:Include xmlns:xop="http://www.w3.org/2004/08/xop/include" 
		href="cid:2806f201-e15e-4ee0-8347-b7b4dffad5cb@example.jaxws.sun.com">
	    </xop:Include>
	  </arg0>
	 </ns2:uploadImage>
     </S:Body>
   </S:Envelope>

--uuid:751f2e5d-47f8-47d8-baf0-f793c29bd931
Content-Id: <2806f201-e15e-4ee0-8347-b7b4dffad5cb@example.jaxws.sun.com>
Content-Type: image/png
Content-Transfer-Encoding: binary

Binary data here.............

服务器发送响应： 

HTTP/1.1 200 OK
Transfer-encoding: chunked
Content-type: multipart/related;
start="<rootpart*188a5835-198b-4c28-9b36-bf030578f2bd@example.jaxws.sun.com>";
type="application/xop+xml";
boundary="uuid:188a5835-198b-4c28-9b36-bf030578f2bd";
start-info="text/xml"

--uuid:188a5835-198b-4c28-9b36-bf030578f2bd
Content-Id: <rootpart*188a5835-198b-4c28-9b36-bf030578f2bd@example.jaxws.sun.com>
Content-Type: application/xop+xml;charset=utf-8;type="text/xml"
Content-Transfer-Encoding: binary

<?xml version="1.0" ?>
  <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
      <S:Body>
	<ns2:uploadImageResponse xmlns:ns2="http://ws.mkyong.com/">
		<return>Upload Successful</return>
	</ns2:uploadImageResponse>
      </S:Body>
  </S:Envelope>

--uuid:188a5835-198b-4c28-9b36-bf030578f2bd--

完整的WSDL文档

对于那些有兴趣研究WSDL文件的人，可以通过URL获得wsdl文件： http：// localhost：9999 / ws / image？wsdl

ImageServer WSDL文件的样本 

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

<definitions 
	xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" 
	xmlns:tns="http://ws.mkyong.com/" 
	xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
	xmlns="http://schemas.xmlsoap.org/wsdl/" 
	targetNamespace="http://ws.mkyong.com/" 
	name="ImageServerImplService">
	
<types></types>

<message name="downloadImage">
	<part name="arg0" type="xsd:string"></part>
</message>
<message name="downloadImageResponse">
	<part name="return" type="xsd:base64Binary"></part>
</message>

<message name="uploadImage">
	<part name="arg0" type="xsd:base64Binary"></part>
</message>
<message name="uploadImageResponse">
	<part name="return" type="xsd:string"></part>
</message>

<portType name="ImageServer">

	<operation name="downloadImage">
		<input message="tns:downloadImage"></input>
		<output message="tns:downloadImageResponse"></output>
	</operation>
	<operation name="uploadImage">
		<input message="tns:uploadImage"></input>
		<output message="tns:uploadImageResponse"></output>
	</operation>

</portType>

<binding name="ImageServerImplPortBinding" type="tns:ImageServer">
	<soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="rpc">
        </soap:binding>
	
	<operation name="downloadImage">
		<soap:operation soapAction=""></soap:operation>
		<input>
			<soap:body use="literal" namespace="http://ws.mkyong.com/"></soap:body>
		</input>
		<output>
			<soap:body use="literal" namespace="http://ws.mkyong.com/"></soap:body>
		</output>
	</operation>

	<operation name="uploadImage">
		<soap:operation soapAction=""></soap:operation>
		<input>
			<soap:body use="literal" namespace="http://ws.mkyong.com/">
                        </soap:body>
		</input>
		<output>
			<soap:body use="literal" namespace="http://ws.mkyong.com/">
                        </soap:body>
		</output>
	</operation>

</binding>

<service name="ImageServerImplService">
<port name="ImageServerImplPort" binding="tns:ImageServerImplPortBinding">
<soap:address location="http://localhost:9999/ws/image"></soap:address>
</port>
</service>
</definitions>

下载源代码

下载它– JAX-WS-Attachment-MTOM-Example.zip （20KB）

参考

  1. http://www.devx.com/xml/Article/34797/1763/page/1
  2. http://download.oracle.com/docs/cd/E17802_01/webservices/webservices/docs/2.0/jaxws/mtom-swaref.html
  3. http://www.crosschecknet.com/intro_to_mtom.php
  4. http://download.oracle.com/docs/cd/E12840_01/wls/docs103/webserv_adv/mtom.html
  5. http://www.theserverside.com/news/1363957/Sending-Attachments-with-SOAP
  6. http://metro.java.net/guide/Binary_Attachments__MTOM_.html
标记：

翻译自: https://mkyong.com/webservices/jax-ws/jax-ws-attachment-with-mtom/

cyan20115
关注
  • 0
    点赞
  • 踩
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
java-spring-js-MTOM-download:使用Java 8，Spring，JAXB的SOAP MTOM XOP模板
05-18
使用Java 8，Spring，JAXB的SOAP MTOM / XOP模板 上载和下载文件非常麻烦。 都是为了创建伪造HTML表单并通过JavaScript伪造单击它们而只是为了将特定类型的文件发送到特定类型的REST端点而进行的黑客尝试。 我在寻找最佳方法方面遇到了很多麻烦。 因此，我将其放在这里，供其他正在寻求快速操作方法，以通过HTTP端点接受和发送二进制文件的人，更具体地说，是在SOAP请求中发送MTOM / XOP附件的人。 显然，这不是一个完全运行的示例。 它是您发送或接收MTOM / XOP SOAP请求所需的一切的骨架。 后端 非常直接的面向服务的体系结构。 控制器接受请求。 首先，Spring将文件解组为“ MultiPartFile”。 控制器然后将请求转换为DTO，然后将其传递给Service。 这就是业务逻辑的去向。 然后将其传递到发出传出请求的WebServ
axis2 axiom_深入了解Axis2：AXIOM
cusi77914的博客
06-30 978
还有另一种文档模型？ Apache Axis2 1.1已发布，它为长期运行的Apache系列Web服务框架的爱好者提供了激动人心的新功能。 我们将在以后的文章中介绍Axis2本身，但是本文将深入探讨Axis2核心的AXI对象模型（AXIOM）XML文档模型。 AXIOM是Axis2背后的重大创新之一，也是Axis2能够提供比原始Axis更好的性能的潜力之一。 本文将指导您完成AXIOM的工...
linux c++ gsoap如何构建服务端、多个客户端设置命名空间以及MTOM协议传输文件
最新发布
weixin_42335835的博客
11-15 806
使用c++ gsoap构建服务端、构建多个客户端并设置命名空间、MTOM协议传输文件
Web Service附件技术的发展及演变
flyingfalcon的专栏
09-01 947
http://www.searchsoa.com.cn/showcontent_7639.htm Web Service 通常将业务数据封装在 SOAP 主体或者 SOAP 消息附件中进行传输，这些附件往往采用 Base64 编码二进制方式进行封装，这将大大增加待传
JAX-WS - 二进制处理之MTOM(文件上传)
袭冷
06-30 1481
一、一般模式
C#调用Java Webservice报错
jackeychen888的博客
07-29 951
Error: 响应消息的内容类型 multipart/related;"。。。 与绑定(text/xml; charset=utf-8)的内容类型不匹配。 如果使用自定义编码器，请确保正确实现 IsContentTypeSupported 方法。 响应的前 491 个字节为:“–uuid:c3fab8c5-b53c-457a-9961-f0a92622acd3 Content-Id: rootpa...
jax-ws实现webservice调用
12-29
**Java API for XML Web Services (JAX-WS)** 是一种由Java SE和Java EE平台支持的用于构建Web服务的标准API。它使得开发人员能够轻松地创建、部署和使用基于SOAP（简单对象访问协议）的Web服务。在本教程中，我们将...
如何基于JAX-WS开发一个WebService实例
04-11
1. JAX-WS支持多种传输协议和消息编解码器，如HTTP、HTTPS以及MTOM和SWA。 2. WSDL文档是服务的核心，它描述了服务的接口、操作、绑定和地址。 3. 安全性是Web服务的重要考虑因素，JAX-WS支持基本认证、证书认证等...
jax-ws:有关JAX-WS 2.0的研究项目
05-20
5. **MTOM/XOP** - JAX-WS 2.0支持Message Transmission Optimization Mechanism (MTOM)和XML-binary Attachment Optimization (XOP)，优化大容量二进制数据传输，显著减少网络带宽消耗。 6. **WSDL生成** - 自动从...
JAX-WS 2.2 Jar包
03-27
在JAX-WS 2.2中，有一些显著的改进和新特性： - **异步调用支持**：允许客户端以非阻塞方式调用Web服务，提高了性能和响应性。 - **WS-Security**：支持WS-Security标准，提供安全的Web服务通信，包括数字签名和...
学习JAX-WSWebService开发
03-10
此外，JAX-WS还提供了多种高级特性，如MTOM（Message Transmission Optimization Mechanism）用于优化二进制数据传输，以及WS-Security用于实现Web服务的安全性。在实际开发中，了解这些特性将有助于提高Web服务的...
webservice有关application/xop+xml的异常
weixin_30432007的博客
03-13 298
今天同事调用一个webservice时返回类似错误 响应消息的内容类型 multipart/related; type="application/xop+xml"; boundary="uuid:026bd32a-6fb3-45a6-8559-fe68024bfe2a"; start="<root.message@cxf.apache.org>"; start-info="tex...
分布式.RPC-WebService三要素，三个规范， Soap协议（理解原理 才是事半功倍）
记录 分享 成就
08-21 1139
SOAP（Simple Object Access Protocol）简单对象访问协议。是基于HTTP协议，使用XML作为数据传输的格式，SOAP规定了XML的格式。XML格式的数据屏蔽了不同语言和平台对对象要求的不同，这个也是WebService（基于SOAP协议）有跨语言、跨平台特点的基础。跨语言、跨平台穿透防火墙：该协议基于HTTP，防火墙对80端口是开的，所以SOAP也就搭了顺风车，直接穿透W3C( 万维网联盟 )制定的标准。...
通过SOAP发送附件
weixin_34162629的博客
06-11 276
SendingAttachmentsWithSOAP.gif(9.9 K) clip_image001.gif(9.2 K) clip_image003.gif(16.2 K) clip_image005.gif(76.4 K) clip_image007.gif(49.1 K)  切换到幻灯片模式Sending...
第 2 部分: 深度探索 Axis2：AXIOM
ckangtai的专栏
04-03 2916
Apache Axis2 Web 服务框架构建于新的 AXIOM XML 文档模型之上，可以进行高效的 SOAP 消息处理。与常规的文档模型不同，AXIOM 仅在被访问时才会在内存中构建文档表示。了解为什么这种按需构造的方法对于 SOAP 处理来说非常合适，以及为什么 XOP/MTOM 附件、数据绑定和性能非常适于这种情况。 为什么需要另一种文档模型？Apache Axis2 1.1 已
webservice传递二进制数据(文件)
一名菜鸟攻城师
08-08 2123
将二进制数据放到Attachment中进行传递，而不是放到SOAPBODY进行传递    xsd文件中定义二进制数据类型 &lt;xsd:element type="tns:upload" name="upload"/&gt; &lt;xsd:element type="tns:uploadResponse" name="uploadResponse"/&gt; &lt;
WebService CXF --- 传输文件MTOM
To Strive To Seek To Find Not To Yield
12-25 363
一、几个相关的概念   1、MTOM基础概念            MTOM（Message Transmission Optimization Mechanism）消息优化传输机制。   它提出的模型适用于大量数据的交互情况。针对Base64编码情况带来的开销提出的解决方案。当数据量小的时候，SOAP依然使用XML进行消息的传递。     消息传输优化机制 (MTOM) 标准允许将消...
Client found response content type of 'multipart/related; type="application/xop+xml"; start="<soap.x
gd2008的专栏
12-02 5035
Client found response content type of 'multipart/related; type="application/xop+xml"; start=""; start-info="text/xml";    boundary="----=_Part_10_473535837.1417501736399"', but expected 'text/xml'. T
SOAP-MTOM_Canon.pdf
12-23
本文档主要探讨了SOAP (Simple Object Access Protocol) 的1.2版本及其与MTOM (Message Transmission Optimization Mechanism) 的结合应用，由Canon Research Centre France S.A.S. 提供。SOAP 1.2是一种基于XML的轻...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值