Update the HomeScreen class to add the controls.

Double-click HomeScreen.java in the Package Explorer window, and then insert the following code above the try-catch statement that calls the getDataAccess method:

        // Add an edit field for entering new names
        _nameEditField = new EditField( "Name: ", "", 50, EditField.USE_ALL_WIDTH );
        add (_nameEditField );

        // Add an ObjectListField for displaying a list of names
        _nameListField = new ObjectListField();
        add( _nameListField );

        // Add a menu item
        addMenuItem(_addToListMenuItem);

Add class-level declarations for _nameEditField and _nameListField, and then define a MenuItem with a run method (empty for now). These declarations belong next to the declarations of _statusLabel and _da.

Insert the following code below the private DataAccess _da; statement:

    private EditField _nameEditField;
    private ObjectListField _nameListField;

    private MenuItem _addToListMenuItem = new MenuItem("Add", 1, 1){
        public void run() {
            // TODO
        }
    };

Add a new method to the DataAccess class that inserts a row into a table.

Double-click DataAccess.java in the Package Explorer window, and then insert the following code after the createDatabaseSchema method:

    public void insertName(String name){
        try {
            UUIDValue nameID = _conn.createUUIDValue();
            String sql = "INSERT INTO Names(ID, Name) VALUES(?, ?)";           
            PreparedStatement ps = _conn.prepareStatement(sql);
            ps.set(1, nameID);
            ps.set(2, name);
            ps.execute();
            _conn.commit();
            ps.close();
        }
        catch(ULjException uex) {
            Dialog.alert("ULjException: " + uex.toString());
        }
        catch( Exception ex ){
            Dialog.alert("Exception: " + ex.toString());
        }  
    }

Add a NameRow class to your project.

Update the NameRow class so that it can store a row in the Names table as an object.

Double-click NameRow.java in the Package Explorer window, and then replace the code with the following snippet:

class NameRow {
    
    public NameRow( String nameID, String name ) {  
        _nameID = nameID;
        _name = name;
    }
    
    public String getNameID(){
        return _nameID;
    }
    
    public String getName(){
        return _name;
    }
       
    public String toString(){
        return _name;
    }
    
    private String _nameID;
    private String _name;
    
}

The toString method is used by the ObjectListField control.

Add a new method to the DataAccess class that reads a row into a Vector of objects.

Double-click DataAccess.java in the Package Explorer window, and then insert the following code after the insertName method:

    public Vector getNameVector(){
        Vector nameVector = new Vector();
        try {
            String sql = "SELECT ID, Name FROM Names";
            PreparedStatement ps = _conn.prepareStatement(sql);
            ResultSet rs = ps.executeQuery();
            while (rs.next()) {
                String nameID = rs.getString(1);
                String name = rs.getString(2);
                NameRow nr = new NameRow(nameID, name);
                nameVector.addElement(nr);
            }
        }
        catch(ULjException uex) {
            Dialog.alert("ULjException: " + uex.toString());
        }
        catch(Exception ex) {
            Dialog.alert("Exception: " + ex.toString());
        }
        return nameVector;
    }

Add a new method to the HomeScreen class that refreshes the contents of the list displayed on the screen.

Double-click HomeScreen.java in the Package Explorer window, and then insert the following code after the _addToListMenuItem method:

    public void refreshNameList() {
        //Clear the list
        _nameListField.setSize(0);

        //Refill from the list of names
        Vector nameVector = _da.getNameVector();
        for( Enumeration e = nameVector.elements(); e.hasMoreElements(); ){
            NameRow nr = ( NameRow )e.nextElement();
            _nameListField.insert(0, nr);
        }
    }

Update the HomeScreen class so that it calls the refreshNameList method, ensuring that the list is filled when the application starts.

Insert the following code before the end of the HomeScreen constructor:

        // Fill the ObjectListField
        refreshNameList();

Add a new method to the HomeScreen class that adds a row to the list on the screen.

Insert the following code after the refreshNameList method:

    private void onAddToList(){
        String name = _nameEditField.getText();
        _da.insertName(name);
        this.refreshNameList();
        _nameEditField.setText("");
        _statusLabel.setText(name + " added to list");
    }

Update the run method in the HomeScreen class so that it calls the onAddToList method.

Replace the line of code that states \\ TODO with the following code snippet:

            onAddToList();

Click File » Save All.

Run the simulator to verify that the application compiles and runs.

In the Package Explorer window, click Application.java, and then click Run » Run As » BlackBerry Simulator.

The HelloBlackBerry project compiles and then the simulator window appears.

Ensure that the project compiles without errors by selecting the Problems tab in Eclipse.

From the simulator menu, click File » Load Java Program.

Browse to the \UltraLite\UltraLiteJ\BlackBerry4.2\ directory of your SQL Anywhere installation and open the UltraLiteJ12.cod file.

From the simulator menu, click Simulate » Set IT Policy.

The Set IT Policy window appears.

In the Policy field, click Allow Third Party Apps To Use Persistent Store » >>.

Click Set and then click Close.

Launch your application.

In the simulator window, navigate to Downloads and then run the HelloBlackBerry application.

A screen appears that displays the Hello BlackBerry title bar, the Status: Connected text, and a Name field.

At the name field, type John Smith.

Click *EMPTY* and then choose Add.

John Smith appears in the list, which indicates that the name entry was added to the Names table in the database.

Names are stored in the database as you add them. They are retrieved from the database and added to the list when you close and re-open the application.

Stop the simulation.

In the simulator window, click File » Exit.