Graphics Conversion サービス入門

この文書は、Graphics Conversion サービスについて学習するための開始点です。以下のトピックについて説明します。

概説

Graphics Conversion サービスは、多くのグラフィックス・フォーマット間での拡大縮小および変換をサポートする、サーバー・サイド JAX-RS リソースを提供します。詳しくは、以下の変換チャートを参照してください。

から / へ GIF JPEG PDF PNG TIFF GFX
GIF はい はい [1] いいえ はい [1] いいえ いいえ
JPEG はい [1] はい いいえ はい いいえ いいえ
PDF --- --- --- --- --- ---
PNG はい [1] はい いいえ はい いいえ いいえ
SVG いいえ はい はい はい はい はい [2]
TIFF --- --- --- --- --- ---

[1] Java SDK バージョン 6.0 以降でのみサポートされます。

[2] 現在は、SVG から GFX への機能の有効範囲には制限があります。制限セクションを参照してください。

Graphics Conversion サービスの単純な Ajax 起動を分かりやすく示すためのサンプル・クライアント・アプリケーションが、WebSphere Application Server 上の Mobile Showcase サンプルを介して提供されます。クライアントでは、変換を必要とするグラフィック・ファイルの URL と、既存のイメージを変換する先のイメージ・フォーマットをユーザーが指定でき、拡大縮小が要求されている場合は、生成されるイメージの最大幅と最大高さもオプションで指定できるようになっています。このサービスは、クライアント・アプリケーションにとって最も便利なフォーマットで使用できるよう、変換後のファイルへの URL を戻すか、または、バイナリー・イメージを戻します。オプションは URL 照会パラメーターであるため、ユーザーは、必要なパラメーターを使用して URL を構築することもでき、変換後のイメージがユーザーのブラウザーに表示されます。

注:
  • Graphics Conversion サンプル・アプリケーションは、Graphics Conversion サービスの可能な使用法の 1 つと、AJAX 起動を使用して REST 要求を作成する方法を示すことだけが目的です。
  • HTML タグ img および iframe 内の SVG コンテンツのレンダリングに関して一定のブラウザーに存在する制限のため、SVG イメージが選択された場合に 非 SVG イメージのレンダリングを使用するといった回避策が採用されることがあります。しかし、これは単に選択表示目的であり、html 文書中にそのように注記されています。ただし、実際の Ajax 要求がサービスに送られるときには、常に実際の SVG イメージが変換用に送られます。結果ビューには常に変換後のイメージが表示され、必要であれば保存できます。

前提条件:

前提となる製品 バージョン
Java Technology Edition 5.0 以降
Java Platform, Enterprise Edition 5
アプリケーション・サーバー以降

WebSphere Application Server バージョン 6.1.0.x 以降

WebSphere Application Server Community Edition バージョン 2.X

Web ブラウザー 任意の新しい Web ブラウザー (例: Internet Explorer 7 以降、 Mozilla Firefox 3.x 以降、Google Chrome、Safari、Opera)

制限

セキュリティーの考慮事項

Graphics Conversion サービスの使用

  1. Graphics Conversion サービスを使用するには、このサービスの .ear ファイルをアプリケーション・サーバーにデプロイします。Graphics Conversion サービスのインストールをお読みください。

  2. サービスのデプロイが終わったら、提供されているクライアント・デモを使用できます。デモは以下の場所にあります。

    http://<server>:<port>/appsvcs-graphics/
    
  3. さまざまな入力フィールドに異なる値を入力してみて、変換後のイメージを確認してください。

  4. 次の例のように、パラメーターを使用して URL を入力して、ブラウザーで動的イメージ変換を直接生成することもできます。

    http://<server>:<port>/appsvcs-graphics/rest/graphics/convert/binaryResponse?sourceUrl=<graphic_file_url>&desiredFormat=<new_format>&maxWidth=<optional_width>&maxHeight=<optional_height>
    

Graphics Conversion サービスのインストール

以下のバージョン固有のインストール手順を参照してください。

WebSphere Application Server インストール手順

このセクションでは、バージョン 6.1.0.X 以降の IBM WebSphere Application Server に Graphics Conversion サービスをインストールする手順を説明します。ここでは、アプリケーションのインストールとアプリケーション・サーバーの管理についての知識があることを前提としています。

はじめに

