net.shibboleth.idp.profile.logic

Class DateAttributePredicate

java.lang.Object

net.shibboleth.idp.profile.logic.AbstractAttributePredicate

net.shibboleth.idp.profile.logic.DateAttributePredicate

All Implemented Interfaces:

com.google.common.base.Predicate<ProfileRequestContext>

public class DateAttributePredicate
extends AbstractAttributePredicate

Provides a date/time matching predicate that compares a date-based attribute value against current system time with optional offset. By convention the predicate returns true if and only if the date represented by the attribute value is after the current system time; false otherwise. Thus the semantics are well-suited for cases such as evaluation of expiration dates.

Field Summary

Fields

Modifier and Type	Field and Description
private String	attributeName Name of attribute to query for.
private org.joda.time.format.DateTimeFormatter	dateTimeFormatter Formatter used to parse string-based date attribute values.
private org.slf4j.Logger	log Class logger.
private boolean	resultIfMissing Result of predicate if attribute is missing or has no values.
private org.joda.time.Duration	systemTimeOffset Offset from system time used for date comparisons.

Constructor Summary

Constructors

Constructor and Description
DateAttributePredicate(String attribute) Create a new instance that performs date comparisons against the given attribute using ISO date/time format parser by default.
DateAttributePredicate(String attribute, org.joda.time.format.DateTimeFormatter formatter) Deprecated.
DateAttributePredicate(String attribute, String formatString) Create a new instance that performs date comparisons against the given attribute using the given date parser.

Method Summary

Methods

Modifier and Type	Method and Description
protected boolean	allowNullAttributeContext() Get the result of the predicate in the case the attribute context is null.
protected boolean	hasMatch(Map<String,IdPAttribute> attributeMap) Abstract implementation of the condition to evaluate.
void	setOffset(long offset) Set the system time offset, which affects the reference date for comparisons.
void	setResultIfMissing(boolean flag) Set the result to return if the attribute to check is missing or has no values.
void	setSystemTimeOffset(org.joda.time.Duration offset) Deprecated.

Methods inherited from class net.shibboleth.idp.profile.logic.AbstractAttributePredicate

apply, getAttributeContextLookupStrategy, isUseUnfilteredAttributes, setAttributeContextLookupStrategy, setUseUnfilteredAttributes

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.google.common.base.Predicate

equals

Field Detail

log

@Nonnull
private final org.slf4j.Logger log

Class logger.

attributeName

@Nonnull
@NotEmpty
private final String attributeName

Name of attribute to query for.

dateTimeFormatter

@Nonnull
private final org.joda.time.format.DateTimeFormatter dateTimeFormatter

Formatter used to parse string-based date attribute values.

systemTimeOffset

@Nullable
private org.joda.time.Duration systemTimeOffset

Offset from system time used for date comparisons.

resultIfMissing

private boolean resultIfMissing

Result of predicate if attribute is missing or has no values.

Constructor Detail

DateAttributePredicate

public DateAttributePredicate(@Nonnull@NotEmpty@ParameterName(name="attribute")
                      String attribute)

Create a new instance that performs date comparisons against the given attribute using ISO date/time format parser by default.

Parameters:

attribute - Attribute name that provides candidate date values to test.

DateAttributePredicate

@Deprecated
public DateAttributePredicate(@Nonnull@NotEmpty@ParameterName(name="attribute")
                                 String attribute,
                                 @Nonnull@ParameterName(name="formatter")
                                 org.joda.time.format.DateTimeFormatter formatter)

Deprecated.

Create a new instance that performs date comparisons against the given attribute using the given date parser.

Parameters:

attribute - Attribute name that provides candidate date values to test.

formatter - Date/time parser.

DateAttributePredicate

public DateAttributePredicate(@Nonnull@NotEmpty@ParameterName(name="attribute")
                      String attribute,
                      @Nonnull@NotEmpty@ParameterName(name="formatString")
                      String formatString)

Create a new instance that performs date comparisons against the given attribute using the given date parser.

Parameters:

attribute - Attribute name that provides candidate date values to test.

formatString - date/time parsing string, currently based on DateTimeFormatter

Method Detail

setSystemTimeOffset

@Deprecated
public void setSystemTimeOffset(@Nonnull
                                  org.joda.time.Duration offset)

Deprecated.

Set the system time offset, which affects the reference date for comparisons. By default all comparisons are against system time, i.e. zero offset.

Parameters:

offset - System time offset. A negative value decreases the target date (sooner); a positive value increases the target date (later).

setOffset

@Duration
public void setOffset(@Duration
                      long offset)

Set the system time offset, which affects the reference date for comparisons. By default all comparisons are against system time, i.e. zero offset.

Parameters:

offset - System time offset. A negative value decreases the target date (sooner); a positive value increases the target date (later).

setResultIfMissing

public void setResultIfMissing(boolean flag)

Set the result to return if the attribute to check is missing or has no values.

Parameters:

flag - flag to set

allowNullAttributeContext

protected boolean allowNullAttributeContext()

Get the result of the predicate in the case the attribute context is null.

Overrides:

allowNullAttributeContext in class AbstractAttributePredicate

Returns:

null context result

hasMatch

protected boolean hasMatch(@Nonnull@NonnullElements
               Map<String,IdPAttribute> attributeMap)

Abstract implementation of the condition to evaluate.

Specified by:

hasMatch in class AbstractAttributePredicate

Parameters:

attributeMap - the attributes to evaluate

Returns:

the condition result