OpenJDK 27 · jdk.internal.vm.StackableScope · APIdia, the JavaDoc alternative

Modifier and Type	Field and Description
private static final JavaLangAccess	JLA
private final Thread	owner
private volatile StackableScope	previous

Access	Constructor and Description
pack-priv	StackableScope(boolean true for a shared scope that cannot be pushed to the stack, false for scope that is owned by the current thread shared) Creates a stackable scope.
protected	StackableScope() Creates a stackable scope owned by the current thread.

Method Summary

Modifier and Type	Method and Description
private static boolean	contains(StackableScope scope) Returns true if the given scope is on the current thread's scope stack.
public StackableScope	enclosingScope() Returns the scope that encloses this scope.
public <T extends StackableScope> T	enclosingScope(Class<T> type) Returns the scope of the given type that encloses this scope.
pack-priv static StackableScope	head() Returns the head of the current thread's scope stack.
private StackableScope	next() Returns the scope that this scope directly encloses, null if none.
public Thread	owner() Returns the scope owner or null if not owned.
public static void	popAll() Pops all scopes from the current thread's scope stack.
public boolean	Returns: true if this scope was at the top of the stack, otherwise false popForcefully() Pops this scope from the current thread's scope stack.
pack-priv StackableScope	previous() Returns the scope that directly encloses this scope, null if none.
public StackableScope	push() Pushes this scope onto the current thread's scope stack.
private static void	setHead(StackableScope scope) Sets the head (top) of the current thread's scope stack.
protected boolean	Returns: true if this method closed the scope, false if it failed tryClose() Override this method to close this scope and release its resources.
public boolean	Returns: true if the pop succeeded, false if this scope is not the top of stack tryPop() Pops this scope from the current thread's scope stack if the scope is at the top of stack.
private void	unlink() Removes this scope from the current thread's scope stack.

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

JLA	back to summary
private static final JavaLangAccess JLA

owner	back to summary
private final Thread owner

previous	back to summary
private volatile StackableScope previous

StackableScope	back to summary
pack-priv StackableScope(boolean shared) Creates a stackable scope. Parameters shared:boolean true for a shared scope that cannot be pushed to the stack, false for scope that is owned by the current thread

StackableScope	back to summary
protected StackableScope() Creates a stackable scope owned by the current thread.

Method Detail

contains	back to summary
private static boolean contains(StackableScope scope) Returns true if the given scope is on the current thread's scope stack.

enclosingScope	back to summary
public StackableScope enclosingScope() Returns the scope that encloses this scope.

enclosingScope	back to summary
public <T extends StackableScope> T enclosingScope(Class<T> type) Returns the scope of the given type that encloses this scope.

head	back to summary
pack-priv static StackableScope head() Returns the head of the current thread's scope stack.

next	back to summary
private StackableScope next() Returns the scope that this scope directly encloses, null if none.

owner	back to summary
public Thread owner() Returns the scope owner or null if not owned.

popAll	back to summary
public static void popAll() Pops all scopes from the current thread's scope stack.

popForcefully back to summary

popForcefully	back to summary
public boolean popForcefully() Pops this scope from the current thread's scope stack. For well-behaved usages, this scope is at the top of the stack. It is popped from the stack and the method returns `true`. If this scope is not at the top of the stack then this method attempts to close each of the intermediate scopes by invoking their `tryClose()` method. If tryClose succeeds then the scope is removed from the stack. When done, this scope is removed from the stack and `false` is returned. This method does nothing, and returns `false`, if this scope is not on the current thread's scope stack. Returns:boolean true if this scope was at the top of the stack, otherwise false Annotations @DontInline @ReservedStackAccess Exceptions WrongThreadException: it the current thread is not the owner

public boolean popForcefully()

Pops this scope from the current thread's scope stack. For well-behaved usages, this scope is at the top of the stack. It is popped from the stack and the method returns true. If this scope is not at the top of the stack then this method attempts to close each of the intermediate scopes by invoking their tryClose() method. If tryClose succeeds then the scope is removed from the stack. When done, this scope is removed from the stack and false is returned. This method does nothing, and returns false, if this scope is not on the current thread's scope stack.

Returns:boolean

true if this scope was at the top of the stack, otherwise false

Annotations

@DontInline
@ReservedStackAccess

Exceptions

WrongThreadException:: it the current thread is not the owner

previous	back to summary
pack-priv StackableScope previous() Returns the scope that directly encloses this scope, null if none.

push	back to summary
public StackableScope push() Pushes this scope onto the current thread's scope stack. Exceptions WrongThreadException: it the current thread is not the owner

push

back to summary

public StackableScope push()

Pushes this scope onto the current thread's scope stack.

Exceptions

WrongThreadException:: it the current thread is not the owner

setHead	back to summary
private static void setHead(StackableScope scope) Sets the head (top) of the current thread's scope stack.

tryClose	back to summary
protected boolean tryClose() Override this method to close this scope and release its resources. This method should not pop the scope from the stack. This method is guaranteed to execute on the owner thread. Returns:boolean true if this method closed the scope, false if it failed

tryClose

back to summary

protected boolean tryClose()

Override this method to close this scope and release its resources. This method should not pop the scope from the stack. This method is guaranteed to execute on the owner thread.

Returns:boolean: true if this method closed the scope, false if it failed

tryPop	back to summary
public boolean tryPop() Pops this scope from the current thread's scope stack if the scope is at the top of stack. Returns:boolean true if the pop succeeded, false if this scope is not the top of stack Annotations @DontInline @ReservedStackAccess Exceptions WrongThreadException: it the current thread is not the owner

tryPop

back to summary

public boolean tryPop()

Pops this scope from the current thread's scope stack if the scope is at the top of stack.

Returns:boolean

true if the pop succeeded, false if this scope is not the top of stack

Annotations

@DontInline
@ReservedStackAccess

Exceptions

WrongThreadException:: it the current thread is not the owner

unlink	back to summary
private void unlink() Removes this scope from the current thread's scope stack.

public Class StackableScope

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail