LazyBot

LazyBot

LazyBot é uma estrutura de código aberto em desenvolvimento ativo, projetada para :

• Reduza o nível de entrada no desenvolvimento de bots de telegrama;
• Dê uma certa forma ao desenvolvimento de bots de telegrama;
• Introduzir padrões para criação de bots de telegrama em ambiente Java.

Esses objetivos são alcançados pelo fato de que, ao criar bots de telegramas usando a estrutura LazyBot :

• Você não precisa mais aprender a API do Telegram Bot;
• Para descrever a funcionalidade do seu bot você utiliza um arquivo xml cuja estrutura deve corresponder a bot.xsd;
• Possui pontos de extensão específicos com os quais você pode adicionar funcionalidades para atender às suas necessidades sem quebrar a estrutura original.

Repositórios adicionais:

• O java-telegram-bot-api é usado para obter dados do telegrama.
• JaxpToObjects é usado para mapear elementos xml para classes Java.

Download

JAR na página de lançamento

Exemplo de um bot simples

Neste exemplo simples, vamos criar um bot que será capaz de responder a determinados comandos enviados a ele pelo usuário através de simples mensagens de texto, menus e ainda ser capaz de retornar às respostas anteriores do bot.

bom.xml:

<? xml version = " 1.0 " encoding = " UTF-8 " ?>
< Bot token = " 123 " xmlns = " http://lazybot.ru "
     xmlns : xsi = " http://www.w3.org/2001/XMLSchema-instance "
     xsi : schemaLocation = " http://lazybot.ru bom.xsd " >
    < Replies after = " /start " >
        < Reply >
            < Message >
                < Text >Hello world!</ Text >
            </ Message >
        </ Reply >
        < Reply >
            < Menu >
                < Text >This is a sample menu</ Text >
                < ButtonsArray >
                    < Button >
                        < ButtonLabel >Button1</ ButtonLabel >
                        < Callback >butt1</ Callback >
                    </ Button >
                </ ButtonsArray >
            </ Menu >
        </ Reply >
    </ Replies >
    < Replies after = " butt1 " >
        < Reply >
            < Menu >
                < Text >You pressed "Button1"</ Text >
                < ButtonsArray >
                    < BackButton >
                        < ButtonLabel >Back</ ButtonLabel >
                        < Count >1</ Count >
                    </ BackButton >
                </ ButtonsArray >
            </ Menu >
        </ Reply >
    </ Replies >
</ Bot >

Aplicativo Java Bot:

 // Create a new LazyBot object
LazyBotTG botTG = new LazyBotTG ( inputStream );
// or
LazyBotTG botTG = new LazyBotTG ( "filePath" );

// Running the bot
botTG . start ();

// Basically, you don't have to do anything else.
// It's easy enough :)

Como você pode ver, conseguimos criar um bot de telegrama simples usando algumas linhas em um arquivo xml e em nosso aplicativo Java. Você pode pensar que até isso já é demais, mas vejamos as coisas que conseguimos evitar graças ao uso do framework LazyBot :

• Abra e comece a estudar a documentação da API do Telegram Bot;
• Vá para a implementação do java-telegram-bot-api;
• Pense na arquitetura do nosso código de forma que no futuro ele seja facilmente alterável;
• Refatore a estrutura do código que conseguimos criar, mas percebemos que não nos serviria no futuro.

No entanto, no futuro poderemos adicionar/alterar algumas linhas em nosso arquivo xml e ao mesmo tempo adicionar novas funcionalidades para o bot ou alterá-lo completamente.

Documentação

A documentação sobre elementos xml e detalhes da implementação da estrutura é armazenada na seção wiki.

Licença

Apache-2.0