[BackEnd][Maven-PJ] 사내 개발자 커뮤니티 서비스 - 게시판 만들기 : 글 등록(작성) / 수정

 

 

🧑🏻‍💻 Git Hub 주소

 

 

🗂 목차

● [BackEnd][Maven-PJ] 개발자 커뮤니티 서비스 - 게시판 만들기 : 글 등록(작성) / 수정

● [BackEnd][Maven-PJ] 개발자 커뮤니티 서비스 - 게시판 만들기 : 목록 조회

● [BackEnd][Maven-PJ]개발자 커뮤니티 서비스 - 게시판 만들기 : 상세 조회

● [BackEnd][Maven-PJ]개발자 커뮤니티 서비스 - 게시판 만들기 : 삭제

● [BackEnd][Maven-PJ] 사내 개발자 커뮤니티 서비스 - 게시판 : 답변 등록 / 수정

● [BackEnd][Maven-PJ] 사내 개발자 커뮤니티 서비스 - 게시판 : 답변 삭제

 

👨‍👩‍👧‍👦 회원 관련

● [BackEnd][Maven-PJ] 사내 개발자 커뮤니티 서비스 - 회원 관련 : 회원 가입

 

 

📚부 록 

● [BackEnd][Maven-PJ]개발자 커뮤니티 서비스 - 게시판 만들기 : Paging처리

 

🤔 내가 만난 Exception

● [Exception 정리] org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)

● [Vue.js][Spring] Post Data 전송 간 null값 전송 문제

​

 

 

 

 

🚀 개발 관련 Q&A 게시판 서비스

 

 

 

    🔽  어떻게 구성할 것인가?

 

    🔽  VO 구성

 

해당 VO가 extends한 객체에 대한 내용은 '이 곳'에 정리 해 두었어요!

 

 

위의 VO는 위와 같이 Table Column과 Mapping 된 객체인 것이에요.
그런데, VO에 보면 srchWord와 srchType이 있는데, 이 두 Member 변수 내용은 Column에 없는 것이에요.

이 변수들은 Client에서 검색 기능을 통한 요청을 할 때 검색 종류 (srchType)과 검색명(srchWord)를 받기 위한 변수입니다!

 

🚀 개발 관련 Q&A 게시판 서비스 - 등록

 

 

 

    🔽  DevInquryController.java

devInquryRegist(@RequestBody DevInquryVO devInquryVO)

 

61번째 줄에 `@ResponseBody`에 대한 정리 내용은 '이 곳'에 준비 해 둘게요!

 

devInquryRegist(@RequestBody DevInquryVO devInquryVO)

devInquryRegist(@RequestBody DevInquryVO devInquryVO)

 

 

이제 위의 Controller Code를 하나하나 분석 해 보면서 복습을 해 볼 것이에요.

 

        Field[] fields = devInquryVO.getClass().getDeclaredFields();

VO에 임의의 값을 넣어서 사용해야 될 때 getDeclaredFields 이 친구를 사용하는 것이에요.

이 내용은 사실 이번 프로젝트를 하면서 주니하랑도 처음 써 본 것이라 좀 더 자세히 정리하기 위해 '이 곳'에 정리한 내용을 준비 해 둘게요!

 

Map<String, Object> result = new HashMap<>();

 

그런 뒤 응답(Response) 시에 전달할 내용들을 담을 그릇인 result를 만들어 준 것이에요.

 

