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开发学习有所帮助！
