public class Connections extends DefaultFolder implements Copyable, SubDirtyable, Subject
Modifier and Type | Field and Description |
---|---|
static java.lang.String |
CONNECTIONS |
_children
Constructor and Description |
---|
Connections()
Default constructor.
|
Connections(Connections otherConnections)
Copy constructor.
|
Modifier and Type | Method and Description |
---|---|
void |
attach(Observer observer)
Registers an observer interested in being notified when the internal state of the class implementing the
Subject interface changes. |
java.lang.Object |
copyTo(java.lang.Object object)
Copies the internal state of
this object to the specified copy . |
void |
detach(Observer observer)
Unregisters an observer that is not interested anymore in being notified when the internal state of the class implementing the
Subject interface changes. |
javax.swing.Icon |
getIcon()
Part of
Element interface. |
java.lang.String |
getLongLabel()
This implementation delegates to
DefaultDisplayable.getShortLabel() . |
java.lang.String |
getShortLabel()
This implementation returns a place-holder
String . |
java.lang.String |
getToolTipText()
This implementation delegates to
DefaultDisplayable.getLongLabel() . |
boolean |
isDirty()
True if the data in the object has been modified.
|
void |
markDirty(boolean dirty)
Marks the data with the specified dirty state.
|
void |
notifyObservers(java.lang.Object subject, UpdateMessage change)
Notifies all observers that the state of the subject has changed.
|
void |
setOwner(Dirtyable owner)
This method should be called to set the document in which a
SubDirtyable implementation will be persisted. |
add, canAdd, canRemove, containsChild, copyToImpl, equalsImpl, getChildren, mayHaveChildren, remove, removeAll, size
getAttributes, getData
toString
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
getAttributes, getData
toString
public static final java.lang.String CONNECTIONS
public Connections()
public Connections(Connections otherConnections)
public java.lang.Object copyTo(java.lang.Object object)
Copyable
this
object to the specified copy
. If copy
is null
, then this method should create a new instance of this
class and proceed to copy the internal state to the newly created object. Generally, only the persistent state of the object should be copied, but whether or not it is appropriate to copy transient properties is at the discretion of the individual implementor.
Regardless of whether the copy occurs to an existing object or to a newly created object, the return value is object to which this
object's state was copied.
There is a standard implementation pattern for the copyTo
method that helps avoid problems that arise when a Copyable
object is subclassed. The pattern is:
The parameter passed into thepublic Object copyTo( Object target ) { final <this_class> copy = target != null ? (<this_class>) target : new <this_class>(); copyToImpl( copy ); return copy; } protected final void copyToImpl( <this_class> copy ) { super.copyToImpl( copy ); // if necessary // put code here for copying the properties of <this_class> }
copyToImpl
method is the same type of this
class. The responsibility of copyToImpl
is to copy the state of this
class through direct access of the fields. The copyToImpl
method should not use getters and setters since these may be overridden, causing the state of this
class to be incompletely copied.copyTo
in interface Copyable
object
- The target object to which the state of this
object should be copied. If target
is null
, then the copyTo
method will return a new instance of this
class.this
object was copied. If the target
was non-null
, then the return value is the same as the target
object that was passed in; otherwise, the return value is a new instance of this
class.public boolean isDirty()
Dirtyable
public void markDirty(boolean dirty)
Dirtyable
markDirty(...)
instead of setDirty(...)
so that the JavaBeans Introspector
will not mistakenly identify "dirty" as a JavaBean property.public void setOwner(Dirtyable owner)
SubDirtyable
SubDirtyable
implementation will be persisted.setOwner
in interface SubDirtyable
owner
- The Dirtyable
object in which this SubDirtyable
will be saved.public java.lang.String getShortLabel()
DefaultDisplayable
String
.getShortLabel
in interface Displayable
getShortLabel
in class DefaultDisplayable
Displayable
that can be shown to the user.Displayable.getShortLabel()
public java.lang.String getLongLabel()
DefaultDisplayable
DefaultDisplayable.getShortLabel()
.getLongLabel
in interface Displayable
getLongLabel
in class DefaultDisplayable
Displayable
that can be shown to the user.Displayable.getLongLabel()
public javax.swing.Icon getIcon()
DefaultFolder
Element
interface. The default implementation returns null
, which causes a default folder icon to be used.getIcon
in interface Displayable
getIcon
in class DefaultFolder
Icon
to be displayed for the Displayable
.Displayable.getIcon()
public java.lang.String getToolTipText()
DefaultDisplayable
DefaultDisplayable.getLongLabel()
.getToolTipText
in interface Displayable
getToolTipText
in class DefaultDisplayable
Displayable
.Displayable.getToolTipText()
public void attach(Observer observer)
Subject
Subject
interface changes. Implementors should do nothing when the same observer is added more than once.public void detach(Observer observer)
Subject
Subject
interface changes. Implementors should do nothing when the same observer is removed more than once.public void notifyObservers(java.lang.Object subject, UpdateMessage change)
Subject
notifyObservers
in interface Subject
subject
- the subject whose state has changed.change
- what changed.