com.atlassian.jira.avatar
Class AvatarManagerImpl

java.lang.Object
  extended by com.atlassian.jira.avatar.AvatarManagerImpl
All Implemented Interfaces:
AvatarManager

public class AvatarManagerImpl
extends Object
implements AvatarManager

Manager for Avatars.

Since:
v4.0

Field Summary
 
Fields inherited from interface com.atlassian.jira.avatar.AvatarManager
AVATAR_IMAGE_FORMAT, LARGE, SMALL
 
Constructor Summary
AvatarManagerImpl(AvatarStore store, JiraHome jiraHome, ApplicationProperties applicationProperties)
           
 
Method Summary
 Avatar create(Avatar avatar)
          Creates a database record for the given avatar.
 Avatar create(Avatar avatar, InputStream imageData, Selection croppingSelection)
          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()
          Provides a list of all system avatars.
 File getAvatarBaseDirectory()
          Returns the directory for storing avatars.
 Avatar getById(Long avatarId)
          Retrieve the avatar with the given id.
 List<Avatar> getCustomAvatarsForOwner(Avatar.Type type, String ownerId)
          Provides a list of all avatars that are of the given type which have the given owner.
 Long getDefaultAvatarId(Avatar.Type ofType)
          Gets the default avatar for the given type.
 boolean isAvatarOwner(Avatar avatar, String owner)
          Tells whether the given avatar is owned by the given owner.
 void readLargeAvatarData(Avatar avatar, Consumer<InputStream> dataAccessor)
          Provides read-only access to the data of the large avatar image as an InputStream passed to the provided dataProcessor.
 void readSmallAvatarData(Avatar avatar, Consumer<InputStream> dataAccessor)
          Provides read-only access to the data of the small 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.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

AvatarManagerImpl

public AvatarManagerImpl(AvatarStore store,
                         JiraHome jiraHome,
                         ApplicationProperties applicationProperties)
Method Detail

getById

public Avatar getById(Long avatarId)
Description copied from interface: AvatarManager
Retrieve the avatar with the given id.

Specified by:
getById in interface AvatarManager
Parameters:
avatarId - must not be null.
Returns:
the Avatar if there is one or null if not.

delete

public boolean delete(Long avatarId)
Description copied from interface: AvatarManager
Delete the avatar with the given id and the file on disk.

Specified by:
delete in interface AvatarManager
Parameters:
avatarId - must not be null.
Returns:
true only if there was an avatar with the given id which was deleted.

delete

public boolean delete(Long avatarId,
                      boolean alsoDeleteAvatarFile)
Description copied from interface: AvatarManager
Delete the avatar with the given id.

Specified by:
delete in interface AvatarManager
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.

update

public void update(Avatar avatar)
Description copied from interface: AvatarManager
Saves the avatar as an updated version of the avatar with the same id that is already in the database.

Specified by:
update in interface AvatarManager
Parameters:
avatar - must not be null.

create

public Avatar create(Avatar avatar)
Description copied from interface: AvatarManager
Creates a database record for the given avatar. Use the return value as the persistent avatar, not the one you passed in.

Specified by:
create in interface AvatarManager
Parameters:
avatar - must not be null, must have a null id.
Returns:
the created avatar which has an assigned id.

create

public Avatar create(Avatar avatar,
                     InputStream imageData,
                     Selection croppingSelection)
              throws DataAccessException,
                     IOException
Description copied from interface: AvatarManager
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.

Specified by:
create in interface AvatarManager
Parameters:
avatar - must not be null, must have a null id.
imageData - the data of the original avatar image.
croppingSelection - 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

getAvatarBaseDirectory

public File getAvatarBaseDirectory()
Description copied from interface: AvatarManager
Returns the directory for storing avatars.

Specified by:
getAvatarBaseDirectory in interface AvatarManager
Returns:
the directory.

getAllSystemAvatars

public List<Avatar> getAllSystemAvatars()
Description copied from interface: AvatarManager
Provides a list of all system avatars.

Specified by:
getAllSystemAvatars in interface AvatarManager
Returns:
the system avatars.

getCustomAvatarsForOwner

public List<Avatar> getCustomAvatarsForOwner(Avatar.Type type,
                                             String ownerId)
Description copied from interface: AvatarManager
Provides a list of all avatars that are of the given type which have the given owner.

Specified by:
getCustomAvatarsForOwner in interface AvatarManager
Parameters:
type - the desired type of the avatars to retrieve.
ownerId - the id of the owner, matches the type.
Returns:
all the avatars that have the given type and owner, never null.

isAvatarOwner

public boolean isAvatarOwner(Avatar avatar,
                             String owner)
Description copied from interface: AvatarManager
Tells whether the given avatar is owned by the given owner.

Specified by:
isAvatarOwner in interface AvatarManager
Parameters:
avatar - the avatar to check, must not be null.
owner - the owner to check, must not be null.
Returns:
true only if the given owner is the owner of the given avatar.

readLargeAvatarData

public void readLargeAvatarData(Avatar avatar,
                                Consumer<InputStream> dataAccessor)
                         throws IOException
Description copied from interface: AvatarManager
Provides read-only access to the data of the large 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.

Specified by:
readLargeAvatarData in interface AvatarManager
Parameters:
avatar - the avatar for which the data is to be processed.
dataAccessor - something to read the data.
Throws:
IOException - if an IOException occurs in the dataProcessor or in acquiring the InputStream for the avatar.

readSmallAvatarData

public void readSmallAvatarData(Avatar avatar,
                                Consumer<InputStream> dataAccessor)
                         throws IOException
Description copied from interface: AvatarManager
Provides read-only access to the data of the small 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.

Specified by:
readSmallAvatarData in interface AvatarManager
Parameters:
avatar - the avatar for which the data is to be processed.
dataAccessor - something to read the data.
Throws:
IOException - if an IOException acquiring the InputStream for the avatar.

getDefaultAvatarId

public Long getDefaultAvatarId(Avatar.Type ofType)
Description copied from interface: AvatarManager
Gets the default avatar for the given type.

Specified by:
getDefaultAvatarId in interface AvatarManager
Parameters:
ofType - the Avatar type.
Returns:
the default Avatar.


Copyright © 2002-2009 Atlassian. All Rights Reserved.