正文

C#开辟微信流派及运用(五)之用户分组信息管理【C#.Net教程】,csharp,.net,分组,用户,门户,应用,开发

搜教程
搜教程 V管理员 /196 阅读
1127
这篇文章重要为人人细致引见了C#开辟微信流派及运用第五篇，用户分组信息治理，具有肯定的参考价值，感兴趣的小伙伴们可以参考一下

在上个月的对C#开辟微信流派及运用做了引见，写过了几篇的漫笔举行分享，因为时刻关联，间隔了一段时刻没有继承写这个系列的博客了，并非对这个方面住手了研讨，而是继承深切探究这方面的手艺，为了更好的运用起来，用心做好底层的手艺开辟。本篇继承上一篇的引见，重要引见分组治理方面的开辟运用，这篇的内容和上一篇，作为一个完全的用户信息和分组信息治理的组合。

1、用户分组治理内容

用户分组的引入，重假如轻易治理关注者列表，以及轻易向差别的组别发送音讯的操纵的，一个民众账号，最多支撑建立500个分组。

用户分组治理，包括下面几个方面的内容：

1 建立分组
2 查询一切分组
3 查询用户地点分组
4 修正分组名
5 移动用户分组

微信关于建立分组的定义以下所示。

http要求体式格局: POST（请使用https协定）
https://api.weixin.qq.com/cgi-bin/groups/create?access_token=ACCESS_TOKEN
POST数据花样：json
POST数据例子：{"group":{"name":"test"}}

一般返回的效果以下所示。


{
  "group": {
    "id": 107, 
    "name": "test"
  }
}

其他接口，也是相似的体式格局，经由历程POST一些参数进去URL内里，猎取返回的Json数据。

前面漫笔定义了GroupJson的实体类信息以下所示。


  /// <summary>
  /// 分组信息
  /// </summary>
  public class GroupJson : BaseJsonResult
  {
    /// <summary>
    /// 分组id，由微信分派
    /// </summary>
    public int id { get; set; }

    /// <summary>
    /// 分组名字，UTF8编码
    /// </summary>
    public string name { get; set; }
  }

依据以上几个接口的定义，我定义了几个接口，并把它们归纳到用户治理的API接口内里。


    /// <summary>
    /// 查询一切分组
    /// </summary>
    /// <param name="accessToken">挪用接口凭据</param>
    /// <returns></returns>
    List<GroupJson> GetGroupList(string accessToken);
            
    /// <summary>
    /// 建立分组
    /// </summary>
    /// <param name="accessToken">挪用接口凭据</param>
    /// <param name="name">分组称号</param>
    /// <returns></returns>
    GroupJson CreateGroup(string accessToken, string name);
            
    /// <summary>
    /// 查询用户地点分组
    /// </summary>
    /// <param name="accessToken">挪用接口凭据</param>
    /// <param name="openid">用户的OpenID</param>
    /// <returns></returns>
    int GetUserGroupId(string accessToken, string openid);
    
    /// <summary>
    /// 修正分组名
    /// </summary>
    /// <param name="accessToken">挪用接口凭据</param>
    /// <param name="id">分组id，由微信分派</param>
    /// <param name="name">分组名字（30个字符之内）</param>
    /// <returns></returns>
    CommonResult UpdateGroupName(string accessToken, int id, string name);
            
    /// <summary>
    /// 移动用户分组
    /// </summary>
    /// <param name="accessToken">挪用接口凭据</param>
    /// <param name="openid">用户的OpenID</param>
    /// <param name="to_groupid">分组id</param>
    /// <returns></returns>
    CommonResult MoveUserToGroup(string accessToken, string openid, int to_groupid);

2、用户分组治理接口的完成

2.1 建立用户分组

为了剖析怎样完成建立用户分组的POST数据操纵，我们来一步步相识建立用户的详细历程。

起首须要建立一个动态定义的实体类信息，它包括几个须要说起的属性，以下所示。


string url = string.Format("https://api.weixin.qq.com/cgi-bin/groups/create?access_token={0}", accessToken);
var data = new
 {
  group = new
 {
  name = name
  }
 };
string postData = data.ToJson();

个中我们把对象转换为适宜的Json数据操纵，放到了扩大要领ToJson内里了，这个重要就是轻易把动态定义的实体类转换Json内容，重要就是挪用Json.NET的序列号操纵。


/// <summary>
/// 把对象为json字符串
/// </summary>
/// <param name="obj">待序列号对象</param>
/// <returns></returns>
public static string ToJson(this object obj)
 {
  return JsonConvert.SerializeObject(obj, Formatting.Indented);
 }

