com.atlassian.confluence.rpc.soap
Class ConfluenceSoapServiceDelegator

java.lang.Object
  extended by com.atlassian.confluence.rpc.soap.ConfluenceSoapServiceDelegator
All Implemented Interfaces:
SecureRpc, ConfluenceSoapService

public class ConfluenceSoapServiceDelegator
extends Object
implements ConfluenceSoapService


Field Summary
 
Fields inherited from interface com.atlassian.confluence.rpc.soap.ConfluenceSoapService
ADMIN_SPACE_PERMISSION, COMMENT_PERMISSION, MODIFY_PERMISSION, VIEW_PERMISSION
 
Constructor Summary
ConfluenceSoapServiceDelegator()
           
 
Method Summary
 boolean addAnonymousPermissionsToSpace(String token, String[] permissions, String spaceKey)
          Add Space Permissions for anonymous users
 boolean addAnonymousPermissionToSpace(String token, String permission, String spaceKey)
          Add a Space Permission for anonymous users
 boolean addAnonymousUsePermission(String token)
           
 boolean addAnonymousViewUserProfilePermission(String token)
          This permission can only be set if the anonymous user already has 'use' permission.
 RemoteAttachment addAttachment(String token, long contentId, RemoteAttachment attachment, byte[] attachmentData)
          Add a new attachment to a ContentEntityObject.
 RemoteAttachment addAttachment(String token, RemoteAttachment attachment, byte[] attachmentData)
          Deprecated. available for backward compatibility.
 RemoteComment addComment(String token, RemoteComment comment)
          Adds a comment to a page or blog post
 boolean addGlobalPermission(String token, String permission, String remoteEntityName)
          Add global permissions for a user or group
 boolean addGlobalPermissions(String token, String[] permissions, String remoteEntityName)
          Add a global permission for a user or group
 boolean addGroup(String token, String groupname)
          Adds a new group
 boolean addLabelById(String token, long labelId, long objectId)
          Adds a label with the given ID to the object with the given ContentEntityObject ID.
 boolean addLabelByName(String token, String labelName, long objectId)
          Adds a label to the object with the given ContentEntityObject ID.
 boolean addLabelByNameToSpace(String token, String labelName, String spaceKey)
          Adds a label to the object with the given ContentEntityObject ID.
 boolean addLabelByObject(String token, RemoteLabel labelObject, long objectId)
          Adds the given label object to the object with the given ContentEntityObject ID.
 boolean addPermissionsToSpace(String token, String[] permissions, String remoteEntityName, String spaceKey)
          Add Space Permissions for a user or group
 boolean addPermissionToSpace(String token, String permission, String remoteEntityName, String spaceKey)
          Add a Space Permission for a user or group
 RemoteSpace addPersonalSpace(String token, RemoteSpace space, String username)
           
 boolean addProfilePicture(String token, String userName, String fileName, String mimeType, byte[] pictureData)
          Add a profile picture to a user's profile
 RemoteSpace addSpace(String token, RemoteSpace space)
           
 RemoteSpaceGroup addSpaceGroup(String token, RemoteSpaceGroup spaceGroup)
          Add a space Group to Confluence
 void addUser(String token, RemoteUser remoteUser, String password)
          Adds a user with the given RemoteUser object and password
 boolean addUserToGroup(String token, String username, String groupname)
           
 boolean changeMyPassword(String token, String oldPass, String newPass)
          Change the current user's password
 boolean changeUserPassword(String token, String username, String newPass)
          Change a user's password
 boolean clearIndexQueue(String token)
           
 boolean convertToPersonalSpace(String token, String userName, String spaceKey, String newName, boolean updateLinks)
           
 boolean deactivateUser(String token, String username)
          Deactivates the given user
 RemoteComment editComment(String token, RemoteComment comment)
          Updates a comment
 boolean editUser(String token, RemoteUser remoteUser)
          Edits a user with the values in the given RemoteUser object

Currently this will only update the user's full name and email

 String exportSite(String token, boolean exportAttachments)
           
 String exportSpace(String token, String spaceKey, String exportType)
           
 String exportSpace(String token, String spaceKey, String exportType, boolean exportAll)
           
 boolean flushIndexQueue(String token)
           
 String[] getActiveUsers(String token, boolean viewAll)
          Returns a list of the current system users
 RemotePageSummary[] getAncestors(String token, long pageId)
          Returns all direct ancestor pages of the page with the given pageId the user authenticated by token is allowed to view.
 RemoteAttachment getAttachment(String token, long entityId, String fileName, int version)
          Retrieve information about an attachment.
 byte[] getAttachmentData(String token, long entityId, String fileName, int version)
          Retrieve the contents of an attachment.
 RemoteAttachment[] getAttachments(String token, long pageId)
           
 RemoteBlogEntrySummary[] getBlogEntries(String token, String spaceKey)
           
 RemoteBlogEntry getBlogEntry(String token, long entryId)
           
 RemoteBlogEntry getBlogEntryByDayAndTitle(String token, String spaceKey, int dayOfMonth, String postTitle)
          Retrieves a blog post in the Space with the given spaceKey, with the title 'postTitle' and posted on the day 'dayOfMonth'
 RemotePageSummary[] getChildren(String token, long pageId)
          Returns all child pages of the page with the given pageId the user authenticated by token is allowed to view.
 RemoteClusterInformation getClusterInformation(String token)
           
 RemoteNodeStatus[] getClusterNodeStatuses(String token)
           
 RemoteComment getComment(String token, long commentId)
          Retrieves a comment with the given ID
 RemoteComment[] getComments(String token, long pageId)
          Retrieves the comments for a given abstract page
 RemoteContentPermissionSet getContentPermissionSet(String token, long contentId, String permissionType)
          Get the content permission set of a certain type for a particular piece of content
 RemoteContentPermissionSet[] getContentPermissionSets(String token, long contentId)
          Get the content permission sets for a particular piece of content
 RemotePageSummary[] getDescendents(String token, long pageId)
          Returns all descendent pages of the page with the given pageId the user authenticated by token is allowed to view.
 String[] getGroups(String token)
          Retrieves a list of user groups
 RemoteSearchResult[] getLabelContentById(String token, long labelId)
          Returns the content for a given label ID
 RemoteSearchResult[] getLabelContentByName(String token, String labelName)
          Returns the content for a given label name
 RemoteSearchResult[] getLabelContentByObject(String token, RemoteLabel labelObject)
          Returns the content for a given label object
 RemoteLabel[] getLabelsByDetail(String token, String labelName, String namespace, String spaceKey, String owner)
          Retrieves the labels matching the given labelName, namespace or owner.
 RemoteLabel[] getLabelsById(String token, long objectId)
          Returns all labels for the given ContentEntityObject ID.
 RemoteLabel[] getMostPopularLabels(String token, int maxCount)
          Returns the most popular labels for the Confluence instance, with a specified maximum number of results.
 RemoteLabel[] getMostPopularLabelsInSpace(String token, String spaceKey, int maxCount)
          Returns the most popular labels for the given spaceKey, with a specified maximum number of results.
 RemotePage getPage(String token, long pageId)
           
 RemotePage getPage(String token, String spaceKey, String pageTitle)
           
 RemotePageHistory[] getPageHistory(String token, long pageId)
           
 RemotePermission[] getPagePermissions(String token, long pageId)
           
 RemotePageSummary[] getPages(String token, String spaceKey)
          Returns all pages of the space with the given spaceKey the user authenticated by token is allowed to view.
 String[] getPermissions(String token, String spaceKey)
           
 String[] getPermissionsForUser(String token, String spaceKey, String userName)
           
 RemoteLabel[] getRecentlyUsedLabels(String token, int maxResults)
          Returns the recently used labels for the Confluence instance, with a specified maximum number of results.
 RemoteLabel[] getRecentlyUsedLabelsInSpace(String token, String spaceKey, int maxResults)
          Returns the recently used labels for the given spaceKey, with a specified maximum number of results.
 RemoteLabel[] getRelatedLabels(String token, String labelName, int maxResults)
          Returns the labels related to the given label name, with a specified maximum number of results.
 RemoteLabel[] getRelatedLabelsInSpace(String token, String labelName, String spaceKey, int maxResults)
          Returns the labels related to the given label name for the given spaceKey, with a specified maximum number of results.
 RemoteServerInfo getServerInfo(String token)
           
 RemoteSpace getSpace(String token, String spaceKey)
           
 RemoteSpaceGroup getSpaceGroup(String token, String spaceGroup)
           
 RemoteSpaceGroup[] getSpaceGroups(String token)
           
 String[] getSpaceLevelPermissions(String token)
           
 RemoteSpaceSummary[] getSpaces(String token)
           
 RemoteSpace[] getSpacesContainingContentWithLabel(String token, String labelName)
          Returns all Spaces that have content labelled with labelName
 RemoteSpaceSummary[] getSpacesInGroup(String token, String spaceGroupKey)
           
 RemoteSpace[] getSpacesWithLabel(String token, String labelName)
          Returns an array of Spaces that have been labelled with labelName
 RemotePageSummary[] getTopLevelPages(String token, String spaceKey)
          Returns all top level pages of the space with the given spaceKey the user authenticated by token is allowed to view.
 RemoteUser getUser(String token, String username)
          Retrieves a user with the given username
 String[] getUserGroups(String token, String username)
          Retrieves the groups that a given user belongs to
 RemoteUserInformation getUserInformation(String token, String username)
          Retrieves a user's information
 boolean hasGroup(String token, String groupname)
          Determines whether a group exists
 boolean hasUser(String token, String username)
          Determines whether a user exists
 boolean importSpace(String token, byte[] importData)
          Import a space in a compressed XML format
 boolean installPlugin(String token, String pluginFileName, byte[] pluginData)
          Installs a plugin.
 boolean isPluginEnabled(String token, String pluginKey)
          Returns true if the specified plugin is enabled.
 String login(String username, String password)
           
 boolean logout(String token)
           
 boolean moveAttachment(String token, long originalContentId, String originalFileName, long newContentId, String newFileName)
          Move or rename an attachment
 Boolean movePage(String token, long sourcePageId, long targetPageId, String position)
           
 Boolean movePageToTopLevel(String token, long pageId, String targetSpaceKey)
           
 boolean reactivateUser(String token, String username)
          Reactivates the given user
 boolean removeAllPermissionsForGroup(String token, String groupname)
          Deletes all global and space permissions for the given group
 boolean removeAnonymousPermissionFromSpace(String token, String permission, String spaceKey)
          Removes a Space Permission for anonymous users
 boolean removeAnonymousUsePermission(String token)
          Remove anonymous use permission.
 boolean removeAnonymousViewUserProfilePermission(String token)
           
 boolean removeAttachment(String token, long contentId, String fileName)
          Remove an attachment.
 boolean removeComment(String token, long commentId)
          Removes a comment with the given ID
 boolean removeGlobalPermission(String token, String permission, String remoteEntityName)
          Remove a global permission
 boolean removeGroup(String token, String groupname, String defaultGroupName)
          Removes an existing group

