Package org.jruby.embed.internal

Class EmbedRubyRuntimeAdapterImpl

java.lang.Object

org.jruby.embed.internal.EmbedRubyRuntimeAdapterImpl

All Implemented Interfaces:

EmbedRubyRuntimeAdapter, RubyRuntimeAdapter

public class EmbedRubyRuntimeAdapterImpl
extends Object
implements EmbedRubyRuntimeAdapter

Field Summary

Fields

Modifier and Type	Field	Description
private final RubyRuntimeAdapter	adapter
private final ScriptingContainer	container
private final boolean	wrapExceptions

Constructor Summary

Constructors

Constructor	Description
EmbedRubyRuntimeAdapterImpl(ScriptingContainer container)
EmbedRubyRuntimeAdapterImpl(ScriptingContainer container, boolean wrapExceptions)

Method Summary

Modifier and Type	Method	Description
(package private) static DynamicScope	createLocalVarScope(Ruby runtime, String[] varNames)
IRubyObject	eval(Ruby runtime, String script)
EmbedEvalUnit	parse(InputStream istream, String filename, int... lines)	Parses a script given by a input stream and return an object which can be run().
EmbedEvalUnit	parse(Reader reader, String filename, int... lines)	Parses a script given by a reader and return an object which can be run().
EmbedEvalUnit	parse(String script, int... lines)	Parses a script and return an object which can be run().
EmbedEvalUnit	parse(PathType type, String filename, int... lines)	Parses a script read from a specified path and return an object which can be run().
JavaEmbedUtils.EvalUnit	parse(Ruby runtime, InputStream istream, String filename, int lineNumber)
JavaEmbedUtils.EvalUnit	parse(Ruby runtime, String script, String filename, int lineNumber)
private EmbedEvalUnit	runParser(Object input, String filename, int... lines)

Methods inherited from class java.lang.Object

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

Field Details

adapter

private final RubyRuntimeAdapter adapter

container

private final ScriptingContainer container

wrapExceptions

private final boolean wrapExceptions

Constructor Details

EmbedRubyRuntimeAdapterImpl

public EmbedRubyRuntimeAdapterImpl(ScriptingContainer container)

EmbedRubyRuntimeAdapterImpl

public EmbedRubyRuntimeAdapterImpl(ScriptingContainer container,
 boolean wrapExceptions)

Method Details

parse

public EmbedEvalUnit parse(String script,
 int... lines)

Description copied from interface: EmbedRubyRuntimeAdapter

Parses a script and return an object which can be run(). This allows the script to be parsed once and evaluated many times.

Specified by:

parse in interface EmbedRubyRuntimeAdapter

Parameters:

script - is a Ruby script to be parsed

lines - are linenumbers to display for parse errors and backtraces. This field is optional. Only the first argument is used for parsing. When no line number is specified, 0 is applied to.

Returns:

an object which can be run

parse

public EmbedEvalUnit parse(Reader reader,
 String filename,
 int... lines)

Description copied from interface: EmbedRubyRuntimeAdapter

Parses a script given by a reader and return an object which can be run(). This allows the script to be parsed once and evaluated many times.

Specified by:

parse in interface EmbedRubyRuntimeAdapter

Parameters:

reader - is used to read a script from

filename - is used as in information, for example, appears in a stack trace of an exception

lines - are linenumbers to display for parse errors and backtraces. This field is optional. Only the first argument is used for parsing. When no line number is specified, 0 is applied to.

Returns:

an object which can be run

parse

public EmbedEvalUnit parse(PathType type,
 String filename,
 int... lines)

Description copied from interface: EmbedRubyRuntimeAdapter

Parses a script read from a specified path and return an object which can be run(). This allows the script to be parsed once and evaluated many times.

Specified by:

parse in interface EmbedRubyRuntimeAdapter

Parameters:

type - is one of the types PathType defines

filename - is used as in information, for example, appears in a stack trace of an exception

lines - are linenumbers to display for parse errors and backtraces. This field is optional. Only the first argument is used for parsing. When no line number is specified, 0 is applied to.

Returns:

an object which can be run

parse

public EmbedEvalUnit parse(InputStream istream,
 String filename,
 int... lines)

Description copied from interface: EmbedRubyRuntimeAdapter

Parses a script given by a input stream and return an object which can be run(). This allows the script to be parsed once and evaluated many times.

Specified by:

parse in interface EmbedRubyRuntimeAdapter

Parameters:

istream - is an input stream to get a script from

filename - filename is used as in information, for example, appears in a stack trace of an exception

lines - are linenumbers to display for parse errors and backtraces. This field is optional. Only the first argument is used for parsing. When no line number is specified, 0 is applied to.

Returns:

an object which can be run

runParser

private EmbedEvalUnit runParser(Object input,
 String filename,
 int... lines)

eval

public IRubyObject eval(Ruby runtime,
 String script)

Specified by:

eval in interface RubyRuntimeAdapter

parse

public JavaEmbedUtils.EvalUnit parse(Ruby runtime,
 String script,
 String filename,
 int lineNumber)

Specified by:

parse in interface RubyRuntimeAdapter

parse

public JavaEmbedUtils.EvalUnit parse(Ruby runtime,
 InputStream istream,
 String filename,
 int lineNumber)

Specified by:

parse in interface RubyRuntimeAdapter

createLocalVarScope

static DynamicScope createLocalVarScope(Ruby runtime,
 String[] varNames)