【气象助手项目开发】-第三篇：聚合平台WebService技术

最新推荐文章于 2020-12-16 13:09:41 发布

张科勇

最新推荐文章于 2020-12-16 13:09:41 发布

阅读量1.5k

点赞数 2

分类专栏： android项目开发文章标签： Android项目实战 web service 聚合数据技术 Android

本文链接：https://blog.csdn.net/kedi_study/article/details/50346847

版权

android项目开发专栏收录该内容

11 篇文章 1 订阅

订阅专栏

一、聚合数据WebService介绍

聚合数据（https://www.juhe.cn/），是一个专门提供各种数据服务网站。使用之前需要先注册成为开发者。

二、聚合数据WebService服务使用

1.注册成为聚合数据服务开发者。（如果已有账户，则可跳过此步，直接进入登录界面进行登录）

步骤：

（1）在浏览器地址框中输入或复制聚合数据官方网址：https://www.juhe.cn/，回车，打开聚合数据网站。

（2）点击聚合数据网站右上角的注册文本，进入注册界面。

（3）按照界面上的注册向导，完成注册。

（4）使用新注册账户进行登录成功后，方可有权使用聚合数据服务。

2、申请全国天气预报数据API服务（测试使用2个月，之后需要对app进行审核，否则数据服务不能正常使用）

步骤：

（1）初始登录是直接进入个人中心的，可在个人中心申请数据服务，如下图:

（2）如果不是初始登录，则进入首页，可按下图步骤申请全国天气预报数据服务：

（2）点击申请数据按钮，进入申请数据界面。

（3）点击申请按钮，完成申请。

如果是第一次注册，需要输入手机号码，如果是已经申请过此服务，则提醒已经申请过该服务了

3、查看我的数据。

已经申请过的数据服务，在我的数据界面会以列表的方式一条一条的显示该界面中。

步骤：

（1）点击左侧数据中心里我的数据，会看到刚刚申请成功的全国天气预报记录，

可能会有其它申请过的数据服务记录。

（2）点击操作列的查看，可以查看应用信息，尤其AppKey,它作为数据服务识别我们的APP的唯一标识。

（3）点击操作列的统计，可以查看我们的APP今日和近15天内每小时请求数走势图。

刚申请时没有请求数据，所以走势图为空是正常的。

如果有请求数据，则统计就会以折线的方式展示，如下图：

4、学习API

步骤：

（1）在我的数据中，点击全国天气预报记录的操作列中接口文本，进入接口文档界面。

目前支持6个接口，根据需求使用对应的API。

（2）根据城市名/id查询天气接口研究。

此接口将作为我们获取某城市天气数据的接口。

接口文档描述的非常清楚，这里就不重复了。如有问题，大家可在留言处提问或私信我。

（3）天气种类及标识列表接口研究。

此接口将天气与一个标识一一对应，将来可作为匹配天气对应的图标标识。

接口文档描述的非常清楚，这里就不重复了。如有问题，大家可在留言处提问或私信我。

（4）支持城市列表接口研究。

此接口将作为我们更多城市模块中要使用城市数据的接口。

接口文档描述的非常清楚，这里就不重复了。如有问题，大家可在留言处提问或私信我。

4、测试API

聚合平台提供了测试每个API的测试工具，我们可以通过测试工具来测试要使用的接口是否正常。

步骤：

（1）点击API界面中的API测试工具文本，进入测试工具界面。

（2）测试：根据城市名/id查询天气接口。（第一个API）

如果返回的结果下如图，说明申请的数据服务时间上已超过聚合设定的测试模式使用时间，需要实名认证

后才可继续使用此数据服务。

如需实名认证可进入个人中心，点击个人资料中的实名认证，按要求填写姓名和上传身份证正反面，再点击提交认证，完成认证

（一般在一小时内通知认证结果）。

如果没有以上问题，测试结果应该如下图：

（3）测试：

支持城市列表接口（第六个API）

按照下图6步，完成测试。

测试结果如下图：

(4)测试其它接口

如果需要用到其它接口，可类似上面两个测试接口的步骤进行测试。

5、编码实现数据的获取

