[spring] 스프링으로 회원가입 기능 만들기(feat. 스프링 개념)

스프링으로 회원가입 기능 만들기(feat. 스프링 개념)

---

스프링 공부하면서 정리한 내용 입니다 !
오류가 있다면 댓글로 남겨주세요 :)

 

[기본 개념]
1. MVC 패턴

2. DB 통신 API

3. 서버 템플릿 엔진

4. redirect, forward

5. 프레임워크, 라이브러리

 

[회원가입 기능]
6. 로컬서버 연결 및 파일 구성
7. Controller
8. DTO
9. Entity
10. Service
11. Repository
 
본 포스팅은 데이터베이스 연결까지 환경 설정이 되어있다는가정 하에 작성하였고, 
UI보다는 기능적인 부분에 집중하여 코드를 작성했습니다.

---

1. MVC 패턴

Model (데이터), View (화면), Controller (처리) 로 구성된 패턴 입니다.

 

로그인 시 "~님 반갑습니다!" 라는 문구는 어떻게 만들어진걸까요?

사용자가 입력한 정보를 model에 담아서 view를 통해 사용자에게 보여줘야 하는데,

이때 controller가 둘 사이에서 전달해주는 역할을 합니다.

 

2. DB 통신 API

만약 우리가 입력한 정보를 데이터베이스에 저장하고 싶다면 어떻게 할까요?

이때 데이터베이스 통신 API를 사용하여 데이터베이스에 정보를 저장할 수 있습니다.

 

- JDBC

직접 쿼리를 작성하여 데이터베이스와 통신하는 기술입니다.

 

- JPA

데이터베이스와 객체를 매핑하는 기술입니다.

ORM으로 직접 SQL 구문을 사용하지 않고,

객체와 데이터베이스의 스키마를 매핑할 수 있습니다.

 

Repository를 구현할 때 JpaRepository와 CrudRepository를 활용할 수 있는데,

간단 CRUD 작업 뿐만 아니라 JPA 기능 등을 사용한다면

JpaRepository를 사용하면 됩니다.

 

3. 서버 템플릿 엔진

사용자의 화면에 서버로부터 정보를 얻고 싶다면 어떻게 할까요?

지정된 템플릿 양식과 데이터가 합쳐져서 html 문서를 만들어주는 소프트웨어인

서버 템플릿 엔진을 활용하면 됩니다.

여러 종류가 있는데 그 중에서 저는 주로 thymleaf를 사용하고 있습니다.

 

- JSP

- Thymleaf

- Mustache

 

4. redirect, forward

- redirect

데이터베이스에 변화가 생기는 작업을 했을 때, 사용합니다.

 

- forward

일반적으로 페이지를 이동할 때, 사용합니다.

 

5. 프레임워크, 라이브러리

프로그램의 주도성이 누구에게 있는가에서 차이가 있습니다.

 

- 프레임워크

특정 애플리케이션의 기본 구조와 흐름을 제공

 

- 라이브러리

개발자가 필요한 기능을 호출하여 사용하는 도구

---

6. 로컬 서버 연결 및 파일 구성

저는 MVC 패턴을 활용하여 프로젝트를 진행하기 위해
controller, dto, entity, repository, service 5개의 디렉터리로 나눴습니다.
 
- controller
사용자의 HTTP 요청을 처리한다.
해당 요청에 대한 응답을 반환한다.
 
- dto
사용자가 입력한 정보이다.
controller와 service 간에 데이터를 전달할 때 사용된다.
 
- entity
데이터베이스에 실제 저장되는 객체이다.
 
- repository
데이터베이스와 관련된 작업을 수행한다.
저장, 삭제, 가져오기 등등..
 
- service
controller에서 요청을 받고, 그 요청에 대한 실제 작업을 수행한다.
 
우선, 로컬 서버에 연결이 잘 되는지부터 확인해봅시다.

 
@GetMapping("/") 코드는 HTTP GET 메서드로 접근하는 '/' 경로에 대한 핸들러 메서드를 정의합니다.
return "index"; 코드는 spring이 "index"라는 이름의 view를 찾아서 사용자에게 반환합니다.
일반적으로 뷰는 'src/main/resources/templates' 폴더 아래에 위치합니다.
 

 
지금까지의 상황만으로 코드를 실행시키면 localhost:8080으로 접속했을 때,
로컬 서버에 연결이 되고 Hello Jcowwk's Board ! 글자가 보여지게 됩니다.
여기까지 확인했으면 다음으로 넘어갑니다.
 

7. Controller

HomeController는 홈 페이지와 관련된 처리를 작성하였고,
회원가입을 위해서는 MemberController를 만들어서 멤버와 관련된 처리를 해줍니다.
 
홈 화면에서 로그인하고, 회원가입을 클릭하면 회원가입 창으로 넘어가는 방식으로
화면을 구성해보겠습니다.
 
- MemberController, index.html

 
index.html에 위와 같이 코드를 작성하면, 현재 localhost에 접속했을 때 보이는 화면을 구성할 수 있습니다.
 
