Java EE7和Maven工程入门（1）—— 一个简单Maven工程的结构

本文由 ImportNew - miracle1919 翻译自 javacodegeeks。欢迎加入Java小组。转载请参见文章末尾的要求。

为什么？

在日常工作中，我经常需要解决许多简单的或者是复杂的Maven/Java EE工程结构的问题。为了找到解决办法，我经常要拿项目的结构做实验，在不同应用服务器上对部署进行测试并且调优。

对新手来说，Maven可能有一个很漫长的学习曲线。如果你参与进一个经常需要非常复杂的配置的现代化的JavaEE应用的时候，事情会变得更糟。
在我的职业生涯中也曾见过：很多初级程序员，当他们参与到一个大的团队或者项目，很多时候，工程的结构已经被一些更高级的程序员调优和配置好了。他们会认
为这是没问题的，并且也不会花时间来理解这些配置和结构。过去我也犯过这样的错误。他们被给予简单的编码任务，然后就一头扎进需求里面去了。很不幸，他们
忽略了应用结构的学习。更高级的同僚们大多数时候因为时间限制也忘了在这个领域对他们进行培训。这会导致一些事故，因为之前没有经验，想让应用跑起来的时
候，会把应用结构弄的一团糟。Maven和它的约定的目的是帮助构建通用的结构，然后对项目的结构应该是什么样子做了约定。但同样的，你需要理解这个工具
和约定，然后才可以掌握你的配置。

经常会听到有人说“我在那里添加了一个lib，可以正常工作”。如果你回答“那里是什么意思？”，很可能会得到许多有意思的回复。碰巧或者是运气好的时候，应用确实能运行。但是，在一个复杂的多模块的应用里面，大多数时候，能运行说明不了什么——问题很快就会出现。

本系列的文章主要是针对Maven和JavaEE新手。如果你是一名高级程序员，欢迎分享或者把它当作一个示例。

我准备拿一个在我的日常工作中发现的有很多实际问题的例子开刀，尝试给出基本的解释或者是给出相关资源的连接。欢迎以一种干净的方式给出可操作或者
可实现的建议、纠正或者是引用。学习Maven并且创建一个复杂但是却容易维护的应用，最好的方式是白手起家，从一个空的pom文件开始。

我想要向读者传达的主要意思是，*学习你的应用的结构，底层的构建工具也是你工作的一部分，永远不要假设总会有人会来处理。为了挑战更难的任务和改善作为Java开发者的技能，这也是很重要的一步。

用到的主要技术

  • 基于JavaEE7的应用
  • 应用会被打成WAR包
  • 应用由很多组件组成（wars、jars、ejbjars）
  • 用Java7进行编译
  • 用Maven3进行打包

我的示例ear应用

作为本文示例，我的应用最终会会是一个EAR包。里面包含2个顶级的模块，一个war包和一个ejb-jar。此外还包含了数据库领域模型（JPA实体）类的jar。后面的文章中我会扩展这个结构，增加更多的资源。

下面的一个抽象的图片展示了我们的ear包将包含哪些东西。将来，war模块会包含servlet或者是jsf组件。services模块会包含许多常用的无状态的会话Bean（或是消息驱动Bean）。domain工程会有普通的用JPA2注解标注的Java类。

用Maven构造我们应用的基本结构

为了构建上面说的ear，我们需要使用Maven定义模块和应用的组成部分，它是我们的构建、打包、配置工具。这只是众多步骤中的一步，但是如果你
一开始就搞明白了，接下来就是一些简单的技术或配置。这里不是最终的解决方案，而是很多时候当你开始一个新的应用时，如何找到接近标准的问题解决方式。因
此，这里没有华而不实的东西，让我们遵守标准，开始构建一个坚实的基础吧。

首先让我们忘掉上面的那幅图，然后想一下：在Maven中模块是什么，他们是如何进行定义的，怎么把他们联系起来，如何定义他们之间的依赖关系。注意：我提倡的工作方式是遵守标准，而不是最终的解决方案。也就是说，你可以定义更少的模块和依赖，然后把你的应用打包成ear。假设我要覆盖非常复杂的结构，所以我总是会遵守标准，定义一个通用的结构。

假设你已经了解了Maven的一些基本改变，至少你应该熟悉一些术语。如果不是的话，请先看这里。

