• Home
• org.spincast
• spincast-website
• 2.1.1
• source code
• SpincastCacheHeadersRequestContextAddon.html

×

Project download

Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $

You can buy this project and download/modify it how often you want.

public.javadoc.org.spincast.plugins.httpcaching.SpincastCacheHeadersRequestContextAddon.html Maven / Gradle / Ivy

Package org.spincast.plugins.httpcaching
Class SpincastCacheHeadersRequestContextAddon<R extends RequestContext<?>>

java.lang.Object
org.spincast.plugins.httpcaching.SpincastCacheHeadersRequestContextAddon<R>



All Implemented Interfaces:
CacheHeadersRequestContextAddon<R>


public class SpincastCacheHeadersRequestContextAddon<R extends RequestContext<?>>
extends Object
implements CacheHeadersRequestContextAddon<R>






Field Summary
Fields

Modifier and Type
Field
Description
protected static final org.slf4j.Logger
logger
 






Constructor Summary
Constructors

Constructor
Description
SpincastCacheHeadersRequestContextAddon(R requestContext,
 ETagFactory etagFactory)
 






Method Summary

All MethodsInstance MethodsConcrete Methods


Modifier and Type
Method
Description
CacheHeadersRequestContextAddon<R>
cache(int seconds)

The number of seconds the client should cache this resource
 before requesting it again.

CacheHeadersRequestContextAddon<R>
cache(int seconds,
 boolean isPrivate)

The number of seconds the client should cache this resource
 before requesting it again.

CacheHeadersRequestContextAddon<R>
cache(int seconds,
 boolean isPrivate,
 Integer cdnSeconds)

The number of seconds the client should cache this resource
 before requesting it again.

CacheHeadersRequestContextAddon<R>
eTag(String currentTag)

Specifies the current ETag (strong) of the resource.

CacheHeadersRequestContextAddon<R>
eTag(String currentTag,
 boolean currentTagIsWeak)

Specifies the current strong or weak ETag of the resource.

CacheHeadersRequestContextAddon<R>
eTag(String currentTag,
 boolean currentTagIsWeak,
 boolean weakComparison)

Specifies the current strong or weak ETag of the resource.

protected String
formatDateForHttpHeader(Date date)
 
protected Date
getDateFromIfModifiedSinceHeader()
 
protected Date
getDateFromIfUnmodifiedSinceHeader()
 
protected ETag
getETag()
 
protected ETagFactory
getEtagFactory()
 
List<ETag>
getEtagsFromIfMatchHeader()
 
List<ETag>
getEtagsFromIfNoneMatchHeader()
 
protected Object
getExchange()
 
protected Date
getLastModificationDate()
 
protected R
getRequestContext()
 
protected boolean
isEtagMatches(ETag requestETag,
 boolean weakComparison)
 
protected boolean
isEtagsFromIfMatchHeaderContainsAWildcard()
 
protected boolean
isEtagsFromIfNoneMatchHeaderContainsAWildcard()
 
protected boolean
isETagWeakComparison()
 
protected boolean
isIfMatchEtagMatches()
 
protected boolean
isIfNoneMatchEtagMatches()
 
CacheHeadersRequestContextAddon<R>
lastModified(Date lastModificationDate)

Specifies the last modification date of the resource.

SpincastCacheHeadersRequestContextAddon<R>
noCache()

Sends "No Cache" headers so the resource is not cached
 at all by the client.

protected void
setETag(ETag eTag)
 
protected void
setETagWeakComparison(boolean eTagWeakComparison)
 
protected void
setLastModificationDate(Date lastModificationDate)
 
boolean
validate(boolean resourceCurrentlyExists)

Call this when you are done setting
 ETag and/or Last-Modified to validate
 them agains the headers sent by the client.





Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait









Field Details



logger
protected static final org.slf4j.Logger logger








Constructor Details



SpincastCacheHeadersRequestContextAddon
@Inject
public SpincastCacheHeadersRequestContextAddon(R requestContext,
 ETagFactory etagFactory)








Method Details



getRequestContext
protected R getRequestContext()




getEtagFactory
protected ETagFactory getEtagFactory()




getExchange
protected Object getExchange()




getETag
protected ETag getETag()




setETag
protected void setETag(ETag eTag)




isETagWeakComparison
protected boolean isETagWeakComparison()




setETagWeakComparison
protected void setETagWeakComparison(boolean eTagWeakComparison)




getLastModificationDate
protected Date getLastModificationDate()




setLastModificationDate
protected void setLastModificationDate(Date lastModificationDate)




eTag
public CacheHeadersRequestContextAddon<R> eTag(String currentTag)
Description copied from interface: CacheHeadersRequestContextAddon
Specifies the current ETag (strong) of the resource.
 

 A strong comparison will be used to compare the request ETag to this
 current ETag.
 
 

 Skip, or use null if the resource doesn't exist.
 

