org.opensaml.storage.impl

Class ServletRequestScopedStorageService

java.lang.Object

net.shibboleth.utilities.java.support.component.AbstractInitializableComponent

net.shibboleth.utilities.java.support.component.AbstractIdentifiedInitializableComponent

net.shibboleth.utilities.java.support.component.AbstractIdentifiableInitializableComponent

org.opensaml.storage.AbstractStorageService

org.opensaml.storage.AbstractMapBackedStorageService

org.opensaml.storage.impl.ServletRequestScopedStorageService

All Implemented Interfaces:

Filter, net.shibboleth.utilities.java.support.component.Component, net.shibboleth.utilities.java.support.component.DestructableComponent, net.shibboleth.utilities.java.support.component.IdentifiableComponent, net.shibboleth.utilities.java.support.component.IdentifiedComponent, net.shibboleth.utilities.java.support.component.InitializableComponent, RequestScopedStorageService, StorageCapabilities, StorageService

public class ServletRequestScopedStorageService
extends AbstractMapBackedStorageService
implements RequestScopedStorageService, Filter

Implementation of RequestScopedStorageService that stores data in-memory in a servlet request attribute, and reads and writes the data with a secured string form using JSON as the underlying format.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	ServletRequestScopedStorageService.DummyReadWriteLock Dummy shared lock that no-ops.
private class	ServletRequestScopedStorageService.OutputInterceptingHttpServletResponseProxy An implementation of HttpServletResponse which detects a response going out from a servlet and executes a save operation.

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	CONTEXT_MAP_ATTRIBUTE Name of request attribute for context map.
private net.shibboleth.utilities.java.support.net.CookieManager	cookieManager Manages creation of cookies.
private String	cookieName Name of cookie used to track storage.
private net.shibboleth.utilities.java.support.security.DataSealer	dataSealer DataSealer instance to secure data.
private static String	DEFAULT_COOKIE_NAME Default cookie name for storage tracking.
protected static String	DIRTY_BIT_ATTRIBUTE Name of request attribute used as a dirty bit.
private static ReadWriteLock	DUMMY_LOCK A dummy lock implementation.
private HttpServletRequest	httpServletRequest Servlet request.
private HttpServletResponse	httpServletResponse Servlet response.
private net.shibboleth.utilities.java.support.security.DataSealerKeyStrategy	keyStrategy KeyStrategy enabling us to detect whether data has been sealed with an older key.
private Logger	log Class logger.

Constructor Summary

Constructors

Constructor and Description
ServletRequestScopedStorageService() Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	create(String context, String key, String value, Long expiration)
void	deleteContext(String context)
protected boolean	deleteImpl(Long version, String context, String key)
void	doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
protected void	doInitialize()
protected TimerTask	getCleanupTask()
protected Map<String,Map<String,MutableStorageRecord>>	getContextMap()
String	getCookieName() Get the cookie name to use for storage tracking.
protected ReadWriteLock	getLock()
void	init(FilterConfig filterConfig)
private boolean	isDirty() Get the dirty bit for the current request.
protected void	load() Reconstitute stored data.
void	reap(String context)
protected void	save() Write/preserve stored data for subsequent requests.
void	setCleanupInterval(long interval)
void	setCookieManager(net.shibboleth.utilities.java.support.net.CookieManager manager) Set the CookieManager to use.
void	setCookieName(String name) Set the cookie name to use for storage tracking.
void	setDataSealer(net.shibboleth.utilities.java.support.security.DataSealer sealer) Set the DataSealer to use for data security.
private void	setDirty(boolean flag) Set the dirty bit for the current request.
void	setHttpServletRequest(HttpServletRequest request) Set the servlet request in which to manage per-request data.
void	setHttpServletResponse(HttpServletResponse response) Set the servlet response in which to manage per-request data.
void	setKeyStrategy(net.shibboleth.utilities.java.support.security.DataSealerKeyStrategy strategy) Set the DataSealerKeyStrategy to use for stale key detection.
void	updateContextExpiration(String context, Long expiration)
protected Long	updateImpl(Long version, String context, String key, String value, Long expiration)

