Package io.deephaven.engine.util

Class NoLanguageDeephavenSession

java.lang.Object

io.deephaven.util.referencecounting.ReferenceCounted

io.deephaven.engine.liveness.ReferenceCountedLivenessReferent

io.deephaven.engine.liveness.ReferenceCountedLivenessNode

io.deephaven.engine.liveness.LivenessScope

io.deephaven.engine.util.AbstractScriptSession<AbstractScriptSession.Snapshot>

io.deephaven.engine.util.NoLanguageDeephavenSession

All Implemented Interfaces:

LogOutputAppendable, LivenessManager, LivenessNode, LivenessReferent, ReleasableLivenessManager, ScriptSession, VariableProvider, Serializable

public class NoLanguageDeephavenSession
extends AbstractScriptSession<AbstractScriptSession.Snapshot>

ScriptSession implementation that simply allows variables to be exported. This is not intended for use in user scripts.

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class io.deephaven.engine.util.AbstractScriptSession

AbstractScriptSession.ScriptSessionQueryScope, AbstractScriptSession.Snapshot, AbstractScriptSession.SynchronizedScriptSessionQueryScope, AbstractScriptSession.UnsynchronizedScriptSessionQueryScope

Nested classes/interfaces inherited from interface io.deephaven.engine.util.ScriptSession

ScriptSession.Changes, ScriptSession.Listener

Field Summary

Fields inherited from class io.deephaven.engine.util.AbstractScriptSession

executionContext

Constructor Summary

Constructors

Constructor	Description
NoLanguageDeephavenSession(UpdateGraph updateGraph, OperationInitializer operationInitializer)
NoLanguageDeephavenSession(UpdateGraph updateGraph, OperationInitializer operationInitializer, String scriptType)

Method Summary

Modifier and Type	Method	Description
protected ScriptSession.Changes	createDiff(AbstractScriptSession.Snapshot from, AbstractScriptSession.Snapshot to, RuntimeException e)
protected AbstractScriptSession.Snapshot	emptySnapshot()
protected void	evaluate(String command, @Nullable String scriptName)	Evaluates command in the context of the current ScriptSession.
@NotNull Object	getVariable(String name)	Retrieve a variable from the script session's bindings.
<T> T	getVariable(String name, T defaultValue)	Retrieve a variable from the script session's bindings.
Set<String>	getVariableNames()	Retrieves all of the variable names present in the session's scope
Map<String,Object>	getVariables()	Retrieves all of the variables present in the session's scope (e.g., Groovy binding, Python globals()).
boolean	hasVariableName(String name)	Check if the scope has the given variable name
QueryScope	newQueryScope()
String	scriptType()
void	setVariable(String name, @Nullable Object newValue)	Inserts a value into the script's scope.
protected AbstractScriptSession.Snapshot	takeSnapshot()

Methods inherited from class io.deephaven.engine.util.AbstractScriptSession

applyVariableChangeToDiff, createScriptCache, destroy, evaluateScript, evaluateScript, getExecutionContext, getTableDefinition, getVariableProvider, getVariableType, observeScopeChanges, publishInitial

Methods inherited from class io.deephaven.engine.liveness.LivenessScope

release, transferTo

Methods inherited from class io.deephaven.engine.liveness.ReferenceCountedLivenessNode

getWeakReference, initializeTransientFieldsForLiveness, onReferenceCountAtZero, tryManage, tryUnmanage, tryUnmanage

Methods inherited from class io.deephaven.engine.liveness.ReferenceCountedLivenessReferent

dropReference, tryRetainReference

Methods inherited from class io.deephaven.util.referencecounting.ReferenceCounted

append, decrementReferenceCount, forceReferenceCountToZero, getReferenceCountDebug, incrementReferenceCount, resetReferenceCount, toString, tryDecrementReferenceCount, tryIncrementReferenceCount

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.deephaven.engine.liveness.LivenessManager

manage, tryManage

Methods inherited from interface io.deephaven.engine.liveness.LivenessNode

