Приложение JAX-WS с MTOM

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

    }

}

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** [email protected]>";
type="application/xop+xml";
boundary="uuid:c73c9ce8-6e02-40ce-9f68-064e18843428";
start-info="text/xml"

--uuid:c73c9ce8-6e02-40ce-9f68-064e18843428

Content-Id: <rootpart** [email protected]> Тип контента: application/xop xml; charset = utf-8; type = "text/xml" Content-Transfer -Кодирование: двоичное

<? xml version = "1.0"?>
  <S: Конверт xmlns: S = "http://schemas.xmlsoap.org/soap/envelope/">
     <S: Body>
    <ns2: downloadImageResponse xmlns: ns2 = "http://ws.mkyong.com/">
      <Возвращение>
        <xop: Включить xmlns: xop = "http://www.w3.org/2004/08/xop/include"
        HREF = "чид: [email protected]">
        </ХОР: Включить>
      </Вернуться>
    </Ns2: downloadImageResponse>
     </S: Body>
   </S: Envelope>
--uuid: c73c9ce8-6e02-40ce-9f68-064e18843428
Content-Id: <[email protected]>
Тип контента: изображение/PNG
Content-Transfer-Encoding: двоичный

Двоичные данные здесь .............

===  1. Клиент WebService

Вот клиент веб-сервиса для отправки файла изображения на опубликованную конечную точку выше (http://localhost: 8888/ws/image) через MTOM

__File: ImageClient.java__

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, сгенерированный клиентом, захваченный инструментом мониторинга трафика.

__P.S Первый запрос wsdl опущен для экономии места .__ + **  Клиентский запрос на отправку: **

**  Сервер отправляет ответ: **

===  Полный документ WSDL

Для тех, кто заинтересован в изучении файла WSDL, вы можете получить файл wsdl по URL: __http://localhost: 9999/ws/image? 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](20 КБ)

[#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-with-SOAP

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

ссылка://тег/вложение/[вложение]ссылка://тег/jax-ws/[jax-ws]ссылка://тег/мтом/[мтом]ссылка://тег/веб-сервисы/[веб-сервисы]