BNF for VRML97RelaxedParser.jj

//---------------------------------------------------------------------------
//  TOKENS declaration
//---------------------------------------------------------------------------

<*> SKIP : {
" "
| "\t"
| "\n"
| "\r"
| "\f"
| ","
}

   

<*> SPECIAL : {
<COMMENT: "#" (~["\n","\r"])* ("\n" | "\r" | "\r\n")>
}

   

<DEFAULT> TOKEN : {
<NUMBER_LITERAL: (["-","+"])? (".")? ["0"-"9"] (["0"-"9","a"-"f","A"-"F","x",".","+","-"])*>
| <STRING_LITERAL: "\"" (~["\"","\\"] | "\\" (["n","t","b","r","f","\\","\'","\""] | ["0"-"7"] (["0"-"7"])? | ["0"-"3"] ["0"-"7"] ["0"-"7"]))* "\"">
}

   

<DEFAULT> TOKEN : {
<LBRACE: "{">
| <RBRACE: "}">
| <LBRACKET: "[">
| <RBRACKET: "]">
}

   

<DEFAULT> TOKEN : {
<DEF: "DEF">
| <USE: "USE">
| <NULL: "NULL">
| <PROTO: "PROTO">
| <EVENTIN: "eventIn">
| <EVENTOUT: "eventOut">
| <FIELD: "field">
| <EXPOSEDFIELD: "exposedField">
| <EXTERNPROTO: "EXTERNPROTO">
| <ROUTE: "ROUTE">
| <TO: "TO">
| <IS: "IS">
| <DOT: ".">
}

   

<DEFAULT> TOKEN : {
<SCRIPT: "Script">
| <TRUE: "TRUE">
| <FALSE: "FALSE">
}

   

<DEFAULT> TOKEN : {
<ID: <ID_FIRST> (<ID_REST>)*> : DEFAULT
| <#ID_FIRST: ["!","$"-"&","("-"*","/",":"-"Z","^"-"z","\u0080"-"\ufaff"]>
| <#ID_REST: ["!","$"-"&","("-"+","-","/"-"Z","^"-"z","|","~","\u0080"-"\ufaff"]>
}

   

// Grammar follows the structure in the ISO spec, except that TOKENS are
// at the bottom. Where we have a rule of the form
// statements ::= statement | statement statements
// this is translated to a single (statement())* expression.
// The empty declaration is handled implicitly by JavaCC

//---------------------------------------------------------------------------
//  Grammar from A.2 General
//---------------------------------------------------------------------------


/**
 * Rule 0 - Parse the complete scene.
 * 
 * vrmlScene ::=
 *     statement* ;
 * 
 * The scene assumes that the caller will make the startDocument() and
 * endDocument() calls on the ContentHandler before and after this method.
 */

/**
 * Rule 1 - Parse a statement.
 * 
 * statement ::=
 *     nodeStatement |
 *     protoStatement |
 *     routeStatement ;
 * 
 */

/**
 * Rule 2 - Parse a node statement.
 * 
 * nodeStatement ::=
 *     node |
 *     DEF NodeNameId node |
 *     USE NodeNameId ;
 * 
 */

/**
 * Rule 3 - Parse a node statement.
 * 
 * rootNodeStatement ::=
 *      node |
 *      DEF NodeNameId node ;
 * 
 */

/**
 * Rule 2 - Parse a node statement.
 * 
 * protoStatement ::=
 *      proto |
 *      externproto ;
 * 
 */

/**
 * Rule 4 - Parse a PROTO declaration.
 * 
 * proto ::=
 *      PROTO NodeTypeId [ interfaceDeclaration* ] { protoBody } ;
 * 
 */

/**
 * Rule 5 - Parse a node statement.
 * 
 * protoBody ::=
 *      protoStatement* rootNodeStatement statement* ;
 * 
 */

/**
 * Rule 6 - Parse an interface declaration that allows everything except
 * exposedFields.
 * 
 * restrictedInterfaceDeclaration ::=
 *      eventIn fieldNameId eventId |
 *      eventOut fieldNameId eventId |
 *      field fieldNameId eventId fieldValue ;
 * 
 *  Unfortunately we also need some context information here to know if we are in
 *  A script or a proto to know which handler to call.
 */

/**
 * Rule 7 - Parse a single field interface declaration.
 * 
 * interfaceDeclaration ::=
 *      restrictedInterfaceDeclaration |
 *      exposedField fieldNameId eventId fieldValue ;
 * 
 */

/**
 * Rule 9 - Parse a node statement.
 * 
 * externproto ::=
 *      EXTERNPROTO NodeTypeId [ externInterfaceDeclaration* ] URLList ;
 * 
 */

/**
 * Rule 10 - Parse a node statement.
 * 
 * externInterfaceDeclaration ::=
 *      accessType fieldNameId eventId
 * 
 */

/**
 * Rule 2 - Parse a node statement.
 * 
 * routeStatement ::=
 *      ROUTE NodeNameId . eventOutId TO NodeNameId . eventInId ;
 * 
 */

