JRuby Base 10.0.0.0 · org.jruby.runtime.ThreadContext

Modifier and Type	Class and Description
private static class	ThreadContext.RecursiveError
public static interface	ThreadContext.RecursiveFunctionEx<T>

Modifier and Type	Field and Description
private BacktraceElement[]	backtrace
private int	backtraceIndex
public static final int	CALL_KEYWORD
public static final int	CALL_KEYWORD_EMPTY
public static final int	CALL_KEYWORD_REST
private static final int	CALL_POLL_COUNT The number of calls after which to do a thread event poll
public static final int	CALL_SPLATS
public int	callInfo
public int	callNumber
private int	catchIndex
private CatchThrow[]	catchStack
private int	currentMethodSerial
private RubyDateFormatter	dateFormatter
private static final CatchThrow[]	EMPTY_CATCHTARGET_STACK
private Encoding[]	encodingHolder
private boolean	eventHooksEnabled
public boolean	exceptionRequiresBacktrace
public final RubyBoolean	fals
private WeakReference<ThreadFiber>	fiber
private int	frameIndex
private Frame[]	frameStack
private static final int	INITIAL_FRAMES_SIZE
private static final int	INITIAL_SIZE
private boolean	isProfiling
private boolean	isWithinTrace
pack-priv CallType	lastCallType
pack-priv IRubyObject	lastExitStatus
pack-priv Visibility	lastVisibility
private static final Logger	LOG
private RubyMatchData	matchData
public final IRubyObject	nil
private static final WeakReference<ThreadFiber>	NULL_FIBER_REF
private RubyModule	privateConstantReference
private ProfileCollection	profileCollection
private Set<RecursiveComparator.Pair>	recursiveSet
private ThreadFiber	rootFiber
public final Ruby	runtime
public final RuntimeCache	runtimeCache
private Throwable	savedExcInLambda
private int	scopeIndex
private DynamicScope[]	scopeStack
public transient SecureRandom	secureRandom Deprecated Use `getSecureRandom()` instead. This fields is no longer initialized, is null by default!
public final JavaSites	sites
private Map<String, IdentityHashMap<IRubyObject, IRubyObject>>	symToGuards
private RubyThread	thread
public final TraceEventManager	traceEvents
private TraceEventManager.CallTraceFuncHook	traceFuncHook
public final RubyBoolean	tru
private static boolean	tryPreferredPRNG
private static boolean	trySHA1PRNG
public static final StackWalker	WALKER
public static final StackWalker	WALKER8

Access	Constructor and Description
private	ThreadContext(Ruby runtime) Constructor for Context.

Method Summary

