创建 Java Web 应用程序
如果您要构建使用 Java 企业版的 Web 应用程序,或者您的需求已经超出 JavaScript API 的能力范围,那么您可以考虑使用 ArcGIS Server Web 应用程序开发框架 (ADF)。Web ADF 提供了可用于在 Java 企业版环境中开发 Web 应用程序的工具和模板。
安装 Web ADF 后,您将可以访问 Eclipse 和 NetBeans 的开发人员插件,其中包括:
- “新建项目”对话框中的“Web 制图应用程序”模板
- ArcGIS Java 企业版 Web 控件
- 使用 com.esri.adf 前缀的开发人员库
支持的开发人员 IDE 包括 Eclipse 和 NetBeans。这些都是用于扩展 Web 制图应用程序的理想效能工具。使用 Web ADF 时,除了可以添加文本框和按钮之外,还可以将地图和内容列表等直接添加到 Web 应用程序。“开发人员帮助”假设您已熟知此开发环境并了解标准 Java 企业版 JSF 控件。
启动 Web 制图应用程序
Web ADF 随 Web 制图应用程序一同提供,它是一种即用型应用程序模板。Web 制图应用程序可通过“管理器”应用程序或其中某个 IDE 插件轻松地创建。您可以从“管理器”直接运行 Web 制图应用程序,并“按原样”对其进行部署,无需编写任何其他代码,也可以将它导入开发人员 IDE,以用作创建自定义应用程序的起点。在某些情况下,您可能需要使用包含在 Web 制图应用程序中的代码或文件来指导您自己的项目。
新建 Web 应用程序
您可以使用随 Web ADF 提供的工具在 Java 企业版开发人员 IDE 中新建 Web 应用程序,而不使用先前在“管理器”中创建的模板或应用程序。如果您所使用的 Eclipse 或 NetBeans 已经安装插件,则可以通过将 ADF Web 控件添加到各个项目的类路径中来使用这些控件。
如果您不需要使用 Web 控件,或者您想使用除所提供的默认功能之外的其他功能,则可以使用随 ArcGIS Server 提供的库,通过程序连接到服务器,并对在此服务器上运行的服务进行操作。每个库都具有一个对象模型图,以帮助您直观地了解库中的各类及其相互间的关系。可以在“开发人员帮助”的库参考部分查找对象模型图。
使用 Web ADF
Web ADF 旨在支持与 Web 应用程序和 Web 服务中多种类型的 GIS 服务建立连接。其中包括以下内容:
- ArcGIS Server(本地和 Internet)服务
- ArcIMS 服务
- ArcGIS Online 服务
- OGC WMS 服务
您不仅可以访问多种类型 GIS 服务器,还可以将在这些服务器上运行的 GIS 服务组合到一个地图中。Web ADF 支持向单个地图显示添加多个地图服务,从而帮助您实现对在同一服务器或各类不同服务器上运行的地图服务的无缝集成。例如,您可以将在 ArcIMS Server 上运行的地图服务与在 ArcGIS Server 上运行的地图服务组合到一起。这种多服务架构可以使您以透明的方式叠加地图服务。
Web ADF 支持的每种类型服务都具有各自的 API。这意味着如果地图包含多个不同类型的服务,您可能需要使用多个 API。例如,如果您的地图中组合了 ArcGIS Server 服务和 ArcIMS 服务,则您可能需要同时使用 ArcObjects 和 ArcIMS API 进行编程。幸运的是,ADF 提供了一个通用 API,可用于导航和查询包含多个服务类型的地图。这意味着,对于涉及整个地图的操作(如缩放至特定范围),您可以使用 Web ADF 的工具类编写代码,而不必使用每个服务类型的 API 编写代码。
如果您要使用某个特定服务类型开发高级功能,ADF 可以为您提供在 Java 环境中访问服务的 API 的方法。例如,您可以通过 Java 类使用 ArcIMS API 操作 ArcIMS 服务。“开发人员帮助”包含有关多服务类型编程及针对各个服务访问 API 的方法的信息。
除了上面列出的服务类型之外,Web ADF 还支持添加图形到地图的功能。在许多情况中,使用 Web ADF 图形图层可提供一种轻量级选择,代替其他更高级的存储数据手段,如通过编程创建要素类。
扩展 Web ADF
Web ADF 被设计为一种灵活的应用程序开发框架,以便用户能够自定义如下内容:
- 工具和命令
- 任务
- 数据源
ADF 随附的“工具条”控件包含了一组用于地图导航和查询的默认工具和命令。可针对自己的工具和命令编写代码,并将其添加到工具条。执行此操作的通用方法就是在类库中编写要添加到开发人员 IDE 项目中的自定义代码。之后可配置各个工具和命令以执行类库中的代码。
Web ADF 包含许多可添加到应用程序的开箱即用任务。其中包含用于查询、网络分析及编辑的任务。所有这些任务都是由“Web 控件”库中的通用框架构建得来的。可用同一框架开发自己的任务。
Web ADF 支持多种类型服务的显示和查询功能,如 ArcGIS Server 服务、ArcIMS 服务及 WMS 服务。在 ADF 的上下文中,服务被称为数据源。ADF 包含了用于开发支持个人数据源类型的功能的框架,该数据源类型是除了上述所列类型之外的数据源类型。
获取帮助
在安装 Web ADF 时,会自动安装“开发人员帮助”。“开发人员帮助”可以从桌面启动,也可以通过 Linux/Solaris 中的命令行或在支持的开发人员 IDE 中启动。
要从桌面启动“开发人员帮助”,请遵循以下步骤:
- 导航到开始 > 所有程序 > ArcGIS > 开发人员帮助 > 打开 Java 帮助。
- 单击开发应用程序。
要在 Linux/Solaris 中通过命令行打开“开发人员帮助”,可执行以下操作:
在 Linux/Solaris 中,通过运行以下命令,以安装程序所有者的身份打开 Java“开发人员帮助”
- % <ArcGIS Server 安装目录>/scripts/startJavaHelp
要在 Eclipse 中打开“开发人员帮助”,可执行以下操作:
- 在帮助菜单中单击帮助目录。
- 单击 ArcGIS Server。
- 单击开发应用程序。
库参考
库参考包含了 Web ADF 中的每个类和成员的简要说明。某些类和成员具有额外的备注和代码示例。此外,如果程序包具有对象模型图,则可在库参考中找到。
可按照上述步骤打开“开发人员帮助”来访问库参考。单击 ArcGIS Server 后,将在目录中看到参考节点。