If a valid defaultGroupName is specified, users will be added to the new group (defaultGroupName).

 boolean removeLabelById(String token, long labelId, long objectId)
          Removes the label with the given ID from the object with the given ContentEntityObject ID.
 boolean removeLabelByName(String token, String labelName, long objectId)
          Removes the given label from the object with the given ContentEntityObject ID.
 boolean removeLabelByNameFromSpace(String token, String labelName, String spaceKey)
          Removes the given label from the given Space
 boolean removeLabelByObject(String token, RemoteLabel labelObject, long objectId)
          Removes the given label object from the object with the given ContentEntityObject ID.
 Boolean removePage(String token, long pageId)
           
 boolean removePermissionFromSpace(String token, String permission, String remoteEntityName, String spaceKey)
          Removes a Space Permission for a user or group
 Boolean removeSpace(String token, String spaceKey)
           
 boolean removeSpaceGroup(String token, String spaceGroupKey)
          Removes a Space Group from Confluence without removeing the space it contains.
 boolean removeUser(String token, String username)
          Removes a user with the given username
 boolean removeUserFromGroup(String token, String username, String groupname)
          Removes the given user from a group
 String renderContent(String token, String spaceKey, long pageId, String newContent)
           
 String renderContent(String token, String spaceKey, long pageId, String newContent, Map renderParameters)
           
 RemoteSearchResult[] search(String token, String query, int maxResults)
           Search Confluence for the supplied query String.
 RemoteSearchResult[] search(String token, String query, Map params, int maxResults)
           Search Confluence for the supplied query String.
 boolean setContentPermissions(String token, long contentId, String permissionType, RemoteContentPermission[] remoteContentPermissions)
          Set the content permissions for a particular permission type on some content.
 boolean setEnableAnonymousAccess(String token, boolean value)
           
 boolean setEnableWysiwyg(String token, boolean value)
           
 void setSoapServiceDelegator(ConfluenceSoapService soapServiceDelegator)
           
 boolean setUserInformation(String token, RemoteUserInformation userInfo)
          Updates a user's information

Currently this will only update a user's "description", stored in the 'content' attribute

 RemoteBlogEntry storeBlogEntry(String token, RemoteBlogEntry blogEntry)
           
 RemotePage storePage(String token, RemotePage page)
           
 RemoteSpace storeSpace(String token, RemoteSpace remoteSpace)
          Allows for modifying space details via the remote API.
 RemotePage updatePage(String token, RemotePage page, RemotePageUpdateOptions options)
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ConfluenceSoapServiceDelegator

public ConfluenceSoapServiceDelegator()
Method Detail

login

public String login(String username,
                    String password)
             throws AuthenticationFailedException,
                    RemoteException
Specified by:
login in interface SecureRpc
Specified by:
login in interface ConfluenceSoapService
Throws:
AuthenticationFailedException
RemoteException

logout

public boolean logout(String token)
               throws RemoteException
Specified by:
logout in interface SecureRpc
Specified by:
logout in interface ConfluenceSoapService
Throws:
RemoteException

getSpaces

public RemoteSpaceSummary[] getSpaces(String token)
                               throws InvalidSessionException,
                                      RemoteException
Specified by:
getSpaces in interface ConfluenceSoapService
Throws:
InvalidSessionException
RemoteException

getSpacesInGroup

public RemoteSpaceSummary[] getSpacesInGroup(String token,
                                             String spaceGroupKey)
                                      throws RemoteException
Specified by:
getSpacesInGroup in interface ConfluenceSoapService
Throws:
RemoteException

addSpace

public RemoteSpace addSpace(String token,
                            RemoteSpace space)
                     throws NotPermittedException,
                            InvalidSessionException,
                            AlreadyExistsException,
                            RemoteException
Specified by:
addSpace in interface ConfluenceSoapService
Throws:
NotPermittedException
InvalidSessionException
AlreadyExistsException
RemoteException

storeSpace

public RemoteSpace storeSpace(String token,
                              RemoteSpace remoteSpace)
                       throws RemoteException
Description copied from interface: ConfluenceSoapService
Allows for modifying space details via the remote API. Currently you can update the following space properties:

addSpaceGroup

public RemoteSpaceGroup addSpaceGroup(String token,
                                      RemoteSpaceGroup spaceGroup)
                               throws NotPermittedException,
                                      InvalidSessionException,
                                      AlreadyExistsException,
                                      RemoteException
Description copied from interface: ConfluenceSoapService
Add a space Group to Confluence

Specified by:
addSpaceGroup in interface ConfluenceSoapService
Parameters:
token - the authentication token
spaceGroup - the spacegroup to add
Returns:
Throws:
NotPermittedException - if the user lacks permissions to perform the action
InvalidSessionException
AlreadyExistsException - if a group with the same key already exists
RemoteException

getSpaceGroup

public RemoteSpaceGroup getSpaceGroup(String token,
                                      String spaceGroup)
                               throws NotPermittedException,
                                      InvalidSessionException,
                                      AlreadyExistsException,
                                      RemoteException
Specified by:
getSpaceGroup in interface ConfluenceSoapService
Throws:
NotPermittedException
InvalidSessionException
AlreadyExistsException
RemoteException

getSpaceGroups

public RemoteSpaceGroup[] getSpaceGroups(String token)
                                  throws InvalidSessionException,
                                         RemoteException
Specified by:
getSpaceGroups in interface ConfluenceSoapService
Throws:
InvalidSessionException
RemoteException

removeSpaceGroup

public boolean removeSpaceGroup(String token,
                                String spaceGroupKey)
                         throws RemoteException
Description copied from interface: ConfluenceSoapService
Removes a Space Group from Confluence without removeing the space it contains. Currently requires global administration rights

Specified by:
removeSpaceGroup in interface ConfluenceSoapService
Parameters:
token - the authentication token
spaceGroupKey - the id of the spacegroup to be removed
Returns:
Throws:
RemoteException

addPersonalSpace

public RemoteSpace addPersonalSpace(String token,
                                    RemoteSpace space,
                                    String username)
                             throws NotPermittedException,
                                    InvalidSessionException,
                                    AlreadyExistsException,
                                    RemoteException
