com.foxinmy.weixin4j.mp.model.SemQuery Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of weixin4j-mp Show documentation
微信公众平台API
There is a newer version: 1.10.2
package com.foxinmy.weixin4j.mp.model;

import java.io.Serializable;

import com.alibaba.fastjson.JSONObject;
import com.foxinmy.weixin4j.mp.type.SemCategory;

/**
 * 语义理解参数
 * 
 * @className SemQuery
 * @author jinyu([email protected])
 * @date 2014年11月7日
 * @since JDK 1.6
 * @see
 */
public class SemQuery implements Serializable {

	private static final long serialVersionUID = 679548284525912436L;
	private JSONObject jsonObj;

	/**
	 * 输入文本串
	 * 
	 * @param query
	 */
	public SemQuery(String query) {
		jsonObj = new JSONObject();
		jsonObj.put("query", query);
	}

	/**
	 * 城市名称,与经纬度二选一传入
	 * 
	 * @param city
	 * @return
	 */
	public SemQuery city(String city) {
		jsonObj.put("city", city);
		return this;
	}

	/**
	 * 需要使用的服务类别,多个用,隔开,不能为空
	 * 
	 * @param categorys
	 * @return
	 */
	public SemQuery category(SemCategory... categorys) {
		StringBuilder category = new StringBuilder();
		if (categorys.length == 1) {
			category.append(categorys[0].name());
		} else {
			for (int i = 0; i < categorys.length - 1; i++) {
				category.append(categorys[i].name()).append(",");
			}
			category.append(categorys[categorys.length - 1].name());
		}
		jsonObj.put("category", category.toString());
		return this;
	}

	/**
	 * App id,开发者的唯一标识,用于区分开放者, 如果为空,则没法使用上下文理解功能。
	 * 
	 * @param appid
	 * @return
	 */
	public SemQuery appid(String appid) {
		jsonObj.put("appid", appid);
		return this;
	}

	/**
	 * 用户唯一 id(并非开发者 id),用于区分该开发者下不同用户,如果为空,则没法使用上下文理解功能。appid 和
	 * uid同时存在的情况下,才可以使用上下文理解功能。
	 * 
	 * @param uid
	 * @return
	 */
	public SemQuery uid(String uid) {
		jsonObj.put("uid", uid);
		return this;
	}

	/**
	 * 区域名称,在城市存在的情况下可省;与经纬度 二选一传入
	 * 
	 * @param region
	 * @return
	 */
	public SemQuery region(String region) {
		jsonObj.put("region", region);
		return this;
	}

	/**
	 * 纬度经度;与城市二选一传入
	 * 
	 * @param latitude
	 * @param longitude
	 * @return
	 */
	public SemQuery location(float latitude, float longitude) {
		jsonObj.put("latitude", latitude);
		jsonObj.put("longitude", longitude);
		return this;
	}

	/**
	 * 输入文本串
	 * 
	 * @param query
	 * @return
	 */
	public static SemQuery build(String query) {
		return new SemQuery(query);
	}

	public String toJson() {
		return jsonObj.toJSONString();
	}

	@Override
	public String toString() {
		return "SemQuery " + jsonObj;
	}
}