org.apache.jackrabbit.rmi.server
Class ServerAdapterFactory

java.lang.Object
  org.apache.jackrabbit.rmi.server.ServerAdapterFactory

All Implemented Interfaces:

RemoteAdapterFactory

Direct Known Subclasses:

JackrabbitServerAdapterFactory

public class ServerAdapterFactory
extends java.lang.Object
implements RemoteAdapterFactory

Default implementation of the RemoteAdapterFactory interface. This factory uses the server adapters defined in this package as the default adapter implementations. Subclasses can override or extend the default adapters by implementing the corresponding factory methods.

The bufferSize property can be used to configure the size of the buffer used by iterators to speed up iterator traversal over the network.

Constructor Summary

ServerAdapterFactory()

Method Summary

int	getBufferSize() Returns the iterator buffer size.
RemoteEventCollection	getRemoteEvent(long listenerId, javax.jcr.observation.EventIterator events) Creates a ServerEventCollection instances.
RemoteItem	getRemoteItem(javax.jcr.Item item) Creates a ServerItem instance.
RemoteItemDefinition	getRemoteItemDefinition(javax.jcr.nodetype.ItemDefinition def) Creates a ServerItemDefinition instance.
RemoteLock	getRemoteLock(javax.jcr.lock.Lock lock) Creates a ServerLock instance.
RemoteNamespaceRegistry	getRemoteNamespaceRegistry(javax.jcr.NamespaceRegistry registry) Creates a ServerNamespaceRegistry instance.
RemoteNode	getRemoteNode(javax.jcr.Node node) Creates a ServerNode instance.
RemoteNodeDefinition	getRemoteNodeDefinition(javax.jcr.nodetype.NodeDefinition def) Creates a ServerNodeDefinition instance.
RemoteIterator	getRemoteNodeIterator(javax.jcr.NodeIterator iterator) Creates a ServerNodeIterator instance.
RemoteNodeType	getRemoteNodeType(javax.jcr.nodetype.NodeType type) Creates a ServerNodeType instance.
RemoteIterator	getRemoteNodeTypeIterator(javax.jcr.nodetype.NodeTypeIterator iterator) Creates a ServerNodeTypeIterator instance.
RemoteNodeTypeManager	getRemoteNodeTypeManager(javax.jcr.nodetype.NodeTypeManager manager) Creates a ServerNodeTypeManager instance.
RemoteObservationManager	getRemoteObservationManager(javax.jcr.observation.ObservationManager observationManager) Creates a ServerObservationManager instance.
RemoteProperty	getRemoteProperty(javax.jcr.Property property) Creates a ServerProperty instance.
RemotePropertyDefinition	getRemotePropertyDefinition(javax.jcr.nodetype.PropertyDefinition def) Creates a ServerPropertyDefinition instance.
RemoteIterator	getRemotePropertyIterator(javax.jcr.PropertyIterator iterator) Creates a ServerPropertyIterator instance.
RemoteQuery	getRemoteQuery(javax.jcr.query.Query query) Creates a ServerQuery instance.
RemoteQueryManager	getRemoteQueryManager(javax.jcr.query.QueryManager manager) Creates a ServerQueryManager instance.
RemoteQueryResult	getRemoteQueryResult(javax.jcr.query.QueryResult result) Creates a ServerQueryResult instance.
RemoteRepository	getRemoteRepository(javax.jcr.Repository repository) Creates a ServerRepository instance.
RemoteRow	getRemoteRow(javax.jcr.query.Row row) Creates a ServerQueryResult instance.
RemoteIterator	getRemoteRowIterator(javax.jcr.query.RowIterator iterator) Creates a ServerRowIterator instance.
RemoteSession	getRemoteSession(javax.jcr.Session session) Creates a ServerSession instance.
RemoteVersion	getRemoteVersion(javax.jcr.version.Version version) Creates a ServerVersion instance.
RemoteVersionHistory	getRemoteVersionHistory(javax.jcr.version.VersionHistory versionHistory) Creates a ServerVersionHistory instance.
RemoteIterator	getRemoteVersionIterator(javax.jcr.version.VersionIterator iterator) Creates a ServerVersionIterator instance.
RemoteWorkspace	getRemoteWorkspace(javax.jcr.Workspace workspace) Creates a ServerWorkspace instance.
RemoteXAResource	getRemoteXAResource(javax.transaction.xa.XAResource resource) Creates a ServerXAResource instance.
protected RemoteIterator	optimizeIterator(RemoteIterator remote) Optimizes the given remote iterator for transmission across the network.
void	setBufferSize(int bufferSize) Sets the iterator buffer size.

