weka.gui.beans

Class SubstringReplacer

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

weka.gui.beans.SubstringReplacer

All Implemented Interfaces:

java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, java.util.EventListener, javax.accessibility.Accessible, EnvironmentHandler, BeanCommon, DataSource, EventConstraints, InstanceListener, Visible

@KFStep(category="Tools",
        toolTipText="Replace substrings in String attributes")
public class SubstringReplacer
extends javax.swing.JPanel
implements BeanCommon, Visible, java.io.Serializable, InstanceListener, EventConstraints, EnvironmentHandler, DataSource

A bean that can replace substrings in the values of string attributes. Multiple match and replace "rules" can be specified - these get applied in the order that they are defined. Each rule can be applied to one or more user-specified input String attributes. Attributes can be specified using either a range list (e.g 1,2-10,last) or by a comma separated list of attribute names (where "/first" and "/last" are special strings indicating the first and last attribute respectively). Matching can be by string literal or by regular expression.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JPanel

javax.swing.JPanel.AccessibleJPanel

Nested classes/interfaces inherited from class javax.swing.JComponent

javax.swing.JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container

java.awt.Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

java.awt.Component.AccessibleAWTComponent, java.awt.Component.BaselineResizeBehavior, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	m_busy Busy indicator
protected Environment	m_env Environment variables
protected InstanceEvent	m_ie Instance event to use
protected java.util.ArrayList<InstanceListener>	m_instanceListeners Downstream steps listening to instance events
protected java.lang.Object	m_listenee Component sending us instances
protected Logger	m_log Logging
protected java.lang.String	m_matchReplaceDetails Internally encoded list of match-replace rules
protected SubstringReplacerRules	m_mr Temporary list of match-replace rules
protected StreamThroughput	m_throughput
protected BeanVisual	m_visual Default visual filters

Fields inherited from class javax.swing.JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors

Constructor and Description
SubstringReplacer() Constructs a new SubstringReplacer

Method Summary

Modifier and Type	Method and Description
void	acceptInstance(InstanceEvent e) Accept and process an instance event
void	addDataSourceListener(DataSourceListener dsl) Add a data source listener
void	addInstanceListener(InstanceListener tsl) Add an instance listener
boolean	connectionAllowed(java.beans.EventSetDescriptor esd) Returns true if, at this time, the object will accept a connection via the named event
boolean	connectionAllowed(java.lang.String eventName) Returns true if, at this time, the object will accept a connection via the named event
void	connectionNotification(java.lang.String eventName, java.lang.Object source) Notify this object that it has been registered as a listener with a source for recieving events described by the named event This object is responsible for recording this fact.
void	disconnectionNotification(java.lang.String eventName, java.lang.Object source) Notify this object that it has been deregistered as a listener with a source for named event.
boolean	eventGeneratable(java.lang.String eventName) Returns true if, at the current time, the named event could be generated.
java.lang.String	getCustomName() Get the custom (descriptive) name for this bean (if one has been set)
java.lang.String	getMatchReplaceDetails() Get the internally encoded list of match-replace rules
BeanVisual	getVisual() Get the visual representation
java.lang.String	globalInfo() About information
boolean	isBusy() Returns true if. at this time, the bean is busy with some (i.e. perhaps a worker thread is performing some calculation).
void	removeDataSourceListener(DataSourceListener dsl) Remove a data source listener
void	removeInstanceListener(InstanceListener tsl) Remove an instance listener
void	setCustomName(java.lang.String name) Set a custom (descriptive) name for this bean
void	setEnvironment(Environment env) Set environment variables to use
void	setLog(Logger logger) Set a logger
void	setMatchReplaceDetails(java.lang.String details) Set internally encoded list of match-replace rules
void	setVisual(BeanVisual newVisual) Set a new visual representation
protected java.lang.String	statusMessagePrefix()
void	stop() Stop any processing that the bean might be doing.
void	useDefaultVisual() Use the default visual representation

Methods inherited from class javax.swing.JPanel

getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Field Detail

m_env

protected transient Environment m_env

Environment variables

m_matchReplaceDetails

protected java.lang.String m_matchReplaceDetails

Internally encoded list of match-replace rules

m_mr

protected transient SubstringReplacerRules m_mr

Temporary list of match-replace rules

m_log

protected transient Logger m_log

Logging

m_busy

protected transient boolean m_busy

Busy indicator

m_listenee

protected java.lang.Object m_listenee

Component sending us instances

m_instanceListeners

protected java.util.ArrayList<InstanceListener> m_instanceListeners

Downstream steps listening to instance events

m_ie

protected InstanceEvent m_ie

Instance event to use

m_visual

protected BeanVisual m_visual

Default visual filters

m_throughput

