Du hast deinen AdBlocker an?

Es wäre ein Traum, wenn du ihn für t3n.de deaktivierst. Wir zeigen dir gerne, wie das geht. Und natürlich erklären wir dir auch, warum uns das so wichtig ist. Digitales High-five, deine t3n-Redaktion

t3n 9

RESTful API und Plugins im Praxiseinsatz für den Datenexport: Ein Eventkalender mit Ruby on Rails

    RESTful API und Plugins im Praxiseinsatz für den Datenexport: Ein Eventkalender mit Ruby on Rails

Die Website wevent.org basiert auf Ruby on Rails und ist ein Eventkalender, in dem Nutzer Veranstaltungen eintragen, Freunde einladen und sich über Events in der Nähe informieren. Um eine Schnittstelle für externe Anwendungen wie Desktop-Kalender oder Feedreader zu bieten, wurde eine RESTful API realisiert, über die verschiedene Datenformate angefordert werden können. Für denselben Zweck kommen auch zwei Plugins zum Einsatz.

Wer seine Anwendung RESTful entwickelt (siehe auch T3N Nr. 7 und 8) bietet eine uniforme Schnittstelle [1], über die die eigenen Daten (Resourcen) anderen Anwendungen zur Verfügung gestellt werden. Bei einem webbasierten Eventplaner bietet es sich dabei an, dass die Nutzer ihren Veranstaltungskalender auch offline auf dem Desktop nutzen oder sich per RSS über neu eingetragene Events informieren lassen können.

Die Ausgabe der Daten für das Frontend in Form einer HTML-Datei ist oftmals bereits in einer „Action“ implementiert, es muss also lediglich auf das vom Client angeforderte Format reagiert werden. Kalenderapplikationen fragen in der Regel das Standardformat iCal (meine_events.ics) an, für Feedreader wiederum kann eine Repräsentation als RSS oder Atom angeboten werden. Wem das noch nicht reicht, der stellt für weitere Anwendungen, wie zum Beispiel Web Services, auch noch XML, YAML oder JSON zu Verfügung – dank Rails ist das alles mit wenigen Zeilen Code möglich.

respond_to whatever

Mit dem Befehl „respond_to“ lässt sich auf den vom Client gesendeten Accept-Header oder das explizit angeforderte Datenformat reagieren. Erhält Rails beispielsweise eine Anfrage, deren HTTP-Header „Accept: application/xml“ enthält oder mit der auf „http://wevent.org/events.xml“ zugegriffen wird, so rendert die Action „index“ eine Liste aller Events als XML. Folgende Einstellungen sind dafür nötig:

RUBY ON RAILS

class EventsController < ApplicationController
	def index
		@page_title = „Alle Events“
		@events = Event.find(:all)
		respond_to do |format|
			 format.html
			 format.xml   { render_xml_for  @events }
			 format.json  { render_json_for @events }
			 format.yaml { render_yaml_for @events }
			 format.rss    { render_rss_for  @events, :title => @page_title }
			 format.atom { render_atom_for @events, :title => @page_title }
			 format.ics    { render_ical_for @events, :title => @page_title }
		end
	end
end

Listing 1

Innerhalb des respond_to-Blocks werden die möglichen Ausgabeformate aufgelistet – die Reihenfolge spielt dabei keine Rolle, da der Client die Reihenfolge der gewünschten Formate im Accept-Header festlegt oder das Format durch die Dateiendung explizit angegeben wurde.

Bitte beachte unsere Community-Richtlinien

Schreib den ersten Kommentar!

Du musst angemeldet sein, um einen Kommentar schreiben zu können.

Jetzt anmelden

Finde einen Job, den du liebst