Options
All
  • Public
  • Public/Protected
  • All
Menu

Interface RemoteServerBuilder

A remote server builder.

A builder of this type may be created using newRemoteServerBuilder and used to create instances of RemoteServer that can be supplied to createRemoteServer(RemoteServer).

since

6.7

deprecated

since 6.9

This builder is retained for backwards compatibility only. It can only be used to create a secondary initiator. SecondaryInitiatorBuilder should be used in preference. This builder will be removed in a future release.

Hierarchy

  • RemoteServerBuilder

Index

Methods

connectionOption

  • Specifies a single connection option.

    This will add to the options currently specified to the builder, or replace a value if it has already been specified.

    throws

    a NullValueError if the connectionOption is null

    Parameters

    • connectionOption: ConnectionOption

      the connection option

    • Optional value: string | null

      the connection option value. If argument is omitted or null the option is removed

    Returns RemoteServerBuilder

    this builder

connectionOptions

  • Specifies a map of ConnectionOption settings.

    This will replace any options currently set for the builder.

    Any options not supplied will take their default values.

    If no connection options are specified, either using this method or connectionOption then all options will take their default value.

    throws

    a NullValueError if the connectionOptions are null

    Parameters

    Returns RemoteServerBuilder

    this builder

create

  • Creates a remote server object using the current values known to this builder.

    throws

    an IllegalArgumentError if the name or URL is empty

    throws

    a NullValueError if the name or URL is null

    Parameters

    • name: string

      the name of the remote server

    • url: string

      the URL to use to connect to the primary server

    Returns RemoteServerDefinition

    a new remote server instance

credentials

  • Specifies the credentials to use when connecting to the primary server.

    The default, if not specified, is undefined.

    Parameters

    Returns RemoteServerBuilder

    this builder

missingTopicNotificationFilter

  • Specifies a topic selector expression which will filter missing topic notifications propagated from secondary to primary server.

    MissingTopicNotifications are notified when a client subscribes using a topic selector that matches no existing topics. By specifying a missing topic notification filter all notifications that match the filter on the secondary server will be propagated to the primary server.

    A match occurs if the path prefix of the subscription selector matches the path prefix of the specified selector. If the selector is a selector set then the notification will be propagated if it matches any selector in the set.

    If no filter is specified then no missing topic notifications will be propagated.

    The special selector expression "." may be used to indicate that all missing topic notifications should be propagated.

    Only the path prefix of the specified selector(s) is considered when matching therefore any use of regular expressions would be ignored.

    throws

    an IllegalArgumentError if the filter is not a valid topic selector

    Parameters

    • filter: string | null

      a topic selector expression specifying the filter to apply or null to remove any existing filter

    Returns RemoteServerBuilder

    this builder

principal

  • Specifies the name of a principal used by the remote server to connect to the primary server.

    The default, if not specified, is the anonymous principal.

    throws

    a NullValueError if the principal is null

    Parameters

    • principal: string

      principal name or a zero length string to indicate an anonymous connection

    Returns RemoteServerBuilder

    this builder

reset

  • Reset the builder.

    Returns RemoteServerBuilder

    this Builder