netdevgirl.eclipse创建maven javaweb项目

港控/mmm° 2022-09-23 11:53 204阅读 0赞

使用IDE版本：eclipse kepler（4.3），eclipse mars（4.5.2），maven（写文档时主要使用3.2.1，目前在切换3.3.9暂未发现问题）

tip：eclipse kepler对应jdk版本1.7，eclipse luna对应jdk版本1.8。

(csdn这个编辑器上传图片太麻烦了……从自己的知识库复制了好一会过来，发表之后图片都不见了……！抽空再完善图片吧……)

# 一 安装maven插件 #

1 eclipse安装maven插件

[http://maven.apache.org/download.cgi][http_maven.apache.org_download.cgi]  （ [http://apache.fayea.com/maven/maven-3/3.3.9/binaries/apache-maven-3.3.9-bin.tar.gz][http_apache.fayea.com_maven_maven-3_3.3.9_binaries_apache-maven-3.3.9-bin.tar.gz]  ）下载maven，解压到相应的位置。

2 window-preferences-maven，Installations

"Add"->选择解压存放的目录。

![Center][]

![Center 1][]

3 修改配置文件：

3.1 修改新的库文件存放位置

![Image 1][] ![Center 2][]

3.2 maven自带的jdk版本较低，修改默认的jdk版本。

![Center 3][]

3.3 修改eclipse中maven配置文件的引用位置

![Center 4][]

# 二 创建Java web项目 #

1 New Project-> Maven -> Maven Project，点击“下一步”

![Image 1][] ![Center 5][]

2  选择项目路径。使用默认的WorkSpace location。“Next”下一步。

![Center 6][]![Image 1][]

3  Select an Archetype选择工程类型。在Fileter中，输入webapp，选中Artifact Id为maven-archetype-webapp的项。然后“Next”下一步。

![Image 1][]![Center 7][]

4  输入Group ID、Artifact ID、Package。

Group Id中一般填写com.公司名；Artifact Id 为工程名。

Group ID：组ID，当有多个项目相互依赖时，创建在一个Group下。总项目名称。  
    Artifact ID：子项目名称。即当前项目名称，相当于不使用Maven时的ProjectName。  
    Package：默认创建一个包，也可以不写。

![Image 1][]![Center 8][]

“Finish”完成。

# 三 初始配置 #

## 1 JSP解析错误。 ##

如图：这是因为没有servlet环境。

![Image 1][]![Center 9][]

### ![Image 1][]![Center 10][]    ###

解决方法：右键工程-->Properties-->Project Facets，最面边的面板，选择Runtimes，选中tomcat服务。“Apply”应用配置。

![Image 1][]![Center 11][]

## 2 Dynamic Web Module版本不能修改的问题 ##

不难发现，默认的jdk版本和Dynamic Web Module版本不对。

2.1 修改JDK版本：java后面的版本，改为匹配的1.7，可以正常修改，没有问题。

![Image 1][]![Center 12][]

2.2 直接修改Dynamic Web Module版本，则报错，并且不能修改，如下：

![Image 1][]![Center 13][]

这是因为Maven的默认配置。该版本的Maven默认使用jdk1.5，对应的web版本是2.3。查到的解决办法有两种，这里采用了修改项目配置的方式解决：

打开pom.xml，在build的finalName下面，添加依赖

<plugins>
             <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>
                       </configuration>
             </plugin>
    </plugins>

保存后，项目会报错，提示更新maven project。

![Center 14][]![Image 1][]

修改pom.xml后，一般都需要更新maven project。即右键项目，选择Maven-->Update Project...

![Center 15][]  
![Image 1][]

**遇到问题：**如果网络比较慢，更新会很长时间，也不会停止。

**解决办法：**在网络比较通畅的地方执行该操作。或者，本地有正常运行的maven工程（即已经有maven的依赖库）这时，强制将进程结束。在

Window-->Properties-->Maven中，将offline选中。就可以通过本地库完成update操作了。

![Center 16][]![Image 1][]

tip：两种修改Maven依赖的jdk版本的方式

tip1: 在1.2中引用的配置文件settings.xml中，修改maven全局jdk。（对当前项目无效，修改以后创建的工程，则自动使用该版本的jdk。）

tip2: 修改项目pom.xml

在build-finalName下面，添加如下的plugin。

<build>
            <finalName>base</finalName>
            <plugins>
                <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>
                    </configuration>
                </plugin>
            </plugins>
        </build>

2.3 这时回到properties-project facets，修改Dynamic Web Module版本，依然会报错。

解决方法：

A 先将Dynamic Web Module的版本选为3.0，然后将其前面checkbox的勾选去掉，点击”Apply“应用配置。如下：

![Image 1][]

B 再次选中Dynamic Web Module。”Apply“应用，配置完成。这时就不会报错了。

## 3 修改web.xml的版本 ##

默认生成的web.xml版本是2.3dtd的。如下图：

![Image 1][]

修改为：

<?xml version="1.0"encoding="GBK"?>
    <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_3_0.xsd"
        id="WebApp_ID" version="3.0">
     
        <display-name>Archetype Created Web Application</display-name>
    </web-app>

### tip：关于web.xml ###

XML 元素是大小写敏感的。

XML元素出现的次序是敏感的。例如，XML头必须是文件中的第一项，DOCTYPE声明必须是第二项，而web- app元素必须是第三项。

在web-app元素内，元素的次序也很重要。下面的列表给出了所有可直接出现在web-app元素内的合法元素所必需的次序：

Ø  icon icon元素指出IDE和GUI工具用来表示Web应用的一个和两个图像文件的位置。

Ø  display-name display-name元素提供GUI工具可能会用来标记这个特定的Web应用的一个名称。

Ø  description description元素给出与此有关的说明性文本。

Ø  context-param context-param元素声明应用范围内的初始化参数。

Ø  filter 过滤器元素将一个名字与一个实现javax.servlet.Filter接口的类相关联。

Ø  filter-mapping 一旦命名了一个过滤器，就要利用filter-mapping元素把它与一个或多个servlet或JSP页面相关联。

Ø  listener servlet API的版本2.3增加了对事件监听程序的支持，事件监听程序在建立、修改和删除会话或servlet环境时得到通知。Listener元素指出事件监听程序类。

Ø  servlet 在向servlet或JSP页面制定初始化参数或定制URL时，必须首先命名servlet或JSP页面。Servlet元素就是用来完成此项任务的。

Ø  servlet-mapping 服务器一般为servlet提供一个缺省的URL：http://host/webAppPrefix/servlet/ServletName。但是，常常会更改这个URL，以便servlet可以访问初始化参数或更容易地处理相对URL。在更改缺省URL时，使用servlet-mapping元素。

Ø  session-config 如果某个会话在一定时间内未被访问，服务器可以抛弃它以节省内存。可通过使用HttpSession的setMaxInactiveInterval方法明确设置单个会话对象的超时值，或者可利用session-config元素制定缺省超时值。

Ø  mime-mapping 如果Web应用具有想到特殊的文件，希望能保证给他们分配特定的MIME类型，则mime-mapping元素提供这种保证。

Ø  welcom-file-list welcome-file-list元素指示服务器在收到引用一个目录名而不是文件名的URL时，使用哪个文件。

Ø  error-page error-page元素使得在返回特定HTTP状态代码时，或者特定类型的异常被抛出时，能够制定将要显示的页面。

Ø  taglib taglib元素对标记库描述符文件（Tag Libraryu Descriptor file）指定别名。此功能使你能够更改TLD文件的位置，而不用编辑使用这些文件的JSP页面。

Ø  resource-env-ref resource-env-ref元素声明与资源相关的一个管理对象。

Ø  resource-ref resource-ref元素声明一个资源工厂使用的外部资源。

Ø  security-constraint security-constraint元素制定应该保护的URL。它与login-config元素联合使用

Ø  login-config 用login-config元素来指定服务器应该怎样给试图访问受保护页面的用户授权。它与sercurity-constraint元素联合使用。

Ø  security-role security-role元素给出安全角色的一个列表，这些角色将出现在servlet元素内的security-role-ref元素的role-name子元素中。分别地声明角色可使高级IDE处理安全信息更为容易。

Ø  env-entry env-entry元素声明Web应用的环境项。

Ø  ejb-ref ejb-ref元素声明一个EJB的主目录的引用。

Ø  ejb-local-ref ejb-local-ref元素声明一个EJB的本地主目录的应用。

## 4 完善Maven工程目录 ##

### 4.1 标准目录和自动生成的目录结构 ###

标准的Maven工程目录结构

![Image 1][]

自动生成的目录如下图：

### ![Image 1][] ###

### 4.2 完善目录结构 ###

目标：需要的source folder；src/main/java,src/main/resources,src/test/java,src/test/resources。

我们需要创建几个java resources目录。自动生成的两个resources，如下图。

![Image 1][]

右键项目根节点，选择New-->Source Folder打开新建对话框，来创建java resources目录。也可以通过右键”Java Resources”，选择New，打开创建Source Folder对话框，手动填写project name或者通过“Browse”选择项目。

NOT：这里一定是source folder，而不是普通的folder。如果是普通Folder，在2.4.5中，也提到了怎么变成source folder。

![Image 1][]

或：

![Image 1][]

新建对话框：

分别创建src/main/java和src/test/resources。

遇到问题：<填写中>Cannot nest 'authority/src/main/java' inside 'authority/src/main/'. To enable the nesting exclude 'java/' from 'authority/src/main/'。<填写完成>The folder is already a source folder.如下两张图所示：

![Image 1][]

问题原因及解决方法：

原因：在配置文件中，认为这些已经存在，但是实际并没有创建成功。

解决方法：右键项目-->Properties -->Java Build Path，选择Source标签项。把报错的目录（missing）删掉。然后再重新上面的创建步骤。

![Image 1][]

创建完成：![Image 1][]。

### 4.3 调整目录显示顺序 ###

右键项目-->Properties-->Java Build Path，选择“Order and Export”标签。调整java resources的显示顺序。

![Image 1][]

### 4.4 更改项目使用的JDK版本 ###

右键项目-->Properties-->Java Build Path，选择“Libraries”标签。选中“JRE System Library”--“Edit”操作。使用

![Image 1][]

### 4.5 更改编译文件生成路径 ###

右键项目-->Properties-->Java Build Path，选择“Source”标签。

![Image 1][]

选中Allow output folders for source folders，双击每个srouce folder的“Output folder”，确认或者修改成：

src/main/java，src/main/resources，生成到target/classes;  
       src/test/java ，src/test/resources，生成到target/test-classes;

tip：将普通Folder变为Source Folder

右键项目-->Properties-->Java Build Path，选择“Source”标签。执行“Add Folder”操作。

![Image 1][]

在对话框中，新建Folder或者选择已有的Folder，点击“OK”，即可。

### 4.6 设置部署程序集 ###

右键项目-->Properties--> Web Deployment Assembly，这里设置的是，项目部署发布时，文件发布的位置。删除test目录的两项，因为test目录里的东西，不需要部署发布。

部署程序集配置应该是：

![Image 1][]

## 小结 ##

我们的项目中，一般常用的目录结构：

![Center 17][]![Image 1][]

maven的整体目录结构：

![Image 1][]![Center 18][]

[http_maven.apache.org_download.cgi]: http://maven.apache.org/download.cgi
[http_apache.fayea.com_maven_maven-3_3.3.9_binaries_apache-maven-3.3.9-bin.tar.gz]: http://apache.fayea.com/maven/maven-3/3.3.9/binaries/apache-maven-3.3.9-bin.tar.gz
[Center]: /images/20220720/5e69050a10524e9187968db6ea263000.png
[Center 1]: /images/20220720/e62391ed5a5e4480bf1ac470a6d0d234.png
[Image 1]: 
[Center 2]: /images/20220720/6bacabbeb79d447d9bb6d73da3b5f440.png
[Center 3]: /images/20220720/4491c9f2120b41e28c7850cc18b465c3.png
[Center 4]: /images/20220720/ff7669feff63479ab98f2036b4e04d0f.png
[Center 5]: /images/20220720/8e6e432e85054c66b1d5d6c1d9292c4b.png
[Center 6]: https://img-blog.csdn.net/20160719094743386?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQv/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center
[Center 7]: /images/20220720/fdb5ed7f97134682abb58c167131b64d.png
[Center 8]: /images/20220720/bc535c26c28d4bb9809f87a72dd1581d.png
[Center 9]: /images/20220720/283b53bd369b44c5b4d500ff199bccb2.png
[Center 10]: /images/20220720/0c281349114b4ff499b96302727aa1e7.png
[Center 11]: /images/20220720/4f3a96136dad4ece925db22e710714b6.png
[Center 12]: /images/20220720/4b756ecf294248aaa12b77da2802cd0d.png
[Center 13]: /images/20220720/0085ff6670a94cfd823307aa278e1bdc.png
[Center 14]: https://img-blog.csdn.net/20160719095921607?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQv/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center
[Center 15]: /images/20220720/01eb0ce3ced74952bef60d9237f4d7fe.png
[Center 16]: https://img-blog.csdn.net/20160719095930211?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQv/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center
[Center 17]: https://img-blog.csdn.net/20160719100116634?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQv/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center
[Center 18]: /images/20220720/7c7c0fe8a75e4623be30c550c21a5509.png