カテゴリ: Javaのユーティリティクラス 更新日: 2026/07/28

JavaのBase64クラスの使い方を完全解説!初心者でもわかる文字列エンコードとデコード

2001
Java の Base64 クラスを使って文字列をエンコード・デコードする方法

先生と生徒の会話形式で理解しよう

生徒

「Javaで文字列を暗号みたいな文字列に変換して送る方法ってありますか?」

先生

「あります。JavaではBase64クラスを使うことで、文字列をBase64形式にエンコードしたり、元の文字列にデコードしたりできます。」

生徒

「Base64って何ですか?暗号化とは違うんですか?」

先生

「Base64は暗号化ではなく、データを安全に送るためのエンコード方式です。メール送信やAPI通信、画像データの文字列化などでよく使われます。」

生徒

「Javaでどのように使うのか知りたいです。」

先生

「それではJavaのBase64クラスを使った文字列のエンコードとデコードの方法を初心者向けに順番に解説していきます。」

1. Base64とは何か

1. Base64とは何か
1. Base64とは何か

Base64とは、バイナリデータを文字列として表現するためのエンコード方式です。Javaだけでなく、Web開発、API通信、メール送信など多くの場面で利用されています。

例えば画像データやバイナリデータは、そのままではテキストとして扱うことができません。そのためBase64という仕組みを使って、英数字で表現できる文字列に変換します。

Javaではjava.util.Base64クラスを利用することで簡単にBase64エンコードとBase64デコードができます。Java8以降では標準ライブラリとして用意されているため、追加のライブラリをインストールする必要はありません。

初心者の方が覚えておくべきポイントは次の通りです。

  • Base64は暗号化ではない
  • データを文字列に変換するための仕組み
  • JavaではBase64クラスで簡単に使える
  • API通信やトークン生成などでよく使われる

2. JavaのBase64クラスとは

2. JavaのBase64クラスとは
2. JavaのBase64クラスとは

Javaではjava.util.Base64というユーティリティクラスが用意されています。このクラスを使うことで、文字列をBase64形式に変換したり、Base64文字列を元の文字列に戻したりすることができます。

Base64クラスでは主に次のような機能が提供されています。

  • Base64エンコード
  • Base64デコード
  • URL安全なBase64
  • MIME形式Base64

通常の文字列エンコードとデコードでは、getEncoder()getDecoder()を使うことが多いです。

次の章から実際のJavaサンプルコードを使ってBase64の使い方を見ていきます。

3. Javaで文字列をBase64エンコードする方法

3. Javaで文字列をBase64エンコードする方法
3. Javaで文字列をBase64エンコードする方法

まずはJavaで文字列をBase64エンコードする方法を解説します。エンコードとは、通常の文字列をBase64形式の文字列に変換することです。

JavaではBase64.getEncoder()を使用してエンコード処理を行います。


import java.util.Base64;

public class Base64EncodeExample {
    public static void main(String[] args) {

        String text = "Hello Java Base64";

        String encoded = Base64.getEncoder().encodeToString(text.getBytes());

        System.out.println("元の文字列: " + text);
        System.out.println("Base64エンコード: " + encoded);
    }
}

このプログラムでは、まず通常の文字列を作成し、その文字列をBase64エンコードしています。encodeToString()メソッドを使うことで、簡単にBase64文字列を取得できます。

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


元の文字列: Hello Java Base64
Base64エンコード: SGVsbG8gSmF2YSBCYXNlNjQ=

このように、元の文字列が英数字の別の文字列に変換されていることが確認できます。

Javaをこれから始める人や、 オブジェクト指向の考え方を基礎から理解したい人には、 定番の入門書がこちらです。

スッキリわかるJava入門 第5版をAmazonで見る

※ Amazon広告リンク

4. Base64文字列をデコードする方法

4. Base64文字列をデコードする方法
4. Base64文字列をデコードする方法

