com.continuent.tungsten.replicator.filter
Class RenameFilter

java.lang.Object
  com.continuent.tungsten.replicator.filter.RenameFilter

All Implemented Interfaces:

Filter, ReplicatorPlugin

public class RenameFilter
extends java.lang.Object
implements Filter

Filter which renames schemas, tables and columns based on a file provided. IMPORTANT: supports row change events only!

Version:

1.0

Author:

Linas Virbalas

Constructor Summary

RenameFilter()

Method Summary

void	configure(PluginContext context) Complete plug-in configuration.
ReplDBMSEvent	filter(ReplDBMSEvent event) Filter the event.
void	prepare(PluginContext context) Prepare plug-in for use.
void	release(PluginContext context) Release all resources used by plug-in.
void	setDefinitionsFile(java.lang.String definitionsFile) Sets the path to rename definition file.
void	setTungstenSchema(java.lang.String tungstenSchema) Sets the Tungsten schema, which we ignore to prevent problems with the replicator.

Methods inherited from class java.lang.Object

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

Constructor Detail

RenameFilter

public RenameFilter()

Method Detail

setDefinitionsFile

public void setDefinitionsFile(java.lang.String definitionsFile)

Sets the path to rename definition file.

Parameters:

definitionsFile - Path to file.

filter

public ReplDBMSEvent filter(ReplDBMSEvent event)
                     throws ReplicatorException

Filter the event. Filters may transform the event or return null if the event should be discarded. Filters must be prepared to be interrupted, which mechanism is used to cancel processing.

Specified by:

filter in interface Filter

Parameters:

event - An event to be filtered

Returns:

Filtered ReplDBMSEvent or null

Throws:

ReplicatorException - Thrown if there is a processing error

See Also:

Filter.filter(com.continuent.tungsten.replicator.event.ReplDBMSEvent)

setTungstenSchema

public void setTungstenSchema(java.lang.String tungstenSchema)

Sets the Tungsten schema, which we ignore to prevent problems with the replicator. This is mostly used for filter testing, which runs without a pipeline.

configure

public void configure(PluginContext context)
               throws ReplicatorException

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

See Also:

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

prepare

public void prepare(PluginContext context)
             throws ReplicatorException

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

See Also:

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

release

public void release(PluginContext context)
             throws ReplicatorException

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

See Also:

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