All Downloads are FREE. Search and download functionalities are using the official Maven repository.

Explore the source code of the class TelegramBot.java


package com.antonioaltieri.telegram.botapi;

import com.antonioaltieri.telegram.botapi.HandlerNotifier;
import com.antonioaltieri.telegram.botapi.requests.*;
import com.antonioaltieri.telegram.botapi.types.*;

import java.io.File;
import java.util.ArrayList;
import java.util.List;
import java.util.logging.Logger;

/**
 * This class represents a TelegramBot.
 *
 * To use it, use any of the available subclasses or subclass it yourself.
 */
abstract public class TelegramBot {

    private static final Logger logger = Logger.getLogger(TelegramBot.class.getName());

    private TelegramApi api;
    private long lastUpdateId = 0;
    private ApiRequestExecutor requestExecutor;
    private HandlerNotifier handlerNotifier;




    /**
     * Constructs a TelegramBot using the provided [email protected] botToken}.
     *
     * @param botToken The token provided by @BotFather
     */
    public TelegramBot(String botToken) {
        api = new TelegramApi(botToken);
        handlerNotifier = new HandlerNotifier(this);
        Properties.Token=botToken;

    }

    /**
     * Starts the bot.
     */
    public final void start() {
        logger.info("Starting");
        requestExecutor = ApiRequestExecutor.getInstance();
        User bot=this.getMe();
        if(bot==null) throw new ApiException("Telegram is not responding. Please check that you have passed the correct botToken");
        Properties.BotUser=this.getMe();
        logger.info("My name is: "+Properties.BotUser);
        onStart();
    }

    protected void onStart() {

    }

    /**
     * Stops the bot.
     */
    public final void stop() {
        onStop();
    }

    protected void onStop() {

    }

    /**
     * Forwards a message with ID [email protected] messageId} from [email protected] fromChatId} to [email protected] chatId}.
     *
     * @see https://core.telegram.org/bots/api#forwardmessage
     *
     * @param chatId Unique identifier for the message recipient — Chat id
     * @param fromChatId Unique identifier for the chat where the original message was sent — Chat id
     * @param messageId Unique message identifier
     * @return The sent [email protected] Message}
     */
    public final Message forwardMessage(long chatId, long fromChatId, long messageId) {
        return requestExecutor.execute(api, new ForwardMessageRequest(chatId, fromChatId, messageId));
    }

    /**
     * A simple method for testing your bot's auth token. Requires no parameters. Returns basic information about the bot in form of a User object.
     *
     * @see https://core.telegram.org/bots/api#getme
     *
     * @return this bot's information, in the form of a [email protected] User}
     */
    public final User getMe() {
        return requestExecutor.execute(api, new GetMeRequest());
    }

    /**
     * @see com.antonioaltieri.telegram.botapi.TelegramBot#getUserProfilePhotos(long, OptionalArgs)
     */
    public final UserProfilePhotos getUserProfilePhotos(long userId) {
        return requestExecutor.execute(api, new GetUserProfilePhotosRequest(userId));
    }

    /**
     * Returns a [email protected] UserProfilePhotos} for a user.
     *
     * For any optional arguments, refer to the Telegram documentation.
     *
     * @see https://core.telegram.org/bots/api#getuserprofilephotos
     * @see OptionalArgs
     *
     * @param userId Unique identifier of the target user
     * @param optionalArgs Any optional arguments for this method
     * @return The requested [email protected] UserProfilePhotos}
     */
    //TODO testare il caso in cui vengano inseirti optionalargs non pertinenti
    public final UserProfilePhotos getUserProfilePhotos(long userId, OptionalArgs optionalArgs) {
        return requestExecutor.execute(api, new GetUserProfilePhotosRequest(userId, optionalArgs));
    }

    /**
     * @see com.antonioaltieri.telegram.botapi.TelegramBot#sendAudio(long, File, OptionalArgs)
     */
    public final Message sendAudio(long chatId, File audioFile) {
        return requestExecutor.execute(api, new SendAudioRequest(chatId, audioFile));
    }