次に、Base64文字列を元の文字列に戻すデコード処理を解説します。デコードとは、Base64でエンコードされた文字列を元のデータに戻す処理のことです。

JavaではBase64.getDecoder()を使用してデコードを行います。


import java.util.Base64;

public class Base64DecodeExample {
    public static void main(String[] args) {

        String encoded = "SGVsbG8gSmF2YSBCYXNlNjQ=";

        byte[] decodedBytes = Base64.getDecoder().decode(encoded);

        String decoded = new String(decodedBytes);

        System.out.println("Base64文字列: " + encoded);
        System.out.println("デコード結果: " + decoded);
    }
}

デコード処理では、まずdecode()メソッドでバイト配列に変換します。その後、new String()で文字列に戻します。

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


Base64文字列: SGVsbG8gSmF2YSBCYXNlNjQ=
デコード結果: Hello Java Base64

このように、Base64文字列から元の文字列が復元されていることが分かります。

5. エンコードとデコードをまとめて行うサンプル

5. エンコードとデコードをまとめて行うサンプル
5. エンコードとデコードをまとめて行うサンプル

次は、Javaでエンコードとデコードの両方を1つのプログラムで実行する例です。実際の開発ではこのように両方の処理を組み合わせて使うことが多いです。


import java.util.Base64;

public class Base64FullExample {

    public static void main(String[] args) {

        String original = "Java Base64 Example";

        String encoded = Base64.getEncoder().encodeToString(original.getBytes());

        byte[] decodedBytes = Base64.getDecoder().decode(encoded);
        String decoded = new String(decodedBytes);

        System.out.println("元の文字列: " + original);
        System.out.println("エンコード: " + encoded);
        System.out.println("デコード: " + decoded);
    }

}

このコードでは次の順番で処理を行っています。

  • 元の文字列を作成
  • Base64エンコード
  • Base64デコード
  • 結果を表示

6. URLセーフなBase64エンコード

6. URLセーフなBase64エンコード
6. URLセーフなBase64エンコード

WebアプリケーションやREST APIでは、URLにBase64文字列を含める場合があります。しかし通常のBase64ではURLで問題になる記号が含まれることがあります。

その場合はgetUrlEncoder()を使うことで、URL安全なBase64エンコードを行うことができます。


import java.util.Base64;

public class Base64UrlExample {

    public static void main(String[] args) {

        String text = "Java URL Base64";

        String encoded = Base64.getUrlEncoder().encodeToString(text.getBytes());

        System.out.println("URLセーフBase64: " + encoded);
    }

}

この方法は次のようなケースでよく利用されます。

  • JWTトークン
  • API認証
  • URLパラメータ
  • Webアプリケーションのセッション管理

JavaのBase64クラスを理解しておくと、Web開発やバックエンド開発のさまざまな場面で役立ちます。特にAPI開発や認証処理では頻繁に使われるため、Java初心者の段階でしっかり覚えておくと開発がスムーズになります。

7. Base64が使われる実際の場面

7. Base64が使われる実際の場面
7. Base64が使われる実際の場面

JavaのBase64エンコードとデコードは、実際のシステム開発でも多くの場面で利用されています。初心者の方は単なる文字列変換のように感じるかもしれませんが、実際には非常に重要な役割を持っています。

例えばWeb APIでは、ユーザー認証のためにトークンを生成することがあります。そのトークンの中にはBase64でエンコードされたデータが含まれていることがよくあります。

また、画像ファイルやPDFファイルなどのバイナリデータをJSON形式で送信する場合にもBase64エンコードが利用されます。Javaのバックエンドシステムでは、この処理を行う場面が非常に多いです。

さらにメール送信でもBase64は重要です。メールでは画像や添付ファイルを送る際に、バイナリデータをBase64形式に変換して送信する仕組みが使われています。

