Android项目实战：使用Retrofit构建天气预报应用

本文将详细介绍如何使用Retrofit构建一个功能齐全的Android天气预报应用。我们将通过图文并茂的方式，一步步讲解如何实现网络交互功能和构建整个应用。在本教程中，您将学到如何在实际项目中使用Retrofit进行网络请求，以及如何构建一个天气预报应用。

1. 项目简介

在这个Android项目实战中，我们将构建一个简单的天气预报应用。用户可以输入城市名称，获取该城市的实时天气信息、未来几天的天气预报以及其他相关信息。为了实现这个功能，我们将使用Retrofit框架进行网络请求，从OpenWeatherMap API获取天气数据。

2. Retrofit简介

Retrofit是一款用于Android和Java应用的优秀网络请求库，它将HTTP API转换为Java接口。Retrofit的主要优点在于其简洁易用的API设计和对异步请求的支持。使用Retrofit，我们可以更轻松地实现网络请求功能。

3. 准备工作

3.1 添加依赖

首先，在项目的build.gradle文件中添加Retrofit和Gson依赖：

dependencies {
    implementation 'com.squareup.retrofit2:retrofit:2.9.0'
    implementation 'com.squareup.retrofit2:converter-gson:2.9.0'
}

3.2 获取API Key

为了使用OpenWeatherMap API，您需要注册一个免费的API Key。请访问OpenWeatherMap官网进行注册，并获取API Key。

4. 构建应用

4.1 创建接口

首先，我们需要创建一个接口，定义我们需要的网络请求方法。在这个例子中，我们需要一个根据城市名称获取天气信息的方法：

public interface WeatherService {
    @GET("weather")
    Call<WeatherResponse> getWeatherByCityName(@Query("q") String cityName, @Query("appid") String apiKey);

    @GET("forecast")
    Call<ForecastResponse> getForecastByCityName(@Query("q") String cityName, @Query("appid") String apiKey);
}

4.2 创建Retrofit实例

接下来，我们需要创建一个Retrofit实例，并配置相关参数。在这个例子中，我们需要配置基础URL和Gson转换器：

public class RetrofitClient {
    private static Retrofit retrofit;

    public static Retrofit getRetrofitInstance(String baseUrl) {
        if (retrofit == null) {
            retrofit = new Retrofit.Builder()
                    .baseUrl(baseUrl)
                    .addConverterFactory(GsonConverterFactory.create())
                    .build();
        }
        return retrofit;
    }
}

4.3创建数据模型

根据OpenWeatherMap API的响应格式，我们需要创建相应的数据模型。这里我们以WeatherResponse和ForecastResponse为例，创建对应的数据模型类。

public class WeatherResponse {
    // 省略其他字段

    @SerializedName("main")
    private Main main;

    @SerializedName("weather")
    private List<Weather> weather;

    // 省略 getter 和 setter
}

public class Main {
    // 省略其他字段

    @SerializedName("temp")
    private double temp;

    @SerializedName("humidity")
    private int humidity;

    // 省略 getter 和 setter
}

public class Weather {
    // 省略其他字段

    @SerializedName("description")
    private String description;

    // 省略 getter 和 setter
}

public class ForecastResponse {
    // 省略其他字段

    @SerializedName("list")
    private List<ForecastItem> forecastItems;

    // 省略 getter 和 setter
}

public class ForecastItem {
    // 省略其他字段

    @SerializedName("dt_txt")
    private String dateTime;

    @SerializedName("main")
    private Main main;

    @SerializedName("weather")
    private List<Weather> weather;

    // 省略 getter 和 setter
}

4.4 发起网络请求

现在，我们可以使用创建好的Retrofit实例发起网络请求。在这个例子中，我们在主活动中实现这一功能：

public class MainActivity extends AppCompatActivity {
    private static final String BASE_URL = "https://api.openweathermap.org/data/2.5/";
    private static final String API_KEY = "your_api_key";

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        WeatherService weatherService = RetrofitClient.getRetrofitInstance(BASE_URL).create(WeatherService.class);

        // 获取用户输入的城市名称
        EditText editTextCityName = findViewById(R.id.editTextCityName);
        Button buttonSearch = findViewById(R.id.buttonSearch);
        TextView textViewWeatherInfo = findViewById(R.id.textViewWeatherInfo);
        RecyclerView recyclerViewForecast = findViewById(R.id.recyclerViewForecast);

