/*
 * SIP Communicator, the OpenSource Java VoIP and Instant Messaging client.
 *
 * Distributable under LGPL license.
 * See terms of license at gnu.org.
 */
package net.java.sip.communicator.service.keybindings;

import java.util.*;

import javax.swing.*;

/**
 * Wrapper for keybinding sets. Observers are notified when there's a change.
 * @author Damian Johnson
 */
public abstract class KeybindingSet
    extends Observable
{
    /**
     * Provides current keybinding mappings.
     * @return mapping of keystrokes to the string representation of the actions
     *         they perform
     */
    public abstract HashMap <KeyStroke, String> getBindings();
    
    /**
     * Resets the bindings and notifies the observer's listeners if they've
     * changed.
     * @param newBindings new keybindings to be held
     */
    public abstract void setBindings(Map <KeyStroke, String> newBindings);
    
    /**
     * Provides the portion of the UI to which the bindings belong.
     * @return binding category
     */
    public abstract Category getCategory();
    
    /**
     * Keybinding sets available in the Sip Communicator.
     */
    public enum Category
    {
        CHAT("keybindings-chat", Persistence.SERIAL_HASH),
        MAIN("keybindings-main", Persistence.SERIAL_HASH);
        
        private final String resource;
        private final Persistence persistenceFormat;
        
        Category(String resource, Persistence format)
        {
            this.resource = resource;
            this.persistenceFormat = format;
        }
        
        /**
         * Provides the name keybindings are saved and loaded with.
         * @return filename used for keybindings
         */
        public String getResource()
        {
            return this.resource;
        }
        
        /**
         * Provides the format used to save and load keybinding resources.
         * @return style of persistence used by keybindings
         */
        public Persistence getFormat()
        {
            return this.persistenceFormat;
        }
    }
}