程序包 net.minecraftforge.network

类 SimpleChannel.MessageBuilder<MSG,BUF extends FriendlyByteBuf>

java.lang.Object

net.minecraftforge.network.SimpleChannel.MessageBuilder<MSG,BUF>

封闭类:

SimpleChannel

public static class SimpleChannel.MessageBuilder<MSG,BUF extends FriendlyByteBuf>
extends Object

嵌套类概要

嵌套类

修饰符和类型	类	说明
static interface	SimpleChannel.MessageBuilder.ToBooleanBiFunction<T,U>
static interface	SimpleChannel.MessageBuilder.ToBooleanTriFunction<T,U,V>

字段概要

字段

修饰符和类型	字段	说明
private final SimpleChannel	channel
private BiConsumer<MSG,CustomPayloadEvent.Context>	consumer
private Function<BUF,MSG>	decoder
private PacketFlow	direction
private BiConsumer<MSG,BUF>	encoder
private final int	id
private final NetworkProtocol<BUF>	protocol
private final Class<MSG>	type

构造器概要

构造器

限定符	构造器	说明
private	MessageBuilder(SimpleChannel channel, Class<MSG> type, int id, @Nullable NetworkProtocol<BUF> protocol)

方法概要

修饰符和类型	方法	说明
SimpleChannel	add()	Finishes building this packet.
SimpleChannel.MessageBuilder<MSG,BUF>	codec(StreamCodec<BUF,MSG> codec)	Set the StreamCodec to be used for marshaling the message object to and from a FriendlyByteBuf
SimpleChannel.MessageBuilder<MSG,BUF>	consumer(BiConsumer<MSG,CustomPayloadEvent.Context> consumer)	Set the message consumer, which is called once a message has been decoded.
<C> SimpleChannel.MessageBuilder<MSG,BUF>	consumerMainThread(io.netty.util.AttributeKey<C> key, org.apache.commons.lang3.function.TriConsumer<C,MSG,CustomPayloadEvent.Context> consumer)	Set the message consumer, which is called once a message has been decoded.
SimpleChannel.MessageBuilder<MSG,BUF>	consumerMainThread(BiConsumer<MSG,CustomPayloadEvent.Context> consumer)	Set the message consumer, which is called once a message has been decoded.
<C> SimpleChannel.MessageBuilder<MSG,BUF>	consumerNetworkThread(io.netty.util.AttributeKey<C> key, SimpleChannel.MessageBuilder.ToBooleanTriFunction<C,MSG,CustomPayloadEvent.Context> handler)	Function returning a boolean "packet handled" indication, for simpler channel building.
<C> SimpleChannel.MessageBuilder<MSG,BUF>	consumerNetworkThread(io.netty.util.AttributeKey<C> key, org.apache.commons.lang3.function.TriConsumer<C,MSG,CustomPayloadEvent.Context> consumer)	Set the message consumer, which is called once a message has been decoded.
SimpleChannel.MessageBuilder<MSG,BUF>	consumerNetworkThread(BiConsumer<MSG,CustomPayloadEvent.Context> consumer)	Set the message consumer, which is called once a message has been decoded.
SimpleChannel.MessageBuilder<MSG,BUF>	consumerNetworkThread(SimpleChannel.MessageBuilder.ToBooleanBiFunction<MSG,CustomPayloadEvent.Context> handler)	Function returning a boolean "packet handled" indication, for simpler channel building.
SimpleChannel.MessageBuilder<MSG,BUF>	decoder(Function<BUF,MSG> decoder)	Set the message decoder, which reads the message from a FriendlyByteBuf.
SimpleChannel.MessageBuilder<MSG,BUF>	direction(PacketFlow direction)	Set the direction that this packet is allowed to be sent/received.
SimpleChannel.MessageBuilder<MSG,BUF>	encoder(BiConsumer<MSG,BUF> encoder)	Set the message encoder, which writes this message to a FriendlyByteBuf.

从类继承的方法 java.lang.Object

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

字段详细资料

channel

private final SimpleChannel channel

type

private final Class<MSG> type

id

private final int id

protocol

private final NetworkProtocol<BUF extends FriendlyByteBuf> protocol

encoder

private BiConsumer<MSG,BUF extends FriendlyByteBuf> encoder

decoder

private Function<BUF extends FriendlyByteBuf,MSG> decoder

consumer

private BiConsumer<MSG,CustomPayloadEvent.Context> consumer

direction

private PacketFlow direction

构造器详细资料

MessageBuilder

private MessageBuilder(SimpleChannel channel,
 Class<MSG> type,
 int id,
 @Nullable
 @Nullable NetworkProtocol<BUF> protocol)

方法详细资料

direction

public SimpleChannel.MessageBuilder<MSG,BUF> direction(PacketFlow direction)

Set the direction that this packet is allowed to be sent/received. Use to enforce strict sided handling to prevent spoofing.

参数:

direction - The direction this packet is allowed on.

返回:

This message builder, for chaining.

encoder

public SimpleChannel.MessageBuilder<MSG,BUF> encoder(BiConsumer<MSG,BUF> encoder)

Set the message encoder, which writes this message to a FriendlyByteBuf.

The encoder is called immediately Channel.send(Object, PacketDistributor.PacketTarget) when the packet is sent}. This means encoding typically occurs on the main server/client thread rather than on the network thread.

However, this behavior should not be relied on, and the encoder should try to be thread-safe and not interact with the current game state.

参数:

encoder - The message encoder.

返回:

This message builder, for chaining.

decoder

public SimpleChannel.MessageBuilder<MSG,BUF> decoder(Function<BUF,MSG> decoder)

Set the message decoder, which reads the message from a FriendlyByteBuf.

The decoder is called when the message is received on the network thread. The decoder should not attempt to access or mutate any game state, deferring that until the the message is handled.

参数:

decoder - The message decoder.

返回:

The message builder, for chaining.

codec

public SimpleChannel.MessageBuilder<MSG,BUF> codec(StreamCodec<BUF,MSG> codec)

Set the StreamCodec to be used for marshaling the message object to and from a FriendlyByteBuf

This has all the same limitations of encoder(BiConsumer) and decoder(Function) as it is equivalent of calling those functions with the codec's encode and decode functions.

参数:

codec - The codec to use.

返回:

The message builder, for chaining.

consumer

public SimpleChannel.MessageBuilder<MSG,BUF> consumer(BiConsumer<MSG,CustomPayloadEvent.Context> consumer)

Set the message consumer, which is called once a message has been decoded. This accepts the decoded message object and the message's context.

The consumer is called on the network thread, and so should not interact with most game state by default. CustomPayloadEvent.Context.enqueueWork(Runnable) can be used to handle the message on the main server or client thread. Alternatively one can use consumerMainThread(BiConsumer) to run the handler on the main thread.

参数:

consumer - The message consumer.

返回:

The message builder, for chaining.

另请参阅:

• consumerMainThread(BiConsumer)

consumerNetworkThread

public SimpleChannel.MessageBuilder<MSG,BUF> consumerNetworkThread(BiConsumer<MSG,CustomPayloadEvent.Context> consumer)

Set the message consumer, which is called once a message has been decoded. This accepts the decoded message object and the message's context.

The consumer is called on the network thread, and so should not interact with most game state by default. CustomPayloadEvent.Context.enqueueWork(Runnable) can be used to handle the message on the main server or client thread. Alternatively one can use consumerMainThread(BiConsumer) to run the handler on the main thread.

参数:

consumer - The message consumer.

返回:

The message builder, for chaining.

另请参阅:

• consumerMainThread(BiConsumer)

consumerNetworkThread

public <C> SimpleChannel.MessageBuilder<MSG,BUF> consumerNetworkThread(io.netty.util.AttributeKey<C> key,
 org.apache.commons.lang3.function.TriConsumer<C,MSG,CustomPayloadEvent.Context> consumer)

Set the message consumer, which is called once a message has been decoded. This accepts the decoded message object and the message's context. The instance will be retrieved from the associated AttributeKey on the channel.

The consumer is called on the network thread, and so should not interact with most game state by default. CustomPayloadEvent.Context.enqueueWork(Runnable) can be used to handle the message on the main server or client thread. Alternatively one can use consumerMainThread(BiConsumer) to run the handler on the main thread.

参数:

consumer - The message consumer.

返回:

The message builder, for chaining.

另请参阅:

• consumerMainThread(BiConsumer)

consumerNetworkThread

public SimpleChannel.MessageBuilder<MSG,BUF> consumerNetworkThread(SimpleChannel.MessageBuilder.ToBooleanBiFunction<MSG,CustomPayloadEvent.Context> handler)

Function returning a boolean "packet handled" indication, for simpler channel building.

另请参阅:

• consumerNetworkThread(BiConsumer)

consumerNetworkThread

public <C> SimpleChannel.MessageBuilder<MSG,BUF> consumerNetworkThread(io.netty.util.AttributeKey<C> key,
 SimpleChannel.MessageBuilder.ToBooleanTriFunction<C,MSG,CustomPayloadEvent.Context> handler)

Function returning a boolean "packet handled" indication, for simpler channel building.

另请参阅:

• consumerNetworkThread(AttributeKey,TriConsumer)

consumerMainThread

public SimpleChannel.MessageBuilder<MSG,BUF> consumerMainThread(BiConsumer<MSG,CustomPayloadEvent.Context> consumer)

Set the message consumer, which is called once a message has been decoded. This accepts the decoded message object and the message's context.

Unlike consumerNetworkThread(BiConsumer), the consumer is called on the main thread, and so can interact with most game state by default.

参数:

consumer - The message consumer.

返回:

The message builder, for chaining.

另请参阅:

• consumerNetworkThread(BiConsumer)

consumerMainThread

public <C> SimpleChannel.MessageBuilder<MSG,BUF> consumerMainThread(io.netty.util.AttributeKey<C> key,
 org.apache.commons.lang3.function.TriConsumer<C,MSG,CustomPayloadEvent.Context> consumer)

Set the message consumer, which is called once a message has been decoded. This accepts the decoded message object and the message's context. The instance will be retrieved from the associated AttributeKey on the channel.

Unlike consumerNetworkThread(AttributeKey,TriConsumer), the consumer is called on the main thread, and so can interact with most game state by default.

参数:

consumer - The message consumer.

返回:

The message builder, for chaining.

另请参阅:

• consumerNetworkThread(BiConsumer)

add

public SimpleChannel add()

Finishes building this packet.

返回:

The attached SimpleChannel to facilitate chaining.