com.ibm.as400.vaccess
Class RecordListTablePane

java.lang.Object
  extended byjava.awt.Component
      extended byjava.awt.Container
          extended byjavax.swing.JComponent
              extended bycom.ibm.as400.vaccess.RecordListTablePane
All Implemented Interfaces:
ImageObserver, MenuContainer, Serializable

Deprecated. Use Java Swing instead, along with the classes in package com.ibm.as400.access

public class RecordListTablePane
extends JComponent
implements Serializable

The RecordListTablePane class represents a table that contains the records and fields of a server file using record-level access.

The data in the table is retrieved from the system when load() is called. If load() is not called, the table will be empty.

Users must call close() to ensure that the server resources are properly freed when this table is no longer needed.

Most errors are reported by firing ErrorEvents, rather than throwing exceptions. Users should listen for ErrorEvents in order to diagnose and recover from error conditions.

The data in this table is not editable, the individual cell values cannot be changed.

RecordListTablePane objects generate the following events:

 // Set up table for file contents.
AS400 system = new AS400("MySystem", "Userid", "Password");
String file = "/QSYS.LIB/QGPL.LIB/MyFile.FILE";
final RecordListTablePane pane = new RecordListTablePane(system, file);

 // Set up window to hold table
JFrame frame = new JFrame ("My Window");
WindowListener l = new WindowAdapter()
{
     // Close the model when window is closed.
    public void windowClosing(WindowEvent e)
    {
        pane.close();
    }
};
frame.addWindowListener(l);

// Set up the error dialog adapter.
pane.addErrorListener (new ErrorDialogAdapter (frame));

// Add the component and get data from system.
frame.getContentPane().add(pane);
pane.load();

 // Display the window
frame.setVisible(true)

See Also:
Serialized Form

Nested Class Summary
 
Nested classes inherited from class javax.swing.JComponent
JComponent.AccessibleJComponent
 
Nested classes inherited from class java.awt.Container
Container.AccessibleAWTContainer
 
Nested classes inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy
 
Field Summary
static int KEY_EQ
          Deprecated. Constant indicating search type of equal.
static int KEY_GE
          Deprecated. Constant indicating search type of greater than or equal.
static int KEY_GT
          Deprecated. Constant indicating search type of greater than.
static int KEY_LE
          Deprecated. Constant indicating search type of less than or equal.
static int KEY_LT
          Deprecated. Constant indicating search type of less than.
 
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
RecordListTablePane()
          Deprecated. Constructs a RecordListTablePane object.
RecordListTablePane(AS400 system, String fileName)
          Deprecated. Constructs a RecordListTablePane object.
RecordListTablePane(AS400 system, String fileName, Object[] key, int searchType)
          Deprecated. Constructs a RecordListTablePane object.
 