Methods inherited from class java.lang.Object

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

Constructor Detail

ServerAdapterFactory

public ServerAdapterFactory()

Method Detail

getBufferSize

public int getBufferSize()

Returns the iterator buffer size.

Returns:

iterator buffer size

setBufferSize

public void setBufferSize(int bufferSize)

Sets the iterator buffer size.

Parameters:

bufferSize - iterator buffer size

getRemoteRepository

public RemoteRepository getRemoteRepository(javax.jcr.Repository repository)
                                     throws java.rmi.RemoteException

Creates a ServerRepository instance. Returns a remote adapter for the given local repository.

Specified by:

getRemoteRepository in interface RemoteAdapterFactory

Parameters:

repository - local repository

Returns:

remote repository adapter

Throws:

java.rmi.RemoteException - on RMI errors

getRemoteSession

public RemoteSession getRemoteSession(javax.jcr.Session session)
                               throws java.rmi.RemoteException

Creates a ServerSession instance. In case the underlying session is transaction enabled, the remote interface is will be transaction enabled too through the ServerXASession. Returns a remote adapter for the given local session.

Specified by:

getRemoteSession in interface RemoteAdapterFactory

Parameters:

session - local session

Returns:

remote session adapter

Throws:

java.rmi.RemoteException - on RMI errors

getRemoteWorkspace

public RemoteWorkspace getRemoteWorkspace(javax.jcr.Workspace workspace)
                                   throws java.rmi.RemoteException

Creates a ServerWorkspace instance. Returns a remote adapter for the given local workspace.

Specified by:

getRemoteWorkspace in interface RemoteAdapterFactory

Parameters:

workspace - local workspace

Returns:

remote workspace adapter

Throws:

java.rmi.RemoteException - on RMI errors

getRemoteObservationManager

public RemoteObservationManager getRemoteObservationManager(javax.jcr.observation.ObservationManager observationManager)
                                                     throws java.rmi.RemoteException

Creates a ServerObservationManager instance. Returns a remote adapter for the given local observation manager.

Specified by:

getRemoteObservationManager in interface RemoteAdapterFactory

Parameters:

observationManager - local observation manager

Returns:

remote observation manager adapter

Throws:

java.rmi.RemoteException - on RMI errors

getRemoteNamespaceRegistry

public RemoteNamespaceRegistry getRemoteNamespaceRegistry(javax.jcr.NamespaceRegistry registry)
                                                   throws java.rmi.RemoteException

Creates a ServerNamespaceRegistry instance. Returns a remote adapter for the given local namespace registry.

Specified by:

getRemoteNamespaceRegistry in interface RemoteAdapterFactory

Parameters:

registry - local namespace registry

Returns:

remote namespace registry adapter

Throws:

java.rmi.RemoteException - on RMI errors

getRemoteNodeTypeManager

public RemoteNodeTypeManager getRemoteNodeTypeManager(javax.jcr.nodetype.NodeTypeManager manager)
                                               throws java.rmi.RemoteException

Creates a ServerNodeTypeManager instance. Returns a remote adapter for the given local node type manager.

Specified by:

getRemoteNodeTypeManager in interface RemoteAdapterFactory

Parameters:

manager - local node type manager

Returns:

remote node type manager adapter

Throws:

java.rmi.RemoteException - on RMI errors

getRemoteItem

public RemoteItem getRemoteItem(javax.jcr.Item item)
                         throws java.rmi.RemoteException

Creates a ServerItem instance. Returns a remote adapter for the given local item. This method will return an adapter that implements only the Item interface. The caller may want to introspect the local item to determine whether to use either the getRemoteNode or the getRemoteProperty method instead.

Specified by:

getRemoteItem in interface RemoteAdapterFactory

Parameters:

item - local item

Returns:

remote item adapter

Throws:

java.rmi.RemoteException - on RMI errors

getRemoteProperty

public RemoteProperty getRemoteProperty(javax.jcr.Property property)
                                 throws java.rmi.RemoteException

Creates a ServerProperty instance. Returns a remote adapter for the given local property.

Specified by:

getRemoteProperty in interface RemoteAdapterFactory

Parameters:

property - local property

Returns:

remote property adapter

Throws:

java.rmi.RemoteException - on RMI errors

getRemoteNode

public RemoteNode getRemoteNode(javax.jcr.Node node)
                         throws java.rmi.RemoteException

Creates a ServerNode instance. Returns a remote adapter for the given local node.

Specified by:

getRemoteNode in interface RemoteAdapterFactory

Parameters:

node - local node

Returns:

remote node adapter

Throws:

java.rmi.RemoteException - on RMI errors

