com.avos.avoscloud.SignatureFactory Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of avoscloud-push Show documentation
AVOS Cloud Android SDK
The newest version!
package com.avos.avoscloud;

import java.util.List;

/**
 * Created by nsun on 5/15/14.
 */
public interface SignatureFactory {
  public static final int SIGNATURE_FAILED_LOGIN = 4102;

  /**
   * 实现一个基础签名方法 其中的签名算法会在SessionManager和AVIMClient(V2)中被使用
   * 
   * @param peerId
   * @param watchIds
   * @return
   * @throws SignatureException 如果签名计算中间发生任何问题请抛出本异常
   */
  public Signature createSignature(String peerId, List watchIds) throws SignatureException;

  /**
   * 实现AVGroup相关的签名计算
   * 
   * @param groupId
   * @param peerId
   * @param targetPeerIds
   * @param action
   * @return
   * @throws SignatureException 如果签名计算中间发生任何问题请抛出本异常
   */
  @Deprecated
  public Signature createGroupSignature(String groupId, String peerId, List targetPeerIds,
      String action) throws SignatureException;

  /**
   * 实现AVIMConversation相关的签名计算
   * 
   * @param conversationId
   * @param clientId
   * @param targetIds 操作所对应的数据
   * @param action - 此次行为的动作，行为分别对应常量 invite（加群和邀请）和 kick（踢出群）
   * @return
   * @throws SignatureException 如果签名计算中间发生任何问题请抛出本异常
   */
  public Signature createConversationSignature(String conversationId, String clientId,
      List targetIds, String action) throws SignatureException;

  /**
   * 实现黑名单相关的签名计算
   *
   * @param clientId        当前登录用户的 id，必须
   * @param conversationId  目标对话的 id，可选
   * @param memberIds       目标成员的 id，可选
   * @param action          操作类型的字符串，有如下集中类型：
   *                        conversation-block-clients    在对话中拉黑部分成员，此时 conversationId 和 memberIds 是必须的。
   *                        conversation-unblock-clients  在对话中解禁部分成员，此时 conversationId 和 memberIds 是必须的。
   * @return
   * @throws SignatureException
   */
  public Signature createBlacklistSignature(String clientId, String conversationId, List memberIds,
                                            String action) throws SignatureException;

  /**
   * 签名异常类
   */
  public static class SignatureException extends AVException {

    public SignatureException(int theCode, String theMessage) {
      super(theCode, theMessage);
    }

  }
}