com.atlassian.jira.avatar

Interface AvatarManager

All Known Implementing Classes:

AvatarManagerImpl

@PublicApi
public interface AvatarManager

Manager interface for Avatar domain objects.

Since:

v4.0

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	AvatarManager.ImageSize Deprecated. in JIRA 6.0 -- use Avatar.Size.

Field Summary

Fields

Modifier and Type	Field and Description
static String	AVATAR_IMAGE_FORMAT
static AvatarFormat	AVATAR_IMAGE_FORMAT_FULL
static String	USER_AVATAR_ID_KEY

Method Summary

Methods

Modifier and Type	Method and Description
Avatar	create(Avatar.Type avatarType, String owningObjectId, AvatarImageDataProvider imageDataProvider) Creates a database record for the given avatar and uses the content of the InputStream as the image.
Avatar	create(Avatar avatar) Creates a database record for the given avatar.
Avatar	create(Avatar avatar, InputStream image, Selection selection) Creates a database record for the given avatar and uses the content of the InputStream as the image.
Avatar	create(String fileName, String contentType, ApplicationUser owner, InputStream image, Selection selection) Creates a database record for the given avatar and uses the content of the InputStream as the image.
Avatar	create(String fileName, String contentType, Project owner, InputStream image, Selection selection) Creates a database record for the given avatar and uses the content of the InputStream as the image.
boolean	delete(Long avatarId) Delete the avatar with the given id and the file on disk.
boolean	delete(Long avatarId, boolean alsoDeleteAvatarFile) Delete the avatar with the given id.
List<Avatar>	getAllSystemAvatars(Avatar.Type type) Provides a list of all system avatars.
Long	getAnonymousAvatarId() Gets the avatar id to use to represent an unknown or anonymous user
File	getAvatarBaseDirectory() Returns the directory for storing avatars.
Avatar	getById(Long avatarId) Retrieve the avatar with the given id.
Avatar	getByIdTagged(Long avatarId) Retrieve the avatar with the given id, ensuring the avatar file is tagged with metadata identifying the image came from JIRA.
List<Avatar>	getCustomAvatarsForOwner(Avatar.Type type, String ownerId) Deprecated. there can only be one. Since v6.4.
Long	getDefaultAvatarId(Avatar.Type ofType) Gets the default avatar for the given type.
boolean	hasPermissionToEdit(ApplicationUser remoteUser, ApplicationUser owner) Determines if the remoteUser provided has permission to edit avatars of a certain type for the owner provided.
boolean	hasPermissionToEdit(ApplicationUser remoteUser, Project owner) Determines if the remoteUser provided has permission to edit avatars of a certain type for the owner provided.
boolean	hasPermissionToEdit(com.atlassian.crowd.embedded.api.User remoteUser, Avatar.Type type, String ownerId) Deprecated. Use hasPermissionToEdit(ApplicationUser, ApplicationUser) or hasPermissionToEdit(com.atlassian.jira.user.ApplicationUser, com.atlassian.jira.project.Project). Since v6.0
boolean	hasPermissionToView(ApplicationUser remoteUser, ApplicationUser owner) Determines if the remoteUser provided has permission to view avatars of a certain type for the owner provided.
boolean	hasPermissionToView(ApplicationUser remoteUser, Project owner) Determines if the remoteUser provided has permission to view avatars of a certain type for the owner provided.
boolean	hasPermissionToView(com.atlassian.crowd.embedded.api.User remoteUser, Avatar.Type type, String ownerId) Deprecated. Use hasPermissionToView(com.atlassian.jira.user.ApplicationUser, ApplicationUser) or hasPermissionToView(com.atlassian.jira.user.ApplicationUser, com.atlassian.jira.project.Project). Since v6.0
boolean	isAvatarOwner(Avatar avatar, String ownerId) Deprecated. To be removed. Since v6.0
void	readAvatarData(Avatar avatar, AvatarManager.ImageSize size, Consumer<InputStream> dataAccessor) Provides read-only access to the data of the avatar image as an InputStream passed to the provided dataProcessor.
void	update(Avatar avatar) Saves the avatar as an updated version of the avatar with the same id that is already in the database.

