com.atlassian.confluence.rest.resources
Class DescendantContentResource

java.lang.Object
  extended by com.atlassian.confluence.rest.resources.DescendantContentResource

public class DescendantContentResource
extends java.lang.Object

REST wrapper for the ChildContentService, when Depth is ALL.


Constructor Summary
DescendantContentResource(ChildContentService childContentService)
           
 
Method Summary
 java.util.Map<ContentType,PageResponse<Content>> descendants(ContentId contentId, java.lang.String expand, javax.ws.rs.core.UriInfo uriInfo)
          Returns a map of the descendants of a piece of Content.
 RestList<Content> descendantsOfType(ContentId contentId, ContentType type, java.lang.String expand, int start, int limit, javax.ws.rs.core.UriInfo uriInfo)
          Returns the direct descendants of a piece of Content, limited to a single descendant type.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

DescendantContentResource

public DescendantContentResource(ChildContentService childContentService)
Method Detail

descendants

public java.util.Map<ContentType,PageResponse<Content>> descendants(ContentId contentId,
                                                                    java.lang.String expand,
                                                                    @Context
                                                                    javax.ws.rs.core.UriInfo uriInfo)
                                                             throws ServiceException
Returns a map of the descendants of a piece of Content. Content can have multiple types of descendants - for example a Page can have descendants that are also Pages, but it can also have Comments and Attachments.

The ContentType(s) of the descendants returned is specified by the "expand" query parameter in the request - this parameter can include expands for multiple descendant types.
If no types are included in the expand parameter, the map returned will just list the descendant types that are available to be expanded for the Content referenced by the "id" path parameter.

Currently the only supported descendants are comment descendants of non-comment Content.

Example requests for a page with id "1234":

Parameters:
contentId - - A string containing the id of the content to retrieve descendants for
expand - - a comma separated list of properties to expand on the descendants
Returns:
a JSON Map of the descendants, keyed by their ContentTypes, or a 404 NOT FOUND if there is no content with the given id or if the user is not permitted to see it.
Throws:
ServiceException - if the request cannot be satisfied for any reason

descendantsOfType

public RestList<Content> descendantsOfType(ContentId contentId,
                                           ContentType type,
                                           java.lang.String expand,
                                           int start,
                                           int limit,
                                           @Context
                                           javax.ws.rs.core.UriInfo uriInfo)
                                    throws ServiceException
Returns the direct descendants of a piece of Content, limited to a single descendant type.

The ContentType(s) of the descendants returned is specified by the "type" path parameter in the request.

Currently the only supported descendants are comment descendants of non-comment Content.

Example requests for a page with id "1234":

Parameters:
contentId - - A string containing the id of the content to retrieve descendants for
type - - a ContentType to filter descendants on.
expand - - a comma separated list of properties to expand on the descendants
start - - (optional, default: 0) the index of the first item within the result set that should be returned
limit - - (optional, default: site limit) how many items should be returned after the start index
Returns:
a JSON Map of the descendants, keyed by their ContentTypes, or a 404 NOT FOUND if there is no content with the given id or if the user is not permitted to see it.
Throws:
ServiceException - if the request cannot be satisfied for any reason


Copyright © 2003-2014 Atlassian. All Rights Reserved.