oracle.ide.log
Class AbstractLogPage

java.lang.Object
  oracle.ide.addin.AbstractView
      oracle.ide.log.AbstractLogPage

All Implemented Interfaces:

Helpable, LogPage, Subview, View

Direct Known Subclasses:

DefaultLogPage, MessagePage

public abstract class AbstractLogPage

extends AbstractView

implements LogPage

The AbstractLogPage is a convenience class that should be extended by integrators that need to add their own LogPage to the LogWindow.

Field Summary

Fields inherited from class oracle.ide.addin.AbstractView

owner, SEPARATOR, viewListeners, viewSelectionListeners

Fields inherited from interface oracle.ide.addin.View

PROJECT_PROP, VISIBLE_PROP, WORKSPACE_PROP

Constructor Summary

protected	AbstractLogPage(ViewId viewId) Creates an AbstractLogPage.
protected	AbstractLogPage(ViewId viewId, javax.swing.Icon icon) Creates an AbstractLogPage.
protected	AbstractLogPage(ViewId viewId, javax.swing.Icon icon, boolean addPage) Creates an AbstractLogPage.

Method Summary

void	addMouseListener(java.awt.event.MouseListener listener) This implemenation does nothing.
void	checkCommands(Context context, Controller activeController)
void	clearAll() Clear all currently displayed messages.
void	close() Closes the view
Context	getContext(java.util.EventObject event) Gets the current view context.
Controller	getController() Gets the Controller associated with this view.
javax.swing.Icon	getTabIcon() Get the icon to display when this page is tabbed.
java.lang.String	getTabName() Get the name to display when this page is tabbed.
java.lang.String	getTitleName() Get the title to be displayed in the log window hosting this page.
java.lang.String	getToolTip() Get the tooltip to display when this page is tabbed.
boolean	isVisible() Returns true if the subview is visible.
void	log(java.lang.Object msg) Display the specified msg.
protected void	logMsg(java.lang.Object msg) Display the specified msg.
void	removeMouseListener(java.awt.event.MouseListener listener) This implemenation does nothing.
protected void	requestShow() Show the log window only if it has not been closed by the user.
void	setOwner(LogOwner owner) Set the view that owns this page.
void	show() Shows the view if hidden.

Methods inherited from class oracle.ide.addin.AbstractView

activate, addViewListener, addViewSelectionListener, deactivate, fireViewActivated, fireViewClosed, fireViewDeactivated, fireViewSelectionChanged, getContext, getContextMenu, getHelpInfo, getId, getSelection, getToolbar, loadToolbar, loadToolbar, newId, owner, removeViewListener, removeViewSelectionListener, setId, setOwner, updateTitle

Methods inherited from class java.lang.Object

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

Methods inherited from interface oracle.ide.addin.View

activate, addViewListener, addViewSelectionListener, deactivate, getId, getSelection, getToolbar, removeViewListener, removeViewSelectionListener, updateTitle

Methods inherited from interface oracle.ide.help.Helpable

getHelpInfo

Methods inherited from interface oracle.ide.addin.Subview

getContext, getContextMenu, getGUI, owner

Constructor Detail

AbstractLogPage

protected AbstractLogPage(ViewId viewId,
                          javax.swing.Icon icon,
                          boolean addPage)

Creates an AbstractLogPage. If the addPage parameter is true it adds the page to LogWindow. It uses the ViewId.getDisplayName() method to determine the tab name used by this page.

Some subclasses will pass false for the addPage argument, which means DO NOT add the page to the log manager during the execution of the constructor. The reason why a subclass would pass false is because they are overriding methods which are called during the addPage process and the overriding methods depend on field initialization which does not take place until after the super constructor returns. For example, a subclass which overrides getToolTip will likely want to pass false for the addPage argument.

Parameters:

viewId - the ViewId identifying this view.

icon - the page icon to be displayed in a tab.

addPage - specifies whether this page should be immediately added to the LogWindow

AbstractLogPage

protected AbstractLogPage(ViewId viewId,
                          javax.swing.Icon icon)

