Java全棧程式設計師之07：IDEA中使用MAVEN構架生產級的Web專案

Maven Servlet 程式設計師 · 發表 2019-02-25 17:02:00

摘要：在上一篇我們介紹瞭如何在IDEA中使用MAVEN，以及如何建立依賴等。那麼在這一篇中，我們就試圖搭建一個生產級的解決方案，大家可以使用這個解決方案作為骨架程式碼來搭建自己的開發環境。在這裡，我們要完成：建立parent，在parent裡完成所有的pom依賴和定義；建立comm...

在上一篇我們介紹瞭如何在IDEA中使用MAVEN，以及如何建立依賴等。那麼在這一篇中，我們就試圖搭建一個生產級的解決方案，大家可以使用這個解決方案作為骨架程式碼來搭建自己的開發環境。

在這裡，我們要完成：

建立parent，在parent裡完成所有的pom依賴和定義；

建立common專案，common作為工具包而存在，被其它module所依賴；

建立dao，依賴common；

建立service，依賴dao和common；

建立web，依賴service和dao；

下面開始具體的建立過程。

1.建立Parent

所謂parent就是父工程，在這個父工程裡我們需要管理所有的子Module，所以我們將其當成是一個解決方案（solution）而存在。

首先，新建project，選擇maven。注意下圖，不要選擇archetype，

下一步，分別定義groupid，artifactid和version，

預設next，

Finish之後，來到下面的介面，

2.配置Parent依賴

開啟pom檔案，讓我們輸入，

<?xml version="1.0" encoding="UTF-8"?>
<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/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>

<groupId>com.zuikc</groupId>
<artifactId>zuikc-sln</artifactId>
<packaging>pom</packaging>
<version>1.0.1</version>
<modules>
<module>zuikc-common</module>
<module>zuikc-dao</module>
<module>zuikc-service</module>
<module>zuikc-web</module>
</modules>

<!-- 設定版本號 -->
<properties>
<java-version>1.10</java-version>
<javax.servlet-version>3.1.0</javax.servlet-version>
<javax.servlet-jsp-version>2.2.1</javax.servlet-jsp-version>
<jstl-version>1.2</jstl-version>
<taglibs-version>1.1.2</taglibs-version>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<!-- 統一依賴管理 -->
<dependencyManagement>
<dependencies>

<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>${javax.servlet-version}</version>
<scope>provided</scope>
</dependency>

<dependency>
<groupId>javax.servlet.jsp</groupId>
<artifactId>javax.servlet.jsp-api</artifactId>
<version>${javax.servlet-jsp-version}</version>
<scope>provided</scope>
</dependency>

<dependency>
<groupId>javax.servlet</groupId>
<artifactId>jstl</artifactId>
<version>${jstl-version}</version>
</dependency>
<dependency>
<groupId>taglibs</groupId>
<artifactId>standard</artifactId>
<version>${taglibs-version}</version>
</dependency>
</dependencies>
</dependencyManagement>

<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<source>${java-version}</source>
<target>${java-version}</target>
<encoding>UTF-8</encoding>
</configuration>
</plugin>
</plugins>
<pluginManagement>
<plugins>
<!-- 配置Tomcat外掛 -->
<plugin>
<groupId>org.apache.tomcat.maven</groupId>
<artifactId>tomcat7-maven-plugin</artifactId>
<version>2.2</version>
</plugin>
</plugins>
</pluginManagement>
</build>

</project>

注意，這部分內容，

實際是不需要我們輸入的，隨著我們子module的建立，idea會自動為我們生成。

下面這部分內容是定義了一些屬性。由於idea預設的servlet模組是2.3的，所以需要讓我們手動定義成3.1，否則我們就使用不了servlet的註解。其次，我索性將jstl也一併引入進來。

以下這部分內容才是真正的依賴管理，

下面是定義了兩個外掛。第一個是java的編譯版本。第二個是使用tomcat外掛來執行我們即將要建立的web專案。

經過上面的設定，parent部分就大功告成了。

3.建立common

Common是工具包。

在parent上右鍵來建立子模組。如下：

注意，由於是普通jar包，所以也不要選archetype，

Next，

Finish。

建立完成後長下面這樣。

4.建立dao與service

用跟建立common一樣的方法來建立dao和service，最終結果如下：

5.建立web

接著讓我們來建立web。

這次我們要選擇“create from archetype”，如下圖選擇webapp，

Next，

Finish，

這個時候，我們發現idea的控制檯中有下圖的generating，這個時候要等幾分鐘，才能將我們的web專案初始化，

當generating完畢，web專案就會被初始化為一些預設的資料夾和檔案在裡面。當前的專案我們暫時不需要spring和日誌，所以就可以將applicaitonContext.xml和log4j.xm刪除。

6.Web的配置

接著修改web.xml，使其支援servlet3，如下，

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
version="3.1" metadata-complete="false">

</web-app>

Maven預設的webapp模版沒有建立java資料夾，讓我們手動建立。手動建立完畢，發現不能在java資料夾上建立servlet，這個時候就要完成兩件事情了。

第一件事情，要將java資料夾標註為：sources root，

第二件事情要配置web的pom檔案，加入對servlet3模版的支援，如下：

<?xml version="1.0" encoding="UTF-8"?>

<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">
<parent>
<artifactId>zuikc-sln</artifactId>
<groupId>com.zuikc</groupId>
<version>1.0.1</version>
</parent>

<modelVersion>4.0.0</modelVersion>
<packaging>war</packaging>

<name>zuikc-web</name>
<artifactId>zuikc-web</artifactId>


<dependencies>

<dependency>
<groupId>com.zuikc</groupId>
<artifactId>zuikc-dao</artifactId>
<version>1.0.1</version>
<scope>compile</scope>
</dependency>

<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<scope>provided</scope>
</dependency>

<dependency>
<groupId>javax.servlet.jsp</groupId>
<artifactId>javax.servlet.jsp-api</artifactId>
<scope>provided</scope>
</dependency>

<dependency>
<groupId>javax.servlet</groupId>
<artifactId>jstl</artifactId>
</dependency>
<dependency>
<groupId>taglibs</groupId>
<artifactId>standard</artifactId>
</dependency>
</dependencies>

<build>
<plugins>
<plugin>
<groupId>org.apache.tomcat.maven</groupId>
<artifactId>tomcat7-maven-plugin</artifactId>
<configuration>
<port>7070</port>
<path>/</path>
</configuration>
</plugin>
</plugins>
</build>


</project>

在這個pom檔案中，一是完成了servlet3的支援，而是讓專案引入引入tomcat的外掛，並指定專案在7070埠上啟動。

這個時候，還是發現不能在java上建立servlet，沒事，只要使用maven的reimport重新整理一下就行了，如下：

這個時候，就可以在java上建立servlet了，

Next，

最後ok，可以看到，

讓我們修改servlet，

package com.zuikc.servlets;

import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

@WebServlet(name = "Servlet1", urlPatterns = "/servlet1")
public class Servlet1 extends javax.servlet.http.HttpServlet {
protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {

}

protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
//通知瀏覽器瀏覽器用utf8來解析返回的資料
response.setHeader("Content-type", "text/html;charset=UTF-8");
//使用UTF-8轉碼
response.setCharacterEncoding("UTF-8");
response.getWriter().append("碼農星球最課程，IT培訓新選擇！");
}
}