Monday, November 21, 2022

Spring Boot - Annotation Reference - Part 01/b

In continuation of the Part 01/a of this article, Let's continue on our journey of Spring Boot Annotations. So, How much percentage (depth and extense) of Spring Boot Annotations do you think you really know? This includes annotations in all it's glory and the power that they bring via all of it's 'options'. I am sure whatever your answer be, I am sure you will appreciate this quote from Albert Einstein.

'The more I learn, the more I realize how much I don't know.'





[Spring- Stereotype] 
 
@Service 
Service Layer usually holds the core business logic of an application. In Spring, we denote the interface or class that holds the business logic with this annotation.
 package xyz.sumithpuri.spring.boot.annotation.service;  
   
 import java.util.HashSet;  
   
 import org.springframework.stereotype.Service;  
   
 import xyz.sumithpuri.spring.boot.annotation.model.Book;  
   
 /**  
  * @author Sumith Puri  
  *  
  */  
 @Service  
 public class BookServiceImpl implements BookService {  
   
      HashSet<Book> bookList = new HashSet<Book>();  
   
      @Override  
      public HashSet<Book> findAllBook() {  
           if (bookList.isEmpty())  
                return null;  
           else  
                return bookList;  
      }  
   
      @Override  
      public Book findBookByID(long id) {  
           Book book = bookList.stream().filter(b -> b.getId() == id).findAny().orElse(null);  
           return book;  
      }  
     ....  


@Controller 
@RestController
@Controller is a specialized component that is primarily used in the web layer. It is typically used in combination with annotated handler methods based on the RequestMapping annotation. @RestController is annotated with @Controller and is used for web layer request handling.  Types that carry the @RestController annotation are treated as controllers where @RequestMapping methods assume @ResponseBody semantics by default.
   
 import java.util.HashSet;  
   
 import org.springframework.beans.factory.annotation.Autowired;  
 import org.springframework.web.bind.annotation.DeleteMapping;  
 import org.springframework.web.bind.annotation.GetMapping;  
 import org.springframework.web.bind.annotation.PathVariable;  
 import org.springframework.web.bind.annotation.PostMapping;  
 import org.springframework.web.bind.annotation.RequestBody;  
 import org.springframework.web.bind.annotation.RestController;  
   
 import xyz.sumithpuri.spring.boot.annotation.configuration.SBASampleConfigurationProperties;  
 import xyz.sumithpuri.spring.boot.annotation.model.Book;  
 import xyz.sumithpuri.spring.boot.annotation.service.BookServiceImpl;  
   
 /**  
  * @author Sumith Puri  
  *  
  */  
 @RestController  
 public class SBASampleController {  
   
      @Autowired  
      BookServiceImpl bookServiceImpl;  
   
      @Autowired  
      SBASampleConfigurationProperties sbasConfigProps;  
        
   
      @GetMapping("/findall")  
      public HashSet<Book> getAllBook() {  
           return bookServiceImpl.findAllBook();  
      }  
   
      @GetMapping("/findbyid/{id}")  
      public Book geBookById(@PathVariable long id) {  
           return bookServiceImpl.findBookByID(id);  
      }  
     ...  

@Component  
@Component is used to create any Spring managed component. It can be used as a Spring Bean. Any bean with @Bean that is created within a component will have a 'Prototype' scope, as opposed to a 'Singleton' scope of beans that is created within a @Configuration annotated class. @Repository and @Controller are all specialized components
 package xyz.sumithpuri.spring.boot.annotation.component;  
   
 import javax.annotation.PostConstruct;  
   
 import org.springframework.beans.factory.annotation.Autowired;  
 import org.springframework.stereotype.Component;  
   
 import xyz.sumithpuri.spring.boot.annotation.service.SBASampleInterface;  
   
 /**  
  * @author sumith.puri  
  *  
  */  
 @Component  
 public class SpringBootAnnotationComponent {  
   
        
      @Autowired  
      private SBASampleInterface sbaSampleInterfaceImpl;  
        
      @PostConstruct  
      private void postConstruct() {  
           System.out.println("Testing @SpringBootApplication, @Component and @PostConstruct");  
      }  
   
 }  


@Repository 
@Repository is a specialized @Component that is used to mark a class that provides persistence or storage operations. It will provide operations like create, update, retrieve, delete and search type of operations. It is mostly used in conjunction with RDBMS or any other Database 

  
[Spring - REST/Web/MVC]

@RequestMapping
This annotation is from MVC/Web that will associate a given URI with a method in the controller. It can be used in the following format.
 @RequestMapping(method = RequestMethod.PATCH)  

@GetMapping
This annotation is used to map a HTTP GET request to a specific handler method in the controller. It is equivalent to the following alternative.
 @RequestMapping(method = RequestMethod.GET) 

@PostMapping
This annotation is used to map a HTTP POST  request to a specific handler method in the controller. It is equivalent to the following alternative.
 @RequestMapping(method = RequestMethod.POST) 

@DeleteMapping
This annotation is used to map a HTTP DELETE request to a specific handler method in the controller. It is equivalent to the following alternative.
 @RequestMapping(method = RequestMethod.DELETE) 

@PutMapping
This annotation is used to map a HTTP PUT request to a specific handler method in the controller. It is equivalent to the following alternative.
 @RequestMapping(method = RequestMethod.PUT) 


@PatchMapping
This annotation is used to map a HTTP PATCH request to a specific handler method in the controller. It is equivalent to the following alternative.
 @RequestMapping(method = RequestMethod.PATCH) 

@RequestBody
This annotation is used to bind a method parameter/object to incoming request parameters. 

@ResponseBody
This is used inside a controller and signifies that the returned object will be automatically serialized and passed back into the HttpResponse object. Note that if you are using @RestController you may not need to use this as automatically it is a combination of @Controller and @ResponseBody.

@RequestParam
This is used to bind a method parameter directly to a request attribute.  

@RequestHeader
This is used to bind a method parameter directly to a request header.

@RequestAttribute 
This can be used to bind a method parameter to a request attribute that was added from an intermediary layer like filter or interceptor.

@PathVariable

This is used to bind a method parameter from a request template URI. Note that It can be used to bind multiple method parameters.


 package xyz.sumithpuri.spring.boot.annotation.controller;  
   
 import java.util.HashSet;  
   
 import org.springframework.beans.factory.annotation.Autowired;  
 import org.springframework.web.bind.annotation.DeleteMapping;  
 import org.springframework.web.bind.annotation.GetMapping;  
 import org.springframework.web.bind.annotation.PathVariable;  
 import org.springframework.web.bind.annotation.PostMapping;  
 import org.springframework.web.bind.annotation.RequestBody;  
 import org.springframework.web.bind.annotation.RestController;  
   
 import xyz.sumithpuri.spring.boot.annotation.configuration.SBASampleConfigurationProperties;  
 import xyz.sumithpuri.spring.boot.annotation.model.Book;  
 import xyz.sumithpuri.spring.boot.annotation.service.BookServiceImpl;  
   
 /**  
  * @author Sumith Puri  
  *  
  */  
 @RestController  
 public class SBASampleController {  
   
      @Autowired  
      BookServiceImpl bookServiceImpl;  
   
      @Autowired  
      SBASampleConfigurationProperties sbasConfigProps;  
   
      @GetMapping("/findall")  
      public HashSet<Book> getAllBook() {  
           return bookServiceImpl.findAllBook();  
      }  
   
      @GetMapping("/findbyid/{id}")  
      public Book geBookById(@PathVariable long id) {  
           return bookServiceImpl.findBookByID(id);  
      }  
   
      @DeleteMapping("/delete")  
      public void deleteBook() {  
           bookServiceImpl.deleteAllData();  
      }  
   
      @PostMapping("/")  
      public void addBook(@RequestBody Book book) {  
   
           System.out.println("Testing Properties: " + sbasConfigProps.getName() + "; "   
                                                                  + sbasConfigProps.getMail() + "; "  
                                                                  + sbasConfigProps.getYear());  
           bookServiceImpl.addBook(book);  
      }  
 }  
   

(@RestController, @GetMapping, @PostMapping,
@DeleteMapping, @Autowired, @Pathvariable )



[Reference Links]
https://github.com/Buzzardo/spring-docs/blob/master/annotation-cheat-sheet.adoc
https://javasterling.com/java/spring-boot-annotations/


No comments: