http-bridge-config

Home > Books > NetKernel API and Services Reference > Accessor Listing > HTTP Transport > http-bridge-config

Module

The http-bridge-config accessor is exported by the urn:org:ten60:netkernel:tpt:http module. Import this module to gain access to the accessor.

Syntax

URI

active:http-bridge-config

Argument	Rules	Description
module	Mandatory	the uri of the module from which the config process should start
version	Optional	optional version uri (eg version:1.0.0)

Example Usage

DPML

active:http-bridge-config+module@urn:org:myorg:myfulcrum+version@version:1.0.0

NetKernel Foundation API

req=context.createSubRequest("active:http-bridge-config");
req.addArgument("module", [resource representation, aspect, or URI] );
result=context.issueSubRequest(req);

Purpose

The http-bridge-config accessor dynamically generates an HTTPBridgeConfig document. for the HTTP Bridge accessor. The http-bridge-config accessor is used by mapping Fulcrum requests for ffcpl:/etc/HTTPBridgeConfig.xml to this accessor which is a dynamically evaluated service to build a pseudo static config from all of the imported modules of the module specified in the module argument.

Deployment

In your fulcrum module which imports the tpt-http module use the following rewrite rule. Note: this rewrite rule must go in the mapping section of the module definition and not the rewrite section!

<rewrite>
  <match>ffcpl:/etc/HTTPBridgeConfig.xml</match>
  <to>active:http-bridge-config+module@[urn of your fulcrum module][+version@version of your fulcrum module]</to>
</rewrite>

Operation

The dynamic evaluation of the HTTPBridgeConfig goes as follows.

First try to find ffcpl:/etc/DefaultHTTPBridgeConfig.xml to use as a default template if this is not found then create an empty template.
Find all imported modules for the specified fulcrum module (optionally use version if provided as argument).
Iterate through imported modules - try to find ffcpl:/etc/HTTPBridgeConfig.xml in each module. If it is found then add all of it's HTTPBridge zones to the template.
Finally add a default zone
<zone>
  <match>.*</match>
  <processQueries />
  <passCookies />
</zone>

Notes: Zones which match .* will not be added to the merged config. Only the final default zone is allowed to match .*