Creates an AbstractLogPage. It uses the ViewId.getDisplayName() method to determine the tab name used by this page.

Parameters:

viewId - the ViewId identifying this view.

icon - the page icon to be displayed in a tab. to the LogWindow

AbstractLogPage

protected AbstractLogPage(ViewId viewId)

Creates an AbstractLogPage. It uses the ViewId.getDisplayName() method to determine the tab name used by this page.

Parameters:

viewId - the ViewId identifying this view. to the LogWindow

Method Detail

log

public void log(java.lang.Object msg)

Display the specified msg. This method first makes sure that the page is visible and then calls the logMsg method to do the actual displaying of the message. Subclasses should not override this method. Instead they should override the logMsgmethod.

Specified by:

log in interface LogPage

Parameters:

msg - the message to display.

clearAll

public void clearAll()

Description copied from interface: LogPage

Clear all currently displayed messages.

Specified by:

clearAll in interface LogPage

getTitleName

public java.lang.String getTitleName()

Description copied from interface: LogPage

Get the title to be displayed in the log window hosting this page.

Specified by:

getTitleName in interface LogPage

Returns:

the title to display in the host's title bar.

getTabName

public java.lang.String getTabName()

Description copied from interface: LogPage

Get the name to display when this page is tabbed.

Specified by:

getTabName in interface LogPage

Returns:

the name to display when tabbed.

getTabIcon

public javax.swing.Icon getTabIcon()

Description copied from interface: LogPage

Get the icon to display when this page is tabbed.

Specified by:

getTabIcon in interface LogPage

Returns:

the icon to display when tabbed.

getToolTip

public java.lang.String getToolTip()

Description copied from interface: LogPage

Get the tooltip to display when this page is tabbed.

Specified by:

getToolTip in interface LogPage

Returns:

the tooltip to display when tabbed.

setOwner

public void setOwner(LogOwner owner)

Description copied from interface: LogPage

Set the view that owns this page.

Specified by:

setOwner in interface LogPage

Parameters:

owner - view the hosting view.

addMouseListener

public void addMouseListener(java.awt.event.MouseListener listener)

This implemenation does nothing. Subclasses must override this method in order to correctly set the specified listener on the graphical components that receive mouse events.

Specified by:

addMouseListener in interface LogPage

Parameters:

listener - mouse listener responsible for displaying a context menu.

removeMouseListener

public void removeMouseListener(java.awt.event.MouseListener listener)

This implemenation does nothing. Subclasses must override this method in order to correctly remove the specified listener from the graphical components that receive mouse events.

Specified by:

removeMouseListener in interface LogPage

Parameters:

listener - mouse listener responsible for displaying a context menu.

logMsg

protected void logMsg(java.lang.Object msg)

Display the specified msg. Subclasses must override this method instead of the log method. The log method makes sure that the page is visible before calling this method.

Parameters:

msg - the message to display.

requestShow

protected void requestShow()

Show the log window only if it has not been closed by the user. This method is call from log method and it will make sure that this page is the selected page if the log window has not been closed by the user.

checkCommands

public void checkCommands(Context context,
                          Controller activeController)

getContext

public Context getContext(java.util.EventObject event)

Description copied from interface: View

Gets the current view context.

Specified by:

getContext in interface View

Parameters:

event - event associated with the context;

Returns:

the current view context.

getController

public Controller getController()

Description copied from interface: Subview

Gets the Controller associated with this view.

Specified by:

getController in interface Subview

Overrides:

getController in class AbstractView

Returns:

the Controller associated with this view.

show

public void show()

Description copied from interface: Subview

Shows the view if hidden. Raises the view to the top if covered by other windows.

Specified by:

show in interface Subview

Overrides:

show in class AbstractView

close

public void close()

Description copied from interface: Subview

Closes the view

Specified by:

close in interface Subview

Overrides:

close in class AbstractView

isVisible

public boolean isVisible()

Description copied from interface: Subview

Returns true if the subview is visible.

Specified by:

isVisible in interface Subview

Overrides:

isVisible in class AbstractView