Series REST API DAO - DAO

REST SPI Implementation for SOS Series Database.

License

License

GroupId

GroupId

org.n52.series-api.db
ArtifactId

ArtifactId

dao
Last Version

Last Version

3.0.0-alpha.8
Release Date

Release Date

Type

Type

jar
Description

Description

Series REST API DAO - DAO
REST SPI Implementation for SOS Series Database.
Project URL

Project URL

http://52north.org/communities/sensorweb/
Project Organization

Project Organization

52North Initiative for Geospatial Open Source Software GmbH

Download dao

How to add to project

<!-- https://jarcasting.com/artifacts/org.n52.series-api.db/dao/ -->
<dependency>
    <groupId>org.n52.series-api.db</groupId>
    <artifactId>dao</artifactId>
    <version>3.0.0-alpha.8</version>
</dependency>
// https://jarcasting.com/artifacts/org.n52.series-api.db/dao/
implementation 'org.n52.series-api.db:dao:3.0.0-alpha.8'
// https://jarcasting.com/artifacts/org.n52.series-api.db/dao/
implementation ("org.n52.series-api.db:dao:3.0.0-alpha.8")
'org.n52.series-api.db:dao:jar:3.0.0-alpha.8'
<dependency org="org.n52.series-api.db" name="dao" rev="3.0.0-alpha.8">
  <artifact name="dao" type="jar" />
</dependency>
@Grapes(
@Grab(group='org.n52.series-api.db', module='dao', version='3.0.0-alpha.8')
)
libraryDependencies += "org.n52.series-api.db" % "dao" % "3.0.0-alpha.8"
[org.n52.series-api.db/dao "3.0.0-alpha.8"]

Dependencies

compile (22)

Group / Artifact Type Version
org.n52.series-api : io jar 2.0.1-alpha.7
org.n52.series-api : spi jar 2.0.1-alpha.7
org.n52.arctic-sea : janmayen jar 7.2.0
org.n52.series-api : rest jar 2.0.1-alpha.7
org.n52.series.db : entities jar 1.0.0-alpha.7
org.geolatte : geolatte-geom jar 1.4.0
org.springframework : spring-beans jar
org.springframework : spring-context jar
org.springframework : spring-orm jar
org.springframework : spring-tx jar
com.fasterxml.jackson.core : jackson-core jar
com.fasterxml.jackson.core : jackson-databind jar
com.fasterxml.jackson.core : jackson-annotations jar
org.apache.commons : commons-lang3 jar
org.hibernate : hibernate-core jar 5.4.4.Final
org.hibernate : hibernate-spatial jar 5.4.4.Final
javax.persistence : javax.persistence-api jar 2.2
joda-time : joda-time jar
org.n52.arctic-sea : shetland jar 7.2.0
com.google.guava : guava jar 28.0-jre
org.locationtech.jts : jts-core jar 1.16.1
org.slf4j : slf4j-api jar

provided (1)

Group / Artifact Type Version
org.geotools » gt-opengis jar 21.2

runtime (3)

Group / Artifact Type Version
org.apache.xmlbeans : xmlbeans jar 3.1.0
org.n52.arctic-sea : svalbard jar 7.2.0
org.n52.arctic-sea : svalbard-odata jar 7.2.0

test (6)

Group / Artifact Type Version
org.geotools » gt-metadata jar 21.2
org.geotools » gt-referencing jar 21.2
ch.qos.logback : logback-classic jar
junit : junit jar
org.hamcrest : hamcrest-core jar
org.hamcrest : hamcrest-library jar

Project Modules

There are no modules declared in this project.

DAO Implementation of 52n Sensor Web Server Helgoland Build Status Maven Central Total alerts Language grade: JavaScript Language grade: Java

Sensor Web Server Helgoland architecture overview

Description

Provide database data via 52n Sensor Web Server Helgoland.

This module is an SPI implementation of the 52°North Sensor Web Server Helgoland. 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:

References

tbd

License

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

Changelog

Contributing

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.

Contact

Henning Bredel ([email protected])

Quick Start

Webapp Installation

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

Configuration

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

Logging

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.

Client development

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

Credits

The development of the 52°North Sensor Web Server Helgoland DAO implementation was supported by several organizations and projects. Among other we would like to thank the following organisations and project

Project/Logo Description
Cos4Cloud - Co-designed citizen observatories for the EOS-Cloud The development of this version of the 52°North Sensor Web Server DAO was supported by the European Union’s Horizon 2020 research project Cos4Cloud (co-funded by the European Commission under the grant agreement n°863463)
BMBFTaMIS - Das Talsperren-Mess-Informations-System The development of this version of the 52°North Sensor Web Server DAO was supported by the German Federal Ministry of Education and Research research project TaMIS (co-funded by the German Federal Ministry of Education and Research, programme Geotechnologien, under grant agreement no. 03G0854[A-D])
JERICO-S3 - Science - Services- Sustainability The development of this version of the 52°North Sensor Web Server DAO was supported by the European Union’s Horizon 2020 research project JERICO-S3 (co-funded by the European Commission under the grant agreement n°871153)
BMBFCOLABIS - Collaborative Early Warning Information Systems for Urban Infrastructures The development of this version of the 52°North Sensor Web Server DAO 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)
NeXOS - Next generation, Cost-effective, Compact, Multifunctional Web Enabled Ocean Sensor Systems Empowering Marine, Maritime and Fisheries Management The development of this version of the 52°North Sensor Web Server DAO was supported by the European FP7 research project NeXOS (co-funded by the European Commission under the grant agreement n°614102)
FixO3 - Fixed-Point Open Ocean Observatories The development of this version of the 52°North Sensor Web Server DAO was supported by the European FP7 research project FixO3 (co-funded by the European Commission under the grant agreement n°312463)
ODIP II - Ocean Data Interoperability Platform The development of this version of the 52°North Sensor Web Server DAO was supported by the Horizon 2020 research project ODIP II (co-funded by the European Commission under the grant agreement n°654310)
SeaDataCloud The development of this version of the 52°North Sensor Web Server DAO was supported by the Horizon 2020 research project SeaDataCloud (co-funded by the European Commission under the grant agreement n°730960)
Wupperverband The Wupperverband for water, humans and the environment (Germany)
Belgian Interregional Environment Agency (IRCEL - CELINE) 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).
GEOWOW - GEOSS interoperability for Weather, Ocean and Water The development of this version of the 52°North Sensor Web Server DAO was supported by the European FP7 research project GEOWOW (co-funded by the European Commission under the grant agreement n°282915)
org.n52.series-api.db

52°North Initiative for Geospatial Open Source Software GmbH

Versions

Version
3.0.0-alpha.8
3.0.0-alpha.7
3.0.0-alpha.6
3.0.0-alpha.5
3.0.0-alpha.4
3.0.0-alpha.3
3.0.0-alpha.2
3.0.0-alpha.1
2.0.0-alpha.11
2.0.0-alpha.10
2.0.0-alpha.9
2.0.0-alpha.8
2.0.0-alpha.7
2.0.0-alpha.6
2.0.0-alpha.5
2.0.0-alpha.4
2.0.0-alpha.3-1
2.0.0-alpha.3
2.0.0-alpha.2
2.0.0-alpha.1