Specified by:
eTag in interface CacheHeadersRequestContextAddon<R extends RequestContext<?>>





eTag
public CacheHeadersRequestContextAddon<R> eTag(String currentTag,
 boolean currentTagIsWeak)
Description copied from interface: CacheHeadersRequestContextAddon
Specifies the current strong or weak ETag of the resource.
 

 A strong comparison will be used to compare the request ETag to this
 current ETag.
 
 

 Skip, or use null if the resource doesn't exist.
 

Specified by:
eTag in interface CacheHeadersRequestContextAddon<R extends RequestContext<?>>





eTag
public CacheHeadersRequestContextAddon<R> eTag(String currentTag,
 boolean currentTagIsWeak,
 boolean weakComparison)
Description copied from interface: CacheHeadersRequestContextAddon
Specifies the current strong or weak ETag of the resource.
 

 Skip, or use null if the resource doesn't exist.
 

Specified by:
eTag in interface CacheHeadersRequestContextAddon<R extends RequestContext<?>>
weakComparison - should a weak comparison be used instead of
 a strong one to compare the request ETag to the current ETag?





lastModified
public CacheHeadersRequestContextAddon<R> lastModified(Date lastModificationDate)
Description copied from interface: CacheHeadersRequestContextAddon
Specifies the last modification date of the resource.
 

 Skip, or use null if the resource doesn't exist.
 

Specified by:
lastModified in interface CacheHeadersRequestContextAddon<R extends RequestContext<?>>





isEtagsFromIfMatchHeaderContainsAWildcard
protected boolean isEtagsFromIfMatchHeaderContainsAWildcard()




getEtagsFromIfMatchHeader
public List<ETag> getEtagsFromIfMatchHeader()




getEtagsFromIfNoneMatchHeader
public List<ETag> getEtagsFromIfNoneMatchHeader()




isEtagsFromIfNoneMatchHeaderContainsAWildcard
protected boolean isEtagsFromIfNoneMatchHeaderContainsAWildcard()




isIfMatchEtagMatches
protected boolean isIfMatchEtagMatches()




isIfNoneMatchEtagMatches
protected boolean isIfNoneMatchEtagMatches()




isEtagMatches
protected boolean isEtagMatches(ETag requestETag,
 boolean weakComparison)




getDateFromIfModifiedSinceHeader
protected Date getDateFromIfModifiedSinceHeader()




getDateFromIfUnmodifiedSinceHeader
protected Date getDateFromIfUnmodifiedSinceHeader()




formatDateForHttpHeader
protected String formatDateForHttpHeader(Date date)




cache
public CacheHeadersRequestContextAddon<R> cache(int seconds)
Description copied from interface: CacheHeadersRequestContextAddon
The number of seconds the client should cache this resource
 before requesting it again.

Specified by:
cache in interface CacheHeadersRequestContextAddon<R extends RequestContext<?>>





cache
public CacheHeadersRequestContextAddon<R> cache(int seconds,
 boolean isPrivate)
Description copied from interface: CacheHeadersRequestContextAddon
The number of seconds the client should cache this resource
 before requesting it again.

Specified by:
cache in interface CacheHeadersRequestContextAddon<R extends RequestContext<?>>
isPrivate - should the cache be 'private'?
 (help)





cache
public CacheHeadersRequestContextAddon<R> cache(int seconds,
 boolean isPrivate,
 Integer cdnSeconds)
Description copied from interface: CacheHeadersRequestContextAddon
The number of seconds the client should cache this resource
 before requesting it again.

Specified by:
cache in interface CacheHeadersRequestContextAddon<R extends RequestContext<?>>
isPrivate - should the cache be 'private'?
 (help)
cdnSeconds - The number of seconds the resource associated with
 this route should be cached by a CDN/proxy. If null, it
 won't be used.





noCache
public SpincastCacheHeadersRequestContextAddon<R> noCache()
Description copied from interface: CacheHeadersRequestContextAddon
Sends "No Cache" headers so the resource is not cached
 at all by the client.

Specified by:
noCache in interface CacheHeadersRequestContextAddon<R extends RequestContext<?>>





validate
public boolean validate(boolean resourceCurrentlyExists)
Description copied from interface: CacheHeadersRequestContextAddon
Call this when you are done setting
 ETag and/or Last-Modified to validate
 them agains the headers sent by the client.
 

 If this method returns true, the route handler should return immediately
 without returning/creating/modifying/deleting the associated resource! Appropriate headers 
 have already been set on the response.
 

Specified by:
validate in interface CacheHeadersRequestContextAddon<R extends RequestContext<?>>
Parameters:
resourceCurrentlyExists - Does the resource currently exist?