bea.jolt.beans.awt
Class JoltList

java.lang.Object
  java.awt.Component
      java.awt.List
          bea.jolt.beans.awt.JoltList

All Implemented Interfaces:

javax.accessibility.Accessible, java.util.EventListener, java.awt.image.ImageObserver, java.awt.event.ItemListener, java.awt.ItemSelectable, JoltOutputListener, java.awt.MenuContainer, java.io.Serializable

public class JoltList

extends java.awt.List

implements JoltOutputListener, java.awt.event.ItemListener

This is a Jolt-aware extension of java.awt.List, which is linked to a specific Jolt field by its JoltFieldName property. It can be wired up with JoltServiceBeans in two ways:

• JoltList contains parts of the input for a service
• JoltList displays output from a service.

In the first case a JoltServiceBean is listening to events raised by a JoltList. JoltList sends JoltInputEvents to its listeners (typically JoltServiceBeans) when the selection in the listbox changes. The JoltInputEvent in this case is populated with the single value of the selected item.

If JoltList is used to display the output of a service, JoltList listens to JoltOutputEvents from JoltServiceBeans and updates its contents accordingly with the occurrences of the Jolt field it is linked to.

See Also:

Serialized Form

Field Summary

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

JoltList()
Constructor

Method Summary

void	addJoltInputListener(JoltInputListener l) Registration method for JoltInput listeners.
java.lang.String[]	getItems() Get the selected items corresponding to this JoltList.
java.lang.String	getJoltFieldName() Get the Jolt field name corresponding to this JoltList.
JoltInputEvent	getJoltInputEvent() Get the current JoltInputEvent object that was sent for serviceReturned.
int	getOccurrenceIndex() Get the occurrence index of the field represented by this JoltList.
void	itemStateChanged(java.awt.event.ItemEvent e) The state of the JoltList changed; generate a JoltInputEvent and notify event listeners.
void	removeJoltInputListener(JoltInputListener l) This method is used to unregister JoltInput listeners.
void	serviceReturned(JoltOutputEvent evt) Event handler for JoltOutputEvents.
void	setItems(java.lang.String[] values) Set the selected items corresponding to this JoltList.
void	setJoltFieldName(java.lang.String name) Set the Jolt field name corresponding to this JoltList.
void	setOccurrenceIndex(int occurrence) Set the occurrence index of the field represented by this JoltList.

Methods inherited from class java.awt.List

add, add, addActionListener, addItem, addItem, addItemListener, addNotify, allowsMultipleSelections, clear, countItems, delItem, delItems, deselect, getAccessibleContext, getActionListeners, getItem, getItemCount, getItemListeners, getListeners, getMinimumSize, getMinimumSize, getPreferredSize, getPreferredSize, getRows, getSelectedIndex, getSelectedIndexes, getSelectedItem, getSelectedItems, getSelectedObjects, getVisibleIndex, isIndexSelected, isMultipleMode, isSelected, makeVisible, minimumSize, minimumSize, preferredSize, preferredSize, remove, remove, removeActionListener, removeAll, removeItemListener, removeNotify, replaceItem, select, setMultipleMode, setMultipleSelections

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, dispatchEvent, doLayout, enable, enable, enableInputMethods, getAlignmentX, getAlignmentY, getBackground, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isOpaque, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paint, paintAll, postEvent, prepareImage, prepareImage, print, printAll, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

JoltList

public JoltList()

Constructor

Method Detail

getJoltInputEvent

public JoltInputEvent getJoltInputEvent()

Get the current JoltInputEvent object that was sent for serviceReturned.

Returns:

The JoltInputEvent.

serviceReturned

public void serviceReturned(JoltOutputEvent evt)

Event handler for JoltOutputEvents. This method should not be called directly; it is always called by the JoltServiceBean.

Specified by:

serviceReturned in interface JoltOutputListener

Parameters:

evt - The event object.

itemStateChanged

public void itemStateChanged(java.awt.event.ItemEvent e)

The state of the JoltList changed; generate a JoltInputEvent and notify event listeners.

Specified by:

itemStateChanged in interface java.awt.event.ItemListener

Parameters:

e - The ItemEvent.

addJoltInputListener

public void addJoltInputListener(JoltInputListener l)

Registration method for JoltInput listeners.

Parameters:

l - The listener to be added.

removeJoltInputListener

public void removeJoltInputListener(JoltInputListener l)

This method is used to unregister JoltInput listeners.

Parameters:

l - The listener to be removed.

setOccurrenceIndex

public void setOccurrenceIndex(int occurrence)

Set the occurrence index of the field represented by this JoltList.

Parameters:

occurrence - The occurrence number.

getOccurrenceIndex

public int getOccurrenceIndex()

Get the occurrence index of the field represented by this JoltList.

Returns:

The occurrence index.

getJoltFieldName

public java.lang.String getJoltFieldName()

Get the Jolt field name corresponding to this JoltList.

Returns:

The Jolt field name.

setJoltFieldName

public void setJoltFieldName(java.lang.String name)

Set the Jolt field name corresponding to this JoltList.

Parameters:

name - The Jolt field name.

getItems

public java.lang.String[] getItems()

Get the selected items corresponding to this JoltList.

Returns:

The array of selected items.

setItems

public void setItems(java.lang.String[] values)

Set the selected items corresponding to this JoltList.