准备好Post的数据后，我们就进一步看看猎取数据并转换为适宜花样的操纵代码。


GroupJson group = null;

CreateGroupResult result = JsonHelper<CreateGroupResult>.ConvertJson(url, postData);
 if (result != null)
{
     group = result.group;
 }

个中POST数据并转换为适宜花样实体类的操纵，放在了ConvertJson要领内里，这个要领的定义以下所示，内里的HttpHelper是我公用类库的辅佐类，重要就是挪用底层的httpWebRequest对象要领，举行数据的提交，并猎取返回效果。


/// <summary>
/// 转换Json字符串到详细的对象
/// </summary>
/// <param name="url">返回Json数据的链接地点</param>
/// <param name="postData">POST提交的数据</param>
/// <returns></returns>
    public static T ConvertJson(string url, string postData)
    {
      HttpHelper helper = new HttpHelper();
      string content = helper.GetHtml(url, postData, true);
      VerifyErrorCode(content);

      T result = JsonConvert.DeserializeObject<T>(content);
      return result;
    }

如许，完全的建立用户分组的操纵函数以下所示。


    /// <summary>
    /// 建立分组
    /// </summary>
    /// <param name="accessToken">挪用接口凭据</param>
    /// <param name="name">分组称号</param>
    /// <returns></returns>
    public GroupJson CreateGroup(string accessToken, string name)
    {
      string url = string.Format("https://api.weixin.qq.com/cgi-bin/groups/create?access_token={0}", accessToken);
      var data = new
      {
        group = new
        {
          name = name
        }
      };
      string postData = data.ToJson();

      GroupJson group = null;
      CreateGroupResult result = JsonHelper<CreateGroupResult>.ConvertJson(url, postData);
      if (result != null)
      {
        group = result.group;
      }
      return group;
    }

2.2 查询一切分组

查询一切分组，可以把服务器上的分组悉数猎取下来，也就是每一个分组的ID和称号。


    /// <summary>
    /// 查询一切分组
    /// </summary>
    /// <param name="accessToken">挪用接口凭据</param>
    /// <returns></returns>
    public List<GroupJson> GetGroupList(string accessToken)
    {
      string url = string.Format("https://api.weixin.qq.com/cgi-bin/groups/get?access_token={0}", accessToken);

      List<GroupJson> list = new List<GroupJson>();
      GroupListJsonResult result = JsonHelper<GroupListJsonResult>.ConvertJson(url);
      if (result != null && result.groups != null)
      {
        list.AddRange(result.groups);
      }

      return list;
    }

2.3 查询用户地点分组

每一个用户都属于一个分组，默许在 未分组 这个分组内里，我们可以经由历程API猎取用户的分组信息，也就是猎取地点用户分组的ID。


    /// <summary>
    /// 查询用户地点分组
    /// </summary>
    /// <param name="accessToken">挪用接口凭据</param>
    /// <param name="openid">用户的OpenID</param>
    /// <returns></returns>
    public int GetUserGroupId(string accessToken, string openid)
    {
      string url = string.Format("https://api.weixin.qq.com/cgi-bin/groups/getid?access_token={0}", accessToken);
      var data = new
      {
        openid = openid
      };
      string postData = data.ToJson();

      int groupId = -1;
      GroupIdJsonResult result = JsonHelper<GroupIdJsonResult>.ConvertJson(url, postData);
      if (result != null)
      {
        groupId = result.groupid;
      }
      return groupId;
    }

2.4 修正分组称号

也可以在现实中，调解用户地点的分组，操纵代码以下。


    /// <summary>
    /// 修正分组名
    /// </summary>
    /// <param name="accessToken">挪用接口凭据</param>
    /// <param name="id">分组id，由微信分派</param>
    /// <param name="name">分组名字（30个字符之内）</param>
    /// <returns></returns>
    public CommonResult UpdateGroupName(string accessToken, int id, string name)
    {
      string url = string.Format("https://api.weixin.qq.com/cgi-bin/groups/update?access_token={0}", accessToken);
      var data = new
      {
        group = new
        {
          id = id,
          name = name
        }
      };
      string postData = data.ToJson();

      return Helper.GetExecuteResult(url, postData);
    }

这里的返回值CommonResult是，一个实体类，包括了bool的胜利与否的标志，以及String范例的毛病信息（假如有的话）。