请记住，Maven是关于：根据定义良好的结构把
你的文件放到正确的位置。定义Maven插件，插件是用来做诸如编译、打包、复制文件这样工作的工具。Maven内置了很多插件。所以，你需要用适当的配
置在适当的地方来定义这些插件。不需要写make或者是ant脚本，只需要插入插件，然后让Maven按照定义的顺序来执行就可以了。

一个和我关系很好的前同事说过（最近的一封email里写道）：在生活或者是编码中打破常规是很好的，但是在Maven中永远不要这么做。他是对的！

如果你不知道如何安装Maven，请看看这里（windows）或这里（Mac）。

我的Maven工程结构：抽象

我们正在使用Maven构建工程，所以需要考虑maven的pom和模块。为了能创建出我们需要的ear包(看上面)，我们需要5个pom文件：

  • 一个pom，作为父pom。
  • 一个pom，包含、定义最终的ear包，它负责给最终的包做配置。
  • 一个pom，包含、定义web应用的代码，也就是我们的war包。
  • 一个pom，包含、定义ejb模块的代码，用来打包我们的ejb的模块。
  • 一个pom，包含JPA（数据库实体）类。

正如你看到的那样，每一个模块都有自己的pom文件，一个父pom文件。很多人不在他们的结构中添加父pom文件，因为他们的工程很小，所以不需要。当更多的模块添加进来时，没有父pom就变得一团糟。所以请记住，拥有并配置父pom文件是一件非常好的事情。在它里面，你会定义你所有依赖的jar包的版本，配置maven的插件，所有的子pom文件都会继承父pom的配置。

我的Maven工程的结构：父pom文件

正如前面说过的那样，我们要白手起家。所以我要创建一个新的文件夹叫做“sample-parent”，在这个文件夹中，添加一个新的文件叫做“pom.xml”。


1

2

3

4

5

6

7

8

9

10

<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/xsd/maven-4.0.0.xsd">

        <modelVersion>4.0.0</modelVersion>

        <groupId>gr.javapapo</groupId>

        <artifactId>sample-parent</artifactId>

        <version>0.0.1-SNAPSHOT</version>

        <packaging>pom</packaging>

 

       

</project>

是的，现在还没什么可兴奋的，仅仅是给值是pom的packaging元素做了个记录。之所以称之为父pom，因为它会定义并管理子模块，这是在模块定义部分完成的。我们的初始的pom看起来就像下面这个样子。这意味着，我们必须在sample-parent下面创建相关的文件夹，然后给它们每一个都添加pom.xml.


1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

<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/xsd/maven-4.0.0.xsd">

        <modelVersion>4.0.0</modelVersion>

        <groupId>gr.javapapo</groupId>

        <artifactId>sample-parent</artifactId>

        <version>0.0.1-SNAPSHOT</version>

        <packaging>pom</packaging>

 

        <modules>

                <module>sample-ear</module>

                <module>sample-web</module>

                <module>sample-services</module>

                <module>sample-domain</module>

        </modules>

       

</project>

让我们继续添加一些配置……

这是很重要的部分，因为我们要定义下面的版本：

  • 需要使用和配置的Maven插件。
  • 所有的jar包：被其他的模块所引用和使用的依赖。
  • 其他的通用的属性，比如我们要编译的Java运行时的版本。
  • 源文件或其他资源的默认的编码。

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

<properties>

        <!--  encoding-->

        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>

        <!--java version -->

        <java-version>1.7</java-version>

       

        <!-- plugin versions -->

        <ejb-plugin-version>2.3</ejb-plugin-version>

        <war-plugin-version>2.4</war-plugin-version>

        <ear-plugin-version>2.9</ear-plugin-version>

        <compiler-plugin-version>3.1</compiler-plugin-version>

 

        <!-- dependency versions -->

        <javaee-api-version>7.0</javaee-api-version>

               

        <!-- EJB spec version -->

        <ejb-spec-version>3.2</ejb-spec-version>

</properties>

在properties部分之后，继续添加另一个重要的部分dependencyManagement。这里用来定义在应用的模块中可能会用到的依赖和各自的版本。在这一部分中，我们实际关注的是版本号，包含还是排除依赖是取决于子pom（也就是说它们是不会被自动添加到子pom中的）。它们的作用范围也是一样。所以DependencyManagement是一个集中控制版本号的地方。


