国产一级a片免费看高清,亚洲熟女中文字幕在线视频,黄三级高清在线播放,免费黄色视频在线看

使用Maven創(chuàng)建應(yīng)用

介紹

將要創(chuàng)建的應(yīng)用名叫Proficio，拉丁語的"help"。

設(shè)置應(yīng)用程序的目錄結(jié)構(gòu)

在設(shè)置Proficio的目錄結(jié)構(gòu)時，注意Maven強(qiáng)調(diào)的實(shí)踐標(biāo)準(zhǔn)化和構(gòu)建模塊化構(gòu)建是很重要的。

這種實(shí)踐自然將產(chǎn)生分離的可重用的開發(fā)工程。決定如何最優(yōu)化的分解應(yīng)用的原則叫做“分離關(guān)注點(diǎn)（Separation of Concerns）”原則，即SoC原則。

SoC有助于識別、封裝、操作于有相關(guān)特殊概念、目標(biāo)、任務(wù)或目的的軟件片段。關(guān)注點(diǎn)是組織和分解軟件的動力，更多的易于管理和理解的部分，每個都用于說明一個或多個特定關(guān)注點(diǎn)。

如上所述，Proficio樣例工程將被設(shè)置為多個Maven模塊：

• Proficio API：Proficio的應(yīng)用編程接口，它包含了一套接口。這些接口是主要組件（例如store）的API。
• Proficio CLI：提供Proficio的命令行接口。
• Proficio Core：API的實(shí)現(xiàn)。
• Proficio Model：Proficio應(yīng)用的數(shù)據(jù)模型，它包含了將被整個Proficio工程所使用的所有的類。
• Proficio Stores：這個模塊處理包含所有的存儲模塊。Proficio有一個簡單的memory-based和XStream-based存儲。

在Proficio的頂層POM中，可以看到所有子模塊元素。一個模塊指向另一個Maven工程，實(shí)際上它是指向另一個POM。Proficio的頂層POM文件如下：

<project><modelVersion>4.0.0</modelVersion><groupId>com.devzuz.mvnbook.proficio</groupId><artifactId>proficio</artifactId><packaging>pom</packaging><version>1.0-SNAPSHOT</version><name>Maven Proficio</name><url>http://maven.apache.org</url>[...]<modules><module>proficio-model</module><module>proficio-api</module><module>proficio-core</module><module>proficio-stores</module><module>proficio-cli</module></modules>[...]</project>

上面的版本號1.0-SNAPSHOT。對于一個有多模塊的應(yīng)用，通常將所有模塊一起發(fā)布，所有模塊使用一個公共的版本號。這是推薦的一種方式。

注意上面的packaging元素，這里它被設(shè)置為pom。對于包含模塊的POM文件，packaging必須設(shè)置為pom：這告訴Maven你準(zhǔn)備創(chuàng)建一個模塊集。

Proficio應(yīng)用的模塊打包類型：

proficio-stores模塊有兩個子模塊。

使用工程繼承

Maven最重要的功能之一就是工程繼承。使用工程繼承允許你在一個地方規(guī)定組織機(jī)構(gòu)信息，規(guī)定部署信息，或規(guī)定通用的依賴。由Proficio工程產(chǎn)生的每個工程的POM文件，每個的頂部都有：

[...]<parent><groupId>com.devzuz.mvnbook.proficio</groupId><artifactId>proficio</artifactId><version>1.0-SNAPSHOT</version></parent>[...]

這個片段允許你從指定的頂層的POM繼承。頂層POM中指定了依賴JUnit 3.8.1。在這種情況下子工程中不再申明這個依賴也可以使用這個包。

為了了解在繼承處理時發(fā)生的東西可以執(zhí)行mvn help:effective-pom命令。這個命令將顯示出最終的POM。在proficio的子工程中執(zhí)行這個命令時可以看到依賴中出現(xiàn)了JUnit 3.8.1。

管理依賴關(guān)系

Maven可以讓不同的工程共享程序包。

可以在頂層的POM中描述所有子工程共享的依賴。

例如Proficio的頂層POM：

