5.4. Jakarta Enterprise Cryostats 클라이언트 상호 운용성 전환

원격 Jakarta Enterprise Cryostats 클라이언트 애플리케이션은 서버에 연결하기 위해 원격 하위 시스템에 정의된 커넥터를 사용합니다. 요구 사항에 따라 다음 커넥터 중 하나를 사용할 수 있습니다.

  • HTTP-connector: 기본 포트 8080으로 undertow 의 HTTP 업그레이드 기능을 통해 서버에 대한 클라이언트 연결을 지원합니다. 이 커넥터가 구성된 경우 클라이언트는 암호화되지 않은 연결에 remote+http URI 스키마를 사용하거나 암호화된 연결에 대해 remote+https URI 체계를 사용합니다.
  • 커넥터: 레거시 원격 URI 체계를 통해 서버에 대한 클라이언트 연결을 지원합니다. 이 커넥터는 이전 Jakarta Enterprise Cryostat 클라이언트 애플리케이션에서 사용하기에 적합합니다.
참고

이전 리모팅 기반 커넥터를 사용하는 것 외에도 Jakarta Enterprise Cryostats 클라이언트는 http URI 체계를 사용하여 undertow 및 HTTP 프로토콜을 통해 서버에 연결할 수 있습니다. 자세한 내용은 Jakarta Enterprise Cryostats Invocation Over HTTP 를 참조하십시오.

기본 HTTP 커넥터

기본 커넥터는 http-connector 로, 클라이언트가 URI 스키마 remote+http 또는 remote+https 를 사용해야 합니다. 기본 원격 연결 포트는 8080 입니다. 이 포트는 undertow 의 기본 포트와 동일합니다. 다음 예제에서는 jboss- Cryostat-client 속성 파일을 보여줍니다.

remote.connectionprovider.create.options.org.xnio.Options.SSL_ENABLED=false
remote.connections=default
remote.connection.default.host=localhost
remote.connection.default.port=8080
remote.connection.default.connect.options.org.xnio.Options.SASL_POLICY_NOANONYMOUS=false

다른 JBoss EAP 버전의 클라이언트 지원

클라이언트 애플리케이션이 JBoss EAP 6의 Jakarta Enterprise Cryostats 클라이언트 라이브러리를 사용하고 JBoss EAP 7 서버에 대한 연결이 필요한 경우 8080 이외의 포트에 원격 커넥터를 노출하도록 서버를 구성해야 합니다. 그런 다음 클라이언트는 새로 구성된 커넥터를 사용하여 연결해야 합니다.

JBoss EAP 7의 Jakarta Enterprise Cryostats 클라이언트 라이브러리를 사용하고 JBoss EAP 6 서버에 연결해야 하는 클라이언트 애플리케이션은 서버 인스턴스에서 remoting http-remoting 커넥터를 사용하지 않고 리모팅 커넥터를 사용해야 합니다. 이를 위해 다음과 같은 새 클라이언트 측 연결 속성을 정의합니다.

remote.connection.default.protocol=remote

자카르타 Enterprise Cryostats 클라이언트 애플리케이션에 대한 여러 커넥터 지원

JBoss EAP 7.4 이전에는 Jakarta Enterprise Cryostats 클라이언트 애플리케이션이 리모팅 하위 시스템에 정의된 하나의 리모팅 커넥터만 사용하여 서버에 연결할 수 있도록 제한되었습니다. 이 커넥터는 Cryostat 3 하위 시스템의 원격 요소의 connector-ref 특성에 지정되었습니다. 기본 http-connector 를 사용하여 undertow 의 HTTP 업그레이드 기능을 통해 remote+http 프로토콜을 사용하거나 기존 원격 프로토콜을 통해 연결을 제공하기 위해 레거시 커넥터 를 사용할 수 있습니다.

JBoss EAP 7.4를 사용하면 Jakarta Enterprise Cryostats 클라이언트가 연결을 위해 사용할 수 있는 커넥터 목록을 지정할 수 있습니다. 이 목록을 지정하려면 원격 요소의 새 커넥터 특성을 사용합니다. connector 속성은 원격 하위 시스템에 정의된 커넥터 목록을 허용합니다. 이를 통해 단일 서버에서 Jakarta Enterprise Cryostats 클라이언트 애플리케이션에 여러 연결을 제공할 수 있습니다. 예를 들어 EAP 7.2 이상과 호환되는 클라이언트는 이전 버전의 EAP 7.2와 호환되는 레거시 클라이언트 및 이전 버전의 EAP 7.2와 호환되는 레거시 클라이언트가 커넥터와 함께 기존 원격 프로토콜을 사용하여 연결할 수 있는 remote +http 프로토콜을 사용하여 서버에 연결할 수 있습니다.

예제

legacy-remoting-connector 가 remoting 하위 시스템에 정의된 커넥터 임을 고려할 때 다음 예제는 쓰기 속성을 사용하여 원격 커넥터의 값을 업데이트하는 Cryostat 3 하위 시스템 구성을 보여줍니다.

/subsystem=ejb3/service=remote:write-attribute(name=connectors, value=[http-remoting-connector, legacy-remoting-connector])

domain.xml 또는 standalone.xml 파일을 보고 Cryostat 3 하위 시스템에서 구성된 원격 커넥터를 확인할 수 있습니다.

<remote cluster="ejb" connectors="http-remoting-connector legacy-remoting-connector" thread-pool-name="default">
  <channel-creation-options>
   <option name="MAX_OUTBOUND_MESSAGES" value="1234" type="remoting"/>
  </channel-creation-options>
</remote>
참고

Jakarta Enterprise Beans 원격 호출은 JBoss EAP 7에서 JBoss EAP 6에서만 지원됩니다.

상호 운용성을 원격하는 Jakarta Enterprise Beans 외에도 다음 옵션을 사용하여 기존 클라이언트에 연결할 수 있습니다.

  • JBoss EAP 구성 가이드에서 JTS 트랜잭션의 ORB를 구성합니다.