Java初学者项目实战：实现一个天气数据展示应用-java教程-PHP中文网

初学者用HttpURLConnection调用OpenWeatherMap API实现天气应用，需注意URL拼接、URLEncoder编码、User-Agent设置、异常处理及org.json安全解析，并用SwingWorker避免GUI阻塞。

java初学者项目实战：实现一个天气数据展示应用

Java初学者做天气应用，别一上来就搞 Spring Boot 或 HTTP 客户端封装——HttpURLConnection 足够跑通流程，且能看清请求-响应全链路。真正卡住新手的，从来不是“怎么写”，而是“为什么返回 403”“JSON 解析报 JSONException 却没提示哪一行”“城市名带空格就查不到”。下面直奔实操。

用 `HttpURLConnection` 发起 GET 请求获取天气 JSON

OpenWeatherMap 免费 API 是最稳妥的起点（注册后得 appid）。注意：它要求请求 URL 中必须带 appid 参数，且不能用 POST；很多初学者误用 setRequestMethod("POST") 导致 405 错误。

URL 必须是完整字符串，例如：https://api.openweathermap.org/data/2.5/weather?q=Beijing&appid=your_key_here&units=metric
手动拼接参数时，城市名要用 URLEncoder.encode(city, "UTF-8")，否则中文或空格直接 400
必须显式设置 conn.setRequestProperty("User-Agent", "JavaApp")，否则部分 API 返回 403（被当成爬虫拦截）
记得调用 conn.connect()，再用 conn.getInputStream() 读响应，别漏掉异常分支里的 getErrorStream()

用 `org.json` 解析响应，避开 `NullPointerException`

别自己用 String.split() 或正则去截 JSON 字段——org.json 轻量且 JDK 无依赖。但新手常在没校验字段存在性的情况下直接调用 getDouble("temp")，结果遇到 JSONException: No value for temp。

先用 new JSONObject(jsonString) 构造顶层对象，再逐层检查键是否存在：if (root.has("main") && root.getJSONObject("main").has("temp"))
温度字段在 "main" 对象里，单位是开尔文（K），要转摄氏度得减 273.15；别直接用 getInt() 读小数，用 getDouble()
城市名在 "name"，国家码在 "sys.country"，注意 sys 是嵌套对象，不是字符串路径

用 `Swing` 做极简 UI，避免线程阻塞界面

JFrame + JTextField + JButton 就够展示核心逻辑。但重点：网络请求不能在 EDT（事件分发线程）里执行，否则点击按钮后整个窗口假死。

Expanso json-flatten

通过 CLI 或 MCP 服务器，使用 Expanso Edge 管道扁平化嵌套 JSON 对象。

下载

把 HTTP 请求逻辑包进 SwingWorker，重写 doInBackground() 发请求、done() 更新 UI
按钮点击后立即设为 setEnabled(false)，防止重复提交；done() 里再设回 true
错误提示别用 System.out.println()，改用 JOptionPane.showMessageDialog(...)，否则控制台看不到报错

public class WeatherApp extends JFrame {
    private JTextField cityField = new JTextField(15);
    private JLabel resultLabel = new JLabel("输入城市名，点击查询");
<pre class="brush:java;toolbar:false;">public WeatherApp() {
    JButton queryBtn = new JButton("查询");
    queryBtn.addActionListener(e -> {
        String city = cityField.getText().trim();
        if (!city.isEmpty()) {
            queryBtn.setEnabled(false);
            new WeatherTask().execute(city);
        }
    });

    add(new JLabel("城市："), BorderLayout.WEST);
    add(cityField, BorderLayout.CENTER);
    add(queryBtn, BorderLayout.EAST);
    add(resultLabel, BorderLayout.SOUTH);
    setDefaultCloseOperation(EXIT_ON_CLOSE);
    pack(); setVisible(true);
}

private class WeatherTask extends SwingWorker<jsonobject void> {
    @Override
    protected JSONObject doInBackground(String... cities) throws Exception {
        return fetchWeather(cities[0]); // 实现见上一节
    }

    @Override
    protected void done() {
        try {
            JSONObject data = get();
            double temp = data.getJSONObject("main").getDouble("temp") - 273.15;
            String name = data.getString("name");
            resultLabel.setText(String.format("%s: %.1f°C", name, temp));
        } catch (Exception ex) {
            resultLabel.setText("查询失败：" + ex.getMessage());
            JOptionPane.showMessageDialog(null, ex.toString());
        } finally {
            ((JButton)getRootPane().getContentPane().getComponent(2)).setEnabled(true);
        }
    }
}</jsonobject>

}

真实项目里，API 密钥不该硬编码在 Java 文件中；城市搜索建议加下拉补全；但对初学者，先确保一次请求能打出正确温度——比堆砌功能重要得多。最容易忽略的是：每次改完代码，记得删掉旧的 .class 文件再编译，否则可能跑着上一版逻辑还一脸懵。