maven

eclipse maven3 创建 maven 项目 之 HelloWorld 入门

http://www.blogjava.net/fancydeepin/archive/2012/07/13/382966.html

环境:

eclipse 3.6maven 3.0.4

 

创建一个 Maven Project:
    1. New –> Other –> Maven Project

        在弹出的对话框里,如果你想修改你项目的存放路径你可以改一下,其他的默认,我的所有项目都是存放在默认的工作区下,所以直接点NEXT

        接下来找到并选择 webapp,其他的默认,NEXT

    2. 填写你的 Group Id、Artifact Id、Version 和 Package 信息,然后 Finish

简单解释一下 Group Id、Artifact Id、Version 和 Package:

    groupId:group 翻译成中文就是组、集团的意识,groupId就是这样一个组或集团的ID标识,就拿 Apache 来说好了,Apache 大家都不陌生吧,

        Apache 官网上有非常多的项目,每个项目里面肯定能找得到 org.apache.xxxx,而 org.apache 就是这里说的 groupId

    artifactId:还是拿 Apache 来说,Apache 官网上有非常多的项目,而每个项目的名字就是这里的 artifactId,换句话说,artifactId 就是你的项目名

    version:这个就没有什么好解释的了吧,是项目版本的意思

    package:这个也没什么好说的,就是 groupId.artifactId,创建的时候会自动帮你补全,如果没有自动帮你补全就自己手动敲上去

好,下面来看创建出来的urlrewrite-maven-example的目录结构:

说明:

    src/main/resources:用来存放资源文件(默认会帮你创建这个资源文件夹)

    src/main/java:用来存放 java 源码文件(需要自己手动创建)

    src/main/test:用来存放测试代码(需要自己手动创建,也有人习惯命名为:src/test)@

    target:是用来存放 Maven 编译好的字节码的地方

    Maven Dependencies:里面放的是 maven 管理的 jar 文件

