eventweb.net.conn

Class GenericCpSrvcConn

java.lang.Object

eventweb.servutil.EvwSrvcBase

eventweb.net.conn.AbstractEvwSrvcConn

eventweb.net.conn.GenericCpSrvcConn

All Implemented Interfaces:

TraceableIo, EvwCtrlHandler, HttpSrvcConn, ProviderHost, SrvcConn, eventweb.servutil.RegInit, eventweb.servutil.SelfDescribing, Debuggable

public class GenericCpSrvcConn
extends AbstractEvwSrvcConn
implements HttpSrvcConn, ProviderHost, eventweb.servutil.SelfDescribing

Generic EventWeb context provider service.

This implements an EventWeb service that can support a context provider specified at runtime.

Version:

0.5.1 11/17/16

Author:

Stephen W. Thompson

Field Summary

Fields

Modifier and Type	Field and Description
int	activityTmo Suggested activity timeout for the service
static java.lang.String[]	DEP_LIST Class dependencies
int	maxMsgSize Maximum expected message size (send or receive)
java.util.List<java.lang.Integer>	supportedMedia
java.util.Set<java.lang.String>	tagList
static java.lang.String	VERSION Class version

Fields inherited from class eventweb.net.conn.AbstractEvwSrvcConn

instanceNumber, srvcName, TAG_DISCONNECT, TAG_RQST_CTRL, TAG_RQST_RSRC, TAG_SRVC_INFO, TAG_TIMESTAMP, VALUE_CONNECT

Fields inherited from class eventweb.servutil.EvwSrvcBase

debugging, log, registry, tracingIo

Fields inherited from interface eventweb.net.conn.HttpSrvcConn

IF_VERSION

Fields inherited from interface eventweb.net.conn.ProviderHost

IF_VERSION

Fields inherited from interface eventweb.servutil.SelfDescribing

IF_VERSION

Fields inherited from interface eventweb.net.conn.EvwCtrlHandler

IF_VERSION

Fields inherited from interface eventweb.io.TraceableIo

IF_VERSION

Fields inherited from interface eventweb.servutil.RegInit

IF_VERSION

Fields inherited from interface eventweb.util.Debuggable

IF_VERSION

Constructor Summary

Constructors

Constructor and Description
GenericCpSrvcConn()

Method Summary

Methods

Modifier and Type	Method and Description
boolean	addProv(java.lang.Class<? extends RsrcProv> pClass, TvList pParams) Add a resource provider.
int	getMaxMsgSize() Get the maximum message size expected by the service.
java.util.List<java.lang.Integer>	getSupportedMedia() Get the MIME types supported by the service.
java.util.Set<java.lang.String>	getSupportedTags() Get the tags supported by the service.
java.util.Set<java.lang.String>	getSupportedValues(java.lang.String tag) Get the values that are valid for a tag.
protected void	handleDisconnect(TvOutput client)
void	init(eventweb.servutil.SrvcRegistry registry, TvList params) Initialize the service.
protected void	newClient(SrvrChan chan, TvList rqst)
int	performSrvc(SrvcInfo sInfo, java.io.OutputStream outStrm) Perform the requested service.
int	prepareSrvc(SrvcInfo sInfo) Validate request and prepare service to run.
void	quiesce() Stop accepting new requests and release resources
protected void	setRsrcSet(eventweb.servutil.SelfDescribing srvcProv)
int	suggestActivityTimeout() Suggest an activity timeout for the service.

Methods inherited from class eventweb.net.conn.AbstractEvwSrvcConn

createChannel, processCtrlRqst, startChannel

Methods inherited from class eventweb.servutil.EvwSrvcBase

isDebugging, isTracingIo, setDebugging, setTracingIo

Methods inherited from class java.lang.Object

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

Methods inherited from interface eventweb.io.TraceableIo

isTracingIo, setTracingIo

Field Detail

VERSION

public static final java.lang.String VERSION

Class version

DEP_LIST

public static final java.lang.String[] DEP_LIST

Class dependencies

tagList

public java.util.Set<java.lang.String> tagList

supportedMedia

public java.util.List<java.lang.Integer> supportedMedia

maxMsgSize

public int maxMsgSize

Maximum expected message size (send or receive)

activityTmo

public int activityTmo

Suggested activity timeout for the service

Constructor Detail

GenericCpSrvcConn

public GenericCpSrvcConn()

Method Detail

init

public void init(eventweb.servutil.SrvcRegistry registry,
        TvList params)

Initialize the service.

Specified by:

init in interface eventweb.servutil.RegInit

Overrides:

init in class eventweb.servutil.EvwSrvcBase

Parameters:

registry - The service registry

params - Initialization parameters

addProv

public boolean addProv(java.lang.Class<? extends RsrcProv> pClass,
              TvList pParams)

Add a resource provider.

Specified by:

addProv in interface ProviderHost

Parameters:

pClass - The class of the provider to add

pParams - Parameters for provider init method

Returns:

true, If the provider was added successfully

getSupportedTags

public java.util.Set<java.lang.String> getSupportedTags()

Get the tags supported by the service.

Specified by:

getSupportedTags in interface eventweb.servutil.SelfDescribing

Returns:

Set of Strings. Each String contains one tag.

getSupportedValues

public java.util.Set<java.lang.String> getSupportedValues(java.lang.String tag)

Get the values that are valid for a tag.
A * indicates any value is valid.

Specified by:

getSupportedValues in interface eventweb.servutil.SelfDescribing

Parameters:

tag - The tag to get values for.

Returns:

List of Strings. Each String contains one value.

getSupportedMedia

public java.util.List<java.lang.Integer> getSupportedMedia()

Get the MIME types supported by the service.
The list is ordered in order of preference, with more preferred types first.

Specified by:

getSupportedMedia in interface eventweb.servutil.SelfDescribing

Returns:

List of Integers. Each Integer contains the ID for one MIME type.

See Also:

MimeType

getMaxMsgSize

public int getMaxMsgSize()

Get the maximum message size expected by the service.

Specified by:

getMaxMsgSize in interface eventweb.servutil.SelfDescribing

Returns:

Maximum message size (in bytes)

suggestActivityTimeout

public int suggestActivityTimeout()

Suggest an activity timeout for the service.
This method provides what the service thinks is a reasonable activity timeout. The server is not required to use this value.

Specified by:

suggestActivityTimeout in interface eventweb.servutil.SelfDescribing

Returns:

Activity timeout in milliseconds

prepareSrvc

public int prepareSrvc(SrvcInfo sInfo)

Validate request and prepare service to run.

Specified by:

prepareSrvc in interface HttpSrvcConn

Parameters:

sInfo - Service request information

Returns:

HTTP status code

performSrvc

public int performSrvc(SrvcInfo sInfo,
              java.io.OutputStream outStrm)

Perform the requested service.

Specified by:

performSrvc in interface HttpSrvcConn

Parameters:

sInfo - Service request information

outStrm - OutputStream to client

Returns:

HTTP status code

quiesce

public void quiesce()

Stop accepting new requests and release resources

Specified by:

quiesce in interface HttpSrvcConn

Specified by:

quiesce in class AbstractEvwSrvcConn

newClient

protected void newClient(SrvrChan chan,
             TvList rqst)

handleDisconnect

protected void handleDisconnect(TvOutput client)

setRsrcSet

protected void setRsrcSet(eventweb.servutil.SelfDescribing srvcProv)