如何使用 Ali-Tomcat 开发应用?

Ali-Tomcat 是 SAE 中的服务运行时可依赖的一个容器，它主要集成了服务的发布、订阅、调用链追踪等一系列的核心功能。无论是开发环境还是运行时，您均可将应用程序发布在该容器中。

Pandora 是一个轻量级的隔离容器，也就是 taobao-hsf.sar。它用来隔离应用和中间件的依赖，也用来隔离中间件之间的依赖。SAE 的 Pandora 中集成了服务发现、配置推送和调用链跟踪等各种中间件功能产品插件。您可以利用该插件对 EDAS 应用进行服务监控、治理、跟踪、分析等全方位运维管理。

本文介绍如何安装 Ali-Tomcat 和 Pandora，以及如何配置 Eclipse 和 IntelliJ IDEA 的开发环境。

安装 Ali-Tomcat 和 Pandora Ali-Tomcat 和 Pandora 为 SAE 中的服务运行时所依赖的容器，集成了服务的发布、订阅、调用链追踪等一系列心功能，应用程序须发布在该容器中运行。

注意 请使用 JDK 1.7及以上版本。 下载 Ali-Tomcat，保存并解压至相应的目录（如：d:\work\tomcat\）。 下载 Pandora 容器，保存并解压至 Ali-Tomcat 的 deploy 目录（d:\work\tomcat\deploy）下。 查看 Pandora 容器的目录结构。 Linux 系统中，在相应路径下执行 tree -L 2 deploy/ 命令查看目录结构。 d:\work\tomcat > tree -L 2 deploy/ deploy/ └── taobao-hsf.sar ├── META-INF ├── lib ├── log.properties ├── plugins ├── sharedlib └── version.properties Windows 中，直接进入相应路径进行查看。Pandora容器目录结构 如果您在安装和使用 Ali-Tomcat 和 Pandora 过程中遇到问题，请参见 Ali-Tomcat 问题和Pandora 问题

配置 Eclipse 开发环境 配置 Eclipse 需要下载 Tomcat4E 插件，并存放在安装 Ali-TomcatPandora 容器的保存路径中，完成配置后可以直接在 Eclipse 中发布、调试本地代码。 下载 Tomcat4E 插件 压缩包内容如下图所示。Tomcat4E 插件 打开 Eclipse，在菜单栏中选择Help > Install New Software 。 在 Install 对话框中 Work with 区域右侧单击 Add，且在弹出的 Add Repository 对话框中单击 Local，并在弹出的对话框中选中已下载并解压的 Tomcat4E 插件的目录（d:\work\tomcat4e\），单击 OK。 返回 Install 对话框，单击 Select All，并单击 Next。 后续步骤，请按界面提示操作。安装完成后，请重启 Eclipse，使 Tomcant4E 插件生效。 重启 Eclipse 后，在 Eclipse 菜单中选择 Run As > Run Configurations 。 选择左侧导航选项中的 AliTomcat Webapp，单击上方的 New launch configuration 图标。 在弹出的界面中，选择 AliTomcat页签，并在 taobao-hsf.sar Location 区域单击 Browse，选择本地的 Pandora 路径，如：d:\work\tomcat\deploy\taobao-hsf.sar。 单击 Apply 或 Run，完成设置。 一个工程只需配置一次，下次可直接启动。 查看工程运行的打印信息，如果出现下图 Pandora Container 的相关信息，即说明 Eclipse 开发环境配置成功。 edas-DG-pandora-success 配置 IntelliJ IDEA 开发环境 注意 目前仅支持 IDEA 商业版，社区版暂不支持。 运行 IntelliJ IDEA。 在菜单栏中选择 Run > Edit Configuration。 在 Run/Debug Configuration 页面左侧的导航栏中选择 Defaults > Tomcat Server > Local 。 配置 AliTomcat。 在右侧页面单击 Server 页签，并在 Application Server 区域单击 Configure。 在 Application Server 页面右上角单击 +，并在 Tomcat Server 对话框中设置 Tomcat Home 和 Tomcat base directory 路径，且单击 OK。 将 Tomcat Home 的路径设置为本地解压后的 Ali-Tomcat 路径，Tomcat base directory 可以自动使用该路径，无需再设置。 在 Application Server 区域的下拉菜单中，选择刚刚配置好的 Ali-Tomcat。 在 VM Options 区域的文本框中，设置 JVM 启动参数指向 Pandora 的路径。 列如：-Dpandora.location=d:\work\tomcat\deploy\taobao-hsf.sar 将d:\work\tomcat\deploy\taobao-hsf.sar 替换为在本地安装 Pandora 的实际路径。

