Backend Code Convention

[ghrltjdtprbs]

Code Convention

---

• [IntelliJ Java Google Style](https://github.com/google/styleguide/blob/gh-pages/intellij-java-google-style.xml)을 준수합니다.

  [Google Java Style Guide](https://google.github.io/styleguide/javaguide.html)

  • Preferences > Editor > Code Style > Java > Scheme Import > Google Style IDE

  • Tab and Indents에서 Indent 및 Tab Size를 4로 변경합니다.

  • 변경이 완료되었으면 단축키를 이용해 코드를 맞출 수 있습니다.

      → 윈도우 : `***Ctrl + Alt + L***`
    
      → 맥       : `***Cmd + Option+ L***`
    

General Convention👍👍

com.example.fasttime
├── domain
│   ├── user
│   │   ├── controller
│   │   ├── dto
│   │   ├── entity
│   │   ├── exception
│   │   ├── repository
│   │   └── service
│   ├── post
│   │   ├── controller
│   │   ├── dto
│   │   ├── entity
│   │   ├── exception
│   │   ├── repository
│   │   └── service
│   ...
└── global
    ├── auth
    ├── common
    ├── config
    ├── error
    ├── infra
    └── util

Variable Convention

• 기본적인 도메인 변수는 ERD에서 작성한 변수명을 따른다.

Method Convention

• boolean 타입 반환 메서드 : ***boolean isXXX( )***

boolean isOutOfStock() // 재고가 다 소진되었는지
boolean isNull()       // Null 값 인지?

Test Convention

@DisplayName("signUp()은 ")
@Nested
class Context_SignUp {

    @DisplayName("회원가입을 할 수 있다.")
    @Test
    void _willSuccess() throws Exception {
        // given
        SignUpRequest requestDto = new SignUpRequest("user11", "password",
                "password", "테스트유저1");

        // when then
        mockMvc.perform(
                    post("/api/v1/signUp")
                    .contentType(MediaType.APPLICATION_JSON)
                    .content(objectMapper.writeValueAsString(requestDto)))
                .andDo(print())
                .andExpect(status().isCreated());
    }

    @DisplayName("username 은 ")
    @Nested
    class Element_username {
        @DisplayName("null이면 실패한다.")
        @Test
        void null_willFail() throws Exception {
            // given
            SignUpRequest requestDto = new SignUpRequest(null, "password",
                    "password", "테스트유저1");

            // when then
            mockMvc.perform(
                        post("/api/v1/signUp")
                        .contentType(MediaType.APPLICATION_JSON)
                        .content(objectMapper.writeValueAsString(requestDto)))
                    .andDo(print())
                    .andExpect(status().isBadRequest())
                    .andExpect(jsonPath("$.message").value("아이디를 입력해주세요."));
            }
        }
}

공통 사항

• 다른사람들이 어떤 테스트가 실패했는지 한눈에 알아 볼 수 있게 ***@DisplayName(””)*** 설정하기.
• 테스트 대상 메서드에서 분기가 존재한다면 ***@NestedClass*** 사용하기
  • Class Name Prefix : ***Context_***
  • Dto Validation 검증 Prefix : ***Element_***

Git

---

Commit Convention

GitFlow-Plugin 사용법

기능개발

1. 현재 브랜치가 develop 인 것을 확인한 후 Start Feature 선택 (사진1)
2. branch 네이밍 설정하기 (사진2)
3. 신나게 기능개발
4. (필수) 커밋 꼭 하기
5. Finish Feature 선택
6. GitFlow-Plugin이 해당 로직을 수행함

• git switch(checkout) develop
• git merge feature-branch
• git branch -d feature-branch

7 . 현재 브랜치가 develop에 있는 것을 본 후에 github로 push!

주의사항

• 항상 GitFlow 사용 전 Branch 확인하기!
• Finish Feature 누르기 전 Commit이 완료되었는지 체크하기 (아니면 브랜치가 삭제되버려요!)

PR Convention

팀원 모두의 리뷰를 받아야 merge할 수 있도록 브랜치 규칙 설정

Pull requests → 리뷰할 pr선택 → 상단의 Add your review → Review changes → 리뷰 작성 → Approve 선택 → Submit review

• 옆에 체크 표시가 떠야 리뷰 완료