Methods inherited from class org.opensaml.storage.AbstractMapBackedStorageService

delete, deleteWithVersion, read, read, readImpl, reapWithLock, update, updateExpiration, updateWithVersion

Methods inherited from class org.opensaml.storage.AbstractStorageService

create, create, delete, deleteWithVersion, doDestroy, getCapabilities, getCleanupInterval, getCleanupTaskTimer, getContextSize, getKeySize, getValueSize, read, setCleanupTaskTimer, setContextSize, setKeySize, setValueSize, update, update, updateExpiration, updateWithVersion, updateWithVersion

Methods inherited from class net.shibboleth.utilities.java.support.component.AbstractIdentifiableInitializableComponent

setId

Methods inherited from class net.shibboleth.utilities.java.support.component.AbstractIdentifiedInitializableComponent

getId

Methods inherited from class net.shibboleth.utilities.java.support.component.AbstractInitializableComponent

destroy, initialize, isDestroyed, isInitialized

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.opensaml.storage.StorageService

create, create, delete, delete, deleteWithVersion, deleteWithVersion, getCapabilities, read, read, read, update, update, update, updateExpiration, updateExpiration, updateWithVersion, updateWithVersion, updateWithVersion

Methods inherited from interface net.shibboleth.utilities.java.support.component.IdentifiedComponent

getId

Methods inherited from interface javax.servlet.Filter

destroy

Field Detail

CONTEXT_MAP_ATTRIBUTE

@Nonnull
protected static final String CONTEXT_MAP_ATTRIBUTE

Name of request attribute for context map.

See Also:

Constant Field Values

DIRTY_BIT_ATTRIBUTE

@Nonnull
protected static final String DIRTY_BIT_ATTRIBUTE

Name of request attribute used as a dirty bit.

See Also:

Constant Field Values

DEFAULT_COOKIE_NAME

@Nonnull
@NotEmpty
private static final String DEFAULT_COOKIE_NAME

Default cookie name for storage tracking.

See Also:

Constant Field Values

DUMMY_LOCK

@Nonnull
private static final ReadWriteLock DUMMY_LOCK

A dummy lock implementation.

log

@Nonnull
private final Logger log

Class logger.

httpServletRequest

@NonnullAfterInit
private HttpServletRequest httpServletRequest

Servlet request.

httpServletResponse

@NonnullAfterInit
private HttpServletResponse httpServletResponse

Servlet response.

cookieManager

@NonnullAfterInit
private net.shibboleth.utilities.java.support.net.CookieManager cookieManager

Manages creation of cookies.

cookieName

@Nonnull
@NotEmpty
private String cookieName

Name of cookie used to track storage.

dataSealer

@NonnullAfterInit
private net.shibboleth.utilities.java.support.security.DataSealer dataSealer

DataSealer instance to secure data.

keyStrategy

@Nullable
private net.shibboleth.utilities.java.support.security.DataSealerKeyStrategy keyStrategy

KeyStrategy enabling us to detect whether data has been sealed with an older key.

Constructor Detail

ServletRequestScopedStorageService

public ServletRequestScopedStorageService()

Constructor.

Method Detail

setCleanupInterval

public void setCleanupInterval(long interval)

Overrides:

setCleanupInterval in class AbstractStorageService

setHttpServletRequest

public void setHttpServletRequest(@Nonnull
                         HttpServletRequest request)

Set the servlet request in which to manage per-request data.

Parameters:

request - servlet request in which to manage data

setHttpServletResponse

public void setHttpServletResponse(@Nonnull
                          HttpServletResponse response)

Set the servlet response in which to manage per-request data.

Parameters:

response - servlet response in which to manage data

setCookieManager

public void setCookieManager(@Nonnull
                    net.shibboleth.utilities.java.support.net.CookieManager manager)

Set the CookieManager to use.

Parameters:

manager - the CookieManager to use.

getCookieName

@Nonnull
@NotEmpty
public String getCookieName()

Get the cookie name to use for storage tracking.

Returns:

cookie name to use

setCookieName

public void setCookieName(@Nonnull@NotEmpty
                 String name)