单击 Apply 或 OK 完成配置。

介绍如何使用 SDK 快速开发 HSF 应用，完成服务注册与发现。

下载 Demo 工程 您可以按照本文的步骤一步步搭建工程，也可以直接下载本文对应的示例工程，或者使用 Git 下载： git clone https://github.com/aliyun/alibabacloud-microservice-demo.git。

该项目包含了众多示例工程，本文对应的示例工程位于 alibabacloud-microservice-demo/microservice-doc-demo/hsf-ali-tomcat，包含 itemcenter-api，itemcenter 和 detail 三个 Maven 工程文件夹。

itemcenter-api：提供接口定义 itemcenter：服务提供者 detail：消费者服务 说明 请使用 JDK 1.7 及以上版本。 定义服务接口 HSF 服务基于接口实现，当接口定义好之后，生产者将使用该接口实现具体的服务，消费者也基于此接口去订阅服务。

在 Demo 的 itemcenter-api 工程中，定义了一个服务接口 com.alibaba.edas.carshop.itemcenter.ItemService。 public interface ItemService { public Item getItemById(long id); public Item getItemByName(String name); } 该服务接口将提供两个方法：getItemById 与 getItemByName。

开发服务提供者 服务提供者将实现服务接口以提供具体服务。同时，如果使用了 Spring 框架，还需要在 xml 文件中配置服务属性。 说明 Demo 工程中的 itemcenter 文件夹为服务提供者的示例代码。 实现服务接口。 请参考 ItemServiceImpl.java 文件中的示例代码构建服务接口。 public class ItemServiceImpl implements ItemService {

@Override
public Item getItemById( long id ) {
    Item car = new Item();
    car.setItemId( 1l );
    car.setItemName( "Mercedes Benz" );
    return car;
}
@Override
public Item getItemByName( String name ) {
    Item car = new Item();
    car.setItemId( 1l );
    car.setItemName( "Mercedes Benz" );
    return car;
}

} 服务提供者配置。 实现服务接口中实现了 com.alibaba.edas.carshop.itemcenter.ItemService，并在两个方法中返回了 Item 对象。代码开发完成之后，除了在 web.xml 中进行必要的常规配置，您还需要增加相应的 Maven 依赖，同时在 Spring 配置文件使用 标签注册并发布该服务。

在 pom.xml 中添加 Maven 依赖。 javax.servlet servlet-api 2.5 provided com.alibaba.edas.carshop itemcenter-api 1.0.0-SNAPSHOT org.springframework spring-web 2.5.6(及其以上版本) com.alibaba.edas edas-sdk 1.8.1 在 hsf-provider-beans.xml 文件中增加 Spring 关于 HSF 服务的配置。

属性 描述 interface 必须配置，类型为 [String]，为服务对外提供的接口。 version 可选配置，类型为 [String]，含义为服务的版本，默认为 1.0.0。 clientTimeout 该配置对接口中的所有方法生效，但是如果客户端通过 methodSpecials 属性对某方法配置了超时时间，则该方法的超时时间以客户端配置为准。其他方法不受影响，还是以服务端配置为准。 serializeType 可选配置，类型为 [String(hessian｜java)]，含义为序列化类型，默认为 hessian。 corePoolSize 单独针对这个服务设置核心线程池，从公用线程池中划分出来。 maxPoolSize 单独针对这个服务设置线程池，从公用线程池中划分出来。 enableTXC 开启分布式事务 GTS。 ref 必须配置，类型为 [ref]，为需要发布为 HSF 服务的 Spring Bean ID。 methodSpecials 可选配置，用于为方法单独配置超时时间（单位 ms），这样接口中的方法可以采用不同的超时时间。该配置优先级高于上面的 clientTimeout 的超时配置，低于客户端的 methodSpecials 配置。 服务创建及发布存在以下限制：