getRemoteVersion

public RemoteVersion getRemoteVersion(javax.jcr.version.Version version)
                               throws java.rmi.RemoteException

Creates a ServerVersion instance. Returns a remote adapter for the given local version.

Specified by:

getRemoteVersion in interface RemoteAdapterFactory

Parameters:

version - local version

Returns:

remote version adapter

Throws:

java.rmi.RemoteException - on RMI errors

getRemoteVersionHistory

public RemoteVersionHistory getRemoteVersionHistory(javax.jcr.version.VersionHistory versionHistory)
                                             throws java.rmi.RemoteException

Creates a ServerVersionHistory instance. Returns a remote adapter for the given local version history.

Specified by:

getRemoteVersionHistory in interface RemoteAdapterFactory

Parameters:

versionHistory - local version history

Returns:

remote version history adapter

Throws:

java.rmi.RemoteException - on RMI errors

getRemoteNodeType

public RemoteNodeType getRemoteNodeType(javax.jcr.nodetype.NodeType type)
                                 throws java.rmi.RemoteException

Creates a ServerNodeType instance. Returns a remote adapter for the given local node type.

Specified by:

getRemoteNodeType in interface RemoteAdapterFactory

Parameters:

type - local node type

Returns:

remote node type adapter

Throws:

java.rmi.RemoteException - on RMI errors

getRemoteItemDefinition

public RemoteItemDefinition getRemoteItemDefinition(javax.jcr.nodetype.ItemDefinition def)
                                             throws java.rmi.RemoteException

Creates a ServerItemDefinition instance. Returns a remote adapter for the given local item definition. This method will return an adapter that implements only the ItemDefinition interface. The caller may want to introspect the local item definition to determine whether to use either the getRemoteNodeDef or the getRemotePropertyDef method instead.

Specified by:

getRemoteItemDefinition in interface RemoteAdapterFactory

Parameters:

def - local item definition

Returns:

remote item definition adapter

Throws:

java.rmi.RemoteException - on RMI errors

getRemoteNodeDefinition

public RemoteNodeDefinition getRemoteNodeDefinition(javax.jcr.nodetype.NodeDefinition def)
                                             throws java.rmi.RemoteException

Creates a ServerNodeDefinition instance. Returns a remote adapter for the given local node definition.

Specified by:

getRemoteNodeDefinition in interface RemoteAdapterFactory

Parameters:

def - local node definition

Returns:

remote node definition adapter

Throws:

java.rmi.RemoteException - on RMI errors

getRemotePropertyDefinition

public RemotePropertyDefinition getRemotePropertyDefinition(javax.jcr.nodetype.PropertyDefinition def)
                                                     throws java.rmi.RemoteException

Creates a ServerPropertyDefinition instance. Returns a remote adapter for the given local property definition.

Specified by:

getRemotePropertyDefinition in interface RemoteAdapterFactory

Parameters:

def - local property definition

Returns:

remote property definition adapter

Throws:

java.rmi.RemoteException - on RMI errors

getRemoteLock

public RemoteLock getRemoteLock(javax.jcr.lock.Lock lock)
                         throws java.rmi.RemoteException

Creates a ServerLock instance. Returns a remote adapter for the given local lock.

Specified by:

getRemoteLock in interface RemoteAdapterFactory

Parameters:

lock - local lock

Returns:

remote lock adapter

Throws:

java.rmi.RemoteException - on RMI errors

getRemoteQueryManager

public RemoteQueryManager getRemoteQueryManager(javax.jcr.query.QueryManager manager)
                                         throws java.rmi.RemoteException

Creates a ServerQueryManager instance. Returns a remote adapter for the given local query manager.

Specified by:

getRemoteQueryManager in interface RemoteAdapterFactory

Parameters:

manager - local query manager

Returns:

remote query manager adapter

Throws:

java.rmi.RemoteException - on RMI errors

getRemoteQuery

public RemoteQuery getRemoteQuery(javax.jcr.query.Query query)
                           throws java.rmi.RemoteException

Creates a ServerQuery instance. Returns a remote adapter for the given local query.

Specified by:

getRemoteQuery in interface RemoteAdapterFactory

Parameters:

query - local query

Returns:

remote query adapter

Throws:

java.rmi.RemoteException - on RMI errors

getRemoteQueryResult

public RemoteQueryResult getRemoteQueryResult(javax.jcr.query.QueryResult result)
                                       throws java.rmi.RemoteException

Creates a ServerQueryResult instance. Returns a remote adapter for the given local query result.

Specified by:

getRemoteQueryResult in interface RemoteAdapterFactory

Parameters:

result - local query result

