简介
我们知道利用Maven创建项目可以基于现有的模型创建,这样可以省去很多项目创建过程,比如前面几篇文章也曾经提到基于maven-archetype-quickstart 或 maven-archetype-webapp 快速创建普通的java项目或web项目。
那么如何创建我们自己的项目原型呢?
Maven为创建项目原型提供了便利,可以直接通过现有项目创建自定义原型项目,然后发布到服务器上,之后就可以使用这个自定义的原型创建项目了。
本文将介绍如何创建一个自定义的WebApp项目。
创建项目
创建普通的Maven WebApp
首先创建一个普通的maven webapp项目,名称为:charley-bootstrap-webapp。
在这个项目中,我们预先添加好BootStrap组件,并提供一个引用BootStrap的模版页。
项目结构如下:
修改jsp模版页index.jsp
在模版页中,我们引入BootStrap的样式文件和脚本文件。
<%@ page contentType="text/html;charset=UTF-8" language="java" isELIgnored="false" %>
<%
String path = request.getContextPath();
String basePath = request.getScheme() + "://"
+ request.getServerName() + ":" + request.getServerPort()
+ path + "/";
%>
<html>
<head>
<base href="<%=basePath%>"/>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<!--页面标题-->
<title>Title</title>
<!--页面Logo-->
<link rel="shortcut icon" href="<%=basePath%>images/voicecyber.ico"/>
<!--引入bootstrap样式-->
<link href="<%=basePath%>bootstrap/css/bootstrap.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<div class="container">
<h1>Welcome, this is Bootstrap WebApp</h1>
</div>
<!--引入jquery脚本-->
<script src="<%=basePath%>bootstrap/js/jquery.js" type="text/javascript"></script>
<!--引入bootstrap脚本-->
<script src="<%=basePath%>bootstrap/js/bootstrap.js" type="text/javascript"></script>
</body>
</html>
配置pom文件
在pom文件中添加几个maven插件,如下:
<build>
<finalName>charley-bootstrap-webapp</finalName>
<pluginManagement>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-archetype-plugin</artifactId>
<version>2.2</version>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<source>1.5</source>
<target>1.5</target>
</configuration>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-resources-plugin</artifactId>
<configuration>
<encoding>utf-8</encoding>
</configuration>
</plugin>
</plugins>
</pluginManagement>
</build>
注:这几个插件可以对原型项目进行详细的配置,具体可以参考各个插件的说明。当然如果这几个插件没有配置,也没有太大关系,Maven将使用默认的方式构建。
至此,我们的web项目就创建好了,下面使用maven创建原型项目。
Maven中创建原型项目
基于现有项目创建原型项目
启动命令行,cd 到charleybootstrapwebapp目录下,然后输入以下命令:
mvn archetype:create-from-project
我们可以看到,在项目的target目录有个generated-sources目录,里面有个archetype目录,这个目录就是原型项目,我们可以使用Idea打开这个项目。
项目结构如下:
安装原型项目
命令行中,cd 到原型项目路径下,然后输入以下命令:
mvn install
这样就将原型项目安装到本地仓库中了。
注意,原型项目只能为本机使用,若项目在其他机器使用这个原型项目,需要把原型项目发布到服务器上。
发布Maven 原型项目
Pom中配置发布位置
首先,需要配置项目的发布位置。打开pom.xml,加入以下配置信息:
<distributionManagement>
<repository>
<id>nexus-releases</id>
<name>nexus releases repository</name>
<url>http://192.168.6.59:8081/repository/maven-releases/</url>
</repository>
<snapshotRepository>
<id>nexus-snapshots</id>
<name>nexus snapshots repository</name>
<url>http://192.168.6.59:8081/repository/maven-snapshots/</url>
</snapshotRepository>
</distributionManagement>
这里我准备把原型项目发布到位于192.168.6.59上的仓库,注意,一般nexus服务器上提供有两个Repository可供部署发布的项目,一个是Release,一个是Snapshot。如果项目的版本带有SNAPSHOT,如:1.0-SNAPSHOT,那么发布的时候将会部署到Snapshot仓库中。
发布原型项目
使用以下命令发布项目:
mvn deploy
登录到nexus,我们可以查看刚刚发布的原型项目 charley-bootstrap-webapp-archetype。
基于原型项目创建新项目
现在,基于刚刚创建的原型项目常见一个新项目charleymavenweb02。
与一般的创建Maven项目基本一致,只是在选择项目原型的时候,需要将刚刚我们发布的原型项目添加进去。
然后输入原型项目的坐标信息即可。
PS,如果想从原型列表中移除某个自定义的原型,可以到Idea目录,如:C:\Users\Charley.IntelliJIdea2016.3\system\Maven\Indices下,修改文件UserArchetypes.xml,把想要移除的原型项目删掉即可。
注意:在创建项目的最后,IDEA可能弹出一个提示框:
一般点击 No,然后打开 Project Structure 查看 Artifacts,可以看到 IDEA 为我们另外创建了charleymavenweb02:war 和 charleymavenweb02:war expoloded 两个部署包,选择 charleymavenweb02:war expoloded 修改一下输出目录,并且勾上 Include in project build 复选框。
如果上一步点击的是 Yes,那么 IDEA 不会再创建 charleymavenweb02:war 和 charleymavenweb02:war expoloded 。Artifacts里只有以原型项目命名的部署包,显然使用这个名称不恰当。
创建完成之后,新项目的结构如下:
可以看到,bootstrap相关的文件已经添加到新项目中了。