Package com.io7m.idstore.admin_client.internal

Class IdAClientProtocolHandlerDisconnected

java.lang.Object

com.io7m.idstore.admin_client.internal.IdAClientProtocolHandlerDisconnected

All Implemented Interfaces:

IdAClientAdminsType, IdAClientAuditType, IdAClientUsersType, IdAClientProtocolHandlerType

public final class IdAClientProtocolHandlerDisconnected
extends Object
implements IdAClientProtocolHandlerType

The "disconnected" protocol handler.

Constructor Summary

Constructors

Constructor	Description
IdAClientProtocolHandlerDisconnected(Locale inLocale, IdAStrings inStrings, HttpClient inHttpClient)	The "disconnected" protocol handler.

Method Summary

Modifier and Type	Method	Description
void	adminBanCreate(IdBan ban)	Create a ban on the given admin account.
void	adminBanDelete(IdBan ban)	Delete the given ban.
Optional<IdBan>	adminBanGet(UUID id)	Get the ban for the given admin, if one exists.
IdAdmin	adminCreate(Optional<UUID> id, IdName idName, IdRealName realName, IdEmail email, IdPassword password, IdAdminPermissionSet permissions)	Create a admin.
void	adminDelete(UUID id)	Delete the given admin.
IdAdmin	adminEmailAdd(UUID id, IdEmail email)	Add an email to the given admin.
IdAdmin	adminEmailRemove(UUID id, IdEmail email)	Remove an email from the given admin.
Optional<IdAdmin>	adminGet(UUID id)	Fetch the given admin.
Optional<IdAdmin>	adminGetByEmail(IdEmail email)	Fetch the given admin.
IdAdmin	adminPermissionGrant(UUID id, IdAdminPermission permission)	Grant a permission to the given admin.
IdAdmin	adminPermissionRevoke(UUID id, IdAdminPermission permission)	Revoke a permission from the given admin.
IdPage<IdAdminSummary>	adminSearchBegin(IdAdminSearchParameters parameters)	Start searching/listing admins.
IdPage<IdAdminSummary>	adminSearchByEmailBegin(IdAdminSearchByEmailParameters parameters)	Start searching/listing admins.
IdPage<IdAdminSummary>	adminSearchByEmailNext()	Continue searching/listing admins.
IdPage<IdAdminSummary>	adminSearchByEmailPrevious()	Continue searching/listing admins.
IdPage<IdAdminSummary>	adminSearchNext()	Continue searching/listing admins.
IdPage<IdAdminSummary>	adminSearchPrevious()	Continue searching/listing admins.
IdAdmin	adminSelf()	Retrieve the current admin profile.
IdAdmin	adminUpdate(UUID admin, Optional<IdName> idName, Optional<IdRealName> realName, Optional<IdPassword> password)	Update the given admin.
IdPage<IdAuditEvent>	auditSearchBegin(IdTimeRange timeRange, Optional<String> owner, Optional<String> type, Optional<String> message, int pageSize)	Start searching/listing audit events.
IdPage<IdAuditEvent>	auditSearchNext()	Continue searching/listing events.
IdPage<IdAuditEvent>	auditSearchPrevious()	Continue searching/listing events.
IdANewHandler	login(String admin, String password, URI base)	Attempt to log in.
void	userBanCreate(IdBan ban)	Create a ban on the given user account.
void	userBanDelete(IdBan ban)	Delete the given ban.
Optional<IdBan>	userBanGet(UUID id)	Get the ban for the given user, if one exists.
IdUser	userCreate(Optional<UUID> id, IdName idName, IdRealName realName, IdEmail email, IdPassword password)	Create a user.
void	userDelete(UUID id)	Delete the given user.
IdUser	userEmailAdd(UUID id, IdEmail email)	Add an email to the given user.
IdUser	userEmailRemove(UUID id, IdEmail email)	Remove an email from the given user.
Optional<IdUser>	userGet(UUID id)	Fetch the given user.
Optional<IdUser>	userGetByEmail(IdEmail email)	Fetch the given user.
List<IdLogin>	userLoginHistory(UUID id)	List the login history for the given user.
IdPage<IdUserSummary>	userSearchBegin(IdUserSearchParameters parameters)	Start searching/listing users.
IdPage<IdUserSummary>	userSearchByEmailBegin(IdUserSearchByEmailParameters parameters)	Start searching/listing users.
IdPage<IdUserSummary>	userSearchByEmailNext()	Continue searching/listing users.
IdPage<IdUserSummary>	userSearchByEmailPrevious()	Continue searching/listing users.
IdPage<IdUserSummary>	userSearchNext()	Continue searching/listing users.
IdPage<IdUserSummary>	userSearchPrevious()	Continue searching/listing users.
IdUser	userUpdate(UUID user, Optional<IdName> idName, Optional<IdRealName> realName, Optional<IdPassword> password)	Update the given user.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.io7m.idstore.admin_client.api.IdAClientUsersType