製品インストールと共に提供される Graphics Conversion サービス・エンタープライズ・アーカイブ (EAR) ファイルがある場所を確認してください。この EAR ファイルは、IBM WebSphere Application Server Feature Pack for Web 2.0 and Mobile をインストールしたインストール・ツリー内にあります。例えば、このフィーチャー・パックを以下の場所にインストールしたとします。

Linux および UNIX: /opt/WebSphere/AppServer
z/OS マウント・ポイント: <install_root>
Windows: c:\WebSphere\AppServer

この場合、EAR ファイルは次の場所にあります。

Linux および UNIX: /opt/WebSphere/AppServer/web2mobilefep_1.1/installableApps/application_services/graphics/appsvcs-graphics.ear
z/OS: <install_root>/web2mobilefep_1.1/installableApps/application_services/graphics/appsvcs-graphics.ear
Windows: c:\WebSphere\AppServer\web2mobilefep_1.1\installableApps\application_services\graphics\appsvcs-graphics.ear

管理コンソールを使用した Graphics Conversion サービスのインストール

  1. アプリケーション・サーバーの管理コンソールにログインします。
  2. 「アプリケーション」>「新規アプリケーション」とナビゲートします (注: WebSphere Application Server バージョン 6.1 では、「新規アプリケーションのインストール」を選択します)。
  3. 新規エンタープライズ・アプリケーション」を選択します (注: WebSphere Application Server バージョン 6.1 では、このステップをスキップします)。
  4. ファイル・システムを参照し、前に場所を確認しておいた appsvcs-graphics.ear ファイルを選択します。「次へ」をクリックします。
  5. 次へ」をクリックして、アプリケーション・インストールを準備します (注: WebSphere Application Server バージョン 6.1 では、このステップをスキップします)。
  6. 次へ」をクリックして、デフォルトのインストール・オプションを受け入れます。
  7. 次へ」をクリックして、モジュールからサーバーへのマップに関するデフォルト・オプションを受け入れます。
  8. 次へ」をクリックして、モジュールのメタデータに関するデフォルト・オプションを受け入れます (注: WebSphere Application Server バージョン 6.1 および 7 では、このステップをスキップします)。
  9. 次へ」をクリックして、Web モジュール用の仮想ホストのマップに関するデフォルト・オプションを受け入れます。
  10. インストール・オプションの要約を確認します。
  11. 完了」をクリックします。
  12. マスター構成に保存」をクリックします。
  13. 「アプリケーション」>「アプリケーション・タイプ」>「WebSphere エンタープライズ・アプリケーション」とナビゲートします (注: WebSphere Application Server バージョン 6.1 では、「アプリケーション」>「エンタープライズ・アプリケーション」とナビゲートします)。
  14. IBM WebSphere Application Server - Graphics Conversion サービス」を選択し、「開始」をクリックします。

WebSphere Application Server Community Edition バージョン 2.X インストール手順

このセクションでは、バージョン 2.X の IBM WebSphere Application Server Community Edition に Graphics Conversion サービスをインストールする手順を説明します。ここでは、アプリケーションのインストールとアプリケーション・サーバーの管理についての知識があることを前提としています。

はじめに

製品インストールと共に提供される Graphics Conversion サービス・エンタープライズ・アーカイブ (EAR) ファイルがある場所を確認してください。この EAR ファイルは、IBM WebSphere Application Server Feature Pack for Web 2.0 and Mobile をインストールしたインストール・ツリー内にあります。例えば、このフィーチャー・パックを以下の場所にインストールしたとします。

Linux および UNIX: /opt/WebSphere/AppServerCommunityEdition
Windows: c:\WebSphere\AppServerCommunityEdition

この場合、EAR ファイルおよびライブラリー・ファイルは次の場所にあります。

Linux および 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

管理コンソールを使用したインストール

アプリケーション・サーバーの管理コンソールにログインします。

  1. 左側のメニューで「アプリケーション」>「デプロイヤー」をクリックします (注: WebSphere Application Server Community Edition バージョン 2.0 では、「アプリケーション」>「新規デプロイ」をクリックします)。
  2. アーカイブ」フィールドで、ファイル・システムを参照し、前に場所を確認しておいた appsvcs-graphics.ear ファイルを選択します。「プラン」フィールドは空のままにしておきます。また、デフォルト・オプションも選択されたままにしておきます。次に、「インストール」をクリックします。

アプリケーションが自動的に開始し、インストールが実行されます。