com.atlassian.jira.rest.v2.user

Class UserPropertyResource

java.lang.Object

com.atlassian.jira.rest.v2.user.UserPropertyResource

public class UserPropertyResource
extends Object

Since:

v7.0

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	UserPropertyResource(UserPropertyService userPropertyService, JiraAuthenticationContext authenticationContext, JiraBaseUrls jiraBaseUrls, I18nHelper i18n, ResponseFactory responseFactory, UserManager userManager, SelfLinkBuilder selfLinkBuilder)

Method Summary

Modifier and Type	Method and Description
javax.ws.rs.core.Response	deleteProperty(String userKey, String username, String propertyKey) Removes the property from the user identified by the key or by the id.
javax.ws.rs.core.Response	getPropertiesKeys(String userKey, String username) Returns the keys of all properties for the user identified by the key or by the id.
javax.ws.rs.core.Response	getProperty(String userKey, String username, String propertyKey) Returns the value of the property with a given key from the user identified by the key or by the id.
javax.ws.rs.core.Response	setProperty(String userKey, String username, String propertyKey, javax.servlet.http.HttpServletRequest request) Sets the value of the specified user's property.

Methods inherited from class java.lang.Object

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

Constructor Detail

UserPropertyResource

protected UserPropertyResource(UserPropertyService userPropertyService,
                               JiraAuthenticationContext authenticationContext,
                               JiraBaseUrls jiraBaseUrls,
                               I18nHelper i18n,
                               ResponseFactory responseFactory,
                               UserManager userManager,
                               SelfLinkBuilder selfLinkBuilder)

Method Detail

getPropertiesKeys

public javax.ws.rs.core.Response getPropertiesKeys(String userKey,
                                                   String username)

Returns the keys of all properties for the user identified by the key or by the id.

Parameters:

username - username of the user whose properties are to be returned

userKey - key of the user whose properties are to be returned

Returns:

a response containing EntityPropertiesKeysBean.

setProperty

public javax.ws.rs.core.Response setProperty(String userKey,
                                             String username,
                                             String propertyKey,
                                             @Context
                                             javax.servlet.http.HttpServletRequest request)

Sets the value of the specified user's property.

You can use this resource to store a custom data against the user identified by the key or by the id. The user who stores the data is required to have permissions to administer the user.

Parameters:

username - username of the user whose property is to be set

userKey - key of the user whose property is to be set

propertyKey - the key of the user's property. The maximum length of the key is 255 bytes.

request - the request containing value of the user's property. The value has to a valid, non-empty JSON conforming to http://tools.ietf.org/html/rfc4627. The maximum length of the property value is 32768 bytes.

getProperty

public javax.ws.rs.core.Response getProperty(String userKey,
                                             String username,
                                             String propertyKey)

Returns the value of the property with a given key from the user identified by the key or by the id. The user who retrieves the property is required to have permissions to read the user.

Parameters:

username - username of the user whose property is to be returned

userKey - key of the user whose property is to be returned

Returns:

a response containing EntityPropertyBean.

deleteProperty

public javax.ws.rs.core.Response deleteProperty(String userKey,
                                                String username,
                                                String propertyKey)

Removes the property from the user identified by the key or by the id. Ths user removing the property is required to have permissions to administer the user.

Parameters:

username - username of the user whose property is to be removed

userKey - key of the user whose property is to be removed

Returns:

a 204 HTTP status if everything goes well.