userCreate

Constructor Details

IdAClientProtocolHandlerDisconnected

public IdAClientProtocolHandlerDisconnected(Locale inLocale,
 IdAStrings inStrings,
 HttpClient inHttpClient)

The "disconnected" protocol handler.

Parameters:

inLocale - The locale

inStrings - The string resources

inHttpClient - The HTTP client

Method Details

login

public IdANewHandler login(String admin,
 String password,
 URI base)
                    throws IdAClientException,
InterruptedException

Description copied from interface: IdAClientProtocolHandlerType

Attempt to log in.

Specified by:

login in interface IdAClientProtocolHandlerType

Parameters:

admin - The admin

password - The password

base - The base URI

Returns:

A new protocol handler

Throws:

IdAClientException - On errors

InterruptedException - On interruption

adminSelf

public IdAdmin adminSelf()
                  throws IdAClientException

Description copied from interface: IdAClientAdminsType

Retrieve the current admin profile.

Specified by:

adminSelf in interface IdAClientAdminsType

Returns:

The current user

Throws:

IdAClientException - On errors

adminSearchBegin

public IdPage<IdAdminSummary> adminSearchBegin(IdAdminSearchParameters parameters)
                                        throws IdAClientException

Description copied from interface: IdAClientAdminsType

Start searching/listing admins. Calling this method will set the search parameters and effectively reset searching back to page 1 of any results.

Specified by:

adminSearchBegin in interface IdAClientAdminsType

Parameters:

parameters - The search parameters

Returns:

The first page of results

Throws:

IdAClientException - On errors

adminSearchNext

public IdPage<IdAdminSummary> adminSearchNext()
                                       throws IdAClientException

Description copied from interface: IdAClientAdminsType

Continue searching/listing admins. This will return the next page of results.

Specified by:

adminSearchNext in interface IdAClientAdminsType

Returns:

The next page of results

Throws:

IdAClientException - On errors

adminSearchPrevious

public IdPage<IdAdminSummary> adminSearchPrevious()
                                           throws IdAClientException

Description copied from interface: IdAClientAdminsType

Continue searching/listing admins. This will return the previous page of results.

Specified by:

adminSearchPrevious in interface IdAClientAdminsType

Returns:

The previous page of results

Throws:

IdAClientException - On errors

adminSearchByEmailBegin

public IdPage<IdAdminSummary> adminSearchByEmailBegin(IdAdminSearchByEmailParameters parameters)
                                               throws IdAClientException

Description copied from interface: IdAClientAdminsType

Start searching/listing admins. Calling this method will set the search parameters and effectively reset searching back to page 1 of any results.

Specified by:

adminSearchByEmailBegin in interface IdAClientAdminsType

Parameters:

parameters - The search parameters

Returns:

The first page of results

Throws:

IdAClientException - On errors

adminSearchByEmailNext

public IdPage<IdAdminSummary> adminSearchByEmailNext()
                                              throws IdAClientException

Description copied from interface: IdAClientAdminsType

Continue searching/listing admins. This will return the next page of results.

Specified by:

adminSearchByEmailNext in interface IdAClientAdminsType

Returns:

The next page of results

Throws:

IdAClientException - On errors

adminSearchByEmailPrevious

public IdPage<IdAdminSummary> adminSearchByEmailPrevious()
                                                  throws IdAClientException

Description copied from interface: IdAClientAdminsType

Continue searching/listing admins. This will return the previous page of results.

