JBoss Community Archive (Read Only)

Latest WildFly Documentation

<endpoint /> - Remoting Client

You can use the endpoint element, which is in the urn:jboss-remoting:5.0 namespace, to configure a JBoss Remoting client endpoint using the wildfly-config.xml file. This section describes how to configure a JBoss Remoting client using this element.

<?xml version="1.0" encoding="UTF-8"?>

<configuration>
...
    <endpoint xmlns="urn:jboss-remoting:5.0">
       ...
    </endpoint>
...
</configuration>

This section describes the child elements and attributes that can be configured within this element.

The <endpoint /> element contains the following optional attribute:

Attribute Name

Attribute Description

name

The endpoint name. If not given, an endpoint name will be derived from the system's host name, if possible.

The <endpoint /> element can optionally contain the following two child elements, as described in the next sections:

The configured endpoint will use the default XNIO configuration.

<providers />

This optional element specifies transport providers for the remote endpoint. It can contain any number of <provider /> sub-elements.

<provider />

This element defines a remote transport provider provider. It has the following attributes.

Attribute Name

Attribute Description

scheme

The primary URI scheme which corresponds to this provider. This attribute is required.

aliases

A space-separated list of other URI scheme names that are also recognized for this provider . This attribute is optional.

module

The name of the module that contains the provider implementation. This attribute is optional; if not given, the class loader of JBoss Remoting itself will be searched for the provider class.

class

The name of the class that implements the transport provider. This attribute is optional; if not given, the Java java.util.ServiceLoader facility will be used to search for the provider class.

This element has no content.

<connections />

This optional element specifies connections for the remote endpoint. It can contain any number of connection elements.

<connection />

This element defines a connection for the remote endpoint. It has the following attributes.

Attribute Name

Attribute Description

destination

The destination URI for the connection. This attribute is required.

read-timeout

The timeout, in milliseconds, for read operations on the corresponding socket. This attribute is optional, however it should only be given if a heartbeat-interval is defined.

write-timeout

The timeout, in milliseconds, for a write operation. This attribute is optional, however it should only be given if a heartbeat-interval is defined..

ip-traffic-class

Defines the numeric IP traffic class to use for this connection's traffic. This attribute is optional.

tcp-keepalive

Boolean setting that determines whether to use TCP keepalive. This attribute is optional.

heartbeat-interval

The interval, in milliseconds, to use when checking for a connection heartbeat. This attribute is optional.

Example Remoting Client Configuration in the wildfly-config.xml File

<configuration>
...
    <endpoint xmlns="urn:jboss-remoting:5.0">
        <connections>
            <connection destination="remote+http://10.20.30.40:8080" read-timeout="50" write-timeout="50" heartbeat-interval="10000"/>
        </connections>
    </endpoint>
...
</configuration>
JBoss.org Content Archive (Read Only), exported from JBoss Community Documentation Editor at 2020-03-13 13:37:09 UTC, last content change 2019-05-09 13:00:03 UTC.