Field Detail

AVATAR_IMAGE_FORMAT

static final String AVATAR_IMAGE_FORMAT

See Also:

Constant Field Values

AVATAR_IMAGE_FORMAT_FULL

static final AvatarFormat AVATAR_IMAGE_FORMAT_FULL

USER_AVATAR_ID_KEY

static final String USER_AVATAR_ID_KEY

See Also:

Constant Field Values

Method Detail

getById

Avatar getById(Long avatarId)
               throws DataAccessException

Retrieve the avatar with the given id.

Parameters:

avatarId - must not be null.

Returns:

the Avatar if there is one or null if not.

Throws:

DataAccessException - if there is a back-end database problem.

getByIdTagged

Avatar getByIdTagged(Long avatarId)
                     throws DataAccessException

Retrieve the avatar with the given id, ensuring the avatar file is tagged with metadata identifying the image came from JIRA.

Parameters:

avatarId - must not be null.

Returns:

the Avatar if there is one or null if not.

Throws:

DataAccessException - if there is a back-end database problem.

delete

boolean delete(Long avatarId)
               throws DataAccessException

Delete the avatar with the given id and the file on disk.

Parameters:

avatarId - must not be null.

Returns:

true only if there was an avatar with the given id which was deleted.

Throws:

DataAccessException - if there is a back-end database problem.

delete

boolean delete(Long avatarId,
             boolean alsoDeleteAvatarFile)

Delete the avatar with the given id.

Parameters:

avatarId - must not be null.

alsoDeleteAvatarFile - if false, the avatar file will be left on disk.

Returns:

true only if there was an avatar with the given id which was deleted.

Throws:

DataAccessException - if there is a back-end database problem.

update

void update(Avatar avatar)
            throws DataAccessException

Saves the avatar as an updated version of the avatar with the same id that is already in the database.

Parameters:

avatar - must not be null.

Throws:

DataAccessException - if there is a back-end database problem.

create

@Nonnull
Avatar create(Avatar avatar)
              throws DataAccessException

Creates a database record for the given avatar. Use the return value as the persistent avatar, not the one you passed in.

Parameters:

avatar - must not be null, must have a null id.

Returns:

the created avatar which has an assigned id.

Throws:

DataAccessException - if there is a back-end database problem.

create

@Nonnull
Avatar create(Avatar avatar,
                    InputStream image,
                    Selection selection)
              throws DataAccessException,
                     IOException

Creates a database record for the given avatar and uses the content of the InputStream as the image. Use the return value as the persistent avatar, not the one you passed in.

Parameters:

avatar - must not be null, must have a null id.

image - the data of the original avatar image.

selection - the cropping selection for the image or null to take whole image.

Returns:

the created avatar which has an assigned id.

Throws:

DataAccessException - if there is a back-end database problem.

IOException

Since:

v6.3

create

@Nonnull
Avatar create(Avatar.Type avatarType,
                    @Nonnull
                    String owningObjectId,
                    @Nonnull
                    AvatarImageDataProvider imageDataProvider)
              throws IOException

Creates a database record for the given avatar and uses the content of the InputStream as the image. Use the return value as the persistent avatar, not the one you passed in.

Parameters:

avatarType - type of new avatar to create.

owningObjectId - id of object (project/user/issuetype) to which this avatar is connected to.

imageDataProvider - provider of image data

Returns:

the created avatar which has an assigned id.

Throws:

DataAccessException - if there is a back-end database problem.

IOException - if there are arrors when processing image data

Since:

v6.3

See Also:

CroppingAvatarImageDataProviderFactory

create

@Nonnull
Avatar create(String fileName,
                    String contentType,
                    Project owner,
                    InputStream image,
                    Selection selection)
              throws DataAccessException,
                     IOException

