org.monte.media.binary

Class StructParser

java.lang.Object

org.monte.media.binary.StructParser

public class StructParser
extends Object

Parses structured binary data using C-like data declarations. Syntax:

 Declarations ::= { MagicDeclaration | DescriptionDeclaration | EnumDeclaration | SetDeclaration | TypedefDeclaration } EOF
 MagicDeclaration ::= "magic" identifier ("ushort" hexLiteral[".." hexLiteral] | stringLiteral) ";"
 DescriptionDeclaration ::= "description" identifier stringLiteral "," stringLiteral ";"
 EnumDeclaration ::= EnumSpecifier identifier ";"
 SetDeclaration ::= SetSpecifier identifier ";"
 TypedefDeclaration ::= "typedef" TypeSpecifier identifier ";"
 EnumSpecifier ::= "enum" ( identifier | "{" identifier ["=" magicOrIntLiteral] {"," identifier ["=" intLiteral]} "}" )
 SetSpecifier ::= "set" ( identifier | "{" identifier "=" intLiteral {"," identifier "=" intLiteral} "}" )
 TypeSpecifier ::= ( StructSpecifier | (PrimitiveSpecifier [EnumSpecifier | SetSpecifier]) ) [ArrayList]
 StructSpecifier ::= "struct (identifier | "{" MemberDeclaration {"," MemberDeclaration } "}" )
 MemberDeclaration ::= TypeSpecifier identifier [ArrayList] ";"
 PrimitiveSpecifier ::= "uint1" | "uint2" | "uint4" | "uint5" | "uint8" 
                         | "uint12" | "uint16" | "uint31LE" | "uint32"
                         | "int9" | "int16" | "int32"
                         | "ubyte" | "byte" | "short"
                         | "ushort" | "int" | "long" | "float" | "double"
                         | "extended"
                         | "char" | "charbyte" | "cstring" | "utf8" | "pstring"
                         | "pstring32"
                         | "utf16le" | "magic" | "mactimestamp" | "bcd2"
                         | "bcd4"
                         | "fixed16d16" | "fixed2d30" | "fixed8d8"
                         | "ataricolor"
 ArrayList ::= "[" [ArraySize] "]" {"," identifier "[" [ArraySize] "]" }
 ArraySize ::= () | intLiteral [("-"|"+"|"=="|"!=") intLiteral]
 

Version:

$Id: StructParser.java 299 2013-01-03 07:40:18Z werner $

Author:

Werner Randelshofer, Hausmatt 10, CH-6405 Goldau, Swityerland

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	StructParser.ArraySize ArraySize expression.
protected static class	StructParser.Declarations Declarations expression.
protected static class	StructParser.DescriptionDeclaration DescriptionDeclaration expression.
protected static class	StructParser.EnumDeclaration EnumDeclaration expression.
protected static class	StructParser.EnumSpecifier EnumSpecifier expression.
protected static class	StructParser.IntLiteral IntLiteral expression.
protected static class	StructParser.MagicDeclaration MagicDeclaration expression.
protected static class	StructParser.MagicOrIntLiteral MagicOrIntLiteral expression.
protected static class	StructParser.MemberDeclaration MemberDeclaration expression.
protected static class	StructParser.PrimitiveSpecifier PrimitiveSpecifier expression.
protected static class	StructParser.SetDeclaration SetDeclaration expression.
protected static class	StructParser.SetSpecifier SetSpecifier expression.
protected static class	StructParser.StructSpecifier StructSpecifier expression.
protected static class	StructParser.TypedefDeclaration TypedefDeclaration expression.
protected static class	StructParser.TypeSpecifier TypeSpecifier expression.

Field Summary

Fields

Modifier and Type	Field and Description
protected static long	MAC_TIMESTAMP_EPOCH

Constructor Summary

Constructors

Constructor and Description
StructParser()
StructParser(Reader r)

Method Summary

Methods

Modifier and Type	Method and Description
String	getDescription(Object magic)
String	getDescription(String magic)
String	getIdentifierName(String magic)
String	getName(Object magic)
String	getName(String magic)
boolean	isMagicDeclared(Object magic)
boolean	isMagicDeclared(String magic)
boolean	isTypeDeclared(Object magic)
boolean	isTypeDeclared(String magic)
protected void	parse(Reader r)
StructTableModel	readStruct(int magic, byte[] data)
StructTableModel	readStruct(int magic, InputStream data)
StructTableModel	readStruct(String magic, byte[] data)
StructTableModel	readStruct(String magic, InputStream data)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

MAC_TIMESTAMP_EPOCH

protected static final long MAC_TIMESTAMP_EPOCH

Constructor Detail

StructParser

public StructParser()

StructParser

public StructParser(Reader r)
             throws IOException,
                    ParseException

Throws:

IOException

ParseException

Method Detail

getName

public String getName(String magic)

getName

public String getName(Object magic)

getIdentifierName

public String getIdentifierName(String magic)

isMagicDeclared

public boolean isMagicDeclared(String magic)

isMagicDeclared

public boolean isMagicDeclared(Object magic)

isTypeDeclared

public boolean isTypeDeclared(String magic)

isTypeDeclared

public boolean isTypeDeclared(Object magic)

getDescription

public String getDescription(String magic)

getDescription

public String getDescription(Object magic)

readStruct

public StructTableModel readStruct(String magic,
                          byte[] data)
                            throws IOException

Throws:

IOException

readStruct

public StructTableModel readStruct(int magic,
                          byte[] data)
                            throws IOException

Throws:

IOException

readStruct

public StructTableModel readStruct(String magic,
                          InputStream data)
                            throws IOException

Throws:

IOException

readStruct

public StructTableModel readStruct(int magic,
                          InputStream data)
                            throws IOException

Throws:

IOException

parse

protected void parse(Reader r)
              throws IOException,
                     ParseException

Throws:

IOException

ParseException