|
|
The HTTP interfaces described in this section are provided to manage, access, and search for data elements. They are supported through the
ManagerServlet
and
SearchServlet
classes. The Details regarding the each servlet can be found in the subsections below.
This servlet handles and manages data element registry. It takes the following parameters, either from a GET or POST request:
-
the methods included should be either
add
, or
remove
indicating what kind of registry action to perform. The method(s) require a common parameter
object
.
Then, depending on the option selected above, other parameters must
be specified.
-
add
is followed by a set of
keyword=value
. The user will need to obtain a list of the attributes describing a data element. These attributes were derived from the ISO/IEC 11179 standard. It is suggested to build a web tool which provides a html form to submit keywords and their values. Without the keyword and value set, this servlet brings you to the element registry prototype.
-
keyword
is an attribute describing data element.
-
value
is value to keyword given above.
-
remove
is followed by:
-
identifier
identifier of data element.
-
regAuthId
identifier of the registration authority of the data element.
-
version
data element's version.
In response, this servlet dispatches to a jsp page,
elementRegistryResult.jsp
that displays the registry status.
Examples:
http://metadata.jpl.nasa.gov/ElementManager?
object=urn:corba:eda:JPL.EDM.MetadataRegistry&
add=&
name=test_name&
regAuthId=MDR&
regAuthName=Metadata+Registry&
definition=definiton
http://metadata.jpl.nasa.gov/ElementManager?
object=urn:corba:eda:JPL.EDM.MetadataRegistry&
remove=&
identifier=1&
regAuthId=&
version=6
This servlet handles data element search. It takes the following parameters, either from a GET or POST request:
-
search methods which should be either
browse
,
textSearch
,
keywordSearch
,
query
, or
xmlQuery
indicating what kind of search to perform. All these methods require a common parameter
object
.
Then, depending on the option selected above, other parameters must be specified.
-
browse
: no parameter is further needed.
-
textSearch
is followed by:
-
textString
is a string of characters.
-
keywordSearch
is followed by a set of
keyword=value
. The user will need to obtain a list of the attributes describing a data element. These attributes were derived from the ISO/IEC 11179 standard.
-
keyword
is an attribute describing data element.
-
value
is value to keyword given above.
-
query
is followed by:
-
kwdString
is a string of characters.
-
xmlQuery
is followed by:
-
kwdString
is a string of characters.
In response, this servlet dispatches to a jsp page,
elementSearchResult.jsp
that displays the html result from the search except for method
xmlQuery
that displays the result in profile xml structure.
In addition, a parameter
returnType
, may be attached to specify the display format of the result. The output formats include
text
,
html
(default), or
xml
.
Examples:
http://metadata.jpl.nasa.gov/ElementSearch?
browse&
object=urn:corba:eda:JPL.EDM.MetadataRegistry
http://metadata.jpl.nasa.gov/ElementSearch?
textSearch&
object=urn:corba:eda:JPL.EDM.MetadataRegistry&
textString=Title
http://metadata.jpl.nasa.gov/ElementSearch?
object=urn:corba:eda:JPL.EDM.MetadataRegistry&
keywordSearch&
Name=Title
http://metadata.jpl.nasa.gov/ElementSearch?
object=urn:corba:eda:JPL.EDM.MetadataRegistry&
query&
kwdString=Name=Title
http://metadata.jpl.nasa.gov/ElementSearch?
object=urn:corba:eda:JPL.EDM.MetadataRegistry&
xmlQuery&
kwdString=Name=Title
|