Specified by:

adminSearchByEmailPrevious in interface IdAClientAdminsType

Returns:

The previous page of results

Throws:

IdAClientException - On errors

adminGet

public Optional<IdAdmin> adminGet(UUID id)
                           throws IdAClientException

Description copied from interface: IdAClientAdminsType

Fetch the given admin.

Specified by:

adminGet in interface IdAClientAdminsType

Parameters:

id - The admin ID

Returns:

The admin, if one exists

Throws:

IdAClientException - On errors

adminGetByEmail

public Optional<IdAdmin> adminGetByEmail(IdEmail email)
                                  throws IdAClientException

Description copied from interface: IdAClientAdminsType

Fetch the given admin.

Specified by:

adminGetByEmail in interface IdAClientAdminsType

Parameters:

email - The admin email

Returns:

The admin, if one exists

Throws:

IdAClientException - On errors

adminUpdate

public IdAdmin adminUpdate(UUID admin,
 Optional<IdName> idName,
 Optional<IdRealName> realName,
 Optional<IdPassword> password)
                    throws IdAClientException

Description copied from interface: IdAClientAdminsType

Update the given admin.

Specified by:

adminUpdate in interface IdAClientAdminsType

Parameters:

admin - The admin

idName - The new idname

realName - The new realname

password - The new password

Returns:

The updated admin

Throws:

IdAClientException - On errors

adminCreate

public IdAdmin adminCreate(Optional<UUID> id,
 IdName idName,
 IdRealName realName,
 IdEmail email,
 IdPassword password,
 IdAdminPermissionSet permissions)
                    throws IdAClientException

Description copied from interface: IdAClientAdminsType

Create a admin.

Specified by:

adminCreate in interface IdAClientAdminsType

Parameters:

id - The ID

idName - The ID name

realName - The real name

email - The email

password - The password

permissions - The permissions

Returns:

The created admin

Throws:

IdAClientException - On errors

adminDelete

public void adminDelete(UUID id)
                 throws IdAClientException

Description copied from interface: IdAClientAdminsType

Delete the given admin.

Specified by:

adminDelete in interface IdAClientAdminsType

Parameters:

id - The admin ID

Throws:

IdAClientException - On errors

adminEmailAdd

public IdAdmin adminEmailAdd(UUID id,
 IdEmail email)
                      throws IdAClientException

Description copied from interface: IdAClientAdminsType

Add an email to the given admin.

Specified by:

adminEmailAdd in interface IdAClientAdminsType

Parameters:

id - The admin ID

email - The email address

Returns:

The updated admin

Throws:

IdAClientException - On errors

adminEmailRemove

public IdAdmin adminEmailRemove(UUID id,
 IdEmail email)
                         throws IdAClientException

Description copied from interface: IdAClientAdminsType

Remove an email from the given admin.

Specified by:

adminEmailRemove in interface IdAClientAdminsType

Parameters:

id - The admin ID

email - The email address

Returns:

The updated admin

Throws:

IdAClientException - On errors

adminPermissionGrant

public IdAdmin adminPermissionGrant(UUID id,
 IdAdminPermission permission)
                             throws IdAClientException

Description copied from interface: IdAClientAdminsType

Grant a permission to the given admin.

Specified by:

adminPermissionGrant in interface IdAClientAdminsType

Parameters:

id - The admin ID

permission - The permission

Returns:

The updated admin

Throws:

IdAClientException - On errors

adminPermissionRevoke

public IdAdmin adminPermissionRevoke(UUID id,
 IdAdminPermission permission)
                              throws IdAClientException

Description copied from interface: IdAClientAdminsType

Revoke a permission from the given admin.

Specified by:

adminPermissionRevoke in interface IdAClientAdminsType

Parameters:

id - The admin ID

permission - The permission

Returns:

The updated admin

Throws:

IdAClientException - On errors

adminBanCreate

public void adminBanCreate(IdBan ban)
                    throws IdAClientException

Description copied from interface: IdAClientAdminsType

Create a ban on the given admin account.

Specified by:

adminBanCreate in interface IdAClientAdminsType

Parameters:

ban - The ban

Throws:

IdAClientException - On errors

