@ApiOperation, @apiparam, @Async,@RequestParam

@ApiOperation 어노테이션  : 스웨거 관련 문서 rest api 에 대한 응답을 문서화 하기 위해  제공되는 것으로 단일작업을 설명하는데 사용된다.  작업은 경로와 HTTP 메서드의 고유한 조합이다

내부에 정의된 응답 속성에는 일반 응답 유형이 포함되어야 한다.

---

@Apiparam은 문서 자동화를 위한 스웨거에 쓰이는 어노테이션이고    @RequestParam 은 Http 부터 요청온 정보를 받아오기 위한 스프링 어노테이션이다.

---

@Async : 스프링에서 제공하는 쓰레드 풀을 활용하는 비동기 메서드 지원 어노테이션이다. 

스프링 부트에서는 @EnableAsnyc 어노테이션을 추가하고 비동기로 작동하길 원하는 메서드 위에 @Asnyc 어노테이션을 붙여주면 된다.

- private method 는 사용 불가

- self-invocation 불가 , inner method 사용 불가

- QueueCapacity 초과 요청에 대한 비동기 메서드 호출시 방어 코드 작성