JavaのVoidクラスの使い方を完全ガイド！初心者でもわかるvoidとの違いや使い方

1. JavaのVoidクラスとは？

1. JavaのVoidクラスとは？

JavaのVoidクラスは、java.langパッケージに用意されているクラスです。Java初心者の場合、最初に覚えるvoidと名前が非常によく似ているため、同じものだと思ってしまうことがあります。しかし、小文字のvoidと大文字で始まるVoidは役割が異なります。

Voidクラスは、Javaで戻り値がないことに関連する型をクラスとして扱う必要がある場面などで利用されます。通常のJavaプログラムで頻繁に自分から使うクラスではありませんが、ジェネリクス、リフレクション、並行処理などを学習すると目にすることがあります。

Voidはjava.langパッケージに含まれています。StringやIntegerなどと同じように、java.langパッケージのクラスは自動的に利用できるため、通常はimportを書く必要がありません。

JavaのVoidクラスの使い方を理解するには、まず普段利用しているvoidがどのような役割を持っているのかを確認し、その後でVoidが必要になる場面を見ると分かりやすくなります。

2. voidとは？戻り値がないメソッドの基本

2. voidとは？戻り値がないメソッドの基本

Javaでメソッドを作るときには、そのメソッドがどのような値を返すのかを指定します。例えば、整数を返すメソッドならint、文字列を返すメソッドならStringを指定します。一方、呼び出し元へ値を返す必要がないメソッドではvoidを指定します。

次のプログラムでは、あいさつを表示するshowMessageメソッドを作っています。

public class VoidMethodExample {
    public static void main(String[] args) {
        showMessage();
    }

    public static void showMessage() {
        System.out.println("こんにちは");
    }
}

実行結果は次のようになります。

こんにちは

showMessageメソッドは画面へ文字を表示していますが、呼び出し元へ計算結果や文字列などの値を返しているわけではありません。そのため、戻り値を表す部分にvoidを指定しています。

ここで重要なのは、voidを指定したメソッドが何もしないという意味ではないことです。画面への表示、データの更新、オブジェクトの状態変更など、さまざまな処理を行えます。あくまで呼び出し元へ戻り値を返さないという意味です。

Java初心者がVoidクラスを学ぶときは、このvoidメソッドとの違いを意識しましょう。一般的な戻り値なしのメソッドを作るだけなら、大文字のVoidではなく小文字のvoidを使用するのが基本です。

3. Voidとvoidの違いを初心者向けに整理

3. Voidとvoidの違いを初心者向けに整理

JavaのVoidとvoidは、文字の大文字と小文字が違うだけに見えますが、Javaプログラミングでは明確に区別する必要があります。

例えば、単純に画面へメッセージを表示するメソッドを作りたいのであればvoidを使います。わざわざVoidを戻り値として指定する必要はありません。

一方、Javaのジェネリクスでは型引数としてクラスなどの参照型を指定します。そのため、戻り値がないことを型引数の形で表したい特殊な場面ではVoidが利用されます。

Integerとintの関係に少し似ているように見えるかもしれませんが、Voidをvoidの一般的なラッパークラスとして、Integerと同じ感覚で値を格納するために使うものだと考えるのは適切ではありません。Voidは通常の値を作って保存するためのクラスではないからです。

4. Voidはジェネリクスでどのように使う？

4. Voidはジェネリクスでどのように使う？

JavaのVoidクラスが必要になる代表的な場面の1つがジェネリクスです。ジェネリクスとは、クラスやインターフェース、メソッドなどで扱う型を後から指定できるJavaの仕組みです。

例えば、Javaの並行処理で利用されるCallableインターフェースは、処理結果を型引数で指定できます。整数を返すならCallable<Integer>、文字列を返すならCallable<String>のように記述できます。

しかし、処理は実行したいものの、意味のある結果を返す必要がない場合もあります。そのような場面ではCallable<Void>という形を利用できます。

import java.util.concurrent.Callable;

