org.crosswire.jsword.passage
Class VerseFactory

java.lang.Object
  extended by org.crosswire.jsword.passage.VerseFactory

public final class VerseFactory
extends Object

A factory to create a Verse from user input.

Distribution Licence:
JSword is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License, version 2 as published by the Free Software Foundation.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
The License is available on the internet here, or by writing to: Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
The copyright to this program is held by it's authors.

Version:
$Id: VerseFactory.java,v 1.1 2004/08/25 22:54:37 joe Exp $
Author:
Joe Walker [joe at eireneh dot com]
See Also:
Licence

Constructor Summary
private VerseFactory()
          Prevent a VerseFactory from being created.
 
Method Summary
static Verse fromString(String original)
          Construct a Verse from a String - something like "Gen 1:1".
static Verse fromString(String original, VerseRange verseRangeBasis)
          Construct a Verse from a String and a VerseRange.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

VerseFactory

private VerseFactory()
Prevent a VerseFactory from being created.

Method Detail

fromString

public static Verse fromString(String original)
                        throws NoSuchVerseException
Construct a Verse from a String - something like "Gen 1:1". in case the user does not want to have their typing 'fixed' by a meddling patronizing computer. The following initial letters can not be matched at all - 'bfquvwx'.

Parameters:
original - The text string to be converteds
Returns:
the Verse representation of the string
Throws:
NoSuchVerseException - If the text can not be understood

fromString

public static Verse fromString(String original,
                               VerseRange verseRangeBasis)
                        throws NoSuchVerseException
Construct a Verse from a String and a VerseRange. For example given "2:2" and a basis of Gen 1:1 - 12 the result would be Gen 2:2

Parameters:
original - The string describing the verse e.g "2:2"
verseRangeBasis - The basis by which to understand the desc.
Returns:
the verse representation of the string
Throws:
NoSuchVerseException - If the reference is illegal

Copyright ? 2003-2004