setServerAddress method

Future<void> setServerAddress(
  1. String? newVal
)

Setter method that sets the address of Lightstreamer Server.

Note that the addresses specified must always have the http: or https: scheme. In case WebSockets are used, the specified scheme is internally converted to match the related WebSocket protocol (i.e. http becomes ws while https becomes wss).

General Edition Note WSS/HTTPS 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 if no server address is supplied the client will be unable to connect.

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. This setting can also be specified in the LightstreamerClient constructor.

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

  • newVal The full address of Lightstreamer Server. A null value can also be used, to restore the default value. An IPv4 or IPv6 can also be used in place of a hostname. Some examples of valid values include:

  • http://push.mycompany.com

  • http://push.mycompany.com:8080

  • http://79.125.7.252

  • http://[2001:0db8:85a3:0000:0000:8a2e:0370:7334]

  • http://[2001:0db8:85a3::8a2e:0370:7334]:8080

Throws IllegalArgumentException if the given address is not valid.

Implementation

Future<void> setServerAddress(String? newVal) async {
  _serverAddress = newVal;
   var arguments = <String, dynamic> {
    'newVal': newVal
  };
  return await _invokeMethod('setServerAddress', arguments);
}