The Assembler is an Oracle Commerce component that performs the following essential roles in any Oracle Commerce application:

The following diagram illustrates the role of the Assembler in an Oracle Commerce implementation:

As shown in the preceding diagram, the following things happen when customers request information through your application page:

  1. Your application invokes the assemble() method as follows:

    ContentItem contentItem = new RedirectAwareContentInclude("/myUrl");

    ContentItem responseContentItem = assembler.assemble(contentItem)

    where /myUrl is the URL to a page that you are assembling in Experience Manager and responseContentItem is a tree of other content items.

  2. The assemble() method sends responseContentItem to the Assembler.

  3. The Assembler passes the individual content items in responseContentItem to cartridge handlers, each of which handles a different content type. Each content item specifies a request for information.

  4. The cartridge handlers pass the requests on to the appropriate sources of information, such as an MDEX Engine, a relational database system, a content management system, and so on.

  5. The cartridge handlers receive and process information from their respective sources. The handlers contain all the logic needed to process the information, though they may also process requests without requiring input from an external data source.

  6. Each cartridge handler returns to the Assembler a content item that contains the requested information.

  7. The Assembler combines the content items that it receives from all of the cartridge handlers into a responseContentItem, which is structured as a tree that contains all of the information required by the front end application.

  8. The Assembler returns responseContentItem to the front end application.

  9. Rendering code in the application converts the information in responseContentItem into a form that can be displayed in the appropriate cartridges on your application page. Typically, a cartridge renderer (a separate module of rendering code) processes and displays the information for each content item in the responseContentItem tree.

The Tools and Frameworks package includes a Java Assembler implementation that uses Spring to resolve cartridge handlers and services.

You can develop extensions to the framework to interact with your resources, centralizing runtime data retrieval and manipulation in your application. For these reasons, the Assembler can be integrated with organizations that use Service-Oriented Architecture.

The Assembler stores and manipulates data as sets of key:value pairs known as content items. Content items can represent cartridges, which map to front-end features in an application.

Copyright © Legal Notices