* * This example handles selection changes with a custom ListSelectionListener, * the AlbumSelectionHandler, that sets the JList's selected values as new * bean of the details PresentationModel. A simpler means to achieve the same * effect is demonstrated by the MasterDetailsSelectionInListExample that uses * the SelectionInList as bean channel for the details PresentationModel.
* * Another variant of this example is the MasterDetailsCopyingExample * that copies the details data on list selection changes, instead of binding * the details UI components to the details PresentationModel's ValueModels. * * @author Karsten Lentzsch * @version $Revision: 1.6 $ * * @see com.jgoodies.binding.PresentationModel * @see com.jgoodies.binding.tutorial.basics.MasterDetailsCopyingExample * @see com.jgoodies.binding.tutorial.basics.MasterDetailsSelectionInListExample */ public class MasterDetailsBoundExample { /** * The Albums displayed in the master list. */ private final List albums; /** * 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 (Bound)"); frame.setDefaultCloseOperation(WindowConstants.EXIT_ON_CLOSE); JComponent panel = new MasterDetailsBoundExample().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 MasterDetailsBoundExample() { this(Album.ALBUMS); } /** * Constructs a list editor for editing the given list of Albums. * * @param albums the list of Albums to edit */ public MasterDetailsBoundExample(List albums) { this.albums = albums; detailsModel = new PresentationModel(new ValueHolder(null)); } // Component Creation and Initialization ********************************** /** * Creates, binds, and configures the UI components. * All components in the details view are read-only.
* * The coding style used here is based on standard Swing components. * Therefore we can create and bind the components in one step. * And that's the purpose of the BasicComponentFactory class.
* * If you need to bind custom components, for example MyTextField, * MyCheckBox, MyComboBox, you can use the more basic Bindings class. * The code would then read:
* titleField = new MyTextField(); * Bindings.bind(titleField, * detailsModel.getModel(Album.PROPERTYNAME_TITLE)); *
* * I strongly recommend to use either the BasicComponentFactory or * the Bindings class. These classes hide details of the binding. * So you better not write the following code:
* titleField = new JTextField(); * titleField.setDocument(new DocumentAdapter( * detailsModel.getModel(Album.PROPERTYNAME_TITLE))); **/ private void initComponents() { albumsList = new JList(albums.toArray()); albumsList.setSelectionMode(ListSelectionModel.SINGLE_SELECTION); albumsList.setCellRenderer(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()); } private void initEventHandling() { albumsList.addListSelectionListener(new AlbumSelectionHandler()); } // Building *************************************************************** /** * Builds and returns a panel that consists of * a master list and a details form. * * @return the built panel */ public JComponent build() { initComponents(); initEventHandling(); 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); } // Event Handling ******************************************************** private class AlbumSelectionHandler implements ListSelectionListener { public void valueChanged(ListSelectionEvent e) { if (e.getValueIsAdjusting()) return; detailsModel.setBean(albumsList.getSelectedValue()); } } } binding.zip( 506 k)