Java 코드 컨벤션

---

1. 파일 공통 요건

• UTF-8 인코딩 사용
• LF (Line Feed) 새줄 문자 사용
• 파일 끝에는 새줄 문자 삽입

---

2. 이름 규칙 (Naming)

• 영문/숫자/언더스코어만 사용
• 한글 발음 표기 금지 (예: moohyungJasan ❌ → intangibleAssets ✅)
• 약어 표기 명시 (예: HttpAPIUrl, HTTPAPIURL 등 프로젝트 기준 정의 필요)
• 패키지명: 모두 소문자 사용 (com.example.service ✅)
• 클래스/인터페이스명: UpperCamelCase 사용
• 클래스 이름은 명사, 인터페이스는 명사/형용사
• 테스트 클래스: 접미어로 Test
• 메서드명: lowerCamelCase, 동사 또는 전치사로 시작
• 상수: 모두 대문자 + 언더스코어 (예: MAX_SIZE)
• 일반 변수: lowerCamelCase 사용
• 임시 변수 외에는 한 글자 변수명 금지

---

3. 선언 규칙

• 소스 파일 당 1개의 탑레벨 클래스
• import 시 와일드카드(*) 사용 금지 (static import만 허용)
• 제한자 순서: public protected private abstract static final … (JLS 기준)
• 애너테이션 다음 새 줄 삽입
• 한 줄에 하나의 문장 / 변수 선언
• 배열은 타입 뒤에 []
• long은 대문자 L로 접미
• 특수문자 이스케이프는 전용 기호 사용 (\\n, \\t 등)

---

4. 들여쓰기

• 하드탭 사용 (스페이스 X)
• 탭 크기: 4 스페이스
• 블럭 중첩마다 1단계 들여쓰기

---

5. 중괄호 { }

• K&R 스타일 사용

  if (a > b) {
      return a;
  } else {
      return b;
  }
  
  

6. 줄바꿈 (Line-wrapping)

• 최대 줄 길이: 120자
• package, import는 한 줄에 작성
• 줄바꿈 시 다음 줄은 1단계 이상 들여쓰기
• 줄바꿈 허용 위치:
  • extends, implements, throws 뒤
  • 괄호 (, 콤마 , 뒤
  • 마침표(.), 연산자 (+, -, ==, &&, 등) 앞

---

7. 빈 줄 (Blank lines)

• package 선언 후 빈 줄 삽입
• import는 그룹별 정렬 후 빈 줄로 구분
• 메서드 선언 사이에 빈 줄 삽입

---

8. 공백 (Whitespace)

• 줄 끝에 공백 금지
• 배열, 중괄호, 소괄호 뒤에 적절한 공백 삽입
• 제어문 키워드와 괄호 사이: 공백 삽입 (예: if (a > b))
• 메서드명/생성자 뒤 소괄호: 공백 삽입 금지
• 형변환 괄호 내부 공백 없음 (예: (String)value)
• 제네릭 꺾쇠괄호 <T>에 공백 삽입 금지
• 콤마 ,, 세미콜론 ; 뒤에만 공백 삽입
• 콜론 :은 앞뒤 공백 삽입
• 이항/삼항 연산자는 앞뒤 공백
• 단항 연산자는 공백 삽입 금지
• 주석문 기호 앞뒤에 공백 삽입