1

2

3

4

5

6

7

8

9

10

11

12

13

14

<dependencyManagement>

        <dependencies>

                <dependency>

                        <groupId>javax</groupId>

                        <artifactId>javaee-api</artifactId>

                        <version>${javaee-api-version}</version>

                </dependency>

                <dependency>

                        <groupId>junit</groupId>

                        <artifactId>junit</artifactId>

                        <version>${junit-version}</version>

                </dependency>

        </dependencies>

</dependencyManagement>

在我们的父pom中，跟dependencyManagemt相似的另一个重要的部分是pluginManagement。在这个部分定义所有
maven插件的版本和通用的配置。这些插件在我们的应用配置和打包的过程中会被引用或者是使用到。下面的例子中，我定义了一个最基本的编译器插件。当
然，我们还需要更多的插件。


1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

<!-- Plugin management -->

<build>

  <pluginManagement>

     <plugins>

        <!-- compiler plugin -->

        <plugin>

          <groupId>org.apache.maven.plugins</groupId>

          <artifactId>maven-compiler-plugin</artifactId>

          <version>${compiler-plugin-version}</version>

          <configuration>

            <source>${java-version}</source>

            <target>${java-version}</target>

            <encoding>${project.build.sourceEncoding}</encoding>

         </configuration>

      </plugin>

   </plugins>

  </pluginManagement>

</build>

让我们在pluginManagement部分添加更多以后会用到的的插件。定义ejb插件用老编译和打包我们的ejb，定义war插件用来打包我们的war。


1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

<!-- ejb plugin -->

<plugin>

        <groupId>org.apache.maven.plugins</groupId>

        <artifactId>maven-ejb-plugin</artifactId>

        <version>${ejb-plugin-version}</version>

        <configuration>

                <ejbVersion>${ejb-spec-version}</ejbVersion>

        </configuration>

</plugin>

 

<!-- war plugin -skinny wars mode! -->

<plugin>

  <groupId>org.apache.maven.plugins</groupId>

  <artifactId>maven-war-plugin</artifactId>

  <version>${war-plugin-version}</version>

  <configuration>

        <failOnMissingWebXml>false</failOnMissingWebXml>

        <packagingExcludes>WEB-INF/lib/*.jar</packagingExcludes>

        <archive>

                <manifest>

                        <addClasspath>true</addClasspath>

                        <classpathPrefix>lib/</classpathPrefix>

                </manifest>

        </archive>

        <webResources>

                <resource>

                        <filtering>true</filtering>

                        <directory>src/main/webapp</directory>

                        <includes>

                                <include>**/web.xml</include>

                        </includes>

                </resource>

        </webResources>

  </configuration>

</plugin>

现在

你可以在这里(tag是post1，bitbucket)下载最小的示例。时光飞逝，看起来我们什么也还没完成。但是，一步一步的定义了一个干净并且具体的父pom文件，他将是我们在下篇文章中要做的剩余工作的基础。

学习的重点

  • 标准的maven工程布局。
  • 父pom文件。
  • dependencyManagement和pluginManagement的重要性。

资源

采集

#HUABAN_WIDGETS .HUABAN-red-normal-icon-button, .HUABAN-red-large-icon-button, .HUABAN-red-small-icon-button, .HUABAN-white-normal-icon-button, .HUABAN-white-large-icon-button, .HUABAN-white-small-icon-button { background-image: url({{imgBase}}/widget_icons_ie6.png)

时间： 2024-12-24 02:22:18

Java EE7和Maven工程入门（1）—— 一个简单Maven工程的结构的相关文章

来写一个简单的PHP MVC结构

MVC结构,其实就是三个Model,Contraller,View单词的简称,Model,主要任务就是把数据库或者其他文件系统的数据按照我们需要的方式读取出来.View,主要负责页面的,把数据以html的形式显示给用户.Controller,主要负责业务逻辑,根据用户的 Request进行请求的分配,比如说显示登陆界面,就需要调用一个控制器userController的方法loginAction来显示.云鼎娱乐城 下面我们用PHP来创建一个简单的MVC结构系统. 首先创建单点入口,即bootst

