Provide database series data via 52n Series REST API.

This module is an SPI implementation of the 52°North Series REST API. It provides data access objects which access series data from relational databases. Using Hibernate the data model is not fixed to one specific.

The DAO module implements the Series API's Service Provider Interface (SPI). It serves as backend access layer to retrieve data from a relational database and to provide it via a well defined RESTful interface. Lightweight clients can then query and work with that series data easily in a common way (other data access mechanisms are available as well). Besides pure data access, the data can be preprocessed with common IO functionalities e.g.

• prerendering of series data,
• generalization,
• overlaying of data from multiple series
• conversion of raw data to other formats like pdf and png

Using Hibernate makes it flexible to use almost arbitrary data models, i.e. there is no need to have convert your data intot a specific data model. The combination of making adjustments to hbm.xml mapping files and database views (not always needed) make it possible to match existing databases quite well. The series data model of the 52°North SOS is used by default and can be used right out-of-the-box.

The following main frameworks are used to provide this API:

• Spring
• Hibernate
• 52°North Series API

tbd

The module is published under the GNU General Public License v2 (GPLv2).

• https://github.com/52North/dao-series-api/blob/develop/CHANGELOG.md
• for detailed infos check https://github.com/52North/dao-series-api/pulls?q=is%3Apr+is%3Aclosed

We try to follow the GitFlow model, although we do not see it that strict.

However, make sure to do pull requests for features, hotfixes, etc. by making use of GitFlow. Altlassian provides [a good overview] (https://www.atlassian.com/de/git/workflows#!workflow-gitflow). of the most common workflows.

Henning Bredel ([email protected])

• tbd: deployment configuration
• tbd: build from source
• tbd: externalize config before build

• general config options
  • Generalizer
  • Prerendering
  • Date formatting
  • Rendering Hints
  • Status Intervals
  • Metadata from a Database

Depending on which build environment you've chosen open one the WEB-INF/classes/logback-{dev,ci,prod}.xml. Here you can edit log levels and log outputs.

Refer to the official Series REST API documentation to get a detailed overview on how to access the data provided by the API.

The development of the 52°North REST-API DAO implementation was supported by several organizations and projects. Among other we would like to thank the following organisations and project

Project/Logo	Description
	The development of this version of the 52°North SOS was supported by the German Federal Ministry of Education and Research research project COLABIS (co-funded by the German Federal Ministry of Education and Research, programme Geotechnologien, under grant agreement no. 03G0852A)
	The development of this version of the 52°North REST-API DAO was supported by the European FP7 research project NeXOS (co-funded by the European Commission under the grant agreement n°614102)
	The development of this version of the 52°North REST-API DAO was supported by the European FP7 research project FixO3 (co-funded by the European Commission under the grant agreement n°312463)
	The development of this version of the 52°North REST-API DAO was supported by the Horizon 2020 research project ODIP II (co-funded by the European Commission under the grant agreement n°654310)
	The development of this version of the 52°North REST-API DAO was supported by the Horizon 2020 research project SeaDataCloud (co-funded by the European Commission under the grant agreement n°730960)
	The Wupperverband for water, humans and the environment (Germany)
	The Belgian Interregional Environment Agency (IRCEL - CELINE) is active in the domain of air quality (modelling, forecasts, informing the public on the state of their air quality, e-reporting to the EU under the air quality directives, participating in scientific research on air quality, etc.). IRCEL — CELINE is a permanent cooperation between three regional environment agencies: Agence wallonne de l'Air et du Climat (AWAC), Bruxelles Environnement - Leefmilieu Brussel and Vlaamse Milieumaatschappij (VMM).
	The development of this version of the 52°North SOS was supported by the European FP7 research project GEOWOW (co-funded by the European Commission under the grant agreement n°282915)