#KVB Rad Live
Dieser Service liest den aktuellen Standort der von den Kölner Verkehrsbetrieben betriebenen Fahrräder unter Aktuelle Standorte Fahrraeder KVB-Rad aus und deserialisisert sie in Java-Objekte. Hierfür wird die Bibliothek FasterXML/jackson-dataformat-xml verwendet.
Zum Betrieb ist eine Postgres + Postgis notwendig. Wenn sich die Position eines Rades gegenüber dem letzten Aufruf geändert hat, wird das Ergebnis in die Datenbank geschrieben.
git clone https://github.com/codeforcologne/kvbradlive.git
cd kvbradlive
mvn clean install
Für die Entwicklung in eclipse wird das Projekt über 'Import/Check out Maven Project from SCM' in eclipse importiert. Danach kann mit 'mvn clean install' alle Abhängigkeiten aufgelöst werden.
Mit 'mvn clean install' werden bereits die Konfigurationsdateien 'config.properties' und 'jndi.properties' mit default-Parametern angelegt. Ggf. müssen hier noch Einträge geändert werden. Nach der Änderung ist ein erneutes Bauen der Anwendung notwendig.
Dieser Service unterstellt, dass die Datenbankverbindung per JNDI gesetzt ist. Für den Server bedeutet dies, dass der Container für die Definition der DB-Verbindung zurständig ist. Dafür muss z.B. im Tomcat die Datei context.xml angepasst werden. Folgende Einstellungen müssen eingetragen werden.
Für die Erreichbarkeit der Datenbank werden zwei Bibliotheken benötigt:
Für die Übersetzung der Anwendung werden beide jar-Files mit scope 'provided' eingebunden. Für den Betrieb eines Servers z.B. innerhalb einer Entwicklungsumgebung bedeutet das, dass der entsprechende Server die Bibliotheken kennen muss. Hierfür müssen diese heruntergeladen und im tomcat/lib Verzeichnis abgelegt werden. Dann müssen diese unter 'launch configuration/ Classpath' dem Server bekannt gemacht werden.
Folgende Parameter müssen im Server gesetzt sein, damit die Services die Datenbank erkennen können:
context.xml
<Context>
<ResourceLink
name="jdbc/kvbrad"
global="jdbc/kvbrad"
type="javax.sql.DataSource" />
</Context>
server.xml
<GlobalNamingResources>
<Resource
name="jdbc/kvbrad"
auth="Container"
driverClassName="org.postgresql.Driver"
maxTotal="25"
maxIdle="10"
username="username"
password="password"
type="javax.sql.DataSource"
url="jdbc:postgresql://localhost:5432/kvbrad"
validationQuery="select 1"/>
Zur Zeit wird nur eine Tabelle verwendet; DDL:
CREATE TABLE bike (
uid integer,
name varchar(256),
bike integer DEFAULT 0,
number integer NOT NULL,
modtime timestamp DEFAULT current_timestamp
);
SELECT AddGeometryColumn ('public','bike','geom',4326,'POINT',2);
Für das Logging der Abfragen wird folgende Tabelle benötigt:
CREATE TABLE kvbradlive (
numberofinsert integer,
modtime timestamp DEFAULT current_timestamp
);
Folgende REST Endpoints stehen zur Verfügung
Mit diesem REST-Endpoint wird das Auslesen der Schnittstelle ausgelöst und ggf. die Werte in die Datenbank eingefügt. Vorgehen:
- AskForNextBikeLife
- Get the Bikes
- Insert Bikes to DB; check for existing bike before inserting
Mit diesem REST-Endpoint werden die Einträge der letzten 30 Tage gelöscht.
Da zur Zeit keine Integration Test Stage zur Verfügung steht, sind alle Tests, die eine Datenbank voraussetzt als main codiert. Um eine Datenbankverbindung hierfür zur Verfügung stellen zu können, muss die Datei src/test/resources/jndi.properties.template in src/test/resources/jndi.properties kopiert und die entsprechenden Parameter zur Datenbank gesetzt werden.
Beim ersten auschecken und mit Aufruf von 'mvn clean install' wird die Datei jndi.properties.template in jndi.properties umgesetzt. Vorausgesetzt die Datenbank ist über localhost erreichbar und kennt das Schema 'kvbrad' bzw. den User 'kvbrad/kvbrad' kann direkt mit der Datenbank verbunden werden.
Dieses Werk ist lizenziert unter einer Creative Commons Namensnennung - Weitergabe unter gleichen Bedingungen 4.0 International Lizenz.