xyz.thepathfinder.android

Class Connection

java.lang.Object

javax.websocket.Endpoint

xyz.thepathfinder.android.Connection

 class Connection
extends Endpoint

Controls access the web socket connection with the Pathfinder sever. To gain access to the connection use PathfinderServices.getConnection().

Field Summary

Fields

Modifier and Type	Field and Description
private static org.slf4j.Logger	logger Logs actions performed by the class.
private MessageHandler	messageHandler Handles incoming web socket messages.
private Queue<String>	messageQueue Stores messages while the connection is down.
private long	sentMessageCount Number of messages sent through the web socket.
private PathfinderServices	services Access to the model registry to notify Models of incoming web socket messages.
private Session	session The web socket session used to send messages through the web socket.
private String	userCredentials The user's credentials to the Pathfinder server.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Connection(String userCredentials) Constructs a connection object that controls access to the web socket connection with the Pathfinder Server.

Method Summary

Methods

Modifier and Type	Method and Description
void	close(CloseReason reason) Closes the web socket connection with the Pathfinder server.
long	getReceivedMessageCount() Returns the number of messages receive through the web socket.
long	getSentMessageCount() Returns the number of messages sent through the web socket.
boolean	isConnected() Returns if the web socket is connected.
void	onClose(Session session, CloseReason closeReason)
void	onOpen(Session session, EndpointConfig config)
private void	send(String message) Sends a message through the web socket connection to the Pathfinder server.
void	sendMessage(String message) Sends a text message through the web socket to the Pathfinder server if connected.
protected void	setServices(PathfinderServices services) Sets the pathfinder services object.

Methods inherited from class javax.websocket.Endpoint

onError

Methods inherited from class java.lang.Object

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

Field Detail

logger

private static final org.slf4j.Logger logger

Logs actions performed by the class.

userCredentials

private final String userCredentials

The user's credentials to the Pathfinder server.

services

private PathfinderServices services

Access to the model registry to notify Models of incoming web socket messages.

session

private Session session

The web socket session used to send messages through the web socket.

sentMessageCount

private long sentMessageCount

Number of messages sent through the web socket.

messageHandler

private MessageHandler messageHandler

Handles incoming web socket messages.

messageQueue

private Queue<String> messageQueue

Stores messages while the connection is down.

Constructor Detail

Connection

protected Connection(String userCredentials)

Constructs a connection object that controls access to the web socket connection with the Pathfinder Server.

Parameters:

userCredentials - the user's credentials for this application

Method Detail

setServices

protected void setServices(PathfinderServices services)

Sets the pathfinder services object.

Parameters:

services - a pathfinder services object

send

private void send(String message)

Sends a message through the web socket connection to the Pathfinder server.

Parameters:

message - to be send.

sendMessage

public void sendMessage(String message)

Sends a text message through the web socket to the Pathfinder server if connected. It will save the message in a queue if not connected.

Parameters:

message - to be sent.

onOpen

public void onOpen(Session session,
          EndpointConfig config)

Specified by:

onOpen in class Endpoint

onClose

public void onClose(Session session,
           CloseReason closeReason)

Overrides:

onClose in class Endpoint

isConnected

public boolean isConnected()

Returns if the web socket is connected.

Returns:

true if the web socket is connected, false otherwise.

getSentMessageCount

public long getSentMessageCount()

Returns the number of messages sent through the web socket.

Returns:

the number of messages sent.

getReceivedMessageCount

public long getReceivedMessageCount()

Returns the number of messages receive through the web socket.

Returns:

the number of messages received.

close

public void close(CloseReason reason)
           throws IOException

Closes the web socket connection with the Pathfinder server.

Parameters:

reason - the reason for closing the web socket.

Throws:

IOException - if the web socket failed to close properly.