content: /*
   * 微信公众平台(JAVA) SDK
   *
   * Copyright (c) 2014, Ansitech Network Technology Co.,Ltd All rights reserved.
   * 
   * http://www.weixin4j.org/
   *
   * Licensed under the Apache License, Version 2.0 (the "License");
   * you may not use this file except in compliance with the License.
   * You may obtain a copy of the License at
   *
   *      http://www.apache.org/licenses/LICENSE-2.0
   *
   * Unless required by applicable law or agreed to in writing, software
   * distributed under the License is distributed on an "AS IS" BASIS,
   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   * See the License for the specific language governing permissions and
   * limitations under the License.
   */
  package org.weixin4j.component;
  
  import com.alibaba.fastjson.JSONArray;
  import com.alibaba.fastjson.JSONObject;
  import java.util.ArrayList;
  import java.util.List;
  import org.weixin4j.Configuration;
  import org.weixin4j.Weixin;
  import org.weixin4j.WeixinException;
  import org.weixin4j.http.HttpsClient;
  import org.weixin4j.http.Response;
  import org.weixin4j.model.tags.Tag;
  
  /**
   * 用户标签管理组件
   *
   * @author yangqisheng
   * @since 0.1.0
   */
  public class TagsComponent extends AbstractComponent {
  
      public TagsComponent(Weixin weixin) {
          super(weixin);
      }
  
      /**
       * 创建标签
       *
       * <p>
       * 一个公众号，最多可以创建100个标签。</p>
       *
       * @param name 标签名，UTF8编码
       * @return 包含标签ID的对象
       * @throws org.weixin4j.WeixinException 微信操作异常
       */
      public Tag create(String name) throws WeixinException {
          //创建请求对象
          HttpsClient http = new HttpsClient();
          //拼接参数
          JSONObject postTag = new JSONObject();
          JSONObject postName = new JSONObject();
          postName.put("name", name);
          postTag.put("tag", postName);
          //调用获创建标签接口
          Response res = http.post("https://api.weixin.qq.com/cgi-bin/tags/create?access_token=" + weixin.getToken().getAccess_token(), postTag);
          //根据请求结果判定，是否验证成功
          JSONObject jsonObj = res.asJSONObject();
          //成功返回如下JSON:
          //{"tag":{"id":134, name":"广东"}}
          if (jsonObj != null) {
              if (Configuration.isDebug()) {
                  System.out.println("获取/tags/create返回json：" + jsonObj.toString());
              }
              Object errcode = jsonObj.get("errcode");
              if (errcode != null && !errcode.toString().equals("0")) {
                  //返回异常信息
                  throw new WeixinException(getCause(jsonObj.getIntValue("errcode")));
              } else {
                  JSONObject tagJson = jsonObj.getJSONObject("tag");
                  if (tagJson != null) {
                      return JSONObject.toJavaObject(tagJson, Tag.class);
                  }
              }
          }
          return null;
      }
  
      /**
       * 获取公众号已创建的标签
       *
       * @return 公众号标签列表
       * @throws org.weixin4j.WeixinException 微信操作异常
       */
      public List<Tag> get() throws WeixinException {
          List<Tag> tagList = new ArrayList<Tag>();
          //创建请求对象
          HttpsClient http = new HttpsClient();
          //调用获取jsapi_ticket接口
          Response res = http.get("https://api.weixin.qq.com/cgi-bin/tags/get?access_token=" + weixin.getToken().getAccess_token());
          //根据请求结果判定，是否验证成功
          JSONObject jsonObj = res.asJSONObject();
          //成功返回如下JSON:
          //{"tags":[{"id":1,"name":"黑名单","count":0},{"id":2,"name":"星标组","count":0},{"id":127,"name":"广东","count":5}]}
          if (jsonObj != null) {
              if (Configuration.isDebug()) {
                  System.out.println("获取/tags/get返回json：" + jsonObj.toString());
              }
              Object errcode = jsonObj.get("errcode");
              if (errcode != null && !errcode.toString().equals("0")) {
                  //返回异常信息
                  throw new WeixinException(getCause(jsonObj.getIntValue("errcode")));
              } else {
                  JSONArray tags = jsonObj.getJSONArray("tags");
                  if (tags != null) {
                      for (int i = 0; i < tags.size(); i++) {
                          JSONObject jsonTag = tags.getJSONObject(i);
                          Tag tag = (Tag) JSONObject.toJavaObject(jsonTag, Tag.class);
                          tagList.add(tag);
                      }
                  }
              }
          }
          return tagList;
      }
  
      /**
       * 编辑标签
       *
       * @param id 标签id，由微信分配
       * @param name 标签名，UTF8编码（30个字符以内）
       * @throws org.weixin4j.WeixinException 微信操作异常 编辑标签异常
       */
      public void update(int id, String name) throws WeixinException {
          //内部业务验证
          if (id < 0) {
              throw new IllegalStateException("id can not <= 0!");
          }
          if (name == null || name.equals("")) {
              throw new IllegalStateException("name is null!");
          }
          //拼接参数
          JSONObject postTag = new JSONObject();
          JSONObject postName = new JSONObject();
          postName.put("id", id);
          postName.put("name", name);
          postTag.put("tag", postName);
          //创建请求对象
          HttpsClient http = new HttpsClient();
          //调用获取access_token接口
          Response res = http.post("https://api.weixin.qq.com/cgi-bin/tags/update?access_token=" + weixin.getToken().getAccess_token(), postTag);
          //根据请求结果判定，是否验证成功
          JSONObject jsonObj = res.asJSONObject();
          if (jsonObj != null) {
              if (Configuration.isDebug()) {
                  System.out.println("/tags/update返回json：" + jsonObj.toString());
              }
              //判断是否修改成功
              //正常时返回 {"errcode": 0, "errmsg": "ok"}
              //错误时返回 示例：{"errcode":45158,"errmsg":"标签名长度超过30个字节"}
              int errcode = jsonObj.getIntValue("errcode");
              //登录成功，设置accessToken和过期时间
              if (errcode != 0) {
                  //返回异常信息
                  throw new WeixinException(getCause(errcode));
              }
          }
      }
  
      /**
       * 删除标签
       *
       * @param id 标签Id
       * @throws org.weixin4j.WeixinException 微信操作异常 删除分组异常
       */
      public void delete(int id) throws WeixinException {
          //拼接参数
          JSONObject postParam = new JSONObject();
          JSONObject postId = new JSONObject();
          postId.put("id", id);
          postParam.put("tag", postId);
          //创建请求对象
          HttpsClient http = new HttpsClient();
          //调用获取access_token接口
          Response res = http.post("https://api.weixin.qq.com/cgi-bin/tags/delete?access_token=" + weixin.getToken().getAccess_token(), postParam);
          //根据请求结果判定，是否验证成功
          JSONObject jsonObj = res.asJSONObject();
          if (jsonObj != null) {
              if (Configuration.isDebug()) {
                  System.out.println("/tags/delete返回json：" + jsonObj.toString());
              }
              Object errcode = jsonObj.get("errcode");
              if (errcode != null && !errcode.toString().equals("0")) {
                  //返回异常信息
                  throw new WeixinException(getCause(jsonObj.getIntValue("errcode")));
              }
          }
      }
  
      /**
       * 批量为用户打标签
       *
       * @param tagid 标签ID
       * @param openids 粉丝OpenId集合
       * @throws org.weixin4j.WeixinException 微信操作异常
       */
      public void membersBatchtagging(int tagid, String[] openids) throws WeixinException {
          JSONObject json = new JSONObject();
          json.put("tagid", tagid);
          json.put("openid_list", openids);
          //创建请求对象
          HttpsClient http = new HttpsClient();
          Response res = http.post("https://api.weixin.qq.com/cgi-bin/tags/members/batchtagging?access_token=" + weixin.getToken().getAccess_token(), json);
          //根据请求结果判定，是否验证成功
          JSONObject jsonObj = res.asJSONObject();
          if (jsonObj != null) {
              if (Configuration.isDebug()) {
                  System.out.println("/tags/members/batchtagging返回json：" + jsonObj.toString());
              }
              Object errcode = jsonObj.get("errcode");
              if (errcode != null && !errcode.toString().equals("0")) {
                  //返回异常信息
                  throw new WeixinException(getCause(jsonObj.getIntValue("errcode")));
              }
          }
      }
  
      /**
       * 批量为用户取消标签
       *
       * @param tagid 标签ID
       * @param openids 粉丝OpenId集合
       * @throws org.weixin4j.WeixinException 微信操作异常
       */
      public void membersBatchuntagging(int tagid, String[] openids) throws WeixinException {
          JSONObject json = new JSONObject();
          json.put("tagid", tagid);
          json.put("openid_list", openids);
          //创建请求对象
          HttpsClient http = new HttpsClient();
          Response res = http.post("https://api.weixin.qq.com/cgi-bin/tags/members/batchuntagging?access_token=" + weixin.getToken().getAccess_token(), json);
          //根据请求结果判定，是否验证成功
          JSONObject jsonObj = res.asJSONObject();
          if (jsonObj != null) {
              if (Configuration.isDebug()) {
                  System.out.println("/tags/members/batchuntagging返回json：" + jsonObj.toString());
              }
              Object errcode = jsonObj.get("errcode");
              if (errcode != null && !errcode.toString().equals("0")) {
                  //返回异常信息
                  throw new WeixinException(getCause(jsonObj.getIntValue("errcode")));
              }
          }
      }
  
      /**
       * 获取用户身上的标签列表
       *
       * @param openid 粉丝OpenId
       * @return 公众号标签ID集合
       * @throws org.weixin4j.WeixinException 微信操作异常
       */
      public Integer[] getIdList(String openid) throws WeixinException {
          //创建请求对象
          HttpsClient http = new HttpsClient();
          //调用获取用户身上的标签列表接口
          Response res = http.get("https://api.weixin.qq.com/cgi-bin/tags/getidlist?access_token=" + weixin.getToken().getAccess_token());
          //根据请求结果判定，是否验证成功
          JSONObject jsonObj = res.asJSONObject();
          //成功返回如下JSON:
          //{"tagid_list":[134,2]}
          if (jsonObj != null) {
              if (Configuration.isDebug()) {
                  System.out.println("获取/tags/getidlist返回json：" + jsonObj.toString());
              }
              Object errcode = jsonObj.get("errcode");
              if (errcode != null && !errcode.toString().equals("0")) {
                  //返回异常信息
                  throw new WeixinException(getCause(jsonObj.getIntValue("errcode")));
              } else {
                  JSONArray tags = jsonObj.getJSONArray("tagid_list");
                  if (tags != null) {
                      return tags.toArray(new Integer[]{});
                  }
              }
          }
          return null;
      }
  
      /**
       * 获取公众号的黑名单openids列表
       *
       * @param openid 开始粉丝OpenId(首次传空)
       * @return 黑名单列表
       * @throws org.weixin4j.WeixinException 微信操作异常
       * @since 0.1.4
       */
      public String[] membersGetBlackList(String openid) throws WeixinException {
          //创建请求对象
          HttpsClient http = new HttpsClient();
          //封装请求参数
          JSONObject postParam = new JSONObject();
          postParam.put("begin_openid", openid);
          //调用获取用户身上的标签列表接口
          Response res = http.post("https://api.weixin.qq.com/cgi-bin/tags/members/getblacklist?access_token=" + weixin.getToken().getAccess_token(), postParam);
          //根据请求结果判定，是否验证成功
          JSONObject jsonObj = res.asJSONObject();
          //成功返回如下JSON:
          //{
          // "total":23000,
          // "count":10000,
          // "data":{"
          //    openid":[
          //       "OPENID1",
          //       "OPENID2",
          //       ...,
          //       "OPENID10000"
          //    ]
          //  },
          //  "next_openid":"OPENID10000"
          //}
          if (jsonObj != null) {
              if (Configuration.isDebug()) {
                  System.out.println("获取/tags/members/getblacklist返回json：" + jsonObj.toString());
              }
              Object errcode = jsonObj.get("errcode");
              if (errcode != null && !errcode.toString().equals("0")) {
                  //返回异常信息
                  throw new WeixinException(getCause(jsonObj.getIntValue("errcode")));
              } else {
                  JSONObject data = jsonObj.getJSONObject("data");
                  if (data != null) {
                      //获取openid集合
                      JSONArray arrays = data.getJSONArray("openid");
                      if (openid != null) {
                          String[] openids = arrays.toArray(new String[]{});
                          //根据openid查询用户信息
                          return openids;
                      }
                  }
              }
          }
          return null;
      }
  
      /**
       * 批量拉黑用户
       *
       * @param openids 需要拉入黑名单的用户的openid，一次拉黑最多允许20个
       * @throws org.weixin4j.WeixinException 微信操作异常
       * @since 0.1.4
       */
      public void membersBatchblacklist(String[] openids) throws WeixinException {
          JSONObject json = new JSONObject();
          json.put("openid_list", openids);
          //创建请求对象
          HttpsClient http = new HttpsClient();
          Response res = http.post("https://api.weixin.qq.com/cgi-bin/tags/members/batchblacklist?access_token=" + weixin.getToken().getAccess_token(), json);
          //根据请求结果判定，是否验证成功
          JSONObject jsonObj = res.asJSONObject();
          if (jsonObj != null) {
              if (Configuration.isDebug()) {
                  System.out.println("/tags/members/batchblacklist返回json：" + jsonObj.toString());
              }
              Object errcode = jsonObj.get("errcode");
              if (errcode != null && !errcode.toString().equals("0")) {
                  //返回异常信息
                  throw new WeixinException(getCause(jsonObj.getIntValue("errcode")));
              }
          }
      }
  
      /**
       * 批量取消拉黑用户
       *
       * @param openids 需要取消拉入黑名单的用户的openid，一次拉黑最多允许20个
       * @throws org.weixin4j.WeixinException 微信操作异常
       * @since 0.1.4
       */
      public void membersBatchunblacklist(String[] openids) throws WeixinException {
          JSONObject json = new JSONObject();
          json.put("openid_list", openids);
          //创建请求对象
          HttpsClient http = new HttpsClient();
          Response res = http.post("https://api.weixin.qq.com/cgi-bin/tags/members/batchunblacklist?access_token=" + weixin.getToken().getAccess_token(), json);
          //根据请求结果判定，是否验证成功
          JSONObject jsonObj = res.asJSONObject();
          if (jsonObj != null) {
              if (Configuration.isDebug()) {
                  System.out.println("/tags/members/batchunblacklist返回json：" + jsonObj.toString());
              }
              Object errcode = jsonObj.get("errcode");
              if (errcode != null && !errcode.toString().equals("0")) {
                  //返回异常信息
                  throw new WeixinException(getCause(jsonObj.getIntValue("errcode")));
              }
          }
      }
  }
  