public class CallableVoidExample {
    public static void main(String[] args) throws Exception {
        Callable<Void> task = () -> {
            System.out.println("処理を実行しました");
            return null;
        };

        task.call();
    }
}

実行結果は次のようになります。

処理を実行しました

この例では、Callableの型引数としてVoidを指定しています。処理の中ではメッセージを表示していますが、意味のある戻り値は必要ありません。そのため、最後にnullを返しています。

Voidを利用した場合でも、メソッドの戻り値そのものが完全になくなるわけではない点に注意してください。Callable<Void>ではVoid型の戻り値が求められるため、通常はnullを返します。

ここがvoidとの大きな違いです。voidは戻り値そのものがないことを表しますが、Voidを型として利用する場合は参照型として扱われます。JavaでジェネリクスとVoidを組み合わせる場合には、この違いを理解しておくことが重要です。

5. Void.TYPEとは？void.classとの関係

5. Void.TYPEとは？void.classとの関係

JavaのVoidクラスには、TYPEというフィールドがあります。Void.TYPEは、voidを表すClassオブジェクトを取得したい場合に利用できます。

初心者には少し難しく感じる部分ですが、Javaではクラスや型についての情報をプログラムから調べる仕組みがあります。例えば、String.classと書くとStringクラスを表すClassオブジェクトを取得できます。

voidについてもvoid.classと記述できます。そして、Void.TYPEはvoid.classと同じClassオブジェクトを表します。

public class VoidTypeExample {
    public static void main(String[] args) {
        Class<Void> type1 = Void.TYPE;
        Class<Void> type2 = void.class;

        System.out.println(type1);
        System.out.println(type2);
        System.out.println(type1 == type2);
    }
}

実行結果は次のようになります。

void
void
true

最後にtrueが表示されていることから、Void.TYPEとvoid.classが同じものを表していることが確認できます。

普通のJavaプログラムでVoid.TYPEを頻繁に記述することはありません。しかし、Javaのリフレクションを使ってメソッドの戻り値を調べたり、フレームワークなどで型情報を扱ったりするときに関係してきます。

そのため、Java初心者の段階では、Voidクラスにはvoidを表す型情報を取得するためのTYPEがあり、Void.TYPEとvoid.classは同じものを表す、と覚えておけば十分です。

6. リフレクションでVoidが関係する場面

6. リフレクションでVoidが関係する場面

JavaのVoidについて調べていると、リフレクションという言葉を目にすることがあります。リフレクションとは、実行中のJavaプログラムからクラス名、メソッド名、戻り値の型などの情報を調べたり、それらを利用したりする仕組みです。

例えば、あるメソッドの戻り値がvoidなのかをプログラムから確認できます。次の例では、MethodクラスのgetReturnTypeメソッドを利用して戻り値の型を調べています。

import java.lang.reflect.Method;

public class ReflectionVoidExample {
    public static void showMessage() {
        System.out.println("Hello");
    }

    public static void main(String[] args) throws Exception {
        Method method = ReflectionVoidExample.class.getMethod("showMessage");

        if (method.getReturnType() == Void.TYPE) {
            System.out.println("戻り値のないメソッドです");
        }
    }
}

実行結果は次のようになります。

戻り値のないメソッドです

getReturnTypeメソッドを使うと、対象となるメソッドの戻り値の型をClassオブジェクトとして取得できます。この例ではshowMessageメソッドの戻り値がvoidなので、その型情報はVoid.TYPEと一致します。

リフレクションはJava初心者が最初から使う必要のある機能ではありませんが、Javaのフレームワークやライブラリでは重要な仕組みです。Voidクラスの存在理由を理解するときには、このようにJavaの型情報を扱う場面があることを知っておくと理解しやすくなります。

7. Void型の変数には何を入れる？

7. Void型の変数には何を入れる？

Voidはクラスなので、Javaの文法上ではVoid型の変数を宣言できます。ただし、StringやIntegerのように、通常の値を作って保存する目的で使うクラスではありません。

Voidクラスは、通常のプログラムからインスタンスを作って値を格納することを目的としていません。そのため、Void型を戻り値などに使う特殊な場面では、実際の値としてnullを扱う形が基本になります。

public class VoidVariableExample {
    public static void main(String[] args) {
        Void result = null;

        System.out.println(result);
    }
}

実行結果は次のようになります。

null

このプログラムではVoid型の変数resultを宣言し、nullを代入しています。nullとは、参照するオブジェクトが存在しないことを表すJavaの特別な値です。

ただし、単にnullを保存するために普段からVoid型の変数を作る必要はありません。通常のJavaプログラミングでは、このような変数を積極的に使うことはほとんどありません。Voidは、ジェネリクスなどで型として指定する必要があるものの、意味のある戻り値を必要としない場合に利用されると考えると分かりやすいでしょう。

8. Voidを使う場面と使わない場面

8. Voidを使う場面と使わない場面

JavaのVoidクラスを学ぶと、どのような場面で自分のプログラムに使えばよいのか迷うかもしれません。基本的には、普段作成する戻り値のないメソッドでVoidを使う必要はありません。

例えば、ユーザー情報を画面に表示する処理、計算結果をコンソールへ表示する処理、オブジェクトの状態を変更する処理など、値を呼び出し元へ返さない一般的なメソッドではvoidを指定します。

一方で、ジェネリクスの型引数として戻り値がないことに相当する型を指定したい場合にはVoidが役立ちます。先ほど確認したCallable<Void>は代表的な例です。また、Javaのリフレクションで戻り値がvoidかどうかを調べる場合には、Void.TYPEを利用できます。

このように整理すると、Voidは何か具体的な値を保存するためのクラスというより、Javaの型を扱う仕組みの中で、戻り値がないことに関連して利用される特殊なクラスだと理解できます。

Java初心者の場合、最初からVoidを積極的に使おうとする必要はありません。まずはメソッドの戻り値として使うvoidを正しく理解し、その後ジェネリクスやリフレクションを学習したときにVoidとの関係を確認するのがおすすめです。

9. Voidで初心者が間違えやすいポイント

9. Voidで初心者が間違えやすいポイント

JavaのVoidで初心者が特に間違えやすいのは、voidと同じように使えると思ってしまうことです。名前がほぼ同じなので混乱しやすいですが、通常のメソッドで戻り値がないことを指定する場合には小文字のvoidを使います。

また、VoidをIntegerやDoubleのような一般的なラッパークラスと同じ感覚で扱わないことも大切です。Integerなら整数値をオブジェクトとして扱えますが、Voidは具体的な戻り値を保存して利用するためのクラスではありません。

もう1つ覚えておきたいのが、Callable<Void>などでVoidを使った場合です。小文字のvoidメソッドと違って、Callableのcallメソッドには戻り値が必要です。そのため、意味のある値を返さない場合でもnullを返す必要があります。

さらに、Void.TYPEはVoidクラスそのものを表すVoid.classと同じものではない点にも注意しましょう。Void.TYPEはvoid.classと同じで、小文字のvoidに対応する型情報を表しています。

public class VoidClassExample {
    public static void main(String[] args) {
        System.out.println(Void.TYPE);
        System.out.println(Void.class);
        System.out.println(Void.TYPE == Void.class);
    }
}

実行結果は次のようになります。

void
class java.lang.Void
false

Void.TYPEはvoidを表していますが、Void.classはjava.lang.Voidクラスそのものを表します。この2つを比較すると結果はfalseになります。

JavaのVoidクラスを学習するときは、まずvoidとの違い、次にジェネリクスでの使い方、その後にVoid.TYPEとリフレクションという順番で理解すると整理しやすくなります。

Javaの学習では、voidは早い段階から登場しますが、Voidクラスを見る機会はそれほど多くありません。そのため、突然Voidという名前がコードに登場すると、単なる書き間違いではないかと感じることもあります。しかし、Javaのジェネリクス、並行処理、リフレクション、型情報などを扱う場面では、それぞれ明確な目的を持って利用されます。

まずは、voidは戻り値がない普通のメソッドで利用するもの、Voidはクラスとして型が必要になる特殊な場面で利用するもの、と区別しておきましょう。この基本が分かれば、JavaのコードでVoidを見つけたときにも、その周囲にジェネリクスや型情報を扱う処理がないかを確認できるようになります。

まとめ

まとめ

JavaのVoidクラスを理解するときに、最も大切なのは小文字のvoidとの違いを整理することです。名前はよく似ていますが、Javaでは役割が異なります。小文字のvoidは、メソッドから呼び出し元へ戻り値を返さないことを表します。一方、大文字から始まるVoidは、java.langパッケージに用意されているクラスです。Java初心者は、まずこの違いをしっかり覚えておくと、その後のジェネリクスやリフレクションも理解しやすくなります。

普通のJavaプログラムで、戻り値のないメソッドを作る場合にはvoidを使います。例えば、画面にメッセージを表示するだけのメソッドや、オブジェクトの状態を変更するメソッドなどでは、処理を実行しても呼び出し元へ値を返す必要がない場合があります。このようなメソッドの戻り値にはvoidを指定します。

ここで注意したいのは、voidが何も処理しないという意味ではないことです。戻り値を返さないという意味であり、メソッドの中では画面表示、計算、データの更新、別のメソッドの呼び出しなど、さまざまな処理を実行できます。Javaのメソッドと戻り値を学習するときには、処理をするかどうかと、値を返すかどうかを分けて考えることが重要です。

普通の戻り値なしメソッドではvoidを使う

Java初心者が最初に身につけたいのは、通常のメソッドではどのようにvoidを使うのかという基本です。次のサンプルプログラムでは、名前を受け取ってメッセージを表示するメソッドを作っています。

public class VoidMethodSample {
    public static void main(String[] args) {
        showMessage("田中");
    }

    public static void showMessage(String name) {
        System.out.println(name + "さん、こんにちは");
    }
}

実行結果は次のようになります。

田中さん、こんにちは

showMessageメソッドは文字を表示する処理を行っていますが、呼び出し元へ値を返していません。そのため、戻り値の部分にはvoidを指定しています。このような一般的な戻り値なしメソッドで、大文字のVoidへ置き換える必要はありません。

Javaのメソッドを作成するときは、まず処理結果を呼び出し元で利用する必要があるかを考えると分かりやすくなります。計算結果を返したいならintなどを使い、文字列を返したいならStringなどを使います。値を返す必要がなければvoidを選びます。

Voidはクラスとして型が必要な場面で登場する

Voidは普通の戻り値なしメソッドを作るためのものではありません。Javaで型をクラスとして指定しなければならない場面で、意味のある戻り値がないことを表現したい場合などに利用されます。

代表的なのがJavaのジェネリクスです。ジェネリクスでは、山括弧の中に扱う型を指定します。例えば、文字列を扱うならString、整数のオブジェクトを扱うならIntegerなどを指定できます。しかし、小文字のvoidを通常の参照型のようにジェネリクスの型引数として指定することはできません。

そこで、型を指定する必要はあるものの、意味のある結果を返す必要がない場合にVoidが利用されることがあります。Javaの並行処理で使われるCallableは、その代表的な例です。

import java.util.concurrent.Callable;

public class CallableVoidSample {
    public static void main(String[] args) throws Exception {
        Callable<Void> task = () -> {
            System.out.println("データを更新しました");
            return null;
        };

        Void result = task.call();
        System.out.println(result);
    }
}

実行結果は次のようになります。

データを更新しました
null

このプログラムでは、Callableの型引数としてVoidを指定しています。処理そのものは実行しますが、呼び出し元で利用するような意味のある結果はありません。そのため、callメソッドからnullを返しています。

