represents the structure of an Uniform Resource Locator.
If the structure represents a valid URL or not depends on prior usage of
the functions of XURLTransformer. Only after one of the functions
returned true this can be assumed.
It is not necessary to set all of the fields; either Complete
or (some of) the others are set. Additionally, most of the other
fields, like Host, Port,
User, Password,
or Mark, are optional.
contains the string representation of the complete URL, for example,
http://www.sun.de:8080/pub/test/foo.txt?a=b#xyz
It is used as a central input/output or input parameter for the interfaces of
XURLTransformer. The usage of one of the XURLTransformer
function is mandatory to validate the URL. It cannot be assumed that
URL::Complete represents always a valid URL!
contains the last segment of the hierarchical path of the URL, for the above example, "foo.txt"
Attention:A service implementing the XURLTransformer interface
will normally not detect if the last segment is a folder or a file. So it is possible that
the last segment describes a folder. If you want to be sure that a file URL that references
a folder will be correctly put into the URL fields you should append a '/' at the end of the
hierarchical path.
