Class ForNameStringParser


  • public class ForNameStringParser
    extends StringParser
    A StringParser that passes the argument to a static method of signature forName(String) of a specified class.

    Note that, for instance, this parser can be used with Class (resulting in a string parser identical to ClassStringParser), but also Charset, and more generally, any class using the forName(String) convention.

    Author:
    Sebastiano Vigna
    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      static ForNameStringParser getParser​(java.lang.Class klass)
      Returns a class forName() string parser.
      java.lang.Object parse​(java.lang.String arg)
      Parses the specified argument into an Object of the appropriate type.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Method Detail

      • getParser

        public static ForNameStringParser getParser​(java.lang.Class klass)
                                             throws java.lang.SecurityException,
                                                    java.lang.NoSuchMethodException
        Returns a class forName() string parser.

        When required to parse an argument, the returned string parser will return the object obtain by means of a call to a static method of klass of signature forName(String).

        Parameters:
        klass - a class with a static method of signature forName(String).
        Throws:
        java.lang.SecurityException
        java.lang.NoSuchMethodException
      • parse

        public java.lang.Object parse​(java.lang.String arg)
                               throws ParseException
        Description copied from class: StringParser
        Parses the specified argument into an Object of the appropriate type. If the specified argument cannot be converted into the desired Object, a ParseException should be thrown.

        Note: this method MAY BE CALLED with a null argument. Take this into consideration when subclassing!
        Specified by:
        parse in class StringParser
        Parameters:
        arg - the argument to convert to an Object of class appropriate to the StringParser subclass.
        Returns:
        the Object resulting from the parsed argument.
        Throws:
        ParseException - if the specified argument cannot be parsed.