remoting 子系统允许您为本地和远程服务配置入站（inbound）和出站（outbound）连接，以及这些连接的设置。

JBoss Remoting 包括以下可配置的元素：端点（endpoint）、连接器（connector），以及一系列的本地和远程 URI。除非用户的应用程序需要使用自定义的连接器，用户一般不需要配置 remoting 子系统。那些需要作为远程客户端的应用程序（如 EJB）则需要独立的配置来连接到一个特定的连接器。

默认的 Remoting 子系统配置

<subsystem xmlns="urn:jboss:domain:remoting:3.0">
    <endpoint/>
    <http-connector name="http-remoting-connector" connector-ref="default" security-realm="ApplicationRealm"/>
</subsystem>

如需获得 remoting 子系统可用的完整属性列表，请参阅 Remoting 子系统属性。

Remoting 端点

Remoting 端点使用了 io 子系统声明和配置的 XNIO 工作节点。

如需了解如何配置远程端点的信息，请参阅配置端点。

连接器

连接器是主要的 Remoting 配置元素。JBoss EAP 允许多个连接器。每个连接器都由带有几个子元素及其他一些属性的 <connector> 元素组成。默认的连接器被 JBoss EAP 的几个子系统使用。自定义连接器的元素和属性的专有设置取决于您的应用程序。更多信息请联系红帽全球支持服务。

如需了解如何配置连接器的信息，请参阅配置一个连接器。

出站连接

您可以指定三种不同类型的出站连接：

额外配置

Remoting 还依赖于 remoting 子系统以外的一些元素，如网络接口和 IO worker。

如需了解更多信息，请参阅额外的远程配置。

JBoss EAP 默认提供下列端点配置。

<subsystem xmlns="urn:jboss:domain:remoting:3.0">
  <endpoint/>
  ...
</subsystem>

更新现有的端点配置

/subsystem=remoting/configuration=endpoint:write-attribute(name=authentication-retries,value=2)

重新载入

创建新的端点配置

/subsystem=remoting/configuration=endpoint:add

删除端点配置

/subsystem=remoting/configuration=endpoint:remove

重新载入

如需了解端点配置可用的属性，请参阅端点属性。

连接器是和 Remoting 相关的主要配置元素，它包含几个用于其他配置的子元素。

更新现有的连接器配置

/subsystem=remoting/connector=new-connector:write-attribute(name=socket-binding,value=my-socket-binding)

重新载入

创建新的连接器

/subsystem=remoting/connector=new-connector:add(socket-binding=my-socket-binding)

删除连接器

/subsystem=remoting/connector=new-connector:remove

重新载入

关于配置连接器的可用属性的完整列表，请参考 Remoting 子系统属性章节。

HTTP 连接器提供基于 HTTP Upgrade 的 Remoting 连接器的配置。JBoss EAP 默认提供了下列 http-connector 配置。

<subsystem xmlns="urn:jboss:domain:remoting:3.0">
    ...
    <http-connector name="http-remoting-connector" connector-ref="default" security-realm="ApplicationRealm"/>
</subsystem>

在默认情况下，这个 HTTP connector 会连接到一个名为 default 的 HTTP listener 中（在 undertow 子系统中配置）。如需了解更多相关信息，请参阅配置 Web 服务器（Undertow）。

更新现有的 HTTP 连接器配置

/subsystem=remoting/http-connector=new-connector:write-attribute(name=connector-ref,value=new-connector-ref)

重新载入

创建新的 HTTP 连接器

/subsystem=remoting/http-connector=new-connector:add(connector-ref=default)

删除 HTTP 连接器

/subsystem=remoting/http-connector=new-connector:remove

如需了解配置一个 HTTP connector 的完整属性列表，请参阅连接器属性。

出站连接是一个由 URI 完全指定的通用 remoting 出站连接。

更新现有的出站连接

/subsystem=remoting/outbound-connection=new-outbound-connection:write-attribute(name=uri,value=http://example.com)

创建新的出站连接

/subsystem=remoting/outbound-connection=new-outbound-connection:add(uri=http://example.com)

删除出站连接

/subsystem=remoting/outbound-connection=new-outbound-connection:remove

如需了解配置一个出站连接的完整属性列表，请参阅出站连接属性。

远程出站连接是由协议、出站连接套接字绑定、用户名和安全区指定的。这个协议可以是 remote、http-remoting 或 https-remoting。

/subsystem=remoting/remote-outbound-connection=new-remote-outbound-connection:write-attribute(name=outbound-socket-binding-ref,value=outbound-socket-binding)

/subsystem=remoting/remote-outbound-connection=new-remote-outbound-connection:add(outbound-socket-binding-ref=outbound-socket-binding)

/subsystem=remoting/remote-outbound-connection=new-remote-outbound-connection:remove

如需了解配置一个远程出站连接的完整属性列表，请参阅远程出站连接属性。

本地出站连接是一个由转出套接字绑定指定的使用 local 协议的 Remoting 出站连接。

更新现有的本地出站连接

/subsystem=remoting/local-outbound-connection=new-local-outbound-connection:write-attribute(name=outbound-socket-binding-ref,value=outbound-socket-binding)

创建新的本地出站连接

/subsystem=remoting/local-outbound-connection=new-local-outbound-connection:add(outbound-socket-binding-ref=outbound-socket-binding)

删除本地出站连接

/subsystem=remoting/local-outbound-connection=new-local-outbound-connection:remove

如需了解配置一个本地出站连接的完整属性列表，请参阅本地出站连接属性。

一些远程项需要在 remoting 子系统以外配置。