Specified by:
addPersonalSpace in interface ConfluenceSoapService
Throws:
NotPermittedException
InvalidSessionException
AlreadyExistsException
RemoteException

convertToPersonalSpace

public boolean convertToPersonalSpace(String token,
                                      String userName,
                                      String spaceKey,
                                      String newName,
                                      boolean updateLinks)
                               throws RemoteException
Specified by:
convertToPersonalSpace in interface ConfluenceSoapService
Throws:
RemoteException

removeSpace

public Boolean removeSpace(String token,
                           String spaceKey)
                    throws NotPermittedException,
                           InvalidSessionException,
                           RemoteException
Specified by:
removeSpace in interface ConfluenceSoapService
Throws:
NotPermittedException
InvalidSessionException
RemoteException

getSpace

public RemoteSpace getSpace(String token,
                            String spaceKey)
                     throws InvalidSessionException,
                            RemoteException
Specified by:
getSpace in interface ConfluenceSoapService
Throws:
InvalidSessionException
RemoteException

getPermissions

public String[] getPermissions(String token,
                               String spaceKey)
                        throws InvalidSessionException,
                               RemoteException
Specified by:
getPermissions in interface ConfluenceSoapService
Throws:
InvalidSessionException
RemoteException

getPermissionsForUser

public String[] getPermissionsForUser(String token,
                                      String spaceKey,
                                      String userName)
                               throws InvalidSessionException,
                                      RemoteException
Specified by:
getPermissionsForUser in interface ConfluenceSoapService
Throws:
InvalidSessionException
RemoteException

addPermissionToSpace

public boolean addPermissionToSpace(String token,
                                    String permission,
                                    String remoteEntityName,
                                    String spaceKey)
                             throws RemoteException
Description copied from interface: ConfluenceSoapService
Add a Space Permission for a user or group

Specified by:
addPermissionToSpace in interface ConfluenceSoapService
Parameters:
token - the authentication token
permission - the Space Permission to add
remoteEntityName - the name of the user or group
spaceKey - the key of the Space affected by this action
Returns:
True if successful, false otherwise
Throws:
RemoteException - if the Space Permission is null
NotPermittedException - if the user lacks permissions to perform the action

addPermissionsToSpace

public boolean addPermissionsToSpace(String token,
                                     String[] permissions,
                                     String remoteEntityName,
                                     String spaceKey)
                              throws RemoteException
Description copied from interface: ConfluenceSoapService
Add Space Permissions for a user or group

Specified by:
addPermissionsToSpace in interface ConfluenceSoapService
Parameters:
token - the authentication token
permissions - the Space Permissions to add
remoteEntityName - the name of the user or group
spaceKey - the key of the Space affected by this action
Returns:
True if successful, false otherwise
Throws:
RemoteException - if the Space Permissions array is null
NotPermittedException - if the user lacks permissions to perform the action

removePermissionFromSpace

public boolean removePermissionFromSpace(String token,
                                         String permission,
                                         String remoteEntityName,
                                         String spaceKey)
                                  throws NotPermittedException,
                                         RemoteException
Description copied from interface: ConfluenceSoapService
Removes a Space Permission for a user or group

Specified by:
removePermissionFromSpace in interface ConfluenceSoapService
Parameters:
token - the authentication token
permission - the Space Permission to remove
remoteEntityName - the name of the user or group
spaceKey - the key of the Space affected by this action
Returns:
True if successful, false otherwise
Throws:
NotPermittedException - if the user lacks permissions to perform the action
RemoteException - if the Space does not exist

addAnonymousPermissionToSpace

public boolean addAnonymousPermissionToSpace(String token,
                                             String permission,
                                             String spaceKey)
                                      throws RemoteException
Description copied from interface: ConfluenceSoapService
Add a Space Permission for anonymous users

Specified by:
addAnonymousPermissionToSpace in interface ConfluenceSoapService
Parameters:
token - the authentication token
permission - the Space Permission to add
spaceKey - the key of the Space affected by this action
Returns:
True if successful, false otherwise
Throws:
RemoteException - if the Space Permission is null
NotPermittedException - if the user lacks permissions to perform the action

addAnonymousPermissionsToSpace

public boolean addAnonymousPermissionsToSpace(String token,
                                              String[] permissions,
                                              String spaceKey)
                                       throws RemoteException
Description copied from interface: ConfluenceSoapService
Add Space Permissions for anonymous users

Specified by:
addAnonymousPermissionsToSpace in interface ConfluenceSoapService
Parameters:
token - the authentication token
permissions - the Space Permissions to add
spaceKey - the key of the Space affected by this action
Returns:
True if successful, false otherwise
Throws:
RemoteException - if the Space Permissions array is null
NotPermittedException - if the user lacks permissions to perform the action

removeAnonymousPermissionFromSpace

public boolean removeAnonymousPermissionFromSpace(String token,
                                                  String permission,
                                                  String spaceKey)
                                           throws NotPermittedException,
                                                  RemoteException
Description copied from interface: ConfluenceSoapService
Removes a Space Permission for anonymous users

Specified by:
removeAnonymousPermissionFromSpace in interface ConfluenceSoapService
Parameters:
token - the authentication token
permission - the Space Permission to remove
spaceKey - the key of the Space affected by this action
Returns:
True if successful, false otherwise
Throws:
NotPermittedException - if the user lacks permissions to perform the action
RemoteException - if the Space does not exist

getSpaceLevelPermissions

public String[] getSpaceLevelPermissions(String token)
                                  throws RemoteException
Specified by:
getSpaceLevelPermissions in interface ConfluenceSoapService
Throws:
RemoteException

getPages

public RemotePageSummary[] getPages(String token,
                                    String spaceKey)
                             throws InvalidSessionException,
                                    RemoteException
Description copied from interface: ConfluenceSoapService
Returns all pages of the space with the given spaceKey the user authenticated by token is allowed to view. The result is not ordered.

Specified by:
getPages in interface ConfluenceSoapService
Parameters:
token - the authentication token
spaceKey - the key of the space which pages are to be returned
Throws:
InvalidSessionException
RemoteException

getPage

public RemotePage getPage(String token,
                          String spaceKey,
                          String pageTitle)
                   throws InvalidSessionException,
                          RemoteException
Specified by:
getPage in interface ConfluenceSoapService
Throws:
InvalidSessionException
RemoteException

getPage

public RemotePage getPage(String token,
                          long pageId)
                   throws InvalidSessionException,
                          RemoteException
Specified by:
getPage in interface ConfluenceSoapService
Throws:
InvalidSessionException
RemoteException

getComments

public RemoteComment[] getComments(String token,
                                   long pageId)
                            throws InvalidSessionException,
                                   RemoteException
Description copied from interface: ConfluenceSoapService
Retrieves the comments for a given abstract page

Specified by:
getComments in interface ConfluenceSoapService
Parameters:
token - the authentication token
pageId - the content ID of the abstract page
Returns:
RemoteComment object with the comment details
Throws:
InvalidSessionException
RemoteException - if the object for the pageId is null, or the user lacks permissions

getComment

public RemoteComment getComment(String token,
                                long commentId)
                         throws InvalidSessionException,
                                RemoteException
Description copied from interface: ConfluenceSoapService
Retrieves a comment with the given ID

Specified by:
getComment in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
commentId - The ID of the comment to be retrieved
Returns:
A RemoteComment object containing the comment information
Throws:
InvalidSessionException
RemoteException - if the comment cannot be found

addComment

public RemoteComment addComment(String token,
                                RemoteComment comment)
                         throws InvalidSessionException,
                                NotPermittedException,
                                RemoteException
Description copied from interface: ConfluenceSoapService
Adds a comment to a page or blog post

Specified by:
addComment in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
comment - The RemoteComment object containing the comment information
Returns:
RemoteComment object
Throws:
InvalidSessionException
NotPermittedException - if the user is unable to post the comment
RemoteException - if the user does not have permission to view the page the comment is being posted to, or it does not exist

editComment

public RemoteComment editComment(String token,
                                 RemoteComment comment)
                          throws InvalidSessionException,
                                 NotPermittedException,
                                 RemoteException
Description copied from interface: ConfluenceSoapService
Updates a comment

Specified by:
editComment in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
comment - The RemoteComment object containing the comment information
Returns:
RemoteComment object
Throws:
InvalidSessionException
NotPermittedException - if the user is unable to edit the comment
RemoteException - if the user does not have permission to view the page the comment is being posted to, or it does not exist

removeComment

public boolean removeComment(String token,
                             long commentId)
                      throws InvalidSessionException,
                             NotPermittedException,
                             RemoteException
