Java—从Maven说起.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "id": "5d39ef60",
   "metadata": {},
   "source": [
    "# Maven项目\n",
    "　　参考：[]()     \n",
    "　　　　　[C语言中文网-Maven教程](http://c.biancheng.net/maven2/)   \n",
    "　　　　　[很全的mvn介绍](https://blog.csdn.net/DR_LF/article/details/7292441)   \n",
    "　　　　　[指定Maven版本：.mvn目录&mvnw和mvnw.cmd文件说明](https://blog.csdn.net/adparking/article/details/114692211)   \n",
    "　　　　　[maven的pom.xml文件详解学习分享](https://blog.csdn.net/weixin_42440011/article/details/118751845)   \n",
    "　　　　　[maven：pom文件详解](https://blog.csdn.net/weixin_38569499/article/details/91456988)   \n",
    "　　　　　[pom文件详解](https://blog.csdn.net/Coder_Qiang/article/details/83306721)   \n",
    "　　　　　[Maven之pom.xml与setting.xml配置文件详解](https://liuyandeng.blog.csdn.net/article/details/79138294)   \n",
    "　　　　　[]()   \n",
    "　　　　　[]()   \n",
    "　　　　　[]()   \n",
    "　　　　　[]()   \n",
    "\n",
    "　　Maven 翻译为\"专家\"、\"内行\"，是 Apache 下的一个纯 Java 开发的开源项目。基于项目对象模型（缩写：POM）概念，Maven利用一个中央信息片断能管理一个项目的构建、报告和文档等步骤。  \n",
    "　　Maven 是一个项目管理工具，可以对 Java 项目进行构建、依赖管理。  \n",
    "　　Maven 也可被用于构建和管理各种项目，例如 C#，Ruby，Scala 和其他语言编写的项目。Maven 曾是 Jakarta 项目的子项目，现为由 Apache 软件基金会主持的独立 Apache 项目。   \n",
    "\n",
    "## 一、Maven 安装\n",
    "+ 构建：比如生成class、jar、war或者ear文件\n",
    "+ 生成文档：比如生成javadoc、网站文档\n",
    "+ 生成报告：比如junit测试报告\n",
    "+ 生成依赖类库：生成文档，说明项目多其他软件的依赖\n",
    "+ 发布：生成供发布的分发包，比如生成Struts2的分发包，供提交给用户使用\n",
    "+ 部署：比如，web应用程序，自动部署到指定的服务器上\n",
    "+ 有关SCM：SCM（Software Configuration Management），软件配置管理，比如版本控制，比如bug管理等等\n",
    "\n",
    "### 1.1、Maven下载\n",
    "1. 选择对应的版本下载（[下载地址](http://maven.apache.org/download.cgi)），这里，我使用 apache-maven-3.3.3-bin.zip,将其解压放到对应安装路径下即可。\n",
    "2. 配置环境变量：  \n",
    "MAVEN_HOME = 安装路径  \n",
    "Path添加 %MAVEN_HOME%/bin   \n",
    "### 1.2、安装对应SDK\n",
    "　　Maven 3.3 需要 jdk 1.7 及以上版本。安装后，配置java环境变量：JAVA_HOME = 安装路径；Path 中新增 %JAVA_HOME %/bin。   \n",
    "### 1.3、Maven自定义配置\n",
    "#### 1.3.1、Maven依赖路径修改\n",
    "　　%MAVEN_HOME%/conf/setting.xml配置文件中的 localRepository 存放了 maven 所依赖的 jar，默认路径是 {user.home}/.m2/repository ,即用户家目录下，建议修改到其他位置。  \n",
    "　　如：<localRepository>xxx/.m2/repository</localRepository>\n",
    "### 1.4、检测安装成功\n",
    "```shell\n",
    "mvn -v\n",
    "```\n",
    "## 二、Maven使用\n",
    "### 2.1、使用Maven新建项目\n",
    "　　例如：新建项目hello  \n",
    "```shell\n",
    "mvn archetype:generate -DgroupId=com.mycompany.helloworld -DartifactId=helloworld -Dpackage=com.mycompany.helloworld -Dversion=1.0-SNAPSHOT\n",
    "```\n",
    "　　**说明**：第一次运行 Maven 可能比较耗时间，因为需要下载 maven 需要的相关 jar 包，第二次运行的时候 就不会需要下载了的。在命令执行的过程中，可能有几处需要输入，直接按回车就好，这样就完成项目的建立。   \n",
    "　　archetype:generate 目标会列出一系列的 archetype 让你选择。Archetype 可以理解成项目的模型。Maven 为我们提供了很多种的项目模型，包括从简单的 Swing 到复杂的 Web 应用。我们选择默认的 maven-archetype-quickstart。  \n",
    "　　maven 的 archetype 插件为我们建立了一个 helloworld 目录，这个名字来自 artifactId 。在这个目录下面，有一个 Project Object Model(POM) 文件 pom.xml 。这个文件用于描述项目、配置插件和管理依赖关系。源代码和资源文件则放在 src/main 下面，而测试代码和资源放在 src/test 下面。另外，Maven 已经为我们建立了一个名为 App.java 的文件。  \n",
    "### 2.2、项目的构建与运行\n",
    "```shell\n",
    "cd helloworld  # 进入当前项目\n",
    "mvn package   # 构建项目\n",
    "java-cp target/helloworld-1.0-SNAPSHOT.jar com.mycompany.helloworld.App   # 运行项目\n",
    "mvn test    # 测试项目\n",
    "```\n",
    "　　**说明**：maven 在构建时，会在 helloworld 下面建立了一个新的目录 target/ ，构建打包后的 jar 文件 helloworld-1.0-SNAPSHOT.jar 就存放在这个目录下。编译后的 class 文件放在 target/classes/ 目录下面，测试 class 文件则放在 target/test-classes/ 目录下面。  \n",
    "\n",
    "### 2.3、其他Maven常用命令\n",
    "```shell\n",
    "mvn compile   # 编译\n",
    "mvn test-compile    # 编译测试程序\n",
    "mvn clean   # 清空\n",
    "mvn site    # 生成站点目录\n",
    "mvn site-deploy    # 生成站点目录并发布\n",
    "mvn install       # 安装当前工程的输出文件到本地仓库\n",
    "mvn install:install-file -DgroupId=<groupId> -DartifactId=<artifactId> -Dversion=1.0.0 -Dpackaging=jar -Dfile=<myfile.jar>   # 安装指定文件到本地仓库\n",
    "mvn help:effective-pom   # 查看实际pom信息\n",
    "mvn dependency:analyze\n",
    "mvn dependency:tree     # 同上，分析项目的依赖信息\n",
    "mvn -Dmaven.test.skip=true XXX   # 跳过测试运行maven任务\n",
    "mvn eclipse:eclipse   # 生成eclipse项目文件\n",
    "mvn help:help\n",
    "mvn help:help -Ddetail=true  # 同上，查看帮助信息\n",
    "mvn <plug-in>:help    # 查看插件的帮助信息，比如：mvn dependency:help 或 mvn ant:help 等等\n",
    "mvn archetype:create -DarchetypeGroupId=org.apache.maven.archetypes -DarchetypeArtifactId=maven-archetype-webapp -DgroupId=com.mycompany.app -DartifactId=my-webapp  # 创建一个java的web工程\n",
    "```\n"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3 (ipykernel)",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.9.7"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 5
}