maven-jetty-plugin 插件配置:
    (maven jetty 插件的配置,请参考我的另一篇随笔:http://www.blogjava.net/fancydeepin/archive/2012/06/23/maven-jetty-plugin.html
    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.fancy</groupId>  <artifactId>maven-demo</artifactId>  <packaging>war</packaging>  <version>1.0</version>  <name>maven-demo Maven Webapp</name>  <url>http://maven.apache.org</url>  <dependencies>    <dependency>      <groupId>junit</groupId>      <artifactId>junit</artifactId>      <version>4.7</version>      <scope>test</scope>    </dependency>  </dependencies>  <build>    <finalName>maven-demo</finalName>    <!– Jetty Server <span style="color: rgb(0, 128, 128); background-color: inherit;"–<>    <plugins>      <plugin>        <groupId>org.mortbay.jetty</groupId>        <artifactId>maven-jetty-plugin</artifactId>        <version>6.1.10</version>        <configuration>          <scanIntervalSeconds>2</scanIntervalSeconds>        </configuration>      </plugin>    </plugins>  </build></project>

index.jsp

<html>  <body>    <h2>Hello World!</h2>  </body></html>

运行 project:
    选中项目,右键选择 Run As –> Maven build
    Name:根据需要,自己取个名
    Goals:输入要执行的 maven 命令
    其余的不用管,直接点击 Run

在浏览器中访问:http://localhost:8080/maven-demo/

maven jetty 插件使用

http://www.blogjava.net/fancydeepin/archive/2012/06/23/maven-jetty-plugin.html

maven jetty 插件使用

本机环境

JDK 7 Maven 3.2 Jetty 9.2 Eclipse Luna

pom.xml 配置

在你的 pom.xml 文件中添加 jetty 插件的描述信息(查看Jetty更多的版本信息):

[…]<build>
  <plugins>
    <plugin>
      <groupId>org.eclipse.jetty</groupId>
      <artifactId>jetty-maven-plugin</artifactId>
      <version>9.2.8.v20150217</version>
    </plugin>
  </plugins></build>
[…]

启动 & 停止

命令行方式启动 jetty mvn jetty:run,可以通过 Ctrl + C 停止 jetty 服务。

或者,在 eclipse 中选中项目 –> 右键 –> Run As –> Maven build…,在 Goals 栏输入 jetty:run(与命令行方式相比,仅仅是

少了 mvn 前缀,为方便起见,以下均以命令行方式介绍。) 

jetty 9 部署的项目的 Context path 默认是 /,也就是说,项目的访问入口地址是:http://localhost:8080(不带项目名)
如果你希望通过命令 mvn jetty:stop 执行关闭 jetty 服务,你需要像下面一样在你的 pom.xml 配置文件中添加一个特殊的端口和控制键: 

<configuration>
  […]
  <stopKey>shutdown</stopKey>
  <stopPort>9966</stopPort>
  […]</configuration>

你仍可以通过 mvn jetty:run 启动 jetty 服务,可以通过 mvn jetty:stop 来停止 jetty 服务。

取消文件映射缓存

jetty 默认开启了 useFileMappedBuffer,在 jetty 运行期间,页面所使用的静态文件(如 css 文件等)不允许修改。如果你尝试去修改它

们,保存的时候就会出现 Save could not be completed. 

解决办法,找到 %repo%/org/eclipse/jetty/jetty-webapp/9.2.8.v20150217/jetty-webapp-9.2.8.v20150217.jar(%repo% 表示你
本地的 maven 仓库的目录,另外,将 9.2.8.v20150217 换成你所使用的版本)。用压缩工具打开它, 找到 jetty-webapp-9.2.8.v2015021
7.jar/org/eclipse/jetty/webapp/webdefault.xml,将 webdefault.xml 文件解压缩一份出来,用文本编辑器打开它,搜索找到
useFileMappedBuffer 配置的行,将 true 改成 false 以禁掉缓存。

<init-param>
  <param-name>useFileMappedBuffer</param-name>
  <param-value>false</param-value></init-param>

先确认 jetty 服务已经停止,将原文件 jetty-webapp-9.2.8.v20150217.jar/org/eclipse/jetty/webapp/webdefault.xml 删除,将刚
才那份修改好的 webdefault.xml 文件重新压缩进去即可。

端口配置

jetty 默认使用的端口是 8080,命令行的方式修改端口的命令是:mvn -Djetty.port=8081 jetty:run 。pom.xml 配置方式如下: 

<configuration>
  […]
  <httpConnector>
    <port>8081</port>
  </httpConnector>
  […]</configuration>

自动热部署

在你的 pom.xml 中添加如下配置: 

<configuration>
  […]
  <scanIntervalSeconds>2</scanIntervalSeconds>
  […]</configuration>

默认值是 0。大于 0 的数值表示开启,0 表示关闭,单位为秒。以配置数值为一个周期,自动的扫描文件检查其内容是否有变化,如果发现文件的

内容被改变,则自动重新部署运用。命令行的方式:mvn -Djetty.scanIntervalSeconds=2 jetty:run 。

手动重加载

在你的 pom.xml 文件中添加如下配置,reload 的可选值 :[automatic|manual]

<configuration>
  […]
  <reload>manual</reload>
  […]</configuration>

默认值为 automatic,它与大于 0 的 scanIntervalSeconds 节点一起作用,实现自动热部署的工作。设为 manual 的好处是,当你改变文件
内容并保存时,不会马上触发自动扫描和重部署的动作,你还可以继续的修改,直至你在 Console 或命令行中敲回车键(Enter)的时候才触发重
新加载的动作。这样可以更加的方便调试修改。命令行的方式是:mvn -Djetty.reload=manual jetty:run 

访问日志

在你的 pom.xml 文件添加如下配置: 

<configuration>
  […]
  <requestLog implementation="org.eclipse.jetty.server.NCSARequestLog">
    <filename>target/access-yyyy_mm_dd.log</filename>
    <filenameDateFormat>yyyy_MM_dd</filenameDateFormat>
    <logDateFormat>yyyy-MM-dd HH:mm:ss</logDateFormat>
    <logTimeZone>GMT+8:00</logTimeZone>
    <append>true</append>
    <logServer>true</logServer>
    <retainDays>120</retainDays>
    <logCookies>true</logCookies>
  </requestLog>
  […]</configuration>

org.eclipse.jetty.server.NCSARequestLog  org.eclipse.jetty.server.RequestLog 的一个实现类。
org.eclipse.jetty.server.NCSARequestLog 是一种伪标准的 NCSA 日志格式。下面是一些节点参数的解释:
filename:日志文件的名称
filenameDateFormat:日志文件的名称的日期格式,它要求日志文件名必须含有 yyyy_mm_dd 串
logDateFormat:日志内容的时间格式
logTimeZone:时区
append:追加到日志
logServer:记录访问的主机名
retainDays:日志文件保存的天数, 超过删除
logCookies:记录 cookies
启动 jetty 服务,在项目的 target 目录下会生成一个 access-2015_06_23.log 文件,该文件中的其中一条记录如下:

localhost 0:0:0:0:0:0:0:1 – – [2015-06-23 01:17:05] "GET /css/main.css HTTP/1.1" 304 – 
"http://localhost:8081/"  "Mozilla/5.0 (Windows NT 6.3; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) 
Chrome/35.0.1916.153 Safari/537.36 SE 2.X MetaSr 1.0" "JSESSIONID=2gyikovul2iz168116l2afo4f"

转储快照

在你的 pom.xml 文件添加如下配置: 

<configuration>
  […]
  <dumpOnStart>true</dumpOnStart>
  […]</configuration>

dumpOnStart 默认值为 false,如果设为 true,jetty 在启动时会把当前服务进程的内存信息输出到控制台中,但这并不会保存到文件中。

WEB上下文

最常用的是 contextPath,它的配置如下: 

<configuration>
  […]
  <webApp>
    <contextPath>/${project.artifactId}</contextPath>
  </webApp>
  […]</configuration>

contextPath 的默认值的 /,${project.artifactId} 引用了 <artifactId> 节点的值,即项目的名称。

项目的静态资源文件目录默认是 src/main/webapp,如果静态资源目录有多个,或者不在默认的 src/main/webapp 目录下,可做如下配置: 

<configuration>
  […]
  <webApp>
    <contextPath>/${project.artifactId}</contextPath>
    <resourceBases>
      <resourceBase>${project.basedir}/src/main/webapp</resourceBase>
      <resourceBase>${project.basedir}/commons</resourceBase>
    </resourceBases>
  </webApp>
  […]</configuration>

引用静态资源文件时,路径不包含资源目录的名称,如 commons/main.css,引用方式为:<link href="main.css" rel="stylesheet" /> 

更多参数信息可参考 jetty-maven-plugin.html#configuring-your-webapp

完整的配置

附 pom.xml 文件中 jetty 插件的完整配置片段: 

<build>
  […]
  <plugins>
    <plugin>
      <groupId>org.eclipse.jetty</groupId>
      <artifactId>jetty-maven-plugin</artifactId>
      <version>9.2.8.v20150217</version>
      <configuration>
        <httpConnector>
          <port>8081</port>
        </httpConnector>
        <stopKey>shutdown</stopKey>
        <stopPort>9966</stopPort>
        <!–
        <scanIntervalSeconds>2</scanIntervalSeconds>
        
<span style="color: rgb(0, 128, 0); background-color: inherit;"–<>
        <reload>manual</reload>
        <dumpOnStart>true</dumpOnStart>
        <webApp>
          <contextPath>/${project.artifactId}</contextPath>
          <!–
          <resourceBases>
            <resourceBase>${project.basedir}/src/main/webapp</resourceBase>
            <resourceBase>${project.basedir}/commons</resourceBase>
          </resourceBases>
          
<span style="color: rgb(0, 128, 0); background-color: inherit;"–<>
        </webApp>
        <requestLog implementation="org.eclipse.jetty.server.NCSARequestLog">
          <filename>target/access-yyyy_mm_dd.log</filename>
          <filenameDateFormat>yyyy_MM_dd</filenameDateFormat>
          <logDateFormat>yyyy-MM-dd HH:mm:ss</logDateFormat>
          <logTimeZone>GMT+8:00</logTimeZone>
          <append>true</append>
          <logServer>true</logServer>
          <retainDays>120</retainDays>
          <logCookies>true</logCookies>
        </requestLog>
      </configuration>
    </plugin>
  </plugins>
  […]</build>

更多有关 jetty 的配置信息可参考 http://www.eclipse.org/jetty/documentation/current/jetty-maven-plugin.html

http://ifeve.com/maven-1/

http://ifeve.com/maven-2/