com.atlassian.confluence.rest.client
Interface RemoteSpaceService

All Known Implementing Classes:
RemoteSpaceServiceImpl

@ExperimentalApi
public interface RemoteSpaceService

SpaceService implementation that communicates with Confluence remotely using the Confluence REST api. Provides future returning equivalents for the methods in SpaceService.


Nested Class Summary
static interface RemoteSpaceService.RemoteSpaceContentFinder
           
static interface RemoteSpaceService.RemoteSpaceFinder
           
static interface RemoteSpaceService.RemoteSpaceSingleFetcher
           
 
Method Summary
 com.atlassian.util.concurrent.Promise<Space> create(Space newSpace, boolean isPrivate)
          Create a new space.
 com.atlassian.util.concurrent.Promise<LongTaskSubmission> delete(Space spaceToDelete)
          Delete the given space.
 RemoteSpaceService.RemoteSpaceFinder find(Expansion... expansions)
           
 RemoteSpaceService.RemoteSpaceContentFinder findContent(Space space, Expansion... expansion)
          Create a finder to find content in the given space.
 com.atlassian.util.concurrent.Promise<com.atlassian.fugue.Option<Space>> getSpace(String spaceKey, Expansion... expansions)
          Deprecated. since 5.6. Use find(Expansion...)
 com.atlassian.util.concurrent.Promise<Space> update(Space space)
          Updates a space.
 SpaceService.Validator validator()
          Get the validator view of the Space Service.
 

Method Detail

create

com.atlassian.util.concurrent.Promise<Space> create(Space newSpace,
                                                    boolean isPrivate)
                                                    throws ServiceException
Create a new space.

Minimum properties to be valid is a key and name.

Parameters:
newSpace - the space to create
isPrivate - true if the space should only be visible to its creator
Returns:
the space created
Throws:
ServiceException - if the space cannot be created

update

com.atlassian.util.concurrent.Promise<Space> update(Space space)
                                                    throws ServiceException
Updates a space.

Currently limited to changing the space name, description and homepage.

Parameters:
space - the updated Space
Returns:
the updated space after being persisted
Throws:
ServiceException

validator

SpaceService.Validator validator()
Get the validator view of the Space Service.


getSpace

@Deprecated
com.atlassian.util.concurrent.Promise<com.atlassian.fugue.Option<Space>> getSpace(String spaceKey,
                                                                                             Expansion... expansions)
Deprecated. since 5.6. Use find(Expansion...)


find

RemoteSpaceService.RemoteSpaceFinder find(Expansion... expansions)

findContent

RemoteSpaceService.RemoteSpaceContentFinder findContent(Space space,
                                                        Expansion... expansion)
Create a finder to find content in the given space. Content will be returned upon calling one of the fetch methods on the returned finder

Parameters:
space - - the space to fetch content for
expansion - - the expansions to apply to the content in this space
Returns:
a new space content finder with the space and expansions set

delete

com.atlassian.util.concurrent.Promise<LongTaskSubmission> delete(Space spaceToDelete)
Delete the given space.

The deletion happens asynchronously so a LongTaskSubmission is returned, that can be used to request status.

Parameters:
spaceToDelete - the space to delete
Returns:
a LongTaskStatus describing the space-removal operation
Throws:
NotFoundException - if the space does not exist or you do not have permission to view it
PermissionException - if you do not have permission to delete the space


Copyright © 2003–2015 Atlassian. All rights reserved.