Interface FuncTestRpcHandler

    • Method Detail

      • logMessage

        @Deprecated
        boolean logMessage​(String token,
                           String destination,
                           String message)
                    throws RemoteException
        Deprecated.
        since 5.6. Use a FuncTestAdminLoggingResource REST call.
        Log a message to the server's console.

        Only administrators can log messages.

        The destination of the message has the following valid values:

        • info - message will be logged at INFO level
        • debug - message will be logged at DEBUG level
        • warn - message will be logged at WARN level
        • error - message will be logged at ERROR level
        • sout - message will be written via System.out.println
        • serr - message will be written via System.err.println
        Parameters:
        token - The token idenfitying the user.
        destination - The destination of the message to be logged
        message - The text message to be logged to the console
        Returns:
        boolean True if the message is logged (ie destination is a valid level)
        Throws:
        RemoteException
      • changeLoggerLevel

        @Deprecated
        String changeLoggerLevel​(String token,
                                 String loggerName,
                                 String level)
                          throws RemoteException
        Deprecated.
        since 5.6. Use a FuncTestAdminLoggingResource REST call.
        Change the level of the specified logger.

        The level parameter can be one of:

        • DEBUG
        • INFO
        • WARN
        • ERROR
        • FATAL
        Parameters:
        token - the token identifying the user.
        loggerName - the full name of the logger e.g. com.atlassian.confluence.test.rpc.FuncTestRpcHandler
        level - the level to change the logger to
        Returns:
        the original level of the logger before changing.
        Throws:
        RemoteException
      • removeTestData

        boolean removeTestData​(String token,
                               Vector<String> usersToKeep,
                               Vector<String> groupsToKeep,
                               Hashtable<String,​Vector<String>> userGroupMemberships)
                        throws RemoteException
        Big Kahuna remove method. Removes EVERYTHING that is meant to be removed on test setup, keeping only the users, groups and memberships specified. This includes removing global templates.
        Parameters:
        token - the token identifying the user.
        usersToKeep - users like admin and sysadmin that should not be removed
        groupsToKeep - groups like admins and users that should not be removed
        userGroupMemberships - a map where the keys are group names and the values are lists of usernames in the group
        Throws:
        NotPermittedException
        RemoteException
      • removeTestDataAfterExternalUserManagement

        boolean removeTestDataAfterExternalUserManagement​(String token)
                                                   throws Exception
        Called at the start of tests for which User management is handled by an external server such as LDAP or Crowd.

        All remove/create User calls can be made to that server in one batch, and then the Confluence instance data can be cleaned up. Generally this will take part in three stages:

        1. Clean up requiring the 'old' users, groups and memberships to exist (e.g. personal spaces, permissions) 2. Sync with the external server, which will reset the user, groups and memberships 3. Perform any other clean-up required, from removing spaces to flushing caches.

        see ServerStateManager.removeTestData()

        Throws:
        Exception
      • disconnectUser

        boolean disconnectUser​(String token,
                               String username)
                        throws RemoteException
        Disconnect a user from Confluence. Removes all their permissions, group memberships, their profile information and their personal space.
        Throws:
        RemoteException
      • removeAllTrustedApplications

        boolean removeAllTrustedApplications​(String token)
                                      throws Exception
        Removes all trusted applications from the database.
        Throws:
        Exception
      • massCreateAttachments

        boolean massCreateAttachments​(String token,
                                      String pageId,
                                      String prefix,
                                      String numAttachments)
                               throws Exception
        Create a whole series of attachments on a single page.
        Throws:
        Exception
      • getGlobalConfiguredTheme

        @Deprecated
        String getGlobalConfiguredTheme​(String token)
                                 throws Exception
        Deprecated.
        since 5.6. Use FuncTestAdminThemeResource.
        Get the key of the configured global theme, whether or not that theme exists.
        Throws:
        Exception
      • getConfiguredThemeForSpace

        @Deprecated
        String getConfiguredThemeForSpace​(String token,
                                          String spaceKey)
                                   throws Exception
        Deprecated.
        since 5.6. Use FuncTestAdminThemeResource.
        Get the key of the configured theme for a space, whether or not that theme exists.
        Throws:
        Exception
      • setGlobalTheme

        @Deprecated
        boolean setGlobalTheme​(String token,
                               String themeKey)
                        throws Exception
        Deprecated.
        since 5.6. Use FuncTestAdminThemeResource.
        Sets the global theme
        Parameters:
        themeKey - - the complete theme key
        Throws:
        Exception
      • setThemeForSpace

        @Deprecated
        boolean setThemeForSpace​(String token,
                                 String spaceKey,
                                 String themeKey)
                          throws Exception
        Deprecated.
        since 5.6. Use FuncTestAdminThemeResource.
        Sets the theme for the specified space
        Parameters:
        spaceKey - - the key of the space to change
        themeKey - - the complete theme key
        Throws:
        Exception
      • clearCustomHtml

        boolean clearCustomHtml​(String token)
                         throws Exception
        Clears the global custom html.
        Returns:
        true always.
        Throws:
        Exception
      • uninstallPlugin

        @Deprecated
        boolean uninstallPlugin​(String token,
                                String pluginKey)
                         throws NotPermittedException
        Deprecated.
        since 5.6. Use PluginsRpc in test client code.
        Uninstall a plugin. (There's an install method in the standard rpc plugin)
        Returns:
        true because a return type is required by XMLRPC
        Throws:
        NotPermittedException
      • enablePluginModule

        @Deprecated
        boolean enablePluginModule​(String token,
                                   String pluginKey,
                                   String moduleKey)
                            throws NotPermittedException
        Deprecated.
        since 5.6. Use PluginsRpc in test client code.
        Enable plugin module
        Parameters:
        pluginKey - the key of the plugin
        moduleKey - the key of the module
        Returns:
        true because a return type is required by XMLRPC
        Throws:
        NotPermittedException
      • disablePluginModule

        @Deprecated
        boolean disablePluginModule​(String tokdis,
                                    String pluginKey,
                                    String moduleKey)
                             throws NotPermittedException
        Deprecated.
        since 5.6. Use PluginsRpc in test client code.
        Disable plugin module
        Parameters:
        pluginKey - the key of the plugin
        moduleKey - the key of the module
        Returns:
        true because a return type is required by XMLRPC
        Throws:
        NotPermittedException
      • isPluginModuleEnabled

        @Deprecated
        boolean isPluginModuleEnabled​(String token,
                                      String pluginKey,
                                      String moduleKey)
                               throws NotPermittedException
        Deprecated.
        since 5.6. Use PluginsRpc in test client code.
        Find out if a plugin module is enabled or not. If the plugin exists and is enabled and the module exists and is enabled, then this method should return true, otherwise it should return false.
        Parameters:
        pluginKey - the key of the plugin
        moduleKey - the key of the module excluding the plugin key
        Returns:
        true if the plugin module exists and is enabled, false otherwise
        Throws:
        NotPermittedException
      • isSpringComponentPresent

        boolean isSpringComponentPresent​(String token,
                                         String name)
        Returns true if a Spring component with the given name exists in the application context.
      • isPluginUpgradeTasksComplete

        boolean isPluginUpgradeTasksComplete​(String token)
        Returns true if the plugin dependent upgrade tasks
      • waitForEvent

        boolean waitForEvent​(String token,
                             String eventClassName,
                             String timeout,
                             String timeUnit)
                      throws Exception
        Waits for an event to occur and returns when it has finished.
        Parameters:
        eventClassName - the fully qualified classname of the event to wait for.
        timeout - number of milliseconds to wait for the event before giving up completely.
        timeUnit - See TimeUnit.name
        Returns:
        true if the event occurs within the timeout.
        Throws:
        Exception
      • waitForEventQueue

        boolean waitForEventQueue​(String token,
                                  String timeoutStr,
                                  String timeUnitStr)
                           throws Exception
        Waits for all events in queue to be processed.
        Returns:
        true if queue was exhausted, false on timeout or any error.
        Throws:
        Exception
      • shutdownScheduler

        @Deprecated
        boolean shutdownScheduler​(String token)
                           throws Exception
        Deprecated.
        since 5.6. Use FuncTestAdminSchedulerResource.
        Shutdown the scheduler to ensure single threadedness for testing
        Throws:
        Exception
      • removeBandanaKey

        @Deprecated
        boolean removeBandanaKey​(String token,
                                 String space,
                                 String key)
        Deprecated.
        since 5.6. Use FuncTestAdminBandanaResource.
        Remove a key from Bandana
      • setBandanaStringSet

        @Deprecated
        boolean setBandanaStringSet​(String token,
                                    String space,
                                    String key,
                                    Vector<String> value)
        Deprecated.
        since 5.6. Use FuncTestAdminBandanaResource.
        Sets a key in Bandana with a Set of Strings as value
      • setBandanaStringList

        @Deprecated
        boolean setBandanaStringList​(String token,
                                     String space,
                                     String key,
                                     Vector<String> value)
        Deprecated.
        since 5.6. Use FuncTestAdminBandanaResource.
        Sets a key in Bandana with a List of Strings as value
      • setBandanaKey

        @Deprecated
        boolean setBandanaKey​(String token,
                              String space,
                              String key,
                              String value)
        Deprecated.
        since 5.6. Use FuncTestAdminBandanaResource.
        Sets a key in Bandana
      • setBandanaKeyBoolean

        @Deprecated
        boolean setBandanaKeyBoolean​(String token,
                                     String space,
                                     String key,
                                     boolean value)
        Deprecated.
        since 5.6. Use FuncTestAdminBandanaResource.
        Sets a key in Bandana
      • setBandanaKeyInteger

        @Deprecated
        boolean setBandanaKeyInteger​(String token,
                                     String space,
                                     String key,
                                     int value)
        Deprecated.
        since 5.6. Use FuncTestAdminBandanaResource.
        Sets a key in Bandana
      • getBandanaValue

        @Deprecated
        Object getBandanaValue​(String token,
                               String space,
                               String key)
        Deprecated.
        since 5.6. Use FuncTestAdminBandanaResource.
        Gets a value from Bandana
      • getContentPropertyKeys

        Vector getContentPropertyKeys​(String token,
                                      String entityId)
        Get the content property keys for a content entity given its id
      • getContentProperty

        String getContentProperty​(String token,
                                  String entityId,
                                  String key)
        Get the content property value for a content entity given its id and the property key
      • getContentTextProperty

        String getContentTextProperty​(String token,
                                      String entityId,
                                      String key)
        Get the content property text value (in OS_PROPERTYENTRY) for a content entity given its id and property key
        Parameters:
        token -
        entityId - the ID of the content object this property is stored against
        key - the entity key of the property being stored
        Returns:
        The string value of the property (or an empty string if no property was found)
      • getContentStringProperty

        String getContentStringProperty​(String token,
                                        String entityId,
                                        String key)
        Get the content property string value (in OS_PROPERTYENTRY) for a content entity given its id and property key
        Parameters:
        token -
        entityId - the ID of the content object this property is stored against
        key - the entity key of the property being stored
        Returns:
        The string value of the property (or an empty string if no property was found)
      • getContentPropertiesString

        String getContentPropertiesString​(String token,
                                          String entityId,
                                          String key)
        Get the string value of a ContentProperty associated with a content entity given its id and the property name
      • setContentTextProperty

        boolean setContentTextProperty​(String token,
                                       String entityId,
                                       String key,
                                       String value)
        Sets a text content property for a content entity given its id
      • setContentStringProperty

        boolean setContentStringProperty​(String token,
                                         String entityId,
                                         String key,
                                         String value)
        Set the content property string value (in OS_PROPERTYENTRY) for a content entity given its id, property key and value
        Parameters:
        token -
        entityId - the ID of the content object this property is stored against
        key - the entity key of the property being stored
        value - the string value of the property to set
      • setContentPropertiesString

        boolean setContentPropertiesString​(String token,
                                           String entityId,
                                           String key,
                                           String value)
        Sets the string value of a ContentProperty associated with a content entity given its id and the property name
      • getPersonalInformationId

        String getPersonalInformationId​(String token,
                                        String username)
        Gets the personal information id for a given username
      • removePersonalInformation

        boolean removePersonalInformation​(String token,
                                          String username)
                                   throws NotPermittedException
        PersonalInformation gets created automatically by the standard create user methods. This method exists to allow testing that the PersonalInformation will get created appropriately when it doesn't exist (eg for LDAP users logging in).
        Parameters:
        username - user whose personalInformation will be removed
        Returns:
        true because it has to return something
        Throws:
        NotPermittedException
      • getLocaleForUser

        String getLocaleForUser​(String token,
                                String username)
        Gets the locale preference for the user.
      • setUserDetails

        boolean setUserDetails​(String token,
                               String username,
                               String fullName,
                               String email)
                        throws RemoteException
        Sets the fullname and email address of a user with a given username.
        Returns:
        true because XMLRPC methods have to return something
        Throws:
        RemoteException - if the user was not found.
      • setUserDetailProperty

        boolean setUserDetailProperty​(String token,
                                      String username,
                                      String propertyKey,
                                      String propertyValue)
        Sets a single UserDetails property through the UserDetailsManager.
        Returns:
        true because XMLRPC methods have to return something
        Throws:
        RemoteException - if the user was not found.
      • putStringMappingInCache

        @Deprecated
        boolean putStringMappingInCache​(String token,
                                        String cacheName,
                                        String key,
                                        String value)
                                 throws Exception
        Deprecated.
        since 5.6. Use FuncTestAdminCacheResource.
        Map a key to a value for a given cache. Only accepts strings. This allows us to manipulate the number of entries in the cache. This method will create the named cache if it doesn't exist.
        Returns:
        true because void is not allowed.
        Throws:
        Exception
      • getCacheStatistics

        @Deprecated
        Hashtable getCacheStatistics​(String token,
                                     String cacheName)
                              throws Exception
        Deprecated.
        since 5.6. Use FuncTestAdminCacheResource.
        Returns the cache statistics for a particular named cache.
        Parameters:
        cacheName - the key of the cache, rather than the "niceName"
        Returns:
        A hashtable representing the cache statistics
        Throws:
        Exception
      • getCacheMaximumNumberOfElements

        @Deprecated
        Integer getCacheMaximumNumberOfElements​(String token,
                                                String cacheName)
                                         throws Exception
        Deprecated.
        since 5.6. Use FuncTestAdminCacheResource.
        Returns the configured maximum number of elements in the given cache
        Parameters:
        cacheName - the key of the cache, rather than the "niceName"
        Throws:
        Exception
      • setCacheMaximumNumberOfElements

        @Deprecated
        boolean setCacheMaximumNumberOfElements​(String token,
                                                String cacheName,
                                                int maxNumElements)
                                         throws Exception
        Deprecated.
        since 5.6. Use FuncTestAdminCacheResource.
        (Re)configures the maximum number of elements in the given cache
        Parameters:
        cacheName - the key of the cache, rather than the "niceName"
        Throws:
        Exception
      • flushAllCaches

        @Deprecated
        boolean flushAllCaches​(String token)
                        throws Exception
        Deprecated.
        since 5.6. Use FuncTestAdminCacheResource.
        Flushes all the caches.
        Returns:
        true because void isn't allowed.
        Throws:
        Exception
      • enableWebSudo

        boolean enableWebSudo​(String token,
                              boolean enabled)
                       throws Exception
        Sets the web sudo enabled status
        Returns:
        true because void isn't allowed.
        Throws:
        Exception
      • setWebSudoTimeout

        boolean setWebSudoTimeout​(String token,
                                  int timeoutMinutes)
                           throws Exception
        Sets the web sudo timeout in minutes
        Returns:
        true because void isn't allowed.
        Throws:
        Exception
      • enableElevatedSecurityCheck

        boolean enableElevatedSecurityCheck​(String token,
                                            boolean enabled)
                                     throws Exception
        Throws:
        Exception
      • enablePublicSignUp

        boolean enablePublicSignUp​(String token,
                                   boolean enabled)
                            throws Exception
        Sets the public sign up enabled status
        Returns:
        true because void isn't allowed.
        Throws:
        Exception
      • startActivity

        boolean startActivity​(String token,
                              String key,
                              String user)
                       throws Exception
        Call startActivity on the heartbeat manager bean
        Parameters:
        token - rpc authentication token
        key - the activity key to start
        user - the username of the user starting the activity
        Returns:
        true if executes start activity without error.
        Throws:
        Exception
      • stopActivity

        boolean stopActivity​(String token,
                             String key,
                             String user)
                      throws Exception
        Call stopActivity on the heartbeatManager bean
        Parameters:
        token - rpc authentication token
        key - the activity key to stop
        user - the username of the user stopping the activity
        Throws:
        Exception
      • getUsersForActivity

        Vector getUsersForActivity​(String key)
                            throws Exception
        Call getUsersForActivity on the heartbeatManager bean
        Throws:
        Exception
      • removeUserUncleanly

        boolean removeUserUncleanly​(String token,
                                    String username)
                             throws Exception
        Remove a User without removing the things that refer to that user.
        Throws:
        Exception
      • removeGroupUncleanly

        boolean removeGroupUncleanly​(String token,
                                     String groupname)
                              throws Exception
        Remove a Group without removing the things that refer to that group.
        Throws:
        Exception
      • doesDraftExist

        boolean doesDraftExist​(String token,
                               String contentId,
                               String owner,
                               String draftType,
                               String spaceKey)
        Determines if a draft of the specified type and belonging to the specified owner exists.
        Parameters:
        token - rpc authentication token
        contentId - id of the content this draft is for ('0' for new content)
        owner - owner/author of the draft
        draftType - type of content this draft is for
        spaceKey - space key, to allow new drafts in multiple spaces
        Returns:
        true if a draft of the specified type and belonging to the specified owner exists, else false
      • countDrafts

        int countDrafts​(String token,
                        String owner)
      • createDraft

        Hashtable createDraft​(String token,
                              Hashtable draft)
        Creates a draft for the draft owner and draft type with the specified title and content. If the draft already exists the current draft is updated.
        Parameters:
        token - rpc authentication token
        draft - the draft object to create Required: "owner" - the username of owner/author of the draft. Set to null for anonymous users. "draftType" - type of content the draft is for i.e. BlogPost.getType() or Page.getType(). "title" - title of the draft. "content" - content of the draft as a String in Confluence XML storage format. Optional: "pageId" - page that the draft is associated with. "spaceKey" - if no there is no page, the space that the draft is written in.
        Returns:
        the draft created returned in the same format as above, with the additional field id.
      • updateDraft

        Hashtable updateDraft​(String token,
                              Hashtable draft)
        Updates a draft located using the draft owner and draft type. Draft is then updated with the specified title and content
        Parameters:
        token - rpc authentication token
        draft - the draft object to create see #createDraft(java.lang.String, java.util.Hashtable)
        Returns:
        the draft updated returns null if the draft does not exist
      • removeDrafts

        boolean removeDrafts​(String token,
                             String username)
        Removes all drafts owned by the specified User.
        Parameters:
        token - rpc authentication token
        username - user to remove drafts for
        Returns:
        true if this is successful, false if no user with this name.
      • setDraftSaveInterval

        boolean setDraftSaveInterval​(String token,
                                     int seconds)
        Sets the given draft save interval.
        Parameters:
        token - rpc authentication token
        seconds - number of seconds for which the draft save interval should be
        Returns:
        true if this is successful, false if not set
      • clearQueue

        boolean clearQueue​(String token,
                           String queueName)
        Removes all items from the specified queue
        Returns:
        true if this is successful, false if no queue with this name exists
      • getQueueSize

        int getQueueSize​(String token,
                         String queueName)
        Returns the size of the task queue with the specified name.
        Returns:
        the size of the task queue with the specified name.
      • getNumberOfIndexTasksInQueue

        int getNumberOfIndexTasksInQueue​(String token)
        Returns the size of the index queue.
        Parameters:
        token -
        Returns:
      • removeMailServer

        boolean removeMailServer​(String token,
                                 String serverName)
                          throws Exception
        Remove the named mail server.
        Parameters:
        token - the rpc authentication token
        serverName - the name of the server to be removed.
        Returns:
        true if the named server was removed (or there was no server by that name), otherwise false.
        Throws:
        Exception
      • getLeastRecentTestAppenderLogMessage

        String getLeastRecentTestAppenderLogMessage​(String token,
                                                    String className)
      • registerTestAppenderForClass

        boolean registerTestAppenderForClass​(String token,
                                             String className)
      • unregisterTestAppenderForClass

        boolean unregisterTestAppenderForClass​(String token,
                                               String className)
      • logTestMessageForClass

        boolean logTestMessageForClass​(String token,
                                       String className,
                                       String message,
                                       String level)
      • getLocalisedText

        String getLocalisedText​(String token,
                                String messageKey)
        Get the localised string for given the message key in the logged-in user's locale.
        Parameters:
        token - the rpc authentication token
        messageKey - the i18n message key
        Returns:
        the localised version of the message key in the logged-in user's locale, or the message key itself if it does not have a corresponding value.
      • addUserAnyCase

        boolean addUserAnyCase​(String token,
                               String username,
                               String email,
                               String fullname,
                               String password)
                        throws RemoteException
        Allows addition of a user without enforcing that the username be all lower case. This is for use in tests where you need mixed case user - useful for emulating an external provider such as LDAP.
        Throws:
        NotPermittedException - if you do not have permissions to add the user.
        RemoteException
      • addGroupAnyCase

        boolean addGroupAnyCase​(String token,
                                String groupname)
                         throws RemoteException
        Allows addition of a group without enforcing that the name be all lower case. This is for use in tests where you need mixed case user - useful for emulating an external provider such as LDAP.
        Parameters:
        groupname - the name of the group to add
        Returns:
        true if successfully added, otherwise false
        Throws:
        RemoteException
      • changeSpaceCreatedDate

        boolean changeSpaceCreatedDate​(String token,
                                       String spaceKey,
                                       Date createdDate)
                                throws RemoteException
        Change the created date of a space
        Parameters:
        spaceKey - the space key of the space to change the created date
        Throws:
        RemoteException
      • changePageCreatedDate

        boolean changePageCreatedDate​(String token,
                                      String pageId,
                                      Date createdDate)
                               throws RemoteException
        Change the created date of a page
        Parameters:
        pageId - the page id of the page to change the created date
        Throws:
        RemoteException
      • removeAttachmentUncleanly

        boolean removeAttachmentUncleanly​(String token,
                                          String contentId,
                                          String attachmentFileName)
                                   throws RemoteException
        Removes an attachment without cleaning up associated attachment info
        Parameters:
        token - the authentication
        contentId - the content that the attachment is attached to
        attachmentFileName - the attachment
        Returns:
        true
        Throws:
        RemoteException
      • changeAttachmentCreatedDate

        boolean changeAttachmentCreatedDate​(String token,
                                            String contentId,
                                            String attachmentFileName,
                                            Date createdDate)
                                     throws RemoteException
        Change the created date of an attachment
        Parameters:
        contentId - the id of the page or blogpost the attachment is attached to
        attachmentFileName - the attachment file name of the attachment to change the created date
        Throws:
        RemoteException
      • changeBlogPostModificationDate

        boolean changeBlogPostModificationDate​(String token,
                                               String blogId,
                                               Date modificationDate)
                                        throws RemoteException
        Change the modification date of a blog post
        Parameters:
        blogId - the id of the blog to modify
        modificationDate - the last modification date to be set.
        Returns:
        true if successful, otherwise false.
        Throws:
        RemoteException
      • changePageModificationDate

        boolean changePageModificationDate​(String token,
                                           String pageId,
                                           Date modificationDate)
                                    throws RemoteException
        Change the modification date of a page
        Parameters:
        pageId - the page id of the page to change the modification date
        modificationDate - the last modification date to be set.
        Throws:
        RemoteException
      • saveDateFormat

        boolean saveDateFormat​(String token,
                               String dateFormat)
      • saveDateTimeFormat

        boolean saveDateTimeFormat​(String token,
                                   String dateTimeFormat)
      • getDateTimeFormat

        String getDateTimeFormat​(String token)
        Get current DateTime format
        Since:
        7.14
      • addSmtpServer

        boolean addSmtpServer​(String token,
                              String name,
                              String from,
                              String subjectPrefix,
                              String hostname,
                              int port)
        Add an SMTP mail server.
      • setSmtpServer

        boolean setSmtpServer​(String token,
                              String name,
                              String from,
                              String subjectPrefix,
                              String hostname,
                              int port)
        Remove all existing SMTP servers and add the given server.
      • setSmtpServer

        boolean setSmtpServer​(String token,
                              String name,
                              String from,
                              String subjectPrefix,
                              String hostname,
                              int port,
                              String fromName)
        Remove all existing SMTP servers and add the given server.
      • addMailServer

        boolean addMailServer​(String token,
                              String serverName,
                              String protocol,
                              String hostname,
                              int port,
                              String username,
                              String password,
                              String toAddress)
        Add a POP server to poll for emails in a particular account. The account's associated email address must also be passed.
      • convertMarkupToXhtml

        String convertMarkupToXhtml​(String token,
                                    String wikiMarkup,
                                    String pageId)
        Render a page as XHTML.
      • convertXhtmlToMarkup

        String convertXhtmlToMarkup​(String token,
                                    String xhtml,
                                    String pageId)
        Convert XHTML to WikiMarkup.
      • createJohnsonEvent

        boolean createJohnsonEvent​(String token,
                                   String message)
        Creates a Johnson event inside Confluence. This method is used to test the ConfluenceJohnsonFilter.
        Parameters:
        message - the description of the event to create
      • removeAllJohnsonEvents

        boolean removeAllJohnsonEvents​(String token)
        Removes all Johnson events from Confluence
      • enableCaptcha

        boolean enableCaptcha​(String token,
                              boolean enable)
        Sets the captcha mode
      • getSystemProperty

        Hashtable<String,​String> getSystemProperty​(String token,
                                                         String name)
        Retrieve the value of a system property. The property is returned as a map of the property key to its value, as XML-RPC doesn't support nulls and it's reasonably important to be able to tell if the property is set.
        Parameters:
        name - the name of the property
        Returns:
        a hash mapping the requested key to its value, if the property is set. Otherwise an empty map.
      • setSystemProperty

        Boolean setSystemProperty​(String token,
                                  String name,
                                  String value)
        Set a system property on the server to the supplied value.
        Parameters:
        name - the name of the property
        value - the value of the property
        Returns:
        always true since XML RPC can't handle void
      • clearSystemProperty

        Boolean clearSystemProperty​(String token,
                                    String name)
        Unset a system property.
        Parameters:
        name - the name of the property
        Returns:
        always true since XML RPC can't handle void
      • clearIndex

        boolean clearIndex​(String token)
        Blows away the main Confluence search index.
      • restoreAbstractPage

        boolean restoreAbstractPage​(String token,
                                    String abstractPageId)
        Restores an abstract page from the trash.
      • getIdOfPagePermission

        String getIdOfPagePermission​(String token,
                                     String contentId,
                                     String permissionType,
                                     String username)
        Returns:
        the id of the identified content permission or 0 if there is no match found.
      • createTestUsers

        int createTestUsers​(String token,
                            int count)
        Create test users with usernames "testuser0", "testuser1", etc. Each user's password is the same as their username.
        Returns:
        the number of users created
      • removeTestUsers

        int removeTestUsers​(String token,
                            int count)
        Removes test users with usernames "testuser0", "testuser1", etc. Logs a warning if a user cannot be removed.
        Returns:
        the number of users removed
      • createUserMacro

        boolean createUserMacro​(String token,
                                String name,
                                boolean hasBody,
                                String bodyType,
                                String outputType,
                                String template,
                                String title,
                                String description,
                                String category,
                                String iconUrl,
                                String documentationUrl,
                                boolean hidden)
                         throws NotPermittedException
        Create a User Macro
        Parameters:
        bodyType - how the body should be treated. "raw", "escapehtml", or "rendered". May be null only if hasBody is false.
        outputType - whether the macro is expected to return html or wiki markup. "html" or "wiki".
        template - the velocity rendered by the macro
        title - the title of the macro that appears in the Macro Browser
        description - the description of the macro that appears in the Macro Browser
        category - the category the macro should be listed under in the Macro Browser
        iconUrl - the URL of the macro icon that appears in the Macro Browser
        documentationUrl - the URL of the macro documentation
        hidden - true if the Macro should not be searchable in the Macro Browser
        Returns:
        true all the time because XMLRPC methods need a non-void return type.
        Throws:
        RuntimeException - if the macro already exists
        NotPermittedException
      • unregisterEventListener

        boolean unregisterEventListener​(String token,
                                        String eventClassName)
                                 throws Exception
        Unregisters the temporary listener registered for the specified event.
        Throws:
        Exception
      • clearEventListeners

        boolean clearEventListeners​(String token)
                             throws Exception
        Removes all temporary event listeners, regardless of their state.
        Returns:
        true because some result is required.
        Throws:
        Exception
      • setApplicationConfigProperty

        boolean setApplicationConfigProperty​(String token,
                                             String propertyKey,
                                             String propertyValue)
        Sets a property on the global ApplicationConfiguration instance.
        Returns:
        the previous value of the property
      • getApplicationConfigProperty

        Object getApplicationConfigProperty​(String token,
                                            String propertyKey)
        Returns a property of the global ApplicationConfiguration instance.
        Parameters:
        propertyKey -
        Returns:
        the property mapped to propertyKey
      • setUserFollows

        boolean setUserFollows​(String token,
                               String followingUsername,
                               Hashtable followUsers)
                        throws RemoteException
        Change the follow or unfollow state between a follower user and s a set of folowees users
        Parameters:
        followingUsername - The username of the user that is doing the following
        followUsers - A map of usernames to bbe followed/unfollowed, and a boolean indicating the desired follow status
        Throws:
        RemoteException
      • followUser

        boolean followUser​(String token,
                           String userName,
                           boolean followUser)
                    throws RemoteException
        Follows or stops following a user. Can be done by any user, not just admins.
        Parameters:
        followUser - true to follow a user, false to stop following
        Throws:
        RemoteException
      • storeXhtmlPage

        Hashtable storeXhtmlPage​(String token,
                                 Hashtable pageStruct)
                          throws RemoteException
        The Confluence remote API store page performs wiki to XHTML conversion on the page content. This version will store the supplied content exactly as it is. This is necessary for tests where the automatic conversion is not helpful, such as user macro testing.
        Parameters:
        token -
        pageStruct -
        Returns:
        the created page
        Throws:
        RemoteException
      • synchroniseUserDirectories

        boolean synchroniseUserDirectories​(String token)
                                    throws Exception
        Synchronizes all remote user directories with the local database cache
        Returns:
        true
        Throws:
        Exception
      • setDirectoryPasswordEncoder

        boolean setDirectoryPasswordEncoder​(String token,
                                            String directoryName,
                                            String encoder)
                                     throws Exception
        Changes the password encoder for the given directory
        Returns:
        true
        Throws:
        Exception
      • removeUserDirectory

        boolean removeUserDirectory​(String token,
                                    String directoryId)
                             throws Exception
        Removes user directory
        Parameters:
        directoryId - the id of the directory
        Returns:
        true if the directory existed and was removed
        Throws:
        Exception
      • addExistingProfilePicture

        boolean addExistingProfilePicture​(String token,
                                          String userName,
                                          String fileName)
                                   throws Exception
        Attempts to add a existing profile picture to a user's profile.
        Parameters:
        userName - the user name of the profile
        fileName - file name of the picture
        Returns:
        true if the picture is successfully added
        Throws:
        Exception
      • setBooleanUserPreference

        boolean setBooleanUserPreference​(String token,
                                         String userName,
                                         String preferenceKey,
                                         String value)
                                  throws RemoteException
        Sets a boolean user preference.
        Parameters:
        userName - the user name to set the preference for
        preferenceKey - the key of the preference to set
        value - the string "true" or "false" to set as the preference
        Throws:
        RemoteException
      • setStringUserPreference

        boolean setStringUserPreference​(String token,
                                        String userName,
                                        String preferenceKey,
                                        String value)
                                 throws RemoteException
        Sets a string user preference.
        Parameters:
        userName - the user name to set the preference for
        preferenceKey - the key of the preference to set
        value - a string to set as the preference
        Throws:
        RemoteException
      • enableDailyReportNotification

        boolean enableDailyReportNotification​(String token,
                                              String userName,
                                              boolean dailyReportEnabled)
        Sets the Daily Report email for a user to enabled or disabled.
        Parameters:
        userName - the user name to set the report state for
        dailyReportEnabled - true if the daily report should be sent, false if not
      • setNetworkNotificationForUser

        boolean setNetworkNotificationForUser​(String token,
                                              String userName,
                                              boolean watchNetwork)
        Sets Network watch emails for a user to enabled or disabled.
        Parameters:
        userName - the user name to set the watch state for
        watchNetwork - true if the user should watch their network, false if not
      • setSiteBlogNotificationForUser

        boolean setSiteBlogNotificationForUser​(String token,
                                               String userName,
                                               boolean globalBlogWatchForUser)
        Sets Site Blog watch emails for a user to enabled or disabled.
        Parameters:
        userName - the user name to set the watch state for
        globalBlogWatchForUser - true if the user should watch all blogs on the site network, false if not
      • getIgnoreBaseURLWarning

        boolean getIgnoreBaseURLWarning​(String token)
        Whether the warning message for an un-advisable value for the Base URL is ignored or not.
        Returns:
        true if the warning message is ignored.
      • setIgnoreBaseURLWarning

        boolean setIgnoreBaseURLWarning​(String token,
                                        boolean value)
                                 throws RemoteException
        Affects whether the warning message for an un-advisable value for the Base URL is ignored or not. If ignored, any warning messages about the Base URL will not be displayed.
        Parameters:
        value - set to true to ignore the warning.
        Throws:
        RemoteException
      • enableUserFeature

        @Deprecated
        boolean enableUserFeature​(String token,
                                  String featureKey)
                           throws RemoteException
        Deprecated.
        since 5.6. Use the REST resource.
        Enables a given dark feature for the logged in user.
        Parameters:
        featureKey - - the key of the feature to enable
        Throws:
        RemoteException
      • disableUserFeature

        @Deprecated
        boolean disableUserFeature​(String token,
                                   String featureKey)
                            throws RemoteException
        Deprecated.
        since 5.6. Use the REST resource.
        Disables a given dark feature for the logged in user.
        Parameters:
        featureKey - - the key of the feature to disable
        Throws:
        RemoteException
      • enableSiteFeature

        @Deprecated
        boolean enableSiteFeature​(String token,
                                  String featureKey)
                           throws RemoteException
        Deprecated.
        since 5.6. Use the REST resource.
        Enables a given dark feature for the entire site.
        Parameters:
        featureKey - - the key of the feature to enable
        Throws:
        RemoteException
      • disableSiteFeature

        @Deprecated
        boolean disableSiteFeature​(String token,
                                   String featureKey)
                            throws RemoteException
        Deprecated.
        since 5.6. Use the REST resource.
        Disables a given dark feature for the entire site.
        Parameters:
        featureKey - - the key of the feature to disable
        Throws:
        RemoteException
      • setWelcomeMessage

        boolean setWelcomeMessage​(String token,
                                  String welcomeMessage)
      • resetWelcomeMessage

        boolean resetWelcomeMessage​(String token)
      • createPagesFromPrototype

        Vector<Hashtable> createPagesFromPrototype​(String token,
                                                   Hashtable pageStruct,
                                                   int count)
                                            throws RemoteException
        Creates a series of pages based on a prototype. Each page will have the same parent and content, and the title will be that of the template plus a space and an index.

        e.g. if the page title passed is "Hey Ho", the created pages will be "Hey Ho 1", "Hey Ho 2" and so on.

        Parameters:
        pageStruct - a template page to create multiple pages from
        count - the number of pages to create - pages created are 1-indexed
        Throws:
        RemoteException
      • updateGlobalSettingBoolean

        boolean updateGlobalSettingBoolean​(String token,
                                           String name,
                                           boolean value)
                                    throws RemoteException
        Update a Settings boolean field.
        Parameters:
        token -
        name - name of the field used to store the setting (see field names inside Settings.
        value -
        Returns:
        the old value
        Throws:
        RemoteException
      • createSpaces

        Vector<String> createSpaces​(String token,
                                    int count)
                             throws RemoteException
        Creates a bunch of spaces.
        Parameters:
        count - the number to create
        Returns:
        the keys of the spaces created
        Throws:
        RemoteException - if you are not awesome enough to use this method
      • getNumberOfActiveUsers

        int getNumberOfActiveUsers​(String token)
                            throws RemoteException
        Returns the number of active users, i.e. the number of users used for license purposes.
        Returns:
        the number of active users
        Throws:
        RemoteException
      • getExportBuildNumber

        String getExportBuildNumber​(String token)
        Returns the backward-compatibility of an export
        Parameters:
        token - the authentication
        Returns:
        the build number
      • getOldestSpaceImportAllowed

        String getOldestSpaceImportAllowed​(String token)
        Returns the backwards-compatibility of a space import
        Parameters:
        token - the authentication
        Returns:
        the oldest build number allowed
      • getPluginExportCompatibility

        String getPluginExportCompatibility​(String token,
                                            String pluginKey)
        Returns the plugin compatibility matrix for exports
        Parameters:
        token - the authentication
        pluginKey - the plugin key
        Returns:
        a version range in the form "4.3..5.0", separated by 2 dots, or null
      • isUnlimitedUserLicense

        boolean isUnlimitedUserLicense​(String token)
                                throws RemoteException
        Returns:
        true if the current licence has no user limit, false otherwise
        Throws:
        RemoteException
      • setEnableAnonymousRpc

        boolean setEnableAnonymousRpc​(String token,
                                      String value)
                               throws RemoteException
        Toggle the setting to allow/deny anonymous RPC calls. You will also need to enable anonymous access at the permissions level using the Admin RPC interface.
        Throws:
        RemoteException
      • getContentForAllLabels

        Hashtable<String,​Object> getContentForAllLabels​(String token,
                                                              int offset,
                                                              int maxResults,
                                                              String labels)
        Returns CEOs having all of the labels supplied in the string. Labels are space-separated.
      • getContentInSpacesForAllLabels

        Hashtable<String,​Object> getContentInSpacesForAllLabels​(String token,
                                                                      int offset,
                                                                      int maxResults,
                                                                      String spaceKeysString,
                                                                      String labelsString)
        Returns CEOs in the given spaces having all of the labels supplied in the string. Labels and space keys are space-separated.
      • getAllContentForAllLabels

        Hashtable<String,​Object> getAllContentForAllLabels​(String token,
                                                                 int offset,
                                                                 int maxResults,
                                                                 String labelsString)
        Returns current and trashed CEOs having all of the labels supplied in the string. Labels are space-separated.
      • getForLabels

        Hashtable<String,​Object> getForLabels​(String token,
                                                    String labelableType,
                                                    int offset,
                                                    int maxResults,
                                                    String labelsString)
        Returns any kind of Labelable entities having all of the labels supplied in the string. Labels are space-separated.
      • addLabelToLabelable

        int addLabelToLabelable​(String token,
                                String labelName,
                                String labelableId,
                                String labelableType)
        Adds a label to a labelable, because the public RPC API doesn't let you do it. Feel free to turn it all into REST to make the pain go away.
      • startLoggingRequests

        boolean startLoggingRequests​(String token)
        Start logging http request urls.

        Call finishLoggingRequests(String) to stop logging and to retrieve results.

        Returns:
        true
      • finishLoggingRequests

        Vector<String> finishLoggingRequests​(String token)
        Finish logging http request and return any requests made.

        Logging must have been previously started using startLoggingRequests(String).

        Returns:
        url of each request made
      • resetDatabaseStatistics

        boolean resetDatabaseStatistics​(String token)
        Reset database statistics.

        Call getDatabaseStatistics(String) to get results since the last reset.

        Returns:
        true
      • runGarbageCollection

        boolean runGarbageCollection​(String token)
      • isImportTaskRunning

        boolean isImportTaskRunning​(String token)
      • getAnonyimizedClusterNodeIdentifier

        String getAnonyimizedClusterNodeIdentifier​(String token)
      • moveBlogPost

        boolean moveBlogPost​(String token,
                             String blogPostId,
                             String targetSpaceKey)
      • increaseHighValue

        boolean increaseHighValue​(String token)
        Put a number bigger than 65535 in Hibernate_unique_key table to force generated ids to be greater than max integer.
        Parameters:
        token - the rpc authentication token
        Returns:
        true if successful.
      • getRecordedErrorLogMessages

        Vector<String> getRecordedErrorLogMessages​(String token)
      • clearRecordedLogMessages

        boolean clearRecordedLogMessages​(String token)
      • setHibernateConnectionProviderLastExceptionTime

        boolean setHibernateConnectionProviderLastExceptionTime​(String token,
                                                                String timeStr)
      • clearHibernateConnectionProviderLastExceptionTime

        boolean clearHibernateConnectionProviderLastExceptionTime​(String token)