adminBanGet

public Optional<IdBan> adminBanGet(UUID id)
                            throws IdAClientException

Description copied from interface: IdAClientAdminsType

Get the ban for the given admin, if one exists.

Specified by:

adminBanGet in interface IdAClientAdminsType

Parameters:

id - The admin ID

Returns:

The ban, if any

Throws:

IdAClientException - On errors

adminBanDelete

public void adminBanDelete(IdBan ban)
                    throws IdAClientException

Description copied from interface: IdAClientAdminsType

Delete the given ban.

Specified by:

adminBanDelete in interface IdAClientAdminsType

Parameters:

ban - The ban

Throws:

IdAClientException - On errors

userSearchBegin

public IdPage<IdUserSummary> userSearchBegin(IdUserSearchParameters parameters)
                                      throws IdAClientException

Description copied from interface: IdAClientUsersType

Start searching/listing users. Calling this method will set the search parameters and effectively reset searching back to page 1 of any results.

Specified by:

userSearchBegin in interface IdAClientUsersType

Parameters:

parameters - The search parameters

Returns:

The first page of results

Throws:

IdAClientException - On errors

userSearchNext

public IdPage<IdUserSummary> userSearchNext()
                                     throws IdAClientException

Description copied from interface: IdAClientUsersType

Continue searching/listing users. This will return the next page of results.

Specified by:

userSearchNext in interface IdAClientUsersType

Returns:

The next page of results

Throws:

IdAClientException - On errors

userSearchPrevious

public IdPage<IdUserSummary> userSearchPrevious()
                                         throws IdAClientException

Description copied from interface: IdAClientUsersType

Continue searching/listing users. This will return the previous page of results.

Specified by:

userSearchPrevious in interface IdAClientUsersType

Returns:

The previous page of results

Throws:

IdAClientException - On errors

userSearchByEmailBegin

public IdPage<IdUserSummary> userSearchByEmailBegin(IdUserSearchByEmailParameters parameters)
                                             throws IdAClientException

Description copied from interface: IdAClientUsersType

Start searching/listing users. Calling this method will set the search parameters and effectively reset searching back to page 1 of any results.

Specified by:

userSearchByEmailBegin in interface IdAClientUsersType

Parameters:

parameters - The search parameters

Returns:

The first page of results

Throws:

IdAClientException - On errors

userSearchByEmailNext

public IdPage<IdUserSummary> userSearchByEmailNext()
                                            throws IdAClientException

Description copied from interface: IdAClientUsersType

Continue searching/listing users. This will return the next page of results.

Specified by:

userSearchByEmailNext in interface IdAClientUsersType

Returns:

The next page of results

Throws:

IdAClientException - On errors

userSearchByEmailPrevious

public IdPage<IdUserSummary> userSearchByEmailPrevious()
                                                throws IdAClientException

Description copied from interface: IdAClientUsersType

Continue searching/listing users. This will return the previous page of results.

Specified by:

userSearchByEmailPrevious in interface IdAClientUsersType

Returns:

The previous page of results

Throws:

IdAClientException - On errors

userGet

public Optional<IdUser> userGet(UUID id)
                         throws IdAClientException

Description copied from interface: IdAClientUsersType

Fetch the given user.

Specified by:

userGet in interface IdAClientUsersType

Parameters:

id - The user ID

Returns:

The user, if one exists

Throws:

IdAClientException - On errors

userGetByEmail

public Optional<IdUser> userGetByEmail(IdEmail email)
                                throws IdAClientException

Description copied from interface: IdAClientUsersType

Fetch the given user.

Specified by:

userGetByEmail in interface IdAClientUsersType

Parameters:

email - The user email

Returns:

The user, if one exists

Throws:

IdAClientException - On errors

userUpdate

public IdUser userUpdate(UUID user,
 Optional<IdName> idName,
 Optional<IdRealName> realName,
 Optional<IdPassword> password)
                  throws IdAClientException

Description copied from interface: IdAClientUsersType

Update the given user.

Specified by:

userUpdate in interface IdAClientUsersType

Parameters:

user - The user

idName - The new idname

realName - The new realname

password - The new password

Returns:

The updated user

Throws:

