Se nos pide desarrollar una calculadora con Spring Boot que realice las operaciones de suma y resta de dos operandos, teniéndose en cuenta que podrá realizar otras operaciones más complejas en el futuro.
Inicialmente tendremos que crear un Controlador de tipo REST que implemente los metodos propios para la suma y la resta, y a su vez un servicio que lleve implementada la operativa aritmética, que invocará el controlador REST.
Para esto la calculadora construida contiene 1 controlador, que en base a la operacion que viaja ahora en la request invocar al servicio que implemente la operacion de forma dinámica.
Para añadir operaciones nuevas a la calculadora, solo es necesario añadir el servicio que la implementa tal y como pueden verse las clases creadas en el package sanitas.example.Calculator.service.impl además del test correspondiente desarrollado bajo TDD. Además será necesario enviar en la petición la cadena que represente dicha operacion ("sumar" para sumar, "restar" para restar..) Dentro de cada servicio de operacion se define dicho valor.
Para el desarrollo del servicio solicitado, se han usado las dependencias de spring-boot-starter-web, que provee de las librerías necesarias para el desarrollo de interfaces REST, y además las utilidades de DevTools que aportan algunas caracteristicas interesantes como la publicación de codigo en caliente, etc etc.
Tal y como se ha solicitado tambien se hace uso de JUNIT5 para la ejecucion de los tests, que seran desarrollados bajo metodología TDD (Test Driven Development)
Nuestra APP es un servicio REST pero no RESTFUL ya que no se realizan operaciones de insercion, borrado o escritura, sino solo lectura. Los controladores tanto básico como para operaciones más complejas aplican el principio de única responsabilidad y dejan toda la operativa en un servicio gestionado por Spring que es el que realiza la lógica de operaciones matemáticas.
Se ha decidio usar POST para las peticiones por comodidad y por frecuencia de uso, igualmente podrían haberse usado peticiones HTTP GET con parámetros para recepcionar los datos en la invocacion de los metodos de los controladores con @Requestparam en vez de @RequestBody que es más propio de JSON.
Al ser un controlador REST, se ha adaptado a Tracer para que imprima el json de respuesta a devolver por la API, de forma que siempre se tracee cualquier resultado de la operacion tras realizar las invocaciones oportunas.
Para la construcción del JAR de la APP, solo tendremos que clonar el repo gitHub y ejecutar: mvn clean install
Esto nos construirá el JAR 'Calculator-1.0.0.jar' en la carpeta target.
En la propia carpeta en la que se generó el JAR, ejecutar bajo consola: java -jar Calculator-1.0.0.jar
La documentacion de los metodos expuestos en la API se encontrará una vez lanzada la app en: http://localhost:8080/calculator/swagger-ui.html