21.5. WS-RM 구성

21.5.1. Apache CXF-Specific WS-RM 속성 구성

21.5.1.1. 개요

Apache CXF별 속성을 구성하려면 rmManager Spring 빈을 사용합니다. 설정 파일에 다음을 추가합니다.

네임스페이스 목록에 대한 http://cxf.apache.org/ws/rm/manager 네임스페이스입니다.
구성하려는 특정 속성에 대한 rmManager Spring 빈입니다.

예 21.4. “Apache CXF-Specific WS-RM 속성 구성” 간단한 예를 보여줍니다.

예 21.4. Apache CXF-Specific WS-RM 속성 구성

&lt;beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:wsrm-mgr="http://cxf.apache.org/ws/rm/manager"
      xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
 http://cxf.apache.org/ws/rm/manager http://cxf.apache.org/schemas/configuration/wsrm-manager.xsd"&gt;
...
&lt;wsrm-mgr:rmManager&gt;
&lt;!--
  ...Your configuration goes here
--&gt;
&lt;/wsrm-mgr:rmManager&gt;

21.5.1.2. rmManager Spring 빈의 하위 항목

표 21.2. “rmManager Spring Bean의 하위” http://cxf.apache.org/ws/rm/manager 네임스페이스에 정의된 rmManager Spring 빈의 하위 요소를 보여줍니다.

표 21.2. rmManager Spring Bean의 하위
요소	설명
`RMAsertion`	`RMAssertion`유형의 요소
`deliveryAssurance`	적용할 전달 보장을 설명하는 Type `DeliveryAssuranceType` 의 요소
`sourcePolicy`	RM 소스의 세부 정보를 구성할 수 있는 `SourcePolicyType` 유형의 요소
`destinationPolicy`	RM 대상에 대한 세부 정보를 구성할 수 있는 `DestinationPolicyType` 유형의 요소

21.5.1.3. 예제

예를 들어 “확인되지 않은 최대 메시지 임계값” 에서 참조하십시오.

21.5.2. 표준 WS-RM 정책 속성 구성

21.5.2.1. 개요

다음 방법 중 하나로 표준 WS-RM 정책 속성을 구성할 수 있습니다.

21.5.2.2. WS-Policy RMAsertion Children

표 21.3. “WS-Policy RMAsertion Element의 하위 항목” http://schemas.xmlsoap.org/ws/2005/02/rm/policy 네임스페이스에 정의된 요소를 표시합니다.

표 21.3. WS-Policy RMAsertion Element의 하위 항목
이름	설명
`InactivityTimeout`	비활성으로 인해 RM 시퀀스를 종료하기 전에 메시지를 수신하지 않고 전달해야 하는 시간을 지정합니다.
`BaseRetransmissionInterval`	지정된 메시지에 대해 RM Source가 승인을 받아야 하는 간격을 설정합니다. `BaseRetransmissionInterval` 에 의해 설정된 시간 내에 승인이 수신되지 않으면 RM Source가 메시지를 다시 전송합니다.
`ExponentialBackoff`	일반적으로 알려진 지수 백오프 알고리즘(Tanenbaum)을 사용하여 재전송 간격이 조정됨을 나타냅니다. 자세한 내용은 Computer Networks, Andrew S. Tanenbaum, Prentice Hall PTR, 2003을 참조하십시오.
`AcknowledgementInterval`	WS-RM에서 승인은 반환 메시지로 전송되거나 독립형으로 전송됩니다. 반환 메시지를 사용하여 승인을 보낼 수 없는 경우 RM Destination은 독립형 승인을 보내기 전에 승인 간격까지 기다릴 수 있습니다. 확인되지 않은 메시지가 없으면 RM Destination은 승인 메시지를 보내지 않도록 선택할 수 있습니다.

21.5.2.3. 자세한 참조 정보

각 요소의 하위 요소 및 특성에 대한 설명을 포함한 자세한 참조 정보는 http://schemas.xmlsoap.org/ws/2005/02/rm/wsrm-policy.xsd 에서 참조하십시오.

21.5.2.4. rmManager Spring bean의 RMAsertion

Apache CXF rmManager Spring bean에 RMAssertion 을 추가하여 표준 WS-RM 정책 속성을 구성할 수 있습니다. 동일한 구성 파일에 모든 WS-RM 구성을 유지하려면 이 방법이 가장 좋습니다. 즉, 동일한 파일에서 Apache CXF 특정 속성과 표준 WS-RM 정책 속성을 구성하려면 가장 좋은 방법입니다.

