rong_cloud_server 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c0a792a26e83b1a5420aa834459d44f62be0ec8c
-  data.tar.gz: 50b3157736cff25fa9937cd99a002d7fa5a62134
+  metadata.gz: 6f18dffa1673ff35d013c644ec931c44af2f5931
+  data.tar.gz: 7d63b3bee76e8106091e92753f4ad8f2ec48ea05
 SHA512:
-  metadata.gz: 9a77797344c9ad396fc0f8b8586d68c061944abac3932cac51445470c2f21d28d4e9544a4ec8524bf21899d2c50a24703b51005ac3b8257b7edf4bf61fdd1ad1
-  data.tar.gz: 72ae4a709051e62499d409c103feb9c106e6f4d1f49b4cbd30cde0f506c3f8ee4d10c4cde46b9495e9f9fe89386ecd99be40e1372b15d1d29c7c45e678cf88fa
+  metadata.gz: 2366fd2761501b3e14a03b5c8e27c0f31c8086a749d5409bae58704f7d2c998578ed1759aed4ce45875e2a266ba3efebaa792a96959153bbb7dbcc440b41a700
+  data.tar.gz: d6822867ea92aff168a5641df355deb9bc461d71c8f6af4280c7aacba4761742c837891b910b936774ec6576c0128d1e671dc889c09d0fc50405191f31dc2d6c

data/README.md

@@ -28,12 +28,10 @@
 2. **简洁**：不过分封装，仅做必要的请求实现，使用方自行处理响应的 JSON 解析后的 Hash 对象，各字段释义请自行查阅融云文档；
 3. **丰富的异常类型**：针对不同的 HTTP 状态码，抛出相对应的异常类型，同时可以通过异常对象的 `business_code` 方法获取错误业务码，可以参考[request test 的代码](https://github.com/Martin91/rong_cloud/blob/master/test/rong_cloud/request_test.rb)。
 
-### TODOs
-1. 私聊与系统模板消息；
-2. 聊天室其他服务以及高级接口实现；
-3. 实时消息路由；
-4. 消息历史记录；
-5. 在线状态订阅。
+### TODOs for v0.1.0
+1. 实时消息路由；
+2. 消息历史记录；
+3. 在线状态订阅。
 
 ### How to contribute
 1. Fork this repo;

data/lib/core_ext/array.rb

@@ -0,0 +1,8 @@
+class Array
+  # inspired by http://api.rubyonrails.org/classes/Array.html#method-i-extract_options-21
+  unless instance_methods.include?(:extract_options!)
+    def extract_options!
+      last.is_a?(Hash) ? pop : {}
+    end
+  end
+end

data/lib/rong_cloud.rb

@@ -1,6 +1,7 @@
 require 'rong_cloud/configuration'
 require 'rong_cloud/errors'
 require 'rong_cloud/service'
+require 'core_ext/array'
 
 # 融云 Ruby SDK 的全局命名空间
 module RongCloud

data/lib/rong_cloud/errors.rb

@@ -1,6 +1,8 @@
 module RongCloud
   # 不支持的消息类型错误
   class UnsupportedMessageChannelName < ::StandardError;end
+  # 缺少必传参数
+  class MissingOptionError < ::StandardError;end
   # 与融云接口请求相关的基本错误类型，其他错误类型继承此类型
   class RequestError < ::StandardError
     # @!attribute [rw] business_code

data/lib/rong_cloud/request.rb

@@ -8,6 +8,24 @@ module RongCloud
   module Request
     include Signature
 
+    # 执行请求
+    # @param path [String] 请求 API 的相对路径
+    # @param params [Hash] 请求的参数
+    # @param content_type [Symbol] 请求数据编码格式，:form_data 或者 :json，默认 :form_data
+    # @return [Hash] JSON 解析后的响应数据
+    # @raise [RongCloud::BadRequest] 请求参数有误，缺失或者不正确等，详见官方文档
+    def request(path, params = nil, content_type = :form_data)
+      uri = get_uri(path)
+      req = initialize_request(uri, params, content_type)
+      use_ssl = uri.scheme == 'https'
+      res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: use_ssl) do |http|
+        http.request(req)
+      end
+
+      handle_response(res)
+    end
+
+    private
     # 拼接请求的接口的路径
     #
     # @param path [String] 接口的相对路径，e.g. "/user/getToken" 或者 "user/getToken"，代码中自动处理开头的斜杠
