facets.facet
Class FacetMaster

java.lang.Object
  facets.util.Tracer
      facets.facet.FacetMaster

Direct Known Subclasses:

FacetMaster.Simple, FacetMaster.Viewer

public abstract class FacetMaster
extends Tracer

Integrates a custom widget assembly with the facet builder API.

FacetMaster allows custom widget assemblies to be built and managed within an abstract facet builder API.

A facet master must

• create a widget assembly on behalf of a facet for use in the GUI surface
• maintain the state of this assembly to match the facet target as the facet is applied
• respond to input events on the assembly by updating the current content or target and triggering a retargeting

A master should be used by a facet builder to extend by composition an appropriate generic facet; FacetMaster itself defines attachedToFacet() to be called by the facet during construction.

FacetMaster is extended for viewer and simple facet by its internal abstract subclasses; methods to create and reference the custom assembly can be defined in toolkit-specific subclasses.

Nested Class Summary

static class	FacetMaster.Simple Builds and manages widget assembly for a simple facet.
static class	FacetMaster.Viewer Builds and manages avatar pane for a viewer facet.

Constructor Summary

FacetMaster()

Method Summary

void	attachedToFacet() Called when a facet is constructed from the instance.

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, toString, wait, wait, wait

Constructor Detail

FacetMaster

public FacetMaster()

Method Detail

attachedToFacet

public void attachedToFacet()

Called when a facet is constructed from the instance.

Can be used to perform facet-dependent construction: up to this call, methods depending on the facet will fail.

Default implementation is empty.