com.box.sdk

Class BoxUser

Object

BoxResource

BoxCollaborator

BoxUser

public class BoxUser
extends BoxCollaborator

Represents a Box user account.

Unless otherwise noted, the methods in this class can throw an unchecked BoxAPIException (unchecked meaning that the compiler won't force you to handle it) if an error occurs. If you wish to implement custom error handling for errors related to the Box REST API, you should capture this exception explicitly.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	BoxUser.Info Contains information about a BoxUser.
static class	BoxUser.Role Enumerates the possible roles that a user can have within an enterprise.
static class	BoxUser.Status Enumerates the possible statuses that a user's account can have.

Field Summary

Fields

Modifier and Type	Field and Description
static String[]	ALL_FIELDS An array of all possible file fields that can be requested when calling getInfo(String...).

Constructor Summary

Constructors

Constructor and Description
BoxUser(BoxAPIConnection api, String id) Constructs a BoxUser for a user with a given ID.

Method Summary

Modifier and Type	Method and Description
EmailAlias	addEmailAlias(String email) Adds a new email alias to this user's account.
static BoxUser.Info	createAppUser(BoxAPIConnection api, String name) Provisions a new app user in an enterprise using Box Developer Edition.
static BoxUser.Info	createAppUser(BoxAPIConnection api, String name, CreateUserParams params) Provisions a new app user in an enterprise with additional user information using Box Developer Edition.
static BoxUser.Info	createEnterpriseUser(BoxAPIConnection api, String login, String name) Provisions a new user in an enterprise.
static BoxUser.Info	createEnterpriseUser(BoxAPIConnection api, String login, String name, CreateUserParams params) Provisions a new user in an enterprise with additional user information.
void	delete(boolean notifyUser, boolean force) Deletes a user from an enterprise account.
void	deleteEmailAlias(String emailAliasID) Deletes an email alias from this user's account.
static Iterable<BoxUser.Info>	getAllEnterpriseUsers(BoxAPIConnection api) Returns an iterable containing all the enterprise users.
static Iterable<BoxUser.Info>	getAllEnterpriseUsers(BoxAPIConnection api, String filterTerm, String... fields) Returns an iterable containing all the enterprise users that matches the filter and specifies which child fields to retrieve from the API.
static BoxUser	getCurrentUser(BoxAPIConnection api) Gets the current user.
Collection<EmailAlias>	getEmailAliases() Gets a collection of all the email aliases for this user.
BoxUser.Info	getInfo(String... fields) Gets information about this user.
Collection<BoxGroupMembership.Info>	getMemberships() Gets information about all of the group memberships for this user.
BoxFolder.Info	moveFolderToUser(String sourceUserID) Moves all of the owned content from within one user’s folder into a new folder in another user's account.
void	updateInfo(BoxUser.Info info) Updates the information about this user with any info fields that have been modified locally.

Methods inherited from class BoxResource

equals, getAPI, getID, hashCode

Methods inherited from class Object

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

Field Detail

ALL_FIELDS

public static final String[] ALL_FIELDS

An array of all possible file fields that can be requested when calling getInfo(String...).

Constructor Detail

BoxUser

public BoxUser(BoxAPIConnection api,
               String id)

Constructs a BoxUser for a user with a given ID.

Parameters:

api - the API connection to be used by the user.

id - the ID of the user.

Method Detail

createAppUser

public static BoxUser.Info createAppUser(BoxAPIConnection api,
                                         String name)

Provisions a new app user in an enterprise using Box Developer Edition.

Parameters:

api - the API connection to be used by the created user.

name - the name of the user.

Returns:

the created user's info.

createAppUser

public static BoxUser.Info createAppUser(BoxAPIConnection api,
                                         String name,
                                         CreateUserParams params)

Provisions a new app user in an enterprise with additional user information using Box Developer Edition.

Parameters:

api - the API connection to be used by the created user.

name - the name of the user.

params - additional user information.

Returns:

the created user's info.

createEnterpriseUser

public static BoxUser.Info createEnterpriseUser(BoxAPIConnection api,
                                                String login,
                                                String name)

Provisions a new user in an enterprise.

Parameters:

api - the API connection to be used by the created user.

login - the email address the user will use to login.

name - the name of the user.

Returns:

the created user's info.

createEnterpriseUser

public static BoxUser.Info createEnterpriseUser(BoxAPIConnection api,
                                                String login,
                                                String name,
                                                CreateUserParams params)

Provisions a new user in an enterprise with additional user information.

Parameters:

api - the API connection to be used by the created user.

login - the email address the user will use to login.

name - the name of the user.

params - additional user information.

Returns:

the created user's info.

getCurrentUser

public static BoxUser getCurrentUser(BoxAPIConnection api)

Gets the current user.

Parameters:

api - the API connection of the current user.

Returns:

the current user.

getAllEnterpriseUsers

public static Iterable<BoxUser.Info> getAllEnterpriseUsers(BoxAPIConnection api)

Returns an iterable containing all the enterprise users.

Parameters:

api - the API connection to be used when retrieving the users.

Returns:

an iterable containing all the enterprise users.

getAllEnterpriseUsers

public static Iterable<BoxUser.Info> getAllEnterpriseUsers(BoxAPIConnection api,
                                                           String filterTerm,
                                                           String... fields)

Returns an iterable containing all the enterprise users that matches the filter and specifies which child fields to retrieve from the API.

Parameters:

api - the API connection to be used when retrieving the users.

filterTerm - used to filter the results to only users starting with this string in either the name or the login. Can be null to not filter the results.

fields - the fields to retrieve. Leave this out for the standard fields.

Returns:

an iterable containing all the enterprise users that matches the filter.

getInfo

public BoxUser.Info getInfo(String... fields)

Gets information about this user.

Parameters:

fields - the optional fields to retrieve.

Returns:

info about this user.

getMemberships

public Collection<BoxGroupMembership.Info> getMemberships()

Gets information about all of the group memberships for this user.

Note: This method is only available to enterprise admins.

Returns:

a collection of information about the group memberships for this user.

addEmailAlias

public EmailAlias addEmailAlias(String email)

Adds a new email alias to this user's account.

Parameters:

email - the email address to add as an alias.

Returns:

the newly created email alias.

deleteEmailAlias

public void deleteEmailAlias(String emailAliasID)

Deletes an email alias from this user's account.

The IDs of the user's email aliases can be found by calling getEmailAliases().

Parameters:

emailAliasID - the ID of the email alias to delete.

getEmailAliases

public Collection<EmailAlias> getEmailAliases()

Gets a collection of all the email aliases for this user.

Note that the user's primary login email is not included in the collection of email aliases.

Returns:

a collection of all the email aliases for this user.

delete

public void delete(boolean notifyUser,
                   boolean force)

Deletes a user from an enterprise account.

Parameters:

notifyUser - whether or not to send an email notification to the user that their account has been deleted.

force - whether or not this user should be deleted even if they still own files.

updateInfo

public void updateInfo(BoxUser.Info info)

Updates the information about this user with any info fields that have been modified locally.

Note: This method is only available to enterprise admins.

Parameters:

info - info the updated info.

moveFolderToUser

public BoxFolder.Info moveFolderToUser(String sourceUserID)

Moves all of the owned content from within one user’s folder into a new folder in another user's account. You can move folders across users as long as the you have administrative permissions and the 'source' user owns the folders. Per the documentation at the link below, this will move everything from the root folder, as this is currently the only mode of operation supported. See also https://box-content.readme.io/reference#move-folder-into-another-users-folder

Parameters:

sourceUserID - the user id of the user whose files will be the source for this operation

Returns:

info for the newly created folder