try {

    log.info("등록할 글이 비밀글인지 확인 하겠습니다!");
    if (devInquryVO.getSecretAt().equals("false")) {

        log.info("등록할 글이 비밀글이 아닙니다! 공개글로 등록 합니다!");
        devInquryVO.setSecretAt("N");

    } else {

        log.info("등록할 글이 비밀글 입니다! 비밀글로 등록 합니다!");
        devInquryVO.setSecretAt("Y");

    } // if (devInquryVO.getSecretAt().equals("false")) - else 끝

 

주니하랑이 만들고 있는 게시판에는 비밀글 기능이 있는 것이에요. 게시글 등록 요청 이용자가 비밀글을 체크 했는지 여부에 따라 해당 VO에 setter를 이용하여 비밀글 여부를 표시하기 위해 조건문으로 확인을 하고, 적절한 값을 넣어주고 있는 것이에요.

 

if (CustomStringUtil.getString(devInquryVO.getInqrySn()) == "" || devInquryVO.getInqrySn() == 0) {

    log.info("등록 요청 게시글 일련번호가 비어있습니다! 게시글 등록을 수행 합니다!");
    // TODO - 회원가입 및 로그인 로직 구현 뒤 아래 하드코딩 수정 필요

    log.info("devInquryService.devInquryInsertUpdate(devInquryVO)을 호출 하겠습니다!");
    devInquryService.devInquryInsert(devInquryVO);

    log.info("Map result에 게시글 일련 번호를 넣겠습니다!");
    result.put("resultSn", devInquryVO.getInqrySn());

 

나중에 주니하랑은 해당 Logic에서 등록 / 수정 Logic을 분리할 예정이지만, 일단은 빠르게 완성을 위해 달리고 있는 것이에요. 어차피 리펙터링은 계속 되어야 하닌까! 하나하나 천천히 가 볼 것이에요.

위의 Logic은 VO안에 들어 있는 getInqrySn (게시글 일련번호)가 들어 있는지 아닌지를 확인하는 Logic인 것이에요. 만약 게시글 일련번호가 없다면 이 글은 신규 등록이 될 것이고, 게시글 일련번호가 있다면 수정Logic을 처리하면 될 것이에요.

위의 if문은 게시글 일련번호가 비어있냐고 물어보고 있으니 게시글 등록 처리를 위한 비즈니스 로직을 호출하는 것이에요.그런 뒤 해당 게시글 일련번호를 응답으로 전달 해 주기 위해 result Map에 담아 주는 것이에요.

 

 

} else {

    log.info("등록 요청 게시글 일련번호가 존재 합니다! 게시글 수정을 수행 합니다!");
    log.info("devInquryService.devInquryInsertUpdate(devInquryVO)을 호출 하겠습니다!");
    devInquryService.devInquryUpdate(devInquryVO);

    log.info("Map result에 게시글 일련 번호를 넣겠습니다!");
    result.put("resultSn", devInquryVO.getInqrySn());

} // if (CustomStringUtil.getString(devInquryVO.getInqrySn() == "" || devInquryVO.getInqrySn() == 0)) - else 끝

 

다음은 else문이니 게시글 일련번호가 있다면 들어오는 로직이고, 그렇다면 수정 비즈니스 로직 처리를 할 것이에요.

역시 마지막에 처리된 게시글 일련번호를 result Map에 담아 준 것이에요.

 

log.info("Logic이 완료 되었으므로, 200 Code를 Map result에 넣겠습니다!");
result.put("code", 200);

그런 뒤 HTTP Status Code를 전달하기 위해 result Code에 해당 Code를 넣어주고 있는 것이에요.

 

} catch (Exception e) {

    log.info("게시글 등록 / 수정에 문제가 발생(권한 문제)하여 catch문이 실행 되었습니다!");

    e.printStackTrace();

    log.warn(e.getMessage());

    log.info("Logic이 Error로 401 Code를 Map result에 넣겠습니다!");
    result.put("code", 401);

    return result;

} // try - catch 끝

return result;

 

해당 try - catch문은 권한이 있냐 없냐에 따라 처리가 될 것이에요. 해당 Logic에 권한이 없는 이용자가 접근을 하여 Logic을 요청하면 catch문에 빠져서 401 Http State Code를 받게 될 것이에요.

그러기 위해 result Map에 해당 Code를 집어 넣어줬고, 반환을 하여 응답 해 주는 것이고,

catch문에 빠지지 않았다면 try문에서 처리된 응답값들을 모은 result Map을 반환 해 주는 것이에요.

 

    🔽  DevInquryService.java

 

 

위의 Service는 interface로 구성하고, 게시판 등록 Method를 추상 Method로 구현한 것이에요. 

 

 

    🔽  DevInquryServiceImpl.java

 

 

그리고, Interface를 구현한 구현체를 만들어서 Method를 재정의(Override)를 통해 Service Logic을 구현한 것이에요.
이렇게 한 이유는 의존관계 주입 DI(Dependency Injection)를 따르기 위해 이렇게 한 것이에요. 이 내용에 대해서는 '이 곳'에 자세히 준비 해 둘게요!

 

28번째 줄 @Transactinal에 대한 정리 자료는 '이 곳'에 정성스럽게 준비 해 두었습니다!

 

@Slf4j는 콘솔에 Log를 출력하기 위한 Annotaion인 것이에요. 주니하랑은 어디서 부터 어디가 어떻게 동작하는지 개발단계에서는 알고 싶어서 되도록 구현된 내용에 기대하는 결과에 대해 출력 되도록 하고 있답니다.

 

자! 이제 본격적으로 DB Handling을 위해 Mapper Class에 Method를 호출 해서 불러 보도록 할께요!

 

 

    🔽  DevInquryMapper.java

 

 

역시 Mapper Class를 Interface로 만들었고, 필요한 Method는 추상 Method로 만들어 준 것이에요.
그리고, @Mapper를 통해서 이 Class과 연결될 구현 xml File과 연결을 해 줄 것이에요.

 

@Mapper.class

반응형

 

Mapper 어노테이션의 코드는 단순히 meta annotation이 붙어 있고, 안에 특별한 내용은 없어 보이는 것이에요. 이 어노테이션은 MyBatis의 mappers를 위한 marker interface로 이용되고, SQL을 호출하기 위한 인터페이스인 것이에요. 이 친구는 Mybatis3.0 부터 생겼다고 합니다.

