Einführung in den Service Graphics Conversion

Dieses Dokument ist der Ausgangspunkt für das Erlernen des Umgangs mit dem Service Graphics Conversion. Die Einführung ist in folgende Abschnitte untergliedert:

Übersicht

Der Service Graphics Conversion stellt eine serverseitige JAX-RS-Ressource bereit, die Skalierung und Konvertierungen in und aus vielen Grafikformaten unterstützt. Weitere Einzelheiten finden Sie in der Konvertierungstabelle.

Aus/In GIF JPEG PDF PNG TIFF GFX
GIF Ja Ja[1] Nein Ja[1] Nein Nein
JPEG Ja[1] Ja Nein Ja Nein Nein
PDF --- --- --- --- --- ---
PNG Ja[1] Ja Nein Ja Nein Nein
SVG Nein Ja Ja Ja Ja Ja[2]
TIFF --- --- --- --- --- ---

[1] Wird nur mit Java SDK Version 6.0 oder höher unterstützt.

[2] Es existieren momentan Einschränkungen im Bereich der Funktion für die SVG-GFX-Konvertierung. Weitere Informationen finden Sie im Abschnitt Einschränkungen.

Eine Beispielclientanwendung, die über das Beispiel Mobile Showcase in WebSphere Application Server bereitgestellt wird, veranschaulicht einen einfachen Ajax-Aufruf des Service Graphics Conversion. Der Client ermöglicht Benutzern, einen URL für die zu konvertierende Grafikdatei, das Bildformat, in das das vorhandene Bild konvertiert werden soll, und eine optionale maximale Breite und Höhe für das generierte Bild (falls Skalierung angefordert wird) anzugeben. Der Service gibt einen URL zur konvertierten Datei oder das binäre Bild in dem Format zurück, das für die Client am besten geeignet ist. Da die Optionen URL-Abfrageparameter sind, können Benutzer den URL auch mit den erforderlichen Parametern erstellen, und der Browser zeigt dann das konvertierte Bild an.

Anmerkung:
  • Die Beispielanwendung Graphics Conversion ist nur zur Veranschaulichung einer der möglichen Verwendungen des Service Graphics Conversion und soll demonstrieren, wie AJAX-Aufrufe für die REST-Anforderung verwendet werden.
  • Aufgrund der Einschränkungen in bestimmten Browsern in Bezug auf die Wiedergabe von SVG-Inhalten in den HTML-Tags "img" und "iframe" werden manchmal Ausweichlösungen verwendet, die die Wiedergabe eines Nicht-SVG-Bilds beinhalten, wenn ein SVG-Bild ausgewählt wird. Diese Ausweichlösungen sind jedoch nur für Anzeigezwecke bestimmt und im HTML-Dokument entsprechend gekennzeichnet. Wenn jedoch die eigentliche AJAX-Anforderung an den Service gesendet wird, wird immer das richtige SVG-Bild zur Konvertierung gesendet. In der Ergebnisansicht sehen Sie immer das konvertierte Bild, das bei Bedarf gespeichert werden kann.

Voraussetzungen:

Vorausgesetztes Produkt Version
Java Technology Edition 5.0 und höher
Java Platform, Enterprise Edition 5
Anwendungsserver (und höher)

WebSphere Application Server Version 6.1.0.x und höher

WebSphere Application Server Community Edition Version 2.X.

Web-Browser Jeder moderne Web-Browser wie Internet Explorer 7 und höher, Mozilla Firefox 3.x und höher, Google Chrome, Safari, Opera

Einschränkungen

Sicherheitsaspekte

Service Graphics Conversion verwenden

  1. Zur Verwendung des Service Graphics Conversion implementieren Sie die EAR-Datei des Service in einem Anwendungsserver. Weitere Informationen finden Sie unter Service Graphics Conversion installieren.

  2. Nach der Implementierung des Service können Sie die bereitgestellte Clientdemo verwenden. Die Demo wird unter dem folgenden URL bereitgestellt>

    http://<Server>:<Port>/appsvcs-graphics/
    
  3. Probieren Sie in den verschiedenen Eingabefeldern verschiedene Werte aus, um die konvertierten Bilder zu prüfen.

  4. Wenn die dynamischen Bildkonvertierungen direkt im Browser generiert werden sollen, können Sie auch einen URL mit den Parametern eingeben, z. B.:

    http://<Server>:<Port>/appsvcs-graphics/rest/graphics/convert/binaryResponse?sourceUrl=<URL_der_Grafikdatei>&desiredFormat=<neues_Format>&maxWidth=<optionale_Breite>&maxHeight=<optionale_Höhe>
    

Service Graphics Conversion installieren

Lesen Sie die folgenden versionsspezifischen Installationsanweisungen:

Anweisungen für die Installation in WebSphere Application Server

In diesem Abschnitt wird die Prozedur für das Installieren des Service Graphics Conversion in Version 6.1.0.X und höher von IBM WebSphere Application Server beschrieben. Es wird vorausgesetzt, dass Sie sich mit der Installation und Verwaltung von Anwendungen im Anwendungsserver auskennen.

Vorbereitungen

