com.couchbase.lite.internal.database.sqlite

Class SQLiteClosable

java.lang.Object

com.couchbase.lite.internal.database.sqlite.SQLiteClosable

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable

Direct Known Subclasses:

SQLiteDatabase, SQLiteProgram

public abstract class SQLiteClosable
extends java.lang.Object
implements java.io.Closeable

An object created from a SQLiteDatabase that can be closed. This class implements a primitive reference counting scheme for database objects.

Constructor Summary

Constructors

Constructor and Description
SQLiteClosable()

Method Summary

Modifier and Type	Method and Description
void	acquireReference() Acquires a reference to the object.
void	close() Releases a reference to the object, closing the object if the last reference was released.
protected abstract void	onAllReferencesReleased() Called when the last reference to the object was released by a call to releaseReference() or close().
protected void	onAllReferencesReleasedFromContainer() Deprecated. Do not use.
void	releaseReference() Releases a reference to the object, closing the object if the last reference was released.
void	releaseReferenceFromContainer() Deprecated. Do not use.

Methods inherited from class java.lang.Object

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

Constructor Detail

SQLiteClosable

public SQLiteClosable()

Method Detail

onAllReferencesReleased

protected abstract void onAllReferencesReleased()

Called when the last reference to the object was released by a call to releaseReference() or close().

onAllReferencesReleasedFromContainer

@Deprecated
protected void onAllReferencesReleasedFromContainer()

Deprecated. Do not use.

Called when the last reference to the object was released by a call to releaseReferenceFromContainer().

acquireReference

public void acquireReference()

Acquires a reference to the object.

Throws:

java.lang.IllegalStateException - if the last reference to the object has already been released.

releaseReference

public void releaseReference()

Releases a reference to the object, closing the object if the last reference was released.

See Also:

onAllReferencesReleased()

releaseReferenceFromContainer

@Deprecated
public void releaseReferenceFromContainer()

Deprecated. Do not use.

Releases a reference to the object that was owned by the container of the object, closing the object if the last reference was released.

See Also:

onAllReferencesReleasedFromContainer()

close

public void close()

Releases a reference to the object, closing the object if the last reference was released. Calling this method is equivalent to calling releaseReference().

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

See Also:

releaseReference(), onAllReferencesReleased()