@@ -22,13 +40,21 @@ module RongCloud
     #
     # @param uri [URI] 请求路径对象
     # @param params [Hash] 请求的参数，所有参数通过 form encoded data 方式发送
+    # @param content_type [Symbol] 请求数据编码格式，:form_data 或者 :json
     # @return [Net::HTTP::Post] 请求的实例
     #
-    def initialize_request(uri, params)
+    def initialize_request(uri, params, content_type)
       req = Net::HTTP::Post.new(uri)
-      req.set_form_data(params) if params.respond_to?(:map)
       signed_headers.each { |header, value| req[header] = value }
 
+      case content_type
+      when :form_data
+        req.set_form_data(params) if params.respond_to?(:map)
+      when :json
+        req.body = params.to_json
+        req["Content-Type"] = "application/json"
+      end
+
       req
     end
 
@@ -49,21 +75,5 @@ module RongCloud
         raise error
       end
     end
-
-    # 执行请求
-    # @param path [String] 请求 API 的相对路径
-    # @param params [Hash] 请求的参数
-    # @return [Hash] JSON 解析后的响应数据
-    # @raise [RongCloud::BadRequest] 请求参数有误，缺失或者不正确等，详见官方文档
-    def request(path, params = nil)
-      uri = get_uri(path)
-      req = initialize_request(uri, params)
-      use_ssl = uri.scheme == 'https'
-      res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: use_ssl) do |http|
-        http.request(req)
-      end
-
-      handle_response(res)
-    end
   end
 end

data/lib/rong_cloud/service.rb

@@ -3,6 +3,7 @@ require 'rong_cloud/services/user'
 require 'rong_cloud/services/message'
 require 'rong_cloud/services/wordfilter'
 require 'rong_cloud/services/group'
+require 'rong_cloud/services/chatroom'
 
 module RongCloud
   # 封装所有接口的 Service 类，所有业务接口通过 Service 的实例完成调用
@@ -13,5 +14,6 @@ module RongCloud
     include RongCloud::Services::Message
     include RongCloud::Services::Wordfilter
     include RongCloud::Services::Group
+    include RongCloud::Services::Chatroom
   end
 end

data/lib/rong_cloud/services/chatroom.rb

