本文へスキップ

本ページはプロモーションが含まれています

Java入門

【コピペOK】Java QRコード作成ガイド!ライブラリ比較から実装まで

CATEGORY
DRAWN BY
TOM
DATE
REV.
READ
約10分
SHEETS
6枚
QR Code(ライブラリ比較から実装まで)

トム

SESで約8年、環境を変えられないもどかしさの中にいました。32歳で自社開発企業に転職し、今はClaude Codeと自動化で、仕事も時間も組み直している途中です。
・Javaバックエンドエンジニア(Java歴12年以上)
・資格:基本情報技術者/応用情報技術者/Java Silver/Python3エンジニア認定基礎
詳細なプロフィール

𝕏

「WebアプリにQRコード決済機能をつけたい」「イベントの電子チケットをJavaで作りたい」

JavaでQRコードを作るなら、ライブラリはZXingを使うのが手堅い選択です。生成と読み取りの両方に対応していて、Maven・Gradleで追加すれば数十行のコードで動きます。

扱うのは、ライブラリの選び方、PNG・JPEGへの出力、日本語を入れたときの文字化け対策、読み取り(デコード)、Spring Bootでの応用です。どれもそのまま動くサンプルコードで説明します。サンプルはZXing 3.5.4でコンパイル・実行し、生成したQRコードを読み取って元の文字列に戻ることを確かめています。

JavaでQRコードを作成する方法【初心者向け解説】

QRコードの基本的な仕組みと、Javaで作成するときの全体的な流れを押さえます。

QRコードとは?仕組みと使い道を簡単に解説

QRコードは、生活のいたるところで使われています。

スマートフォンをかざすだけで、Webサイトにアクセスしたり、キャッシュレス決済をしたりできます。

この白と黒の四角い模様は、大量の情報を格納できる二次元コードの一種です。従来のバーコードは横一列にしか情報を持てません。

QRコードは縦横の二方向に情報を持つため、より多くのデータを記録できます。

数字だけでなく、アルファベットや漢字、ひらがなも格納できるため、URLやメールアドレス、商品情報など、さまざまな用途で活用されています。

JavaでQRコードを生成する手順の全体像

JavaでQRコードを作成する手順は、大きく分けて3つのステップしかありません。

ステップ

  1. ライブラリの導入: QRコードの生成・読み取り機能を提供してくれるライブラリをプロジェクトに追加
  2. 生成コードの記述: ライブラリの機能を使って、指定した文字列をQRコードのデータに変換し、画像として作成するコードを書く
  3. 画像ファイルへの出力: 作成したQRコードの画像を、PNGやJPEGなどの形式でファイルに保存

開発環境の準備(JDK・IDE・ライブラリ導入)

QRコード作成を始める前に、開発環境を整えます。必要なものは以下の3つです。

  • JDK (Java Development Kit): Javaで開発を行うための基本セットです。バージョンは8以上を推奨します。
  • IDE (統合開発環境): EclipseやIntelliJ IDEAなど、普段お使いのもので問題ありません。
  • ライブラリ: QRコードを扱うためのライブラリ。この記事では、最も広く使われているZXingを例に進めます。

ライブラリの導入は、MavenやGradleといったビルド管理ツールを使うと簡単です。

Mavenの場合 (pom.xmlに追記)

<dependency>
    <groupId>com.google.zxing</groupId>
    <artifactId>core</artifactId>
    <version>3.5.4</version>
</dependency>
<dependency>
    <groupId>com.google.zxing</groupId>
    <artifactId>javase</artifactId>
    <version>3.5.4</version>
</dependency>

Gradleの場合 (build.gradleに追記)

implementation 'com.google.zxing:core:3.5.4'
implementation 'com.google.zxing:javase:3.5.4'

ZXingの追加で、QRコード作成の準備は完了です。

JavaでQRコードを作るためのライブラリ紹介

JavaでQRコードを扱えるライブラリはいくつかありますが、ここでは代表的な3つを比較します。

最も人気のあるZXingとは?特徴とメリット

