org.apache.jackrabbit.rmi.client

Class SafeClientRepository

java.lang.Object

org.apache.jackrabbit.rmi.client.ClientObject

org.apache.jackrabbit.rmi.client.SafeClientRepository

public abstract class SafeClientRepository
extends ClientObject

A "safe" local adapter for the JCR-RMI RemoteRepository interface. This class uses an abstract factory method for loading (and reloading) the remote repository instance that is made locally available through the JCR Repository interface. If the remote reference breaks (a RemoteException is thrown by a remote call), then this adapter attempts to reload the remote reference once before failing.

See Also:

javax.jcr.Repository, RemoteRepository

Constructor Summary

Constructors

Constructor and Description
SafeClientRepository(LocalAdapterFactory factory) Creates a client adapter for the given remote repository.

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.String	getDescriptor(java.lang.String name)
java.lang.String[]	getDescriptorKeys()
Value	getDescriptorValue(java.lang.String key)
Value[]	getDescriptorValues(java.lang.String key)
protected abstract RemoteRepository	getRemoteRepository() Abstract factory class for getting the remote repository.
protected RemoteRepository	getRemoteRepository(boolean initialize) Method to obtain the remote remote repository.
boolean	isSingleValueDescriptor(java.lang.String key)
boolean	isStandardDescriptor(java.lang.String key)
Session	login()
Session	login(Credentials credentials)
Session	login(Credentials credentials, java.lang.String workspace)
Session	login(java.lang.String workspace)

Methods inherited from class org.apache.jackrabbit.rmi.client.ClientObject

getFactory, getItem, getNode, getNodeTypeArray

Methods inherited from class java.lang.Object

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

Constructor Detail

SafeClientRepository

public SafeClientRepository(LocalAdapterFactory factory)

Creates a client adapter for the given remote repository.

Parameters:

factory - local adapter factory

Method Detail

getRemoteRepository

protected abstract RemoteRepository getRemoteRepository()
                                                 throws java.rmi.RemoteException

Abstract factory class for getting the remote repository.

Returns:

remote repository

Throws:

java.rmi.RemoteException - if the remote repository could not be accessed

getRemoteRepository

protected RemoteRepository getRemoteRepository(boolean initialize)
                                        throws java.rmi.RemoteException

Method to obtain the remote remote repository. If initialize is true and a RepositoryException will be thrown no BrokenRemoteRepository will be created.

Returns:

remote repository

Throws:

java.rmi.RemoteException - if the remote repository could not be accessed

getDescriptor

public java.lang.String getDescriptor(java.lang.String name)

getDescriptorKeys

public java.lang.String[] getDescriptorKeys()

login

public Session login(Credentials credentials,
            java.lang.String workspace)
              throws RepositoryException

Throws:

RepositoryException

login

public Session login(java.lang.String workspace)
              throws RepositoryException

Throws:

RepositoryException

login

public Session login(Credentials credentials)
              throws RepositoryException

Throws:

RepositoryException

login

public Session login()
              throws RepositoryException

Throws:

RepositoryException

getDescriptorValue

public Value getDescriptorValue(java.lang.String key)

getDescriptorValues

public Value[] getDescriptorValues(java.lang.String key)

isSingleValueDescriptor

public boolean isSingleValueDescriptor(java.lang.String key)

isStandardDescriptor

public boolean isStandardDescriptor(java.lang.String key)