com.ibm.as400.vaccess

Class SQLStatementMenuItem

  • All Implemented Interfaces:
    ImageObserver, ItemSelectable, MenuContainer, Serializable, Accessible, MenuElement, SwingConstants
    Deprecated. 
    Use Java Swing instead, along with the classes in package com.ibm.as400.access

    public class SQLStatementMenuItem
extends JMenuItem
implements Serializable
    The SQLStatementMenuItem class represents a menu item that issues a SQL statement when chosen.

    It is up to the user to register a JDBC driver when using this class. For example, the following code registers the IBM Toolbox for Java JDBC driver. 

       DriverManager.registerDriver (new com.ibm.as400.access.AS400JDBCDriver ());

    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.

    SQLStatementMenuItem objects generate the following events:

    • ActionCompletedEvent
    • ErrorEvent
    • PropertyChangeEvent
    • WorkingEvent
    See Also:
    Serialized Form

    • Constructor Detail

      • SQLStatementMenuItem

        public SQLStatementMenuItem()
        Deprecated. 
        Constructs a SQLStatementMenuItem object.

      • SQLStatementMenuItem

        public SQLStatementMenuItem(Icon icon)
        Deprecated. 
        Constructs a SQLStatementMenuItem object.
        Parameters:
        icon - The icon to be placed on the menu item.

      • SQLStatementMenuItem

        public SQLStatementMenuItem(String text)
        Deprecated. 
        Constructs a SQLStatementMenuItem object.
        Parameters:
        text - The text to be placed on the menu item.

      • SQLStatementMenuItem

        public SQLStatementMenuItem(String text,
                    Icon icon)
        Deprecated. 
        Constructs a SQLStatementMenuItem object.
        Parameters:
        text - The text to be placed on the menu item.
        icon - The icon to be placed on the menu item.

      • SQLStatementMenuItem

        public SQLStatementMenuItem(String text,
                    Icon icon,
                    SQLConnection connection,
                    String SQLStatement)
        Deprecated. 
        Constructs a SQLStatementMenuItem object.
        Parameters:
        text - The text to be placed on the menu item.
        icon - The icon to be placed on the menu item.
        connection - The SQL connection.
        SQLStatement - The SQL statement.

    • Method Detail

      • addActionCompletedListener

        public void addActionCompletedListener(ActionCompletedListener listener)
        Deprecated. 
        Adds a listener to be notified when a SQL statement is executed. The listener's actionCompleted() method will be called.
        Parameters:
        listener - The listener.

      • addErrorListener

        public void addErrorListener(ErrorListener listener)
        Deprecated. 
        Adds a listener to be notified when an error occurs. The listener's errorOccurred() method will be called.
        Parameters:
        listener - The listener.

      • addWorkingListener

        public void addWorkingListener(WorkingListener listener)
        Deprecated. 
        Adds a listener to be notified when work starts and stops on potentially long-running operations.
        Parameters:
        listener - The listener.

      • getConnection

        public SQLConnection getConnection()
        Deprecated. 
        Returns the SQL connection used to execute statements.
        Returns:
        The SQL connection.

      • getMoreResults

        public void getMoreResults()
        Deprecated. 
        Makes the next result of the last statement run the current result. Nothing is done if no statement has been executed.

        Refer to JDBC documentation for more information.

      • getResultSet

        public ResultSet getResultSet()
        Deprecated. 
        Returns the current results of the last SQL statement run. Multiple results can be obtained by calling getUpdateCount() and/or getResultSet() multiple times, with intervening getMoreResults() calls.

        Refer to JDBC documentation for more information.

        Returns:
        The result set or null if the result was not a result set, or if there are no results.

      • getSQLStatement

        public String getSQLStatement()
        Deprecated. 
        Returns the SQL statement that will be run when this menu item is chosen.
        Returns:
        The SQL statement that will be run when this menu item is chosen.

      • getUpdateCount

        public int getUpdateCount()
        Deprecated. 
        Returns the number of rows affected by the last SQL statement run. Multiple results can be obtained by calling getUpdateCount() and/or getResultSet() multiple times, with intervening getMoreResults() calls. If an error occurs, 0 is returned.

        Refer to JDBC documentation for more information.

        Returns:
        The number of rows that were affected. If no rows were affected or the SQL statement was a DDL command, 0 is returned. If there are no results or the results are a result set, -1 is returned.

      • getWarnings

        public SQLWarning getWarnings()
        Deprecated. 
        Returns the warnings generated by the JDBC connection and statement. Each time the menu item is selected (the SQL statement is run), the warnings are cleared. Connection warnings are only available after the first time a statement is executed. The warnings from the statement will be linked to the end of any connection warnings.
        Returns:
        The warnings generated by the connection and statement, or null if none.

      • removeActionCompletedListener

        public void removeActionCompletedListener(ActionCompletedListener listener)
        Deprecated. 
        Removes a listener from being notified when a SQL statement is issued.
        Parameters:
        listener - The listener.

      • removeErrorListener

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

      • removeWorkingListener

        public void removeWorkingListener(WorkingListener listener)
        Deprecated. 
        Removes a listener from being notified when work starts and stops on potentially long-running operations.
        Parameters:
        listener - The listener.

      • setConnection

        public void setConnection(SQLConnection connection)
                   throws PropertyVetoException
        Deprecated. 
        Sets the SQL connection used to execute statements. This property is bound and constrained.
        Parameters:
        connection - The SQL connection.
        Throws:
        PropertyVetoException - If the change is vetoed.

      • setSQLStatement

        public void setSQLStatement(String SQLStatement)
                     throws PropertyVetoException
        Deprecated. 
        Sets the SQL statement to run. This property is bound and constrained.
        Parameters:
        SQLStatement - The SQL statement.
        Throws:
        PropertyVetoException - If the change is vetoed.