facets.core.superficial
Interface STargeter

All Superinterfaces:

Facetable, Notifiable, Notifying, SRetargetable, Titled

All Known Implementing Classes:

AreaTargeter, IndexingFrame.FrameTargeter, IndexingTargeter, SContentRootTargeter, TargeterCore

public interface STargeter
extends SRetargetable, Titled, Notifying, Facetable

Superficial targeter.

A STargeter mediates between a target, its exposing facet(s) and the surface by extending three significant interfaces:

• SRetargetable enables to to have a target.
• Notifying enables it to form part of the notification tree.
• Facetable enables it to attach facet which it applies with its own target; note that some STargeters have no facet, functioning only as organising elements of the targeter tree.

Nested Class Summary

Nested classes/interfaces inherited from interface facets.core.superficial.Notifying

Notifying.Impact

Method Summary

void	attachFacet(SFacet facet) Adds facet to a list of facets to be updated during retargetFacets.
STargeter[]	elements() Dynamically-defined children.
void	retarget(STarget target, Notifying.Impact impact) Sets the target of the STargeter and those of any elements or other STargeter members.
void	retargetFacets(Notifying.Impact impact) Updates all facets attached with attachFacet(SFacet) and those of any child elements().

Methods inherited from interface facets.core.superficial.SRetargetable

target

Methods inherited from interface facets.util.Titled

title

Methods inherited from interface facets.core.superficial.Notifying

impact, monitor, notifyMonitor, setMonitor

Methods inherited from interface facets.core.superficial.Notifiable

notify

Method Detail

retarget

void retarget(STarget target,
              Notifying.Impact impact)

Sets the target of the STargeter and those of any elements or other STargeter members.

Also sets the STargeter as notification monitor of its STargeter members and of its target.

Specified by:

retarget in interface SRetargetable

See Also:

Notifying

elements

STargeter[] elements()

Dynamically-defined children.

Return any children created dynamically during initial retargeting to correspond with the child elements of target.

attachFacet

void attachFacet(SFacet facet)

Adds facet to a list of facets to be updated during retargetFacets.

Specified by:

attachFacet in interface Facetable

Parameters:

facet - will be applied during each retargeting sequence

retargetFacets

void retargetFacets(Notifying.Impact impact)

Updates all facets attached with attachFacet(SFacet) and those of any child elements().

Application code need never call this method directly; it is called on the surface root targeter after retargeting following notification, and then recursively through the targeter tree.

Specified by:

retargetFacets in interface Facetable