手把手教你使用SpringBoot获取实时天气数据！

站长

2023年08月30日 14:13 · 阅读数 73

🏆本文收录于《Spring Boot从入门到精通》，专门攻坚指数提升。

本专栏致力打造最硬核 Spring Boot 从零基础到进阶系列学习内容，🚀均为全网独家首发，打造精品专栏，专栏持续更新中…欢迎大家订阅持续学习。

环境说明：Windows10 + Idea2021.3.2 + Jdk1.8 + SpringBoot 2.3.1.RELEASE

1. 前言🔥

在开发中，有时需要获取天气信息以提升用户体验或进行数据分析。而在实现这一功能时，通常需要使用天气 API 来获取公开的气象数据。在本文中，我们将使用 Spring Boot 框架来构建一个简单的天气应用程序，并介绍如何通过第三方 API 获取天气数据。

那么，具体如何实现呢？这将又会是干货满满的一期，全程无尿点不废话只抓重点教，具有非常好的学习效果，拿好小板凳准备就坐！希望学习的过程中大家认真听好好学，学习的途中有任何不清楚或疑问的地方皆可评论区留言或私信，bug菌将第一时间给予解惑，那么废话不多说，直接开整！Fighting！！

2. 环境说明🔥

本地的开发环境：

开发工具：IDEA 2021.3

JDK版本： JDK 1.8

Spring Boot版本：2.3.1 RELEASE

Maven版本：3.8.2

3. 实现思路🔥

我先来给同学们捋捋，到底要如何实现这种场景。

首先需要获取天气预报的API，可以选择免费的天气API，比如聚合数据、天气网等，注册并申请API Key（正文给大家推荐一个免密钥的，绝绝子）。
使用Spring Boot提供的RestTemplate类发送HTTP请求，调用天气API接口，获取返回的JSON数据。
使用Jackson或Gson等库，将JSON数据转换成Java对象，方便数据的处理。
根据需求，将天气数据存储到数据库中，呈现在前端页面上。
可以使用缓存技术，将天气预报数据缓存一段时间，避免频繁向天气API发送请求。(拓展需要)

4. 正文🔥

下面是以Spring Boot为雏形，获取天气预报数据的演示及示例代码，如要整个项目源码，可以在文末链接中自行获取。

4.1 搭建Spring Boot应用

4.2 添加依赖

在pom.xml文件中添加以下依赖：

        <!--Thymeleaf 静态模板-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-thymeleaf</artifactId>
        </dependency>

        <!--fastjson-->
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>fastjson</artifactId>
            <version>1.2.51</version>
        </dependency>

        <!--OkHttp3工具类-->
        <dependency>
            <groupId>com.squareup.okhttp3</groupId>
            <artifactId>okhttp</artifactId>
            <version>4.9.1</version>
        </dependency>

4.3 创建Weather类

创建一个Weather类，用于存储天气预报数据，示例代码如下，仅供参考：

**
 * 存储天气预报数据
 */
@Data
public class Weather implements Serializable {
    private static final long serialVersionUID = -7671756385477179547L;

    private String city;//地区
    private String time;//天气上一次更新时间
    private String shidu;//湿度
    private String quality;//空气质量
    private String wendu;//温度

    private String high;//最高温度
    private String low;//最低温度
    private String sunrise;//日出时间
    private String sunset;//日落时间
    private String aqi;//空气指数
    private String fx;//风向
    private String fl;//风速
    private String type;//天气
    private String notice;//温馨提醒

}

4.4 创建WeatherService类

创建WeatherService类，用于调用天气API获取天气预报数据，解析返回的数据，并封装成Weather对象返回。

想要要获取天气，我们需要使用气象API，它提供了天气数据的实时更新，选择其中一个API，然后按照API文档中的说明进行API集成；为了给大家做演示，这里我找来一个免API Key版的第三方API，只需要通过HTTP方法发起GET请求即可从API中获取一个Json数据。

这里我们可以使用浏览器或者 CURL 工具，可以测试下该API天气接口是否正常返回天气数据。那么可以使用以下命令获取天气信息，例如：t.weather.itboy.net/api/weather…

手把手教你使用SpringBoot获取实时天气数据！

封装WeatherService类，示例代码如下，仅供参考：

