A pipeline is an execution mechanism that allows for modular code execution. Oracle ATG Web Commerce uses pipelines to execute tasks such as loading, saving, and checking out Orders. The PipelineManager implements the pipeline execution mechanism.

The commerce pipeline is defined in an XML file, which can be found at <ATG10dir>/DCS/config/atg/commerce/commercepipeline.xml. To execute a pipeline through JSPs, define a handle method in a form handler class that calls the PipelineManager.

In the Nucleus hierarchy, the PipelineManager is located at /atg/commerce/PipelineManager. When you deploy an application that includes Commerce, a new instance is created and the commerce pipeline configuration is loaded. The commerce pipeline configuration file contains the definition for the processOrder chain. To insert a new link, add a new element to the XML file that references the new pipeline processor. The new functionality is inserted into the execution chain without affecting the existing code.

A pipeline should generally be executed from an OrderManager method. This is the case for the loadOrder(), updateOrder(), and processOrder() methods.

For more information, see the Processor Chains and the Pipeline Manager chapter in this manual.

Copyright © 1997, 2012 Oracle and/or its affiliates. All rights reserved. Legal Notices