Skip to content

Commit 614d345

Browse files
jiachao2310006984
authored andcommitted
添加目录结构
1 parent 1c7c482 commit 614d345

File tree

3 files changed

+124
-2
lines changed

3 files changed

+124
-2
lines changed

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,11 @@
44

55
为依赖注入,事务管理,Web应用程序,数据访问,消息传递等提供核心支持。
66

7-
该项目为 Spring Framework文档翻译项目,基于 [Spring 5.1.4](https://spring.io/projects/spring-framework) 的官方文档进行翻译。
7+
该项目为 Spring Framework文档翻译项目,基于 [Spring 5.1.3](https://spring.io/projects/spring-framework) 的官方文档进行翻译。
88

99
## 阅读方式
1010

11-
[Github](https://github.com/DocsHome/springboot/blob/master/SUMMARY.md) | [Gitbook](https://www.gitbook.com/book/docshome/springboot)
11+
[Github](https://github.com/DocsHome/spring-docs/SUMMARY.md) | [Gitbook](https://www.gitbook.com/book/docshome/spring-docs)
1212

1313
## 项目状态
1414

SUMMARY.md

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
# Spring Framework 中文文档
2+
> #### Version 5.1.3.BUILD-SNAPSHOT
3+
>
4+
> 最新特性, 更新日志, 支持的版本, 以及其他话题,项目的发布追踪,都在项目的 [Github Wiki](https://github.com/spring-projects/spring-framework/wiki).进行维护
5+
6+
## [概述](https://github.com/DocsHome/spring-docs/pages/overview/overview.md)
7+
Spring的历史介绍,设计理念,反馈和贡献,以及入门指南.
8+
9+
## [核心组件](https://github.com/DocsHome/spring-docs/pages/core/core.md)
10+
11+
IoC 容器, 事件, 资源, 国际化, 验证, 数据绑定, 类型转换, SpEL, AOP.
12+
13+
## [测试](https://github.com/DocsHome/spring-docs/pages/test/test.md)
14+
15+
Mock objects,, TestContext框架, Spring MVC 测试, WebTestClient.
16+
17+
## [数据访问](https://github.com/DocsHome/spring-docs/pages/dataaccess/data-access.md)
18+
19+
Transactions(事务支持), DAO support(DAO 支持), JDBC, ORM(对象关系映射), 编组 XML.
20+
21+
## [Web Servlet](https://github.com/DocsHome/spring-docs/pages/web/web.md)
22+
23+
Spring MVC, WebSocket, SockJS, STOMP 消息.
24+
25+
## [Web Reactive框架](https://github.com/DocsHome/spring-docs/pages/webreactive/web-reactive.md)
26+
27+
Spring WebFlux, WebClient, WebSocket.
28+
29+
## [集成](https://github.com/DocsHome/spring-docs/pages/integration/integration.md)
30+
31+
Remoting(远程调用), JMS(java消息服务), JCA(J2EE 连接器架构), JMX(Java管理扩展), Email(电子邮箱), Tasks(任务执行), Scheduling(调度), Cache(缓存).
32+
33+
## [语言](https://github.com/DocsHome/spring-docs/pages/languages/languages.md)
34+
35+
Kotlin, Groovy, Dynamic languages.

pages/overview/overview.md

Lines changed: 87 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,87 @@
1+
<a id="overview"></a>
2+
3+
# Spring Framework 概述
4+
5+
**Spring 使创建 Java 企业应用程序变得更加容易。它提供了在企业环境中接受 Java 语言所需的一切,,并支持 Groovy 和 Kotlin 作为 JVM 上的替代语言,并可根据应用程序的需要灵活地创建多种体系结构。
6+
从 Spring Framework 5.0 开始,Spring 需要 JDK 8(Java SE 8+),并且已经为 JDK 9 提供了现成的支持。**
7+
8+
Spring支持各种应用场景, 在大型企业中, 应用程序通常需要运行很长时间,而且必须运行在 jdk 和应用服务器上,这种场景开发人员无法控制其升级周期。 其他可能作为一个单独的jar嵌入到服务器去运行,也有可能在云环境中。还有一些可能是不需要服务器的独立应用程序(如批处理或集成的工作任务)。
9+
10+
Spring 是开源的。它拥有一个庞大而且活跃的社区,提供不同范围的,真实用户的持续反馈。这也帮助Spring不断地改进,不断发展。
11+
12+
<a id="overview-spring"></a>
13+
14+
## 1、"Spring"是什么?
15+
16+
Spring在不同的背景下有这不同的含义。它可以指 Spring Framework项目本身,这也是创建他的初衷。随着时间的推移,其他的"Spring" 项目已经构建在Spring框架之上。大多数时候,当人们说 "Spring",他们指的是整个项目家族。本参考文档主要侧重于Spring的基本:也就是Spring框架本身。
17+
18+
整个Spring框架被分成多个模块,应用程序可以选择需要的部分。core是核心容器的模块,包括模块配置和依赖注入机制 。Spring框架还为不同的应用程序体系结构提供了基础支持,包括消息传递,事务数据和持久化以及Web,还包括基于Servlet的Spring MVC Web框架 ,以及Spring WebFlux响应式Web框架。
19+
20+
关于模块的说明: Spring Framework 的jar包允许部署到JDK 9的模块路径("Jigsaw")。为了在支持Jigsaw的应用程序中使用, Spring Framework 5的jar带有 "Automatic-Module-Name" 清单条目,它定义了稳定的语言级模块名称(例如"spring.code","spring.context"等)独立于jar部件名称(jar遵循相同的命名模式使用"-"号代替".", 例如"spring-core" 和 "spring-context")。当然,Spring Framework 的jar包在JDK 8和9的类路径上都能保持正常工作。
21+
22+
<a id="overview-history"></a>
23+
24+
## 2、Spring和Spring框架的历史
25+
26+
Spring 的初版发布在2003年,是为了克服早期 J2EE 规范的复杂性。虽然有些人认为 [J2EE](https://en.wikipedia.org/wiki/Java_Platform,_Enterprise_Edition) 和 Spring 是竞争的,但是Spring 实际上是对 Java EE 的补充。Spring编程模型不受 Java EE 的平台制约,相反 它与精心挑选的个别规范的java EE项 目结合:
27+
28+
- Servlet API ([JSR 340](https://jcp.org/en/jsr/detail?id=340))
29+
30+
- WebSocket API ([JSR 356](https://www.jcp.org/en/jsr/detail?id=356))
31+
32+
- Concurrency Utilities ([JSR 236](https://www.jcp.org/en/jsr/detail?id=236))
33+
34+
- JSON Binding API ([JSR 367](https://jcp.org/en/jsr/detail?id=367))
35+
36+
- Bean Validation ([JSR 303](https://jcp.org/en/jsr/detail?id=303))
37+
38+
- JPA ([JSR 338](https://jcp.org/en/jsr/detail?id=338))
39+
40+
- JMS ([JSR 914](https://jcp.org/en/jsr/detail?id=914))
41+
42+
- as well as JTA/JCA setups for transaction coordination, if necessary.
43+
44+
Spring框架还支持依赖注入([JSR 330](https://www.jcp.org/en/jsr/detail?id=330))和通用注解([JSR 250](https://jcp.org/en/jsr/detail?id=250)) 规范, 应用程序开发人员可以选择使用这些规范,而不是Spring Framework提供的Spring特定机制。
45+
46+
在Spring框架5.0版本中,Spring最低要求使用Java EE 7的版本(例如Servlet 3.1+, JPA 2.1+),同时在运行时能与使用Java EE 8的最新API集成(例如Servlet 4.0, JSON Binding API)。 这使得Spring能完全兼容Tomcat 8/9、WebSphere 9或者JBoss EAP 7等等。
47+
48+
随着时间的不断推移,Java EE在应用程序开发中越发重要,也不断发展、改善。在Java EE和Spring的早期,应用程序被创建为部署到服务器的应用。如今,在有Spring Boot的帮助后,应用可以创建在devops或云端。 而Servlet容器的嵌入和一些琐碎的东西也发生了变化。在Spring框架5中,WebFlux应用程序甚至可以不直接使用Servlet的API,并且可以在非Servlet容器的服务器(如Netty)上运行。
49+
50+
Spring还在继续创新和发展,如今,除了Spring框架以外,还加入了其他项目,如:`Spring Boot`, `Spring Security`, `Spring Data`, `Spring Cloud`, `Spring Batch` 等等。请记住,每一个Spring项目都有自己的源代码库, 问题跟踪以及发布版本。请上[spring.io/projects](https://spring.io/projects)查看所有Spring家族的项目名单。
51+
52+
53+
54+
<a id="overview-philosophy"></a>
55+
56+
## 3、Spring的设计理念
57+
58+
当你学习一个框架时,不仅需要知道他是如何运作的,更需要知道他遵循什么样的原则,以下是 Spring 框架遵循的原则:
59+
60+
- 提供各个层面的选择。Spring 允许您尽可能延迟设计决策。例如,您可以在不更改代码的情况下通过配置切换持久性功能。对于其他基础架构的问题以及与第三方API的集成也是如此。
61+
62+
- 包含多个使用视角。Spring 的灵活性非常高,而不是规定了某部分只能做某一件事.他以不同的视角支持广泛的应用需求
63+
64+
- 保持向后兼容。Spring 的发展经过了精心的设计,在不同版本之间保持与前版本的兼容。Spring 支持一系列精心挑选的 JDK 版本和第三方库,以方便维护依赖于 Spring 的应用程序和库。
65+
66+
- 关心API的设计。Spring团队投入了大量的思考和时间来制作直观的API,并在许多版本和许多年中都保持不变。
67+
68+
- 高标准的代码质量。Spring 框架提供了强有力的、精确的、即时的Javadoc。Spring这种要求干净、简洁的代码结构、包之间没有循环依赖的项目在Java界是少有的。
69+
70+
71+
<a id="overview-feedback"></a>
72+
73+
## 4、反馈和贡献
74+
75+
对于操作方法问题或诊断或调试问题,我们建议使用 Stackoverflow。Spring 在此网站上有一个专用的页面[questions page](https://spring.io/questions) ,列出了建议使用的标记。 如果你相当确定 Spring 框架存在问题,或者想建议添加功能等等,可以使用 [JIRA 的问题追踪](https://jira.spring.io/browse/spr)
76+
77+
如果你想到了某问题的解决方案或者想建议,你可以在 [Github](https://github.com/spring-projects/spring-framework) 上提交请求。但是, 我们希望在此之前,你可以在问题跟踪页面先提交一波,在那里可以进行讨论并留下记录以作参考。
78+
79+
有关更多详情,请参阅 [CONTRIBUTING](https://github.com/spring-projects/spring-framework/blob/master/CONTRIBUTING.md) 项目页面
80+
81+
<a id="overview-getting-started"></a>
82+
83+
## 5、入门指南
84+
85+
如果你是刚开始使用 Spring 的话,希望你能使用基于 [Spring Boot](https://projects.spring.io/spring-boot/) 来编写应用程序,由此开始使用Spring框架。Spring Boot提供了一种快速(固定设置 )的方式来创建即时能用的 Spring 应用程序。它基于Spring框架,利用已有的约束配置,目的是让你的程序尽快跑起来。
86+
87+
你可以使用 [start.spring.io](https://start.spring.io/) 里的步骤来生成基本项目。或者参考 ["Getting Started" guides](https://spring.io/guides) ,例如开始创建RESTful风格的Web服务 。除了易于理解,这些指南都是非常注重任务,其中大多数是基于Spring Boot的。当然,里面还囊括了 Spring 其他很多项目,你可能在需要某些功能时用得上。

0 commit comments

Comments
 (0)