【JavaAPIとは？】標準APIの使い方とリファレンスを解説！

2024年3月1日

中沢丈

Javaには開発を行うために便利な標準APIがたくさん用意されています。

そこで、この記事ではよく使用するAPIや便利なAPIなどについて解説いたします。

【基礎】Javaのリファレンスとは
【基礎】JavaのAPIとは
【基礎】JavaのAPIドキュメントの読み方
【発展】代表的なインタフェースの解説
【発展】代表的なクラスの解説
【発展】その他の便利なAPI
【発展】旧バージョンのAPI

JavaのAPIドキュメントは情報量が膨大で、書いてあることもなんだか難しそうで、慣れないと戸惑ってしまうかもしれません。

しかし、APIをうまく使いこなすことがJavaプログラマとして上達するための近道となります。

ここではそんなJavaの標準APIについて詳しく解説していきます！

なお、Javaの記事については、こちらにまとめています。

Javaのリファレンスとは

shutterstock_524370115
Javaのリファレンスとは、オラクル社が公開しているJavaを開発するために必要な情報が書かれているドキュメントのことを言います。

Javaのリファレンスは、Javaをインストールして開発を行うための情報や、Javaの仕様、プログラミングをするために必要なパッケージやクラスなどの情報について網羅されている公式のリファレンスのことを指します。

以下ではドキュメントを「基本」「少し詳しい人向け」「ツール関係」と分けてそれぞれ簡単に解説いたします。

初心者の方には難しい内容も含まれていますので、今の段階ではこのようなドキュメントがあるということを頭の片隅にでも留めておいていただければと思います。

基本ドキュメント

・Java SE APIドキュメント
Java SE（Java Platform, Standard Edition）及びJDK（Java Development Kit ）に関するドキュメントの一覧があるページです。過去のバージョンを遡って閲覧することもできます。

・開発者ガイド
Java SE及びJDKで開発するために必要な情報が網羅されています。

少し詳しい人向けのドキュメント

・JavaFX APIドキュメント
Java仮想マシンで動作するGUIライブラリのAPIドキュメントです。

・Java言語および仮想マシン仕様
Java言語および仮想マシンについての仕様が網羅されているドキュメントです。全て英文です。

ツール関係のドキュメント

・Java SEツール・リファレンス(UNIX)
UNIXでJava Platform, Standard Editionのツールを使用するためのリファレンスです。

・Java SEツール・リファレンス(Windows)
WindowsでJava Platform, Standard Editionのツールを使用するためのリファレンスです。

JavaのAPIとは

shutterstock_448000054
JavaのAPI（Application Programming Interface ）は、Javaでアプリケーションを作成するために必要となる標準機能を提供するインタフェースのことです。

APIについては以下の記事で詳しく解説していますので、ぜひ参考にしてください！

APIとは？意味や仕組み、活用するメリットもわかりやすく解説

更新日：2024年4月19日

Javaには多数の機能が提供されており、Javaの機能を有効に使うためにはAPIの使用が必須となります。

開発者はJavaのルールに従ってAPIを使用することにより、自分で1から実装することなく用意されたAPIを使用することで効率よく開発することができます。

例えば、以下のようにコンソールに文字列を出力するおなじみの処理も、Javaが提供しているAPIを使用しています。

System.out.println("Hello World");

これは、Systemクラスのoutというクラスフィールドを取得し、outクラスフィールドで使用できるprintlnメソッドを呼出して、引数で指定された変数や文字列を出力するJavaのAPIです。

JavaのAPIドキュメントの読み方を知ろう

shutterstock_397574674
ここではJavaのAPIドキュメントの読み方について見ていきましょう。

javaの最新バージョンであるJava 8のAPIは以下より確認できます。
https://docs.oracle.com/javase/jp/8/docs/api/

APIのリファレンスにアクセスしてみると、画面が3分割されていて、左上にパッケージ、左下にはクラスのリンクがそれぞれ記載されています。

javaapi_image1
Java(tm) Platform, Standard Edition 8

APIの種類について知ろう

Javaはパッケージを指定することで、そのパッケージに含まれる機能を使用してプログラミングを行います。

パッケージとはJavaの名前空間にあるクラスやインタフェースをまとめた機能です。

クラスやインタフェースにはさらに固有の機能を使うためのメソッドが用意されています。

JavaのAPIでは、

・パッケージ
・パッケージで使用するクラス・インタフェース
・クラス・インタフェースで使用するメソッド

などがそれぞれグループごとにまとめられています。

Javaなどのオブジェクト指向言語では、パッケージやクラス・インタフェース、メソッドなどをそれぞれモノ（オブジェクト）として表現されます。

オブジェクト指向については以下の記事でも詳しく解説していますので、ぜひ参考にしてください！

オブジェクト指向とは？意味や言語の種類、基礎知識もわかりやすく解説

更新日：2024年4月16日

脱初心者のためのオブジェクト指向再入門

更新日：2024年3月1日

クラスの説明の読み方

ここではJavaのAPIからStringクラスを例に読み方を紹介します。

