Week#1-Step#1
-
상품 조회
- 상품 목록을 조회하는 기능
- HTTP 메서드: GET
- 엔드포인트:
/api/products
-
상품 추가
- 새로운 상품을 추가하는 기능
- HTTP 메서드: POST
- 엔드포인트:
/api/products
-
상품 수정
- 기존 상품 정보를 수정하는 기능
- HTTP 메서드: PUT
- 엔드포인트:
/api/products/{id}
-
상품 삭제
- 특정 ID를 가진 상품을 삭제하는 기능
- HTTP 메서드: DELETE
- 엔드포인트:
/api/products/{id}
Week#1-Step#2
-
상품 조회
- 상품 목록을 조회하는 기능
- HTTP 메서드: GET
- 엔드포인트:
/api/products
-
상품 추가
- 새로운 상품을 추가하는 기능
- HTTP 메서드: POST
- 엔드포인트:
/api/products
-
상품 수정
- 기존 상품 정보를 수정하는 기능
- HTTP 메서드: PUT
- 엔드포인트:
/api/products/{id}
-
상품 삭제
- 특정 ID를 가진 상품을 삭제하는 기능
- HTTP 메서드: DELETE
- 엔드포인트:
/api/products/{id}
-
상품 목록 화면
- 상품 목록을 화면에 표시하는 기능
- HTML 페이지:
templates/products.html - 접속 방법 :
localhost:8080/products - 상품 목록과 오른쪽 상단의 상품 추가 버튼
- 각 상품 우측 상품 수정 버튼과 상품 삭제 버튼
-
상품 추가 화면
- 새로운 상품을 추가하는 화면
- HTML 페이지:
templates/product_form.html - 폼을 통해 상품 정보를 입력받아 추가
-
상품 수정 화면
- 기존 상품 정보를 수정하는 화면
- HTML 페이지:
templates/product_edit_form.html - 폼을 통해 상품 정보를 입력받아 수정
-
AJAX를 통한 비동기 처리
- 상품 추가, 수정, 삭제 시 페이지 새로고침 없이 비동기로 처리
fetchAPI를 사용하여 서버와 통신
Week#1-Step#3
- JDBC를 사용하여 데이터를 H2 데이터베이스에 저장하고 관리한다.
- 상품 정보를 데이터베이스에 저장하고 조회, 수정, 삭제하는 기능을 구현한다.
- 데이터베이스 테이블 생성
Product테이블 생성
- JDBC DAO 구현
ProductDao클래스 구현
- 컨트롤러 리팩토링
- 기존의
HashMap대신 데이터베이스를 사용하도록ProductController수정
- 기존의
- 상품 추가/수정 시 DB 처리
- 상품 추가 및 수정 시 데이터베이스에 반영하도록 로직 수정
- 상품 조회 시 DB 사용
- 상품 조회 시 데이터베이스에서 정보 조회
- 상품 삭제 시 DB 사용
- 상품 삭제 시 데이터베이스에서 정보 삭제
Week#2-Step#1
- 상품 추가, 수정 시 유효성 검사
- 상품 이름은 공백 포함 최대 15자까지 입력 가능
- 가능한 특수 문자: ( ), [ ], +, -, &, /, _
- "카카오"가 포함된 문구는 담당 MD와 협의한 경우에만 사용 가능
Week#2-Step#2
- email, password 를 통한 회원가입
- 유저 정보를 기반으로 한 로그인
- 로그인이 완료된다면 토큰 제공 (bearer 방식 -> JWT 사용)
Week#3-Step#2
spring-gift-jpa
- 기존 코드 리팩토링
- 엔티티, 레포지토리 작성
- 그에 맞게 서비스 수정
- Dao 삭제
- 엔티티 연관 관계 설정
-
Wish엔티티가User,Product참조하도록 함 -
user_id,product_id를 FK로 가지도록 설정
-
Week#3-Step#3
상품과 위시 리스트 보기에 페이지네이션을 구현한다.
- 대부분의 게시판은 모든 게시글을 한 번에 표시하지 않고 여러 페이지로 나누어 표시한다. 정렬 방법을 설정하여 보고 싶은 정보의 우선 순위를 정할 수도 있다.
- 페이지네이션은 원하는 정렬 방법, 페이지 크기 및 페이지에 따라 정보를 전달하는 방법이다.
이를 직접 구현할 수도 있지만, 스프링 데이터는 **Pageable**이라는 객체를 제공하여 쉽게 구현할 수 있다. 또한 List, Slice, Page 등 다양한 반환 타입을 제공한다.
Week#4-Step#1
상품 정보에 카테고리를 추가한다. 상품과 카테고리 모델 간의 관계를 고려하여 설계하고 구현한다.
- 카테고리는 1차 카테고리만 있으며 2차 카테고리는 고려하지 않는다.
- 카테고리는 수정할 수 있다.
- 관리자 화면에서 상품을 추가할 때 카테고리를 지정할 수 있다.
- 카테고리의 예시는 아래와 같다.
- 교환권, 상품권, 뷰티, 패션, 식품, 리빙/도서, 레저/스포츠, 아티스트/캐릭터, 유아동/반려, 디지털/가전, 카카오프렌즈, 트렌드 선물, 백화점
아래 예시와 같이 HTTP 메시지를 주고받도록 구현한다.
GET /api/categories HTTP/1.1
HTTP/1.1 200
Content-Type: application/json
{
“id”: 91,
“name”: “교환권”,
“color”: “#6c95d1”,
“imageUrl”: “https://gift-s.kakaocdn.net/dn/gift/images/m640/dimm_theme.png”,
“description”: “”
}
- 구현한 기능에 대해 적절한 테스트 전략을 생각하고 작성한다.
- 카테고리를 추가하는 문제이다. 1차카테고리를 지정하고, 수정할 수 있으며, 관리자 화면에서 지정할 수 있어야 한다.
Week#5-Step#1
카카오 로그인을 통해 인가 코드를 받고, 인가 코드를 사용해 토큰을 받은 후 향후 카카오 API 사용을 준비한다.
- 카카오계정 로그인을 통해 인증 코드를 받는다.
- 토큰 받기를 읽고 액세스 토큰을 추출한다.
- 앱 키, 인가 코드가 절대 유출되지 않도록 한다.
- (선택) 인가 코드를 받는 방법이 불편한 경우 카카오 로그인 화면을 구현한다.
실제 카카오 로그인은 아래 그림과 같이 진행된다.
하지만 지금과 같이 클라이언트가 없는 상황에서는 아래와 같은 방법으로 인가 코드를 획득한다.
- 내 애플리케이션 > 앱 설정 > 앱 키로 이동하여 REST API 키를 복사한다.
- https://kauth.kakao.com/oauth/authorize?scope=talk_message&response_type=code&redirect_uri=http://localhost:8080&client_id=**`{REST_API_KEY}`**에 접속하여 카카오톡 메시지 전송에 동의한다.
- http://localhost:8080/?code=**`{AUTHORIZATION_CODE}`**에서 인가 코드를 추출한다.
카카오 플랫폼 서비스를 이용하여 개발한 애플리케이션은 이름, 아이콘, 상품명, 서비스명, 회사명, 로고, 심벌 등에 카카오의 상표를 사용할 수 없으므로(제17조(상표 사용 시 의무 사항)), 아래 항목들에 "카카오"사용 불가하다
- 앱 이름:
- 회사명:
- 카테고리:
토큰 받기에 따르면 아래와 같이 **RequestEntity**를 만들 수 있다.
var url = "https://kauth.kakao.com/oauth/token";
var headers = new HttpHeaders();
headers.add(HttpHeaders.CONTENT_TYPE, MediaType.APPLICATION_FORM_URLENCODED_VALUE);
var body = new LinkedMultiValueMap<String, String>();
body.add("grant_type", "authorization_code");
body.add("client_id", properties.clientId());
body.add("redirect_uri", properties.redirectUri());
body.add("code", authorizationCode);
var request = new RequestEntity<>(body, headers, HttpMethod.POST, URI.create(url));
- 레퍼런스를 참고하여 발생할 수 있는 다양한 오류를 처리한다.
- RestTemplate을 사용하는 경우 Spring RestTemplate Error Handling를 참고한다.
- REST Clients
- 사용할 클라이언트를 선택할 때 어떤 기준을 사용해야 할까?
- 클라이언트 인스턴스를 효과적으로 생성/관리하는 방법은 무엇인가?
- 요청을 보내고 응답을 파싱하는 부분만 테스트하려면 어떻게 해야 할까?
- 비즈니스 로직에 연결할 때 단위/통합 테스트는 어떻게 할까?
- 응답 시간이 길면 어떻게 할까? 몇 초가 적당할까?
- 오류 코드는 어떻게 처리해야 할까?
- 응답 값을 파싱할 때 문제가 발생하면 어떻게 할까?
Week#5-Step#2
카카오톡 메시지 API를 사용하여 주문하기 기능을 구현한다.
- 주문할 때 수령인에게 보낼 메시지를 작성할 수 있다.
- 상품 옵션과 해당 수량을 선택하여 주문하면 해당 상품 옵션의 수량이 차감된다.
- 해당 상품이 위시 리스트에 있는 경우 위시 리스트에서 삭제한다.
- 나에게 보내기를 읽고 주문 내역을 카카오톡 메시지로 전송한다.
- 메시지는 메시지 템플릿의 기본 템플릿이나 사용자 정의 템플릿을 사용하여 자유롭게 작성한다.
아래 예시와 같이 HTTP 메시지를 주고받도록 구현한다.
Request
POST /api/orders HTTP/1.1
Authorization: Bearer {token}
Content-Type: application/json
{
"optionId": 1,
"quantity": 2,
"message": "Please handle this order with care."
}
Response
HTTP/1.1 201 Created
Content-Type: application/json
{
"id": 1,
"optionId": 1,
"quantity": 2,
"orderDateTime": "2024-07-21T10:00:00",
"message": "Please handle this order with care."
}
실제 카카오톡 메시지는 아래와 같이 전송된다. 하지만 이번 미션에서는 수신자가 나이기 때문에 카카오톡 친구 목록 가져오기는 생략한다.
주문하기 API를 만드는 문제다.
이전에 계획한대로, Order 엔티티와 그 외 레이어들 만들고
거기에 User 와 ProductOption 을 다대일로 연관지어서 구현하면 될 것 같다.
# spring-gift-order
## step 1 - 카카오 로그인
- **카카오 로그인 구현**
- [x] 기존 로그인은 일단 그대로 유지
- [x] http://localhost:8080/oauth/kakao 에 접속 시, 로그인 페이지로 리다이렉트
- [x] 해당 페이지에서 로그인 완료 시, 인가 코드를 http://localhost:8080/oauth/kakao/callback 으로 전달
- [x] 인가 코드 추출 후, 해당 코드를 통해 access token 발급
- **추가 기능**
- [x] 카카오 로그인 시, 유저 정보를 통해 서비스의 User에도 등록하여 로그인 처리 되도록 함
## step 2 - 주문하기
- **주문하기 기능 구현**
- [ ] `Order` 엔티티, Dto, 레포지토리, 서비스, 컨트롤러 구현
- [ ] 상품 옵션과 수량을 선택하여 주문 시, 해당 상품 옵션의 수량 차감
- [ ] 해당 상품이 위시 리스트에 있는 경우 위시 리스트에서 삭제
- **카카오톡 메시지 API 호출**
- [ ] `access token`을 검증하여 카카오톡 메시지 전송 API 호출