Burst使用手册.doc

Burst使用手册1.0版 更新日期2011-11-23 更新人thegod   Burst使用手册1.0版 1 1 Burst简介 3 2 Burst资源下载 3 3如何使用Burst开发项目 3 4 Burst包说明 4 5 TblDesigner工具使用说明 4 6 重要API介绍 6 6.1 如何创建和删除数据库表 6 6.2 如何创建数据 6 6.3 如何读取数据 7 6.4 如何修改数据 7 6.5 如何删除数据 8 6.6 如何执行检索 8 7 数据库的配置 9 1 Burst简介 Burst是个人开发的轻量级数据库开发框架，可对应Oracle,Db2,Sql server, Mysql四种数据库，使用Java语言开发，特点是使用非常方便，不需要复杂的配置和定义 Burst由两部分组成，一部分是Eclipse的项目文件，一部分是TblDesigner.xls工具。 这个Excel文件用来设计表结构，以及用宏自动创建Java类 Burst覆盖了数据库开发的常用功能，如数据库连接池、CRUD、多表联合检索、分页检索等，但是跟主流框架相比，功能还比较简单。 2 Burst资源下载 /p/burst/downloads/list 3如何使用Burst开发项目 首先需要下载Burst.rar，解压到Eclipse工作区。这是一个java项目文件，在Eclipse中导入该项目。 需要下载TblDesigner.xls工具，按自身项目需求，设计数据库表结构。 设计完毕后，运行宏，会在该excel文件处生成tbl和def两个目录，里面有Java类文件。 将tbl和def目录复制到项目文件相应目录 配置properties目录下的perties文件，设定好数据库参数 参照functionTest包下的测试1，创建数据库表 参照functionTest的其他测试，编写业务逻辑的Java文件 4 Burst包说明 1 config包，用于读取配置文件 2 conn包，用于管理数据库连接池和连接 3 def包，存放由TblDesigner生成的表定义类 4 init包，在服务启动时调用，初始化项目环境 5 query包， 存放检索相关的类 6 tbl包， 存放由TblDesigner生成的表的模型类 7 tbl.base包，存放表的模型的基类。以及对表进行操作的服务类 8 functionTest包，存放一些测试过程，可用于开发参考 9 其他 5 TblDesigner工具使用说明 下载的excel文件有5个sheet，如下 1，最重要的是List页，用来定义要生成那些表，如下 Package是预设创建类所在的包 2，DropList这个sheet定义了一些下拉列表，请不要删除 3，Example1 ,2,3是具体的表的定义 比如Example1 Example2 4，定义好后，运行宏。会创建tbl和def目录，如下 6 重要API介绍 6.1 如何创建和删除数据库表 参照test1，需要调用如下方法 //启动系统，取得配置等，该操作只需要在服务器启动时执行一次 Startup.init(); //取得一个新的数据库连接，执行任何数据库操作前，都要取得 db = new DbBase(); //创建所有表、索引、序列 TblDefService.createAllTbl(db); //删除所有表 //TblDefService.dropAllTbl(db); 6.2 如何创建数据 请参照test2的createTest方法 该方法中，我们使用模型对象，设置了各种类型的字段，最后调用 TblBaseService的create方法，即可创建数据 6.3 如何读取数据 请参照test2的readTest方法 在该方法中，我们通过一个简单的检索，取得TblStudent的第一条数据，并把它打出来 6.4 如何修改数据 请参照test2的updateTest方法 如上图，我们直接在TblStudent模型中设置更新后的值，然后设置字段是否需要更新的标志， 最后执行TblBaseService.updateById即可更新一条数据。 可直接将字段更新为null 如要更新多条数据，可执行updateByCondition方法 6.5 如何删除数据 请参照test2的deleteTest方法 如上图，可用removeById方法直接删除某条数据 也可以用removeByCondition方法根据检索条件删除数据 6.6 如何执行检索 检索的功能繁多，请参照测试的test3 – test9 7 数据库的配置 编辑perties文件 如下 #for oracle #db.type=oracle #=orcl #db.jdbc.drive