Package org.spongepowered.api.network.channel.packet

Interface TransactionalPacketBinding<P extends RequestPacket<R>,R extends Packet>

Type Parameters:

P - The type of the request packet

R - The type of the response packet

All Superinterfaces:

PacketBinding<P>

All Known Subinterfaces:

FixedTransactionalPacketBinding<P,R>

public interface TransactionalPacketBinding<P extends RequestPacket<R>,R extends Packet>
extends PacketBinding<P>

A packet binding that represents a request/response pair. One side of a connection can send a RequestPacket and the other side will normally respond with a response Packet.

Request/response pairs share an opcode, a additional byte will specify whether it's a request, response or a no-response.

Method Summary

Modifier and Type	Method	Description
<C extends EngineConnection> TransactionalPacketBinding<P,R>	addResponseHandler(Class<C> connectionType, PacketHandler<? super R,? super C> responseHandler)	Adds a PacketHandler to handle a response Packet on for a specific connection type.
<C extends EngineConnection> TransactionalPacketBinding<P,R>	addResponseHandler(Class<C> connectionType, ResponsePacketHandler<? super P,? super R,? super C> handler)	Adds a ResponsePacketHandler to handle a response Packet for a specific connection type.
TransactionalPacketBinding<P,R>	addResponseHandler(PacketHandler<? super R,EngineConnection> handler)	Adds a PacketHandler to handle a response Packet on both platform sides.
TransactionalPacketBinding<P,R>	addResponseHandler(ResponsePacketHandler<? super P,? super R,EngineConnection> handler)	Adds a ResponsePacketHandler to handle a response Packet on both platform sides.
<C extends EngineConnection> TransactionalPacketBinding<P,R>	addResponseHandler(EngineConnectionSide<C> side, PacketHandler<? super R,? super C> handler)	Adds a PacketHandler to handle a response Packet on a specific connection side.
<C extends EngineConnection> TransactionalPacketBinding<P,R>	addResponseHandler(EngineConnectionSide<C> side, ResponsePacketHandler<? super P,? super R,? super C> handler)	Adds a ResponsePacketHandler to handle a response Packet on a specific connection side.
int	opcode()	Gets the opcode of the TransactionalPacketBinding.
Class<P>	packetType()	Gets the type of the RequestPacket.
<C extends EngineConnection> TransactionalPacketBinding<P,R>	setRequestHandler(Class<C> connectionType, RequestPacketHandler<? super P,? extends R,? super C> handler)	Sets the RequestPacketHandler to handle a RequestPacket for a specific connection type.
TransactionalPacketBinding<P,R>	setRequestHandler(RequestPacketHandler<? super P,? extends R,EngineConnection> handler)	Sets the RequestPacketHandler to handle a RequestPacket on both connection sides.
<C extends EngineConnection> TransactionalPacketBinding<P,R>	setRequestHandler(EngineConnectionSide<C> side, RequestPacketHandler<? super P,? extends R,? super C> handler)	Sets the RequestPacketHandler to handle a RequestPacket on a specific connection side.

Method Details

opcode

int opcode()

Gets the opcode of the TransactionalPacketBinding. This opcode will be shared by the request and response Packets.

Specified by:

opcode in interface PacketBinding<P extends RequestPacket<R>>

Returns:

The opcode

packetType

Class<P> packetType()

Gets the type of the RequestPacket.

Specified by:

packetType in interface PacketBinding<P extends RequestPacket<R>>

Returns:

The request packet type

setRequestHandler

<C extends EngineConnection>
TransactionalPacketBinding<P,R> setRequestHandler(EngineConnectionSide<C> side,
 RequestPacketHandler<? super P,? extends R,? super C> handler)

Sets the RequestPacketHandler to handle a RequestPacket on a specific connection side. The difference with a normal PacketHandler is that it requires a response Packet as return value.

Type Parameters:

C - The connection type

Parameters:

side - The side the request packet should be handled on

handler - The handler of the request packet

Returns:

This packet binding, for chaining

setRequestHandler

<C extends EngineConnection>
TransactionalPacketBinding<P,R> setRequestHandler(Class<C> connectionType,
 RequestPacketHandler<? super P,? extends R,? super C> handler)

