org.bonitasoft.engine.page

Interface PageMappingService

All Known Implementing Classes:

PageMappingServiceImpl

public interface PageMappingService

Service that allows to map an arbitrary String key to a (Custom) Page or URL. Also allows to process the URL or Page return by providing an URLAdapter implementation that will be called automatically. Also allows to execute Authorization checkings by specifying rules to execute before returning the Page or URL.

Author:

Baptiste Mesta, Emmanuel Duchastenier, Matthieu Chaffotte

See Also:

URLAdapter

Method Summary

Modifier and Type	Method and Description
SPageMapping	create(String key, Long pageId, List<String> authorizationRules)
SPageMapping	create(String key, String url, String urlAdapter, List<String> authorizationRules)
void	delete(SPageMapping SPageMapping) delete this page mapping
List<SPageMapping>	get(long pageId, int startIndex, int maxResults) Gets the paginated mappings of the page.
SPageMapping	get(String key)
SPageURL	resolvePageURL(SPageMapping pageMapping, Map<String,Serializable> context, boolean executeAuthorizationRules)
void	update(SPageMapping pageMapping, Long pageId) update the given page mapping
void	update(SPageMapping pageMapping, String url, String urlAdapter) update the given page mapping

Method Detail

create

SPageMapping create(String key,
                    Long pageId,
                    List<String> authorizationRules)
             throws org.bonitasoft.engine.commons.exceptions.SObjectCreationException

Parameters:

key - the key used to retrieve the mapping

pageId - the id of the custom page

authorizationRules - the names of the authorization rules to execute

Returns:

the created page mapping

Throws:

org.bonitasoft.engine.commons.exceptions.SObjectCreationException - when there is an issue while creating this object

Since:

7.0.0

create

SPageMapping create(String key,
                    String url,
                    String urlAdapter,
                    List<String> authorizationRules)
             throws org.bonitasoft.engine.commons.exceptions.SObjectCreationException

Parameters:

key - the key used to retrieve the mapping

url - the external URL the mapping points to

urlAdapter - the name of the URL adapter that transform the URL in case of an external URL. i.e. it can add parameters

authorizationRules - the names of the authorization rules to execute

Returns:

the created page mapping

Throws:

org.bonitasoft.engine.commons.exceptions.SObjectCreationException - when there is an issue while creating this object

Since:

7.0.0

get

SPageMapping get(String key)
          throws org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException,
                 org.bonitasoft.engine.persistence.SBonitaReadException

Parameters:

key - the key of the page mapping to retrieve

Returns:

the page mapping having this key

Throws:

org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException - when there is no mapping having this key

org.bonitasoft.engine.persistence.SBonitaReadException

resolvePageURL

SPageURL resolvePageURL(SPageMapping pageMapping,
                        Map<String,Serializable> context,
                        boolean executeAuthorizationRules)
                 throws org.bonitasoft.engine.commons.exceptions.SExecutionException,
                        SAuthorizationException

Parameters:

pageMapping -

context -

executeAuthorizationRules -

Returns:

Throws:

org.bonitasoft.engine.commons.exceptions.SExecutionException

SAuthorizationException

delete

void delete(SPageMapping SPageMapping)
     throws org.bonitasoft.engine.commons.exceptions.SDeletionException

delete this page mapping

Parameters:

SPageMapping - the page mapping to delete

Throws:

org.bonitasoft.engine.commons.exceptions.SDeletionException

update

void update(SPageMapping pageMapping,
            Long pageId)
     throws org.bonitasoft.engine.commons.exceptions.SObjectModificationException,
            org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException,
            org.bonitasoft.engine.persistence.SBonitaReadException

update the given page mapping

Parameters:

pageMapping - the pageMapping to update

pageId - the id of the page or null

Throws:

org.bonitasoft.engine.commons.exceptions.SObjectModificationException

org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException

org.bonitasoft.engine.persistence.SBonitaReadException

update

void update(SPageMapping pageMapping,
            String url,
            String urlAdapter)
     throws org.bonitasoft.engine.commons.exceptions.SObjectModificationException,
            org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException,
            org.bonitasoft.engine.persistence.SBonitaReadException

update the given page mapping

Parameters:

pageMapping - the pageMapping to update

url - the URL or null

urlAdapter - the new URL adapter to use

Throws:

org.bonitasoft.engine.commons.exceptions.SObjectModificationException

org.bonitasoft.engine.commons.exceptions.SObjectNotFoundException

org.bonitasoft.engine.persistence.SBonitaReadException

get

List<SPageMapping> get(long pageId,
                       int startIndex,
                       int maxResults)
                throws org.bonitasoft.engine.persistence.SBonitaReadException

Gets the paginated mappings of the page.

Parameters:

pageId - the page identifier

startIndex - the start index

maxResults - the max results

Returns:

the paginated mappings of the page

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException