Difference between revisions of "URL URI URN Implimentations"

From BRL-CAD
(Updated URL page with current information)
 
(6 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{DesignDocument}}
+
[[category:Geometry Service]]
  
cad://dloman@fe80::21b:63ff:fe03:3cdf%en1/hardware/faseners/9.16th/3in/aluminum/bolt.g/
+
The formal way to specify the URL of a directory or concrete resource in a Geometry Service repository is as follows:
  
<br /><br />
+
gs://host.of.geometry.service[:port]/name[:revision]/name[:revision]/...etc[:revision}[/]
  
cad://dloman@sassyhost/hardware/faseners/bolts.g/9.16th/3inch/aluminum/dwaynesbolt/bolt01.s
+
'''[port]''' Port is an optional paramater, default is 5309.
cad://user  @hostname /dir    /dir    /db    /comb  /comb /comb    /region    /solid
 
cad://user  @hostname /comb    /comb    /comb  /comb  /comb /comb    /region    /solid
 
  
<br /><br /><br /><br /><br /><br /><br /><br /><br /><br />
+
'''[revision]''' Revision is an optional per path step parameter, default is HEAD.
 +
 
 +
'''[/]''' A trailing backslash indicates a directory, whereas the absense of a backslash indicates a concrete resource.
 +
<br />
 +
<br />
 +
----
 +
===Examples===
 +
 
 +
Requesting
 +
gs://geoserv.brlcad.org/wheeled/civilian/cars/sports/lotus/
 +
would return a directory listing.
 +
<br />
 +
<br />
 +
<br />
 +
Where as requesting
 +
gs://geoserv.brlcad.org/wheeled/civilian/cars/sports/lotus/elise.g
 +
would return valid geometry.
 +
<br />
 +
<br />
 +
<br />
 +
and requesting
 +
gs://geoserv.brlcad.org/wheeled/civilian/cars/sports/lotus/elise.png
 +
would return a PNG image of the associated geometry.

Latest revision as of 11:55, 14 January 2011


The formal way to specify the URL of a directory or concrete resource in a Geometry Service repository is as follows:

gs://host.of.geometry.service[:port]/name[:revision]/name[:revision]/...etc[:revision}[/]

[port] Port is an optional paramater, default is 5309.

[revision] Revision is an optional per path step parameter, default is HEAD.

[/] A trailing backslash indicates a directory, whereas the absense of a backslash indicates a concrete resource.


Examples[edit]

Requesting

gs://geoserv.brlcad.org/wheeled/civilian/cars/sports/lotus/ 

would return a directory listing.


Where as requesting

gs://geoserv.brlcad.org/wheeled/civilian/cars/sports/lotus/elise.g

would return valid geometry.


and requesting

gs://geoserv.brlcad.org/wheeled/civilian/cars/sports/lotus/elise.png

would return a PNG image of the associated geometry.