org.jruby.embed

Class IsolatedScriptingContainer

java.lang.Object

org.jruby.embed.ScriptingContainer

org.jruby.embed.IsolatedScriptingContainer

All Implemented Interfaces:

EmbedRubyInstanceConfigAdapter

public class IsolatedScriptingContainer
extends ScriptingContainer

the IsolatedScriptingContainer does set GEM_HOME and GEM_PATH and JARS_HOME in such a way that it uses only resources which can be reached with classloader. GEM_HOME is uri:classloader://META-INF/jruby.home/lib/ruby/gems/shared GEM_PATH is uri:classloader:// JARS_HOME is uri:classloader://jars but whenever you want to set them via setEnvironment(Map) this will be honored. it also comes with OSGi support which allows to add a bundle to LOAD_PATH or GEM_PATH.

Constructor Summary

Constructors

Constructor and Description
IsolatedScriptingContainer()
IsolatedScriptingContainer(LocalContextScope scope)
IsolatedScriptingContainer(LocalContextScope scope, LocalVariableBehavior behavior)
IsolatedScriptingContainer(LocalContextScope scope, LocalVariableBehavior behavior, boolean lazy)
IsolatedScriptingContainer(LocalVariableBehavior behavior)

Method Summary

Methods

Modifier and Type	Method and Description
void	addBundleToGemPath(org.osgi.framework.Bundle bundle) add the classloader from the given bundle to the GEM_PATH
void	addBundleToGemPath(String symbolicName) add the classloader from the given bundle to the GEM_PATH using the bundle symbolic name
void	addBundleToLoadPath(org.osgi.framework.Bundle bundle) add the classloader from the given bundle to the LOAD_PATH
void	addBundleToLoadPath(String symbolicName) add the classloader from the given bundle to the LOAD_PATH using the bundle symbolic name
void	setEnvironment(Map environment) Changes an environment variables' map.

Methods inherited from class org.jruby.embed.ScriptingContainer

addGemPath, addGemPath, addLoadPath, addLoadPath, callMethod, callMethod, callMethod, callMethod, callMethod, callMethod, callMethod, callMethod, callMethod, callSuper, callSuper, clear, finalize, get, get, getArgv, getAttribute, getAttributeMap, getClassLoader, getClassloaderDelegate, getCompatVersion, getCompileMode, getCurrentDirectory, getEnvironment, getErr, getError, getErrorWriter, getHomeDirectory, getIn, getInput, getInstance, getJitLogEvery, getJitMax, getJitMaxSize, getJitThreshold, getKCode, getLoadPaths, getLoadServiceCreator, getOut, getOutput, getProfile, getProfileOutput, getProfilingMode, getProperty, getProvider, getReader, getRecordSeparator, getRuntime, getScriptFilename, getSupportedRubyVersion, getVarMap, getWriter, isNativeEnabled, isObjectSpaceEnabled, isRunRubyInProcess, newObjectAdapter, newRuntimeAdapter, parse, parse, parse, parse, put, put, remove, remove, removeAttribute, resetErrorWriter, resetWriter, runRubyMethod, runRubyMethod, runScriptlet, runScriptlet, runScriptlet, runScriptlet, setArgv, setAttribute, setClassLoader, setClassloaderDelegate, setCompatVersion, setCompileMode, setCurrentDirectory, setError, setError, setErrorWriter, setHomeDirectory, setInput, setInput, setJitLogEvery, setJitMax, setJitMaxSize, setJitThreshold, setKCode, setLoadPaths, setLoadServiceCreator, setNativeEnabled, setObjectSpaceEnabled, setOutput, setOutput, setProfile, setProfile, setProfileOutput, setProfilingMode, setReader, setRecordSeparator, setRunRubyInProcess, setScriptFilename, setWriter, terminate

Methods inherited from class java.lang.Object

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

Constructor Detail

IsolatedScriptingContainer

public IsolatedScriptingContainer()

IsolatedScriptingContainer

public IsolatedScriptingContainer(LocalContextScope scope,
                          LocalVariableBehavior behavior)

IsolatedScriptingContainer

public IsolatedScriptingContainer(LocalContextScope scope)

IsolatedScriptingContainer

public IsolatedScriptingContainer(LocalVariableBehavior behavior)

IsolatedScriptingContainer

public IsolatedScriptingContainer(LocalContextScope scope,
                          LocalVariableBehavior behavior,
                          boolean lazy)

Method Detail

setEnvironment

public void setEnvironment(Map environment)

Description copied from class: ScriptingContainer

Changes an environment variables' map. Call this method before you use put/get, runScriptlet, and parse methods so that initial configurations will work.

Specified by:

setEnvironment in interface EmbedRubyInstanceConfigAdapter

Overrides:

setEnvironment in class ScriptingContainer

Parameters:

environment - a new map of environment variables.

addBundleToLoadPath

public void addBundleToLoadPath(org.osgi.framework.Bundle bundle)

add the classloader from the given bundle to the LOAD_PATH

Parameters:

bundle -

addBundleToLoadPath

public void addBundleToLoadPath(String symbolicName)

add the classloader from the given bundle to the LOAD_PATH using the bundle symbolic name

Parameters:

symbolicName -

addBundleToGemPath

public void addBundleToGemPath(org.osgi.framework.Bundle bundle)

add the classloader from the given bundle to the GEM_PATH

Parameters:

bundle -

addBundleToGemPath

public void addBundleToGemPath(String symbolicName)

add the classloader from the given bundle to the GEM_PATH using the bundle symbolic name

Parameters:

symbolicName -