org.aksw.jena_sparql_api.io.common

Interface Reference<T>

Type Parameters:

T -

All Superinterfaces:

AutoCloseable

All Known Implementing Classes:

ReferenceImpl

public interface Reference<T>
extends AutoCloseable

Interface for nested references. References allow for sharing an entity across several clients and deferring the release of that entity's resources immediately to the point in time when the last reference is released. The main use case is for memory paging such that if several threads request the same page only one physical buffer is handed out from a cache - conversely, as long as a page is still in used by a client, cache eviction may be suppressed.

Author:

raven

Method Summary

Modifier and Type	Method and Description
Reference<T>	acquire(Object purpose) Acquire a new reference with a given comment object Acquiration fails if isAlive() returns false
T	get() Get the referent
StackTraceElement[]	getAquisitionStackTrace() Optional operation.
boolean	isAlive() A reference may itself be released, but references to it may keep it alive
boolean	isClosed() Check whether this reference is closed / released

Methods inherited from interface java.lang.AutoCloseable

close

Method Detail

get

T get()

Get the referent

Returns:

The referent

acquire

Reference<T> acquire(Object purpose)

Acquire a new reference with a given comment object Acquiration fails if isAlive() returns false

Returns:

isAlive

boolean isAlive()

A reference may itself be released, but references to it may keep it alive

Returns:

true iff either this reference is not closed or there exists any acquired reference.

isClosed

boolean isClosed()

Check whether this reference is closed / released

getAquisitionStackTrace

StackTraceElement[] getAquisitionStackTrace()

Optional operation. References may expose where they were aquired

Returns: