Шаблон проекта Maven

Maven использует архетипы для создания пользовательских структур проектов, формируя шаблоны проектов Maven.

В предыдущих главах мы узнали, что Maven использует следующую команду для быстрого создания проекта Java:

mvn archetype:generate

Что такое архетип?

Архетип — это прототип, плагин Maven или, точнее, шаблон проекта. Его задача — создать структуру проекта на основе шаблона. Мы будем использовать плагин архетипа quickstart для создания простого приложения Java.

Использование шаблонов проектов

Давайте откроем командную консоль, перейдем в каталог C:\> MVN и выполним следующую команду mvn:

C:\MVN> mvn archetype:generate

Maven начнет обработку и попросит вас выбрать нужный архетип:

[INFO] Scanning for projects...
[INFO] Searching repository for plugin with prefix: 'archetype'.
[INFO] -------------------------------------------------------------------
[INFO] Building Maven Default Project
[INFO]task-segment: [archetype:generate] (aggregator-style)
[INFO] -------------------------------------------------------------------
[INFO] Preparing archetype:generate
...
600: remote -> org.trailsframework:trails-archetype (-)
601: remote -> org.trailsframework:trails-secure-archetype (-)
602: remote -> org.tynamo:tynamo-archetype (-)
603: remote -> org.wicketstuff.scala:wicket-scala-archetype (-)
604: remote -> org.wicketstuff.scala:wicketstuff-scala-archetype 
Basic setup for a project that combines Scala and Wicket,
depending on the Wicket-Scala project. 
Includes an example Specs test.)
605: remote -> org.wikbook:wikbook.archetype (-)
606: remote -> org.xaloon.archetype:xaloon-archetype-wicket-jpa-glassfish (-)
607: remote -> org.xaloon.archetype:xaloon-archetype-wicket-jpa-spring (-)
608: remote -> org.xwiki.commons:xwiki-commons-component-archetype 
(Make it easy to create a maven project for creating XWiki Components.)
609: remote -> org.xwiki.rendering:xwiki-rendering-archetype-macro 
(Make it easy to create a maven project for creating XWiki Rendering Macros.)
610: remote -> org.zkoss:zk-archetype-component (The ZK Component archetype)
611: remote -> org.zkoss:zk-archetype-webapp (The ZK wepapp archetype)
612: remote -> ru.circumflex:circumflex-archetype (-)
613: remote -> se.vgregion.javg.maven.archetypes:javg-minimal-archetype (-)
614: remote -> sk.seges.sesam:sesam-annotation-archetype (-)
Choose a number or apply filter 
(format: [groupId:]artifactId, case sensitive contains): 203:

НажмитеEnterВыберите вариант по умолчанию (203:maven-archetype-quickstart).

Maven запросит версию архетипа

Choose org.apache.maven.archetypes:maven-archetype-quickstart version:
1: 1.0-alpha-1
2: 1.0-alpha-2
3: 1.0-alpha-3
4: 1.0-alpha-4
5: 1.0
6: 1.1
Choose a number: 6:

НажмитеEnterВыберите вариант по умолчанию (6:maven-archetype-quickstart:1.1)

Maven запросит сведения о проекте. Введите сведения о проекте по запросу. Если вы хотите использовать значения по умолчанию, просто нажмите Enter. Вы также можете ввести свои собственные значения.

Define value for property 'groupId': : com.companyname.insurance
Define value for property 'artifactId': : health
Define value for property 'version': 1.0-SNAPSHOT
Define value for property 'package': com.companyname.insurance

Maven попросит вас подтвердить сведения о проекте, нажмитеEnterили нажмите Y

Confirm properties configuration:
groupId: com.companyname.insurance
artifactId: health
version: 1.0-SNAPSHOT
package: com.companyname.insurance
Y:

Теперь Maven начнёт создавать структуру проекта, как показано ниже:

[INFO] -----------------------------------------------------------------------
[INFO] Using following parameters for creating project 
from Old (1.x) Archetype: maven-archetype-quickstart:1.1
[INFO] -----------------------------------------------------------------------
[INFO] Parameter: groupId, Value: com.companyname.insurance
[INFO] Parameter: packageName, Value: com.companyname.insurance
[INFO] Parameter: package, Value: com.companyname.insurance
[INFO] Parameter: artifactId, Value: health
[INFO] Parameter: basedir, Value: C:\MVN
[INFO] Parameter: version, Value: 1.0-SNAPSHOT
[INFO] project created from Old (1.x) Archetype in dir: C:\MVN\health
[INFO] -----------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] -----------------------------------------------------------------------
[INFO] Total time: 4 minutes 12 seconds
[INFO] Finished at: Fri Jul 13 11:10:12 IST 2012
[INFO] Final Memory: 20M/90M
[INFO] -----------------------------------------------------------------------

Созданный проект

Теперь перейдите в каталог C:\ > MVN. Вы увидите проект Java-приложения с именем health, соответствующий artifactId, заданному при создании проекта. Maven создаст проект со стандартной структурой каталогов, как показано ниже:

Создание pom.xml

Maven автоматически создаёт файл pom.xml для проекта, как показано ниже:

<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>com.companyname.insurance</groupId> <artifactId>health</artifactId> <version>1.0-SNAPSHOT</version> <packaging>jar</packaging> <name>health</name> <url>http://maven.apache.org</url> <properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> </properties> <dependencies> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>3.8.1</version> <scope>test</scope> </зависимость> </зависимости> </проект>

App.java

Maven автоматически создаст тестовый Java-файл, App.java.

Путь:C:\MVN\consumerBanking\src\main\java\com\companyname\bank

package com.companyname.insurance; /** * Привет, мир! * */ public class App { public static void main( String[] args ) { System.out.println( "Hello World!" ); } }

AppTest.java

Maven автоматически создаст Java-файл, AppTest.java.

Путь:C:\MVN\consumerBanking\src\test\java\com\companyname\bank

package com.companyname.insurance; import junit.framework.Test; import junit.framework.TestCase; import junit.framework.TestSuite; /** * Модульный тест для простого App. */ public class AppTest extends TestCase { /** * Создать тестовый пример * * @param testName имя тестового примера */ public AppTest( String testName ) { super( testName ); } /** * @return набор тестов, которые тестируются */ public static Test suite() { return new TestSuite( AppTest.class ); } /** * Строгий тест :-) */ public void testApp() { assertTrue( истина ); } }

Вот и всё. Теперь вы можете увидеть мощь Maven. Вы можете использовать простые команды Maven для создания проекта любого типа и начать разработку.

Другие расширения