Suchen Sie die EAR-Datei des Service Graphics Conversion, die mit Ihrer Produktinstallation bereitgestellt wird. Sie finden die EAR-Datei in der Installationsstruktur, in der Sie IBM WebSphere Application Server Feature Pack for Web 2.0 and Mobile installiert haben. Angenommen, Sie haben das Feature-Pack im folgenden Verzeichnis installiert:

Linux und UNIX: /opt/WebSphere/AppServer
z/OS-Mountpunkt: <Installationsstammverzeichnis>
Windows: c:\WebSphere\AppServer

In diesem Fall finden Sie die EAR-Datei im folgenden Verzeichnis:

Linux und UNIX: /opt/WebSphere/AppServer/web2mobilefep_1.1/installableApps/application_services/graphics/appsvcs-graphics.ear
z/OS: <Installationsstammverzeichnis>/web2mobilefep_1.1/installableApps/application_services/graphics/appsvcs-graphics.ear
Windows: c:\WebSphere\AppServer\web2mobilefep_1.1\installableApps\application_services\graphics\appsvcs-graphics.ear

Service Graphics Conversion über die Administrationskonsole installieren

  1. Melden Sie sich bei der Administrationskonsole des Anwendungsservers an.
  2. Klicken Sie auf Anwendungen > Neue Anwendung. (Anmerkung: In WebSphere Application Server Version 6.1 wählen Sie Neue Anwendung installieren aus.)
  3. Wählen Sie Neue Unternehmensanwendung aus. (Anmerkung: In WebSphere Application Server Version 6.1 überspringen Sie diesen Schritt.)
  4. Durchsuchen Sie Ihr Dateisystem, und wählen Sie die Datei "appsvcs-graphics.ear" aus, die Sie zuvor gesucht haben. Klicken Sie auf Weiter.
  5. Klicken Sie auf Weiter, um die Anwendungsinstallation vorzubereiten. (Anmerkung: In WebSphere Application Server Version 6.1 überspringen Sie diesen Schritt.)
  6. Klicken Sie auf Weiter, um die Standardinstallationsoptionen zu akzeptieren.
  7. Klicken Sie auf Weiter, um die Standardoptionen für die Zuordnung von Modulen zu Servern zu akzeptieren.
  8. Klicken Sie auf Weiter, um die Standardoptionen für die Metadaten für Module zu akzeptieren. (Anmerkung: In den WebSphere Application Server Versionen 6.1 und 7 überspringen Sie diesen Schritt.)
  9. Klicken Sie auf Weiter, um die Standardoptionen für die Zuordnung virtueller Hosts zu Webmodulen zu akzeptieren.
  10. Überprüfen Sie die Zusammenfassung der Installationsoptionen.
  11. Klicken Sie auf Fertig stellen.
  12. Klicken Sie auf In Masterkonfiguration speichern.
  13. Klicken Sie auf Anwendungen > Anwendungstypen > WebSphere-Unternehmensanwendungen. (Anmerkung: In WebSphere Application Server Version 6.1 klicken Sie auf Anwendungen > Enterprise-Anwendungen.)
  14. Wählen Sie IBM WebSphere Application Server - Graphics Conversion service aus, und klicken Sie anschließend auf Starten.

Installationsanweisungen für WebSphere Application Server Community Edition Version 2.X

In diesem Abschnitt wird die Vorgehensweise bei der Installation des Service Graphics Conversion in Version 2.X von IBM WebSphere Application Server Community Edition beschrieben. Es wird vorausgesetzt, dass Sie sich mit der Installation und Verwaltung von Anwendungen im Anwendungsserver auskennen.

Vorbereitungen

Suchen Sie die EAR-Datei des Service Graphics Conversion, die mit Ihrer Produktinstallation bereitgestellt wird. Sie finden die EAR-Datei in der Installationsstruktur, in der Sie IBM WebSphere Application Server Feature Pack for Web 2.0 and Mobile installiert haben. Angenommen, Sie haben das Feature-Pack im folgenden Verzeichnis installiert:

Linux und UNIX: /opt/WebSphere/AppServerCommunityEdition
Windows: c:\WebSphere\AppServerCommunityEdition

In diesem Fall finden Sie die EAR-Dateien und Bibliotheksdateien an folgender Position:

Linux und UNIX: /opt/WebSphere/AppServerCommunityEdition/web2mobilefep_1.1/AppServices/installableApps/graphics/appsvcs-graphics.ear
Windows: c:\WebSphere\AppServerCommunityEdition\web2mobilefep_1.1\AppServices\installableApps\graphics\appsvcs-graphics.ear

Installation über die Administrationskonsole

Melden Sie sich bei der Administrationskonsole des Anwendungsservers an.

  1. Klicken Sie im linken Menü auf Anwendungen > Deployer. (Anmerkung: In WebSphere Application Server Community Edition Version 2.0 klicken Sie auf Anwendungen > Neue Anwendung implementieren.)
  2. Suchen Sie über das Feld Archiv in Ihrem Dateisystem die Datei "appsvcs-graphics.ear", und wählen Sie sie aus. Lassen Sie das Feld Plan leer und die Standardoptionen ausgewählt. Klicken Sie anschließend auf Installieren.

Die Anwendung wird automatisch gestartet, und die Installation ist damit abgeschlossen.