<project>[...]<dependencyManagement><dependencies><dependency><groupId>com.devzuz.mvnbook.proficio</groupId><artifactId>proficio-model</artifactId><version>${project.version}</version></dependency><dependency><groupId>com.devzuz.mvnbook.proficio</groupId><artifactId>proficio-api</artifactId><version>${project.version}</version></dependency><dependency><groupId>com.devzuz.mvnbook.proficio</groupId><artifactId>proficio-store-memory</artifactId><version>${project.version}</version></dependency><dependency><groupId>com.devzuz.mvnbook.proficio</groupId><artifactId>proficio-store-xstream</artifactId><version>${project.version}</version></dependency><dependency><groupId>com.devzuz.mvnbook.proficio</groupId><artifactId>proficio-core</artifactId><version>${project.version}</version></dependency><dependency><groupId>org.codehaus.plexus</groupId><artifactId>plexus-container-default</artifactId><version>1.0-alpha-9</version></dependency></dependencies></dependencyManagement>[...]</project>

注意${project.version}指定了版本，它與應(yīng)用的版本對應(yīng)。

在dependencyManagement一節(jié)，有多個Proficio依賴并且還依賴于Plexus IoC container。dependencyManagment元素與頂層POM的dependencies有重要區(qū)別。

dependencyManagement元素中包括的dependencies元素僅用于說明引用的版本號，對并不影響工程的依賴關(guān)系圖，然而頂層的dependencies元素將影響依賴關(guān)系圖。查看proficio-api模塊的POM將只看到引用而沒有指定版本：

<project>[...]<dependencies><dependency><groupId>com.devzuz.mvnbook.proficio</groupId><artifactId>proficio-model</artifactId></dependency></dependencies></project>

這個依賴的版本號是從Proficio的頂層POM文件的dependencyManagement繼承過來的。 dependencyManagement指定了引用proficio-model的版本號為1.0-SNAPSHOT（被設(shè)置為${project.version}）這個版本號將注入到上面的依賴中。dependencyManagement中說明的dependencies 只用于當(dāng)某個依賴沒有版本號的情況。

使用快照

當(dāng)開發(fā)的應(yīng)用具有多個模塊時，通常每個模塊的版本都在變更。API可能正在經(jīng)歷變遷或你的實(shí)現(xiàn)正在發(fā)生改變，或者在進(jìn)行重構(gòu)。你在構(gòu)建時需要非常容易的實(shí)時獲取最新版本，這是Maven的快照（snapshot）的概念?？煺帐荕aven的一個artifact。查看 Proficio的頂層POM可以看到指定了快照版本。

<project>[...]<version>1.0-SNAPSHOT</version><dependencyManagement><dependencies><dependency><groupId>com.devzuz.mvnbook.proficio</groupId><artifactId>proficio-model</artifactId><version>${project.version}</version></dependency><dependency><groupId>com.devzuz.mvnbook.proficio</groupId><artifactId>proficio-api</artifactId><version>${project.version}</version></dependency><dependency><groupId>org.codehaus.plexus</groupId><artifactId>plexus-container-default</artifactId><version>1.0-alpha-9</version></dependency></dependencies></dependencyManagement>[...]</project>

指定快照版本作為依賴時Maven將會查找新版本而不像手工指定版本時那樣操作?？煺找蕾嚰俣偸窃谧兏?，因此 Maven將嘗試更新它們。默認(rèn)情況下Maven將以天為單位查找新版本，但你可以使用命令行參數(shù)-U來強(qiáng)制它查找新版本。當(dāng)指定非快照的依賴時 Maven將下載依賴并且不會進(jìn)行重試。

解決依賴沖突和使用版本號范圍

在Maven 2.0中通過引入依賴傳遞，使得可以在簡單的POM文件中只指定你直接需要的依賴，并且Maven可以計(jì)算出完整的依賴關(guān)系圖。但是，隨著圖的增漲，不可避免的將產(chǎn)生一個或多個artifacts需要依賴的不同版本。這種情況下，Maven必須選擇使用哪個版本。

Maven通常選擇這個關(guān)系樹中頂層的“最接近的版本（nearest）”，Maven選擇版本號跨度最小的版本。如果在POM中指定了版本，則將被使用而不管其它的原因。但這種方式也有下面的限制：

• 選擇的版本可能沒有某個依賴的組件所需要的功能。
• 如果在相同的級別先擇了多個不同的版本，則結(jié)果將是不明確的。

