public interface

AvatarPickerHelper

com.atlassian.jira.avatar.AvatarPickerHelper
Known Indirect Subclasses

Class Overview

A helper interface for uploading and creating custom avatars

The user will upload an image that is then stored in the session. A url and cropping instructions are sent back to the user so they can select part of the image to be the avatar. Those coordinates are sent back to the server and used to convert the temporary image into an avatar.

Summary

Public Methods
Result<Avatar> convertTemporaryToReal(String ownerId, Avatar.Type type, Selection selection)
Converts temporary avatar (uploaded) to real avatar
Result<AvatarPickerHelperImpl.TemporaryAvatarBean> cropTemporary(String ownerId, Avatar.Type type, Selection selection)
Crops the temporary avatar (uploaded) using the given selection.
String getTemporaryAvatarUrl()
Gets temporary avatar url
Result<AvatarPickerHelperImpl.TemporaryAvatarBean> upload(InputStream stream, String fileName, String contentType, long size, String ownerId, Avatar.Type type)
Handles upload of temporary avatar

Public Methods

public Result<Avatar> convertTemporaryToReal (String ownerId, Avatar.Type type, Selection selection)

Converts temporary avatar (uploaded) to real avatar

Parameters
ownerId the id of the owner, matches the type (project id or user key)
type the desired type of the avatar
selection the area of the temporary avatar to crop real avatar to
Returns
  • conversion result and any errors

public Result<AvatarPickerHelperImpl.TemporaryAvatarBean> cropTemporary (String ownerId, Avatar.Type type, Selection selection)

Crops the temporary avatar (uploaded) using the given selection.

Parameters
ownerId the id of the owner, matches the type (project id or user key)
type the desired type of the avatar.
selection the area of the temporary avatar to crop real avatar to
Returns
  • crop result and any errors

public String getTemporaryAvatarUrl ()

Gets temporary avatar url

Returns
  • temporary avatar url

public Result<AvatarPickerHelperImpl.TemporaryAvatarBean> upload (InputStream stream, String fileName, String contentType, long size, String ownerId, Avatar.Type type)

Handles upload of temporary avatar

Parameters
stream upload io stream
fileName name of upload file
contentType image type
size size of avatar
ownerId ownerId the id of the owner, matches the type (project id or user key)
type the desired type of the avatar.
Returns
  • upload result and any errors