limiton开发手册

《limiton开发手册》由会员分享，可在线阅读，更多相关《limiton开发手册（7页珍藏版）》请在金锄头文库上搜索。

1、limiton 开发手册(适用于 1.x.x 系列版本) http:/www.limiton.org 版权所有 www.limiton.org 严禁因商业用途抄袭本电子书的任何内容 违者必究 如有需要请联系: adminlimiton.org 1. 介绍介绍 imiton 是遵循 JavaEE 标准开发的权限管理系统，它不是山寨 struts2、spring、hibernate 等某一领域 的知名解决方案而把自己标榜为后来者，而是以这些技术为基础，专注于实现基于角色的权限管理 模型，并使自身逐步发展为 JavaEE 权限管理领域的知名解决方案。为了实现这个目标，limiton-1.X.X 系

2、列版本将持续在以下几个方面做出努力、进行完善： 易于集成，limiton 的最终发布形式和 struts2、hibernate 等一样，是一个 JAR 包，当然，limiton 所依赖的其它框架 （struts2、 spring、 freemarker 等等） 的 JAR 包会随着 limiton 的 JAR 包一起发布。 这样， JavaEE开发者如需要使用 limiton，只需将 limiton 自身及其依赖的 JAR 包放到应用程序的 WEB-INF/lib 目录下并做简单的配置即可。 内置权限管理的系统级功能，对于用户管理、角色管理、分组管理、功能点管理等实现系统权限管理所必不可少的系

3、统级功能，在 limiton 中开箱即用，所以集成了 limiton 的应用程序无需开发和维护这些功能，这必定会从某种程度上降低应用程序的开发和维护成本。 灵活、易于使用的 API 和接口，在 limiton 中权限被划分为两个维度：操作权限和数据权限，对两种权限的管理系统都提供对编程友好的 API 和接口，应用程序开发者通过调用 limiton 提供的 API 或实现特定的接口，就可以完成权限的定制和管理。 用户界面高度可定制，limiton 的表现层使用模板语言 freemarker 开发，默认的 UI 资源被打包在limiton 的发布包中，如果需要对某一功能（例如用户管理）进行定制，可