手工解決沖突，可以從依賴樹中移除不正確的版本，或者可以用正確的版本來覆蓋掉樹中的版本。移除不正確的版本需要在運(yùn)行Maven時指定-X標(biāo)識來找出不正確的版本。例如，如果在proficio-core模塊運(yùn)行mvn -X test將輸出：

proficio-core:1.0-SNAPSHOTjunit:3.8.1 (selected for test)plexus-container-default:1.0-alpha-9 (selected for compile)plexus-utils:1.0.4 (selected for compile)classworlds:1.1-alpha-2 (selected for compile)junit:3.8.1 (not setting scope to compile; local scope test wins)proficio-api:1.0-SNAPSHOT (selected for compile)proficio-model:1.0-SNAPSHOT (selected for compile)plexus-utils:1.1 (selected for compile)

這樣可以找出當(dāng)前操作所使用的詳細(xì)版本信息，一旦找出了不正確的版本，你可以將它從依賴關(guān)系圖中移除。例如，這個例子中，plexus-utils出現(xiàn)了兩次，Proficio需要1.1版。為確保這個依賴，可以修改plexus-container-default的依賴，例如：

<dependency><groupId>org.codehaus.plexus</groupId><artifactId>plexus-container-default</artifactId><version>1.0-alpha-9</version><exclusions><exclusion><groupId>org.codehaus.plexus</groupId><artifactId>plexus-utils</artifactId></exclusion></exclusions></dependency>

這保證了Maven將忽略1.04版的plexus-utils，而使用1.1版。

另一種方法確保在依賴中使用特定版本，是將它直接包含在POM中，例：

<dependencies><dependency><groupId>org.codehaus.plexus</groupId><artifactId>plexus-utils</artifactId><version>1.1</version><scope>runtime</scope></dependency></dependencies>

但是這種方式是不被推薦的除非你是在制作一個綁定了自己的依賴的artifact，并且它自身不會作為一個依賴（例如，是一個WAR文件）。原因是這種做法歪曲了真實(shí)的依賴關(guān)系圖，在工程自身作為依賴被重用時將導(dǎo)致問題。

在這里指定了runtime作用范圍。這是因?yàn)?，在這種情況下，依賴只是用于打包而不是編譯。實(shí)際上，如果依賴是在編譯時需要，它應(yīng)該總是出現(xiàn)在當(dāng)前POM的依賴中——而不管另一個依賴是否使用了它。

上面的這些解決都只是理想化的，但它可以提高你自己的依賴的質(zhì)量，避免你在構(gòu)建自己的產(chǎn)品時的風(fēng)險。這一點(diǎn)在構(gòu)建一個應(yīng)用程序框架時是非常重要的，因?yàn)樗鼘V泛的被其它人使用。為達(dá)到這個目標(biāo)，可以使用版本范圍來替代這種方式。

當(dāng)上面的plexus-utils的版本被設(shè)置為1.1時，標(biāo)明首選依賴的是1.1版，但其它版本可能也能夠接受。Maven并不知道哪個版本可以工作，因此當(dāng)與其它依賴沖突時，Maven確保所有的版本使用前面描述的“最近依賴（nearest dependency）”技術(shù)來決定使用哪個版本。

但是，你可能需要一個plexus-utils 1.1版中的功能。這時，依賴應(yīng)該指定為下面的形式：

<dependency><groupId>org.codehaus.plexus</groupId><artifactId>plexus-utils</artifactId><version>[1.1,)</version></dependency>

這表示在版本沖突時仍將使用nearest dependency技術(shù)，但是版本號必須符合給定的范圍。如果版本不匹配，則下一個最接近的版本將被測試，如此繼續(xù)。最后，如果沒有匹配的版本，或本來就沒有沖突，則使用指定的版本[1.1,)。這表示將從倉庫中獲取最小的版本號大于或等于1.1的版本。

版本范圍范例表：

通過指定使用的版本范圍，使得構(gòu)建時依賴管理機(jī)制更加可靠并且減少異常的情況。但應(yīng)該避免過度的詳細(xì)。例如，如果兩個版本范圍依賴圖不交叉，那么構(gòu)建將失敗。

為了解版本范圍是如何工作的，需要了解版本是怎樣進(jìn)行比較的。下面展示了Maven是如何分割版本號的。

1.0.1-20060211.131141-1

從左至右依次為：

1為主版本號

0為次版本號

1為Bug修正號

20060211.131141為限定版本號

1為構(gòu)建號

在目前的版本方案中，快照版本是一種特殊的情況，在這種情況下限定號和構(gòu)建號可以同時存在。在正式版本中，可以只提供限定號或只提供構(gòu)建號。有意設(shè)置的限定號標(biāo)識出了一個較優(yōu)先的版本（例如：alpha-1，beta-1，rc1）。對于快照版本，限定號必須是文本“snapshot”或時間戳。構(gòu)建號是一個自增號在發(fā)布時標(biāo)明是補(bǔ)丁構(gòu)建。

版本中的元素依次決定哪個版本較新——首先是主版本號，如果主版本號相等，則比較次版本號，接下來是Bug修正號，限定號，最后比較構(gòu)建號。帶限定號的版本比不帶限定號的版本要舊；比如1.2-beta比1.2舊。包含了構(gòu)建號的版本比不帶構(gòu)建號的版本新；比如1.2-beta-1比1.2- beta新。某些情況下，版本可能會不匹配這個語法。在這些情況下，兩個版本號將作為字符串進(jìn)行比較。

當(dāng)使用快照版本測試編譯發(fā)布版本或自己測試發(fā)布測試版本時應(yīng)該將它們部署到快照倉庫，這將在第七章討論。這保證了在版本范圍中的beta版本才會使用，除非工程顯式的申明了使用快照版本。

最后要注意的是當(dāng)使用版本范圍時版本更新是如何被決定的。這個機(jī)制與前面介紹的快照版本更新機(jī)制是相同的，即每天從版本庫中更新一次版本。但是，這可以通過配置每個倉庫來設(shè)置更新的頻率，或在命令行使用-U參數(shù)強(qiáng)制Maven執(zhí)行更新。

例：

<repository>[...]<releases><updatePolicy>interval:60</updatePolicy></releases></repository>

利用構(gòu)建生命周期

第二章中將Maven描述為一個正確調(diào)整插件執(zhí)行方式或順序的應(yīng)用框架，這實(shí)際上就是Maven的默認(rèn)構(gòu)建生命周期。 Maven默認(rèn)的構(gòu)建生命周期對于大多數(shù)工程來說不需要增加任何內(nèi)容就可以滿足了——當(dāng)然，有時工程需要增加不同的內(nèi)容到Maven的默認(rèn)構(gòu)生命周期來滿足構(gòu)建的需求。

例如，Proficio需要從model生成Java源碼。Maven通過允許申明插件來滿足這個需求，將它綁定到Maven默認(rèn)生命周期的一個標(biāo)準(zhǔn)階段——generate-sources階段。

Maven的插件是為特定任務(wù)而創(chuàng)建的，這意味著插件將被綁定到默認(rèn)的生命周期的一個特定階段。在Proficio中，Modello插件被用于生成Proficio的數(shù)據(jù)模型的Java源碼。查看proficio-model的POM可以看到plugins元素配置了Modello插件。

<project><parent><groupId>com.devzuz.mvnbook.proficio</groupId><artifactId>proficio</artifactId><version>1.0-SNAPSHOT</version></parent><modelVersion>4.0.0</modelVersion><artifactId>proficio-model</artifactId><packaging>jar</packaging><name>Proficio Model</name><build><plugins><plugin><groupId>org.codehaus.modello</groupId><artifactId>modello-maven-plugin</artifactId><version>1.0-alpha-5</version><executions><execution><goals><goal>java</goal></goals></execution></executions><configuration><version>1.0.0</version><packageWithVersion>false</packageWithVersion><model>src/main/mdo/proficio.mdo</model></configuration></plugin></plugins></build></project>

這與第二章中maven-compiler-plugin的申明非常相似，但這里可以看到額外的execution元素。Maven中的插件可以有多個goal，因此你需要指定你希望運(yùn)行插件的哪個goal，這可以通過在execution中的goal元素來指定。

使用Profiles

Profile是Maven提供的用于創(chuàng)建構(gòu)建生命周期中的不同環(huán)境變量、不同的平臺、不同JVM、不同的測試數(shù)據(jù)庫、或引用不同的本地文件系統(tǒng)的方法。通常你可以在POM中封裝，以保證構(gòu)建的可移植性，但有時你需要考慮變化的交叉系統(tǒng)的情況，這也是Maven中引入 profile的原因。

