12.1 API 도큐먼트
자바 표준 모듈에서 제공하는 라이브러리는 방대하기 때문에 쉽게 찾아서 사용할 수 있도록 도와주는 API(Application Programming Interface) 도큐먼트가 있다. 라이브러리가 클래스와 인터페이스의 집합이라면, API 도큐먼트는 이를 사용하기 위한 방법을 기술한 것이다.
다음 URL을 방문하면 JDK 버전별로 사용할 수 있는 API 도큐먼트를 볼 수 있다.
자바 버전을 선택하고 왼쪽 메뉴에서 [API Document] 버튼을 클릭하면 다음과 같이 각 버전에 따른 API 도큐먼트 페이지가 열린다.
String 도큐먼트를 통해 API 도큐먼트를 읽는 방법을 알아보자.
클래스 선언부 보기
API 도큐먼트에서 String 클래스가 어떻게 정의되었는지 보려면 1번 선언부를 보면 된다. 여기서는 클래스가 final인지 추상(abstract)인지를 알 수 있고, 부모 클래스와 구현 인터페이스를 볼 수 있다. 전체 상속 관계를 보려면 2번 상속 계층도를 보면 된다.
구성 멤버 보기
String이 가지고 있는 멤버를 보려면 상단 메뉴의 SUMMARY를 활용한다. SUMMARY는 선언된 멤버별로 이동하는 링크를 제공한다. 링크가 있으면 공개된(public, protected) 멤버가 있다는 뜻이고, 링크가 없으면 공개된 멤버가 없다는 뜻이다.
필드 보기
SUMMARY에서 FIELD 링크를 클릭하면 필드 목록으로 이동한다.
Modifier and Type 에서는 static 여부와 필드 타입을 알 수 있고, Field와 Description은 필드명과 그에 대한 간단한 설명이다. 필드명을 클릭하면 필드 선언부와 상세한 설명이 나온다. 관례적으로 필드 이름이 모두 대문자이면 public static final로 선언된 상수 필드이다.
생성자 보기
SUMMARY에서 CONSTR 링크를 클릭하면 생성자 목록으로 이동한다.
Constructor 에서는 생성자의 매개변수 타입을 알 수 있고, Description은 이에 대한 간단한 설명이다. String 클래스는 매개변수 타입과 개수를 달리한 10개가 넘는 생성자들이 오버로딩되어 있다. 이 생성자들 중 하나를 이용해서 String 객체를 생성할 수 있다.
메소드 보기
SUMMARY에서 METHOD 링크를 클릭하면 메소드 목록으로 이동하는데, 다음과 같이 서브 목록으로 가는 버튼들을 볼 수 있다.
Modifier and Type 에서는 static 여부와 리턴 타입이 무엇인지 알 수 있다. Method에서는 메소드명과 매개변수 타입 및 개수를 알고 있고, Description은 그에 대한 간단한 설명이다. 각 메소드명을 클릭하면 상세 설명을 읽을 수 있다.
12.2 java.base 모듈
java.base는 모든 모듈이 의존하는 기본 모듈로, 모듈 중 유일하게 requires 하지 않아도 사용할 수 있다. 이 모듈에 포함되어 있는 패키지는 대부분의 자바 프로그램에서 많이 사용하는 것들이다. 다음은 java.base 모듈에 포함된 주요 패키지와 용도를 설명한 표이다.
우리가 지금까지 사용한 String, System, Integer, Double, Exception, RuntimeException 등의 클래스는 java.lang 패키지에 있고, 키보드 입력을 위해 사용한 Scanner는 java.util 패키지에 있다.
java.lang은 자바 언어의 기본적인 클래스를 담고 있는 패키지로, 이 패키지에 있는 클래스와 인터페이스는 import 없이 사용할 수 있다. 다음은 java.lang 패키지에 포함된 주요 클래스와 용도를 설명한 표이다.
12.3 Object 클래스
'자바 > 이것이 자바다' 카테고리의 다른 글
| 14. 멀티 스레드 (1) | 2023.11.17 |
|---|---|
| 13. 제네릭 (1) | 2023.11.17 |
| 11. 예외 처리 (0) | 2023.11.15 |
| 10. 라이브러리와 모듈 (0) | 2023.11.15 |
| 9. 중첩 선언과 익명 객체 (0) | 2023.11.15 |