全国天气预报API中有各种语言编写的示例代码，可参考这里的示例完成数据的获取（我选择Java语言）。

需要注意的是：如果获取数据时，返回的状态码不是200，可根据API中的错误码对照表查找错误原因。

下面是示例代码中的一些核心代码：

（1）常量工具类：

package com.kedi.juheclient.constant;

/**
 * 常量池对象类：专门用来存放APP中要使用到的常量
 * 
 * @author 张科勇
 *
 */
public class AppConstant {
	// 聚合数据-申请数据服务成功后分配的key,做为此应用与数据服务交互的唯一标识
	public static final String APPKEY = "01360343b6a3ca6d4ade944eee95bf96";
	// 根据城市名获取天气数据的网络地址
	public static final String WEATHER_REPORT_BY_CITY_URL = "http://v.juhe.cn/weather/index";
	// 获取天气种类及标识列表网络地址
	public static final String WEATHER_ICON_AND_ID_URL = "http://v.juhe.cn/weather/uni";
	// 获取支持城市列表网络地址
	public static final String CITY_LIST_URL = "http://v.juhe.cn/weather/citys";
	// 表示数据获取功能
	public static final String RESULT_OK = "200";
}

（2）获取网络数据工具类

package com.kedi.juheclient.utils;

import java.io.BufferedReader;
import java.io.BufferedWriter;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.io.OutputStreamWriter;
import java.net.HttpURLConnection;
import java.net.URL;
import java.util.Map;

import javax.net.ssl.HttpsURLConnection;

/**
 * 网络请求工具类
 * 
 * @author 张科勇
 *
 */
public class NetWorkUtil {
	/**
	 * get方式请求网络数据的方法
	 * 
	 * @param url
	 *            网络地址
	 * @return 网络数据
	 */

	public static <K, V> String get(String url) {
		try {
			// 将字符串网址封装成URL对象，目前是为了使用URL对象打开网络链接
			URL u = new URL(url);
			// 打开网络链接，并强制转化成使用Http协议的链接对象HttpURLConnection
			HttpURLConnection conn = (HttpURLConnection) u.openConnection();
			StringBuffer sb = null;
			conn.setRequestMethod("GET");
			conn.connect();// 建立连接
			// 获取服务端响应码，如果等于200，则服务端响应成功，否则响应不成功
			int recode = conn.getResponseCode();
			// 服务端响应请求成功
			if (recode == HttpsURLConnection.HTTP_OK) {
				// 获取输入流（字节流），读取服务端返回的数据
				InputStream in = conn.getInputStream();
				// 将字节流转化成字符流
				InputStreamReader inr = new InputStreamReader(in);
				// 将低级流封装成高级流
				BufferedReader br = new BufferedReader(inr);
				String str = null;
				sb = new StringBuffer();
				// 按行读取服务端返回的数据，判断如果不为null，则将读到的一行数据保存到StringBuffer中
				while ((str = br.readLine()) != null) {
					sb.append(str);
					// 每行后添加一个换行符
					sb.append(System.getProperty("line.separator"));
				}
				// 关闭输入流
				br.close();
				// 判断如果返回的数据为空，返回null
				if (sb.toString().length() == 0) {
					// 获取的数据为空
					return null;
				}
				// 返回服务端响应的数据字符串（去到最后一行的换行符）
				return sb.toString().substring(0,
						sb.toString().length() - System.getProperty("line.separator").length());
			}
			return null;

		} catch (Exception e) {
			e.printStackTrace();
		}
		return null;
	}