このようにJavaのBase64クラスは、Web開発、API開発、バックエンド処理などさまざまな場面で利用される基本技術のひとつです。Javaプログラミングを学ぶうえで、文字列処理と合わせて覚えておくと役立つ知識になります。

まとめ

まとめ
まとめ

JavaのBase64クラスの重要ポイント

JavaのBase64クラスは文字列やバイナリデータを安全に文字列として扱うための基本的な仕組みです。Javaプログラミングを学習する初心者にとって文字列処理はとても重要な基礎技術でありその中でもBase64エンコードとBase64デコードは実際の開発で頻繁に利用されます。特にWeb開発バックエンド開発API通信認証処理データ転送などの場面ではBase64エンコードが利用されることが多くJava開発者が理解しておくべき基本知識の一つです。

Base64とはバイナリデータを英数字の文字列として表現するためのエンコード方式です。画像データファイルデータトークンデータなどはそのままでは文字列として扱えない場合があります。そのような場合にBase64エンコードを行うことでテキスト形式として安全にデータを送信したり保存したりすることができます。Javaではjava util Base64クラスが標準ライブラリとして用意されているため追加ライブラリを導入しなくても簡単に利用できます。

JavaのBase64クラスでは主に三つの重要な処理があります。それはBase64エンコードBase64デコードそしてURL安全Base64エンコードです。Base64エンコードでは通常の文字列をBase64形式の文字列に変換します。Base64デコードではBase64形式の文字列を元の文字列に戻します。さらにURL安全Base64エンコードではWebアプリケーションやAPI通信で使用できる安全な形式の文字列を作成できます。

Java初心者が理解しておくべきポイントとしてBase64は暗号化ではないという点があります。Base64はデータを隠す仕組みではなくデータ形式を変換するためのエンコード方式です。そのためBase64文字列は誰でもデコードすれば元の文字列に戻すことができます。セキュリティ目的で利用するものではなくデータ転送のための技術として理解しておくことが重要です。

Javaでの基本的なBase64処理の流れ

JavaでBase64を利用する場合はまずjava util Base64クラスをインポートします。その後Base64 getEncoderメソッドを使用してエンコーダを取得します。encodeToStringメソッドを利用すると文字列をBase64文字列に変換することができます。反対にBase64 getDecoderメソッドを利用するとBase64文字列を元のデータに戻すデコード処理を行うことができます。

Javaプログラムの中では文字列をバイト配列に変換してからBase64エンコードする処理が行われます。そしてデコード処理ではBase64文字列をバイト配列に変換したあと新しい文字列として復元します。この処理の流れを理解しておくことでJavaの文字列処理やデータ変換の理解も深まります。

復習用サンプルプログラム

次のサンプルプログラムではJavaのBase64エンコードとBase64デコードをまとめて実行しています。学習の復習として実際にプログラムを実行して動作を確認すると理解がより深まります。Java初心者の方はコードの流れをゆっくり確認しながら読み進めることが大切です。


import java.util.Base64;

public class Base64SummaryExample {

    public static void main(String[] args) {

        String originalText = "Java Base64 Learning";

        String encodedText = Base64.getEncoder().encodeToString(originalText.getBytes());

        byte[] decodedBytes = Base64.getDecoder().decode(encodedText);
        String decodedText = new String(decodedBytes);

        System.out.println("元の文字列");
        System.out.println(originalText);

        System.out.println("Base64エンコード結果");
        System.out.println(encodedText);

        System.out.println("Base64デコード結果");
        System.out.println(decodedText);

    }

}

このサンプルプログラムではまず元の文字列を作成しその文字列をBase64エンコードしています。そしてエンコードされた文字列を再度デコードすることで元の文字列に戻しています。このようにエンコード処理とデコード処理を理解しておくことでAPI通信やデータ処理などさまざまな場面で応用することができます。

Base64が活躍する実際の開発場面

