Package jmri.server.json.util

Class JsonUtilServiceFactory

java.lang.Object

jmri.server.json.util.JsonUtilServiceFactory

All Implemented Interfaces:

JmriServiceProviderInterface, JsonServiceFactory<JsonUtilHttpService,JsonUtilSocketService>

public class JsonUtilServiceFactory
extends java.lang.Object
implements JsonServiceFactory<JsonUtilHttpService,JsonUtilSocketService>

Constructor Summary

Constructors

Constructor	Description
JsonUtilServiceFactory()

Method Summary

Modifier and Type	Method	Description
JsonUtilHttpService	getHttpService(com.fasterxml.jackson.databind.ObjectMapper mapper, java.lang.String version)	Create a JSON HTTP service.
java.lang.String[]	getReceivedTypes(java.lang.String version)	Get the message type(s) services created by this factory receive, if not also listed in JsonServiceFactory.getTypes(String).
java.lang.String[]	getSentTypes(java.lang.String version)	Get the message type(s) services created by this factory send, if not also listed in JsonServiceFactory.getTypes(String).
JsonUtilSocketService	getSocketService(JsonConnection connection, java.lang.String version)	Create a JSON service for the given connection.
java.lang.String[]	getTypes(java.lang.String version)	Get the service type(s) for services created by this factory respond to.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

JsonUtilServiceFactory

public JsonUtilServiceFactory()

Method Detail

getTypes

public java.lang.String[] getTypes(java.lang.String version)

Description copied from interface: JsonServiceFactory

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.

Specified by:

getTypes in interface JsonServiceFactory<JsonUtilHttpService,JsonUtilSocketService>

Parameters:

version - The JSON protocol version major component identifier

Returns:

An array of types this service responds to

getSentTypes

public java.lang.String[] getSentTypes(java.lang.String version)

Description copied from interface: JsonServiceFactory

Get the message type(s) services created by this factory send, if not also listed in JsonServiceFactory.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.

Specified by:

getSentTypes in interface JsonServiceFactory<JsonUtilHttpService,JsonUtilSocketService>

Parameters:

version - The JSON protocol version major component identifier

Returns:

An array of types this service sends, but does not respond to

getReceivedTypes

public java.lang.String[] getReceivedTypes(java.lang.String version)

Description copied from interface: JsonServiceFactory

Get the message type(s) services created by this factory receive, if not also listed in JsonServiceFactory.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.

Specified by:

getReceivedTypes in interface JsonServiceFactory<JsonUtilHttpService,JsonUtilSocketService>

Parameters:

version - The JSON protocol version major component identifier

Returns:

An array of types this service sends, but does not respond to

getSocketService

public JsonUtilSocketService getSocketService(JsonConnection connection,
                                              java.lang.String version)

Description copied from interface: JsonServiceFactory

Create a JSON service for the given connection. This connection can be a WebSocket or raw socket.

Specified by:

getSocketService in interface JsonServiceFactory<JsonUtilHttpService,JsonUtilSocketService>

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

public JsonUtilHttpService getHttpService(com.fasterxml.jackson.databind.ObjectMapper mapper,
                                          java.lang.String version)

Description copied from interface: JsonServiceFactory

Create a JSON HTTP service.

Specified by:

getHttpService in interface JsonServiceFactory<JsonUtilHttpService,JsonUtilSocketService>

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