Logo Search packages:      
Sourcecode: libjgoodies-binding-java version File versions

AlbumManagerModel.java

/*
 * Copyright (c) 2002-2007 JGoodies Karsten Lentzsch. All Rights Reserved.
 *
 * Redistribution and use in source and binary forms, with or without 
 * modification, are permitted provided that the following conditions are met:
 * 
 *  o Redistributions of source code must retain the above copyright notice, 
 *    this list of conditions and the following disclaimer. 
 *     
 *  o Redistributions in binary form must reproduce the above copyright notice, 
 *    this list of conditions and the following disclaimer in the documentation 
 *    and/or other materials provided with the distribution. 
 *     
 *  o Neither the name of JGoodies Karsten Lentzsch nor the names of 
 *    its contributors may be used to endorse or promote products derived 
 *    from this software without specific prior written permission. 
 *     
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, 
 * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 
 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR 
 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 
 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 
 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; 
 * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 
 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE 
 * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, 
 * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 
 */

package com.jgoodies.binding.tutorial.manager;

import java.awt.event.ActionEvent;
import java.awt.event.MouseAdapter;
import java.awt.event.MouseEvent;
import java.awt.event.MouseListener;
import java.beans.PropertyChangeEvent;
import java.beans.PropertyChangeListener;

import javax.swing.AbstractAction;
import javax.swing.Action;
import javax.swing.SwingUtilities;

import com.jgoodies.binding.list.SelectionInList;
import com.jgoodies.binding.list.SelectionInListModel;
import com.jgoodies.binding.tutorial.Album;

/**
 * Provides the models and Actions for managing and editing Albums.
 * Works with an underlying AlbumManager that provides a ListModel
 * for the Albums and operations to add, remove, and change a Album.
 * In other words, this class turns the raw data and operations
 * form the AlbumManager into a form usable in a user interface.<p>
 * 
 * This model keeps the Albums in a SelectionInList, refers to another
 * PresentationModel for editing the selected Album, and provides 
 * Actions for the Album operations: add, remove and edit the selected Album.
 * 
 * @author  Karsten Lentzsch
 * @version $Revision: 1.11 $
 * 
 * @see AlbumManager
 * @see com.jgoodies.binding.PresentationModel
 */

