스프링과 JPA를 이용한 웹개발_컨트롤러 구현

🤔컨트롤러가 무엇인가요?

• 사용자 요청(input)을 적절히 처리하여 그 결과를 Model(ModelAndView)에 담는 역할
• 컨트롤러를 정의하는 다양한 방법이 존재
• Spring 2.5에서 어노테이션 기반 컨트롤러 등장
  • @RequestMapping, @RequestParam, @ModelAttribute, and so on
• 어노테이션 기반 컨트롤러의 경우 부모 클래스를 상속받거나 인터페이스를 구현할 필요 없이 단순히 하나의 클래스를 정의하면 됨

@Controller
public class HelloWorldController {

@RequestMapping("/helloWorld")
public String helloWorld(Model model) {
	model.addAttribute("message", "Hello World!");
	return "helloWorld";
	}
}

@RequestMapping이 Handler의 역할을 하는 것 !

• /hellowWorld Request가 들어오면 helloWorld 메소드를 실행하게 하는 것

@Controller

컴포넌트 스캔 대상이 되는 빈 중, Controller의 역할을 담당한다는 것을 명시하는 역할을 한다.

• @Component : 컴포넌트 스캔에서 사용
• @Controller : 스프링 MVC 컨트롤러
• @Repository : 스프링 데이터 접근 계층
• @Service : 스프링 비즈니스 로직(특별한 기능이 있는 것은 아니고 빈의 역할을 분명하게 나타내기 위해)

예시

맨 위에 @RequestMapping("/appintments")를 지정해둬서 아래에 @RequestMapping을 사용할 때에는 value를 지정하지 않아도 됨!

value값을 {}로 담아서 그 값을 활용할 수도 있음.

RequestMapping

@RequestMapping 대체: HTTP 종류에 따른 구체적인 명시

• GetMapping
• PostMapping
• PutMapping
• DeleteMapping
• PatchMapping

하나의 RequestMapping으로 다수의 URL을 매핑

• 사용자 입력의 편이성 제공

@RequestMapping({"/welcome","/welcome2"})

Path Variable

@PathVariable

• Spring MVC에서 사용되는 어노테이션으로, URL 경로에서 변수 값을 추출하는데 사용됩니다.
• 주로 RESTful 웹 서비스에서 사용되며, 클라이언트가 전달한 URL의 일부를 컨트롤러 메소드의 매개변수로 받아오는 데에 사용됩니다.
• "localhost:8080/appointments/13"와 같이 요청 URL에 13이라는 자원을 지정할 수 있음
• REST API가 점점 중요해짐 → PathVariable 사용 빈도 증가

value값의 {ownerId}, {petId}는 입력받아야 하는 값이기 때문에 파라미터로 넣고 변수를 찾아서 반환하는 등의 메소드를 실행시켜줄 수 있다.

➕PathVariable이 다수일 경우, Map<>으로 한 번에 받을 수 있음!

앞서 언급한 것처럼 @RequestMapping을 클래스 앞단에 적어 공통 분모를 지정해줄 수 있다.

다양한 메소드 argument 사용

Argument : 함수 혹은 메서드를 호출할 때, 전달 혹은 입력되는 실제 값

Parameter : 함수 혹은 메서드 정의에서 나열되는 변수 명

컨트롤러를 정의할 때, handler 함수 정의에 다양한 파라미터를 사용할 수 있답니다

• HandlerApater는 handler 실행에 필요한 인자들을 미리 만듦
  • @PathVariable: Path(=url로) 변수를 받을 때
  • @RequestParam: 요청 파라미터를 받을 때
  • @RequestBody: 대표적으로 요청 Body에 포함된 JSON과 같은 데이터를 조회할 때 사용
  • @ModelAttribute: 정의한 (getter/setter가 정의된)DTO에 자동 데이터 바인딩
  • @Valid: 입력의 유효성 검사

클라이언트가 요청파라미터에 담을 수 있는 데이터 방식은 두가지!

1. 요청 파라미터 2.HTTP 메시지 바디 어떻게 구분할까?

• 요청 파라미터의 종류
  • 쿼리스트링(=url)
    • Ex) localhost:8080/name=jin&page=20
  • Get 
  • Post
• 요청 파라미터 조회 방법
  • @RequestParam, @ModelAttribute
• HTTP 메시지 바디를 조회하는 방법
  • @RequestBody
    • 클라이언트가 Request에 JSON형식으로 데이터를 보내면 이 어노테이션으로 조회하면됨!

@RequestParam

➕Model model 파라미터는 Spring MVC에서 사용되는 Model 객체입니다. 이 Model 객체는 컨트롤러에서 뷰로 데이터를 전달하는 데 사용됩니다.

Model을 파라미터 값으로 넣고, 위의 Pet 매개변수를 "pet"에 담아 html에서 pet을 사용해 데이터를 뿌려줄 수 있게 됩니다.

@RequestBody

HTTP 메시지 바디에 있는 내용을 body라는 파라미터에 적용이 된다.

@ModelAttribute

폼 데이터 바인딩 : 주로 HTML 폼에서 전송된 데이터를 스프링 컨트롤러의 메소드에 바인딩할 때 사용됩니다. 폼 데이터를 자바 객체로 변환하고 이를 컨트롤러 메소드에서 사용할 수 있게 합니다.

