오늘은 각자 모여서 소프트웨어(모각소)하는 시간에 창업동아리에서 개발중인 가구 이커머스 플랫폼의 상품등록 기능에 대해서 개발해 보았다.
그럼 개발했던 과정중 구상한 기능과 요구사항들에 대해서 정리해보도록 하겠다.
요구사항 분석
앱 개발 관련해서 정의한 요구사항은 이미 노션에 적어 놨기에 이번 상품 등록, 조회 관련해서 요구사항만 분석했다.
- 상품등록은 Seller 의 입장에서만 적용된다.
- 구매자 또는 일반 사용자 입장에서는 상품을 등록 시킬 수 없다.
-> 이를 구분하기 위한 MEMBER Enums 클래스가 필요할 것.
- 상품등록에 필요한 정보들
- 상품 카테고리(거울, 침대 등)
- 상품의 이름(String)
- 상품의 가격(int)
- 상품의 재고(int)
- 상품 제조 회사명(String)
- 상품 설명(string)
으로 정의한다.
-
각각의 회사에서 등록할 때 사진을 같이 첨부해야한다.
-
판매자는 자신이 등록한 상품을 확인하고, 수정할 수 있어야한다.
-
구매자는 판매자가 등록한 상품을 확인할 수 있다.(평범한 이커머스 플랫폼과 같이)
필요 기능 분석
- 상품등록에 필요한 정보들을 프론트엔드에서 받고, 백엔드에 위 정보를 받아오면, 백엔드는 이를 데이터베이스에 저장하고, 저장된 정보를 프론트엔드에 전달해야한다.
- 등록이므로 @PostMapping 사용
- 잘못된 정보를 전달 시 http badRequset 메세지를 보낸다.
- 엔티티를 api에 직접 노출하는 것은 좋지않다.(유지보수, 보안)
- 이를 해결하기 위해서 RequestDTO, ResponseDTO를 따로 만들어야한다.
- 상품 단일 조회를 위해 프론트엔드는 해당 상품 ID를 전달하고, 백엔드는 받은 ID를 통해 위 상품을 검색 후 프론트엔드에 상품 정보를 전달한다.
- 조회이므로 @GetMapping
- 이때 응답 DTO는 등록시 전달하는 DTO 와 동일하게 한다.
- ID에 해당하는 정보가 존재하지 않는다면 notFound 결과를 전송
- 상품 전체 조회
- 데이터 베이스 내의 모든 아이템에 대해서 List형식으로 정보를 제공한다.
- 이 경우도 마찬가지로 모든 item에 대한 정보를 Response DTO로 형변환시켜 전달한다.
개발한 코드
*Controller
@RestController
@RequiredArgsConstructor
public class ItemController {
private final ItemService itemService;
// item 관련해서 response 제약 가져갈지 말지 고민하기
@PostMapping(value = "/seller/item/new")
public ResponseEntity<ResponseItemFormDto> ItemRegistration(@RequestBody RequestItemFormDto itemFormDto) {
if (itemFormDto.getItemType() == ItemType.MIRROR) {
Mirror item = new Mirror();
item.setName(itemFormDto.getName());
item.setPrice(itemFormDto.getPrice());
item.setStockQuantity(itemFormDto.getStockQuantity());
item.setItemDetail(itemFormDto.getItemDetail());
Long saveitemId = itemService.saveitem(item);
ResponseItemFormDto responseItemFormDto = new ResponseItemFormDto();
responseItemFormDto.setId(saveitemId);
responseItemFormDto.setItemName(item.getName());
responseItemFormDto.setItemDetail(itemFormDto.getItemDetail());
responseItemFormDto.setStockQuantity(item.getStockQuantity());
responseItemFormDto.setPrice(itemFormDto.getPrice());
responseItemFormDto.setItemType(itemFormDto.getItemType());
responseItemFormDto.setItemSellStatus(ItemSellStatus.AVAILABLE);
return ResponseEntity.ok(responseItemFormDto);
}
return ResponseEntity.badRequest().build();
}
@GetMapping(value = "/seller/item/search/{id}")
public ResponseEntity<ResponseItemFormDto> ItemSelection(@PathVariable Long id) {
ResponseItemFormDto itemFormDto = new ResponseItemFormDto();
Item item = itemService.findById(id);
if(item == null){
return ResponseEntity.notFound().build();
}
itemFormDto.setItemName(item.getName());
itemFormDto.setItemDetail(item.getItemDetail());
itemFormDto.setStockQuantity(item.getStockQuantity());
itemFormDto.setId(item.getId());
itemFormDto.setPrice(item.getPrice());
if(item instanceof Mirror) {
itemFormDto.setItemType(ItemType.MIRROR);
}
return ResponseEntity.ok(itemFormDto);
}
@GetMapping(value = "/seller/item/search/all")
public List<ResponseItemFormDto> ItemSelection() {
List<Item> items = itemService.findAll();
List<ResponseItemFormDto> collect = items.stream()
.map(o -> new ResponseItemFormDto(o))
.collect(toList());
return collect;
}
}RequestItemFormDto
@Getter
@Setter
@NoArgsConstructor
public class RequestItemFormDto {
private String name;
private int price;
private int stockQuantity;
private ItemType itemType;
private String ItemDetail;
}ResponseItemFormDto
{
private Long id;
@NotBlank(message = "상품명은 필수 입력 값입니다.")
private String itemName;
@NotNull(message = "가격은 필수 입력 값입니다.")
private int price;
@NotNull(message = "재고는 필수 입력 값입니다.")
private int stockQuantity;
private ItemType itemType;
@NotBlank(message = "상품 상세는 필수 입력 값입니다.")
private String itemDetail;
private ItemSellStatus itemSellStatus;
private List<ItemImgDto> itemImgDtoList = new ArrayList<>();
private List<Long> itemImgIds = new ArrayList<>();
public ResponseItemFormDto(Item item) {
this.id = item.getId();
this.itemDetail = item.getItemDetail();
this.itemName = item.getName();
this.price = item.getPrice();
this.stockQuantity = item.getStockQuantity();
this.itemDetail =item.getItemDetail();
if(item instanceof Mirror){
this.setItemType(ItemType.MIRROR);
}
}
}다음 개발 과정에는 상품 등록시 이미지 추가 , 주문 관련 기능, 장바구니 관련기능을 추가해보도록 하겠다.
모각소 후기
이제 진짜 얼마남지 않은 모각소를 오늘 하루도 진행했다. 이번주 일요일까지 꽉꽉채워서 25일날 최고의 모각소 기록들을 제출할 예정이다. 또한 오늘 진행한 개발은 상품조회, 상품 등록에 관한 내용이였는데 크게 어렵지 않았지만, 프로그램이 점점 커지면서 관리해야할 부분이 늘어나므로 객체 지향적 개발에 관해서 더욱더 공부를 해야한다고 느꼈다. 방학이 끝나기 전까지 막판 스퍼트를 달려보자.
현재진행중