SOAP API

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
  <soap:Header>
    <!-- 선택적 헤더 정보 -->
    <auth:Credentials xmlns:auth="http://example.org/auth">
      <auth:Username>사용자</auth:Username>
      <auth:Password>비밀번호</auth:Password>
    </auth:Credentials>
  </soap:Header>
  <soap:Body>
    <!-- 필수 본문 내용 -->
    <m:GetStockPrice xmlns:m="http://example.org/stock">
      <m:StockName>IBM</m:StockName>
    </m:GetStockPrice>
  </soap:Body>
</soap:Envelope>

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

<?xml version="1.0" encoding="UTF-8"?>
<definitions name="StockQuote"
             targetNamespace="http://example.org/stock/wsdl"
             xmlns="http://schemas.xmlsoap.org/wsdl/"
             xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
             xmlns:tns="http://example.org/stock/wsdl"
             xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    
    <!-- 데이터 타입 정의 -->
    <types>
        <xsd:schema targetNamespace="http://example.org/stock/xsd">
            <xsd:element name="GetStockPriceRequest">
                <xsd:complexType>
                    <xsd:sequence>
                        <xsd:element name="StockName" type="xsd:string"/>
                    </xsd:sequence>
                </xsd:complexType>
            </xsd:element>
            <xsd:element name="GetStockPriceResponse">
                <xsd:complexType>
                    <xsd:sequence>
                        <xsd:element name="Price" type="xsd:decimal"/>
                    </xsd:sequence>
                </xsd:complexType>
            </xsd:element>
        </xsd:schema>
    </types>
    
    <!-- 메시지 정의 -->
    <message name="GetStockPriceInput">
        <part name="body" element="xsd:GetStockPriceRequest"/>
    </message>
    <message name="GetStockPriceOutput">
        <part name="body" element="xsd:GetStockPriceResponse"/>
    </message>
    
    <!-- 포트 타입 정의 -->
    <portType name="StockQuotePortType">
        <operation name="GetStockPrice">
            <input message="tns:GetStockPriceInput"/>
            <output message="tns:GetStockPriceOutput"/>
        </operation>
    </portType>
    
    <!-- 바인딩 정의 -->
    <binding name="StockQuoteSoapBinding" type="tns:StockQuotePortType">
        <soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
        <operation name="GetStockPrice">
            <soap:operation soapAction="http://example.org/GetStockPrice"/>
            <input>
                <soap:body use="literal"/>
            </input>
            <output>
                <soap:body use="literal"/>
            </output>
        </operation>
    </binding>
    
    <!-- 서비스 정의 -->
    <service name="StockQuoteService">
        <port name="StockQuotePort" binding="tns:StockQuoteSoapBinding">
            <soap:address location="http://example.org/stockquote"/>
        </port>
    </service>
</definitions>

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
           targetNamespace="http://example.org/stock"
           xmlns:tns="http://example.org/stock"
           elementFormDefault="qualified">
  
  <xsd:element name="GetStockPrice">
    <xsd:complexType>
      <xsd:sequence>
        <xsd:element name="StockName" type="xsd:string"/>
      </xsd:sequence>
    </xsd:complexType>
  </xsd:element>
  
  <xsd:element name="StockPriceResponse">
    <xsd:complexType>
      <xsd:sequence>
        <xsd:element name="Price" type="xsd:decimal"/>
        <xsd:element name="Currency" type="xsd:string"/>
        <xsd:element name="LastUpdate" type="xsd:dateTime"/>
      </xsd:sequence>
    </xsd:complexType>
  </xsd:element>
  
</xsd:schema>

1
2
3
4
5
6
7

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
  <soap:Body>
    <m:GetStockPrice xmlns:m="http://example.org/stock">
      <m:StockName>IBM</m:StockName>
    </m:GetStockPrice>
  </soap:Body>
</soap:Envelope>

1
2
3
4
5
6
7

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
  <soap:Body>
    <m:GetStockPriceResponse xmlns:m="http://example.org/stock">
      <m:Price>95.72</m:Price>
    </m:GetStockPriceResponse>
  </soap:Body>
</soap:Envelope>

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
  <soap:Body>
    <soap:Fault>
      <soap:Code>
        <soap:Value>soap:Sender</soap:Value>
      </soap:Code>
      <soap:Reason>
        <soap:Text xml:lang="en">Stock not found</soap:Text>
      </soap:Reason>
      <soap:Detail>
        <e:StockError xmlns:e="http://example.org/stock/error">
          <e:Message>Stock 'XYZ' does not exist</e:Message>
          <e:ErrorCode>E123</e:ErrorCode>
        </e:StockError>
      </soap:Detail>
    </soap:Fault>
  </soap:Body>
