使用Eclipse+Maven+Jetty构建Java Web开发环境(几个教程综合集成2014发行)

工作需要使用Jetty由于web集装箱,得知Eclipse+Maven+Jetty该组合是非常好的,因此,要在网上找了很多教程,但不写或多或少特定的或过时的内容而导致最终的配置失败,易于配置为未来的同事,这篇配置教程。顺便来方便一下大家。

用到的參考资料例如以下:

【用Maven构建Java Web开发环境(Jetty容器)】(以此教程为主)http://sarin.iteye.com/blog/784275 以及 http://sarin.iteye.com/blog/784697

【在Eclipse中编写servlet时出现"The import javax.servlet cannot be resolved" 问题解决的方法】http://blog.163.com/y_love_qq/blog/static/27637235201211141422583/

【使用maven载入项目中缺少的jar包】http://blog.csdn.net/daven_java/article/details/8775809

【*- maven jetty - org.mortbay.jetty vs org.eclipse.jetty】http://*.com/questions/15386461/maven-jetty-org-mortbay-jetty-vs-org-eclipse-jetty

在此首先感谢这些作者的心血,把这些结合在一起我才最终配置成功。

以下開始正题。

=======================软件环境=======================

『系统』Windows 7 x64

『JAVA』JDK 1.7.0_65

『Eclipse』 Eclipse for JavaEE

『Maven』 Apache Maven 3.2.2

『Jetty』 jetty-distribution-8.1.15

=======================配置过程=======================

一、JAVA和Maven的配置(假设都配置好了并且清楚maven的使用方法能够直接跳过看第二部分)

这部分我就直接使用參考资料中的教程了,由于写得比較具体也没有错误。

