org.bukkit.plugin.messaging
Interface PluginMessageRecipient

All Known Subinterfaces:

Player, Server, World

public interface PluginMessageRecipient

Represents a possible recipient for a Plugin Message.

Method Summary

Set<String>	getListeningPluginChannels() Gets a set containing all the Plugin Channels that this client is listening on.
void	sendPluginMessage(Plugin source, String channel, byte[] message) Sends this recipient a Plugin Message on the specified outgoing channel.

Method Detail

sendPluginMessage

void sendPluginMessage(Plugin source,
                       String channel,
                       byte[] message)

Sends this recipient a Plugin Message on the specified outgoing channel.

The message may not be larger than Messenger.MAX_MESSAGE_SIZE bytes, and the plugin must be registered to send messages on the specified channel.

Parameters:

source - The plugin that sent this message.

channel - The channel to send this message on.

message - The raw message to send.

Throws:

IllegalArgumentException - Thrown if the source plugin is disabled.

IllegalArgumentException - Thrown if source, channel or message is null.

MessageTooLargeException - Thrown if the message is too big.

ChannelNotRegisteredException - Thrown if the channel is not registered for this plugin.

getListeningPluginChannels

Set<String> getListeningPluginChannels()

Gets a set containing all the Plugin Channels that this client is listening on.

Returns:

Set containing all the channels that this client may accept.