반응형
Jake Seo
제이크서 위키 블로그
Jake Seo
전체 방문자
오늘
어제
  • 분류 전체보기 (715)
    • 일상, 일기 (0)
    • 백준 문제풀이 (1)
    • 릿코드 문제풀이 (2)
    • 알고리즘 이론 (10)
      • 기본 이론 (2)
      • 배열과 문자열 (8)
    • 데이터베이스 (15)
      • Planet Scale (1)
      • MSSQL (9)
      • 디비 기본 개념 (1)
      • SQLite 직접 만들어보기 (4)
    • 보안 (7)
    • 설계 (1)
    • 네트워크 (17)
      • HTTP (9)
      • OSI Layers (5)
    • 회고 (31)
      • 연간 회고 (2)
      • 주간 회고 (29)
    • 인프라 (52)
      • 도커 (12)
      • AWS (9)
      • 용어 (21)
      • 웹 성능 (1)
      • 대규모 서비스를 지탱하는 기술 (9)
    • 깃 (7)
    • 빌드 도구 (7)
      • 메이븐 (6)
      • 그레이들 (0)
    • Java (135)
      • 이펙티브 자바 (73)
      • 자바 API (4)
      • 자바 잡지식 (30)
      • 자바 디자인 패턴 (21)
      • 톰캣 (Tomcat) (7)
    • 프레임워크 (64)
      • next.js (14)
      • 스프링 프레임워크 (28)
      • 토비의 스프링 (6)
      • 스프링 부트 (3)
      • JPA (Java Persistence API) (5)
      • Nest.js (8)
    • 프론트엔드 (48)
      • 다크모드 (1)
      • 노드 패키지 관리 매니저 (3)
      • CSS (19)
      • Web API (11)
      • tailwind-css (1)
      • React (5)
      • React 새 공식문서 요약 (1)
      • HTML (Markup Language) (5)
    • 자바스크립트 (108)
      • 모던 자바스크립트 (31)
      • 개념 (31)
      • 정규표현식 (5)
      • 코드 스니펫 (1)
      • 라이브러리 (6)
      • 인터뷰 (24)
      • 웹개발자를 위한 자바스크립트의 모든 것 (6)
      • 팁 (2)
    • Typescript (49)
    • 리눅스와 유닉스 (10)
    • Computer Science (1)
      • Compiler (1)
    • IDE (3)
      • VSCODE (1)
      • IntelliJ (2)
    • 세미나 & 컨퍼런스 (1)
    • 용어 (개발용어) (16)
      • 함수형 프로그래밍 용어들 (1)
    • ORM (2)
      • Prisma (2)
    • NODEJS (2)
    • cypress (1)
    • 리액트 네이티브 (React Native) (31)
    • 러스트 (Rust) (15)
    • 코틀린 (Kotlin) (4)
      • 자바에서 코틀린으로 (4)
    • 정규표현식 (3)
    • 구글 애널리틱스 (GA) (1)
    • SEO (2)
    • UML (2)
    • 맛탐험 (2)
    • 리팩토링 (1)
    • 서평 (2)
    • 소프트웨어 공학 (18)
      • 테스팅 (16)
      • 개발 프로세스 (1)
    • 교육학 (1)
    • 삶의 지혜, 통찰 (1)
    • Chat GPT (2)
    • 쉘스크립트 (1)
    • 컴파일 (2)
    • Dart (12)
    • 코드팩토리의 플러터 프로그래밍 (4)
    • 플러터 (17)
    • 안드로이드 스튜디오 (1)
    • 윈도우즈 (1)
    • 잡다한 백엔드 지식 (1)
    • 디자인 패턴 (1)

블로그 메뉴

  • 홈
  • 태그
  • 방명록

공지사항

인기 글

