Package io.github.eutro.jwasm

Class ModuleReader<E extends Exception>

java.lang.Object

io.github.eutro.jwasm.ModuleReader<E>

Type Parameters:

E - The exception that may be thrown on read errors by accept(ModuleVisitor).

public class ModuleReader<E extends Exception>
extends Object

A parser that makes a ModuleVisitor visit a WebAssembly module structure.

This class parses a binary module's contents, calling the appropriate visit methods of the ModuleVisitor and any other relevant *Visitors it returns.

Constructor Summary

Constructors

Constructor	Description
ModuleReader(Supplier<ByteInputStream<E>> source)	Construct a ModuleReader with the given source of bytes.

Method Summary

Modifier and Type	Method	Description
void	accept(ModuleVisitor mv)	Make the given ModuleVisitor visit the structure of the module.
static ModuleReader<RuntimeException>	fromBytes(byte[] b)	Construct a ModuleReader that reads from the given byte array.
static ModuleReader<RuntimeException>	fromBytes(byte[] b, int offset, int len)	Construct a ModuleReader that reads from a subarray of the given byte array, starting at offset with a length of len bytes.
static ModuleReader<IOException>	fromInputStream(InputStream is)	Construct a ModuleReader that reads from the given input stream.

Methods inherited from class java.lang.Object

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

Constructor Details

ModuleReader

public ModuleReader(Supplier<ByteInputStream<E>> source)

Construct a ModuleReader with the given source of bytes.

Parameters:

source - The supplier of ByteInputStreams to read the module from.

Method Details

fromBytes

public static ModuleReader<RuntimeException> fromBytes(byte[] b)

Construct a ModuleReader that reads from the given byte array.

Parameters:

b - The byte array to read from.

Returns:

The new ModuleReader.

fromBytes

public static ModuleReader<RuntimeException> fromBytes(byte[] b,
 int offset,
 int len)

Construct a ModuleReader that reads from a subarray of the given byte array, starting at offset with a length of len bytes.

Parameters:

b - The byte array to read from.

offset - The offset of the subarray to use.

len - The length of the subarray to use.

Returns:

The new ModuleReader.

fromInputStream

public static ModuleReader<IOException> fromInputStream(InputStream is)

Construct a ModuleReader that reads from the given input stream.

The accept(ModuleVisitor) method of the returned ModuleReader can only be called once, or an IllegalStateException will be thrown.

Parameters:

is - The input stream to read from.

Returns:

The new ModuleReader.

accept

public void accept(ModuleVisitor mv)
            throws E

Make the given ModuleVisitor visit the structure of the module.

Parameters:

mv - The ModuleVisitor.

Throws:

E - If the ByteInputStream throws an error while reading.

ValidationException - If the bytes represent an invalid module file that inhibits the parsing of the file. Not all invalid modules will cause this method to throw this exception, only those errors that prevent the parsing.