Eigenschaften für dynamische SQL-Erweiterung angepasster Finder

Verwenden Sie diese Seite, um die Eigenschafteneinstellungen für dynamische SQL-Erweiterung angepasster Finder zu ändern.

Um sicherzustellen, dass die dynamischen SQL-Erweiterungen (Structured Query Language) für die angepassten Finder, die in einer Home-Schnittstelle der EJB Version 1.1 definiert sind und einen Back-End-Datenspeicher verwenden, ordnungsgemäß angewendet werden, werden die folgenden Eigenschaften für die JVM (Java Virtual Machine) und Beans (Module) bereitgestellt. Mit diesen Eigenschaften können Sie angeben, welche angepassten Finder erweitert werden sollen, sofern der Back-End-Datenspeicher die SQL-Klauseln unterstützt.

[iSeries] [AIX Solaris HP-UX Linux Windows] Für IBM i und verteilte Plattenformen klicken Sie zum Anzeigen dieser Seite der Administrationskonsole auf Server > Servertypen > WebSphere-Anwendungsserver > Servername > Java- und Prozessverwaltung > Prozessdefinition > Java Virtual Machine > Angepasste Eigenschaften.

[z/OS] Für z/OS klicken Sie zum Anzeigen dieser Seite der Administrationskonsole auf Server > Servertypen > WebSphere-Anwendungsserver > Servername > Steuerung (zum Definieren der Eigenschaft in der Steuerung) oder Servant (zum Definieren der Eigenschaft im Servant) > Java- und Prozessverwaltung > Prozessdefinition > Java Virtual Machine > Angepasste Eigenschaften.

com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent

Mit dieser Eigenschaft können Sie angeben, für welche Enterprise-Beans die dynamische SQL-Erweiterung angepasster Finder zur Laufzeit aktiviert werden soll.

Diese Eigenschaft wird auf Serverebene wirksam. Alle in der Home-Schnittstelle der EJB Version 1.1 definierten angepassten Finder (Präfix find) mit der Zugriffsart Update sind je nach angegebener Isolationsstufe Kandidaten für die dynamische SQL-Erweiterung. Wenn der Back-End-Speicher eine spezielle SQL-Semantik erfordert, wird diese angewendet. Die jeweilig verwendete SQL variiert mit der für die Beans in der Anwendung ausgewählten Isolationsstufe und dem verwendeten Back-End-Datenspeicher. Bei der Eigenschafteneinstellung all wird die dynamische SQL-Erweiterung von allen angepassten Findern aktiviert, die in den im Container installierten Beans definiert sind. Bei der Eigenschafteneinstellung J2EENAME[:J2EENAME] (J2EENAME steht für den vollständig qualifizierten Paket- oder Bean-Namen) wird die die dynamische SQL-Erweiterung nur für die angepassten Finder aktiviert, die in den im Container definierten Beans definiert sind und den angegebenen Bean-Namen entsprechen.

Datentyp String
Einstellmöglichkeiten Gültige Werte sind all und J2EENAME[:J2EENAME]
Standardeinstellung Erweiterungsverhalten nicht aktiv
Anmerkung: Einige Ihrer Anwendungen verwenden möglicherweise angepasste Finder, die manuell codiert wurden und bereits SQL-Sperrklauseln oder die Schlüsselwörter ORDER BY und DISTINCT in der Operation SELECT enthalten. Wenn die Laufzeitumgebung in solchen Fällen eine dynamische SQL-Erweiterung versucht, ist es möglich, dass ungültige SQL-Anweisungen in den zugrundeliegenden Back-End-Datenspeicher eingefügt werden. Falls eine Anwendung solche angepassten Finder enthält, müssen Sie bei der Angabe des Wertes für die JVM-Eigenschaft com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent sehr sorgfältig vorgehen. Der Wert all bewirkt, dass für jede angepasste Finder-Methode, die mit der Zugriffsart Update definiert ist, in allen im Anwendungsserver installierten Beans eine dynamische SQL-Erweiterung durchgeführt wird, woraufhin ungültige SQL-Anweisungen für diese angepassten Finder eingefügt werden.

Um dies zu verhindern, setzen Sie die serverweite Einstellung nicht auf all. Verwenden Sie stattdessen die Eigenschaft der Methodenebene, com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent.methodLevel, um für jede Bean nur die angepassten Finder-Methoden anzugeben, für die zur Laufzeit eine dynamische SQL-Erweiterung durchgeführt werden soll.

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

Mit dieser Eigenschaft wird angegeben, dass eine dynamische SQL-Erweiterung für eine bestimmte Bean auf Methodenebene durchgeführt werden soll.

Ist für eine Bean diese Eigenschaft definiert und werden mit der Eigenschaft angepasste Finder-Methoden angegeben, wird für jeden angepassten Finder (Präfix find), der in der Home-Schnittstelle definiert ist und einen entsprechenden Methodennamen und eine Parametersignatur besitzt, zur Laufzeit die SQL-Sperrsemantik angewendet. Die gilt jedoch nur, wenn die angepasste Finder-Methode die Zugriffsart Update hat und der Back-End-Datenspeicher die SQL-Klauseln unterstützt. Die jeweilig verwendete SQL variiert mit der für die Anwendung ausgewählten Isolationsstufe und dem verwendeten Back-End-Datenspeicher.

Datentyp String
Einstellmöglichkeiten Gültige Werte sind Zeichenfolgen des folgenden Formats: method1(parm1,parm2,..parmn):method2(parm1,parm2,..parmn):methodn(...)



Mit (online) gekennzeichnete Links setzen einen Internet-Zugang voraus.

Zugehörige Tasks
[AIX Solaris HP-UX Linux Windows] [iSeries]


Dateiname: udat_sqllock.html