Мотивация
У разработчика, предпочитающего индивидуальные проекты, есть множество способов самореализации. Для меня, например, приоритетным является создание небольших Telegram-ботов на java. Ведь помимо того, что в процессе разработки всегда можно наглядно проверить работу программы на любом этапе ее реализации, Telegram-боты, на мой взгляд, имеют потребительский потенциал в основном за счет того, что, являясь программой, они не нуждаются в отдельной установке на устройство. Достаточно пользоваться мессенджером Telegram и запустить в нем бот с подходящим функционалом, что, как минимум, экономит ресурсы самого устройства.
Ранее на Хабре я уже делилась с читателями своим опытом самостоятельного создания несложных Telegram-ботов на java, а также небольшими пошаговыми инструкциями по решению отдельных вопросов, возникающих при написании кода. После новогодней разработки очередного чат-бота хочу продолжить сложившуюся традицию и рассказать немного о некоторых нюансах одного из распространенных способов взаимодействия с ботом – принятие и обработка от пользователя запроса с сообщением.
Детализация
Тем, кто так или иначе уже сталкивался с разработкой Telegram-ботов на java, известно, что бот должен уметь отправлять запросы Telegram-серверу и получать от него обновления (updates). В настоящее время существует два способа получения обновлений:
- использование LongPolling (регулярную отправку запрос к серверу Telegram для получения обновлений. Все обновления обрабатываются последовательно, что делает бота очень простым для отладки, а все поведение - предсказуемым),
- использование Webhooks (Telegram сам отправляет запросы по нужному URL).
Поскольку LongPolling используется по умолчанию, я буду рассматривать взаимодействие с ботом на его примере.
Итак, для того, чтобы класс, содержащий логику бота, реализовывал взаимодействие с сервисами Telegram, его необходимо унаследовать от класса TelegramLongPollingBot и реализовать следующие его базовые методы:
- public void onUpdateReceived(Update update);
- public String getBotUsername();
- public String getBotToken().
Каждый раз, когда кто-то отправляет личное сообщение боту, этот метод будет вызываться автоматически, и вы сможете обработать параметр, который содержит сообщение, а также множество другой информации.
Основной функционал моего последнего бота прост: он принимает от пользователя текстовое сообщение с двумя параметрами (вес и рост, указанными целыми цифрами и разделенными одним пробелом), рассчитывает по формуле индекс массы тела (ИМТ) и высылает пользователю результат с характеристикой и краткими рекомендациями. То есть, помимо команд, которые предусмотрены в моем боте, обрабатывается только одно текстовое сообщение от пользователя.
Казалось бы, все предельно просто – достаточно лишь проверить при реализации метода onUpdateReceived, есть ли во входящем обновлении (update) сообщение (метод getMessage()) и есть ли в таком сообщении текст (метод hasText()). Но текст должен быть с определенными параметрами – это должно быть 2 целые цифры, разделенные пробелом. Все остальные запросы должны блокироваться, а пользователю высылаться сообщение об ошибке и повторная просьба корректно направить запрос.
Реализация
Для себя я нашла следующий вариант обработки и запроса:
1. Проверить входящее сообщение на наличие в нем пробелов и, при наличии таковых, разделить строку на части и создать из них массив.
2. В созданном массиве проверить длину такого массива и принадлежность элементов к целым положительным числам и, при соблюдении условий, вызвать метод, в котором производится расчет ИМТ, присвоив его параметрам соответствующие значения элементов массива.
Наиболее оптимальным способом для проверки принадлежности элементов текстового массива к целым положительным числам я выбрала применение регулярных выражений, именно с ними код выглядел компактно и отрабатывал корректно.
Синтаксис регулярных выражений основан на использовании символов <([{\^-=$!|]})?*+.>, которые можно комбинировать с буквенными символами.
Поскольку меня интересовали только целые числа, я использовала следующие символы регулярного выражения:
‘\d’ - соответствует любой одной цифре и заменяет собой выражение [0-9];
‘+’ – частота появления элемента (1 или более цифра в выражении),
и matches() – метод, который возвращает true только тогда, когда вся строка соответствует заданному регулярному выражению.
3. Во всех остальных случаях, не подпадающих под заданные проверки, пользователь должен получать сообщение об ошибке и необходимости корректно ввести запрос.
В итоге, если опустить реализацию методов, участвующих в обработке команд, расчете ИМТ и формировании рекомендаций, передаче данных в базу данных, у меня получилась вот такая реализация метода onUpdateReceived:
@SneakyThrows
@Override
public void onUpdateReceived(Update update) {
// проверка, содержит ли обновление сообщение и содержит ли сообщение текст
if (update.hasMessage() && update.getMessage().hasText()) {
String messageText = update.getMessage().getText();
Long chatId = update.getMessage().getChatId();
Message message = update.getMessage();
User from = message.getFrom();
SendMessage sendMessage = new SendMessage();
sendMessage.setChatId(update.getMessage().getChatId().toString());
if (commandType.types().contains(messageText)) {
commandHandler.onUpdateReceived(update);
// если сообщение с текстом содержит пробел
} else if (messageText.contains(" ")) {
// создаем строковый массив, в котором элементы образуются через разделитель - пробел
String[] weightAntHeight = update.getMessage().getText().split(" ");
// если длина массива 2 элемента, которые соответствуют целым числам
//(те самые нужные нам значения веса и роста),
if (weightAntHeight.length == 2
&& weightAntHeight[0].matches("\\d+")
&& weightAntHeight[1].matches("\\d+")) {
// производим расчет ИМТ, высылаем пользователю результаты и рекомендации, заносим результаты в базу данных
String resultImt = String.format("%.1f", ImtCount.imt(weightAntHeight[0], weightAntHeight[1]));
String resultWithDescription = ImtCount.description(weightAntHeight[0], weightAntHeight[1]);
WriteUser.writeUserIntoDb(LocalDateTime.now().withNano(0),
from.getId(), from.getFirstName()
, resultImt
);
sendMessage.setText(resultWithDescription);
execute(sendMessage);
// во всех остальных случаях выдается сообщение об ошибке и инструкция с правилами направления запроса.
} else {
execute(Sender.sendMessage(chat_id, UNKNOWN + INSTRUCTION));
}
}
else {
execute(Sender.sendMessage(chat_id, UNKNOWN + INSTRUCTION));
}
}
}
Описанный способ может применяться, например, и при регистрации пользователя для формирования параметров обработки логина и пароля.
Резюмирование
Да, статей, посвященный разработке Telegram-ботов, великое множество, но, как показывает мой личный опыт поиска нужной информации, они в большинстве своем однотипны и зачастую не содержат ответов (разъяснений) на практические вопросы. В своих публикациях я делюсь самостоятельно пройденным путем больше с новичками и с теми, кому в принципе как и мне интересна разработка Telegram-ботов.
Надеюсь, этот разбор и реализация обработки текстовых запросов пользователя в проекте, код которого выложен на GitHub, кому-нибудь поможет при разработке своих телеграмм ботов.
Если интересно, как работает мой последний телеграмм бот, то милости прошу: Индекс массы тела.