예를 들어 예 21.5. “rmManager Spring Bean에서 RMAssertion을 사용하여 WS-RM 속성 구성” 의 구성은 다음과 같습니다.

rmManager Spring 빈 내에서 RMAssertion 을 사용하여 구성된 표준 WS-RM 정책 속성 BaseRetransmissionInterval.
동일한 구성 파일에 구성된 Apache CXF별 RM 속성인 intraMessageThreshold.

예 21.5. rmManager Spring Bean에서 RMAssertion을 사용하여 WS-RM 속성 구성

<beans xmlns:wsrm-policy="http://schemas.xmlsoap.org/ws/2005/02/rm/policy"
       xmlns:wsrm-mgr="http://cxf.apache.org/ws/rm/manager"
...>
<wsrm-mgr:rmManager id="org.apache.cxf.ws.rm.RMManager">
    <wsrm-policy:RMAssertion>
        <wsrm-policy:BaseRetransmissionInterval Milliseconds="4000"/>
    </wsrm-policy:RMAssertion>
    <wsrm-mgr:destinationPolicy>
        <wsrm-mgr:acksPolicy intraMessageThreshold="0" />
    </wsrm-mgr:destinationPolicy>
</wsrm-mgr:rmManager>
</beans>

21.5.2.5. 기능 내에서 정책

예 21.6. “WS-RM 특성을 기능 내에서 정책으로 구성” 과 같이 기능 내에서 표준 WS-RM 정책 특성을 구성할 수 있습니다.

예 21.6. WS-RM 특성을 기능 내에서 정책으로 구성

<xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xmlns:wsa="http://cxf.apache.org/ws/addressing"
        xmlns:wsp="http://www.w3.org/2006/07/ws-policy"
        xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"
        xmlns:jaxws="http://cxf.apache.org/jaxws"
        xsi:schemaLocation="
http://www.w3.org/2006/07/ws-policy http://www.w3.org/2006/07/ws-policy.xsd
http://cxf.apache.org/ws/addressing http://cxf.apache.org/schema/ws/addressing.xsd
http://cxf.apache.org/jaxws http://cxf.apache.org/schemas/jaxws.xsd
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd">
    <jaxws:endpoint name="{http://cxf.apache.org/greeter_control}GreeterPort" createdFromAPI="true">
        <jaxws:features>
               <wsp:Policy>
                   <wsrm:RMAssertion xmlns:wsrm="http://schemas.xmlsoap.org/ws/2005/02/rm/policy">
                     <wsrm:AcknowledgementInterval Milliseconds="200" />
                   </wsrm:RMAssertion>
                   <wsam:Addressing xmlns:wsam="http://www.w3.org/2007/02/addressing/metadata">
                       <wsp:Policy>
                            <wsam:NonAnonymousResponses/>
                       </wsp:Policy>
                   </wsam:Addressing>
              </wsp:Policy>
        </jaxws:features>
    </jaxws:endpoint>
</beans>

21.5.2.6. WSDL 파일

WS-Policy 프레임워크를 사용하여 WS-RM을 활성화하는 경우 WSDL 파일에서 표준 WS-RM 정책 속성을 구성할 수 있습니다. 이 방법은 서비스에서 기타 정책 인식 웹 서비스 스택에 배포된 소비자와 함께 WS-RM을 원활하게 사용하고자 하는 경우에 적합합니다.

예를 들어, “WS-Policy 프레임워크: 암시적으로 인터셉터 추가” 기본 재전송 간격이 WSDL 파일에 구성된 위치를 참조하십시오.

21.5.2.7. 외부 첨부 파일

외부 연결 파일에서 표준 WS-RM 정책 속성을 구성할 수 있습니다. 이 방법은 WSDL 파일을 변경할 수 없거나 원하지 않는 경우 좋은 방법입니다.

예 21.7. “외부 연결에서 WS-RM 구성” 특정 EPR에 대해 WS-A 및 WS-RM(기본 재전송 간격 30초)을 둘 다 활성화하는 외부 연결을 보여줍니다.

예 21.7. 외부 연결에서 WS-RM 구성