JavaでQRコードを扱うライブラリはいくつかありますが、中でもZXing(ゼブラクロッシング)は、Javaでよく使われている代表的なライブラリです。

ZXingは、Googleのエンジニアが中心になって始めたオープンソースのライブラリです(パッケージ名もcom.google.zxing)。公式製品の位置づけではなく、現在はコミュニティからの寄稿で保守されています。

新機能の追加は止まっていますが、QRコードの生成・読み取りに必要な機能はそろっているため、特別な理由がなければZXingで足ります。

メリット

  • 生成と読み取りの両方に対応: 1つのライブラリでQRコードの作成と読み取りの両方が可能
  • 豊富な機能: QRコードだけでなく、さまざまな形式の一次元・二次元バーコードに対応
  • 高い実績: 2007年から続くプロジェクトで、多くのプロジェクトで採用されており情報が多い
  • 継続的な保守: 公式READMEでは新機能の開発は行わない保守モード(バグ修正が中心)とされている。リリースは続いており(3.5.4は2025年11月)、安定して利用できる

QRGenやZBarなど他の選択肢との比較

ZXing以外にも、特徴的なライブラリが存在します。

ライブラリ名特徴メリットデメリット
ZXing生成・読み取り両対応、多機能情報が豊富で信頼性が高い多機能ゆえに少し複雑に感じる場合がある
QRGenQRコード生成に特化シンプルで使い方が分かりやすい読み取り機能はない
ZBarC言語ベース。高速な読み取りが特徴読み取り速度が速いJavaで使うにはJNI連携が必要で導入が少し複雑

QRコードを生成するだけで、手軽に導入したい場合はQRGenも良い選択肢です。

また、カメラ映像からリアルタイムで高速にQRコードを読み取りたい場合はZBarが向いています。

どのライブラリを選ぶべきか【初心者向けおすすめ】

初心者にはZXingをおすすめします。

理由は、QRコードの作成と読み取りの両方を1つのライブラリで完結でき、日本語の解説記事やQ&Aも多いからです。

使っている人が多いので、エラーが出ても解決策を見つけやすいのが利点です。

この記事でも、以降はZXingを使って実装します。

実際にQRコードを作ってみよう【サンプルコード付き】

ここからは、実際にJavaのコードを書きながらQRコードを作成していきます。以下のサンプルコードは、そのままコピー&ペーストして試せます。

ZXingを使ったQRコード生成の基本コード

まずは、指定した文字列からQRコードを生成する最も基本的なコードです。

import com.google.zxing.BarcodeFormat;
import com.google.zxing.MultiFormatWriter;
import com.google.zxing.common.BitMatrix;
import com.google.zxing.client.j2se.MatrixToImageWriter;
import java.nio.file.Paths;

