Name 

Description 

Classes 

The following table lists classes in this documentation. 

Interfaces 

The following table lists interfaces in this documentation. 

 

Name 

Description 

 

AccessException 

Thrown by the Notify* methods in IMetadataProvider if the supplied User is not recognized or a functionality is not implemented for this User.  

 

ConflictingSessionException 

Thrown by the NotifyNewSession method of IMetadataProvider if a User is not enabled to open a new Session but he would be enabled as soon as another Session were closed. By using this exception, the ID of the other Session is also supplied.
After receiving this exception, the Server may try to close the specified session and invoke NotifyNewSession again.
 

 

CreditsException 

Thrown by the Notify* methods in IMetadataProvider if some functionality cannot be allowed to the supplied User. This may occur if the user is not granted some resource or if the user would exceed the granted amount. Different kinds of problems can be distinguished by an error code. Both the error message detail and the error code will be forwarded by Lightstreamer Kernel to the Client.  

 

ItemsException 

Thrown by the GetItems and GetSchema methods in IMetadataProvider if the supplied Group name is not recognized or cannot be resolved.  

 

MetadataException 

Base class for all exceptions directly thrown by the Metadata Adapter.  

 

MetadataProviderAdapter 

Provides a default implementation of all the functionality of a Metadata Adapter which allow a simple default behavior. Overriding this class may facilitate the coding of simple Adapters.  

 

MetadataProviderException 

Thrown by the Init method in IMetadataProvider if there is some problem that prevents the correct behavior of the Metadata Adapter. If this exception occurs, Lightstreamer Kernel must give up the startup.  

 

Mode 

Encapsulates a publishing Mode. The different Modes handled by Lightstreamer Kernel can be uniquely identified by the static constants defined in this class. See the technical documents for a detailed description of Modes.  

 

NotificationException 

Thrown by the Notify* methods in IMetadataProvider if there is some inconsistency in the supplied parameters. Lightstreamer Kernel ensures that such conditions will never occur, but they may be checked for debugging or documentation reasons.  

 

SchemaException 

Thrown by the GetSchema method in IMetadataProvider if the supplied Schema name is not recognized or cannot be resolved.  

 

TableInfo 

Used to provide value objects to the calls to methods NotifyNewTables and NotifyTablesClose of IMetadataProvider. The attributes of every Table (i.e. Subscription) to be added or removed to a Session has to be written to a TableInfo instance.  

 

Name 

Description 

 

IMetadataProvider 

Provides an interface to be implemented by a Remote Metadata Adapter in order to attach a Metadata Provider to Lightstreamer. The configuration of a Remote Adapter instance requires the following info:
- an optional name for the instance;
- the Remote Adapter class name;
- optional configuration parameters.
A single instance of each configured Remote Adapter is created by Lightstreamer at startup, through a Remote Server instance. For this purpose, any Remote Metadata Adapter must provide a void constructor. After creation, the init method is called, providing the Remote Metadata Adapter with the configuration information.
A Metadata Provider is used... more