图形转换服务入门

本文档是您了解图形转换服务的起始点。包括下列主题:

概述

图形转换服务提供服务器端 JAX-RS 资源,该资源支持多种图形格式之间的缩放和转换。请参阅转换图表以获取详细信息。

从/至 GIF JPEG PDF PNG TIFF GFX
GIF 是 [1] 是 [1]
JPEG 是 [1]
PDF --- --- --- --- --- ---
PNG 是 [1]
SVG 是 [2]
TIFF --- --- --- --- --- ---

[1] 仅在 Java SDK V6.0 或更高版本的情况下受支持。

[2] 当前在 SVG 至 GFX 功能的作用域中存在限制。请参阅限制一节。

通过移动展示样本提供了样本客户机应用程序,该应用程序说明了图形转换服务的简单 Ajax 调用。WAS 8.5 样本信息中心中提供了移动展示样本。

注:
  • 图形转换样本应用程序仅用于说明图形转换服务的一种可能用法,并且用于说明可以使用 AJAX 调用来进行 REST 请求的方式。
  • 由于特定浏览器中存在关于呈现 img 和 iframe HTML 标记中的 SVG 内容的限制,所以有时会使用变通方法,其中涉及在选择 SVG 图像时呈现非 SVG 图像。但是,这仅仅是出于选择显示目的,因此已在 HTML 文档中进行了相应注释。然而,将实际 AJAX 请求发送至服务时,始终会发送实际的 SVG 图像以进行转换。在结果视图中,您始终会看到实际的转换后图像,必要时可以保存该图像。

先决条件:

产品先决条件 版本
Java Technology Edition 5.0 及更高版本
Java Platform, Enterprise Edition 5
应用程序服务器及更高版本

WebSphere Application Server V8.5r

Web 浏览器 任何现代 Web 浏览器,如:Internet Explorer 7 及更高版本、Mozilla Firefox 3.x 及更高版本、Google Chrome、Safari 和 Opera

局限性

安全性注意事项

使用图形转换服务

  1. 要使用图形转换服务,请将该服务 .ear 文件部署至应用程序服务器。请阅读有关安装图形转换服务的信息。

  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>
    

安装图形转换服务

WebSphere Application Server 安装指示信息

本节描述在 IBM WebSphere Application Server V8.5 中安装图形转换服务的过程。假定您熟悉应用程序服务器的应用程序安装和管理工作。

在您开始之前

找到产品安装随附提供的图形转换服务企业归档 (EAR) 文件。可以在已安装 IBM WebSphere Application Server Web 2.0 and Mobile Toolkit 的安装树中找到该 EAR 文件。例如,如果已将 Toolkit 安装在以下位置中:

平台 位置
Linux 和 UNIX: /opt/WebSphere/Web20Mobile
Windows: c:\WebSphere\Web20Mobile

那么可以在以下位置找到该 EAR 文件:

平台 位置
Linux 和 UNIX: /opt/WebSphere/Web20Mobile/installableApps/application_services/graphics/appsvcs-graphics.ear
Windows: c:\WebSphere\Web20Mobile\installableApps\application_services\graphics\appsvcs-graphics.ear

使用管理控制台安装图形转换服务

  1. 登录到应用程序服务器的管理控制台。
  2. 浏览至应用程序 > 新建应用程序。(注:在 WebSphere Application Server V6.1 中,选择安装新的应用程序
  3. 选择新建企业应用程序。(注:在 WebSphere Application Server V6.1 中,跳过此步骤)
  4. 浏览文件系统,并选择您先前找到的 appsvcs-graphics.ear 文件。单击下一步
  5. 单击下一步以准备安装应用程序。(注:在 WebSphere Application Server V6.1 中,跳过此步骤)
  6. 单击下一步以接受缺省安装选项。
  7. 单击下一步以接受有关将模块映射至服务器的缺省选项。
  8. 单击下一步以接受有关模块元数据的缺省选项。(注:在 WebSphere Application Server V6.1 和 V7 中,跳过此步骤)
  9. 单击下一步以接受有关映射 Web 模块的虚拟主机的缺省选项。
  10. 查看安装选项摘要。
  11. 单击完成
  12. 单击保存到主配置
  13. 浏览至应用程序 > 应用程序类型 > WebSphere 企业应用程序。(注:在 WebSphere Application Server V6.1 中,浏览至应用程序 > 企业应用程序
  14. 选择 IBM WebSphere Application Server - 图形转换服务,然后单击启动

使用条款 | 反馈