Method Summary
 void addErrorListener(ErrorListener listener)
          Deprecated. Adds a listener to be notified when an error occurs.
 void addListSelectionListener(ListSelectionListener listener)
          Deprecated. Adds a listener to be notified when the selection changes.
 void addPropertyChangeListener(PropertyChangeListener listener)
          Deprecated. Adds a listener to be notified when the value of any bound property is changed.
 void addVetoableChangeListener(VetoableChangeListener listener)
          Deprecated. Adds a listener to be notified when the value of any constrained property is changed.
 void close()
          Deprecated. Closes the server file this table represents.
 TableColumnModel getColumnModel()
          Deprecated. Returns the column model for this table.
 String getColumnTitle(int columnIndex)
          Deprecated. Returns the title of a column.
 int getColumnWidth(int columnIndex)
          Deprecated. Returns the width of a column.
 RecordListTableModel getDataModel()
          Deprecated. Returns the data model for the table.
 String getFileName()
          Deprecated. Returns the file name.
 Color getGridColor()
          Deprecated. Returns the color used to draw grid lines.
 Object[] getKey()
          Deprecated. Returns the key.
 boolean getKeyed()
          Deprecated. Returns whether the file will be accessed in key or sequential order.
 int getSearchType()
          Deprecated. Returns the search type.
 ListSelectionModel getSelectionModel()
          Deprecated. Returns the ListSelectionModel that is used to maintain row selection state.
 boolean getShowHorizontalLines()
          Deprecated. Returns whether horizontal lines are drawn between rows.
 boolean getShowVerticalLines()
          Deprecated. Returns whether vertical lines are drawn between columns.
 String getStringValueAt(int rowIndex, int columnIndex)
          Deprecated. Returns the string value at the specifed row and column.
 AS400 getSystem()
          Deprecated. Returns the system where the file is located.
 Object getValueAt(int rowIndex, int columnIndex)
          Deprecated. Returns the value at the specifed row and column.
 void load()
          Deprecated. Loads the table based on the state of the system.
 void moveColumn(int columnIndex, int newIndex)
          Deprecated. Moves the column and heading at columnIndex to newIndex.
 void refreshHeadings()
          Deprecated. Updates the table header to match the data.
 void removeColumn(int columnIndex)
          Deprecated. Removes a column from the table.
 void removeErrorListener(ErrorListener listener)
          Deprecated. Removes a listener from being notified when an error occurs.
 void removeListSelectionListener(ListSelectionListener listener)
          Deprecated. Removes a listener from being notified when the selection changes.
 void removePropertyChangeListener(PropertyChangeListener listener)
          Deprecated. Removes a listener from being notified when the value of any bound property is changed.
 void removeVetoableChangeListener(VetoableChangeListener listener)
          Deprecated. Removes a listener from being notified when the value of any constrained property is changed.
 void setColumnTitle(int columnIndex, String title)
          Deprecated. Sets the title of a column.
 void setColumnWidth(int columnIndex, int width)
          Deprecated. Sets the width of a column.
 void setFileName(String fileName)
          Deprecated. Sets the name of the file.
 void setGridColor(Color color)
          Deprecated. Sets the color used to draw grid lines.
 void setKey(Object[] key)
          Deprecated. Sets the key.
 void setKeyed(boolean keyed)
          Deprecated. Sets whether the file will be accessed in key or sequential order.
 void setSearchType(int searchType)
          Deprecated. Sets the search type.
 void setSelectionModel(ListSelectionModel model)
          Deprecated. Sets the ListSelectionModel that is used to maintain row selection state.
 void setShowHorizontalLines(boolean show)
          Deprecated. Sets whether horizontal lines are drawn between rows.
 void setShowVerticalLines(boolean show)
          Deprecated. Sets whether vertical lines are drawn between columns.
 void setSystem(AS400 system)
          Deprecated. Sets the system where the file is located.
 
Methods inherited from class javax.swing.JComponent
addAncestorListener, addNotify, addPropertyChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getAccessibleContext, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getGraphics, getHeight, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getUIClassID, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isPreferredSizeSet, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, paramString, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removePropertyChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFont, setForeground, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update, updateUI
 
Methods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, addImpl, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setLayout, transferFocusBackward, transferFocusDownCycle, validate, validateTree
 
Methods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusUpCycle
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

KEY_EQ

public static final int KEY_EQ
Deprecated. 
Constant indicating search type of equal.

See Also:
Constant Field Values

KEY_GT

public static final int KEY_GT
Deprecated. 
Constant indicating search type of greater than.

See Also:
Constant Field Values

KEY_GE

public static final int KEY_GE
Deprecated. 
Constant indicating search type of greater than or equal.

See Also:
Constant Field Values

KEY_LT

public static final int KEY_LT
Deprecated. 
Constant indicating search type of less than.

See Also:
Constant Field Values

KEY_LE

public static final int KEY_LE
Deprecated. 
Constant indicating search type of less than or equal.

See Also:
Constant Field Values
Constructor Detail

RecordListTablePane

public RecordListTablePane()
Deprecated. 
Constructs a RecordListTablePane object. This constructor sets the keyed property to false.


RecordListTablePane

public RecordListTablePane(AS400 system,
                           String fileName)
Deprecated. 
Constructs a RecordListTablePane object. This constructor sets the keyed property to false.

Parameters:
system - The system where the file is located.
fileName - The file name. The name is specified as a fully qualified path name in the library file system.

RecordListTablePane

public RecordListTablePane(AS400 system,
                           String fileName,
                           Object[] key,
                           int searchType)
Deprecated. 
Constructs a RecordListTablePane object. This constructor sets the keyed property to true.