<attachments xmlns:wsp="http://www.w3.org/2006/07/ws-policy" xmlns:wsa="http://www.w3.org/2005/08/addressing">
    <wsp:PolicyAttachment>
        <wsp:AppliesTo>
           <wsa:EndpointReference>
                <wsa:Address>http://localhost:9020/SoapContext/GreeterPort</wsa:Address>
            </wsa:EndpointReference>
        </wsp:AppliesTo>
        <wsp:Policy>
            <wsam:Addressing xmlns:wsam="http://www.w3.org/2007/02/addressing/metadata">
                <wsp:Policy/>
            </wsam:Addressing>
            <wsrmp:RMAssertion xmlns:wsrmp="http://schemas.xmlsoap.org/ws/2005/02/rm/policy">
                <wsrmp:BaseRetransmissionInterval Milliseconds="30000"/>
            </wsrmp:RMAssertion>
        </wsp:Policy>
    </wsp:PolicyAttachment>
</attachments>/

21.5.3. WS-RM 구성 사용 사례

21.5.3.1. 개요

이 하위 섹션에서는 사용 사례 관점에서 WS-RM 속성을 구성하는 데 중점을 둡니다. 속성이 http://schemas.xmlsoap.org/ws/2005/02/rm/policy/ 네임스페이스에 정의된 표준 WS-RM 정책 특성인 경우 rmManager Spring 빈 내의 RMAssertion 에서 설정하는 예제만 표시됩니다. 기능 내에서 정책과 같은 속성을 설정하는 방법에 대한 자세한 내용은 WSDL 파일 또는 외부 연결에서 참조하십시오. 21.5.2절. “표준 WS-RM 정책 속성 구성”

다음 사용 사례에 대해 설명합니다.

21.5.3.2. 기본 재전송 간격

BaseRetransmissionInterval 요소는 RM 소스가 아직 확인되지 않은 메시지를 다시 전송하는 간격을 지정합니다. http://schemas.xmlsoap.org/ws/2005/02/rm/wsrm-policy.xsd 스키마 파일에 정의되어 있습니다. 기본값은 3000밀리초입니다.

예 21.8. “WS-RM 기본 재전송 간격 설정” WS-RM 기본 재전송 간격을 설정하는 방법을 보여줍니다.

예 21.8. WS-RM 기본 재전송 간격 설정

<beans xmlns:wsrm-policy="http://schemas.xmlsoap.org/ws/2005/02/rm/policy
...>
<wsrm-mgr:rmManager id="org.apache.cxf.ws.rm.RMManager">
    <wsrm-policy:RMAssertion>
        <wsrm-policy:BaseRetransmissionInterval Milliseconds="4000"/>
    </wsrm-policy:RMAssertion>
</wsrm-mgr:rmManager>
</beans>

21.5.3.3. 다시 전송 시 지수 백오프

ExponentialBackoff 요소는 검증되지 않은 메시지에 대한 연속 재전송 시도가 지수 간격으로 수행되는지 여부를 결정합니다.

ExponentialBackoff 요소의 존재로 인해 이 기능을 사용할 수 있습니다. 기본적으로 2 의 지수 백오프 비율이 사용됩니다. ExponentialBackoff 는 플래그입니다. 요소가 있으면 exponential 백오프가 활성화됩니다. 요소가 없으면 exponential 백오프가 비활성화됩니다. 값이 필요하지 않습니다.

예 21.9. “WS-RM Exponential Backoff 속성 설정” 는 재전송을 위해 WS-RM exponential 백오프를 설정하는 방법을 보여줍니다.

예 21.9. WS-RM Exponential Backoff 속성 설정

<beans xmlns:wsrm-policy="http://schemas.xmlsoap.org/ws/2005/02/rm/policy
...>
<wsrm-mgr:rmManager id="org.apache.cxf.ws.rm.RMManager">
    <wsrm-policy:RMAssertion>
        <wsrm-policy:ExponentialBackoff/>
    </wsrm-policy:RMAssertion>
</wsrm-mgr:rmManager>
</beans>

21.5.3.4. 승인 간격

AcknowledgementInterval 요소는 WS-RM 대상이 비동기 승인을 보내는 간격을 지정합니다. 이는 수신 메시지의 수신 시 보내는 동기 확인에도 추가됩니다. 기본 비동기 승인 간격은 0 밀리초입니다. 즉, AcknowledgementInterval 이 특정 값으로 구성되지 않은 경우 승인은 즉시 전송됩니다(즉, 첫 번째 사용 가능한 기회에서).

비동기 승인은 다음 두 조건이 모두 충족되는 경우에만 RM 대상에 의해 전송됩니다.