4、拷贝 limiton 发布包中/lMRoot/ui/user/*.ftl 到工程（这里指 MyEclipse 的 Web 工程）的 WebRoot/lMRoot/ui/user 目录中，然后按照需要定制界面即可。 对商业项目友好， limiton 本身采用 Apache License 2.0 许可协议进行开源， 它所依赖的其它框架我们也尽量选择同类型中对商业项目友好的。 2. 快速开始快速开始 章将创建一个名为 licrm（crm 是 Customer Relation Management 的缩写，即客户关系管理）的 JavaEE 工程，以此来演示如何将 limiton 集成到开发者自己的

5、的项目中。在开发工具的选型上 我们更倾向于使用 MyEclipse，但如果您使用的是别的开发工具，本章的示例仍旧会对您有所 帮助（除了个别的细节需要注意之外） 。 需要指出的是， limiton-1.0.X 系列版本仅在Oracle 10上进行过完整的测试， 对其它主流数据库 （mysql、 mssqlserver、sybase、db2）的支持将在后续版本中提供。 l 本 limiton 开发手册(适用于 1.x.x 系列版本) http:/www.limiton.org 版权所有 www.limiton.org 严禁因商业用途抄袭本电子书的任何内容 违者必究 如有需要请联系: adminli

6、miton.org 2.1. 下载下载 imiton 的官方网站 http:/www.limiton.org 提供 limiton 最新版本的下载，目前，limiton 是 google code 上 的 一 个 开 源 项 目 ， 所 以 也 可 以 到 下 面 给 出 的 链 接 网 址 下 载 limiton 的 最 新 版 本 ： http:/ 的版本号遵循 Apache 版本号规则，如果有兴 趣可以到 http:/apr.apache.org/versioning.html 上查看版本号命名的相关细节和约定。 2.2. limiton 产品的目录结构产品的目录结构 imiton 的产

7、品发布最终为一个压缩文件（如 limiton-1.0.0.zip） ，下载后解压缩文件可以看到如图 2-1 所示的目录结构，其中，database 目录中存放的是数据库（oracle、mysql、db2 等等）创建及数据导 入的脚本文件；dist 中存放的是 limiton 的发布 JAR 包以及其依赖的其它框架（struts2、spring、 freemarker 等等）的 JAR 包；docs 中存放 limiton 的 API 及相关文档；src 中存放 limiton 的源代码。 图 2-1 limiton 产品的目录结构 2.3. 创建创建 licrm 工程工程 2.3.1. 开始开

8、始 在 myeclipse 中新建一个名为 licrm 的 Web 工程，将图 2 中 dist 目录下的全部 jar 文件拷贝到工程中 WEB-INF/lib 中。 2.3.2.搭建数据库环境搭建数据库环境 oracle 数据库为例，limiton 的发布包中 database/oracle 目录下面存放的是 oracle 数据库环境下 limiton的数据库创建及数据导入SQL脚本， 分别命名为limiton-x.x.x.sql和limiton-data-x.x.x.sql。 在 oracle 中为 licrm 项目创建一个数据库用户（例如 licrm） ，然后用这个用户的身份登录到数据库

9、中并分 别执行这两个脚本中的内容即可（也可借助 PL/SQL Developer 工具进行导入） 。 2.3.3. 集成主流框架集成主流框架 imiton 是基于 struts2、spring 等技术开发的，它的所有内置功能也是基于这些技术实现的，因此要 集成 limiton 的项目也应该做好集成这些框架的准备。 l l 以 l limiton 开发手册(适用于 1.x.x 系列版本) http:/www.limiton.org 版权所有 www.limiton.org 严禁因商业用途抄袭本电子书的任何内容 违者必究 如有需要请联系: adminlimiton.org 2.3.3.1. 集成集

10、成 spring limiton 的某些组件以 spring beans 的形式提供，因此启用这些组件需要集成 spring，在 JavaEE 程序中 集成 spring 是非常简单的，在 web.xml 中按如下步骤进行配置即可： 首先， 配置名称为 contextConfigLocation 的 context 参数， spring 会从此参数指定的配置文件中加载 bean 定义，请参照如下形式进行配置： 图 2-2 spring context 参数配置示例 在图 2-2 的所示的配置中，是表示从类路径中加载 limiton 预置的 bean 定义文件，这些文件已经 被包含在 limit

11、on-x.x.x.jar（x.x.x 表示版本号）中，是表示从 JavaEE 应用程序的 WEB-INF/config 目录下 所有的 XML 文件中加载 spring bean 定义。 limiton 使用标准名称（limiton 内置的 spring bean 的名称均以 lM 开头）lMDatasource 来获知应用程序 所使用的数据源信息，接下来我们在 WEB-INF/config 下面创建一个 datasource.xml 并参考图 2-3 所示进行 配置，以告知 limiton 应用程序所使用的数据源信息： 图 2-3 limiton 数据源配置示例 除使用 Apache DBC

12、P 的 BasicDataSource 等开源的、具备连接池功能的数据源外，还可以通过使用 spring 内置的 JndiObjectFactoryBean 来引用 JNDI 数据源， 如果您使用的是 Weblogic 等企业级应用服务器， 通过 JNDI 引用服务器的数据源可以极大地提高应用程序的性能。 2.3.3.2. 集成集成 struts2 应用程序中集成 struts2 也是很简单的，在 web.xml 中只需要配置 struts2 的过滤器及其映射模式 即可，具体配置可参考图 2-4 所示。在图 2-4 中唯一需要进一步解释的是 filter-mapping 中的 dispatch

13、er 元素，这个元素是 servlet2.4 规范中新增加的，接受四个可能的值：REQUEST、FORWARD、 INCLUDE 和 ERROR。元素中可以包含多个元素以拦截不同类型的请求，如 果没有指定任何元素，默认值是 REQUEST。 在 limiton 开发手册(适用于 1.x.x 系列版本) http:/www.limiton.org 版权所有 www.limiton.org 严禁因商业用途抄袭本电子书的任何内容 违者必究 如有需要请联系: adminlimiton.org 图 2-4 应用程序集成 struts2 时 web.xml 配置示例 Struts2 被集成到 JavaEE

14、 应用程序之后，会随着应用程序的启动自动扫描类路径中的 struts.xml 文件并 加载其中的 Action、Result 等定义。插件机制是 struts2 的一大亮点，limiton 之所以能够将自身的 web 功能 打包在 JAR 包中进行发布也是得益于 struts2 的插件机制，对 struts2 不熟悉的用户可参考其官方文档或者 其它教程，本手册不予以详述。 2.3.3.3. 集成集成 spring security imiton 的身份认证模块集成了 JavaEE 安全领域知名的技术框架 spring security，这样做是出于两个 方面的考虑： 一是本着不重复发明轮子的原

15、则， 二是 spring security 的身份认证功能已经做得极其灵 活和强大，可以很方便地集成多种认证方式。 在JavaEE应用程序中集成spring security首先要在web.xml中声明过滤器并配置它要拦截的URL样式， 如图 2-5 所示： 图 2-5 应用程序集成 spring security 时 web.xml 配置示例 DelegatingFilterProxy 是一个标准的 Filter，它的任务是将对标准的 Servlet Filter 的调用委派给 Spring 管理的 bean（当然这个 bean 的类定义需实现 Filter 接口） 。查找这个 bean 是

16、按照名称进行的，在图 2-5 中 所示的配置中这个名称就是过滤器的名称 springSecurityFilterChain， 如果在 web.xml 为这个 Filter 配置一个 名称为 targetBeanName 的初始化参数（init-param） ，那么将按照这个参数指定的值作为查找的 bean 名称， 进一步的信息可参考 DelegatingFilterProxy 的 Javadoc。 2.3.4.一切就绪一切就绪 完成 2.3.1 至 2.3.3 所述的步骤之后， 将 limiton 集成到项目的基本工作就算完成了。 在浏览器中的地址 栏中键入 http:/localhost:8080/licrm， 可以看到如图 2-6 所示的 li