International Virtual Observatory Alliance

Difference: VOSpace10schema (2 vs. 3)

Revision 32006-06-13 - PaulHarrison

META TOPICPARENT	name="IvoaGridAndWebServices"

VOSpace-1.0 WSDL and schema

This is a discussion page for the WSDL and schema for the VOSpace-1.0 service.

This is somewhere where we can post proposals for schema and WSDL to enable interested parties to discuss the different versions.

Once we have finalised the WSDL and schema, the final versions will be posted on the main Grid & Web Services page.

News

Mailing list for discussions of VOStore and associated protocols: vospace@ivoa.net
Messages archive: http://ivoa.net/forum/vospace/

Schema discussion page created.

Core schema

This is the main section for schema and WSDL files.

Changed:

<
< When posting a new version, please tweak the filename and namespace version number to make it distinct from previous versions.

>
> The files for the 1.0 VOSpace release are

Changed:

<
< Once we have finalised the schema, we can change the filename and namespace version number to 01.00 when we publish it on the main Grid & Web Services page.

>
>

VOSpace-v1.0.wsdl the main WSDL file.

Added:

>
>

VOSpaceBase-v1.0.xsd a subsidiary schema file that contains core types that might be useful in implementing a VOSpace server cf. the WSDL which contains types that are used only in the web service interface.

Changed:

<
< Note - If you upload schema as attachments to this page, can you set the schemaLocation and import URLs to point to the files on this wiki. This just makes it easier to run code generators on the examples without having to modify the location URLs.

>
> These file are packaged in a zip file which is named with the release candidate number for each sucessive release candidate. The exact release candidate number is also reflected in the files in

Added:

>
>

the version attribute of the top level xsd:schema element in the schema file
the name attribute of the top level wsdl:definitions element in the WSDL file

Changed:

<
<

version-00.04

>
>

Version 1.0rc1

Deleted:

<
< Paul, can you post latest version here.

Added:

>
>

This is the first 'official' release candidate of the VOSpace interface definition, and is based on version 0.21 of the specification document, though is known not to follow this document exactly.

I stilll find the data transfer operations confusing- I think that the basic problem is that the push and pull verbs are opposite in meaning and viewed from opposite perspectives. I have a new set of proposals

old name	new name"
pushDataToVoSpace	importDataClientPush
pullDataToVoSpace	importDataServerPull
pushDataFromVoSpace	exportDataServerPush
pullDataFromVoSpace	exportDataClientPull

which I think are better because

the overall objective of the operation is the first verb
the active party in the transfer is identified
the direction of the transfer is then related to the active party.

-- PaulHarrison - 13 Jun 2006

Experiments

This section is for experiments and examples. Schema posted here are examples of techniques and styles that may me useful in the main schema.

version-mg.01

An experimental schema, looking at how SOAP overriding works, and if it would be useful for adding VOSpace-2.0 functionality to a VOSpace-1.0 service.

[link]

version-dm.01

An experimental schema, splitting things up into small schema files.

Using separate namespaces for each schema file maps well to Java packages. Using separate schema files for the base node type and derived types makes it much easier to add new extension types later.

Astrogrid.VoSpace20060602

-- DaveMorris - 12 Jun 2006

version-dm.02

An experimental schema, using compleType for all of the elements, and moving as much as possible out of the main WSDL file.

Defining everything as complexType maps well to Java classes - it forces code generators to create full Java classes for all of the elements.
Defining the messages types outside the main WSDL file may make it easier to to create JUnit tests, and possibly experiment with different transport mechnisms.

Astrogrid.VoSpace20060605

-- DaveMorris - 12 Jun 2006

<-- 
 
 
 Set ALLOWTOPICRENAME = TWikiAdminGroup
 
 
-->

View topic | History: r25 < r24 < r23 < r22 | More topic actions...