태그

  • MSSQL
  • 자료구조
  • 자바스크립트 면접
  • 이펙티브 자바 item9
  • 자바 검증
  • try-with-resources
  • prerendering
  • Next.js
  • 싱글톤
  • Javadoc 자바독 자바주석 주석 Comment
  • item8
  • 도커공식문서
  • 러스트
  • 프로그래머의 뇌
  • bean Validation
  • 싱글턴
  • 토비의 스프링
  • Pre-rendering
  • rust
  • 느린 쿼리
  • 스프링 검증
  • 자바 디자인패턴
  • 작업기억공간
  • 빈 검증
  • 싱글톤 패턴
  • 팩터리 메서드 패턴
  • 메이븐 라이프사이클
  • 서버리스 컴퓨팅
  • 외래키 제약조건
  • 이펙티브 자바
  • item7
  • 디자인패턴
  • 메이븐 골
  • 자바
  • Java
  • item9
  • 이펙티브자바
  • 알고리즘
  • 슬로우 쿼리
  • 추상 팩터리 패턴
  • 참조 해제
  • 메이븐 페이즈
  • 자바스크립트
  • 자바스크립트 인터뷰
  • 객체복사
  • 플라이웨이트패턴
  • next js app
  • pnpm
  • serverless computing
  • NEXT JS

최근 댓글

최근 글

티스토리

hELLO · Designed By 정상우.
Jake Seo

제이크서 위키 블로그

Java/이펙티브 자바

이펙티브 자바, 쉽게 정리하기 - item 68. 일반적으로 통용되는 명명 규칙을 따르라

2023. 6. 28. 17:45

이펙티브 자바, 쉽게 정리하기 - item 68. 일반적으로 통용되는 명명 규칙을 따르라

자바 언어의 명명 규칙

  • 철자와 문법 2가지로 나뉜다.

철자 규칙

  • 패키지, 클래스, 인터페이스, 메서드, 필드, 타입 변수의 이름을 다룬다.

특별한 이유가 없는 한 반드시 따라야 다른 개발자들의 오해로 인한 실수가 생기지 않는다.

패키지 명명법

  • .으로 구분하여 계층적으로 이름을 짓는다.
  • 보통 인터넷 도메인 이름을 역순으로 사용한다.
    • ex) com.google
  • 표준 라이브러리 및 선택적 패키지는 java와 javax로 시작한다.
  • 이름은 보통 8자 이하의 짧은 단어로 한다.
    • utilities -> util
    • 약어라면, abstract window toolkit -> awt와 같이 가능하다.

클래스와 인터페이스 명명법

  • 열거타입과 애너테이션도 클래스 혹은 인터페이스로 본다.
  • 각 단어는 대문자로 시작한다.
  • 널리 통용된 줄임말(max, min 등)을 제외하고는 단어를 줄여쓰지 않는다.
  • 약자의 경우는 첫글자만 대문자로 할지 약간의 논쟁이 있으나, 첫글자만 대문자로 하는게 알아보기 좋다.
    • ex) HttpUrl vs HTTPURL
    • 전체를 대문자로 하면 어디서 끊어 읽어야 하는지에 대한 구분이 어렵다.

메서드와 필드 이름 명명법

  • 첫 글자를 소문자로 하는 것 이외에는 클래스, 인터페이스 명명법과 동일하다.
    • ex) remove(), ensureCapacity()

상수 필드 명명법

  • 상수 필드란 아래와 같은 경우가 있다.
    • enum 의 열거 이름들
    • static final 접근 제어자로 표현되는 필드
  • 모두 대문자로 쓰며, 단어 사이는 밑줄로 구분한다.
    • ex) VALUES, NEGATIVE_INFINITY

지역 변수 명명법

  • 지역 변수에 한해서는 문맥에서 의미를 쉽게 유추할 수 있는 경우에 한해 약어를 써도 된다.
  • 입력 매개변수도 지역 변수의 일종으로 본다.

타입 매개변수(제네릭) 명명법

  • T: 임의의 타입을 말한다.
  • E: 컬렉션 원소의 타입을 말한다.
  • K, V: 맵의 키와 값을 말한다.
  • X: 예외를 말한다.
  • R: 메서드의 반환 타입을 말한다.
  • T, U, V, T1, T2, T3: 임의의 타입 시퀀스를 말한다.

문법 규칙

  • 철자 규칙에 비해 더 유연하고 논란도 많다.

클래스와 인터페이스

  • 객체를 생성할 수 있는 클래스(열거타입 포함)라면, 단수명사 혹은 명사구를 사용한다.
    • ex) Thread, PrioirtyQueue, ChessPiece
  • 객체를 생성할 수 없는 클래스라면, 보통 복수형 명사로 짓는다.
    • ex) Collections, Collectors
  • 인터페이스 이름은 able 혹은 ible 로 끝나는 형용사로 짓거나 클래스와 똑같이 짓는다.
    • ex) Runnable, Iterable, Accssible, Closeable

