org.web3d.vrml.sav
Interface VRMLReader

All Known Implementing Classes:

BaseReader, XMLReader

public interface VRMLReader

Representation of a class capable of reading a VRML source and providing event notification of the items in that file.

The class acts as a serial stream of events as the VRML file is parsed. If a given handler is not registered, events of these types will be ignored.

All SAV interfaces are assumed to be Synchronous. The parse methods shall not return until parsing is complete and readers shall wait for an event handler callback to return before reporting the next event.

Version:

$Revision: 1.8 $

Author:

Justin Couch

Method Summary

ContentHandler	getContentHandler() Get the currently set ContentHandler instance.
ErrorReporter	getErrorHandler() Get the currently set ErrorHandler instance.
java.lang.Object	getProperty(java.lang.String prop) Get the value of the named property.
ProtoHandler	getProtoHandler() Get the currently set ProtoHandler instance.
RouteHandler	getRouteHandler() Get the currently set RouteHandler instance.
ScriptHandler	getScriptHandler() Get the currently set ScriptHandler instance.
void	parse(InputSource is) Parse a VRML document represented by the given input source.
void	setContentHandler(ContentHandler nh) Set the node handler to the given instance.
void	setErrorHandler(ErrorHandler eh) Set the error handler to the given instance.
void	setErrorReporter(ErrorReporter eh) Set the error handler to the given instance.
void	setHeaderIgnore(boolean enable) Tell the reader that it should not look for the header.
void	setProperty(java.lang.String name, java.lang.Object value) Set the value of the named property to the given value.
void	setProtoHandler(ProtoHandler ph) Set the proto handler to the given instance.
void	setRouteHandler(RouteHandler rh) Set the route handler to the given instance.
void	setScriptHandler(ScriptHandler sh) Set the script handler to the given instance.

Method Detail

parse

void parse(InputSource is)
           throws java.io.IOException,
                  VRMLException

Parse a VRML document represented by the given input source. This method should not be called while currently processing a stream. If multiple concurrent streams need to be parsed then multiple instances of this interface should be used.

Parameters:

is - The input source to be used

Throws:

java.io.IOException - An I/O error while reading the stream

VRMLParseException - A parsing error occurred in the file

VRMLException

getProperty

java.lang.Object getProperty(java.lang.String prop)
                             throws SAVNotSupportedException

Get the value of the named property. VRMLReaders are not required to support any specific property names.

Parameters:

prop - The name of the property to get the value of

Returns:

The value of the set property or null if not set

Throws:

SAVNotSupportedException - The VRMLReader does not recognize or does not support this property name.

setProperty

void setProperty(java.lang.String name,
                 java.lang.Object value)
                 throws SAVNotSupportedException

Set the value of the named property to the given value. VRMLReaders are not required to support any specific property names. Using a value of null will clear the currently set property value.

Parameters:

name - The name of the property to set

value - The value of this property

Throws:

SAVNotSupportedException - The VRMLReader does not recognize or does not support this property name.

setHeaderIgnore

void setHeaderIgnore(boolean enable)

Tell the reader that it should not look for the header. This is needed to deal with createVrmlFromString() calls that do not include the header as part of the stream and would otherwise cause an error.

Parameters:

enable - true to stop looking for a header

getErrorHandler

ErrorReporter getErrorHandler()

Get the currently set ErrorHandler instance. If nothing is set it will return null.

Returns:

The currently set error handler.

setErrorHandler

void setErrorHandler(ErrorHandler eh)

Set the error handler to the given instance. If the value is null it will clear the currently set instance.

Parameters:

eh - The error handler instance to use

setErrorReporter

void setErrorReporter(ErrorReporter eh)

Set the error handler to the given instance. If the value is null it will clear the currently set instance. If the reporter is also an instance of ErrorHandler, the actions will be the same as for setting an error handler.

Parameters:

eh - The error reporter instance to use

getContentHandler

ContentHandler getContentHandler()

Get the currently set ContentHandler instance. If nothing is set it will return null.

Returns:

The currently set node handler.

setContentHandler

void setContentHandler(ContentHandler nh)

Set the node handler to the given instance. If the value is null it will clear the currently set instance.

Parameters:

nh - The node handler instance to use

getScriptHandler

ScriptHandler getScriptHandler()

Get the currently set ScriptHandler instance. If nothing is set it will return null.

Returns:

The currently set script handler.

setScriptHandler

void setScriptHandler(ScriptHandler sh)

Set the script handler to the given instance. If the value is null it will clear the currently set instance.

Parameters:

sh - The script handler instance to use

getProtoHandler

ProtoHandler getProtoHandler()

Get the currently set ProtoHandler instance. If nothing is set it will return null.

Returns:

The currently set proto handler.

setProtoHandler

void setProtoHandler(ProtoHandler ph)

Set the proto handler to the given instance. If the value is null it will clear the currently set instance.

Parameters:

ph - The proto handler instance to use

getRouteHandler

RouteHandler getRouteHandler()

Get the currently set RouteHandler instance. If nothing is set it will return null.

Returns:

The currently set route handler.

setRouteHandler

void setRouteHandler(RouteHandler rh)

Set the route handler to the given instance. If the value is null it will clear the currently set instance.

Parameters:

rh - The route handler instance to use