org.scripthelper.swing

Class DefaultSwingScriptLoggerArea

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

org.scripthelper.swing.DefaultSwingScriptLoggerArea

All Implemented Interfaces:

java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, javax.accessibility.Accessible, ScriptLogger, SwingScriptLogger

public class DefaultSwingScriptLoggerArea
extends javax.swing.JPanel
implements SwingScriptLogger

Presents a scrollable logging text area for Script messages.

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 StylableSizableArea	area The area.
protected javax.swing.JProgressBar	progressBar The progress bar. it is null by default.

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 org.scripthelper.swing.SwingScriptLogger

CLEAR_KEY, OK_KEY, PRINT_KEY, SEARCH_KEY

Fields inherited from interface java.awt.image.ImageObserver

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

Constructor Summary

Constructors

Constructor and Description
DefaultSwingScriptLoggerArea() Constructor.
DefaultSwingScriptLoggerArea(boolean hasProgressBar, boolean hasTools) Constructor.
DefaultSwingScriptLoggerArea(boolean hasProgressBar, boolean hasTools, int rows, int cols) Constructor.

Method Summary

Modifier and Type	Method and Description
void	acceptNullObjectLinks(boolean accept) Specifies if the logger must accept objects which generate null links from LinkIndexConverter.getLinkFromObject(java.lang.Object).
void	append(java.lang.String text) Append a line of text in the message area, with a default color.
void	append(java.lang.String txt, java.lang.String htmlColor) Append a line of text in the message area, with a specific color.
void	appendError(java.lang.String txt) Append a line of text in the message area, colored in red (for errors).
void	appendLink(java.lang.String txt, java.lang.String linkID) Append a hyperlinked line of text in the message area, with a default color.
void	appendLink(java.lang.String txt, java.lang.String linkID, java.lang.String htmlColor) Append a hyperlinked line of text in the message area, with a specific color.
void	appendLinks(java.lang.String txt, java.util.List<java.lang.String> linkIDs, java.lang.String htmlColor) Append a hyperlinked line of text in the message area, with a specified color.
void	appendObjectLink(HyperlinkElement element) Append a hyperlinked line of text in the message area, with a default color.
void	appendObjectLink(HyperlinkElement element, java.lang.String htmlColor) Append a hyperlinked line of text in the message area, with a specific color.
void	appendObjectLinks(java.lang.String txt, java.util.List<HyperlinkElement> links, java.lang.String htmlColor) Append a hyperlinked line of text in the message area, with a specified color.
void	appendObjectLinks(java.lang.String txt, java.lang.String htmlColor, HyperlinkElement... links) Append a hyperlinked line of text in the message area, with a specified color.
void	clear() Clear the content of the logger
void	clearTab() Clear the current value of the tab for the text.
protected void	doPrint() Print the content of the panel as html.
protected void	doPrintImpl(java.io.File file) Perform the html printing.
ScriptLoggerHyperLinkListener	getHyperLinkListener() Return the listener which will be fired when an hyperlink is visited.
java.util.List<java.lang.String>	getLines() Return the list of currently logger lines.
LinkIndexConverter	getLinkIndexConverter() Return class which will convert Objects to and from link indexes.
protected java.io.File	getPrintDirectory() Return the default directory to use for printing the area content.
java.lang.String	getTab() Return the tab that can be usage for a text content.
protected java.lang.String	getTabImpl() Return the tab.
protected void	initializeHTMLContent(int rows, int cols) Initialize the HTML content.
protected void	initializeTextArea() Initialize the text area.
void	registerHyperLinkListener(ScriptLoggerHyperLinkListener hyperlinkListener) Set the listener which will be fired when an hyperlink is visited.
void	registerLinkIndexConverter(LinkIndexConverter converter) Register the class which will convert Objects to and from link indexes.
void	setProgress(float value) Set the value of the progress bar.
void	setTab(int tabs) Set the current value for of the tab for the text.
protected void	visitHyperLink(java.lang.String linkDesc) Visit an hyperlink.

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

Methods inherited from interface org.scripthelper.swing.SwingScriptLogger

doGetLabel, getLabel

Methods inherited from interface org.scripthelper.context.ScriptLogger

appendArrayLinks, appendColorArrayLinks, appendError, appendLinks, appendObjectLinks, appendObjectLinks, appendStackTrace, finishedScript, newLine, setLoggerTitle, setStatusMessage

Field Detail

progressBar

protected javax.swing.JProgressBar progressBar

The progress bar. it is null by default.

area

protected StylableSizableArea area

The area.

Constructor Detail

DefaultSwingScriptLoggerArea

public DefaultSwingScriptLoggerArea()

Constructor.

DefaultSwingScriptLoggerArea

public DefaultSwingScriptLoggerArea(boolean hasProgressBar,
                                    boolean hasTools)

Constructor.

Parameters:

hasProgressBar - true if there must be a progress bar

hasTools - true if tools must be integrated in the area

DefaultSwingScriptLoggerArea

public DefaultSwingScriptLoggerArea(boolean hasProgressBar,
                                    boolean hasTools,
                                    int rows,
                                    int cols)

Constructor.

Parameters:

hasProgressBar - true if there must be a progress bar

hasTools - true if tools must be integrated in the area

rows - the number of rows of the logger area

cols - the number of columns of the logger area

Method Detail

acceptNullObjectLinks

public void acceptNullObjectLinks(boolean accept)

Specifies if the logger must accept objects which generate null links from LinkIndexConverter.getLinkFromObject(java.lang.Object).

Specified by:

acceptNullObjectLinks in interface ScriptLogger

Parameters:

accept - true if the logger must accept objects which generate null links

