JAVA API 보는법 - 1

JAVA API는 창이 세 개로 나뉘어져 있습니다.

왼쪽 상단은 Package구요 여기서 하나를 선택하면 왼쪽하단에 모든 클래스가 나타납니다.

그리고 클래스를 클릭하면 오른쪽 에 메인 화면이 나타납니다.

우선 API문서를 제대로 사용하고자 한다면 먼저 자바에 대해 공부하는게 맞겟죠?

API는 기본적으로 어느 Package에 어느 클래스가 어떠한 기능을 하는지 알고 있어야 하거든요.

예를 들어 System.out.println을 보겠습니다.

우선 클래스는 - 대문자로 시작합니다(ex : JComponent)

클래스 안의 필드는 소문자로 사용하구요 

클래스 안의 메소드는 맨앞글자는 소문자 메소드를 구성하는 단어의 첫글자는 대문자로 사용합니다(ex : isTrue(), createStatement(), initialCondition())

따라서 System은 클래스를 의미하고 out은 필드 println은 메소드가 되겠습니다.

일단 API에서 이 System이라는 클래스가 무슨일을 하는지 알아봐야 할텐데 문제는 어느 클래스에 있는지 알 수가 없다는 것입니다.

그래서 우선 All classes 를 클릭하면 모든 클래스가 나옵니다

여기서 Ctrl + F를 눌러 system을 검색합니다.

그리고 System 클래스는 Object 클래스를 상속받고 있씁니다.

자바의 모든 클래스는 묵시적으로 Object 클래스를 상속받고 있다는 점을 감안하면 System클래스는 최상의 클래스라 할 수 있습니다.

그리고 아래에 클래스에 대한 설명이 나옵니다

Object클래스를 상속받고 final 종단클래스임을 뜻하죠 그 다음줄에는 

"몇 가지 유용한 클래스 필드와 메소드들을 포함하고 있다. 이 값들은 초기화 될 수 없다"라 나옵니다 

클래스의 설명이 끝나면 Field Summary와 Method Summary가 나옵니다

System.out.println()을 보면

out이 System 클래스에 정의되고 static final PrintStream임을 알 수 있습니다.

단순히 System.out.println()을 봤을 때는 클래스 필드 메소드밖에 모르지만 API를 보면 비로소 어느 형의 필드인지 기능은 어떠한지 알 수 있습니다 여기선 PrintStream으로 정의된 out을 알 수 있었습니다.

Field Sumarry 에서 out을 누르면 좀 더 자세한 내용을 알 수 있습니다.

The "standard" output stream. This stream is already open and ready to accept output data. Typically this stream corresponds to display output or another output destination specified by the host environment or user.

이것은 표준 output stream이고 이것은 이미 출력 데이터를 받아들일 준비가 되어 열려있다. 라고 나와 있습니다

그렇기에 우리는 클래스 정의 없이 언제나 System.out.println()을 사용 할 수 있는것입니다.

글이 길어졌네요 좀더 자세한 내용은 다음에 더 쓰도록 하겠습니다.