00066 public final class AlbumManagerModel {
    
    /**
     * Holds the List of Albums and provides operations 
     * to create, add, remove and change a Album.
     */
00072     private final AlbumManager albumManager;
    
    /**
     * Holds the list of managed albums plus a single selection.
     */
00077     private SelectionInListModel albumSelection;

    private Action newAction;
    private Action editAction;
    private Action deleteAction;


    // Instance Creation ******************************************************
    
    /**
     * Constructs an AlbumManager for editing the given list of Albums.
     * 
     * @param albumManager   the list of albums to edit
     */
00091     public AlbumManagerModel(AlbumManager albumManager) {
        this.albumManager = albumManager;
        initModels();
        initEventHandling();
    }
    
    
    /**
     * Initializes the SelectionInList and Action.
     * In this case we eagerly initialize the Actions. 
     * As an alternative you can create the Actions lazily 
     * in the Action getter methods. To synchronize the Action enablement 
     * with the selection state, we update the enablement now. 
     */
00105     private void initModels() {
        albumSelection = new SelectionInListModel(albumManager.getManagedAlbums());
        
        newAction = new NewAction();
        editAction = new EditAction();
        deleteAction = new DeleteAction();
        updateActionEnablement();
    }
    
    
    /**
     * Initializes the event handling by just registering a
     * handler that updates the Action enablement if the
     * albumSelection's 'selectionEmpty' property changes.
     */
00120     private void initEventHandling() {
        albumSelection.addPropertyChangeListener(
                SelectionInList.PROPERTYNAME_SELECTION_EMPTY,
                new SelectionEmptyHandler());
    }
    
    
    // Exposing Models and Actions ********************************************
    
    /**
     * Returns the List of Albums with the current selection.
     * Useful to display the managed Albums in a JList or JTable.
     * 
     * @return the List of Albums with selection
     */
00135     public SelectionInListModel getAlbumSelection() {
        return albumSelection;
    }
    
    
    /**
     * Returns the Action that creates a new Album and adds it 
     * to this model's List of managed Albums. Opens a AlbumEditorDialog
     * on the newly created Album.
     *  
     * @return the Action that creates and adds a new Album
     */
00147     public Action getNewAction() {
        return newAction;
    }
    
    
    /**
     * Returns the Action that opens a AlbumEditorDialog on the selected Album.
     * 
     * @return the Action that opens a AlbumEditorDialog on the selected Album
     */
00157     public Action getEditAction() {
        return editAction;
    }
    
    
    /**
     * Returns the Action that deletes the selected Album from
     * this model's List of managed albums.
     * 
     * @return The Action that deletes the selected Album
     */
00168     public Action getDeleteAction() {
        return deleteAction;
    }
    
    
    /**
     * Returns a MouseListener that selects and edits a Album on double-click.
     * 
     * @return a MouseListener that selects and edits a Album on double-click.
     */
00178     public MouseListener getDoubleClickHandler() {
        return new DoubleClickHandler();
    }
    
    
    // Action Operations ******************************************************
    // For every Action we provide a method that is performed for this Action.
    // This makes it easier to overview this class.
    
    private void doNew() {
        Object newAlbum = createAndAddItem();
        getAlbumSelection().setSelection(newAlbum);
    }
    
    
    /**
     * Edits the selected item and marks it as changed, 
     * if the editor dialog has not been canceled.
     */
00197     private void doEdit() {
        editSelectedItem();
    }
    
    
    /**
     * Lets the AlbumManager removes the selected Album from the list of Albums.
     * The AlbumManager fires the list data change event. If the AlbumManager
     * wouldn't fire this event, we could use 
     * {@link SelectionInList#fireIntervalRemoved(int, int)}.
     */
00208     private void doDelete() {
        albumManager.removeItem(getSelectedItem());
    }
    
    
    // Managing Albums ********************************************************
    
    /**
     * Lets the AlbumManager add the given Album to the list of Albums.
     * The AlbumManager fires the list data change event. If the AlbumManager
     * won't fire this event, we could use 
     * {@link SelectionInList#fireIntervalAdded(int, int)}.
     */
00221     private void addItem(Album albumToAdd) {
        albumManager.addItem(albumToAdd);
    }
    
    /**
     * Opens a AlbumEditorDialog for the given Album.
     * 
     * @param album  the Album to be edited
     * @return true if the dialog has been canceled, false if accepted
     */
00231     private boolean openAlbumEditor(Album album) {
        AlbumEditorDialog dialog = new AlbumEditorDialog(null, album);
        dialog.open();
        return dialog.hasBeenCanceled();
    }
    
    private Album createAndAddItem() {
        Album newAlbum = albumManager.createItem();
        boolean canceled = openAlbumEditor(newAlbum);
        if (!canceled) {
            addItem(newAlbum);
            return newAlbum;
        }
        return null;
    }
    
    /**
     * Edits the selected item. If the editor dialog has not been canceled,
     * the presentations is notified that the contents has changed.<p>
     * 
     * This implementation fires the contents change event using
     * {@link SelectionInList#fireSelectedContentsChanged()}.
     * Since the album SelectionInList contains a ListModel, 
     * the <code>albumSelection</code> managed by the AlbumManager,
     * the AlbumManager could fire that event. However, I favored to fire
     * the contents change in the SelectionInList because this approach
     * works with underlying Lists, ListModels, and managers that don't
     * fire contents changes.
     */
00260     private void editSelectedItem() {
        boolean canceled = openAlbumEditor(getSelectedItem());
        if (!canceled) {
            getAlbumSelection().fireSelectedContentsChanged();
        }
    }
    
    
    private Album getSelectedItem() {
        return (Album) getAlbumSelection().getSelection();
    }
    

    // Actions ****************************************************************
    
    private final class NewAction extends AbstractAction {
        
        private NewAction() {
            super("New\u2026");
        }
        
        public void actionPerformed(ActionEvent e) {
            doNew();
        }
    }

        
    private final class EditAction extends AbstractAction {
        
        private EditAction() {
            super("Edit\u2026");
        }
        
        public void actionPerformed(ActionEvent e) {
            doEdit();
        }
    }

        
    private final class DeleteAction extends AbstractAction {
        
        private DeleteAction() {
            super("Delete");
        }
        
        public void actionPerformed(ActionEvent e) {
            doDelete();
        }
    }

      
    // Event Handling *********************************************************
    
    /**
     * A mouse listener that edits the selected item on double click.
     */
00316     private final class DoubleClickHandler extends MouseAdapter {
        public void mouseClicked(MouseEvent e) {
            if (SwingUtilities.isLeftMouseButton(e) && e.getClickCount() == 2)
                editSelectedItem();
        }
    }
    
    
    private void updateActionEnablement() {
        boolean hasSelection = getAlbumSelection().hasSelection();
        getEditAction().setEnabled(hasSelection);
        getDeleteAction().setEnabled(hasSelection);
    }
    
    
    /**
     * Enables or disables this model's Actions when it is notified
     * about a change in the <em>selectionEmpty</em> property
     * of the SelectionInList.
     */
00336     private final class SelectionEmptyHandler implements PropertyChangeListener {

        public void propertyChange(PropertyChangeEvent evt) {
            updateActionEnablement();
        }
    }
    
}

Generated by  Doxygen 1.6.0   Back to index