[[toc]]
Authing Java SDK 由两部分组成：ManagementClient 和 AuthenticationClient。ManagementClient 中进行的所有操作均以管理员的身份进行，包含管理用户、管理角色、管理权限策略、管理用户池配置等模块。AuthenticationClient 中的所有操作以当前终端用户的身份进行，包含登录、注册、修改用户资料、退出登录等方法。
你应该将初始化过后的 ManagementClient 实例设置为一个全局变量（只初始化一次），而 AuthenticationClient 应该每次请求初始化一个。
在 build.gradle 内的 dependencies 中添加：
implementation "cn.authing:java-core:3.0.3"
初始化 ManagementClient 需要 userPoolId（用户池 ID） 和 secret（用户池密钥）:
你可以在此了解如何获取 UserPoolId 和 Secret .
importcn.authing.core.mgmt.ManagementClient;
publicclassManagementClientTest {
publicstaticvoidmain(String[] args){
ManagementClientmanagementClient = newManagementClient("AUTHING_USERPOOL_ID", "AUTHING_USERPOOL_SECRET");
// 为了获得管理员权限managementClient.requestToken().execute();
}
}现在 managementClient 实例就可以使用了。例如可以获取用户池中的用户列表：
importcn.authing.core.mgmt.ManagementClient;
publicclassManagementClientTest {
publicstaticvoidmain(String[] args){
ManagementClientmanagementClient = newManagementClient("AUTHING_USERPOOL_ID", "AUTHING_USERPOOL_SECRET");
// 为了获得管理员权限managementClient.requestToken().execute(); PaginatedUsersusers = managementClient.users().list().execute();
}
}初始化 ManagementClient 需要 userPoolId（用户池 ID）：
你可以在此了解如何获取 UserPoolId .
importcn.authing.core.auth.AuthenticationClient;
publicclassAuthenticationClientTest {
publicstaticvoidmain(String[] args){
AuthenticationClientauthenticationClient = newAuthenticationClient("AUTHING_USERPOOL_ID");
}
}接下来可以进行注册登录等操作：
importcn.authing.core.auth.AuthenticationClient;
publicclassAuthenticationClientTest {
publicstaticvoidmain(String[] args){
AuthenticationClientauthenticationClient = newAuthenticationClient("AUTHING_USERPOOL_ID");
Stringemail = "test@example.com";
Stringpassword = "123456";
Useruser = authenticationClient.registerByEmail(newRegisterByEmailInput(email, password)).execute();
}
}完成登录之后，update_profile 等要求用户登录的方法就可用了：
importcn.authing.core.auth.AuthenticationClient;
publicclassAuthenticationClientTest {
publicstaticvoidmain(String[] args){
AuthenticationClientauthenticationClient = newAuthenticationClient("AUTHING_USERPOOL_ID");
Stringemail = "test@example.com";
Stringpassword = "123456";
authenticationClient.loginByEmail(newLoginByEmailInput(email, password)).execute();
Useruser = authenticationClient.updateProfile(newUpdateUserInput().withNickname("nickname")).execute();
}
}你也可以在初始化后设置 AccessToken 参数, 不需要每次都调用 LoginByXXX 方法:
importcn.authing.core.auth.AuthenticationClient;
publicclassAuthenticationClientTest {
publicstaticvoidmain(String[] args){
AuthenticationClientauthenticationClient = newAuthenticationClient("AUTHING_USERPOOL_ID");
authenticationClient.setAccessToken("ACCESS_TOKEN");
}
}再次执行 UpdateProfile 方法，发现也成功了:
importcn.authing.core.auth.AuthenticationClient;
publicclassAuthenticationClientTest {
publicstaticvoidmain(String[] args){
AuthenticationClientauthenticationClient = newAuthenticationClient("AUTHING_USERPOOL_ID");
authenticationClient.setAccessToken("ACCESS_TOKEN");
Useruser = authenticationClient.updateProfile(newUpdateUserInput().withNickname("nickname")).execute();
}
}importcn.authing.core.auth.AuthenticationClient;
importcn.authing.core.graphql.GraphQLException;importjava.io.IOException;
publicclassAuthenticationClientTest {
publicstaticvoidmain(String[] args){
AuthenticationClientauthenticationClient = newAuthenticationClient("AUTHING_USERPOOL_ID");
authenticationClient.setAccessToken("ACCESS_TOKEN");
try {
Useruser = authenticationClient.updateProfile(newUpdateUserInput().withNickname("nickname")).execute();
} catch (GraphQLException | IOExceptione) {
e.printStackTrace();
}
}
}Join us on Gitter: #authing-chat
可用的 Authentication 方法
- 获取当前用户的用户资料:
getCurrentUser - 使用邮箱注册:
registerByEmail - 使用用户名注册:
registerByUsername - 使用手机号验证码注册:
registerByPhoneCode - 使用邮箱登录:
loginByEmail - 使用用户名登录:
loginByUsername - 使用手机号验证码登录
loginByPhoneCode - 使用手机号密码登录:
loginByPhonePassword - 发送邮件:
sendEmail - 发送短信验证码:
sendSmsCode - 检查 token 的有效状态:
checkLoginStatus - 使用手机号验证码重置密码:
resetPasswordByPhoneCode - 使用邮件验证码重置密码:
resetPasswordByEmailCode - 更新用户资料:
updateProfile - 更新密码:
updatePassword - 更新手机号:
updatePhone - 更新邮箱:
updateEmail - 刷新 token:
refreshToken - 绑定手机号:
bindPhone - 解绑手机号:
unbindPhone
完整的接口文档请见：