org.nuxeo.ecm.automation.client.adapters

Class AsyncSession

java.lang.Object

org.nuxeo.ecm.automation.client.adapters.AsyncSession

All Implemented Interfaces:

Session

public class AsyncSession
extends Object
implements Session

Asynchronous session adapter.

Since:

10.3

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	AsyncSession.AsyncRequest Asynchronous pooling based request
class	AsyncSession.CompletableRequest Request providing a completable call method for convenience.

Field Summary

Fields

Modifier and Type	Field and Description
protected static ExecutorService	executor
protected DefaultSession	session

Constructor Summary

Constructors

Constructor and Description
AsyncSession(DefaultSession session)

Method Summary

Modifier and Type	Method and Description
void	close() Remove any resources held by this session.
Object	execute(OperationRequest request)
<T> T	getAdapter(Class<T> type) Get an adapter of the current session.
AutomationClient	getClient() Get the client that created this session.
Connector	getConnector()
String	getDefaultSchemas() Get the default schemas that should be sent by the server.
Blob	getFile(String path) Get a file from the server given a path identifying the file.
Blobs	getFiles(String path) Get a collection of files from the server given the path identifying the collection.
LoginInfo	getLogin() Get the login used to authenticate against the server
OperationDocumentation	getOperation(String id)
Map<String,OperationDocumentation>	getOperations()
Session	getSession()
OperationRequest	newRequest(String id) Create a new operation request given an operation ID.
OperationRequest	newRequest(String id, Map<String,Object> ctx) Create a new operation request given an operation ID and an operation context map.
void	setDefaultSchemas(String defaultSchemas) Set the default schemas that should be sent by the server.

Methods inherited from class java.lang.Object

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

Field Detail

executor

protected static ExecutorService executor

session

protected final DefaultSession session

Constructor Detail

AsyncSession

public AsyncSession(DefaultSession session)

Method Detail

getSession

public Session getSession()

getClient

public AutomationClient getClient()

Description copied from interface: Session

Get the client that created this session.

Specified by:

getClient in interface Session

Returns:

the client. cannot be null.

getLogin

public LoginInfo getLogin()

Description copied from interface: Session

Get the login used to authenticate against the server

Specified by:

getLogin in interface Session

Returns:

the login. cannot be null.

newRequest

public OperationRequest newRequest(String id)

Description copied from interface: Session

Create a new operation request given an operation ID.

Specified by:

newRequest in interface Session

Parameters:

id - the ID of the operation to be executed.

Returns:

the operation request

newRequest

public OperationRequest newRequest(String id,
                                   Map<String,Object> ctx)

Description copied from interface: Session

Create a new operation request given an operation ID and an operation context map.

Specified by:

newRequest in interface Session

Parameters:

id - the operation id

ctx - the context map to be used when executing the operation on the server.

Returns:

the operation request

execute

public Object execute(OperationRequest request)
               throws IOException

Specified by:

execute in interface Session

Throws:

IOException

getFile

public Blob getFile(String path)
             throws IOException

Description copied from interface: Session

Get a file from the server given a path identifying the file.

Specified by:

getFile in interface Session

Parameters:

path - the file path

Returns:

a blob representation of the file

Throws:

IOException

getFiles

public Blobs getFiles(String path)
               throws IOException

Description copied from interface: Session

Get a collection of files from the server given the path identifying the collection.

Specified by:

getFiles in interface Session

Parameters:

path - the file path

Returns:

a collection of files represented as blobs.

Throws:

IOException

getOperation

public OperationDocumentation getOperation(String id)

Specified by:

getOperation in interface Session

getOperations

public Map<String,OperationDocumentation> getOperations()

Specified by:

getOperations in interface Session

getAdapter

public <T> T getAdapter(Class<T> type)

Description copied from interface: Session

Get an adapter of the current session. Adapters can be used to define custom API over a Nuxeo Automation Session.

Optional operation. Environments that cannot support this method (like GWT) must throw UnsupportedOperationException

Specified by:

getAdapter in interface Session

See Also:

AutomationClient#getAdapter(Object, Class)

getDefaultSchemas

public String getDefaultSchemas()

Description copied from interface: Session

Get the default schemas that should be sent by the server.

This is a comma separated String (ex: dublincore,file)

default value is null (let the server decide what to send)

when Automation server convert the Documents to JSON, it will use this list to select what properties should be sent. You can explicitly set the X-NXDocumentProperties header at request level. If defaultSchemas, the request that don't already have the header set will inherit the default value.

Specified by:

getDefaultSchemas in interface Session

setDefaultSchemas

public void setDefaultSchemas(String defaultSchemas)

Description copied from interface: Session

Set the default schemas that should be sent by the server.

This is a comma separated String (ex: dublincore,file)

when Automation server convert the Documents to JSON, it will use this list to select what properties should be sent. You can explicitly set the X-NXDocumentProperties header at request level. If defaultSchemas, the request that don't already have the header set will inherit the default value.

Specified by:

setDefaultSchemas in interface Session

Parameters:

defaultSchemas - list of schemas as a comma separated string

close

public void close()

Description copied from interface: Session

Remove any resources held by this session. The session will no more be used again.

Specified by:

close in interface Session

getConnector

public Connector getConnector()