org.favabeans.base
Class FacetView

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--javax.swing.JComponent
                    |
                    +--javax.swing.JPanel
                          |
                          +--org.favabeans.base.FacetView

All Implemented Interfaces:

Accessible, Faceted, ImageObserver, MenuContainer, Serializable, View

public class FacetView

extends JPanel

implements View, Faceted

A FacetView is a wrapper around a View built to handle the common (and, in fact, foundationally important) situation where we have --

• Some View v capable of displaying objects of Type t₀;
• Some object x of Type t_k-1 (say);
• A way of building, via Facets, a Type t₀ object given a t_k-1 object;
• The perfectly reasonable desire to use View v to display the t₀ Facet of x; and --
• To simplify interactions with the framework, the need to do all this while still preserving the abstraction that our resulting View is a direct view on x.

Our approach in this case would be to construct a FacetView. More formally, adopting the notation that --

F[t_i](z)

is the Facet of Type t_i of some object z, there exists a chain of Facet implementations necessary to recursively build the Facet --

y = F[t₀](F[t₁](...F[t_k-1](x)))

of the primary object x. We create the FacetView --

v_f = new FacetView(v, a)

passing our View v as the delegate View and an array of Types a = (t₀, t₁, ..., t_k-1) on the basis of which v_f can construct the necessary intermediary Facets. v_f will behave as a View on the original object x, and will pass various View operations through to its delegate v in a predictable fashion.

See Also:

Serialized Form

Inner classes inherited from class javax.swing.JPanel

JPanel.AccessibleJPanel

Inner classes inherited from class javax.swing.JComponent

JComponent.AccessibleJComponent

Inner classes inherited from class java.awt.Container

Container.AccessibleAWTContainer

Inner classes inherited from class java.awt.Component

Component.AccessibleAWTComponent

Fields inherited from class javax.swing.JComponent

accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

FacetView(View delegate, Type[] facetTypes)

Method Summary

View	getDelegate()
Facet	getFacet(Type type) Obtain a Facet of the requested Type for this object.
Type[]	getFacetTypes()
Object	getModel() Obtain the current model of this View.
boolean	isModelSettable(Object model) Check if the given value is an allowable argument to setModel(Object).
void	setModel(Object model) Set the model of this View to a new value.

Methods inherited from class javax.swing.JPanel

getAccessibleContext, getUIClassID, paramString, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getConditionForKeyStroke, getDebugGraphicsOptions, getGraphics, getHeight, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getVerifyInputWhenFocusTarget, getVisibleRect, getWidth, getX, getY, grabFocus, hasFocus, hide, isDoubleBuffered, isFocusCycleRoot, isFocusTraversable, isLightweightComponent, isManagingFocus, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isPreferredSizeSet, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processFocusEvent, processKeyBinding, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setDebugGraphicsOptions, setDoubleBuffered, setEnabled, setFont, setForeground, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getLayout, insets, invalidate, isAncestorOf, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setLayout, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, getBackground, getBounds, getColorModel, getComponentOrientation, getCursor, getDropTarget, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getInputContext, getInputMethodRequests, getLocale, getLocation, getLocationOnScreen, getName, getParent, getPeer, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, imageUpdate, inside, isDisplayable, isEnabled, isLightweight, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.favabeans.base.View

addPropertyChangeListener, addPropertyChangeListener, removePropertyChangeListener, removePropertyChangeListener

Constructor Detail

FacetView

public FacetView(View delegate,
                 Type[] facetTypes)

Method Detail

getFacetTypes

public Type[] getFacetTypes()

getDelegate

public View getDelegate()

getFacet

public Facet getFacet(Type type)

Description copied from interface: Faceted

Obtain a Facet of the requested Type for this object.

Specified by:

getFacet in interface Faceted

Following copied from interface: org.favabeans.base.Faceted

Parameters:

type - the Type of Facet requested for this object.

Returns:

a Facet, or null if none can be created as requested.

isModelSettable

public boolean isModelSettable(Object model)

Description copied from interface: View

Check if the given value is an allowable argument to View.setModel(Object). This should be overridden to provide end-user feedback regarding the correctness of a candidate model for this View, where such information is available to the implementation.

The default behavior of this method is to return true, and throw an exception in View.setModel(Object) if necessary.

Specified by:

isModelSettable in interface View

Following copied from interface: org.favabeans.base.View

Parameters:

model - the candidate model.

Returns:

false if the candidate model is known to be unacceptable; true otherwise.

setModel

public void setModel(Object model)
              throws PropertyValueException

Description copied from interface: View

Set the model of this View to a new value.

Specified by:

setModel in interface View

Following copied from interface: org.favabeans.base.View

Parameters:

model - the new model.

Throws:

PropertyValueException - if the supplied model was not acceptable.

getModel

public Object getModel()

Description copied from interface: View

Obtain the current model of this View.

Specified by:

getModel in interface View

Following copied from interface: org.favabeans.base.View

Returns:

the current model.