编程的第一步都是从搭建项目开始,写框架也不例外。
第一步:创建框架项目
首先创建我们的框架的maven项目,创建好后,修改pom.xml:
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<!-- Maven三坐标, 其中smart是我们的框架名称-->
<groupId>org.smart4j</groupId>
<artifactId>smart-framework</artifactId>
<version>1.0.0</version>
<packaging>war</packaging>
<name>smart-framework Maven Webapp</name>
<url>http://maven.apache.org</url>
<dependencies>
<!--
原书:既然是web框架,那就需要依赖Servlet/JSP/JSTL
个人理解:如果是前后端分离的架构,JSP和JSTL都可不用
-->
<!-- Servlet -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>3.1.0</version>
<scope>provided</scope>
</dependency>
<!-- JSP -->
<dependency>
<groupId>javax.servlet.jsp</groupId>
<artifactId>jsp-api</artifactId>
<version>2.2</version>
<scope>provided</scope>
</dependency>
<!-- JSTL -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>jstl</artifactId>
<version>1.2</version>
<scope>runtime</scope>
</dependency>
<!--
框架中会大量输出日志,目前最流行的日志框架是Log4j,它是日志具体实现的一种。
如果将来要使用更好的日志框架,就需要改动代码中大量用到日志的地方,为了解决
这个问题,我们可以用SLF4J作为日志接口,Log4j作为实现。添加以下实现,即可
同时引入SLF4J、Log4j这两个依赖
-->
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-log4j12</artifactId>
<version>1.7.7</version>
</dependency>
<!-- 项目使用MySQL,因此要添加MySQL的java驱动 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.33</version>
<scope>runtime</scope>
</dependency>
<!--
项目中Controller的方法是可以返回JSON的,因此需要一款JSON序列化工具,
目前功能、性能、稳定性表现良好的序列化工具是Jackson
-->
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.4.4</version>
</dependency>
<!--
项目中经常会用到一些工具类,其中:
commons-lang3用到的最多的应该就是检验字符串是否为空。
commons-collections4可以检验集合是否为空。
当然这两个依赖还有很多其他的功能
-->
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-lang3</artifactId>
<version>3.3.2</version>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-collections4</artifactId>
<version>4.0</version>
</dependency>
<!-- 对于JDBC类库,我们选择轻量级的DbUtils -->
<dependency>
<groupId>commons-dbutils</groupId>
<artifactId>commons-dbutils</artifactId>
<version>1.6</version>
</dependency>
<!-- 数据库连接池,我们选择综合能力最强的DBCP -->
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-dbcp2</artifactId>
<version>2.0.1</version>
</dependency>
</dependencies>
<build>
<finalName>smart-framework</finalName>
</build>
</project>
执行mvn install命令(原书上面没有写,我要执行此命令才可以完成第二步),用来给下面的实例项目作依赖。
第二步:创建示例项目
除了框架项目以外,我们还有必要再创建一个使用该框架的项目,把示例项目命名为demo1,它的pom.xml如下:
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>org.smart4j</groupId>
<artifactId>demo1</artifactId>
<version>1.0.0</version>
<packaging>war</packaging>
<name>demo1 Maven Webapp</name>
<url>http://maven.apache.org</url>
<dependencies>
<!-- 依赖我们的框架项目 -->
<dependency>
<groupId>org.smart4j</groupId>
<artifactId>smart-framework</artifactId>
<version>1.0.0</version>
</dependency>
</dependencies>
<build>
<finalName>demo1</finalName>
<plugins>
<!-- Tomcat -->
<plugin>
<groupId>org.apache.tomcat.maven</groupId>
<artifactId>tomcat7-maven-plugin</artifactId>
<version>2.2</version>
<configuration>
<path>/${project.artifactId}</path>
</configuration>
</plugin>
</plugins>
</build>
</project>
至此,开发环境暂时完成了(以后需要做扩展的话还要继续修改这里的)。下一篇我们就开始定义框架配置项了