JAVA 调用第三方短信平台接口发送短信
做了几个调用三方短信平台发送短信的例子，大部分需要 携带参数,向指定URL发送请求
回顾对接第一个平台时痛苦的乱码经历，这里放一份代码，算是个模版，再用到的时候过来copy一下就OK。
在进入主题之前，考虑一个编码的问题：
1、unicode，utf8，gbk，gb2312之类的指的到底是什么？为什么需要它们？
字符编码中ASCII、Unicode和UTF-8的区别 - 风行风中 - 博客园 (cnblogs.com)
GB2312、GBK、GB18030 这几种字符集的主要区别是什么？ - 知乎 (zhihu.com)
- 简单来说，计算机只能识别0和1组成的二进制，所以为了显示某一个字符，必须指定字符与二进制表示的对应关系。
- 各种各样的字符会组合成一个集合，集合被称为字符表，
- 给字符表里的字符编上一个数字，也就是字符集合到一个整数集合的映射，这个整数集合叫做字符集，而按照字符二进制表示标准进行的实现叫做编码，我们需要它们的结合来让屏幕显示出我们看得懂的内容。
- 编码其实就是一种映射关系，将字节表示的值映射到字符集中的符号。
- unicode是一种字符集，涵盖了世界上所有的字符，utf8是一种用于unicode的编码方式
- gb2312是国内针对 ASCII 扩展的字符集，通常我们把编码方案也叫做gb2312。GBK是对gb2312做的扩展。
也就是说，gbk，gb2312和 utf8 不是一个派系的。
2、程序运行时，处于内存中的字符串是不是也具有指定的编码？如果没有，为什么有时候在获取字节数组时还要指定编码方式？
这里我看了一些文章，有了自己的理解，但是不知道理解的是否正确，先不列出来了
Get请求
- getResponse 内将数据写入请求的方式
- 组织数据时对content进行URL编码
- 正确设置content-type 头
//调用处捕获异常处理发送失败的情况，所以代码内不合预期的情况都是直接抛Exception
public void send(String to, String content) throws Exception {
//username,password,content,to...参数的非空 及 格式判断
String apiRspStr = getResponse(to,content); //构建请求，获取响应
String result = resolve(apiRspStr); //解析响应数据(kv,json,html...)，
//成功时返回代码，失败时返回错误消息
if(!"0".equals(result)) { //"0" 需要按平台文档替换
throw new Exception("消息发送失败：" + result);
}
}
private String getResponse(String to, String content) throws Exception {
URLConnection con = null;
OutputStreamWriter out = null;
BufferedReader br = null;
String sendSmsData;
try {
sendSmsData = organizationData(to,content);
log.info("请求参数为：" + sendSmsData);
} catch (Exception e) {
log.error("组织请求数据时出现错误", e);
throw e;
}
try {
URL requestUrl = new URL(getUrl());
con = requestUrl.openConnection();
con.setDoOutput(true);
con.setRequestProperty("Pragma", "no-cache");
con.setRequestProperty("Cache-Control", "no-cache");
con.setRequestProperty("Content-Type", "application/x-www-form-urlencoded;charset=gb2312"); // 按短信平台的要求设置 charset的值
out = new OutputStreamWriter(con.getOutputStream());
out.write(sendSmsData);
out.flush();
out.close();
br = new BufferedReader(new InputStreamReader(con.getInputStream()));
String line = "";
StringBuffer buf = new StringBuffer();
while ( (line = br.readLine()) != null ) {
buf.append(line);
}
String responseStr = buf.toString();
log.info("响应数据：" + responseStr);
return responseStr;
} catch (IOException e) {
e.printStackTrace();
log.error("获取响应失败", e);
throw e;
} finally {
try {
if(out != null) {
out.close();
}
}catch(Exception e) {}
try {
if(br != null) {
br.close();
}
}catch(Exception e) {}
}
}
private String organizationData(String to, String content) throws Exception {
StringBuilder sendBuilder = new StringBuilder();
sendBuilder.append("username=");//用户登录名
sendBuilder.append(getUserName());
sendBuilder.append("&password=");//密码需要按平台要求处理;
sendBuilder.append(hashpwd());
sendBuilder.append("&mobiles=");//接收手机号，限定不允许
sendBuilder.append(to);
sendBuilder.append("&content=");
sendBuilder.append(URLEncoder.encode(content, "GB2312"));
return sendBuilder.toString();
}
// resolve方法 依赖于短信平台返回结果的标准，这里提供的内容脱离平台就没有意义
//示例代码内 发送成功result为0，发送失败会返回各种含义的数字，description是中文描述
private String resolve(String rspStr) throws Exception { //rspStr: result=0&description=%B7%A2%CB%CD%B3%C9%B9%A6&faillist=
String[] resultArray = rspStr.split("&");
Map kv = new HashMap();
for(String array : resultArray) {
String[] elementArray = array.split("=");
if(elementArray.length == 2) {
kv.put(elementArray[0], elementArray[1]);
}
}
if(kv.isEmpty()) {
log.error("rspStr: " + rspStr);
throw new Exception("解析返回数据时未得到结果");
}
String result = "";
if("0".equals(kv.get("result").toString())) {
result = "0";
return result;
}
result = URLDecoder.decode(kv.get("description").toString(),"gb2312") ;
return result;
}
Post请求
- 短信内容要用URL编码
- 写入请求体的数据以 List<NameValuePair> 形式组织
public void sendSmsPost(MsgData msgData){
String respContent;//响应报文
CloseableHttpClient httpClient = null;
try{
httpClient = HttpClients.createDefault(); //创建连接对象
HttpPost httpPost = new HttpPost(smsUrl); //创建post对象
Map params = new HashMap(); //构建请求参数
String phone = msgData.getMsgTo(); //接收手机号
String text = msgData.getContent(); //发送内容
String gbkText = URLEncoder.encode(msgData.getContent().trim(), "GBK");
System.out.println("短信内容GBK：" + gbkText);
params.put("username",username);//登录用户名
params.put("password",password);//登录用户密码
params.put("to",phone); //消息接收手机号码
params.put("text",gbkText);
List<NameValuePair> postParams = getParams(params);
httpPost.setHeader("Content-Type","application/x-www-form-urlencoded;charset=gbk");
httpPost.setEntity(new UrlEncodedFormEntity(postParams));
//发送http请求，获取返回结果
HttpResponse httpResponse = httpClient.execute(httpPost);
if(httpResponse.getStatusLine().getStatusCode() == 200){
//解析数据
respContent = EntityUtils.toString(httpResponse.getEntity());
System.out.println("响应数据：" + respContent);
}else {
//请求失败
}
}catch (Exception e){
e.printStackTrace();
}finally {
try {
if(httpClient != null){
httpClient.close();
}
}catch (Exception e2){
e2.printStackTrace();
}
}
}
/**
* 参数解析
* @param map
* @return
*/
public static List<NameValuePair> getParams(Map<String, String> map){
List<NameValuePair> params = new ArrayList<NameValuePair>();
Set<Map.Entry<String, String>> entrySet = map.entrySet();
for (Map.Entry<String, String> e : entrySet) {
String name = e.getKey();
String value = e.getValue();
NameValuePair pair = new BasicNameValuePair(name, value);
params.add(pair);
}
return params;
}
