How to use

normalize

method

in

org.crosswire.jsword.passage.PassageKeyFactory

/**
 * Convert the passageReference into a Passage. This is the recommended
 * form for understanding references in ThML and GBF.
 * 
 * @param v11n
 *            The Versification to which this Passage belongs.
 * @param passageReference
 *            A String containing the text for the Passage
 * @param basis
 *           The basis by which to interpret passageReference
 * @return a new Passage filled with the desired Verses
 * @throws NoSuchKeyException
 *             If the passageReference has anything that could not be understood as a Verse
 */
public Passage getKey(Versification v11n, String passageReference, Key basis) throws NoSuchKeyException {
  // since normalization is relatively expensive
  // don't try it unless it solves a problem.
  try {
    return defaultType.createPassage(v11n, passageReference, basis);
  } catch (NoSuchKeyException e) {
    try {
      return defaultType.createPassage(v11n, normalize(passageReference), basis);
    } catch (NoSuchKeyException ex) {
      // TODO(DM): Parser should allow valid osisRefs!
      return defaultType.createPassage(v11n, mungOsisRef(passageReference), basis);
    }
  }
}