tryUnmanage, tryUnmanage, unmanage, unmanage

Methods inherited from interface io.deephaven.engine.liveness.LivenessReferent

dropReference, getReferentDescription, getWeakReference, retainReference, tryRetainReference

Methods inherited from interface io.deephaven.engine.liveness.ReleasableLivenessManager

release

Methods inherited from interface io.deephaven.engine.util.ScriptSession

evaluateScript, sanitizeThrowable, unwrapObject

Constructor Details

NoLanguageDeephavenSession

public NoLanguageDeephavenSession(UpdateGraph updateGraph,
 OperationInitializer operationInitializer)

NoLanguageDeephavenSession

public NoLanguageDeephavenSession(UpdateGraph updateGraph,
 OperationInitializer operationInitializer,
 String scriptType)

Method Details

newQueryScope

public QueryScope newQueryScope()

Specified by:

newQueryScope in class AbstractScriptSession<AbstractScriptSession.Snapshot>

Returns:

a query scope for this session; only invoked during construction

getVariable

@NotNull
public @NotNull Object getVariable(String name)
                            throws QueryScope.MissingVariableException

Description copied from interface: ScriptSession

Retrieve a variable from the script session's bindings.

Please use ScriptSession.getVariable(String, Object) if you expect the variable may not exist.

Parameters:

name - the variable to retrieve

Returns:

the variable

Throws:

QueryScope.MissingVariableException - if the variable does not exist

getVariable

public <T> T getVariable(String name,
 T defaultValue)

Description copied from interface: ScriptSession

Retrieve a variable from the script session's bindings. If the variable is not present, return defaultValue. If the variable is present, but is not of type (T), a ClassCastException may result.

Type Parameters:

T - the type of the variable

Parameters:

name - the variable to retrieve

defaultValue - the value to use when no value is present in the session's scope

Returns:

the value of the variable, or defaultValue if not present

emptySnapshot

protected AbstractScriptSession.Snapshot emptySnapshot()

Specified by:

emptySnapshot in class AbstractScriptSession<AbstractScriptSession.Snapshot>

takeSnapshot

protected AbstractScriptSession.Snapshot takeSnapshot()

Specified by:

takeSnapshot in class AbstractScriptSession<AbstractScriptSession.Snapshot>

createDiff

protected ScriptSession.Changes createDiff(AbstractScriptSession.Snapshot from,
 AbstractScriptSession.Snapshot to,
 RuntimeException e)

Specified by:

createDiff in class AbstractScriptSession<AbstractScriptSession.Snapshot>

evaluate

protected void evaluate(String command,
 @Nullable
 @Nullable String scriptName)

Description copied from class: AbstractScriptSession

Evaluates command in the context of the current ScriptSession.

Specified by:

evaluate in class AbstractScriptSession<AbstractScriptSession.Snapshot>

Parameters:

command - the command to evaluate

scriptName - an optional script name, which may be ignored by the implementation, or used improve error messages or for other internal purposes

getVariables

public Map<String,Object> getVariables()

Description copied from interface: ScriptSession

Retrieves all of the variables present in the session's scope (e.g., Groovy binding, Python globals()).

Returns:

an unmodifiable map with variable names as the keys, and the Objects as the result

getVariableNames

public Set<String> getVariableNames()

Description copied from interface: ScriptSession

Retrieves all of the variable names present in the session's scope

Returns:

an unmodifiable set of variable names

hasVariableName

public boolean hasVariableName(String name)

Description copied from interface: ScriptSession

Check if the scope has the given variable name

Parameters:

name - the variable name

Returns:

True iff the scope has the given variable name

setVariable

public void setVariable(String name,
 @Nullable
 @Nullable Object newValue)

Description copied from interface: ScriptSession

Inserts a value into the script's scope.

Parameters:

name - the variable name to set

newValue - the new value of the variable

scriptType

public String scriptType()

Returns:

a textual description of this script session's language for use in messages.