最新稳定版请使用Spring Session 3.5.3spring-doc.cadn.net.cn

春季课程 - HttpSession(快速入门)

本指南介绍了如何使用 Spring Session 透明地利用关系型来支持网页应用HttpSession基于XML的配置。spring-doc.cadn.net.cn

你可以在 httpsession-jdbc-xml 示例应用中找到完成的指南。

更新依赖关系

在使用春季会话之前,您必须更新依赖。 如果你使用Maven,必须添加以下依赖关系:spring-doc.cadn.net.cn

pom.xml
<dependencies>
	<!-- ... -->

	<dependency>
		<groupId>org.springframework.session</groupId>
		<artifactId>spring-session-jdbc</artifactId>
		<version>3.4.6</version>
		<type>pom</type>
	</dependency>
	<dependency>
		<groupId>org.springframework</groupId>
		<artifactId>spring-web</artifactId>
		<version>6.2.12</version>
	</dependency>
</dependencies>

Spring XML 配置

添加所需的依赖后,我们可以创建 Spring 配置。 Spring配置负责创建一个servletFilter,以替换HttpSession实现时,Spring Session支持的实现。 以下列表展示了如何添加以下Spring配置:spring-doc.cadn.net.cn

src/main/webapp/WEB-INF/spring/session.xml
(1)
<context:annotation-config/>
<bean class="org.springframework.session.jdbc.config.annotation.web.http.JdbcHttpSessionConfiguration"/>

(2)
<jdbc:embedded-database id="dataSource" database-name="testdb" type="H2">
	<jdbc:script location="classpath:org/springframework/session/jdbc/schema-h2.sql"/>
</jdbc:embedded-database>

(3)
<bean class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
	<constructor-arg ref="dataSource"/>
</bean>
1 我们使用以下组合:<context:annotation-config/>JdbcHttpSessionConfiguration因为 Spring Session 尚未支持 XML 命名空间(参见 gh-104)。 这会形成一种名为springSessionRepositoryFilter. 豆子的实现Filter. 过滤器负责更换HttpSession实施将由Spring Session支持。 在这种情况下,Spring Session 是由关系型数据库支持的。
2 我们创建一个数据来源它将 Spring Session 连接到 H2 数据库的嵌入式实例。 我们通过 Spring Session 中包含的 SQL 脚本配置 H2 数据库来创建数据库表。
3 我们创建一个transactionManager它管理已配置的交易数据来源.

有关如何配置数据访问相关问题的更多信息,请参见 Spring Framework 参考文档spring-doc.cadn.net.cn

XML Servlet 容器初始化

我们的春季配置创建了一个名为springSessionRepositoryFilter实现Filter. 这springSessionRepositoryFilterBean负责替换HttpSession并采用由 Spring Session 支持的自定义实现。spring-doc.cadn.net.cn

为了我们的Filter要施展魔法,我们需要指示Spring加载我们的session.xml配置。 我们采用以下配置实现:spring-doc.cadn.net.cn

src/main/webapp/WEB-INF/web.xml
<context-param>
	<param-name>contextConfigLocation</param-name>
	<param-value>
		/WEB-INF/spring/session.xml
	</param-value>
</context-param>
<listener>
	<listener-class>
		org.springframework.web.context.ContextLoaderListener
	</listener-class>
</listener>

ContextLoaderListener读道contextConfigLocation并接收到我们的session.xml配置。spring-doc.cadn.net.cn

最后,我们需要确保我们的Servlet容器(即Tomcat)使用我们的springSessionRepositoryFilter每一个请求。 以下摘录为我们完成了这一最后步骤:spring-doc.cadn.net.cn

src/main/webapp/WEB-INF/web.xml
<filter>
	<filter-name>springSessionRepositoryFilter</filter-name>
	<filter-class>org.springframework.web.filter.DelegatingFilterProxy</filter-class>
</filter>
<filter-mapping>
	<filter-name>springSessionRepositoryFilter</filter-name>
	<url-pattern>/*</url-pattern>
	<dispatcher>REQUEST</dispatcher>
	<dispatcher>ERROR</dispatcher>
</filter-mapping>

DelegatingFilterProxy查找一个叫做springSessionRepositoryFilter并将其铸造为Filter. 对于每一个请求DelegatingFilterProxy被调用时,springSessionRepositoryFilter被召唤。spring-doc.cadn.net.cn

HTTPsession-JDBC-XML示例应用

本节介绍了如何与HTTPsession-JDBC-XML示例应用。spring-doc.cadn.net.cn

运行HTTPsession-JDBC-XML示例应用

您可以通过获取源代码并调用以下命令来运行示例:spring-doc.cadn.net.cn

$ ./gradlew :spring-session-sample-xml-jdbc:tomcatRun

你现在应该可以在localhost:8080/访问该应用了spring-doc.cadn.net.cn

探索HTTPsession-JDBC-XML示例应用

现在你可以试试用这个应用了。填写表格时需填写以下信息:spring-doc.cadn.net.cn

现在点击设置属性按钮。你现在应该能在表格中看到显示的数值。spring-doc.cadn.net.cn

它是如何运作的?

我们与标准互动HttpSession以下内容SessionServlet:spring-doc.cadn.net.cn

src/main/java/sample/SessionServlet.java
public class SessionServlet extends HttpServlet {

	@Override
	protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws IOException {
		String attributeName = req.getParameter("attributeName");
		String attributeValue = req.getParameter("attributeValue");
		req.getSession().setAttribute(attributeName, attributeValue);
		resp.sendRedirect(req.getContextPath() + "/");
	}

	private static final long serialVersionUID = 2878267318695777395L;

}

而不是用Tomcat的HttpSession,我们将这些值持久化在H2数据库中。 Spring Session 创建了一个名为会期在你的浏览器里。这个Cookie里包含了你会话的ID。 你可以查看这些Cookie(使用ChromeFirefox)。spring-doc.cadn.net.cn

你可以使用H2网页控制台(localhost:8080/h2-console/)删除会话(使用)JDBC:H2:mem:testDB用于JDBC URL)spring-doc.cadn.net.cn

现在你可以访问 localhost:8080/ 的应用程序,发现我们添加的属性已不再显示。spring-doc.cadn.net.cn