org.fest.swing.keystroke
Class KeyStrokeMappingsParser

java.lang.Object
  extended by org.fest.swing.keystroke.KeyStrokeMappingsParser

public class KeyStrokeMappingsParser
extends Object

Understands creation of KeyStrokeMappings by parsing a text file.

Mappings for the following characters:

will be automatically added and should not be included to the file to parse.

The following is an example of a mapping file:

 a, A, NO_MASK
 A, A, SHIFT_MASK
 COMMA, COMMA, NO_MASK
 
Each line represents a character-keystroke mapping where each value is separated by a comma.

The first value represents the character to map. For example 'a' or 'A'. Since each field is separated by a comma, to map the ',' character we need to specify the text "COMMA."

The second value represents the key code, which should be the name of a key code from KeyEvent without the prefix "VK_". For example, if the key code is KeyEvent.VK_COMMA we just need to specify "COMMA".

The third value represents any modifiers to use, which should be the name of a modifier from InputEvent. For example, if the modifier to use is InputEvent.SHIFT_MASK we need to specify "SHIFT_MASK". If no modifiers are necessary, we just specify "NO_MASK".

Since:
1.2
Author:
Olivier DOREMIEUX, Alex Ruiz

Constructor Summary
KeyStrokeMappingsParser()
           
 
Method Summary
 KeyStrokeMappingProvider parse(File file)
          Creates a KeyStrokeMappingProvider containing all the character-keystroke mappings specified in the given file.
 KeyStrokeMappingProvider parse(String file)
          Creates a KeyStrokeMappingProvider containing all the character-keystroke mappings specified in the file with the given name.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

KeyStrokeMappingsParser

public KeyStrokeMappingsParser()
Method Detail

parse

public KeyStrokeMappingProvider parse(String file)
Creates a KeyStrokeMappingProvider containing all the character-keystroke mappings specified in the file with the given name.

Note: This attempts to read the file using ClassLoader.getResourceAsStream(String).

Parameters:
file - the name of the file to parse.
Returns:
the created KeyStrokeMappingProvider.
Throws:
NullPointerException - if the given name is null.
IllegalArgumentException - if the given name is empty.
ParsingException - if any error occurs during parsing.
See Also:
parse(File)

parse

public KeyStrokeMappingProvider parse(File file)
Creates a KeyStrokeMappingProvider containing all the character-keystroke mappings specified in the given file.

Parameters:
file - the file to parse.
Returns:
the created KeyStrokeMappingProvider.
Throws:
NullPointerException - if the given file is null.
IllegalArgumentException - if the given file does not represent an existing file.
ParsingException - if any error occurs during parsing.


Copyright © 2007-2011 FEST (Fixtures for Easy Software Testing). All Rights Reserved.