net.renfei.discuz.ucenter.client

Class Client

java.lang.Object

net.renfei.discuz.ucenter.client.PHPFunctions

net.renfei.discuz.ucenter.client.Client

public class Client
extends PHPFunctions

================================================ Discuz! Ucenter API for JAVA ================================================ UC Client 通用调用该类来实现与UC Server之间的通信。 该类实现与UC Server通信的所有接口函数

更多信息：http://code.google.com/p/discuz-ucenter-api-for-java 原作者：梁平 (no_ten@163.com) 创建时间：2009-2-20 更多信息：https://github.com/renfei/discuz-ucenter-api-for-java 修改者：任霏 (i@renfei.net) 修改时间：2020-12-17

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	IN_UC
static String	UC_API
static String	UC_API_FUNC
static String	UC_APPID
static String	UC_CLIENT_RELEASE
static String	UC_CLIENT_VERSION
static String	UC_CONNECT
static String[]	uc_controls
static String	UC_DATADIR
static String	UC_DATAURL
static String	UC_IP
static String	UC_KEY
static String	UC_ROOT

Constructor Summary

Constructors

Constructor and Description
Client(String ucApi, String ucIp, String ucKey, String ucAppId, String ucConnect)

Method Summary

Modifier and Type	Method and Description
protected String	daddslashes(String string, int force)
protected String	ucAddslashes(String string, int force, boolean strip)
String	ucApiInput(String data)
String	ucApiMysql(String model, String action, Map args) MYSQL 方式取指定的模块和动作的数据
String	ucApiPost(String module, String action, Map<String,Object> arg)
protected String	ucApiRequestdata(String module, String action, String arg, String extra) 构造发送给用户中心的请求数据
protected String	ucApiUrl(String module, String action, String arg, String extra)
String	ucAppLs()
String	ucAuthcode(String string, String operation) 字符串加密以及解密函数
String	ucAuthcode(String string, String operation, String key) 字符串加密以及解密函数
String	ucAuthcode(String string, String operation, String key, int expiry) 字符串加密以及解密函数
protected String	ucFopen(String url, int limit, String post, String cookie, boolean bysocket, String ip, int timeout, boolean block)
protected String	ucFopen2(String url, int limit, String post, String cookie, boolean bysocket, String ip, int timeout, boolean block) 远程打开URL
String	ucGetUser(String username, int isuid) 取得用户数据
protected String	ucSerialize(String arr, int htmlon)
protected String	ucStripslashes(String string)
protected String	ucUnserialize(String s)
String	ucUserDelete(String uid) 删除用户
String	ucUserDeleteavatar(String uid) 删除用户头像
String	ucUserEdit(String username, String oldpw, String newpw, String email, int ignoreoldpw, String questionid, String answer) 编辑用户
String	ucUserLogin(String username, String password) 用户登陆检查
String	ucUserLogin(String username, String password, int isuid, int checkques) 用户登陆检查
String	ucUserLogin(String username, String password, int isuid, int checkques, String questionid, String answer) 用户登陆检查
String	ucUserRegister(String username, String password, String email) 用户注册
String	ucUserRegister(String username, String password, String email, String questionid, String answer) 用户注册
String	ucUserSynlogin(int uid) 进入同步登录代码
String	ucUserSynlogout() 进入同步登出代码

Methods inherited from class net.renfei.discuz.ucenter.client.PHPFunctions

base64Decode, base64Encode, byte2hex, callUserFunc, md5, md5, microTime, sprintf, substr, substr, time, urlencode

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

IN_UC

public static boolean IN_UC

UC_IP

public static String UC_IP

UC_API

public static String UC_API

UC_CONNECT

public static String UC_CONNECT

UC_KEY

public static String UC_KEY

UC_APPID

public static String UC_APPID

UC_CLIENT_VERSION

public static String UC_CLIENT_VERSION

UC_CLIENT_RELEASE

public static String UC_CLIENT_RELEASE

UC_ROOT

public static String UC_ROOT

UC_DATADIR

public static String UC_DATADIR

UC_DATAURL

public static String UC_DATAURL

UC_API_FUNC

public static String UC_API_FUNC

uc_controls

public static String[] uc_controls

Constructor Detail

Client

public Client(String ucApi,
              String ucIp,
              String ucKey,
              String ucAppId,
              String ucConnect)

Method Detail

ucSerialize

protected String ucSerialize(String arr,
                             int htmlon)

ucUnserialize

protected String ucUnserialize(String s)

ucAddslashes

protected String ucAddslashes(String string,
                              int force,
                              boolean strip)

daddslashes

protected String daddslashes(String string,
                             int force)

ucStripslashes

protected String ucStripslashes(String string)

ucApiPost

public String ucApiPost(String module,
                        String action,
                        Map<String,Object> arg)

Specified by:

ucApiPost in class PHPFunctions

ucApiRequestdata

protected String ucApiRequestdata(String module,
                                  String action,
                                  String arg,
                                  String extra)

构造发送给用户中心的请求数据

Parameters:

module - 请求的模块

action - 请求的动作

arg - 参数（会加密的方式传送）

extra - 附加参数（传送时不加密）

Returns:

string

ucApiUrl

protected String ucApiUrl(String module,
                          String action,
                          String arg,
                          String extra)

ucApiInput

public String ucApiInput(String data)

ucApiMysql

public String ucApiMysql(String model,
                         String action,
                         Map args)

MYSQL 方式取指定的模块和动作的数据

Specified by:

ucApiMysql in class PHPFunctions

Parameters:

model - 请求的模块

action - 请求的动作

