Package com.orchestranetworks.ui

Class UIHttpManagerComponent

java.lang.Object
com.orchestranetworks.ui.UIHttpManagerComponent
public abstract class UIHttpManagerComponent extends Object
This class is a utility for invoking user interface components using the HTTP protocol.

A general introduction to EBX® as a Web Component is available here.

How to obtain a Web Component

An instance of this class can be obtained with the following factory methods:

With the second and third options, the URL that is obtained is a permanent link (permalink).

User authentication

The authentication uses the first applicable case of the following:

  1. If this component has been obtained by invoking the method UIResourceLocator.createWebComponentForSubSession(), the authentication is automatic and the new Session shares the properties of the calling session.
  2. Otherwise, if the parameters login and password are specified (see method setUserLoginPassword(String, String)), the method Directory.authenticateUserFromLoginPassword(String, String) is called when the HTTP request is received by the application server. If the user cannot be authenticated using the specified credentials, an 'access denied' page is returned.
  3. Otherwise, the method Directory.authenticateUserFromHttpRequest(HttpServletRequest) is called (it is up to the specific directory to implement this method).
    1. If the method throws an exception, an 'access denied' page is returned.
    2. If the method returns null (default implementation), the request is considered to have no authentication specified, so the login/password page is returned to the user. When this page is submitted, the method Directory.authenticateUserFromLoginPassword(String, String) is called.
