dev.roanh.convexmerger.net

Class ClientConnection

java.lang.Object

dev.roanh.convexmerger.net.Connection

dev.roanh.convexmerger.net.ClientConnection

All Implemented Interfaces:

GameStateListener

public class ClientConnection
extends Connection
implements GameStateListener

Represents a client connection to a remote game server.

Field Summary

Fields

Modifier and Type	Field and Description
private PacketPlayerJoinReject.RejectReason	failReason The reason a server connection could not be established (if any).
private Player	self The local player that wants to join.

Constructor Summary

Constructors

Modifier	Constructor and Description
private	ClientConnection(java.net.Socket socket, Player self) Constructs a new client connection from the given socket connection and with the given local player.

Method Summary

Modifier and Type	Method and Description
void	abort() Called when the game is aborted (forcefully terminated).
void	claim(Player player, ConvexObject obj) Called when a player claims a new object.
static ClientConnection	connect(java.lang.String host, Player player) Attempts to establish a new multiplayer connection to the given host and with the given local player.
void	end() Called when the game ends.
GameState	getGameState() Gets the gamestate for the remote game.
PacketPlayerJoinReject.RejectReason	getRejectReason() Gets the reason why the connection to the server failed (if any).
boolean	isConnected() Checks if this client was connected to the server.
void	merge(Player player, ConvexObject source, ConvexObject target, ConvexObject result, java.util.List<ConvexObject> absorbed) Called when a player performs a merge.

Methods inherited from class dev.roanh.convexmerger.net.Connection

close, isClosed, readPacket, sendPacket

Methods inherited from class java.lang.Object

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

Field Detail

self

private Player self

The local player that wants to join.

failReason

private PacketPlayerJoinReject.RejectReason failReason

The reason a server connection could not be established (if any).

Constructor Detail

ClientConnection

private ClientConnection(java.net.Socket socket,
                         Player self)
                  throws java.io.IOException

Constructs a new client connection from the given socket connection and with the given local player.

Parameters:

socket - The server connection.

self - The local player instance.

Throws:

java.io.IOException - When an IOException occurs.

Method Detail

isConnected

public boolean isConnected()

Checks if this client was connected to the server.

Returns:

True if this client was connected successfully.

getRejectReason

public PacketPlayerJoinReject.RejectReason getRejectReason()

Gets the reason why the connection to the server failed (if any).

Returns:

The reason a server connection failed.

getGameState

public GameState getGameState()
                       throws java.io.IOException

Gets the gamestate for the remote game. This method blocks until the game is started and the game state sent.

Returns:

The remote game state.

Throws:

java.io.IOException - When an IOException occurs.

claim

public void claim(Player player,
                  ConvexObject obj)

Description copied from interface: GameStateListener

Called when a player claims a new object.

Specified by:

claim in interface GameStateListener

Parameters:

player - The player that made the claim.

obj - The object that was claimed.

merge

public void merge(Player player,
                  ConvexObject source,
                  ConvexObject target,
                  ConvexObject result,
                  java.util.List<ConvexObject> absorbed)

Description copied from interface: GameStateListener

Called when a player performs a merge.

Specified by:

merge in interface GameStateListener

Parameters:

player - The player that performed the merge.

source - The object the merge was started from.

target - The target object of the merge.

result - The object resulting from the merge.

absorbed - The objects absorbed in the merge.

end

public void end()

Description copied from interface: GameStateListener

Called when the game ends.

Specified by:

end in interface GameStateListener

abort

public void abort()

Description copied from interface: GameStateListener

Called when the game is aborted (forcefully terminated).

Specified by:

abort in interface GameStateListener

connect

public static final ClientConnection connect(java.lang.String host,
                                             Player player)
                                      throws java.io.IOException

Attempts to establish a new multiplayer connection to the given host and with the given local player.

Parameters:

host - The host to connect to.

player - The local player joining.

Returns:

The remote connection, possibly containing a reason the connection failed.

Throws:

java.io.IOException - When an IOException occured.