名称 示例 限制大小 是否可调整 {服务名}:{版本号} com.alibaba.edas.testcase.api.TestCase:1.0.0 最大192字节 否 组名 HSF 最大32字节 否 单个 Pandora 应用实例发布的服务数 N/A 最大 800 个 可在应用基本信息页面单击应用设置部分右侧的设置，在下拉列表中选择JVM，在弹出的应用设置对话框中进入自定义 > 自定义参数，-DCC.pubCountMax=1200属性参数（该参数值可根据应用实际发布的服务数调整）。 服务提供者属性配置示例： <hsf:provider id="simpleService" interface="com.taobao.edas.service.SimpleService" ref="impl" version="1.0.1" clientTimeout="3000" enableTXC="true" serializeType="hessian"> hsf:methodSpecials <hsf:methodSpecial name="sum" timeout="2000" /> </hsf:methodSpecials> </hsf:provider> 开发服务消费者 消费者订阅服务从代码编写的角度分为两个部分。 Spring 的配置文件使用标签 hsf:consumer/ 定义好一个 Bean。 在使用的时候从 Spring 的 context 中将 Bean 取出来。 说明 Demo 工程中的 detail 文件夹为消费者服务的示例代码。 与生产者相同，消费者的服务属性配置分为 Maven 依赖配置与 Spring 的配置。 配置服务属性。 在 pom.xml 文件中添加 Maven 依赖。 javax.servlet servlet-api 2.5 provided com.alibaba.edas.carshop itemcenter-api 1.0.0-SNAPSHOT org.springframework spring-web 2.5.6(及其以上版本) com.alibaba.edas edas-sdk 1.8.1 在 hsf-consumer-beans.xml 文件中添加 Spring 关于 HSF 服务的配置。 增加消费者的定义，HSF 框架将根据该配置文件去服务中心订阅所需的服务。

@Override
public void contextInitialized( ServletContextEvent sce ) {
    ApplicationContext ctx = WebApplicationContextUtils.getWebApplicationContext( sce.getServletContext() );
    // 根据 Spring 配置中的 Bean ID “item” 获取订阅到的服务
    final ItemService itemService = ( ItemService ) ctx.getBean( "item" );
    ……
    // 调用服务 ItemService 的 getItemById 方法
    System.out.println( itemService.getItemById( 1111 ) );
    // 调用服务 ItemService 的 getItemByName 方法
    System.out.println( itemService.getItemByName( "myname is le" ) );
    ……
}

} 上面的示例中为基本配置，您也可以根据您的实际需求，参考下面的服务属性列表，增加其它配置。