Description copied from interface: ConfluenceSoapService
Removes a comment with the given ID

Specified by:
removeComment in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
commentId - The ID of the comment to remove
Returns:
True if successful, false otherwise
Throws:
InvalidSessionException
NotPermittedException - if the user does not have permission to remove the comment
RemoteException - if the user does not have permission to view the page the comment is on, or it does not exist

getTopLevelPages

public RemotePageSummary[] getTopLevelPages(String token,
                                            String spaceKey)
                                     throws RemoteException
Description copied from interface: ConfluenceSoapService
Returns all top level pages of the space with the given spaceKey the user authenticated by token is allowed to view. The result is ordered by child page order.

Specified by:
getTopLevelPages in interface ConfluenceSoapService
Parameters:
token - the authentication token
spaceKey - the key of the space which pages are to be returned
Throws:
RemoteException

getAncestors

public RemotePageSummary[] getAncestors(String token,
                                        long pageId)
                                 throws InvalidSessionException,
                                        RemoteException
Description copied from interface: ConfluenceSoapService
Returns all direct ancestor pages of the page with the given pageId the user authenticated by token is allowed to view. The result is not ordered.

Specified by:
getAncestors in interface ConfluenceSoapService
Parameters:
token - the authentication token
pageId - the id of the page which child pages are to be returned
Throws:
InvalidSessionException
RemoteException

getChildren

public RemotePageSummary[] getChildren(String token,
                                       long pageId)
                                throws InvalidSessionException,
                                       RemoteException
Description copied from interface: ConfluenceSoapService
Returns all child pages of the page with the given pageId the user authenticated by token is allowed to view. The result is ordered by child page order.

Specified by:
getChildren in interface ConfluenceSoapService
Parameters:
token - the authentication token
pageId - the id of the page which child pages are to be returned
Throws:
InvalidSessionException
RemoteException

getDescendents

public RemotePageSummary[] getDescendents(String token,
                                          long pageId)
                                   throws InvalidSessionException,
                                          RemoteException
Description copied from interface: ConfluenceSoapService
Returns all descendent pages of the page with the given pageId the user authenticated by token is allowed to view. The result is not ordered.

Specified by:
getDescendents in interface ConfluenceSoapService
Parameters:
token - the authentication token
pageId - the id of the page which child pages are to be returned
Throws:
InvalidSessionException
RemoteException

getAttachments

public RemoteAttachment[] getAttachments(String token,
                                         long pageId)
                                  throws InvalidSessionException,
                                         RemoteException
Specified by:
getAttachments in interface ConfluenceSoapService
Throws:
InvalidSessionException
RemoteException

getPageHistory

public RemotePageHistory[] getPageHistory(String token,
                                          long pageId)
                                   throws InvalidSessionException,
                                          RemoteException
Specified by:
getPageHistory in interface ConfluenceSoapService
Throws:
InvalidSessionException
RemoteException

renderContent

public String renderContent(String token,
                            String spaceKey,
                            long pageId,
                            String newContent)
                     throws InvalidSessionException,
                            RemoteException
Specified by:
renderContent in interface ConfluenceSoapService
Throws:
InvalidSessionException
RemoteException

renderContent

public String renderContent(String token,
                            String spaceKey,
                            long pageId,
                            String newContent,
                            Map renderParameters)
                     throws RemoteException
Specified by:
renderContent in interface ConfluenceSoapService
Throws:
RemoteException

addAttachment

public RemoteAttachment addAttachment(String token,
                                      long contentId,
                                      RemoteAttachment attachment,
                                      byte[] attachmentData)
                               throws RemoteException
Description copied from interface: ConfluenceSoapService
Add a new attachment to a ContentEntityObject.

Specified by:
addAttachment in interface ConfluenceSoapService
Parameters:
token - the authentication token
contentId - the id of the ContentEntityObject to receive the new attachment.
attachment - RemoteAttachment object containing attachment information
attachmentData - a byte[] continaing the contents of the attachment.
Returns:
the newly created attachment
Throws:
RemoteException

addAttachment

public RemoteAttachment addAttachment(String token,
                                      RemoteAttachment attachment,
                                      byte[] attachmentData)
                               throws RemoteException
Deprecated. available for backward compatibility.

Specified by:
addAttachment in interface ConfluenceSoapService
Throws:
RemoteException

getAttachment

public RemoteAttachment getAttachment(String token,
                                      long entityId,
                                      String fileName,
                                      int version)
                               throws RemoteException
Description copied from interface: ConfluenceSoapService
Retrieve information about an attachment.

Specified by:
getAttachment in interface ConfluenceSoapService
Parameters:
token - the authentication token.
entityId - the id of the ContentEntityObject the attachemt belongs to.
fileName - the name of the attachment.
version - the version number of the attachment.
Returns:
the attachment
Throws:
RemoteException

getAttachmentData

public byte[] getAttachmentData(String token,
                                long entityId,
                                String fileName,
                                int version)
                         throws RemoteException
Description copied from interface: ConfluenceSoapService
Retrieve the contents of an attachment.

Specified by:
getAttachmentData in interface ConfluenceSoapService
Parameters:
token - the authentication token.
entityId - the id of the ContentEntityObject the attachemt belongs to.
fileName - the name of the attachment.
version - the version number of the attachment.
Returns:
the attachment's data
Throws:
RemoteException

removeAttachment

public boolean removeAttachment(String token,
                                long contentId,
                                String fileName)
                         throws RemoteException
Description copied from interface: ConfluenceSoapService
Remove an attachment.

Specified by:
removeAttachment in interface ConfluenceSoapService
Parameters:
token - the authentication token.
contentId - the id of the ContentEntityObject the attachment belongs to.
fileName - the name of the attachment.
Returns:
true if the attachment was deleted.
Throws:
RemoteException

moveAttachment

public boolean moveAttachment(String token,
                              long originalContentId,
                              String originalFileName,
                              long newContentId,
                              String newFileName)
                       throws RemoteException
Description copied from interface: ConfluenceSoapService
Move or rename an attachment

Specified by:
moveAttachment in interface ConfluenceSoapService
Parameters:
token - the authentication token.
originalContentId - the id of the ContentEntityObject the attachment belongs to.
originalFileName - the name of the attachment.
newContentId - the id of the ContentEntityObject the attachment is to be moved to.
newFileName - the name the attachment is to be renamed to.
Returns:
true
Throws:
RemoteException

storePage

public RemotePage storePage(String token,
                            RemotePage page)
                     throws VersionMismatchException,
                            NotPermittedException,
                            InvalidSessionException,
                            RemoteException
Specified by:
storePage in interface ConfluenceSoapService
Throws:
VersionMismatchException
NotPermittedException
InvalidSessionException
RemoteException

updatePage

public RemotePage updatePage(String token,
                             RemotePage page,
                             RemotePageUpdateOptions options)
                      throws VersionMismatchException,
                             NotPermittedException,
                             InvalidSessionException,
                             RemoteException
Specified by:
updatePage in interface ConfluenceSoapService
Throws:
VersionMismatchException
NotPermittedException
InvalidSessionException
RemoteException

movePageToTopLevel

public Boolean movePageToTopLevel(String token,
                                  long pageId,
                                  String targetSpaceKey)
                           throws RemoteException
Specified by:
movePageToTopLevel in interface ConfluenceSoapService
Throws:
RemoteException

movePage

public Boolean movePage(String token,
                        long sourcePageId,
                        long targetPageId,
                        String position)
                 throws RemoteException
Specified by:
movePage in interface ConfluenceSoapService
Throws:
RemoteException

removePage

public Boolean removePage(String token,
                          long pageId)
                   throws NotPermittedException,
                          InvalidSessionException,
                          RemoteException
Specified by:
removePage in interface ConfluenceSoapService
Throws:
NotPermittedException
InvalidSessionException
RemoteException

search

public RemoteSearchResult[] search(String token,
                                   String query,
                                   int maxResults)
                            throws InvalidSessionException,
                                   RemoteException
Description copied from interface: ConfluenceSoapService

Search Confluence for the supplied query String. Please be sensible in your use of the maxResults parameter. Too large a value will result in this call taking a long time.

Specified by:
search in interface ConfluenceSoapService
Parameters:
token - the authentication token
query - the query term for the search
maxResults - the maximum number of results to be returned.
Returns:
an array of RemoteSearchResults. If there are no results then an empty array will be returned.
Throws:
InvalidSessionException
RemoteException

search

public RemoteSearchResult[] search(String token,
                                   String query,
                                   Map params,
                                   int maxResults)
                            throws RemoteException
