terrestris GmbH & Co. KG

GeoServer in action

Vorheriges Thema

3. REST-Schnittstelle

Nächstes Thema

3.2. Katalogeinträge erzeugen

3.1. Katalog auslesen

Wie bereits in der Einführung zu REST aufgeführt, ist eine zentrale Bedingung von REST die Adressierbarkeit, d.h. jede Katalogkonfiguration im GeoServer besitzt eine eindeutige URL. Da sich diese Konfiguration logischerweise je nach Instanz unterscheidet, aber die Voraussetzung für die späteren Manipulations-Operationen notwendig ist, muss es eine Möglichkeit geben, diese Ressourcen abzubilden. Das Auslesen des existierenden Katalogs und der entsprechenden eindeutigen REST URLs ist direkt über den Browser möglich und dabei interaktiv, d.h. navigierbar aufgebaut.

Bemerkung

Wir werden in diesem Workshop die REST-Schnittstelle über das Kommandozeilentool cURL ansprechen. cURL ist ein Programm zur Client-Server Kommunikation und unterstützt neben vielen anderen auch das HTTP Netzwerkprotokoll. Für einfache Debugging-Prozesse zu empfehlen, sind für den produktiven Einsatz der REST-Schnittstelle Clientbibliotheken in den Programmiersprachen Java, Python, PHP und Ruby, die eine direkte Kommunikation aus dem Programmcode heraus erlauben, verfügbar und zu empfehlen.

GeoServer Configuration API

Öffnen Sie ein Browserfenster und geben Sie dort die folgende Adresse ein (Die Ressource benötigt eine Authentifizierung mit einem gültigen GeoServer Nutzer, geben Sie hier admin:geoserver ein):

http://localhost:8082/geoserver/rest

Nach Aufruf der Adresse erscheint im Browser eine einfache Liste, die eine Übersicht der aktuellen GeoServer Configuration API bietet (siehe Abbildung).

../_images/read1.png

Startansicht der GeoServer Configuration API.

Die Listenansicht ist voll navigierbar und eindeutig zuordenbar. Eine Auswahl im Browser (z.B. des Eintrags workspaces) navigiert den Browser zur eindeutigen URL http://localhost:8082/geoserver/rest/workspaces. Der Aufbau der Liste (bei Auswahl eines Arbeitsbereichs) folgt dabei der logischen Struktur des GeoServer-Katalogs:

workspace
  |
  +--datastore
       |
       +--featuretype

GeoServer Configuration API Formate

Die obigen Aktionen im Browser rufen einen Endpunkt standardmäßig im HTML-Format auf. Der GeoServer unterstützt darüberhinaus die Formate JSON (JavaScript Object Notation) und XML (Extensible Markup Language), die insbesondere bei der Manipulation einer Ressource relevant sind. Vergleichen Sie die folgenden Ausgaben im Browser:

http://localhost:8082/geoserver/rest/workspaces
http://localhost:8082/geoserver/rest/workspaces.json
http://localhost:8082/geoserver/rest/workspaces.xml

sowie

http://localhost:8082/geoserver/rest/workspaces/topp/datastores/states_shapefile/featuretypes/states
http://localhost:8082/geoserver/rest/workspaces/topp/datastores/states_shapefile/featuretypes/states.json
http://localhost:8082/geoserver/rest/workspaces/topp/datastores/states_shapefile/featuretypes/states.xml

Die obigen Befehle können ebenfalls direkt über cURL aufgerufen werden. Öffnen Sie hierzu das Terminal (über den Button terminal_icon (LXTerminal) im unteren Systempanel) und fügen Sie dort den folgenden Befehl ein. Der aktuelle Pfad im Terminal ist dabei irrelevant.

curl \
  -v \
  -u admin:geoserver \
  -XGET \
  -H "Accept: text/html" \
  http://localhost:8082/geoserver/rest/workspaces

Der obige Request ist analog zu dem ersten hier aufgeführten Beispiel http://localhost:8082/geoserver/rest/workspaces und wird entsprechend die selbe Antwort im HTML-Format liefern (siehe Output aller vorhandenen Arbeitsbereiche im HTML-Format). Das Format der Response ist jedoch auch über cURL steuerbar. Hierzu muss lediglich der Accept Header des Requests von text/html auf text/json bzw. text/xml gesetzt werden.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
    <title>GeoServer Configuration</title>
    <meta name="ROBOTS" content="NOINDEX, NOFOLLOW"/>
</head>
<body>

Workspaces
<ul>
  <li><a href="http://localhost:8082/geoserver/rest/workspaces/it.geosolutions.html">it.geosolutions</a></li>
  <li><a href="http://localhost:8082/geoserver/rest/workspaces/cite.html">cite</a> [default] </li>
  <li><a href="http://localhost:8082/geoserver/rest/workspaces/tiger.html">tiger</a></li>
  <li><a href="http://localhost:8082/geoserver/rest/workspaces/sde.html">sde</a></li>
  <li><a href="http://localhost:8082/geoserver/rest/workspaces/topp.html">topp</a></li>
  <li><a href="http://localhost:8082/geoserver/rest/workspaces/sf.html">sf</a></li>
  <li><a href="http://localhost:8082/geoserver/rest/workspaces/nurc.html">nurc</a></li>
  <li><a href="http://localhost:8082/geoserver/rest/workspaces/cartaro.html">cartaro</a></li>
</ul>
</body>
</html>

Nachdem wir die grundlegenden Funktionen zum Auslesen der Katalogeinstellungen kennengelernt haben, können Sie mit dem Kapitel Katalogeinträge erzeugen fortfahren.