javaweb华为云短信通知公共类调用
情景：公司业务需求，短信从阿里云切换到华为云，参照华为云短信调用的相关文档遇到不少坑，在此记录一下。
开发环境：JDK1.8 系统环境：SpringBoot
1、华为云短信配置信息在application.yml中配置
sms:
huawei:
url: https://rtcsms.cn-north-1.myhuaweicloud.com:10743/sms/batchSendSms/v1
appKey: ******
appSecret: ******
2、创建短信公共类：HwSmsSender
package com.seeker.common.utils.hwsms;
import com.alibaba.fastjson.JSONObject;
import com.seeker.common.utils.Constants;
import com.seeker.common.utils.LoggerUtils;
import com.seeker.common.utils.SmsConstants;
import org.apache.commons.codec.binary.Hex;
import org.apache.commons.codec.digest.DigestUtils;
import org.apache.http.HttpHeaders;
import org.apache.http.HttpResponse;
import org.apache.http.NameValuePair;
import org.apache.http.client.methods.RequestBuilder;
import org.apache.http.client.utils.URLEncodedUtils;
import org.apache.http.conn.ssl.NoopHostnameVerifier;
import org.apache.http.entity.StringEntity;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.message.BasicNameValuePair;
import org.apache.http.ssl.SSLContextBuilder;
import org.apache.http.util.EntityUtils;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;
import java.nio.charset.Charset;
import java.text.SimpleDateFormat;
import java.util.*;
@Component
public class HwSmsSender {
protected Logger logger = LoggerFactory.getLogger(getClass());
/**
* 无需修改,用于格式化鉴权头域,给"X-WSSE"参数赋值
*/
private static final String WSSE_HEADER_FORMAT = "UsernameToken Username=\"%s\",PasswordDigest=\"%s\",Nonce=\"%s\",Created=\"%s\"";
/**
* 无需修改,用于格式化鉴权头域,给"Authorization"参数赋值
*/
private static final String AUTH_HEADER_VALUE = "WSSE realm=\"SDP\",profile=\"UsernameToken\",type=\"Appkey\"";
@Value("${sms.huawei.url}")
private String url;
@Value("${sms.huawei.appKey}")
private String appKey;
@Value("${sms.huawei.appSecret}")
private String appSecret;
public String sendNotifyMsg(String mobile, String templateId, String templateParas) throws Exception {
// 默认通知类
return sendMsg(mobile, SmsConstants.ResultMessage.SIGN_NOTIFY_ID, templateId, templateParas);
}
public String sendMsg(String mobile, String sender, String templateId, String templateParas) throws Exception {
//条件必填,国内短信关注,当templateId指定的模板类型为通用模板时生效且必填,必须是已审核通过的,与模板类型一致的签名名称
//国际/港澳台短信不用关注该参数
//签名名称
String signature = "美团外卖";
// String sender = "10690400999304584";
String receiver = "+86" + mobile;
//选填,短信状态报告接收地址,推荐使用域名,为空或者不填表示不接收状态报告
String statusCallBack = "";
/**
* 选填,使用无变量模板时请赋空值 String templateParas = "";
* 单变量模板示例:模板内容为"您的验证码是${1}"时,templateParas可填写为"[\"369751\"]"
* 双变量模板示例:模板内容为"您有${1}件快递请到${2}领取"时,templateParas可填写为"[\"3\",\"人民公园正门\"]"
* 模板中的每个变量都必须赋值，且取值不能为空
* 查看更多模板和变量规范:产品介绍>模板和变量规范
*/
//模板变量，此处以单变量验证码短信为例，请客户自行生成6位验证码，并定义为字符串类型，以杜绝首位0丢失的问题（例如：002569变成了2569）。
//templateParas = "[\"369751\"]";
//请求Body,不携带签名名称时,signature请填null
String body = buildRequestBody(sender, receiver, templateId, templateParas, statusCallBack, signature);
if (null == body || body.isEmpty()) {
LoggerUtils.info(logger, "body is null.");
return "1";
}
//请求Headers中的X-WSSE参数值
String wsseHeader = buildWsseHeader(appKey, appSecret);
if (null == wsseHeader || wsseHeader.isEmpty()) {
LoggerUtils.info(logger, "wsse header is null.");
return "1";
}
//如果JDK版本低于1.8,可使用如下代码
//为防止因HTTPS证书认证失败造成API调用失败,需要先忽略证书信任问题
//CloseableHttpClient client = HttpClients.custom()
// .setSSLContext(new SSLContextBuilder().loadTrustMaterial(null, new TrustStrategy() {
// @Override
// public boolean isTrusted(X509Certificate[] x509Certificates, String s) throws CertificateException {
// return true;
// }
// }).build()).setSSLHostnameVerifier(NoopHostnameVerifier.INSTANCE).build();
//如果JDK版本是1.8,可使用如下代码
//为防止因HTTPS证书认证失败造成API调用失败,需要先忽略证书信任问题
CloseableHttpClient client = HttpClients.custom()
.setSSLContext(new SSLContextBuilder().loadTrustMaterial(null,
(x509CertChain, authType) -> true).build())
.setSSLHostnameVerifier(NoopHostnameVerifier.INSTANCE)
.build();
//请求方法POST
HttpResponse response = client.execute(RequestBuilder.create("POST")
.setUri(url)
.addHeader(HttpHeaders.CONTENT_TYPE, "application/x-www-form-urlencoded")
.addHeader(HttpHeaders.AUTHORIZATION, AUTH_HEADER_VALUE)
.addHeader("X-WSSE", wsseHeader)
.setEntity(new StringEntity(body)).build());
//打印响应头域信息
LoggerUtils.info(logger, (response.toString()));
//打印响应消息实体
String entity = EntityUtils.toString(response.getEntity());
LoggerUtils.info(logger, "消息实体" + entity);
HwSmsRoot hwSmsRoot = JSONObject.parseObject(entity, HwSmsRoot.class);
return "0";
}
/**
* 构造请求Body体
*
* @param sender
* @param receiver
* @param templateId
* @param templateParas
* @param statusCallbackUrl
* @param signature | 签名名称,使用国内短信通用模板时填写
* @return
*/
static String buildRequestBody(String sender, String receiver, String templateId, String templateParas,
String statusCallbackUrl, String signature) {
if (null == sender || null == receiver || null == templateId || sender.isEmpty() || receiver.isEmpty()
|| templateId.isEmpty()) {
System.out.println("buildRequestBody(): sender, receiver or templateId is null.");
return null;
}
List keyValues = new ArrayList();
keyValues.add(new BasicNameValuePair("from", sender));
keyValues.add(new BasicNameValuePair("to", receiver));
keyValues.add(new BasicNameValuePair("templateId", templateId));
if (null != templateParas && !templateParas.isEmpty()) {
keyValues.add(new BasicNameValuePair("templateParas", templateParas));
}
if (null != statusCallbackUrl && !statusCallbackUrl.isEmpty()) {
keyValues.add(new BasicNameValuePair("statusCallback", statusCallbackUrl));
}
if (null != signature && !signature.isEmpty()) {
keyValues.add(new BasicNameValuePair("signature", signature));
}
return URLEncodedUtils.format(keyValues, Charset.forName("UTF-8"));
}
/**
* 构造X-WSSE参数值
*
* @param appKey
* @param appSecret
* @return
*/
static String buildWsseHeader(String appKey, String appSecret) {
if (null == appKey || null == appSecret || appKey.isEmpty() || appSecret.isEmpty()) {
System.out.println("buildWsseHeader(): appKey or appSecret is null.");
return null;
}
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss'Z'");
//Created
String time = sdf.format(new Date());
//Nonce
String nonce = UUID.randomUUID().toString().replace("-", "");
byte[] passwordDigest = DigestUtils.sha256(nonce + time + appSecret);
String hexDigest = Hex.encodeHexString(passwordDigest);
//如果JDK版本是1.8,请加载原生Base64类,并使用如下代码
//PasswordDigest
String passwordDigestBase64Str = Base64.getEncoder().encodeToString(hexDigest.getBytes());
//如果JDK版本低于1.8,请加载三方库提供Base64类,并使用如下代码
//PasswordDigest
//String passwordDigestBase64Str = Base64.encodeBase64String(hexDigest.getBytes(Charset.forName("utf-8")));
//若passwordDigestBase64Str中包含换行符,请执行如下代码进行修正
//passwordDigestBase64Str = passwordDigestBase64Str.replaceAll("[\\s*\t\n\r]", "");
return String.format(WSSE_HEADER_FORMAT, appKey, passwordDigestBase64Str, nonce, time);
}
//本地调试方法
public static void main(String[] args) throws Exception {
//必填,请参考"开发准备"获取如下数据,替换为实际值
//APP接入地址+接口访问URI
String url = "https://rtcsms.cn-north-1.myhuaweicloud.com:10743/sms/batchSendSms/v1";
//APP_Key 输入自己的
String appKey = "******";
//APP_Secret 输入自己的
String appSecret = "******";
//国内短信签名通道号或国际/港澳台短信通道号
String sender = "8820032023657";
//模板ID
String templateId = "d1e8f2c7ab964c6998bda5638238bb7d";
//条件必填,国内短信关注,当templateId指定的模板类型为通用模板时生效且必填,必须是已审核通过的,与模板类型一致的签名名称
//国际/港澳台短信不用关注该参数
//签名名称
String signature = "美团外卖";
//必填,全局号码格式(包含国家码),示例:+8615123**6789,多个号码之间用英文逗号分隔
//String receiver = "+8615123**6789,+8615234**7890"; //短信接收人号码
String receiver = "+8617520**2687";
//选填,短信状态报告接收地址,推荐使用域名,为空或者不填表示不接收状态报告
String statusCallBack = "";
/**
* 选填,使用无变量模板时请赋空值 String templateParas = "";
* 单变量模板示例:模板内容为"您的验证码是${1}"时,templateParas可填写为"[\"369751\"]"
* 双变量模板示例:模板内容为"您有${1}件快递请到${2}领取"时,templateParas可填写为"[\"3\",\"人民公园正门\"]"
* 模板中的每个变量都必须赋值，且取值不能为空
* 查看更多模板和变量规范:产品介绍>模板和变量规范
*/
//模板变量，此处以单变量验证码短信为例，请客户自行生成6位验证码，并定义为字符串类型，以杜绝首位0丢失的问题（例如：002569变成了2569）。
String templateParas = JSONObject.toJSONString(new String[]{"598745", "1"});
//请求Body,不携带签名名称时,signature请填null
String body = buildRequestBody(sender, receiver, templateId, templateParas, statusCallBack, signature);
if (null == body || body.isEmpty()) {
System.out.println("body is null.");
return;
}
//请求Headers中的X-WSSE参数值
String wsseHeader = buildWsseHeader(appKey, appSecret);
if (null == wsseHeader || wsseHeader.isEmpty()) {
System.out.println("wsse header is null.");
return;
}
//如果JDK版本低于1.8,可使用如下代码
//为防止因HTTPS证书认证失败造成API调用失败,需要先忽略证书信任问题
//CloseableHttpClient client = HttpClients.custom()
// .setSSLContext(new SSLContextBuilder().loadTrustMaterial(null, new TrustStrategy() {
// @Override
// public boolean isTrusted(X509Certificate[] x509Certificates, String s) throws CertificateException {
// return true;
// }
// }).build()).setSSLHostnameVerifier(NoopHostnameVerifier.INSTANCE).build();
//如果JDK版本是1.8,可使用如下代码
//为防止因HTTPS证书认证失败造成API调用失败,需要先忽略证书信任问题
CloseableHttpClient client = HttpClients.custom()
.setSSLContext(new SSLContextBuilder().loadTrustMaterial(null,
(x509CertChain, authType) -> true).build())
.setSSLHostnameVerifier(NoopHostnameVerifier.INSTANCE)
.build();
//请求方法POST
HttpResponse response = client.execute(RequestBuilder.create("POST")
.setUri(url)
.addHeader(HttpHeaders.CONTENT_TYPE, "application/x-www-form-urlencoded")
.addHeader(HttpHeaders.AUTHORIZATION, AUTH_HEADER_VALUE)
.addHeader("X-WSSE", wsseHeader)
.setEntity(new StringEntity(body)).build());
//打印响应头域信息
System.out.println(response.toString());
//打印响应消息实体
String entity = EntityUtils.toString(response.getEntity());
System.out.println(entity);
HwSmsRoot hwSmsRoot = JSONObject.parseObject(entity, HwSmsRoot.class);
System.out.println(hwSmsRoot.getCode());
}
}
3、上面公共类还用到以下类：
HwSmsResult
import lombok.Data;
@Data
public class HwSmsResult {
private String originTo;
private String createTime;
private String from;
private String smsMsgId;
private String status;
}
HwSmsRoot
@Data
public class HwSmsRoot {
private List result;
private String code;
private String description;
}
SmsConstants
public class SmsConstants {
public static class ResultMessage {
/**
* 通道 美团外卖 验证码类
*/
public static String SIGN_NOTIFY_ID = "8821041535507";
public static String SMS_SEND_ID = "8fed7b85f85d4a248fe983a321";
}
}
LoggerUtils
import org.slf4j.Logger;
public class LoggerUtils {
public static void debug(Logger logger, Object message) {
if (logger.isDebugEnabled()) {
logger.debug("Debug日志信息{}", message);
}
}
public static void info(Logger logger, Object message) {
if (logger.isInfoEnabled()) {
logger.info("Info日志信息{}", message);
}
}
public static void error(Logger logger, Object message) {
if (logger.isErrorEnabled()) {
logger.error("Error日志信息{}", message);
}
}
}
4、实战调用如下：
/**
* 获取验证码接口
*/
@PostMapping("/sendMessageWxUser")
public AjaxResult sendMessageWxUser(@RequestBody WxUser user, HttpServletRequest request, HttpServletResponse response) throws Exception {
String ipAddr = IPUtils.getIpAddr(request);
AjaxResult ajaxResult = new AjaxResult(0, "短信发送成功！请等待查收！");
if (StringUtils.isEmpty(user.getLoginName())) {
return AjaxResult.error(500, "手机号不能为空");
}
//生成6位随机数，有效期1分钟
String randNum = VerificatieCodeUtils.getRandNum(6);
String[] templateParas = new String[]{randNum, "1"};
String templateId = SmsConstants.ResultMessage.SMS_SEND_ID;
String code = smsSendUtils.sendRegisterSMS(user.getLoginName(), templateId, JSONObject.toJSONString(templateParas));
logger.info("--打印验证码：" + randNum);
if ("0".equals(code)) {
//缓存按ip+varcode 作为key保存
redisCache.setCacheObject(ipAddr + "varcode", randNum, 60, TimeUnit.SECONDS);
return ajaxResult;
} else {
return new AjaxResult(500, "短信发送失败！");
}
}
VerificatieCodeUtils ：验证码随机数生成
import java.util.Random;
public class VerificatieCodeUtils {
public static String getRandNum(int charCount) {
String charValue = "";
for (int i = 0; i < charCount; i++) {
char c = (char) (randomInt(0, 10) + '0');
charValue += String.valueOf(c);
}
return charValue;
}
public static int randomInt(int from, int to) {
Random r = new Random();
return from + r.nextInt(to - from);
}
}
最后：需要注意的是，根据自己项目开发环境版本调整一些相关方法，以及华为云一些密钥什么需要填写正确。
java调用华为云上的文字识别(OCR)接口
首先要满足的条件，已注册华为云账户，并订阅华为云上的文字识别接口，以下以订阅的身份证识别接口为例
package OCRDemo;
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.io.PrintWriter;
import java.net.URL;
import java.net.URLConnection;
import java.util.List;
import java.util.Map;
/**
* @author abang
* @date 2020/7/3 0003 20:59
*/
public class GetOCR {
public static void main(String[] args) throws IOException {
//请求的region
String region = "cn-north-4";
//用户名
String username = "xxxxxx";
//用户密码
String password = "xxxxxx";
//账户名
String userName = "xxxxxx";
//请求的uri接口
String uri = "/v1.0/ocr/id-card";
//传入image或uri的json字符串(图片为公网的地址，可查询)
String param = "{\"url\":\"http://photocdn.sohu.com/20101021/Img276166786.jpg\"}";
//获取用token
String token = getToken(region,username,password,userName);
//返回请求的图片文字信息
System.out.println(getIdCard(region,token,param,uri));
}
//获取请求链接中用户的token信息
public static String getToken(String region,String username,String password,String userName) throws IOException {
String iam = "https://iam."+region+".myhuaweicloud.com/v3/auth/tokens";
String param = "{\"auth\":{\"identity\":{\"methods\":[\"password\"],\"password\":{\"user\":{\"name\":\"" + username + "\",\"password\":\"" + password + "\",\"domain\":{\"name\":\"" + userName + "\"}}}},\"scope\":{\"project\":{\"name\":\"cn-north-4\"}}}}";
PrintWriter out;
BufferedReader in = null;
String token = "";
String response = "";
try {
//需要请求的url
URL url = new URL(iam);
//打开和URL之间的连接
URLConnection connection = url.openConnection();
//设置通用的请求属性，请求头部分
connection.setRequestProperty("accept", "*/*");
connection.setRequestProperty("connection", "Keep-Alive");
connection.setRequestProperty("user-agent", "Mozilla/4.0");
// 发送POST请求必须设置如下两行
connection.setDoInput(true);
connection.setDoOutput(true);
// 建立实际的连接
connection.connect();
///获取URLConnection对象对应的输出流
out = new PrintWriter(connection.getOutputStream());
//发送请求参数
out.write(param);
//flush输出流的缓冲
out.flush();
//获取相应头中的token信息
token = connection.getHeaderField("X-Subject-Token");
//定义BufferedReader输入流来读取URL的响应
in = new BufferedReader(new InputStreamReader(connection.getInputStream()));
String line;
while ((line = in.readLine()) != null) {
//换行打印获取结果
response += "\n" + line;
}
// 获取所有响应头字段
Map> map = connection.getHeaderFields();
// 遍历所有的响应头字段
for (String key : map.keySet()) {
//打印出相应头中的信息
//System.out.println(key + "--->" + map.get(key));
}
} catch (Exception e) {
System.out.println("发送GET请求出现异常！" + e);
e.printStackTrace();
}
// 使用finally块来关闭输入流
finally {
try {
if (in != null) {
in.close();
}
} catch (Exception e2) {
e2.printStackTrace();
}
}
//返回所要用到的token信息
return token;
}
//请求云上接口，调用接口服务
public static String getIdCard(String region,String token,String param,String uri) throws IOException {
String ocr = "https://ocr."+region+".myhuaweicloud.com"+uri;
String response = "";
BufferedReader in = null;
try {
URL url = new URL(ocr);
URLConnection connection = url.openConnection();
//容易载跟头，表明请求体的部分为json形式
connection.setRequestProperty("Content-Type", "application/json");
connection.setRequestProperty("X-Auth-Token", token);
connection.setDoOutput(true);
connection.setDoInput(true);
connection.connect();
PrintWriter out = new PrintWriter(connection.getOutputStream());
out.write(param);
out.flush();
in = new BufferedReader(new InputStreamReader(connection.getInputStream()));
String line;
while ((line = in.readLine()) != null) {
response += "\n" + line;
}
} catch (Exception e) {
System.out.println("发送GET请求出现异常！" + e);
e.printStackTrace();
}
// 使用finally块来关闭输入流
finally {
try {
if (in != null) {
in.close();
}
} catch (Exception e2) {
e2.printStackTrace();
}
}
//返回相应体中的结果，打印出来
return response;
}
}
返回成功
以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。