Spec-Zone .ru спецификации, руководства, описания, API

javax.resource.cci
Взаимодействие интерфейса

public interface Interaction

javax.resource.cci.Interaction позволяет компоненту выполнить функции EIS. Экземпляр Взаимодействия поддерживает следующие способы взаимодействовать с экземпляром EIS:

• execute метод, который берет входную Запись, выходную Запись и InteractionSpec. Этот метод выполняет функцию EIS, представленную InteractionSpec, и обновляет выходную Запись
• execute метод, который берет входную Запись и InteractionSpec. Эта реализация метода выполняет функцию EIS, представленную InteractionSpec, и производит выходную Запись как возвращаемое значение.

Экземпляр Взаимодействия создается из Соединения и обязан поддерживать свою ассоциацию с экземпляром Соединения. Близкий метод высвобождает все средства, сохраняемые адаптером ресурса для Взаимодействия. Завершение экземпляра Взаимодействия не должно закрыть связанный экземпляр Соединения.

С тех пор:

0.8

Версия:

0.8

Автор:

Рэхул Шарма

См. Также:

ResultSet

Сводка метода

void	clearWarnings() Очищает все предупреждение, о котором сообщает этот экземпляр Взаимодействия.
void	close() Закрывает текущее Взаимодействие, и высвободите все средства, сохраненные на этот экземпляр адаптером ресурса.
Запись	execute(InteractionSpec ispec, Record input) Выполняет взаимодействие, представленное InteractionSpec.
boolean	execute(InteractionSpec ispec, Record input, Record output) Выполняет взаимодействие, представленное InteractionSpec.
Соединение	getConnection() Связали Соединение со Взаимодействием.
ResourceWarning	getWarnings() Получает первый ResourceWarning от цепочки предупреждений, связанных с этим экземпляром Взаимодействия.

Деталь метода

близко

void close()
           throws ResourceException

Закрывает текущее Взаимодействие, и высвободите все средства, сохраненные на этот экземпляр адаптером ресурса. Завершение экземпляра Взаимодействия не закрывает связанный экземпляр Соединения. Рекомендуется, чтобы экземпляры Взаимодействия были закрыты явно, чтобы освободить любые сохраненные ресурсы.

Броски:

ResourceException - Отказавший, чтобы закрыть экземпляр Взаимодействия. Вызов близко на уже закрытое Взаимодействие должен также выдать это исключение.

getConnection

Connection getConnection()

Связали Соединение со Взаимодействием.

Возвраты:

Экземпляр соединения связался со Взаимодействием

выполниться

boolean execute(InteractionSpec ispec,
                Record input,
                Record output)
                throws ResourceException

Выполняет взаимодействие, представленное InteractionSpec. Эта форма вызова берет входную Запись и обновляет выходную Запись.

Параметры:

ispec - InteractionSpec, представляющий целевой модуль данных/функции EIS

input - Входная Запись

output - Выходная Запись

Возвраты:

истина, если выполнение функции EIS было успешно и выходная Запись, была обновлена; ложь иначе

Броски:

ResourceException - Исключение, если выполняют сбои работы. Примеры ошибочных случаев:

• Адаптер ресурса, внутренний, специфичный для EIS или коммуникационная ошибка
• Недопустимая спецификация InteractionSpec, структуры записи ввода или вывода
• Ошибки в использовании Записи ввода или вывода
• Недопустимое соединение связалось с этим Взаимодействием

NotSupportedException - Работа, не поддерживаемая

выполниться

Record execute(InteractionSpec ispec,
               Record input)
               throws ResourceException

Выполняет взаимодействие, представленное InteractionSpec. Эта форма вызова берет входную Запись и возвращает выходную Запись, если выполнение Взаимодействия было successfull.

Параметры:

ispec - InteractionSpec, представляющий целевой модуль данных/функции EIS

input - Входная Запись

Возвраты:

выходная Запись, если выполнение функции EIS было успешно; нуль иначе

Броски:

ResourceException - Исключение, если выполняют сбои работы. Примеры ошибочных случаев:

• Адаптер ресурса, внутренний, специфичный для EIS или коммуникационная ошибка
• Недопустимая спецификация InteractionSpec или ввода записывает структуру
• Ошибки в использовании входной Записи или создании выходной Записи
• Недопустимое соединение связалось с этим Взаимодействием

NotSupportedException - Работа, не поддерживаемая

getWarnings

ResourceWarning getWarnings()
                            throws ResourceException

Получает первый ResourceWarning от цепочки предупреждений, связанных с этим экземпляром Взаимодействия.

Возвраты:

ResourceWarning наверху цепочки предупреждения

Броски:

ResourceException - Отказавший, чтобы связать ResourceWarnings со Взаимодействием

clearWarnings

void clearWarnings()
                   throws ResourceException

Очищает все предупреждение, о котором сообщает этот экземпляр Взаимодействия. После звонка в этот метод метод getWarnings возвратит нуль, пока о новом предупреждении не сообщат для этого Взаимодействия.

Броски:

ResourceException - Отказавший, чтобы очистить ResourceWarnings, связанный со Взаимодействием