public class QRCodeGenerator {
    public static void main(String[] args) {
        try {
            // QRコードに含める文字列
            String text = "https://www.google.com";
            // 画像のサイズ
            int width = 300;
            int height = 300;
            // 出力するファイルパス
            String filePath = "qrcode.png";

            // QRコードを生成
            BitMatrix bitMatrix = new MultiFormatWriter().encode(
                text,
                BarcodeFormat.QR_CODE,
                width,
                height
            );

            // ファイルに出力
            MatrixToImageWriter.writeToPath(
                bitMatrix,
                "PNG",
                Paths.get(filePath)
            );

            System.out.println("QRコードの生成に成功しました: " + filePath);

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

このコードを実行すると、プロジェクトのルートディレクトリに qrcode.png という名前でQRコード画像が生成されます。

スマートフォンで読み取ると、"https://www.google.com" にアクセスできるはずです。

画像ファイル(PNG・JPEG)として出力する方法

上記のサンプルコードではPNG形式で出力しましたが、MatrixToImageWriterはJPEG形式にも対応しています。

JPEGで出力する場合は、writeToPathメソッドの第2引数を "JPEG" に、ファイルパスの拡張子を ".jpg" や ".jpeg" に変更するだけです。

// ...
String filePath = "qrcode.jpg";
// ...
MatrixToImageWriter.writeToPath(
    bitMatrix,
    "JPEG", // 出力形式をJPEGに変更
    Paths.get(filePath)
);
// ...

一般的に、QRコードのような単純な図形は、くっきりと表示されるPNG形式の方が向いています。

文字コード・サイズ・誤り訂正レベルの設定方法

実用的なアプリケーションでは、文字化けを防いだり、QRコードのサイズや強度を調整したりする設定が必要になります。

  • 文字コード: 日本語を含む場合は、文字化けを防ぐためにUTF-8を指定するのが一般的
  • 誤り訂正レベル: QRコードの一部が汚れたり破損したりしても、正しく読み取れるようにする機能。レベルは低い順にL(7%)、M(15%)、Q(25%)、H(30%)の4段階あり、レベルが高いほど多くの情報を復元できますが、格納できるデータ量は少なくなる
  • マージン(余白): QRコードの周囲の白い余白部分。広いほど読み取りやすい。ZXingの既定値は4(セル4つ分)で、下のサンプルでは見た目を詰めるために2にしている。読み取りに失敗するときは4に戻す

文字コード・誤り訂正レベル・マージンの設定は、EncodeHintTypeを使って行います。

import com.google.zxing.BarcodeFormat;
import com.google.zxing.EncodeHintType;
import com.google.zxing.MultiFormatWriter;
import com.google.zxing.common.BitMatrix;
import com.google.zxing.qrcode.decoder.ErrorCorrectionLevel;
import com.google.zxing.client.j2se.MatrixToImageWriter;
import java.nio.file.Paths;
import java.util.HashMap;
import java.util.Map;

public class QRCodeGeneratorAdvanced {
    public static void main(String[] args) {
        try {
            String text = "こんにちは、Java QRコード!";
            int size = 350;
            String filePath = "qrcode_advanced.png";
            
            // エンコードのヒント(設定)をMapで作成
            Map<EncodeHintType, Object> hints = new HashMap<>();
            
            // 1. 文字コードをUTF-8に設定
            hints.put(EncodeHintType.CHARACTER_SET, "UTF-8");
            
            // 2. 誤り訂正レベルをQ(25%)に設定
            hints.put(EncodeHintType.ERROR_CORRECTION, ErrorCorrectionLevel.Q);
            
            // 3. マージン(余白)を2に設定
            hints.put(EncodeHintType.MARGIN, 2);

            BitMatrix bitMatrix = new MultiFormatWriter().encode(
                text,
                BarcodeFormat.QR_CODE,
                size,
                size,
                hints // 設定を渡す
            );

            MatrixToImageWriter.writeToPath(
                bitMatrix,
                "PNG",
                Paths.get(filePath)
            );

            System.out.println("詳細設定でQRコードを生成しました: " + filePath);

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

このコードを実行すると、日本語の文字列を含み、少し汚れに強いQRコードが生成されます。日本語を入れるなら、文字コードの指定は省略しないでください。

JavaでQRコードを読み取る方法も知っておこう

ZXingを使えば、QRコードの読み取り(デコード)も簡単に行えます。

ZXingでQRコードをデコードする手順

デコードの基本的な流れは以下の通りです。

  1. 画像ファイルを読み込む: BufferedImageオブジェクトとしてQRコードの画像ファイルを読み込みます。
  2. バイナリビットマップを作成: 読み込んだ画像を、ZXingが解析できる形式(BinaryBitmap)に変換します。
  3. デコードを実行: MultiFormatReaderを使って、ビットマップからテキスト情報を抽出します。

画像ファイルからテキストを抽出するサンプルコード

先ほど作成したQRコード画像を読み取ります。

import com.google.zxing.BinaryBitmap;
import com.google.zxing.MultiFormatReader;
import com.google.zxing.NotFoundException;
import com.google.zxing.Result;
import com.google.zxing.client.j2se.BufferedImageLuminanceSource;
import com.google.zxing.common.HybridBinarizer;
import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.io.File;

public class QRCodeReader {
    public static void main(String[] args) {
        try {
            // 読み取るQRコードの画像ファイル
            File file = new File("qrcode_advanced.png");
            
            BufferedImage image = ImageIO.read(file);
            
            // ZXingが解析できる形式に変換
            BinaryBitmap bitmap = new BinaryBitmap(
                new HybridBinarizer(
                    new BufferedImageLuminanceSource(image)
                )
            );
            
            // デコードを実行
            Result result = new MultiFormatReader().decode(bitmap);
            
            System.out.println("QRコードの読み取りに成功しました。");
            System.out.println("テキスト: " + result.getText());
            System.out.println("フォーマット: " + result.getBarcodeFormat());

        } catch (NotFoundException e) {
            System.err.println("QRコードが見つかりませんでした。");
            e.printStackTrace();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

このコードを実行すると、コンソールに「こんにちは、Java QRコード!」というテキストが出力されるはずです。

QRコードの生成 → 読み取りの流れ
1
生成文字列+設定(ヒント)を用意「こんにちは、Java QRコード!」と UTF-8・誤り訂正レベルQ・余白2
2
生成encode() → BitMatrixMultiFormatWriter が白黒のマス目に変換
3
生成writeToPath() → PNGで保存MatrixToImageWriter で qrcode_advanced.png に書き出す
4
読取ImageIO.read() → BufferedImage画像ファイルを読み込む
5
読取BinaryBitmap に変換ZXing が解析できる形式にする
6
読取decode() → 文字列を取得MultiFormatReader で元の「こんにちは、Java QRコード!」が取り出せる
NOTE本文の詳細設定版の生成コードと読み取りコードをつなげた流れです。

エラーが出たときのチェックポイント

QRコードの読み取り時にNotFoundExceptionというエラーが頻繁に発生する場合、以下の点を確認してみてください。

  • 画像の品質: 画像がぼやけていたり、解像度が低すぎたりしませんか?
  • 余白(マージン): QRコードの周囲に十分な余白はありますか?
  • コントラスト: QRコードの黒い部分と背景の白い部分の明暗差ははっきりしていますか?
  • 画像の傾き: 画像が大きく傾いていたり歪んでいたりすると、読み取りに失敗します。

4点を確認すると、読み取りの成功率が上がります。

QRコード作成機能をアプリに応用するアイデア

WebアプリでのQRコード生成機能の実装例

Spring Bootを使えば、ユーザーが入力したテキストを動的にQRコード画像として表示するWebアプリケーションを簡単に作れます。

例えば、以下のようなControllerを実装します。

import com.google.zxing.BarcodeFormat;
import com.google.zxing.EncodeHintType;
import com.google.zxing.MultiFormatWriter;
import com.google.zxing.client.j2se.MatrixToImageWriter;
import com.google.zxing.common.BitMatrix;
import org.springframework.http.MediaType;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import java.io.ByteArrayOutputStream;
import java.util.HashMap;
import java.util.Map;

@RestController
public class QRCodeController {

    @GetMapping(value = "/qrcode", produces = MediaType.IMAGE_PNG_VALUE)
    public ResponseEntity<byte[]> generateQRCode(@RequestParam(defaultValue = "Hello") String text) {
        try {
            int width = 250;
            int height = 250;

            // 日本語を含む文字列が文字化けしないよう、文字コードにUTF-8を指定
            Map<EncodeHintType, Object> hints = new HashMap<>();
            hints.put(EncodeHintType.CHARACTER_SET, "UTF-8");

            BitMatrix bitMatrix = new MultiFormatWriter().encode(text, BarcodeFormat.QR_CODE, width, height, hints);

            ByteArrayOutputStream pngOutputStream = new ByteArrayOutputStream();
            MatrixToImageWriter.writeToStream(bitMatrix, "PNG", pngOutputStream);
            
            return ResponseEntity.ok(pngOutputStream.toByteArray());

        } catch (Exception e) {
            // エラーハンドリング
            return ResponseEntity.internalServerError().build();
        }
    }
}

このWebアプリを起動し、ブラウザで http://localhost:8080/qrcode?text=Java最高 にアクセスすると、"Java最高" という文字列を含んだQRコードが動的に生成・表示されます。

あわせて読む

名刺・商品・チケットなど活用アイデア集

Javaで作成したQRコードは、さまざまな場面で活用できます。

  • オンライン名刺: 自分のプロフィールページのURLをQRコードにして名刺に印刷
  • 商品管理: 商品ごとの詳細情報ページへのリンクをQRコード化し、商品タグに添付
  • イベントの電子チケット: 入場者ごとのユニークなIDをQRコードにし、スマートフォンに表示させて受付を電子化
  • Wi-Fi接続情報: SSIDとパスワードをQRコードにして店舗に掲示し、来店者が簡単にWi-Fiに接続できるようにする
  • アンケート: アンケートフォームのURLをQRコードにして、イベントや商品の満足度調査に活用

JavaFXやSpring Bootとの連携事例

  • JavaFX: デスクトップアプリケーションにQRコード生成・表示機能を組み込めます。例えば、顧客管理システムで顧客ごとの会員証QRコードを表示する、といった使い方が考えられます。
  • Spring Boot: 上記の例のように、Web APIとしてQRコード生成機能を提供できます。ユーザー登録完了メールにアカウント情報を含んだQRコードを添付して送る、といったWebシステムとの連携にも向きます。

まとめ|JavaでQRコードを作るのは意外と簡単!

この記事の内容まとめ

要点を振り返ります。

  • QRコードの作成は、ZXingライブラリを使えば初心者でも簡単。
  • MavenやGradleでライブラリを導入し、数行のコードでQRコードを生成できる。
  • 日本語を扱う場合は、文字コード(UTF-8)を指定しないと文字化けする。
  • ZXingは読み取り(デコード)にも対応しており、画像ファイルからテキストを抽出可能。
  • Spring Bootと組み合わせれば、動的にQRコードを生成するWebアプリも手軽に開発できる。

QRコード生成でよくある質問(FAQ)

Q1: QRコードの色は変えられますか?

A1: はい、変更可能です。ただし、読み取り精度を確保するため、背景色と十分なコントラストがある濃い色を選ぶ必要があります。ZXingでは、MatrixToImageConfigクラスを使うことで色をカスタマイズできます。

Q2: 日本語の文字列が文字化けしてしまいます。

A2: 生成時にエンコードのヒントでEncodeHintType.CHARACTER_SETに "UTF-8" を指定しているか確認してください。

また、ソースコード自体のファイルエンコーディングもUTF-8に設定することをおすすめします。

Q3: QRコードの真ん中にロゴ画像を入れることはできますか?

A3: 可能です。ただし、ZXing自体には直接その機能はありません。一度QRコードを画像として生成し、Javaの画像処理ライブラリ(java.awt.Graphics2Dなど)で中央にロゴ画像を合成します。その際は誤り訂正レベルを高く(Hなど)設定してください。ロゴで隠れる部分の情報も、誤り訂正の範囲内であれば復元できます。ただし、Hでも復元できる量には限りがあるため、ロゴは全体の1割程度までの小さなサイズに抑え、実際に読み取れるかを確認してください。

REVISIONS / 改訂履歴
REV.DATE内容
52026-11-19内容を全体的に見直し
42026-10-16図解を描き直し(図面のデザインにそろえた)
32026-10-14一人称と言い回しの表記をそろえた。雰囲気だけの挿絵を外した
22026-08-30内容を全体的に見直し(古い記述を2件更新)
12025-10-08初版
NEXT READ本棚から1本

AIで開発を組み直すなら、まずこの5冊から

入門・実践・設計まで、Claude Codeの本をレベル別に5冊選んで比べました。

→ おすすめ5冊を見る

トム

SESで約8年、環境を変えられないもどかしさの中にいました。32歳で自社開発企業に転職し、今はClaude Codeと自動化で、仕事も時間も組み直している途中です。
・Javaバックエンドエンジニア(Java歴12年以上)
・資格:基本情報技術者/応用情報技術者/Java Silver/Python3エンジニア認定基礎
詳細なプロフィール

𝕏

Java入門

TOC