Package org.alfresco.repo.remote

Class RepoRemoteTransportService

java.lang.Object

org.alfresco.repo.remote.RepoRemoteTransportService

All Implemented Interfaces:

Runnable, RepoRemoteTransport

public class RepoRemoteTransportService
extends Object
implements RepoRemoteTransport, Runnable

The server side implementation of RepoRemoteTransport. It handles ticket validation, and expiration of idle streams.

Author:

britt

Constructor Summary

Constructors

Constructor	Description
RepoRemoteTransportService()	Default constructor.

Method Summary

Modifier and Type	Method	Description
void	closeInputHandle(String ticket, String handle)	Close a remote InputStream.
void	closeOutputHandle(String ticket, String handle)	Close a remote OutputStream.
NodeRef	createDirectory(String ticket, NodeRef base, String path)	Create a new directory.
String	createFile(String ticket, NodeRef base, String path)	Create a file relative to a base node.
Map<String,Pair<NodeRef,Boolean>>	getListing(String ticket, NodeRef dir)	Get a listing of a directory.
NodeRef	getRoot(String ticket)	Get the root node of the SpacesStore repo.
void	init()	The init method.
Pair<NodeRef,Boolean>	lookup(String ticket, NodeRef base, String path)	Lookup a node by path relative to a node.
String	readFile(String ticket, NodeRef fileRef)	Read a file directly.
String	readFile(String ticket, NodeRef base, String path)	Read a file from a relative path.
byte[]	readInput(String ticket, String handle, int count)	Read a block of bytes over the wire.
void	removeNode(String ticket, NodeRef toRemove)	Remove a node directly.
void	removeNode(String ticket, NodeRef base, String path)	Remove a node via a relative path.
void	rename(String ticket, NodeRef base, String src, String dst)	Rename a node
void	run()	The body of this Runnable.
void	setAuthenticationService(AuthenticationService service)	Set the AuthenticationService instance.
void	setIdleTimeout(long timeout)	Set the Idle Timeout value.
void	setRepoRemote(RepoRemote remote)	Set the RepoRemote instance.
void	shutDown()	Shutdown the Runnable cleanly.
String	writeFile(String ticket, NodeRef base, String path)	Write to an already existing file.
void	writeOutput(String ticket, String handle, byte[] buff, int count)	Write a portion of a block of bytes over the wire.

Methods inherited from class java.lang.Object

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

Constructor Detail

RepoRemoteTransportService

public RepoRemoteTransportService()

Default constructor.

Method Detail

setIdleTimeout

public void setIdleTimeout(long timeout)

Set the Idle Timeout value.

Parameters:

timeout - The value to set.

setRepoRemote

public void setRepoRemote(RepoRemote remote)

Set the RepoRemote instance.

setAuthenticationService

public void setAuthenticationService(AuthenticationService service)

Set the AuthenticationService instance.

init

public void init()

The init method. This fires up a thread to check for closable streams.

run

public void run()

The body of this Runnable.

Specified by:

run in interface Runnable

shutDown

public void shutDown()

Shutdown the Runnable cleanly.

closeInputHandle

public void closeInputHandle(String ticket,
                             String handle)

Description copied from interface: RepoRemoteTransport

Close a remote InputStream.

Specified by:

closeInputHandle in interface RepoRemoteTransport

Parameters:

ticket - The authentication ticket.

handle - The handle.

closeOutputHandle

public void closeOutputHandle(String ticket,
                              String handle)

Description copied from interface: RepoRemoteTransport

Close a remote OutputStream.

Specified by:

closeOutputHandle in interface RepoRemoteTransport

Parameters:

ticket - The authentication ticket.

handle - The handle.

createDirectory

public NodeRef createDirectory(String ticket,
                               NodeRef base,
                               String path)

Description copied from interface: RepoRemoteTransport

Create a new directory.

Specified by:

createDirectory in interface RepoRemoteTransport

base - The base node ref.

path - The relative path.

Returns:

The node ref to the newly created directory.

createFile

public String createFile(String ticket,
                         NodeRef base,
                         String path)

Description copied from interface: RepoRemoteTransport

Create a file relative to a base node.

Specified by:

createFile in interface RepoRemoteTransport

base - The base node ref.

path - The relative path.

Returns:

A handle.

getListing

public Map<String,Pair<NodeRef,Boolean>> getListing(String ticket,
                                                                NodeRef dir)

Description copied from interface: RepoRemoteTransport

Get a listing of a directory.

Specified by:

getListing in interface RepoRemoteTransport

dir - The node ref of the directory.

Returns:

A Map of names to node refs.

getRoot

public NodeRef getRoot(String ticket)

Description copied from interface: RepoRemoteTransport

Get the root node of the SpacesStore repo.

Specified by:

getRoot in interface RepoRemoteTransport

Returns:

The root node ref.

lookup

public Pair<NodeRef,Boolean> lookup(String ticket,
                                          NodeRef base,
                                          String path)

Description copied from interface: RepoRemoteTransport

Lookup a node by path relative to a node.

Specified by:

lookup in interface RepoRemoteTransport

base - The base node ref.

path - The relative path.

Returns:

The node ref or null.

readFile

public String readFile(String ticket,
                       NodeRef base,
                       String path)

Description copied from interface: RepoRemoteTransport

Read a file from a relative path.

Specified by:

readFile in interface RepoRemoteTransport

base - The base node ref.

path - The relative path to the file.

Returns:

A handle.

readFile

public String readFile(String ticket,
                       NodeRef fileRef)

Description copied from interface: RepoRemoteTransport

Read a file directly.

Specified by:

readFile in interface RepoRemoteTransport

fileRef - The node ref of the file.

Returns:

A handle.

readInput

public byte[] readInput(String ticket,
                        String handle,
                        int count)

Description copied from interface: RepoRemoteTransport

Read a block of bytes over the wire.

Specified by:

readInput in interface RepoRemoteTransport

Parameters:

ticket - The authentication ticket.

handle - The remote handle.

count - The number of bytes to try to read.

Returns:

A buffer of the bytes read. Length is 0 at EOF.

removeNode

public void removeNode(String ticket,
                       NodeRef base,
                       String path)

Description copied from interface: RepoRemoteTransport

Remove a node via a relative path.

Specified by:

removeNode in interface RepoRemoteTransport

base - The base node ref.

path - The relative path.

removeNode

public void removeNode(String ticket,
                       NodeRef toRemove)

Description copied from interface: RepoRemoteTransport

Remove a node directly.

Specified by:

removeNode in interface RepoRemoteTransport

toRemove - The node ref to remove.

rename

public void rename(String ticket,
                   NodeRef base,
                   String src,
                   String dst)

Description copied from interface: RepoRemoteTransport

Rename a node

Specified by:

rename in interface RepoRemoteTransport

base - The base node ref.

src - The relative source path.

dst - The relative target path.

writeFile

public String writeFile(String ticket,
                        NodeRef base,
                        String path)

Description copied from interface: RepoRemoteTransport

Write to an already existing file.

Specified by:

writeFile in interface RepoRemoteTransport

base - The base node ref.

path - The relative path.

Returns:

A handle.

writeOutput

public void writeOutput(String ticket,
                        String handle,
                        byte[] buff,
                        int count)

Description copied from interface: RepoRemoteTransport

Write a portion of a block of bytes over the wire.

Specified by:

writeOutput in interface RepoRemoteTransport

Parameters:

ticket - The authentication ticket.

handle - The remote handle.

buff - The buffer with data.

count - The number of bytes to write.