Profile使用POM中的一個子集元素來指定，可以用多種方式來啟用。Profile在構(gòu)建時修改POM，意味著它將用于給不同的目標(biāo)環(huán)境中的參數(shù)集（比如，在開發(fā)環(huán)境、測試環(huán)境、產(chǎn)品環(huán)境下應(yīng)用服務(wù)器根路徑）不同參數(shù)值。

Profile也可以很容易的實(shí)現(xiàn)團(tuán)隊(duì)中不同成員生成不同的構(gòu)建結(jié)果。也可以通過profile阻止構(gòu)建的移植性。Profile可以定義在下面三個地方：

• Maven的配置文件（通常是<user_home>/.m2/settings.xml）
• 與POM同一目錄下的名為profiles.xml的文件
• POM文件中

優(yōu)先級依次為POM文件、profiles.xml、settings.xml。這也是Maven中的基本原則。

settings.xml中設(shè)置profile會影響所有的構(gòu)建，因此它適合“全局”的profiles。profiles.xml允許設(shè)置單個工程的構(gòu)建而不用修改POM?；赑OM的profiles是首選方式，因?yàn)檫@樣更具有移植性（它們將在布署時發(fā)布到倉庫，對于源于倉庫的子構(gòu)建或依賴來說也同樣有效）。

因?yàn)橐浦残缘脑?，那些不會發(fā)布到倉庫中的文件不允許修改任何基礎(chǔ)構(gòu)建。因此，profiles.xml和settings.xml只允許定義：

• 倉庫repositories
• 插件倉庫pluginRepositories
• 屬性properties

其它的信息必須在POM的profile中指定或在POM自身指定。例如，如果settings.xml中有一個profile它可以注入一個依賴，你的工程運(yùn)行需要settings注入的依賴，一旦這個工程部部署到倉庫中它將不能解決它的依賴。因?yàn)槠渲幸粋€依賴設(shè)置在settings.xml的 profile中了。

注意：respositories、pluginRepositories和properties也可以在POM內(nèi)部的profiles指定。因此，在POM外部指定的profiles只允許使用POM內(nèi)部指定的profiles選項(xiàng)的一個小的子集。

可以在POM中定義的profile：

• repositories
• pluginRepositories
• dependencies
• plugins
• properties(not actually available in the main POM, but used behind the scenes)
• modules
• reporting
• dependencyManagement
• distributionManagement

構(gòu)建元素的子集，由下面組成：

• defaultGoal
• resources
• testResources
• finalName

有多種方法啟用profiles：

• 在命令行上使用-P選項(xiàng)。這個選項(xiàng)接收以逗號名分隔的profile的id列表。當(dāng)指定這個選項(xiàng)時，這些指定在參數(shù)中的profiles將被激活。例：

mvn -Pprofile1,profile2 install

• Profiles可以在Maven settings文件通過activeProfiles段中激活。這段接收activeProfile元素的列表，每個都包括了一個profile-id。注意你必須在settings.xml文件中定義了這些profiles。例：

<settings>[...]<profiles><profile><id>profile1</id>[...]</profile></profiles><activeProfiles><activeProfile>profile1</activeProfile></activeProfiles>[...]</settings>

• Profiles可以在檢測到構(gòu)建環(huán)境時自動觸發(fā)。這些在profile的activation段設(shè)置。目前這種檢測僅限于匹配JDK版本號的前綴、當(dāng)前系統(tǒng)屬性或系統(tǒng)屬性的值。例如：

<profile><id>profile1</id>[...]<activation><jdk>1.4</jdk></activation></profile>

這個激器將在JDK的版本以1.4開始時被觸發(fā)。

<profile><id>profile1</id>[...]<activation><property><name>debug</name></property></activation></profile>

上面的profile將在系統(tǒng)屬性debug被指定時被觸發(fā)。

<profile><id>profile1</id>[...]<activation><property><name>environment</name><value>test</value></property></activation></profile>

最后的這個例子將在系統(tǒng)屬性environment屬性設(shè)置為true時激活。

在熟悉profiles后，可以使用它組裝不同的Proficio系統(tǒng)：一個配置方案是memory-base存儲，另一個是XStream-based存儲。這些將在proficio-cli模塊中使用。proficio-cli模塊的profile定義如下：

