com.SecurePlay.Comms
Class SPAbstractCommsClass

java.lang.Object
  com.SecurePlay.Comms.SPAbstractCommsClass

All Implemented Interfaces:

SPAbstractCommsInterface

Direct Known Subclasses:

SPCLocalCommsClass, SPCLocalCommsFileClass

public class SPAbstractCommsClass

extends java.lang.Object

implements SPAbstractCommsInterface

This is the SuperClass for comms services classes.

Author:

IT GlobaLSecure

See Also:

SecurePlay License Information

Field Summary

java.lang.String

commstype Type of Comms Service

Constructor Summary

SPAbstractCommsClass()
Default Construtor

Method Summary

boolean	addGame(java.lang.String gid, SPCommsManagerCommsInterface gamcomobj) This method adds an internal game to a specific comms service.
boolean	addPlayer(java.lang.String pid, java.lang.String gid) This method adds a player ID of a remote player serviced by this comm service.
boolean	APIactivate() OPTIONAL - This is a shell method to trigger the activation of a comms service, if necessary.
boolean	APIconfigureCommService() This method configures a comm service instance.
boolean	APIdeactivate() OPTIONAL - This shell method is used to deactivate a comms service once it is no longer needed.
java.lang.String	getCommsID() Getter function that returns the property: commsID
java.lang.String	getCommsServiceType() This method returns a unique identifier for the type of comms service instance.
SPMap	getGameplayerList() Getter function that returns the property: gameplayerList
java.lang.String[]	getInternalGameIDList() Getter function that returns the property: internalGameIDList
SPMap	getPrinternalGameList() Getter function that returns the property: printernalGameList
boolean	isGameInternal(java.lang.String gid) This method returns whether a game is handled internally by a comms service
void	logError() This is a shell for future error log.
void	processincoming(SPMessageClass inmess) This method processes the incoming message.
protected boolean	prreceive(java.lang.String message) This standard method handles incoming serialized messages that have been separated out of incoming data streams by the incoming method.
protected boolean	prsend(java.lang.String message) This is a shell method for the actual transmission of a serialized message over a network using a specific communications transport.
boolean	removeGame(java.lang.String gid) This method removes the association of a game with the comms service.
boolean	removePlayer(java.lang.String pid, java.lang.String gid) This method removes a player from the list of remote players served by this comm service.
int	sendMessage(SPMessageClass clearmessage, SPMessageClass alternatemessage) This method returns a number based on the input array to indicate how many of the input array's player IDs are included in the comms service playerIDList (This method takes the message and sends it over the network, if they are served by this comms service.)
int	sendMessage(java.lang.String[] receivers, SPMessageClass clearmessage, SPMessageClass alternatemessage) This method returns a number based on the input array to indicate how many of the input array's player IDs are included in the comms service playerIDList This method is depreceated and will be removed in a future version of the software (This method takes the message and sends it over the network, if they are served by this comms service.)
boolean	setcommsID(java.lang.String cid) This method sets the internal ID for a comms service if it has not been set.
protected SPMessageClass[]	SPdeserialize(java.lang.String message) This method takes a serialized messagestring and turns it into an instance of the SPMessageClass
protected java.lang.String	SPserialize(SPMessageClass message) This method takes an instance of the SPMessageClass and serializes it into a string.

Methods inherited from class java.lang.Object

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

Field Detail

commstype

public final java.lang.String commstype

Type of Comms Service

See Also:

Constant Field Values

Constructor Detail

SPAbstractCommsClass

public SPAbstractCommsClass()

Default Construtor

Method Detail

setcommsID

public boolean setcommsID(java.lang.String cid)

Description copied from interface: SPAbstractCommsInterface

This method sets the internal ID for a comms service if it has not been set. NOTE, this ID is not the public, network, or other ID for the communications service, but simply an internal handler.

Specified by:

setcommsID in interface SPAbstractCommsInterface

Parameters:

cid - String - comms id

Returns:

boolean: TRUE, if succesful, FALSE, if not

getCommsServiceType

public java.lang.String getCommsServiceType()

This method returns a unique identifier for the type of comms service instance.

Specified by:

getCommsServiceType in interface SPAbstractCommsInterface

Returns:

"abstract" - String - unique identifier for type of comms service

addGame

public boolean addGame(java.lang.String gid,
                       SPCommsManagerCommsInterface gamcomobj)

Description copied from interface: SPAbstractCommsInterface

This method adds an internal game to a specific comms service. The connection is to the SPComms class associated with the game to allow incoming messages to be serviced.

Specified by:

addGame in interface SPAbstractCommsInterface

Parameters:

gid - String - game id

gamcomobj - SPCommsManagerCommsInterface - the comms object to be added to a game

Returns:

boolean - TRUE, if successful, FALSE, if not

removeGame

public boolean removeGame(java.lang.String gid)

Description copied from interface: SPAbstractCommsInterface

This method removes the association of a game with the comms service. NOTE: actually the association that is removed is with the game instance's SPComms class instance.

Specified by:

removeGame in interface SPAbstractCommsInterface

Parameters:

gid - String - game id

Returns:

boolean - TRUE, if successful, FALSE, if not

APIconfigureCommService

public boolean APIconfigureCommService()

This method configures a comm service instance. The parameters are variable depending on the specific service. (this is a shell method It returns true if successful, false, if not.)

