diff --git a/README.md b/README.md index 484894d..3227ee3 100644 --- a/README.md +++ b/README.md @@ -157,7 +157,9 @@ #### 5.6.2 Spring事务管理器 #### 5.6.3 使用@Transactional进行声明式事务管理 #### 5.6.4 使用编程式事务管理 - +### 5.7 构建工具 +#### 5.7.1 Maven(了解) +#### 5.7.2 Gradle(掌握) ## 6. [数据库访问](./docs/chapter06.md) ### 6.1 JDBC(掌握) #### 6.1.1 什么是JDBC? diff --git a/docs/chapter05.md b/docs/chapter05.md index 3ed6b8a..538488f 100644 --- a/docs/chapter05.md +++ b/docs/chapter05.md @@ -631,3 +631,154 @@ Java 内置的 `List` 和 `Map` 类型都支持泛型,可以用来存储任意 } } ``` +### 5.7 构建工具 + + +构建工具(Build Tools)是软件开发过程中用于自动化构建、测试和打包软件应用程序的工具。它们通常用于编译源代码、运行测试、生成文档、打包应用程序以及执行其他与构建过程相关的任务。 + +java项目常用的构建工具有: + +**Apache Ant** + +- 是一个基于 Java 的构建工具,使用 XML 文件(build.xml)来描述构建过程。 +- 支持跨平台构建,常用于 Java 项目。 + +**Maven** +- 是一个项目管理和构建自动化工具,主要针对 Java 项目。 +- 使用 POM(Project Object Model)文件来描述项目结构和配置。 +- 提供了依赖管理和项目生命周期管理。 + +**Gradle** +- 是一个现代的构建自动化系统,适用于 JVM 语言。 +- 支持 Groovy 和 Kotlin 脚本,可以替代 Ant 和 Maven。 +- 提供了丰富的插件生态系统。 + +好的,以下是针对 Maven 和 Gradle 的具体使用方法的介绍,以完成你的文档的 5.7.1 和 5.7.2 部分。 + +### 5.7.1 Maven + +#### 5.7.1.1 独立Maven + +##### 安装 Maven + +1. **下载 Maven**: 访问 [Maven 官方网站](https://maven.apache.org/download.cgi),下载适合您操作系统的二进制包。 +2. **解压缩**: 将下载的文件解压缩到一个合适的目录。 +3. **设置环境变量**: + - Windows 用户需要设置 `MAVEN_HOME` 环境变量指向 Maven 的安装目录,并将 `%MAVEN_HOME%\\bin` 加入到 `PATH` 环境变量中。 + - Linux/macOS 用户可以编辑 `.bashrc` 或 `.zshrc` 文件,添加 `export MAVEN_HOME=path/to/maven` 并将 `$MAVEN_HOME/bin` 添加到 `PATH` 中。 + +##### 创建 Maven 项目 + +1. **初始化项目**: 使用 Maven 命令行工具创建一个新的项目。例如,使用一个简单的 webapp 模板: + ```shell + mvn archetype:generate -DgroupId=com.example -DartifactId=my-app -DarchetypeArtifactId=maven-archetype-webapp -DinteractiveMode=false + ``` +2. **编辑 pom.xml**: 修改 `pom.xml` 文件以包含项目的依赖和其他配置信息。 + +##### 常用 Maven 命令 + +- **编译项目**: `mvn compile` +- **运行测试**: `mvn test` +- **打包项目**: `mvn package` +- **安装到本地仓库**: `mvn install` +- **清理项目**: `mvn clean` +- **生成站点文档**: `mvn site` + +##### 示例 + +假设你有一个 Maven 项目,并且希望编译和打包它: + +```shell +cd path/to/your/project +mvn clean package +mvn package +``` +#### 5.7.1.2 在IDEA使用Maven + +**导入 Maven 项目** +* 打开 IntelliJ IDEA +* 新建或打开项目:选择 “Open” 或 “Import Project”,浏览到包含 pom.xml 文件的目录,并选择它。 +* 导入项目:IDEA 会检测到这是一个 Maven 项目,并提示你导入该项目。 + +**创建新的 Maven 项目** +* 创建项目:选择 “File” > “New” > “Project”。 +* 选择 Maven:在新窗口中选择 “Maven” 作为项目类型。 +* 配置项目:填写必要的信息,如 Group Id、Artifact Id 等,并选择一个模板或空项目。 + +**使用 Maven 插件** +IntelliJ IDEA 自带 Maven 插件,可以使用 Maven 插件来运行测试、打包项目、生成站点等。 + +> **访问 Maven 工具窗口:** 在 IntelliJ IDEA 的右侧栏中找到 “Maven” 工具窗口。 如果没有显示,可以通过 “View” > “Tool Windows” > “Maven” 打开。 + +### 5.7.2 Gradle + +#### 5.7.2.1 单独 Gradle + +##### 安装 Gradle + +1. **下载 Gradle**: 访问 [Gradle 官方网站](https://gradle.org/releases/),下载适合您操作系统的二进制包。 +2. **解压缩**: 将下载的文件解压缩到一个合适的目录。 +3. **设置环境变量**: + - Windows 用户需要设置 `GRADLE_HOME` 环境变量指向 Gradle 的安装目录,并将 `%GRADLE_HOME%\\bin` 加入到 `PATH` 环境变量中。 + - Linux/macOS 用户可以编辑 `.bashrc` 或 `.zshrc` 文件,添加 `export GRADLE_HOME=path/to/gradle` 并将 `$GRADLE_HOME/bin` 添加到 `PATH` 中。 + +##### 创建 Gradle 项目 + +1. **初始化项目**: 使用 Gradle 命令行工具创建一个新的项目。首先,创建一个项目目录,并在其中创建 `build.gradle` 文件。 +2. **编辑 build.gradle**: 在 `build.gradle` 文件中定义项目的构建逻辑。例如,定义依赖关系和插件: + ```groovy + plugins { + id 'java' + id 'application' + } + + repositories { + mavenCentral() + } + + dependencies { + implementation 'org.jetbrains:annotations:23.0.1' + testImplementation 'junit:junit:4.12' + } + + application { + mainClass = 'com.example.MainApp' + } + ``` + +##### 常用 Gradle 命令 + +- **编译项目**: `./gradlew build` (Linux/macOS) + - `gradlew.bat build` (Windows) +- **运行测试**: `./gradlew test` (Linux/macOS) + - `gradlew.bat test` (Windows) +- **打包项目**: `./gradlew jar` (Linux/macOS) + - `gradlew.bat jar` (Windows) +- **清理项目**: `./gradlew clean` (Linux/macOS) + - `gradlew.bat clean` (Windows) + +#### 5.7.2.2 IDEA中使用Gradle + +在 IntelliJ IDEA 中使用 Gradle 同样可以提高开发效率,因为 IDEA 提供了对 Gradle 的深度集成支持。以下是详细的步骤说明如何在 IntelliJ IDEA 中使用 Gradle: + +### 5.7.2.2 在 IntelliJ IDEA 中使用 Gradle + +#### 创建新的 Gradle 项目 + +- **启动 IntelliJ IDEA**:打开 IntelliJ IDEA。 +- **创建新项目**:选择 “File” > “New” > “Project”。 +- **选择 Gradle**:在新窗口中选择 “Gradle” 作为项目类型。 +- **配置项目**:填写必要的信息,如项目名称、位置、Gradle 版本等。如果需要,可以指定一个模板或空项目。 +- **完成创建**:点击 “Finish” 来创建 Gradle 项目。 + +#### 导入现有的 Gradle 项目 + +- **打开 IntelliJ IDEA**:启动 IntelliJ IDEA 应用程序。 +- **打开项目**:选择 “Open” 或 “Import Project”,浏览到包含 `build.gradle` 文件的目录,并选择它。 +- **导入项目**:IDEA 会检测到这是一个 Gradle 项目,并提示你导入该项目。选择 “Import project from external model” 并点击 “OK”。 + + +#### 使用 IDEA的gradle插件 + +IDEA 内置了对 Gradle 的支持,使得开发者可以直接从 IDE 内部执行 Gradle 任务,监控构建过程,并管理项目的构建配置。 +> **访问 Gradle 工具窗口:** 在 IntelliJ IDEA 的右侧栏中找到 “Gradle” 工具窗口。 如果没有显示,可以通过 “View” > “Tool Windows” > “Gradle” 打开。 diff --git a/docs/index.md b/docs/index.md index 238fd64..74ed1c5 100644 --- a/docs/index.md +++ b/docs/index.md @@ -156,6 +156,9 @@ #### 5.6.2 Spring事务管理器 #### 5.6.3 使用@Transactional进行声明式事务管理 #### 5.6.4 使用编程式事务管理 +### 5.7 构建工具 +#### 5.7.1 Maven(了解) +#### 5.7.2 Gradle(掌握) ## 6. [数据库访问](./docs/chapter06.md) ### 6.1 JDBC(掌握)