准备工作
- Maven3
- Jdk7
- SqlServer 2008
- IntelliJ IDEA(建议)
- Git 客户端、git.oschina.net 账号
Git 客户端 Windows 下建议 TortoiseGit,Mac 下建议 SourceTree。
快速开始
- 创建数据库 ssme,并执行 resources 下的 schema.sql 和 其它 sql 文件。
- 先要在根目录下 mvn install
- 在 web module 目录下 mvn tomcat7:run
所有 core 的修改都需要在相应的 module 根目录下 mvn install,否则 web module 不可见。
开发步骤
- 在数据库中建表,然后在 schema.sql 中保存 sql 脚本。
- 修改 generatorConfig.xml 中的 tableName="user" 为实际的表名。
- 在 core module 目录运行 mvn mybatis-generator:generate 根据表名生成 domain、mapper.xml、DAO interface。
- 在 ipsp-codegen 下边可以运行 Generator 类生成 service、controller 类。
在运行之前确保代码已经在 git 版本控制中,否则同名文件会被覆盖。
mapper.xml 中的 @mbggenerated 不能删除。
数据库规范
- 数据库表名使用“_”分隔。
- 数据库字段名使用驼峰全名。
- 字段都标明 comment,生成的 domain 类会根据 comment 自动生成注释。
- 可以为空的字段都要加 default 值。
- 自动生成的代码注解 @mbggenerated 不要删除。
开发规范
- 不可以用 REST URL 做为参数传递的常规手段,而是用来表达语义。
- 不可以在 Controller 中调用多个 Service 非只读事务(造成事务失效)。
默认 Mapper 的说明
实现了默认的 10 多个方法,具体见 BaseService 类注释。
单表操作用基类的方法,大部分场景不需要写 Sql,条件多的可以结合 Example 类实现。
相关技术
- Spring4
- Mybatis3 + MBG(代码生成)
- Shiro
- Druid
- Freemarker (no jsp)
- Fastjson
- logback + slf4j
- JQuery + Bootstrap
- RequireJS