RM 대상은 비익명 wsrm:acksTo 끝점을 사용합니다.
승인 간격이 만료되기 전에 응답 메시지에 대한 승인이 발생하지 않습니다.

예 21.10. “WS-RM 인식 간격 설정” 는 WS-RM 승인 간격을 설정하는 방법을 보여줍니다.

예 21.10. WS-RM 인식 간격 설정

<beans xmlns:wsrm-policy="http://schemas.xmlsoap.org/ws/2005/02/rm/policy
...>
<wsrm-mgr:rmManager id="org.apache.cxf.ws.rm.RMManager">
    <wsrm-policy:RMAssertion>
        <wsrm-policy:AcknowledgementInterval Milliseconds="2000"/>
    </wsrm-policy:RMAssertion>
</wsrm-mgr:rmManager>
</beans>

21.5.3.5. 확인되지 않은 최대 메시지 임계값

maxUnacknowledged 특성은 시퀀스가 종료되기 전에 시퀀스당 누적할 수 있는 최대 메시지 수를 설정합니다.

예 21.11. “WS-RM Maximum Unackledged Message Threshold 설정” WS-RM 최대 확인되지 않은 메시지 임계값을 설정하는 방법을 보여줍니다.

예 21.11. WS-RM Maximum Unackledged Message Threshold 설정

<beans xmlns:wsrm-mgr="http://cxf.apache.org/ws/rm/manager
...>
<wsrm-mgr:reliableMessaging>
    <wsrm-mgr:sourcePolicy>
        <wsrm-mgr:sequenceTerminationPolicy maxUnacknowledged="20" />
    </wsrm-mgr:sourcePolicy>
</wsrm-mgr:reliableMessaging>
</beans>

21.5.3.6. RM 시퀀스의 최대 길이

maxLength 속성은 WS-RM 시퀀스의 최대 길이를 설정합니다. 기본값은 0 이며, 이는 WS-RM 시퀀스의 길이가 바인딩되지 않음을 의미합니다.

이 속성이 설정되면 RM 끝점이 제한에 도달하면 새 RM 시퀀스를 생성하고 이전에 보낸 메시지에 대한 모든 승인을 받습니다. 새 메시지는 newsequence를 사용하여 전송됩니다.

예 21.12. “WS-RM 메시지 시퀀스의 최대 길이 설정” RM 시퀀스의 최대 길이를 설정하는 방법을 보여줍니다.

예 21.12. WS-RM 메시지 시퀀스의 최대 길이 설정

<beans xmlns:wsrm-mgr="http://cxf.apache.org/ws/rm/manager
...>
<wsrm-mgr:reliableMessaging>
    <wsrm-mgr:sourcePolicy>
        <wsrm-mgr:sequenceTerminationPolicy maxLength="100" />
    </wsrm-mgr:sourcePolicy>
</wsrm-mgr:reliableMessaging>
</beans>

21.5.3.7. 메시지 전달 보장 정책

다음과 같은 전달 보장 정책을 사용하도록 RM 대상을 구성할 수 있습니다.

At mostOnce - RM 대상은 한 번만 애플리케이션 목적지로 메시지를 전달합니다. 메시지가 두 번 이상 발생하는 경우 오류가 발생합니다. 시퀀스의 일부 메시지가 전달되지 않을 수 있습니다.
AtLeastOnce - RM 대상은 적어도 한 번 이상 애플리케이션 대상으로 메시지를 전달합니다. 전송된 모든 메시지가 전송되거나 오류가 발생합니다. 일부 메시지는 한 번 이상 배달될 수 있습니다.
InOrder - RM 대상은 전송된 순서대로 애플리케이션 대상에 메시지를 전달합니다. 이 전달 보장은 At most Once 또는 AtLeastOnce 보증과 결합할 수 있습니다.

예 21.13. “WS-RM 메시지 전달 보장 정책 설정” 는 WS-RM 메시지 전달 보증을 설정하는 방법을 보여줍니다.

예 21.13. WS-RM 메시지 전달 보장 정책 설정

<beans xmlns:wsrm-mgr="http://cxf.apache.org/ws/rm/manager
...>
<wsrm-mgr:reliableMessaging>
    <wsrm-mgr:deliveryAssurance>
        <wsrm-mgr:AtLeastOnce />
    </wsrm-mgr:deliveryAssurance>
</wsrm-mgr:reliableMessaging>
</beans>