즉, 이 어노테이션을 통해 밑에 Mapper.xml에 Name Space에 패키지명을 포함한 인터페이스 이름을 적어주면 연결이 되는 것이에요.

 

    🔽  DevInquryMapper.xml

 

 

이 친구가 본격적으로 게시글 등록시에 SQL 문을 DB에 던져줄 Mapper 인터페이스 구현체인 것이에요.

<mapper namespace> 이 곳에 위에 이야기 했던 Mapper 인터페이스 경로를 적어주면 해당 Mapper 인터페이스와 연결이 되고,
<insert> id 속성에 Mapper 인터페이스의 추상 Method명을 써주면 되는 것이에요. 그리고, parameterType 속성은 이 xml에 어떤 매개 변수를 넣어 줄 것이냐고 이해 하면 좋을 것 같아요. 주니하랑은 VO 자체를 넣어주었답니다!

게시글 등록이기 때문에 INSERT 문을 사용했고, tb_com_inqry 라는 Table에 9 ~ 18 Line Column에 Matching될 값들을 #{매개 변수 객체의 Member 변수명}을 넣어주면 되는 것이에요.

여기서 궁금한게 있는 것이에요. 7번째 줄에 `<![CDATA[...]]>` 이 친구는 대체 무엇일까요?

일단, 이 친구를 풀어 쓰면 `Character Data` 즉, '문자 데이터'라는 뜻인 것잉에요.
이 용어를 좀 더 정확하게 이야기 하자면 '(Unparsed) Character Data' 즉, Parsing하지 않은 문자 데이터라는 의미인 것이에요. 이에 반대되는 친구는 'PCDATA'라고 부른 답니다!

 

예시를 한번 들어 볼게요. 위에 내용에 Text를 출력 해 보면 아래와 같이 출력 되는 것이에요.

 

 

이것은 ![CDATA[]] 를 쓰지 않았을 때 모습이고, 이것을 사용하면 아래와 같은 것이에요.

 

 

 

차이가 느껴지시나요? 이렇듯 <![CDATA[...]]는 안에 들어가는 Text가 Parsing 되지 않게 하려고 사용하는 것이에요.

위에 mapper.xml에서는 바로 SQL문이 Parsing 되어 기능을 잃어버리지 않게 하기 위해서 사용한 것이 랍니다!

 

 

📣 결과

 

Postman을 통해 등록을 해 보았는데, 문제가 발생한 것이에요. 해당 내용은 '이 곳'에 정리 해서 준비 해 둘게요!

 

 

Request Body에 들어갈 부분에 꼭 들어가야 하는 내용을 제외하고, 위에 Exception을 처리한 뒤 Request를 보내니 정상 처리 된 것이에요.

 

 

DB에도 정상적으로 들어간 것을 확인할 수 있는 것이에요.

 

 

 

 

🚀 개발 관련 Q&A 게시판 서비스 - 수정

    🔽  DevInquryService.java

Controller는 등록과 수정이 같이 사용하고 있는 것이에요. 그리고, 요청 Body에 게시글 일련번호가 있는지 없는지를 판단하여 없으면 글 등록으로 판단하고, 있으면 수정으로 판단하는 것이에요.

 

 

    🔽  DevInquryServiceImpl.java

 

뭔가 바뀐 것은 Controller에서 비즈니스 로직이 처리되고, Service 단에서는 단지 DB처리를 위한 Method만 호출하는 것이에요. 차 후 이 부분은 변경할 예정 입니다.

 

 

    🔽  DevInquryMapper.java

 

 

 

 

    🔽  DevInquryMapper.xml

 

update Query를 써서 VO에 들어온 값을 처리하고 있는 것이에요. 게시글 제목(inqrySj), 게시글 내용(InqryCn), 파일 관련 일련번호(fileSn), 수정일, 수정자(upduserSn)일련 번호, 비밀글 여부(secretAt)에 대해 수정을 하고, 수정은 해당 게시글 번호에 맞는 요청에 대해 처리를 하는 것이에요.

나중에 주니하랑은 and 조건을 추가해서 회원 일련번호도 확인을 하도록 해서 자기 자신의 게시글만 수정이 가능하게 Refactoring을 진행해보려 해요.

 

 

 

위에 글 등록 단계에서 등록한 글이 정상적으로 수정이 되나 확인 해 볼것이에요.

 

 

 

 

📣 결과

 

사실 눈치 채셨겠지만, 이 Logic은 RestFul하지 않은 것이에요.
바로 수정은 Patch나, Put Method를 사용해야 하는데, 등록과 함께 Post를 사용하는 것이 문제에요.
이 부분도 차 후 모든 서비스 구현이 완료되면 점차 Refactoring을 진행 하려고 하는 것이에요.

 

 

앞으로 해당 Project에서 다른 게시판에 등록 부분에 대해 특별한 내용이 있지 않는 한 추가 하지는 않을 것이고, 주니하랑의 Project가 궁금하다면 아래 Git Hub에서 기다리고 있을게요!