[#4] 상품 등록, 조회, 수정, 삭제

build.gradle

@@ -23,10 +23,25 @@ repositories {
 dependencies {
 	implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
 	implementation 'org.springframework.boot:spring-boot-starter-web'
+	implementation 'org.springframework.boot:spring-boot-starter-validation'
+	implementation 'com.google.guava:guava:31.1-jre'
+	implementation 'org.apache.commons:commons-lang3:3.12.0'
+
+	// lombok
+	implementation 'org.mapstruct:mapstruct:1.5.3.Final'
 	compileOnly 'org.projectlombok:lombok'
+
+	// Mapstruct
+	implementation 'org.mapstruct:mapstruct:1.5.3.Final'
+	annotationProcessor 'org.mapstruct:mapstruct-processor:1.5.3.Final'
+
+	annotationProcessor(
+			'org.projectlombok:lombok',
+			'org.projectlombok:lombok-mapstruct-binding:0.2.0'
+	)
+
 	runtimeOnly 'com.h2database:h2'
 	runtimeOnly 'com.mysql:mysql-connector-j'
-	annotationProcessor 'org.projectlombok:lombok'
 	testImplementation 'org.springframework.boot:spring-boot-starter-test'
 }
 

http-test/item-api.http

@@ -0,0 +1,35 @@
+### 아이템 등록
+POST http://localhost:8080/api/v1/items
+Content-Type: application/json
+
+{
+  "itemName": "한옥스테이조아당",
+  "itemPrice": 35000,
+  "itemStock": 10
+}
+
+### 아이템 전체 조회
+GET http://localhost:8080/api/v1/items
+Content-Type: application/json
+
+### 아이템 상세 조회
+GET http://localhost:8080/api/v1/items/itm_m01CJuHJ6ogMx7f0
+Content-Type: application/json
+
+### 아이템 수정
+PUT http://localhost:8080/api/v1/items/itm_m01CJuHJ6ogMx7f0
+Content-Type: application/json
+
+{
+  "itemName": "한옥스테이조아당 업데이트",
+  "itemPrice": 35000,
+  "itemStock": 10
+}
+
+### 아이템 비활성화
+POST http://localhost:8080/api/v1/items/change-end-of-sales
+Content-Type: application/json
+
+{
+  "itemToken": "itm_m01CJuHJ6ogMx7f0"
+}

src/main/java/com/flab/goodchoice/item/application/ItemFacade.java

@@ -0,0 +1,42 @@
+package com.flab.goodchoice.item.application;
+
+
+import com.flab.goodchoice.item.domain.*;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+
+import java.util.List;
+
+@Service
+@RequiredArgsConstructor
+public class ItemFacade {
+
+    private final ItemEntryService itemEntryService;
+
+    private final ItemModifyService itemModifyService;
+
+    private final ItemOneService itemOneService;
+
+    private final ItemListService itemListService;
+
+    public String registerItem (ItemCommand.RegisterItemRequest request) {
+        var itemToken = itemEntryService.registerItem(request);
+        return itemToken;
+    }
+
+    public ItemInfo.Main retrieveItemInfo(String itemToken) {
+        return itemOneService.retrieveItemInfo(itemToken);
+    }
+
+    public void changeEndOfSaleItem(String itemToken) {
+        itemModifyService.changeEndOfSale(itemToken);
+    }
+
+    public void updateItem(String itemToken, ItemCommand.UpdateItemRequest request) {
+        itemModifyService.updateItem(itemToken, request);
+    }
+
+    public List<Item> retrieveAllItemInfo() {
+        return itemListService.retrieveAllItemInfo();
+    }
+}

src/main/java/com/flab/goodchoice/item/common/util/TokenGenerator.java

@@ -0,0 +1,15 @@
+package com.flab.goodchoice.item.common.util;
+
+import org.apache.commons.lang3.RandomStringUtils;
+
+public class TokenGenerator {
+    private static final int TOKEN_LENGTH = 20;
+
+    public static String randomCharacter(int length) {
+        return RandomStringUtils.randomAlphanumeric(length);
+    }
+
+    public static String randomCharacterWithPrefix(String prefix) {
+        return prefix + randomCharacter(TOKEN_LENGTH - prefix.length());
+    }
+}

src/main/java/com/flab/goodchoice/item/domain/Item.java

@@ -0,0 +1,82 @@
+package com.flab.goodchoice.item.domain;
+
+import com.flab.goodchoice.item.common.util.TokenGenerator;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import lombok.RequiredArgsConstructor;
+
+import org.apache.commons.lang3.StringUtils;
+import org.hibernate.annotations.CreationTimestamp;
+import org.hibernate.annotations.UpdateTimestamp;
+
+import javax.persistence.*;
+import java.security.InvalidParameterException;
+import java.time.ZonedDateTime;
+
+@Getter
+@Entity
+@NoArgsConstructor
+@Table(name = "items")
+public class Item {
+
+    private static final String ITEM_PREFIX = "itm_";
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    private String itemToken;
+
+    private String itemName;
+
+    private Long itemPrice;
+
+    private Long itemStock;
+
+    @Enumerated(EnumType.STRING)
+    private Status status;
+
+    @CreationTimestamp
+    private ZonedDateTime createdAt;
+
+    @UpdateTimestamp
+    private ZonedDateTime updatedAt;
+
+    @UpdateTimestamp
+    private ZonedDateTime deletedAt;
+
+    @Getter
+    @RequiredArgsConstructor
+    public enum Status {
+        PREPARE("판매준비중"),
+        ON_SALE("판매중"),
+        END_OF_SALE("판매종료");
+
+        private final String description;
+    }
+
+    @Builder
+    public Item(String itemName, Long itemPrice, Long itemStock) {
+        if (StringUtils.isBlank(itemName)) throw new InvalidParameterException("Item.itemName");
+        if (itemPrice == null) throw new InvalidParameterException("Item.itemPrice");
+        if (itemStock == null) throw new InvalidParameterException("Item.itemStock");
+
+        this.itemToken = TokenGenerator.randomCharacterWithPrefix(ITEM_PREFIX);
+        this.itemName = itemName;
+        this.itemPrice = itemPrice;
+        this.itemStock = itemStock;
+        this.status = Status.PREPARE;
+    }
+
+    public void update(String itemName, Long itemPrice, Long itemStock) {
+        this.itemName = itemName;
+        this.itemPrice = itemPrice;
+        this.itemStock = itemStock;
+    }
+
+    public void changeEndOfSale() {
+        this.status = Status.END_OF_SALE;
+    }
+
+}

src/main/java/com/flab/goodchoice/item/domain/ItemCommand.java

@@ -0,0 +1,46 @@
+package com.flab.goodchoice.item.domain;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.ToString;
+
+public class ItemCommand {
+
+    @Getter
+    @Builder
+    @ToString
+    @AllArgsConstructor
+    public static class RegisterItemRequest {
+        private final String itemName;
+        private final Long itemPrice;
+        private final Long itemStock;
+
+        public Item toEntity() {
+            return Item.builder()
+                    .itemName(itemName)
+                    .itemPrice(itemPrice)
+                    .itemStock(itemStock)
+                    .build();
+        }
+
+    }
+
+    @Getter
+    @Builder
+    @ToString
+    @AllArgsConstructor
+    public static class UpdateItemRequest {
+        private final String itemName;
+        private final Long itemPrice;
+        private final Long itemStock;
+
+        public Item toEntity() {
+            return Item.builder()
+                    .itemName(itemName)
+                    .itemPrice(itemPrice)
+                    .itemStock(itemStock)
+                    .build();
+        }
+    }
+}

src/main/java/com/flab/goodchoice/item/domain/ItemEntryService.java

@@ -0,0 +1,22 @@
+package com.flab.goodchoice.item.domain;
+
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class ItemEntryService {
+
+    private final ItemStore itemStore;
+
+    @Transactional
+    public String registerItem(ItemCommand.RegisterItemRequest command) {
+        var initItem = command.toEntity();
+        var item = itemStore.store(initItem);
+        return item.getItemToken();
+    }
+
+}

src/main/java/com/flab/goodchoice/item/domain/ItemInfo.java

@@ -0,0 +1,26 @@
+package com.flab.goodchoice.item.domain;
+
+import lombok.Getter;
+import lombok.ToString;
+
+public class ItemInfo {
+
+    @Getter
+    @ToString
+    public static class Main {
+        private final String itemToken;
+        private final String itemName;
+        private final Long itemPrice;
+        private final Long itemStock;
+        private final Item.Status status;
+
+        public Main(Item item) {
+            this.itemToken = item.getItemToken();
+            this.itemName = item.getItemName();
+            this.itemPrice = item.getItemPrice();
+            this.itemStock = item.getItemStock();
+            this.status = item.getStatus();
+        }
+    }
+
+}

src/main/java/com/flab/goodchoice/item/domain/ItemListService.java

@@ -0,0 +1,19 @@
+package com.flab.goodchoice.item.domain;
+
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+
+import java.util.List;
+
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class ItemListService {
+
+    private final ItemReader itemReader;
+
+    public List<Item> retrieveAllItemInfo() {
+        return itemReader.getItems();
+    }
+}

src/main/java/com/flab/goodchoice/item/domain/ItemModifyService.java

@@ -0,0 +1,28 @@
+package com.flab.goodchoice.item.domain;
+
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class ItemModifyService {
+
+    private final ItemReader itemReader;
+
+    @Transactional
+    public void changeEndOfSale(String itemToken) {
+        var item = itemReader.getItemBy(itemToken);
+        item.changeEndOfSale();
+    }
+
+    @Transactional
+    public ItemInfo.Main updateItem(String itemToken, ItemCommand.UpdateItemRequest request) {
+        var item = itemReader.getItemBy(itemToken);
+        item.update(request.getItemName(), request.getItemPrice(), request.getItemStock());
+        return new ItemInfo.Main(item);
+    }
+
+}

src/main/java/com/flab/goodchoice/item/domain/ItemOneService.java

@@ -0,0 +1,21 @@
+package com.flab.goodchoice.item.domain;
+
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class ItemOneService {
+
+    private final ItemReader itemReader;
+
+    @Transactional(readOnly = true)
+    public ItemInfo.Main retrieveItemInfo(String itemToken) {
+        var item = itemReader.getItemBy(itemToken);
+        return new ItemInfo.Main(item);
+    }
+
+}

src/main/java/com/flab/goodchoice/item/domain/ItemReader.java

@@ -0,0 +1,9 @@
+package com.flab.goodchoice.item.domain;
+
+import java.util.List;
+
+public interface ItemReader {
+    Item getItemBy(String itemToken);
+
+    List<Item> getItems();
+}

src/main/java/com/flab/goodchoice/item/domain/ItemStore.java

@@ -0,0 +1,5 @@
+package com.flab.goodchoice.item.domain;
+
+public interface ItemStore {
+    Item store(Item initItem);
+}