	/**
	 * post方式请求网络数据的方法
	 * 
	 * @param url
	 *            网络地址
	 * @param params
	 *            请求参数Map集合，如果没有参数，则传null
	 * @return 返回网络数据
	 */
	public static <K, V> String post(String url, Map<K, V> params) {
		try {
			// 将字符串网址封装成URL对象，目前是为了使用URL对象打开网络链接
			URL u = new URL(url);
			// 打开网络链接，并强制转化成使用Http协议的链接对象HttpURLConnection
			HttpURLConnection conn = (HttpURLConnection) u.openConnection();
			StringBuffer sb = null;
			// 判断网络请求是否带参数，如果带参数则params！=null,接下来需要将参数从Map集合中遍历出来，写到输出流中
			if (params != null) {
				// 打开输出流开闭，默认是关闭的，只有打开后，客户端才可以通过输出流向服务端上传数据（此处上传的是参数数据）
				conn.setDoOutput(true);
				// 设置请求方式为post
				conn.setRequestMethod("POST");
				// 获取输出流对象（字节流）
				OutputStream out = conn.getOutputStream();
				// 将字节流转化成字符流
				OutputStreamWriter ousw = new OutputStreamWriter(out);
				// 将低级流转化成带缓冲的高级流
				BufferedWriter bw = new BufferedWriter(ousw);
				sb = new StringBuffer();
				// 遍历Map集合中的所有参数，并按k=v&的形式保存到StringBuffer中
				for (Map.Entry<K, V> m : params.entrySet()) {
					sb.append(m.getKey() + "=" + m.getValue() + "&");
				}
				// 使用高级流将StringBuffer中的参数写到输出流中
				bw.write(sb.deleteCharAt(sb.length() - 1).toString());
				// 关闭高级输出流，将参数上传给服务端
				bw.close();
				sb = null;
			}
			conn.connect();// 建立连接
			// 获取服务端响应码，如果等于200，则服务端响应成功，否则响应不成功
			int recode = conn.getResponseCode();
			// 服务端响应请求成功
			if (recode == HttpsURLConnection.HTTP_OK) {
				// 获取输入流（字节流），读取服务端返回的数据
				InputStream in = conn.getInputStream();
				// 将字节流转化成字符流
				InputStreamReader inr = new InputStreamReader(in);
				// 将低级流封装成高级流
				BufferedReader br = new BufferedReader(inr);
				String str = null;
				sb = new StringBuffer();
				// 按行读取服务端返回的数据，判断如果不为null，则将读到的一行数据保存到StringBuffer中
				while ((str = br.readLine()) != null) {
					sb.append(str);
					// 每行后添加一个换行符
					sb.append(System.getProperty("line.separator"));
				}
				// 关闭输入流
				br.close();
				// 判断如果返回的数据为空，返回null
				if (sb.toString().length() == 0) {
					// 获取的数据为空
					return null;
				}
				// 返回服务端响应的数据字符串（去到最后一行的换行符）
				return sb.toString().substring(0,
						sb.toString().length() - System.getProperty("line.separator").length());
			}
			return null;

		} catch (Exception e) {
			e.printStackTrace();
		}
		return null;
	}
}

（3）获取天气相关数据工具类

package com.kedi.juheclient.utils;

import java.net.URLEncoder;
import java.util.HashMap;
import java.util.Map;

import org.json.JSONException;
import org.json.JSONObject;

import com.kedi.juheclient.constant.AppConstant;

import android.util.Log;

/**
 * 获取天气相对数据的工具类
 * 
 * @author 张科勇
 *
 */
public class WeatherReportUtil {
	/**
	 * 根据城市名获取天气数据的方法
	 * 
	 * @param cityName
	 *            城市名， 必填
	 * @param dtype
	 *            返回数据格式：json或xml,默认json，可选
	 * @param format
	 *            未来6天预报(future)两种返回格式，1或2，默认1，可选
	 * @return
	 */
	public static String getWeatherReportByCity(String cityName, String dtype, int format) {
		// 接口网址
		String url = AppConstant.WEATHER_REPORT_BY_CITY_URL;
		StringBuffer sb = new StringBuffer();
		String city;
		try {
			// 将传递进来的中文使用UTF-8进行编码
			city = URLEncoder.encode(cityName, "utf-8");
			// 拼装url
			sb.append("cityname=" + city);
			sb.append("&");
			sb.append("format=" + format);
			sb.append("&");
			sb.append("dtype=" + dtype);
			sb.append("&");
			sb.append("key=" + AppConstant.APPKEY);
			url = url + "?" + sb.toString();
			// 这里用get方式请求数据
			String result = NetWorkUtil.get(url);
			JSONObject jsonObj = new JSONObject(result);
			// 安全性检查
			if (!"".equals(jsonObj)) {
				String resultcode = jsonObj.getString("resultcode");
				if (!"".equals(resultcode)) {
					if (AppConstant.RESULT_OK.equals(resultcode)) {
						result = jsonObj.getString("result");
						return result;
					}
				}

			}

		} catch (Exception e) {
			e.printStackTrace();
		}

		return null;
	}

