sql2java:一个古老但稳定的轻量级的ORM工具的使用说明

大约在2011年,我刚开始接触java开发的时候 ,接触的第一个ORM工具就是sql2java.

官网地址:https://sourceforge.net/projects/sql2java

这是一个轻量级的java code generator.可以根据你的要求,对数据库中指定的table/view生成全套的java bean 对象以及针对这张表常用数据库操作(增/删/改/查),支持事务,有了它,关于数据库操作的相关代码你基本上就不需要写了.

当时我还挺奇怪,那时已经有hibernate等一大批ORM工具了,为什么老板选择用sql2java这么个不知名的工具来生成数据库操作代码。老板是个在硅谷做过oracle高管的海归创业人人士,他给我的理由是这个工具比较轻量级,就这么一句简单的话。 事实上当时我也没什么选择权,老板让用什么就用什么呗。在没有中文说明,网上找不到教程的情况,硬头头皮仅靠看软件自带的readme.txt和注释,把这个工具玩转了,到后来随着开发的越来越深入,我对sql2java也越发了解.越发体会到老板那句评价的含义,果然是个轻量级的工具。 相比hibernate和很多其他的ORM工具,它确实太简陋了,连个命令行界面都没有,更别提GUI界面了。 对于刚入门的人来说,它确实不太友好:所有的配置都需要手工修改一个properties文件,要是不小心改错了,它可能就抛出一堆异常。 而且它一次查询只能对单表操作,不能支持复杂的跨表查询(join,union)。 但缺点往往可以变成优点: 这个工具很小,生成代码的人机界面是一个ant脚本(build.xm),执行脚本,就自动生成所有的数据库相关代码并编译,特别适合ant自动化脚本编译。 框架搭得很好,java核心代码很少,控制代码生成的主要是velocity模板,熟悉velocity后完全可以根据自己的需要自由定制模板,增加/修改生成数据库操作代码。入门可能麻烦点,但它给了开发者一个更自由更广阔施展空间,你完全可以做出一个定制化的ORM工具。 就算它不支持跨表查询,你也可以自己修改模板定制一个。

但是

闪开!我要说但是啦! 但是这个开源工具早已经不再维护了,最后一个release版本是08年的。可以说它已经死了,真正的老古董了。 如果还有兴趣了解它,那我很佩服你。

虽然它已经不再更新了,但就最后一个release版本而言,也已经很稳定了,并且已经支持不少数据库(oracle,mysql,db2,mssql,hsql,derby,postgresql),对我而言主要是用mysql,oracle,drby,足够用了,加上它生成的代码很稳定也很漂亮。用久了,熟悉了,更是放不下。

the lastest release version:sql2java-2-6-7.zip

DEMO

关于它的基本入门,我还是不多写了,从上面的下载zip包解压到本地,打开doc/index.html,你能看一个非常简单的入门说明,仔细看看这个说明,你就能跑通它的一个demo。

软件运行环境要求 java (1.6以上) apache ant (我是用1.8以上的版本)

如何安装java和ant不是本文的讨论范围

入门

配置sql2java.properties

如果你已经跑通了sql2java提供的demo,那么你肯定已经急切的想用sql2java为自己的数据库表生成java代码了。 这个吧,也不难,关于生成java代码的所有参数都定义在src/config/sql2java.properties文件中,只要搞懂了主要的几个参数,就算OK了。 这也是本文的主要目的:介绍sql2java.properties中主要的参数意义。

请打开src/config/sql2java.properties文件,下面从上到下挑几个主要的参数逐一说明

那么其他参数呢?不用了解么? 等你能正常生成自己的代码后,你自然有兴趣看sql2java.properties文件中的英文注释,其实那些英文描述得很清楚,仔细看了自然都明白了。 进一步如果你完全熟悉了它的结构,你可以自己改模板,生成自己需要的方法和类

part1:配置数据库访问

打开sql2java.properties文件,你首先看到的就是下面这部分(line 8-79)

(1/8) CONFIGURE YOUR DATABASE ACCESS

顾名思义,这开始70多行都是用配置数据库访问参数的,表被这70行代码吓住,仔细看,是分别针对7种数据库定义的数据库连接。 第一个是默认的hsql数据库,其他6种(oracle,mysql….)数据库的参数都是#注释的。 所以在这部分,你要先注释掉hsql部分参数,然后根据自己的数据库类型,打开对应的注释。

比如我用oracle,所以我对oracle部分做如下修改

# you need to provide the classes12.jar
jdbc.type=oracle
# 我用ojdbc.jar连接oracle,这里填jdbc driver 的class name
# 要把ojdbc.jar复制到sql2java/lib目录下
jdbc.driver=oracle.jdbc.OracleDriver
# 数据库连接字符串
jdbc.url=jdbc:oracle:thin:@10.110.206.152:1521:educacio
jdbc.username=e13_poe
jdbc.password=313p03
# 是否打开,根据实际情况设置
#jdbc.schema=E13_POE
#retrieving remarks on oracle is very long ... do you need it right now ?
jdbc.oracle.retrieve.remarks=false

part2:配置自增长键

如果你的表中用到了自增长键,就要配置第二部分(line 80-155)

(2/8) CONFIGURE RETRIEVAL OF AUTO GENERATED KEY

关于自增长键是怎么回事儿,不是本文说明的范围,请自行脑补。 这部分也是对应了不同类型的数据库有不同的参数,默认是hsql.如果你有自增长键,就关掉hsql,打开对应数据库的部分注释。

part3:生成代码

第三部分是关于生成代码的控制参数(line 158-188)