    /**
     * Use this method to send audio files, if you want Telegram clients to display the file as a music playable with the internal player.
     * Bots can currently send audio files of up to 50 MB in size, this limit may be changed in the future.
     *
     * For any optional arguments, refer to the Telegram documentation.
     *
     * @see https://core.telegram.org/bots/api#sendaudio
     *
     * @param chatId Unique identifier for the message recipient - [email protected] Chat} id or Channel Username
     * @param audioFile Audio [email protected] File} to send
     * @param optionalArgs Any optional arguments for this method
     * @return The sent [email protected] Message}
     */
    public final Message sendAudio(long chatId, File audioFile, OptionalArgs optionalArgs) {
        return requestExecutor.execute(api, new SendAudioRequest(chatId, audioFile, optionalArgs));
    }

    /**
     * @see com.antonioaltieri.telegram.botapi.TelegramBot#sendAudio(long, String, OptionalArgs)
     */
    public final Message sendAudio(long chatId, String audioFileId) {
        return requestExecutor.execute(api, new SendAudioRequest(chatId, audioFileId));
    }

    /**
     * This version takes a file id instead of a [email protected] File}, as a [email protected] String} argument.
     *
     * @see com.antonioaltieri.telegram.botapi.TelegramBot#sendAudio(long, File, OptionalArgs)
     */
    public final Message sendAudio(long chatId, String audioFileId, OptionalArgs optionalArgs) {
        return requestExecutor.execute(api, new SendAudioRequest(chatId, audioFileId, optionalArgs));
    }

    /**
     * Use this method when you need to tell the user that something is happening on the bot's side.
     * The status is set for 5 seconds or less (when a message arrives from your bot, Telegram clients clear its typing status).
     *
     * @see https://core.telegram.org/bots/api#sendchataction
     *
     * @param chatId Unique identifier for the message recipient - [email protected] Chat} id or Channel Username
     * @param chatAction The target [email protected] ChatAction}
     * @return True if the request was successful
     */
    public final Boolean sendChatAction(long chatId, ChatAction chatAction) {
        return requestExecutor.execute(api, new SendChatActionRequest(chatId, chatAction));
    }

    /**
     * @see com.antonioaltieri.telegram.botapi.TelegramBot#sendAudio(long, File, OptionalArgs)
     */
    public final Message sendDocument(long chatId, File documentFile) {
        return requestExecutor.execute(api, new SendDocumentRequest(chatId, documentFile));
    }

    /**
     * Use this method to send general files. On success, the sent Message is returned.
     * Bots can currently send files of any type of up to 50 MB in size, this limit may be changed in the future.
     *
     * For any optional arguments, refer to the Telegram documentation.
     *
     * @see https://core.telegram.org/bots/api#senddocument
     *
     * @param chatId Unique identifier for the message recipient - [email protected] Chat} id or Channel Username
     * @param documentFile File to send
     * @param optionalArgs Any optional arguments
     * @return The sent [email protected] Message}
     */
    public final Message sendDocument(long chatId, File documentFile, OptionalArgs optionalArgs) {
        return requestExecutor.execute(api, new SendDocumentRequest(chatId, documentFile, optionalArgs));
    }

    /**
     * @see com.antonioaltieri.telegram.botapi.TelegramBot#sendDocument(long, String, OptionalArgs)
     */
    public final Message sendDocument(long chatId, String documentFileId) {
        return requestExecutor.execute(api, new SendDocumentRequest(chatId, documentFileId));
    }

    /**
     * This version takes a file id instead of a [email protected] File}.
     *
     * @see com.antonioaltieri.telegram.botapi.TelegramBot#sendDocument(long, File, OptionalArgs)
     */
    public final Message sendDocument(long chatId, String documentFileId, OptionalArgs optionalArgs) {
        return requestExecutor.execute(api, new SendDocumentRequest(chatId, documentFileId, optionalArgs));
    }

    /**
     * @see com.antonioaltieri.telegram.botapi.TelegramBot#sendLocation(long, float, float, OptionalArgs)
     */
    public final Message sendLocation(long chatId, float latitude, float longitude) {
        return requestExecutor.execute(api, new SendLocationRequest(chatId, latitude, longitude));
    }

    /**
     * Use this method to send point on the map.
     *
     * For any optional arguments, refer to the Telegram documentation.
     *
     * @see https://core.telegram.org/bots/api#sendlocation
     *
     * @param chatId Unique identifier for the message recipient - [email protected] Chat} id or Channel Username
     * @param latitude Latitude of location
     * @param longitude Longitude of location
     * @param optionalArgs Any optional arguments
     * @return the sent [email protected] Message}
     */
    public final Message sendLocation(long chatId, float latitude, float longitude, OptionalArgs optionalArgs) {
        return requestExecutor.execute(api, new SendLocationRequest(chatId, latitude, longitude, optionalArgs));
    }