入门搭建一个简单的springcloud

搭建父工程 创建新的项目,这里我习惯先创建一个空的项目 命名这个项目和工程存放的路径 然后点ok会弹出这个窗口, 然后点击new Module 选择maven,然后不用勾选任何东西,直接next 填写完毕后直接next 然后点击finish 点击ok即可 这样父工程就被我们创建出来了,然后我们删除一些不用的文件夹. 然后我们导入父工程的相关依赖 1 <packaging>pom</packaging> 2 3 <parent> 4 <groupId>org.

maven（04）--一个简单的项目

简单介绍 一个maven项目,使用hibernate框架,实现向mysql数据库中添加和获取操作,其他操作也是类似 如果你没有hibernate,那么也不要紧,这里主要介绍如何在一个maven项目中引入框架 项目流程 1.新建一个maven项目,项目命名为maven-ch04 2.添加相关依赖,如junit.hibernate.mysql驱动.log4j pom.xml文件添加以下依赖(如果你是第一次加这些依赖,那么需要等一会,这时候IDEA会下载一些相关文件) 如果你不知道如何查找依赖,可以查

java 20 - 4 IO流概述和一个简单例子解析

IO流的分类:  流向: 输入流 读取数据  输出流 写出数据 数据类型:  字节流  字节输入流 读取数据 InputStream  字节输出流 写出数据 OutputStream  字符流  字符输入流 读取数据 Reader  字符输出流 写出数据 Writer 注意:一般我们在探讨IO流的时候,如果没有明确说明按哪种分类来说,默认情况下是按照数据类型来分的. ------------------------------------割割割--------------------------

Java小练习之利用面向对象写一个简单的登录系统

import java.util.Scanner; /** * 采用面向对象的方式 写一个登录系统 * @author Administrator * */ //用户信息 class UserInfo{ public static String[] user = new String[10]; public static String[] passwd = new String[10]; public UserInfo() { this.user[0] = "test"; this.p

【webGL】threejs入门 ---创建一个简单立方体

开发环境 Three.js是一个JavaScript库,所以,你可以使用平时开发JavaScript应用的环境开发Three.js应用.如果你没什么偏好的话,我会推荐Komodo IDE. 调试建议使用Chrome或者Firefox浏览器.如果你使用的是Firefox,那么Firebug会是你必不可少的插件:如果你使用的是Chrome,那么直接使用控制台调试即可.这些和JavaScript的调试是相同的,因此本书不作进一步展开. 下载 首先,我们需要在Github下载Three.js的代码. 在

Android 开发基础入门篇: 复制一个工程作为一个新的工程

说明 咱们做项目很多时候都需要复制一份工程出来作为一个新的工程 把第一节的工程拷贝到这一节 修改工程名字 打开软件导入此工程 修改包名 第一节的时候说了,一个APP一个包名 自行添加修改 自行修改 自行修改 选择 Sync Now 清理下工程 然后安装到手机 原文地址:https://www.cnblogs.com/yangfengwu/p/11909225.html

[转载]Maven初级入门笔记

最近在研究Maven,写了一个简单的学习笔记. 本文所有资料百度云地址:http://pan.baidu.com/s/1jGn27PG 首先需要在本机上搭建一个nexus私服. 第一步,将Maven总结资料\工具目录下的nexus-2.1.2.war直接放在D:\Tomcat 7.0\webapps目录下. 第二步,启动tomcat后,在webapps目录下生成一个nexus-2.1.2目录. 第三步,停掉tomcat,修改nexus-2.1.2目录名称为nexus.再次启动tomcat,访问h

java后台框架源码 springmvc mybatis oracle mysql maven HTML5 bootstrap 全新技术

获取[下载地址 (劳动所得,不喜勿喷)] [免费支持更新]A 代码生成器(开发利器);全部是源码     增删改查的处理类,service层,mybatis的xml,SQL( mysql   和oracle)脚本,   jsp页面 都生成   就不用写搬砖的代码了,生成的放到项目里,可以直接运行B 阿里巴巴数据库连接池druid;  数据库连接池  阿里巴巴的 druid.Druid在监控.可扩展性.稳定性和性能方面都有明显的优势C 安全权限框架shiro ;  Shiro 是一个用 Java