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），可以这么做：

1. 在spring-core模块中排除对commons-logging的依赖（只有这个模块明确依赖commons-logging）
2. 依赖一个特殊的日志门面框架

　　排除指定的日志框架如下：

<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

+附言

　　文档目录详见：http://www.cnblogs.com/yiwangzhibujian/p/5893219.html　　

　　这是翻译的Spring文档的第一部分，如果看过原文应该可以看出这个翻译是很简略的，尤其是在大段文本的翻译上，但是重点部分还是不会省略的，我这么做的目的是不想把时间和精力放在那些文本语言的推敲上，而是以程序员的思维提取重点部分，就像文档一开始的JDK版本要求，就是随意加上的，原文没有，但是我觉得比较重要。这样会比较相对快一点翻译完这个文档，等以后有时间在慢慢做修补工作。