Description copied from interface: ConfluenceSoapService

Search Confluence for the supplied query String. Please be sensible in your use of the maxResults parameter.

A Map of search criteria can be specified. The following keys are understood -

Specified by:
search in interface ConfluenceSoapService
Parameters:
token - the authentication token
query - the query term for the search
params - a Map providing criteria to the search.
maxResults - the maximum number of results to be returned.
Returns:
an array of RemoteSearchResults. If there are no results then an empty array will be returned.
Throws:
RemoteException

getBlogEntryByDayAndTitle

public RemoteBlogEntry getBlogEntryByDayAndTitle(String token,
                                                 String spaceKey,
                                                 int dayOfMonth,
                                                 String postTitle)
                                          throws RemoteException
Description copied from interface: ConfluenceSoapService
Retrieves a blog post in the Space with the given spaceKey, with the title 'postTitle' and posted on the day 'dayOfMonth'

Specified by:
getBlogEntryByDayAndTitle in interface ConfluenceSoapService
Parameters:
token - the authentication token
spaceKey - the key of the Space the blog post belongs to
dayOfMonth - the day of the month the blog post was made
postTitle - the title of the blog post
Returns:
A RemoteBlogEntry object
Throws:
RemoteException - if the user does not have permission to view the blog post, or it does not exist

getBlogEntry

public RemoteBlogEntry getBlogEntry(String token,
                                    long entryId)
                             throws RemoteException
Specified by:
getBlogEntry in interface ConfluenceSoapService
Throws:
RemoteException

getBlogEntries

public RemoteBlogEntrySummary[] getBlogEntries(String token,
                                               String spaceKey)
                                        throws InvalidSessionException,
                                               RemoteException
Specified by:
getBlogEntries in interface ConfluenceSoapService
Throws:
InvalidSessionException
RemoteException

storeBlogEntry

public RemoteBlogEntry storeBlogEntry(String token,
                                      RemoteBlogEntry blogEntry)
                               throws VersionMismatchException,
                                      NotPermittedException,
                                      InvalidSessionException,
                                      RemoteException
Specified by:
storeBlogEntry in interface ConfluenceSoapService
Throws:
VersionMismatchException
NotPermittedException
InvalidSessionException
RemoteException

getServerInfo

public RemoteServerInfo getServerInfo(String token)
                               throws InvalidSessionException,
                                      RemoteException
Specified by:
getServerInfo in interface ConfluenceSoapService
Throws:
InvalidSessionException
RemoteException

getPagePermissions

public RemotePermission[] getPagePermissions(String token,
                                             long pageId)
                                      throws InvalidSessionException,
                                             RemoteException
Specified by:
getPagePermissions in interface ConfluenceSoapService
Throws:
InvalidSessionException
RemoteException

exportSpace

public String exportSpace(String token,
                          String spaceKey,
                          String exportType)
                   throws RemoteException
Specified by:
exportSpace in interface ConfluenceSoapService
Throws:
RemoteException

exportSpace

public String exportSpace(String token,
                          String spaceKey,
                          String exportType,
                          boolean exportAll)
                   throws RemoteException
Specified by:
exportSpace in interface ConfluenceSoapService
Throws:
RemoteException

exportSite

public String exportSite(String token,
                         boolean exportAttachments)
                  throws RemoteException
Specified by:
exportSite in interface ConfluenceSoapService
Throws:
RemoteException

importSpace

public boolean importSpace(String token,
                           byte[] importData)
                    throws RemoteException
Description copied from interface: ConfluenceSoapService
Import a space in a compressed XML format

Specified by:
importSpace in interface ConfluenceSoapService
Parameters:
token - The authentication token
importData - The contents of the Space export file
Returns:
True if successful, otherwise false
Throws:
RemoteException - If the space exists or the export file is invalid

flushIndexQueue

public boolean flushIndexQueue(String token)
                        throws RemoteException
Specified by:
flushIndexQueue in interface ConfluenceSoapService
Throws:
RemoteException

clearIndexQueue

public boolean clearIndexQueue(String token)
                        throws RemoteException
Specified by:
clearIndexQueue in interface ConfluenceSoapService
Throws:
RemoteException

getClusterInformation

public RemoteClusterInformation getClusterInformation(String token)
                                               throws RemoteException
Specified by:
getClusterInformation in interface ConfluenceSoapService
Throws:
RemoteException

getClusterNodeStatuses

public RemoteNodeStatus[] getClusterNodeStatuses(String token)
                                          throws RemoteException
Specified by:
getClusterNodeStatuses in interface ConfluenceSoapService
Throws:
RemoteException

getGroups

public String[] getGroups(String token)
                   throws RemoteException
Description copied from interface: ConfluenceSoapService
Retrieves a list of user groups

Specified by:
getGroups in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
Returns:
An array of group names
Throws:
NotPermittedException - if the current user lacks permission to administer
RemoteException

hasGroup

public boolean hasGroup(String token,
                        String groupname)
                 throws InvalidSessionException,
                        RemoteException
Description copied from interface: ConfluenceSoapService
Determines whether a group exists

Specified by:
hasGroup in interface ConfluenceSoapService
Parameters:
token - the token identifying the current user
groupname - the group to look up
Returns:
True if the user exists, false otherwise
Throws:
InvalidSessionException
RemoteException

addGroup

public boolean addGroup(String token,
                        String groupname)
                 throws NotPermittedException,
                        InvalidSessionException,
                        RemoteException
Description copied from interface: ConfluenceSoapService
Adds a new group

Specified by:
addGroup in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
groupname - The name of the group to be added
Returns:
True when the group was successfully added, false if it already exists
Throws:
NotPermittedException - if the current user lacks permission to administer
InvalidSessionException
RemoteException

removeGroup

public boolean removeGroup(String token,
                           String groupname,
                           String defaultGroupName)
                    throws NotPermittedException,
                           InvalidSessionException,
                           RemoteException
Description copied from interface: ConfluenceSoapService
Removes an existing group

If a valid defaultGroupName is specified, users will be added to the new group (defaultGroupName).

Specified by:
removeGroup in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
groupname - The name of the group to be removed
defaultGroupName - The name of the group that users will be moved to
Returns:
True if successful, false otherwise.
Throws:
NotPermittedException - if the current user lacks permission to administer
InvalidSessionException
RemoteException - if the given groupname does not exist

removeAllPermissionsForGroup

public boolean removeAllPermissionsForGroup(String token,
                                            String groupname)
                                     throws RemoteException
Description copied from interface: ConfluenceSoapService
Deletes all global and space permissions for the given group

Specified by:
removeAllPermissionsForGroup in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
groupname - The group to delete permissions for
Returns:
True if successful, false otherwise.
Throws:
NotPermittedException - if the current user lacks permission to administer
RemoteException - if the given groupname does not exist

getUserGroups

public String[] getUserGroups(String token,
                              String username)
                       throws NotPermittedException,
                              InvalidSessionException,
                              RemoteException
Description copied from interface: ConfluenceSoapService
Retrieves the groups that a given user belongs to

Specified by:
getUserGroups in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
username - The username to retrieve groups for
Returns:
An array of group names as Strings
Throws:
NotPermittedException - if the current user lacks permission to administer
InvalidSessionException
RemoteException - if the given username does not exist

addUserToGroup

public boolean addUserToGroup(String token,
                              String username,
                              String groupname)
                       throws NotPermittedException,
                              InvalidSessionException,
                              RemoteException
Specified by:
addUserToGroup in interface ConfluenceSoapService
Returns:
True if successful, false otherwise
Throws:
NotPermittedException - if the current user lacks permission to administer
InvalidSessionException
RemoteException - if the given username does not exist

removeUserFromGroup

public boolean removeUserFromGroup(String token,
                                   String username,
                                   String groupname)
                            throws NotPermittedException,
                                   InvalidSessionException,
                                   RemoteException
Description copied from interface: ConfluenceSoapService
Removes the given user from a group

Specified by:
removeUserFromGroup in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
username - The username to remove from a group
groupname - The name of the group the user is to be removed from
Returns:
True if successful, false otherwise
Throws:
NotPermittedException - if the current user lacks permission to administer
InvalidSessionException
RemoteException - if the given username does not exist

getUser

public RemoteUser getUser(String token,
                          String username)
                   throws InvalidSessionException,
                          RemoteException
Description copied from interface: ConfluenceSoapService
Retrieves a user with the given username

Specified by:
getUser in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
username - The username of the user to be retrieved
Returns:
A RemoteUser object, containing the username, full name, email and URL
Throws:
InvalidSessionException
RemoteException - if a user with the given username cannot be found