Set the cookie name to use for storage tracking.

Parameters:

name - cookie name to use

setDataSealer

public void setDataSealer(@Nonnull
                 net.shibboleth.utilities.java.support.security.DataSealer sealer)

Set the DataSealer to use for data security.

Parameters:

sealer - DataSealer to use for data security

setKeyStrategy

public void setKeyStrategy(@Nonnull
                  net.shibboleth.utilities.java.support.security.DataSealerKeyStrategy strategy)

Set the DataSealerKeyStrategy to use for stale key detection.

Parameters:

strategy - DataSealerKeyStrategy to use for stale key detection

doInitialize

protected void doInitialize()
                     throws net.shibboleth.utilities.java.support.component.ComponentInitializationException

Overrides:

doInitialize in class AbstractStorageService

Throws:

net.shibboleth.utilities.java.support.component.ComponentInitializationException

create

public boolean create(@Nonnull@NotEmpty
             String context,
             @Nonnull@NotEmpty
             String key,
             @Nonnull@NotEmpty
             String value,
             @Nullable
             Long expiration)
               throws IOException

Specified by:

create in interface StorageService

Overrides:

create in class AbstractMapBackedStorageService

Throws:

IOException

updateContextExpiration

public void updateContextExpiration(@Nonnull@NotEmpty
                           String context,
                           @Nullable
                           Long expiration)
                             throws IOException

Specified by:

updateContextExpiration in interface StorageService

Overrides:

updateContextExpiration in class AbstractMapBackedStorageService

Throws:

IOException

deleteContext

public void deleteContext(@Nonnull@NotEmpty
                 String context)
                   throws IOException

Specified by:

deleteContext in interface StorageService

Overrides:

deleteContext in class AbstractMapBackedStorageService

Throws:

IOException

reap

public void reap(@Nonnull@NotEmpty
        String context)
          throws IOException

Specified by:

reap in interface StorageService

Overrides:

reap in class AbstractMapBackedStorageService

Throws:

IOException

init

public void init(FilterConfig filterConfig)
          throws ServletException

Specified by:

init in interface Filter

Throws:

ServletException

doFilter

public void doFilter(ServletRequest request,
            ServletResponse response,
            FilterChain chain)
              throws IOException,
                     ServletException

Specified by:

doFilter in interface Filter

Throws:

IOException

ServletException

load

protected void load()
             throws IOException

Reconstitute stored data.

Throws:

IOException - if an error occurs reconstituting the data

save

@Nullable
protected void save()
             throws IOException

Write/preserve stored data for subsequent requests.

Throws:

IOException - if an error occurs preserving the data

updateImpl

@Nullable
protected Long updateImpl(@Nullable
                       Long version,
                       @Nonnull@NotEmpty
                       String context,
                       @Nonnull@NotEmpty
                       String key,
                       @Nullable
                       String value,
                       @Nullable
                       Long expiration)
                   throws IOException,
                          VersionMismatchException

Overrides:

updateImpl in class AbstractMapBackedStorageService

Throws:

IOException

VersionMismatchException

deleteImpl

protected boolean deleteImpl(@Nullable@Positive
                 Long version,
                 @Nonnull@NotEmpty
                 String context,
                 @Nonnull@NotEmpty
                 String key)
                      throws IOException,
                             VersionMismatchException

Overrides:

deleteImpl in class AbstractMapBackedStorageService

Throws:

IOException

VersionMismatchException

getCleanupTask

@Nullable
protected TimerTask getCleanupTask()

Overrides:

getCleanupTask in class AbstractStorageService

getContextMap

@Nonnull
@NonnullElements
@Live
protected Map<String,Map<String,MutableStorageRecord>> getContextMap()

Specified by:

getContextMap in class AbstractMapBackedStorageService

getLock

@Nonnull
protected ReadWriteLock getLock()

Specified by:

getLock in class AbstractMapBackedStorageService

setDirty

private void setDirty(boolean flag)

Set the dirty bit for the current request.

Parameters:

flag - dirty bit to set

isDirty

private boolean isDirty()

Get the dirty bit for the current request.

Returns:

status of dirty bit