oracle.ide.layout
Class IdeLayout

java.lang.Object
  oracle.ide.model.Node
      oracle.ide.layout.Layout
          oracle.ide.layout.IdeLayout

All Implemented Interfaces:

oracle.javatools.data.Dirtyable, Dirtyable, Displayable, Element, Folder, LazyLoadable, Locatable, PropertyAccess, Subject

public final class IdeLayout

extends Layout

implements Folder

IdeLayout class. IdeLayout instances are layouts that can contain other layouts. For example, the design and debug layouts can contain other user created SimpleLayouts as their children.

Constructor Summary

protected	IdeLayout()
	IdeLayout(java.net.URL fileURL, java.lang.String shortLabel, ArrayResourceBundle iconBundle, int iconKey)
	IdeLayout(java.net.URL fileURL, java.lang.String shortLabel, javax.swing.Icon icon)

Method Summary

boolean	add(Element element) Appends a child Element to the end of the Folder.
boolean	canAdd(Element element) Other classes can call this method to determine whether the given Element can be added to the Folder.
boolean	canRemove(Element element) Other classes can call this method to determine whether the specified Element can be removed from this Folder.
protected void	closeImpl() Release the data associated with this item
boolean	containsChild(Element child) Returns true if the folder contains the specified child Element; returns false otherwise.
boolean	equals(java.lang.Object o)
protected boolean	equalsImpl(IdeLayout other)
Layout	findLayout(java.net.URL url) Find the layout associated with the specified url.
Layout	getActiveLayout()
java.util.Iterator	getChildren() This method is part of the Element interface to provide a convenient way of getting an Iterator over any contained child Elements without having to test the object's type with the instanceof operator or having to downcast to a more specific type.
Layout	getDefaults()
javax.swing.Icon	getIcon() Returns an Icon that can be shown in association with this Displayable.
java.io.InputStream	getInputStream() Gets a InputStream that can be used to read the contents of this object.
protected java.util.Map	getLayoutMap()
java.lang.String	getLongLabel() Returns a long label that can be displayed to the user.
java.lang.String	getProperty(java.lang.String key, java.lang.String defaultValue) Retrieves the value associated with a property.
java.lang.String	getShortLabel() Returns a short label that can be displayed to the user.
java.lang.String	getToolTipText() Returns the tool tip text to show when the mouse pointer pauses over a UI component that represents this Displayable.
boolean	mayHaveChildren() This method is part of the Element interface to provide a convenient way of determining whether an object may have children without having to test the object's type with the instanceof operator or having to downcast to a more specific type.
protected void	openImpl() Open (load) the data associated with this item.
boolean	remove(Element element) Removes the specified child Element.
void	removeAll() Removes all children from the folder.
java.lang.Object	removeProperty(java.lang.String key) Removes the property.
protected void	saveImpl() Force the node to be re-loaded from file.
protected void	setActiveLayout(Layout layout)
java.lang.Object	setProperty(java.lang.String key, java.lang.String value) Sets the value for a property.
int	size() Returns the current number of children in the folder.

Methods inherited from class oracle.ide.layout.Layout

getName, getOwner, isActive, isTrackedInNodeCache, setActive, setOwner, toString

Methods inherited from class oracle.ide.model.Node

_getReadWriteLockInternal, addNodeListener, addNodeListenerForType, addNodeListenerForTypeHierarchy, attach, close, createSubject, delete, deleteImpl, detach, ensureOpen, equalsImpl, getAttributes, getData, getSubject, getTimestamp, getURL, isDirty, isNew, isOpen, isReadOnly, markDirty, notifyObservers, open, postCloseImpl, refreshTimestamp, removeNodeListener, removeNodeListenerForType, removeNodeListenerForTypeHierarchy, rename, renameImpl, reportOpenException, revert, revertImpl, runWhileSynchronized, save, setOpen, setTimestampDirectly, setURL

Methods inherited from class java.lang.Object

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

Methods inherited from interface oracle.ide.model.Element

getAttributes, getData

Methods inherited from interface oracle.ide.model.Displayable

toString

Constructor Detail

IdeLayout

public IdeLayout(java.net.URL fileURL,
                 java.lang.String shortLabel,
                 javax.swing.Icon icon)

IdeLayout

public IdeLayout(java.net.URL fileURL,
                 java.lang.String shortLabel,
                 ArrayResourceBundle iconBundle,
                 int iconKey)

IdeLayout

protected IdeLayout()

Method Detail

getProperty

public java.lang.String getProperty(java.lang.String key,
                                    java.lang.String defaultValue)

Description copied from interface: PropertyAccess

Retrieves the value associated with a property. If no value exists for the requested property, the specified default value is returned.

Specified by:

getProperty in interface PropertyAccess

Parameters:

key - the property key for which a value is desired.

defaultValue - the value to return if no value currently exists.

Returns:

the value of the requested property, or the default value if the property does not exist.

setProperty

public java.lang.Object setProperty(java.lang.String key,
                                    java.lang.String value)

Description copied from interface: PropertyAccess

Sets the value for a property.

Specified by:

setProperty in interface PropertyAccess

Parameters:

key - the property key to set

value - the string value to set

Returns:

the previous value

removeProperty

public java.lang.Object removeProperty(java.lang.String key)

Description copied from interface: PropertyAccess

Removes the property.

Specified by:

removeProperty in interface PropertyAccess

Parameters:

key - the property key to remove

Returns:

the previous value

getActiveLayout

public Layout getActiveLayout()

findLayout

public Layout findLayout(java.net.URL url)

Find the layout associated with the specified url. If the url matches the default layout url return it, otherwise, look in the list of children.

