com.continuent.tungsten.replicator.applier
Class MongoApplier

java.lang.Object
  com.continuent.tungsten.replicator.applier.MongoApplier

All Implemented Interfaces:

RawApplier, ReplicatorPlugin

public class MongoApplier
extends java.lang.Object
implements RawApplier

Implements an applier for MongoDB. This class handles only row updates, as SQL statements are meaningless in MongoDB. We use a local version of the Tungsten trep_commit_seqno table to keep track of updates.

Version:

1.0

Author:

Robert Hodges

Constructor Summary

MongoApplier()

Method Summary

void	apply(DBMSEvent event, ReplDBMSHeader header, boolean doCommit, boolean doRollback) Applies row updates to MongoDB.
void	commit() Commits current open transaction to ensure data applied up to current point are durable.
void	configure(PluginContext context) Complete plug-in configuration.
ReplDBMSHeader	getLastEvent() Return header information corresponding to last committed event.
void	prepare(PluginContext context) Prepare plug-in for use.
void	release(PluginContext context) Release all resources used by plug-in.
void	rollback() Rolls back any current work.
void	setAutoIndex(boolean autoIndex) If set to true, generate indexes automatically on keys whenever we see a table for the first time.
void	setConnectString(java.lang.String connectString) Set the MongoDB connect string, e.g., "myhost:27071".
void	setTaskId(int id) Sets the ID of the task using this raw applier.

Methods inherited from class java.lang.Object

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

Constructor Detail

MongoApplier

public MongoApplier()

Method Detail

setConnectString

public void setConnectString(java.lang.String connectString)

Set the MongoDB connect string, e.g., "myhost:27071".

setAutoIndex

public void setAutoIndex(boolean autoIndex)

If set to true, generate indexes automatically on keys whenever we see a table for the first time.

apply

public void apply(DBMSEvent event,
                  ReplDBMSHeader header,
                  boolean doCommit,
                  boolean doRollback)
           throws ReplicatorException,
                  ConsistencyException,
                  java.lang.InterruptedException

Applies row updates to MongoDB. Statements are discarded. Apply the proffered event to the replication target.

Specified by:

apply in interface RawApplier

Parameters:

event - Event to be applied. If a DBMSEmptyEvent, just mark the apply position.

header - Header data corresponding to event

doCommit - Boolean flag indicating whether this is the last part of multi-part event

doRollback - Boolean flag indicating whether this transaction should rollback

Throws:

ReplicatorException - Thrown if applier processing fails

ConsistencyException - Thrown if the applier detects that a consistency check has failed

java.lang.InterruptedException - Thrown if the applier is interrupted

See Also:

RawApplier.apply(com.continuent.tungsten.replicator.event.DBMSEvent, com.continuent.tungsten.replicator.event.ReplDBMSHeader, boolean, boolean)

commit

public void commit()
            throws ReplicatorException,
                   java.lang.InterruptedException

Commits current open transaction to ensure data applied up to current point are durable.

Specified by:

commit in interface RawApplier

Throws:

ReplicatorException - Thrown if applier processing fails

java.lang.InterruptedException - Thrown if the applier is interrupted

See Also:

RawApplier.commit()

getLastEvent

public ReplDBMSHeader getLastEvent()
                            throws ReplicatorException,
                                   java.lang.InterruptedException

Return header information corresponding to last committed event.

Specified by:

getLastEvent in interface RawApplier

Returns:

Header data for last committed event.

Throws:

ReplicatorException - Thrown if getting sequence number fails

java.lang.InterruptedException - Thrown if the applier is interrupted

See Also:

RawApplier.getLastEvent()

rollback

public void rollback()
              throws java.lang.InterruptedException

Rolls back any current work.

Specified by:

rollback in interface RawApplier

Throws:

java.lang.InterruptedException - Thrown if the applier is interrupted.

See Also:

RawApplier.rollback()

setTaskId

public void setTaskId(int id)

Sets the ID of the task using this raw applier.

Specified by:

setTaskId in interface RawApplier

Parameters:

id - Task ID

See Also:

RawApplier.setTaskId(int)

configure

public void configure(PluginContext context)
               throws ReplicatorException,
                      java.lang.InterruptedException

Complete plug-in configuration. This is called after setters are invoked at the time that the replicator goes through configuration.

Specified by:

configure in interface ReplicatorPlugin

Throws:

ReplicatorException - Thrown if configuration is incomplete or fails

java.lang.InterruptedException

See Also:

ReplicatorPlugin.configure(com.continuent.tungsten.replicator.plugin.PluginContext)

prepare

public void prepare(PluginContext context)
             throws ReplicatorException,
                    java.lang.InterruptedException

Prepare plug-in for use. This method is assumed to allocate all required resources. It is called before the plug-in performs any operations.

Specified by:

prepare in interface ReplicatorPlugin

Throws:

ReplicatorException - Thrown if resource allocation fails

java.lang.InterruptedException

See Also:

ReplicatorPlugin.prepare(com.continuent.tungsten.replicator.plugin.PluginContext)

release

public void release(PluginContext context)
             throws ReplicatorException,
                    java.lang.InterruptedException

Release all resources used by plug-in. This is called before the plug-in is deallocated.

Specified by:

release in interface ReplicatorPlugin

Throws:

ReplicatorException - Thrown if resource deallocation fails

java.lang.InterruptedException

See Also:

ReplicatorPlugin.release(com.continuent.tungsten.replicator.plugin.PluginContext)