개발일지-12 [🏠가게 도메인: 판매자 가게 등록]

가게 도메인 기능 정의 포스팅

---

가게 등록 신청 화면

• 

---

1. [GET] /jat/stores/duplicate

가게 등록 전 중복된 가게 이름이 서버에 등록 되어있는지 조회

화면의 지점명 밑 칸 옆에 중복확인 버튼을 누르면 서버에 API 요청

• 응답 바디 [StoreNameDupRes.java]

• StoresController.java
  가게이름을 queryParam으로 넘겨받는다.
  

• StoresService.java
  

• StoreDao.java

// Stores 테이블에 가게 이름이 queryParam으로 넘어온 가게이름과 동일한 가게가 존재하는지?
public int storeNameDuplicate(String storeName) {
        String duplicateCheck = "SELECT 
        				EXISTS(SELECT storeIdx FROM Stores WHERE store_name = ?)";

        return this.jdbcTemplate.queryForObject(duplicateCheck, int.class, storeName);
}

---

2. [POST] /jat/stores

판매자가 서비스 이용하기전 본인의 가게 정보를 등록 요청

• 판매자가 가게를 운영하기 위한 모든 가게 정보를 작성 하기 위한 단계이다.
• 주소 처리를 위해 카카오 위치 API를 사용하였고,
• 각 이미지 정보를 처리하기 위해 AWS S3 서비스를 이용하였다.
• 서버에 AWS S3 의존성 주입 후, 서비스 이용을 위해 S3 서비스 이용 권한이 있는 AWS IAM 계정을 하나 만들어서 해당 계정의 인증키를 이용하였음.

• 클라이언트에서 서버로 요청올 때 이미지 파일이 담겨 있으므로 해당 이미지를 담기 위해 MultiPart 라는 클래스를 사용.
• @ReuqestBody는 JSON형태로 파싱해서 서버의 객체 클래스로 매핑 되지만, MultiPart 파일은 form-data 형식으로 서버에 넘겨줘야 매핑이 가능하다.
• 고로 이미지를 받는 API의 요청 바디에는 @RequestBody 어노테이션을 작성하지 않았다.
• 파일은 S3에 저장하기 위해 서버 OS 환경에 잠시 저장했다가 S3에 저장후 바로 삭제, 파일명은 현재시간을 나노초로 나타낸 값 + 확장자으로 지정하였다.

(1) 로직 플로우
0. 로그인 시 발행받은 JWT 토큰을 헤더에 추가하고,
1. 가게이름, 가게업종, 사업자 휴대번호, 사업주 이메일, 사업자 등록증/영업자 등록증/통장사본/가게로고/매장간판 이미지, 휴무일, 운영 시작/종료 시간, 가게 전화번호, 가게 주소를 한번에 Body에 담아 서버에 요청.
2. 가게 정보에 대한 이미지를 URL 할당
3. 주소를 이용한 가게 위치 좌표 할당
4. 입력 정보 + 이미지 URL + 가게 위치 좌표 를 최종적으로 DB의 가게 테이블에 가게 정보로 등록한다.

• 요청 바디 [PostStoreReq.java]
  주석에 이미지 url은 이미지가 아니라 이미지 파일을 채우는 필드이다..ㅎㅎ
  

• StoreController.java
  로그인 후 사용되는 서비스 이므로 헤더에 올바른 JWT토큰을 확인하여 사용자 식별자를 획득하여 사용한다.

• StoreService.java

