|
最新稳定版请使用Spring Session 3.5.3! |
春季课程 - HttpSession(快速入门)
本指南介绍了如何使用 Spring Session 透明地利用关系型来支持网页应用HttpSession基于XML的配置。
| 你可以在 httpsession-jdbc-xml 示例应用中找到完成的指南。 |
更新依赖关系
在使用春季会话之前,您必须更新依赖。 如果你使用Maven,必须添加以下依赖关系:
<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配置:
(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 参考文档。
XML Servlet 容器初始化
我们的春季配置创建了一个名为springSessionRepositoryFilter实现Filter.
这springSessionRepositoryFilterBean负责替换HttpSession并采用由 Spring Session 支持的自定义实现。
为了我们的Filter要施展魔法,我们需要指示Spring加载我们的session.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配置。
最后,我们需要确保我们的Servlet容器(即Tomcat)使用我们的springSessionRepositoryFilter每一个请求。
以下摘录为我们完成了这一最后步骤:
<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被召唤。
HTTPsession-JDBC-XML示例应用
本节介绍了如何与HTTPsession-JDBC-XML示例应用。
运行HTTPsession-JDBC-XML示例应用
您可以通过获取源代码并调用以下命令来运行示例:
$ ./gradlew :spring-session-sample-xml-jdbc:tomcatRun
你现在应该可以在localhost:8080/访问该应用了
探索HTTPsession-JDBC-XML示例应用
现在你可以试试用这个应用了。填写表格时需填写以下信息:
-
属性名称:用户名
-
属性值:盗贼
现在点击设置属性按钮。你现在应该能在表格中看到显示的数值。
它是如何运作的?
我们与标准互动HttpSession以下内容SessionServlet:
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(使用Chrome或Firefox)。
你可以使用H2网页控制台(localhost:8080/h2-console/)删除会话(使用)JDBC:H2:mem:testDB用于JDBC URL)
现在你可以访问 localhost:8080/ 的应用程序,发现我们添加的属性已不再显示。