com.atlassian.confluence.plugins.rest.manager
Interface RestSpaceManager

All Known Implementing Classes:
DefaultRestSpaceManager

public interface RestSpaceManager

Responsible for managing SpaceEntity objects.


Method Summary
 SpaceEntity expand(SpaceEntity spaceEntity)
          Expands and returns the given SpaceEntity.
 SpaceEntity getSpaceEntity(String spaceKey, boolean expand)
          Gets the SpaceEntity for the given spaceKey and expands it if necessary.
 SpaceEntityList getSpaceEntityList(SpaceEntityListContext ctx)
          Gets the SpaceEntityList for the given SpaceEntityListContext.
 

Method Detail

getSpaceEntity

SpaceEntity getSpaceEntity(String spaceKey,
                           boolean expand)
Gets the SpaceEntity for the given spaceKey and expands it if necessary. It is responsible for doing any permission checking and conversion from Confluence's Space to a SpaceEntity. null is returned, if the current user is not permitted to view the space.

Parameters:
spaceKey - the space key of the space to retrieve
expand - whether to expand the space entity

getSpaceEntityList

SpaceEntityList getSpaceEntityList(SpaceEntityListContext ctx)
Gets the SpaceEntityList for the given SpaceEntityListContext. It is up to the implementation to decide on default behaviour when values for in the context are not specified. The context passed in however, must not be null.

Parameters:
ctx - the context for which the space entity list is retrieved in

expand

SpaceEntity expand(SpaceEntity spaceEntity)
Expands and returns the given SpaceEntity.

Parameters:
spaceEntity - the space entity to expand
Returns:
the expanded space entity


Copyright © 2003-2013 Atlassian. All Rights Reserved.