com.atlassian.confluence.api.impl.service.content

Class SpaceServiceImpl

java.lang.Object

com.atlassian.confluence.api.impl.service.content.SpaceServiceImpl

All Implemented Interfaces:

SpaceService

public class SpaceServiceImpl
extends Object
implements SpaceService

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	SpaceServiceImpl.SpaceContentImpl
class	SpaceServiceImpl.SpaceFinderImpl
class	SpaceServiceImpl.ValidatorImpl

Nested classes/interfaces inherited from interface com.atlassian.confluence.api.service.content.SpaceService

SpaceService.SingleSpaceFetcher, SpaceService.SpaceContentFinder, SpaceService.SpaceFinder, SpaceService.Validator

Constructor Summary

Constructors

Constructor and Description

SpaceServiceImpl(SpaceManagerInternal spaceManager, SpaceFactory spaceFactory, PageManagerInternal pageManager, ContentFactory contentFactory, PaginationService paginationService, PermissionManager permissionManager, ContentService contentService, SpacePermissionManager spacePermissionManager, LongRunningTaskManager longRunningTaskManager, LongTaskFactory longTaskFactory, I18NBeanFactory i18NBeanFactory, FinderProxyFactory finderProxyFactory, LabelManager labelManager, UserChecker userChecker)

Method Summary

Modifier and Type	Method and Description
Space	create(Space space, boolean isPrivate) Create a new space.
LongTaskSubmission	delete(Space spaceToDelete) Delete the given space.
SpaceService.SpaceFinder	find(Expansion... expansions) Create a space finder to locate spaces, the expansions will be applied to each Space matching the restrictions on the finder.
SpaceService.SpaceContentFinder	findContent(Space space, Expansion... expansions) A finder to locate content in the space
com.atlassian.fugue.Option<Space>	getSpace(String spaceKey, Expansion... expansions) Deprecated. Since 5.5 use find().withKey(String).fetchOne();
Space	update(Space space) Updates a space.
SpaceServiceImpl.ValidatorImpl	validator() Get the validator view of the Space Service.

Methods inherited from class java.lang.Object

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

Constructor Detail

SpaceServiceImpl

public SpaceServiceImpl(SpaceManagerInternal spaceManager,
                        SpaceFactory spaceFactory,
                        PageManagerInternal pageManager,
                        ContentFactory contentFactory,
                        PaginationService paginationService,
                        PermissionManager permissionManager,
                        ContentService contentService,
                        SpacePermissionManager spacePermissionManager,
                        LongRunningTaskManager longRunningTaskManager,
                        LongTaskFactory longTaskFactory,
                        I18NBeanFactory i18NBeanFactory,
                        FinderProxyFactory finderProxyFactory,
                        LabelManager labelManager,
                        UserChecker userChecker)

Method Detail

create

public Space create(Space space,
                    boolean isPrivate)
             throws ServiceException

Description copied from interface: SpaceService

Create a new space.

If the "isPrivate" flag is set to true the new space will only be visible to the creator.

Minimum properties to be valid is a key and name.

Specified by:

create in interface SpaceService

Parameters:

space - the space to create

isPrivate - whether the space is private (true) or has default permissions (false)

Returns:

the space created

Throws:

ServiceException - if the space cannot be created

delete

public LongTaskSubmission delete(Space spaceToDelete)
                          throws ServiceException

Description copied from interface: SpaceService

Delete the given space.

The deletion happens asynchronously so a LongTaskStatus is returned, that can be used to track progress.

Specified by:

delete in interface SpaceService

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

ServiceException

find

public SpaceService.SpaceFinder find(Expansion... expansions)

Description copied from interface: SpaceService

Create a space finder to locate spaces, the expansions will be applied to each Space matching the restrictions on the finder. Restrictions can be applied to the finder using the appropriate withFoo() method

For example:

  spaceService.find()
      .withKeys("DEV","PROD")
      .fetchMany(new SimplePageRequest(0, 10);
 
 

Specified by:

find in interface SpaceService

Parameters:

expansions - - the expansion to apply to each fetched space

Returns:

a new SpaceFinder

update

public Space update(Space space)
             throws ServiceException

Description copied from interface: SpaceService

Updates a space.

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

Specified by:

update in interface SpaceService

Parameters:

space - the updated Space

Returns:

the updated space after being persisted

Throws:

ServiceException

validator

public SpaceServiceImpl.ValidatorImpl validator()

Description copied from interface: SpaceService

Get the validator view of the Space Service.

Specified by:

validator in interface SpaceService

findContent

public SpaceService.SpaceContentFinder findContent(Space space,
                                                   Expansion... expansions)
                                            throws NotFoundException

Description copied from interface: SpaceService

A finder to locate content in the space

Specified by:

findContent in interface SpaceService

Returns:

Throws:

NotFoundException - if the space does not exist or you do not have permission to view it

getSpace

@Deprecated
public com.atlassian.fugue.Option<Space> getSpace(String spaceKey,
                                                              Expansion... expansions)

Deprecated. Since 5.5 use find().withKey(String).fetchOne();

Description copied from interface: SpaceService

Retrieve a space with the given spacekey. A space key uniquely identifies a space.

Specified by:

getSpace in interface SpaceService

Parameters:

spaceKey - - the space key of the space

Returns:

an Option of the space with the given key if one exists.