ここはvoidとの違いが分かりやすい部分です。voidのメソッドには戻り値そのものがありません。一方、Voidを戻り値の型として利用する場合は参照型として扱われるため、値を返す必要がある場面では通常nullを返します。

VoidはIntegerのように値を保存するクラスではない

Javaを学習していると、intとInteger、doubleとDoubleのような組み合わせが登場します。そのため、voidとVoidについても、まったく同じ関係だと考えてしまうことがあります。

しかし、VoidをIntegerなどと同じ感覚で値を保存するために使うのは適切ではありません。Integerなら整数をオブジェクトとして扱えますが、Voidは具体的な値を作って保存するために利用するクラスではありません。

JavaのコードでVoid型の変数を見つけた場合は、何か特殊な値が入っていると考えるより、ジェネリクスなどで型を合わせるために使われていないかを確認すると理解しやすくなります。

Void.TYPEとvoid.classは同じ型情報を表す

VoidクラスにはTYPEというフィールドがあります。Void.TYPEは、小文字のvoidを表すClassオブジェクトです。Javaではクラスや型そのものに関する情報をプログラムから扱うことができ、このような情報を型情報として利用する場面があります。

Void.TYPEとvoid.classは同じ型情報を表します。一方で、Void.classは大文字のVoidクラスそのものを表すため、Void.TYPEとは異なります。この違いはJavaのリフレクションを扱うときに特に重要です。

public class VoidTypeSample {
    public static void main(String[] args) {
        System.out.println(Void.TYPE == void.class);
        System.out.println(Void.TYPE == Void.class);
    }
}

実行結果は次のようになります。

true
false

最初の比較がtrueになることから、Void.TYPEとvoid.classが同じ型情報を表していることが分かります。一方、Void.classはjava.lang.Voidクラスを表しているため、比較するとfalseになります。

Java初心者の段階では、Void.TYPEを日常的に使う必要はほとんどありません。それでも、Void.TYPEは小文字のvoidに対応する型情報であり、Void.classは大文字のVoidクラスを表すという違いを知っておくと、リフレクションを学習するときに混乱しにくくなります。

リフレクションではメソッドの戻り値を調べられる

Javaのリフレクションは、実行中のプログラムからクラスやメソッドなどの情報を調べるための仕組みです。例えば、メソッドの名前だけでなく、そのメソッドがどのような戻り値を持っているのかを調べることもできます。

戻り値がvoidのメソッドをリフレクションで調べると、その戻り値の型はvoid.classとして取得できます。そのため、Void.TYPEと比較して、戻り値のないメソッドかどうかを判定できます。

import java.lang.reflect.Method;

public class VoidReflectionSample {
    public static void printMessage() {
        System.out.println("こんにちは");
    }

    public static void main(String[] args) throws Exception {
        Method method = VoidReflectionSample.class.getMethod("printMessage");

        if (method.getReturnType() == Void.TYPE) {
            System.out.println("このメソッドの戻り値はvoidです");
        }
    }
}

実行結果は次のようになります。

このメソッドの戻り値はvoidです

リフレクションはJava初心者が最初に覚える機能ではありませんが、フレームワークやライブラリの内部では利用されることがあります。JavaのVoidクラスについて調べるとリフレクションが一緒に登場することがあるのは、Void.TYPEを利用してvoidの型情報を扱えるためです。

Voidとvoidの使い分けを整理して覚える

JavaのVoidとvoidを使い分けるときは、最初に普通のメソッドを作っているのか、それとも型そのものを扱う特殊な処理を作っているのかを考えると分かりやすくなります。

Java初心者が特に覚えておきたいのは、普段のプログラミングではvoidを使う場面のほうが圧倒的に多いということです。戻り値のないメソッドを作るたびにVoidを使う必要はありません。Voidはジェネリクスやリフレクションなど、クラスとして型を扱う必要がある場面で登場するものとして整理しておくとよいでしょう。