Parameters:
system - The system where the file is located.
fileName - The keyed file name. The name is specified as a fully qualified path name in the library file system.
key - The values which make up the key with which to find the record. This value may be null.
searchType - Constant indicating the type of match required.
Method Detail

addErrorListener

public void addErrorListener(ErrorListener listener)
Deprecated. 
Adds a listener to be notified when an error occurs.

Parameters:
listener - The listener.

addListSelectionListener

public void addListSelectionListener(ListSelectionListener listener)
Deprecated. 
Adds a listener to be notified when the selection changes.

Parameters:
listener - The listener.

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)
Deprecated. 
Adds a listener to be notified when the value of any bound property is changed.

Parameters:
listener - The listener.

addVetoableChangeListener

public void addVetoableChangeListener(VetoableChangeListener listener)
Deprecated. 
Adds a listener to be notified when the value of any constrained property is changed.

Parameters:
listener - The listener.

close

public void close()
Deprecated. 
Closes the server file this table represents.


getColumnModel

public TableColumnModel getColumnModel()
Deprecated. 
Returns the column model for this table.

Returns:
The model for this table's columns.

getColumnTitle

public String getColumnTitle(int columnIndex)
Deprecated. 
Returns the title of a column. This is used for the table column heading. If an error occurs, null is returned.

Parameters:
columnIndex - The index of the column. Indices start at 0.
Returns:
The title of the column.

getColumnWidth

public int getColumnWidth(int columnIndex)
Deprecated. 
Returns the width of a column. If an error occurs, 0 is returned.

Parameters:
columnIndex - The index of the column. Indices start at 0.
Returns:
The width of the column.

getDataModel

public RecordListTableModel getDataModel()
Deprecated. 
Returns the data model for the table.

Returns:
The data model for the table.

getFileName

public String getFileName()
Deprecated. 
Returns the file name. The name is formatted as a fully qualified path name in the library file system.

Returns:
The file name.

getGridColor

public Color getGridColor()
Deprecated. 
Returns the color used to draw grid lines.

Returns:
The color used to draw grid lines.

getKey

public Object[] getKey()
Deprecated. 
Returns the key. The key is only used if the keyed property is true.

Returns:
The key.

getKeyed

public boolean getKeyed()
Deprecated. 
Returns whether the file will be accessed in key or sequential order.

Returns:
true if the file will be accessed in key order; false if the file will be accessed in sequential order.

getSearchType

public int getSearchType()
Deprecated. 
Returns the search type. The search type is only used if the keyed property is true and the key property is not null.

Returns:
The search type.

getSelectionModel

public ListSelectionModel getSelectionModel()
Deprecated. 
Returns the ListSelectionModel that is used to maintain row selection state.

Returns:
The model that provides row selection state.

getShowHorizontalLines

public boolean getShowHorizontalLines()
Deprecated. 
Returns whether horizontal lines are drawn between rows.

Returns:
true if horizontal lines are to be drawn; false otherwise.

getShowVerticalLines

public boolean getShowVerticalLines()
Deprecated. 
Returns whether vertical lines are drawn between columns.

Returns:
true if vertical lines are to be drawn; false otherwise.

getSystem

public AS400 getSystem()
Deprecated. 
Returns the system where the file is located.

Returns:
The system where the file is located.

getStringValueAt

public String getStringValueAt(int rowIndex,
                               int columnIndex)
Deprecated. 
Returns the string value at the specifed row and column. Indices start at 0. If an error occurs, null is returned.

Parameters:
rowIndex - The row index.
columnIndex - The column index.
Returns:
The value at the specified row and column as a string.

getValueAt

public Object getValueAt(int rowIndex,
                         int columnIndex)
Deprecated. 
Returns the value at the specifed row and column. Indices start at 0. If an error occurs, null is returned.

Parameters:
rowIndex - The row index.
columnIndex - The column index.
Returns:
The value at the specified row and column.

load

public void load()
Deprecated. 
Loads the table based on the state of the system. The fileName and system properties must be set before this method is called. The table heading is reconstructed to ensure it matches the data, so any column customization will be lost.


moveColumn

public void moveColumn(int columnIndex,
                       int newIndex)
