PDFlib Tutorial 9.0.1

2.13 Ruby-Sprachbindung
Installation der Ruby-Edition von PDFlib. Der Erweiterungsmechanismus von Ruby 1
lädt eine dynamische Bibliothek zur Laufzeit. Damit die PDFlib-Sprachbindung funktioniert,
benötigt der Ruby-Interpreter Zugriff auf die PDFlib-Erweiterungsbibliothek für
Ruby. Diese Bibliothek (unter Windows und Unix: PDFlib.so; unter OS X: PDFlib.bundle)
wird normalerweise im Unterverzeichnis site_ruby des lokalen Ruby-Installationsverzeichnisses
installiert, das heißt in einem Verzeichnis mit etwa folgendem Namen:
/usr/local/lib/ruby/site_ruby//
Ruby durchsucht aber auch andere Verzeichnisse nach Erweiterungen. Mit folgendem
Ruby-Aufruf erhalten Sie eine Liste dieser Verzeichnisse:
ruby -e "puts $:"
Diese Liste enthält in der Regel auch das aktuelle Verzeichnis, so dass Sie die PDFlib-
Erweiterungsbibliothek und die Skripten zum Testen einfach ins gleiche Verzeichnis
stellen können.
Datentypen. Parameter müssen der PDFlib-Programmschnittstelle (API) gemäß der in
Tabelle 2.12 aufgeführten Datentypen übergeben werden.
Tabelle 2.12 Datentypen der Ruby-Sprachbindung
API-Datentyp
Strings
Binärdaten
Datentypen der Ruby-Sprachbindung
string
string
Fehlerbehandlung in Ruby. Die Ruby-Sprachbindung installiert einen Error-Handler,
der PDFlib-Exceptions in native Ruby-Exceptions übersetzt. Die Ruby-Exceptions können
mit der üblichen rescue-Technik behandelt werden:
begin
...PDFlib-Anweisungen...
rescue PDFlibException => pe
print "PDFlib-Exception im Beispiel Hello:\n"
print "[" + pe.get_errnum.to_s + "] " + pe.get_apiname + ": " + pe.get_errmsg + "\n"
end
Ruby on Rails. Ruby on Rails 2 ist ein Open-Source-Framework, das die Webentwicklung
mit Ruby erleichtert. Die PDFlib-Erweiterung für Ruby ist auch mit Ruby on Rails
einsetzbar; entsprechende Beispiele sind im Paket enthalten. Um die PDFlib-Beispiele
für Ruby on Rails auszuführen, gehen Sie wie folgt vor:
> Installieren Sie Ruby und Ruby on Rails.
> Richten Sie einen neuen Controller von der Kommandozeile aus ein:
$ rails new pdflibdemo
1. Siehe www.ruby-lang.org/en
2. Siehe www.rubyonrails.org
58 Kapitel 2: Sprachbindungen von PDFlib