|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectfacets.util.Tracer
facets.core.superficial.TargetCore
facets.core.superficial.app.IndexingTarget
public abstract class IndexingTarget
STarget
with indexing of STarget
children.
IndexingTarget
defines key behaviour needed by
SAreaTarget
, based on an
SIndexing
of STarget
children.
Nested Class Summary |
---|
Nested classes/interfaces inherited from interface facets.core.superficial.STarget |
---|
STarget.Targeted |
Nested classes/interfaces inherited from interface facets.core.superficial.Notifying |
---|
Notifying.Impact |
Field Summary |
---|
Fields inherited from class facets.core.superficial.TargetCore |
---|
targets |
Fields inherited from interface facets.core.superficial.STarget |
---|
NONE |
Constructor Summary | |
---|---|
protected |
IndexingTarget(java.lang.String title,
SIndexing indexing)
Unique constructor. |
Method Summary | |
---|---|
protected boolean |
blockNotification()
Enables notification to be restricted to this member of the tree. |
java.lang.Object |
identity()
Return an object that is as far as possible unique for the implementation. |
Notifying.Impact |
impact()
Allows this Notifying to specify a default Notifying.Impact . |
STarget[] |
indexableTargets()
Convenience cast for the indexables of the indexing. |
STarget |
indexedTarget()
Convenience cast for the indexed of the indexing. |
SIndexing |
indexing()
The indexing last set with setIndexing(SIndexing) . |
Notifiable |
monitor()
The current Notifiable in the notification tree,
as set with setMonitor . |
protected TypedNode[] |
newDebugChildren()
Create a TypedNode[] representation of this Notifying
for debug purposes. |
protected static TypedNode |
newDebugContentNode(java.lang.String title,
java.lang.Object source)
|
protected static TypedNode |
newDebugContentNode(java.lang.String title,
java.lang.Object[] source)
|
protected static TypedNode |
newDebugMonitorNode(Notifiable monitor)
|
TypedNode |
newGraphNode()
Returns a descriptive node for use in debug object graph. |
abstract STargeter |
newTargeter()
Overrides superclass method. |
protected boolean |
notifiesTargeter()
Used to construct the notification tree. |
void |
notify(Notice notice)
Respond to the Notice passed. |
void |
notifyMonitor(Notifying.Impact impact)
Call notify on the parent monitor in the notification tree,
typically with itself as parameter to the Notice passed. |
IndexingTarget |
parent()
Any containing IndexingTarget . |
void |
setIndexing(SIndexing indexing)
Sets the SIndexing containing the STarget children of
the IndexingTarget . |
void |
setLive(boolean live)
Overrides superclass method. |
void |
setMonitor(Notifiable monitor)
Attach the Notifying to a Notifiable parent
in the notification tree. |
java.lang.String |
toString()
|
Methods inherited from class facets.core.superficial.TargetCore |
---|
elements, findMonitorOfType, isLive, join, lazyElements, setElements, title, wantsFocus |
Methods inherited from class facets.util.Tracer |
---|
trace, trace, trace, trace, trace, traceDebug, traceDebug, traceObjectText, traceOutput, traceOutputWithClass |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Methods inherited from interface facets.core.superficial.Notifying |
---|
impact, monitor, notifyMonitor, setMonitor |
Methods inherited from interface facets.core.superficial.Notifiable |
---|
notify |
Constructor Detail |
---|
protected IndexingTarget(java.lang.String title, SIndexing indexing)
title
- passed to the superclassindexing
- passed to setIndexing(SIndexing)
Method Detail |
---|
public void setIndexing(SIndexing indexing)
SIndexing
containing the STarget
children of
the IndexingTarget
.
indexing
- will be returned by indexing()
; its indexables
will be returned by indexableTargets()
and its SIndexing.indexed()
by indexedTarget()
;
the indexables must therefore be a STarget
[]public final SIndexing indexing()
setIndexing(SIndexing)
.
public final STarget[] indexableTargets()
indexables
of the indexing.
indexing().indexables()
cast to a
STarget
[]
public final STarget indexedTarget()
indexed
of the indexing.
indexing().indexed()
cast to a
STarget
public abstract STargeter newTargeter()
Must return an IndexingTargeter
.
newTargeter
in class TargetCore
public final IndexingTarget parent()
IndexingTarget
.
null
public final void setLive(boolean live)
Ensures that only the indexed child is live (but ignores viewers).
setLive
in interface STarget
setLive
in class TargetCore
public java.lang.String toString()
toString
in class TargetCore
protected final boolean notifiesTargeter()
TargetCore
NOTE This method must NOT be overridden in application code.
notifiesTargeter
in class TargetCore
protected TypedNode[] newDebugChildren()
TypedNode[]
representation of this Notifying
for debug purposes.
newDebugChildren
in class TargetCore
protected static final TypedNode newDebugContentNode(java.lang.String title, java.lang.Object source)
protected static final TypedNode newDebugContentNode(java.lang.String title, java.lang.Object[] source)
protected static final TypedNode newDebugMonitorNode(Notifiable monitor)
public final TypedNode newGraphNode()
public Notifying.Impact impact()
Notifying
Notifying
to specify a default Notifying.Impact
.
impact
in interface Notifying
Notifying.Impact.DEFAULT
public java.lang.Object identity()
Identified
This will usually be a class instance counter.
identity
in interface Identified
public final Notifiable monitor()
Notifiable
in the notification tree,
as set with setMonitor
.
Complains if no parent has been set.
monitor
in interface Notifying
public void notify(Notice notice)
Notifiable
Notice
passed.
When this method is called, the Notifiable
should
respond based on
Notice
passed.
notify
in interface Notifiable
public final void notifyMonitor(Notifying.Impact impact)
Notifying
notify
on the parent monitor in the notification tree,
typically with itself as parameter to the Notice
passed.
Has no effect if no monitor has been set.
This is the usual means to trigger a surface retargeting, being called
by an exposing SFacet
on its target.
notifyMonitor
in interface Notifying
impact
- suggests the level of retargeting requiredprotected boolean blockNotification()
Checked by notify(Notice)
; default returns false
.
public final void setMonitor(Notifiable monitor)
Notifying
Notifying
to a Notifiable
parent
in the notification tree.
setMonitor
in interface Notifying
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |