Spring Boot: conociendo las anotaciones más importantes (2da parte)

Spring Boot es una herramienta de desarrollo web que ha hecho la vida más fácil a los desarrolladores. Las configuraciones complejas y tediosas no tienen cabida, ya no más. Las anotaciones han venido en nuestro auxilio.

En el anterior post vimos una lista de las anotaciones más usadas. Ahora veremos ejemplos de su uso.

Recordemos el formato de una anotación:

@MyAnnotation

Una anotación puede estar en el método de una clase, en una propiedad o atributo o en una clase.

En una clase (@MyAnnotationClass):

@MyAnnotationClass
public class MyClass{

}

En una propiedad o atributo de clase (@MyAnnotationProps):

@MyAnnotationClass
public class MyClass{

   @MyAnnotationProps
   private String name;

}

En un método (@MyAnnotationMethod):

@MyAnnotationClass
public class MyClass{

   @MyAnnotationProps
   private String name;


   @MyAnnotationMethod
   public String doSomething(){
       return null;
   }

}

Empecemos con la anotación @Autowired.

Anotación: @Autowired

Paquete: org.springframework.beans.factory.annotation

   @Autowired
   private ProductService productService;

Esta anotación nos ayuda a inyectar dependencia. En este caso tenemos una clase tipo service llamada ProductService, la cual será inyectada en la clase.

Continuemos con la anotación @Bean.

Anotación: @Bean

Paquete: org.springframework.context.annotation

@Bean 
public ProductBean myBean(){ 
   return new ProductBean();
}

Esta anotación indica que un método genera un Bean para ser administrado por el contenedor de Spring Framework.

Continuemos con la anotación @Component.

Anotación: @Component

Paquete: org.springframework.stereotype

@Component
public class ProductComponent{
  
  @Bean 
  public ProductBean myBean(){ 
     return new ProductBean();
  }
 
}

Usamos esta anotación como una forma de registrar los objetos, en este caso los Beans.

Ahora con @Configuration.

Anotación: @Configuration

Paquete: org.springframework.context.annotation

@Configuration
public class ProductConfiguration{
  
  // Aqui ocurre la magia
 
}

Esta anotación es la encargada de definir que la clase es una clase de configuración.

Anotación: @Controller

Paquete: org.springframework.stereotype

@Controller
public class ProductController{
  
  // Aquí definimos los métodos HTTP
 
}

Se usa para marcar una clase como un controlador MVC, manejando solicitudes HTTP y definiendo endpoints para la lógica de la aplicación web.

Veamos las anotaciones @RequestMapping, @GetMapping, @PostMapping, @PutMapping y @DeleteMapping todos del paquete org.springframework.web.bind.annotation en una clase @RestController.

@RequestMapping("/api")
@RestController
public class ProductController{
  
    @GetMapping("/get/{id}")
    public Product getObject(@PathVariable Long id){
        return ProductService.getByid(id);
    }
    
    @PostMapping("/create")
    public Product create(@RequestBody Product product){
        System.out.println("Objeto Product creado!!");
        return ProductService.create(product);
    }

    @PutMapping("/update")
    public Product update(@RequestBody Product product){
        System.out.println("Objeto Product actualizado!!");
        return ProductService.update(product);
    }

    @DeleteMapping("/delete/{id}")
    public void delete(@PathVariable Long id){
        System.out.printf("Objeto Product con id %d sera borrado\n",id);
        ProductService.delete(id);
    }
 
}

Estas anotaciones se usan para mapear solicitudes HTTP como GET, POST, PUT y DELETE.

Anotación: @Service

Paquete: org.springframework.stereotype

@Service
public class ProductService{
  
  @Autowired 
  private ProductRepository productRepository;

  // Aquí ocurre la magia
}

Esta anotación nos sirve para marcar una clase como servicio.

Anotación: @Repository

Paquete: org.springframework.stereotype

@Repository
public class ProductRepository implements ObjectRepository<Product> {

   // Aquí ocurre la magia
}

Esta anotación nos sirve para marcar una clase como un componente de acceso a datos. No confundir con la interface JpaRepository, cuya funcionalidad es similar.

Hay muchas otras anotaciones que nos sirven para mapear funcionalidad a nuestras clases, propiedades y métodos. Puedes consultar la documentación oficial: https://docs.spring.io/spring-framework/docs/current/javadoc-api/

Nota: ¡Es el post número 333 del blog!

https://codemonkeyjunior.wordpress.com/2020/12/12/anotaciones-importantes-de-spring-framework-spring-boot/
https://www.arquitecturajava.com/spring-autowired-y-la-inyeccion-de-dependencias/
https://www.arquitecturajava.com/spring-bean-y-su-uso/
https://www.digitalocean.com/community/tutorials/spring-repository-annotation