org.rigwit.forth

Class ForthLoader

java.lang.Object

org.rigwit.forth.ForthLoader

public class ForthLoader
extends java.lang.Object

Load a high-level forth package (file) into the Forth Virtual Machine. Search the java class path for the file and load it.

Constructor Summary

Constructors

Constructor and Description
ForthLoader(VM vm) Initialise the loader to load files from the default Java classpath into the given Virtual Machine.
ForthLoader(VM vm, java.lang.String pathList) Initialise the loader to load files from the given path into the given Virtual Machine.

Method Summary

Methods

Modifier and Type	Method and Description
void	load(java.lang.String packageName) Search for a given Forth package (packageName) in the configured search paths, interpreting the file using the configured Virtual Machine.

Methods inherited from class java.lang.Object

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

Constructor Detail

ForthLoader

public ForthLoader(VM vm)

Initialise the loader to load files from the default Java classpath into the given Virtual Machine.

Parameters:

vm - the Virtual Machine to use when loading / interpreting the file.

ForthLoader

public ForthLoader(VM vm,
           java.lang.String pathList)

Initialise the loader to load files from the given path into the given Virtual Machine. The path is a list of paths to search to find the file. This list of paths is searched before the default Java classpath paths are searched.

Parameters:

vm - the Virtual Machine to use when loading / interpreting the file.

pathList - a list of paths to be used when searching for the file.

Method Detail

load

public void load(java.lang.String packageName)
          throws java.io.FileNotFoundException,
                 java.io.IOException,
                 ForthException

Search for a given Forth package (packageName) in the configured search paths, interpreting the file using the configured Virtual Machine. The system will search inside .jar and .zip file on the search path as well as directories for the file. If the file is not found, it will search using a number of default extensions.

Parameters:

packageName - the name of the Forth package to load.

Throws:

java.io.FileNotFoundException - should the file not be found in the path.

java.io.IOException - should there be a difficulty loading the file.

ForthException - should there be a difficulty with the source code in the forth package.