        // 设置按钮点击事件
        buttonSearch.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                String cityName = editTextCityName.getText().toString();
                Call<WeatherResponse> callWeather = weatherService.getWeatherByCityName(cityName, API_KEY);
                Call<ForecastResponse> callForecast = weatherService.getForecastByCityName(cityName, API_KEY);

                callWeather.enqueue(new Callback<WeatherResponse>() {
                    @Override
                    public void onResponse(Call<WeatherResponse> call, Response<WeatherResponse> response) {
                        if (response.isSuccessful()) {
                            WeatherResponse weatherResponse = response.body();
                            String weatherInfo = "城市：" + weatherResponse.getName() + "\n"
                                    + "温度：" + (weatherResponse.getMain().getTemp() - 273.15) + "℃\n"
                                    + "湿度：" + weatherResponse.getMain().getHumidity() + "%\n"
                                    + "天气：" + weatherResponse.getWeather().get(0).getDescription();
                            textViewWeatherInfo.setText(weatherInfo);
                        } else {
                            textViewWeatherInfo.setText("请求失败，请检查输入的城市名称");
                        }
                    }

                    @Override
                    public void onFailure(Call<WeatherResponse> call, Throwable t) {
                        textViewWeatherInfo.setText("网络错误，请稍后重试");
                    }
                });

                callForecast.enqueue(new Callback<ForecastResponse>() {
                    @Override
                    public void onResponse(Call<ForecastResponse> call, Response<ForecastResponse> response) {
                        if (response.isSuccessful()) {
                            ForecastResponse forecastResponse = response.body();
                            List<ForecastItem> forecastItems = forecastResponse.getForecastItems();

                            ForecastAdapter adapter = new ForecastAdapter(forecastItems);
                            recyclerViewForecast.setLayoutManager(new LinearLayoutManager(MainActivity.this));
                            recyclerViewForecast.setAdapter(adapter);
                        } else {
                            Toast.makeText(MainActivity.this, "获取未来天气预报失败", Toast.LENGTH_SHORT).show();
                        }
                    }

                    @Override
                    public void onFailure(Call<ForecastResponse> call, Throwable t) {
                        Toast.makeText(MainActivity.this, "网络错误，请稍后重试", Toast.LENGTH_SHORT).show();
                    }
                });
            }
        });
    }
}

在上述代码中，我们首先从EditText组件获取用户输入的城市名称，然后使用WeatherService接口发起网络请求。通过回调方法，我们可以处理网络请求的结果，将天气信息显示在TextView组件上，同时将未来几天的天气预报数据展示在RecyclerView中。

4.5 自定义RecyclerView适配器

为了在RecyclerView中展示未来几天的天气预报数据，我们需要创建一个自定义的适配器。以下是一个简单的ForecastAdapter实现：

public class ForecastAdapter extends RecyclerView.Adapter<ForecastAdapter.ForecastViewHolder> {
    private List<ForecastItem> forecastItems;

    public ForecastAdapter(List<ForecastItem> forecastItems) {
        this.forecastItems = forecastItems;
    }

    @NonNull
    @Override
    public ForecastViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
        View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.item_forecast, parent, false);
        return new ForecastViewHolder(view);
    }

    @Override
    public void onBindViewHolder(@NonNull ForecastViewHolder holder, int position) {
        ForecastItem forecastItem = forecastItems.get(position);

        holder.textViewDateTime.setText(forecastItem.getDateTime());
        holder.textViewTemp.setText(String.format("%.1f℃", forecastItem.getMain().getTemp() - 273.15));
        holder.textViewWeather.setText(forecastItem.getWeather().get(0).getDescription());
    }

    @Override
    public int getItemCount() {
        return forecastItems.size();
    }

    static class ForecastViewHolder extends RecyclerView.ViewHolder {
        TextView textViewDateTime;
        TextView textViewTemp;
        TextView textViewWeather;

        public ForecastViewHolder(@NonNull View itemView) {
            super(itemView);
            textViewDateTime = itemView.findViewById(R.id.textViewDateTime);
            textViewTemp = itemView.findViewById(R.id.textViewTemp);
            textViewWeather = itemView.findViewById(R.id.textViewWeather);
        }
    }
}

5. 结语

在这篇博客中，我们一步步实现了一个功能齐全的Android天气预报应用，并使用Retrofit框架进行网络请求。通过这个实战项目，您可以了解到如何在实际应用中使用Retrofit进行网络交互，以及如何构建一个天气预报应用。希望这篇博客对您的Android开发学习有所帮助！