DPML
DPML Transit Link Protocol
HomeUtilitiesStationMetro
Link Protocol

The link protocol handler provides support for artifact style references to a resource which contains a reference to another uri.

Specification

The specification of the link protocol is as follows;

 link:[type]:[group]/[name]#[version] 

Type, group and name are required fields. The version field is optional.

type The type of the artifact - e.g. "module".
group The group to which the artifact belong, so that naming conflicts can be avoided. It is recommended that the group is multi-leveled and slash separated, where the top level denotes the distinguishable name of the organization.
name The name of the resource.
version Optional opaque identifier.
Using an link URL

Using link URLs are no different from any http or ftp URLs. You create them by instantiating the java.net.URL class, and setting the protocol to "link" (no quotes).

The following example link URI identifies a resource named "dpml-metro" associated with the "dpml/metro" group, using a resource type called "module".

link:module:dpml/metro/dpml-metro

The above uri refers to a special artifact datatype with same name as a normal artifact plus the ".link" suffix. The contents of this data object is a text file continaing a redirection uri. Resolving the content of a link will result is the delgation of the request to the uri declared by the link.