@@ -0,0 +1,98 @@
+module RongCloud
+  module Services
+    # 聊天室服务相关接口 http://www.rongcloud.cn/docs/server.html#聊天室服务
+    module Chatroom
+      # 创建聊天室，支持同时创建多个聊天室 http://www.rongcloud.cn/docs/server.html#创建聊天室_方法
+      #
+      # @param chatrooms [Hash] id 为 key，聊天室名称为 value 的 Hash 实例，多个 key-value 表示多个聊天室
+      #
+      def create_chatroom(chatrooms)
+        params = {}
+        chatrooms.each { |room_id, room_name| params["chatroom[#{room_id}]"] = room_name }
+
+        request("/chatroom/create", params)
+      end
+
+      # 加入聊天室 http://www.rongcloud.cn/docs/server.html#加入聊天室_方法
+      #
+      # @param user_id [String, Array] 一个或多个用户 id
+      # @param chatroom_id [String] 聊天室 id
+      #
+      def join_chatroom(user_id, chatroom_id)
+        request("/chatroom/join", userId: user_id, chatroomId: chatroom_id)
+      end
+
+      # 销毁聊天室 http://www.rongcloud.cn/docs/server.html#销毁聊天室_方法
+      #
+      # @param chatroom_ids [String, Array] 一个或多个聊天室 id
+      #
+      def destroy_chatroom(chatroom_ids)
+        request("/chatroom/destroy", chatroomId: chatroom_ids)
+      end
+
+      # 查询聊天室信息 http://www.rongcloud.cn/docs/server.html#查询聊天室信息_方法
+      #
+      # @param chatroom_ids [String, Array] 一个或多个聊天室 id
+      #
+      def query_chatroom(chatroom_ids)
+        request("/chatroom/query", chatroomId: chatroom_ids)
+      end
+
+      # 添加禁言聊天室成员 http://www.rongcloud.cn/docs/server.html#添加禁言聊天室成员_方法
+      #
+      def block_chatroom_user(chatroom_id, user_id, minute)
+        request("/chatroom/user/gag/add", chatroomId: chatroom_id, userId: user_id, minute: minute)
+      end
+
+      # 移除封禁聊天室成员 http://www.rongcloud.cn/docs/server.html#移除封禁聊天室成员_方法
+      #
+      def unblock_chatroom_user(chatroom_id, user_id)
+        request("/chatroom/user/block/rollback", chatroomId: chatroom_id, userId: user_id)
+      end
+
+      # 查询被封禁聊天室成员 http://www.rongcloud.cn/docs/server.html#查询被封禁聊天室成员_方法
+      #
+      def blocked_chatroom_users(chatroom_id)
+        request("/chatroom/user/block/list", chatroomId: chatroom_id)
+      end
+
+      # 查询聊天室内用户
+      #
+      # @param chatroom_id [String] 聊天室 id
+      # @param count [String, Fixnum] 要获取的聊天室成员数，上限为 500
+      # @param order [String] 加入聊天室的先后顺序， 1 为加入时间正序， 2 为加入时间倒序
+      #
+      def query_chatroom_users(chatroom_id, count, order = "1")
+        request("chatroom/user/query", chatroomId: chatroom_id, count: count, order: order)
+      end
+
+      # 聊天室消息停止分发 http://www.rongcloud.cn/docs/server.html#聊天室消息停止分发_方法
+      #
+      def stop_chatroom_distribution(chatroom_id)
+        request("/chatroom/message/stopDistribution", chatroomId: chatroom_id)
+      end
+
+      # 聊天室消息恢复分发 http://www.rongcloud.cn/docs/server.html#聊天室消息恢复分发_方法
+      #
+      def resume_chatroom_distribution(chatroom_id)
+        request("/chatroom/message/resumeDistribution", chatroomId: chatroom_id)
+      end
+
+      # 添加聊天室白名单成员 http://www.rongcloud.cn/docs/server.html#添加聊天室白名单成员_方法
+      #
+      def add_chatroom_whitelist(chatroom_id, user_id)
+        request("/chatroom/user/whitelist/add", chatroomId: chatroom_id, userId: user_id)
+      end
+
+      # 移除聊天室白名单成员 http://www.rongcloud.cn/docs/server.html#移除聊天室白名单成员_方法
+      def remove_chatroom_whitelist(chatroom_id, user_id)
+        request("/chatroom/user/whitelist/remove", chatroomId: chatroom_id, userId: user_id)
+      end
+
+      # 查询聊天室白名单成员 http://www.rongcloud.cn/docs/server.html#查询聊天室白名单成员_方法
+      def whitelisted_chatroom_users(chatroom_id)
+        request("/chatroom/user/whitelist/query", chatroomId: chatroom_id)
+      end
+    end
+  end
+end

data/lib/rong_cloud/services/message.rb

@@ -12,20 +12,30 @@ module RongCloud
       # @param [Hash] content 消息体，更多消息请看 http://www.rongcloud.cn/docs/server.html#内置消息类型表
       # @option content [Object] :content 消息体中的正文，如果为自定义消息，由消息消费方自行解析
       # @option content [Object] :extra 消息体中的附加信息，传递时为字符串，由消息消费方自行解析
-      #
+      # @param args [Array] 额外的 1 到 2 个参数，1 个参数时，表示 options 参数；2 个参数时，第一个参数表示模板消息的 values，第二个参数为 options 参数
       # @param [Hash] options 额外选项，包含 pushContent 以及 pushData 等配置，所有支持选项根据各消息类型确定
       # @option options [String] :pushContent 推送通知显示的 Push 内容
       # @option options [Hash] :pushData 推送 payload
       #