<project>[...]<!-- Profiles for the two assemblies to create for deployment --><profiles><!-- Profile which creates an assembly using the memory based store --><profile><id>memory</id><build><plugins><plugin><artifactId>maven-assembly-plugin</artifactId><configuration><descriptors><descriptor>src/main/assembly/assembly-store-memory.xml</descriptor></descriptors></configuration></plugin></plugins></build><activation><property><name>memory</name></property></activation></profile><!-- Profile which creates an assembly using the xstream based store --><profile><id>xstream</id><build><plugins><plugin><artifactId>maven-assembly-plugin</artifactId><configuration><descriptors><descriptor>src/main/assembly/assembly-store-xstream.xml</descriptor></descriptors></configuration></plugin></plugins></build><activation><property><name>xstream</name></property></activation></profile></profiles></project>

可以看到兩個profiles：一個id為memory另一個id為xstream。在每個profile中你可以配置插件。也可以看到profile通過一個系統(tǒng)屬性進(jìn)行激活。這個例子依賴于前面已經(jīng)執(zhí)行過的一些構(gòu)建步驟，因此應(yīng)該先在工程的頂級目錄執(zhí)行mvn install確保需要的組件被安裝到本地倉庫。

如果想基于memory-based存儲進(jìn)行構(gòu)建，可以執(zhí)行：

mvn -Dmemory clean assembly:assembly

如果想基于XStream-based存儲進(jìn)行，可以執(zhí)行：

mvn -Dxstream clean assembly:assembly

這兩種方式構(gòu)建的結(jié)果都保存在target目錄中，如果對輸出使用jar tvf命令，可以看到memory-base方式構(gòu)建時只包含了proficio-store-memory-1.0-SNAPSHOT.jar，當(dāng)使用 XStream-based方式時，只包含了proficio-store-xstream-1.0-SNAPSHOT.jar。

部署應(yīng)用

當(dāng)前Maven支持多種部署方式包括文件系統(tǒng)部署、SSH2部署、SFTP部署、FTP部署和外部SSH部署。為了進(jìn)行部署，需要正確的配置POM中的distributionManagement元素，通常是在頂級POM中，因?yàn)樽覲OM可以繼承這些信息。

文件系統(tǒng)部署

<project>[...]<distributionManagement><repository><id>proficio-repository</id><name>Proficio Repository</name><url>file://${basedir}/target/deploy</url></repository></distributionManagement>[...]</project>

SSH2部署

<project>[...]<distributionManagement><repository><id>proficio-repository</id><name>Proficio Repository</name><url>scp://sshserver.yourcompany.com/deploy</url></repository></distributionManagement>[...]</project>

SFTP部署

<project>[...]<distributionManagement><repository><id>proficio-repository</id><name>Proficio Repository</name><url>sftp://ftpserver.yourcompany.com/deploy</url></repository></distributionManagement>[...]</project>

外部SSH部署

前面三個部署方式是包含在Maven內(nèi)部的，因此只需要distributionMangement元素，但使用外部SSH命令部署則還要使用一個構(gòu)建擴(kuò)展。

<project>[...]<distributionManagement><repository><id>proficio-repository</id><name>Proficio Repository</name><url>scpexe://sshserver.yourcompany.com/deploy</url></repository></distributionManagement><build><extensions><extension><groupId>org.apache.maven.wagon</groupId><artifactId>wagon-ssh-external</artifactId><version>1.0-alpha-6</version></extension></extensions></build>[...]</project>

這個構(gòu)建擴(kuò)展指定使用Wagon外部SSH提供都，它將你的文件移動到遠(yuǎn)程服務(wù)器上。Wagon是Maven中通用的用于傳送的機(jī)制。

FTP部署

FTP部署也必須指定一個構(gòu)建擴(kuò)展。

<project>[...]<distributionManagement><repository><id>proficio-repository</id><name>Proficio Repository</name><url>ftp://ftpserver.yourcompany.com/deploy</url></repository></distributionManagement><build><extensions><extension><groupId>org.apache.maven.wagon</groupId><artifactId>wagon-ftp</artifactId><version>1.0-alpha-6</version></extension></extensions></build>[...]</project>

一旦配置完P(guān)OM后，可以執(zhí)行

mvn deploy

進(jìn)行部署。

為應(yīng)用程序創(chuàng)建Web站點(diǎn)

