TmplApi.java

package com.foxinmy.weixin4j.mp.api;

import java.util.List;

import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONObject;
import com.alibaba.fastjson.serializer.NameFilter;
import com.foxinmy.weixin4j.exception.WeixinException;
import com.foxinmy.weixin4j.http.weixin.ApiResult;
import com.foxinmy.weixin4j.http.weixin.WeixinResponse;
import com.foxinmy.weixin4j.model.Token;
import com.foxinmy.weixin4j.mp.message.TemplateMessage;
import com.foxinmy.weixin4j.mp.model.TemplateMessageInfo;
import com.foxinmy.weixin4j.mp.type.IndustryType;
import com.foxinmy.weixin4j.token.TokenManager;
import com.foxinmy.weixin4j.util.NameValue;

/**
 * 模板消息相关API
 * 
 * @className TemplApi
 * @author jinyu(foxinmy@gmail.com)
 * @date 2014年9月30日
 * @since JDK 1.6
 * @see
 */
public class TmplApi extends MpApi {

	private final TokenManager tokenManager;

	public TmplApi(TokenManager tokenManager) {
		this.tokenManager = tokenManager;
	}

	/**
	 * 设置所属行业(每月可修改行业1次,账号仅可使用所属行业中相关的模板)
	 * 
	 * @param industryTypes
	 *            所处行业 目前不超过两个
	 * @return 操作结果
	 * @throws WeixinException
	 * @see com.foxinmy.weixin4j.mp.type.IndustryType
	 * @see <a
	 *      href="https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1433751277&token=&lang=zh_CN">设置所处行业</a>
	 */
	public ApiResult setTmplIndustry(IndustryType... industryTypes)
			throws WeixinException {
		JSONObject obj = new JSONObject();
		for (int i = 0; i < industryTypes.length; i++) {
			obj.put(String.format("industry_id%d", i + 1),
					Integer.toString(industryTypes[i].getTypeId()));
		}
		Token token = tokenManager.getCache();
		String template_set_industry_uri = getRequestUri("template_set_industry_uri");
		WeixinResponse response = weixinExecutor.post(String.format(
				template_set_industry_uri, token.getAccessToken()), obj
				.toJSONString());

		return response.getAsResult();
	}

	/**
	 * 获取设置的行业信息
	 * 
	 * @return 行业信息数组 第一个元素为帐号设置的主营行业 第二个元素为帐号设置的副营行业
	 * @throws WeixinException
	 * @see com.foxinmy.weixin4j.mp.type.IndustryType
	 * @see <a
	 *      href="https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1433751277&token=&lang=zh_CN">获取设置的行业信息</a>
	 */
	public IndustryType[] getTmplIndustry() throws WeixinException {
		String template_get_industry_uri = getRequestUri("template_get_industry_uri");
		WeixinResponse response = weixinExecutor.get(String.format(
				template_get_industry_uri, tokenManager.getAccessToken()));
		JSONObject primary = response.getAsJson().getJSONObject(
				"primary_industry");
		JSONObject secondary = response.getAsJson().getJSONObject(
				"secondary_industry");
		return new IndustryType[] {
				primary != null ? IndustryType.getIndustry(
						primary.getString("first_class"),
						primary.getString("second_class")) : null,
				secondary != null ? IndustryType.getIndustry(
						secondary.getString("first_class"),
						secondary.getString("second_class")) : null };
	}

	/**
	 * 获取模板ID
	 * 
	 * @param shortId
	 *            模板库中模板的编号,有“TM**”和“OPENTMTM**”等形式
	 * @return 模板ID
	 * @throws WeixinException
	 * @see <a
	 *      href="https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1433751277&token=&lang=zh_CN">获得模板ID</a>
	 */
	public String getTemplateId(String shortId) throws WeixinException {
		Token token = tokenManager.getCache();
		String template_getid_uri = getRequestUri("template_getid_uri");
		WeixinResponse response = weixinExecutor.post(
				String.format(template_getid_uri, token.getAccessToken()),
				String.format("{\"template_id_short\":\"%s\"}", shortId));

		return response.getAsJson().getString("template_id");
	}

	/**
	 * 获取模板列表
	 * 
	 * @return 模板列表
	 * @see com.foxinmy.weixin4j.mp.model.TemplateMessageInfo
	 * @see <a
	 *      href="https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1433751277&token=&lang=zh_CN">获取模板列表</a>
	 * @throws WeixinException
	 */
	public List<TemplateMessageInfo> getAllTemplates() throws WeixinException {
		Token token = tokenManager.getCache();
		String template_getall_uri = getRequestUri("template_getall_uri");
		WeixinResponse response = weixinExecutor.get(String.format(
				template_getall_uri, token.getAccessToken()));
		return JSON.parseArray(response.getAsJson().getString("template_list"),
				TemplateMessageInfo.class);
	}

	/**
	 * 删除模板
	 * 
	 * @param templateId
	 *            公众帐号下模板消息ID
	 * @return 处理结果
	 * @see <a
	 *      href="https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1433751277&token=&lang=zh_CN">删除模板</a>
	 * @throws WeixinException
	 */
	public ApiResult deleteTemplate(String templateId) throws WeixinException {
		Token token = tokenManager.getCache();
		String template_del_uri = getRequestUri("template_del_uri");
		WeixinResponse response = weixinExecutor.post(
				String.format(template_del_uri, token.getAccessToken()),
				String.format("{\"template_id\":\"%s\"}", templateId));
		return response.getAsResult();
	}

	/**
	 * 发送模板消息
	 * 
	 * @param tplMessage
	 *            消息对象
	 * @return 发送的消息ID
	 * @throws WeixinException
	 * @see <a
	 *      href="https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1433751277&token=&lang=zh_CN">模板消息</a>
	 * @see <a href=
	 *      "https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1433751288&token=&lang=zh_CN"
	 *      >运营规范</a>
	 * @see com.foxinmy.weixin4j.mp.message.TemplateMessage
	 * @see com.foxinmy.weixin4j.msg.event.TemplatesendjobfinishMessage
	 */
	public String sendTmplMessage(TemplateMessage tplMessage)
			throws WeixinException {
		Token token = tokenManager.getCache();
		String template_send_uri = getRequestUri("template_send_uri");
		WeixinResponse response = weixinExecutor.post(
				String.format(template_send_uri, token.getAccessToken()),
				JSON.toJSONString(tplMessage, new NameFilter() {
					@Override
					public String process(Object object, String name,
							Object value) {
						if (object instanceof NameValue && name.equals("name")) {
							return "color";
						}
						return name;
					}
				}));

		return response.getAsJson().getString("msgid");
	}
}