-      def send_message(from_user_id, target_id, channel_name, object_name, content, options = {})
+      def send_message(from_user_id, target_id, channel_name, object_name, content, *args)
+        options = args.extract_options!
+        values = args.first
+        content_type = values.nil? ? :form_data : :json
+
         message_channel = MessageChannel.new(channel_name)
         params = { fromUserId: from_user_id, objectName: object_name, content: content.to_json }
         if message_channel.target_param_name
           params.merge!(message_channel.target_param_name => target_id)
         end
+        if values
+          if options[:pushContent].nil?
+            raise RongCloud::MissingOptionError, "pushContent is required for template messages"
+          end
+          params.merge!(values: values)
+        end
 
         params.merge!(options)
-        request(message_channel.api_path, params)
+        request(message_channel.api_path, params, content_type)
       end
 
       # 发送单聊消息 http://www.rongcloud.cn/docs/server.html#发送单聊消息_方法
@@ -34,11 +44,21 @@ module RongCloud
         send_message(from_user_id, to_user_id, :private, object_name, content, options)
       end
 
+      # 发送单聊模板消息 http://www.rongcloud.cn/docs/server.html#发送单聊模板消息_方法
+      def send_private_template_message(from_user_id, to_user_id, object_name, content, values, options = {})
+        send_message(from_user_id, to_user_id, :private_template, object_name, content, values, options)
+      end
+
       # 发送系统消息 http://www.rongcloud.cn/docs/server.html#发送系统消息_方法
       def send_system_message(from_user_id, to_user_id, object_name, content, options = {})
         send_message(from_user_id, to_user_id, :system, object_name, content, options)
       end
 
+      # 发送系统模板消息 http://www.rongcloud.cn/docs/server.html#发送系统模板消息_方法
+      def send_system_template_message(from_user_id, to_user_id, object_name, content, values, options = {})
+        send_message(from_user_id, to_user_id, :system_template, object_name, content, values, options)
+      end
+
       # 发送群组消息 http://www.rongcloud.cn/docs/server.html#发送群组消息_方法
       def send_group_message(from_user_id, to_group_id, object_name, content, options = {})
         send_message(from_user_id, to_group_id, :group, object_name, content, options)

data/lib/rong_cloud/services/message/message_channel.rb