회원가입을 눌렀을 때는 회원가입 창으로 이동하는 것이기 때문에 GET 매핑을 하고,
로그인을 눌렀을 때는 사용자가 입력한 id, pw가 서버로 전달되어야 하기 때문에 POST 매핑을 했습니다.
 
@GetMapping("member/joinForm")와 @GetMapping("/member/joinForm")는 동일한 경로를 나타냅니다.
하지만 첫 번째의 경우에는 상대 경로, 두 번째는 절대 경로를 나타내는데 안전을 위해서는 절대 경로를 사용하는 것이 좋습니다.
위의 캡쳐본에서는 상대 경로를 사용하였는데 절대 경로로 바꿔서 코드를 작성하고,
@controller 어노테이션이 빠졌는데 추가해서 코드를 수정해봅시다!
 
사용자의 요청에 맞게 controller에서 응답을 해줄 때 return 값이 "member/joinForm"과 "member/home"으로 되어있습니다.
이는 templates의 member 디렉터리 안에 존재하는 joinForm.html, home.html으로 이동하라는 의미입니다.
 
templates안에 member 디렉터리를 만들고 그 안에 joinForm.html과 home.html을 만들어주고 실행을 하면 동작이 가능합니다.
로그인과 회원가입을 눌렀을 때 창이 제대로 뜬다면 성공입니다.
 
- MemberController, joinForm.html

 
joinForm.html과 MemberController에 위와 같이 코드를 작성합니다.
 
회원가입이 완료되거나 취소를 누르면 홈 화면으로 이동하게 됩니다.
다음 단계부터는 회원가입 창에서 가입완료를 누르거나 확인을 눌렀을 때 실행되는 작업의 로직을
만들어보도록 하겠습니다.
 

8. DTO

회원가입 창에서 확인 버튼을 눌렀을 때 id가 중복된 id인지 확인 하는 작업과,
가입완료 버튼을 눌렀을 때 데이터베이스에 회원 정보를 저장하는 작업이 필요합니다.
 
이 작업을 하기 위해서는 DTO를 통해 사용자의 입력을 받은 후,
Entity로 바꾸어준 다음에 Repository를 통해 데이터베이스와 통신해야합니다.
이러한 작업을 실제로 하는 것이 Service입니다.
 
우선 DTO부터 만들어보겠습니다.
 
- MemberDTO, MemberController

 
회원가입 시에 id, pw, name을 입력할 것입니다.
joinForm.html에서 <input ~ name = "">라는 부분이 있는데 name에 입력된 변수명을
@ModelAttribute 어노테이션으로 담아서 같은 변수를 가진 DTO 변수와 매핑됩니다.
 
예를 들어 현재는 name의 값이 joinId로 되어있는 것을 memberEmail로 바꾸면
아이디에 입력한 값을 memberEmail에 잘 매핑시킬 수 있습니다.
설명의 편의를 위해 html의 name부분을 모두 다르게 했는데 DTO 변수 이름과 같게 바꿔주도록 합시다.
 
toMemberDTO 함수는 MemberEntity를 MemberDTO로 바꿔주는 함수입니다.
로그인할 때 데이터베이스와 통신하여 회원가입된 사용자인지 확인하면서 사용됩니다.
 

9. Entity

- MemberEntity

 
DTO를 다 만들었으면 Entity도 만들어줍니다.
이제 회원가입을 위한 코드를 작성해보겠습니다.
 

10. Service

- MemberController, MemberService

 
회원가입 창에 들어가서 사용자가 입력한 내용이 @ModelAttribute 어노테이션을 통해 memberDTO와 매핑됩니다.
memberDTO에 담긴 내용을 memberService로 보내서 작업을 해주고, controller는 페이지를 반환합니다.
 

 
MemberService에서는 아이디 중복 확인을 위한 idCheck 메서드와 join 메서드의 로직을 작성합니다.
현재 idCheck 메서드는 확인을 눌렀을 때 확인이 잘되는지 확인 차 코드를 간단히 하였고,
join 메서드는 실제 데이터베이스에 저장하도록 코드를 작성했습니다.
 
여기까지 코드를 작성했을 때, 이미 가입된 아이디로도 가입을 할 수 있는 상황입니다.
유효성 검사를 위해서는 로직을 작성하면 됩니다.
 

11. Repository

- MemberRepository

 
JpaRepository를 사용하여 MemberEntity에 매핑된 정보와 데이터베이스의 테이블의 통신을 해주는
MemberRepository의 코드를 위와 같이 작성합니다.
 
JpaRepository를 extends하여 save(), findById() 등 기본으로 내장된 함수를 사용할 수 있습니다.

---

 다음 포스팅에서는 유효성 검사 및 로그인 기능 구현을
해보겠습니다 !

https://jcowwk.tistory.com/m/125

[spring] 스프링으로 로그인 및 유효성 검사 기능 만들기