登录
首页 >  文章 >  java教程

Java天气查询Demo:HTTP请求入门教程

时间:2026-02-01 10:45:40 450浏览 收藏

亲爱的编程学习爱好者,如果你点开了这篇文章,说明你对《Java实现天气查询Demo:HTTP请求入门教程》很感兴趣。本篇文章就来给大家详细解析一下,主要介绍一下,希望所有认真读完的童鞋们,都有实质性的提高。

使用HttpURLConnection调用天气API需设置User-Agent、启用重定向、URL编码中文、逐层解析JSON;注意和风需城市ID与lang=zh,OpenWeatherMap需units=metric及q/lat参数,避免403、429和解析异常。

如何使用Java实现天气查询Demo_JavaHTTP请求初级实战说明

HttpURLConnection 发起 GET 请求获取天气数据

Java 标准库自带的 HttpURLConnection 足够完成基础天气 API 调用,无需额外依赖。关键在于正确设置请求头、处理重定向和读取响应流。

  • 必须设置 conn.setRequestProperty("User-Agent", "Mozilla/5.0"),否则部分天气 API(如和风、心知)会返回 403
  • 务必调用 conn.setInstanceFollowRedirects(true),避免因 301/302 跳转导致读到空响应
  • 响应体要用 BufferedReader 按行读取,不能直接 conn.getInputStream().readAllBytes()(JDK 8 不支持)
  • 中文城市名需先用 URLEncoder.encode("北京", "UTF-8") 编码,否则 URL 解析失败

解析 JSON 响应时避开 org.json 的常见陷阱

天气 API 返回的是标准 JSON,但新手常在解析时遇到 JSONException: JSONObject["xxx"] not found 或空指针。问题往往出在字段路径或类型误判上。

  • 先用在线工具(如 jsonlint.com)校验返回体结构,确认实际字段名是 now 还是 data.now
  • JSONObject.get("temperature") 会抛异常,改用 optInt("temperature", -999)optString("temperature", "N/A")
  • 嵌套对象要逐层检查:先 json.optJSONObject("now"),再从中取 optString("text_day"),不能链式调用 json.getJSONObject("now").getString("text_day")
  • 数组字段(如预报列表)要用 optJSONArray("daily_forecast"),空数组时 getJSONArray 直接炸

使用免费天气 API 时必须注意的配额与参数细节

和风天气(https://dev.qweather.com)和 OpenWeatherMap 是最常用的免费源,但它们的请求格式、认证方式和字段命名差异很大。

  • 和风要求 location 参数传城市 ID(如 101010100),不是城市名;需先调用「城市搜索」接口查 ID,或用其提供的城市 ID CSV 文件
  • OpenWeatherMap 用 q=beijinglat=39.9&lon=116.4,但免费 Key 每分钟最多 1000 次,超限返回 429 Too Many Requests
  • 两个 API 都要求在 URL 中携带 key=YOUR_KEY,和风还强制加 lang=zh 才返回中文描述
  • 响应里温度单位默认是开尔文(K),OpenWeatherMap 需加 &units=metric 才得摄氏度
URL url = new URL("https://devapi.qweather.com/v7/weather/now?location=101010100&key=YOUR_KEY&lang=zh");
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("GET");
conn.setRequestProperty("User-Agent", "Mozilla/5.0");
conn.setConnectTimeout(5000);
conn.setReadTimeout(5000);
int responseCode = conn.getResponseCode();
if (responseCode == HttpURLConnection.HTTP_OK) {
    BufferedReader reader = new BufferedReader(new InputStreamReader(conn.getInputStream(), "UTF-8"));
    StringBuilder resp = new StringBuilder();
    String line;
    while ((line = reader.readLine()) != null) resp.append(line);
    reader.close();
    JSONObject json = new JSONObject(resp.toString());
    JSONObject now = json.optJSONObject("now");
    if (now != null) {
        String temp = now.optString("temp", "未知");
        String text = now.optString("text_day", "无描述");
        System.out.println("当前温度:" + temp + "℃,天气:" + text);
    }
}
真正卡住人的往往不是写不出请求,而是没意识到城市 ID 和温度单位这些“默认不透明”的约定。调试时先手动把完整 URL 粘到浏览器里看返回结果,比盯着 Java 报错更有用。

以上就是《Java天气查询Demo:HTTP请求入门教程》的详细内容,更多关于的资料请关注golang学习网公众号!

前往漫画官网入口并下载 ➜
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>