Java Web 學習筆記(五) 創建自定義的Maven項目原型

簡介

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

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章