</soap:Envelope>

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
  <soap:Header>
    <wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
      <wsse:UsernameToken>
        <wsse:Username>사용자명</wsse:Username>
        <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">비밀번호</wsse:Password>
      </wsse:UsernameToken>
    </wsse:Security>
  </soap:Header>
  <soap:Body>
    <!-- 메시지 본문 -->
  </soap:Body>
</soap:Envelope>

1
2
3
4
5
6
7
8

<soap:Header>
   <wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
      <wsse:UsernameToken>
         <wsse:Username>user123</wsse:Username>
         <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">pass456</wsse:Password>
      </wsse:UsernameToken>
   </wsse:Security>
</soap:Header>

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

<soap:Header>
   <wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
      <wsse:BinarySecurityToken 
         EncodingType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap-message-security-1.0#Base64Binary"
         ValueType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-x509-token-profile-1.0#X509v3"
         wsu:Id="X509Token">
         <!-- Base64로 인코딩된 X.509 인증서 -->
      </wsse:BinarySecurityToken>
   </wsse:Security>
</soap:Header>

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

<soap:Header>
   <wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
      <!-- 인증 토큰 -->
      <ds:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
         <ds:SignedInfo>
            <ds:CanonicalizationMethod Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/>
            <ds:SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1"/>
            <ds:Reference URI="#Body">
               <ds:DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/>
               <ds:DigestValue>Hash값</ds:DigestValue>
            </ds:Reference>
         </ds:SignedInfo>
         <ds:SignatureValue>서명값</ds:SignatureValue>
      </ds:Signature>
   </wsse:Security>
</soap:Header>

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

<soap:Body>
   <xenc:EncryptedData xmlns:xenc="http://www.w3.org/2001/04/xmlenc#"
      Type="http://www.w3.org/2001/04/xmlenc#Content">
      <xenc:EncryptionMethod Algorithm="http://www.w3.org/2001/04/xmlenc#aes256-cbc"/>
      <ds:KeyInfo xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
         <!-- 키 정보 -->
      </ds:KeyInfo>
      <xenc:CipherData>
         <xenc:CipherValue>암호화된 데이터</xenc:CipherValue>
      </xenc:CipherData>
   </xenc:EncryptedData>
</soap:Body>

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

package com.example.stockservice;

import javax.jws.WebService;
import javax.jws.WebMethod;
import javax.jws.WebParam;

@WebService(serviceName = "StockQuoteService")
public interface StockQuoteService {
    
    @WebMethod
    public float getStockPrice(@WebParam(name = "stockName") String stockName);
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

package com.example.stockservice;

import javax.jws.WebService;
import java.util.HashMap;
import java.util.Map;

@WebService(endpointInterface = "com.example.stockservice.StockQuoteService")
public class StockQuoteServiceImpl implements StockQuoteService {
    
    private Map<String, Float> stockPrices = new HashMap<>();
    
    public StockQuoteServiceImpl() {
        // 샘플 데이터 초기화
        stockPrices.put("IBM", 176.25f);
        stockPrices.put("AAPL", 149.35f);
        stockPrices.put("MSFT", 338.11f);
        stockPrices.put("GOOGL", 128.45f);
    }
    
    @Override
    public float getStockPrice(String stockName) {
        if (!stockPrices.containsKey(stockName)) {
            throw new RuntimeException("Stock not found: " + stockName);
        }
        return stockPrices.get(stockName);
    }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

package com.example.stockservice;

import javax.xml.ws.Endpoint;

public class StockQuotePublisher {
    public static void main(String[] args) {
        // 웹 서비스 엔드포인트 게시
        Endpoint.publish("http://localhost:8080/stockservice", new StockQuoteServiceImpl());
        System.out.println("Stock Quote Service is published at http://localhost:8080/stockservice");
    }
}

1

wsimport -keep -p com.example.stockclient http://localhost:8080/stockservice?wsdl

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

package com.example.stockclient;

public class StockQuoteClient {
    public static void main(String[] args) {
        // 서비스 및 포트 생성
        StockQuoteService_Service service = new StockQuoteService_Service();
        StockQuoteService port = service.getStockQuoteServicePort();
        
        // 주식 가격 요청
        try {
            String stockName = "IBM";
            float price = port.getStockPrice(stockName);
            System.out.println("The price of " + stockName + " is $" + price);
        } catch (Exception e) {
            System.out.println("Error: " + e.getMessage());
        }
    }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

from zeep import Client

# WSDL URL로 클라이언트 생성
client = Client('http://localhost:8080/stockservice?wsdl')

# 서비스 호출
stock_name = 'IBM'
result = client.service.getStockPrice(stockName=stock_name)

print(f"The price of {stock_name} is ${result}")