Spring中文文档-第一部分
一、 Spring 框架概述
Spring是为了构建企业应用的轻量级框架。然而,Spring是模块化的,允许你只是使用其中的一部分,不需要引入其他的。你可以在任何web框架上使用IoC容器,也可以只使用Hibernate集成代码或JDBC抽象层。Spring框架支持声明式事务管理、通过RMI远程访问、WebService和持久化数据。它还提供全功能的MVC框架,和将AOP应用到你的系统上。
Spring设计为非侵入式的,意味着你的逻辑代码不依赖与框架本身。
1. 开始使用Spring
学习Spring看这个文档就没错。
注意JDK版本要求:
- JDK 6+ for Spring Framework 4.x
- JDK 5+ for Spring Framework 3.x
2. Spring框架介绍
Spring是应用于Java平台的,使用它可以让你更专注于你的代码。
做为一个程序员,你可以在Spring中获得以下好处:
- 不使用事务APIs写代码就让一个方法有事务处理功能
- 不使用remote APIs就可以让本地方法访问远程程序
- 不使用JMX APIs就可以让一个本地方法管理操作
- 不使用JMS APIs就可以让本地代码处理消息
2.1 依赖注入和控制反转(IoC)
一个Java应用程序,对象间往往是相互依赖的。
Spring框架的控制反转(Inversion of Control)就是为了解决这个问题的。
2.2 各模块
Spring大约分为20个模块,这些模块分为核心容器、数据访问/集成、Web、AOP、Instrumentation、消息和测试,如下图所示:
2.2.1 核心容器
核心容器由spring-core
、spring-beans
、spring-context
、spring-context
和spring-expression
5个模块构成。
spring-core
和spring-beans
模块为框架提供最基本的功能,包括IoC和依赖注入。BeanFactory
是一个工厂的实现类。它可以免除用户手动创建单例类并且对象之间解耦。
context(spring-core
)模块基于spring-beans
和BeanFactory
两个模块,允许以框架方式访问对象,这类似于JNDI。Context模块继承了Beans模块,并支持国际化、事件传播、资源加载等。Context模块支持Java EE特性,如EJB、JMX、远程访问。spring-context
接口是Contet模块的重点。spring-context-support
提供将第三方库集成到Spring的功能,如缓存(EhCache,JCache)和任务调度(CommonJ,Quartz)等。
spring-expression
模块提供强有力的在运行时查询和操作对象的语言。这种语言支持获取和设置属性、方法执行、获取数组或集合中的对象、逻辑计算、命名变量,在Spring的IoC容器中获得对象。
2.2.2 AOP 和 Instrumentation
spring-aop
模块提供切面编程的实现。可以自定义方法拦截和切入点。
spring-aspects
模块提供与AspectJ的集成。
spring-instrument
模块为特定的服务器提供类加载服务。spring-instrument
模块是集成了Tomcat。
2.2.3 消息
Spring4提供了spring-messaging
模块,主要类有Message
,MessageChannel
,MessageHandler
。这个模块还包含一些映射消息到方法的注解,类似于Spring MVC基于编程模式的注解。
2.2.4 数据访问/集成
这一层由JDBC、ORM、OXM、JMS、和事物模块组成。
spring-jdbc
模块,主要为了解决数据库繁多的问题,应用此可不需要关注使用的数据库。
spring-tx
模块提供编程式或声明式事务处理。
spring-orm
模块提供流行的对象关系映射的APIs,包含JPA和Hibernate.
spring-oxm
模块提供对Object/XML映射的支持,例如JAXB,Castor,JiBX和XStream。
spring-jms
模块(Java消息服务)包含生成和消费消息的功能。在Spring4.1以后,它集成了spring-messaging
模块。
2.2.5 Web
Web层包含spring-web
、spring-webmvc
和spring-websocket
3个模块。
spring-web
模块提供面向Web方法的集成特性,例如多部分文件上传、通过监听初始化IoC容器和面向Web的Context,还包含HTTP客户端和对远程的支持。
spring-webmvc
模块(也被称作Web-Servlet模块)包含Spring MVC框架。
spring-websocket
模块提供对socket的全面支持。
2.2.6 测试
spring-test
模块通过JUnit或者TestNG来对Spring的模块进行单元测试和集成测试。它提供一致的Spring 的ApplicationContexts
和context的缓存。它还提供mock对象让你测试你的代码。
2.3 使用场景
Spring可以应用在大部分场景和各种企业级应用。
2.3.1 依赖管理和命名约定
依赖管理和依赖注入是不同的东西。为了应用好的特性(比如依赖注入)到你的程序中,你需要添加所有必须的jar包。依赖关系可以是直接的或者是间接的(例如我的应用依赖于commons-dbcp
,而它又依赖于ApplicationContexts
)。间接依赖是传递的,所以非常难以管理。
为了方便的使用Spring,Spring已经尽量的减少依赖和进行模块化,如果你不打算写一个Web应用那么就不需要引入spring-web模块。为了方便代表Spring的jar包,以后使用spring-*
或spring-*.jar
来代替,*
为不同的模块(例如,spring-core
,spring-webmvc
,spring-jms
),但是实际的jar包会有相应的版本信息(例如,spring-core-5.0.0.BUILD-SNAPSHOT.jar
)。
每一个版本的Spring将发布在Maven中心,格式为spring-*-<version>.jar
,Maven的坐标为org.springframework。
所以首先你应该决定怎么去管理你的依赖,我们建议使用自动化管理工具例如Maven,Gradle或者Ivy,当然你也可以下载后手动管理。
以下是Spring的所有jar包。
GroupId | ArtifactId | 描述 |
---|---|---|
org.springframework |
spring-aop |
基于代理的AOP支持 |
org.springframework |
spring-aspects |
基于AspectJ 的切面编程 |
org.springframework |
spring-beans |
Beans的支持, 包括 Groovy |
org.springframework |
spring-context |
应用程序运行时上下文,包括调度和远程抽象 |
org.springframework |
spring-context-support |
提供第三方库到Spring的支持 |
org.springframework |
spring-core |
核心工具类,被其他模块使用 |
org.springframework |
spring-expression |
Spring 表达式语言 (SpEL) |
org.springframework |
spring-instrument |
代理JVM相关的 |
org.springframework |
spring-instrument-tomcat |
Tomcat的插件 |
org.springframework |
spring-jdbc |
提供jdbc的支持,包括数据源和JDBC访问 |
org.springframework |
spring-jms |
JMS支持包,包括接收和发送消息类的支持 |
org.springframework |
spring-messaging |
对消息传递体系结构和协议的支持 |
org.springframework |
spring-orm |
对象/关系 映射, 拨快对JPA 和 Hibernate的支持 |
org.springframework |
spring-oxm |
对象/XML 映射的支持 |
org.springframework |
spring-test |
对Spring组件单元测试和集成测试的支持 |
org.springframework |
spring-tx |
事物支持,包块DAO支持和JCA集成 |
org.springframework |
spring-web |
Web 支持,包括客户端和Web访问 |
org.springframework |
spring-webmvc |
一个MVC框架 |
org.springframework |
spring-websocket |
WebSocket 和SockJS 的实现,包括对STOMP的支持 |
一个Maven的依赖如下:
<dependencies> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-context</artifactId> <version>5.0.0.BUILD-SNAPSHOT</version> <scope>runtime</scope> </dependency> </dependencies>
如果你不需要编译Spring APIs可以声明作用域为runtime。
+提示
Maven坐标查询可以在http://mvnrepository.com/网站查询到。
最新稳定版为4.3.3.RELEASE
,建议使用这个版本。
上面是用的Maven仓库,当然也可以使用Spring的Maven仓库,只需要指定仓库地址即可,如下:
<repositories> <repository> <id>io.spring.repo.maven.release</id> <url>http://repo.spring.io/release/</url> <snapshots><enabled>false</enabled></snapshots> </repository> </repositories>
为了防止下载不同版本的Spring,可以引入spring-framework-bom
到你的dependencyManagement
中,这可以确保你的所有Spring会使用同一个版本。
<dependencyManagement> <dependencies> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-framework-bom</artifactId> <version>5.0.0.BUILD-SNAPSHOT</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement>
那么以后增加Spring模块的时候就不需要再指定<version>
标签了:
<dependencies> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-context</artifactId> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-web</artifactId> </dependency> <dependencies>
2.3.2 日志记录
日志是非常重要的。因为现在日志框架特别多,所以选择变得很困难。
在Spring中强制使用的是Jakarta Commons Logging API (JCL),在Spring中也显示的使用了JCL。对有所有的模块使用相同的日志框架是非常重要的,Spring是这么做的,让spring-core
模块显示的依赖commons-logging
,而其他模块则是在编译时依赖。
2.3.2.1 不使用Commons Logging
如果不想使用commons-logging
而想使用其他日志门面(例如slf4j),可以这么做:
- 在
spring-core
模块中排除对commons-logging
的依赖(只有这个模块明确依赖commons-logging
) - 依赖一个特殊的日志门面框架
排除指定的日志框架如下:
<dependencies> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-core</artifactId> <version>5.0.0.BUILD-SNAPSHOT</version> <exclusions> <exclusion> <groupId>commons-logging</groupId> <artifactId>commons-logging</artifactId> </exclusion> </exclusions> </dependency> </dependencies>
现在应用程序应该不能正常工作了,因为没有指定一个日志框架,下面将使用slf4j来代替。
2.3.2.2 使用slf4j
slf4j是一个好的日志门面框架,比commons-logging
性能要高。并且是在编译时绑定。
下面的例子展示了使用slf4j日志门面框架,并使用log4j具体日志框架的例子:
<dependencies> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-core</artifactId> <version>5.0.0.BUILD-SNAPSHOT</version> <exclusions> <exclusion> <groupId>commons-logging</groupId> <artifactId>commons-logging</artifactId> </exclusion> </exclusions> </dependency> <dependency> <groupId>org.slf4j</groupId> <artifactId>jcl-over-slf4j</artifactId> <version>1.5.8</version> </dependency> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-api</artifactId> <version>1.5.8</version> </dependency> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-log4j12</artifactId> <version>1.5.8</version> </dependency> <dependency> <groupId>log4j</groupId> <artifactId>log4j</artifactId> <version>1.2.14</version> </dependency> </dependencies>
2.3.2.3 使用log4j
如果你就想使用log4j,也不需要上面那么负责的依赖,可以简单的使用如下例子即可:
<dependencies> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-core</artifactId> <version>5.0.0.BUILD-SNAPSHOT</version> </dependency> <dependency> <groupId>log4j</groupId> <artifactId>log4j</artifactId> <version>1.2.14</version> </dependency> </dependencies>
再给出一个简单的log4j.properties例子:
log4j.rootCategory=INFO, stdout
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{ABSOLUTE} %5p %t %c{2}:%L - %m%n
log4j.category.org.springframework.beans.factory=DEBUG
+附言
文档目录详见:http://www.cnblogs.com/yiwangzhibujian/p/5893219.html
这是翻译的Spring文档的第一部分,如果看过原文应该可以看出这个翻译是很简略的,尤其是在大段文本的翻译上,但是重点部分还是不会省略的,我这么做的目的是不想把时间和精力放在那些文本语言的推敲上,而是以程序员的思维提取重点部分,就像文档一开始的JDK版本要求,就是随意加上的,原文没有,但是我觉得比较重要。这样会比较相对快一点翻译完这个文档,等以后有时间在慢慢做修补工作。