O tipo de aplica\u00e7\u00e3o que podemos criar com base nesta estrat\u00e9gia n\u00e3o chamaria sequer de microservi\u00e7os, mas nanoservi\u00e7os<\/em>. Aplica\u00e7\u00f5es realmente \u00fateis, compostas por um n\u00famero muito pequeno de endpoints (um, dois no m\u00e1ximo) que s\u00e3o simples e podem quebrar diversos galhos na sua infraestrutura.<\/p>\n\n\n\n N\u00e3o espere que este post v\u00e1 lhe servir de guia completo para este tipo de solu\u00e7\u00e3o: a ideia \u00e9 apenas apresentar a voc\u00eas esta possibilidade, mas n\u00e3o fiquem tristes, colocarei links que lhes ajudar\u00e3o a aprender mais sobre o assunto durante e ap\u00f3s sua leitura.<\/p>\n\n\n\n \u00c9 muito curioso que com tantos tutoriais, cursos e livros sobre Spring e Spring Boot (me salvo nesta: meu primeiro livro foi sobre o Spring Framework, n\u00e3o Spring Boot!) pouca gente mencione esta ferramenta. Talvez seja por que todo mundo pense da mesma forma na hora de escrever… talvez por que seja algo que n\u00e3o envolva a linguagem Java, mas sim Groovy… n\u00e3o entendo (mas tenho minhas suspeitas).<\/p>\n\n\n\n Mas fato \u00e9 que apesar de pouco falado o Spring CLI existe desde que o Boot foi lan\u00e7ado. E era inclusive usado na \u00e9poca para demonstrar o poder do framework como algo super produtivo, bem na mesma pegada que o povo demonstrava o Node.js quando saiu.<\/p>\n\n\n\n Se voc\u00ea j\u00e1 programou em Grails ou Express o Spring CLI lhe parecer\u00e1 familiar. \u00c9 uma interface de linha de comando (C<\/strong>ommand L<\/strong>ine I<\/strong>nterface) que voc\u00ea instala e pode executar as seguintes fun\u00e7\u00f5es:<\/p>\n\n\n\n O recurso ainda est\u00e1 ativo (e em cont\u00ednuo desenvolvimento!) no Spring Boot e voc\u00ea pode ler sua documenta\u00e7\u00e3o neste link<\/a> em sua vers\u00e3o mais atual, ou seja, se \u00e9 mantido at\u00e9 hoje com certeza muita gente usa!<\/p>\n\n\n\n H\u00e1 duas formas de fazer isto: a f\u00e1cil, que ensino aqui e outra que voc\u00ea pode ver no link que mencionei agora h\u00e1 pouco. A f\u00e1cil e que recomendo \u00e9 usando o Sdkman (n\u00e3o conhece? Escrevi um guia a respeito que voc\u00ea pode ler aqui: https:\/\/www.itexto.com.br\/guias\/?guia=configurando-seu-ambiente-de-desenvolvimento-java-com-sdkman<\/a> ).<\/p>\n\n\n\n Execute o comando a seguir com o sdkman:<\/p>\n\n\n\n Para testar sua instala\u00e7\u00e3o execute o comando a seguir:<\/p>\n\n\n\n Ser\u00e1 apresentada para voc\u00ea a vers\u00e3o instalada. Mencionei aqui que vamos usar Groovy, certo? Voc\u00ea n\u00e3o precisa ter a linguagem instalada em seu computador. O Spring CLI j\u00e1 inclui tudo o que voc\u00ea precisa para poder trabalhar.<\/p>\n\n\n\n Cabe aqui um “Ol\u00e1 mundo” para mostrar a simplicidade do c\u00f3digo que escrevemos para termos um “nano servi\u00e7o” em execu\u00e7\u00e3o com o Spring CLI. Nosso pimeiro “Ol\u00e1 mundo” pode ser visto a seguir:<\/p>\n\n\n\n Repare que n\u00e3o h\u00e1 instru\u00e7\u00f5es import<\/strong>. N\u00e3o \u00e9 necess\u00e1rio importar as classes: o pr\u00f3prio CLI vai import\u00e1-las para voc\u00ea de forma autom\u00e1tica. <\/p>\n\n\n\n Note que \u00e9 apenas uma classe Groovy padr\u00e3o com algumas anota\u00e7\u00f5es: as mesmas que usamos ao implementar endpoints com o Spring tradicional: @RestController<\/strong> pra informar que a classe \u00e9 um controlador e @RequestMapping<\/strong> para informar que aquele m\u00e9todo disponibiliza um endpoint.<\/p>\n\n\n\n E como fazemos para executar este script? Usando o comando spring novamente.<\/p>\n\n\n\n A sua linha de comando ir\u00e1 apresentar uma sa\u00edda que se voc\u00ea j\u00e1 programou com Spring com certeza j\u00e1 conhece:<\/p>\n\n\n\n E se acessar o endere\u00e7o http:\/\/localhost:8080, o que voc\u00ea vai ver?<\/p>\n\n\n\n Paramos por aqui com este exemplo. Vamos para algo mais \u00fatil.<\/p>\n\n\n\n No exemplo anterior voc\u00ea viu essencialmente como usando Groovy criamos um nano servi\u00e7o com Spring Boot, certo? Se \u00e9 Spring Boot, podemos usar todos<\/strong> dos seus recursos como o Actuator<\/a>, por exemplo: que nos permite monitorar os servi\u00e7os que implementamos.<\/p>\n\n\n\n Ent\u00e3o que tal implementarmos aqui um micro servi\u00e7o que verifique se tudo est\u00e1 ok no nosso servidor? Ele poderia usar as valida\u00e7\u00f5es padr\u00f5es do Actuator<\/a> e ainda implementar nossas pr\u00f3prias regras de valida\u00e7\u00e3o. Imagine que por alguma raz\u00e3o \u00e9 necess\u00e1ria a presen\u00e7a do arquivo felicidade.txt<\/em> no diret\u00f3rio home do usu\u00e1rio respons\u00e1vel por executar a aplica\u00e7\u00e3o. Como far\u00edamos isto?<\/p>\n\n\n\n J\u00e1 que estamos falando de Spring<\/strong>, ser\u00e1 que nossos scripts podem ter seus pr\u00f3prios beans? A resposta \u00e9 sim: observe o c\u00f3digo que escrevi (est\u00e1 tudo em um mesmo arquivo chamado monitor.groovy<\/em>):<\/p>\n\n\n\n H\u00e1 algumas coisas interessantes aqui que voc\u00ea deve prestar aten\u00e7\u00e3o. Talvez voc\u00ea n\u00e3o conhe\u00e7a esta anota\u00e7\u00e3o: @Grab<\/strong>. Ela faz parte de um recurso incr\u00edvel<\/strong> do Groovy chamado Grape<\/a>. Enquanto na maior parte das aplica\u00e7\u00f5es voc\u00ea usa solu\u00e7\u00f5es como Maven ou Gradle para resolver as suas depend\u00eancias, como voc\u00ea faria se precisasse escrever apenas um script? Faria sentido ter um arquivo pom.xml ou build.gradle s\u00f3 para execut\u00e1-lo? N\u00e3o! Se voc\u00ea incluir a anota\u00e7\u00e3o @Grab do Groovy em seu script, ele ir\u00e1 incluir estas depend\u00eancias no classpath de forma autom\u00e1tica durante a execu\u00e7\u00e3o: lindo, n\u00e9?<\/p>\n\n\n\n No caso, eu precisei incluir as depend\u00eancias do Actuator no projeto e importar duas classes para implementar o nosso HealthIndicator: Health e… HealthIndicator.<\/p>\n\n\n\n E dali pra baixo voc\u00ea que j\u00e1 conhece o Spring n\u00e3o ver\u00e1 novidade alguma: temos um componente e um controlador. Mas observou que este controlador \u00e9 uma classe vazia sem nenhum endpoint exposto? Precisamos dela para que o Spring CLI execute nossa aplica\u00e7\u00e3o. Experimente executar o script acima sem o controlador para ver o que ocorre.<\/p>\n\n\n\n Com nosso c\u00f3digo pronto, basta executar agora:<\/p>\n\n\n\n E acessando http:\/\/localhost:8080\/actuator\/health<\/em> temos a seguinte sa\u00edda:<\/p>\n\n\n\n Mas se voc\u00ea j\u00e1 usou o Actuator antes deve ter observado que esta n\u00e3o \u00e9 a sa\u00edda padr\u00e3o<\/strong> do mesmo. Ent\u00e3o, aonde coloquei as configura\u00e7\u00f5es? Simples: voc\u00ea pode seguir uma conven\u00e7\u00e3o: se no diret\u00f3rio em que seu script se encontra existir uma pasta chamada config<\/em>, basta deixar ali um arquivo application.properties<\/em> ou application.yml<\/em>. Seguem as minhas configura\u00e7\u00f5es:<\/p>\n\n\n\n Voc\u00ea tamb\u00e9m pode passar suas configura\u00e7\u00f5es por linha de comando ou vari\u00e1veis de ambiente, exatamente como faria em uma aplica\u00e7\u00e3o baseada em Spring Boot<\/strong> por que, bem: esta \u00e9 uma aplica\u00e7\u00e3o baseada em Spring Boot<\/strong>. Sugiro a leitura deste post<\/a> do Baeldung sobre o Spring CLI que descreve em maiores detalhes como estas configura\u00e7\u00f5es se aplicam.<\/p>\n\n\n\n Claro! Como voc\u00ea faz para executar a aplica\u00e7\u00e3o ent\u00e3o? Bem simples.<\/p>\n\n\n\n Ou qualquer outra express\u00e3o que seu shell aceite para a sele\u00e7\u00e3o de m\u00faltiplos arquivos.<\/p>\n\n\n\n Executar o seu script com o CLI \u00e9 bastante \u00fatil no ambiente de desenvolvimento, mas em produ\u00e7\u00e3o n\u00e3o \u00e9 uma boa ideia. Sendo assim, como voc\u00ea faz para implantar a sua aplica\u00e7\u00e3o? Basta usar o comando spring jar<\/strong> com a seguinte sintaxe essencial:<\/p>\n\n\n\n Nosso \u00faltimo exemplo poderia ser empacotado portanto com o comando a seguir:<\/p>\n\n\n\n Feito: agora basta executar o comando java -jar monitor.jar<\/strong> e nossa aplica\u00e7\u00e3o estar\u00e1 dispon\u00edvel. Neste arquivo estar\u00e3o todas as depend\u00eancias necess\u00e1rias para a execu\u00e7\u00e3o do projeto. <\/p>\n\n\n\n Apenas por curiosidade, o arquivo gerado para o nosso monitor tinha 24Mb de tamanho. Um overhead significativo para algo t\u00e3o pequeno, huh?<\/p>\n\n\n\n N\u00e3o recomendo o uso do Spring CLI para a cria\u00e7\u00e3o de aplica\u00e7\u00f5es complexas, isto \u00e9, compostas por uma quantidade significativa de scripts (3 ou mais). Se voc\u00ea quer usar Groovy como linguagem no desenvolvimento de aplica\u00e7\u00f5es baseadas em Spring Boot, saiba que ele oferece total suporte<\/strong>, sendo inclusive uma das op\u00e7\u00f5es quando criamos um novo projeto no site Spring Initializr<\/a>:<\/p>\n\n\n\n Mas existe um nicho de aplica\u00e7\u00f5es para o qual este tipo de desenvolvimento cai como uma luva. \u00c9 algo para o qual eu j\u00e1 uso Node.js faz um bom tempo inclusive: consiste em aplica\u00e7\u00f5es que sejam essencialmente utilit\u00e1rias, isto \u00e9, que desempenhem uma \u00fanica fun\u00e7\u00e3o<\/strong> e cuja intera\u00e7\u00e3o com as mesmas se d\u00ea atrav\u00e9s da disponibiliza\u00e7\u00e3o de um conjunto \u00ednfimo de endpoints. Seguem alguns exemplos:<\/p>\n\n\n\n Podem ser tamb\u00e9m simplesmente aplica\u00e7\u00f5es compostas por um \u00fanico endpoint. Fiz uma prova de conceito, por exemplo, para o \/dev\/All<\/a> que era a implementa\u00e7\u00e3o do RSS do site e funcionou muito bem. Resumindo: \u00e9 uma ferramenta para a constru\u00e7\u00e3o de microservi\u00e7os (eu diria nano<\/em>) que sejam realmente<\/strong> pequenos.<\/p>\n\n\n\n Achou legal esta possibilidade? Quer se aprofundar a respeito? Ent\u00e3o seguem alguns links que me ajudaram e com certeza v\u00e3o te ajudar tamb\u00e9m.<\/p>\n\n\n\n Documenta\u00e7\u00e3o oficial do Spring CLI<\/strong> – https:\/\/docs.spring.io\/spring-boot\/docs\/current\/reference\/html\/spring-boot-cli.html#cli-multiple-source-files<\/a> <\/p>\n\n\n\n Introduction to Spring Boot CLI – Baeldung<\/strong> – excelente texto por sinal – https:\/\/www.baeldung.com\/spring-boot-cli<\/a><\/p>\n\n\n\nSpring CLI?<\/h2>\n\n\n\n
Instalando<\/strong> o Spring CLI<\/h3>\n\n\n\n
sdk install springboot 2.2.2.RELEASE<\/pre>\n\n\n\n
spring --version<\/pre>\n\n\n\n
Nosso primeiro “Ol\u00e1 mundo!”<\/h2>\n\n\n\n
@RestController\nclass OlaMundo {\n @RequestMapping(\"\/\") \n String olaMundo() { \n \"Que neg\u00f3cio simples!\"}\n}<\/pre>\n\n\n\nspring run ola-mundo.groovy<\/code><\/p>\n\n\n\n![\"\"](\"https:\/\/i1.wp.com\/www.itexto.com.br\/devkico\/wp-content\/uploads\/2020\/01\/image.png?fit=800%2C344&ssl=1\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.itexto.com.br\/devkico\/wp-content\/uploads\/2020\/01\/image-1.png\")
<\/figure>\n\n\n\nUm exemplo um pouco mais \u00fatil: monitorando o servidor usando Groovy e Actuator<\/h2>\n\n\n\n
@Grab(\"spring-boot-starter-actuator\")\n\nimport org.springframework.boot.actuate.health.Health;\nimport org.springframework.boot.actuate.health.HealthIndicator;\n\n@Component\nclass FelicidadePresente implements HealthIndicator {\n public Health health() {\n def arquivo = new File(\"${System.getProperty('user.home')}\/felicidade.txt\")\n arquivo.exists() ? Health.up().build() : Health.down().withDetail(\"infeliz\", \"Servidor infeliz\").build()\n }\n}\n\n@RestController\nclass Monitor {\n\n \n}<\/pre>\n\n\n\nspring run monitor.groovy<\/pre>\n\n\n\n
![\"\"](\"https:\/\/www.itexto.com.br\/devkico\/wp-content\/uploads\/2020\/01\/image-2.png\")
<\/figure>\n\n\n\nMas e as configura\u00e7\u00f5es?<\/h3>\n\n\n\n
management.endpoints.web.exposure.include=*\nmanagement.endpoint.health.show-details=always<\/pre>\n\n\n\n
Minha aplica\u00e7\u00e3o pode ter mais de um arquivo de script?<\/h2>\n\n\n\n
spring run *.groovy<\/pre>\n\n\n\n
Gerando um arquivo JAR execut\u00e1vel<\/h2>\n\n\n\n
spring jar [nome do arquivo .jar] [scripts que comp\u00f5em sua aplica\u00e7\u00e3o]<\/pre>\n\n\n\n
spring jar monitor.jar monitor.groovy<\/pre>\n\n\n\n
Aplica\u00e7\u00f5es mais pr\u00e1ticas<\/h2>\n\n\n\n
![\"\"](\"https:\/\/www.itexto.com.br\/devkico\/wp-content\/uploads\/2020\/01\/image-3.png\")
<\/figure>\n\n\n\nPara saber mais<\/h2>\n\n\n\n