protected transient StreamThroughput m_throughput

Constructor Detail

SubstringReplacer

public SubstringReplacer()

Constructs a new SubstringReplacer

Method Detail

globalInfo

public java.lang.String globalInfo()

About information

Returns:

about information

setMatchReplaceDetails

public void setMatchReplaceDetails(java.lang.String details)

Set internally encoded list of match-replace rules

Parameters:

details - the list of match-replace rules

getMatchReplaceDetails

public java.lang.String getMatchReplaceDetails()

Get the internally encoded list of match-replace rules

Returns:

the match-replace rules

eventGeneratable

public boolean eventGeneratable(java.lang.String eventName)

Returns true if, at the current time, the named event could be generated.

Specified by:

eventGeneratable in interface EventConstraints

Parameters:

eventName - the name of the event in question

Returns:

true if the named event could be generated

acceptInstance

public void acceptInstance(InstanceEvent e)

Accept and process an instance event

Specified by:

acceptInstance in interface InstanceListener

Parameters:

e - an InstanceEvent value

useDefaultVisual

public void useDefaultVisual()

Use the default visual representation

Specified by:

useDefaultVisual in interface Visible

setVisual

public void setVisual(BeanVisual newVisual)

Set a new visual representation

Specified by:

setVisual in interface Visible

Parameters:

newVisual - a BeanVisual value

getVisual

public BeanVisual getVisual()

Get the visual representation

Specified by:

getVisual in interface Visible

Returns:

a BeanVisual value

setCustomName

public void setCustomName(java.lang.String name)

Set a custom (descriptive) name for this bean

Specified by:

setCustomName in interface BeanCommon

Parameters:

name - the name to use

getCustomName

public java.lang.String getCustomName()

Get the custom (descriptive) name for this bean (if one has been set)

Specified by:

getCustomName in interface BeanCommon

Returns:

the custom name (or the default name)

stop

public void stop()

Stop any processing that the bean might be doing.

Specified by:

stop in interface BeanCommon

isBusy

public boolean isBusy()

Returns true if. at this time, the bean is busy with some (i.e. perhaps a worker thread is performing some calculation).

Specified by:

isBusy in interface BeanCommon

Returns:

true if the bean is busy.

setLog

public void setLog(Logger logger)

Set a logger

Specified by:

setLog in interface BeanCommon

Parameters:

logger - a weka.gui.Logger value

connectionAllowed

public boolean connectionAllowed(java.beans.EventSetDescriptor esd)

Returns true if, at this time, the object will accept a connection via the named event

Specified by:

connectionAllowed in interface BeanCommon

Parameters:

esd - the EventSetDescriptor for the event in question

Returns:

true if the object will accept a connection

connectionAllowed

public boolean connectionAllowed(java.lang.String eventName)

Returns true if, at this time, the object will accept a connection via the named event

Specified by:

connectionAllowed in interface BeanCommon

Parameters:

eventName - the name of the event

Returns:

true if the object will accept a connection

connectionNotification

public void connectionNotification(java.lang.String eventName,
                                   java.lang.Object source)

Notify this object that it has been registered as a listener with a source for recieving events described by the named event This object is responsible for recording this fact.

Specified by:

connectionNotification in interface BeanCommon

Parameters:

eventName - the event

source - the source with which this object has been registered as a listener

disconnectionNotification

public void disconnectionNotification(java.lang.String eventName,
                                      java.lang.Object source)

Notify this object that it has been deregistered as a listener with a source for named event. This object is responsible for recording this fact.

Specified by:

disconnectionNotification in interface BeanCommon

Parameters:

eventName - the event

source - the source with which this object has been registered as a listener

setEnvironment

public void setEnvironment(Environment env)

Set environment variables to use

Specified by:

setEnvironment in interface EnvironmentHandler

Parameters:

env - the environment variables to use

statusMessagePrefix

protected java.lang.String statusMessagePrefix()

addInstanceListener

public void addInstanceListener(InstanceListener tsl)

Add an instance listener

Specified by:

addInstanceListener in interface DataSource

Parameters:

tsl - an InstanceListener value

removeInstanceListener

public void removeInstanceListener(InstanceListener tsl)

Remove an instance listener

Specified by:

removeInstanceListener in interface DataSource

Parameters:

tsl - an InstanceListener value

addDataSourceListener

public void addDataSourceListener(DataSourceListener dsl)

Add a data source listener

Specified by:

addDataSourceListener in interface DataSource

Parameters:

dsl - a DataSourceListener value

removeDataSourceListener

public void removeDataSourceListener(DataSourceListener dsl)

Remove a data source listener

Specified by:

removeDataSourceListener in interface DataSource

Parameters:

dsl - a DataSourceListener value