* * This example does not require a custom ListSelectionListener to handle * selection changes in the list of Albums. Instead it uses the SelectionInList * as bean channel for the details PresentationModel. And so, whenever the * SelectionInList's selection changes, the details PresentationModel will * automatically update the bean used to display the details.
* * In contrast, the MasterDetailsBoundExample uses a ListSelectionListener * to handle selection changes in the Album list. This listener then sets * the current selection as the details PresentationModel's new bean.
* * Another variant of this example is the MasterDetailsDelayedReadExample * that deferres selection changes for a specified delay. This can be useful * if bean changes in the details PresentationModel require time consuming * additional operations, for example a database lookup, a heavy computation, * or a remote access. * * @author Karsten Lentzsch * @version $Revision: 1.7 $ * * @see com.jgoodies.binding.PresentationModel * @see com.jgoodies.binding.tutorial.basics.MasterDetailsBoundExample * @see com.jgoodies.binding.tutorial.extras.MasterDetailsDelayedReadExample */ public class MasterDetailsSelectionInListExample { /** * Holds the list of Albums plus a single selection. */ private final SelectionInList albumSelection; /** * Holds the edited Album and vends ValueModels that adapt Album properties. */ private final PresentationModel detailsModel; private JList albumsList; private JTextComponent titleField; private JTextComponent artistField; private JTextComponent classicalField; private JTextComponent composerField; private JButton closeButton; // Launching ************************************************************** public static void main(String[] args) { try { UIManager.setLookAndFeel("com.jgoodies.looks.plastic.PlasticXPLookAndFeel"); } catch (Exception e) { // Likely PlasticXP is not in the class path; ignore. } JFrame frame = new JFrame(); frame.setTitle("Binding Tutorial :: Master/Details (SelectionInList)"); frame.setDefaultCloseOperation(WindowConstants.EXIT_ON_CLOSE); JComponent panel = new MasterDetailsSelectionInListExample().build(); frame.getContentPane().add(panel); frame.pack(); TutorialUtils.locateOnScreenCenter(frame); frame.setVisible(true); } // Instance Creation ****************************************************** /** * Constructs a list editor using a example Album list. */ public MasterDetailsSelectionInListExample() { this(Album.ALBUMS); } /** * Constructs a list editor for editing the given list of Albums. * * @param albums the list of Albums to edit */ public MasterDetailsSelectionInListExample(List albums) { this.albumSelection = new SelectionInList(albums); // The PresentationModel uses the SelectionInList as bean channel. // In other words, the list's selection is the adapter's bean. detailsModel = new PresentationModel(albumSelection); // Another way to write the above is: // detailsModel = new PresentationModel(albumSelection.getSelectionHolder(), true); } // Component Creation and Initialization ********************************** /** * Creates and intializes the UI components. */ private void initComponents() { albumsList = BasicComponentFactory.createList( albumSelection, TutorialUtils.createAlbumListCellRenderer()); titleField = BasicComponentFactory.createTextField( detailsModel.getModel(Album.PROPERTYNAME_TITLE)); titleField.setEditable(false); artistField = BasicComponentFactory.createTextField( detailsModel.getModel(Album.PROPERTYNAME_ARTIST)); artistField.setEditable(false); classicalField = BasicComponentFactory.createTextField( ConverterFactory.createBooleanToStringConverter( detailsModel.getModel(Album.PROPERTYNAME_CLASSICAL), "Yes", "No")); classicalField.setEditable(false); composerField = BasicComponentFactory.createTextField( detailsModel.getModel(Album.PROPERTYNAME_COMPOSER)); composerField.setEditable(false); closeButton = new JButton(TutorialUtils.getCloseAction()); } // Building *************************************************************** /** * Builds and returns a panel that consists of * a master list and a details form. * * @return the built panel */ public JComponent build() { initComponents(); FormLayout layout = new FormLayout( "right:pref, 3dlu, 150dlu:grow", "p, 1dlu, p, 9dlu, p, 1dlu, p, 3dlu, p, 3dlu, p, 3dlu, p, 9dlu, p"); PanelBuilder builder = new PanelBuilder(layout); builder.setDefaultDialogBorder(); CellConstraints cc = new CellConstraints(); builder.addSeparator("Albums", cc.xyw(1, 1, 3)); builder.add(new JScrollPane( albumsList), cc.xy (3, 3)); builder.addSeparator("Details", cc.xyw(1, 5, 3)); builder.addLabel("Title", cc.xy (1, 7)); builder.add(titleField, cc.xy (3, 7)); builder.addLabel("Artist", cc.xy (1, 9)); builder.add(artistField, cc.xy (3, 9)); builder.addLabel("Classical", cc.xy (1, 11)); builder.add(classicalField, cc.xy (3, 11)); builder.addLabel("Composer", cc.xy (1, 13)); builder.add(composerField, cc.xy (3, 13)); builder.add(buildButtonBar(), cc.xyw(1, 15, 3)); return builder.getPanel(); } private JComponent buildButtonBar() { return ButtonBarFactory.buildRightAlignedBar(closeButton); } } binding.zip( 506 k)