Java Swing REST API ｜ Swing画面からREST APIを呼び出すサンプル

Javaのデスクトップアプリ（Swing）から、REST API を呼び出したいケースは意外と多くあります。
例えば以下のような用途です。

社内ツールからWeb APIを呼び出す
Swing画面でボタンを押したら外部サービスと通信する
APIの結果を画面に表示する簡易クライアントを作りたい

本記事では、Swing画面のボタン操作をトリガーに REST API を呼び出す基本サンプルを紹介します。

使用する構成

Java：Java 11 以上
GUI：Swing
HTTP通信：java.net.http.HttpClient（標準API）
API：JSON を返す REST API（サンプル用）

全体イメージ

Swing画面を表示
ボタンをクリック
REST API を呼び出す
レスポンスをテキストエリアに表示

サンプル画面の構成

ボタン：API呼び出し
テキストエリア：レスポンス表示

Swing画面のサンプルコード

import javax.swing.*;
import java.awt.*;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SwingRestSample extends JFrame {

    private JTextArea textArea;

    public SwingRestSample() {
        setTitle("Swing REST API Sample");
        setSize(600, 400);
        setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        setLocationRelativeTo(null);

        JButton button = new JButton("REST API 呼び出し");
        textArea = new JTextArea();
        textArea.setEditable(false);

        JScrollPane scrollPane = new JScrollPane(textArea);

        button.addActionListener(e -> callRestApi());

        getContentPane().setLayout(new BorderLayout());
        getContentPane().add(button, BorderLayout.NORTH);
        getContentPane().add(scrollPane, BorderLayout.CENTER);
    }

    private void callRestApi() {
        // Swingのイベントスレッドをブロックしないように別スレッドで実行
        new Thread(() -> {
            try {
                HttpClient client = HttpClient.newHttpClient();

                HttpRequest request = HttpRequest.newBuilder()
                        .uri(new URI("https://jsonplaceholder.typicode.com/posts/1"))
                        .GET()
                        .build();

                HttpResponse<String> response =
                        client.send(request, HttpResponse.BodyHandlers.ofString());

                // Swingコンポーネント更新はEDTで行う
                SwingUtilities.invokeLater(() -> {
                    textArea.setText(response.body());
                });

            } catch (Exception ex) {
                SwingUtilities.invokeLater(() -> {
                    textArea.setText("エラーが発生しました\n" + ex.getMessage());
                });
            }
        }).start();
    }

    public static void main(String[] args) {
        SwingUtilities.invokeLater(() -> {
            new SwingRestSample().setVisible(true);
        });
    }
}

import javax.swing.*;

import java.awt.*;

import java.net.URI;

import java.net.http.HttpClient;

import java.net.http.HttpRequest;

import java.net.http.HttpResponse;

public class SwingRestSample extends JFrame {

private JTextArea textArea;

public SwingRestSample() {

setTitle("Swing REST API Sample");

setSize(600, 400);

setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);

setLocationRelativeTo(null);

JButton button = new JButton("REST API 呼び出し");

textArea = new JTextArea();

textArea.setEditable(false);

JScrollPane scrollPane = new JScrollPane(textArea);

button.addActionListener(e -> callRestApi());

getContentPane().setLayout(new BorderLayout());

getContentPane().add(button, BorderLayout.NORTH);

getContentPane().add(scrollPane, BorderLayout.CENTER);

}

private void callRestApi() {

// Swingのイベントスレッドをブロックしないように別スレッドで実行

new Thread(() -> {

try {

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()

.uri(new URI("https://jsonplaceholder.typicode.com/posts/1"))

.GET()

.build();

HttpResponse<String> response =

client.send(request, HttpResponse.BodyHandlers.ofString());

// Swingコンポーネント更新はEDTで行う

SwingUtilities.invokeLater(() -> {

textArea.setText(response.body());

});

} catch (Exception ex) {

SwingUtilities.invokeLater(() -> {

textArea.setText("エラーが発生しました\n" + ex.getMessage());

});

}

}).start();

}

public static void main(String[] args) {

SwingUtilities.invokeLater(() -> {

new SwingRestSample().setVisible(true);

});

}

コード解説（重要ポイント）

① HttpClient を使用してREST APIを呼び出す

HttpClient client = HttpClient.newHttpClient();

1	HttpClient client = HttpClient.newHttpClient();

Java 11 以降では、HttpURLConnection よりも
HttpClient の使用が推奨されています。

② Swingのイベントディスパッチスレッド（EDT）に注意

Swingでは以下が非常に重要です。

通信処理はEDTで実行しない
画面更新はEDTで実行する

そのため、以下のように分けています。

API呼び出し → new Thread(...)
画面更新 → SwingUtilities.invokeLater(...)

これを守らないと、

画面がフリーズする
ランダムに例外が出る

といった不具合につながります。

POSTリクエストの例（参考）

HttpRequest request = HttpRequest.newBuilder()
        .uri(new URI("https://example.com/api"))
        .header("Content-Type", "application/json")
        .POST(HttpRequest.BodyPublishers.ofString(
                "{\"name\":\"test\",\"value\":123}"
        ))
        .build();

HttpRequest request = HttpRequest.newBuilder()

.uri(new URI("https://example.com/api"))

.header("Content-Type", "application/json")

.POST(HttpRequest.BodyPublishers.ofString(

"{\"name\":\"test\",\"value\":123}"

))

.build();

よくあるハマりポイント

問題	原因
ボタンを押すと画面が固まる	EDTで通信している
レスポンスは取れているのに画面に表示されない	EDT外でUI更新
SSLエラーが出る	証明書未登録・プロキシ環境

まとめ

SwingからREST APIを呼び出すことは可能
通信は別スレッド、UI更新はEDTが鉄則
Java 11 以降なら HttpClient がシンプルでおすすめ

Swingの社内ツールや簡易クライアントを作る際の参考になれば幸いです。

日	月	火	水	木	金	土
	1	2	3	4	5	6
7	8	9	10	11	12	13
14	15	16	17	18	19	20
21	22	23	24	25	26	27
28	29	30	31

「駑馬十駕」を信念に IT系情報を中心に調べた事をコツコツ綴っています。

Java Swing REST API ｜ Swing画面からREST APIを呼び出すサンプル

使用する構成

全体イメージ

サンプル画面の構成

Swing画面のサンプルコード

コード解説（重要ポイント）

① HttpClient を使用してREST APIを呼び出す

② Swingのイベントディスパッチスレッド（EDT）に注意

POSTリクエストの例（参考）

よくあるハマりポイント

まとめ

Ads by Google

「駑馬十駕」を信念に IT系情報を中心に調べた事をコツコツ綴っています。

使用する構成

全体イメージ

サンプル画面の構成

Swing画面のサンプルコード

コード解説（重要ポイント）

① HttpClient を使用してREST APIを呼び出す

② Swingのイベントディスパッチスレッド（EDT）に注意

POSTリクエストの例（参考）

よくあるハマりポイント

まとめ

関連記事

Ads by Google

　関連記事