用idea写一个简单的Java Web应用

前提技能：

使用IDEA搭建并发开Java项目；

使用Maven自动化构建Java项目；

使用Git管理项目源代码。

1.1使用IDEA创建Maven项目

1）单击 New Project

2）选择Maven

3）输入groupId，ArtifactId，Version，单击Next

4）输入Project name，Project loaction 单击Finish按钮

此时IDEA就创建了一个基于Maven的目录结构。

1.2调整Maven配置

<?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</version>


</project>

此时pom.xml的基本配置如上，下面需要为它添加一些常用配置

首先，需要统一源代码的编码方式，否则使用Maven编译源代码的时候就会出现相关警告。一般情况下，我们都适用UTF-8进行编码，需要添加配置如下：

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

除了需要统一源代码编码方式以外，还需要统一源代码与编译输出的JDK版本。

    <build>
        <plugins>
            <!--Compile -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.3</version>
                <configuration>
                    <source>1.6</source>
                    <target>1.6</target>
                </configuration>
            </plugin>
        </plugins>
    </build>

一下配置不是必须的，如果在使用Maven打包时想跳过单元测试，可以添加如下插件：

            <!--Test -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
                <version>2.18.1</version>
                <configuration>
                    <skipTests>true</skipTests>
                </configuration>
            </plugin>

至此，一个Maven项目就搭建完毕了。

1.2.1转为Java Web项目

目前，在pom.xml中还没有任何的Maven依赖(dependency)，随后会添加一些Java Web所需的依赖，只不过在添加这些依赖之前，有必要先将这个Maven项目调整为Web项目结构。

PS:可以简单的将Maven依赖理解为jar包，只不过Maven依赖具备传递性，只需配置某个依赖，就能自动获取该依赖的相关配置。

只需按照以下三步即可实现：

1）在main目录下，添加webapp目录

2）在webapp目录下，添加WEB-INF目录

3）在WEB-INF目录下，添加web.xml文件

此时，IDEA给出一个提示，表示IDEA已经识别出目前我们使用了Web框架(即Servlet框架)，需要进行一些配置才能使用。单机Configure按钮，会看到一个确认框，单机ok按钮可将当前项目变为Web项目。

这里打算使用Servlet3.0框架，所以在web.xml中添加如下代码：

<?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>

实际上，使用Servlet3.0框架是可以省略web.xml文件的，因为Servlet无须在web.xml里配置，只需通过Java注解来配置即可，下面会描述具体的用法。

1.2.2添加Java Web的Maven依赖

由于Web项目是需要打war包的，因此必须在pom.xml文件里设置packaging为war（默认为jar），配置如下：

<packaging>war</packaging>

接下来就需要添加Java Web所需的Servlet，JSP，JSTL等依赖了。

    <dependencies>
        <!-- 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>
    </dependencies>

需要说明的是：

1）Maven依赖的三坐标(groupId,artifactId,version)必须提供。

2）如果某些依赖只需参与编译，而无需参与打包，（例如Tomcat自带了Servlet与JSP所对应的jar包），可将其scope设置为provided。

3）如果某些依赖只是运行时需要，但无需参与编译（例如，JSTL的jar包），可将其scope设置为runtime。

现在一个基于Maven的Jave Web项目已搭建完毕，随后可进入具体的开发阶段。

1.3编写一个简单的Web应用

1.3.1编写Servlet类

我们写一个HelloServlet类，接收Get类型的/hello请求，转发到/WEB-INF/jsp/hello.jsp页面，在hello.jsp页面上显示系统当前时间。

@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");
        String currentTime = dateFormat.format(new Date());
        req.setAttribute("currentTime",currentTime);
        req.getRequestDispatcher("/WEB-INF/jsp/hello.jsp").forward(req,resp);
    }
}

对以上代码进行一些说明：

1）继承HttpServlet，让它成为一个Servlet类

2）覆盖父类的doGet方法，用于接收GET请求。

3）在doGet方法中获取系统当前时间，并将其放入HTTPServletRequest对象中，最后转发到/WEB=INF/jsp/hellp.jsp页面。

4）使用WebServlet注解并配置请求路径，对外发布Servlet服务。

 

编写jsp页面

在webapp/WEB-INF目录下创建jsp目录，并在该目录下创建hello.jsp，代码如下：

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
<h1>Hello!</h1>

<h2>当前时间:${currentTime}</h2>

</body>
</html>

我们使用了JSTL表达式来获取从HelloServlet里传递过来的currentTime请求属性。

下面，我们让这个Web应用跑起来。

1.4让Web应用跑起来

1.4.1在IDEA中配置Tomcat

1.单机Run ->Edit Confiturations

2.单机左上角的“+”按钮，选择Tomcat Server ->Local选项

3.输入Tomcat的Name(例如：tomcat)，取消勾选After Launch选项

4.单机Application server下拉框右侧的Configure...按钮，配置一个Tomcat，配置完成后，在下拉框中选择该Tomcat

5.切换到Deployment选项卡，单击右边的"+"按钮，选择"Artifact"选项，弹出Select Artifact to Deploy对话框

6.选择chapter1:war exploded,单机ok按钮

7.回到Run/Debug Configurations对话框，在Application context中输入/chapter1

8.切换回Server选项卡，在On frame deactivation下拉框中选择"Update resources"选项，单击ok按钮，完成所有配置。

然后，单机IDEA工具栏上的“Run”或“Debug”按钮，启动Tomcat并部署Web应用。

最后，打开浏览器，输入以下地址：http://localhost:8080/chapter1/hello