Returns:

true - Boolean: TRUE, if successful, FALSE, if not

addPlayer

public boolean addPlayer(java.lang.String pid,
                         java.lang.String gid)

Description copied from interface: SPAbstractCommsInterface

This method adds a player ID of a remote player serviced by this comm service.

Specified by:

addPlayer in interface SPAbstractCommsInterface

Parameters:

pid - String - player id to be added

gid - String - game id for the player to be added

Returns:

boolean - TRUE, if successful, FALSE, if not

removePlayer

public boolean removePlayer(java.lang.String pid,
                            java.lang.String gid)

Description copied from interface: SPAbstractCommsInterface

This method removes a player from the list of remote players served by this comm service.

Specified by:

removePlayer in interface SPAbstractCommsInterface

Parameters:

pid - String - player id to ber removed.

gid - String - game id from which the player is to be removed.

Returns:

result - Boolean: TRUE, if successful, FALSE, if not

prsend

protected boolean prsend(java.lang.String message)

This is a shell method for the actual transmission of a serialized message over a network using a specific communications transport.

Parameters:

message - String - the message to be sent

Returns:

true - Boolean: TRUE, if successful, FALSE, if not.

prreceive

protected boolean prreceive(java.lang.String message)

This standard method handles incoming serialized messages that have been separated out of incoming data streams by the incoming method. It parses them into Message Objects and passes them on to the Game Instance.

Parameters:

message - String - the incoming message

Returns:

result - Boolean: TRUE, if successfully handled, FALSE, if not.

sendMessage

public int sendMessage(SPMessageClass clearmessage,
                       SPMessageClass alternatemessage)

Description copied from interface: SPAbstractCommsInterface

This method returns a number based on the input array to indicate how many of the input array's player IDs are included in the comms service playerIDList (This method takes the message and sends it over the network, if they are served by this comms service.)

Specified by:

sendMessage in interface SPAbstractCommsInterface

Parameters:

clearmessage - SPMessageClass - message for receivers

alternatemessage - SPMessageClass - message or other game players

Returns:

integer - int - Number of remote players that were handled by this comm service for the message (or the number of players supported by the Comms Service in the input playerID array.)

sendMessage

public int sendMessage(java.lang.String[] receivers,
                       SPMessageClass clearmessage,
                       SPMessageClass alternatemessage)

Description copied from interface: SPAbstractCommsInterface

This method returns a number based on the input array to indicate how many of the input array's player IDs are included in the comms service playerIDList This method is depreceated and will be removed in a future version of the software (This method takes the message and sends it over the network, if they are served by this comms service.)

Specified by:

sendMessage in interface SPAbstractCommsInterface

Parameters:

receivers - String[] - array of playerIDs

clearmessage - SPMessageClass - message for receivers

alternatemessage - SPMessageClass - message or other game players

Returns:

integer - int - Number of remote players that were handled by this comm service for the message (or the number of players supported by the Comms Service in the input playerID array.)

APIactivate

public boolean APIactivate()

OPTIONAL - This is a shell method to trigger the activation of a comms service, if necessary.

Returns:

true - Boolean: TRUE, if successful, FALSE, if not.

APIdeactivate

public boolean APIdeactivate()

OPTIONAL - This shell method is used to deactivate a comms service once it is no longer needed. Depending on the comms service, this method may not be necessary

Returns:

true - Boolean: TRUE, if successful, FALSE, if not.

logError

public void logError()

This is a shell for future error log.

getCommsID

public java.lang.String getCommsID()

Getter function that returns the property: commsID

Specified by:

getCommsID in interface SPAbstractCommsInterface

Returns:

commsid - String - the comms id.

SPserialize

protected java.lang.String SPserialize(SPMessageClass message)

This method takes an instance of the SPMessageClass and serializes it into a string.

Parameters:

message - SPMessageClass - a message to be seriealized into a string

Returns:

mstring - String - the serialized string of the message

SPdeserialize

protected SPMessageClass[] SPdeserialize(java.lang.String message)

This method takes a serialized messagestring and turns it into an instance of the SPMessageClass

Parameters:

message - String - serialized message object

Returns:

messobj - SPMessageClass - an instance of SPMessageClass

getGameplayerList

public SPMap getGameplayerList()

Getter function that returns the property: gameplayerList

Specified by:

getGameplayerList in interface SPAbstractCommsInterface

Returns:

gameplayerList - SPMap

getInternalGameIDList

public java.lang.String[] getInternalGameIDList()

Getter function that returns the property: internalGameIDList

Specified by:

getInternalGameIDList in interface SPAbstractCommsInterface

Returns:

internalGameIDList - String[]

getPrinternalGameList

public SPMap getPrinternalGameList()

Getter function that returns the property: printernalGameList

Specified by:

getPrinternalGameList in interface SPAbstractCommsInterface

Returns:

printernalGameList - SPMap

isGameInternal

public boolean isGameInternal(java.lang.String gid)

Description copied from interface: SPAbstractCommsInterface

This method returns whether a game is handled internally by a comms service

Specified by:

isGameInternal in interface SPAbstractCommsInterface

Parameters:

gid - - String

Returns:

boolean - True if game is internal and supported by Comms Service

processincoming

public void processincoming(SPMessageClass inmess)

This method processes the incoming message.

Parameters:

inmess - SPMessageClass - the incoming message void