Returns:

remote query result adapter

Throws:

java.rmi.RemoteException - on RMI errors

getRemoteRow

public RemoteRow getRemoteRow(javax.jcr.query.Row row)
                       throws java.rmi.RemoteException

Creates a ServerQueryResult instance. Returns a remote adapter for the given local query row.

Specified by:

getRemoteRow in interface RemoteAdapterFactory

Parameters:

row - local query row

Returns:

remote query row adapter

Throws:

java.rmi.RemoteException - on RMI errors

getRemoteEvent

public RemoteEventCollection getRemoteEvent(long listenerId,
                                            javax.jcr.observation.EventIterator events)
                                     throws java.rmi.RemoteException

Creates a ServerEventCollection instances. Returns a remote adapter for the given local events.

Specified by:

getRemoteEvent in interface RemoteAdapterFactory

Parameters:

listenerId - The listener identifier to which the events are to be dispatched.

events - the local events

Returns:

remote event iterator adapter

Throws:

java.rmi.RemoteException - on RMI errors

optimizeIterator

protected RemoteIterator optimizeIterator(RemoteIterator remote)
                                   throws java.rmi.RemoteException

Optimizes the given remote iterator for transmission across the network. This method retrieves the first set of elements from the iterator by calling RemoteIterator.nextObjects() and then asks for the total size of the iterator. If the size is unkown or greater than the length of the retrieved array, then the elements, the size, and the remote iterator reference are wrapped into a BufferIterator instance that gets passed over the network. If the retrieved array of elements contains all the elements in the iterator, then the iterator instance is discarded and just the elements are wrapped into a ArrayIterator instance to be passed to the client.

Subclasses can override this method to provide alternative optimizations.

Parameters:

remote - remote iterator

Returns:

optimized remote iterator

Throws:

java.rmi.RemoteException - on RMI errors

getRemoteNodeIterator

public RemoteIterator getRemoteNodeIterator(javax.jcr.NodeIterator iterator)
                                     throws java.rmi.RemoteException

Creates a ServerNodeIterator instance. Returns a remote adapter for the given local node iterator.

Specified by:

getRemoteNodeIterator in interface RemoteAdapterFactory

Parameters:

iterator - local node iterator

Returns:

remote iterator adapter

Throws:

java.rmi.RemoteException - on RMI errors

getRemotePropertyIterator

public RemoteIterator getRemotePropertyIterator(javax.jcr.PropertyIterator iterator)
                                         throws java.rmi.RemoteException

Creates a ServerPropertyIterator instance. Returns a remote adapter for the given local property iterator.

Specified by:

getRemotePropertyIterator in interface RemoteAdapterFactory

Parameters:

iterator - local property iterator

Returns:

remote iterator adapter

Throws:

java.rmi.RemoteException - on RMI errors

getRemoteVersionIterator

public RemoteIterator getRemoteVersionIterator(javax.jcr.version.VersionIterator iterator)
                                        throws java.rmi.RemoteException

Creates a ServerVersionIterator instance. Returns a remote adapter for the given local version iterator.

Specified by:

getRemoteVersionIterator in interface RemoteAdapterFactory

Parameters:

iterator - local version iterator

Returns:

remote iterator adapter

Throws:

java.rmi.RemoteException - on RMI errors

getRemoteNodeTypeIterator

public RemoteIterator getRemoteNodeTypeIterator(javax.jcr.nodetype.NodeTypeIterator iterator)
                                         throws java.rmi.RemoteException

Creates a ServerNodeTypeIterator instance. Returns a remote adapter for the given local node type iterator.

Specified by:

getRemoteNodeTypeIterator in interface RemoteAdapterFactory

Parameters:

iterator - local node type iterator

Returns:

remote iterator adapter

Throws:

java.rmi.RemoteException - on RMI errors

getRemoteRowIterator

public RemoteIterator getRemoteRowIterator(javax.jcr.query.RowIterator iterator)
                                    throws java.rmi.RemoteException

Creates a ServerRowIterator instance. Returns a remote adapter for the given local row iterator.

Specified by:

getRemoteRowIterator in interface RemoteAdapterFactory

Parameters:

iterator - local row iterator

Returns:

remote iterator adapter

Throws:

java.rmi.RemoteException - on RMI errors

getRemoteXAResource

public RemoteXAResource getRemoteXAResource(javax.transaction.xa.XAResource resource)
                                     throws java.rmi.RemoteException

Creates a ServerXAResource instance.

Specified by:

getRemoteXAResource in interface RemoteAdapterFactory

Returns:

remote XA resource adapter

Throws:

java.rmi.RemoteException - on RMI errors