JavaのAPIであるJava(tm) Platform, Standard Edition 8にアクセスしてクラスからStringを探して選択してみましょう。

javaapi_image2

クラスStringのページを上から順に確認すると、まずStringクラスを使うためには、Java.langというパッケージが必要ということが分かります。

さらにStringクラスの概要や定義の方法、使い方が詳細に解説されています。

フィールド、コンストラクタ、使用できるメソッドなど、Stringクラスを使うために必要な情報も網羅されていることがわかります。

メソッドの説明の読み方

メソッドは上述したように、そのクラスやインタフェースで使用できる機能のことを指します。

たとえば、Stringでどのようなメソッドが使用できるかを確認するには、APIのStringクラスのページをスクロールしていくと、以下のようなメソッドの一覧が表示されます。

javaapi_image3

デフォルトでは使用できる全てのメソッドが表示されていますが、「静的メソッド」「インスタンス・メソッド」「具象メソッド」「非推奨メソッド」をそれぞれ選択して表示することもできます。

メソッドの一覧の中から、例えば文字列を比較するequalsメソッドの使い方を知りたい場合は、「メソッドと一覧」からequalsのリンクをクリックすると、equalsについて解説されているリンク先に飛ぶことができます。

javaapi_image4

リンク先ではメソッドの解説や「オーバーライド」「パラメータ」「戻り値」「関連項目」などの内容が解説されています。

javaapi_image5

インタフェース

shutterstock_330786716
ここではJavaのAPIの中から、よく使うインタフェースについて紹介していきます。

インタフェース（interface）とは、具体的な内容を書かずにメソッドの型のみを宣言したクラスのようなものを言います。

インタフェースの詳しい解説については以下の記事を参考にしてください！

【Java入門】interfaceとimplementsの使い方を基礎の基礎から解説！

更新日：2024年3月1日

List

Listは格納した順にindexが生成され、値と紐づけされるコレクションです。

Listはindexを指定して要素にアクセスしたり、Listで格納した値を検索することもできます。

使用するパッケージ：
java.util

オブジェクトの生成：

List<String> list = new ArrayList<>();

代表的なメソッド：
add(E e), get(int index), size()

使用例：sizeメソッドで要素数を調べる

//オブジェクトの生成
List<String> list = 
new ArrayList<String>(
    Arrays.asList("apple", "orange", "melon"));
 
System.out.println("List = " + list);
System.out.println("要素数 = " + list.size());

実行結果：

List = [apple, orange, melon]
要素数 = 3

Listインタフェースの使い方については、以下の記事でも詳しく解説しています！

JavaのList型とは！？ArrayListの使い方を基礎の基礎から解説！

更新日：2024年3月29日

Map

Mapは「キー」と「値」の2つの要素で構成されるコレクションです。

Mapの値にアクセスするにはキーを指定します。

使用するパッケージ：
java.util

オブジェクトの生成：

Map<String, String> map = new HashMap<>();

代表的なメソッド：
put(K key, V value), containsKey(Object key)

使用例：値の追加

//オブジェクトの生成
private static Map<String, String> map = new HashMap<>();
static {
     map.put("item1", "apple");
     map.put("item2", "orange");
     map.put("item3", "melon");
}
 
public static void main(String[] args) {
    for(Map.Entry<String, String> entry : map.entrySet()) {
        System.out.println(entry.getKey() + " : " + entry.getValue());
    }
}

実行結果：

item2 : orange
item1 : apple
item3 : melon

Mapインタフェースの使い方については、以下の記事でも詳しく解説しています！

【Java入門】Mapの使い方総まとめ(HashMapで初期化、値のソート)

更新日：2024年3月29日

Set

Setは重複しない要素の集まりがあるコレクションです。

Listはindexの順番通りに並んだ要素のコレクションで重複した要素を持つことができますが、Setでは重複した要素を持つことはできません。

使用するパッケージ：
java.util

オブジェクトの生成：

Set<String> set = new HashSet<>();

代表的なメソッド：
add(E e), remove(Object o), size()

使用例：値の追加

public static void main(String[] args) {

    //オブジェクトの生成
    Set<String> set = new HashSet<>();
    Collections.addAll(set, "apple", "orange", "melon");

    for (Iterator<String> itr = set.iterator(); itr.hasNext();) {
        System.out.println(itr.next());
    }
}

実行結果：

orange
apple
melon

Setインタフェースの使い方については、以下の記事でも詳しく解説しています！

【Java入門】ListとSetクラスの変換・違いまとめ

更新日：2024年3月1日

クラス

shutterstock_526821523
ここではJavaのAPIの中から、よく使うクラスについて紹介していきます。

クラス（class）とはJavaプログラムの1番外側に記述し、1つの機能をひとまとめにしたもので、クラスの中には処理に必要なメソッドや変数などをまとめて記述します。

クラスの生成：

class クラス名{
…
}

クラスの使い方については次の記事でも詳しく解説しています。

【Java入門】クラスの使い方総まとめ

