com.day.cq.replication

Interface OutboxManager

public interface OutboxManager

Represents an outbox manager.

Method Summary

Modifier and Type	Method and Description
boolean	checkPermission(Session session) Deprecated. since 5.12.4; use getDefaultOutbox(javax.jcr.Session)} instead.
void	fetch(Session session, Calendar time, OutputStream out) Deprecated. since 5.12.4; use getDefaultOutbox(javax.jcr.Session).Outbox.fetch(java.util.Calendar, java.io.OutputStream) instead.
Outbox	getDefaultOutbox(Session session) Returns the default, anonymous outbox.
Outbox	getOutbox(Session session, String name, boolean autoCreate) Returns the outbox with the given name.
void	put(InputStream in) Deprecated. since 5.5 use put(ReplicationAction, java.io.InputStream) instead.
void	put(ReplicationAction action) Deprecated. since 5.12.4; use getDefaultOutbox(javax.jcr.Session).Outbox.put(ReplicationAction) instead.
void	put(ReplicationAction action, InputStream in) Deprecated. since 5.12.4; use getDefaultOutbox(javax.jcr.Session).Outbox.put(ReplicationAction, java.io.InputStream) instead.

Method Detail

getOutbox

@Nullable
Outbox getOutbox(Session session,
                           String name,
                           boolean autoCreate)
                    throws ReplicationException,
                           AccessDeniedException

Returns the outbox with the given name. If no such outbox exists null is returned, unless autoCreate is set to true. Note that the given session needs to be able to read and write nodes on an existing outbox, or needs to be able to create nodes below the default outboxes path "/var/replication/outboxes".

Parameters:

session - the session to access the outbox

name - name of the outbox.

autoCreate - if true the outbox will be created if it does not exist

Returns:

the outbox or null

Throws:

ReplicationException - if an error occurs.

AccessDeniedException - if the given session is not allowed to get or create the outbox.

getDefaultOutbox

@Nonnull
Outbox getDefaultOutbox(Session session)
                          throws ReplicationException

Returns the default, anonymous outbox.

Parameters:

session - the session to access the default outbox

Returns:

the default outbox.

Throws:

ReplicationException - if an error occurs.

put

@Deprecated
void put(ReplicationAction action,
                     InputStream in)
              throws ReplicationException

Deprecated. since 5.12.4; use getDefaultOutbox(javax.jcr.Session).Outbox.put(ReplicationAction, java.io.InputStream) instead.

Put item in the outbox.

Parameters:

action - replication action, must not be ReplicationActionType.ACTIVATE

in - item data

Throws:

ReplicationException - if an error occurs

put

@Deprecated
void put(ReplicationAction action)
              throws ReplicationException

Deprecated. since 5.12.4; use getDefaultOutbox(javax.jcr.Session).Outbox.put(ReplicationAction) instead.

Put an empty item in the outbox with a replication action other than ReplicationActionType.ACTIVATE.

Parameters:

action - replication action, must not be ReplicationActionType.ACTIVATE

Throws:

ReplicationException - if an error occurs

put

@Deprecated
void put(InputStream in)
              throws ReplicationException

Deprecated. since 5.5 use put(ReplicationAction, java.io.InputStream) instead.

Put item in the outbox. The implicit replication action of this item is ReplicationActionType.ACTIVATE

Parameters:

in - item data

Throws:

ReplicationException - if an error occurs

fetch

@Deprecated
void fetch(Session session,
                       Calendar time,
                       OutputStream out)
                throws ReplicationException

Deprecated. since 5.12.4; use getDefaultOutbox(javax.jcr.Session).Outbox.fetch(java.util.Calendar, java.io.OutputStream) instead.

Fetch items from the outbox, having a last modified time greater than the given optional time, automatically removing items that are older.

Parameters:

session - session to use

time - if not null, all items older than this date are automatically purged from the outbox before returning the outbox's content

out - output stream where to store a virtual durbo package named outbox with the items in the outbox as children

Throws:

ReplicationException - if an error occurs

checkPermission

@Deprecated
boolean checkPermission(Session session)

Deprecated. since 5.12.4; use getDefaultOutbox(javax.jcr.Session)} instead.

To check that session's user has permissions to fetch items from outbox. Returns true if session's user has permissions to fetch items from outbox else returns false.

Parameters:

session - session to use

Returns:

true if session's user has permissions to fetch items from outbox else false.