[ODE-281] XPath functions for RESTful BPEL: combineUrl, composeUrl, expandTemplate

• Type: New Feature
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 1.1
• Fix Version/s: 1.2
• Component/s: BPEL Runtime
• Assignee: Matthieu Riou
• Reporter: Alexis Midon
• Created: 12/May/08 23:40
• Updated: 22/May/08 00:01
• Resolved: 22/May/08 00:01

Description

Provide 2 new Xpath functions as described in the ODE wiki:

_combineUrl(base, relative)_
----------------------------------------------------
Takes the relative URL and combines it with the base URL to return a new absolute URL. If the relative parameter is an absolute URL, returns it instead.

_composeUrl(template, [name, value]*)_
_composeUrl(template, pairs)_
----------------------------------------------------
Expands the template URL by substituting place holders in the template, for example, ('/order/

{id}

', 'id', 5) returns '/order/5'. Substitute values are either name/value pairs passed as separate parameters, or a node-set returning elements with name mapping to value. The functions applies proper encoding to the mapped values. Undefined variables are replaced by an empty string.
Basically a uri is always returned.
Compliant with the URI Template spec [1].

_expandTemplate(template, [name, value]*)_
_expandTemplate(template, pairs)_
----------------------------------------------------
Same behavior as composeUrl except that undefined variables are NOT replaced by an empty string. The corresponding expansion pattern is not replaced. The immediate coensquence is that the function may return a template.

[1] http://bitworking.org/projects/URI-Templates/spec/draft-gregorio-uritemplate-03.html

Issue Links

• is part of: ODE-282 RESTful bpel Part I