From 509fb99a5d27a7f7a275ebc6c15a8595a2eb7dfa Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vedran=20Pavi=C4=87?= Date: Fri, 20 May 2016 18:56:58 +0200 Subject: [PATCH] Improve JDBC transaction management doc --- docs/src/docs/asciidoc/guides/httpsession-jdbc-xml.adoc | 2 ++ docs/src/docs/asciidoc/guides/httpsession-jdbc.adoc | 2 ++ docs/src/docs/asciidoc/index.adoc | 2 +- .../session/jdbc/JdbcOperationsSessionRepository.java | 5 +++-- .../config/annotation/web/http/EnableJdbcHttpSession.java | 5 +++++ 5 files changed, 13 insertions(+), 3 deletions(-) diff --git a/docs/src/docs/asciidoc/guides/httpsession-jdbc-xml.adoc b/docs/src/docs/asciidoc/guides/httpsession-jdbc-xml.adoc index c0a7d89e..6bed75dd 100644 --- a/docs/src/docs/asciidoc/guides/httpsession-jdbc-xml.adoc +++ b/docs/src/docs/asciidoc/guides/httpsession-jdbc-xml.adoc @@ -87,6 +87,8 @@ In this instance Spring Session is backed by a relational database. We configure the H2 database to create database tables using the SQL script which is included in Spring Session. <3> We create a `transactionManager` that manages transactions for previously configured `dataSource`. +For additional information on how to configure data access related concerns, please refer to the http://docs.spring.io/spring/docs/current/spring-framework-reference/html/spring-data-tier.html[Spring Framework Reference Documentation]. + == XML Servlet Container Initialization Our <> created a Spring Bean named `springSessionRepositoryFilter` that implements `Filter`. diff --git a/docs/src/docs/asciidoc/guides/httpsession-jdbc.adoc b/docs/src/docs/asciidoc/guides/httpsession-jdbc.adoc index 178d6592..bdcab3a0 100644 --- a/docs/src/docs/asciidoc/guides/httpsession-jdbc.adoc +++ b/docs/src/docs/asciidoc/guides/httpsession-jdbc.adoc @@ -85,6 +85,8 @@ In this instance Spring Session is backed by a relational database. We configure the H2 database to create database tables using the SQL script which is included in Spring Session. <3> We create a `transactionManager` that manages transactions for previously configured `dataSource`. +For additional information on how to configure data access related concerns, please refer to the http://docs.spring.io/spring/docs/current/spring-framework-reference/html/spring-data-tier.html[Spring Framework Reference Documentation]. + == Java Servlet Container Initialization Our <> created a Spring Bean named `springSessionRepositoryFilter` that implements `Filter`. diff --git a/docs/src/docs/asciidoc/index.adoc b/docs/src/docs/asciidoc/index.adoc index 48a43be2..18e39d97 100644 --- a/docs/src/docs/asciidoc/index.adoc +++ b/docs/src/docs/asciidoc/index.adoc @@ -1012,7 +1012,7 @@ A typical example of how to create a new instance can be seen below: include::{indexdoc-tests}[tags=new-jdbcoperationssessionrepository] ---- -For additional information on how to create and configure `JdbcTemplate` and `PlatformTransactionManager`, refer to the Spring Framework Reference Documentation. +For additional information on how to create and configure `JdbcTemplate` and `PlatformTransactionManager`, refer to the http://docs.spring.io/spring/docs/current/spring-framework-reference/html/spring-data-tier.html[Spring Framework Reference Documentation]. [[api-jdbcoperationssessionrepository-config]] ==== EnableJdbcHttpSession diff --git a/spring-session/src/main/java/org/springframework/session/jdbc/JdbcOperationsSessionRepository.java b/spring-session/src/main/java/org/springframework/session/jdbc/JdbcOperationsSessionRepository.java index 74c93b8f..2504ebd4 100644 --- a/spring-session/src/main/java/org/springframework/session/jdbc/JdbcOperationsSessionRepository.java +++ b/spring-session/src/main/java/org/springframework/session/jdbc/JdbcOperationsSessionRepository.java @@ -83,8 +83,9 @@ import org.springframework.util.StringUtils; * new JdbcOperationsSessionRepository(jdbcTemplate, transactionManager); * * - * For additional information on how to create and configure a JdbcTemplate, refer to the - * + * For additional information on how to create and configure {@link JdbcTemplate} and + * {@link PlatformTransactionManager}, refer to the + * * Spring Framework Reference Documentation. *

* By default, this implementation uses SPRING_SESSION and diff --git a/spring-session/src/main/java/org/springframework/session/jdbc/config/annotation/web/http/EnableJdbcHttpSession.java b/spring-session/src/main/java/org/springframework/session/jdbc/config/annotation/web/http/EnableJdbcHttpSession.java index 121c0997..0cfb4322 100644 --- a/spring-session/src/main/java/org/springframework/session/jdbc/config/annotation/web/http/EnableJdbcHttpSession.java +++ b/spring-session/src/main/java/org/springframework/session/jdbc/config/annotation/web/http/EnableJdbcHttpSession.java @@ -55,6 +55,11 @@ import org.springframework.session.config.annotation.web.http.EnableSpringHttpSe * * More advanced configurations can extend {@link JdbcHttpSessionConfiguration} instead. * + * For additional information on how to configure data access related concerns, please + * refer to the + * + * Spring Framework Reference Documentation. + * * @author Vedran Pavic * @since 1.2.0 * @see EnableSpringHttpSession