org.springframework.session.hazelcast.config.annotation.web.http

Annotation Type EnableHazelcastHttpSession

@Retention(value=RUNTIME)
 @Target(value=TYPE)
 @Documented
 @Import(value=HazelcastHttpSessionConfiguration.class)
 @Configuration
public @interface EnableHazelcastHttpSession

Add this annotation to an @Configuration class to expose the SessionRepositoryFilter as a bean named springSessionRepositoryFilter and backed by Hazelcast. In order to leverage the annotation, a single HazelcastInstance must be provided. For example:

 @Configuration
 @EnableHazelcastHttpSession
 public class HazelcastHttpSessionConfig {

     @Bean
     public HazelcastInstance embeddedHazelcast() {
         Config hazelcastConfig = new Config();
         return Hazelcast.newHazelcastInstance(hazelcastConfig);
     }

 }
 

More advanced configurations can extend HazelcastHttpSessionConfiguration instead.

Since:

1.1

See Also:

EnableSpringHttpSession

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
HazelcastFlushMode	hazelcastFlushMode Flush mode for the Hazelcast sessions.
int	maxInactiveIntervalInSeconds The session timeout in seconds.
java.lang.String	sessionMapName This is the name of the Map that will be used in Hazelcast to store the session data.

Element Detail

maxInactiveIntervalInSeconds

public abstract int maxInactiveIntervalInSeconds

The session timeout in seconds. By default, it is set to 1800 seconds (30 minutes). This should be a non-negative integer.

Returns:

the seconds a session can be inactive before expiring

Default:

1800

sessionMapName

public abstract java.lang.String sessionMapName

This is the name of the Map that will be used in Hazelcast to store the session data. Default is HazelcastSessionRepository.DEFAULT_SESSION_MAP_NAME.

Returns:

the name of the Map to store the sessions in Hazelcast

Default:

"spring:session:sessions"

hazelcastFlushMode

public abstract HazelcastFlushMode hazelcastFlushMode

Flush mode for the Hazelcast sessions. The default is ON_SAVE which only updates the backing Hazelcast when SessionRepository.save(Session) is invoked. In a web environment this happens just before the HTTP response is committed.

Setting the value to IMMEDIATE will ensure that the any updates to the Session are immediately written to the Hazelcast instance.

Returns:

the HazelcastFlushMode to use

Since:

1.3.0

Default:

org.springframework.session.hazelcast.HazelcastFlushMode.ON_SAVE