(3/8) GENERATED SOURCE CODE

这部分有两个重要的参数需要说明:

codewriter.package 生成java代码的包名,这个你肯定希望改成自己的package,而不是使用默认值。

codewriter.destdir 默认就是src,可以不改,这个src是指 sql2jav2/src文件夹

其他参数入门阶段统统不要改

part4:选择table/view和模板

第四部分还是关于代码的进一步控制参数(line 190-230)

(4/8) FILTER OUT CERTAIN TABLES

jdbc.tabletypes 是指要对哪些类型的对象生成代码,默认是table,view,可以不修改。如果你不希望对view(视图)生成代码,就只填talbe jdbc.tablenamepattern 可以定义一个过滤器,根据名称来选择要生成代码的表,比如你的数据库中有 a_user,b_user,b_profile,三张表,你只需要对b_开头的表生成代码,那么就填 b_%,%在这里代表通配符。默认值%,就是指所有的表。

tables.includetables.exclude同样也是起过滤器的作用,可以在这里用空格分隔指定要包含的表或要排除的表。

template.folder 开头的两个参数用来控制生成代码的模板类别(appfuse ibatis java java5 cache spdao factory db web),这些类别分别代表什么含义,这部分在properties中有比较详细的说明。别的先不用管,你只需要知道java和java5是用来生成java代码的。java5是指java1.5以上版本。这部分我只需要用到java5. 所以我是这样写的

template.folder.exclude=
template.folder.include=java5

part5:package配置

在第五部分是进一步配置不同的表生成的代码的包名 (line 232-246)

(5/8) ORGANISE YOUR SUBPACKAGES

这部分你可以完全删除,不配置,那么,所有生成的代码都会在part3 codewriter.package指定的包名下。如果你希望不同的table在不同的子包名下面,还以 b_user,b_profile两张表举例,可以如下配置:

subpackage.1.name=user
subpackage.1.tables=b_user

subpackage.2.name=profile
subpackage.2.tables=b_profile

假设codewriter.package设置为my.package,那么b_user表生成的代码就会在 my.package.user下,同理b_profile的代码在my.package.profile

part6

这部分可以略过,因为我从也从来没有用过。。。

part7

可以使用默认值,不必修改

part8

可以使用默认值,不必修改

总结

好了所有的重要参数都介绍完了,仔细想想,刚开始要填的参数也没几个嘛

1.数据库连接部分,这是必填的。 2.如果没有用到自增长键,自增长键这部分可以略过,(如果你还不知道怎么填自增长键部分,可以先用一张没有自增长键的表来尝试,把这部分先跳过,循序渐进)

如果其他都不填,你已经可以开始代码了。 我觉得你可以开始试试了。

配置好sql2java.properties后, 生成代码很简单,命令行下执行ant脚本:

d:\sql2java> ant compile 

就开始连接数据库、生成代码、编译出class,最后生成的java代码在sql2java/src/java下面。

打开生成的代码,你会发现对应每张表都生成了每张表对应的<TableName>Manager类,提供了完整的数据库操作方法(增/删/改/查),调用这些方法,你不需要写任何SQL语句。 如下图:

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏Kubernetes

深入分析Kubelet Bootstrap Checkpoint

Kubelet Bootstrap Checkpoint是kubelet对特定的Pods的进行备份、恢复的kubelet内置模块。

1194
来自专栏IT笔记

前后端分离之SpringBoot项目Token认证

写在开始 有人说,爱上一座城,是因为城中住着某个喜欢的人。其实不然,爱上一座城,也许是为城里的一道生动风景,为一段青梅往事,为一座熟悉老宅。或许,仅仅为的只是这...

4079
来自专栏大魏分享(微信公众号:david-share)

Java学习笔记第一篇:坦克大战游戏

一、Java学习笔记系列 笔者大学时候学的编程语言是C和汇编,毕业以后并未从事过开发工作,也没有接触过Java。但近两年的PaaS、CI/CD主要是以Java应...

3295
来自专栏张镇圳的专栏

一个只有99行代码的JS流程框架 (一)

最近一直在想一个问题,如何能让 js 代码写起来更语义化和更具有可读性。

7.1K8
来自专栏猿天地

微信中页面二次分享小图标丢失问题

在我们有房APP1.1的版本中增加了房产资讯的功能,昨天晚上有同事在群里反馈从APP中分享的资讯到微信中,然后再次分享出去的时候标题和小图标不见了,见下图:

1032
来自专栏Jerry的SAP技术分享

找出OData service出错根源的小技巧

SAP的Fiori应用是通过OData和后台交互的。在使用Fiori应用时您可能会遇到这样的错误消息:

1909
来自专栏应用案例

主题建设之主题表

亿信BI中的分析表大多数都是基于主题表而创建的。那什么是主题?什么是主题表?主题表分哪几种类型、何种场景下使用、又是如何创建的?不同类型的主题表有什么区别等等,...

2018
来自专栏Youngxj

php在线PIng接口源码

1643
来自专栏FreeBuf

Java反序列化漏洞:在受限环境中从漏洞发现到获取反向Shell

Java反序列化漏洞可以说是Java安全的一块心病,近年来更是在安全界“出尽风头”。其实说到Java反序列化的问题,早在2015年年初的在AppSecCali大...

552
来自专栏木宛城主

SharePoint 2010、2013多个域之间互信(Domain Trust)的设计与实施

在现实的业务场景中,有时为了更好的管理域用户和服务。我们往往会创建多个分散式的域,每个域的Administrator专注于维护特定域中的用户和资源,Admin...

2099

扫码关注云+社区