    /**
     * @see com.antonioaltieri.telegram.botapi.TelegramBot#sendMessage(long, String, OptionalArgs)
     */
    public final Message sendMessage(long chatId, String text) {
        return requestExecutor.execute(api, new SendMessageRequest(chatId, text));
    }
    /**
     * @see com.antonioaltieri.telegram.botapi.TelegramBot#sendMessage(long, String, OptionalArgs)
     */
    public final Message sendMessage(String channelUsername, String text) {
        return requestExecutor.execute(api, new SendMessageRequest(channelUsername, text));
    }
    /**
     * Use this method to send text messages.
     *
     * For any optional arguments, refer to the Telegram documentation.
     *
     * @see https://core.telegram.org/bots/api#sendmessage
     *
     * @param chatId Unique identifier for the message recipient - [email protected] Chat} id or Channel Username
     * @param text Text of the message to be sent
     * @param optionalArgs Any optional arguments
     * @return the sent [email protected] Message}
     */
    public final Message sendMessage(long chatId, String text, OptionalArgs optionalArgs) {
        return requestExecutor.execute(api, new SendMessageRequest(chatId, text, optionalArgs));
    }
    /**
     * @see com.antonioaltieri.telegram.botapi.TelegramBot#sendPhoto(long, File, OptionalArgs)
     */
    public final Message sendMessage(String chatId, String text, OptionalArgs optionalArgs) {
        return requestExecutor.execute(api, new SendMessageRequest(chatId, text, optionalArgs));
    }
    /**
     * @see com.antonioaltieri.telegram.botapi.TelegramBot#sendPhoto(long, File, OptionalArgs)
     */
    public final Message sendPhoto(long chatId, File photoFile) {
        return requestExecutor.execute(api, new SendPhotoRequest(chatId, photoFile));
    }

    /**
     * Use this method to send photos.
     *
     * @see https://core.telegram.org/bots/api#sendphoto
     *
     * @param chatId Unique identifier for the message recipient - [email protected] Chat} id or Channel Username
     * @param photoFile Photo to send
     * @param optionalArgs Any optional arguments
     * @return The sent [email protected] Message}
     */
    public final Message sendPhoto(long chatId, File photoFile, OptionalArgs optionalArgs) {
        return requestExecutor.execute(api, new SendPhotoRequest(chatId, photoFile, optionalArgs));
    }

    /**
     * @see com.antonioaltieri.telegram.botapi.TelegramBot#sendPhoto(long, String, OptionalArgs)
     */
    public final Message sendPhoto(long chatId, String photoFileId) {
        return requestExecutor.execute(api, new SendPhotoRequest(chatId, photoFileId));
    }

    /**
     * This version takes a file id instead of a [email protected] File}
     *
     * @see com.antonioaltieri.telegram.botapi.TelegramBot#sendPhoto(long, File, OptionalArgs)
     */
    public final Message sendPhoto(long chatId, String photoFileId, OptionalArgs optionalArgs) {
        return requestExecutor.execute(api, new SendPhotoRequest(chatId, photoFileId, optionalArgs));
    }

    /**
     * @see com.antonioaltieri.telegram.botapi.TelegramBot#sendSticker(long, File, OptionalArgs)
     */
    public final Message sendSticker(long chatId, File stickerFile) {
        return requestExecutor.execute(api, new SendStickerRequest(chatId, stickerFile));
    }

    /**
     * Use this method to send .webp stickers.
     *
     * For any optional arguments, refer to the Telegram documentation.
     *
     * @see https://core.telegram.org/bots/api#sendsticker
     *
     * @param chatId Unique identifier for the message recipient - [email protected] Chat} id or Channel Username
     * @param stickerFile Sticker to send.
     * @param optionalArgs Any optional arguments
     * @return The sent [email protected] Message}
     */
    public final Message sendSticker(long chatId, File stickerFile, OptionalArgs optionalArgs) {
        return requestExecutor.execute(api, new SendStickerRequest(chatId, stickerFile, optionalArgs));
    }

