IPooledConnection Интерфейс

Определение

Пространство имен:: Javax.Sql

Сборка:: Mono.Android.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Объект, предоставляющий перехватчики для управления пулом подключений.

[Android.Runtime.Register("javax/sql/PooledConnection", "", "Javax.Sql.IPooledConnectionInvoker")]
public interface IPooledConnection : Android.Runtime.IJavaObject, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("javax/sql/PooledConnection", "", "Javax.Sql.IPooledConnectionInvoker")>]
type IPooledConnection = interface
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Атрибуты: RegisterAttribute

Реализации: IJavaObject IJavaPeerable IDisposable

Объект, предоставляющий перехватчики для управления пулом подключений. PooledConnection Объект представляет физическое подключение к источнику данных. Подключение можно перезаработать, а не закрывать, когда приложение завершится с ним, тем самым уменьшая количество подключений, которые необходимо сделать.

Программист приложений PooledConnection не использует интерфейс напрямую. Вместо этого он используется инфраструктурой среднего уровня, которая управляет пулом подключений.

При вызове метода DataSource.getConnectionприложение возвращает Connection объект. Если выполняется пул соединений, этот Connection объект фактически является дескриптором PooledConnection объекта, который является физическим соединением.

Диспетчер пула подключений, как правило, сервер приложений PooledConnection поддерживает пул объектов. Если в пуле есть PooledConnection объект, диспетчер пула соединений возвращает Connection объект, который является дескриптором этого физического соединения. Если объект недоступен PooledConnection , диспетчер пула подключений вызывает ConnectionPoolDataSource метод getPoolConnection для создания нового физического подключения. Драйвер JDBC, реализующий ConnectionPoolDataSource создание нового PooledConnection объекта, возвращает дескриптор.

При закрытии подключения приложение вызывает Connection метод close. Когда выполняется пул подключений, диспетчер пулов подключений уведомляется, так как он зарегистрировался в качестве ConnectionEventListener объекта с помощью ConnectionPool метода addConnectionEventListener. Диспетчер пула соединений деактивирует дескриптор PooledConnection объекта и возвращает PooledConnection объект в пул подключений, чтобы его можно было использовать снова. Таким образом, когда приложение закрывает свое подключение, базовое физическое подключение перезапускается, а не закрывается.

Физическое подключение не закрывается, пока диспетчер пула подключений PooledConnection не вызывает метод close. Этот метод обычно вызывается для упорядоченного завершения работы сервера или если неустранимая ошибка сделала подключение непригодным для использования.

Диспетчер пула подключений часто является диспетчером пула инструкций, главным образом, пулом PreparedStatement объектов. При закрытии подготовленной инструкции приложение вызывает PreparedStatement метод close. Когда Statement выполняется объединение пулов, диспетчер пулов уведомляется, так как он зарегистрировался в качестве StatementEventListener объекта с помощью ConnectionPool метода addStatementEventListener. Таким образом, когда приложение закрывает его PreparedStatement, базовая подготовленная инструкция перезапускается, а не закрывается.

Добавлено в версии 1.4.

Java документации по javax.sql.PooledConnection.

Части этой страницы — это изменения на основе работы, созданной и общей Project и используемых в соответствии с условиями, описанными в разделе "".

Свойства

Имя.	Описание
Connection	Создает подключение к базе данных.
Handle	Возвращает значение JNI базового объекта Android. (Унаследовано от IJavaObject)
JniIdentityHashCode	Возвращает значение `java.lang.System.identityHashCode()` для упаковаемого экземпляра. (Унаследовано от IJavaPeerable)
JniManagedPeerState	Состояние управляемого однорангового узла. (Унаследовано от IJavaPeerable)
JniObjectReferenceControlBlock	Объект, предоставляющий перехватчики для управления пулом подключений. (Унаследовано от IJavaPeerable)
JniPeerMembers	Поддержка доступа к членам и вызовов. (Унаследовано от IJavaPeerable)
PeerReference	JniObjectReference Возвращает экземпляр объекта Java в оболочке. (Унаследовано от IJavaPeerable)

Методы

Имя.	Описание
AddConnectionEventListener(IConnectionEventListener)	Регистрирует заданный прослушиватель событий, чтобы оно было уведомлено, когда событие происходит в этом `PooledConnection` объекте.
AddStatementEventListener(IStatementEventListener)	`StatementEventListener` Регистрирует объект с этим `PooledConnection` объектом.
Close()	Закрывает физическое соединение, которое представляет этот `PooledConnection` объект.
Disposed()	Вызывается при удалении экземпляра. (Унаследовано от IJavaPeerable)
DisposeUnlessReferenced()	Если нет невыполненных ссылок на этот экземпляр, то вызывается `Dispose()`; в противном случае ничего не делает. (Унаследовано от IJavaPeerable)
Finalized()	Вызывается при завершении экземпляра. (Унаследовано от IJavaPeerable)
RemoveConnectionEventListener(IConnectionEventListener)	Удаляет заданный прослушиватель событий из списка компонентов, которые будут получать уведомления при возникновении события в этом `PooledConnection` объекте.
RemoveStatementEventListener(IStatementEventListener)	Удаляет указанный `StatementEventListener` из списка компонентов, которые будут уведомлены, когда драйвер обнаруживает, что `PreparedStatement` он закрыт или недопустим.
SetJniIdentityHashCode(Int32)	Задайте значение, возвращаемое `JniIdentityHashCode`. (Унаследовано от IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)	Объект, предоставляющий перехватчики для управления пулом подключений. (Унаследовано от IJavaPeerable)
SetPeerReference(JniObjectReference)	Задайте значение, возвращаемое `PeerReference`. (Унаследовано от IJavaPeerable)
UnregisterFromRuntime()	Отмените регистрацию этого экземпляра, чтобы среда выполнения не возвращала ее из будущих Java.Interop.JniRuntime+JniValueManager.PeekValue вызовов. (Унаследовано от IJavaPeerable)

Методы расширения

Имя.	Описание
GetJniTypeName(IJavaPeerable)	Возвращает имя JNI типа экземпляра `self`.
JavaAs<TResult>(IJavaPeerable)	Попробуйте принуждать к типу`self`, проверяя`TResult`, является ли приведение допустимым на стороне Java.
JavaCast<TResult>(IJavaObject)	Выполняет преобразование типа, проверяемого средой выполнения Android.
JavaCast<TResult>(IJavaObject)	Объект, предоставляющий перехватчики для управления пулом подключений.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Попробуйте принуждать к типу`self`, проверяя`TResult`, является ли приведение допустимым на стороне Java.

Применяется к