簡介
我們知道利用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相關的文件已經添加到新項目中了。