Creates a database record for the given avatar and uses the content of the InputStream as the image. Use the return value as the persistent avatar, not the one you passed in.

Parameters:

fileName - the name of the avatar

contentType - MIME content type for the avatar

image - the data of the original avatar image (it will be automatically closed)

selection - the cropping selection for the image or null to take whole image

Returns:

the created avatar which has an assigned id

Throws:

DataAccessException - if there is a back-end database problem.

IOException

create

@Nonnull
Avatar create(String fileName,
                    String contentType,
                    ApplicationUser owner,
                    InputStream image,
                    Selection selection)
              throws DataAccessException,
                     IOException

Creates a database record for the given avatar and uses the content of the InputStream as the image. Use the return value as the persistent avatar, not the one you passed in.

Parameters:

fileName - the name of the avatar

contentType - MIME content type for the avatar

image - the data of the original avatar image (it will be automatically closed)

selection - the cropping selection for the image or null to take whole image

Returns:

the created avatar which has an assigned id

Throws:

DataAccessException - if there is a back-end database problem.

IOException

getAllSystemAvatars

@Nonnull
List<Avatar> getAllSystemAvatars(Avatar.Type type)
                                 throws DataAccessException

Provides a list of all system avatars.

Parameters:

type - The type of system avatars to return

Returns:

the system avatars.

Throws:

DataAccessException - if there is a back-end database problem.

getCustomAvatarsForOwner

@Nonnull
@Deprecated
List<Avatar> getCustomAvatarsForOwner(Avatar.Type type,
                                                       String ownerId)
                                      throws DataAccessException

Deprecated. there can only be one. Since v6.4.

Provides a list of all avatars that are of the given type which have the given owner.

Parameters:

type - the desired type of the avatars to retrieve.

ownerId - the id of the owner, matches the type (project id or user key).

Returns:

all the avatars that have the given type and owner, never null.

Throws:

DataAccessException - if there is a back-end database problem.

isAvatarOwner

boolean isAvatarOwner(Avatar avatar,
                    String ownerId)

Deprecated. To be removed. Since v6.0

Tells whether the given avatar is owned by the given ownerId.

Parameters:

avatar - the avatar to check, must not be null.

ownerId - the ownerId to check, must not be null.

Returns:

true only if the given ownerId is the ownerId of the given avatar.

readAvatarData

void readAvatarData(Avatar avatar,
                  AvatarManager.ImageSize size,
                  Consumer<InputStream> dataAccessor)
                    throws IOException

Provides read-only access to the data of the avatar image as an InputStream passed to the provided dataProcessor. The InputStream is closed after the dataProcessor completes. The dataProcessor is immediately invoked on the data for the avatar.

Parameters:

avatar - the avatar for which the data is to be processed.

size - the size to return for this avatar

dataAccessor - something to read the data.

Throws:

IOException - if an IOException occurs in the dataProcessor or in acquiring the InputStream for the avatar.

getAvatarBaseDirectory

@Nonnull
File getAvatarBaseDirectory()

Returns the directory for storing avatars.

Returns:

the directory.

getDefaultAvatarId

Long getDefaultAvatarId(Avatar.Type ofType)

Gets the default avatar for the given type.

Parameters:

ofType - the Avatar type.

Returns:

the default Avatar.

getAnonymousAvatarId

Long getAnonymousAvatarId()

Gets the avatar id to use to represent an unknown or anonymous user

Returns:

the avatar id for an anonymous user

hasPermissionToView

boolean hasPermissionToView(com.atlassian.crowd.embedded.api.User remoteUser,
                          Avatar.Type type,
                          String ownerId)

Deprecated. Use hasPermissionToView(com.atlassian.jira.user.ApplicationUser, ApplicationUser) or hasPermissionToView(com.atlassian.jira.user.ApplicationUser, com.atlassian.jira.project.Project). Since v6.0