属性 描述 interface 必须配置，类型为 [String]，为需要调用的服务的接口。 version 可选配置，类型为 [String]，为需要调用的服务的版本，默认为1.0.0。 methodSpecials 可选配置，为方法单独配置超时时间（单位 ms）。这样接口中的方法可以采用不同的超时时间，该配置优先级高于服务端的超时配置。 target 主要用于单元测试环境和开发环境中，手动地指定服务提供端的地址。如果不想通过此方式，而是通过配置中心推送的目标服务地址信息来指定服务端地址，可以在消费者端指定 -Dhsf.run.mode=0。 connectionNum 可选配置，为支持设置连接到 server 连接数，默认为1。在小数据传输，要求低延迟的情况下设置多一些，会提升 TPS。 clientTimeout 客户端统一设置接口中所有方法的超时时间（单位 ms）。超时时间设置优先级由高到低是：客户端 methodSpecials，客户端接口级别，服务端 methodSpecials，服务端接口级别 。 asyncallMethods 可选配置，类型为 [List]，设置调用此服务时需要采用异步调用的方法名列表以及异步调用的方式。默认为空集合，即所有方法都采用同步调用。 maxWaitTimeForCsAddress 配置该参数，目的是当服务进行订阅时，会在该参数指定时间内，阻塞线程等待地址推送，避免调用该服务时因为地址为空而出现地址找不到的情况。若超过该参数指定时间，地址还是没有推送，线程将不再等待，继续初始化后续内容。注意，在应用初始化时，需要调用某个服务时才使用该参数。如果不需要调用其它服务，请勿使用该参数，会延长启动时间。 消费者服务属性配置示例 <hsf:consumer id="service" interface="com.taobao.edas.service.SimpleService" version="1.1.0" clientTimeout="3000" target="10.1.6.57:12200?_TIMEOUT=1000" maxWaitTimeForCsAddress="5000"> hsf:methodSpecials <hsf:methodSpecial name="sum" timeout="2000" ></hsf:methodSpecial> </hsf:methodSpecials> </hsf:consumer> 本地运行服务 完成代码、接口开发和服务配置后，在 Eclipse 或 IDEA 中，可直接以 Ali-Tomcat 运行该服务（具体请参见安装及开发环境配置）。

在开发环境配置时，有一些额外 JVM 启动参数来改变 HSF 的行为，具体如下：

属性 描述 -Dhsf.server.port 指定 HSF 的启动服务绑定端口，默认值为 12200。 -Dhsf.serializer 指定 HSF 的序列化方式，默认值为 hessian。 -Dhsf.server.max.poolsize 指定 HSF 的服务端最大线程池大小，默认值为 720。 -Dhsf.server.min.poolsize 指定 HSF 的服务端最小线程池大小。默认值为 50。 -DHSF_SERVER_PUB_HOST 指定对外暴露的 IP，如果不配置，使用 -Dhsf.server.ip 的值。 -DHSF_SERVER_PUB_PORT 指定对外暴露的端口，该端口必须在本机被监听，并对外开放了访问授权，默认使用 -Dhsf.server.port 的配置，如果 -Dhsf.server.port 没有配置，默认使用12200。 本地查询 HSF 服务 在开发调试的过程中，如果您的服务是通过轻量级注册配置中心进行服务注册与发现，就可以通过 EDAS 控制台查询某个应用提供或调用的服务。

假设您在一台 IP 为 192.168.1.100 的机器上启动了 EDAS 配置中心。 进入 http://192.168.1.100:8080/ 在左侧菜单栏单击服务列表，输入服务名、服务组名或者 IP 地址进行搜索，查看对应的服务提供者以及服务调用者。 说明 配置中心启动之后默认选择第一块网卡地址做为服务发现的地址，如果开发者所在的机器有多块网卡的情况，可设置启动脚本中的 SERVER_IP 变量进行显式的地址绑定。 常见查询案例

提供者列表页 在搜索框中输入 IP 地址，单击搜索，即可查询该 IP 地址的物理机所提供的服务。 在搜索框中输入服务名或服务分组，即可查询提供该服务的 IP 地址。 调用者列表页 在搜索框中输入 IP 地址，单击搜索，即可查询该 IP 地址的物理机所调用的服务。 在搜索框中输入服务名或服务分组，即可查询调用该服务的 IP 地址。 部署到 SAE 本地使用轻量级配置及注册中心的应用可以直接部署到 SAE 中，无需做任何修改，注册中心会被自动替换为 SAE 上的注册中心。

正常打包出可供 EDAS-Container 运行的 WAR 包，需要添加如下的 Maven 打包插件

在 pom.xml 文件中添加以下打包插件的配置。 itemcenter org.apache.maven.plugins maven-compiler-plugin 3.1 执行 mvn clean package 将本地的程序打成 WAR 包。 应用运行时环境需要选择 EDAS-Container。

具体部署操作请参见应用部署概述。

了解以下：使用 Ali-Tomcat 开发应用