public class XhtmlSoapService extends Object implements ConfluenceSoapService
Modifier and Type | Field and Description |
---|---|
static List |
ADMINISTER_PERMISSION_TYPES |
static List |
EXPORT_SPACE_PERMISSION_TYPES |
static List |
MODIFY_SPACE_PERMISSION_TYPES |
static List |
REMOVE_PAGE_PERMISSION_TYPES |
static List |
SPACE_ADMIN_PERMISSION_TYPES |
static List |
VIEW_SPACE_PERMISSION_TYPES |
ADMIN_SPACE_PERMISSION, COMMENT_PERMISSION, MODIFY_PERMISSION, VIEW_PERMISSION
Constructor and Description |
---|
XhtmlSoapService() |
Modifier and Type | Method and Description |
---|---|
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.
|
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) |
RemoteSpace |
addPersonalSpaceWithDefaultPermissions(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
|
RemoteSpace |
addSpaceWithDefaultPermissions(String token,
RemoteSpace space) |
void |
addUser(String token,
RemoteUser remoteUser,
String password)
Adds a user with the given RemoteUser object and password
|
void |
addUser(String token,
RemoteUser remoteUser,
String password,
boolean notifyUser)
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) |
String |
convertWikiToStorageFormat(String token,
String markup)
Converts a string from wiki markup to the XHTML based storage format.
|
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
|
Boolean |
emptyTrash(String token,
String spaceKey) |
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 contentId,
String fileName,
int version)
Retrieve information about an attachment.
|
byte[] |
getAttachmentData(String token,
long contentId,
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 |
getBlogEntryByDateAndTitle(String token,
String spaceKey,
int year,
int month,
int dayOfMonth,
String postTitle)
Retrieves a blog post in the given space, with the title and date as specified.
|
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.
|
RemotePageSummary |
getPageSummary(String token,
long pageId) |
RemotePageSummary |
getPageSummary(String token,
String spaceKey,
String pageTitle) |
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 spaceGroupKey) |
RemoteSpaceGroup[] |
getSpaceGroups(String token) |
String[] |
getSpaceLevelPermissions(String token) |
RemoteSpacePermissionSet |
getSpacePermissionSet(String token,
String spaceKey,
String permissionType) |
RemoteSpacePermissionSet[] |
getSpacePermissionSets(String token,
String spaceKey) |
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) |
String |
getSpaceStatus(String token,
String spaceKey) |
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.
|
RemoteContentSummaries |
getTrashContents(String token,
String spaceKey,
int offset,
int count) |
RemoteUser |
getUser(String token,
String username)
Retrieves a user with the given username
|
RemoteConfluenceUser |
getUserByKey(String token,
String key)
Retrieves a user with the given user key.
|
RemoteConfluenceUser |
getUserByName(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 |
getUserPreferenceBoolean(String token,
String username,
String key)
Get a user preference as a boolean value.
|
long |
getUserPreferenceLong(String token,
String username,
String key)
Get a user preference as a long integer value.
|
String |
getUserPreferenceString(String token,
String username,
String key)
Get a user preference as a String value.
|
RemoteUser[] |
getWatchersForPage(String token,
long pageId)
Returns the list of users watching the page or blog post with the given ID.
|
RemoteUser[] |
getWatchersForSpace(String token,
String spaceKey)
Returns the list of users watching the space with the given key.
|
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 |
isActiveUser(String token,
String username)
Checks if a given user is active.
|
boolean |
isDarkFeatureEnabled(String token,
String key) |
boolean |
isPluginEnabled(String token,
String pluginKey)
Returns true if the specified plugin is enabled.
|
boolean |
isPluginInstalled(String token,
String pluginKey)
Returns true if the specified plugin is installed.
|
boolean |
isWatchingPage(String token,
long pageId,
String username)
Returns true if the specified user is watching the page or blog post with the given ID, otherwise false.
|
boolean |
isWatchingSpace(String token,
String spaceKey,
String username)
Returns true if the specified user is watching the space with the given key, otherwise false.
|
boolean |
isWatchingSpaceForType(String token,
String spaceKey,
String contentType,
String username)
Returns true if the specified user is watching the specified type of content in space with the given key,
otherwise false.
|
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) |
String |
performBackup(String token,
boolean exportAttachments) |
Boolean |
purgeFromTrash(String token,
String spaceKey,
long pageId) |
boolean |
reactivateUser(String token,
String username)
Reactivates the given user
|
boolean |
recoverMainIndex(String token) |
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
|
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 |
removePageVersionById(String token,
long historicalPageId)
Remove a historical version of a page.
|
Boolean |
removePageVersionByVersion(String token,
long pageId,
int version)
Remove the identified version of a page.
|
boolean |
removePageWatch(String token,
long pageId)
Remove a watch for the current user on the page or blog post with the specified page ID.
|
boolean |
removePageWatchForUser(String token,
long pageId,
String username)
Removes a watch from a specific page or blog post for a particular user.
|
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 |
removeSpaceWatch(String token,
String spaceKey)
Removes a watch for the current user on the space with the specified space key.
|
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
|
boolean |
renameUser(String token,
String oldUsername,
String newUsername)
Change user's username
|
String[] |
renameUsers(String token,
Map<String,String> oldUsernamesToNewUsernames)
Change usernames for a set of users
|
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.
|
void |
setAdminSoapService(AdminSoapService adminSoapService) |
void |
setAttachmentsSoapService(AttachmentsSoapService attachmentsService) |
void |
setBlogsSoapService(BlogsSoapService blogsService) |
void |
setContentEntityObjectDao(ContentEntityObjectDao contentEntityObjectDao) |
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)
Deprecated.
since 4.0. You can no longer disable the wysiwyg editor.
|
void |
setGlobalSoapService(AdminSoapService adminSoapService) |
void |
setLabelsSoapService(LabelsSoapService labelsSoapService) |
void |
setMailServerManager(com.atlassian.mail.server.MailServerManager mailServerManager) |
void |
setNotificationsSoapService(NotificationsSoapService notificationsSoapService) |
void |
setPagesSoapService(PagesSoapService pagesService) |
void |
setSpacesSoapService(SpacesSoapService spacesService) |
Boolean |
setSpaceStatus(String token,
String spaceKey,
String status) |
boolean |
setUserInformation(String token,
RemoteUserInformation userInfo)
Updates a user's information
|
boolean |
setUserPreferenceBoolean(String token,
String username,
String key,
boolean value)
Set a user preference to a boolean value.
|
boolean |
setUserPreferenceLong(String token,
String username,
String key,
long value)
Set a user preference to an long integer value.
|
boolean |
setUserPreferenceString(String token,
String username,
String key,
String value)
Set a user preference to a String value.
|
void |
setUsersSoapService(UsersSoapService usersService) |
void |
setWikiToXhtmlMigrator(ExceptionTolerantMigrator wikiToXhtmlMigrator) |
void |
setXhtmlRoundTripMigrator(ExceptionTolerantMigrator xhtmlRoundTripMigrator) |
boolean |
startActivity(String token,
String key,
String user)
Call startActivity on the heartbeat manager bean
|
boolean |
stopActivity(String token,
String key,
String user)
Call stopActivity on the heartbeat manager bean
|
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) |
boolean |
watchPage(String token,
long pageId)
Adds a watch for the current user on the page or blog post with the specified page ID.
|
boolean |
watchPageForUser(String token,
long pageId,
String username)
Adds a watch to a specific page or blog post for a particular user.
|
boolean |
watchSpace(String token,
String spaceKey)
Adds a watch for the current user on the space with the specified space key.
|
public static final List VIEW_SPACE_PERMISSION_TYPES
public static final List MODIFY_SPACE_PERMISSION_TYPES
public static final List ADMINISTER_PERMISSION_TYPES
public static final List SPACE_ADMIN_PERMISSION_TYPES
public static final List REMOVE_PAGE_PERMISSION_TYPES
public static final List EXPORT_SPACE_PERMISSION_TYPES
public void setSpacesSoapService(SpacesSoapService spacesService)
public void setPagesSoapService(PagesSoapService pagesService)
public void setUsersSoapService(UsersSoapService usersService)
public void setBlogsSoapService(BlogsSoapService blogsService)
public void setGlobalSoapService(AdminSoapService adminSoapService)
public void setAdminSoapService(AdminSoapService adminSoapService)
public void setLabelsSoapService(LabelsSoapService labelsSoapService)
public void setAttachmentsSoapService(AttachmentsSoapService attachmentsService)
public void setNotificationsSoapService(NotificationsSoapService notificationsSoapService)
public String login(String username, String password) throws RemoteException
login
in interface SecureRpc
login
in interface ConfluenceSoapService
RemoteException
public boolean logout(String token)
logout
in interface SecureRpc
logout
in interface ConfluenceSoapService
public RemoteSpaceSummary[] getSpaces(String token) throws RemoteException
getSpaces
in interface ConfluenceSoapService
RemoteException
public RemoteSpaceSummary[] getSpacesInGroup(String token, String spaceGroupKey) throws RemoteException
getSpacesInGroup
in interface ConfluenceSoapService
RemoteException
public RemoteSpace addSpaceWithDefaultPermissions(String token, RemoteSpace space) throws RemoteException
addSpaceWithDefaultPermissions
in interface ConfluenceSoapService
RemoteException
public RemoteSpace addSpace(String token, RemoteSpace space) throws RemoteException
addSpace
in interface ConfluenceSoapService
RemoteException
public RemoteSpace storeSpace(String token, RemoteSpace remoteSpace) throws RemoteException
ConfluenceSoapService
storeSpace
in interface ConfluenceSoapService
RemoteException
public RemoteSpaceGroup addSpaceGroup(String token, RemoteSpaceGroup spaceGroup) throws NotPermittedException, InvalidSessionException, AlreadyExistsException, RemoteException
ConfluenceSoapService
addSpaceGroup
in interface ConfluenceSoapService
token
- the authentication tokenspaceGroup
- the spacegroup to addNotPermittedException
- if the user lacks permissions to perform the actionInvalidSessionException
AlreadyExistsException
- if a group with the same key already existsRemoteException
public RemoteSpaceGroup getSpaceGroup(String token, String spaceGroupKey) throws NotPermittedException, InvalidSessionException, AlreadyExistsException, RemoteException
getSpaceGroup
in interface ConfluenceSoapService
NotPermittedException
InvalidSessionException
AlreadyExistsException
RemoteException
public RemoteSpaceGroup[] getSpaceGroups(String token) throws InvalidSessionException, RemoteException
getSpaceGroups
in interface ConfluenceSoapService
InvalidSessionException
RemoteException
public boolean removeSpaceGroup(String token, String spaceGroupKey) throws RemoteException
ConfluenceSoapService
removeSpaceGroup
in interface ConfluenceSoapService
token
- the authentication tokenspaceGroupKey
- the id of the spacegroup to be removedRemoteException
public RemoteSpace addPersonalSpace(String token, RemoteSpace space, String username) throws RemoteException
addPersonalSpace
in interface ConfluenceSoapService
RemoteException
public RemoteSpace addPersonalSpaceWithDefaultPermissions(String token, RemoteSpace space, String username) throws RemoteException
addPersonalSpaceWithDefaultPermissions
in interface ConfluenceSoapService
RemoteException
public Boolean removeSpace(String token, String spaceKey) throws RemoteException
removeSpace
in interface ConfluenceSoapService
RemoteException
public RemoteSpace getSpace(String token, String spaceKey) throws RemoteException
getSpace
in interface ConfluenceSoapService
RemoteException
public String getSpaceStatus(String token, String spaceKey) throws NotPermittedException, InvalidSessionException, RemoteException
getSpaceStatus
in interface ConfluenceSoapService
NotPermittedException
InvalidSessionException
RemoteException
public Boolean setSpaceStatus(String token, String spaceKey, String status) throws NotPermittedException, InvalidSessionException, RemoteException
setSpaceStatus
in interface ConfluenceSoapService
NotPermittedException
InvalidSessionException
RemoteException
public String[] getPermissions(String token, String spaceKey) throws RemoteException
getPermissions
in interface ConfluenceSoapService
RemoteException
public String[] getPermissionsForUser(String token, String spaceKey, String userName) throws InvalidSessionException, RemoteException
getPermissionsForUser
in interface ConfluenceSoapService
InvalidSessionException
RemoteException
public RemoteSpacePermissionSet[] getSpacePermissionSets(String token, String spaceKey) throws InvalidSessionException, NotPermittedException, RemoteException
getSpacePermissionSets
in interface ConfluenceSoapService
InvalidSessionException
NotPermittedException
RemoteException
public RemoteSpacePermissionSet getSpacePermissionSet(String token, String spaceKey, String permissionType) throws InvalidSessionException, NotPermittedException, RemoteException
getSpacePermissionSet
in interface ConfluenceSoapService
InvalidSessionException
NotPermittedException
RemoteException
public boolean addPermissionToSpace(String token, String permission, String remoteEntityName, String spaceKey) throws RemoteException
ConfluenceSoapService
addPermissionToSpace
in interface ConfluenceSoapService
token
- the authentication tokenpermission
- the Space Permission to addremoteEntityName
- the name of the user or groupspaceKey
- the key of the Space affected by this actionRemoteException
- if the Space Permission is nullNotPermittedException
- if the user lacks permissions to perform the actionpublic boolean addPermissionsToSpace(String token, String[] permissions, String remoteEntityName, String spaceKey) throws RemoteException
ConfluenceSoapService
addPermissionsToSpace
in interface ConfluenceSoapService
token
- the authentication tokenpermissions
- the Space Permissions to addremoteEntityName
- the name of the user or groupspaceKey
- the key of the Space affected by this actionRemoteException
- if the Space Permissions array is nullNotPermittedException
- if the user lacks permissions to perform the actionpublic boolean removePermissionFromSpace(String token, String permission, String remoteEntityName, String spaceKey) throws NotPermittedException, RemoteException
ConfluenceSoapService
removePermissionFromSpace
in interface ConfluenceSoapService
token
- the authentication tokenpermission
- the Space Permission to removeremoteEntityName
- the name of the user or groupspaceKey
- the key of the Space affected by this actionNotPermittedException
- if the user lacks permissions to perform the actionRemoteException
- if the Space does not existpublic boolean addGlobalPermission(String token, String permission, String remoteEntityName) throws NotPermittedException, RemoteException
ConfluenceSoapService
addGlobalPermission
in interface ConfluenceSoapService
token
- the login tokenpermission
- the Space Permission to addremoteEntityName
- the name of the user or groupNotPermittedException
- if the user lacks permissions to perform the actionRemoteException
public boolean addGlobalPermissions(String token, String[] permissions, String remoteEntityName) throws NotPermittedException, RemoteException
ConfluenceSoapService
addGlobalPermissions
in interface ConfluenceSoapService
token
- the login tokenpermissions
- Array of permissions to addremoteEntityName
- the name of the user or groupNotPermittedException
- if the user lacks permissions to perform the actionRemoteException
public boolean removeGlobalPermission(String token, String permission, String remoteEntityName) throws RemoteException
ConfluenceSoapService
removeGlobalPermission
in interface ConfluenceSoapService
token
- the login tokenpermission
- the Space Permission to addremoteEntityName
- the name of the user or groupNotPermittedException
- if the user lacks permissions to perform the actionRemoteException
public boolean addAnonymousUsePermission(String token) throws RemoteException
addAnonymousUsePermission
in interface ConfluenceSoapService
RemoteException
public boolean removeAnonymousUsePermission(String token) throws RemoteException
ConfluenceSoapService
removeAnonymousUsePermission
in interface ConfluenceSoapService
token
- the login tokenRemoteException
public boolean addAnonymousViewUserProfilePermission(String token) throws RemoteException
ConfluenceSoapService
addAnonymousViewUserProfilePermission
in interface ConfluenceSoapService
token
- the login tokenRemoteException
public boolean removeAnonymousViewUserProfilePermission(String token) throws RemoteException
removeAnonymousViewUserProfilePermission
in interface ConfluenceSoapService
RemoteException
public boolean addAnonymousPermissionToSpace(String token, String permission, String spaceKey) throws RemoteException
ConfluenceSoapService
addAnonymousPermissionToSpace
in interface ConfluenceSoapService
token
- the authentication tokenpermission
- the Space Permission to addspaceKey
- the key of the Space affected by this actionRemoteException
- if the Space Permission is nullNotPermittedException
- if the user lacks permissions to perform the actionpublic boolean addAnonymousPermissionsToSpace(String token, String[] permissions, String spaceKey) throws RemoteException
ConfluenceSoapService
addAnonymousPermissionsToSpace
in interface ConfluenceSoapService
token
- the authentication tokenpermissions
- the Space Permissions to addspaceKey
- the key of the Space affected by this actionRemoteException
- if the Space Permissions array is nullNotPermittedException
- if the user lacks permissions to perform the actionpublic boolean removeAnonymousPermissionFromSpace(String token, String permission, String spaceKey) throws NotPermittedException, RemoteException
ConfluenceSoapService
removeAnonymousPermissionFromSpace
in interface ConfluenceSoapService
token
- the authentication tokenpermission
- the Space Permission to removespaceKey
- the key of the Space affected by this actionNotPermittedException
- if the user lacks permissions to perform the actionRemoteException
- if the Space does not existpublic String[] getSpaceLevelPermissions(String token) throws RemoteException
getSpaceLevelPermissions
in interface ConfluenceSoapService
RemoteException
public RemotePageSummary[] getPages(String token, String spaceKey) throws RemoteException
ConfluenceSoapService
getPages
in interface ConfluenceSoapService
token
- the authentication tokenspaceKey
- the key of the space which pages are to be returnedRemoteException
public RemotePage getPage(String token, String spaceKey, String pageTitle) throws InvalidSessionException, RemoteException
getPage
in interface ConfluenceSoapService
InvalidSessionException
RemoteException
public RemotePage getPage(String token, long pageId) throws RemoteException
getPage
in interface ConfluenceSoapService
RemoteException
public RemotePageSummary getPageSummary(String token, String spaceKey, String pageTitle) throws InvalidSessionException, RemoteException
getPageSummary
in interface ConfluenceSoapService
InvalidSessionException
RemoteException
public RemotePageSummary getPageSummary(String token, long pageId) throws InvalidSessionException, RemoteException
getPageSummary
in interface ConfluenceSoapService
InvalidSessionException
RemoteException
public RemoteComment[] getComments(String token, long pageId) throws RemoteException
ConfluenceSoapService
getComments
in interface ConfluenceSoapService
token
- the authentication tokenpageId
- the content ID of the abstract pageInvalidSessionException
RemoteException
- if the object for the pageId is null, or the user lacks permissionspublic RemoteComment getComment(String token, long commentId) throws InvalidSessionException, RemoteException
ConfluenceSoapService
getComment
in interface ConfluenceSoapService
token
- The token identifying the current usercommentId
- The ID of the comment to be retrievedInvalidSessionException
RemoteException
- if the comment cannot be foundpublic RemoteComment addComment(String token, RemoteComment comment) throws InvalidSessionException, NotPermittedException, RemoteException
ConfluenceSoapService
addComment
in interface ConfluenceSoapService
token
- The token identifying the current usercomment
- The RemoteComment object containing the comment informationInvalidSessionException
NotPermittedException
- if the user is unable to post the commentRemoteException
- if the user does not have permission to view the page the comment is being posted to, or it does not existpublic RemoteComment editComment(String token, RemoteComment comment) throws InvalidSessionException, NotPermittedException, RemoteException
ConfluenceSoapService
editComment
in interface ConfluenceSoapService
token
- The token identifying the current usercomment
- The RemoteComment object containing the comment informationInvalidSessionException
NotPermittedException
- if the user is unable to edit the commentRemoteException
- if the user does not have permission to view the page the comment is being posted to, or it does not existpublic boolean removeComment(String token, long commentId) throws InvalidSessionException, NotPermittedException, RemoteException
ConfluenceSoapService
removeComment
in interface ConfluenceSoapService
token
- The token identifying the current usercommentId
- The ID of the comment to removeInvalidSessionException
NotPermittedException
- if the user does not have permission to remove the commentRemoteException
- if the user does not have permission to view the page the comment is on, or it does not existpublic RemotePageSummary[] getTopLevelPages(String token, String spaceKey) throws RemoteException
ConfluenceSoapService
getTopLevelPages
in interface ConfluenceSoapService
token
- the authentication tokenspaceKey
- the key of the space which pages are to be returnedRemoteException
public RemotePageSummary[] getAncestors(String token, long pageId) throws InvalidSessionException, RemoteException
ConfluenceSoapService
getAncestors
in interface ConfluenceSoapService
token
- the authentication tokenpageId
- the id of the page which child pages are to be returnedInvalidSessionException
RemoteException
public RemotePageSummary[] getChildren(String token, long pageId) throws InvalidSessionException, RemoteException
ConfluenceSoapService
getChildren
in interface ConfluenceSoapService
token
- the authentication tokenpageId
- the id of the page which child pages are to be returnedInvalidSessionException
RemoteException
public RemotePageSummary[] getDescendents(String token, long pageId) throws InvalidSessionException, RemoteException
ConfluenceSoapService
getDescendents
in interface ConfluenceSoapService
token
- the authentication tokenpageId
- the id of the page which child pages are to be returnedInvalidSessionException
RemoteException
public RemoteAttachment[] getAttachments(String token, long pageId) throws RemoteException
getAttachments
in interface ConfluenceSoapService
RemoteException
public RemotePageHistory[] getPageHistory(String token, long pageId) throws RemoteException
getPageHistory
in interface ConfluenceSoapService
RemoteException
public boolean watchPage(String token, long pageId) throws RemoteException
ConfluenceSoapService
watchPage
in interface ConfluenceSoapService
RemoteException
- if the watch could not be addedpublic boolean watchSpace(String token, String spaceKey) throws RemoteException
ConfluenceSoapService
watchSpace
in interface ConfluenceSoapService
RemoteException
- if the watch could not be addedpublic boolean watchPageForUser(String token, long pageId, String username) throws RemoteException
ConfluenceSoapService
watchPageForUser
in interface ConfluenceSoapService
RemoteException
- if the watch could not be added, or the current user does not have permission to add itpublic boolean removePageWatch(String token, long pageId) throws RemoteException
ConfluenceSoapService
removePageWatch
in interface ConfluenceSoapService
RemoteException
- if the watch could not be removedpublic boolean removeSpaceWatch(String token, String spaceKey) throws RemoteException
ConfluenceSoapService
removeSpaceWatch
in interface ConfluenceSoapService
RemoteException
- if the watch could not be removedpublic boolean removePageWatchForUser(String token, long pageId, String username) throws RemoteException
ConfluenceSoapService
removePageWatchForUser
in interface ConfluenceSoapService
RemoteException
- if the watch could not be removed, or the current user does not have permission to remove itpublic boolean isWatchingPage(String token, long pageId, String username) throws RemoteException
ConfluenceSoapService
isWatchingPage
in interface ConfluenceSoapService
RemoteException
- if the current user does not have permission to see the page or administer the space, or
if the page or user does not existpublic boolean isWatchingSpace(String token, String spaceKey, String username) throws RemoteException
ConfluenceSoapService
isWatchingSpace
in interface ConfluenceSoapService
RemoteException
- if the current user does not have permission to administer the space, or if the user does
not existpublic boolean isWatchingSpaceForType(String token, String spaceKey, String contentType, String username) throws RemoteException
ConfluenceSoapService
Note that this method will return false if the user is watching the entire space and not just the given type.
isWatchingSpaceForType
in interface ConfluenceSoapService
RemoteException
- if the current user does not have permission to administer the space, or if the user does
not existpublic RemoteUser[] getWatchersForPage(String token, long pageId) throws RemoteException
ConfluenceSoapService
getWatchersForPage
in interface ConfluenceSoapService
RemoteException
- if the current user does not have permission to see the page or administer the space, or
if the page does not existpublic RemoteUser[] getWatchersForSpace(String token, String spaceKey) throws RemoteException
ConfluenceSoapService
getWatchersForSpace
in interface ConfluenceSoapService
RemoteException
- if the current user does not have permission to administer the space, or if the space does not existpublic RemoteSearchResult[] search(String token, String query, int maxResults) throws RemoteException
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.
search
in interface ConfluenceSoapService
token
- the authentication tokenquery
- the query term for the searchmaxResults
- the maximum number of results to be returned.RemoteSearchResult
s. If there are no results then an empty array will be returned.RemoteException
public RemoteSearchResult[] search(String token, String query, Map params, int maxResults) throws RemoteException
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 -
com.atlassian.bonnie.search.SinceDateQueryFactory
for a list of understood representations.
search
in interface ConfluenceSoapService
token
- the authentication tokenquery
- the query term for the searchparams
- a MapmaxResults
- the maximum number of results to be returned.RemoteSearchResult
s. If there are no results then an empty array will be returned.RemoteException
public RemoteBlogEntry getBlogEntryByDayAndTitle(String token, String spaceKey, int dayOfMonth, String postTitle) throws RemoteException
ConfluenceSoapService
getBlogEntryByDayAndTitle
in interface ConfluenceSoapService
token
- the authentication tokenspaceKey
- the key of the Space the blog post belongs todayOfMonth
- the day of the month the blog post was madepostTitle
- the title of the blog postRemoteException
- if the user does not have permission to view the blog post, or it does not existpublic RemoteBlogEntry getBlogEntryByDateAndTitle(String token, String spaceKey, int year, int month, int dayOfMonth, String postTitle) throws RemoteException
ConfluenceSoapService
getBlogEntryByDateAndTitle
in interface ConfluenceSoapService
RemoteException
- if the user does not have permission to view the blog post or it does not existpublic String renderContent(String token, String spaceKey, long pageId, String newContent) throws RemoteException
renderContent
in interface ConfluenceSoapService
RemoteException
public String renderContent(String token, String spaceKey, long pageId, String newContent, Map renderParameters) throws RemoteException
renderContent
in interface ConfluenceSoapService
RemoteException
public String convertWikiToStorageFormat(String token, String markup) throws RemoteException
ConfluenceSoapService
convertWikiToStorageFormat
in interface ConfluenceSoapService
RemoteException
@Deprecated public RemoteAttachment addAttachment(String token, RemoteAttachment attachment, byte[] attachmentData) throws RemoteException
addAttachment(String, long, com.atlassian.confluence.rpc.soap.beans.RemoteAttachment, byte[])
addAttachment
in interface ConfluenceSoapService
RemoteException
public RemoteAttachment addAttachment(String token, long contentId, RemoteAttachment attachment, byte[] attachmentData) throws RemoteException
ConfluenceSoapService
addAttachment
in interface ConfluenceSoapService
token
- the authentication tokencontentId
- the id of the ContentEntityObject to receive the new attachment.attachment
- RemoteAttachment object containing attachment informationattachmentData
- a byte[] continaing the contents of the attachment.RemoteException
public RemoteAttachment getAttachment(String token, long contentId, String fileName, int version) throws RemoteException
ConfluenceSoapService
getAttachment
in interface ConfluenceSoapService
token
- the authentication token.contentId
- the id of the ContentEntityObject the attachemt belongs to.fileName
- the name of the attachment.version
- the version number of the attachment.RemoteException
public byte[] getAttachmentData(String token, long contentId, String fileName, int version) throws RemoteException
ConfluenceSoapService
getAttachmentData
in interface ConfluenceSoapService
token
- the authentication token.contentId
- the id of the ContentEntityObject the attachemt belongs to.fileName
- the name of the attachment.version
- the version number of the attachment.RemoteException
public boolean removeAttachment(String token, long contentId, String fileName) throws RemoteException
ConfluenceSoapService
removeAttachment
in interface ConfluenceSoapService
token
- the authentication token.contentId
- the id of the ContentEntityObject the attachment belongs to.fileName
- the name of the attachment.RemoteException
public boolean moveAttachment(String token, long originalContentId, String originalFileName, long newContentId, String newFileName) throws RemoteException
ConfluenceSoapService
moveAttachment
in interface ConfluenceSoapService
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.RemoteException
public Boolean movePageToTopLevel(String token, long pageId, String targetSpaceKey) throws RemoteException
movePageToTopLevel
in interface ConfluenceSoapService
RemoteException
public Boolean movePage(String token, long sourcePageId, long targetPageId, String position) throws RemoteException
movePage
in interface ConfluenceSoapService
RemoteException
public Boolean removePage(String token, long pageId) throws RemoteException
removePage
in interface ConfluenceSoapService
RemoteException
public Boolean removePageVersionById(String token, long historicalPageId) throws NotPermittedException, InvalidSessionException, RemoteException
ConfluenceSoapService
ConfluenceSoapService.removePage(String, long)
.removePageVersionById
in interface ConfluenceSoapService
historicalPageId
- the id of a historical version of a pageNotPermittedException
InvalidSessionException
RemoteException
public Boolean removePageVersionByVersion(String token, long pageId, int version) throws NotPermittedException, InvalidSessionException, RemoteException
ConfluenceSoapService
removePageVersionByVersion
in interface ConfluenceSoapService
pageId
- the id of the page which you want to remove a version from.version
- the version of the page to be removed (with 1 being the first).NotPermittedException
InvalidSessionException
RemoteException
public RemotePage storePage(String token, RemotePage page) throws RemoteException
storePage
in interface ConfluenceSoapService
RemoteException
public RemotePage updatePage(String token, RemotePage page, RemotePageUpdateOptions options) throws VersionMismatchException, NotPermittedException, InvalidSessionException, RemoteException
updatePage
in interface ConfluenceSoapService
VersionMismatchException
NotPermittedException
InvalidSessionException
RemoteException
public RemotePermission[] getPagePermissions(String token, long pageId) throws RemoteException
getPagePermissions
in interface ConfluenceSoapService
RemoteException
public RemoteContentSummaries getTrashContents(String token, String spaceKey, int offset, int count) throws RemoteException
getTrashContents
in interface ConfluenceSoapService
RemoteException
public Boolean purgeFromTrash(String token, String spaceKey, long pageId) throws RemoteException
purgeFromTrash
in interface ConfluenceSoapService
RemoteException
public Boolean emptyTrash(String token, String spaceKey) throws RemoteException
emptyTrash
in interface ConfluenceSoapService
RemoteException
public RemoteBlogEntry getBlogEntry(String token, long entryId) throws RemoteException
getBlogEntry
in interface ConfluenceSoapService
RemoteException
public RemoteBlogEntrySummary[] getBlogEntries(String token, String spaceKey) throws RemoteException
getBlogEntries
in interface ConfluenceSoapService
RemoteException
public RemoteBlogEntry storeBlogEntry(String token, RemoteBlogEntry blogEntry) throws RemoteException
storeBlogEntry
in interface ConfluenceSoapService
RemoteException
public String[] getGroups(String token) throws RemoteException
ConfluenceSoapService
getGroups
in interface ConfluenceSoapService
token
- The token identifying the current userNotPermittedException
- if the current user lacks permission to administerRemoteException
public boolean hasGroup(String token, String groupname) throws InvalidSessionException, RemoteException
ConfluenceSoapService
hasGroup
in interface ConfluenceSoapService
token
- the token identifying the current usergroupname
- the group to look upInvalidSessionException
RemoteException
public boolean addGroup(String token, String groupname) throws RemoteException
ConfluenceSoapService
addGroup
in interface ConfluenceSoapService
token
- The token identifying the current usergroupname
- The name of the group to be addedNotPermittedException
- if the current user lacks permission to administerInvalidSessionException
RemoteException
public boolean removeGroup(String token, String groupname, String defaultGroupName) throws RemoteException
ConfluenceSoapService
If a valid defaultGroupName is specified, users will be added to the new group (defaultGroupName).
removeGroup
in interface ConfluenceSoapService
token
- The token identifying the current usergroupname
- The name of the group to be removeddefaultGroupName
- The name of the group that users will be moved toNotPermittedException
- if the current user lacks permission to administerInvalidSessionException
RemoteException
- if the given groupname does not existpublic boolean removeAllPermissionsForGroup(String token, String groupname) throws RemoteException
ConfluenceSoapService
removeAllPermissionsForGroup
in interface ConfluenceSoapService
token
- The token identifying the current usergroupname
- The group to delete permissions forNotPermittedException
- if the current user lacks permission to administerRemoteException
- if the given groupname does not existpublic String[] getUserGroups(String token, String username) throws RemoteException
ConfluenceSoapService
getUserGroups
in interface ConfluenceSoapService
token
- The token identifying the current userusername
- The username to retrieve groups forNotPermittedException
- if the current user lacks permission to administerInvalidSessionException
RemoteException
- if the given username does not existpublic boolean addUserToGroup(String token, String username, String groupname) throws RemoteException
addUserToGroup
in interface ConfluenceSoapService
NotPermittedException
- if the current user lacks permission to administerInvalidSessionException
RemoteException
- if the given username does not existpublic boolean removeUserFromGroup(String token, String username, String groupname) throws RemoteException
ConfluenceSoapService
removeUserFromGroup
in interface ConfluenceSoapService
token
- The token identifying the current userusername
- The username to remove from a groupgroupname
- The name of the group the user is to be removed fromNotPermittedException
- if the current user lacks permission to administerInvalidSessionException
RemoteException
- if the given username does not existpublic RemoteUser getUser(String token, String username) throws RemoteException
ConfluenceSoapService
getUser
in interface ConfluenceSoapService
token
- The token identifying the current userusername
- The username of the user to be retrievedInvalidSessionException
RemoteException
- if a user with the given username cannot be foundpublic RemoteConfluenceUser getUserByName(String token, String username) throws InvalidSessionException, RemoteException
ConfluenceSoapService
getUserByName
in interface ConfluenceSoapService
token
- The token identifying the current userusername
- The username of the user to be retrievedInvalidSessionException
RemoteException
- if a user with the given username cannot be foundpublic RemoteConfluenceUser getUserByKey(String token, String key) throws InvalidSessionException, RemoteException
ConfluenceSoapService
getUserByKey
in interface ConfluenceSoapService
token
- The token identifying the current userkey
- The user key of the user to be retrievedInvalidSessionException
RemoteException
- if a user with the given user key cannot be foundpublic boolean setUserPreferenceBoolean(String token, String username, String key, boolean value) throws InvalidSessionException, RemoteException
ConfluenceSoapService
setUserPreferenceBoolean
in interface ConfluenceSoapService
token
- the token identifying the current userkey
- The user preference keyvalue
- The valueInvalidSessionException
- If the rpc token expiredRemoteException
- If any other exception occurredpublic boolean getUserPreferenceBoolean(String token, String username, String key) throws InvalidSessionException, RemoteException
ConfluenceSoapService
getUserPreferenceBoolean
in interface ConfluenceSoapService
token
- the token identifying the current userkey
- The user preference keyInvalidSessionException
- If the rpc token expiredRemoteException
- If any other exception occurred (including not being able to find the key)public boolean setUserPreferenceLong(String token, String username, String key, long value) throws InvalidSessionException, RemoteException
ConfluenceSoapService
setUserPreferenceLong
in interface ConfluenceSoapService
token
- the token identifying the current userkey
- The user preference keyvalue
- The valueInvalidSessionException
- If the rpc token expiredRemoteException
- If any other exception occurredpublic long getUserPreferenceLong(String token, String username, String key) throws InvalidSessionException, RemoteException
ConfluenceSoapService
getUserPreferenceLong
in interface ConfluenceSoapService
token
- the token identifying the current userkey
- The user preference keyInvalidSessionException
- If the rpc token expiredRemoteException
- If any other exception occurred (including not being able to find the key)public boolean setUserPreferenceString(String token, String username, String key, String value) throws InvalidSessionException, RemoteException
ConfluenceSoapService
setUserPreferenceString
in interface ConfluenceSoapService
token
- the token identifying the current userkey
- The user preference keyvalue
- The valueInvalidSessionException
- If the rpc token expiredRemoteException
- If any other exception occurredpublic String getUserPreferenceString(String token, String username, String key) throws InvalidSessionException, RemoteException
ConfluenceSoapService
getUserPreferenceString
in interface ConfluenceSoapService
token
- the token identifying the current userkey
- The user preference keyInvalidSessionException
- If the rpc token expiredRemoteException
- If any other exception occurred (including not being able to find the key)public boolean hasUser(String token, String username) throws InvalidSessionException, RemoteException
ConfluenceSoapService
hasUser
in interface ConfluenceSoapService
token
- the token identifying the current userusername
- the username to look upInvalidSessionException
RemoteException
public void addUser(String token, RemoteUser remoteUser, String password) throws RemoteException
ConfluenceSoapService
addUser
in interface ConfluenceSoapService
token
- The token identifying the current userremoteUser
- The object containing the user informationpassword
- The password of the userNotPermittedException
- if the current user lacks permissions to create new usersInvalidSessionException
RemoteException
- if a user with the given username cannot be foundpublic void addUser(String token, RemoteUser remoteUser, String password, boolean notifyUser) throws RemoteException
ConfluenceSoapService
addUser
in interface ConfluenceSoapService
token
- The token identifying the current userremoteUser
- The object containing the user informationpassword
- The password of the usernotifyUser
- Whether or not you want the new user to be notified of their new accountNotPermittedException
- if the current user lacks permissions to create new usersInvalidSessionException
RemoteException
- if a user with the given username cannot be foundpublic boolean removeUser(String token, String username) throws RemoteException
ConfluenceSoapService
removeUser
in interface ConfluenceSoapService
token
- The token identifying the current userusername
- The username of the user to be removedInvalidSessionException
NotPermittedException
- if the current user lacks the permission to remove usersRemoteException
- if the given username cannot be foundpublic boolean editUser(String token, RemoteUser remoteUser) throws NotPermittedException, InvalidSessionException, RemoteException
ConfluenceSoapService
Currently this will only update the user's full name and email
editUser
in interface ConfluenceSoapService
token
- The token identifying the current userremoteUser
- The object containing the user informationNotPermittedException
- if the current user cannot administer users or is not the actual userInvalidSessionException
RemoteException
- if a user with the given username cannot be foundpublic boolean deactivateUser(String token, String username) throws NotPermittedException, InvalidSessionException, RemoteException
ConfluenceSoapService
deactivateUser
in interface ConfluenceSoapService
token
- The token identifying the current userusername
- The username of the user to deactivateNotPermittedException
- if the current user does not have permissions to perform the actionInvalidSessionException
RemoteException
- if the given username cannot be foundpublic boolean reactivateUser(String token, String username) throws NotPermittedException, InvalidSessionException, RemoteException
ConfluenceSoapService
reactivateUser
in interface ConfluenceSoapService
token
- The token identifying the current userusername
- The username of the user to reactivateNotPermittedException
- if the current user does not have permissions to perform the actionInvalidSessionException
RemoteException
- if the given username cannot be foundpublic boolean isActiveUser(String token, String username) throws NotPermittedException, RemoteException
ConfluenceSoapService
isActiveUser
in interface ConfluenceSoapService
username
- The username to checkRemoteException
- If the username does not existNotPermittedException
public String[] getActiveUsers(String token, boolean viewAll) throws InvalidSessionException, RemoteException
ConfluenceSoapService
getActiveUsers
in interface ConfluenceSoapService
token
- The token identifying the current userviewAll
- Whether all users should be shown. When it is false, all users in the default users group will be returned.
Otherwise, every registered user is returned.InvalidSessionException
NotPermittedException
- if the current user does not have administration permissionsRemoteException
public boolean setUserInformation(String token, RemoteUserInformation userInfo) throws NotPermittedException, InvalidSessionException, RemoteException
ConfluenceSoapService
Currently this will only update a user's "description", stored in the 'content' attribute
setUserInformation
in interface ConfluenceSoapService
token
- The token identifying the current useruserInfo
- A RemoteUserInformation object, containing the username, email, fullname, url and informationNotPermittedException
- if the current user cannot administer users or is not the actual userInvalidSessionException
RemoteException
- if there was an error saving the personal informationpublic RemoteUserInformation getUserInformation(String token, String username) throws InvalidSessionException, RemoteException
ConfluenceSoapService
getUserInformation
in interface ConfluenceSoapService
token
- The token identifying the current userusername
- The name of the user to get information onInvalidSessionException
RemoteException
- if a user with the given username cannot be foundpublic boolean changeMyPassword(String token, String oldPass, String newPass) throws InvalidSessionException, RemoteException
ConfluenceSoapService
changeMyPassword
in interface ConfluenceSoapService
token
- The token identifying the current useroldPass
- The old password of the user, required for security purposesnewPass
- The new password for the userInvalidSessionException
NotPermittedException
- if newPass was incorrectRemoteException
- if oldPass does not match the user's passwordpublic boolean changeUserPassword(String token, String username, String newPass) throws NotPermittedException, InvalidSessionException, RemoteException
ConfluenceSoapService
changeUserPassword
in interface ConfluenceSoapService
token
- The token identifying the current userusername
- The username of the user we are changing the password fornewPass
- The new password for the userNotPermittedException
- if the current user does not have permission to administer the userInvalidSessionException
RemoteException
- if the user cannot be foundpublic boolean addProfilePicture(String token, String userName, String fileName, String mimeType, byte[] pictureData) throws NotPermittedException, InvalidSessionException, RemoteException
ConfluenceSoapService
addProfilePicture
in interface ConfluenceSoapService
userName
- The user name of the profilefileName
- File name of the picturemimeType
- Image mime type (must be from image/*)pictureData
- The image dataNotPermittedException
- Principal is not permitted to add pictures to the specified profileInvalidSessionException
RemoteException
- if the user can not be foundpublic boolean renameUser(String token, String oldUsername, String newUsername) throws RemoteException
ConfluenceSoapService
renameUser
in interface ConfluenceSoapService
token
- The token identifying the current useroldUsername
- current username of the usernewUsername
- new username of the userNotPermittedException
- if the current user does not have permissions to perform the actionInvalidSessionException
RemoteException
- if the new username does not meet username requirementspublic String[] renameUsers(String token, Map<String,String> oldUsernamesToNewUsernames) throws RemoteException
ConfluenceSoapService
renameUsers
in interface ConfluenceSoapService
token
- The token identifying the current useroldUsernamesToNewUsernames
- mapping of current usernames to new usernames of usersNotPermittedException
- if the current user does not have permissions to perform the actionInvalidSessionException
RemoteException
- if a new username does not meet username requirementspublic RemoteServerInfo getServerInfo(String token) throws RemoteException
getServerInfo
in interface ConfluenceSoapService
RemoteException
public String exportSpace(String token, String spaceKey, String exportType) throws RemoteException
exportSpace
in interface ConfluenceSoapService
RemoteException
public String exportSpace(String token, String spaceKey, String exportType, boolean exportAll) throws RemoteException
exportSpace
in interface ConfluenceSoapService
RemoteException
public String exportSite(String token, boolean exportAttachments) throws RemoteException
exportSite
in interface ConfluenceSoapService
RemoteException
public String performBackup(String token, boolean exportAttachments) throws RemoteException
performBackup
in interface ConfluenceSoapService
RemoteException
public boolean importSpace(String token, byte[] importData) throws RemoteException
ConfluenceSoapService
importSpace
in interface ConfluenceSoapService
token
- The authentication tokenimportData
- The contents of the Space export fileRemoteException
- If the space exists or the export file is invalidpublic boolean flushIndexQueue(String token) throws RemoteException
flushIndexQueue
in interface ConfluenceSoapService
RemoteException
public boolean clearIndexQueue(String token) throws RemoteException
clearIndexQueue
in interface ConfluenceSoapService
RemoteException
public boolean recoverMainIndex(String token) throws RemoteException
recoverMainIndex
in interface ConfluenceSoapService
RemoteException
public RemoteClusterInformation getClusterInformation(String token) throws RemoteException
getClusterInformation
in interface ConfluenceSoapService
RemoteException
public RemoteNodeStatus[] getClusterNodeStatuses(String token) throws RemoteException
getClusterNodeStatuses
in interface ConfluenceSoapService
RemoteException
public RemoteLabel[] getLabelsById(String token, long objectId) throws RemoteException
ConfluenceSoapService
getLabelsById
in interface ConfluenceSoapService
token
- The token identifying the current userobjectId
- The ID of the ContentEntityObject the method will retrieve the labels forRemoteException
- if the object cannot be retrieved from the ContentEntityManagerpublic RemoteLabel[] getMostPopularLabels(String token, int maxCount) throws RemoteException
ConfluenceSoapService
getMostPopularLabels
in interface ConfluenceSoapService
token
- The token identifying the current usermaxCount
- The maximum number of labels to return. A maxCount of 0 means there is no limit.RemoteException
public RemoteLabel[] getMostPopularLabelsInSpace(String token, String spaceKey, int maxCount) throws RemoteException
ConfluenceSoapService
getMostPopularLabelsInSpace
in interface ConfluenceSoapService
token
- The token identifying the current userspaceKey
- The key of the space to limit the labels tomaxCount
- The maximum number of labels to return. A maxCount of 0 means there is no limit.RemoteException
- if the space cannot be retrieved from the SpaceManagerNotPermittedException
- if the given user does not have VIEW permissions for the spacepublic RemoteLabel[] getRecentlyUsedLabels(String token, int maxResults) throws InvalidSessionException, RemoteException
ConfluenceSoapService
getRecentlyUsedLabels
in interface ConfluenceSoapService
token
- The token identifying the current usermaxResults
- The maximum number of labels to return. A value of 0 means the default is used.InvalidSessionException
RemoteException
public RemoteLabel[] getRecentlyUsedLabelsInSpace(String token, String spaceKey, int maxResults) throws InvalidSessionException, RemoteException
ConfluenceSoapService
getRecentlyUsedLabelsInSpace
in interface ConfluenceSoapService
token
- The token identifying the current userspaceKey
- The key of the space to limit the labels tomaxResults
- The maximum number of labels to return. A value of 0 means the default is used.RemoteException
- if the space does not exist, or the user lacks permission to view itNotPermittedException
- if the given user does not have VIEW permissions for the spaceInvalidSessionException
public RemoteSpace[] getSpacesWithLabel(String token, String labelName) throws InvalidSessionException, RemoteException
ConfluenceSoapService
getSpacesWithLabel
in interface ConfluenceSoapService
token
- The token identifying the current userlabelName
- The name of the label (namespace prefixes permitted)InvalidSessionException
RemoteException
- if labelName is an empty string or nullpublic RemoteLabel[] getRelatedLabels(String token, String labelName, int maxResults) throws InvalidSessionException, RemoteException
ConfluenceSoapService
getRelatedLabels
in interface ConfluenceSoapService
token
- The token identifying the current userlabelName
- 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.RemoteException
- if labelName is an empty string or nullInvalidSessionException
public RemoteLabel[] getRelatedLabelsInSpace(String token, String labelName, String spaceKey, int maxResults) throws InvalidSessionException, RemoteException
ConfluenceSoapService
getRelatedLabelsInSpace
in interface ConfluenceSoapService
token
- The token identifying the current userlabelName
- The name of the label (namespace prefixes permitted)spaceKey
- The key of the space to limit the labels tomaxResults
- The maximum number of labels to return. A maxCount of 0 means the default is used.RemoteException
- if labelName is an empty string or nullInvalidSessionException
public RemoteLabel[] getLabelsByDetail(String token, String labelName, String namespace, String spaceKey, String owner) throws InvalidSessionException, RemoteException, NotPermittedException
ConfluenceSoapService
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.
getLabelsByDetail
in interface ConfluenceSoapService
token
- the authentication token for the userlabelName
- the name of the label to search for (not parsed for prefixes)namespace
- the namespace to restrict byspaceKey
- the key of the space to restrict byowner
- the owner of the labelsInvalidSessionException
RemoteException
- if labelName is an empty string or nullNotPermittedException
Namespace
public RemoteSearchResult[] getLabelContentById(String token, long labelId) throws RemoteException
ConfluenceSoapService
getLabelContentById
in interface ConfluenceSoapService
token
- The token identifying the current userlabelId
- The ID of the labelRemoteException
- if a Label could not be retrieved for the given IDpublic RemoteSearchResult[] getLabelContentByName(String token, String labelName) throws RemoteException
ConfluenceSoapService
getLabelContentByName
in interface ConfluenceSoapService
token
- The token identifying the current userlabelName
- The name of a label (namespace prefixes permitted)RemoteException
- if the label name is nullpublic RemoteSearchResult[] getLabelContentByObject(String token, RemoteLabel labelObject) throws RemoteException
ConfluenceSoapService
getLabelContentByObject
in interface ConfluenceSoapService
token
- The token identifying the current userlabelObject
- The RemoteLabel objectRemoteException
- if the RemoteLabel object is nullpublic RemoteSpace[] getSpacesContainingContentWithLabel(String token, String labelName) throws InvalidSessionException, RemoteException
ConfluenceSoapService
getSpacesContainingContentWithLabel
in interface ConfluenceSoapService
token
- The token identifying the current userlabelName
- The label to retrieve the content for (namespace prefixes permitted)InvalidSessionException
RemoteException
- if labelName is an empty string or nullpublic boolean addLabelByName(String token, String labelName, long objectId) throws NotPermittedException, RemoteException
ConfluenceSoapService
addLabelByName
in interface ConfluenceSoapService
token
- The token identifying the current userlabelName
- The name of the label(s) to be added to the ContentEntityObject, in the form of a space-separated stringobjectId
- The ID of the ContentEntityObject the method will act onNotPermittedException
- if the user lacks EDIT permissions for the objectRemoteException
- if the label name is null or an empty Stringpublic boolean addLabelById(String token, long labelId, long objectId) throws NotPermittedException, RemoteException
ConfluenceSoapService
addLabelById
in interface ConfluenceSoapService
token
- The token identifying the current userlabelId
- The ID of the label to be added to the ContentEntityObjectobjectId
- The ID of the ContentEntityObject the method will act onNotPermittedException
- if the user lacks EDIT permissions for the objectRemoteException
- if a Label could not be retrieved for the given IDpublic boolean addLabelByObject(String token, RemoteLabel labelObject, long objectId) throws NotPermittedException, RemoteException
ConfluenceSoapService
addLabelByObject
in interface ConfluenceSoapService
token
- The token identifying the current userlabelObject
- The label to be added to the ContentEntityObjectobjectId
- The ID of the ContentEntityObject the method will act onNotPermittedException
- if the user lacks EDIT permissions for the objectRemoteException
- if the given RemoteLabel object is nullpublic boolean addLabelByNameToSpace(String token, String labelName, String spaceKey) throws NotPermittedException, InvalidSessionException, RemoteException
ConfluenceSoapService
addLabelByNameToSpace
in interface ConfluenceSoapService
token
- The token identifying the current userlabelName
- The name of the label(s) to be added to the Space, in the form of a space-separated stringspaceKey
- The Space to add the label toNotPermittedException
- if the user does not have permission to add the labelRemoteException
- if the label name is null or an empty StringInvalidSessionException
public boolean removeLabelByName(String token, String labelName, long objectId) throws NotPermittedException, RemoteException
ConfluenceSoapService
removeLabelByName
in interface ConfluenceSoapService
token
- The token identifying the current userlabelName
- The name of the label(s) to be removed from the ContentEntityObject, in the form of a space-separated StringobjectId
- The ID of the ContentEntityObject the method will act onNotPermittedException
- if the user lacks EDIT permissions for the objectRemoteException
- if the label name is nullpublic boolean removeLabelById(String token, long labelId, long objectId) throws NotPermittedException, RemoteException
ConfluenceSoapService
removeLabelById
in interface ConfluenceSoapService
token
- The token identifying the current userlabelId
- The ID of the label to be removed from the ContentEntityObjectobjectId
- The ID of the ContentEntityObject the method will act onNotPermittedException
- if the user lacks EDIT permissions for the objectRemoteException
- if a Label could not be retrieved for the given IDpublic boolean removeLabelByObject(String token, RemoteLabel labelObject, long objectId) throws NotPermittedException, RemoteException
ConfluenceSoapService
removeLabelByObject
in interface ConfluenceSoapService
token
- The token identifying the current userlabelObject
- The label to be removed from the ContentEntityObjectobjectId
- The ID of the ContentEntityObject the method will act onNotPermittedException
- if the user lacks EDIT permissions for the objectRemoteException
- if the RemoteLabel object is nullpublic boolean removeLabelByNameFromSpace(String token, String labelName, String spaceKey) throws NotPermittedException, InvalidSessionException, RemoteException
ConfluenceSoapService
removeLabelByNameFromSpace
in interface ConfluenceSoapService
token
- The token identifying the current userlabelName
- The name of the label(s) to be removed from the Space, in the form of a space-separated StringspaceKey
- The Space the method will act onNotPermittedException
- if the user lacks EDIT permissions for the SpaceRemoteException
- if the label name is nullInvalidSessionException
public RemoteContentPermissionSet[] getContentPermissionSets(String token, long contentId) throws NotPermittedException, InvalidSessionException, RemoteException
ConfluenceSoapService
getContentPermissionSets
in interface ConfluenceSoapService
token
- the login token for the current usercontentId
- the content ID of the content to be looked upNotPermittedException
- if the content can not be found, or can not be accessed by the current userInvalidSessionException
- if no login session can be found for the supplied tokenRemoteException
- if something random goes wrongpublic RemoteContentPermissionSet getContentPermissionSet(String token, long contentId, String permissionType) throws NotPermittedException, InvalidSessionException, RemoteException
ConfluenceSoapService
getContentPermissionSet
in interface ConfluenceSoapService
token
- the login token for the current usercontentId
- the content ID of the content to be looked uppermissionType
- type of content permissionNotPermittedException
- if the content can not be found, or can not be accessed by the current userInvalidSessionException
- if no login session can be found for the supplied tokenRemoteException
- if something random goes wrongpublic boolean setContentPermissions(String token, long contentId, String permissionType, RemoteContentPermission[] remoteContentPermissions) throws NotPermittedException, InvalidSessionException, RemoteException
ConfluenceSoapService
setContentPermissions
in interface ConfluenceSoapService
token
- the login tokencontentId
- the id of the content to have permissions set on itpermissionType
- the type of the permissions (one of the constants from ContentPermission
)remoteContentPermissions
- the permissions to setNotPermittedException
- if the content can not be found or can not be accessed by the current userInvalidSessionException
- if no login session can be found for the supplied tokenRemoteException
- if something random goes wrong@Deprecated public boolean setEnableWysiwyg(String token, boolean value) throws RemoteException
setEnableWysiwyg
in interface ConfluenceSoapService
RemoteException
public boolean setEnableAnonymousAccess(String token, boolean value) throws RemoteException
setEnableAnonymousAccess
in interface ConfluenceSoapService
RemoteException
public boolean isPluginEnabled(String token, String pluginKey) throws RemoteException
ConfluenceSoapService
isPluginEnabled
in interface ConfluenceSoapService
RemoteException
public boolean isPluginInstalled(String token, String pluginKey) throws RemoteException
ConfluenceSoapService
isPluginInstalled
in interface ConfluenceSoapService
RemoteException
public boolean installPlugin(String token, String pluginFileName, byte[] pluginData) throws RemoteException
ConfluenceSoapService
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[] containing the contents of the plugin xml or jar file.RemoteException
public boolean isDarkFeatureEnabled(String token, String key) throws RemoteException
isDarkFeatureEnabled
in interface ConfluenceSoapService
RemoteException
public boolean startActivity(String token, String key, String user) throws RemoteException
ConfluenceSoapService
startActivity
in interface ConfluenceSoapService
token
- rpc authentication tokenkey
- the activity key to startuser
- the username of the user starting the activityRemoteException
public boolean stopActivity(String token, String key, String user) throws RemoteException
ConfluenceSoapService
stopActivity
in interface ConfluenceSoapService
token
- rpc authentication tokenkey
- the activity key to stopuser
- the username of the user stopping the activityRemoteException
public void setWikiToXhtmlMigrator(ExceptionTolerantMigrator wikiToXhtmlMigrator)
public void setXhtmlRoundTripMigrator(ExceptionTolerantMigrator xhtmlRoundTripMigrator)
public void setContentEntityObjectDao(ContentEntityObjectDao contentEntityObjectDao)
public void setMailServerManager(com.atlassian.mail.server.MailServerManager mailServerManager)
Copyright © 2003–2017 Atlassian. All rights reserved.