What's new and migrating are prominently featured
Before this commit those were burried in the Appendix where few would guess to look. Previously that information was at the top, so it makes sense to point to the Github wiki from the index HTML page. Also a general update of the index page. Since we have recently revised the overview, we can simply point to it and keep it shorter. The section listing now includes more details per section.
This commit is contained in:
Rossen Stoyanchev
parent
6597551858
commit
45c207aece
|
|
@ -7,18 +7,6 @@
|
|||
:toclevels: 2
|
||||
:docinfo1:
|
||||
|
||||
[[spring-whats-new]]
|
||||
== What's New in the Spring Framework
|
||||
"What's New" guides for releases of the Spring Framework are now provided as a
|
||||
link:{wiki-spring-framework}/++What's-New-in-the-Spring-Framework++[Wiki page].
|
||||
|
||||
|
||||
[[migration-4.x]]
|
||||
== Migrating to Spring Framework 4.3 / 5.0
|
||||
Migration guides for upgrading from previous releases of the Spring Framework are now provided as a
|
||||
{wiki-spring-framework}/Migrating-from-earlier-versions-of-the-spring-framework[Wiki page].
|
||||
|
||||
|
||||
[[annotation-programming-model]]
|
||||
== Spring Annotation Programming Model
|
||||
Spring's annotation programming model is documented in the
|
||||
|
|
|
|||
|
|
@ -3,36 +3,27 @@ The Spring Framework team and contributors https://github.com/spring-projects/sp
|
|||
:doc-root: https://docs.spring.io
|
||||
:api-spring-framework: {doc-root}/spring-framework/docs/{spring-version}/javadoc-api/org/springframework
|
||||
|
||||
Welcome to the Spring Framework reference!
|
||||
|
||||
The Spring Framework is a lightweight solution and a potential one-stop-shop for
|
||||
building your enterprise-ready applications. However, Spring is modular, allowing you to
|
||||
use only those parts that you need, without having to bring in the rest. You can use the
|
||||
IoC container, with any web framework on top, but you can also use only the
|
||||
<<data-access.adoc#orm-hibernate,Hibernate integration code>> or the
|
||||
<<data-access.adoc#jdbc-introduction,JDBC abstraction layer>>. The Spring Framework supports declarative
|
||||
transaction management, remote access to your logic through RMI or web services, and various
|
||||
options for persisting your data.
|
||||
It offers full-featured web frameworks such as <<web.adoc#mvc,Spring Web MVC>>
|
||||
and <<web-reactive.adoc#webflux, Spring WebFlux>>; and it enables you to
|
||||
integrate <<core.adoc#aop-introduction,AOP>> transparently into your software.
|
||||
Please read the <<overview.adoc,Overview>> for an introduction including brief history,
|
||||
design philosophy, where to ask questions, and tips to get started. For information on
|
||||
what's new, or migrating from a previous version, check the
|
||||
https://github.com/spring-projects/spring-framework/wiki[Github Wiki].
|
||||
|
||||
This document is a reference guide to Spring Framework features. Questions on the
|
||||
Framework itself should be asked on StackOverflow (see https://spring.io/questions[]).
|
||||
The reference is divided into several sections:
|
||||
|
||||
This reference document provides the following sections:
|
||||
|
||||
* <<overview.adoc#spring-introduction,Overview of the Spring Framework>>
|
||||
|
||||
* <<core.adoc#spring-core,Core concepts such as IoC and AOP>>
|
||||
|
||||
* <<testing.adoc#testing,Testing with Spring>>
|
||||
|
||||
* <<data-access.adoc#spring-data-tier,Data access and transaction management>>
|
||||
|
||||
* The Web on <<web.adoc#spring-web,Servlet>> or <<web-reactive.adoc#spring-webflux,Reactive>> stacks
|
||||
|
||||
* <<kotlin.adoc#kotlin,Kotlin support>>
|
||||
|
||||
* <<integration.adoc#spring-integration,Integration with other technologies>>
|
||||
|
||||
* <<appendix.adoc#spring-appendices,Appendix>>
|
||||
[horizontal]
|
||||
<<core.adoc#spring-core,Core>> :: IoC container, Events, Resources, i18n, Validation,
|
||||
Data Binding, Type Conversion, SpEL, AOP.
|
||||
<<testing.adoc#testing,Testing>> :: Mock objects, TestContext framework,
|
||||
Spring MVC Test, WebTestClient.
|
||||
<<data-access.adoc#spring-data-tier,Data Access>> :: Transactions, DAO support, JDBC,
|
||||
ORM, Marshalling XML.
|
||||
<<web.adoc#spring-web,Web Servlet>> :: Spring MVC web framework, WebSocket,
|
||||
SockJS, STOMP messaging.
|
||||
<<web-reactive.adoc#spring-webflux,Web Reactive>> :: Spring WebFlux,
|
||||
WebClient, WebSocket support.
|
||||
<<integration.adoc#spring-integration,Integration>> :: Remoting, JMS, JCA, JMX, Email,
|
||||
Tasks, Scheduling, Cache, Dynamic languages.
|
||||
<<kotlin.adoc#kotlin,Kotlin>> :: Extensions, Bean Definition DSL, WebFlux DSL
|
||||
<<appendix.adoc#spring-appendices,Appendix>> :: XML Schemas, JSP Tag Libraries
|
||||
|
|
@ -1,6 +1,7 @@
|
|||
:toc: left
|
||||
:toclevels: 1
|
||||
:docinfo1:
|
||||
|
||||
= Spring Framework Overview
|
||||
|
||||
Spring makes it easy to create Java enterprise applications. It provides everything you
|
||||
|
|
@ -19,6 +20,7 @@ Spring is open source. It has a large and active community that provides continu
|
|||
based on a diverse range of real-world use cases. This has helped Spring to successfully
|
||||
evolve over a very long time.
|
||||
|
||||
[[overview-spring]]
|
||||
== What We Mean by "Spring"
|
||||
|
||||
The term "Spring" means different things in different contexts. It can be used to refer to
|
||||
|
|
@ -41,6 +43,7 @@ A note about modules: Spring's framework jars allow for deployment to JDK 9's mo
|
|||
the same naming pattern with "-" instead of ".", e.g. "spring-core" and "spring-context").
|
||||
Of course, Spring's framework jars keep working fine on the classpath on both JDK 8 and 9.
|
||||
|
||||
[[overview-history]]
|
||||
== History of Spring and the Spring Framework
|
||||
|
||||
Spring came into being in 2003 as a response to the complexity of the early
|
||||
|
|
@ -81,6 +84,7 @@ among others. It’s important to remember that each project has its own source
|
|||
issue tracker, and release cadence. See https://spring.io/projects[spring.io/projects] for
|
||||
the complete list of Spring projects.
|
||||
|
||||
[[overview-philosophy]]
|
||||
== Design Philosophy
|
||||
|
||||
When you learn about a framework, it’s important to know not only what it does but what
|
||||
|
|
@ -103,6 +107,7 @@ that are intuitive and that hold up across many versions and many years.
|
|||
meaningful, current, and accurate Javadoc. It is one of very few projects that can claim
|
||||
clean code structure with no circular dependencies between packages.
|
||||
|
||||
[[overview-feedback]]
|
||||
== Feedback and Contributions
|
||||
|
||||
For how-to questions or diagnosing or debugging issues, we suggest using StackOverflow,
|
||||
|
|
@ -122,6 +127,7 @@ information that is not specific to any one version. For example, it has migrati
|
|||
notes from earlier versions, comprehensive information on what's new across multiple
|
||||
versions, contributor guidelines, the Spring Framework code style, and other information.
|
||||
|
||||
[[overview-getting-started]]
|
||||
== Getting Started
|
||||
|
||||
If you are just getting started with Spring, you may want to begin using the Spring
|
||||
|
|
|
|||
Loading…
Reference in New Issue