 |
|
|
 |
Software Documentation
- About Transport Service
- Installation
- Operation
Download
Project Documentation
Operation
This document describes how to operate the Transport Service software contained in the transport-registry package. The Transport Service software is a web application for retrieving product files from the the Product Servers that are located at the various Discipline Nodes. The following topics can be found in this section:
Interface
The Transport Service provides a REST-based interface accessible via HTTP for interacting with the service. Because the REST-based interface operates over HTTP, there are several options for interacting with the Transport Service:
- Web Browser
Any standard web browser (e.g., Firefox, Safari, Internet Explorer, etc.) will allow interaction with the service.
- cURL
The cURL utility offers the most flexible means for interacting with the application. The utility comes installed on most UNIX-based platforms and is available for download for the Windows platform. The examples in the sections that follow utilize cURL to interact with the application. If cURL is not installed on the local machine but Wget is, see the Using Wget section for converting cURL commands to Wget commands.
The examples below use http://localhost:8080 as the default base end point for the service.
Product Retrieval
The Transport Service web application provides functionality for querying the Registry Service for a product or products and retrieving the associated files. The service can be queried using 3 possible methods for encoding the HTTP request parameters: DIS-Style syntax, XML query expressions, or simple HTTP (name, value) pairs. The following table summarizes the parameters available:
| HTTP Parameter | Description |
|---|---|
| q | The DIS-Style query expression identifying the product (or set of files) to retrieve from the Transport Service. The use of the q parameter is preferred over the use of the xmlq parameter, but it is still discouraged with respect to the use of straight HTTP (name, value) pairs (last option in this table). Additional information regarding the DIS-Style query format can be found at the Apache OODT DIS-Style Query page. |
| xmlq | The XML query expression identifying the product (or set of files) to retrieve from the Transport Service. The details for the format of this query expression will not be covered here. Although supported, the use of the xmlq parameter is discouraged. |
| identifier, package | The product identifier (specified one or more times), and the requested packaging format (ZIP or TGZ). This is the preferred method to query the transport-registry service. |
When using DIS-Style format, the identifier and package parameters must be encoded as part of the "q" value parameter:
| DIS Query Parameter | Description |
|---|---|
| identifier | The identifier for the product to be retrieved in the form of a PDS logical identifier (LID) or the LID and the version identifier (LIDVID). This parameter is required and may be specified more than once. Due to the 5000 character limit for HTTP POST commands, a safe maximum of specified identifiers is around 50. |
| package | The package type to be returned from the Transport Service. The valid values are ZIP and TGZ, and are NOT case sensitive. The default value is ZIP. This parameter is optional. |
The following is an example query using DIS-Style query syntax with the q parameter:
% curl -X GET -o package.zip -v \
http://localhost:8080/transport-registry/prod?q=identifier+EQ+<LID|LIDVID>
Assuming the LID or LIDVID was specified correctly, the above query should return a ZIP package containing the products associated with the specified product. The following is an example query in DIS-Style syntax that will return a TAR/GZIP package:
% curl -X GET -o package.tar.gz -v \
http://localhost:8080/transport-registry/prod?q=identifier+EQ+<LID|LIDVID>+AND+package+EQ+TGZ
Alternatively, the product identifier and desired packaging can be specified using standard HTTP parameter encoding. The general URL form is:
http://localhost:8080/transport-registry/prod?identifier=<LID|LIDVID>&package=<TGZ|ZIP>
For example, the following URLs specify the same logical request for retrieving a PDS product:
http://localhost:8080/transport-registry/prod?q=identifier+EQ+\
urn:nasa:pds:phx_lidar:reduced:LS075RLS_00902835894_1885M1+AND+package+EQ+TGZ
http://localhost:8080/transport-registry/prod?identifier=\
urn:nasa:pds:phx_lidar:reduced:LS075RLS_00902835894_1885M1&package=TGZ
 |
 |
|
 |
|