* * This class builds a JList of Albums with an attached details panel * that presents the current Album selection. The details panel's components * are bound to the domain using ValueModels returned by a PresentationModel. * The master JList is bound to a SelectionInList that holds the list of Albums * and the currently selected Album. The SelectionInList is used 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.
* * This example implements the deferred details update by using a delayed * version of the SelectionInList as the presentation model's bean channel. * Changes in the SelectionInList's selecion are held back for a specified delay * before the selection becomes the presentation model's new bean. * * @author Karsten Lentzsch * @version $Revision: 1.3 $ * * @see #initComponents() * @see DelayedReadValueModel * @see com.jgoodies.binding.PresentationModel * @see com.jgoodies.binding.tutorial.basics.MasterDetailsSelectionInListExample */ public class MasterDetailsDelayedReadExample { /** * The default in milliseconds to wait before a selection change * shall be forwarded to the delayed details presentation model. */ private static final int DEFAULT_DELAY = 1000; /** * Holds the list of Albums plus a single selection. */ private final SelectionInList albumSelection; /** * Holds the selected 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 (Delayed)"); frame.setDefaultCloseOperation(WindowConstants.EXIT_ON_CLOSE); JComponent panel = new MasterDetailsDelayedReadExample().build(); frame.getContentPane().add(panel); frame.pack(); TutorialUtils.locateOnScreenCenter(frame); frame.setVisible(true); } // Instance Creation ****************************************************** /** * Constructs a delayed list editor using an example Album list * and the default delay. */ public MasterDetailsDelayedReadExample() { this(Album.ALBUMS); } /** * Constructs a delayed list editor for editing the given list of Albums * using the default delay. * * @param albums the list of Albums to edit */ public MasterDetailsDelayedReadExample(List albums) { this(albums, DEFAULT_DELAY); } /** * Constructs a list editor for editing the given list of Albums * using the specified delay. * * @param albums the list of Albums to edit * @param delay the milliseconds to wait before the album selection * is forwarded to the SelectionInList */ public MasterDetailsDelayedReadExample(List albums, int delay) { this.albumSelection = new SelectionInList(albums); // Uses the delayed SelectionInList as PresentationModel's bean channel. // The SelectionInList is wrapped so that selection updates will be // deferred for the specified delay. In other words, the list's // selection becomes the Presentation Model's new bean - after a delay. detailsModel = new PresentationModel( new DelayedReadValueModel(albumSelection, delay)); } // Component Creation and Initialization ********************************** /** * Creates and intializes the UI components. The JList used to present * the Album list is bound directly to the SelectionInList which * implements the required ListModel interface. Even the JList's * selection model is bound directly bound the the SelectionInList's * selection index holder. It's just that the presentation model's * bean channel is not the selection, but a delayed selection.
* * If the user selects an element in the Album JList, the selection model * changes immediately. It's just that the bean of the detailsModel will * be set a bit later, which in turn holds back details change a bit. * See the constructor to study how the master SelectionInList is wrapped * by a DelayedReadValueModel to hold back selection changes for a limited * amount of time. */ 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("Delayed 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)