【從零寫javaweb框架】(一)搭建開發環境

編程的第一步都是從搭建項目開始，寫框架也不例外。

第一步：創建框架項目

首先創建我們的框架的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>

至此，開發環境暫時完成了(以後需要做擴展的話還要繼續修改這裏的)。下一篇我們就開始定義框架配置項了

【從零寫javaweb框架】(二)定義和加載配置項