9.2. MTOM을 사용하도록 데이터 유형에 주석 처리
9.2.1. 개요
WSDL에서 이미지 파일 또는 사운드 파일과 같은 바이너리 데이터 블록을 전달하는 데이터 유형을 정의할 때 데이터의 요소를 xsd:base64Binary 형식으로 정의합니다. 기본적으로 xsd:base64Binary 유형의 모든 요소는 MTOM을 사용하여 직렬화할 수 있는 byte[] 생성을 생성합니다. 그러나 코드 생성기의 기본 동작은 직렬화를 최대한 활용하지 않습니다.
MTOM을 최대한 활용하기 위해서는 서비스의 WSDL 문서 또는 바이너리 데이터 구조를 구현하는 CryostatB 클래스에 주석을 추가해야 합니다. WSDL 문서에 주석을 추가하면 코드 생성기가 바이너리 데이터에 대한 스트리밍 데이터 처리기를 생성하도록 합니다. CryostatB 클래스에 주석을 달 때는 적절한 콘텐츠 유형을 지정해야 하며 바이너리 데이터가 포함된 필드의 유형 사양을 변경해야 할 수도 있습니다.
9.2.2. 먼저 WSDL
예 9.1. “MTOM의 메시지” 하나의 문자열 필드, 하나의 정수 필드 및 바이너리 필드를 포함하는 메시지를 사용하는 웹 서비스에 대한 WSDL 문서를 표시합니다. 바이너리 필드는 큰 이미지 파일을 전송하기 위한 것이므로 일반 Cryostat 메시지의 일부로 보내는 것은 적절하지 않습니다.
예 9.1. MTOM의 메시지
<?xml version="1.0" encoding="UTF-8"?>
<definitions name="XrayStorage"
targetNamespace="http://mediStor.org/x-rays"
xmlns="http://schemas.xmlsoap.org/wsdl/"
xmlns:tns="http://mediStor.org/x-rays"
xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/"
xmlns:xsd1="http://mediStor.org/types/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<types>
<schema targetNamespace="http://mediStor.org/types/"
xmlns="http://www.w3.org/2001/XMLSchema">
<complexType name="xRayType">
<sequence>
<element name="patientName" type="xsd:string" />
<element name="patientNumber" type="xsd:int" />
<element name="imageData" type="xsd:base64Binary" />
</sequence>
</complexType>
<element name="xRay" type="xsd1:xRayType" />
</schema>
</types>
<message name="storRequest">
<part name="record" element="xsd1:xRay"/>
</message>
<message name="storResponse">
<part name="success" type="xsd:boolean"/>
</message>
<portType name="xRayStorage">
<operation name="store">
<input message="tns:storRequest" name="storRequest"/>
<output message="tns:storResponse" name="storResponse"/>
</operation>
</portType>
<binding name="xRayStorageSOAPBinding" type="tns:xRayStorage">
<soap12:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
<operation name="store">
<soap12:operation soapAction="" style="document"/>
<input name="storRequest">
<soap12:body use="literal"/>
</input>
<output name="storResponse">
<soap12:body use="literal"/>
</output>
</operation>
</binding>
...
</definitions>
MTOM을 사용하여 메시지의 바이너리 부분을 최적화된 첨부 파일로 보내려면 바이너리 데이터가 포함된 요소에 xmime:expectedContentTypes 속성을 추가해야 합니다. 이 속성은 http://www.w3.org/2005/05/xmlmime 네임스페이스에 정의되어 있으며 요소에 포함될 것으로 예상되는 MIME 유형을 지정합니다. 쉼표로 구분된 MIME 유형 목록을 지정할 수 있습니다. 이 속성의 설정은 코드 생성기가 데이터에 대한 CryostatB 클래스를 생성하는 방법을 변경합니다. 대부분의 MIME 유형의 경우 코드 생성기는 DataHandler를 생성합니다. 이미지 옵션과 같은 일부 MIME 유형에는 매핑이 정의되어 있습니다.
MIME 유형은 Internet Assigned Numbers Authority(IANA)에 의해 유지 관리되며 Multipurpose Internet Mail Extensions (MIME) Part One: Internet Message Bodies 및 Multipurpose Internet Mail Extensions (MIME) Part 2 에 자세히 설명되어 있습니다.
대부분의 용도에서 application/octet-stream 을 지정합니다.
예 9.2. “MTOM의 바이너리 데이터” MTOM을 사용하기 위해 예 9.1. “MTOM의 메시지” 에서 x CryostatType 을 수정하는 방법을 보여줍니다.
예 9.2. MTOM의 바이너리 데이터
...
<types>
<schema targetNamespace="http://mediStor.org/types/"
xmlns="http://www.w3.org/2001/XMLSchema"
xmlns:xmime="http://www.w3.org/2005/05/xmlmime">
<complexType name="xRayType">
<sequence>
<element name="patientName" type="xsd:string" />
<element name="patientNumber" type="xsd:int" />
<element name="imageData" type="xsd:base64Binary"
xmime:expectedContentTypes="application/octet-stream"/>
</sequence>
</complexType>
<element name="xRay" type="xsd1:xRayType" />
</schema>
</types>
...
x CryostatType 용으로 생성된 생성된 CryostatB 클래스에는 더 이상 byte[] 가 포함되어 있지 않습니다. 대신 코드 생성기는 xmime:expectedContentTypes 속성을 보고 imageData 필드에 대한 DataHandler를 생성합니다.
MTOM을 사용하기 위해 바인딩 요소를 변경할 필요가 없습니다. 런타임은 데이터를 전송할 때 적절한 변경을 수행합니다.
9.2.3. Java 첫 번째
Java를 처음 개발하는 경우 다음 작업을 수행하여 CryostatB 클래스 MTOM을 준비할 수 있습니다.
- 바이너리 데이터를 보유하는 필드가 DataHandler인지 확인합니다.
-
스트림할 데이터가 MTOM 첨부 파일로 포함된 필드에
@ CryostatMimeType()주석을 추가합니다.
예 9.3. “MTOM용 CryostatB 클래스” MTOM을 사용하기 위해 주석이 추가된 CryostatB 클래스를 표시합니다.
예 9.3. MTOM용 CryostatB 클래스
@XmlType
public class XRayType {
protected String patientName;
protected int patientNumber;
@XmlMimeType("application/octet-stream")
protected DataHandler imageData;
...
}