com.atlassian.confluence.rpc.soap.services
Class SpacesSoapService

java.lang.Object
  com.atlassian.confluence.rpc.soap.services.SpacesSoapService

public class SpacesSoapService
extends java.lang.Object

This is the soap service that handles all of the 'space' type methods.

Usually delegated from the ConfluenceSoapServiceImpl.

Constructor Summary

SpacesSoapService()

Method Summary

boolean	addAnonymousUsePermission()
boolean	addAnonymousViewUserProfilePermission()
boolean	addGlobalPermission(java.lang.String permission, java.lang.String remoteEntityName)
boolean	addGlobalPermissions(java.lang.String[] permissions, java.lang.String remoteEntityName)
boolean	addPermissionsToSpace(java.lang.String[] permissions, java.lang.String remoteEntityName, java.lang.String spaceKey)
boolean	addPermissionToSpace(java.lang.String permission, java.lang.String remoteEntityName, java.lang.String spaceKey) Add a given permission for a particular group/user to the given space.
RemoteSpace	addPersonalSpace(RemoteSpace space, java.lang.String username)
RemoteSpace	addSpace(RemoteSpace space)
RemoteSpaceGroup	addSpaceGroup(RemoteSpaceGroup spaceGroup)
boolean	convertToPersonalSpace(java.lang.String userName, java.lang.String spaceKey, java.lang.String newName, boolean updateLinks) Convert a space to a personal space
java.lang.String	exportSpace(java.lang.String spaceKey, java.lang.String exportType)
java.lang.String	exportSpace(java.lang.String spaceKey, java.lang.String exportType, boolean exportAll)
java.lang.String[]	getPermissions(java.lang.String spaceKey) Returns permissions that the logged in user has on the space with the given key.
java.lang.String[]	getPermissions(java.lang.String spaceKey, java.lang.String userName) Returns the permissions that the nominated user has on the space with the given key.
RemoteSpace	getSpace(java.lang.String spaceKey)
RemoteSpaceGroup	getSpaceGroup(java.lang.String spaceGroupKey)
RemoteSpaceGroup[]	getSpaceGroups()
java.lang.String[]	getSpaceLevelPermissions() Get all fine grained Space Level Permissions so that they can be added remotely.
RemoteSpaceSummary[]	getSpaces()
RemoteSpaceSummary[]	getSpacesInGroup(java.lang.String groupKey)
boolean	removeAnonymousUserPermission()
boolean	removeAnonymousViewUserProfilePermission()
boolean	removeGlobalPermission(java.lang.String permission, java.lang.String remoteEntityName) Removes a global permission from the user.
boolean	removePermissionFromSpace(java.lang.String permission, java.lang.String remoteEntityName, java.lang.String spaceKey)
java.lang.Boolean	removeSpace(java.lang.String spaceKey)
boolean	removeSpaceGroup(java.lang.String spaceGroupKey)
void	setAnonymousUserPermissionsService(AnonymousUserPermissionsService anonymousUserPermissionsService)
void	setGateKeeper(GateKeeper gateKeeper)
void	setImportExportManager(ImportExportManager importExportManager)
void	setPageManager(PageManager pageManager)
void	setPermissionManager(PermissionManager permissionManager)
void	setPersonalInformationManager(PersonalInformationManager personalInformationManager)
void	setSetSpacePermissionChecker(SetSpacePermissionChecker setSpacePermissionChecker)
void	setSettingsManager(SettingsManager settingsManager)
void	setSoapServiceHelper(SoapServiceHelper soapServiceHelper)
void	setSpaceGroupManager(SpaceGroupManager spaceGroupManager)
void	setSpaceManager(SpaceManager spaceManager)
void	setSpacePermissionManager(SpacePermissionManager spacePermissionManager)
void	setUserAccessor(UserAccessor userAccessor)
void	setWikiStyleRenderer(com.atlassian.renderer.WikiStyleRenderer wikiStyleRenderer)
RemoteSpace	storeSpace(RemoteSpace remoteSpace)
protected void	verifyPersonalSpaceCreation(com.atlassian.user.User user) Perform checking that a personal space for a user may be created

