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.
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
- 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 (CDS).
This library is free: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License.