getInputStream

public java.io.InputStream getInputStream()
                                   throws java.io.IOException

Gets a InputStream that can be used to read the contents of this object.

Overrides:

getInputStream in class Node

Returns:

an input stream, or null if the node has no contents.

Throws:

java.io.IOException - if a security manager exists and its checkRead method denies read access.

openImpl

protected void openImpl()
                 throws java.io.IOException

Open (load) the data associated with this item.

Overrides:

openImpl in class Node

Throws:

java.io.IOException - if an I/O error occurred while opening

closeImpl

protected void closeImpl()
                  throws java.io.IOException

Release the data associated with this item

Overrides:

closeImpl in class Node

Throws:

java.io.IOException - if an I/O error occurred while closing

saveImpl

protected void saveImpl()
                 throws java.io.IOException

Force the node to be re-loaded from file.

Overrides:

saveImpl in class Node

Throws:

java.io.IOException - if an I/O error occurred while saving

getDefaults

public Layout getDefaults()

getShortLabel

public java.lang.String getShortLabel()

Description copied from interface: Displayable

Returns a short label that can be displayed to the user. Generally, the value of the returned String is considered translatable and should therefore be placed in an appropriate resource file. When possible, the returned label should be reasonably short enough to show in the navigator or explorer windows but long enough to clearly identify and distinguish the Displayable.

Specified by:

getShortLabel in interface Displayable

Overrides:

getShortLabel in class Layout

getIcon

public javax.swing.Icon getIcon()

Description copied from interface: Displayable

Returns an Icon that can be shown in association with this Displayable. Typically the icon will be used in a tree control or list control. Therefore the icon must fit naturally within the space normally given to items within those controls. Such icons are usually 16x16 in size or, if there is a one-pixel transparent padding around the edge, 18x18 in size. It is strongly recommended that icons returned by this method be either 16x16 or 18x18 in size. If null is returned, the control may show a default icon, or it may show no icon, whichever is appropriate.

Specified by:

getIcon in interface Displayable

Overrides:

getIcon in class Node

getLongLabel

public java.lang.String getLongLabel()

Description copied from interface: Displayable

Returns a long label that can be displayed to the user. Generally, the value of the returned String is considered translatable and should therefore be placed in an appropriate resource file. The long label differs from the short label essentially on length. Usually the long label will only be shown on-demand and in places where horizontal space is more available. Examples are the status bar and tooltips.

Specified by:

getLongLabel in interface Displayable

Overrides:

getLongLabel in class Node

getToolTipText

public java.lang.String getToolTipText()

Description copied from interface: Displayable

Returns the tool tip text to show when the mouse pointer pauses over a UI component that represents this Displayable. In many cases it may be appropriate for this method to return the same value as Displayable.getLongLabel().

Specified by:

getToolTipText in interface Displayable

Overrides:

getToolTipText in class Node

mayHaveChildren

public boolean mayHaveChildren()

Description copied from interface: Element

This method is part of the Element interface to provide a convenient way of determining whether an object may have children without having to test the object's type with the instanceof operator or having to downcast to a more specific type.

An implementation of Element that represents a leaf in a tree structure should return false from this method. An implementation of Element that could represent a non-leaf in a tree structure should return true from this method, even if it does not currently contain any children.

Specified by:

mayHaveChildren in interface Element

Overrides:

mayHaveChildren in class Node

getChildren

public java.util.Iterator getChildren()

Description copied from interface: Element

This method is part of the Element interface to provide a convenient way of getting an Iterator over any contained child Elements without having to test the object's type with the instanceof operator or having to downcast to a more specific type.

An implementation of Element that represents a leaf in a tree structure should return null from this method. An implementation of Element that could represent a non-leaf in a tree structure should return either an Iterator over the child Elements or null if there are no children.

Specified by:

getChildren in interface Element

Overrides:

getChildren in class Layout

add

public boolean add(Element element)

Description copied from interface: Folder

Appends a child Element to the end of the Folder.

Specified by:

add in interface Folder

remove

public boolean remove(Element element)

Description copied from interface: Folder

Removes the specified child Element. If the child object appears more than once, only the first instance is removed.

Specified by:

remove in interface Folder

Parameters:

element - The child object to remove.

canRemove

public boolean canRemove(Element element)

Description copied from interface: Folder

Other classes can call this method to determine whether the specified Element can be removed from this Folder.

Specified by:

canRemove in interface Folder

Parameters:

element - the Element that is about to be removed from this Folder.

Returns:

true if the specified Element can be removed from this Folder; false if the Element cannot be removed.

canAdd

public boolean canAdd(Element element)

Description copied from interface: Folder

Other classes can call this method to determine whether the given Element can be added to the Folder.

Specified by:

canAdd in interface Folder

Parameters:

element - the Element that is about to be added to this Folder.

Returns:

true if the specified Element can be added to this Folder; false if the Element cannot be added.

containsChild

public boolean containsChild(Element child)

Description copied from interface: Folder

Returns true if the folder contains the specified child Element; returns false otherwise.

Specified by:

containsChild in interface Folder

size

public int size()

Description copied from interface: Folder

Returns the current number of children in the folder.

Specified by:

size in interface Folder

removeAll

public void removeAll()

Description copied from interface: Folder

Removes all children from the folder.

Specified by:

removeAll in interface Folder

equals

public boolean equals(java.lang.Object o)

equalsImpl

protected final boolean equalsImpl(IdeLayout other)

setActiveLayout

protected void setActiveLayout(Layout layout)

getLayoutMap

protected java.util.Map getLayoutMap()