[MOBY-guts] biomoby commit
Mark Wilkinson
mwilkinson at pub.open-bio.org
Tue Dec 2 00:57:15 UTC 2003
mwilkinson
Mon Dec 1 19:57:15 EST 2003
Update of /home/repository/moby/moby-live/Perl/MOBY
In directory pub.open-bio.org:/tmp/cvs-serv21719/MOBY
Modified Files:
Central.html Central.pm
Log Message:
I just remembered that Martin objected to me calling the non-MOBY services 'soap' services, so I now call them 'wsdl' services. Also fixed some more documentation errors, and fixed an error in the test suite.
moby-live/Perl/MOBY Central.html,1.10,1.11 Central.pm,1.114,1.115
===================================================================
RCS file: /home/repository/moby/moby-live/Perl/MOBY/Central.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- /home/repository/moby/moby-live/Perl/MOBY/Central.html 2003/12/02 00:23:23 1.10
+++ /home/repository/moby/moby-live/Perl/MOBY/Central.html 2003/12/02 00:57:15 1.11
@@ -27,7 +27,6 @@
<li><a href="#deregisterservicetype">deregisterServiceType</a></li>
<li><a href="#registernamespace">registerNamespace</a></li>
<li><a href="#deregisternamespace">deregisterNamespace</a></li>
- <li><a href="#retrieverelationshiptypes">retrieveRelationshipTypes</a></li>
<li><a href="#registerservice">registerService</a></li>
<li><a href="#registerservicewsdl">registerServiceWSDL</a></li>
<li><a href="#deregisterservice">deregisterService</a></li>
@@ -301,24 +300,6 @@
<p>...Registration Object...</p>
<p>
</p>
-<h2><a name="retrieverelationshiptypes">retrieveRelationshipTypes</a></h2>
-<ul>
-<li><strong>used to remove a Namespace from the controlled vocabulary</strong><br />
-</li>
-<li><strong>will fail if that namespace is being used by any services</strong><br />
-</li>
-<li><strong>you will recieve an email for confirmation of the deregistration</strong><br />
-</li>
-</ul>
-<p>Input XML :</p>
-<pre>
- <deregisterNamespace>
- <namespaceType>MyNamespace</namespaceType>
- </deregisterNamespace></pre>
-<p>Ouptut XML :</p>
-<p>...Registration Object...</p>
-<p>
-</p>
<h2><a name="registerservice">registerService</a></h2>
<ul>
<li><strong><a name="item_all_elements_are_required">all elements are required</a></strong><br />
===================================================================
RCS file: /home/repository/moby/moby-live/Perl/MOBY/Central.pm,v
retrieving revision 1.114
retrieving revision 1.115
diff -u -r1.114 -r1.115
--- /home/repository/moby/moby-live/Perl/MOBY/Central.pm 2003/12/02 00:23:23 1.114
+++ /home/repository/moby/moby-live/Perl/MOBY/Central.pm 2003/12/02 00:57:15 1.115
@@ -812,43 +812,16 @@
}
-
-=head2 retrieveRelationshipTypes
-
-=over 3
-
-=item * used to remove a Namespace from the controlled vocabulary
-
-=item * will fail if that namespace is being used by any services
-
-=item * you will recieve an email for confirmation of the deregistration
-
-=back
-
-
-Input XML :
-
- <deregisterNamespace>
- <namespaceType>MyNamespace</namespaceType>
- </deregisterNamespace>
-
-Ouptut XML :
-
-...Registration Object...
-
-
=head2 registerService
=over 3
=item * all elements are required
-=item * a service must have at least one Input OR Output Object Class.
+=item * a service must have at least one Input OR Output Object Class. Either Input or Output may be blank to represent "PUT" or "GET" services respectively
=item * the contactEmail address must be valid, as it is used to authorize deregistrations and changes to the service you registered.
-=item * the Object Classes, Namespaces, and Service Types must all exist for the registration to be successful, so make sure you register these first, or ensure that they already exist in their respective ontologies.
-
=item * the "authoritativeService" tag is used to indicate whether or not the registered service is "authoritative" for that transformation. i.e. if anyone else were to perform the same transformation they would have to have obtained the information to do so from you. This is similar to, but not necessarily identical to, mirroring someone elses data, since the data in question may not exist prior to service invocation.
=item * only Input Secondary articles are defined during registration; Output Secondary objects are entirely optional and may or may not be interpreted Client-side using their articleName tags.
@@ -859,7 +832,17 @@
=item * moby - for services that use the MOBY SOAP messaging format and object structure (i.e. the objects used in service transaction inherit from the root 'Object' Class in the MOBY Class ontology).
-=item * soap - for other SOAP services that do not use the MOBY messaging format. The other elements in the registration should be interpreted as follows:
+=over 2
+
+=item * authURI - a URI representing your organization (e.g. yourdomain.com); no http-prefix, and no trailing path information is allowed.
+
+=item * serviceName - an arbitrary, but unique, name for your service within your authURI namespace
+
+=item * URL - the URL to a SOAP CGI server that can invoke a method as described by your serviceName
+
+=back
+
+=item * wsdl - for other SOAP services that do not use the MOBY messaging format. The other elements in the registration should be interpreted as follows:
=over 2
@@ -869,17 +852,19 @@
=item * URL - the URL from which a WSDL document describing your service can be retrieved by an HTTP GET call.
-=item * Comments about Input and Output:
+=back
+
+=item * Comments about Input and Output for MOBY and non-MOBY services
=over 2
=item * in "moby" services, the input and output messaging structure is defined by the BioMOBY API, and the services use data Objects that are defined in the Class ontology as inheriting from the root "Object" Class.
-=item * For "soap" services, there is additional flexibility:
+=item * For "wsdl" services, there is additional flexibility:
=over 2
-=item * Similar to a "moby" service, your "soap" service must consume/produce named data types. These are represented as LSID's
+=item * Similar to a "moby" service, your "wsdl" service must consume/produce named data types. These are represented as LSID's
=item * YOU DO NOT NEED TO REGISTER THESE DATA TYPES in MOBY Central; it is up to you what your LSID's represent, and MOBY Central WILL NOT try to resolve them!
@@ -905,7 +890,6 @@
=back
-=back
Input XML :
@@ -1063,10 +1047,14 @@
$error .="missing Category \n" unless defined $Category;
return &_error("malformed payload $error\n\n","") if ($error);
- return &_error("Category may take the (case sensitive) values 'moby', 'cgi', 'soap'\n","") unless (($Category eq "est") || ($Category eq "cgi") || ($Category eq "moby"));
+ return &_error("Category may take the (case sensitive) values 'moby', 'cgi', 'soap'\n","") unless (
+ ($Category eq "wsdl")
+# || ($Category eq "cgi")
+ || ($Category eq "moby")
+ );
$debug && &_LOG("Entering switch with $Category method\n");
- return &_error("Service categories other than 'moby' and 'soap' are not yet implemented","") unless ($Category eq "moby" || $Category eq "soap");
+ return &_error("Service categories other than 'moby' and 'wsdl' are not yet implemented","") unless ($Category eq "moby" || $Category eq "wsdl");
my @IN = @{$INPUTS};
my @OUT = @{$OUTPUTS};
my @SECS = @{$SECONDARY};
More information about the MOBY-guts
mailing list