setServerInstanceAddressIgnored method

void setServerInstanceAddressIgnored(
  1. bool newVal
)

Setter method that can be used to disable/enable the automatic handling of server instance address that may be returned by the Lightstreamer server during session creation.

In fact, when a Server cluster is in place, the Server address specified through ConnectionDetails.setServerAddress can identify various Server instances; in order to ensure that all requests related to a session are issued to the same Server instance, the Server can answer to the session opening request by providing an address which uniquely identifies its own instance.
Setting this value to true permits to ignore that address and to always connect through the address supplied in setServerAddress. This may be needed in a test environment, if the Server address specified is actually a local address to a specific Server instance in the cluster.

General Edition Note Server Clustering is an optional feature, available depending on Edition and License Type. To know what features are enabled by your license, please see the License tab of the Monitoring Dashboard (by default, available at /dashboard).

Default false.

Lifecycle This method can be called at any time. If called while connected, it will be applied when the next session creation request is issued.

Notification A change to this setting will be notified through a call to ClientListener.onPropertyChange with argument "serverInstanceAddressIgnored" on any ClientListener listening to the related LightstreamerClient.

  • newVal true or false, to ignore or not the server instance address sent by the server.

  • See ConnectionDetails.setServerAddress

Implementation

external void setServerInstanceAddressIgnored(bool newVal);