Maven
1. Maven项目架构管理工具
核心思想:约定大于配置
- 有约束,不要去违反。
Maven会规定好如何取编写Java代码,必须按照这个规范来。
2. 下载安装
下载 binary
压缩包而不是源码包。apache-maven-3.6.3/conf/settings.xml
中可以调整配置:
- mirrors: 配置镜像目录,方便下载使用
3. 环境变量配置
在系统环境变量中配置:
- M2_HOME:maven目录下的bin目录
- MAVEN_HOME:maven的目录
- 在系统的path中配置
%MAVEN_HOME%\bin
- 在CMD中使用
mvn -version
检测是否安装成功
4. 配置阿里云镜像
<mirror>
<id>aliyunmaven</id>
<mirrorof>*</mirrorof>
<name>阿里云公共仓库</name>
<url>https://maven.aliyun.com/repository/public</url>
</mirror>
参考: 阿里云仓库服务
5. 配置本地仓库
在 settings
标签下的 localRepository
标签中配置本地仓库位置。
<localrepository>D:\maven_repository</localrepository>
6. 在IDEA中使用Maven
- 创建一个Maven web项目
- 在IDEA中配置Maven
Settings -> Build, Execution, Deployment -> Build Tools -> Maven
在Web情况下的Maven项目结构:
javaweb-01-maven
├── pom.xml
└── src
└── main
└── webapp
├── index.jsp // 网页
└── WEB-INF // Web的配置
└── web.xml
在 main
目录下新建 java、resource 文件夹,可能还需要手动标记为对应目录:Mark Directory as
- Sources Root 源码目录
- Test Sources Root 测试源码目录
- Resources Root 资源目录
- Test Resources Root 测试资源目录
Maven能够帮助导入jar包所依赖的其他jar包。
7. 创建一个普通的Maven项目
干净的Maven项目结构:
javaweb-01-maven02
├── .idea
├── pom.xml // 初始的Maven配置文件
└── src
├── main
│ ├── java // 放置Java源代码
│ └── resources // 防止一些配置文件
└── test
└── java // 测试使用
8. 在IDEA中配置Tomcat
Add Configuration -> +
-> Tomcat Server -> local
配置完成后需要手动添加一个 artifact,在Deployment标签下添加当前项目即可。
9. IDEA中的Maven侧边栏
- Lifecycle: 生命周期,Maven的命令行操作
- Plugins: 插件,甚至可以删掉
- Dependencies:项目依赖,一个一个的jar包
10. pom文件
pom.xml
是maven的核心配置文件,主要包括几部分:
- Maven版本和头文件
- 配置的GAV(groupId,artifactId,version)
<!--?xml version="1.0" encoding="UTF-8"?-->
<!-- Maven版本和头文件 -->
<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>
<!-- 配置的GAV -->
<groupid>com.kuang</groupid>
<artifactid>javaweb-01-maven</artifactid>
<version>1.0-SNAPSHOT</version>
<!-- Package:项目的打包方式, jar:Java应用;war:JavaWeb应用 -->
<packaging>war</packaging>
<name>javaweb-01-maven Maven Webapp</name>
<!-- FIXME change it to the project's website -->
<url>http://www.example.com</url>
<!-- 配置 -->
<properties>
<!-- 项目的默认构建编码 -->
<project.build.sourceencoding>UTF-8</project.build.sourceencoding>
<!-- 编译版本 -->
<maven.compiler.source>1.8</maven.compiler.source>
<maven.compiler.target>1.8</maven.compiler.target>
</properties>
<!-- 项目依赖 -->
<dependencies>
<!-- 具体依赖的jar包配置文件 -->
<dependency>
<groupid>junit</groupid>
<artifactid>junit</artifactid>
<version>4.11</version>
<scope>test</scope>
</dependency>
</dependencies>
<!-- 项目构建用的东西 -->
<build>
<finalname>javaweb-01-maven</finalname>
<pluginmanagement><!-- lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) -->
<plugins>
<plugin>
<artifactid>maven-clean-plugin</artifactid>
<version>3.1.0</version>
</plugin>
<!-- see http://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_war_packaging -->
<plugin>
<artifactid>maven-resources-plugin</artifactid>
<version>3.0.2</version>
</plugin>
<plugin>
<artifactid>maven-compiler-plugin</artifactid>
<version>3.8.0</version>
</plugin>
<plugin>
<artifactid>maven-surefire-plugin</artifactid>
<version>2.22.1</version>
</plugin>
<plugin>
<artifactid>maven-war-plugin</artifactid>
<version>3.2.2</version>
</plugin>
<plugin>
<artifactid>maven-install-plugin</artifactid>
<version>2.5.2</version>
</plugin>
<plugin>
<artifactid>maven-deploy-plugin</artifactid>
<version>2.8.2</version>
</plugin>
</plugins>
</pluginmanagement>
</build>
</project>
Maven的约定大于配置,可能会出现写的配置文件、资源导出失败,这种情况可以在build下配置resources解决。
11. 常见问题
Maven默认web项目中web.xml
版本问题:
可以替换为对应tomcat版本中的ROOT项目中的头,最合适
<!--?xml version="1.0" encoding="UTF-8"?-->
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemalocation="http://xmlns.jcp.org/xml/ns/javaee
http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd" version="4.0" metadata-complete="true">
</web-app>
简单的Servlet例子:
- 创建一个servlet文件,需要继承对应的HttpServlet类:
package com.kuang.servlet;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.io.PrintWriter;
/**
* servlet入门
*
* @author maple_w
* Created on 22/07/27 027 12:26
*/
public class HelloServlet extends HttpServlet {
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
// 这里如果没有把自带的super.doGet(req, resp); 注释掉,会出现405错误
// 响应的类型 html
resp.setContentType("text/html");
// 设置编码格式以避免中文乱码
resp.setCharacterEncoding("utf-8");
// 获取响应的输出流
PrintWriter out = resp.getWriter();
out.println("");
out.println("");
out.println("<title>huang</title>");
out.println("");
out.println("");
out.println("<h1>huang</h1>");
out.println("<h1>中文</h1>");
out.println("");
out.println("");
}
@Override
protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
doGet(req, resp);
}
}
- 该
HttpServlet
对应的包也需要在pom.xml
文件中引入:
<!-- https://mvnrepository.com/artifact/javax.servlet/javax.servlet-api -->
<dependency>
<groupid>javax.servlet</groupid>
<artifactid>javax.servlet-api</artifactid>
<version>4.0.1</version>
</dependency>
- 在
web.xml
文件中也要对servlet进行注册:
<!-- 配置web的核心应用 -->
<!-- 注册Servlet -->
<servlet>
<servlet-name>helloServlet</servlet-name>
<servlet-class>com.kuang.servlet.HelloServlet</servlet-class>
</servlet>
<!-- 一个servlet对应一个mapping -->
<servlet-mapping>
<servlet-name>helloServlet</servlet-name>
<!-- 映射的请求路径 -->
<url-pattern>/huang</url-pattern>
</servlet-mapping>
- ,默认开启项目中的
index.jsp
页面,通过在路径后加/kuang
即可得到HelloServlet
中输出的网页,直接输入文件名也可以访问对应的静态资源,如header.html
。