非Gradle/Maven项目及NetBeans下JavaFX项目引入OkHttp的方法

阿华AIGC实验室

2026-5-22

关于在无构建工具/NetBeans JavaFX项目中使用OkHttp的解决方案

一、不使用Gradle或Maven的项目中引入OkHttp

如果你的项目没用到任何构建工具，完全手动管理依赖，步骤其实很简单：

下载必要的JAR包：
首先获取OkHttp的核心JAR包okhttp-x.x.x.jar，同时别忘了它的核心依赖okio-x.x.x.jar——OkHttp底层依赖Okio处理IO操作，缺了它根本跑不起来。
添加JAR到项目：
把两个JAR放到项目的专属目录（比如新建lib文件夹），再根据开发环境配置类路径：
- 命令行环境：编译时用javac -cp ".;lib/*" YourMainClass.java，运行时用java -cp ".;lib/*" YourMainClass（Windows用分号，Linux/macOS替换为冒号）。
- IDE环境：直接把JAR添加到项目的库依赖中（后面NetBeans的具体步骤会详细说明）。
验证使用：
导入核心类（比如import okhttp3.OkHttpClient;），写个简单的GET请求测试，确保能正常编译运行。

二、NetBeans JavaFX项目中使用OkHttp的完整指南

1. 先解答你的疑问：能不能只引入OkHttp的部分内容？

其实OkHttp的模块设计比较紧密，核心功能和依赖（比如Okio）绑定很深，官方并没有提供拆分好的“轻量化”JAR包。如果硬要裁剪，只能自己克隆源码手动剔除模块后重新编译，但这对普通开发者来说成本极高，还容易因依赖缺失引发奇怪的错误。我个人非常推荐直接使用完整JAR包——毕竟OkHttp本身体积不大，完全不会给JavaFX项目造成负担。

2. 已导入JAR但不会用？NetBeans配置+使用步骤补全

既然你已经下载了JAR，咱们把剩下的步骤理清楚：

确认JAR已正确添加到项目
右键你的JavaFX项目 → 选择「属性」→ 切换到「库」标签页 → 检查「编译」和「运行」列表里有没有okhttp和okio的JAR。如果没有，点击「添加JAR/文件夹」，选中存放JAR的lib目录里的两个文件添加进去。

在JavaFX代码中使用OkHttp
注意JavaFX不能在UI线程里做网络请求，所以我们用Task包装请求避免阻塞界面，示例代码如下：

import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;
import javafx.application.Application;
import javafx.concurrent.Task;
import javafx.scene.Scene;
import javafx.scene.control.Button;
import javafx.scene.control.Label;
import javafx.scene.layout.VBox;
import javafx.stage.Stage;

public class OkHttpJavaFXDemo extends Application {
    private final OkHttpClient client = new OkHttpClient();

    @Override
    public void start(Stage stage) {
        Label resultLabel = new Label("点击按钮发起请求");
        Button requestBtn = new Button("发起GET请求");

        requestBtn.setOnAction(e -> {
            Task<String> requestTask = new Task<>() {
                @Override
                protected String call() throws Exception {
                    Request request = new Request.Builder()
                            .url("https://example.com")
                            .build();
                    try (Response response = client.newCall(request).execute()) {
                        return response.body().string();
                    }
                }
            };

            // 请求成功后更新UI
            requestTask.setOnSucceeded(event -> 
                resultLabel.setText("请求结果:\n" + requestTask.getValue())
            );

            // 请求失败时提示错误
            requestTask.setOnFailed(event -> 
                resultLabel.setText("请求失败: " + requestTask.getException().getMessage())
            );

            // 启动异步任务
            new Thread(requestTask).start();
        });

        VBox root = new VBox(10, resultLabel, requestBtn);
        root.setPadding(new javafx.geometry.Insets(20));
        stage.setScene(new Scene(root, 400, 300));
        stage.setTitle("OkHttp + JavaFX Demo");
        stage.show();
    }

    public static void main(String[] args) {
        launch(args);
    }
}