Modifier and Type	Method and Description
public IRubyObject	addThreadTraceFunction(IRubyObject trace_func, boolean useContextHook)
public void	blockingThreadPoll() Poll for thread events that should be fired before a blocking call.
public void	callThreadPoll()
public static void	callThreadPoll(ThreadContext context)
public IRubyObject	Returns: nil clearBackRef() Set the $~ (backref) "global" to nil.
public void	clearCallInfo() Deprecated use the trivially-inlinable static version Clear call info state (set to 0).
public static void	clearCallInfo(ThreadContext context) Clear call info state (set to 0).
public void	clearErrorInfo()
public void	clearLocalMatch() Set the thread-local MatchData specific to this context to null.
public IRubyObject	clearThreadTraceFunctions()
public IRubyObject	Returns: an Array with the backtrace createCallerBacktrace(int level, int length, Stream<StackWalker.StackFrame> stackStream) Create an Array with backtrace information for Kernel#caller
public IRubyObject	Returns: an Array with the backtrace locations createCallerLocations(int the level at which the trace should start level, Integer the length of the trace length, Stream<StackWalker.StackFrame> stackStream) Create an array containing Thread::Backtrace::Location objects for the requested caller trace level and length.
public static String	createRawBacktraceStringFromThrowable(final Throwable ex, final boolean color)
public Binding	Returns: the current binding currentBinding() Return a binding representing the current call's state
public Binding	Returns: the current binding, using the specified self currentBinding(IRubyObject the self object to use self) Return a binding representing the current call's state but with a specified self
public Binding	Returns: the current binding using the specified self and visibility currentBinding(IRubyObject the self object to use self, Visibility the visibility to use visibility) Return a binding representing the current call's state but with the specified visibility and self.
public Binding	Returns: the current binding using the specified self and scope currentBinding(IRubyObject the self object to use self, DynamicScope the scope to use scope) Return a binding representing the current call's state but with the specified scope and self.
public Binding	Returns: the current binding using the specified self, scope, and visibility currentBinding(IRubyObject the self object to use self, Visibility the visibility to use visibility, DynamicScope the scope to use scope) Return a binding representing the current call's state but with the specified visibility, scope, and self.
public void	eachCallerLocation(Stream<StackWalker.StackFrame> the stream of StackFrame objects from JVM stackStream, Consumer<RubyThread.Location> the consumer of RubyThread.Location objects consumer) Like `createCallerLocations(int, Integer, Stream)` but accepts a lambda to yield each location and yields all stack elements until the loop ends or is broken early.
private void	eachPartialTrace(Stream<StackWalker.StackFrame> stackStream, Consumer<RubyStackTraceElement> consumer)
public Encoding[]	encodingHolder()
public void	exceptionBacktraceOff()
public void	exceptionBacktraceOn()
private static void	expandBacktraceStack(ThreadContext context)
private void	expandCatchStack()
private void	expandFrameStack()
private void	expandScopeStack()
private static BacktraceElement[]	fillNewBacktrace(ThreadContext context, BacktraceElement[] newBacktrace, int newSize)
private Frame[]	fillNewFrameStack(Frame[] newFrameStack, int newSize)
protected void	finalize() Overrides java.lang.Object.finalize. Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
public CatchThrow	Returns: The continuation associated with this tag getActiveCatch(Object The interned string to search for tag) Find the active Continuation for the given tag.
public IRubyObject	Returns: the value of $~ getBackRef() Get the value of the $~ (backref) "global".
public Stream<BacktraceElement>	Returns: the backtrace getBacktrace() Create a snapshot Array with current backtrace information.
public final Stream<BacktraceElement>	getBacktrace(int level)
public String	Returns: the name under which the current method was called getCalleeName() The name under which the current method was called, if called via an alias.
public String	Returns: a representation of the current method's name and the name it was called under getCompositeName() A string representing the name of the current method and the name under which it was called.
public IRubyObject	getConstant(String internedName) Deprecated Used by the evaluator and the compiler to look up a constant by name
public Frame	getCurrentFrame()
public DynamicScope	getCurrentScope()
public StaticScope	getCurrentStaticScope()
public int	getCurrentTarget()
public Visibility	getCurrentVisibility()
public IRubyObject	getErrorInfo()
public ThreadFiber	getFiber()
public RubyThread	getFiberCurrentThread()
public String	getFile()
public String	getFileAndLine()
public Block	getFrameBlock()
public RubyModule	getFrameKlazz()
public String	Returns: the current method's name getFrameName() The currently-running method's original name, used for stack traces, super calls, and __method__, and trace hooks.
public IRubyObject	getFrameSelf()
public CallType	getLastCallType()
public IRubyObject	getLastExitStatus()
public IRubyObject	Returns: the value of $_ getLastLine() Get the value of the $_ (lastline) "global".
public Visibility	getLastVisibility()
public int	getLine()
public RubyMatchData	Returns: the current thread-local MatchData, or null if none getLocalMatch() Get the thread-local MatchData specific to this context.
public IRubyObject	Returns: the current thread-local MatchData, or nil if none getLocalMatchOrNil() Get the thread-local MatchData specific to this context or nil if none.
public Frame	getNextFrame()
private RubyStackTraceElement[]	getPartialTrace(int level, Integer length, Stream<StackWalker.StackFrame> stackStream)
public Frame	getPreviousFrame()
public RubyModule	getPrivateConstantReference()
public ProfileCollection	Returns: the thread's profile collection getProfileCollection() Get the profile collection for this thread (ThreadContext).
public Set<RecursiveComparator.Pair>	getRecursiveSet()
public RubyDateFormatter	getRubyDateFormatter()
public final Ruby	Returns: the runtime associated with this context getRuntime() Retrieve the runtime associated with this context.
public Throwable	getSavedExceptionInLambda()
public SecureRandom	getSecureRandom()
public RubyStackTraceElement	Returns: the nearest stack trace element getSingleBacktrace(int level) Return a single RubyStackTraceElement representing the nearest Ruby stack trace element.
public RubyStackTraceElement	getSingleBacktrace() Same as calling getSingleBacktrace(0);
public RubyStackTraceElement	getSingleBacktraceExact(int level) Return the trace of level or null.
public RubyThread	getThread()
private RubyStackTraceElement[]	getWarnTrace(int level, Stream<StackWalker.StackFrame> stackStream)
public boolean	hasAnyScopes()
public static boolean	hasKeywords(int callInfo)
public boolean	isEventHooksEnabled()
public boolean	isProfiling()
public boolean	Returns: true if so isWithinTrace() Is this thread actively tracing at this moment.
public IRubyObject	last_match() MRI: rb_reg_last_match
public IRubyObject	match_last() MRI: rb_reg_match_last
public IRubyObject	match_post() MRI: rb_reg_match_post
public IRubyObject	match_pre() MRI: rb_reg_match_pre
public static ThreadContext	newContext(Ruby runtime)
public void	pollThreadEvents()
private void	popBackrefFrame()
public static void	popBacktrace(ThreadContext context)
public void	popCatch()
public void	popFrame()
private void	popFrameReal(Frame oldFrame)
public void	popScope()
public void	postBackrefMethod()
public void	postEvalScriptlet()
public void	postEvalWithBinding(Binding binding, Frame lastFrame)
public void	postExecuteUnder()
public void	postMethodBacktraceAndScope()
public void	postMethodBacktraceDummyScope()
public void	postMethodBacktraceOnly()
public void	postMethodFrameAndScope()
public void	postMethodFrameOnly()
public void	postMethodScopeOnly()
public void	postNodeEval()
public void	postScopedBody()
public void	postTrace()
public void	postYield(Binding binding, Frame lastFrame)
public void	postYieldNoScope(Frame lastFrame)
public void	preAdoptThread()
public void	preBackrefMethod()
public void	preEvalScriptlet(DynamicScope scope)
public Frame	preEvalWithBinding(Binding binding)
public void	preExecuteUnder(IRubyObject executeUnderObj, RubyModule executeUnderClass, Block block)
public void	preExtensionLoad(IRubyObject self)
public void	preMethodBacktraceAndScope(String name, StaticScope staticScope)
public void	preMethodBacktraceDummyScope(String name, StaticScope staticScope)
public void	preMethodBacktraceOnly(String name)
public void	preMethodFrameAndDummyScope(RubyModule clazz, String name, IRubyObject self, Block block, StaticScope staticScope)
public void	preMethodFrameAndScope(RubyModule clazz, String name, IRubyObject self, Block block, StaticScope staticScope)
public void	preMethodFrameOnly(RubyModule clazz, String name, IRubyObject self, Block block)
public void	preMethodFrameOnly(RubyModule clazz, String name, IRubyObject self, Visibility visiblity, Block block)
public void	preMethodFrameOnly(RubyModule clazz, String name, IRubyObject self)
public void	preMethodNoFrameAndDummyScope(StaticScope staticScope)
public void	preMethodScopeOnly(StaticScope staticScope)
public void	preNodeEval(IRubyObject self)
public void	prepareTopLevel(RubyClass objectClass, IRubyObject topSelf)
public void	preScopedBody(DynamicScope scope)
public void	preTrace()
public Frame	preYieldNoScope(Binding binding)
public Frame	preYieldNoScope(Block block)
public Frame	preYieldSpecificBlock(Binding binding, StaticScope scope)
public void	printScope()
public int	profileEnter(int nextMethod)
public int	profileEnter(String name, DynamicMethod nextMethod)
public int	profileExit(int nextMethod, long startTime)
private void	pushBackrefFrame()
public static void	pushBacktrace(ThreadContext context, String method, String file, int line)
private void	pushCallFrame(RubyModule clazz, String name, IRubyObject self, Block block)
private void	pushCallFrame(RubyModule clazz, String name, IRubyObject self, Visibility visibility, Block block)
public void	pushCatch(RubyContinuation.Continuation catchTarget) Deprecated
public void	pushCatch(CatchThrow catchTarget)
private void	pushEvalFrame(IRubyObject self)
public void	pushEvalSimpleFrame(IRubyObject executeObject)
private Frame	pushFrame(Frame frame)
public void	pushFrame()
private Frame	pushFrameForBlock(Binding binding)
public DynamicScope	pushNewScope(StaticScope staticScope)
public void	pushScope(DynamicScope scope)
public void	renderCurrentBacktrace(StringBuilder the StringBuilder to which to render the backtrace sb) Render the current backtrace as a string to the given StringBuilder.
public int	Returns: the old call info resetCallInfo() Deprecated use the trivially-inlinable static version Reset call info state and return the value of call info right before it is reset.
public static int	Returns: the old call info resetCallInfo(ThreadContext context) Reset call info state and return the value of call info right before it is reset.
private static int	safeLength(int level, Integer length, RubyStackTraceElement[] trace)
public <T> IRubyObject	safeRecurse(ThreadContext.RecursiveFunctionEx<T> func, T state, IRubyObject obj, String name, boolean outer)
private Map<IRubyObject, IRubyObject>	safeRecurseGetGuards(String name)
private <T> IRubyObject	safeRecurseInner(ThreadContext.RecursiveFunctionEx<T> func, T state, IRubyObject obj, Map<IRubyObject, IRubyObject> guards)
private <T> IRubyObject	safeRecurseOutermost(ThreadContext.RecursiveFunctionEx<T> func, T state, IRubyObject obj, Map<IRubyObject, IRubyObject> guards)
public boolean	Returns: true if it exists. otherwise false. scopeExistsOnCallStack(DynamicScope the scope to look for scope) Check if a scope is present on the call stack.
public IRubyObject	Returns: the value passed in setBackRef(RubyMatchData the value to set match) Set the $~ (backref) "global" to the given RubyMatchData value.
public IRubyObject	setBackRef(IRubyObject match) Deprecated
public void	setCurrentVisibility(Visibility visibility)
public IRubyObject	setErrorInfo(IRubyObject errorInfo)
public void	setEventHooksEnabled(boolean flag)
public void	setExceptionRequiresBacktrace(boolean exceptionRequiresBacktrace)
public void	setFiber(ThreadFiber fiber)
public void	setFileAndLine(String file, int line)
public void	setLastCallStatusAndVisibility(CallType callType, Visibility visibility)
public void	setLastExitStatus(IRubyObject lastExitStatus)
public IRubyObject	Returns: the value passed in setLastLine(IRubyObject the value to set last) Set the $_ (lastlne) "global" to the given value.
public void	setLine(int line)
public void	setLocalMatch(RubyMatchData the new thread-local MatchData or null localMatch) Set the thread-local MatchData specific to this context.
public void	setPrivateConstantReference(RubyModule privateConstantReference)
public void	setRecursiveSet(Set<RecursiveComparator.Pair> recursiveSet)
public void	setRootFiber(ThreadFiber rootFiber)
public void	setSavedExceptionInLambda(Throwable e)
public void	setThread(RubyThread thread)
public IRubyObject	setThreadTraceFunction(IRubyObject trace_func)
public void	setWithinTrace(boolean true is so isWithinTrace) Set whether we are actively tracing or not on this thread.
public void	startProfiling()
public void	stopProfiling()
public void	trace(RubyEvent event, String name, RubyModule implClass)
public void	trace(RubyEvent event, String name, RubyModule implClass, String file, int line)
public IRubyObject	Returns: The current match, or nil updateBackref() Update the current frame's backref using the current thread-local match, or clear it if that match is null.
public void	useRecursionGuardsFrom(ThreadContext context) Fibers must use the same recursion guards as their parent thread.

Inherited from java.lang.Object:: clone equals getClass hashCode notify notifyAll toString wait wait wait

public final Class ThreadContext

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary