Package com.atlassian.confluence.user

Enum Class AuthenticatedUserImpersonator

java.lang.Object

java.lang.Enum<AuthenticatedUserImpersonator>

com.atlassian.confluence.user.AuthenticatedUserImpersonator

All Implemented Interfaces:

Serializable, Comparable<AuthenticatedUserImpersonator>, Constable

public enum AuthenticatedUserImpersonator
extends Enum<AuthenticatedUserImpersonator>

Impersonates an authenticated user during the execution of the given callback.

The authenticated user is stored on a thread local variable for the HTTP workers. This variable is, amongst other things, used to

invalid reference

determine the locale

for

invalid reference

i18n

.

This behaviour makes sense for most cases. But if you want to e.g. render a Soy template for an email (on an HTTP worker) ahead of being sent, you'd want to set the locale to the recipient's locale. If the recipient is unknown to Confluence, you'd want the lookup to default to the site's locale instead of the sender's locale.

Since:

5.1.5

See Also:

• AuthenticatedUserThreadLocal
• UserThreadLocalFilter
• invalid reference

  com.atlassian.sal.confluence.message.ConfluenceI18nResolver

• invalid reference

  com.atlassian.soy.impl.GetTextFunction

• DefaultLocaleManager

Nested Class Summary

Nested classes/interfaces inherited from class java.lang.Enum

Enum.EnumDesc<E extends Enum<E>>

Enum Constant Summary

Enum Constants

Enum Constant	Description
REQUEST_AGNOSTIC	Use this instance if you'd want the thread to be agnostic of the request cache during the execution of the given callback.
REQUEST_AWARE	Use this instance if you'd want the thread to be aware of the request cache during the execution of the given callback.

Method Summary

Modifier and Type	Method	Description
<T> T	asAnonymousUser(Callable<T> callback)
<T> T	asUser(Callable<T> callback, @Nullable ConfluenceUser user)	Impersonates the given user during the execution of the given callback.
<T> T	asUser(Callable<T> callback, @Nullable com.atlassian.user.User user)	Deprecated, for removal: This API element is subject to removal in a future version. since 8.8 use asUser(Callable, ConfluenceUser)
static AuthenticatedUserImpersonator	valueOf(String name)	Returns the enum constant of this class with the specified name.
static AuthenticatedUserImpersonator[]	values()	Returns an array containing the constants of this enum class, in the order they are declared.
protected <T> Callable<T>	wrapCallback(Callable<T> callback)

Methods inherited from class java.lang.Enum

clone, compareTo, describeConstable, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Details

REQUEST_AWARE

public static final AuthenticatedUserImpersonator REQUEST_AWARE

Use this instance if you'd want the thread to be aware of the request cache during the execution of the given callback.

This would mean that the locale lookup would fall back to the Browser's locale.

See Also:

• RequestCacheThreadLocal
• RequestCacheThreadLocalFilter

REQUEST_AGNOSTIC

public static final AuthenticatedUserImpersonator REQUEST_AGNOSTIC

Use this instance if you'd want the thread to be agnostic of the request cache during the execution of the given callback.

This would mean that the locale lookup would fall back to the the site's locale.

See Also:

• RequestCacheThreadLocal
• RequestCacheThreadLocalFilter

Method Details

values

public static AuthenticatedUserImpersonator[] values()

Returns an array containing the constants of this enum class, in the order they are declared.

Returns:

an array containing the constants of this enum class, in the order they are declared

valueOf

public static AuthenticatedUserImpersonator valueOf(String name)

Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum class has no constant with the specified name

NullPointerException - if the argument is null

asAnonymousUser

public <T> T asAnonymousUser(Callable<T> callback)

asUser

public <T> T asUser(Callable<T> callback,
 @Nullable ConfluenceUser user)

Impersonates the given user during the execution of the given callback.

Parameters:

callback - the callback to be executed

user - the user to be impersonated

Returns:

the return value of the given callback

asUser

@Deprecated(forRemoval=true)
public <T> T asUser(Callable<T> callback,
 @Nullable com.atlassian.user.User user)

Deprecated, for removal: This API element is subject to removal in a future version.

since 8.8 use asUser(Callable, ConfluenceUser)

Impersonates the given user during the execution of the given callback.

Parameters:

callback - the callback to be executed

user - the user to be impersonated

Returns:

the return value of the given callback

wrapCallback

protected <T> Callable<T> wrapCallback(Callable<T> callback)