(源地址:http://sarin.iteye.com/blog/784275)

Maven是构建Java应用的优秀管理工具,是Apache软件基金会的*项目。其具有开发文件夹构建和管理,统一管理第三方依赖,编译,測试。打包,公布等功能。

最大的特点要数第三方依赖管理了。由于其他功能都能从Ant中找到踪影。以往每一个项目独立管理依赖,使得每一个项目打包后都是巨大无比的,而真正的程序文件却没有多少。Maven接管第三方依赖后,我们的应用就仅仅有程序文件了,没有了jar包轻巧非常多。而统一的管理,使得我们能够任意获取jar资源。

刚開始学习的人使用Maven总是感觉非常难上手。当中也有一部分人是被Maven下载资源那疯狂的做法吓退的,这就是Maven的静止之处。从Apache官方站点下载的Maven工具只2M大小,当中是不包括我们要使用的依赖的,那么就要从网络中获取这些依赖,就是那个疯狂下载的过程。以下我们从头開始构建Maven环境,直到执行Jetty容器执行Web应用。这一切都非常easy。

下载Maven的开发包之后,解压到一个固定的文件夹,建议不要使用汉字并在磁盘的根文件夹下,这是比較好的实践。那么本文以Maven 3为例来说明,Maven的位置是F:\Maven 3文件夹。解压后就要加入系统环境变量,这里要说明,由于Maven也是Java应用,所以JDK就必需要提前安装并设置环境遍历。将JAVA_HOME和M3_HOME单独设置。防止其使用时不能用Path变量下发现所需路径。以下是JAVA_HOME和M3_HOME的配置位置。这个因人而异,可是最好固定不要任意改动。

使用Eclipse+Maven+Jetty构建Java Web开发环境(几个教程综合集成2014发行) 

使用Eclipse+Maven+Jetty构建Java Web开发环境(几个教程综合集成2014发行) 

    在Path中,这样来加入就可以,很easy。 

使用Eclipse+Maven+Jetty构建Java Web开发环境(几个教程综合集成2014发行) 

    至此Maven已经安装完毕了,以下我们来验证安装,在CMD中输入mvn –v 

使用Eclipse+Maven+Jetty构建Java Web开发环境(几个教程综合集成2014发行) 

    能够看到,已经识别mvn命令了。做点简单的设置,就是第三方依赖下载的时候的存放位置。默认是在C盘用户文件夹的当前用户文件夹下(如C:\用户\Admin,这里是Windows 7的命名方式)。在这里Maven会创建.m2文件夹,这里面就会存放下载的类库。

当然我不想这些类库放在C盘下。不是特别安全,我想让它们存放在Maven安装文件夹下,那么就能够这样进行:在Maven安装文件夹的conf下打开settings.xml,这是对Maven进行设置的XML文件,这里我们简单设置第三方依赖的位置。例如以下设置:

  1. <localRepository>F:/Maven3/repository</localRepository>

这样。那些疯狂下载的依赖就在这个位置下了,要留给足够大的空间,由于依赖下载非常可能占用非常大的一块空间。为什么?下载后去看看它的真实面目就知道了。 

    以下我们就来创建应用文件夹,使用mvn archetype:generate命令一步一步依据提示,选择项目类型,加入groupId和artifactId就能够创建项目了,我们来看一下,这里运行mvn archetype:generate -DarchetypeCatalog=internal命令。要手工设置一下项目类型分类属性。可能由于类型太多导致屏幕显示不全,那么我们就简单来看几个经常使用的即可,就是internal类型。运行该命令后。在控制台我们看到有例如以下的内容。(切记这个操作位置就是生成项目文件夹的位置) 

使用Eclipse+Maven+Jetty构建Java Web开发环境(几个教程综合集成2014发行) 

    这里我们先选择16是maven-archetype-quickstart,就是主要的JavaSE项目结构的构建。19是maven-archetype-webapp。用来创建简单的Java Web应用,我们先选择16来看看。 

使用Eclipse+Maven+Jetty构建Java Web开发环境(几个教程综合集成2014发行) 

    选择16之后,Maven提示输出groupId。就是我们的项目命名组成之中的一个,没什么过多解释的东西,artifactId用来标记项目名称。它们两个是联合使用的。而package定义的是包名。我们在目录内就发现了demo命名的项目目录。看看这个目录的结构,这是Maven为我们创建的,就是一个标准的格式: 

使用Eclipse+Maven+Jetty构建Java Web开发环境(几个教程综合集成2014发行) 

    根文件夹下有一个pom.xml,这就是项目的Maven配置文件,临时不介绍其强大的功能,只简单看一下实际应用。这是基础的文件夹结构,Maven为我们创建了一个Hello World的小程序。我们来执行它。想要执行这个程序。那么就要编译,mvn的编译命令是mvn compile。这样就为我们编译整个项目。这个操作要在demo文件夹下完毕。

使用Eclipse+Maven+Jetty构建Java Web开发环境(几个教程综合集成2014发行) 

    回头看看demo文件夹。多出一个target文件夹,这就是我们的类路径了,class文件就在以下。这个操作的逆过程是mvn clean,顾名思义,就是清理,清理生成的可运行部分。仅留下源代码部分,例如以下: 

使用Eclipse+Maven+Jetty构建Java Web开发环境(几个教程综合集成2014发行) 

    Maven运行了Deleting操作,删除了target文件夹。

假设想运行程序。是须要class文件或jar文件的。前面的mvn compile命令不过编译。而没有相应用进行打包公布。而mvn package命令能够将应用打包(jar或war等),那么我们就来为项目打包公布: 

使用Eclipse+Maven+Jetty构建Java Web开发环境(几个教程综合集成2014发行) 

    这个过程。Maven运行了非常多操作,有日志能够细看。当中还有測试过程。这是JUnit的測试。事实上我们创建项目时,Maven为我们引入的第一个依赖就是JUnit。

以下我们来运行jar文件。运行程序。

(当然运行class是一样的效果) 

使用Eclipse+Maven+Jetty构建Java Web开发环境(几个教程综合集成2014发行) 

    这样就得到运行效果了,Hello World!

二、Eclipse+Maven+Jetty配置过程

   这一部分相同以sarin博主的教程为主,当中加入、改动了部分不具体的或是过时的内容(会以暗红色标出以示差别)。
   眼下为止我们还是手工命令行方式运行程序的,没有和IDE结合。事实上Maven天生就对Eclipse做了集成。我们使用mvn eclipse:eclipse就得到了一个Eclipse的项目结构。在Eclipse中使用import功能就能直接导入到IDE中了。我们来看一下这个过程: 

使用Eclipse+Maven+Jetty构建Java Web开发环境(几个教程综合集成2014发行) 

    此时的demo就是Eclipse项目格式的了,出现了.project和.classpath文件。

我们在Eclipse中引入这个项目,此时的Eclipse没有安装Maven插件,不能自己主动执行Maven命令,我们来安装Maven的Eclipse插件M2E。

使用Eclipse+Maven+Jetty构建Java Web开发环境(几个教程综合集成2014发行) 

假设因为网络原因Eclipse无法联网安装M2E插件,能够到这里下载我上传的离线包(安装方式为解压后合并同名目录并重新启动eclipse):
相同的方法我们来安装一下run-Jetty-run插件:
假设因为网络原因Eclipse无法联网安装run-jetty-run插件,能够到这里下载我上传的离线包。然后在Install
New Software的窗体点击Add,然后选择Archive,选中下载的压缩包安装就可以,压缩包地址:http://download.csdn.net/detail/u012510614/7667397


 在Eclipse的Install
New Software中直接选择安装就可以。很easy。以下我们来创建Web项目并导入Eclipse中,在Jetty容器中执行程序。假设你看了第一部分的教程,那么请删除第一部分建立的项目目录,或者另外新建一个maven项目,步骤例如以下:
1、cmd呼出命令行窗体
2、mvn
archetype:generate -DgroupId=com.cwbeta -DartifactId=demo-DarchetypeArtifactId=maven-archetype-webapp -Dversion=1.0(请将“com.cwbeta”替换成你的项目开发组,“demo”换成你的项目名称)
3、cd到你的项目文件夹
4、mvn
eclipse:eclipse(使用这条指令使得项目成为eclipse可以导入的格式)
5、用Eclipse的File->Import导入该项目根文件夹

上面几部假设记不住能够写一个批处理的脚本方便以后建立项目:
@echo off
set /p project_name=Name of the new project: 
set /p producer_name=Name of the producer: 
mvn archetype:generate -DgroupId=%producer_name% -DartifactId=%project_name% -DarchetypeArtifactId=maven-archetype-webapp -Dversion=1.0
cd %project_name%
mvn eclipse:eclipse
echo [Press any key to exit]
pause>nul
exit

写入记事本保存成bat格式文件粘贴到workspace的文件夹执行就可以。


 然后我们能够看到例如以下的Eclipse项目格式

使用Eclipse+Maven+Jetty构建Java Web开发环境(几个教程综合集成2014发行) 
 能够看到。刚创建的web项目结构包括了resources文件夹,而没有java代码文件夹,我们须要手工创建,在Eclipse中创建source
folder,路径为src/main/java/src,创建方法例如以下:
在你的项目上右键
-> New -> Source Folder
Folder name填上路径:src/main/java/src
勾上Update
exclusion filters...选项(一定要勾否则不能创建)
Finish!

如今我们得到例如以下一个项目结构,新建一个Servlet用于測试,新建方法例如以下:
在你新建立的src/main/java/src的source file上右键 -> New -> Servlet
Java
package填org.ourpioneer.servlets(源教程这么写。不知道能否改,姑且先这么写着吧)
Class
name填HelloWorldServlet
Finish。
然后你就会看到例如以下的文件脉络。
使用Eclipse+Maven+Jetty构建Java Web开发环境(几个教程综合集成2014发行)
假设在这里你发现HelloWorldServlet.java有报错说“The
import javax.servlet cannot be resolved”,能够这么解决:
在Eclipse中。右击项目。选择Build
Path -> Configure Build Path... -> Libraries->Add External JARs,找到你计算机中Jetty(tomcat也适用)的安装路径,在lib目录下选中"servlet-api-3.0.jar",加入点击“确定”,ok!

 
 此时,项目中没有Servlet的依赖,须要加入,我们使用m2eclipse插件来直接加入依赖,例如以下所看到的:
双击项目根文件夹的pom.xml
-> 选择Dependencies -> 左边的add -> 例如以下图配置
使用Eclipse+Maven+Jetty构建Java Web开发环境(几个教程综合集成2014发行)
也能够手动编辑pom.xml
插入这一段:
 <dependency>
<groupId>javax.servlet</groupId>
<artifactId>servlet-api</artifactId>
<version>2.5</version>
<type>jar</type>
<scope>compile</scope>
</dependency>

以下就能够编写Servlet了。非常easy,就输出HelloWorld吧(编辑HelloWorldServlet.java)。

package org.ourpioneer.servlets;  

import java.io.IOException;
import java.io.PrintWriter; import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse; public class HelloWorldServlet extends HttpServlet { protected void doGet(HttpServletRequest request,
HttpServletResponse response) throws ServletException, IOException {
this.process(request, response);
} protected void doPost(HttpServletRequest request,
HttpServletResponse response) throws ServletException, IOException {
this.process(request, response);
} private void process(HttpServletRequest request,
HttpServletResponse response) throws ServletException, IOException {
response.setContentType("text/html;charset=utf-8");
response.setCharacterEncoding("utf-8");
PrintWriter out = response.getWriter();
String title="Webapp Demo";
out.println("<!DOCTYPE html PUBLIC \"-//W3C//DTD XHTML 1.0 Strict//EN\" \"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd\">");
out.println("<html xmlns=\"http://www.w3.org/1999/xhtml\">");
out.println("<head>");
out.println("<meta http-equiv=\"Content-Type\" content=\"text/html;charset=utf-8\" />");
out.println("<title>" + title + "</title>");
out.println("<body>");
out.println("<h1>Hello World!</h1>");
out.println("</body>");
out.println("</html>");
}
}

源教程说须要再配置web.xml。而我用的eclipse自己主动配置完毕了。所以这里跳过。


 程序都有了。剩下就是执行了,Maven既然天生和Jetty是一对儿,这里我们就使用Jetty吧。在Maven中配置Jetty,首先是webdefault.xml要准备好。它是配置Jetty的,这个能够从Jetty的包中找到。并拷贝到resources下,这里多说一点,默认Jetty执行时是锁定JS/CSS等静态文件的,假设想在Jetty执行时也能改动它们,要在webdefault.xml中改动例如以下设置:
<init-param>
<param-name>useFileMappedBuffer</param-name>
<param-value>false</param-value>
</init-param>

Jetty也准备了,执行命令是jetty:run。这要在Maven中设置,那么须要在pom.xml中增加Jetty的插件的设置信息。

这里直接贴出其总体构建信息。

这部分注意,因为源教程贴出的构建信息中org.apache.maven.plugins这个plugin已不能使用(能够參考Jetty-Maven-Plugin的发展史:http://www.eclipse.org/jetty/documentation/current/jetty-maven-plugin.html)。因此我做了一些改动,换成了org.eclipse.jetty的jetty插件,版本号为9.0.0.v20130308(官网上给出的最新版本号我这里測试不可用,而此2013年的版本号能够使用,因此使用该版本号)。改动后的内容例如以下。改动方法也是编辑项目根文件夹的pom.xml(双击然后选择pom.xml选项卡就可以编辑):
  <build>
<finalName>demo</finalName>
<sourceDirectory>src/main/java/src</sourceDirectory>
<testSourceDirectory>src/test</testSourceDirectory>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>2.0.2</version>
<configuration>
<source>1.6</source>
<target>1.6</target>
<encoding>utf-8</encoding>
</configuration>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-resources-plugin</artifactId>
<configuration>
<encoding>UTF-8</encoding>
</configuration>
</plugin>
<plugin>
<groupId>org.eclipse.jetty</groupId>
<artifactId>jetty-maven-plugin</artifactId>
<version>9.0.0.v20130308</version> <!-- latest at time of writing -->
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-eclipse-plugin</artifactId>
<version>2.7</version>
<configuration>
<addVersionToProjectName>false</addVersionToProjectName>
<useProjectReferences>false</useProjectReferences>
<encoding>UTF-8</encoding>
<wtpmanifest>false</wtpmanifest>
<wtpapplicationxml>true</wtpapplicationxml>
<wtpversion>1.5</wtpversion>
<additionalBuildcommands>
<buildcommand>org.eclipse.jdt.core.javabuilder</buildcommand>
<buildcommand>org.eclipse.wst.common.project.facet.core.builder</buildcommand>
<buildcommand>org.eclipse.wst.validation.validationbuilder</buildcommand>
</additionalBuildcommands> <additionalProjectnatures>
<nature>org.springframework.ide.eclipse.core.springnature</nature>
<nature>org.maven.ide.eclipse.maven2Nature</nature>
<nature>org.eclipse.wst.common.project.facet.core.nature</nature>
<nature>org.eclipse.jdt.core.javanature</nature>
<nature>org.eclipse.wst.common.modulecore.ModuleCoreNature</nature>
</additionalProjectnatures>
<classpathContainers>
<classpathContainer>org.eclipse.jdt.launching.JRE_CONTAINER</classpathContainer>
</classpathContainers>
</configuration>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-war-plugin</artifactId>
<version>2.1-beta-1</version>
<configuration>
<warName>webapp</warName>
</configuration>
</plugin>
</plugins>
</build>

接着让我们更新一下maven的依赖,用cmd命令行工具cd到项目的根文件夹,运行mvn dependency:copy-dependencies。

须要更新一段时间。只是整个配置就快完毕啦,能够站起来活动活动,放松一下~
更新完毕后,我们就能够在Eclipse中配置Debug执行了。配置非常easy,例如以下:
Run
-> Debug Configurations...
由于安装了run-jetty-run插件,Jetty执行的port能够在这里配置:
使用Eclipse+Maven+Jetty构建Java Web开发环境(几个教程综合集成2014发行)

而Maven例如以下配置就可以:
使用Eclipse+Maven+Jetty构建Java Web开发环境(几个教程综合集成2014发行)


   
这是Debug模式执行,Run模式下是一样的,用Debug模式能够在Eclipse中断点执行程序,很便于调试。

以下我们就让它跑起来吧。执行命令是jetty:run。Base directory配置是:${workspace_loc:/应用名}。启动调试,看到例如以下信息,Jetty就成功启动了。

 

使用Eclipse+Maven+Jetty构建Java Web开发环境(几个教程综合集成2014发行) 

    假设你使用了80port,在浏览器中訪问地址例如以下:http://localhost/你的项目名称,之后。我们就看到了效果。

使用Eclipse+Maven+Jetty构建Java Web开发环境(几个教程综合集成2014发行) 

版权声明:本文博主原创文章,博客,未经同意不得转载。

上一篇:Web AppBuilder Widget使用共享类库的方式


下一篇:css小知识点