MTOMを使用したJAX-WSの添付

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);

}

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!");

    }

}

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!");

    }

}

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("https://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!");

    }

}

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"コンテンツ転送 - エンコーディング:バイナリ

<？xml version = "1.0"？>
  <S:封筒xmlns:S = "http://schemas.xmlsoap.org/soap/envelope/">
     <S:Body>
    <ns2:downloadImageResponse xmlns:ns2 = "http://ws.mkyong.com/">
      <戻る>
        <xop:Include xmlns:xop = "http://www.w3.org/2004/08/xop/include"
        href = "cid:012eb00e-9460-407c-b622-1be987fdb2cf@example.jaxws.sun.com">
        </xop:インクルード>
      </return>
    </ns2:downloadImageResponse>
     </S:Body>
   </S:封筒>
--uuid:c73c9ce8-6e02-40ce-9f68-064e18843428
コンテンツID:<012eb00e-9460-407c-b622-1be987fdb2cf@example.jaxws.sun.com>
コンテンツタイプ:image/png
コンテンツ転送エンコーディング:バイナリ

ここのバイナリデータ.............

===  1. WebServiceクライアント

MTOMを介して上記の公開されたエンドポイント（http://localhost:8888/ws/image）に画像ファイルを送信するWebサービスクライアントがあります。

__File:ImageClient.java__

public static void main(String[]args) throws Exception {

URL url = new URL("https://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トラフィックです。

__P.Sスペースを節約するために最初のwsdl要求は省略されました。__ ** クライアント送信要求:**

** サーバーは応答を送信します:**

=== 完全なWSDL文書

WSDLファイルの調査に興味がある人は、URL:__http://localhost:9999/ws/image？wsdl__を使用してwsdlファイルを入手できます。

ImageServer WSDLファイルのサンプル

<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>

<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>

=== ソースコードをダウンロードする

ダウンロード - リンク://wp-content/uploads/2010/11/JAX-WS-Attachment-MTOM-Example.zip[JAX-WS-Attachment-MTOM-Example.zip]（20KB）

[#reference]##

=== リファレンス

.  http://www.devx.com/xml/Article/34797/1763/page/1

.  http://download.oracle.com/docs/cd/E17802__01/webservices/webservices/docs/2.0/jaxws/mtom-swaref.html

.  http://www.crosschecknet.com/intro__to__mtom.php

.  http://download.oracle.com/docs/cd/E12840__01/wls/docs103/webserv__adv/mtom.html

.  http://www.theserverside.com/news/1363957/Sending-Attachments-withSOAP

.  http://metro.java.net/guide/Binary__Attachments____MTOM__.html

リンク://タグ/添付ファイル/[添付ファイル]リンク://タグ/jax-ws/[jax-ws]link://tag/mtom/[mtom]link://タグ/web-services/[Webサービス]