1.新建一个maven项目
2.创建项目结构
-
详细信息
- Controller:控制层
- 请求分发:
- 控制层接收来自前端的HTTP请求,并根据请求的URL和HTTP方法将请求分发到相应的处理方法。
- 数据校验和转换:
- 控制层负责校验请求参数的合法性,并将前端传递的数据转换为合适的Java对象。
- 调用业务逻辑:
- 控制层将请求转发到相应的业务逻辑层(Service层),并将业务层返回的数据传递给视图层(View层)进行展示。
- 响应数据的处理:
- 控制层根据业务逻辑层的执行结果,组装合适的响应数据,并返回给前端。
- Service:业务逻辑层
- 负责实现应用程序的业务逻辑
- Service 接口:
- 这些接口定义了应用程序的各种业务操作,如查询、新增、修改和删除等。
- 这些接口是业务逻辑的抽象,为上层的控制层提供服务。
- Service 实现类:
- 这些类实现了 Service 接口中定义的各种业务方法。
- 在实现业务逻辑时,Service 层会调用 Model 层 (即 pojo 文件夹) 提供的数据访问方法。
- Service 层负责处理业务规则、事务管理、权限控制等。
- Service 辅助类:
- 有时候,service文件夹还会包含一些辅助类,如工具类、常量类等。
- 这些辅助类为 Service 层的实现提供支持。
- Pojo:对象层
- 负责定义应用程序的数据结构和业务规则
- 对象类:
- 这些类对应数据库表中的各个字段,并提供了属性、getter 和 setter 方法。这些 POJO 类是 MyBatis 用来映射数据库表结构的基础。
- 数据传输对象 (DTO) 类:
- 有时候,我们需要在不同层之间传输数据,这时就需要定义 DTO 类。DTO 类可以是 POJO 类的子集,也可以是完全不同的类。它们用于封装要在不同层之间传输的数据。
- 数据访问对象 (DAO) 接口:
- 有时候,POJO文件夹也会包含 DAO 接口的定义。DAO 接口定义了与数据库交互的方法,如增、删、改、查等。
- Mapper:持久化层
- 数据库操作:
- 持久层中定义的Mapper接口和XML配置文件,包含了对数据库表进行增删改查等操作的SQL语句。
- 数据映射:
- 持久层负责将数据库查询结果映射为Java对象,并将Java对象转换为数据库所需的格式。
- 事务控制:
- 持久层通常会配合Service层实现事务管理,保证数据操作的完整性。
- Utils:工具类
- 用于存放一些通用的工具类和辅助类
- 提供公共功能:
- 这些工具类和辅助类通常包含一些常用的方法,如日期、字符串、数学等方面的操作。
- 这些方法可以被项目中的其他层次(如 Service 层、Controller 层)共同使用,提高代码的复用性。
- 封装第三方库:
- 有时候,utils文件夹还会包含一些封装第三方库的工具类。
- 这样可以隔离第三方库的实现细节,方便项目中其他部分的调用。
- 实现通用算法:
- 一些常见的算法实现,如排序、搜索等,也可以放在 utils 文件夹下。
- 这些算法可以被项目中的其他模块复用。
- 管理常量和配置:
- utils文件夹有时也会包含一些常量类和配置管理类。
- 这些类用于集中管理项目中用到的一些固定值和配置信息
- Resources:主要用于存放项目中所需的各种资源文件
- 配置文件:
- Spring 的配置文件,如 applicationContext.xml、spring-mvc.xml 等。
- MyBatis 的配置文件,如 mybatis-config.xml。
- 数据库连接配置文件,如 jdbc.properties。
- 其他系统配置文件,如日志配置、缓存配置等。
- SQL 脚本:
- MyBatis 的 SQL 映射文件,如 UserMapper.xml。
- 一些 SQL 初始化脚本,如建表语句等。
- 静态资源文件:
- 项目中使用的 JavaScript、CSS、图片等静态文件。
- 国际化资源文件,如 messages_zh_CN.properties。
- 其他资源文件:
- 一些项目需要的其他资源文件,如 XML、properties 等。
- Webapp:Web应用核心配置文件
- 负责处理用户界面和用户交互,并将用户请求转发给后端的 Service 层进行业务处理。Webapp文件夹的内容通常由前端开发人员维护和管理,后端开发人员则主要关注 Service 层和 Dao 层的实现。两者通过 Controller 层进行交互和协作,共同完成项目的功能实现。
- 前端页面:
- 这个文件夹通常包含项目的 HTML、JSP、Vue.js 等前端页面文件。
- 这些页面文件负责展示用户界面,接受用户输入,并将用户请求传递给后端。
- 静态资源:
- 除了前端页面,还包含项目所需的静态资源,如 JavaScript 文件、CSS 文件、图片、字体等。
- 这些静态资源为前端页面提供样式和交互功能。
- Web 配置文件:
- 项目的 Web 应用相关的配置文件,如 web.xml 文件,用于配置 Servlet、Filter 等 Web 组件。
- 有时也会包含 Spring MVC 的 servlet-context.xml 配置文件。
- TestSpringMybatis.java:测试类
- 用于存放项目的单元测试和集成测试代码
- 单元测试:
- 这些测试类用于测试项目中的各个单元,如 Service 层、Dao 层等。
- 这些测试类可以独立测试各个单元的功能是否正确。
- 集成测试:
- 这些测试类用于测试多个模块之间的集成情况,如 Controller 层与 Service 层的集成。
- 集成测试可以验证整个系统的功能是否正常工作。
- 测试辅助类:
- 一些测试过程中需要用到的辅助类,如测试数据生成器、Mock 对象等。
- 测试配置文件:
- 用于配置单元测试和集成测试的一些参数,如数据源、事务管理等。
- pom.xml:Maven项目的核心配置文件
- 项目信息定义:
- pom.xml文件定义了项目的基本信息,如项目名称、版本、描述等。
- 依赖管理:
- pom.xml文件用于管理项目所需的各种依赖库,如Spring框架、MyBatis、数据库驱动等。这样可以方便地引入和管理项目所需的第三方库。
- 插件配置:
- pom.xml文件可以配置各种Maven插件,如Tomcat插件、Compiler插件等,用于构建、测试和部署项目。
- 构建配置:
- pom.xml文件可以定义项目的构建过程,如源代码目录、资源文件目录、输出目录等。
3.添加MAVEN依赖(pom.xml)
-
-
<!-- mybatis核心依赖,提供了数据持久层的功能 --> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>3.5.16</version> </dependency> <!-- spring --> <!--spring-core:spring 核心模块,提供了 loC 容器、类型转换等功能。--> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-core</artifactId> <version>5.3.26</version> </dependency> <!--spring-beans:提供了 Bean的管理和依赖注入功能。--> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-beans</artifactId> <version>5.3.26</version> </dependency> <!--spring-context: Spring上下文模块,提供了 Spring 应用程序上下文的功能。--> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-context</artifactId> <version>5.3.26</version> </dependency> <!--spring-test: Spring 测试模块,用于编写单元测试和集成测试。--> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-test</artifactId> <version>5.3.26</version> <scope>test</scope> </dependency> <!--spring-aop:Spring AOP 模块,用于实现面向切面编程。 --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-aop</artifactId> <version>5.3.26</version> </dependency> <!--spring-tx:Spring 事务管理模块,提供了声明式事务处理功能。 --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-tx</artifactId> <version>5.3.26</version> </dependency> <!--spring-jdbc:Spring JDBC 模块,用于简化 JDBC 操作。 --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-jdbc</artifactId> <version>5.3.26</version> </dependency> <!-- spring和mybatis整合包 --> <!--mybatis-spring:提供了 MyBatis 与 Spring 的整合功能。 --> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis-spring</artifactId> <version>2.0.6</version> </dependency> <!--springMVC--> <!--spring-webmvc:Spring MVC 模块,用于构建 Web 应用程序。 --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>5.3.26</version> </dependency> <!-- 数据库相关 --> <!--mysql-connector-j:MySQL 数据库驱动。 --> <dependency> <groupId>com.mysql</groupId> <artifactId>mysql-connector-j</artifactId> <version>8.0.33</version> </dependency> <!--commons-dbcp: Apache Commons DBCP2 数据库连接池。 --> <dependency> <groupId>org.apache.commons</groupId> <artifactId>commons-dbcp2</artifactId> <version>2.1.1</version> </dependency> <!--commons-pool2:Apache Commons Pool2 对象池工具。 --> <dependency> <groupId>org.apache.commons</groupId> <artifactId>commons-pool2</artifactId> <version>2.4.2</version> </dependency> <!-- 工具类 --> <!--lombok:Lombok 工具,注解提供getter,setter方法,用于简化 Java 代码。 --> <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <version>1.18.24</version> <scope>provided</scope> </dependency> <!--junit:JUnit 测试框架。 --> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>RELEASE</version> </dependency> <!--log4j:Log4j 日志框架。 --> <dependency> <groupId>log4j</groupId> <artifactId>log4j</artifactId> <version>1.2.17</version> </dependency>
-
4.配置文件
-
-
配置database.properties
- 通常用于配置数据库连接相关的参数。
- database.properties 文件通常包含以下配置参数:
jdbc.driver
: 数据库驱动类名jdbc.url
: 数据库连接 URLjdbc.username
: 数据库用户名jdbc.password
: 数据库密码- 其他可选的参数,如数据库连接池的配置等
-
#加载驱动 jdbc.driver = com.mysql.cj.jdbc.Driver #数据库连接 URL jdbc.url = jdbc:mysql:///test jdbc.username = root jdbc.password = xxxx
-
配置spring.xml
- Spring 框架的主配置文件
- 作用:
- 定义 Bean 和 Bean 之间的依赖关系:
- 用于定义应用程序中所需的各种 Bean,如 Service 层、DAO 层等组件,并管理它们之间的依赖关系。
- 配置 Spring 容器行为:
- 配置 Spring 容器的一些行为,如是否开启注解驱动、是否开启事务管理等。
- 整合其他框架和组件:
- 可以用于整合 MyBatis、Hibernate 等其他框架和组件,并配置它们与 Spring 容器的集成。
- 实现面向切面编程 (AOP):
- 用于配置 AOP 切面,实现跨越多个模块的功能,如日志记录、安全检查等。
- 管理资源文件和属性配置:
- 可以引入其他配置文件,如 database.properties`等,实现对资源文件和属性配置的集中管理。
- 定义 Bean 和 Bean 之间的依赖关系:
- 在具体的 SSM 项目中,spring.xml 文件通常包含以下主要内容:
- Bean 定义:
- 定义 Service 层、DAO 层等组件 Bean,并管理它们之间的依赖关系。
- 数据源配置:
- 配置数据源 Bean,并将其与数据库连接信息(如 database.properties`文件)关联。
- 事务管理配置:
- 配置事务管理器 Bean,并将其与 Service 层 Bean 进行关联,实现事务管理。
- MyBatis 配置:
- 配置 MyBatis 的 SqlSessionFactory 和 MapperScannerConfigurer,实现 MyBatis 与 Spring 的整合。
- 其他功能配置:
- 如 AOP 切面的定义、属性文件的引入等。
- Bean 定义:
-
<?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context" xmlns:aop="http://www.springframework.org/schema/aop" xmlns:tx="http://www.springframework.org/schema/tx" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop.xsd http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx.xsd"> <!--01 开启注解扫描 --> <context:component-scan base-package="com.its"/> <!--02 配置数据源--> <context:property-placeholder location="classpath:database.properties"/> <bean id="dataSource" class="org.apache.commons.dbcp2.BasicDataSource"> <property name="driverClassName" value="${jdbc.driver}"/> <property name="url" value="${jdbc.url}"/> <property name="username" value="${jdbc.username}"/> <property name="password" value="${jdbc.password}"/> <!--连接池信息--> <property name="maxIdle" value="100"/> </bean> <!--03 事务相关配置--> <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager"> <property name="dataSource" ref="dataSource"/> </bean> <!--开启事务注解模式--> <tx:annotation-driven transaction-manager="transactionManager"/> <!--mybatis基础配置--> <bean id="sqlSessionFactoryBean" class="org.mybatis.spring.SqlSessionFactoryBean"> <!--数据源--> <property name="dataSource" ref="dataSource"/> <!--自动扫描mapper.xml--> <property name="mapperLocations" value="classpath:com/its/mapper/*.xml"/> <!--别名--> <property name="typeAliasesPackage" value="com.its.pojo"/> <!--引入特定配置--> <property name="configLocation" value="classpath:mybatis.xml"/> </bean> <!--05 mapper代理开发,使用Spring自动扫描Mybatis的接口并装配--> <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer"> <!--确定mapper接口位置--> <property name="basePackage" value="com.its.mapper"/> <!--获取sqlSession工厂--> <property name="sqlSessionFactoryBeanName" value="sqlSessionFactoryBean"/> </bean> </beans>
-
配置mybatis.xml
- MyBatis 的配置文件
- 作用:
- 定义数据库表与实体类的映射关系:
- 件用于定义数据库表中的字段与实体类属性之间的映射关系,使得 MyBatis 可以自动完成对象-关系映射 (ORM)。
- 配置 SQL 语句和 SQL 执行方式:
- 在该文件中可以定义各种 SQL 语句,如 SELECT、INSERT、UPDATE、DELETE 等,并指定它们的执行方式,如返回值类型、参数映射等。
- 管理数据库操作相关的配置:
- 文件可用于配置数据库驱动、连接池、事务管理等与数据库操作相关的参数。
- 实现动态 SQL 语句生成:
- MyBatis 支持动态 SQL 语句的生成,这些逻辑可以在 文件中定义,以提高 SQL 语句的灵活性和可维护性。
- 定义数据库表与实体类的映射关系:
- 因为此次我们将管理数据库的相关配置在spring.xml中配置,所以我们就只在mybatis.xml文件中开始日志和驼峰映射
-
<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd"> <!--核心配置文件--> <configuration> <!--设置--> <settings> <!--输出日志--> <setting name="logImpl" value="STDOUT_LOGGING"/> <setting name="mapUnderscoreToCamelCase" value="true"/> </settings> </configuration>
-
配置spring-mvc.xml
- Spring MVC 的配置文件
- 作用:
- 处理 Web 请求:
- 定义了 Spring MVC 的核心组件, 如 DispatcherServlet、HandlerMapping、HandlerAdapter 等, 用于接收和处理客户端发送的 HTTP 请求。
- 配置视图解析器:
- 配置视图解析器, 定义视图的渲染方式, 如 JSP、Thymeleaf 等。
- 管理控制器 (Controller) 组件:
- 可以声明 Spring MVC 的控制器组件, 并配置它们的请求映射、方法参数解析等。
- 配置拦截器:
- 配置 Spring MVC 的拦截器, 实现对请求的预处理和后处理。
- 整合其他组件:
- 整合其他 Web 相关的组件, 如 Spring Security、文件上传等。
- 处理 Web 请求:
- 在具体的 SSM 项目中, spring-mvc.xml文件通常包含以下主要内容:
- DispatcherServlet 配置:
- 定义 DispatcherServlet 作为前端控制器, 用于处理 Web 请求。
- HandlerMapping 配置:
- 配置 HandlerMapping 实现, 用于将 HTTP 请求映射到相应的控制器方法。
- ViewResolver 配置:
- 配置视图解析器, 用于将逻辑视图名解析为实际的视图实现。
- 控制器 (Controller) 组件扫描:
- 配置组件扫描, 自动扫描并注册 Spring MVC 控制器类。
- 其他配置:
- 如拦截器配置、异常处理、文件上传等 Web 应用相关的配置。
- DispatcherServlet 配置:
-
<?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context" xmlns:mvc="http://www.springframework.org/schema/mvc" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd"> <!-- 扫描 --> <context:component-scan base-package="com.its.controller"/> </beans>
-
配置web.xml
- Web 应用程序的部署描述符文件
- 作用:
- 配置前端控制器 (DispatcherServlet):
- 配置 Spring MVC 的前端控制器 DispatcherServlet,用于拦截和处理所有 Web 请求。
- 配置 Spring 容器:
- 配置和加载 Spring 应用上下文,将 Spring 的相关配置文件(如 spring-mvc.xml, spring-mybatis.xml 等)引入到 Web 应用程序中。
- 配置字符编码过滤器:
- 配置字符编码过滤器,确保 Web 应用程序的请求和响应都使用正确的字符编码。
- 配置 Spring Security (可选):
- 如果 Web 应用程序使用 Spring Security 进行权限控制,web.xml 文件可用于配置 Spring Security 过滤器链。
- 配置其他过滤器:
- 于配置其他 Web 应用程序所需的过滤器,如 Gzip 压缩过滤器、缓存过滤器等。
- 配置错误页面:
- 可以定义当 Web 应用程序抛出特定异常或返回特定 HTTP 状态码时,应该渲染的错误页面。
- 配置前端控制器 (DispatcherServlet):
- 在具体的 SSM 项目中, web.xml文件通常包含以下主要内容:
- DispatcherServlet 配置:
- 定义 DispatcherServlet 并映射到 URL patterns。
- Spring 应用上下文配置:
- 加载 Spring 配置文件,如 spring-mvc.xml、spring-mybatis.xml 等。
- 字符编码过滤器配置:
- 配置 CharacterEncodingFilter 以确保正确的字符编码。
- 错误页面配置:
- 定义针对特定异常或 HTTP 状态码的错误页面。
- 其他过滤器配置:
- 如 Spring Security 过滤器、Gzip 压缩过滤器等。
- DispatcherServlet 配置:
-
<!--Servlet 2.3 版本的 DTD 定义,声明了 Web 应用程序的版本信息 --> <!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd" > <!--定义了应用程序的名称。--> <web-app> <display-name>Archetype Created Web Application</display-name> <!--spring--> <!--<context-param> 和 <listener> 标签用于配置 Spring 应用上下文,加载 spring.xml 配置文件。--> <context-param> <param-name>contextConfigLocation</param-name> <param-value>classpath:spring.xml</param-value> </context-param> <!--Spring 的监听器类,负责启动和管理 Spring 容器。--> <listener> <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class> </listener> <!--MVC--> <!--<servlet> 和 <servlet-mapping> 标签用于配置 Spring MVC 的前端控制器 DispatcherServlet。 --> <servlet> <servlet-name>dispatcherServlet</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <init-param> <param-name>contextConfigLocation</param-name> <param-value>classpath:spring-mvc.xml</param-value> </init-param> </servlet> <!--DispatcherServlet 的配置文件为 spring-mvc.xml。/* 的 URL 映射表示 DispatcherServlet 将拦截所有的 Web 请求。 --> <!--<servlet-mapping> <servlet-name>dispatcherServlet</servlet-name> <url-pattern>/*</url-pattern> </servlet-mapping>--> <!--<welcome-file-list> 标签用于配置应用程序的欢迎页面,这里设置为 index.jsp。 --> <welcome-file-list> <welcome-file>index.jsp</welcome-file> </welcome-file-list> </web-app>
-
配置Tomcat服务器
-
5.编写简单的查询测试项目
-
- BooksController.java:负责接收客户端的 HTTP 请求,调用业务逻辑,并返回适当的响应结果
/**
* Created with IntelliJ IDEA.
*
* @Author: YuaaanC
* @Date: 2024/08/02
*/
//@Controller: 这个注解将这个类标记为一个 Spring MVC 控制器,用于处理 Web 请求。
@Controller
//@RequestMapping("/books")这个注解将这个控制器映射到 /books 这个 URL 路径下
@RequestMapping("/books")
public class BooksController {
//@Autowired 注解自动注入了 BooksService 类型的 bean,用于调用图书相关的业务逻辑。
@Autowired
private BooksService booksService;
//@RequestMapping("/list") 处理 /books/list 这个 URL 路径的请求。
@RequestMapping("/l")
public void list(){
List<Books> list=booksService.list();
list.forEach(System.out::println);
}
}
BooksMapper.java:负责数据访问层的核心组件,它定义了对象相关的数据操作方法,并与 MyBatis 的 SQL 映射机制无缝集成,为业务层提供了标准化的数据访问接口。
@Mapper//作用就是将Mapper系列的内容移交给Spring处理
public interface BooksMapper {
List<Books> list();
- Books.java:实体类对象
@Data
@Accessors(chain = true)
public class Books {
//图书ID
private int bookId;
//图书标题
private String title;
//作者
private String author;
//出版日期
private Date publicationDate;
//ISBN号,唯一索引
private String isbn;
//图书类型
private String genre;
}
- BooksService.java:负责业务逻辑处理的关键组件,它为控制层提供了一组标准化的服务接口,并协调数据访问层的操作
public interface BooksService {
List<Books> list();
}
- BooksServiceImpl.java:负责实现业务逻辑的核心类,它基于 BooksService 接口提供了具体的业务方法实现,并协调了控制层和数据访问层之间的交互。
@Service
public class BooksServiceImpl implements BooksService {
@Autowired
private BooksMapper booksMapper;
@Override
public List<Books> list() {
System.out.println("哈哈哈哈哈哈哈哈");
return booksMapper.list();
}
}
- BooksMapper.xml:集中定义了与实体类相关的 SQL 语句
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.its.mapper.BooksMapper" >
<sql id="books">
book_id,title,author,publication_date,isbn,genre
</sql>
<select id="list" resultType="com.its.pojo.Books">
select <include refid="books"/> from books
</select>
</mapper>