• Home
• org.bonitasoft.engine
• bonita-common
• 9.0.0
• source code
• PageAPI.java

×

Project download

Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $

You can buy this project and download/modify it how often you want.

org.bonitasoft.engine.api.PageAPI Maven / Gradle / Ivy

/**
 * Copyright (C) 2019 Bonitasoft S.A.
 * Bonitasoft, 32 rue Gustave Eiffel - 38000 Grenoble
 * This library is free software; you can redistribute it and/or modify it under the terms
 * of the GNU Lesser General Public License as published by the Free Software Foundation
 * version 2.1 of the License.
 * This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
 * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 * See the GNU Lesser General Public License for more details.
 * You should have received a copy of the GNU Lesser General Public License along with this
 * program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth
 * Floor, Boston, MA 02110-1301, USA.
 **/
package org.bonitasoft.engine.api;

import java.io.Serializable;
import java.util.List;
import java.util.Map;
import java.util.Properties;

import org.bonitasoft.engine.exception.AlreadyExistsException;
import org.bonitasoft.engine.exception.CreationException;
import org.bonitasoft.engine.exception.DeletionException;
import org.bonitasoft.engine.exception.ExecutionException;
import org.bonitasoft.engine.exception.InvalidPageTokenException;
import org.bonitasoft.engine.exception.InvalidPageZipContentException;
import org.bonitasoft.engine.exception.InvalidPageZipInconsistentException;
import org.bonitasoft.engine.exception.InvalidPageZipMissingAPropertyException;
import org.bonitasoft.engine.exception.InvalidPageZipMissingIndexException;
import org.bonitasoft.engine.exception.InvalidPageZipMissingPropertiesException;
import org.bonitasoft.engine.exception.NotFoundException;
import org.bonitasoft.engine.exception.SearchException;
import org.bonitasoft.engine.exception.UnauthorizedAccessException;
import org.bonitasoft.engine.exception.UpdateException;
import org.bonitasoft.engine.exception.UpdatingWithInvalidPageTokenException;
import org.bonitasoft.engine.exception.UpdatingWithInvalidPageZipContentException;
import org.bonitasoft.engine.page.Page;
import org.bonitasoft.engine.page.PageCreator;
import org.bonitasoft.engine.page.PageNotFoundException;
import org.bonitasoft.engine.page.PageURL;
import org.bonitasoft.engine.page.PageUpdater;
import org.bonitasoft.engine.search.SearchOptions;
import org.bonitasoft.engine.search.SearchResult;

/**
 * This API gives access to all page features. Page is a way to add pages on portal.
 * 

 * Also allows to manipulate Pages, through creation, deletion, search.
 * 
 *
 * @author Laurent Leseigneur
 * @see org.bonitasoft.engine.page.Page
 */
public interface PageAPI {

    /**
     * Retrieves a page from its ID.
     *
     * @param pageId
     *        the Identifier of the page to retrieve
     * @return the found page
     * @throws org.bonitasoft.engine.page.PageNotFoundException
     *         if no page can be found with the provided ID.
     */
    Page getPage(final long pageId) throws PageNotFoundException;

    /**
     * Retrieves a page from its name.
     *
     * @param name
     *        the name of the page to retrieve
     * @return the found page
     * @throws PageNotFoundException
     *         if no page can be found with the provided page or is assigned with a process definition.
     */
    Page getPageByName(final String name) throws PageNotFoundException;

    /**
     * Retrieves a page from its name and processDefinitionId.
     *
     * @param name
     *        the name of the page to retrieve
     * @param processDefinitionId
     *        the process definition ID associated to the page
     * @return the found page
     * @throws PageNotFoundException
     *         if no page can be found with the provided name and process definition ID.
     */
    Page getPageByNameAndProcessDefinitionId(final String name, long processDefinitionId) throws PageNotFoundException;

    /**
     * Retrieves the binary content of a page.
     *
     * @param pageId
     *        the ID of the page to extract the content for.
     * @return
     *         the binary content of the page.
     * @throws PageNotFoundException
     *         if no page can be found with the provided ID.
     */
    byte[] getPageContent(final long pageId) throws PageNotFoundException;

    /**
     * Searches for pages with specific search criteria.
     *
     * @param searchOptions
     *        the search options for the search. See {@link org.bonitasoft.engine.search.SearchOptions} for search
     *        option details.
     * @return the SearchResult containing
     * @throws org.bonitasoft.engine.exception.SearchException
     *         if a problem occurs during the search.
     */
    SearchResult searchPages(final SearchOptions searchOptions) throws SearchException;