getLines

public java.util.List<java.lang.String> getLines()

Return the list of currently logger lines.

Returns:

the list of currently logger lines

initializeHTMLContent

protected void initializeHTMLContent(int rows,
                                     int cols)

Initialize the HTML content.

Parameters:

rows - the number of rows of the logger area

cols - the number of columns of the logger area

clear

public void clear()

Clear the content of the logger

Specified by:

clear in interface ScriptLogger

registerLinkIndexConverter

public void registerLinkIndexConverter(LinkIndexConverter converter)

Register the class which will convert Objects to and from link indexes. Do nothing by default.

Specified by:

registerLinkIndexConverter in interface ScriptLogger

Parameters:

converter - the link index converter

getLinkIndexConverter

public LinkIndexConverter getLinkIndexConverter()

Return class which will convert Objects to and from link indexes.

Returns:

the link index converter

registerHyperLinkListener

public void registerHyperLinkListener(ScriptLoggerHyperLinkListener hyperlinkListener)

Set the listener which will be fired when an hyperlink is visited.

Specified by:

registerHyperLinkListener in interface ScriptLogger

Parameters:

hyperlinkListener - the listener

getHyperLinkListener

public ScriptLoggerHyperLinkListener getHyperLinkListener()

Return the listener which will be fired when an hyperlink is visited.

Returns:

the listener

initializeTextArea

protected void initializeTextArea()

Initialize the text area.

visitHyperLink

protected void visitHyperLink(java.lang.String linkDesc)

Visit an hyperlink. Do nothing by default.

Parameters:

linkDesc - the hyperlink description

append

public void append(java.lang.String text)

Append a line of text in the message area, with a default color.

Specified by:

append in interface ScriptLogger

Parameters:

text - the text

append

public void append(java.lang.String txt,
                   java.lang.String htmlColor)

Append a line of text in the message area, with a specific color.

Specified by:

append in interface ScriptLogger

Parameters:

txt - the text

htmlColor - the HTML color to use for the text

appendLink

public void appendLink(java.lang.String txt,
                       java.lang.String linkID)

Append a hyperlinked line of text in the message area, with a default color.

Specified by:

appendLink in interface ScriptLogger

Parameters:

txt - the text

linkID - the hyperlink ID

appendLink

public void appendLink(java.lang.String txt,
                       java.lang.String linkID,
                       java.lang.String htmlColor)

Append a hyperlinked line of text in the message area, with a specific color.

Specified by:

appendLink in interface ScriptLogger

Parameters:

txt - the text

linkID - the hyperlink ID

htmlColor - the HTML color to use for the text

appendLinks

public void appendLinks(java.lang.String txt,
                        java.util.List<java.lang.String> linkIDs,
                        java.lang.String htmlColor)

Append a hyperlinked line of text in the message area, with a specified color.

Specified by:

appendLinks in interface ScriptLogger

Parameters:

txt - the text

linkIDs - the hyperlinks IDs

htmlColor - the color

appendObjectLink

public void appendObjectLink(HyperlinkElement element)

Append a hyperlinked line of text in the message area, with a default color.

Specified by:

appendObjectLink in interface ScriptLogger

Parameters:

element - the hyperlink element

appendObjectLink

public void appendObjectLink(HyperlinkElement element,
                             java.lang.String htmlColor)

Append a hyperlinked line of text in the message area, with a specific color.

Specified by:

appendObjectLink in interface ScriptLogger

Parameters:

element - the hyperlink element

htmlColor - the HTML color to use for the text

appendObjectLinks

public void appendObjectLinks(java.lang.String txt,
                              java.lang.String htmlColor,
                              HyperlinkElement... links)

Append a hyperlinked line of text in the message area, with a specified color.

Specified by:

appendObjectLinks in interface ScriptLogger

Parameters:

txt - the text

links - the hyperlinks Objects

htmlColor - the color

appendObjectLinks

public void appendObjectLinks(java.lang.String txt,
                              java.util.List<HyperlinkElement> links,
                              java.lang.String htmlColor)

Append a hyperlinked line of text in the message area, with a specified color.

Specified by:

appendObjectLinks in interface ScriptLogger

Parameters:

txt - the text

links - the hyperlinks Objects

htmlColor - the color

appendError

public void appendError(java.lang.String txt)

Append a line of text in the message area, colored in red (for errors).

Specified by:

appendError in interface ScriptLogger

Parameters:

txt - the text

clearTab

public void clearTab()

Clear the current value of the tab for the text. All subsequent lines will be presented without tab.

Specified by:

clearTab in interface ScriptLogger

getTabImpl

protected java.lang.String getTabImpl()

Return the tab.

Returns:

the tab

getTab

public java.lang.String getTab()

Return the tab that can be usage for a text content. Return an empty String by default.

Specified by:

getTab in interface ScriptLogger

Returns:

the tab

setTab

public void setTab(int tabs)

Set the current value for of the tab for the text. All subsequent lines will be presented with a tab of tabs

Specified by:

setTab in interface ScriptLogger

Parameters:

tabs - the current value for of the tab for the text

setProgress

public void setProgress(float value)

Set the value of the progress bar.

Specified by:

setProgress in interface ScriptLogger

Parameters:

value - the value

getPrintDirectory

protected java.io.File getPrintDirectory()

Return the default directory to use for printing the area content.

Returns:

the directory

doPrint

protected void doPrint()

Print the content of the panel as html.

doPrintImpl

protected void doPrintImpl(java.io.File file)
                    throws java.io.IOException

Perform the html printing.

Parameters:

file - the file where to put the html content

Throws:

java.io.IOException - if an IOException is thrown