Einführung in den Service Graphics Conversion

Dieses Dokument ist der Ausgangspunkt für das Erlernen des Umgangs mit dem Service Graphics Conversion. Das Dokument 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" bereitgestellt wird, veranschaulicht einen einfachen Ajax-Aufruf des Service "Graphics Conversion" . Das Beispiel "Mobile Showcase" ist im Information Center zu den Beispielen in WAS 8.5 verfügbar.

Anmerkung:
  • Die Beispielanwendung "Graphics Conversion" ist nur zur Veranschaulichung einer der möglichen Verwendungsmöglichkeiten des Service "Graphics Conversion" bestimmt 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 8.5

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

Anweisungen für die Installation in WebSphere Application Server

In diesem Abschnitt wird beschrieben, wie der Service "Graphics Conversion" in Version 8.5 von IBM WebSphere Application Server installiert wird. 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 Ihrer Installationsverzeichnisstruktur, in der Sie WebSphere Application Server Web 2.0 and Mobile Toolkit installiert haben. Angenommen, Sie haben das Toolkit im folgenden Verzeichnis installiert:

Plattform Position
Linux und UNIX: /opt/WebSphere/Web20Mobile
Windows: c:\WebSphere\Web20Mobile

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

Plattform Position
Linux und UNIX: /opt/WebSphere/Web20Mobile/installableApps/application_services/graphics/appsvcs-graphics.ear
Windows: c:\WebSphere\Web20Mobile\installableApps\application_services\graphics\appsvcs-graphics.ear

Service Graphics Conversion über die Administrationskonsole installieren

  1. Melden Sie sich an 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.

Nutzungsbedingungen | Feedback