前面已經(jīng)完成了Proficio的構(gòu)建、測試、部署，現(xiàn)在可以為這個應(yīng)用創(chuàng)建一個標(biāo)準(zhǔn)的Web站點(diǎn)。對于Procio這樣的應(yīng)，推薦在頂級目錄創(chuàng)建用于生成站點(diǎn)的資源目錄。

所有用于生成站點(diǎn)的文件保存在src/site目錄。src/site目錄中也有子目錄保存支持文檔。Maven支持大量同的文件格式。

當(dāng)前支持得最好的格式：

• XDOC格式，它是一個被Apache廣泛使用的簡單的XML格式。
• APT（Almost Plain Text）,與wiki格式類似的格式。
• FML格式，F(xiàn)AQ格式。一個簡單的XML格式管理FAQ。
• DocBook Simple格式，它是一個比完整的DocBook格式簡單一些的格式。

Maven也有限的支持：

• Twiki格式，這是一種流行的Wiki格式。
• Confluence格式，這是另一種流行的Wiki格式。
• DocBook格式。

在后面的章節(jié)將了解支持較好的那些格式，但你應(yīng)該熟悉下面的目標(biāo)：

• 配置banner的外觀。
• 配置站點(diǎn)的皮膚。
• 配置發(fā)布數(shù)據(jù)的格式。
• 配置banner下顯示的鏈接。
• 配置放入生成的頁面的<head/>元素中的信息。
• 配置顯示在導(dǎo)航欄中的菜單項(xiàng)。
• 配置項(xiàng)目報(bào)表的外觀。

查看Proficio應(yīng)用的src/site可以看到站點(diǎn)的描述：

<project name="Proficio"><bannerLeft><name>Proficio</name><href>http://maven.apache.org/</href></bannerLeft><bannerRight><name>Proficio</name><src>http://maven.apache.org/images/apache-maven project.png</src></bannerRight><skin><groupId>org.apache.maven.skins</groupId><artifactId>maven-default-skin</artifactId><version>1.0-SNAPSHOT</version></skin><publishDate format="dd MMM yyyy" /><body><links><item name="Apache" /><item name="Maven" /><item name="Continuum" /></links><head><meta name="faq" content="proficio"/></head><menu name="Quick Links"><item name="Features" href="/maven-features.html"/></menu><menu name="About Proficio"><item name="What is Proficio?" href="/what-is-maven.html"/></menu>${reports}</body></project>

這是一個相當(dāng)標(biāo)準(zhǔn)的Web站點(diǎn)描述，每個元素的說明如下：

Maven中最流行的功能之一就是花較少的功夫就可以生成標(biāo)準(zhǔn)的報(bào)表。只要簡單的在站點(diǎn)描述中包含${reports}引用，默認(rèn)情況下是包含的，工程信息報(bào)表將自動生成的被添加上來。標(biāo)準(zhǔn)的工程信息報(bào)表包含下面的內(nèi)容：

• 依賴關(guān)系報(bào)告
• 郵件列表報(bào)告
• 持續(xù)集成報(bào)告
• 源碼倉庫報(bào)告
• 發(fā)行版本跟蹤報(bào)告
• 工程團(tuán)隊(duì)報(bào)告
• 版權(quán)

盡管標(biāo)準(zhǔn)報(bào)表很有用，通常你需要自定義工程的報(bào)表。報(bào)表的創(chuàng)建和顯示控制是在POM的build/reports元素中。你可以選擇生成報(bào)表的信息，只要列舉出需要包含在站點(diǎn)中的報(bào)表即可。這個插件的配置方式如下：

<project>[...]<reporting>[...]<plugins><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-project-info-reports-plugin</artifactId><reportSets><reportSet><reports><report>dependencies</report><report>project-team</report><report>mailing-list</report><report>cim</report><!--Issue tracking report will be omitted<report>issue-tracking</report>--><report>license</report><report>scm</report></reports></reportSet></reportSets></plugin></plugins>[...]</reporting>[...]</project>

執(zhí)行

mvn site

生成站點(diǎn)。

生成的站點(diǎn)放在target目錄下。如果有其它的資源，如圖片、PDF等可以存放在src/site/resources。當(dāng)站點(diǎn)被生成時src/site/resources將被復(fù)制到站點(diǎn)的頂級目錄。