/**
 * Rule 11 - Parse an MFField statement - principally a URIList on the
 * EXTERNPROTO.
 * 
 * URLList ::=
 *    "[" STRING_LITERAL* "]" |
 *    STRING_LITERAL ;
 * 
 */

//---------------------------------------------------------------------------
//  A.3 Node declarations
//---------------------------------------------------------------------------

/**
 * Rule 12 - Parse a node statement.
 * 
 * node ::=
 *      nodeTypeId { nodeBody } |
 *      "Script" { scriptBody } ;
 *  We also handle the empty cases for both body and script here
 * 
 */

/**
 * Rule 13 - Parse a node statement.
 * 
 * nodeBody ::=
 *      nodeBodyElement |
 *      nodeBodyElement nodeBody
 * 
 *  The empty case is handled in the Node declaration
 */

/**
 * Rule 14 - Parse a node statement.
 * 
 * nodeBodyElement ::=
 *      fieldNameId fieldValue |
 *      fieldNameId IS fieldNameId |
 *      routeStatement |
 *      protoStatement ;
 * 
 */

/**
 * Rule 15 - Parse a node statement.
 * 
 * scriptBody ::=
 *      scriptBodyElement |
 *      scriptBodyElement scriptBody
 * 
 * The empty case is handled in the Node declaration
 */

/**
 * Rule 16 - Parse a node statement.
 * 
 * scriptBodyElement ::=
 *      nodeBodyElement |
 *      restrictedInterfaceDeclaration |
 *      eventIn fieldType eventInId IS eventInId |
 *      eventOut fieldType eventOutId IS eventOutId |
 *      field fieldType fieldNameId IS fieldNameId ;
 * 
 */

/**
 * Rule 17 - Parse a node statement.
 * 
 * nodeNameId ::= Id ;
 * 
 */

/**
 * Rule 18 - Parse a NodeType identifier.
 * 
 * nodeTypeId ::= Id ;
 * 
 */

/**
 * Rule 19 - Parse a field name string.
 * 
 * fieldNameId ::= Id ;
 * eventInId ::= Id ;
 * eventOutId ::= Id ;
 * exposedFieldId ::= Id ;
 * 
 */

/**
 * Rule 20 - Turn a string into the {@link org.web3d.vrml.lang.FieldConstants}
 * value.
 * 
 *    "field" = FieldConstants.FIELD;
 *    "eventIn" = FieldConstants.EVENTIN;
 *    "eventOut" = FieldConstants.EVENTOUT;
 *    "exposedField" = FieldConstants.EXPOSEDFIELD;
 * 
 */

/**
 * Rule 21 - Turn a string into the {@link org.web3d.vrml.lang.FieldConstants}
 * value.
 * Restricted declaration of a field type of "field" "eventIn" and "eventOut"
 * but does not allow "exposedField"
 * 
 *    "field" = FieldConstants.FIELD;
 *    "eventIn" = FieldConstants.EVENTIN;
 *    "eventOut" = FieldConstants.EVENTOUT;
 * 
 */

/**
 * Rule 22 - Parse a field identifier.
 * 
 *   Id
 * 
 *  Concatention of fieldType that we really only care about the ID if the
 *  user wants to provided expanded types.
 */

/**
 * Rule 23 - Parse a field value statement.
 * 
 *  The value of a field. Just a literral string to pass back to the caller
 *  FieldValue :: =
 *     SingleFieldValue |
 *     MultiFieldValue
 * 
 *
 */

/**
 * Rule 24 - Parse a single value of a field statement.
 * 
 * SingleFieldValue ::=
 *     NodeStatement |         # SFNode
 *     "NULL" |                # empty SFNode or empty MFNode
 *     LiteralValue
 * 
 */

/**
 * Rule 25 - Parse a multi value field statement.
 * 
 * MultiFieldValue ::=
 *     "["(NodeStatment)+ "]" | # MFNode
 *     "[ (SingleFieldvalue)* ]
 * 
 */

/**
 * Rule 26 - Parse a literal value for a single field value.
 * 
 * LiteralValue ::=
 *    TRUE |
 *    FALSE |
 *    NumberArray |
 *    STRING_LITERAL
 * 
 * We do allow a full number array here - ie more than the max 4 values that
 * an SFRotation contains. This makes our parsing faster, but less correct.
 * Basically we assume the callback will deal with any extra numbers if they
 * want to by either discarding them or throwing an error.
 */

/**
 * Rule 27 - Parse an array of string literals.
 * 
 * StringArray ::=
 *   STRING_LITERAL+
 * 
 */

/**
 * Rule 28 - Parse a number that may contain multiple whitespace values - such
 * as an SFVec3f.
 * 
 * NumberArray ::=
 *    NUMBER_LITERAL+
 * 
 */

/**
 * Rule 29 - Parse a number that may contain multiple whitespace values - such
 * as an SFVec3f.
 * 
 * NumberArray ::=
 *    NUMBER_LITERAL+
 * 
 */

//---------------------------------------------------------------------------
//  Miscellaneous methods to use
//---------------------------------------------------------------------------

/**
 * Generate an identifier as a string from the parsed token.
 */