Class JDK14RegexTranslator


  • public class JDK14RegexTranslator
    extends SurrogateRegexTranslator
    This class translates XML Schema regex syntax into JDK 1.4 regex syntax. Author: James Clark, Thai Open Source Software Center Ltd. See statement at end of file. Modified by Michael Kay (a) to integrate the code into Saxon, and (b) to support XPath additions to the XML Schema regex syntax.

    This version of the regular expression translator treats each half of a surrogate pair as a separate character, translating anything in an XPath regex that can match a non-BMP character into a Java regex that matches the two halves of a surrogate pair independently. This approach doesn't work under JDK 1.5, whose regex engine treats a surrogate pair as a single character.

    • Constructor Detail

      • JDK14RegexTranslator

        public JDK14RegexTranslator()
        Create a regex translator for JDK 1.4
    • Method Detail

      • setIgnoreWhitespace

        public void setIgnoreWhitespace​(boolean ignore)
        Indicate whether whitespace should be ignored
        Parameters:
        ignore - true if whitespace should be ignored
      • translate

        public java.lang.String translate​(java.lang.CharSequence regExp,
                                          int xmlVersion,
                                          boolean xpath)
                                   throws RegexSyntaxException
        Translates a regular expression in the syntax of XML Schemas Part 2 into a regular expression in the syntax of java.util.regex.Pattern. The translation assumes that the string to be matched against the regex uses surrogate pairs correctly. If the string comes from XML content, a conforming XML parser will automatically check this; if the string comes from elsewhere, it may be necessary to check surrogate usage before matching.
        Parameters:
        regExp - a String containing a regular expression in the syntax of XML Schemas Part 2
        xmlVersion - integer constant indicating XML 1.0 or XML 1.1
        xpath - a boolean indicating whether the XPath 2.0 F+O extensions to the schema regex syntax are permitted
        Returns:
        a String containing a regular expression in the syntax of java.util.regex.Pattern
        Throws:
        RegexSyntaxException - if regexp is not a regular expression in the syntax of XML Schemas Part 2, or XPath 2.0, as appropriate
        See Also:
        Pattern, XML Schema Part 2
      • main

        public static void main​(java.lang.String[] args)
                         throws RegexSyntaxException
        Diagnostic entry point
        Parameters:
        args - argument 1 - XPath regex; argument 2 - xpath|xmlschema
        Throws:
        RegexSyntaxException