[java-opensaml COMMIT] /trunk/opensaml-storage-api/src/main/java/org/opensaml/storage/StorageService.java

[noreply at shibboleth.net]

Author: scantor
Date: Fri Feb  5 10:50:32 2016
New Revision: 4424

URL: http://svn.shibboleth.net/view/java-opensaml?rev=4424&view=rev
Log:
Clarifying comment in javadoc about expiration.

Modified:
    trunk/opensaml-storage-api/src/main/java/org/opensaml/storage/StorageService.java

Modified: trunk/opensaml-storage-api/src/main/java/org/opensaml/storage/StorageService.java
URL: http://svn.shibboleth.net/view/java-opensaml/trunk/opensaml-storage-api/src/main/java/org/opensaml/storage/StorageService.java?rev=4424&r1=4423&r2=4424&view=diff
==============================================================================
--- trunk/opensaml-storage-api/src/main/java/org/opensaml/storage/StorageService.java	(original)
+++ trunk/opensaml-storage-api/src/main/java/org/opensaml/storage/StorageService.java	Fri Feb  5 10:50:32 2016
@@ -42,7 +42,11 @@
  * by the implementation to callers, but MUST be at least 255 characters.</p>
  * 
  * <p>Expiration is expressed in milliseconds since the beginning of the epoch,
- * or a null can be used to signify no expiration.</p>
+ * or a null can be used to signify no expiration. Implementations <strong>MUST</strong>
+ * persist the expiration in a manner that allows the exact value supplied to be
+ * recovered. It is not sufficient to ensure that records expire; the actual
+ * value is used in many cases as part of the data set being stored and cannot be
+ * perturbed.</p>
  */
 @ThreadSafeAfterInit
 public interface StorageService extends IdentifiedComponent {