net.shibboleth.ext.spring.resource

Class SVNResource

java.lang.Object

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

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

net.shibboleth.ext.spring.resource.SVNResource

All Implemented Interfaces:

Component, DestructableComponent, IdentifiedComponent, InitializableComponent, Resource, org.springframework.beans.factory.Aware, org.springframework.beans.factory.BeanNameAware, org.springframework.beans.factory.InitializingBean, org.springframework.core.io.InputStreamSource

Deprecated.

@Deprecated
public class SVNResource
extends AbstractIdentifiedInitializableComponent
implements org.springframework.core.io.Resource, org.springframework.beans.factory.BeanNameAware, org.springframework.beans.factory.InitializingBean, Resource

Implementation of a Spring Resource that communications with a Subversion server (via a spool directory). This resource will fetch the given resource as follows:

• If the revision is a positive number the resource will fetch the resource once during construction time and will never attempt to fetch it again.
• If the revision number is zero or less, signaling the HEAD revision, every call this resource will cause the resource to check to see if the current working copy is the same as the revision in the remote repository. If it is not the new revision will be retrieved.

The behavior of multiple SVNResource operating on the same local copy are undefined.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private class	SVNResource.SVNStatusHandler Deprecated. Simple ISVNStatusHandler implementation that just stores and returns the status.

Field Summary

Fields

Modifier and Type	Field and Description
private org.tmatesoft.svn.core.wc.SVNClientManager	clientManager Deprecated. SVN Client manager.
private org.joda.time.DateTime	lastModified Deprecated. Time the resource file was last modified.
private org.slf4j.Logger	log Deprecated. Class logger.
private org.tmatesoft.svn.core.SVNURL	remoteRepository Deprecated. URL to the remote repository.
private String	resourceFileName Deprecated. File, within the working copy, represented by this resource.
private org.tmatesoft.svn.core.wc.SVNRevision	retrievalRevision Deprecated. Revision of the working copy.
private File	workingCopyDirectory Deprecated. Directory where the working copy will be kept.

Constructor Summary

Constructors

Constructor and Description
SVNResource(org.tmatesoft.svn.core.wc.SVNClientManager svnClientMgr, org.tmatesoft.svn.core.SVNURL repositoryUrl, File workingCopy, long workingRevision, String resourceFile) Deprecated. Constructor.

Method Summary

Modifier and Type	Method and Description
void	afterPropertiesSet() Deprecated.
protected void	checkoutOrUpdateResource() Deprecated. Checks out the resource specified by the remoteRepository in to the working copy workingCopyDirectory.
private org.tmatesoft.svn.core.wc.SVNRevision	checkoutResourceDirectory() Deprecated. Fetches the content from the SVN repository and creates the local working copy.
protected void	checkWorkingCopyDirectory(File directory) Deprecated. Checks that the given file exists, or can be created, is a directory, and is read/writable by this process.
long	contentLength() Deprecated.
org.springframework.core.io.Resource	createRelative(String relativePath) Deprecated.
Resource	createRelativeResource(String relativePath) Deprecated.
boolean	exists() Deprecated.
String	getDescription() Deprecated.
File	getFile() Deprecated.
String	getFilename() Deprecated.
protected String	getFullPath() Deprecated. Helper function to generate the full path for injecting into URLs and URIs.
InputStream	getInputStream() Deprecated.
private org.joda.time.DateTime	getLastModificationForRevision(org.tmatesoft.svn.core.wc.SVNRevision revision) Deprecated. Gets the last modified time for the given revision.
protected String	getProtocol() Deprecated. Helper function to return a complex scheme - a conjunction of 'svn' and the underlying protocol.
URI	getURI() Deprecated.
URL	getURL() Deprecated.
boolean	isOpen() Deprecated. Our stream can be read multiple times.
boolean	isReadable() Deprecated. We always say yes.
long	lastModified() Deprecated.
void	setBeanName(String name) Deprecated.
void	setFilename(String fileName) Deprecated. Set the resourceFileName.
private org.tmatesoft.svn.core.wc.SVNRevision	updateResourceDirectory() Deprecated. Updates an existing local working copy from the repository.
private boolean	workingCopyDirectoryExists() Deprecated. Checks to see if the working copy directory exists.

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 org.slf4j.Logger log

Deprecated.

Class logger.

clientManager

@Nonnull
private final org.tmatesoft.svn.core.wc.SVNClientManager clientManager

Deprecated.

SVN Client manager.

remoteRepository

@Nonnull
private org.tmatesoft.svn.core.SVNURL remoteRepository

Deprecated.

URL to the remote repository.

workingCopyDirectory

@Nonnull
private File workingCopyDirectory

Deprecated.

Directory where the working copy will be kept.

retrievalRevision

private org.tmatesoft.svn.core.wc.SVNRevision retrievalRevision

Deprecated.

Revision of the working copy.

resourceFileName

private String resourceFileName

Deprecated.

File, within the working copy, represented by this resource.

lastModified

private org.joda.time.DateTime lastModified

Deprecated.

Time the resource file was last modified.

Constructor Detail

SVNResource