데이터 전달: 컨트롤러 메소드에서 뷰로 데이터를 전달할 때 사용됩니다. @ModelAttribute를 이용하여 메소드의 반환값으로 모델에 데이터를 추가하면, 해당 데이터는 자동으로 뷰로 전달되어 화면에 표시할 수 있습니다.

모델 객체 생성: @ModelAttribute를 사용하면 해당 어노테이션이 붙은 메소드가 먼저 실행되어 객체를 생성하고 초기화할 수 있습니다. 이를 통해 컨트롤러 내에서 중복되는 코드를 줄이고 객체를 미리 초기화할 수 있습니다.

• 메소드(Method Level)와 메소드의 인자(Method Parameter Level)에 사용 가능
  • 메소드 레벨 → 해당 컨트롤러 내의 모든 @RequestMapping 메소드의 Model에 삽입되어 반환
    • MyController에 @RequestMapping 어노테이션이 붙은 메소드는 모두 Model에 삽입되어 반환된다는 뜻!
  • @RequestMapping가 붙은 핸들러의 실행 전에 @ModelAttribute가 붙은 메소드가 실행됨

이걸 왜 해야하냐 ..?!?

• Model 객체에 데이터를 저장해 view에 보여주기 위함.

속성 하나 추가 

• View에 전달해야할 값이 하나일 경우에는, ModelAttribute를 메소드레벨에 정의해도 됩니다!
• 그러면 자연스럽게 return 값이 @ModelAttribute("이름")에 바인딩 됩니다.

여러개의 속성 추가

• @ModelAttribute를 선언하고 아래에 model.addAttribute를 사용해주면 됩니다.

+) 참고로 저는 이해가 안갔던 부분이라 여러분들도 그럴까봐 적어봅니다..

@GetMapping("/user/{userId}")
public String getUserProfile(@PathVariable Long userId, @ModelAttribute("user") User user) {
    // userId를 사용하여 사용자 프로필 정보를 가져오는 로직
    user = userService.getUserById(userId);
    return "userProfile";
}

HTTP 요청 (GET)       ----->    컨트롤러 메소드 (@GetMapping("/user/{userId}"))
                          |
                          |       @PathVariable로 userId 값을 받음
                          |
                          V
서비스 레이어 (Service)  ----->    userId를 사용하여 사용자 정보 조회
                          |
                          |
                          V
데이터베이스 (Database) ----->    userId에 해당하는 사용자 정보 조회
                          |
                          |
                          V
서비스 레이어 (Service)  ----->    사용자 정보를 컨트롤러 메소드로 반환
                          |
                          |
                          V
컨트롤러 메소드         ----->    @ModelAttribute로 사용자 정보를 받아옴
                          |
                          |
                          V
모델에 추가             ----->    받아온 사용자 정보를 모델에 추가
                          |
                          |
                          V
뷰 (View)               ----->    사용자 프로필 페이지로 이동

이렇게 과정이 일어나는데, 저는@PathVariable Long userId, @ModelAttribute("user")) 매개변수가 같이 있어서 동시에 실행되는 줄 알았더니 메소드의 매개변수는 메소드가 호출될 때만 해당 값이 전달되어 실행된다네요 ? 

⏩그래서 매개변수는 호출될 때 순차적으로 실행된다고 합니다 !

띠라서 @PathVariable로 추출된 값이 먼저 실행되고, @ModelAttribute로 지정된 매개변수가 나중에 실행됩니다.

나는 바보야 ..😂

메소드는 다양한 리턴타입을 사용할 수 있다.

• ModelAndView object: 모델과 뷰 전달
• Model object : 모델 전달
• Map object : 모델과 뷰 이름 전달
• View object : 뷰 이름 전달
• String :
  • @Controller → return 타입이 view의 논리 이름이다.(ex) jsp파일이름)
  • @RestController → return 타입이 데이터
• void : 현재 호출한 url의 경로로 뷰를 찾음
  • (요청: /person/new, 실행: templates/person/new.html

만약에 return타입을 String으로 그냥 반환하고 싶다면?

@RequestMapping(value = "/something", method = RequestMethod.PUT)
@ResponseBody
public String helloWorld() {
	return "Hello World";
}

@ResponseBody annotation을 사용하고 String으로 타입을 지정해주면, 그냥 Hello world라는 문자열이 반환된답니다~

만약에 Http의 Header을 조회하고 싶다면?

HttpEntity<?>

• @RequestBody와 @ResponseBody의 기능과 더불어 헤더 정보까지 조회 가능하다.

@RequestMapping("/something")
public ResponseEntity<String> handle(HttpEntity<byte[]> requestEntity) throws UnsupportedEncodingException {
    String requestHeader = requestEntity.getHeaders().getFirst("MyRequestHeader"));
    byte[] requestBody = requestEntity.getBody();
    // do something with request header and body
    HttpHeaders responseHeaders = new HttpHeaders();
    responseHeaders.set("MyResponseHeader", "MyValue");
    return new ResponseEntity<String>("Hello World", responseHeaders, HttpStatus.CREATED);
}