	/**
	 * 获取支持的城市列表数据
	 * 
	 * @param dtype
	 *            返回数据格式：json或xml,默认json，可选
	 * @return
	 */
	public static String getCityList(String dtype) {
		// 拼装url
		String url = AppConstant.CITY_LIST_URL;
		Map<String, String> params = new HashMap<String, String>();
		params.put("dtype", dtype);
		params.put("key", AppConstant.APPKEY);
		// 用post方式请求数据
		String result = NetWorkUtil.post(url, params);
		JSONObject jsonObj;
		try {
			jsonObj = new JSONObject(result);
			String resultcode = jsonObj.getString("resultcode");
			if (AppConstant.RESULT_OK.equals(resultcode)) {
				result = jsonObj.getString("result");
				return result;
			}
		} catch (JSONException e) {
			e.printStackTrace();
		}
		return null;
	}

	/**
	 * 获取天气种类及标识列表数据
	 * 
	 * @param dtype
	 *            返回数据格式：json或xml,默认json，可选
	 * @return
	 */
	public static String getWeatherIconAndId(String dtype) {
		// 拼装url
		String url = AppConstant.WEATHER_ICON_AND_ID_URL;
		Map<String, String> params = new HashMap<String, String>();
		params.put("dtype", dtype);
		params.put("key", AppConstant.APPKEY);
		// 用post方式请求数据
		String result = NetWorkUtil.post(url, params);
		JSONObject jsonObj;
		try {
			jsonObj = new JSONObject(result);
			String resultcode = jsonObj.getString("resultcode");
			if (AppConstant.RESULT_OK.equals(resultcode)) {
				result = jsonObj.getString("result");
				return result;
			}
		} catch (JSONException e) {
			e.printStackTrace();
		}
		return null;
	}
}

（4）测试代码

package com.kedi.juheclient;

import com.kedi.juheclient.utils.WeatherReportUtil;

import android.app.Activity;
import android.os.Bundle;
import android.util.Log;
/**
 * 测试类
 * @author 张科勇
 *
 */
public class MainActivity extends Activity {

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

		new Thread(new Runnable() {

			@Override
			public void run() {
				// 根据城市名获取天气数据
				String weatherStr = WeatherReportUtil.getWeatherReportByCity("北京", "json", 2);
				Log.i("weatherStr=", weatherStr + "");
			}
		}).start();
		new Thread(new Runnable() {

			@Override
			public void run() {

				// 获取天气图标与标识
				String weatherIconAndIdStr = WeatherReportUtil.getWeatherIconAndId("json");
				Log.i("weatherIconAndIdStr=", weatherIconAndIdStr + "");
			}
		}).start();
		new Thread(new Runnable() {

			@Override
			public void run() {
				// 获取支持城市列表数据
				String cityListStr = WeatherReportUtil.getCityList("json");
				Log.i("cityListStr=", cityListStr + "");
			}
		}).start();

	}

}

说明：这是一个Android项目，不要忘了在AndroidManifest.xml文件中添加访问网络的权限。

案例源码下载：http://pan.baidu.com/s/1dEjE7Rz

张科勇

关注

2
点赞
踩
2

收藏

觉得还不错? 一键收藏
3
评论
【气象助手项目开发】-第三篇：聚合平台WebService技术

一、聚合数据WebService介绍聚合数据（https://www.juhe.cn/），是一个专门提供各种数据服务网站。使用之前需要先注册成为开发者。二、聚合数据WebService服务使用 1.注册成为聚合数据服务开发者（如果已有账户，则可跳过此步，直接进入登录界面进行登录）。步骤：（1）在浏览器地址框中输入或复制聚合数据官方
复制链接

扫一扫

专栏目录