Deprecated. 
Moves the column and heading at columnIndex to newIndex. The old column at columnIndex will now be found at newIndex, the column that used to be at newIndex is shifted left or right to make room. Indices start at 0.

Parameters:
columnIndex - The index of column to be moved.
newIndex - The new index to move the column to.

refreshHeadings

public void refreshHeadings()
Deprecated. 
Updates the table header to match the data. Any column customization will be lost.


removeColumn

public void removeColumn(int columnIndex)
Deprecated. 
Removes a column from the table.

Parameters:
columnIndex - The index of column. Indices start at 0.

removeErrorListener

public void removeErrorListener(ErrorListener listener)
Deprecated. 
Removes a listener from being notified when an error occurs.

Parameters:
listener - The listener.

removeListSelectionListener

public void removeListSelectionListener(ListSelectionListener listener)
Deprecated. 
Removes a listener from being notified when the selection changes.

Parameters:
listener - The listener.

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)
Deprecated. 
Removes a listener from being notified when the value of any bound property is changed.

Parameters:
listener - The listener.

removeVetoableChangeListener

public void removeVetoableChangeListener(VetoableChangeListener listener)
Deprecated. 
Removes a listener from being notified when the value of any constrained property is changed.

Parameters:
listener - The listener.

setColumnTitle

public void setColumnTitle(int columnIndex,
                           String title)
Deprecated. 
Sets the title of a column. This is used for the table column heading.

Parameters:
columnIndex - The index of column. Indices start at 0.
title - The title of the column.

setColumnWidth

public void setColumnWidth(int columnIndex,
                           int width)
Deprecated. 
Sets the width of a column.

Parameters:
columnIndex - The index of column. Indices start at 0.
width - The column width.

setFileName

public void setFileName(String fileName)
                 throws PropertyVetoException
Deprecated. 
Sets the name of the file. This property is bound and constrained. Note that the data in the table will not change until a load() is done.

Parameters:
fileName - The file name. The name is specified as a fully qualified path name in the library file system.
Throws:
PropertyVetoException - If the change is vetoed.

setGridColor

public void setGridColor(Color color)
Deprecated. 
Sets the color used to draw grid lines.

Parameters:
color - The color used to draw the grid lines.

setKey

public void setKey(Object[] key)
            throws PropertyVetoException
Deprecated. 
Sets the key. This property is bound and constrained. Note that the data in the table will not change until a load() is done. The key is only used if the keyed property is true.

Parameters:
key - The values which make up the key with which to find the record. This value may be null.
Throws:
PropertyVetoException - If the change is vetoed.

setKeyed

public void setKeyed(boolean keyed)
              throws PropertyVetoException
Deprecated. 
Sets whether the file will be accessed in key or sequential order. This property is bound and constrained. Note that the data in the table will not change until a load() is done.

Parameters:
keyed - true if the file will be accessed in key order; false if the file will be accessed in sequential order.
Throws:
PropertyVetoException - If the change is vetoed.

setSearchType

public void setSearchType(int searchType)
                   throws PropertyVetoException
Deprecated. 
Sets the search type. This property is bound and constrained. Note that the data in the table will not change until a load() is done. The search type is only used if the keyed property is true and the key property is not null.

Parameters:
searchType - Constant indicating the type of match required.
Throws:
PropertyVetoException - If the change is vetoed.

setSelectionModel

public void setSelectionModel(ListSelectionModel model)
Deprecated. 
Sets the ListSelectionModel that is used to maintain row selection state.

Parameters:
model - The model that provides the row selection state.

setShowHorizontalLines

public void setShowHorizontalLines(boolean show)
Deprecated. 
Sets whether horizontal lines are drawn between rows.

Parameters:
show - true if horizontal lines are to be drawn; false otherwise.

setShowVerticalLines

public void setShowVerticalLines(boolean show)
Deprecated. 
Sets whether vertical lines are drawn between columns.

Parameters:
show - true if vertical lines are to be drawn; false otherwise.

setSystem

public void setSystem(AS400 system)
               throws PropertyVetoException
Deprecated. 
Sets the system where the file is located. This property is bound and constrained. Note that the data in the table will not change until a load() is done.

Parameters:
system - The system where the file is located.
Throws:
PropertyVetoException - If the change is vetoed.