【Java】開発者が読むべき標準ドキュメント

こんにちは。駆け出しプログラマーの松倉です！

ここでは、Javaドキュメントとその参照方法について紹介・解説します。

プログラミング未経験の方、Javaについて勉強している方、これから勉強したいと思っている方の参考になれば幸いです！ 

関連記事リンク：【Java】プログラミングでのコメントの書き方とJavadocコメントから APIリファレンスを生成方法を詳しく解説、【Java】標準入出力とは？書式指定のやり方は？Scannerクラスとは？　使い方を解説！、【Java】java.io.Fileクラスを使えばファイル・ディレクトリ操作ができる！？

Java ドキュメントとは

Javaのドキュメントとは、Javaを開発に必要な Javaの仕様、プログラミング、新機能について網羅されているオラクル社が公式に公開しているものです。

これを参考にしながらプログラム開発を行うことも多いです。

この記事では Javaドキュメントとその参照方法について以下の解説をします。

・Java チュートリアル （Java 入門者 ～ 初心者向け）

・Java API ドキュメント （標準 API リファレンス）

・ドキュメントの参照方法

・開発者ガイド （Java 開発者、システム管理者向け）

Java チュートリアル （Java 入門者 ～ 初心者向け）

Oracle社が公式に公開している Java プログラミング言語を使用してアプリケーションを作成したいプログラマー向けの実践的なガイドドキュメントのことです。

Javaプログラミング言語の重要な概念と機能の Java言語の学習や例外、基本的な I/O、同時実行性、正規表現、プラットフォームの環境についてなど 、実用的なコードと練習問題が数多く含まれているページです。

プログラミング初心者の方が多く受講しています。

これから学ぶ方は試してみてもよいかもしれません。

Oracle社が提供しているページはこちらです。

Java API ドキュメント （標準 API リファレンス）

Javaの API(Application Programming Interface )とは Javaでアプリケーションを作成するために必要となるクラスをまとめたクラスライブラリのことです。

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

開発者は APIを使用することにより、プログラムのコードを一から書く必要がないため、開発を効率良く進めることができるようになります。

クラスは機能や目的ごとにパッケージとして格納されており、コンソールに文字列を出力する処理も、Javaが提供している APIを使用しています。

サンプルコードを見てみましょう。

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

これは、java.langパッケージの Systemクラスを指しています。

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

普段使う Dateクラスや Calendarクラスのような Java APIを活用することで、一からコードを書く必要がなくなり日付を取得や特定の日時を設定・出力を簡単に実現することができます。

ドキュメントの参照方法

Javaのドキュメントの参照方法について解説します。

Oracle社が提供しているこちらのページをクリックしてみましょう。

注意：公式ページは頻繁に更新されるため、本記事で紹介した手順と異なる可能性があります。(2021/1/24現在)

本記事では Java8を例として解説します。

Java8の日本語のリンクを選択しましょう。

次のページが表示されます。

Javaの APIはバージョンによって使い方が微妙に異なったり、使用そのものが非推奨になったりします。

使用する Javaのバージョンを確認して、ドキュメントを参照しましょう。

※インターネット環境がない場合、参照したいドキュメントを事前にダウンロードすることで参照することができます。

リファレンスの・Java SE APIドキュメントを選択しましょう。

次のページが表示されます。

このページではパッケージ、クラス、説明の3つに分かれています。

パッケージ

ページ左上のパッケージでは目的のクラスのパッケージを指定します。

最初は指定されていないためすべてのクラスが表示されています。

パッケージを選択するとそのパッケージのクラスのみが表示されます。

クラス

ページ左下のクラスでは目的のクラスを選択します。

選択するとクラスの説明とコンストラクタ、メソッドの説明と利用方法が記述されます。

説明

ページ右の説明では主に以下のようなパートで構成されています。

・クラスの説明

・コンストラクタ

・メソッド

・クラスが持つ、メソッドの一覧

メソッドの一覧では機能概要、戻り値の型、メソッド名、引数の型、メソッドの説明、定義されている例外の詳細が書かれています。

例として java.langパッケージを指定すると、Mathや Stringクラスについての説明を見ることができます。

使い方がわからなくなった場合に利用しましょう！

開発者ガイド （Java 開発者、システム管理者向け）

開発者ガイドとはシステム管理者に対して Java SE及び JDKで開発するために必要な情報が網羅されたドキュメントです。

これは対象読者がビジネス分野に関する基礎的知識と実践的知識とコンピュータのデスクトップ・アプリケーションの使用方法とその用語の知識を持つ人たちに向けられて作られたマニュアルです。

そのため経験者や多くの知識を持つ方のためのページとなっています。

Oracle社が提供しているページはこちらです。

まとめ 

Javaドキュメントとその参照方法について解説しました。

Javaの APIは膨大な数に上り、あらゆる機能が用意されています。

Javaの APIを使えるようになると、正確で効率的なコーディングや開発スピードの向上につながります。

そのためより複雑なプログラムを書くことができコーディング上達の手助けになると思います！

今回の記事で紹介した Webサイトは Oracle社が公式に公開しているため、どのサイトよりも信頼性があります。

他の記事で疑問に思ったり、不安な場合は必ず確認しましょう。

クラスの説明だけではなく Javaのバージョンアップのリリースノート、新機能なども書かれているので時間があるときに目を通しておくと知識も付くためおすすめですよ！

関連記事リンク：【Java】プログラミングでのコメントの書き方とJavadocコメントから APIリファレンスを生成方法を詳しく解説、【Java】標準入出力とは？書式指定のやり方は？Scannerクラスとは？　使い方を解説！、【Java】java.io.Fileクラスを使えばファイル・ディレクトリ操作ができる！？