hasUser

public boolean hasUser(String token,
                       String username)
                throws InvalidSessionException,
                       RemoteException
Description copied from interface: ConfluenceSoapService
Determines whether a user exists

Specified by:
hasUser in interface ConfluenceSoapService
Parameters:
token - the token identifying the current user
username - the username to look up
Returns:
True if the user exists, false otherwise
Throws:
InvalidSessionException
RemoteException

addUser

public void addUser(String token,
                    RemoteUser remoteUser,
                    String password)
             throws NotPermittedException,
                    InvalidSessionException,
                    RemoteException
Description copied from interface: ConfluenceSoapService
Adds a user with the given RemoteUser object and password

Specified by:
addUser in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
remoteUser - The object containing the user information
password - The password of the user
Throws:
NotPermittedException - if the current user lacks permissions to create new users
InvalidSessionException
RemoteException - if a user with the given username cannot be found

removeUser

public boolean removeUser(String token,
                          String username)
                   throws NotPermittedException,
                          InvalidSessionException,
                          RemoteException
Description copied from interface: ConfluenceSoapService
Removes a user with the given username

Specified by:
removeUser in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
username - The username of the user to be removed
Returns:
True if successful, false otherwise
Throws:
NotPermittedException - if the current user lacks the permission to remove users
InvalidSessionException
RemoteException - if the given username cannot be found

editUser

public boolean editUser(String token,
                        RemoteUser remoteUser)
                 throws NotPermittedException,
                        InvalidSessionException,
                        RemoteException
Description copied from interface: ConfluenceSoapService
Edits a user with the values in the given RemoteUser object

Currently this will only update the user's full name and email

Specified by:
editUser in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
remoteUser - The object containing the user information
Throws:
NotPermittedException - if the current user cannot administer users or is not the actual user
InvalidSessionException
RemoteException - if a user with the given username cannot be found

deactivateUser

public boolean deactivateUser(String token,
                              String username)
                       throws NotPermittedException,
                              InvalidSessionException,
                              RemoteException
Description copied from interface: ConfluenceSoapService
Deactivates the given user

Specified by:
deactivateUser in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
username - The username of the user to deactivate
Returns:
True if the user was successfully deactivated, false otherwise
Throws:
NotPermittedException - if the current user does not have permissions to perform the action
InvalidSessionException
RemoteException - if the given username cannot be found

reactivateUser

public boolean reactivateUser(String token,
                              String username)
                       throws NotPermittedException,
                              InvalidSessionException,
                              RemoteException
Description copied from interface: ConfluenceSoapService
Reactivates the given user

Specified by:
reactivateUser in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
username - The username of the user to reactivate
Returns:
True if the user was successfully reactivated, false otherwise
Throws:
NotPermittedException - if the current user does not have permissions to perform the action
InvalidSessionException
RemoteException - if the given username cannot be found

getActiveUsers

public String[] getActiveUsers(String token,
                               boolean viewAll)
                        throws InvalidSessionException,
                               RemoteException
Description copied from interface: ConfluenceSoapService
Returns a list of the current system users

Specified by:
getActiveUsers in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
viewAll - Whether all users should be shown. When it is false, all users in the confluence-users group will be returned. Otherwise, every registered user is returned.
Returns:
An array of usernames as Strings
Throws:
InvalidSessionException
NotPermittedException - if the current user does not have administration permissions
RemoteException

setUserInformation

public boolean setUserInformation(String token,
                                  RemoteUserInformation userInfo)
                           throws NotPermittedException,
                                  InvalidSessionException,
                                  RemoteException
Description copied from interface: ConfluenceSoapService
Updates a user's information

Currently this will only update a user's "description", stored in the 'content' attribute

Specified by:
setUserInformation in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
userInfo - A RemoteUserInformation object, containing the username, email, fullname, url and information
Throws:
NotPermittedException - if the current user cannot administer users or is not the actual user
InvalidSessionException
RemoteException - if there was an error saving the personal information

getUserInformation

public RemoteUserInformation getUserInformation(String token,
                                                String username)
                                         throws InvalidSessionException,
                                                RemoteException
Description copied from interface: ConfluenceSoapService
Retrieves a user's information

Specified by:
getUserInformation in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
username - The name of the user to get information on
Throws:
InvalidSessionException
RemoteException - if a user with the given username cannot be found

changeMyPassword

public boolean changeMyPassword(String token,
                                String oldPass,
                                String newPass)
                         throws InvalidSessionException,
                                RemoteException
Description copied from interface: ConfluenceSoapService
Change the current user's password

Specified by:
changeMyPassword in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
oldPass - The old password of the user, required for security purposes
newPass - The new password for the user
Throws:
InvalidSessionException
NotPermittedException - if newPass was incorrect
RemoteException - if oldPass does not match the user's password

changeUserPassword

public boolean changeUserPassword(String token,
                                  String username,
                                  String newPass)
                           throws NotPermittedException,
                                  InvalidSessionException,
                                  RemoteException
Description copied from interface: ConfluenceSoapService
Change a user's password

Specified by:
changeUserPassword in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
username - The username of the user we are changing the password for
newPass - The new password for the user
Throws:
NotPermittedException - if the current user does not have permission to administer the user
InvalidSessionException
RemoteException - if the user cannot be found

addProfilePicture

public boolean addProfilePicture(String token,
                                 String userName,
                                 String fileName,
                                 String mimeType,
                                 byte[] pictureData)
                          throws NotPermittedException,
                                 InvalidSessionException,
                                 RemoteException
Description copied from interface: ConfluenceSoapService
Add a profile picture to a user's profile

Specified by:
addProfilePicture in interface ConfluenceSoapService
userName - The user name of the profile
fileName - File name of the picture
mimeType - Image mime type (must be from image/*)
pictureData - The image data
Returns:
true if successful
Throws:
NotPermittedException - Principal is not permitted to add pictures to the specified profile
InvalidSessionException
RemoteException - if the user can not be found

getLabelsById

public RemoteLabel[] getLabelsById(String token,
                                   long objectId)
                            throws InvalidSessionException,
                                   RemoteException
Description copied from interface: ConfluenceSoapService
Returns all labels for the given ContentEntityObject ID.

Specified by:
getLabelsById in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
objectId - The ID of the ContentEntityObject the method will retrieve the labels for
Returns:
An array of RemoteLabel objects
Throws:
RemoteException - if the object cannot be retrieved from the ContentEntityManager
InvalidSessionException

getMostPopularLabels

public RemoteLabel[] getMostPopularLabels(String token,
                                          int maxCount)
                                   throws InvalidSessionException,
                                          RemoteException
Description copied from interface: ConfluenceSoapService
Returns the most popular labels for the Confluence instance, with a specified maximum number of results.

Specified by:
getMostPopularLabels in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
maxCount - The maximum number of labels to return. A maxCount of 0 means there is no limit.
Returns:
An array of RemoteLabel objects, sorted by descending popularity
Throws:
InvalidSessionException
RemoteException

getMostPopularLabelsInSpace

public RemoteLabel[] getMostPopularLabelsInSpace(String token,
                                                 String spaceKey,
                                                 int maxCount)
                                          throws InvalidSessionException,
                                                 RemoteException
Description copied from interface: ConfluenceSoapService
Returns the most popular labels for the given spaceKey, with a specified maximum number of results.

Specified by:
getMostPopularLabelsInSpace in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
spaceKey - The key of the space to limit the labels to
maxCount - The maximum number of labels to return. A maxCount of 0 means there is no limit.
Returns:
An array of RemoteLabel objects, sorted by descending popularity
Throws:
RemoteException - if the space cannot be retrieved from the SpaceManager
NotPermittedException - if the given user does not have VIEW permissions for the space
InvalidSessionException

getRecentlyUsedLabels

public RemoteLabel[] getRecentlyUsedLabels(String token,
                                           int maxResults)
                                    throws InvalidSessionException,
                                           RemoteException
Description copied from interface: ConfluenceSoapService
Returns the recently used labels for the Confluence instance, with a specified maximum number of results.

Specified by:
getRecentlyUsedLabels in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
maxResults - The maximum number of labels to return. A value of 0 means the default is used.
Returns:
An array of RemoteLabel objects, sorted by most recent use
Throws:
InvalidSessionException
RemoteException

getRecentlyUsedLabelsInSpace

public RemoteLabel[] getRecentlyUsedLabelsInSpace(String token,
                                                  String spaceKey,
                                                  int maxResults)
                                           throws InvalidSessionException,
                                                  RemoteException
Description copied from interface: ConfluenceSoapService
Returns the recently used labels for the given spaceKey, with a specified maximum number of results.

Specified by:
getRecentlyUsedLabelsInSpace in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
spaceKey - The key of the space to limit the labels to
maxResults - The maximum number of labels to return. A value of 0 means the default is used.
Returns:
An array of RemoteLabel objects, sorted by most recent use
Throws:
RemoteException - if the space does not exist, or the user lacks permission to view it
NotPermittedException - if the given user does not have VIEW permissions for the space
InvalidSessionException

getSpacesWithLabel

public RemoteSpace[] getSpacesWithLabel(String token,
                                        String labelName)
                                 throws InvalidSessionException,
                                        RemoteException
Description copied from interface: ConfluenceSoapService
Returns an array of Spaces that have been labelled with labelName

Specified by:
getSpacesWithLabel in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
labelName - The name of the label (namespace prefixes permitted)
Returns:
An array of RemoteSpace instances
Throws:
InvalidSessionException
RemoteException - if labelName is an empty string or null

getRelatedLabels

public RemoteLabel[] getRelatedLabels(String token,
                                      String labelName,
                                      int maxResults)
                               throws InvalidSessionException,
                                      RemoteException
Description copied from interface: ConfluenceSoapService
Returns the labels related to the given label name, with a specified maximum number of results.

Specified by:
getRelatedLabels in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
labelName - The name of the label (namespace prefixes permitted)
maxResults - The maximum number of labels to return. A value of 0 means the default is used.
Returns:
An array of RemoteLabel objects (sorted by frequency of use)
Throws:
RemoteException - if labelName is an empty string or null
InvalidSessionException

getRelatedLabelsInSpace

public RemoteLabel[] getRelatedLabelsInSpace(String token,
                                             String labelName,
                                             String spaceKey,
                                             int maxResults)
                                      throws InvalidSessionException,
                                             RemoteException
Description copied from interface: ConfluenceSoapService
Returns the labels related to the given label name for the given spaceKey, with a specified maximum number of results.

Specified by:
getRelatedLabelsInSpace in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
labelName - The name of the label (namespace prefixes permitted)
spaceKey - The key of the space to limit the labels to
maxResults - The maximum number of labels to return. A maxCount of 0 means the default is used.
Returns:
An array of RemoteLabel objects (sorted by frequency of use)
Throws:
RemoteException - if labelName is an empty string or null
InvalidSessionException

getLabelsByDetail

public RemoteLabel[] getLabelsByDetail(String token,
                                       String labelName,
                                       String namespace,
                                       String spaceKey,
                                       String owner)
                                throws InvalidSessionException,
                                       RemoteException,
                                       NotPermittedException
Description copied from interface: ConfluenceSoapService
Retrieves the labels matching the given labelName, namespace or owner.

This method can be used to retrieve labels of a specfic type, such as personal labels, by setting the namespace.

Parameters with empty strings are ignored.

Specified by:
getLabelsByDetail in interface ConfluenceSoapService
Parameters:
token - the authentication token for the user
labelName - the name of the label to search for (not parsed for prefixes)
namespace - the namespace to restrict by
spaceKey - the key of the space to restrict by
owner - the owner of the labels
Returns:
an array of matching RemoteLabel objects
Throws:
InvalidSessionException
RemoteException - if labelName is an empty string or null
NotPermittedException
See Also:
Namespace

getLabelContentById

public RemoteSearchResult[] getLabelContentById(String token,
                                                long labelId)
                                         throws InvalidSessionException,
                                                RemoteException
Description copied from interface: ConfluenceSoapService
Returns the content for a given label ID

Specified by:
getLabelContentById in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
labelId - The ID of the label
Returns:
An array of RemoteSearchResult objects
Throws:
RemoteException - if a Label could not be retrieved for the given ID
InvalidSessionException

getLabelContentByName

public RemoteSearchResult[] getLabelContentByName(String token,
                                                  String labelName)
                                           throws InvalidSessionException,
                                                  RemoteException
Description copied from interface: ConfluenceSoapService
Returns the content for a given label name

Specified by:
getLabelContentByName in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
labelName - The name of a label (namespace prefixes permitted)
Returns:
An array of RemoteSearchResult objects
Throws:
RemoteException - if the label name is null
InvalidSessionException

getLabelContentByObject

public RemoteSearchResult[] getLabelContentByObject(String token,
                                                    RemoteLabel labelObject)
                                             throws InvalidSessionException,
                                                    RemoteException
Description copied from interface: ConfluenceSoapService
Returns the content for a given label object

Specified by:
getLabelContentByObject in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
labelObject - The RemoteLabel object
Returns:
An array of RemoteSearchResult objects
Throws:
RemoteException - if the RemoteLabel object is null
InvalidSessionException

getSpacesContainingContentWithLabel

public RemoteSpace[] getSpacesContainingContentWithLabel(String token,
                                                         String labelName)
                                                  throws InvalidSessionException,
                                                         RemoteException
Description copied from interface: ConfluenceSoapService
Returns all Spaces that have content labelled with labelName

Specified by:
getSpacesContainingContentWithLabel in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
labelName - The label to retrieve the content for (namespace prefixes permitted)
Returns:
An array of RemoteSpace instances (order undefined)
Throws:
InvalidSessionException
RemoteException - if labelName is an empty string or null

addLabelByName

public boolean addLabelByName(String token,
                              String labelName,
                              long objectId)
                       throws NotPermittedException,
                              InvalidSessionException,
                              RemoteException
Description copied from interface: ConfluenceSoapService
Adds a label to the object with the given ContentEntityObject ID.

Specified by:
addLabelByName in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
labelName - The name of the label(s) to be added to the ContentEntityObject, in the form of a space-separated string
objectId - The ID of the ContentEntityObject the method will act on
Returns:
True if successfully added, false otherwise.
Throws:
NotPermittedException - if the user lacks EDIT permissions for the object
RemoteException - if the label name is null or an empty String
InvalidSessionException

addLabelById

public boolean addLabelById(String token,
                            long labelId,
                            long objectId)
                     throws NotPermittedException,
                            InvalidSessionException,
                            RemoteException
Description copied from interface: ConfluenceSoapService
Adds a label with the given ID to the object with the given ContentEntityObject ID.

Specified by:
addLabelById in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
labelId - The ID of the label to be added to the ContentEntityObject
objectId - The ID of the ContentEntityObject the method will act on
Returns:
True if successfully added, false otherwise.
Throws:
NotPermittedException - if the user lacks EDIT permissions for the object
RemoteException - if a Label could not be retrieved for the given ID
InvalidSessionException

addLabelByObject

public boolean addLabelByObject(String token,
                                RemoteLabel labelObject,
                                long objectId)
                         throws NotPermittedException,
                                InvalidSessionException,
                                RemoteException
Description copied from interface: ConfluenceSoapService
Adds the given label object to the object with the given ContentEntityObject ID.

Specified by:
addLabelByObject in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
labelObject - The label to be added to the ContentEntityObject
objectId - The ID of the ContentEntityObject the method will act on
Returns:
True if successfully added, false otherwise.
Throws:
NotPermittedException - if the user lacks EDIT permissions for the object
RemoteException - if the given RemoteLabel object is null
InvalidSessionException

addLabelByNameToSpace

public boolean addLabelByNameToSpace(String token,
                                     String labelName,
                                     String spaceKey)
                              throws NotPermittedException,
                                     InvalidSessionException,
                                     RemoteException
Description copied from interface: ConfluenceSoapService
Adds a label to the object with the given ContentEntityObject ID.

Specified by:
addLabelByNameToSpace in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
labelName - The name of the label(s) to be added to the Space, in the form of a space-separated string
spaceKey - The Space to add the label to
Returns:
True if successfully added, false otherwise.
Throws:
NotPermittedException - if the user does not have permission to add the label
RemoteException - if the label name is null or an empty String
InvalidSessionException

removeLabelByName

public boolean removeLabelByName(String token,
                                 String labelName,
                                 long objectId)
                          throws NotPermittedException,
                                 InvalidSessionException,
                                 RemoteException
Description copied from interface: ConfluenceSoapService
Removes the given label from the object with the given ContentEntityObject ID.

Specified by:
removeLabelByName in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
labelName - The name of the label(s) to be removed from the ContentEntityObject, in the form of a space-separated String
objectId - The ID of the ContentEntityObject the method will act on
Returns:
True if successfully removed, false otherwise.
Throws:
NotPermittedException - if the user lacks EDIT permissions for the object
RemoteException - if the label name is null
InvalidSessionException

removeLabelById

public boolean removeLabelById(String token,
                               long labelId,
                               long objectId)
                        throws NotPermittedException,
                               InvalidSessionException,
                               RemoteException
Description copied from interface: ConfluenceSoapService
Removes the label with the given ID from the object with the given ContentEntityObject ID.

Specified by:
removeLabelById in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
labelId - The ID of the label to be removed from the ContentEntityObject
objectId - The ID of the ContentEntityObject the method will act on
Returns:
True if successfully removed, false otherwise.
Throws:
NotPermittedException - if the user lacks EDIT permissions for the object
RemoteException - if a Label could not be retrieved for the given ID
InvalidSessionException

removeLabelByObject

public boolean removeLabelByObject(String token,
                                   RemoteLabel labelObject,
                                   long objectId)
                            throws NotPermittedException,
                                   InvalidSessionException,
                                   RemoteException
Description copied from interface: ConfluenceSoapService
Removes the given label object from the object with the given ContentEntityObject ID.

Specified by:
removeLabelByObject in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
labelObject - The label to be removed from the ContentEntityObject
objectId - The ID of the ContentEntityObject the method will act on
Returns:
True if successfully removed, false otherwise.
Throws:
NotPermittedException - if the user lacks EDIT permissions for the object
RemoteException - if the RemoteLabel object is null
InvalidSessionException

removeLabelByNameFromSpace

public boolean removeLabelByNameFromSpace(String token,
                                          String labelName,
                                          String spaceKey)
                                   throws NotPermittedException,
                                          InvalidSessionException,
                                          RemoteException
Description copied from interface: ConfluenceSoapService
Removes the given label from the given Space

Specified by:
removeLabelByNameFromSpace in interface ConfluenceSoapService
Parameters:
token - The token identifying the current user
labelName - The name of the label(s) to be removed from the Space, in the form of a space-separated String
spaceKey - The Space the method will act on
Returns:
True if successfully removed, false otherwise.
Throws:
NotPermittedException - if the user lacks EDIT permissions for the Space
RemoteException - if the label name is null
InvalidSessionException

getContentPermissionSets

public RemoteContentPermissionSet[] getContentPermissionSets(String token,
                                                             long contentId)
                                                      throws NotPermittedException,
                                                             InvalidSessionException,
                                                             RemoteException
Description copied from interface: ConfluenceSoapService
Get the content permission sets for a particular piece of content

Specified by:
getContentPermissionSets in interface ConfluenceSoapService
Parameters:
token - the login token for the current user
contentId - the content ID of the content to be looked up
Returns:
an array of the permission sets applied to that content
Throws:
NotPermittedException - if the content can not be found, or can not be accessed by the current user
InvalidSessionException - if no login session can be found for the supplied token
RemoteException - if something random goes wrong

getContentPermissionSet

public RemoteContentPermissionSet getContentPermissionSet(String token,
                                                          long contentId,
                                                          String permissionType)
                                                   throws NotPermittedException,
                                                          InvalidSessionException,
                                                          RemoteException
Description copied from interface: ConfluenceSoapService
Get the content permission set of a certain type for a particular piece of content

Specified by:
getContentPermissionSet in interface ConfluenceSoapService
Parameters:
token - the login token for the current user
contentId - the content ID of the content to be looked up
permissionType - type of content permission
Returns:
a content permission set of the specified type on the content object to be looked up
Throws:
NotPermittedException - if the content can not be found, or can not be accessed by the current user
InvalidSessionException - if no login session can be found for the supplied token
RemoteException - if something random goes wrong

setContentPermissions

public boolean setContentPermissions(String token,
                                     long contentId,
                                     String permissionType,
                                     RemoteContentPermission[] remoteContentPermissions)
                              throws NotPermittedException,
                                     InvalidSessionException,
                                     RemoteException
Description copied from interface: ConfluenceSoapService
Set the content permissions for a particular permission type on some content. These permissions will replace any permissions that already exist for that permission type.

Specified by:
setContentPermissions in interface ConfluenceSoapService
Parameters:
token - the login token
contentId - the id of the content to have permissions set on it
permissionType - the type of the permissions (one of the constants from ContentPermission)
remoteContentPermissions - the permissions to set
Returns:
true (because RPC methods can't be void)
Throws:
NotPermittedException - if the content can not be found or can not be accessed by the current user
InvalidSessionException - if no login session can be found for the supplied token
RemoteException - if something random goes wrong

addGlobalPermission

public boolean addGlobalPermission(String token,
                                   String permission,
                                   String remoteEntityName)
                            throws NotPermittedException,
                                   RemoteException
Description copied from interface: ConfluenceSoapService
Add global permissions for a user or group

Specified by:
addGlobalPermission in interface ConfluenceSoapService
Parameters:
token - the login token
permission - the Space Permission to add
remoteEntityName - the name of the user or group
Returns:
True if successful, false otherwise
Throws:
NotPermittedException - if the user lacks permissions to perform the action
RemoteException

addGlobalPermissions

public boolean addGlobalPermissions(String token,
                                    String[] permissions,
                                    String remoteEntityName)
                             throws NotPermittedException,
                                    RemoteException
Description copied from interface: ConfluenceSoapService
Add a global permission for a user or group

Specified by:
addGlobalPermissions in interface ConfluenceSoapService
Parameters:
token - the login token
permissions - Array of permissions to add
remoteEntityName - the name of the user or group
Returns:
True if successful, false otherwise
Throws:
NotPermittedException - if the user lacks permissions to perform the action
RemoteException

removeGlobalPermission

public boolean removeGlobalPermission(String token,
                                      String permission,
                                      String remoteEntityName)
                               throws RemoteException
Description copied from interface: ConfluenceSoapService
Remove a global permission

Specified by:
removeGlobalPermission in interface ConfluenceSoapService
Parameters:
token - the login token
permission - the Space Permission to add
remoteEntityName - the name of the user or group
Returns:
True if successful, false otherwise
Throws:
NotPermittedException - if the user lacks permissions to perform the action
RemoteException

addAnonymousUsePermission

public boolean addAnonymousUsePermission(String token)
                                  throws RemoteException
Specified by:
addAnonymousUsePermission in interface ConfluenceSoapService
Throws:
RemoteException

removeAnonymousUsePermission

public boolean removeAnonymousUsePermission(String token)
                                     throws RemoteException
Description copied from interface: ConfluenceSoapService
Remove anonymous use permission. If the anonymous user also has 'view user profile' permission then this will also be removed.

Specified by:
removeAnonymousUsePermission in interface ConfluenceSoapService
Parameters:
token - the login token
Returns:
true if successful, false otherwise.
Throws:
RemoteException

addAnonymousViewUserProfilePermission

public boolean addAnonymousViewUserProfilePermission(String token)
                                              throws RemoteException
Description copied from interface: ConfluenceSoapService
This permission can only be set if the anonymous user already has 'use' permission. If this is not the case then false will be returned.

Specified by:
addAnonymousViewUserProfilePermission in interface ConfluenceSoapService
Parameters:
token - the login token
Returns:
true if successfully set; otherwise false.
Throws:
RemoteException

removeAnonymousViewUserProfilePermission

public boolean removeAnonymousViewUserProfilePermission(String token)
                                                 throws RemoteException
Specified by:
removeAnonymousViewUserProfilePermission in interface ConfluenceSoapService
Throws:
RemoteException

setSoapServiceDelegator

public void setSoapServiceDelegator(ConfluenceSoapService soapServiceDelegator)

setEnableWysiwyg

public boolean setEnableWysiwyg(String token,
                                boolean value)
                         throws RemoteException
Specified by:
setEnableWysiwyg in interface ConfluenceSoapService
Throws:
RemoteException

setEnableAnonymousAccess

public boolean setEnableAnonymousAccess(String token,
                                        boolean value)
                                 throws RemoteException
Specified by:
setEnableAnonymousAccess in interface ConfluenceSoapService
Throws:
RemoteException

isPluginEnabled

public boolean isPluginEnabled(String token,
                               String pluginKey)
Description copied from interface: ConfluenceSoapService
Returns true if the specified plugin is enabled.

Specified by:
isPluginEnabled in interface ConfluenceSoapService

installPlugin

public boolean installPlugin(String token,
                             String pluginFileName,
                             byte[] pluginData)
                      throws RemoteException
Description copied from interface: ConfluenceSoapService
Installs a plugin.

Specified by:
installPlugin in interface ConfluenceSoapService
pluginFileName - the original filename of the plugin. It should end with the correct file extension .xml or .jar.
pluginData - a byte[] continaing the contents of the plugin xml or jar file.
Throws:
RemoteException


Copyright © 2003-2010 Atlassian. All Rights Reserved.