Java天气查询小程序开发教程

本文深入解析了如何用Java打造一个稳定健壮的天气查询小程序，强调核心不在花哨界面，而在扎实的工程实践：推荐新手选用文档友好、免费额度充足的和风天气API，借助OkHttp高效发送HTTPS请求并合理管理连接与超时，通过Jackson精准解析嵌套JSON并妥善处理空值与异常，辅以本地缓存和简洁命令行交互提升实用性，同时将API密钥、城市ID映射等配置外置，全面覆盖网络失败、响应非200、字段缺失等真实场景——手把手教你写出真正能跑稳、易维护、有生产意识的Java小工具。

用Java写一个天气查询小程序，核心是调用第三方天气API（如和风天气、高德天气、OpenWeatherMap等），获取JSON格式的天气数据，再用Java解析并展示。关键不在界面多炫，而在请求是否稳定、解析是否健壮、异常是否兜底。

选对API是第一步：免费额度+文档清晰+支持HTTPS

新手推荐从和风天气免费版入手：每天1000次调用、无需企业认证、返回结构统一、中文文档友好。注册后拿到key，就能拼出类似这样的URL：

https://devapi.qweather.com/v7/weather/now?location=101010100&key=YOUR_KEY

其中location是城市ID（不是名称），需先查“城市搜索API”获取。别直接传“北京”——接口不认字符串地名。

用HttpURLConnection或OkHttp发请求，别手写Socket

Java原生HttpURLConnection够用，但建议引入OkHttp（更简洁、自动处理重试与连接池）。示例片段：

• 构建OkHttpClient实例（可复用，别每次new）
• 用Request.Builder设置URL、Header（如User-Agent）
• 同步execute()获取Response，检查response.code()==200再读body
• 务必在try-with-resources或finally里关闭response.body().close()

解析JSON别用正则，用Jackson或Gson

返回的JSON嵌套深（比如{"code":200,"now":{"temp":"22","textDay":"晴"}}），手撕字符串极易出错。用Jackson两步搞定：

• 定义对应Java类（如WeatherResponse、NowData），字段名与JSON key一致或加@JsonProperty注解
• ObjectMapper.readValue(jsonString, WeatherResponse.class) 直接转对象
• 重点：为所有可能为空的字段（如precip、windScale）设默认值或判null，避免运行时NullPointerException

加一层缓存和简单命令行交互，体验立刻不同

每次输城市名太累？加个本地缓存（比如HashMap）存最近查过的城市；再用Scanner读用户输入，支持“quit”退出、“help”提示指令。不必做GUI，控制台清爽实用：

• 启动时打印欢迎语和可用城市列表（可预置北京、上海、广州ID）
• 输入“shanghai”自动匹配ID，调用API，格式化输出温度、天气状况、风向
• 网络失败时明确提示“请求超时，请检查网络”，而非堆栈报错刷屏

不复杂但容易忽略：所有外部依赖（API key、城市ID映射表）抽到配置文件，别硬编码；每个HTTP请求设timeout（建议connectTimeout=5s，readTimeout=10s）；JSON字段名大小写、空值、code非200都得单独处理——这才是项目能跑稳的关键。

理论要掌握，实操不能落！以上关于《Java天气查询小程序开发教程》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！