Package jmri.spi

Interface JsonServiceFactory<H extends JsonHttpService,S extends JsonSocketService<H>>

Type Parameters:
H - the specific supported HTTP service
S - the specific supported (Web)Socket service
All Superinterfaces:
JmriServiceProviderInterface
All Known Implementing Classes:
JsonAudioIconServiceFactory, JsonAudioServiceFactory, JsonBlockServiceFactory, JsonConsistServiceFactory, JsonIdTagServiceFactory, JsonLayoutBlockServiceFactory, JsonLightServiceFactory, JsonLogixNGIconServiceFactory, JsonMemoryServiceFactory, JsonMessageServiceFactory, JsonOblockServiceFactory, JsonOperationsServiceFactory, JsonPowerServiceFactory, JsonReporterServiceFactory, JsonRosterServiceFactory, JsonRouteServiceFactory, JsonSchemaServiceFactory, JsonSensorServiceFactory, JsonSignalHeadServiceFactory, JsonSignalMastServiceFactory, JsonThrottleServiceFactory, JsonTimeServiceFactory, JsonTurnoutServiceFactory, JsonUtilServiceFactory
public interface JsonServiceFactory<H extends JsonHttpService,S extends JsonSocketService<H>> extends JmriServiceProviderInterface
Factory interface for JSON services.

A JSON service is a service provided by the JsonServer. This API allows JSON services to be defined in a modular manner. The factory pattern is used since each connection gets a unique instance of each service.

  • Method Details

    • getTypes

      @Nonnull String[] getTypes(@Nonnull String version)
      Get the service type(s) for services created by this factory respond to. These type must have valid schemas for messages received from a client and sent to a client.

      Types should be single words, in camelCase if needed, unless supporting a plural noun introduced in the JSON 1.x or 2.x protocols and exposed in the JSON 3.0 or newer protocol.

      If a service returns no types, it will never be used.

      Parameters:
      version - The JSON protocol version major component identifier
      Returns:
      An array of types this service responds to

    • getSentTypes

      @Nonnull default String[] getSentTypes(@Nonnull String version)
      Get the message type(s) services created by this factory send, if not also listed in getTypes(String). These types must only have schemas for messages sent to a client.

      Types should be single words, in camelCase if needed, unless supporting a plural noun introduced in the JSON 1.x or 2.x protocols and exposed in the JSON 3.0 or newer protocol.

      Parameters:
      version - The JSON protocol version major component identifier
      Returns:
      An array of types this service sends, but does not respond to

    • getReceivedTypes

      @Nonnull default String[] getReceivedTypes(@Nonnull String version)
      Get the message type(s) services created by this factory receive, if not also listed in getTypes(String). These types must only have schemas for messages received from a client.

      Types should be single words, in camelCase if needed, unless supporting a plural noun introduced in the JSON 1.x or 2.x protocols and exposed in the JSON 3.0 or newer protocol.

      Parameters:
      version - The JSON protocol version major component identifier
      Returns:
      An array of types this service sends, but does not respond to

    • getSocketService

      @Nonnull S getSocketService(@Nonnull JsonConnection connection, @Nonnull String version)
      Create a JSON service for the given connection. This connection can be a WebSocket or raw socket.
      Parameters:
      connection - The connection for this service to respond to
      version - The JSON protocol version major component identifier
      Returns:
      A service or null if the service does not support sockets

    • getHttpService

      @Nonnull H getHttpService(@Nonnull com.fasterxml.jackson.databind.ObjectMapper mapper, @Nonnull String version)
      Create a JSON HTTP service.
      Parameters:
      mapper - The object mapper for the HTTP service to use
      version - The JSON protocol version major component identifier
      Returns:
      A servlet or null if the service does not support HTTP