快速搭建Web项目

2016-09-28 本文已影响422人许da广

开发环境准备

eclipse版本：4.3
Maven版本：3.0.4（eclipse内嵌）
JDK：Java SE 1.7
OS：Windows 10

第一步：新建一个Maven项目

“File” --> “New” --> “Maven Project ”

新建Maven项目1.png

这一步为默认设置，直接点击下一步（“Next”）

新建Maven项目2.png

在过滤其中输入web方便选择，这里选择Maven默认的webapp模版

新建Maven项目3.png

输入你的“Group Id”和“Artifact Id”，点击“Finish”完成

新建Maven项目4.png

至此，新建一个Maven项目的工作已经完成。

第二步：修改调试项目结构

上述我们新建项目的过程基本都是“Next”一路点下来的。但IDE强大如eclipse也无法做到尽善尽美，自动生成的项目结构还需要进一步微调，才能使用。

添加必要的文件目录

点击项目，右键选择“Properties”，选中“Java Build Path”，在右边的界面中选中“Source”。此时的显示结果如下图，可以看到有两个报错信息。报错的原因是项目缺少必要的文件目录。

项目的文件目录缺失.png

根据上图的错误提示信息，新增目录结构“../src/main/java”和"../src/test/java"，右键刷新项目，问题解决。

新增文件目录.png

此时项目的包结构目录如下图所示。

项目包结构目录.png

修改默认的JRE版本

从上图可以看到，此时默认的JRE版本为“J2SE-1.5”，这么底的版本肯定无法满足日常使用的需求。我们可以在“Java Build Path”页面中手工修改，但这样也有问题，每次对项目做“Maven Update”时，又会变成“J2SE-1.5”，这就很讨厌了。好在通过修改pom.xml，我们从根本上解决这类问题。
当前默认生成的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>com.eassyPassport</groupId>
    <artifactId>client1</artifactId>
    <packaging>war</packaging>
    <version>0.0.1-SNAPSHOT</version>
    <name>client1 Maven Webapp</name>
    <url>http://maven.apache.org</url>
    <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>3.8.1</version>
            <scope>test</scope>
        </dependency>
    </dependencies>
    <build>
        <finalName>client1</finalName>
    </build>
</project>

现在需要做的，就是添加“插件”

<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>com.eassyPassport</groupId>
    <artifactId>client1</artifactId>
    <packaging>war</packaging>
    <version>0.0.1-SNAPSHOT</version>
    <name>client1 Maven Webapp</name>
    <url>http://maven.apache.org</url>
    <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>3.8.1</version>
            <scope>test</scope>
        </dependency>
    </dependencies>
    <build>
        <finalName>client1</finalName>
        <plugins>
            <!-- 打包 -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-war-plugin</artifactId>
                <version>2.1.1</version>
                <configuration>
                    <warName>amms-server</warName>
                </configuration>
            </plugin>
            <!-- 资源文件 -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-resources-plugin</artifactId>
                <version>2.5</version>
                <configuration>
                    <encoding>UFT-8</encoding>
                </configuration>
            </plugin>
            <!-- 源码 -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.1</version>
                <configuration>
                    <source>1.7</source>
                    <target>1.7</target>
                    <encoding>UTF-8</encoding>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

添加完成之后，选中项目 --> 右键 --> “Maven” --> “Update Project”，此时的项目“Build Path”如下图所示

Build Path.png

修改web.xml

默认的web.xml为

<!DOCTYPE web-app PUBLIC
 "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
 "http://java.sun.com/dtd/web-app_2_3.dtd" >

<web-app>
  <display-name>Archetype Created Web Application</display-name>
</web-app>

需要将其修改为

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://java.sun.com/xml/ns/javaee"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
    id="WebApp_ID" version="2.5">
    <display-name>Archetype Created Web Application</display-name>

</web-app>

修改eclipse的“Dynamic Web Module”

如下图所示，无法通过界面修改“Dynamic Web Module”，如果要修改，需要单独修改eclipse生成的配置文件org.eclipse.wst.common.project.facet.core.xml。

修改Dynamic Web Module.png

在对应workspace下的项目目录，eclipse会针对每一个项目生成一个.settings文件加，文件org.eclipse.wst.common.project.facet.core.xml就在此目录中。打开文件，将其修改如下所示即可

<?xml version="1.0" encoding="UTF-8"?>
<faceted-project>
  <runtime name="Apache Tomcat v7.0"/>
  <fixed facet="wst.jsdt.web"/>
  <installed facet="jst.web" version="2.5"/>
  <installed facet="wst.jsdt.web" version="1.0"/>
  <installed facet="java" version="1.7"/>
</faceted-project>

打包运行

选中项目 --> “右键” --> “Run AS” --> “Maven Install”，运行完成之后，会生成target目录，其中包含打包编译后的内容。

生成war包.png

将client1.war文件拷贝至tomcat的../webapps目录下，启动tomcat。

启动tomcat.png

打开浏览器，输入http://localhost:8080/client1/显示结果如下图所示，证明已成功在eclipse中新建一个wab项目。

Hello World.png