JavaのBase64処理は実際のシステム開発でも多く利用されています。例えばWebサービスのログイン認証処理ではトークンデータの生成や通信データの変換にBase64が使われることがあります。またREST APIの通信ではバイナリデータをJSON形式で送信する必要があるため画像データやファイルデータをBase64文字列に変換するケースもあります。

さらにメール送信システムでは添付ファイルを安全に送信するためにBase64エンコードが利用されます。Javaでメール送信プログラムを作成する場合もBase64エンコードの知識が役立ちます。このようにJava Base64エンコードとJava Base64デコードは多くの実用的な場面で利用される重要な技術です。

Java学習者がBase64クラスを理解することで文字列処理データ変換API通信認証処理など多くの分野の理解が深まります。特にJavaバックエンド開発やWebアプリケーション開発を目指す場合Base64処理は基本知識として覚えておくと役立ちます。Javaプログラミングを学ぶ中でこのような標準ライブラリの使い方を理解していくことが実践的なスキル向上につながります。

先生と生徒の振り返り会話

生徒

今日の学習でJavaのBase64エンコードとBase64デコードの意味がよく分かりました文字列を別の文字列に変換してデータを安全に扱う仕組みなのですね最初は暗号のようなものだと思っていましたがデータ形式を変換する技術だと理解できました

先生

その理解でとても良いですJavaのBase64クラスはデータを隠す技術ではなくデータを文字列として扱いやすくするための技術です特にAPI通信やトークン生成画像データ送信など多くの場面で使われます

生徒

JavaではBase64 getEncoderとBase64 getDecoderを使えば簡単にエンコードとデコードができることも理解できましたコードもとても短く書けるので覚えやすいですね

先生

その通りですJava標準ライブラリのBase64クラスを使うことで複雑な処理を書かなくても簡単にBase64処理を実装できます初心者の段階でこのような便利なクラスの使い方を覚えることはとても大切です

生徒

今後はAPI通信や認証処理の学習をするときにもBase64が出てきそうなので今回の内容を復習してしっかり理解しておきたいと思います

先生

とても良い学習姿勢ですJavaの文字列処理データ変換標準ライブラリを理解していくことで実際のシステム開発に近い知識が身についていきますこれからも実際にコードを書きながら学習を続けていきましょう

Javaのユーティリティクラスの一覧へ
新着記事
AWS
【AWS】CloudWatchで障害検知を自動化する設計パターン
【AWS】CloudWatchで障害検知を自動化する設計パターンを初心者向けに解説!AWS監視とアラート通知の基本
AWS
【AWS】RDSの無料枠とは?対象インスタンスタイプと注意点を解説
【AWS】RDSの無料枠とは?対象インスタンスタイプと注意点を解説
Flutter
Flutterの入力フォーム作成!TextField・TextFormFieldの基本
Flutterの入力フォーム作成!TextField・TextFormFieldの基本を初心者向けに解説
AWS
IAM Identity Centerの料金・SSO対応・Entra ID連携を詳しく解説
IAM Identity Centerの料金・SSO対応・Entra ID連携を詳しく解説【初心者向けAWS IAM】
人気記事
Flutter
Flutterの開発に必要なもの!パソコン・ツール・OSなど準備まとめ
Flutterの開発に必要なもの!パソコン・ツール・OSなど準備まとめ
Java
Java の Random クラスを使ってランダムな数値を生成する方法
JavaのRandomクラスの使い方を完全ガイド!初心者でもわかる乱数生成
Java
Java の getter メソッドと setter メソッドの使い方
Javaのgetterメソッドとsetterメソッドの使い方を完全ガイド!初心者でもわかるアクセス方法
AWS
【AWS】RDSの料金体系まとめ!ざっくり理解・高いと感じる理由も解説
【AWS】RDSの料金体系まとめ!ざっくり理解・高いと感じる理由も解説

🔌 USBポート不足を解消

Type-C 1本で拡張。
開発・作業環境を一気に快適に

UGREEN USB-Cハブを見る

※ Amazon広告リンク