前提技能:
使用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