Maven快速上手

kanglecjr

浏览: 504553 次
性别:
来自: 北京

最近访客更多访客>>

briefyf

-tl-

malinhuan123

mygod_cx

博主相关

博客

微博

相册

留言

关于我

文章分类

社区版块

存档分类

博客分类：

工作

maven build continuous integration

1.目标

该篇主要是为了快速利用maven来构建工程，maven作为项目管理的工具已经得到极大程度的应用，很多开源项目都用maven来构建。如何建立一个maven工程，如何导入别人的maven工程，是这篇文章的核心。

2. 创建maven工程

2.1 下载maven的开发包

maven为apache下open source项目，其下载地址为： http://maven.apache.org/ , 下载后将jar包解压到任意目录（建议不要有空格和中文目录）

配置环境变量M2_HOME ，以及把%M2_HOME%\bin 加入到环境变量PATH :

配置完成以后在命令行执行 mvn -v 获得maven的安装版本，表示安装成功！

2.2 eclipse下开发maven项目

可以到网上下载m2eclipse插件，但是在eclipse最新版本 luna 中已经集成了maven插件,在eclipse中配置maven ，如图：

为了使在Eclipse中运行的Maven 与在命令行运行的 Maven行为完全一致, 不建议使用Embedded(内置)的Maven.

其中的settings.xml文件为maven的核心配置文件。以上也指定了maven的本地仓库。

新建一个maven工程（web工程）

选择Maven Project 后Next

选择 maven-archetype-webapp

填入 Group Id 和 Artifact Id , 点击 Finish

工程建立完毕，如下

一开始工程有一个红叉，暂时不管它。先说一个maven的目录结构最基本的结构如下(一个普通的java工程)：

|-src

|-main

|-java

|-test

|-java

|-target

|-pom.xml

其作用：

|-src

|-main

|-java -->平常工程中的java代码

|-test

|-java -->放置测试的java代码，以Test开头或者结尾的java代码在maven工程会自动运行

|-target -->maven工程编译过后生成的文件

|-pom.xml -->maven工程依赖的jar对应的配置文件（核心文件）

上面的建立的工程目录不满足我们的需求，需要手动建立。将工程切换到java EE 透视图(perspective)下

鼠标右击以后建议一个java文件夹，然后添加到Source Folder

设置为 Source Folder

2.3 案例 WebDemo

在第一篇中利用到了案例WebDemo ，其结构如下：

其中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>org.lkl.demo</groupId>
  <artifactId>WebDemo</artifactId>
  <packaging>war</packaging>
  <version>0.0.1-SNAPSHOT</version>
  <name>WebDemo Maven Webapp</name>
  <url>http://maven.apache.org</url>
  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.10</version>
      <scope>test</scope>
    </dependency>
    
    
    <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>3.1-b09</version>
            <scope>provided</scope>
    </dependency>
    
    
    <dependency>
    <groupId>org.atteo.moonshine</groupId>
    <artifactId>h2</artifactId>
    <version>0.9</version>
</dependency>

    
    
  </dependencies>
  
  
  <build>
    <finalName>WebDemo</finalName>
    
    <plugins>
            <plugin>
                <groupId>org.mortbay.jetty</groupId>
                <artifactId>jetty-maven-plugin</artifactId>
                <version>7.0.2.v20100331</version>
                <configuration>
                    <scanIntervalSeconds>10</scanIntervalSeconds>
                    <webAppConfig>
                        <contextPath>/</contextPath>
                    </webAppConfig>
                    <webAppSourceDirectory>webapp</webAppSourceDirectory>
                    <connectors>
                        <connector implementation="org.eclipse.jetty.server.nio.SelectChannelConnector">
                            <port>8080</port>
                            <maxIdleTime>60000</maxIdleTime>
                        </connector>
                    </connectors>
                </configuration>
            </plugin>
        </plugins>
    
    
  </build>
</project>

在 dependencies 下配置工程依赖的jar的信息.

可以在http://mvnrepository.com/ 中查到需要的依赖文件

例如

下面依次来解释pom.xml中的内容

<groupId>org.lkl.demo</groupId>
  <artifactId>WebDemo</artifactId>   -->工程标识
  <packaging>war</packaging>   -->编译打包的形式
  <version>0.0.1-SNAPSHOT</version>  -->里程碑信息
  <name>WebDemo Maven Webapp</name>
  <url>http://maven.apache.org</url>

注意一下这里的里程碑信息，一般情况下有如下几种形式的里程碑

      SNAPSHOT：快照 在开发中的版本
      ALPHA：内部测试的版本
      BETA：公测的版本（给外部人员使用的版本）
      RELEASE： 又称RC  释放版本
      GA：稳定的版本

依赖信息

 <dependency>
      <groupId>junit</groupId>  
      <artifactId>junit</artifactId>
      <version>4.10</version>   -->版本
      <scope>test</scope>   -->对应的jar包在工程中的依赖范围
    </dependency>

依赖范围有如下几种

 1. test范围指的是测试范围有效，在编译和打包时都不会使用这个依赖
 2. compile范围指的是在编译范围有效，在编译和打包的时候都会将依赖存储进去
 3. provided范围，在编译和测试范围有效，在打包时不会加入依赖，如servlet-api.jar,一般在服务器中已经存在了， 如果还打包进去的话就会造成冲突
 4. runtime在运行的时候依赖，在编译的时候不依赖, 在打包时被捆绑进去
看下面的servlet的配置：

<dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>3.1-b09</version>
            <scope>provided</scope>
    </dependency>

 其依赖范围为provided，在打包的时候就不会进行依赖，因为一般的app server中都存在对应的jar，刚才建立的工程中出现红叉就是因为没有添加该依赖信息。

最后一个依赖

<dependency>
      <groupId>org.atteo.moonshine</groupId>
       <artifactId>h2</artifactId>
       <version>0.9</version>
</dependency>

为H2内存数据库的依赖，不需要安装 http://www.h2database.com/html/quickstart.html ，在test/java文件夹中存在一个H2DBTest.java的文件，就是用来测试该数据库的。其内容如下

import java.sql.PreparedStatement;
import java.sql.ResultSet;

import org.junit.Test;

public class H2DBTest {

    @Test
    public void testDemo() throws Exception{
         System.out.println("--test h2 db --");
         Class.forName("org.h2.Driver") ;
         Connection conn = DriverManager.getConnection("jdbc:h2:test", "sa", "") ;
         System.out.println(conn);
         PreparedStatement pstmt = conn.prepareStatement("drop table if exists person;  create table person(id int primary key ,name varchar)") ;
         pstmt.execute() ;
         for(int i  = 1 ;i<11 ;i++){
           pstmt = conn.prepareStatement("insert into person(id,name) values (?,?)") ;
           pstmt.setInt(1, i);
           pstmt.setString(2, "zhangsan-"+i);
           pstmt.execute() ;
         }
         pstmt = conn.prepareStatement("select id,name from person") ;
         ResultSet rs  =  pstmt.executeQuery() ;
         while(rs.next()){
             System.out.println("id="+rs.getInt(1)+";name="+rs.getString(2));
         }
         conn.close(); 
        
    }
}

前面已经说过test/java文件夹下的以Test开头或结尾的java文件中的测试方法会在maven工程执行的时候自动运行，选中pom.xml文件鼠标右击-->Run As -->Maven test

得到结果

也可以使用 Maven Build 然后输入test来执行(该方法用来手动输入命令) ，其操作和 Maven test 一致

输入test后执行

测试说完以后接下来继续说pom.xml后部的文件 plugins 表示的是maven工程的插件

          <plugin>      
             <groupId>org.mortbay.jetty</groupId>
                <artifactId>jetty-maven-plugin</artifactId>
                <version>7.0.2.v20100331</version>
                <configuration>
                    <scanIntervalSeconds>10</scanIntervalSeconds>
                    <webAppConfig>
                        <contextPath>/</contextPath>  -- >工程访问路径
                    </webAppConfig>
                    <webAppSourceDirectory>webapp</webAppSourceDirectory>
                    <connectors>
                        <connector implementation="org.eclipse.jetty.server.nio.SelectChannelConnector">
                            <port>8080</port>  -->端口
                            <maxIdleTime>60000</maxIdleTime>
                        </connector>
                    </connectors>
                </configuration>
            </plugin>

该插件为jetty服务器插件，不推荐使用tomcat .运行为 Maven build 然后输入 jetty:run

输入 localhost:8080 得到如下页面：

一个maven工程就这样子运行起来了

附上工程中其他代码

index.html (静态文件哦)

<html>
<body>
<hr style="margin-top: 100px;">
Welcome to <a href="HelloWorld" style="cursor: pointer;color: red">Apache+Tomcat</a>
</body>
</html>

然后是 main/java下的servlet

package org.lkl.demo;

import java.io.IOException;
import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
import java.util.ArrayList;
import java.util.List;

import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

/**
 * Servlet implementation class HelloWorld
 */
public class HelloWorld extends HttpServlet {
    private static final long serialVersionUID = 1L;

    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        this.doPost(request, response); 
    }

    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        try {
            System.out.println("---getDbData():"+getDbData());
            request.setAttribute("resultSize",getDbData() );
            request.getRequestDispatcher("welcome.jsp").forward(request, response);  
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
    
     private int getDbData() throws Exception{
        System.out.println("--test h2 db --");
         Class.forName("org.h2.Driver") ;
         Connection conn = DriverManager.getConnection("jdbc:h2:test", "sa", "") ;
         System.out.println(conn);
         PreparedStatement pstmt = conn.prepareStatement("drop table if exists person;  create table person(id int primary key ,name varchar)") ;
         pstmt.execute() ;
         List<String> nameList = new ArrayList<String>() ;
         for(int i  = 1 ;i<11 ;i++){
           pstmt = conn.prepareStatement("insert into person(id,name) values (?,?)") ;
           pstmt.setInt(1, i);
           pstmt.setString(2, "zhangsan-"+i);
           pstmt.execute() ;
         }
         pstmt = conn.prepareStatement("select id,name from person") ;
         ResultSet rs  =  pstmt.executeQuery() ;
    
         while(rs.next()){
             System.out.println("id="+rs.getInt(1)+";name="+rs.getString(2));
             nameList.add(rs.getString(2)) ;
         }
         conn.close(); 
         return nameList.size();
    }

}

welcome.jsp

<%@ page language="java" contentType="text/html; charset=ISO-8859-1"
    pageEncoding="ISO-8859-1"%>
    <!-- 解决el表示是不启作用 -->
    <%@ page isELIgnored="false"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>welcome</title>
</head>
<body>
<hr style="margin-top: 100px;">
You obtain <font color="red">${resultSize}</font> datas.

</body>
</html>

从互联网下载的开源项目, 如果解压后其目录下有pom.xml 文件, 在 Eclipse 中可以导入为 Maven Project

Eclipse -> File -> Import... -> Maven -> Existing Maven Projects