Java tutorial
/* * This file is part of TelegramBots. * * TelegramBots is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * TelegramBots is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with TelegramBots. If not, see <http://www.gnu.org/licenses/>. */ package org.telegram.telegrambots.api.methods.send; import com.fasterxml.jackson.annotation.JsonProperty; import com.fasterxml.jackson.core.type.TypeReference; import org.telegram.telegrambots.api.methods.BotApiMethod; import org.telegram.telegrambots.api.objects.Message; import org.telegram.telegrambots.api.objects.replykeyboard.ApiResponse; import org.telegram.telegrambots.api.objects.replykeyboard.ReplyKeyboard; import org.telegram.telegrambots.exceptions.TelegramApiRequestException; import org.telegram.telegrambots.exceptions.TelegramApiValidationException; import java.io.IOException; import java.util.Objects; /** * @author Ruben Bermudez * @version 1.0 * @brief Use this method to send a game. On success, the sent Message is returned. * @date 27 of September of 2016 */ public class SendGame extends BotApiMethod<Message> { public static final String PATH = "sendGame"; private static final String CHATID_FIELD = "chat_id"; private static final String GAMESHORTNAME_FIELD = "game_short_name"; private static final String DISABLENOTIFICATION_FIELD = "disable_notification"; private static final String REPLYTOMESSAGEID_FIELD = "reply_to_message_id"; private static final String REPLYMARKUP_FIELD = "reply_markup"; @JsonProperty(CHATID_FIELD) private String chatId; ///< Unique identifier for the chat to send the message to (Or username for channels) @JsonProperty(GAMESHORTNAME_FIELD) private String gameShortName; ///< Short name of the game /** * Optional. Sends the message silently. iOS users will not receive a notification, Android * users will receive a notification with no sound. Other apps coming soon */ @JsonProperty(DISABLENOTIFICATION_FIELD) private Boolean disableNotification; @JsonProperty(REPLYTOMESSAGEID_FIELD) private Integer replyToMessageId; ///< Optional. If the message is a reply, ID of the original message @JsonProperty(REPLYMARKUP_FIELD) private ReplyKeyboard replyMarkup; ///< Optional. JSON-serialized object for a custom reply keyboard public SendGame() { super(); } public String getChatId() { return chatId; } public SendGame setChatId(String chatId) { this.chatId = chatId; return this; } public SendGame setChatId(Long chatId) { Objects.requireNonNull(chatId); this.chatId = chatId.toString(); return this; } public Integer getReplyToMessageId() { return replyToMessageId; } public SendGame setReplyToMessageId(Integer replyToMessageId) { this.replyToMessageId = replyToMessageId; return this; } public ReplyKeyboard getReplyMarkup() { return replyMarkup; } public SendGame setReplyMarkup(ReplyKeyboard replyMarkup) { this.replyMarkup = replyMarkup; return this; } public Boolean getDisableNotification() { return disableNotification; } public SendGame enableNotification() { this.disableNotification = null; return this; } public SendGame disableNotification() { this.disableNotification = true; return this; } public String getGameShortName() { return gameShortName; } public SendGame setGameShortName(String gameShortName) { this.gameShortName = gameShortName; return this; } @Override public String getMethod() { return PATH; } @Override public Message deserializeResponse(String answer) throws TelegramApiRequestException { try { ApiResponse<Message> result = OBJECT_MAPPER.readValue(answer, new TypeReference<ApiResponse<Message>>() { }); if (result.getOk()) { return result.getResult(); } else { throw new TelegramApiRequestException("Error sending game", result); } } catch (IOException e) { throw new TelegramApiRequestException("Unable to deserialize response", e); } } @Override public void validate() throws TelegramApiValidationException { if (chatId == null) { throw new TelegramApiValidationException("ChatId parameter can't be empty", this); } if (gameShortName == null || gameShortName.isEmpty()) { throw new TelegramApiValidationException("GameShortName parameter can't be empty", this); } if (replyMarkup != null) { replyMarkup.validate(); } } @Override public String toString() { return "SendGame{" + "chatId='" + chatId + '\'' + ", gameShortName='" + gameShortName + '\'' + ", disableNotification=" + disableNotification + ", replyToMessageId=" + replyToMessageId + ", replyMarkup=" + replyMarkup + '}'; } }