Dieses Dokument ist der Ausgangspunkt für das Erlernen des Umgangs mit dem Service Graphics Conversion. Die Einführung ist in folgende Abschnitte untergliedert:
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 PNG TIFF GFX GIF Ja Ja[1] Nein Ja[1] Nein Nein JPEG Ja[1] Ja Nein Ja Nein Nein --- --- --- --- --- --- 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.
Vorausgesetztes Produkt | Version |
---|---|
Java Technology Edition | 5.0 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 |
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.
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/
Probieren Sie in den verschiedenen Eingabefeldern verschiedene Werte aus, um die konvertierten Bilder zu prüfen.
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>
Arbeitsdateien und konvertierte Dateien, die über eine URL-Referenz zurückgegeben werden, werden an einer temporären Verzeichnisposition gespeichert, die mit dem Konfigurationsparameter "resultsTmpDir" angegeben wird, der in einem Initialisierungsparameter in der Datei "web.xml" deklariert wird. Der folgende Teil der Datei "web.xml" veranschaulicht die Verwendung:
... <init-param> <!-- Setzen Sie die folgende Eigenschaft auf den vollständigen Pfad, in dem die neu skalierten und konvertierten Bilder gespeichert werden sollen.--> <!-- Beispiel für Linux/Unix: /tmp --> <!-- Beispiel für Windows: c:\temp --> <!-- Wenn Sie keinen Wert angeben, wird standardmäßig das ServletContext-Attribut "javax.servlet.context.tempdir" des Webcontainers verwendet. --> <!-- Wenn die Sonderzeichenfolge "java.io.tmpdir" angegeben ist, verwendet der Service die Java-Systemeigenschaft mit dem Schlüssel "java.io.tmpdir" --> <param-name>com.ibm.ws.mobile.appsvcs.graphics.resultsTmpDir</param-name> <param-value>java.io.tmpdir</param-value> </init-param> ...
Lesen Sie die folgenden versionsspezifischen Installationsanweisungen:
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.
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
- Melden Sie sich bei der Administrationskonsole des Anwendungsservers an.
- Klicken Sie auf Anwendungen > Neue Anwendung. (Anmerkung: In WebSphere Application Server Version 6.1 wählen Sie Neue Anwendung installieren aus.)
- Wählen Sie Neue Unternehmensanwendung aus. (Anmerkung: In WebSphere Application Server Version 6.1 überspringen Sie diesen Schritt.)
- Durchsuchen Sie Ihr Dateisystem, und wählen Sie die Datei "appsvcs-graphics.ear" aus, die Sie zuvor gesucht haben. Klicken Sie auf Weiter.
- Klicken Sie auf Weiter, um die Anwendungsinstallation vorzubereiten. (Anmerkung: In WebSphere Application Server Version 6.1 überspringen Sie diesen Schritt.)
- Klicken Sie auf Weiter, um die Standardinstallationsoptionen zu akzeptieren.
- Klicken Sie auf Weiter, um die Standardoptionen für die Zuordnung von Modulen zu Servern zu akzeptieren.
- 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.)
- Klicken Sie auf Weiter, um die Standardoptionen für die Zuordnung virtueller Hosts zu Webmodulen zu akzeptieren.
- Überprüfen Sie die Zusammenfassung der Installationsoptionen.
- Klicken Sie auf Fertig stellen.
- Klicken Sie auf In Masterkonfiguration speichern.
- Klicken Sie auf Anwendungen > Anwendungstypen > WebSphere-Unternehmensanwendungen. (Anmerkung: In WebSphere Application Server Version 6.1 klicken Sie auf Anwendungen > Enterprise-Anwendungen.)
- Wählen Sie IBM WebSphere Application Server - Graphics Conversion service aus, und klicken Sie anschließend auf Starten.
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.
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
Melden Sie sich bei der Administrationskonsole des Anwendungsservers an.
- 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.)
- 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.