org.telegram.telegrambots.bots

Class TelegramLongPollingCommandBot

java.lang.Object

org.telegram.telegrambots.bots.AbsSender

org.telegram.telegrambots.bots.DefaultAbsSender

org.telegram.telegrambots.bots.TelegramLongPollingBot

org.telegram.telegrambots.bots.TelegramLongPollingCommandBot

All Implemented Interfaces:

ICommandRegistry, LongPollingBot

public abstract class TelegramLongPollingCommandBot
extends TelegramLongPollingBot
implements ICommandRegistry

This class adds command functionality to the TelegramLongPollingBot

Author:

Timo Schulz (Mit0x2)

Constructor Summary

Constructors

Constructor and Description
TelegramLongPollingCommandBot() Creates a TelegramLongPollingCommandBot using default options Use ICommandRegistry's methods on this bot to register commands
TelegramLongPollingCommandBot(DefaultBotOptions options) Creates a TelegramLongPollingCommandBot with custom options and allowing commands with usernames Use ICommandRegistry's methods on this bot to register commands
TelegramLongPollingCommandBot(DefaultBotOptions options, boolean allowCommandsWithUsername) Creates a TelegramLongPollingCommandBot Use ICommandRegistry's methods on this bot to register commands

Method Summary

Modifier and Type	Method and Description
boolean	deregister(BotCommand botCommand) deregister a command
Map<BotCommand,Boolean>	deregisterAll(BotCommand... botCommands) deregister multiple commands
protected boolean	filter(Message message) Override this function in your bot implementation to filter messages with commands For example, if you want to prevent commands execution incoming from group chat: # # return !message.getChat().isGroupChat(); #
BotCommand	getRegisteredCommand(String commandIdentifier) get registered command
Collection<BotCommand>	getRegisteredCommands() get a collection of all registered commands
void	onUpdateReceived(Update update)
abstract void	processNonCommandUpdate(Update update) Process all updates, that are not commands.
boolean	register(BotCommand botCommand) register a command
Map<BotCommand,Boolean>	registerAll(BotCommand... botCommands) register multiple commands
void	registerDefaultAction(BiConsumer<AbsSender,Message> defaultConsumer) Register a default action when there is no command register that match the message sent

Methods inherited from class org.telegram.telegrambots.bots.TelegramLongPollingBot

clearWebhook

Methods inherited from class org.telegram.telegrambots.bots.DefaultAbsSender

downloadFile, downloadFile, downloadFileAsync, downloadFileAsync, getBotToken, getOptions, sendApiMethod, sendApiMethodAsync, sendAudio, sendDocument, sendPhoto, sendSticker, sendVideo, sendVoice

Methods inherited from class org.telegram.telegrambots.bots.AbsSender

answerCallbackQuery, answerCallbackQueryAsync, answerInlineQuery, answerInlineQueryAsync, editMessageCaption, editMessageCaptionAsync, editMessageReplyMarkup, editMessageReplyMarkup, editMessageText, editMessageTextAsync, forwardMessage, forwardMessageAsync, getChat, getChatAdministrators, getChatAdministratorsAsync, getChatAsync, getChatMember, getChatMemberAsync, getChatMemberCount, getChatMemberCountAsync, getFile, getFileAsync, getGameHighScores, getGameHighScoresAsync, getMe, getMeAsync, getUserProfilePhotos, getUserProfilePhotosAsync, getWebhookInfo, getWebhookInfoAsync, kickMember, kickMemberAsync, leaveChat, leaveChatAsync, sendChatAction, sendChatActionAsync, sendContact, sendContactAsync, sendGame, sendGameAsync, sendLocation, sendLocationAsync, sendMessage, sendMessageAsync, sendVenue, sendVenueAsync, setGameScore, setGameScoreAsync, unbanMember, unbanMemberAsync

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.telegram.telegrambots.generics.LongPollingBot

getBotToken, getBotUsername, getOptions, onClosing

Constructor Detail

TelegramLongPollingCommandBot

public TelegramLongPollingCommandBot()

Creates a TelegramLongPollingCommandBot using default options Use ICommandRegistry's methods on this bot to register commands

TelegramLongPollingCommandBot

public TelegramLongPollingCommandBot(DefaultBotOptions options)

Creates a TelegramLongPollingCommandBot with custom options and allowing commands with usernames Use ICommandRegistry's methods on this bot to register commands

Parameters:

options - Bot options

TelegramLongPollingCommandBot

public TelegramLongPollingCommandBot(DefaultBotOptions options,
                                     boolean allowCommandsWithUsername)

Creates a TelegramLongPollingCommandBot Use ICommandRegistry's methods on this bot to register commands

Parameters:

options - Bot options

allowCommandsWithUsername - true to allow commands with parameters (default), false otherwise

Method Detail

onUpdateReceived

public final void onUpdateReceived(Update update)

Specified by:

onUpdateReceived in interface LongPollingBot

filter

protected boolean filter(Message message)

Override this function in your bot implementation to filter messages with commands For example, if you want to prevent commands execution incoming from group chat: # # return !message.getChat().isGroupChat(); #

Parameters:

message - Received message

Returns:

true if the message must be ignored by the command bot and treated as a non command message, false otherwise

register

public final boolean register(BotCommand botCommand)

Description copied from interface: ICommandRegistry

register a command

Specified by:

register in interface ICommandRegistry

Parameters:

botCommand - the command to register

Returns:

whether the command could be registered, was not already registered

registerAll

public final Map<BotCommand,Boolean> registerAll(BotCommand... botCommands)

Description copied from interface: ICommandRegistry

register multiple commands

Specified by:

registerAll in interface ICommandRegistry

Parameters:

botCommands - commands to register

Returns:

map with results of the command register per command

deregister

public final boolean deregister(BotCommand botCommand)

Description copied from interface: ICommandRegistry

deregister a command

Specified by:

deregister in interface ICommandRegistry

Parameters:

botCommand - the command to deregister

Returns:

whether the command could be deregistered, was registered

deregisterAll

public final Map<BotCommand,Boolean> deregisterAll(BotCommand... botCommands)

Description copied from interface: ICommandRegistry

deregister multiple commands

Specified by:

deregisterAll in interface ICommandRegistry

Parameters:

botCommands - commands to deregister

Returns:

map with results of the command deregistered per command

getRegisteredCommands

public final Collection<BotCommand> getRegisteredCommands()

Description copied from interface: ICommandRegistry

get a collection of all registered commands

Specified by:

getRegisteredCommands in interface ICommandRegistry

Returns:

a collection of registered commands

registerDefaultAction

public void registerDefaultAction(BiConsumer<AbsSender,Message> defaultConsumer)

Description copied from interface: ICommandRegistry

Register a default action when there is no command register that match the message sent

Specified by:

registerDefaultAction in interface ICommandRegistry

Parameters:

defaultConsumer - Consumer to evaluate the message

getRegisteredCommand

public final BotCommand getRegisteredCommand(String commandIdentifier)

Description copied from interface: ICommandRegistry

get registered command

Specified by:

getRegisteredCommand in interface ICommandRegistry

Returns:

registered command if exists or null if not

processNonCommandUpdate

public abstract void processNonCommandUpdate(Update update)

Process all updates, that are not commands.

Parameters:

update - the update