@Service
public class WeatherService {
    private final String apiUrl = "http://t.weather.itboy.net/api/weather/city/";

    public List<Weather> getWeather(String cityCode) throws IOException {
        //HTTP请求 天气接口
        OkHttpClient client = new OkHttpClient();
        Request request = new Request.Builder()
                .url(apiUrl + cityCode)
                .build();
        Response response = client.newCall(request).execute();
        //返回
        String strJson = response.body().string();
        //json字符串解析
        JSONObject data = JSON.parseObject(strJson).getJSONObject("data");
        JSONObject cityInfo = JSON.parseObject(strJson).getJSONObject("cityInfo");

        JSONArray forecast = (JSONArray) data.get("forecast");
        //默认该集合中当天数据为集合第0条，所以我只需要将它取出即可。
        String forecast_0 = forecast.get(0).toString();
        //转Weather对象
        Weather weather = JSON.parseObject(forecast_0, Weather.class);
        weather.setCity(cityInfo.getString("city"));
        weather.setTime(JSON.parseObject(strJson).getString("time"));
        weather.setShidu(data.getString("shidu"));
        weather.setQuality(data.getString("quality"));
        weather.setWendu(data.getString("wendu"));

        List<Weather> res = new ArrayList<>();
        res.add(weather);
        return res;
    }
}

在这个方法中，我们使用OkHttp发送一个HTTP请求，获取天气信息的JSON数据，并通过FastJson将数据转换为一个JSON对象，最后转化成Weather对象。在这个JSON对象中，我们可以获取到天气信息的各个参数，如温度、风向等等。当然，你也可以使用HttpURLConnection或者其他HTTP客户端库来发送HTTP请求并获取响应。

4.5 创建WeatherController类

创建一个WeatherController类，用于提供获取天气预报数据的接口，并实现其具体的实现类。实现类中需要调用集成的天气数据 API 并返回相应的天气数据，示例代码如下，仅供参考：

@Controller
public class WeatherController {

    @Autowired
    private WeatherService weatherService;

    @RequestMapping("/weather/{cityCode}")
    public String  getWeather(@PathVariable String cityCode, Model model) throws IOException {
        //获取天气数据
        List<Weather> weathers = weatherService.getWeather(cityCode);
        model.addAttribute("weathers", weathers);
        return "weather";
    }
}

注意： 参数cityCode为城市代码，这里具体以国家气象局发布的为标准，毕竟我所调取第三方API用的就是也是那一套城市代码，比如101020100 为上海市代码，101020200 为上海市闵行区的城市代码等。

4.6 创建静态页面weather.html

创建一个静态页面，将获取到天气信息，并将其显示在页面上，示例代码如下，仅供参考：

<!DOCTYPE HTML>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>当日天气预报</title>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
</head>
<body>
    <div th:each="weather : ${weathers}">
        <p th:text="'地区:'+ ${weather.city}"></p>
        <p th:text="'更新时间:'+${weather.time}"></p>
        <p th:text="'温度:'+${weather.wendu}"></p>
        <p th:text="'湿度:'+${weather.shidu}"></p>
        <p th:text="'空气质量:'+${weather.quality}"></p>
        <p th:text="'最高温度:'+${weather.high}"></p>
        <p th:text="'最低温度:'+${weather.low}"></p>
        <p th:text="'日出时间:'+${weather.sunrise}"></p>
        <p th:text="'日落时间:'+${weather.sunset}"></p>
        <p th:text="'空气指数:'+${weather.aqi}"></p>
        <p th:text="'风向:'+${weather.fx}"></p>
        <p th:text="'风速:'+${weather.fl}"></p>
        <p th:text="'天气:'+${weather.type}"></p>
        <p th:text="'温馨提醒:'+${weather.notice}"></p>
    </div>
</body>
</html>

此处就不详细演示SpringBoot应用如何集成Thymeleaf 静态模板及功能演示了，不会的同学可以去看我的这篇《Spring Boot 整合 Thymeleaf 模板引擎，开发Web页面》，零基础教程浅显易懂，一定可以帮到你的(切记，快去快回，本文才是重中之重！)，如果你不想学这种方式，我也不反对你通过jQuery发GET请求的方式来获取json数据以渲染到页面中，一切自由发挥，我只做示例演示。

手把手教你使用SpringBoot获取实时天气数据！