Getting Further with Spring RCP

Adding Functionality to the Table

Let's now add a popup item to our table. Whenever the user right-clicks in the table, the popup item should appear. The starting point is to override "AbstractView.registerLocalCommandExecutors()", similar to how we did it in the section Adding Context Sensitivity, in "Getting Started with Spring RCP". Here we specify that we want to use our PropertiesExecutor to handle the Properties command. That executor returns a simple JOptionPane as a placeholder for code that we will add later.

Then we use the Spring RCP "CommandGroup" class and the Spring RCP "ValueModel" class to display the popup item within the table. One or more commands can be gathered up together into a "CommandGroup", which has several useful utility methods, such as "setPopupCommandGroup", for creating popups. A "ValueModel", on the other hand, is useful for ensuring that a command is only active when something is selected. We create a new "ListSingleSelectionGuard", which selects a list selection model that is held by the ValueModel. Then the related commands (which are the guarded objects) are either enabled or disabled. You will find that, if you don't set a ValueModel, the command will always be disabled.

It is this interaction, i.e., the fact that changes in the GUI are reflected in ValueModels (and the fact that the values of the ValueModels are committed back to the related form objects, once the values in the ValueModel change), that is called "data binding", in the context of Spring RCP.

So, replace the content of your current CustomerView with the following:

package simple;

import domain.CustomerDataStore;
import java.awt.BorderLayout;
import javax.swing.JComponent;
import javax.swing.JOptionPane;
import javax.swing.JPanel;
import javax.swing.JScrollPane;
import org.springframework.binding.value.ValueModel;
import org.springframework.richclient.application.PageComponentContext;
import org.springframework.richclient.application.support.AbstractView;
import org.springframework.richclient.command.ActionCommand;
import org.springframework.richclient.command.CommandGroup;
import org.springframework.richclient.command.GuardedActionCommandExecutor;
import org.springframework.richclient.command.support.AbstractActionCommandExecutor;
import org.springframework.richclient.command.support.GlobalCommandIds;
import org.springframework.richclient.list.ListSelectionValueModelAdapter;
import org.springframework.richclient.list.ListSingleSelectionGuard;

public class CustomerView extends AbstractView {

    private CustomerTable customerTable;
    private CustomerDataStore customerDataStore;

    private GuardedActionCommandExecutor propertiesExecutor = new PropertiesExecutor();

    protected CustomerDataStore getCustomerDataStore() {
        return customerDataStore;
    }

    public void setCustomerDataStore(CustomerDataStore customerDataStore) {
        this.customerDataStore = customerDataStore;
    }

    @Override
    protected void registerLocalCommandExecutors(PageComponentContext context) {
        context.register(GlobalCommandIds.PROPERTIES, propertiesExecutor);
    }

    @Override
    protected JComponent createControl() {
        
        customerTable = new customerTableFactory().createCustomerTable();
        JPanel view = new JPanel(new BorderLayout());
        JScrollPane sp = getComponentFactory().createScrollPane(customerTable.getControl());
        view.add(sp, BorderLayout.CENTER);
        return view;
        
    }

    private class customerTableFactory {

        public CustomerTable createCustomerTable() {

            CustomerTable customerTable = new CustomerTable(customerDataStore);

            CommandGroup popup = new CommandGroup();
            popup.add((ActionCommand) getWindowCommandManager().getCommand(GlobalCommandIds.PROPERTIES, ActionCommand.class));
            customerTable.setPopupCommandGroup(popup);

            ValueModel selectionHolder = new ListSelectionValueModelAdapter(customerTable.getSelectionModel());
            new ListSingleSelectionGuard(selectionHolder, propertiesExecutor);

            return customerTable;
            
        }
        
    }

    private class PropertiesExecutor extends AbstractActionCommandExecutor {

        @Override
        public void execute() {
            JOptionPane.showMessageDialog(null, "Placeholder for showing TitledPageApplicationDialog...");
        }
        
    }

}

Now when you right-click in the table, you should see your new popup item:

When you select the item, a JOptionPane appears, as a placeholder for the code you will add in the next section.

And now you might be wondering how to set a double-click event, so that the PropertiesExecutor will be invoked when the user double-clicks on the table. Here it is, simply add this to the createCustomerTable() method, somewhere between lines 56 and 63 above:

customerTable.setDoubleClickHandler(propertiesExecutor);

Then run the application again and double-click in the table and you will have the same result as when you right-clicked the table and then invoked the popup item.