Voidを見つけたら周囲のコードを確認する

実際のJavaプログラムで大文字のVoidを見つけたときは、単純に小文字のvoidの代わりだと考えないようにしましょう。まず、山括弧の中に書かれているか、型情報を調べる処理で使われているかなど、周囲のコードを確認することが大切です。

例えばCallable<Void>のような形であれば、ジェネリクスの型引数として利用されています。Void.TYPEが書かれている場合は、voidの型情報を利用している可能性があります。このように周囲を見るだけでも、Voidが何のために使われているのかを判断しやすくなります。

また、Voidは通常の値を保存して計算したり、文字列のように加工したりするためのクラスではありません。Javaの型システムの中で、戻り値がないことに関連する型をクラスとして表現する必要がある場合に登場する特殊なクラスだと考えると、その役割をつかみやすくなります。

JavaのVoidクラスを理解することは、単に1つのクラスを覚えるだけではなく、Javaのメソッド、戻り値、参照型、ジェネリクス、リフレクション、型情報といった知識をつなげることにも役立ちます。特にvoidとの違いを説明できるようになれば、Javaの戻り値に関する理解がかなり整理できたと考えてよいでしょう。

Java初心者は、Voidの細かな仕様を最初からすべて暗記する必要はありません。まず、普通の戻り値なしメソッドではvoidを使うこと、Voidはクラスとして型が必要な場面で使われること、Void.TYPEとvoid.classは同じ型情報を表すことの3点を押さえておきましょう。この基本を理解しておけば、ジェネリクスやリフレクションを学習したときにも知識をつなげやすくなります。

この記事を読んだ人からの質問

この記事を読んだ人からの質問

プログラミング初心者からのよくある疑問／質問を解決します

Javaの「Voidクラス」とは具体的にどのような役割を持つクラスなのですか？プログラミング初心者にもわかりやすく教えてください。

JavaのVoidクラスは、メソッドが戻り値を返さないという状態を「オブジェクト（型）」として表現するために存在する、非常に特殊な参照型クラスです。通常、Javaのプログラミングにおいて戻り値がない場合は小文字の「void」というキーワードを使いますが、これだけでは「クラス」として扱うことができません。Voidクラス（大文字のVから始まるもの）を使うことで、本来は値を返さない処理であっても、ジェネリクス（汎用的な型）の仕組みの中で一つの型として定義できるようになります。初心者の方にとっては少し難しく感じるかもしれませんが、「値を返さないことをクラス形式で証明するための道具」と考えると理解しやすいでしょう。

Javaのソースコードでよく見かける小文字の「void」と、今回解説されている大文字の「Voidクラス」の決定的な違いは何ですか？

小文字の「void」はJavaの基本キーワード（プリミティブな型に近い扱い）であり、メソッドの定義において「このメソッドは何も返しません」という宣言に使われる予約語です。一方、大文字の「Void」は、java.langパッケージに属する「クラス（参照型）」です。この二つの決定的な使い分けのポイントは、ジェネリクス（Generic）が使えるかどうかです。Javaのリストやマップ、インターフェースの型指定には「クラス」しか指定できないため、戻り値がない処理をジェネリクスの型として渡したい場合には、キーワードのvoidではなく、Voidクラスを使用する必要があります。

JavaのVoidクラスを実際に使うシーンとして、具体的にどのようなプログラムの例がありますか？

代表的な使用例は、記事内でも紹介されている「Callableインターフェース」との組み合わせです。Callableは通常、何らかの計算結果や処理結果を戻り値として返すタスクを定義するためのインターフェースですが、時には「非同期で処理は実行したいけれど、特に結果として返すデータはない」という場合があります。そのような時に「Callable＜Void＞」と定義することで、Javaの文法を守りつつ、実際には何も返さないタスクを並列処理やスレッドとして実行させることが可能になります。また、リフレクション（プログラムの構造を調べる機能）でメソッドの戻り値の型を判定する際にも使われます。