javacc-7.0.4.src.main.resources.templates.TokenMgrError.template Maven / Gradle / Ivy

Go to download
/** Token Manager Error. */
${SUPPORT_CLASS_VISIBILITY_PUBLIC?public :}class ${LEGACY_EXCEPTION_HANDLING?TokenMgrError:TokenMgrException} extends ${LEGACY_EXCEPTION_HANDLING?Error:RuntimeException}
{

  /**
   * The version identifier for this Serializable class.
   * Increment only if the serialized form of the
   * class changes.
   */
  private static final long serialVersionUID = 1L;

  /*
   * Ordinals for various reasons why an Error of this type can be thrown.
   */

  /**
   * Lexical error occurred.
   */
  public static final int LEXICAL_ERROR = 0;

  /**
   * An attempt was made to create a second instance of a static token manager.
   */
  public static final int STATIC_LEXER_ERROR = 1;

  /**
   * Tried to change to an invalid lexical state.
   */
  public static final int INVALID_LEXICAL_STATE = 2;

  /**
   * Detected (and bailed out of) an infinite loop in the token manager.
   */
  public static final int LOOP_DETECTED = 3;

  /**
   * Indicates the reason why the exception is thrown. It will have
   * one of the above 4 values.
   */
  int errorCode;

  /**
   * Replaces unprintable characters by their escaped (or unicode escaped)
   * equivalents in the given string
   */
  protected static final String addEscapes(String str) {
    StringBuffer retval = new StringBuffer();
    char ch;
    for (int i = 0; i < str.length(); i++) {
      switch (str.charAt(i))
      {
        case '\b':
          retval.append("\\b");
          continue;
        case '\t':
          retval.append("\\t");
          continue;
        case '\n':
          retval.append("\\n");
          continue;
        case '\f':
          retval.append("\\f");
          continue;
        case '\r':
          retval.append("\\r");
          continue;
        case '\"':
          retval.append("\\\"");
          continue;
        case '\'':
          retval.append("\\\'");
          continue;
        case '\\':
          retval.append("\\\\");
          continue;
        default:
          if ((ch = str.charAt(i)) < 0x20 || ch > 0x7e) {
            String s = "0000" + Integer.toString(ch, 16);
            retval.append("\\u" + s.substring(s.length() - 4, s.length()));
          } else {
            retval.append(ch);
          }
          continue;
      }
    }
    return retval.toString();
  }

  /**
   * Returns a detailed message for the Error when it is thrown by the
   * token manager to indicate a lexical error.
   * Parameters :
   *    EOFSeen     : indicates if EOF caused the lexical error
   *    curLexState : lexical state in which this error occurred
   *    errorLine   : line number when the error occurred
   *    errorColumn : column number when the error occurred
   *    errorAfter  : prefix that was seen before this error occurred
   *    curchar     : the offending character
   * Note: You can customize the lexical error message by modifying this method.
   */
  protected static String LexicalErr(boolean EOFSeen, int lexState, int errorLine, int errorColumn, String errorAfter, int curChar) {
    char curChar1 = (char)curChar;
    return("Lexical error at line " +
          errorLine + ", column " +
          errorColumn + ".  Encountered: " +
          (EOFSeen ? " " : ("\"" + addEscapes(String.valueOf(curChar1)) + "\"") + " (" + curChar + "), ") +
          "after : \"" + addEscapes(errorAfter) + "\"");
  }

  /**
   * You can also modify the body of this method to customize your error messages.
   * For example, cases like LOOP_DETECTED and INVALID_LEXICAL_STATE are not
   * of end-users concern, so you can return something like :
   *
   *     "Internal Error : Please file a bug report .... "
   *
   * from this method for such cases in the release version of your parser.
   */
  @Override
  public String getMessage() {
    return super.getMessage();
  }

  private final boolean structured;

  private final boolean eofSeen;
  private final int lexState;
  private final int errorLine;
  private final int errorColumn;
  private final String errorAfter;
  private final int curChar;

  public boolean isStructured() {
    return structured;
  }

  private void ensureStructured() {
    if (!isStructured()) {
      throw new UnsupportedOperationException("the TokenMgrError is not structured");
    }
  }

  public boolean isEofSeen() {
    ensureStructured();
    return eofSeen;
  }

  public int getLexState() {
    ensureStructured();
    return lexState;
  }

  public int getErrorLine() {
    ensureStructured();
    return errorLine;
  }

  public int getErrorColumn() {
    ensureStructured();
    return errorColumn;
  }

  public String getErrorAfter() {
    ensureStructured();
    return errorAfter;
  }

  public int getCurChar() {
    ensureStructured();
    return curChar;
  }

  /*
   * Constructors of various flavors follow.
   */

  /** No arg constructor. */
  public ${LEGACY_EXCEPTION_HANDLING?TokenMgrError:TokenMgrException}() {
    structured = false;
    eofSeen = false;
    this.lexState = -1;
    this.errorLine = -1;
    this.errorColumn = -1;
    this.errorAfter = null;
    this.curChar = -1;
  }

  /** Constructor with message and reason. */
  public ${LEGACY_EXCEPTION_HANDLING?TokenMgrError:TokenMgrException}(String message, int reason) {
    super(message);
    structured = false;
    errorCode = reason;
    eofSeen = false;
    this.lexState = -1;
    this.errorLine = -1;
    this.errorColumn = -1;
    this.errorAfter = null;
    this.curChar = -1;
  }

  /** Full Constructor. */
  public ${LEGACY_EXCEPTION_HANDLING?TokenMgrError:TokenMgrException}(boolean EOFSeen, int lexState, int errorLine, int errorColumn, String errorAfter, int curChar, int reason) {
    super(LexicalErr(EOFSeen, lexState, errorLine, errorColumn, errorAfter, curChar));
    structured = true;
    errorCode = reason;
    eofSeen = EOFSeen;
    this.lexState = lexState;
    this.errorLine = errorLine;
    this.errorColumn = errorColumn;
    this.errorAfter = errorAfter;
    this.curChar = curChar;
  }
}