Methods inherited from class java.lang.Object

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

Constructor Detail

SpacesSoapService

public SpacesSoapService()

Method Detail

setUserAccessor

public void setUserAccessor(UserAccessor userAccessor)

setSpaceManager

public void setSpaceManager(SpaceManager spaceManager)

setPermissionManager

public void setPermissionManager(PermissionManager permissionManager)

setWikiStyleRenderer

public void setWikiStyleRenderer(com.atlassian.renderer.WikiStyleRenderer wikiStyleRenderer)

setSoapServiceHelper

public void setSoapServiceHelper(SoapServiceHelper soapServiceHelper)

setSpacePermissionManager

public void setSpacePermissionManager(SpacePermissionManager spacePermissionManager)

setPersonalInformationManager

public void setPersonalInformationManager(PersonalInformationManager personalInformationManager)

setPageManager

public void setPageManager(PageManager pageManager)

getSpaces

public RemoteSpaceSummary[] getSpaces()
                               throws RemoteException

Throws:

RemoteException

getSpacesInGroup

public RemoteSpaceSummary[] getSpacesInGroup(java.lang.String groupKey)
                                      throws RemoteException

Throws:

RemoteException

getSpace

public RemoteSpace getSpace(java.lang.String spaceKey)
                     throws RemoteException

Throws:

RemoteException

getPermissions

public java.lang.String[] getPermissions(java.lang.String spaceKey)
                                  throws RemoteException

Returns permissions that the logged in user has on the space with the given key.

Throws:

RemoteException

getPermissions

public java.lang.String[] getPermissions(java.lang.String spaceKey,
                                         java.lang.String userName)
                                  throws RemoteException

Returns the permissions that the nominated user has on the space with the given key.

Throws:

RemoteException

addSpace

public RemoteSpace addSpace(RemoteSpace space)
                     throws RemoteException

Throws:

RemoteException

storeSpace

public RemoteSpace storeSpace(RemoteSpace remoteSpace)
                       throws RemoteException

Throws:

RemoteException

addSpaceGroup

public RemoteSpaceGroup addSpaceGroup(RemoteSpaceGroup spaceGroup)
                               throws RemoteException

Throws:

RemoteException

getSpaceGroup

public RemoteSpaceGroup getSpaceGroup(java.lang.String spaceGroupKey)
                               throws RemoteException

Throws:

RemoteException

getSpaceGroups

public RemoteSpaceGroup[] getSpaceGroups()
                                  throws RemoteException

Throws:

RemoteException

removeSpaceGroup

public boolean removeSpaceGroup(java.lang.String spaceGroupKey)
                         throws RemoteException

Throws:

RemoteException

verifyPersonalSpaceCreation

protected void verifyPersonalSpaceCreation(com.atlassian.user.User user)
                                    throws NotPermittedException,
                                           AlreadyExistsException

Perform checking that a personal space for a user may be created

Parameters:

user - The owner of the personal space

Throws:

NotPermittedException - The current principal may not create a personal space for the user

AlreadyExistsException - A personal space already exists for the user

addPersonalSpace

public RemoteSpace addPersonalSpace(RemoteSpace space,
                                    java.lang.String username)
                             throws RemoteException

Throws:

RemoteException

convertToPersonalSpace

public boolean convertToPersonalSpace(java.lang.String userName,
                                      java.lang.String spaceKey,
                                      java.lang.String newName,
                                      boolean updateLinks)
                               throws RemoteException

Convert a space to a personal space

Parameters:

userName - User name of user to create a personal space for

spaceKey - The key of the space to convert

newName - The new name of the space once it has been converted. If null or empty, the name will be unchanged.

updateLinks - Update links in the space after conversion

Returns:

true if successful

Throws:

RemoteException

getSpaceLevelPermissions

public java.lang.String[] getSpaceLevelPermissions()
                                            throws RemoteException