    /**
     * @see com.antonioaltieri.telegram.botapi.TelegramBot#sendSticker(long, String, OptionalArgs)
     */
    public final Message sendSticker(long chatId, String stickerFileId) {
        return requestExecutor.execute(api, new SendStickerRequest(chatId, stickerFileId));
    }

    /**
     * This version takes a file id instead of a [email protected] File}.
     *
     * @see com.antonioaltieri.telegram.botapi.TelegramBot#sendSticker(long, File, OptionalArgs)
     */
    public final Message sendSticker(long chatId, String stickerFileId, OptionalArgs optionalArgs) {
        return requestExecutor.execute(api, new SendStickerRequest(chatId, stickerFileId, optionalArgs));
    }

    /**
     * @see com.antonioaltieri.telegram.botapi.TelegramBot#sendVideo(long, File, OptionalArgs)
     */
    public final Message sendVideo(long chatId, File videoFile) {
        return requestExecutor.execute(api, new SendVideoRequest(chatId, videoFile));
    }

    /**
     * Use this method to send video files,
     * Telegram clients support mp4 videos (other formats may be sent as Document ([email protected] com.antonioaltieri.telegram.botapi.TelegramBot#sendDocument(long, File, OptionalArgs)})).
     * Bots can currently send video files of up to 50 MB in size, this limit may be changed in the future.
     *
     * For any optional arguments, refer to the Telegram documentation.
     *
     * @see https://core.telegram.org/bots/api#sendvideo
     *
     * @param chatId Unique identifier for the message recipient - [email protected] Chat} id or Channel Username
     * @param videoFile Video to send
     * @param optionalArgs Any optional arguments.
     * @return The sent [email protected] Message}
     */
    //TODO Controllare cosa succede se si invia un file di tipo diverso da quello richiesto. es. foto con sendvideo, oppure un video non mp4
    public final Message sendVideo(long chatId, File videoFile, OptionalArgs optionalArgs) {
        return requestExecutor.execute(api, new SendVideoRequest(chatId, videoFile, optionalArgs));
    }

    /**
     * @see com.antonioaltieri.telegram.botapi.TelegramBot#sendVideo(long, File, OptionalArgs)
     */
    public final Message sendVideo(long chatId, String videoFileId) {
        return requestExecutor.execute(api, new SendVideoRequest(chatId, videoFileId));
    }

    /**
     * This version uses a file id rather than a [email protected] File}
     *
     * @see com.antonioaltieri.telegram.botapi.TelegramBot#sendVideo(long, File, OptionalArgs)
     */
    public final Message sendVideo(long chatId, String videoFileId, OptionalArgs optionalArgs) {
        return requestExecutor.execute(api, new SendVideoRequest(chatId, videoFileId, optionalArgs));
    }

    /**
     * Convenience method for [email protected] sendMessage(message.getChat().getId(), text, new OptionalArgs().replyToMessageId(message.getMessageId()))}
     */
    public final Message replyTo(Message message, String text) {
        OptionalArgs optionalArgs = new OptionalArgs().replyToMessageId(message.getMessageId());
        return sendMessage(message.getChat().getId(), text, optionalArgs);
    }

    /** set the webhook of the bot.
     *
     * @param servletAddress address of the servlet that handles the requests
     * @return if the webhook is setted succesfully
     */
    public final boolean setWebHook(String servletAddress){
        SetWebHookRequest request = new SetWebHookRequest(servletAddress);
        return requestExecutor.execute(api, request);
    }
    /**
     * This method is called when a new message has arrived.
     * It can safely be overridden by subclasses.
     *
     * @param message The newly arrived [email protected] Message}
     */
    protected void onMessage(Message message) {
        // Can be overridden by subclasses.
    }

    /**
     * This method is called by this class to process all new [email protected] Message}s .
     * @param message The newly arrived [email protected] Message}
     */
    protected void notifyNewMessage(Message message) {
        onMessage(message);
        handlerNotifier.notifyHandlers(message);
    }

    /**
     * This method is called by another class to process all new [email protected] Update}s asynchronously.
     *
     * @param update The newly arrived [email protected] Update}s
     */
    public void notifyNewUpdate(Update update) {
    	Message message = processUpdate(update);
        if(message!=null) notifyNewMessage(message);
    }
    private Message processUpdate(Update update) {
        Message msg=null;
        if (update.getUpdateId() > lastUpdateId){
            lastUpdateId = update.getUpdateId();
            msg=update.getMessage();
        }

        return msg;
    }


}