uk.co.real_logic.sbe.xml

Class XmlSchemaParser

java.lang.Object

uk.co.real_logic.sbe.xml.XmlSchemaParser

public class XmlSchemaParser
extends Object

Encapsulate the XML Schema parsing for SBE so that other representations may be used to generate independent representation.

Field Summary

Fields

Modifier and Type	Field and Description
static String	COMPOSITE_XPATH_EXPR
static String	ENUM_XPATH_EXPR
static String	ERROR_HANDLER_KEY Key for storing ErrorHandler as user data in XML document
static String	MESSAGE_SCHEMA_XPATH_EXPR
static String	MESSAGE_XPATH_EXPR
static String	SET_XPATH_EXPR
static String	TYPE_XPATH_EXPR

Constructor Summary

Constructors

Constructor and Description
XmlSchemaParser()

Method Summary

Modifier and Type	Method and Description
static void	checkForValidName(Node node, String name) Check name against validity for C++ and Java naming.
static Map<Long,Message>	findMessages(Document document, XPath xPath, Map<String,Type> typeByNameMap) Scan XML for all message definitions and save in map
static Map<String,Type>	findTypes(Document document, XPath xPath) Scan XML for all types (encodedDataType, compositeType, enumType, and setType) and save in map
static String	getAttributeValue(Node elementNode, String attrName) Helper function that throws an exception when the attribute is not set.
static String	getAttributeValue(Node elementNode, String attrName, String defValue) Helper function that uses a default value when value not set.
static String	getAttributeValueOrNull(Node elementNode, String attrName) Helper function that hides the null return from NamedNodeMap.getNamedItem(String)
static ByteOrder	getByteOrder(String byteOrderName) Helper function to convert a schema byteOrderName into a ByteOrder
static void	handleError(Node node, String msg) Handle an error condition as consequence of parsing.
static void	handleWarning(Node node, String msg) Handle a warning condition as a consequence of parsing.
static MessageSchema	parse(InputStream in, ParserOptions options) Take an InputStream and parse it generating map of template ID to Message objects, types, and schema Input could be from FileInputStream, ByteArrayInputStream, etc.
static void	validate(String xsdFilename, BufferedInputStream in) Validate the document against a given schema.

Methods inherited from class java.lang.Object

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

Field Detail

ERROR_HANDLER_KEY

public static final String ERROR_HANDLER_KEY

Key for storing ErrorHandler as user data in XML document

See Also:

Constant Field Values

TYPE_XPATH_EXPR

public static final String TYPE_XPATH_EXPR

See Also:

Constant Field Values

COMPOSITE_XPATH_EXPR

public static final String COMPOSITE_XPATH_EXPR

See Also:

Constant Field Values

ENUM_XPATH_EXPR

public static final String ENUM_XPATH_EXPR

See Also:

Constant Field Values

SET_XPATH_EXPR

public static final String SET_XPATH_EXPR

See Also:

Constant Field Values

MESSAGE_SCHEMA_XPATH_EXPR

public static final String MESSAGE_SCHEMA_XPATH_EXPR

See Also:

Constant Field Values

MESSAGE_XPATH_EXPR

public static final String MESSAGE_XPATH_EXPR

See Also:

Constant Field Values

Constructor Detail

XmlSchemaParser

public XmlSchemaParser()

Method Detail

validate

public static void validate(String xsdFilename,
                            BufferedInputStream in)
                     throws Exception

Validate the document against a given schema. Error will be written to System.err

Parameters:

xsdFilename - schema to validate against.

in - document to be validated.

Throws:

Exception - if an error occurs when parsing the document or schema.

parse

public static MessageSchema parse(InputStream in,
                                  ParserOptions options)
                           throws Exception

Take an InputStream and parse it generating map of template ID to Message objects, types, and schema Input could be from FileInputStream, ByteArrayInputStream, etc. Exceptions are passed back up for any problems.

Parameters:

in - stream from which schema is read.

options - to be applied during parsing.

Returns:

MessageSchema encoding for the schema.

Throws:

Exception - on parsing error.

findTypes

public static Map<String,Type> findTypes(Document document,
                                         XPath xPath)
                                  throws Exception

Scan XML for all types (encodedDataType, compositeType, enumType, and setType) and save in map

Parameters:

document - for the XML parsing

xPath - for XPath expression reuse

Returns:

Map of name String to Type

Throws:

Exception - on parsing error.

findMessages

public static Map<Long,Message> findMessages(Document document,
                                             XPath xPath,
                                             Map<String,Type> typeByNameMap)
                                      throws Exception

Scan XML for all message definitions and save in map

Parameters:

document - for the XML parsing

xPath - for XPath expression reuse

typeByNameMap - to use for Type objects

Returns:

Map of schemaId to Message

Throws:

Exception - on parsing error.

handleError

public static void handleError(Node node,
                               String msg)

Handle an error condition as consequence of parsing.

Parameters:

node - that is the context of the warning.

msg - associated with the error.

handleWarning

public static void handleWarning(Node node,
                                 String msg)

Handle a warning condition as a consequence of parsing.

Parameters:

node - as the context for the warning.

msg - associated with the warning.

getAttributeValue

public static String getAttributeValue(Node elementNode,
                                       String attrName)

Helper function that throws an exception when the attribute is not set.

Parameters:

elementNode - that should have the attribute

attrName - that is to be looked up

Returns:

value of the attribute

Throws:

IllegalArgumentException - if the attribute is not present

getAttributeValue

public static String getAttributeValue(Node elementNode,
                                       String attrName,
                                       String defValue)

Helper function that uses a default value when value not set.

Parameters:

elementNode - that should have the attribute

attrName - that is to be looked up

defValue - String to return if not set

Returns:

value of the attribute or defValue

getAttributeValueOrNull

public static String getAttributeValueOrNull(Node elementNode,
                                             String attrName)

Helper function that hides the null return from NamedNodeMap.getNamedItem(String)

Parameters:

elementNode - that could be null

attrName - that is to be looked up

Returns:

null or value of the attribute

getByteOrder

public static ByteOrder getByteOrder(String byteOrderName)

Helper function to convert a schema byteOrderName into a ByteOrder

Parameters:

byteOrderName - specified as a FIX SBE string

Returns:

ByteOrder representation

checkForValidName

public static void checkForValidName(Node node,
                                     String name)

Check name against validity for C++ and Java naming. Warning if not valid.

Parameters:

node - to have the name checked.

name - of the node to be checked.