@Transactional(rollbackFor = {BaseException.class, IOException.class})
    public PostStoreRes storeRegister(int sellerIdx, PostStoreReq postStoreReq) throws BaseException, IOException {
        //0) 가게 중복 등록 방지
        int storeRegistredCheck = storeDao.storeAlreadyRegister(sellerIdx);
        if (storeRegistredCheck == 1){
            throw new BaseException(STORE_ALREADY_REGISTERD); // 2034:"가게 등록 요청을 이미 하였습니다(메뉴 등록 또는 관리자의 승인을 기다리세요).
        }

        // 1) 가게 이미지 등록정보 URL 발생
        String[] fileNames = new String[]{null, null, null, null, null};
        File[] files = new File[]{null, null, null, null, null};
        try{

            fileNames[0] = checkFileIsNullThenName(postStoreReq.getBusinessCertificateFile()); // 사업자 등록증 이미지파일
            fileNames[1] = checkFileIsNullThenName(postStoreReq.getSellerCertificateFile()); // 영업자 등록증 이미지 파일
            fileNames[2] = checkFileIsNullThenName(postStoreReq.getCopyAccountFile()); // 통장 사본 이미지 파일
            fileNames[3] = checkFileIsNullThenName(postStoreReq.getStoreLogoFile()); // 가게로고 이미지파일
            fileNames[4] = checkFileIsNullThenName(postStoreReq.getSignFile()); // 가게 간판 이미지 파일

            // 보낼 이미지 생성
            for (int i = 0; i<5 ; i++)
                if (fileNames[i] != null) {
                    files[i] = new File(absolutePath + fileNames[i]);
                    System.out.println(fileNames[i] +": "+ files[i]);
                }
        }catch (Exception e){
            throw new BaseException(STORE_URL_POST_ERROR); // 4034: 등록하는 이미지의 형태가 잘못 처리되었습니다.
        }

        // 실제 파일 생성
        try{
            if (files[0] != null)
                postStoreReq.getBusinessCertificateFile().transferTo(files[0]);
            if (files[1] != null)
                postStoreReq.getSellerCertificateFile().transferTo(files[1]);
            if (files[2] != null)
                postStoreReq.getCopyAccountFile().transferTo(files[2]);
            if (files[3] != null)
                postStoreReq.getStoreLogoFile().transferTo(files[3]);
            if (files[4] != null)
                postStoreReq.getSignFile().transferTo(files[4]);
        }catch (Exception e){
            throw new BaseException(STORE_URL_POST_ERROR); // 4034: 등록하는 이미지의 형태가 잘못 처리되었습니다.
        }

        // 2) 가게 등록에 필요한 각 이미지 url 생성
        String[] urls = new String[]{null, null, null, null, null};
        try{
            for (int i = 0; i<5; i++) {
                if (fileNames[i] != null) {
                    s3Client.putObject(new PutObjectRequest(bucketName, fileNames[i], files[i]));
                    urls[i] = "" + s3Client.getUrl(bucketName, fileNames[i]);
                    files[i].delete();
                }
            }
        } catch (Exception e){
            throw new BaseException(S3_ACCESS_API_ERROR); // 5030 : 이미지 url 생성에 실패하였습니다.
        }

        // 가게 좌표 구하기(경/위도)
        ResponseEntity<LocationInfoRes> apiResponse;
        try{
            apiResponse = locationValue.kakaoLocalAPI(postStoreReq.getStoreAddress());
        }catch (Exception e) {
            throw new BaseException(STORE_XY_CODE_FAILED); // 2035 : 가게주소가 올바르지 않습니다.
        }

        // 카카오 위치 API 응답 실패
        if (apiResponse.getStatusCode() != HttpStatus.OK){
            throw new BaseException(STORE_XY_CODE_FAILED); // 2035 : 가게주소가 올바르지 않습니다.
        }

        // 응답 값이 1이상이면 결과가 존재함
        LocationInfoRes currentLoc = apiResponse.getBody();
        if (currentLoc.getDocuments().length == 0){
            throw new BaseException(STORE_XY_CODE_FAILED); //2036 :가게 등록 요청 실패.
        }

        String locAddress = currentLoc.getDocuments()[0].getAddress().getAddress_name();
        String roadAddress = currentLoc.getDocuments()[0].getRoad_address().getAddress_name();
        double nowX = currentLoc.getDocuments()[0].getX();
        double nowY = currentLoc.getDocuments()[0].getY();

        try{ // url 저장
           return new PostStoreRes(storeDao.storeRegister(sellerIdx, postStoreReq, fileNames, nowX, nowY));
        } catch (Exception e){
            throw new BaseException(STORE_REGISTER_FAILED);
        }
    }