Determines if the remoteUser provided has permission to view avatars of a certain type for the owner provided. For project avatars, this method checks that the user is either and admin, project admin or has browse permission for the owner project. For user avatars, the method checks that the remoteUser has use permission for JIRA or the remoteUser and avatar owner are the same person

Parameters:

remoteUser - The remote user trying to view an avatar

type - The type of avatar

ownerId - The owner id of the avatar being viewed (project id or user key)

Returns:

true if the remote user has permission to view avatars owned by the owner provided.

hasPermissionToView

boolean hasPermissionToView(ApplicationUser remoteUser,
                          ApplicationUser owner)

Determines if the remoteUser provided has permission to view avatars of a certain type for the owner provided. For project avatars, this method checks that the user is either and admin, project admin or has browse permission for the owner project. For user avatars, the method checks that the remoteUser has use permission for JIRA or the remoteUser and avatar owner are the same person

Parameters:

remoteUser - The remote user trying to view an avatar

owner - The owner of the avatar being viewed

Returns:

true if the remote user has permission to view avatars owned by the owner provided.

Since:

v6.0

hasPermissionToView

boolean hasPermissionToView(ApplicationUser remoteUser,
                          Project owner)

Determines if the remoteUser provided has permission to view avatars of a certain type for the owner provided. For project avatars, this method checks that the user is either and admin, project admin or has browse permission for the owner project. For user avatars, the method checks that the remoteUser has use permission for JIRA or the remoteUser and avatar owner are the same person

Parameters:

remoteUser - The remote user trying to view an avatar

owner - The owner of the avatar being viewed

Returns:

true if the remote user has permission to view avatars owned by the owner provided.

Since:

v6.0

hasPermissionToEdit

boolean hasPermissionToEdit(com.atlassian.crowd.embedded.api.User remoteUser,
                          Avatar.Type type,
                          String ownerId)

Deprecated. Use hasPermissionToEdit(ApplicationUser, ApplicationUser) or hasPermissionToEdit(com.atlassian.jira.user.ApplicationUser, com.atlassian.jira.project.Project). Since v6.0

Determines if the remoteUser provided has permission to edit avatars of a certain type for the owner provided. For project avatars, this method checks that the user is either and admin or project admin for the owner project. For user avatars, the method checks that the remoteUser has admin permissions for JIRA or the remoteUser and avatar owner are the same person. If external user management is enabled this method returns false

Parameters:

remoteUser - The remote user trying to edit an avatar

type - The type of avatar

ownerId - The owner id of the avatar being edited (project id or user key)

Returns:

true if the remote user has permission to edit avatars owned by the owner provided.

hasPermissionToEdit

boolean hasPermissionToEdit(ApplicationUser remoteUser,
                          ApplicationUser owner)

Determines if the remoteUser provided has permission to edit avatars of a certain type for the owner provided. For project avatars, this method checks that the user is either and admin or project admin for the owner project. For user avatars, the method checks that the remoteUser has admin permissions for JIRA or the remoteUser and avatar owner are the same person. If external user management is enabled this method returns false

Parameters:

remoteUser - The remote user trying to edit an avatar

owner - The owner of the avatar being edited

Returns:

true if the remote user has permission to edit avatars owned by the owner provided.

Since:

v6.0

hasPermissionToEdit

boolean hasPermissionToEdit(ApplicationUser remoteUser,
                          Project owner)

Determines if the remoteUser provided has permission to edit avatars of a certain type for the owner provided. For project avatars, this method checks that the user is either and admin or project admin for the owner project. For user avatars, the method checks that the remoteUser has admin permissions for JIRA or the remoteUser and avatar owner are the same person. If external user management is enabled this method returns false

Parameters:

remoteUser - The remote user trying to edit an avatar

owner - The owner of the avatar being edited

Returns:

true if the remote user has permission to edit avatars owned by the owner provided.

Since:

v6.0