Version 4.3 of the UWS library released since the 2nd of March 2018. This version is now implementing the UWS 1.1 protocol.
See the modifications for more details
See UWS-1.1 introduction to see how to use the new features
Version 4.2 of the UWS library released since the 26th of February 2018. This is the last version implementing the UWS 1.0 protocol.
See the modifications for more details

UWS Library v4.3

This CDS/ARI library is a framework to create easily a UWS service.

Download

What is UWS ?

UWS is an IVOA protocol aiming to create to start and to manage work(s)/job(s). It is especialy used in TAP services to execute asynchronously ADQL queries. This library implements the protocol as defined by the IVOA in the Recommendation 24 October 2016 (version 1.1) and is included in the TAP Library.

Remind me!

Why this library ?

In order to help Java developpers to create a UWS service as quickly and easily as possible while respecting the IVOA standard.

Functionalities:
  • Custom jobs: the library lets the service administrator to define one or several processing he wants to allow in the service.
  • 1 job execution = 1 Thread: each time a user asks the execution of one job, a new thread is created on the server.
  • Backup: this library manages all jobs in memory in order to be as fast as possible. It is however possible (and recommended) to configure the library so that saving all jobs in a file, database or other.
  • Upload: since version 4.1, the library is properly configured in order to deal with HTTP Multipart requests. Thus, files may now be uploaded as input parameter for a job.
  • Authentication: thanks to a simple Java interface, the library lets developers to specify a way to identify a user. No default authentication method is provided but the implementation is really easy to perform.
  • Log: all infos, warnings and errors are reported in a log. Log format is let free to the library users: it can be a file (free format), a database, a set of files, ...

How to use it ?

If you have any question about the UWS library, you can send it to Grégory Mantelet (ARI/ZAH).

This library is free: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License.