推荐使用和风天气免费API,通过OkHttp发送HTTPS请求获取JSON数据,用Jackson解析为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”获取。别直接传“北京”——接口不认字符串地名。
立即学习“Java免费学习笔记(深入)”;
用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
- 启动时打印欢迎语和可用城市列表(可预置北京、上海、广州ID)
- 输入“shanghai”自动匹配ID,调用API,格式化输出温度、天气状况、风向
- 网络失败时明确提示“请求超时,请检查网络”,而非堆栈报错刷屏
不复杂但容易忽略:所有外部依赖(API key、城市ID映射表)抽到配置文件,别硬编码;每个HTTP请求设timeout(建议connectTimeout=5s,readTimeout=10s);JSON字段名大小写、空值、code非200都得单独处理——这才是项目能跑稳的关键。