public SVNResource(@Nonnull @ParameterName(name="svnClientMgr")
                   org.tmatesoft.svn.core.wc.SVNClientManager svnClientMgr,
                   @Nonnull @ParameterName(name="repositoryUrl")
                   org.tmatesoft.svn.core.SVNURL repositoryUrl,
                   @Nonnull @ParameterName(name="workingCopy")
                   File workingCopy,
                   @ParameterName(name="workingRevision")
                   long workingRevision,
                   @Nonnull @ParameterName(name="resourceFile")
                   String resourceFile)

Deprecated.

Constructor.

Parameters:

svnClientMgr - manager used to create SVN clients

repositoryUrl - URL of the remote repository

workingCopy - directory that will serve as the root of the local working copy

workingRevision - revision of the resource to retrieve or -1 for HEAD revision

resourceFile - file, within the working copy, represented by this resource

Throws:

org.springframework.beans.factory.BeanCreationException - thrown if there is a problem initializing the SVN resource

Method Detail

getFilename

public String getFilename()

Deprecated.

Specified by:

getFilename in interface Resource

setFilename

public void setFilename(@Nonnull
                        String fileName)

Deprecated.

Set the resourceFileName.

Parameters:

fileName - the name

getFullPath

protected String getFullPath()

Deprecated.

Helper function to generate the full path for injecting into URLs and URIs.

Returns:

the directory path (from svn) pus the file.

getProtocol

protected String getProtocol()

Deprecated.

Helper function to return a complex scheme - a conjunction of 'svn' and the underlying protocol.

Returns:

'svn+'protocol

checkWorkingCopyDirectory

protected void checkWorkingCopyDirectory(@Nonnull
                                         File directory)
                                  throws IOException

Deprecated.

Checks that the given file exists, or can be created, is a directory, and is read/writable by this process.

Parameters:

directory - the directory to check

Throws:

IOException - thrown if the file is invalid

checkoutOrUpdateResource

protected void checkoutOrUpdateResource()
                                 throws IOException

Deprecated.

Checks out the resource specified by the remoteRepository in to the working copy workingCopyDirectory. If the working copy is empty than an SVN checkout is performed if the working copy already exists then an SVN update is performed.

Throws:

IOException - thrown if there is a problem communicating with the remote repository, the revision does not exist, or the working copy is unusable

workingCopyDirectoryExists

private boolean workingCopyDirectoryExists()

Deprecated.

Checks to see if the working copy directory exists.

Returns:

true if the working copy directory exists, false otherwise

checkoutResourceDirectory

private org.tmatesoft.svn.core.wc.SVNRevision checkoutResourceDirectory()
                                                                 throws IOException

Deprecated.

Fetches the content from the SVN repository and creates the local working copy.

Returns:

the revision of the fetched content

Throws:

IOException - thrown if there is a problem checking out the content from the repository

getLastModificationForRevision

private org.joda.time.DateTime getLastModificationForRevision(org.tmatesoft.svn.core.wc.SVNRevision revision)
                                                       throws IOException

Deprecated.

Gets the last modified time for the given revision.

Parameters:

revision - revision to get the last modified date for

Returns:

the last modified time

Throws:

IOException - thrown if there is a problem getting the last modified time

updateResourceDirectory

private org.tmatesoft.svn.core.wc.SVNRevision updateResourceDirectory()
                                                               throws IOException

Deprecated.

Updates an existing local working copy from the repository.

Returns:

the revision of the fetched content

Throws:

IOException - thrown if there is a problem updating the working copy

getInputStream

public InputStream getInputStream()
                           throws IOException

Deprecated.

Specified by:

getInputStream in interface Resource

Specified by:

getInputStream in interface org.springframework.core.io.InputStreamSource

Throws:

IOException

exists

public boolean exists()

Deprecated.

Specified by:

exists in interface Resource

isReadable

public boolean isReadable()

Deprecated.

We always say yes.

Specified by:

isReadable in interface Resource

isOpen

public boolean isOpen()

Deprecated.

Our stream can be read multiple times.

Specified by:

isOpen in interface Resource

getURL

public URL getURL()
           throws IOException

Deprecated.

Specified by:

getURL in interface Resource

Throws:

IOException

getURI

public URI getURI()
           throws IOException

Deprecated.

Specified by:

getURI in interface Resource

Throws:

IOException

getFile

public File getFile()
             throws IOException

Deprecated.

Specified by:

getFile in interface Resource

Throws:

IOException

contentLength

public long contentLength()
                   throws IOException

Deprecated.

Specified by:

contentLength in interface Resource

Throws:

IOException

lastModified

public long lastModified()
                  throws IOException

Deprecated.

Specified by:

lastModified in interface Resource

Throws:

IOException

createRelative

public org.springframework.core.io.Resource createRelative(String relativePath)
                                                    throws IOException

Deprecated.

Throws:

IOException

createRelativeResource

public Resource createRelativeResource(String relativePath)
                                throws IOException

Deprecated.

Specified by:

createRelativeResource in interface Resource

Throws:

IOException

getDescription

public String getDescription()

Deprecated.

Specified by:

getDescription in interface Resource

afterPropertiesSet

public void afterPropertiesSet()
                        throws Exception

Deprecated.

Specified by:

afterPropertiesSet in interface org.springframework.beans.factory.InitializingBean

Throws:

Exception

setBeanName

public void setBeanName(String name)

Deprecated.

Specified by:

setBeanName in interface org.springframework.beans.factory.BeanNameAware