10장. XML 문서 사용

XML 형식 바인딩을 설명하는 데 사용되는 확장 기능은 네임스페이스 http://cxf.apache.org/bindings/xformat 에 정의되어 있습니다. Apache CXF 툴은 xformat 접두사를 사용하여 XML 바인딩 확장을 나타냅니다. 계약에 다음 줄을 추가합니다.Add the following line to your contract:

xmlns:xformat="http://cxf.apache.org/bindings/xformat"

인터페이스를 순수 XML 페이로드 형식으로 매핑하려면 다음을 수행합니다.

인터페이스의 메시지가 SOAP 봉투 없이 XML 문서로 전달되도록 지정하는 경우 메시지가 전선에 기록될 때 유효한 XML 문서를 형성하도록 해야 합니다. 또한 XML 문서를 수신하는 Apache CXF 이외의 사용자가 Apache CXF가 생성한 메시지를 이해하고 있는지 확인해야 합니다.

두 문제를 해결하는 간단한 방법은 글로벌 xformat:binding 요소 또는 개별 메시지의 xformat:body 요소에서 선택적 rootNode 특성을 사용하는 것입니다. rootNode 속성은 Apache CXF에서 생성된 XML 문서에 대한 루트 노드 역할을 하는 요소의 QName을 지정합니다. rootNode 속성이 설정되지 않은 경우 Apache CXF는 doc 스타일 메시지를 사용할 때 메시지 부분의 루트 요소를 루트 요소로 사용하거나 rpc 스타일 메시지를 사용할 때 메시지 파트 이름을 루트 요소로 사용합니다.

예를 들어 rootNode 속성이 예 10.1. “유효한 XML 바인딩 메시지” 에 정의된 메시지를 설정하지 않으면 루트 요소 lineNumber 를 사용하여 XML 문서를 생성합니다.

<type ... >
  ...
  <element name="operatorID" type="xsd:int"/>
  ...
</types>
<message name="operator">
  <part name="lineNumber" element="ns1:operatorID"/>
</message>

한 부분이 있는 메시지의 경우, Apache CXF는 rootNode 속성이 설정되지 않은 경우에도 항상 유효한 XML 문서를 생성합니다. 그러나 예 10.2. “잘못된 XML 바인딩 메시지” 의 메시지는 유효하지 않은 XML 문서를 생성합니다.

<types>
  ...
  <element name="pairName" type="xsd:string"/>
  <element name="entryNum" type="xsd:int"/>
  ...
</types>

<message name="matildas">
  <part name="dancing" element="ns1:pairName"/>
  <part name="number" element="ns1:entryNum"/>
</message>

XML 바인딩에 지정된 rootNode 특성이 없으면 Apache CXF는 예 10.2. “잘못된 XML 바인딩 메시지” 로 정의된 메시지에 대해 예 10.3. “잘못된 XML 문서” 와 유사한 XML 문서를 생성합니다. 생성된 XML 문서는 pairName 및 entryNum 의 두 가지 루트 요소가 있기 때문에 유효하지 않습니다.

<pairName>
  Fred&Linda
</pairName>
<entryNum>
  123
</entryNum>

rootNode 특성을 설정하면 예 10.4. “rootNode 세트가 있는 XML 바인딩” Apache CXF에서 지정된 루트 요소에 요소를 래핑합니다. 이 예제에서 rootNode 특성은 전체 바인딩에 대해 정의되며 루트 요소 이름이 entrants로 지정되도록 지정합니다.

<portType name="danceParty">
  <operation name="register">
    <input message="tns:matildas" name="contestant"/>
  </operation>
</portType>

<binding name="matildaXMLBinding" type="tns:dancingMatildas">
  <xmlformat:binding rootNode="entrants"/>
  <operation name="register">
    <input name="contestant"/>
    <output name="entered"/>
</binding>

입력 메시지에서 생성된 XML 문서는 예 10.5. “rootNode 특성을 사용하여 생성된 XML 문서” 과 유사합니다. XML 문서에는 이제 하나의 루트 요소만 있습니다.

<entrants>
  <pairName>
    Fred&Linda
  <entryNum>
    123
  </entryNum>
</entrants>

각 개별 메시지에 대해 rootNode 특성을 설정하거나 메시지 바인딩 내부의 xformat:body 요소를 사용하여 특정 메시지에 대한 전역 설정을 덮어쓸 수도 있습니다. 예를 들어 예 10.4. “rootNode 세트가 있는 XML 바인딩” 에 정의된 출력 메시지가 입력 메시지와 다른 루트 요소를 갖도록 하려면 예 10.6. “xformat:body사용” 에 표시된 대로 바인딩의 루트 요소를 재정의할 수 있습니다.

<binding name="matildaXMLBinding" type="tns:dancingMatildas">
  <xmlformat:binding rootNode="entrants"/>
  <operation name="register">
    <input name="contestant"/>
    <output name="entered">
      <xformat:body rootNode="entryStatus" />
    </output>
  </operation>
</binding>