Свойства динамического расширения пользовательской программы поиска SQL

С помощью этой страницы можно изменить свойства динамического расширения пользовательской программы поиска SQL.

Для правильного выполнения динамических расширений языка структурных запросов (SQL) пользовательских программ поиска, заданных в домашнем интерфейсе EJB 1.1, использующем базовое хранилище данных, требующее особых операторов поиска SQL, предоставляются следующие свойства виртуальной машины Java (JVM) и объекта (модуля). Эти свойства позволяют указать, какую пользовательскую программу поиска следует расширить, исходя из предположения, что базовое хранилище данных поддерживает операторы SQL.

[IBM i] [AIX Solaris HP-UX Linux Windows] Для того чтобы открыть эту страницу административной консоли при работе в IBM i и на распределенных платформах, выберите Серверы > Типы серверов > Серверы приложений WebSphere >имя_сервера > Java и управление процессами > Определение процесса > Виртуальная машина Java > Пользовательские свойства

[z/OS] Для того чтобы открыть эту страницу административной консоли при работе в z/OS, выберите Серверы > Типы серверов > Серверы приложений WebSphere > имя_сервера > Управляющий (для определения свойства в панели Управляющий) или Подчиненный (для определения свойства в панели Управляющий) > Java и управление процессами > Определение процесса > Виртуальная машина Java > Пользовательские свойства.

com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent

Используется для указания объектов EJB для которых при выполнении будет включено динамическое расширение пользовательской программы поиска SQL.

Это свойство действует на уровне сервера. Любая заданная с помощью домашнего интерфейса EJB 1.1 пользовательская программа поиска (с префиксом find), содержащая декларацию доступа Update, является кандидатом на динамическое расширение SQL исходя из указанного уровня изоляции. Если базовому хранилищу данных требуется особая семантика SQL, она применяется. Используемые операторы SQL зависят от выбранного уровня изоляции объектов в приложении, а также используемой базовой базы данных. Если задать значение все, динамическое расширение SQL пользовательской программы поиска будет включено для всех пользовательских программ поиска, заданных во всех объектах, установленных в контейнере. Если задать J2EENAME[:J2EENAME], где J2EENAME - это полное имя пакета или объекта, динамическое расширение SQL пользовательских программ поиска будет включено только для пользовательских программ поиска, заданных в объектах, установленных в контейнере и представленных указанными именами объектов.

Информация	Значение
Тип данных	Строка
Диапазон	Допустимыми значениями являются все или J2EENAME[:J2EENAME]
Значение по умолчанию	Поведение расширения не активно

Прим.: Некоторые приложения могут использовать пользовательские программы поиска, созданные вручную и уже содержащие операторы блокировки SQL или ключевые слова УПОРЯДОЧИТЬ ПО и УТОЧНЕНИЕ в операции ВЫБРАТЬ. В таких случаях при попытке применить динамическое расширение SQL сохраняется вероятность применения некорректных операторов SQL с базовым хранилищем данных. Если приложение содержит подобные пользовательские программы поиска следует с особой осторожностью указывать значение свойства JVM com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent. Значение все приведет к выполнению динамического расширения SQL пользовательской программы поиска для всех методов пользовательских программ поиска, заданных в декларации доступа Update для всех объектов, установленных в сервере приложений, что вызовет ошибки SQL для данного подмножества пользовательских программ поиска.

Для предотвращения этого не задавайте значение на уровне сервера равным все. Вместо этого используйте свойство уровня метода объекта com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent.methodLevel чтобы указать на уровне объектов только те методы пользовательских программ поиска, для которых следует выполнят динамическое расширение SQL при выполнении.

com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent.methodLevel

Используется чтобы указать, что динамическое расширение SQL пользовательских программ поиска включено на уровне метода для определенного объекта.

Если это свойство объекта содержит список из одного или нескольких методов пользовательской программы поиска, все пользовательские программы поиска (с префиксом find), заданные в домашнем интерфейсе с совпадающим именем метода и сигнатурой параметра, содержат семантику блокировки SQL, применяемой при выполнении. Это происходит только если метод пользовательской программы поиска имеет декларацию доступа со значением Update и базовое хранилище данных поддерживает операторы SQL. Используемые операторы SQL зависят от выбранного уровня изоляции для приложения и используемого базового хранилища данных.

Информация	Значение
Тип данных	Строка
Диапазон	Допустимым значением является строка следующего вида:метод1(параметр1,параметр2,..параметрn):метод2(параметр1,параметр2,..параметрn):методn(...)

com.ibm.websphere.persistence.bean.managed.custom.finder.access.intent

Используется пользователями WebSphere Application Server для z/OS версий 4.x, чтобы указать, что функцию расширения SQL не следует применять к приложениям, установленным в продукте WebSphere Application Server для z/OS.

По умолчанию WebSphere Application Server для z/OS версий 4.x выполняет динамическое расширение SQL. Для пользователей z/OS, решивших не при менять динамическое расширение SQL пользовательских программ поиска в продукте версий 4.x, этот атрибут используется для указания их выбора на уровне объекта и сервера.

На уровне объекта пара имя/значение, состоящая из имени этого атрибута и значения true, отключает расширение SQL всех пользовательских программ поиска, заданных в домашнем интерфейсе данного объекта.

На уровне сервера при добавлении записи в файл свойств сервера WebSphere Application Server для z/OS со значением true можно отключить расширение SQL для всех установленных на данном сервере объектов.

Атрибут расширения пользовательской программы поиска по-прежнему поддерживается при выполнении на уровне объекта в продукте. Его применение в качестве индикатора на уровне сервера признано устаревшим из-за того, что по умолчанию в предыдущих версиях динамическое расширение SQL пользовательских программ поиска не выполняется.

Прим.: Если ваша установка WebSphere Application Server для z/OS использует автоматическое динамическое расширение всех пользовательских программ доступа во всех установленных приложениях, следует задать для индикатора com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent значение all. Если приложение содержит объект, индикатор com.ibm.websphere.persistence.bean.managed.custom.finder.access.intent которого имеет значение env-var, этот индикатор по-прежнему будет использоваться, если функции динамического расширения SQL продукта включены, как описано выше.

Информация	Значение
Тип данных	Строка
Диапазон	Допустимыми значениями являются true и false

Замечания относительно приоритета:

Атрибут com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent.methodLevel переопределяет все атрибуты на уровне сервера или объекта
Любой объект, указанный через Имя J2EE в индикаторе com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent, разрешает выполнение динамического расширения пользовательских программ поиска данного объекта если используемое сервером поведения по умолчанию вызывает сомнения.
Атрибут com.ibm.websphere.persistence.bean.managed.custom.finder.access.intent отключает применение определенным объектом данной функции если параметр на уровне сервера или объекта включен и параметр уровня метода не указан.

Имя файла: udat_sqllock.html