@@ -7,7 +7,9 @@ module RongCloud
         #
         CHANNEL_TO_REQUEST_DETAILS_MAP = {
           'private': { target_param_name: "toUserId", api_path: "/message/private/publish" },
+          private_template: { target_param_name: "toUserId", api_path: "/message/private/publish_template" },
           system: { target_param_name: "toUserId", api_path: "/message/system/publish" },
+          system_template: { target_param_name: "toUserId", api_path: "/message/system/publish_template" },
           group: { target_param_name: 'toGroupId', api_path: "/message/group/publish" },
           discussion: { target_param_name: "toDiscussionId", api_path: "/message/discussion/publish" },
           chatroom: { target_param_name: "toChatroomId", api_path: "/message/chatroom/publish" },

data/rong_cloud.gemspec

@@ -4,7 +4,7 @@ Gem::Specification.new do |s|
   s.require_path = 'lib'
   s.summary      = '融云 Server API SDK'
   s.description  = '融云服务器端接口 API，http://www.rongcloud.cn/docs/server.html'
-  s.version      = '0.0.1'
+  s.version      = '0.0.2'
   s.files        = `git ls-files`.split("\n")
   s.authors      = ['Martin Hong']
   s.email        = 'hongzeqin@gmail.com'

data/test/rong_cloud/service_test.rb

@@ -3,6 +3,7 @@ require 'rong_cloud/services/user_test'
 require 'rong_cloud/services/message_test'
 require 'rong_cloud/services/wordfilter_test'
 require 'rong_cloud/services/group_test'
+require 'rong_cloud/services/chatroom_test'
 
 module RongCloud
   class ServiceTest < Minitest::Test
@@ -10,6 +11,7 @@ module RongCloud
     include RongCloud::Services::MessageTest
     include RongCloud::Services::WordfilterTest
     include RongCloud::Services::GroupTest
+    include RongCloud::Services::ChatroomTest
 
     def setup
       rong_cloud_configure_with_settings

data/test/rong_cloud/services/chatroom_test.rb

@@ -0,0 +1,136 @@
+module RongCloud
+  module Services
+    module ChatroomTest
+      def test_create_chatroom
+        chatrooms = { 10001 => "name1", 10002 => "name2" }
+        response = @service.create_chatroom(chatrooms)
+        assert_equal 200, response["code"]
+      end
+
+      def test_join_chatroom_with_unexisted_chatroom_id
+        error = assert_raises RongCloud::BadRequest do
+          @service.join_chatroom(["user"], rand.to_s[2..8])
+        end
+
+        assert_equal "chatroomId is not exist.", error.message
+      end
+
+      def test_join_chatroom_with_multiple_users_less_than_50
+        create_chatrooms({10003 => "room3"})
+        response = @service.join_chatroom(["user1", "user2", "user3"], 10003)
+        assert_equal 200, response["code"]
+      end
+
+      def test_join_chatroom_with_multiple_users_greater_than_50
+        create_chatrooms({10004 => "room4"})
+        users = 1.upto(51).map { |i| "user#{i}" }
+        response = @service.join_chatroom(users, 10004)
+        assert_equal 200, response["code"]
+      end
+
+      def test_destroy_chatroom_with_multiple_chatroom_ids_existed
+        create_chatrooms({10005 => "room5", 10006 => "room6"})
+        response = @service.destroy_chatroom([10005, 10006])
+        assert_equal 200, response["code"]
+      end
+
+      def test_destroy_chatroom_with_multiple_chatroom_ids_unexisted
+        response = @service.destroy_chatroom(%w(unexisted_chat1 unexisted_chat2))
+        assert_equal 200, response["code"]
+      end
+
+      def test_query_chatroom_with_existed_chatroom_ids
+        create_chatrooms({10007 => "room7", 10008 => "room8"})
+        chatrooms = @service.query_chatroom(%w(10007 10008))["chatRooms"]
+        chatroom_ids = chatrooms.map{ |chatroom| chatroom["chrmId"] }
+        room = chatrooms.detect{ |chatroom| chatroom["chrmId"] == "10007" }
+        assert_equal 2, chatrooms.count
+        assert_equal "room7", room["name"]
+      end
+
+      def test_query_chatroom_with_unexisted_chatroom_ids
+        chatrooms = @service.query_chatroom(%w(unexisted_chat1 unexisted_chat2))["chatRooms"]
+        assert_equal [], chatrooms
+      end
+
+      def test_query_chatroom_users_with_count_1_and_order_1
+        create_chatrooms({10009 => "room9"})
+        @service.join_chatroom("user3", 10009)
+        @service.join_chatroom("user4", 10009)
+
+        users = @service.query_chatroom_users("10009", 1, "1")["users"]
+        user = users.first
+        assert_equal 1, users.count
+        assert_equal "user3", user["id"]
+      end
+
+      def test_query_chatroom_users_with_count_1_and_order_2
+        create_chatrooms({10009 => "room9"})
+        @service.join_chatroom("user3", 10009)
+        @service.join_chatroom("user4", 10009)
+
+        users = @service.query_chatroom_users("10009", 1, "2")["users"]
+        user = users.first
+        assert_equal "user4", user["id"]
+      end
+
+      def test_query_chatroom_users_with_count_2
+        create_chatrooms({10009 => "room9"})
+        @service.join_chatroom("user3", 10009)
+        @service.join_chatroom("user4", 10009)
+
+        users = @service.query_chatroom_users("10009", 2)["users"]
+        assert_equal 2, users.count
+      end
+
+      def test_block_chatroom_user_flow
+        create_chatrooms({10010 => "room10"})
+        @service.join_chatroom("user5", 10010)
+
+        response = @service.block_chatroom_user(10010, "user5", 60)
+        assert_equal 200, response["code"]
+
+        response = @service.blocked_chatroom_users(10010)
+        assert_equal 200, response["code"]
+        assert response["users"]
+
+        response = @service.unblock_chatroom_user(10010, "user5")
+        assert_equal 200, response["code"]
+      end
+
+      def test_stop_chatroom_distribution
+        response = @service.stop_chatroom_distribution(10011)
+        assert_equal 200, response["code"]
+      end
+
+      def test_resume_chatroom_distribution
+        response = @service.resume_chatroom_distribution(10011)
+        assert_equal 200, response["code"]
+      end
+
+      def test_chatroom_whitelist_flow
+        create_chatrooms({10011 => "room11"})
+        @service.join_chatroom("user6", 10011)
+
+        response = @service.add_chatroom_whitelist(10011, "user6")
+        assert_equal 200, response["code"]
+        response = @service.add_chatroom_whitelist(10011, ["user7", "user8"])
+        assert_equal 200, response["code"]
+
+        response = @service.whitelisted_chatroom_users(10011)
+        assert_equal 200, response["code"]
+        assert response["users"]
+
+        response = @service.remove_chatroom_whitelist(10011, "user6")
+        assert_equal 200, response["code"]
+        response = @service.remove_chatroom_whitelist(10011, ["user7", "user8"])
+        assert_equal 200, response["code"]
+      end
+
+      private
+      def create_chatrooms(chatrooms = { 10000001 => "super chatroom"})
+        @service.create_chatroom(chatrooms)
+      end
+    end
+  end
+end

data/test/rong_cloud/services/group_test.rb

@@ -25,7 +25,8 @@ module RongCloud
 
       def test_create_group_without_group_name
         response = @service.create_group('user1', '5', nil)
-        assert_equal 200, response['code']
+
+        assert_equal 200, response["code"]
       end
 
       def test_join_group_with_single_user_id
@@ -47,7 +48,8 @@ module RongCloud
 
       def test_join_group_without_group_name
         response = @service.join_group('user1', '5', nil)
-        assert_equal 200, response['code']
+
+        assert_equal 200, response["code"]
       end
 
       def test_quit_group
@@ -94,7 +96,6 @@ module RongCloud
         response = @service.blocked_group_members('group1')
         user_ids = response['users'].map{|user| user['userId']}
 
-        assert_equal 1, user_ids.count
         assert_includes user_ids, "user2"
       end
     end

data/test/rong_cloud/services/message/message_channel_test.rb

@@ -13,7 +13,7 @@ module RongCloud
           error = assert_raises RongCloud::UnsupportedMessageChannelName do
             RongCloud::Services::Message::MessageChannel.new(:nothing)
           end
-          expected_error = "support only channels: [\"private\", \"system\", \"group\", \"discussion\", \"chatroom\", \"broadcast\"]"
+          expected_error = "support only channels: [\"private\", \"private_template\", \"system\", \"system_template\", \"group\", \"discussion\", \"chatroom\", \"broadcast\"]"
           assert_equal expected_error, error.message
         end
 
@@ -22,11 +22,21 @@ module RongCloud
           assert_equal "toUserId", channel.target_param_name
         end
 
+        def test_target_param_name_for_private_template
+          channel = RongCloud::Services::Message::MessageChannel.new(:private_template)
+          assert_equal "toUserId", channel.target_param_name
+        end
+
         def test_target_param_name_for_system
           channel = RongCloud::Services::Message::MessageChannel.new(:system)
           assert_equal "toUserId", channel.target_param_name
         end
 
+        def test_target_param_name_for_system_template
+          channel = RongCloud::Services::Message::MessageChannel.new(:system_template)
+          assert_equal "toUserId", channel.target_param_name
+        end
+
         def test_target_param_name_for_group
           channel = RongCloud::Services::Message::MessageChannel.new(:group)
           assert_equal "toGroupId", channel.target_param_name
@@ -52,11 +62,21 @@ module RongCloud
           assert_equal "/message/private/publish", channel.api_path
         end
 
+        def test_api_path_for_private_template
+          channel = RongCloud::Services::Message::MessageChannel.new(:private_template)
+          assert_equal "/message/private/publish_template", channel.api_path
+        end
+
         def test_api_path_for_system
           channel = RongCloud::Services::Message::MessageChannel.new(:system)
           assert_equal "/message/system/publish", channel.api_path
         end
 
+        def test_api_path_for_system_template
+          channel = RongCloud::Services::Message::MessageChannel.new(:system_template)
+          assert_equal "/message/system/publish_template", channel.api_path
+        end
+
         def test_api_path_for_group
           channel = RongCloud::Services::Message::MessageChannel.new(:group)
           assert_equal "/message/group/publish", channel.api_path

data/test/rong_cloud/services/message_test.rb

@@ -11,6 +11,33 @@ module RongCloud
         assert_equal 200, response["code"]
       end
 
+      def test_send_private_template_message_with_multiple_to_user_ids
+        response = @service.send_private_template_message(1, [2, 3, 4], "RC:TxtMsg",
+          { content: "hello {name}", extra: "nothing" },
+          [
+            {"{name}" => "user2"},
+            {"{name}" => "user3"},
+            {"{name}" => "user4"},
+          ],
+          pushContent: Array.new(3, "欢迎 {name}")
+        )
+        assert_equal 200, response["code"]
+      end
+
+      def test_send_private_template_message_with_multiple_to_user_ids_missing_push_content
+        error = assert_raises RongCloud::MissingOptionError do
+          @service.send_private_template_message(1, [2, 3], "RC:TxtMsg",
+            { content: "hello {name}", extra: "nothing" },
+            [
+              {"{name}" => "user2"},
+              {"{name}" => "user3"}
+            ],
+          )
+        end
+
+        assert_equal "pushContent is required for template messages", error.message
+      end
+
       def test_send_private_message_with_options
         options = { pushContent: "hello", pushData: { shouldBeTrue: "true" } }
         response = @service.send_private_message(1, [2, 3, 4], "RC:TxtMsg", { content: "hello world", extra: "nothing" }, options)
@@ -27,6 +54,19 @@ module RongCloud
         assert_equal 200, response["code"]
       end
 
+      def test_send_system_template_message_with_multiple_to_user_ids
+        response = @service.send_system_template_message(1, [2, 3, 4], "RC:TxtMsg",
+          { content: "hello {name}", extra: "nothing" },
+          [
+            {"{name}" => "user5"},
+            {"{name}" => "user6"},
+            {"{name}" => "user7"},
+          ],
+          pushContent: Array.new(3, "欢迎 {name}")
+        )
+        assert_equal 200, response["code"]
+      end
+
       def test_send_system_message_with_options
         options = { pushContent: "hello", pushData: { shouldBeTrue: "true" } }
         response = @service.send_system_message(1, [2, 3, 4], "RC:TxtMsg", { content: "hello world", extra: "nothing" }, options)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rong_cloud_server
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - Martin Hong
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-10-09 00:00:00.000000000 Z
+date: 2016-10-18 00:00:00.000000000 Z
 dependencies: []
 description: 融云服务器端接口 API，http://www.rongcloud.cn/docs/server.html
 email: hongzeqin@gmail.com
@@ -19,11 +19,13 @@ files:
 - ".gitignore"
 - README.md
 - config.example.yml
+- lib/core_ext/array.rb
 - lib/rong_cloud.rb
 - lib/rong_cloud/configuration.rb
 - lib/rong_cloud/errors.rb
 - lib/rong_cloud/request.rb
 - lib/rong_cloud/service.rb
+- lib/rong_cloud/services/chatroom.rb
 - lib/rong_cloud/services/group.rb
 - lib/rong_cloud/services/message.rb
 - lib/rong_cloud/services/message/message_channel.rb
@@ -35,6 +37,7 @@ files:
 - test/rong_cloud/configuration_test.rb
 - test/rong_cloud/request_test.rb
 - test/rong_cloud/service_test.rb
+- test/rong_cloud/services/chatroom_test.rb
 - test/rong_cloud/services/group_test.rb
 - test/rong_cloud/services/message/message_channel_test.rb
 - test/rong_cloud/services/message_test.rb