com.atlassian.jira.rest.v2.issue
Class CommentPropertyResource

java.lang.Object
  extended by com.atlassian.jira.rest.v2.issue.CommentPropertyResource

public class CommentPropertyResource
extends Object


Constructor Summary
CommentPropertyResource(CommentPropertyService commentPropertyService, JiraAuthenticationContext authenticationContext, JiraBaseUrls jiraBaseUrls, I18nHelper i18n)
           
 
Method Summary
 javax.ws.rs.core.Response deleteProperty(String commentId, String propertyKey)
          Removes the property from the comment identified by the key or by the id.
 javax.ws.rs.core.Response getPropertiesKeys(String commentId)
          Returns the keys of all properties for the comment identified by the key or by the id.
 javax.ws.rs.core.Response getProperty(String commentId, String propertyKey)
          Returns the value of the property with a given key from the comment identified by the key or by the id.
 javax.ws.rs.core.Response setProperty(String commentId, String propertyKey, javax.servlet.http.HttpServletRequest request)
          Sets the value of the specified comment's property.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

CommentPropertyResource

public CommentPropertyResource(CommentPropertyService commentPropertyService,
                               JiraAuthenticationContext authenticationContext,
                               JiraBaseUrls jiraBaseUrls,
                               I18nHelper i18n)
Method Detail

getPropertiesKeys

@ExperimentalApi
public javax.ws.rs.core.Response getPropertiesKeys(String commentId)
Returns the keys of all properties for the comment identified by the key or by the id.

Parameters:
commentId - the comment from which keys will be returned.
Returns:
a response containing EntityPropertiesKeysBean.

setProperty

@ExperimentalApi
public javax.ws.rs.core.Response setProperty(String commentId,
                                                             String propertyKey,
                                                             @Context
                                                             javax.servlet.http.HttpServletRequest request)
Sets the value of the specified comment's property.

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

Parameters:
commentId - the comment on which the property will be set.
propertyKey - the key of the comment's property. The maximum length of the key is 255 bytes.
request - the request containing value of the comment'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

@ExperimentalApi
public javax.ws.rs.core.Response getProperty(String commentId,
                                                             String propertyKey)
Returns the value of the property with a given key from the comment identified by the key or by the id. The user who retrieves the property is required to have permissions to read the comment.

Parameters:
commentId - the comment from which the property will be returned.
propertyKey - the key of the property to return.
Returns:
a response containing EntityPropertyBean.

deleteProperty

@ExperimentalApi
public javax.ws.rs.core.Response deleteProperty(String commentId,
                                                                String propertyKey)
Removes the property from the comment identified by the key or by the id. Ths user removing the property is required to have permissions to administer the comment.

Parameters:
commentId - the comment from which the property will be removed.
propertyKey - the key of the property to remove.
Returns:
a 204 HTTP status if everything goes well.


Copyright © 2002-2014 Atlassian. All Rights Reserved.