args - 参数（会加密的方式传送）

Returns:

mix

ucAuthcode

public String ucAuthcode(String string,
                         String operation)

字符串加密以及解密函数

Parameters:

string - 原文或者密文

operation - 操作(ENCODE | DECODE), 默认为 DECODE

Returns:

处理后的 原文或者 经过 base64_encode 处理后的密文

ucAuthcode

public String ucAuthcode(String string,
                         String operation,
                         String key)

字符串加密以及解密函数

Parameters:

string - 原文或者密文

operation - 操作(ENCODE | DECODE), 默认为 DECODE

key - 密钥

Returns:

处理后的 原文或者 经过 base64_encode 处理后的密文

ucAuthcode

public String ucAuthcode(String string,
                         String operation,
                         String key,
                         int expiry)

字符串加密以及解密函数

Parameters:

string - 原文或者密文

operation - 操作(ENCODE | DECODE), 默认为 DECODE

key - 密钥

expiry - 密文有效期, 加密时候有效， 单位 秒，0 为永久有效

Returns:

处理后的 原文或者 经过 base64_encode 处理后的密文

ucFopen2

protected String ucFopen2(String url,
                          int limit,
                          String post,
                          String cookie,
                          boolean bysocket,
                          String ip,
                          int timeout,
                          boolean block)

远程打开URL

Parameters:

url - 打开的url，　如 http://www.baidu.com/123.htm

limit - 取返回的数据的长度

post - 要发送的 POST 数据，如uid=1&password=1234

cookie - 要模拟的 COOKIE 数据，如uid=123&auth=a2323sd2323

bysocket - TRUE/FALSE 是否通过SOCKET打开

ip - IP地址

timeout - 连接超时时间

block - 是否为阻塞模式 defaul valuet:true

Returns:

取到的字符串

ucFopen

protected String ucFopen(String url,
                         int limit,
                         String post,
                         String cookie,
                         boolean bysocket,
                         String ip,
                         int timeout,
                         boolean block)

ucAppLs

public String ucAppLs()

ucUserRegister

public String ucUserRegister(String username,
                             String password,
                             String email)

用户注册

Parameters:

username - 用户名

password - 密码

email - Email

Returns:

int -1 : 用户名不合法 -2 : 包含不允许注册的词语 -3 : 用户名已经存在 -4 : email 格式有误 -5 : email 不允许注册 -6 : 该 email 已经被注册 >1 : 表示成功，数值为 UID

ucUserRegister

public String ucUserRegister(String username,
                             String password,
                             String email,
                             String questionid,
                             String answer)

用户注册

Parameters:

username - 用户名

password - 密码

email - Email

questionid - 安全提问

answer - 安全提问答案

Returns:

int -1 : 用户名不合法 -2 : 包含不允许注册的词语 -3 : 用户名已经存在 -4 : email 格式有误 -5 : email 不允许注册 -6 : 该 email 已经被注册 >1 : 表示成功，数值为 UID

ucUserLogin

public String ucUserLogin(String username,
                          String password)

用户登陆检查

Parameters:

username - 用户名/uid

password - 密码

Returns:

array (uid/status, username, password, email) 数组第一项 1 : 成功 -1 : 用户不存在,或者被删除 -2 : 密码错

ucUserLogin

public String ucUserLogin(String username,
                          String password,
                          int isuid,
                          int checkques)

用户登陆检查

Parameters:

username - 用户名/uid

password - 密码

isuid - 是否为uid

checkques - 是否使用检查安全问答

Returns:

array (uid/status, username, password, email) 数组第一项 1 : 成功 -1 : 用户不存在,或者被删除 -2 : 密码错

ucUserLogin

public String ucUserLogin(String username,
                          String password,
                          int isuid,
                          int checkques,
                          String questionid,
                          String answer)

用户登陆检查

Parameters:

username - 用户名/uid

password - 密码

isuid - 是否为uid

checkques - 是否使用检查安全问答

questionid - 安全提问

answer - 安全提问答案

Returns:

array (uid/status, username, password, email) 数组第一项 1 : 成功 -1 : 用户不存在,或者被删除 -2 : 密码错

ucUserSynlogin

public String ucUserSynlogin(int uid)

进入同步登录代码

Parameters:

uid - 用户ID

Returns:

string HTML代码

ucUserSynlogout

public String ucUserSynlogout()

进入同步登出代码

Returns:

string HTML代码

ucGetUser

public String ucGetUser(String username,
                        int isuid)

取得用户数据

Parameters:

username - 用户名

isuid - 是否为UID

Returns:

array (uid, username, email)

ucUserEdit

public String ucUserEdit(String username,
                         String oldpw,
                         String newpw,
                         String email,
                         int ignoreoldpw,
                         String questionid,
                         String answer)

编辑用户

Parameters:

username - 用户名

oldpw - 旧密码

newpw - 新密码

email - Email

ignoreoldpw - 是否忽略旧密码, 忽略旧密码, 则不进行旧密码校验.

questionid - 安全提问

answer - 安全提问答案

Returns:

int 1 : 修改成功 0 : 没有任何修改 -1 : 旧密码不正确 -4 : email 格式有误 -5 : email 不允许注册 -6 : 该 email 已经被注册 -7 : 没有做任何修改 -8 : 受保护的用户，没有权限修改

ucUserDelete

public String ucUserDelete(String uid)

删除用户

Parameters:

uid - 用户的 UID

Returns:

int >0 : 成功 0 : 失败

ucUserDeleteavatar

public String ucUserDeleteavatar(String uid)

删除用户头像

Parameters:

uid - 用户的 UID