The link
protocol handler provides support for artifact style
references to a resource which contains a reference to another uri.
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 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.