net.shibboleth.ext.spring.resource

Class FileBackedHTTPResource

java.lang.Object

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

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

net.shibboleth.ext.spring.resource.HTTPResource

net.shibboleth.ext.spring.resource.FileBackedHTTPResource

All Implemented Interfaces:

net.shibboleth.utilities.java.support.component.Component, net.shibboleth.utilities.java.support.component.DestructableComponent, net.shibboleth.utilities.java.support.component.IdentifiedComponent, net.shibboleth.utilities.java.support.component.InitializableComponent, net.shibboleth.utilities.java.support.resource.Resource, Aware, BeanNameAware, InitializingBean, InputStreamSource

public class FileBackedHTTPResource
extends HTTPResource

A resource representing a file read from an HTTP(S) location. Every time the file is successfully read from the URL location it is written to a backing file. If the file can not be read from the URL it is read from this backing file, if available.

Field Summary

Fields

Modifier and Type	Field and Description
private Resource	backingResource Backing resource file.
private Logger	log Logger.

Constructor Summary

Constructors

Constructor and Description
FileBackedHTTPResource(HttpClient client, String url, Resource resource) Deprecated. use FileBackedHTTPResource(String, HttpClient, String)
FileBackedHTTPResource(HttpClient client, URL url, Resource resource) Deprecated. use FileBackedHTTPResource(String, HttpClient, URL)
FileBackedHTTPResource(String backingFile, HttpClient client, String url) Constructor.
FileBackedHTTPResource(String backingFile, HttpClient client, URL url) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
long	contentLength()
HTTPResource	createRelative(String relativePath) Based on UrlResource.
boolean	exists()
String	getDescription()
InputStream	getInputStream()
long	lastModified()
protected InputStream	saveAndClone(InputStream input) saveAndClone.

Methods inherited from class net.shibboleth.ext.spring.resource.HTTPResource

afterPropertiesSet, buildHttpClientContext, closeResponse, createRelativeResource, getFile, getFilename, getResourceHeaders, getResponseHeader, getURI, getURL, isOpen, isReadable, reportCachingStatus, setBeanName

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

doInitialize, getId, setId

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

destroy, doDestroy, initialize, isDestroyed, isInitialized

Methods inherited from class java.lang.Object

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

Field Detail

log

private final Logger log

Logger.

backingResource

private final Resource backingResource

Backing resource file.

Constructor Detail

FileBackedHTTPResource

@Deprecated
public FileBackedHTTPResource(@Nonnull@ParameterName(name="client")
                                 HttpClient client,
                                 @NotEmpty@Nonnull@ParameterName(name="url")
                                 String url,
                                 @Nonnull@ParameterName(name="resource")
                                 Resource resource)
                       throws IOException

Deprecated. use FileBackedHTTPResource(String, HttpClient, String)

Constructor.

Parameters:

client - the client we use to connect with.

url - URL to the remote data

resource - the file to use as backing store

Throws:

IOException - if the URL was badly formed

FileBackedHTTPResource

@Deprecated
public FileBackedHTTPResource(@Nonnull@ParameterName(name="client")
                                 HttpClient client,
                                 @Nonnull@NotEmpty@ParameterName(name="url")
                                 URL url,
                                 @Nonnull@ParameterName(name="resource")
                                 Resource resource)
                       throws IOException

Deprecated. use FileBackedHTTPResource(String, HttpClient, URL)

Constructor.

Parameters:

client - the client we use to connect with.

url - URL to the remote data

resource - the file to use as backing store

Throws:

IOException - if the URL was badly formed

FileBackedHTTPResource

public FileBackedHTTPResource(@Nonnull@ParameterName(name="backingFile")
                      String backingFile,
                      @Nonnull@ParameterName(name="client")
                      HttpClient client,
                      @NotEmpty@Nonnull@ParameterName(name="url")
                      String url)
                       throws IOException

Constructor.

Parameters:

backingFile - the file to use as backing store

client - the client we use to connect with.

url - URL to the remote data

Throws:

IOException - if the URL was badly formed

FileBackedHTTPResource

public FileBackedHTTPResource(@Nonnull@ParameterName(name="backingFile")
                      String backingFile,
                      @Nonnull@ParameterName(name="client")
                      HttpClient client,
                      @Nonnull@ParameterName(name="url")
                      URL url)
                       throws IOException

Constructor.

Parameters:

backingFile - the file to use as backing store

client - the client we use to connect with.

url - URL to the remote data

Throws:

IOException - if the URL was badly formed

Method Detail

saveAndClone

protected InputStream saveAndClone(InputStream input)
                            throws IOException

saveAndClone. Read the contents into memory and then write out to the backing file. Finally

Parameters:

input - the input stream

Returns:

the cloned stream.

Throws:

IOException - if an error happens. If the backing file might have been corrupted we delete it.

getInputStream

public InputStream getInputStream()
                           throws IOException

Specified by:

getInputStream in interface net.shibboleth.utilities.java.support.resource.Resource

Specified by:

getInputStream in interface InputStreamSource

Overrides:

getInputStream in class HTTPResource

Throws:

IOException

exists

public boolean exists()

Specified by:

exists in interface net.shibboleth.utilities.java.support.resource.Resource

Overrides:

exists in class HTTPResource

contentLength

public long contentLength()
                   throws IOException

Specified by:

contentLength in interface net.shibboleth.utilities.java.support.resource.Resource

Overrides:

contentLength in class HTTPResource

Throws:

IOException

lastModified

public long lastModified()
                  throws IOException

Specified by:

lastModified in interface net.shibboleth.utilities.java.support.resource.Resource

Overrides:

lastModified in class HTTPResource

Throws:

IOException

createRelative

public HTTPResource createRelative(String relativePath)
                            throws IOException

Based on UrlResource.

Overrides:

createRelative in class HTTPResource

Throws:

IOException

getDescription

public String getDescription()

Specified by:

getDescription in interface net.shibboleth.utilities.java.support.resource.Resource

Overrides:

getDescription in class HTTPResource