애너테이션

  • 애너테이션은 지배적인 규칙 없이 명사, 동사, 전치사, 형용사 두루 쓴다.
    • ex) BindingAnnotation, Inject, ImplementedBy, Singleton

메서드

  • 동작을 수행하는 메서드는 동사나 동사구로 짓는다.
    • ex) append, drawImage
  • boolean 값을 반환하는 메서드는 is나 has로 시작하고, 명사, 명사구, 형용사로 기능하는 아무 단어나 구로 끝나도록 짓는다.
    • ex) isDigit, isProbablePrime, isEmpty, isEnabled, hasSiblings
  • 반환 타입이 boolean 이 아니거나, 속성을 반환하는 메서드는 명사, 명사구 혹은 get으로 시작하는 동사구로 짓는다.
    • ex) size, hashCode, getTime
    • get 으로 써야 한다는 주장이 있지만, 때때론 get 을 안 쓰고 단순 명사로 짓는 것이 더 가독성이 좋다.
  • 객체의 타입을 바꿔서 다른 타입의 같은 내용의 객체를 반환할 때는 보통 toType 으로 짓는다.
    • ex) toString, toArray
  • 객체의 내용을 다른 뷰로 보여주는 메서드는 asType 형태로 짓는다.
    • ex) asList
  • 객체의 값을 기본 타입 값으로 반환하는 메서드의 이름은 보통 typeValue 형태로 짓는다.
    • ex) intValue
  • 정적 팩터리의 경우, from, of 등의 네이밍을 쓴다.
    • ex) valueOf, list.of

필드

  • 필드 이름은 클래스, 인터페이스, 메서드 이름에 비해 명확하고 덜 중요하다.
  • boolean 타입의 필드 이름은 보통 boolean 접근자 메서드에서 앞 단어를 뺀 형태다.
    • ex) initialized, composite
  • 다른 타입의 필드라면 명사, 명사구를 사용한다.
    • ex) height, digits, bodyStyle
  • 지역변수도 필드와 비슷하게 지으면 되는데, 조금 더 느슨하다.

핵심 정리

  • 표준 명명 규칙을 활용하여 자연스럽게 베어나오도록 하자.
  • 철자 규칙은 직관적이라 모호한 부분이 적은데 반해 문법 규칙은 더 복잡하고 느슨하다.
  • 오랫동안 따라온 규칙과 충돌한다면 그 규칙을 맹신하지 말고 상식이 이끄는대로 따르자.
반응형
저작자표시 비영리 (새창열림)

'Java > 이펙티브 자바' 카테고리의 다른 글

이펙티브 자바, 쉽게 정리하기 - item 70. 복구할 수 있는 상황에는 검사 예외를 프로그래밍 오류에는 런타임(비검사) 예외를 사용하라  (0) 2023.06.29
이펙티브 자바, 쉽게 정리하기 - item 69. 예외는 진짜 예외 상황에만 사용하라  (0) 2023.06.28
이펙티브 자바, 쉽게 정리하기 - item 67. 최적화는 신중히 하라  (0) 2023.06.27
이펙티브 자바, 쉽게 정리하기 - item 66. 네이티브 메서드는 신중히 사용하라  (0) 2023.06.27
이펙티브 자바, 쉽게 정리하기 - item 65. 리플렉션보다는 인터페이스를 사용하라  (0) 2023.06.26
    'Java/이펙티브 자바' 카테고리의 다른 글
    • 이펙티브 자바, 쉽게 정리하기 - item 70. 복구할 수 있는 상황에는 검사 예외를 프로그래밍 오류에는 런타임(비검사) 예외를 사용하라
    • 이펙티브 자바, 쉽게 정리하기 - item 69. 예외는 진짜 예외 상황에만 사용하라
    • 이펙티브 자바, 쉽게 정리하기 - item 67. 최적화는 신중히 하라
    • 이펙티브 자바, 쉽게 정리하기 - item 66. 네이티브 메서드는 신중히 사용하라
    Jake Seo
    Jake Seo
    ✔ 잘 보셨다면 광고 한번 클릭해주시면 큰 힘이 됩니다. ✔ 댓글로 틀린 부분을 지적해주시면 기분 나빠하지 않고 수정합니다. ✔ 많은 퇴고를 거친 글이 좋은 글이 된다고 생각합니다. ✔ 간결하고 명료하게 사람들을 이해 시키는 것을 목표로 합니다.

    티스토리툴바