Sets the RequestPacketHandler to handle a RequestPacket for a specific connection type. The difference with a normal PacketHandler is that it requires a response Packet as return value.

Type Parameters:

C - The connection type

Parameters:

connectionType - The connection type the request packet should be handled by

handler - The handler of the request packet

Returns:

This packet binding, for chaining

setRequestHandler

TransactionalPacketBinding<P,R> setRequestHandler(RequestPacketHandler<? super P,? extends R,EngineConnection> handler)

Sets the RequestPacketHandler to handle a RequestPacket on both connection sides. The difference with a normal PacketHandler is that it requires a response Packet as return value.

Parameters:

handler - The handler of the request packet

Returns:

This packet binding, for chaining

addResponseHandler

<C extends EngineConnection>
TransactionalPacketBinding<P,R> addResponseHandler(EngineConnectionSide<C> side,
 PacketHandler<? super R,? super C> handler)

Adds a PacketHandler to handle a response Packet on a specific connection side.

Binding a response PacketHandler is completely optional. It is also possible to append a handler to the CompletableFuture returned by TransactionalPacketDispatcher.sendTo(EngineConnection, RequestPacket).

Type Parameters:

C - The connection type

Parameters:

side - The side the response packet should be handled on

handler - The handler of the response packet

Returns:

This packet binding, for chaining

addResponseHandler

<C extends EngineConnection>
TransactionalPacketBinding<P,R> addResponseHandler(Class<C> connectionType,
 PacketHandler<? super R,? super C> responseHandler)

Adds a PacketHandler to handle a response Packet on for a specific connection type.

Binding a response PacketHandler is completely optional. It is also possible to append a handler to the CompletableFuture returned by TransactionalPacketDispatcher.sendTo(EngineConnection, RequestPacket).

Type Parameters:

C - The connection type

Parameters:

connectionType - The connection type the response packet should be handled by

responseHandler - The handler of the response packet

Returns:

This packet binding, for chaining

addResponseHandler

<C extends EngineConnection>
TransactionalPacketBinding<P,R> addResponseHandler(EngineConnectionSide<C> side,
 ResponsePacketHandler<? super P,? super R,? super C> handler)

Adds a ResponsePacketHandler to handle a response Packet on a specific connection side.

Binding a response PacketHandler is completely optional. It is also possible to append a handler to the CompletableFuture returned by TransactionalPacketDispatcher.sendTo(EngineConnection, RequestPacket).

Type Parameters:

C - The connection type

Parameters:

side - The side the response packet should be handled on

handler - The handler of the response packet

Returns:

This packet binding, for chaining

addResponseHandler

<C extends EngineConnection>
TransactionalPacketBinding<P,R> addResponseHandler(Class<C> connectionType,
 ResponsePacketHandler<? super P,? super R,? super C> handler)

Adds a ResponsePacketHandler to handle a response Packet for a specific connection type.

Binding a response PacketHandler is completely optional. It is also possible to append a handler to the CompletableFuture returned by TransactionalPacketDispatcher.sendTo(EngineConnection, RequestPacket).

Type Parameters:

C - The connection type

Parameters:

connectionType - The connection type the response packet should be handled by

handler - The handler of the response packet

Returns:

This packet binding, for chaining

addResponseHandler

TransactionalPacketBinding<P,R> addResponseHandler(PacketHandler<? super R,EngineConnection> handler)

Adds a PacketHandler to handle a response Packet on both platform sides.

Binding a response PacketHandler is completely optional. It is also possible to append a handler to the CompletableFuture returned by TransactionalPacketDispatcher.sendTo(EngineConnection, RequestPacket).

Parameters:

handler - The handler of the response packet

Returns:

This packet binding, for chaining

addResponseHandler

TransactionalPacketBinding<P,R> addResponseHandler(ResponsePacketHandler<? super P,? super R,EngineConnection> handler)

Adds a ResponsePacketHandler to handle a response Packet on both platform sides.

Binding a response PacketHandler is completely optional. It is also possible to append a handler to the CompletableFuture returned by TransactionalPacketDispatcher.sendTo(EngineConnection, RequestPacket).

Parameters:

handler - The handler of the response packet

Returns:

This packet binding, for chaining