Spring Boot第一性原理:约定优于配置的威力
系列导航:本文是《Spring框架第一性原理》系列的第4篇 第1篇:为什么我们需要Spring框架? 第2篇:IoC容器:从手动new到自动装配的演进 第3篇:AOP:从代码重复到面向切面编程 第4篇:Spring Boot:约定优于配置的威力(本文) 引子:配置地狱的噩梦 场景重现:创建一个Spring Web应用(传统方式) 想象你是2013年的Java开发者,接到任务:创建一个简单的RESTful API服务。使用传统Spring框架,你需要经历以下"噩梦": 第一步:手动配置依赖(pom.xml,约50行) <!-- 1. Spring核心依赖 --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-core</artifactId> <version>4.3.9.RELEASE</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-context</artifactId> <version>4.3.9.RELEASE</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-beans</artifactId> <version>4.3.9.RELEASE</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-web</artifactId> <version>4.3.9.RELEASE</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>4.3.9.RELEASE</version> </dependency> <!-- 2. Jackson JSON依赖 --> <dependency> <groupId>com.fasterxml.jackson.core</groupId> <artifactId>jackson-databind</artifactId> <version>2.8.9</version> </dependency> <!-- 3. Servlet API --> <dependency> <groupId>javax.servlet</groupId> <artifactId>javax.servlet-api</artifactId> <version>3.1.0</version> <scope>provided</scope> </dependency> <!-- 4. 日志依赖 --> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-api</artifactId> <version>1.7.25</version> </dependency> <dependency> <groupId>ch.qos.logback</groupId> <artifactId>logback-classic</artifactId> <version>1.2.3</version> </dependency> <!-- 问题:--> <!-- ❌ 依赖繁多:手动引入10+个依赖 --> <!-- ❌ 版本冲突:spring-core必须和spring-webmvc版本一致 --> <!-- ❌ 依赖遗漏:忘记jackson导致JSON序列化失败 --> 第二步:配置web.xml(约30行) <!-- src/main/webapp/WEB-INF/web.xml --> <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_3_1.xsd" version="3.1"> <!-- 1. 配置Spring上下文监听器 --> <listener> <listener-class> org.springframework.web.context.ContextLoaderListener </listener-class> </listener> <!-- 2. 配置Spring上下文配置文件位置 --> <context-param> <param-name>contextConfigLocation</param-name> <param-value>/WEB-INF/applicationContext.xml</param-value> </context-param> <!-- 3. 配置DispatcherServlet --> <servlet> <servlet-name>dispatcher</servlet-name> <servlet-class> org.springframework.web.servlet.DispatcherServlet </servlet-class> <init-param> <param-name>contextConfigLocation</param-name> <param-value>/WEB-INF/dispatcher-servlet.xml</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet> <!-- 4. 配置Servlet映射 --> <servlet-mapping> <servlet-name>dispatcher</servlet-name> <url-pattern>/</url-pattern> </servlet-mapping> <!-- 5. 配置字符编码过滤器 --> <filter> <filter-name>encodingFilter</filter-name> <filter-class> org.springframework.web.filter.CharacterEncodingFilter </filter-class> <init-param> <param-name>encoding</param-name> <param-value>UTF-8</param-value> </init-param> </filter> <filter-mapping> <filter-name>encodingFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> </web-app> <!-- 问题:--> <!-- ❌ XML冗长:30行配置只为启动Web应用 --> <!-- ❌ 路径硬编码:配置文件路径写死 --> <!-- ❌ 易出错:一个标签写错就启动失败 --> 第三步:配置applicationContext.xml(约40行) <!-- src/main/webapp/WEB-INF/applicationContext.xml --> <?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: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/tx http://www.springframework.org/schema/tx/spring-tx.xsd"> <!-- 1. 启用注解扫描 --> <context:component-scan base-package="com.example"> <context:exclude-filter type="annotation" expression="org.springframework.stereotype.Controller"/> </context:component-scan> <!-- 2. 加载properties文件 --> <context:property-placeholder location="classpath:application.properties"/> <!-- 3. 配置数据源 --> <bean id="dataSource" class="com.zaxxer.hikari.HikariDataSource"> <property name="driverClassName" value="${jdbc.driver}"/> <property name="jdbcUrl" value="${jdbc.url}"/> <property name="username" value="${jdbc.username}"/> <property name="password" value="${jdbc.password}"/> <property name="maximumPoolSize" value="20"/> </bean> <!-- 4. 配置JdbcTemplate --> <bean id="jdbcTemplate" class="org.springframework.jdbc.core.JdbcTemplate"> <property name="dataSource" ref="dataSource"/> </bean> <!-- 5. 配置事务管理器 --> <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager"> <property name="dataSource" ref="dataSource"/> </bean> <!-- 6. 启用事务注解 --> <tx:annotation-driven transaction-manager="transactionManager"/> </beans> <!-- 问题:--> <!-- ❌ 配置繁琐:每个Bean都要显式配置 --> <!-- ❌ 命名空间复杂:xsi:schemaLocation写错就无法启动 --> <!-- ❌ 重复配置:每个项目都要写相同的配置 --> 第四步:配置dispatcher-servlet.xml(约30行) <!-- src/main/webapp/WEB-INF/dispatcher-servlet.xml --> <?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:mvc="http://www.springframework.org/schema/mvc" xmlns:context="http://www.springframework.org/schema/context" xsi:schemaLocation=" http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd"> <!-- 1. 扫描Controller --> <context:component-scan base-package="com.example.controller"/> <!-- 2. 启用Spring MVC注解 --> <mvc:annotation-driven> <mvc:message-converters> <!-- 配置JSON转换器 --> <bean class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter"> <property name="objectMapper"> <bean class="com.fasterxml.jackson.databind.ObjectMapper"> <property name="dateFormat"> <bean class="java.text.SimpleDateFormat"> <constructor-arg value="yyyy-MM-dd HH:mm:ss"/> </bean> </property> </bean> </property> </bean> </mvc:message-converters> </mvc:annotation-driven> <!-- 3. 配置静态资源处理 --> <mvc:default-servlet-handler/> <!-- 4. 配置拦截器 --> <mvc:interceptors> <bean class="com.example.interceptor.LogInterceptor"/> </mvc:interceptors> </beans> 第五步:配置应用(application.properties) # 数据库配置 jdbc.driver=com.mysql.jdbc.Driver jdbc.url=jdbc:mysql://localhost:3306/mydb?useUnicode=true&characterEncoding=utf8 jdbc.username=root jdbc.password=123456 # 日志配置 logging.level.root=INFO logging.level.com.example=DEBUG 第六步:编写业务代码 // Controller @RestController @RequestMapping("/api/users") public class UserController { @Autowired private UserService userService; @GetMapping("/{id}") public User getUser(@PathVariable Long id) { return userService.getUser(id); } } // Service @Service public class UserService { @Autowired private JdbcTemplate jdbcTemplate; public User getUser(Long id) { return jdbcTemplate.queryForObject( "SELECT * FROM users WHERE id = ?", new Object[]{id}, new BeanPropertyRowMapper<>(User.class) ); } } 第七步:部署到Tomcat # 1. 打包成WAR文件 mvn clean package # 2. 将WAR文件复制到Tomcat webapps目录 cp target/myapp.war /usr/local/tomcat/webapps/ # 3. 启动Tomcat /usr/local/tomcat/bin/startup.sh # 4. 访问应用 curl http://localhost:8080/myapp/api/users/1 统计:传统Spring Web应用的复杂度 维度 数量/行数 说明 配置文件数量 5个 pom.xml、web.xml、applicationContext.xml、dispatcher-servlet.xml、application.properties 配置代码行数 约200行 纯配置代码,不含业务逻辑 依赖数量 15+个 需要手动管理版本 外部容器依赖 Tomcat 必须部署到Servlet容器 启动时间 约30秒 Tomcat启动 + Spring初始化 学习曲线 陡峭 XML配置、命名空间、Schema 问题总结 传统Spring Web应用的五大痛点: 1. 配置地狱(Configuration Hell) ├─ XML配置文件冗长(200+行) ├─ 命名空间复杂(记不住schemaLocation) ├─ 配置分散(5个配置文件) └─ 重复配置(每个项目都要写) 2. 依赖管理噩梦(Dependency Hell) ├─ 依赖繁多(15+个Maven依赖) ├─ 版本冲突(Spring各模块版本必须一致) ├─ 依赖遗漏(忘记引入导致运行时错误) └─ 传递依赖混乱(A依赖B,B依赖C的不同版本) 3. 容器部署复杂 ├─ 必须依赖外部容器(Tomcat、Jetty) ├─ 打包成WAR文件 ├─ 部署步骤繁琐 └─ 环境不一致(开发环境 vs 生产环境) 4. 启动速度慢 ├─ Tomcat启动耗时 ├─ Spring容器初始化耗时 └─ 总启动时间:30秒+ 5. 学习成本高 ├─ XML配置语法 ├─ Spring命名空间 ├─ 容器部署知识 └─ 调试困难(配置错误定位难) 对比:Spring Boot的"魔法" 同样的需求,Spring Boot只需要这样: 第一步:创建项目(使用Spring Initializr) 访问 https://start.spring.io/,选择: ...