Package com.atlassian.confluence.content.service

Interface PageService

All Known Implementing Classes:
DefaultPageService
public interface PageService
The PageService is a service layer implementation of the PageManager.
See Also:

  • Method Details

    • newMovePageCommand

      MovePageCommand newMovePageCommand(PageLocator sourcePageLocator, PageLocator targetPageLocator, String position)
      Retrieve a command to perform a simple move operation.
      Parameters:
      position - the point describing where the source should be moved to in relation to the target, see MovePageCommand
      Returns:
      an appropriate command instance

    • newMovePageCommand

      MovePageCommand newMovePageCommand(PageLocator sourcePageLocator, SpaceLocator targetSpaceLocator)
      Retrieve a command that performs a move operation of a page to a top level of a target space.

    • getIdPageLocator

      PageLocator getIdPageLocator(long pageId)
      Creates a page locator that can locate a page based on an id.

    • getTitleAndSpaceKeyPageLocator

      PageLocator getTitleAndSpaceKeyPageLocator(String spaceKey, String title)
      Creates a page locator that can locate a page based on a space key and title.

    • getPageVersionLocator

      PageLocator getPageVersionLocator(long pageId, int version)
      Parameters:
      pageId - the id of the original version of the page
      version - a historical version, where 1 refers to version 1.
      Returns:
      a page locator that will locate a historical version of a page.

    • newSetPageOrderCommand

      ServiceCommand newSetPageOrderCommand(PageLocator parentPageLocator, List<Long> childPageIds)
      Retrieve a command to set the order of all children for a supplied parent Page locator.
      Parameters:
      parentPageLocator - locator for the parent Page object
      childPageIds - a list of child page ids

    • newRevertPageOrderCommand

      ServiceCommand newRevertPageOrderCommand(PageLocator parentPageLocator)
      Retrieve a command to clear any existing positions for children of the located Page.

    • newDeletePageCommand

      ServiceCommand newDeletePageCommand(PageLocator pageLocator)
      Retrieve a command to remove an existing page

    • newRemovePageVersionCommand

      ServiceCommand newRemovePageVersionCommand(PageLocator pageLocator)
      Parameters:
      pageLocator - a page locator that identifies either the historical version of a page directly (e.g. IdPageLocator) or the page and a version (e.g. IdAndVersionPageLocator).
      Returns:
      a command to remove a version of a page.

    • newRevertPageCommand

      ServiceCommand newRevertPageCommand(PageLocator pageToRevert, int version, String revertComment, boolean revertTitle)
      Retrieve a command to revert a page

    • newCreatePageCommand

      ServiceCommand newCreatePageCommand(PageProvider provider, CreateContextProvider contextProvider, Page draft, ConfluenceUser user)
      Retrieve a command for creating a new page for the specified user.
      Parameters:
      provider - an object that will provide the page to be created.
      contextProvider - an object that can provide a context to be included when publishing the page creation event
      user - the user creating this page
      Returns:
      a CreatePageCommand for creating the specified page.
      Since:
      10.0

    • newCreatePageCommand

      ServiceCommand newCreatePageCommand(PageProvider provider, CreateContextProvider contextProvider, ContentEntityObject draft, ConfluenceUser user)
      Retrieve a command for creating a new page for the specified user.
      Parameters:
      provider - an object that will provide the page to be created.
      contextProvider - an object that can provide a context to be included when publishing the page creation event
      user - the user creating this page
      Returns:
      a CreatePageCommand for creating the specified page.
      Since:
      10.0

    • newCreatePageCommand

      ServiceCommand newCreatePageCommand(PageProvider provider, CreateContextProvider contextProvider, Draft draft, ConfluenceUser user)
      Retrieve a command for creating a new page for the specified user.
      Parameters:
      provider - an object that will provide the page to be created.
      contextProvider - an object that can provide a context to be included when publishing the page creation event
      user - the user creating this page
      Returns:
      a CreatePageCommand for creating the specified page.
      Since:
      10.0

    • newCreatePageCommandFromExisting

      @Internal ServiceCommand newCreatePageCommandFromExisting(PageProvider provider, Draft draft, ConfluenceUser user, SpaceProvider spaceProvider)

      This is not a public API method! Creating a page from an existing page has different authorisation and validation logic from creating a brand new page. This method allows creation of a command that implements that difference in logic. Apart from that the command created here will have the same logic as that created by newCreatePageCommand(PageProvider, CreateContextProvider, Draft, ConfluenceUser).

      This logic in this command originates from CopyPageAction which differs from that of CreatePageAction.

      I hope that when we get a chance to analyse why CopyPageAction has different permission and validation logic we will eventually remove this method.

      Parameters:
      provider - an object that will provide the page to be created.
      draft - the draft associated with the copy, if present.
      user - the user creating this page
      spaceProvider - provide the space where page will be created.
      Since:
      10.0

    • newCreatePageCommandFromExisting

      @Internal ServiceCommand newCreatePageCommandFromExisting(PageProvider provider, ContentEntityObject draft, ConfluenceUser user, SpaceProvider spaceProvider)

      This is not a public API method! Creating a page from an existing page has different authorisation and validation logic from creating a brand new page. This method allows creation of a command that implements that difference in logic. Apart from that the command created here will have the same logic as that created by newCreatePageCommand(PageProvider, CreateContextProvider, Draft, ConfluenceUser).

      This logic in this command originates from CopyPageAction which differs from that of CreatePageAction.

      I hope that when we get a chance to analyse why CopyPageAction has different permission and validation logic we will eventually remove this method.

      Parameters:
      provider - an object that will provide the page to be created.
      draft - the draft associated with the copy, if present.
      user - the user creating this page
      spaceProvider - provide the space where page will be created.
      Since:
      10.0

    • newCreatePageCommandFromExisting

      @Internal ServiceCommand newCreatePageCommandFromExisting(PageProvider provider, CreateContextProvider contextProvider, ContentEntityObject draft, ConfluenceUser user, SpaceProvider spaceProvider)

      This is not a public API method! Creating a page from an existing page has different authorisation and validation logic from creating a brand new page. This method allows creation of a command that implements that difference in logic. Apart from that the command created here will have the same logic as that created by newCreatePageCommand(PageProvider, CreateContextProvider, Draft, ConfluenceUser).

      This logic in this command originates from CopyPageAction which differs from that of CreatePageAction.

      I hope that when we get a chance to analyse why CopyPageAction has different permission and validation logic we will eventually remove this method.

      Parameters:
      provider - an object that will provide the page to be created.
      contextProvider - an object that provides context for the new page creation
      draft - the draft associated with the copy, if present.
      user - the user creating this page
      spaceProvider - provide the space where page will be created.
      Since:
      10.0

    • newCreatePageCommandFromExisting

      @Internal ServiceCommand newCreatePageCommandFromExisting(PageProvider provider, CreateContextProvider contextProvider, Page draft, ConfluenceUser user, SpaceProvider spaceProvider)

      This is not a public API method! Creating a page from an existing page has different authorisation and validation logic from creating a brand new page. This method allows creation of a command that implements that difference in logic. Apart from that the command created here will have the same logic as that created by newCreatePageCommand(PageProvider, CreateContextProvider, Draft, ConfluenceUser).

      This logic in this command originates from CopyPageAction which differs from that of CreatePageAction.

      I hope that when we get a chance to analyse why CopyPageAction has different permission and validation logic we will eventually remove this method.

      Parameters:
      provider - an object that will provide the page to be created.
      contextProvider - an object that provides context for the new page creation
      draft - the draft associated with the copy, if present.
      user - the user creating this page
      spaceProvider - provide the space where page will be created.
      Since:
      10.0

    • newConvertPageToBlogPostCommand

      ServiceCommand newConvertPageToBlogPostCommand(PageLocator pageLocator, SpaceLocator targetSpaceLocator)

      This converts a page into a blogpost

      Parameters:
      pageLocator - Page locator for the page to be converted
      targetSpaceLocator - Space locator for the destination space