Get all fine grained Space Level Permissions so that they can be added remotely. RETURNS a string array containing the following elements. VIEWSPACE_PERMISSION COMMENT_PERMISSION EDITSPACE SETSPACEPERMISSIONS REMOVEPAGE REMOVECOMMENT REMOVEBLOG CREATEATTACHMENT REMOVEATTACHMENT EDITBLOG EXPORTPAGE EXPORTSPACE REMOVEMAIL

Throws:

RemoteException

addPermissionToSpace

public boolean addPermissionToSpace(java.lang.String permission,
                                    java.lang.String remoteEntityName,
                                    java.lang.String spaceKey)
                             throws RemoteException

Add a given permission for a particular group/user to the given space. Assumption : Users and groups cannot have the same name.

Parameters:

permission - is the Permission that is to be added to the space

remoteEntityName - is either a group or a user name or null for anonymous permissions

spaceKey - is the key of the space for which the given permission is to be added to the given given group/user

Throws:

RemoteException - if space is null or authenticated user does not not have A ADMINISTRATE SPACE permission or if null entity is specified or if no valid entity i.e group/user exist with the given name

addGlobalPermissions

public boolean addGlobalPermissions(java.lang.String[] permissions,
                                    java.lang.String remoteEntityName)
                             throws RemoteException

Throws:

RemoteException

addGlobalPermission

public boolean addGlobalPermission(java.lang.String permission,
                                   java.lang.String remoteEntityName)
                            throws RemoteException

Throws:

RemoteException

addAnonymousUsePermission

public boolean addAnonymousUsePermission()
                                  throws RemoteException

Throws:

RemoteException

removeAnonymousUserPermission

public boolean removeAnonymousUserPermission()
                                      throws RemoteException

Throws:

RemoteException

addAnonymousViewUserProfilePermission

public boolean addAnonymousViewUserProfilePermission()
                                              throws RemoteException

Throws:

RemoteException

removeAnonymousViewUserProfilePermission

public boolean removeAnonymousViewUserProfilePermission()
                                                 throws RemoteException

Throws:

RemoteException

removeGlobalPermission

public boolean removeGlobalPermission(java.lang.String permission,
                                      java.lang.String remoteEntityName)
                               throws NotPermittedException,
                                      RemoteException

Removes a global permission from the user.

Throws:

NotPermittedException - if you are not permitted to remove this permission from the user with remoteEntityName

RemoteException

addPermissionsToSpace

public boolean addPermissionsToSpace(java.lang.String[] permissions,
                                     java.lang.String remoteEntityName,
                                     java.lang.String spaceKey)
                              throws RemoteException,
                                     NotPermittedException

Parameters:

permissions -

remoteEntityName - is either a group or a user name or null for anonymous permissions

spaceKey -

Returns:

Throws:

RemoteException

NotPermittedException

removePermissionFromSpace

public boolean removePermissionFromSpace(java.lang.String permission,
                                         java.lang.String remoteEntityName,
                                         java.lang.String spaceKey)
                                  throws NotPermittedException,
                                         RemoteException

Throws:

NotPermittedException

RemoteException

removeSpace

public java.lang.Boolean removeSpace(java.lang.String spaceKey)
                              throws RemoteException

Throws:

RemoteException

exportSpace

public java.lang.String exportSpace(java.lang.String spaceKey,
                                    java.lang.String exportType)
                             throws RemoteException

Throws:

RemoteException

exportSpace

public java.lang.String exportSpace(java.lang.String spaceKey,
                                    java.lang.String exportType,
                                    boolean exportAll)
                             throws RemoteException

Throws:

RemoteException

setImportExportManager

public void setImportExportManager(ImportExportManager importExportManager)

setGateKeeper

public void setGateKeeper(GateKeeper gateKeeper)

setSettingsManager

public void setSettingsManager(SettingsManager settingsManager)

setSpaceGroupManager

public void setSpaceGroupManager(SpaceGroupManager spaceGroupManager)

setSetSpacePermissionChecker

public void setSetSpacePermissionChecker(SetSpacePermissionChecker setSpacePermissionChecker)

setAnonymousUserPermissionsService

public void setAnonymousUserPermissionsService(AnonymousUserPermissionsService anonymousUserPermissionsService)