Package com.lightstreamer.adapters.remote

Class DataProviderServer

java.lang.Object
com.lightstreamer.adapters.remote.Server
com.lightstreamer.adapters.remote.DataProviderServer
public class DataProviderServer extends Server
A Remote Server object which can run a Remote Data Adapter and connect it to a Proxy Data Adapter running on Lightstreamer Server.
The object should be provided with a DataProvider instance and with suitable local initialization parameters and established connections, then activated through Server.start() and finally disposed through Server.close(). If any preliminary initialization on the supplied DataProvider implementation object has to be performed, it should be done through a custom, dedicated method before invoking Server.start(). Further reuse of the same instance is not supported.
By default, the invocations to the Data Adapter methods will be done in an unlimited thread pool. A thread pool maximum size can be specified through the custom "lightstreamer.data.pool.size" system property; a size of 0 or negative also implies an unlimited thread pool.
Note that Subscribe and Unsubscribe invocations for the same item are always guaranteed to be sequentialized in the right way, although they may not occur in the same thread.

  • Constructor Details

    • DataProviderServer

      public DataProviderServer()
      Creates an empty server still to be configured and started. The init method of the Remote Adapter will be invoked only upon a Proxy Adapter request.
      Throws:
      IllegalArgumentException - in case something wrong is supplied in system properties related with Data Adapter processing.

  • Method Details

    • setAdapter

      public final void setAdapter(@Nonnull DataProvider adapter)
      Sets the Remote Data Adapter instance to be run.
      Parameters:
      adapter - the Remote Data Adapter instance to be run.

    • getAdapter

      @Nonnull public final DataProvider getAdapter()
      Gets the configured Data Adapter that is running or will run.
      Returns:
      the configured Data Adapter

    • setAdapterParams

      public final void setAdapterParams(@Nonnull Map<String,String> params)
      Sets a Map object to be passed to the init method of the Remote Data Adapter, to supply optional parameters.
      The default value is an empty HashMap.
      Parameters:
      params - the Map to be passed to the init method of the Remote Data Adapter
      See Also:

    • getAdapterParams

      @Nonnull public final Map<String,String> getAdapterParams()
      Gets the Map object to be passed to the init method of the Remote Data Adapter, to supply optional parameters.
      The default value is an empty HashMap.
      Returns:
      the Map object to be passed to the init method of the Remote Data Adapter
      See Also:

    • setAdapterConfig

      public final void setAdapterConfig(@Nullable String configFile)
      Sets the pathname of an optional configuration file for the Remote Data Adapter, to be passed to the init method.
      The default value is null.
      Parameters:
      configFile - the pathname of an optional configuration file for the Remote Data Adapter.
      See Also:

    • getAdapterConfig

      @Nullable public final String getAdapterConfig()
      Gets the pathname of an optional configuration file for the Remote Data Adapter, to be passed to the init method.
      The default value is null.
      Returns:
      the pathname of an optional configuration file for the Remote Data Adapter
      See Also: