UWS Library v4.4

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.

• 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 ?

• Documentation: to have more details about all provided functionnalities.

  Since version 4.0 of the library, the former documentation (for v3.0) is no longer valid. Thus, no documentation is yet available.

  This documentation will come little by little. While waiting, you can use the provided example, the Javadoc or directly send me your questions.

• Javadoc: Java documentation of all available classes.
• What's new?: Last modifications of the library.

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

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