更新日：2024年3月29日

String

StringクラスはJavaの中でも使用頻度が高いクラスです。

主に文字列を生成したり、結合・置換などの文字列操作を行うときに使用します。

使用するパッケージ：
java.lang

オブジェクトの生成：

//文字列を生成
String str1 = "Hello";

//オブジェクトを生成して文字列を指定
String str2 = new String("Java!!");

代表的なメソッド：
format(String format, Object… args), indexOf(String str), isEmpty()

使用例：値の追加

public static void main(String[] args) {

    //文字列を生成
    String str1 = "Hello";

    //オブジェクトを生成して文字列を指定
    String str2 = new String("Java!!");
    
    System.out.println(str1);
    System.out.println(str2);
}

実行結果：

Hello
Java!!

Stringクラスの使い方については、以下の記事でも詳しく解説しています！

【Java String】7つの基本的な使い方で文字列操作を理解しよう

更新日：2021年9月9日

File

Fileクラスはファイルを扱うためのクラスです。

ファイルを扱うには、オブジェクトを生成して、生成したオブジェクトに対してファイルの読み込みや書き込みなどのファイル操作を行います。

使用するパッケージ：
java.io

オブジェクトの生成：

File file = new File(ファイル名);

代表的なメソッド：
delete(), exists(), getName()

使用例：ファイルの存在を調べる

public static void main(String[] args) {

    //オブジェクトの生成
    File file = new File("java.txt");
        
    // ファイルの存在確認
    if(file.exists()){
    System.out.println("ファイルが存在します。");
    }else{
    System.out.println("ファイルが存在しません。");
    }
}

Fileクラスの使い方については、以下の記事でも詳しく解説しています！

JavaのFileクラスをマスター！基礎から便利な使い方まで総まとめ

更新日：2024年3月1日

Calendar

Calendarクラスは、特定の日付や日時を指定して日付の操作を行うためのクラスです。

使用するパッケージ：
java.util

オブジェクトの生成：

Calendar cl = Calendar.getInstance();

代表的なメソッド：
add(int field, int amount), get(int field), getInstance(),

使用例：ファイルの存在を調べる

public static void main(String[] args) {

    //Calendarクラスのオブジェクトを生成
    Calendar cl = Calendar.getInstance();
    
    //現在の年月日を取得する
    System.out.println("YEAR：" + cl.get(Calendar.YEAR));
    System.out.println("MONTH：" + cl.get(Calendar.MONTH)); 
    System.out.println("DATE：" + cl.get(Calendar.DATE));
}

実行結果：

YEAR：2017
MONTH：8
DATE：17

CalendarクラスやDateクラスは月またぎの問題があり、0が1月となりますので注意しましょう。

Calendarクラスの使い方については、以下の記事でも詳しく解説しています！

【Java入門】Calendarクラスの使い方を完全解説(set/add/format)

更新日：2024年3月1日

ArrayList

ArrayListクラスは要素数が決まっていない動的な配列で、コレクションの中でもよく使用されます。

使用するパッケージ：
java.util

オブジェクトの生成：

List<データ型名> list = new ArrayList<データ型名>();

代表的なメソッド：
add(E e), get(int index), ort(Comparator<? super E> c)

使用例：値の追加

public static void main(String[] args) {

    //オブジェクトの生成
    List<String> list = new ArrayList<>();
 
    list.add("apple");
    list.add("orange");
    list.add("melon");
        
    for(Iterator it = list.iterator(); it.hasNext();) {
        System.out.println(it.next());
    }

}

実行結果：

apple
orange
melon

ArrayListクラスの使い方については、以下の記事でも詳しく解説しています！

JavaのList型とは！？ArrayListの使い方を基礎の基礎から解説！

更新日：2024年3月29日

Date

Dateクラスは、指定した日時を取得したり、日時を計算したいときに使用します。

使用するパッケージ：
java.util

オブジェクトの生成：

Date date = new Date();

代表的なメソッド：
compareTo(Date anotherDate), getTime(), toString()

使用例：現在の日付を取得

public static void main(String[] args) {

    //Dateクラスのオブジェクトを生成する
    Date date = new Date();
        
    //現在の日時を出力する
    System.out.println(date.toString());

}

実行結果：

Sun Sep 17 02:43:03 UTC 2017

Dateクラスの使い方については、以下の記事でも詳しく解説しています！

【Java】Dateクラスで日付を扱う方法を5つのパターン別に解説

更新日：2024年3月1日

Math

Mathクラスは基本的な数値の計算を行うときに使用します。

使用するパッケージ：
java.lang

オブジェクトの生成：
Mathクラスはオブジェクトを生成しなくても使用できます。

代表的なメソッド：
abs(型 a), max(型 a), min(型 a), pow(型 a, 型 b), random()

使用例：乱数を生成する

public static void main(String[] args) {

    //乱数を生成し、整数に四捨五入する
    double dnum = Math.random()*10;
    dnum = Math.ceil(dnum);
    System.out.println(dnum);

}

実行結果：