infotalk S04-插件开发指南.doc

目录 1 文档概述 1 2 扩展插件简介 2 2.1 扩展插件的特点 2 2.2 术语及定义 2 2.3 常见问题 2 3 快速开始 5 3.2 开始一个简单的应用 5 4 扩展插件开发指南 12 4.1 第一课：扩展插件开发基础 12 4.2 第二课：替换Infotalk文件 22 4.3 第三课：自定义模块 24 4.4 第四课：自定义资源树右键菜单 34 4.5 第五课：自定义任务面板 47 4.6 第六课：新增系统选项 57 4.7 第七课：如何修改Infotalk JS文件的方法 61 4.8 第八课：服务端Java接口调用 62 4.9 第九课：高级应用 64 5 扩展点 94 5.1 服务端 94 5.2 客户端 96 6 示例集 100 6.1 新增资源类型 100 6.2 灵活分析QueryView对象的扩展 103 6.3 数据集定义BusinessView对象扩展 105 6.4 数据集定义中新增SQL表达式校验控制 106 6.5 用户密码合法性判断的添加 106 文档概述 使用下表快速访问。 请参见 扩展插件简介 简单介绍扩展插件的特点及常见问题。 快速开始 让读者尽快掌握扩展插件开发的基本步骤。 扩展插件开发指南 通过一些课程来指导如何开发扩展插件。 扩展点 介绍产品中已提供的扩展点，供扩展开发参考。 示例集 给读者提供常用的扩展开发示例。 文档目的 随着客户对BI前端功能的要求越来越深入，Infotalk的很多应用项目都有定制化需求。为满足这类需求，产品进一步增强“稳定内核+API扩展”的架构，支持插件扩展。每个项目的定制化的需求都可以做成单独的插件，这样，最大限度地控制项目化的需求对产品的影响，控制不同项目之间相互影响，项目需求响应的及时性也能得到保证。 适用范围 本文面向Infotalk定制开发人员以及研发人员。  扩展插件简介 扩展插件从应用角度上看，它是一个可以加载到Infotalk中执行的功能插件；从技术角度上看，它是一个web项目，包含Html、Jsp、Java、Js和资源等文件。 扩展插件的特点 扩展插件通过Infotalk加载执行。 扩展插件中的文件会覆盖Infotalk相同路径下的同名文件。 扩展插件可以调用Infotalk的内部对象。 扩展插件可以通过扩展点对Infotalk进行定制开发，能够把新功能无缝集成到系统中。 术语及定义 术语 定义 扩展点 为了能够在不改动Infotalk代码的情况下，让新开发的插件无缝集成到系统中，Infotalk系统框架提供了大量的功能插入接口，这些接口即称之为“扩展点”。 一级模块 “审核”、“浏览”、“定制”、“管理”、“仪表盘”、“个人设置”、“帮助”等功能模块入口。 二级模块 一级模块的子模块入口。 任务面板 Infotalk模块主界面中大图标展现的快捷功能操作入口区。 资源树 以树的方式展现Infotalk资源。 知识库 用于存储Infotalk系统资源信息的数据库我们称之为知识库。 知识库对象 使用Hibernate运行机制，知识库表映射到一个POJO实体类，该实体类指知识库对象。 知识库升级 Infotalk使用升级类代码对知识库版本进行维护，当扩展插件中需要修改知识库对象时就必须添加相应的升级类进行知识库版本的维护。 Java查询 指基于Java数据源中Java查询对象作为查询源的一种业务查询。 常见问题 为什么要使用扩展插件？ 从项目角度上看把项目定制化的需求做成扩展插件，这样能够最大限度地控制项目化的需求对产品的影响，控制不同项目之间相互影响，项目需求响应的及时性也能得到保证。 从产品开发角度上看把产品新功能模块的开发做成扩展插件，这样可以有效避免新功能开发对产品的影响，从而最大限度的保证产品的质量。 如何在Infotalk中加载扩展插件？ 项目定制化的需求开发的扩展插件启动Infotalk服务器，访问http://ip:host/infotalk/config。在config界面上，指定扩展插件的路径，如“C: /infotalkExtension/src/web/”，保存配置。 研发内部开发的新功能扩展插件：修改infotalk.war/WEB-INF/extensions/extensions.list文件，每一行为一个扩展插件路径的声明。声明加载指定目录的扩展插件如：“..\ExtensionManager.SandBox\src\web\”。 Infotalk是否可以同时加载多个扩展插件？ Infotalk里面允许同时加载多个扩展插件。把多个插件放到同一个目录中，然后通过config配置界面把扩展插件路径指向该目录，或者在extensions.list文件中添加多个扩