1. 해당 유저가 이미 가게를 등록하였는지 판별하고, 가게 등록을 이미 안했다면
2. 가게 정보의 이미지를 처리하기 위해 URL을 만들 준비를 한다.
3. AWS S3에 저장할 파일의 Key값인 파일명은 현재시간의 나노초까지의 값 + 파일 확장자 로 지정하였다.
4. 파일명을 각 이미지에 맞게 만들었으면 Ubuntu 환경에 지정된 폴더에 실제로 파일을 생성하고,
5. 해당 파일을 AWS S3 서비스를 이용하여 S3 버킷에 직접 저장하고 URL을 생성한다.
6. 이미지 URL 생성이 끝나고,
7. 앱에서 구매자가 지도로 가게를 확인하기 위해, 입력받은 가게정보를 Kakao 위치 API를 이용하여 가게 주소의 경/위도 좌표를 할당받는다.
8. S3를 통한 이미지 URL 할당 & Kakao API를 이용한 주소 좌표 값을 모두 구하였다면, 나머지 입력받은 값과 함께 판매자의 가게 정보를 "승인 대기 상태로" DB에 저장한다!
9. 승인 대기인 이유는 관리자가 해당 가게의 정보를 확인하고 서비스 이용을 허락하기 위함이다!
   -> 카카오 위치 API 포스팅, S3 관련 포스팅

• StoreDao.java

// 이미 등록 요청을 마친 판매자 인지 식별
public int storeAlreadyRegister(int sellerIdx) {
        String query = "SELECT EXISTS(
        			SELECT * FROM Stores 
                    WHERE sellerIdx = ? AND (status = 'W' OR status = 'A'))";

        return this.jdbcTemplate.queryForObject(query, int.class, sellerIdx);
    }

// 가게 정보를 서버에 "승인대기(W)" 상태로 등록
public int storeRegister(int sellerIdx, PostStoreReq postStoresReq, String[] urls, double nowX, double nowY) {

        String query = "INSERT INTO Stores (sellerIdx,\n" +
                "                    categoryIdx,\n" +
                "                    city,\n" +
                "                    local,\n" +
                "                    town,\n" +
                "                    x,\n" +
                "                    y,\n" +
                "                    store_name,\n" +
                "                    business_phone,\n" +
                "                    business_email,\n" +
                "                    business_certificate_url,\n" +
                "                    seller_certificate_url,\n" +
                "                    copyaccount_url,\n" +
                "                    breakday,\n" +
                "                    store_open,\n" +
                "                    store_close,\n" +
                "                    store_phone,\n" +
                "                    store_address,\n" +
                "                    store_logo_url,\n" +
                "                    sign_url)\n" +
                "VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?);";

        Object[] params = new Object[]{
                sellerIdx,
                postStoresReq.getCategoryIdx(),
                postStoresReq.getCity(),
                postStoresReq.getLocal(),
                postStoresReq.getTown(),
                nowX,
                nowY,
                postStoresReq.getStoreName(),
                postStoresReq.getBusinessPhone(),
                postStoresReq.getBusinessEmail(),
                urls[0] != null ? urls[0] : "",
                urls[1] != null ? urls[1] : "",
                urls[2] != null ? urls[2] : "",
                postStoresReq.getBreakDay(),
                postStoresReq.getStoreOpen(),
                postStoresReq.getStoreClose(),
                postStoresReq.getStorePhone(),
                postStoresReq.getStoreAddress(),
                urls[3] != null ? urls[3] : "",
                urls[4] != null ? urls[4] : ""
        };

        this.jdbcTemplate.update(query, params);

        String lastInsertIdQuery = "SELECT LAST_INSERT_ID();";
        return this.jdbcTemplate.queryForObject(lastInsertIdQuery, int.class);
    }

---

API 테스트

• 

[GET] /jat/stores/duplicate

• 우리 동네의 빵집으로 가게 등록을 한번 해보겠다.
• 0 이면 중복되지 않는 가게 이름 (명세서 참고)
  

[POST] /jat/stores

• 가게 정보 등록신청 완료 한 모습
• 다시 로그인 하면 가게가 등록된 것을 확인 가능하다.