See Also:

  • Method Details

    • createWithURIWithParameters

      public static UIHttpManagerComponent createWithURIWithParameters(String uriWithParameters)
      Creates an instance of this class in order to call the EBX® user interface from an external application. A URI to EBX® user interface with parameters can be specified.
      Parameters:
      uriWithParameters - URI with parameters to EBX® web application.
      Since:
      6.0.0

    • createWithBaseURI

      public static UIHttpManagerComponent createWithBaseURI(String baseURI)
      Creates an instance of this class in order to call the EBX® user interface from an external application.
      Parameters:
      baseURI - Base URI to EBX® web application.
      See Also:

    • createWithBaseURI

      @Deprecated public static UIHttpManagerComponent createWithBaseURI(String baseURI, boolean enforceStrongEncoding)
      Deprecated.
      Since 5.9.0, use instead createWithBaseURI(String).
      Creates an instance of this class in order to call the EBX® user interface from an external application.
      Parameters:
      baseURI - Base URI to EBX® web application.
      enforceStrongEncoding - This parameter is now ignored.

    • createWithBaseURI

      public static UIHttpManagerComponent createWithBaseURI(String baseURI, AdaptationName aManagerReference)
      Creates an instance of this class in order to call the EBX® user interface from an external application.

      The default deployment requires a URL base of the following form:

      http://<host>[:<port>]/ebx/

      Or, if the Java application is running on the same application server:

      /ebx/

      Note: The URI base must refer to the servlet named com.onwbp.front.FrontServlet defined in the web application ebx.war (see file /WEB-INF/web.xml in ebx.war).

      Parameters:
      baseURI - Base URI to EBX® web application (see examples above).
      aManagerReference - Identifier of the EBX® user interface dataset (for example, ebx-manager).

    • createWithBaseURI

      @Deprecated public static UIHttpManagerComponent createWithBaseURI(String baseURI, boolean enforceStrongEncoding, AdaptationName aManagerReference)
      Deprecated.
      Since 5.9.0, use instead createWithBaseURI(String, AdaptationName).
      Creates an instance of this class in order to call the EBX® user interface from an external application.

      The default deployment requires a URL base of the following form:

      http://<host>[:<port>]/ebx/

      Or, if the Java application is running on the same application server:

      /ebx/

      Note: The URI base must refer to the servlet named com.onwbp.front.FrontServlet defined in the web application ebx.war (see file /WEB-INF/web.xml in ebx.war).

      Parameters:
      baseURI - Base URI to EBX® web application (see examples above).
      enforceStrongEncoding - This parameter is now ignored.
      aManagerReference - Identifier of the EBX® user interface dataset (for example, ebx-manager).

    • createWithURIWithParametersForSubSession

      public static UIHttpManagerComponent createWithURIWithParametersForSubSession(String uriWithParameters, Session aSession)
      Creates an instance of this class in order to call the EBX® user interface in a separate sub-session (namely, a Web Component). As this uses a sub-session, the URL obtained by this type of component is not a permanent link (permalink). It is automatically authenticated and inherits all its properties from its parent session, except trackingInfo (these inherited properties are available using the Session interface).

      The Web Component must be invoked within a pop-up, inner pop-up, or iFrame. A standard inner pop-up can be created by using the method UIComponentWriter.buildButtonPreview(String).

      A URI to EBX® user interface, including parameters for this instance, can be specified.

      Parameters:
      uriWithParameters - URI with parameters to EBX® web application.
      aSession - Current user session in EBX® user interface.
      Since:
      6.0.0
      See Also:

    • createOnServiceContext

      @Deprecated public static UIHttpManagerComponent createOnServiceContext(ServiceContext aContext)
      Deprecated.
      This method has been replaced by UIResourceLocator.createWebComponentForSubSession().

    • createOnAjaxContext

      @Deprecated public static UIHttpManagerComponent createOnAjaxContext(UIAjaxContext aContext)
      Deprecated.
      This method has been replaced by UIResourceLocator.createWebComponentForSubSession().

    • createOnUIBeanContext

      @Deprecated public static UIHttpManagerComponent createOnUIBeanContext(UIResponseContext aContext)
      Deprecated.
      This method has been replaced by UIResourceLocator.createWebComponentForSubSession().

    • createOnUILabelRendererForHierarchyContext

      @Deprecated public static UIHttpManagerComponent createOnUILabelRendererForHierarchyContext(UILabelRendererForHierarchyContext aContext)
      Deprecated.
      This method has been replaced by UIResourceLocator.createWebComponentForSubSession().

    • getURIWithoutParameters

      public abstract String getURIWithoutParameters()
      This function returns the URI to EBX® user interface, without specific parameters.
      See Also:

    • getURIWithParameters

      public String getURIWithParameters(String aBaseURI)

    • getURIWithParameters

      public String getURIWithParameters()
      This function returns the URI to EBX® user interface, including the parameters specified by this instance.

      Note: This method may return a String whose length is not supported by the browser or the Servlet Container.

      User authentication parameters have to be added according to the current user directory implementation.

      See Also:

    • getHttpParameterNames

      public List<String> getHttpParameterNames()
      Returns the names of the HTTP parameters that are specified by this instance.

      Since the method getURIWithParameters() may give a URI that is too long, this method can be used for building a POST request.

      See Also:

    • getHttpParameterValue

      public String getHttpParameterValue(String aParameterName)
      Returns the String value of a parameter, returns null if the parameter is not defined.

      See Also:

    • initFromHttpRequest

      public final void initFromHttpRequest(HttpServletRequest request) throws IllegalArgumentException
      Initializes this instance with the specified incoming request.

      This method can be used to "forward" EBX® Web Component parameters to another page to perform the actual call.

      Throws:
      IllegalArgumentException

    • getUserLogin

      public String getUserLogin()
      Returns the user login, null if no login/password is specified.
      See Also:

    • getUserPassword

      public String getUserPassword()
      Returns the user password, null if no login/password is specified.
      See Also:

    • setUserLoginPassword

      public void setUserLoginPassword(String userLogin, String userPassword)
      Specifies the login and password with which to authenticate the user.

      The authentication process is detailed in this class comment.

    • getHomeKey

      public HomeKey getHomeKey()

    • getInstanceReference

      public AdaptationReference getInstanceReference()

    • getXPathString

      public String getXPathString()

    • selectHome

      public void selectHome(HomeKey aDataSpaceOrSnapshotKey)
      Selects the specified dataspace or snapshot.
      Throws:
      IllegalArgumentException - if aDataSpaceOrSnapshotKey is null.

    • selectInstance

      public void selectInstance(HomeKey aDataSpaceOrSnapshotKey, AdaptationName aDataSetReference)
      Selects the specified dataset.
      Throws:
      IllegalArgumentException - if aDataSpaceOrSnapshotKey is null or aDataSetReference is null.

    • select

      public void select(HomeKey aDataSpaceOrSnapshotKey, AdaptationName aDataSetReference, Path aPath)
      Selects the node in the specified dataset.
      Throws:
      IllegalArgumentException - if aDataSpaceOrSnapshotKey is null.
      IllegalArgumentException - if xpath is a relative path.

    • select

      public void select(HomeKey aDataSpaceOrSnapshotKey, AdaptationName aDataSetReference, String aXPathExpression) throws IllegalArgumentException
      Specifies an entity selection in the EBX® repository.

      This is the most general method of performing an entity selection.

      Parameters:
      aDataSpaceOrSnapshotKey - identifies a dataspace or a snapshot in the repository.
      aDataSetReference - identifies a dataset in the dataspace or snapshot. If null, this method is the same as selectHome(HomeKey).
      aXPathExpression - XPath expression specifying a selection in the dataset. If null and dataset not null, this method is the same as selectInstance(HomeKey, AdaptationName); if not null and the XPath expression specifies a predicate, this parameter overrides the method setPredicate.
      Throws:
      IllegalArgumentException - if aDataSpaceOrSnapshotKey is null, or aDataSetReference is null but not aXPathExpression.
      IllegalArgumentException - if aXPathExpression contains a relative path to the dataset node.
      See Also:

    • selectHome

      public void selectHome(AdaptationHome aDataSpaceOrSnapshot)
      Selects the specified dataspace or snapshot.
      Throws:
      IllegalArgumentException - if aDataSpaceOrSnapshot is null.
      See Also:

    • selectInstanceOrOccurrence

      public void selectInstanceOrOccurrence(Adaptation aDataSetOrRecord)
      Selects the specified dataset or record.
      Throws:
      IllegalArgumentException - if aDataSetOrRecord is null.
      See Also:

    • selectInstanceOrOccurrenceWithPredicate

      public void selectInstanceOrOccurrenceWithPredicate(Adaptation aDataSetOrRecord, String aPredicate)
      Selects the specified dataset or record with the specified predicate restriction.
      Parameters:
      aPredicate - the predicate that defines the selection; if not null, this parameter overrides the method setPredicate.
      Throws:
      IllegalArgumentException - if aDataSetOrRecord is null.
      See Also:

    • selectNode

      public void selectNode(Adaptation aDataSetOrRecord, Path aNode)
      Selects the specified node.
      Parameters:
      aDataSetOrRecord - a dataset or a record.
      aNode - a path to a node in the dataset; if null this method is the same as selectInstanceOrOccurrence(Adaptation).
      Throws:
      IllegalArgumentException - if aDataSetOrRecord is null.
      IllegalArgumentException - if aNode is a relative path and aDataSetOrRecord is a dataset.
      See Also:

    • selectNode

      public void selectNode(Adaptation aDataSetOrRecord, Path aNode, String aPredicate)
      Selects the specified node with the specified predicate restriction.
      Parameters:
      aDataSetOrRecord - a dataset or a record.
      aNode - a path to a node in the dataset; if null this method is the same as selectInstanceOrOccurrence(Adaptation).
      aPredicate - the predicate that defines the selection; if not null, this parameter overrides the method setPredicate.
      Throws:
      IllegalArgumentException - if aDataSetOrRecord is null.
      IllegalArgumentException - if aNode is a relative path and aDataSetOrRecord is a dataset.
      See Also:

    • selectWorkflowView

      public final void selectWorkflowView(WorkflowView aWorkflowView)
      Selects the specified workflow view using the service ServiceKey.WORKFLOW.

      Note: The method setService(ServiceKey) will override parameters that have been automatically set by this method.

      Parameters:
      aWorkflowView - the key of the workflow view to select.
      Since:
      5.4.3

    • selectPerspective

      public final void selectPerspective(String aPerspectiveName)
      Selects the specified perspective.
      Parameters:
      aPerspectiveName - the name of the perspective to select.
      Since:
      5.9.0 fix B

    • selectPerspectiveAction

      public final void selectPerspectiveAction(String aPerspectiveName, String aPerspectiveActionName)
      Selects the specified perspective action.
      Parameters:
      aPerspectiveName - the name of the perspective to select.
      aPerspectiveActionName - the name of the perspective action to select.
      Since:
      5.9.0 fix B

    • setFirstCallDisplay

      public final void setFirstCallDisplay(FirstCallDisplay aFirstCallDisplay)
      Specifies what must be displayed upon first call, either the whole tabular or hierarchical or a record.
      Since:
      5.6.1

    • setFirstCallDisplayRecord

      public final void setFirstCallDisplayRecord(String aFirstCallDisplayPredicate)
      Specifies that a record must be displayed upon first call. If the specified predicate is not empty, the corresponding record will be opened. Otherwise, opens the first record in the request.
      Since:
      5.7.1
      See Also:

    • setFirstCallDisplayHierarchyExpanded

      public final void setFirstCallDisplayHierarchyExpanded()
      Specifies that the hierarchy must be displayed expanded. If a predicate is specified on the target table, the hierarchy will be expanded up to the nodes that match the predicate (see select(HomeKey, AdaptationName, String)).
      Since:
      5.8.0 fix D
      See Also:

    • selectWorkItem

      public final void selectWorkItem(boolean shouldTakeAndStart, WorkItemKey aWorkItemKey)
      Selects the specified work item using the service ServiceKey.WORKFLOW.

      Note: The methods setPredicate(String) and setService(ServiceKey) will override parameters that have been automatically set by this method.

      Parameters:
      shouldTakeAndStart - if true, the target work item will be automatically allocated to and started for the current user; does nothing if this is already the case.
      aWorkItemKey - the key of the work item to select.
      Throws:
      IllegalArgumentException - if aWorkItemKey is null.
      Since:
      5.4.3
      See Also:

    • selectWorkItemInMonitoring

      public final void selectWorkItemInMonitoring(WorkItemKey aWorkItemKey)
      Selects the specified work item using the service ServiceKey.WORKFLOW and in the workflow view WorkflowView.MONITORING_WORKITEMS

      Note: The methods setPredicate(String) and setService(ServiceKey) will override parameters that have been automatically set by this method.

      Parameters:
      aWorkItemKey - the key of the work item to select
      Throws:
      IllegalArgumentException - if aWorkItemKey is null.
      Since:
      5.4.3
      See Also:

    • getService

      public ServiceKey getService()
      Returns the service to be activated, null if no specific service has been set.

    • setService

      public void setService(ServiceKey aServiceKey)
      Specifies the service to be activated.

      If no service is defined, the entity specified using the select... methods is selected.

      If a service is specified, it may require the selection of some entities (and additional parameters for specific services). Built-in services are documented in the class ServiceKey) and specific services are documented in their own declarations.

      Parameters:
      aServiceKey - The service that must be activated when the EBX® Web Component is called, null if no specific service is activated.

    • getCompareFilter

      public CompareFilter getCompareFilter()
      Returns the comparison filter defined for this Web Component.
      Since:
      5.4.2

    • setCompareFilter

      public void setCompareFilter(CompareFilter compareFilter)
      Specifies the comparator filter for this Web Component.

      This property is interpreted only if the service ServiceKey.COMPARE is set.

      Since:
      5.4.2

    • getScope

      public UIHttpManagerComponent.Scope getScope()
      Returns the scope defined for this Web Component.
      Since:
      5.2.2

    • setScope

      public void setScope(UIHttpManagerComponent.Scope scope)
      Specifies the scope for this Web Component.

      If unspecified, a minimal scope will be applied and the user will only be able to work with the selected content.

      Since:
      5.2.2

    • getCloseButtonSpec

      public UIHttpManagerComponent.CloseButtonSpec getCloseButtonSpec()
      Returns the close button display style for this Web Component.
      Since:
      5.2.2

    • setCloseButtonSpec

      public void setCloseButtonSpec(UIHttpManagerComponent.CloseButtonSpec closeButtonSpec)
      Specifies whether the close button is displayed for this Web Component, and if so, its display style.

      If unspecified, the default is to display the logout button if the web component scope is full. Otherwise, no button is displayed.

      Since:
      5.2.2
      See Also:

    • getRedirectionURI

      public String getRedirectionURI()
      Returns the URI that will be used to redirect the user after closing a session of EBX® user interface.

    • setRedirectionURI

      public void setRedirectionURI(String redirectionUrl)
      Specifies the URI that will be used to redirect the user after closing an EBX® user interface session.

      The URI can have an additional HTTP parameter that specifies a return code. The application that receives the URI can extract it by means of method UIHttpManagerComponentHelper.getReturnCodeFromHttpRequest(jakarta.servlet.ServletRequest).

      See Also:

    • getTrackingInfo

      public String getTrackingInfo()
      Returns tracking info for the new user session, returns null if no specific tracking info has been set.
      See Also:

    • setTrackingInfo

      public void setTrackingInfo(String trackingInfo)
      Specifies tracking info for the new user session.
      See Also:

    • getLocale

      public Locale getLocale()
      Returns the locale specified for the new user session, returns null if no specific locale has been set.
      See Also:

    • setLocale

      public void setLocale(Locale locale)
      Specifies the locale for the new user session.
      See Also:

    • compareSelectionWithEntity

      public void compareSelectionWithEntity(HomeKey homeOnRightKey, AdaptationName instanceOnRight, String tableOrOccurrenceOnRight)
      Specifies the activation of the comparison service.

      The user is directed to the comparison interface:

      • The selected entity, specified by one of the select... methods, is displayed on the left side.
      • The entity that is specified by the arguments of this method is displayed on the right side..

      Entities that can be compared are: two dataspaces or versions, two datasets, two tables, or two table records.

      Parameters:
      homeOnRightKey - identifies a dataspace or a snapshot in the repository.
      instanceOnRight - identifies a dataset in the specified dataspace or snapshot, null if comparing homes. The reference to a dataset is obtained by invoking the method Adaptation.getAdaptationName().
      tableOrOccurrenceOnRight - XPath expression that specifies either a unique table record in the specified dataset, or a table, or null if comparing dat sets or homes. The XPath expression that uniquely identifies a unique table record is directly obtained by invoking the method Adaptation.toXPathExpression().
      See Also:

    • getHomeKeyToCompareWith

      public HomeKey getHomeKeyToCompareWith()
      See Also:

    • getInstanceReferenceToCompareWith

      public AdaptationReference getInstanceReferenceToCompareWith()
      See Also:

    • getXPathStringToCompareWith

      public String getXPathStringToCompareWith()
      See Also:

    • getViewPublication

      public String getViewPublication()
      Returns the published custom view that will be applied to the selected content.
      Since:
      6.0.0
      See Also:

    • setViewPublication

      public void setViewPublication(String aPublication)
      Specifies the published custom view that will be applied to the selected content.

      The predicate specified by the custom view will be combined with the local predicate, if specified, as a logical 'AND' operation.

      Parameters:
      aPublication - the unique publication name of the custom view to be applied.
      Since:
      5.2.3
      See Also:

    • setPredicate

      public void setPredicate(String aPredicate)
      Sets a predicate to be applied to the selected table. If no table is selected, this predicate will be ignored.

      The predicate can also be set using methods such as selectNode.

      Parameters:
      aPredicate - the predicate to apply as a filter.
      Since:
      5.4.3
      See Also:

    • getAdditionalParameterValue

      public String getAdditionalParameterValue(String aParameterName)
      Returns the requested additional parameter or null if this parameter is not defined.
      Throws:
      IllegalArgumentException - if the parameter name is null or reserved.
      Since:
      5.9.0
      See Also:

    • setAdditionalParameter

      public void setAdditionalParameter(String aParameterName, String aValue)
      Adds an additional parameter.
      Throws:
      IllegalArgumentException - if the parameter name is null or reserved.
      Since:
      5.9.0
      See Also:

    • getAdditionalParameters

      public Map<String,String> getAdditionalParameters()
      Returns all additional parameters.
      Since:
      5.9.0
      See Also:

    • setAdditionalParameters

      public void setAdditionalParameters(Map<String,String> aParameterMap)
      Adds additional parameters.
      Throws:
      IllegalArgumentException - if the parameter map is null or any of its keys is a reserved parameter name.
      Since:
      5.9.0
      See Also:

    • getPerspectiveName

      public final String getPerspectiveName()
      Returns the selected perspective name.
      Since:
      6.0.0

    • showAllDataSetFeatures

      public void showAllDataSetFeatures()
      If called, all dataset features will be displayed. Note that the user permission will not be ignored.
      Since:
      5.4.0
      See Also:

    • showDataSetFeatures

      public void showDataSetFeatures(List<String> aFeaturesListToDisplay)
      If called, all dataset features will be hidden except those specified by the given list. Note that the user permission will not be ignored.
      Since:
      5.4.0
      See Also:

    • showDataSetFeature

      public void showDataSetFeature(String aFeature)
      If called, all dataset features will be hidden except the one specified. Note that the user permission will not be ignored.
      Since:
      5.4.0
      See Also:

    • hideAllDataSetFeatures

      public void hideAllDataSetFeatures()
      If called, all dataset features will be hidden.
      Since:
      5.4.0
      See Also:

    • hideDataSetFeatures

      public void hideDataSetFeatures(List<String> aFeaturesListToHide)
      If called, all dataset features will be displayed except those specified by the given list. Note that the user permission will not be ignored.
      Since:
      5.4.0
      See Also:

    • hideDataSetFeature

      public void hideDataSetFeature(String aFeature)
      If called, all dataset features will be displayed except the one specified. Note that the user permission will not be ignored.
      Since:
      5.4.0
      See Also:

    • showAllRecordFeatures

      public void showAllRecordFeatures()
      If called, all record features will be displayed. Note that the user permission will not be ignored.
      Since:
      5.4.0
      See Also:

    • showRecordFeatures

      public void showRecordFeatures(List<String> aFeaturesListToDisplay)
      If called, all record features will be hidden except those specified by the given list. Note that the user permission will not be ignored.
      Since:
      5.4.0
      See Also:

    • showRecordFeature

      public void showRecordFeature(String aFeature)
      If called, all record features will be hidden except the one specified. Note that the user permission will not be ignored.
      Since:
      5.4.0
      See Also:

    • hideAllRecordFeatures

      public void hideAllRecordFeatures()
      If called, all record features will be hidden.
      Since:
      5.4.0
      See Also:

    • hideRecordFeatures

      public void hideRecordFeatures(List<String> aFeaturesListToHide)
      If called, all record features will be displayed except those specified by the given list. Note that the user permission will not be ignored.
      Since:
      5.4.0
      See Also:

    • hideRecordFeature

      public void hideRecordFeature(String aFeature)
      If called, all record features will be displayed except the one specified. Note that the user permission will not be ignored.
      Since:
      5.4.0
      See Also:

    • showAllViewFeatures

      public void showAllViewFeatures()
      If called, all table or hierarchy features will be displayed. Note that the user permission will not be ignored.
      Since:
      5.4.0
      See Also:

    • showViewFeatures

      public void showViewFeatures(List<String> aFeaturesListToDisplay)
      If called, all table or hierarchy features will be hidden except those specified by the given list. Note that the user permission will not be ignored.
      Since:
      5.4.0
      See Also:

    • showViewFeature

      public void showViewFeature(String aFeature)
      If called, all table or hierarchy features will be hidden except the one specified. Note that the user permission will not be ignored.
      Since:
      5.4.0
      See Also:

    • hideAllViewFeatures

      public void hideAllViewFeatures()
      If called, all table or hierarchy features will be hidden.
      Since:
      5.4.0
      See Also:

    • hideViewFeatures

      public void hideViewFeatures(List<String> aFeaturesListToHide)
      If called, all table or hierarchy features will be displayed except those specified by the given list. Note that the user permission will not be ignored.
      Since:
      5.4.0
      See Also:

    • hideViewFeature

      public void hideViewFeature(String aFeature)
      If called, all table or hierarchy features will be displayed except the one specified. Note that the user permission will not be ignored.
      Since:
      5.4.0
      See Also:

    • setPageSize

      public void setPageSize(int aPageSize)
      Sets the number of rows that will be displayed per page. If a hierarchy is applied using the method setViewPublication(String), this is the number of records that will be shown for each level of the hierarchy.
      Since:
      5.4.2

    • getWorkflowView

      public WorkflowView getWorkflowView()
      Returns the workflow view using the service ServiceKey.WORKFLOW.
      Since:
      6.0.0