water

Class Scope

java.lang.Object

water.Scope

public class Scope
extends java.lang.Object

A "scope" for tracking Key lifetimes; an experimental API.

A Scope defines a SINGLE THREADED local lifetime management context, stored in Thread Local Storage. Scopes can be explicitly entered or exited. User keys created by this thread are tracked, and deleted when the scope is exited. Since enter & exit are explicit, failure to exit means the Keys leak (there is no reliable thread-on-exit cleanup action). You must call Scope.exit() at some point. Only user keys & Vec keys are tracked.

Scopes support nesting. Scopes support partial cleanup: you can list Keys you'd like to keep in the exit() call. These will be "bumped up" to the higher nested scope - or escaped and become untracked at the top-level.

Constructor Summary

Constructors

Constructor and Description
Scope()

Method Summary

Methods

Modifier and Type	Method and Description
static void	enter() Enter a new Scope
static Key[]	exit(Key... keep) Exit the inner-most Scope, remove all Keys created since the matching enter call except for the listed Keys.
static Key[]	pop() Pop-scope (same as exit-scope) but return all keys that are tracked (and would have been deleted).
static Frame	track(Frame fr)
static Vec	track(Vec vec)
static void	untrack(Key<Vec>[] keys)

Methods inherited from class java.lang.Object

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

Constructor Detail

Scope

public Scope()

Method Detail

enter

public static void enter()

Enter a new Scope

exit

public static Key[] exit(Key... keep)

Exit the inner-most Scope, remove all Keys created since the matching enter call except for the listed Keys.

Returns:

Returns the list of kept keys.

pop

public static Key[] pop()

Pop-scope (same as exit-scope) but return all keys that are tracked (and would have been deleted).

track

public static Vec track(Vec vec)

track

public static Frame track(Frame fr)

untrack

public static void untrack(Key<Vec>[] keys)