2017.12.12 架构探险-第一章-从一个简单的web应用开始

参考来自：《架构探险》黄勇 著

1 使用IDEA搭建MAVEN项目

1.1 搭建java项目

（1）创建java项目

为了整个书籍的项目，我创建了一个工程，在这个工程里创建了每个章节的module。创建过程见随笔《待定》。

创建完成后，项目结构如下：

ps：对maven项目而言，classpath是java和resources两个根目录。

（2）调整pom配置

• 统一源代码的编码方式
• 统一源代码和编译输出所用的JDK版本
• 打包时跳过单元测试（可选）

<?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>org.smart4j</groupId>
    <artifactId>chapter1</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <!--编码方式-->
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <build>
        <plugins>
            <!--编译-->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.3</version>
                <configuration>
                    <source>1.7</source>
                    <target>1.7</target>
                </configuration>
            </plugin>
            <!--测试-->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
                <version>2.18.1</version>
            </plugin>
        </plugins>
    </build>

</project>

 1.2 将java项目转换成web项目

（1）调整项目结构

调整后的项目结构如下：

（2）web.xml

这里使用Servlet3.0框架。其实Servlet3.0框架可以不使用web.xml，直接用注解配置即可。所以这里在后面也没有配置servlet的信息，直接在类上里加了注解@WebServlet。

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://java.sun.com/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
                           http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
         version="3.0">
       
</web-app>

（3）web项目所需要的依赖及属性配置

• Servlet
• JSP
• JSTL
• 打war包

<?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>org.smart4j</groupId>
    <artifactId>chapter1</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <!--编码方式-->
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <packaging>war</packaging>

    <build>
        <plugins>
            <!--编译-->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.3</version>
                <configuration>
                    <source>1.7</source>
                    <target>1.7</target>
                </configuration>
            </plugin>
            <!--测试-->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
                <version>2.18.1</version>
            </plugin>
        </plugins>
    </build>

    <dependencies>
        <dependency>
            <!--servlet-->
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>3.1.0</version>
            <!--provided表示只参与编译，不参与打包，因为tomcat自带了这个jar包-->
            <scope>provided</scope>
        </dependency>

        <!--jsp-->
        <dependency>
            <groupId>javax.servlet.jsp</groupId>
            <artifactId>jsp-api</artifactId>
            <version>2.2</version>
            <!--provided表示只参与编译，不参与打包，因为tomcat自带了这个jar包-->
            <scope>provided</scope>
        </dependency>

        <!--JSTL-->
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>jstl</artifactId>
            <version>1.2</version>
            <!--runtime表示只参与运行，不参与编译-->
            <scope>runtime</scope>
        </dependency>
    </dependencies>
</project>

1.3 编写简单的web应用

需求很简单：有一个HelloServlet，接收GET /hello请求，转发至WEB-INF/jsp/hello.jsp页面，在hello.jsp页面上显示系统当前时间。

（1）Servlet

package org.smart4j.chapter1;

import java.io.IOException;
import java.text.DateFormat;
import java.text.SimpleDateFormat;
import java.util.Date;

import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

@WebServlet("/hello")
public class HelloServlet extends HttpServlet{
    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp)
            throws ServletException, IOException {
        DateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss:SSS");
        String currentTime = dateFormat.format(new Date());

        req.setAttribute("currentTime",currentTime);
        req.getRequestDispatcher("/WEB-INF/jsp/hello.jsp").forward(req,resp);
    }
}

（2）JSP页面

推荐将jsp文件放在WEB-INF文件夹内部，而非外部。因为用户无法通过浏览器直接访问放在WEB-INF文件夹内部的jsp文件，必须经过Servlet转发。

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>hello</title>
</head>

<body>
    <h1>lyh</h1>
    <h2>${currentTime}</h2>
</body>
</html>

（3）项目结构

1.4 运行web应用

tomcat的配置和项目运行配置略。访问http://localhost:8080/chapter1/hello ，运行结果如下：

 

1.5 代码git提交

略。参看随笔：