本人博客:http://chen-shang.github.io
原文地址
saas 项目是一个给其他应用提供接口的项目,更偏重业务一点,主要是负责员工提交申请的信息的记录和状态的流转
使用到的工具
- 框架 -- 以 Spring 为主, Spring MVC 思想为辅
- 编程语言 -- 以 java 为主
- 项目构建工具 -- gradle
- 持久层框架 -- mybatis
- 版本控制工具 -- git
- 数据库 -- postgresql
- 脚本编程 -- shell
- IDE -- Intellij IDEA
- 容器 -- tomcat
搭建项目的前提是保证你的 jdk、gradle、git、postgresql 等都已经安装和配置完成,如下是我工具所对应的版本
chenshang@MrRobot-3:~$ java -version
java version "1.8.0_121"
Java(TM) SE Runtime Environment (build 1.8.0_121-b13)
Java HotSpot(TM) 64-Bit Server VM (build 25.121-b13, mixed mode)
chenshang@MrRobot-3:~$ git --version
git version 2.8.1
chenshang@MrRobot-3:~$ postgres --version
postgres (PostgreSQL) 9.6.2
chenshang@MrRobot-3:~$ gradle -v
------------------------------------------------------------
Gradle 3.2.1
------------------------------------------------------------
Build time: 2016-11-22 15:19:54 UTC
Revision: 83b485b914fd4f335ad0e66af9d14aad458d2cc5
Groovy: 2.4.7
Ant: Apache Ant(TM) version 1.9.6 compiled on June 29 2015
JVM: 1.8.0_121 (Oracle Corporation 25.121-b13)
OS: Mac OS X 10.12.4 x86_64
由于是一个以 spring 框架为基础的项目,我们需要先集成 spring ,然后以此为基础一点一点盖楼。
新建 Gradle Java Web 项目
首先搭建一个 gradle 的 java web项目,然后添加 spring 依赖
打开 idea 在首页选择 Create New Project
点击 Next
如上图选择 Gradle 然后在右侧的窗口中勾选 Java 和 Web。这代表我将用 Gradle 新建一个 Java Web 项目。
点击 Next,在下一页为自己的应用起一个响亮而且文雅的名字(主要是写 GroupId、ArtifactId、Version)
GroupId:组 id,可以理解为你所属的项目组或公司的名称
ArtifactId:项目 id,可以理解为你项目的名称,Artifact是手工艺品的意思,引申为作品,代表你做的项目是你的作品
点击 Next
这里上面三个复选框可以选择性的勾选,第一个是自动 import(具体不知道是做什么的),第二个是创建项目的缺省目录,勾选后就可以在新建的项目中看到你熟悉的项目目录的结构如下
chenshang@bogon:~/Learn/spring/saas$ tree -L 3 src
src
├── main
│ ├── java
│ ├── resources
│ └── webapp
│ └── index.jsp
└── test
├── java
└── resources
7 directories, 1 file
点击 Next 到下面这个页面
这里有个 Project name 让你填写工程名称,这个一般和你的项目名称也就是前面你定义的ArtifactId是相同的。其实这个 Project name 默认就是ArtifactId的名字,不用你做任何修改,只需在配置 Project Location 也就是你工程所在的目录即可,如果项目目录不存在 IEDA 会给你新建这个目录,之后你的项目目录结构和内容都应该在该目录下完成。
点击 Finish
等待 IDEA 的 Gradle 插件加载并解析完成项目后我们的 Gradle Java Web 项目就建好了。
还记得我们开始勾选了 Java 和 Web 两个选项吧,我们在 gradle.setting 文件中可以看到项目自动为我们添加了两个 gradle 插件 java 和 war。如果开始不勾选的话,这个配置文件就需要我们自己手动填写了。
建项目的方式多种多样,这里只是使用 IEDA 工具纯界面操作建立了一个简单的项目,其实最简单最理想的方式就是用工具只用点击就可以配置好项目,这样能省去繁琐的手工配置节省很多时间。
如果在第四步的时候没有勾选自动新建目录,那么新建的目录就是一个裸露的项目
chenshang@MrRobot-3:~/learn/spring/saas/src$ tree -L 3
.
└── main
└── webapp
└── index.jsp
2 directories, 1 file
这里推荐一款 Gradle 插件 gradle_templet,这是一款生成项目标准目录结构和类的插件,支持多种语言
只需要在 build.gradle 中添加下面
apply from: 'http://www.tellurianring.com/projects/gradle-plugins/gradle-templates/1.3/apply.groovy'
自己去发现其中的乐趣吧!
集成 spring
其实就是引用 spring 的 jar 包的过程
很简单在dependencies{}中添加
compile 'org.springframework:spring-webmvc:4.3.7.RELEASE'
该项目就会自动引入 spring 的依赖。至于怎么选择需要的 jar 包,这个真的就需要你去各种谷歌各种查资料了,因为第三方工具这种东西,只有你知道你才会去用,就像我搭建项目的时候我还不知道有 springboot 这种东西一些样我只能按照我以前的经验来搭建项目, 当我知道有 springboot这个工具的时候我就会发现其实集成第三方框架是多么的容易。
推荐一个搜索 jar 包的网站
http://search.maven.org/
以上项目就继承了 spring + spring MVC 了,我们写一个传统的项目来验证一下
首先在 src/java 目录中新建包,按照约定我们一般是公司域名的反写,我们这里就随便起名为 com.finhub.saas 吧
在com.finhub.saas这个包下,新建 controller/RootCtrl.class 文件
package com.finhub.saas.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.ResponseBody;
/**
* Created by chenshang on 2017/4/8.
*/
@Controller
public class RootCtrl {
@ResponseBody
@RequestMapping(value = "/hello", method = RequestMethod.GET)
public String test() {
return "Hello world";
}
}
在 web.xml 中添加 spring 的配置
- 一个是 contextConfigLocation
- 一个是 dispatcherServlet
这里直接贴出我的配置项,其实 spring 的配置组合还有很多
contextConfigLocation
classpath*:spring/applicationContext.xml
org.springframework.web.context.ContextLoaderListener
dispatcherServlet
org.springframework.web.servlet.DispatcherServlet
contextConfigLocation
classpath*:spring/dispatcherServlet.xml
1
dispatcherServlet
/
spring 的配置文件统一放在 resources 目录下的 spring 目录中,resource 这个资源文件中主要放置各种配置文件以及自定义属性等文件的集合
webapp 则主要放置于 web 项目相关的东西如 css、js、html 等
这里要新建两个文件一个叫 applicationContext.xml,从名字上也可以看出来,这个是应用上下文的配置文件,主要用来存储 spring用到的 bean 配置,如果有些配置需要从其他 xml 文件中引入,可以用 import 来实现
新建resources/applicationContext
新建resources/dispatcherServlet
启动项目
访问 http://localhost:8080/hello
集成mybtais
这下要与数据库继承了,根据你选择的数据库应用相应数据库的驱动 jar 包。这里以 postgrsq 为例子，我引入相关依赖
//=================>database jar<=============
compile 'org.mongodb:bson:3.4.2'
compile 'com.alibaba:druid:1.0.23'
compile 'org.mybatis:mybatis:3.4.2'
compile 'org.mybatis:mybatis-spring:1.3.1'
compile 'org.postgresql:postgresql:9.4.1212.jre7'
compile 'redis.clients:jedis:2.9.0'
compile 'org.springframework.data:spring-data-redis:1.8.0.RELEASE'
compile 'org.springframework:spring-orm:4.3.6.RELEASE'
//=================>json jar<=================
compile 'com.alibaba:fastjson:1.2.24'
compile 'com.fasterxml.jackson.core:jackson-databind:2.7.3'
compile 'com.fasterxml.jackson.dataformat:jackson-dataformat-xml:2.7.3'
//=================>others<===================
compile 'javax.servlet:javax.servlet-api:3.1.0'
compile 'jstl:jstl:1.2'
compile 'joda-time:joda-time:2.9.7'
compile 'org.apache.commons:commons-lang3:3.5'
新建 resources/jdbc/jdbc.properties
jdbc_driver=org.postgresql.Driver
jdbc_url=jdbc:postgresql://localhost:5432/saas
jdbc_username=postgres
jdbc_password=
新建 resources/spring-mybatis/spring-mybatis.xml
classpath:jdbc/jdbc.properties
这样 mybatis 和数据库也就集成好了
这样就可以愉快的开始写代码了
集成logback
上面已经添加好了依赖
新建 resources/logback.xml
[%d{yyyy-MM-dd'T'HH:mm:ss.SSS}] [%level] %logger:%line [%X{RID}] - %message%n%xException%n
${LOG_PATH}/${LOG_FILE}.log
${LOG_PATH}/${LOG_FILE}-%d{yyyy-MM-dd}.log.zip
30
[%d{yyyy-MM-dd'T'HH:mm:ss.SSS}] [%level] %logger:%line [%X{RID}] - %message%n%xException%n
${LOG_PATH}/${LOG_FILE}-error.log
ERROR
ACCEPT
DENY
${LOG_PATH}/${LOG_FILE}-error-%d{yyyy-MM-dd}.log.zip
30
[%d{yyyy-MM-dd'T'HH:mm:ss.SSS}] [%level] %logger:%line [%X{RID}] - %message%n%xException%n
MDC
统一的异常处理体系
over 可以愉快的玩耍了
彩蛋--敬请期待
- 后期会更新成多数据源的配置
- 还会讲解这个传统项目转战 springboot 项目
- 项目的版本控制策略
- 项目的部署控制策略