XWiki (CONFLUENCE-REPORTING::Core - 6.0-rc1 6.0-rc1 API)

java.lang.Object
- org.bsc.confluence.xmlrpc.XWiki

```
public class XWiki
extends Object
```
Version:

$Revision$ $Date$

Field Summary

Fields
Modifier and Type Field and Description

protected boolean sendRawData

protected static String SERVICE_PREFIX_1

Fields
Modifier and Type	Field and Description
`protected boolean`	`sendRawData`
`protected static String`	`SERVICE_PREFIX_1`

Constructor Summary

Constructors
Constructor and Description

XWiki(String endpoint, ConfluenceProxy proxyInfo)

Constructors
Constructor and Description
`XWiki(String endpoint, ConfluenceProxy proxyInfo)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`addAnonymousPermissionsToSpace(List permissions, String spaceKey)` Give anonymous users the permissions {{permissions}} on the space with the key {{spaceKey}}.
`boolean`	`addAnonymousPermissionToSpace(String permission, String spaceKey)` Give anonymous users the permission {{permission}} on the space with the key {{spaceKey}}.
`org.bsc.confluence.xmlrpc.Attachment`	`addAttachment(long contentId, org.bsc.confluence.xmlrpc.Attachment attachment, byte[] attachmentData)` add a new attachment to a content entity object.
`Comment`	`addComment(Comment comment)` adds a comment to the page.
`void`	`addGroup(String group)` add a new group
`boolean`	`addLabelById(long labelId, long objectId)` Adds a label with the given ID to the object with the given ContentEntityObject ID.
`boolean`	`addLabelByName(String labelName, long objectId)` Adds a label to the object with the given ContentEntityObject ID.
`boolean`	`addLabelByNameToSpace(String labelName, String spaceKey)` Adds a label to the object with the given ContentEntityObject ID.
`boolean`	`addLabelByObject(Label labelObject, long objectId)` Adds the given label object to the object with the given ContentEntityObject ID.
`boolean`	`addPermissionsToSpace(List permissions, String remoteEntityName, String spaceKey)` Give the entity named {{remoteEntityName}} (either a group or a user) the permissions {{permissions}} on the space with the key {{spaceKey}}.
`boolean`	`addPermissionToSpace(String permission, String remoteEntityName, String spaceKey)` Give the entity named {{remoteEntityName}} (either a group or a user) the permission {{permission}} on the space with the key {{spaceKey}}.
`Space`	`addSpace(Space space)` create a new space, passing in name, key and description.
`void`	`addUser(User user, String password)` add a new user with the given password
`void`	`addUserToGroup(String username, String groupname)` add a user to a particular group
`boolean`	`changeMyPassword(String oldPass, String newPass)` changes the current user's password
`boolean`	`changeUserPassword(String username, String newPass)` changes the specified user's password
`boolean`	`deactivateUser(String username)` deactivates the specified user
`boolean`	`editUser(User remoteUser)` edits the details of a user
`String`	`exportSite(boolean exportAttachments)` exports a Confluence instance and returns a String holding the URL for the download.
`String`	`exportSpace(String spaceKey, String exportType)` exports a space and returns a String holding the URL for the download.
`List`	`getActiveUsers(boolean viewAll)` returns all registered users as Strings
`List`	`getAncestors(String pageId)` returns all the ancestors (as `PageSummary` instances) of this page (parent, parent's parent etc).
`org.bsc.confluence.xmlrpc.Attachment`	`getAttachment(String pageId, String fileName, String versionNumber)` get information about an attachment.
`byte[]`	`getAttachmentData(String pageId, String fileName, String versionNumber)` get the contents of an attachment.
`List`	`getAttachments(String pageId)` returns all the `Attachment`s for this page (useful to point users to download them with the full file download URL returned).
`List`	`getBlogEntries(String spaceKey)` returns all the `BlogEntrySummary` instances in the space.
`BlogEntry`	`getBlogEntry(String pageId)` returns a single BlogEntry.
`BlogEntry`	`getBlogEntryByDayAndTitle(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'.
`List`	`getChildren(String pageId)` returns all the direct children (as `PageSummary` instances) of this page.
`Comment`	`getComment(String commentId)` returns an individual comment.
`List`	`getComments(String pageId)` returns all the `Comment`s for this page.
`List`	`getDescendents(String pageId)` returns all the descendents (as `PageSummary` instances) of this page (children, children's children etc).
`List`	`getGroups()` gets all groups as a list of `String`s
`List`	`getLabelContentById(long labelId)` Returns the content for a given label ID
`List`	`getLabelContentByName(String labelName)` Returns the content for a given label name.
`List`	`getLabelContentByObject(Label labelObject)` Returns the content for a given Label object.
`List`	`getLabelsByDetail(String labelName, String namespace, String spaceKey, String owner)` Retrieves the `Label`s matching the given {{labelName}}, {{namespace}}, {{spaceKey}} or {{owner}}.
`List`	`getLabelsById(long objectId)` Returns all `Label`s for the given ContentEntityObject ID
`List`	`getMostPopularLabels(int maxCount)` Returns the most popular `Label`s for the Confluence instance, with a specified maximum number.
`List`	`getMostPopularLabelsInSpace(String spaceKey, int maxCount)` Returns the most popular `Label`s for the given {{spaceKey}}, with a specified maximum number of results.
`org.bsc.confluence.xmlrpc.Page`	`getPage(org.bsc.confluence.xmlrpc.PageSummary summary)` returns a single Page
`org.bsc.confluence.xmlrpc.Page`	`getPage(String pageId)`
`org.bsc.confluence.xmlrpc.Page`	`getPage(String spaceKey, String pageTitle)` returns a single Page
`List`	`getPageHistory(String pageId)` returns all the `PageHistorySummary` instances - useful for looking up the previous versions of a page, and who changed them.
`List`	`getPagePermissions(String pageId)` Returns a List of `Permission`s representing the permissions set on the given page.
`List`	`getPages(String spaceKey)` returns all the `PageSummary` instances in the space.
`List`	`getPermissions(String spaceKey)` Returns a List of `Permission`s representing the permissions the current user has for this space (a list of "view", "modify", "comment" and / or "admin").
`List`	`getPermissionsForUser(String spaceKey, String userName)` Returns a List of `Permission`s representing the permissions the given user has for this space.
`List`	`getRecentlyUsedLabels(int maxResults)` Returns the recently used `Label`s for the Confluence instance, with a specified maximum number of results.
`List`	`getRecentlyUsedLabelsInSpace(String spaceKey, int maxResults)` Returns the recently used `Label`s for the given {{spaceKey}}, with a specified maximum number of results.
`List`	`getRelatedLabels(String labelName, int maxResults)` Returns the `Label`s related to the given label name, with a specified maximum number of results.
`List`	`getRelatedLabelsInSpace(String labelName, String spaceKey, int maxResults)` Returns the `Label`s related to the given label name for the given {{spaceKey}}, with a specified maximum number of results.
`ServerInfo`	`getServerInfo()` retrieve some basic information about the server being connected to.
`protected String`	`getServicePrefix()`
`Space`	`getSpace(String spaceKey)` returns a single Space.
`List`	`getSpaceLevelPermissions()` returns List of the space level `Permission`s which may be granted.
`List`	`getSpaces()` returns all the `SpaceSummary` instances that the current user can see.
`List`	`getSpacesContainingContentWithLabel(String labelName)` Returns all Spaces that have content labelled with {{labelName}}.
`List`	`getSpacesWithLabel(String labelName)` Returns an array of `Space`s that have been labelled with {{labelName}}.
`User`	`getUser(String username)` get a single user
`List`	`getUserGroups(String username)` get a user's current groups as a list of `String`s
`UserInformation`	`getUserInformation(String username)` Retrieves user information
`boolean`	`hasGroup(String groupname)` checks if a group exists
`boolean`	`hasUser(String username)` checks if a user exists
`void`	`login(String username, String password)`
`boolean`	`logout()` remove this token from the list of logged in tokens.
`boolean`	`moveAttachment(String originalContentId, String originalName, String newContentEntityId, String newName)` move an attachment to a different content entity object and/or give it a new name.
`boolean`	`reactivateUser(String username)` reactivates the specified user
`boolean`	`removeAllPermissionsForGroup(String groupname)` Remove all the global and space level permissions for {{groupname}}.
`boolean`	`removeAnonymousPermissionFromSpace(String permission, String spaceKey)` Remove the permission {{permission} from anonymous users on the space with the key {{spaceKey}}.
`boolean`	`removeAttachment(String contentId, String fileName)` remove an attachment from a content entity object.
`boolean`	`removeComment(String commentId)` removes a comment from the page.
`boolean`	`removeGroup(String groupname, String defaultGroupName)` remove a group.
`boolean`	`removeLabelById(long labelId, long objectId)` Removes the label with the given ID from the object with the given ContentEntityObject ID.
`boolean`	`removeLabelByName(String labelName, long objectId)` Removes the given label from the object with the given ContentEntityObject ID.
`boolean`	`removeLabelByNameFromSpace(String labelName, String spaceKey)` Removes the given label from the given {{spaceKey}}.
`boolean`	`removeLabelByObject(Label labelObject, long objectId)` Removes the given label object from the object with the given ContentEntityObject ID.
`void`	`removePage(String pageId)` remove a page
`boolean`	`removePermissionFromSpace(String permission, String remoteEntityName, String spaceKey)` Remove the permission {{permission} from the entity named {{remoteEntityName}} (either a group or a user) on the space with the key {{spaceKey}}.
`Boolean`	`removeSpace(String spaceKey)` remove a space completely.
`boolean`	`removeUser(String username)` delete a user.
`boolean`	`removeUserFromGroup(String username, String groupname)` remove a user from a group.
`String`	`renderContent(org.bsc.confluence.xmlrpc.PageSummary page)`
`String`	`renderContent(String spaceKey, String pageId)`
`String`	`renderContent(String spaceKey, String pageId, String content)` returns the HTML rendered content for this page.
`String`	`renderContent(String spaceKey, String pageId, String content, Map parameters)` Like the above renderContent(), but you can supply an optional hash (map, dictionary, etc) containing additional instructions for the renderer.
`List`	`search(String query, int maxResults)` return a list of `SearchResult`s which match a given search query (including pages and other content types).
`List`	`search(String query, Map parameters, int maxResults)` Returns a list of `SearchResult`s like the previous search, but you can optionally limit your search by adding parameters to the parameter map.
`void`	`sendRawData(boolean sendRawData)`
`boolean`	`setUserInformation(UserInformation userInfo)` updates user information
`BlogEntry`	`storeBlogEntry(BlogEntry entry)` add or update a blog entry.
`org.bsc.confluence.xmlrpc.Page`	`storePage(org.bsc.confluence.xmlrpc.Page page)` add or update a page.
`boolean`	`willSendRawData()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

SERVICE_PREFIX_1

protected static final String SERVICE_PREFIX_1

See Also:: Constant Field Values

sendRawData
```
protected boolean sendRawData
```

Constructor Detail

XWiki

public XWiki(String endpoint,
             ConfluenceProxy proxyInfo)
      throws MalformedURLException,
             URISyntaxException

Throws:: MalformedURLException; URISyntaxException

Method Detail

getServicePrefix
```
protected String getServicePrefix()
```

willSendRawData
```
public boolean willSendRawData()
```

sendRawData

public void sendRawData(boolean sendRawData)

login

public void login(String username,
                  String password)
           throws Exception

Throws:: Exception

logout
```
public boolean logout()
               throws Exception
```
remove this token from the list of logged in tokens. Returns true if the user was logged out, false if they were not logged in in the first place (we don't really need this return, but void seems to kill XML-RPC for me)

Throws:

Exception

exportSite
```
public String exportSite(boolean exportAttachments)
                  throws Exception
```
exports a Confluence instance and returns a String holding the URL for the download. The boolean argument indicates whether or not attachments ought to be included in the export.

Throws:

Exception

getServerInfo
```
public ServerInfo getServerInfo()
                         throws Exception
```
retrieve some basic information about the server being connected to. Useful for clients that need to turn certain features on or off depending on the version of the server. (Since 1.0.3)

Throws:

Exception

getSpaces
```
public List getSpaces()
               throws Exception
```
returns all the SpaceSummary instances that the current user can see.

Throws:

Exception

getSpace

public Space getSpace(String spaceKey)
               throws Exception

returns a single Space.

Throws:: Exception

exportSpace
```
public String exportSpace(String spaceKey,
                          String exportType)
                   throws Exception
```
exports a space and returns a String holding the URL for the download. The export type argument indicates whether or not to export in XML, PDF, or HTML format - use "TYPE_XML", "TYPE_PDF", or "TYPE_HTML" respectively. Also, using "all" will select TYPE_XML.

Throws:

Exception

addSpace
```
public Space addSpace(Space space)
               throws Exception
```
create a new space, passing in name, key and description.

Throws:

Exception

removeSpace

public Boolean removeSpace(String spaceKey)
                    throws Exception

remove a space completely.

Throws:: Exception

getPages
```
public List getPages(String spaceKey)
              throws Exception
```
returns all the PageSummary instances in the space. Doesn't include pages which are in the Trash. Equivalent to calling {{Space.getCurrentPages()}}.

Throws:

Exception

getPage

public org.bsc.confluence.xmlrpc.Page getPage(org.bsc.confluence.xmlrpc.PageSummary summary)
                                       throws Exception

returns a single Page

Throws:: Exception

getPage

public org.bsc.confluence.xmlrpc.Page getPage(String pageId)
                                       throws Exception

Throws:: Exception

getPage

public org.bsc.confluence.xmlrpc.Page getPage(String spaceKey,
                                              String pageTitle)
                                       throws Exception

returns a single Page

Throws:: Exception

getPageHistory
```
public List getPageHistory(String pageId)
                    throws Exception
```
returns all the PageHistorySummary instances - useful for looking up the previous versions of a page, and who changed them.

Throws:

Exception

getAttachments
```
public List getAttachments(String pageId)
                    throws Exception
```
returns all the Attachments for this page (useful to point users to download them with the full file download URL returned).

Throws:

Exception

getAncestors
```
public List getAncestors(String pageId)
                  throws Exception
```
returns all the ancestors (as PageSummary instances) of this page (parent, parent's parent etc).

Throws:

Exception

getChildren
```
public List getChildren(String pageId)
                 throws Exception
```
returns all the direct children (as PageSummary instances) of this page.

Throws:

Exception

getDescendents
```
public List getDescendents(String pageId)
                    throws Exception
```
returns all the descendents (as PageSummary instances) of this page (children, children's children etc).

Throws:

Exception

getComments

public List getComments(String pageId)
                 throws Exception

returns all the Comments for this page.

Throws:: Exception

getComment

public Comment getComment(String commentId)
                   throws Exception

returns an individual comment.

Throws:: Exception

addComment

public Comment addComment(Comment comment)
                   throws Exception

adds a comment to the page.

Throws:: Exception

removeComment

public boolean removeComment(String commentId)
                      throws Exception

removes a comment from the page.

Throws:: Exception

storePage
```
public org.bsc.confluence.xmlrpc.Page storePage(org.bsc.confluence.xmlrpc.Page page)
                                         throws Exception
```
add or update a page. For adding, the Page given as an argument should have space, title and content fields at a minimum. For updating, the Page given should have id, space, title, content and version fields at a minimum. The parentId field is always optional. All other fields will be ignored.

Throws:

Exception

renderContent
```
public String renderContent(String spaceKey,
                            String pageId,
                            String content)
                     throws Exception
```
returns the HTML rendered content for this page. If 'content' is provided, then that is rendered as if it were the body of the page (useful for a 'preview page' function). If it's not provided, then the existing content of the page is used instead (ie useful for 'view page' function).

Throws:

Exception

renderContent

public String renderContent(String spaceKey,
                            String pageId)
                     throws Exception

Throws:: Exception

renderContent

public String renderContent(org.bsc.confluence.xmlrpc.PageSummary page)
                     throws Exception

Throws:: Exception

renderContent

public String renderContent(String spaceKey,
                            String pageId,
                            String content,
                            Map parameters)
                     throws Exception

Like the above renderContent(), but you can supply an optional hash (map, dictionary, etc) containing additional instructions for the renderer. Currently, only one such parameter is supported:

Throws:: Exception

removePage

public void removePage(String pageId)
                throws Exception

remove a page

Throws:: Exception

getAttachment

public org.bsc.confluence.xmlrpc.Attachment getAttachment(String pageId,
                                                          String fileName,
                                                          String versionNumber)
                                                   throws Exception

get information about an attachment.

Throws:: Exception

getAttachmentData

public byte[] getAttachmentData(String pageId,
                                String fileName,
                                String versionNumber)
                         throws Exception

get the contents of an attachment.

Throws:: Exception

addAttachment

public org.bsc.confluence.xmlrpc.Attachment addAttachment(long contentId,
                                                          org.bsc.confluence.xmlrpc.Attachment attachment,
                                                          byte[] attachmentData)
                                                   throws Exception

add a new attachment to a content entity object. *Note that this uses a lot of memory -- about 4 times the size of the attachment.*

Throws:: Exception

removeAttachment

public boolean removeAttachment(String contentId,
                                String fileName)
                         throws Exception

remove an attachment from a content entity object.

Throws:: Exception

moveAttachment

public boolean moveAttachment(String originalContentId,
                              String originalName,
                              String newContentEntityId,
                              String newName)
                       throws Exception

move an attachment to a different content entity object and/or give it a new name.

Throws:: Exception

getBlogEntries

public List getBlogEntries(String spaceKey)
                    throws Exception

returns all the BlogEntrySummary instances in the space.

Throws:: Exception

getBlogEntry

public BlogEntry getBlogEntry(String pageId)
                       throws Exception

returns a single BlogEntry.

Throws:: Exception

storeBlogEntry
```
public BlogEntry storeBlogEntry(BlogEntry entry)
                         throws Exception
```
add or update a blog entry. For adding, the BlogEntry given as an argument should have space, title and content fields at a minimum. For updating, the BlogEntry given should have id, space, title, content and version fields at a minimum. All other fields will be ignored.

Throws:

Exception

getBlogEntryByDayAndTitle

public BlogEntry getBlogEntryByDayAndTitle(String spaceKey,
                                           int dayOfMonth,
                                           String postTitle)
                                    throws Exception

Retrieves a blog post in the Space with the given spaceKey, with the title 'postTitle' and posted on the day 'dayOfMonth'.

Throws:: Exception

search
```
public List search(String query,
                   int maxResults)
            throws Exception
```
return a list of SearchResults which match a given search query (including pages and other content types). This is the same as a performing a parameterised search (see below) with an empty parameter map.

Throws:

Exception

search
```
public List search(String query,
                   Map parameters,
                   int maxResults)
            throws Exception
```
Returns a list of SearchResults like the previous search, but you can optionally limit your search by adding parameters to the parameter map. If you do not include a parameter, the default is used instead.

Throws:

Exception

getPermissions
```
public List getPermissions(String spaceKey)
                    throws Exception
```
Returns a List of Permissions representing the permissions the current user has for this space (a list of "view", "modify", "comment" and / or "admin").

Throws:

Exception

getPermissionsForUser

public List getPermissionsForUser(String spaceKey,
                                  String userName)
                           throws Exception

Returns a List of Permissions representing the permissions the given user has for this space. (since 2.1.4)

Throws:: Exception

getPagePermissions
```
public List getPagePermissions(String pageId)
                        throws Exception
```
Returns a List of Permissions representing the permissions set on the given page.

Throws:

Exception

getSpaceLevelPermissions
```
public List getSpaceLevelPermissions()
                              throws Exception
```
returns List of the space level Permissions which may be granted. This is a list of possible permissions to use with {{addPermissionToSpace}}, below, not a list of current permissions on a Space.

Throws:

Exception

addPermissionToSpace

public boolean addPermissionToSpace(String permission,
                                    String remoteEntityName,
                                    String spaceKey)
                             throws Exception

Give the entity named {{remoteEntityName}} (either a group or a user) the permission {{permission}} on the space with the key {{spaceKey}}.

Throws:: Exception

addPermissionsToSpace

public boolean addPermissionsToSpace(List permissions,
                                     String remoteEntityName,
                                     String spaceKey)
                              throws Exception

Give the entity named {{remoteEntityName}} (either a group or a user) the permissions {{permissions}} on the space with the key {{spaceKey}}.

Throws:: Exception

removePermissionFromSpace

public boolean removePermissionFromSpace(String permission,
                                         String remoteEntityName,
                                         String spaceKey)
                                  throws Exception

Remove the permission {{permission} from the entity named {{remoteEntityName}} (either a group or a user) on the space with the key {{spaceKey}}.

Throws:: Exception

addAnonymousPermissionToSpace

public boolean addAnonymousPermissionToSpace(String permission,
                                             String spaceKey)
                                      throws Exception

Give anonymous users the permission {{permission}} on the space with the key {{spaceKey}}. (since 2.0)

Throws:: Exception

addAnonymousPermissionsToSpace

public boolean addAnonymousPermissionsToSpace(List permissions,
                                              String spaceKey)
                                       throws Exception

Give anonymous users the permissions {{permissions}} on the space with the key {{spaceKey}}. (since 2.0)

Throws:: Exception

removeAnonymousPermissionFromSpace

public boolean removeAnonymousPermissionFromSpace(String permission,
                                                  String spaceKey)
                                           throws Exception

Remove the permission {{permission} from anonymous users on the space with the key {{spaceKey}}. (since 2.0)

Throws:: Exception

removeAllPermissionsForGroup

public boolean removeAllPermissionsForGroup(String groupname)
                                     throws Exception

Remove all the global and space level permissions for {{groupname}}.

Throws:: Exception

getUser

public User getUser(String username)
             throws Exception

get a single user

Throws:: Exception

addUser

public void addUser(User user,
                    String password)
             throws Exception

add a new user with the given password

Throws:: Exception

addGroup

public void addGroup(String group)
              throws Exception

add a new group

Throws:: Exception

getUserGroups

public List getUserGroups(String username)
                   throws Exception

get a user's current groups as a list of Strings

Throws:: Exception

addUserToGroup

public void addUserToGroup(String username,
                           String groupname)
                    throws Exception

add a user to a particular group

Throws:: Exception

removeUserFromGroup

public boolean removeUserFromGroup(String username,
                                   String groupname)
                            throws Exception

remove a user from a group.

Throws:: Exception

removeUser

public boolean removeUser(String username)
                   throws Exception

delete a user.

Throws:: Exception

removeGroup

public boolean removeGroup(String groupname,
                           String defaultGroupName)
                    throws Exception

remove a group. If {{defaultGroupName}} is specified, users belonging to {{groupname}} will be added to {{defaultGroupName}}.

Throws:: Exception

getGroups

public List getGroups()
               throws Exception

gets all groups as a list of Strings

Throws:: Exception

hasUser

public boolean hasUser(String username)
                throws Exception

checks if a user exists

Throws:: Exception

hasGroup

public boolean hasGroup(String groupname)
                 throws Exception

checks if a group exists

Throws:: Exception

editUser

public boolean editUser(User remoteUser)
                 throws Exception

edits the details of a user

Throws:: Exception

deactivateUser

public boolean deactivateUser(String username)
                       throws Exception

deactivates the specified user

Throws:: Exception

reactivateUser

public boolean reactivateUser(String username)
                       throws Exception

reactivates the specified user

Throws:: Exception

getActiveUsers

public List getActiveUsers(boolean viewAll)
                    throws Exception

returns all registered users as Strings

Throws:: Exception

setUserInformation

public boolean setUserInformation(UserInformation userInfo)
                           throws Exception

updates user information

Throws:: Exception

getUserInformation

public UserInformation getUserInformation(String username)
                                   throws Exception

Retrieves user information

Throws:: Exception

changeMyPassword

public boolean changeMyPassword(String oldPass,
                                String newPass)
                         throws Exception

changes the current user's password

Throws:: Exception

changeUserPassword

public boolean changeUserPassword(String username,
                                  String newPass)
                           throws Exception

changes the specified user's password

Throws:: Exception

getLabelsById

public List getLabelsById(long objectId)
                   throws Exception

Returns all Labels for the given ContentEntityObject ID

Throws:: Exception

getMostPopularLabels
```
public List getMostPopularLabels(int maxCount)
                          throws Exception
```
Returns the most popular Labels for the Confluence instance, with a specified maximum number.

Throws:

Exception

getMostPopularLabelsInSpace

public List getMostPopularLabelsInSpace(String spaceKey,
                                        int maxCount)
                                 throws Exception

Returns the most popular Labels for the given {{spaceKey}}, with a specified maximum number of results.

Throws:: Exception

getRecentlyUsedLabels
```
public List getRecentlyUsedLabels(int maxResults)
                           throws Exception
```
Returns the recently used Labels for the Confluence instance, with a specified maximum number of results.

Throws:

Exception

getRecentlyUsedLabelsInSpace

public List getRecentlyUsedLabelsInSpace(String spaceKey,
                                         int maxResults)
                                  throws Exception

Returns the recently used Labels for the given {{spaceKey}}, with a specified maximum number of results.

Throws:: Exception

getSpacesWithLabel
```
public List getSpacesWithLabel(String labelName)
                        throws Exception
```
Returns an array of Spaces that have been labelled with {{labelName}}.

Throws:

Exception

getRelatedLabels

public List getRelatedLabels(String labelName,
                             int maxResults)
                      throws Exception

Returns the Labels related to the given label name, with a specified maximum number of results.

Throws:: Exception

getRelatedLabelsInSpace

public List getRelatedLabelsInSpace(String labelName,
                                    String spaceKey,
                                    int maxResults)
                             throws Exception

Returns the Labels related to the given label name for the given {{spaceKey}}, with a specified maximum number of results.

Throws:: Exception

getLabelsByDetail

public List getLabelsByDetail(String labelName,
                              String namespace,
                              String spaceKey,
                              String owner)
                       throws Exception

Retrieves the Labels matching the given {{labelName}}, {{namespace}}, {{spaceKey}} or {{owner}}.

Throws:: Exception

getLabelContentById

public List getLabelContentById(long labelId)
                         throws Exception

Returns the content for a given label ID

Throws:: Exception

getLabelContentByName

public List getLabelContentByName(String labelName)
                           throws Exception

Returns the content for a given label name.

Throws:: Exception

getLabelContentByObject

public List getLabelContentByObject(Label labelObject)
                             throws Exception

Returns the content for a given Label object.

Throws:: Exception

getSpacesContainingContentWithLabel

public List getSpacesContainingContentWithLabel(String labelName)
                                         throws Exception

Returns all Spaces that have content labelled with {{labelName}}.

Throws:: Exception

addLabelByName

public boolean addLabelByName(String labelName,
                              long objectId)
                       throws Exception

Adds a label to the object with the given ContentEntityObject ID.

Throws:: Exception

addLabelById

public boolean addLabelById(long labelId,
                            long objectId)
                     throws Exception

Adds a label with the given ID to the object with the given ContentEntityObject ID.

Throws:: Exception

addLabelByObject

public boolean addLabelByObject(Label labelObject,
                                long objectId)
                         throws Exception

Adds the given label object to the object with the given ContentEntityObject ID.

Throws:: Exception

addLabelByNameToSpace

public boolean addLabelByNameToSpace(String labelName,
                                     String spaceKey)
                              throws Exception

Adds a label to the object with the given ContentEntityObject ID.

Throws:: Exception

removeLabelByName

public boolean removeLabelByName(String labelName,
                                 long objectId)
                          throws Exception

Removes the given label from the object with the given ContentEntityObject ID.

Throws:: Exception

removeLabelById

public boolean removeLabelById(long labelId,
                               long objectId)
                        throws Exception

Removes the label with the given ID from the object with the given ContentEntityObject ID.

Throws:: Exception

removeLabelByObject

public boolean removeLabelByObject(Label labelObject,
                                   long objectId)
                            throws Exception

Removes the given label object from the object with the given ContentEntityObject ID.

Throws:: Exception

removeLabelByNameFromSpace

public boolean removeLabelByNameFromSpace(String labelName,
                                          String spaceKey)
                                   throws Exception

Removes the given label from the given {{spaceKey}}.

Throws:: Exception

Class XWiki

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

SERVICE_PREFIX_1

sendRawData

Constructor Detail

XWiki

Method Detail

getServicePrefix

willSendRawData

sendRawData

login

logout

exportSite

getServerInfo

getSpaces

getSpace

exportSpace

addSpace

removeSpace

getPages

getPage

getPage

getPage

getPageHistory

getAttachments

getAncestors

getChildren

getDescendents

getComments

getComment

addComment

removeComment

storePage

renderContent

renderContent

renderContent

renderContent

removePage

getAttachment

getAttachmentData

addAttachment

removeAttachment

moveAttachment

getBlogEntries

getBlogEntry

storeBlogEntry

getBlogEntryByDayAndTitle

search

search

getPermissions

getPermissionsForUser

getPagePermissions

getSpaceLevelPermissions

addPermissionToSpace

addPermissionsToSpace

removePermissionFromSpace

addAnonymousPermissionToSpace

addAnonymousPermissionsToSpace

removeAnonymousPermissionFromSpace

removeAllPermissionsForGroup

getUser

addUser

addGroup

getUserGroups

addUserToGroup

removeUserFromGroup

removeUser

removeGroup

getGroups

hasUser

hasGroup

editUser

deactivateUser

reactivateUser

getActiveUsers

setUserInformation