Package com.atlassian.jira.plugin.userformat

Class CachingUserFormat

java.lang.Object

com.atlassian.jira.plugin.userformat.CachingUserFormat

All Implemented Interfaces:

UserFormat

public class CachingUserFormat
extends Object
implements UserFormat

Wrapping implementation of UserFormat that caches the results in RequestCache.

Note: results of both format methods are cached in the same cache. But for example format("1", "2") and format("1", "2", null) are still considered as different invocations because there is no guarantee they will return the same results.

Since:

v6.4

Field Summary

Fields inherited from interface com.atlassian.jira.plugin.profile.UserFormat

VIEW_TEMPLATE

Constructor Summary

Constructors

Constructor	Description
CachingUserFormat(UserFormat delegate)

Method Summary

Modifier and Type	Method	Description
String	format(String userkey, String id)	Renders the formatted user for a given section on the screen.
String	format(String userkey, String id, Map<String,Object> params)	Renders the formatted user for a given section on the screen.

Methods inherited from class java.lang.Object

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

Constructor Details

CachingUserFormat

public CachingUserFormat(UserFormat delegate)

Method Details

format

public String format(String userkey,
 String id)

Description copied from interface: UserFormat

Renders the formatted user for a given section on the screen. Please note that the username may be null (eg for empty fields, anonymous user's, etc) or the user may not exist. Implementations should handle these cases.

Extra context can be passed to the renderer via the id attribute. Ideally an implementation might include this id in the rendered output such that it can be used for test assertions.

The result should always be ready to display in an HTML response i.e. it should be HTML encoded if necessary.

Specified by:

format in interface UserFormat

Parameters:

userkey - the user's userkey to format.

id - A value providing extra context to the rendering process.

Returns:

the formatted user

format

public String format(String userkey,
 String id,
 Map<String,Object> params)

Description copied from interface: UserFormat

Renders the formatted user for a given section on the screen. Please note that the username may be null (eg for empty fields, anonymous user's, etc) or the user may not exist. Implementations should handle these cases.

Extra context can be passed to the renderer via the params attribute.

The result should always be ready to display in an HTML response i.e. it should be HTML encoded if necessary.

Specified by:

format in interface UserFormat

Parameters:

userkey - the user's userkey to format.

id - A value providing extra context to the rendering process.

params - Additional context to pass to the renderer

Returns:

the formatted user