关于这个GetExecuteResult函数体，内里重要就是提交数据，然后猎取效果，并依据效果举行处置惩罚的函数。


    /// <summary>
    /// 通用的操纵效果
    /// </summary>
    /// <param name="url">网页地点</param>
    /// <param name="postData">提交的数据内容</param>
    /// <returns></returns>
    public static CommonResult GetExecuteResult(string url, string postData = null)
    {
      CommonResult success = new CommonResult();
      try
      {
        ErrorJsonResult result;
        if (postData != null)
        {
          result = JsonHelper<ErrorJsonResult>.ConvertJson(url, postData);
        }
        else
        {
          result = JsonHelper<ErrorJsonResult>.ConvertJson(url);
        }

        if (result != null)
        {
          success.Success = (result.errcode == ReturnCode.要求胜利);
          success.ErrorMessage = result.errmsg;
        }
      }
      catch (WeixinException ex)
      {
        success.ErrorMessage = ex.Message;
      }

      return success;
    } 
  }

上面赤色部份的意义，就是转换为实体类的时刻，假如毛病是微信内里定义的，那末纪录毛病信息，其他非常我不处置惩罚（也就是抛出去）。

2.5 移动用户到新的分组

移动用户到新的分组的操纵和上面小节的差不多，详细看代码。


    /// <summary>
    /// 移动用户分组
    /// </summary>
    /// <param name="accessToken">挪用接口凭据</param>
    /// <param name="openid">用户的OpenID</param>
    /// <param name="to_groupid">分组id</param>
    /// <returns></returns>
    public CommonResult MoveUserToGroup(string accessToken, string openid, int to_groupid)
    {
      string url = string.Format("https://api.weixin.qq.com/cgi-bin/groups/members/update?access_token={0}", accessToken);
      var data = new
      {
        openid = openid,
        to_groupid = to_groupid
      };
      string postData = data.ToJson();

      return Helper.GetExecuteResult(url, postData);
    }

3、用户分组接口的挪用

上面小节，定义并完成了用户分组的各种接口，一切的用户相干的都已毫无保留贴出代码，它的挪用操纵以下代码所示（测试代码）。


    private void btnGetGroupList_Click(object sender, EventArgs e)
    {
      IUserApi userBLL = new UserApi();
      List<GroupJson> list = userBLL.GetGroupList(token);
      foreach (GroupJson info in list)
      {
        string tips = string.Format("{0}:{1}", info.name, info.id);
        Console.WriteLine(tips);
      }
    }

    private void btnFindUserGroup_Click(object sender, EventArgs e)
    {
      IUserApi userBLL = new UserApi();
      int groupId = userBLL.GetUserGroupId(token, openId);

      string tips = string.Format("GroupId:{0}", groupId);
      Console.WriteLine(tips);
    }

    private void btnCreateGroup_Click(object sender, EventArgs e)
    {
      IUserApi userBLL = new UserApi();
      GroupJson info = userBLL.CreateGroup(token, "建立测试分组");
      if (info != null)
      {
        string tips = string.Format("GroupId:{0} GroupName:{1}", info.id, info.name);
        Console.WriteLine(tips);

        string newName = "建立测试修正";
        CommonResult result = userBLL.UpdateGroupName(token, info.id, newName);
        Console.WriteLine("修正分组称号：" + (result.Success ? "胜利" : "失利:" + result.ErrorMessage));
      }
    }

    private void btnUpdateGroup_Click(object sender, EventArgs e)
    {
      int groupId = 111;
      string newName = "建立测试修正";

      IUserApi userBLL = new UserApi();
      CommonResult result = userBLL.UpdateGroupName(token, groupId, newName);
      Console.WriteLine("修正分组称号：" + (result.Success ? "胜利" : "失利:" + result.ErrorMessage));
    }

    private void btnMoveToGroup_Click(object sender, EventArgs e)
    {
      int togroup_id = 111;//输入分组ID

      if (togroup_id > 0)
      {
        IUserApi userBLL = new UserApi();
        CommonResult result = userBLL.MoveUserToGroup(token, openId, togroup_id);

        Console.WriteLine("移动用户分组称号：" + (result.Success ? "胜利" : "失利:" + result.ErrorMessage));
      }
    }

相识了上面的代码和挪用划定规矩，我们就可以经由历程API举行用户分组信息的治理了。经由历程在运用程序中集成相干的接口代码，我们就可以够很好的掌握我们的关注用户列表和用户分组信息。从而为我们下一步用户的信息推送打好基本。

以上就是C#开辟微信流派及运用(五)之用户分组信息治理的细致内容，更多请关注ki4网别的相干文章！

本站所有文章、图片、资源等如无特殊说明或标注，均为来自互联网或者站长原创；版权归原作者所有，仅作为个人学习、研究以及欣赏！如若本站内容侵犯了原著者的合法权益，可联系我们进行处理，邮箱：i-hu@foxmail.com