Maven学习笔记(十一)-创建自定义的archetype(项目模板)
2017-07-16 12:32
357 查看
一、archetype简介
Archetype是一个Maven项目的模板工具包,它定义了一类项目的基本架构。Archetype为开发人员提供了创建Maven项目的模板,同时它也可以根据已有的Maven项目生成参数化的模板。通过archetype,开发人员可以很方便地将一类项目的最佳实现应用到自己的项目中。在一个Maven项目中,开发者可以通过archetype提供的范例快速入门并了解该项目的结构与特点。
Maven Archetype由下面几个模块组成:
maven-archetype-plugin:Archetype插件。通过该插件,开发者可以在Maven中使用Archetype。
archetype-packaging:用于描述archetype的生命周期与构建项目软件包
archetype-models:用于描述类与引用
archetype-common:核心类
archetype-testing:用于测试Maven Archetype的内部组件
下图是官方提供的Archetype的生命周期:
Archetype插件有四个目标可以直接使用:
archetype:create(不推荐):从archetype 中创建一个Maven项目。
archetype:generate:从archetype 中创建一个Maven项目,需要开发人员在指定archetype,插件会从远程仓库中自动获取。
archetype:create-from-project:从已有的项目中生成archetype。
archetype:crawl:搜索并更新仓库中的archetype。
二、Archetype工程的组成
一个典型的archetype包含如下组成部分:
1)Archetype descriptor(archetype.xml),这个文件位于路径src/main/resources/META-INF/maven/,它列出了原型中包含的所有文件,并且给他们做了分类以便Archetype的生成机制可以正确的处理它们;
2)Archetype插件将要拷贝的原型文件,位于路径,src/main/resources/archetype-resources/
3)pom.xml原型文件,位于路径:src/main/resources/archetype-resources
4)这个工程本身自己的pom.xml
三、如何生成Archetype
有两种方法来创建Archetyp,第一种是通过已有的项目来创建,第二种是通过mvn archetype:generate创建一个简单的JAVA项目或WEB项目,然后进行改造。
这里就以SSM框架为例,来演示第一种方法,如何生成一个SSM骨架,至于如何搭建SSM框架,可参考看我这篇文章:http://blog.csdn.net/u011781521/article/details/53725788 也可以直接下载我提供的示例,然后解压
解压之后,修改POM.XML文件为如下:
往里面添加maven-archetype-plugin,Maven-resources-plugins,maven-compiler-plugin插件。所以一般可先创建所需的maven项目,然后利用archetype plugin的create-from-project将maven项目将该maven项目生成为archetype类型项目。生成maven项目后并确定定型后,执行:
注意:
在执行上面命令之前最好,把这一些.setting, .class, .project的文件删除掉,因为这是多余的,所以我们在搭建好样板工程之后,在使用mvn archetype:create-from-project命令之前,要先把项目中不相关的工程文件、中间文件删除。
生成的archetype在此路径下:
此时会在该项目的target目录下发现如下文件:
四、生成Archetype如何安装
在上文创建了archetype之后,进入到target\generate-sources\archetype目录,然后在命令行执行:
安装该archetype项目到你的本地仓库,输出如下信息,特别是Build Success这段,表示就安装成功了。
安装之后主要做了一件事情:
1) 将文件安装到mvn缓存目录,在我本机就是G:\MavenRepository\com\fendo\ssm\fendo-SSM,该文件夹下的目录结构如下:
| maven-metadata-local.xml
|
\---0.0.1-SNAPSHOT
fendo-SSM-0.0.1-SNAPSHOT.jar
fendo-SSM-0.0.1-SNAPSHOT.pom
maven-metadata-local.xml
_remote.repositories
在target\generate-sources\archetype目录中执行crawl命令,生成archetype-catalog.xml:
执行成功后会在G:\MavenRepository\archetype-catalog.xml中多出来一个骨架配置文件:
五、使用上自定义archetype
有2种使用方式:
1)通过命令行使用
找到一个空目录,然后执行如下命令:
此时会给出上文安装的archetype,选择即可,如下:
输入编号,就可以了,这里就输入"2",选择SSM,然后输入GroupId,artifactId,就可以了
2)通过eclipse使用
因为G:\MavenRepository\archetype-catalog.xml是新创建的,所以需要在ecliplse的 file -》new-》maven projects对话框中,在选择archetype页面上,如下图
选择本地的archetype-catalog.xml
选择好之后,点击OK
然后点击Next
点击Finish,创建之后如下
默认是JAVA项目,还要把它转换成WEB项目,项目右键---->Project Facets
输入src/main/webapp然后点击OK,然后再点击Applay。然后编辑Deployment Assembly
把Maven的JAR配置进去.
然后点击Applay,运行项目访问
六、archetype命令
1.帮助命令:
2.爬取一个maven仓库,创建目录文件:
3.根据一个工程,创建一个新的archetype:
4.根据一个archetype,创建一个新的工程:
5.根据当前的archetype工程,创建一个jar包:
6.更新本地的maven目录:
参考地址: http://maven.apache.org/guides/mini/guide-creating-archetypes.html
Archetype是一个Maven项目的模板工具包,它定义了一类项目的基本架构。Archetype为开发人员提供了创建Maven项目的模板,同时它也可以根据已有的Maven项目生成参数化的模板。通过archetype,开发人员可以很方便地将一类项目的最佳实现应用到自己的项目中。在一个Maven项目中,开发者可以通过archetype提供的范例快速入门并了解该项目的结构与特点。
Maven Archetype由下面几个模块组成:
maven-archetype-plugin:Archetype插件。通过该插件,开发者可以在Maven中使用Archetype。
archetype-packaging:用于描述archetype的生命周期与构建项目软件包
archetype-models:用于描述类与引用
archetype-common:核心类
archetype-testing:用于测试Maven Archetype的内部组件
下图是官方提供的Archetype的生命周期:
Archetype插件有四个目标可以直接使用:
archetype:create(不推荐):从archetype 中创建一个Maven项目。
archetype:generate:从archetype 中创建一个Maven项目,需要开发人员在指定archetype,插件会从远程仓库中自动获取。
archetype:create-from-project:从已有的项目中生成archetype。
archetype:crawl:搜索并更新仓库中的archetype。
二、Archetype工程的组成
一个典型的archetype包含如下组成部分:
1)Archetype descriptor(archetype.xml),这个文件位于路径src/main/resources/META-INF/maven/,它列出了原型中包含的所有文件,并且给他们做了分类以便Archetype的生成机制可以正确的处理它们;
2)Archetype插件将要拷贝的原型文件,位于路径,src/main/resources/archetype-resources/
3)pom.xml原型文件,位于路径:src/main/resources/archetype-resources
4)这个工程本身自己的pom.xml
三、如何生成Archetype
有两种方法来创建Archetyp,第一种是通过已有的项目来创建,第二种是通过mvn archetype:generate创建一个简单的JAVA项目或WEB项目,然后进行改造。
这里就以SSM框架为例,来演示第一种方法,如何生成一个SSM骨架,至于如何搭建SSM框架,可参考看我这篇文章:http://blog.csdn.net/u011781521/article/details/53725788 也可以直接下载我提供的示例,然后解压
解压之后,修改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/maven-v4_0_0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.fendo.ssm</groupId> <artifactId>fendo-SSM</artifactId> <packaging>jar</packaging> <version>0.0.1-SNAPSHOT</version> <name>fendo-SSM Maven Webapp</name> <url>http://maven.apache.org</url> <!-- 初始化框架的版本号 --> <properties> <spring.version>4.3.3.RELEASE</spring.version> </properties> <pluginRepositories> <pluginRepository> <id>alfresco-public</id> <url>https://artifacts.alfresco.com/nexus/content/groups/public</url> </pluginRepository> <pluginRepository> <id>alfresco-public-snapshots</id> <url>https://artifacts.alfresco.com/nexus/content/groups/public-snapshots</url> <snapshots> <enabled>true</enabled> <updatePolicy>daily</updatePolicy> </snapshots> </pluginRepository> <pluginRepository> <id>beardedgeeks-releases</id> <url>http://beardedgeeks.googlecode.com/svn/repository/releases</url> </pluginRepository> </pluginRepositories> <dependencies> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>3.8.1</version> </dependency> <!-- 加入ServletAPI --> <!-- https://mvnrepository.com/artifact/javax.servlet/javax.servlet-api --> <dependency> <groupId>javax.servlet</groupId> <artifactId>servlet-api</artifactId> <version>2.3</version> <scope>provided</scope> </dependency> <!-- MySQL依赖 start --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>5.1.38</version> </dependency> <!-- MySQL依赖 end --> <!-- 加入MyBatis 依赖 start --> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>3.2.5</version> </dependency> <!-- 加入MyBatis 依赖 end --> <!-- Log4j start --> <dependency> <groupId>log4j</groupId> <artifactId>log4j</artifactId> <version>1.2.17</version> </dependency> <!-- Log4j end --> <!-- 引入Spring(包含SpringMVC) 依赖 start --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-core</artifactId> <version>${spring.version}</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-web</artifactId> <version>${spring.version}</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-oxm</artifactId> <version>${spring.version}</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-tx</artifactId> <version>${spring.version}</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-jdbc</artifactId> <version>${spring.version}</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>${spring.version}</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-aop</artifactId> <version>${spring.version}</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-context-support</artifactId> <version>${spring.version}</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-test</artifactId> <version>${spring.version}</version> </dependency> <!-- 引入Spring 依赖 end --> <!-- 引用c3p0 依赖 start--> <dependency> <groupId>com.mchange</groupId> <artifactId>c3p0</artifactId> <version>0.9.2.1</version> </dependency> <!-- 引用c3p0 依赖 end--> <!-- 引用插件依赖:MyBatis整合Spring --> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis-spring</artifactId> <version>1.3.0</version> </dependency> <!-- JSTL --> <dependency> <groupId>jstl</groupId> <artifactId>jstl</artifactId> <version>1.2</version> </dependency> </dependencies> <build> <finalName>fendo-SSM</finalName> <plugins> <!-- 加入Tomcat插件 --> <plugin> <groupId>org.apache.tomcat.maven</groupId> <artifactId>tomcat8-maven-plugin</artifactId> <version>3.0-r1655215</version> </plugin> <!-- 加入maven-archetype-plugin插件 --> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-archetype-plugin</artifactId> <version>2.0-alpha-4</version> </plugin> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <version>3.6.1</version> <configuration> <source>1.8</source> <target>1.8</target> </configuration> </plugin> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-resources-plugin</artifactId> <version>3.0.2</version> <configuration> <encoding>UTF-8</encoding> </configuration> </plugin> </plugins> </build> </project>
往里面添加maven-archetype-plugin,Maven-resources-plugins,maven-compiler-plugin插件。所以一般可先创建所需的maven项目,然后利用archetype plugin的create-from-project将maven项目将该maven项目生成为archetype类型项目。生成maven项目后并确定定型后,执行:
mvn archetype:create-from-project
注意:
在执行上面命令之前最好,把这一些.setting, .class, .project的文件删除掉,因为这是多余的,所以我们在搭建好样板工程之后,在使用mvn archetype:create-from-project命令之前,要先把项目中不相关的工程文件、中间文件删除。
生成的archetype在此路径下:
target\generated-sources
此时会在该项目的target目录下发现如下文件:
---target ---generated-sources ---archetype ---our project
四、生成Archetype如何安装
在上文创建了archetype之后,进入到target\generate-sources\archetype目录,然后在命令行执行:
mvn clean install
安装该archetype项目到你的本地仓库,输出如下信息,特别是Build Success这段,表示就安装成功了。
安装之后主要做了一件事情:
1) 将文件安装到mvn缓存目录,在我本机就是G:\MavenRepository\com\fendo\ssm\fendo-SSM,该文件夹下的目录结构如下:
| maven-metadata-local.xml
|
\---0.0.1-SNAPSHOT
fendo-SSM-0.0.1-SNAPSHOT.jar
fendo-SSM-0.0.1-SNAPSHOT.pom
maven-metadata-local.xml
_remote.repositories
在target\generate-sources\archetype目录中执行crawl命令,生成archetype-catalog.xml:
mvn archetype:crawl
执行成功后会在G:\MavenRepository\archetype-catalog.xml中多出来一个骨架配置文件:
<archetype> <groupId>com.fendo.ssm</groupId> <artifactId>fendo-SSM-archetype</artifactId> <version>0.0.1-SNAPSHOT</version> <description>fendo-SSM</description> </archetype>
五、使用上自定义archetype
有2种使用方式:
1)通过命令行使用
找到一个空目录,然后执行如下命令:
mvn archetype:generate -DarchetypeCatalog=local
此时会给出上文安装的archetype,选择即可,如下:
输入编号,就可以了,这里就输入"2",选择SSM,然后输入GroupId,artifactId,就可以了
2)通过eclipse使用
因为G:\MavenRepository\archetype-catalog.xml是新创建的,所以需要在ecliplse的 file -》new-》maven projects对话框中,在选择archetype页面上,如下图
选择本地的archetype-catalog.xml
选择好之后,点击OK
然后点击Next
点击Finish,创建之后如下
默认是JAVA项目,还要把它转换成WEB项目,项目右键---->Project Facets
输入src/main/webapp然后点击OK,然后再点击Applay。然后编辑Deployment Assembly
把Maven的JAR配置进去.
然后点击Applay,运行项目访问
六、archetype命令
1.帮助命令:
archetype:help
2.爬取一个maven仓库,创建目录文件:
archetype:crawl
3.根据一个工程,创建一个新的archetype:
archetype:create-from-project
4.根据一个archetype,创建一个新的工程:
archetype:generate
5.根据当前的archetype工程,创建一个jar包:
archetype:jar
6.更新本地的maven目录:
archetype:update-local-catalog
参考地址: http://maven.apache.org/guides/mini/guide-creating-archetypes.html
相关文章推荐
- archetype:create-from-project命令创建maven模板工程(自定义项目模板并且上载到maven私服)
- 自定义maven骨架/以当前项目为模板创建maven骨架
- VS自定义项目模板:[3]创建自定义模板
- Maven创建项目模板自定义基本包名
- 使用项目模板创建自定义项目项
- 创建maven项目指定自定义-DarchetypeCatalog=file://archetype-catalog.xml遇到的问题
- 使用标准导出模板向导创建自定义项目模板
- Cocos2d-x 创建自定义项目模板
- 创建maven自定义archetype项目
- 如何利用 Visual Studio 自定义项目或工程模板
- Gridview中自定义模板中增加控件后创建该控件事件
- Linq to Oracle 使用教程(十一)创建 Dynamic Data 项目
- 创建自定义的Visual Studio项模板(转)
- Maven2 根据项目生成模版项目,并使用该模板批量创建工程
- Cocos2d-x 创建自己定义项目模板
- eclispe 创建maven 项目:Could not resolve archetype org.apache.maven.archetypes
- 解决IntelliJ创建Maven项目一直显"Loading archetype list"
- myeclipse无法创建maven web项目:Could not resolve archetype
- 在VisualStudio2013,2015中如何安装自定义项目模板
- 使用Android模板创建的tabbed activity项目之问题(can’t convert taba to fragment)