开发者门户应用开发规范.PDFVIP

开发者门户 应用开发规范 当前版本： V1.0 神州数码 目 录 第一章 现状 3 第二章 规约 3 2.1 应用/服务参数规范 3 2.2 应用/服务格式规范 3 2.3 应用/服务功能规范 3 2.4 不支持的组件服务 3 第三章 应用开发4 3.1 功能概述 4 3.2 接口说明 4 3.3 开发步骤 4 3.4 示例 4 2 / 6 神州数码 第一章 现状 目前PAAS 平台采用jetty-8.1.9/OSGi 为应用/服务承载容器。采用PAAS 提供容器、配置以及各种优化策略，用户 提供应用war 包(bundle)的方式进行应用集成。 第二章 规约 基于以上约定以及PAAS 平台现能提供的服务有以下规约。 2.1 应用/服务参数规范 用户提供war (bundle)包，并且在相应 jetty-8.1.9/OSGi 下测试通过后提供。提供war 包时提供应用从启动到能提供 http 服务所需要的时间，以便PAAS 定制启动超时时间。提供war 包运行所需要的最小参数，否则默认以 100M 为最大 堆进行应用容器启动。对于特殊的应用，也希望能提供部署参考时间，cpu 占用率参考值，以便PAAS 平台提供更适合 应用的环境，以达到应用最大效率。 部署参考时间 启动参考时间 内存堆最小值，最大值 最大cpu 占用率参考值 2.2 应用/服务格式规范 由于war 包在jetty 容器采用javaunzip 方式进行解压缩，默认是采用utf-8 的方式进行解码，而windows 下开发服 务包文件名称多以GBK 或GB1830 进行编码，当文件名称为中文时，便会出现war 包解压缩失败。文件名为中文包括： 中文名命名或英文名+ “副本”、“备份”等备份文件。 应用中路径需要用request.getContextPath ()/……的方式表示，不能用./(../)……方式表示。原因是router 上无法 针对每个应用单独设置contextpath，后一种表示方式在调用时router 无法取到appid，导致调用失败。 2.3 应用/服务功能规范 应用不提供非http 服务。不允许在应用内私自启动监听服务端口，此类私开端口既无法提供服务，又造成PAAS 端 口管理问题。有私开端口将强制停止应用的风险。 尽量减少在接收到容器stop 命令后进行业务善后操作。由于paas 对应用关闭时间有严格限制，部分在接收到容器 stop 命令后做善后业务操作超过关闭时间，PAAS 平台将以终止进程的方式进行强制关闭。 禁止在应用内通过runtime.exec 方式进行脚本调用。应用将以限制身份运行，无法执行这些命令。 禁止在应用内使用jni 服务。 2.4 不支持的组件服务 目前数据库无法支持jndi 方式，需要进行连接池直接配置否则无法进行加载。 3 / 6 神州数码 第三章 应用开发 3.1 功能概述