IdAClientException - On errors

userEmailAdd

public IdUser userEmailAdd(UUID id,
 IdEmail email)
                    throws IdAClientException

Description copied from interface: IdAClientUsersType

Add an email to the given user.

Specified by:

userEmailAdd in interface IdAClientUsersType

Parameters:

id - The user ID

email - The email address

Returns:

The updated user

Throws:

IdAClientException - On errors

userEmailRemove

public IdUser userEmailRemove(UUID id,
 IdEmail email)
                       throws IdAClientException

Description copied from interface: IdAClientUsersType

Remove an email from the given user.

Specified by:

userEmailRemove in interface IdAClientUsersType

Parameters:

id - The user ID

email - The email address

Returns:

The updated user

Throws:

IdAClientException - On errors

userCreate

public IdUser userCreate(Optional<UUID> id,
 IdName idName,
 IdRealName realName,
 IdEmail email,
 IdPassword password)
                  throws IdAClientException,
InterruptedException

Description copied from interface: IdAClientUsersType

Create a user.

Specified by:

userCreate in interface IdAClientUsersType

Parameters:

id - The ID

idName - The ID name

realName - The real name

email - The email

password - The password

Returns:

The created user

Throws:

IdAClientException - On errors

InterruptedException - On interruption

userDelete

public void userDelete(UUID id)
                throws IdAClientException

Description copied from interface: IdAClientUsersType

Delete the given user.

Specified by:

userDelete in interface IdAClientUsersType

Parameters:

id - The user ID

Throws:

IdAClientException - On errors

userBanCreate

public void userBanCreate(IdBan ban)
                   throws IdAClientException

Description copied from interface: IdAClientUsersType

Create a ban on the given user account.

Specified by:

userBanCreate in interface IdAClientUsersType

Parameters:

ban - The ban

Throws:

IdAClientException - On errors

userBanGet

public Optional<IdBan> userBanGet(UUID id)
                           throws IdAClientException

Description copied from interface: IdAClientUsersType

Get the ban for the given user, if one exists.

Specified by:

userBanGet in interface IdAClientUsersType

Parameters:

id - The user ID

Returns:

The ban, if any

Throws:

IdAClientException - On errors

userBanDelete

public void userBanDelete(IdBan ban)
                   throws IdAClientException

Description copied from interface: IdAClientUsersType

Delete the given ban.

Specified by:

userBanDelete in interface IdAClientUsersType

Parameters:

ban - The ban

Throws:

IdAClientException - On errors

userLoginHistory

public List<IdLogin> userLoginHistory(UUID id)
                               throws IdAClientException

Description copied from interface: IdAClientUsersType

List the login history for the given user.

Specified by:

userLoginHistory in interface IdAClientUsersType

Parameters:

id - The user ID

Returns:

The login history

Throws:

IdAClientException - On errors

auditSearchBegin

public IdPage<IdAuditEvent> auditSearchBegin(IdTimeRange timeRange,
 Optional<String> owner,
 Optional<String> type,
 Optional<String> message,
 int pageSize)
                                      throws IdAClientException

Description copied from interface: IdAClientAuditType

Start searching/listing audit events. Calling this method will set the search parameters and effectively reset searching back to page 1 of any results.

Specified by:

auditSearchBegin in interface IdAClientAuditType

Parameters:

timeRange - The time range within which events should have been created

owner - The owner search query

type - The type search query

message - The message search query

pageSize - The page size

Returns:

The first page of results

Throws:

IdAClientException - On errors

auditSearchNext

public IdPage<IdAuditEvent> auditSearchNext()
                                     throws IdAClientException

Description copied from interface: IdAClientAuditType

Continue searching/listing events. This will return the next page of results.

Specified by:

auditSearchNext in interface IdAClientAuditType

Returns:

The next page of results

Throws:

IdAClientException - On errors

auditSearchPrevious

public IdPage<IdAuditEvent> auditSearchPrevious()
                                         throws IdAClientException

Description copied from interface: IdAClientAuditType

Continue searching/listing events. This will return the previous page of results.

Specified by:

auditSearchPrevious in interface IdAClientAuditType

Returns:

The previous page of results

Throws:

IdAClientException - On errors