    /**
     * Creates a custom page.
     * Note that if called from an operation in a task, the author of the page will always be the user System.
     *
     * @param pageCreator
     *        the creator object to instantiate the new page.
     * @param content
     *        the binary content of the page.
     * @return the newly created page.
     * @throws org.bonitasoft.engine.exception.AlreadyExistsException
     *         if a page with this name already exists.
     * @throws org.bonitasoft.engine.exception.CreationException
     *         if an error occurs during the creation.
     * @deprecated as of 9.0.0. Page content should be created at startup.
     */
    @Deprecated(since = "9.0.0")
    Page createPage(final PageCreator pageCreator, final byte[] content)
            throws AlreadyExistsException, CreationException, InvalidPageTokenException,
            InvalidPageZipContentException;

    /**
     * Updates a custom page.
     *
     * @param pageId
     *        the Identifier of the page to update
     * @param pageUpdater
     *        the creator object to instantiate the new page.
     * @return the newly created page.
     * @throws org.bonitasoft.engine.exception.UpdateException
     *         if an error occurs during the update.
     * @throws org.bonitasoft.engine.exception.AlreadyExistsException
     *         if a page with this name already exists.
     * @deprecated as of 9.0.0. Page content should be updated at startup.
     */
    @Deprecated(since = "9.0.0")
    Page updatePage(final long pageId, final PageUpdater pageUpdater)
            throws UpdateException, AlreadyExistsException, UpdatingWithInvalidPageTokenException,
            UpdatingWithInvalidPageZipContentException;

    /**
     * Updates a custom page content.
     * it read the page.properties inside to update the page properties
     *
     * @param pageId
     *        the Identifier of the page to update
     * @param content
     *        the binary content of the page.
     * @throws org.bonitasoft.engine.exception.UpdateException
     *         if an error occurs during the update.
     * @deprecated as of 9.0.0. Page content should be updated at startup.
     */
    @Deprecated(since = "9.0.0")
    void updatePageContent(final long pageId, final byte[] content)
            throws UpdateException, UpdatingWithInvalidPageTokenException,
            UpdatingWithInvalidPageZipContentException;

    /**
     * Deletes a page identified by its ID.
     *
     * @param pageId
     *        the page identifier to delete.
     * @throws org.bonitasoft.engine.exception.DeletionException
     *         if a problem occurs during deletion.
     */
    void deletePage(final long pageId) throws DeletionException;

    /**
     * Deletes a list of pages, given by their IDs.
     *
     * @param pageIds
     *        a list of page identifiers to delete.
     * @throws org.bonitasoft.engine.exception.DeletionException
     *         if a problem occurs during deletion.
     */
    void deletePages(final List pageIds) throws DeletionException;

    /**
     * create a page using the given content
     * the content must contain a page.properties file that contains information on the page:
     * name, displayName and description. Be aware that this method does not update your web permission-mappings.
     * It means that rest api extensions created with this method will not be accessible from the portal.
     * To avoid the problem, either use the create
     * page rest api or upload the extensions directly from Bonita Portal.
     * Note that if called from an operation in a task, the author of the page will always be the user System.
     *
     * @param contentName
     *        name of the zip file containing the page
     * @param content
     *        content of the zip file containing the page
     * @return
     *         the created page
     * @throws org.bonitasoft.engine.exception.AlreadyExistsException
     *         if a page with the same name already exists
     * @throws org.bonitasoft.engine.exception.CreationException
     * @since 6.3.1
     * @deprecated as of 9.0.0. Page content should be created at startup.
     */
    @Deprecated(since = "9.0.0")
    Page createPage(String contentName, byte[] content)
            throws AlreadyExistsException, CreationException, InvalidPageTokenException,
            InvalidPageZipContentException;

    /**
     * Read the content of the page zip file check it is consistent and return it's properties
     *
     * @param content
     *        content of the zip file containing the page
     * @return
     *         the properties of the page
     * @since 6.4.0
     */
    Properties getPageProperties(byte[] content, boolean checkIfItAlreadyExists) throws InvalidPageTokenException,
            AlreadyExistsException, InvalidPageZipMissingPropertiesException, InvalidPageZipMissingIndexException,
            InvalidPageZipInconsistentException,
            InvalidPageZipMissingAPropertyException;

    /**
     * Resolves a Page URL from a specific key.
     *
     * @param key the key of the page to resolve.
     * @return the PageURL containing the pageId or the complete
     * @throws NotFoundException if the key does not match anything.
     * @see PageURL the structured PageURL that points to the Page or URL
     */
    PageURL resolvePageOrURL(String key, Map context, boolean executeAuthorizationRules)
            throws NotFoundException, UnauthorizedAccessException, ExecutionException;

}