Anwendung für Installation durch Programmierung vorbereiten
Die Anwendungsverwaltungsarchitektur des Produkts stellt eine eine Gruppe von Klassen bereit, mit der Anwendungsentwickler WAS-spezifische Implementierungsinformationen, im Folgenden Bindungsinformationen genannt, erfassen und in der EAR-Datei der Anwendung speichern können. Eine solche EAR-Datei kann anschließend in einer Konfiguration von WebSphere Application Server installiert werden. Dazu verwenden Sie die im Abschnitt "Eine Anwendung durch Programmierung installieren" beschriebenen Anwendungsmanagementschnittstellen. In diesem Artikel wird ein Beispiel für die Programmierung verwendet, um zu erläutern, wie eine EAR-Datei mit Bindungsinformationen gefüllt wird.
Vorbereitende Schritte
Diese Task setzt eine grundlegende Vertrautheit mit den Programmierschnittstellen von WebSphere Application Server und der MBean-Programmierung voraus. Lesen Sie die Informationen zu den Programmierschnittstellen von WebSphere Application Server und zur MBean-Programmierung in der Dokumentation zu den Anwendungsprogrammierschnittstellen.
Informationen zu diesem Vorgang
Führen Sie die folgenden Tasks aus, um eine Anwendung für die Installation durch Programmierung vorzubereiten.
Vorgehensweise
- Erstellen Sie einen AppDeploymentController. Der AppDeploymentController verwendet eine EAR-Datei als Argument und erstellt eine Schrittfolge, dargestellt durch AppDeploymentTask-Objekte (im Folgenden als Tasks bezeichnet). Normalerweise werden die Tasks über das Programm bearbeitet oder dem Implementierer verfügbar gemacht, damit er Bindungsinformationen erfassen kann. Der folgende Codeauszug zeigt, wie eine AppDeploymentController-Instanz erstellt wird:
// Vorgaben erstellen, die in den Ländereinstellungsinformationen übergeben werden sollen Hashtable prefs = new Hashtable(); prefs.put(AppConstants.APPDEPL_LOCALE, Locale.getDefault()); // Controllerinstanz für eine EAR-Datei erstellen, die durch einen vollständig // qualifizierten Pfad in earName angegeben ist AppDeploymentController flowController = AppManagementFactory.readArchive (earName, prefs);
- AppDeploymentTask-Instanzen abrufen. Wenn Sie
AppDeploymentController erstellt haben, können Sie über die erstellten Taskobjekte iterieren. Jede Task
erfasst Bindungsinformationen eines bestimmten Typs für verschiedene Module in der Anwendung oder für die Anwendung selbst.
Eine Task kann die folgenden Attribute und, falls zutreffend, entsprechende Getter und Setter haben. Weitere Informationen
zu diesen Attributen finden Sie in der Javadoc zur API "AppDeploymentTask".
Tabelle 1. Taskattribute. In der folgenden Tabelle werden die möglichen Attribute einer AppDeploymentController-Task beschrieben: Name Beschreibung Wert appController Eine Controllerinstanz, die Tasks verwaltet. AppDeploymentController colNames Die Spaltennamen der Task. java.lang.String[] hasHiddenColumns Gibt an, ob die Task verdeckte Spalten hat. boolean HiddenColumns Ein Array mit booleschen Ausdrücken, der angibt, dass diese Spalten von dem Tool, das die Tasks dem Endbenutzer anzeigt, nicht dargestellt werden soll. boolean[] HIGHEST_VERSION Public static final java.lang.String HIGHEST_VERSION static java.lang.String isSufficientlyDone Gibt an, ob die Task erforderliche Daten hat, die nicht angegeben sind. boolean isTaskDisabled Gibt an, ob die Task angezeigt oder geändert werden soll. boolean isTaskEmpty Gibt an, ob die Task Daten enthält. boolean isValidationEnabled Gibt an, ob die Task validiert werden soll. boolean mutables Ein Array mit booleschen Ausdrücken, der angibt, ob die Taskdaten in einem bestimmten Spaltenindex von der Person, die die Anwendung implementiert, geändert werden kann. boolean[] name Ein eindeutiger Taskname. java.lang.String requiredColumns Ein Array mit booleschen Ausdrücken, der angibt, ob eine Taskspalte einen Wert ungleich null haben muss. boolean[] taskData Ein zweidimensionaler Array (Tabelle) mit Zeichenfolgen. Die erste Zeile der Tabelle enthält die Spaltenüberschriften für die Task (z. B. den Namen des Moduls, den Modul-URI, den JNDI-Namen etc.). Die restlichen Zeilen enthalten anwendungsspezifische Informationen. java.lang.String[] taskValidateErrorMessages Die Fehlernachrichten, die generiert werden, wenn eine Task validiert wird. java.lang.String[] VERSION_HIGHEST public static final int VERSION_HIGHEST static int In der folgenden Tabelle sind verschiedene Tasknamen aufgelistet, die normalerweise vom AppDeploymentController für eine J2EE 1.2-, eine J2EE 1.3- oder eine Java™ EE 5-Anwendung (oder höher) erstellt werden. Möglicherweise sind mehr Tasks vorhanden, wenn die Anwendung WAS-Unternehmenserweiterungen enthält.
Tabelle 2. Tasknamen, die normalerweise vom AppDeploymentController für eine J2EE 1.2-, eine J2EE 1.3- oder eine Java EE 5-Anwendung (oder höher) erstellt werden.. In der folgenden Tabelle sind die Namen der Tasks aufgelistet, die normalerweise vom AppDeploymentController für eine J2EE 1.2-, eine J2EE 1.3- oder eine Java EE 5-Anwendung (oder höher) erstellt werden. Es sind auch Beschreibungen und die Spaltennamen der Tasks angegeben. AppDeploymentTask-Name Beschreibung Spaltennamen der Task MapRolesToUsers Ermöglicht Ihnen, Benutzer oder Gruppen für eine Sicherheitsrolle anzugeben. Sie müssen jede in der Anwendung oder im Modul definierte Rolle über die Benutzerregistry der Domäne einem Benutzer oder einer Gruppe zuordnen. Jede Zeile mit Taskdaten stellt eine Sicherheitsrolle dar. Sie können mehrere Benutzer oder Gruppen für eine einzelne Rolle angeben, indem Sie sie mit einem Anführungszeichen (") voneinander trennen. - role - Listet die Berechtigungen auf, die einem Benutzer zugeordnet werden. Die Rollenberechtigungen geben Benutzern und Gruppen die Möglichkeit, Operationen unter einer festgelegten Identität (RunAs) auszuführen.Sie können beispielsweise den Benutzer Joe der Administratorrolle zuordnen. Damit kann der Benutzer Joe alle Tasks ausführen, die der Administratorrolle zugeordnet sind. Die Berechtigungsrichtlinie wird nur bei Aktivierung der globalen Sicherheitseinrichtung umgesetzt.
- everyone - Gibt an, ob alle Benutzer einer angegebenen Rolle zugeordnet werden sollen.
- allAuthenticatedUsers - Gibt an, ob alle authentifizierten Benutzer unabhängig vom Realm einer bestimmten Rolle zugeordnet werden sollen.
- mappedUsers - Listet die Benutzer auf, die der angegebenen Rolle in dieser Anwendung zugeordnet sind.
- mappedGroups Gruppen - Listet die Gruppen auf, die der angegebenen Rolle in dieser Anwendung zugeordnet sind.
- AllAuthenticatedInTrustedRealms - Gibt an, ob alle Benutzer in den anerkannten Realms einer bestimmten Rolle zugeordnet werden sollen.
- userAccessIds - Gibt die Benuzerdaten an, die bei Verwendung der WAS-Berechtigungsengine für die JEE-Berechtigung (Java Platform, Enterprise Edition) verwendet werden. Das Format für userAccessIds ist user:realm/uniqueUserID.
- groupAccessIds - Gibt die Gruppeninformationen an. Das accessId-Format für die Gruppe lautet wie folgt: "group:realm/uniqueGroupID".
- Mapped users access ids - Gibt die Zugriffs-IDs zugeordneter Benutzer an.
- Mapped groups access ids - Gibt die Zugriffs-IDs zugeordneter Gruppen an.
MapRunAsRolesToUsers Ermöglicht die Angabe von Berechtigungsnachweisen für eine RunAs-Rolle. Die Enterprise-Beans, die Sie installieren, enthalten vordefinierte RunAs-Rollen. RunAs-Rollen werden von Enterprise-Beans verwendet, die bei der Interaktion mit einer anderen Enterprise-Bean mit einer bestimmten Rolle ausgeführt werden müssen. Jede Zeile mit Taskdaten stellt eine RunAs-Rolle dar. - role - Listet die spezifischen Funktionen für einen Benutzer auf. Die Berechtigungsrichtlinie wird nur bei Aktivierung der globalen Sicherheitseinrichtung umgesetzt.
- userName - Gibt einen Benutzernamen für den Benutzer der RunAs-Rolle an. Dieser Benutzer ist bereits einer für die Task "MapRolesToUsers" angegebenen Rolle zugeordnet. Sie können den Benutzer seiner Rolle zuordnen, indem Sie den Benutzer direkt dieser Rolle zuordnen oder eine Gruppe zuordnen, die den Benutzer für diese Rolle enthält.
- password - Gibt das Kennwort für den RunAs-Benutzer an.
BindJndiForEJBNonMessageBinding Ermöglicht die Angabe von JNDI-Namen für Enterprise JavaBeans. Dieser JNDI-Name wird verwendet, um EJB-Homes mit Clientprogrammen zu suchen. Eine Zeile mit Taskdaten gibt jeweils eine EJB an, für die ein JNDI-Name angegeben werden kann. - EJBModule - Gibt das EJB-Modul an, das die Enterprise-Beans enthält, die an den JNDI-Namen gebunden werden sollen.
- EJB - Gibt den Namen einer Enterprise-Bean im Modul an.
- uri - Der Uniform Resource Identifier (URI) gibt die Position des Modularchivs relativ zum Stammverzeichnis der EAR-Datei der Anwendung an.
- JNDI - Gibt den JNDI-Namen der Enterprise-Bean in einem EJB-Modul an.
BindJndiForEJBMessageBinding Ermöglicht die Angabe eines Listener-Port-Namens oder einer JNDI einer Aktivierungsspezifikation für Message-driven Beans (MDBs). Vergewissern Sie sich, dass jede MDB in der Anwendung oder im Modul an den Namen eines Listener-Ports oder die JNDI einer Aktivierungsspezifikation gebunden ist. Jede Zeile mit Taskdaten stellt eine Message-driven Bean dar. - EJBModule - Gibt das Enterprise JavaBeans-Modul an, das die Enterprise-Bean enthält.
- EJB - Gibt den Namen einer MDB in der Anwendung an.
- uri - Der Uniform Resource Identifier (URI) gibt die Position des Modularchivs relativ zum Stammverzeichnis der EAR-Datei der Anwendung an.
- listenerPort - Gibt den Namen eines Listener-Ports für die MDB an.
- actSpecJNDI - Gibt den JNDI-Namen einer Aktivierungsspezifikation für die MDB an. Wenn Sie eine MDB an den JNDI-Namen einer Aktivierungsspezifikation binden, können Sie auch den JNDI-Namen des Ziels und den Authentifizierungsalias angeben.
- actSpecDestinationJNDI - Gibt den JNDI-Namen eines Ziels für die Aktivierungsspezifikation an.
- actSpecAuth - Gibt einen Authentifizierungsalias an, der verwendet wird, um auf eine Kombination aus Benutzername und Kennwort, die in der konfigurierten J2C-Aktivierungsspezifikation definiert ist, zuzugreifen.
BindJndiForEJBBusiness Ermöglicht die Angabe von JNDI-Namensbindungen für jede Enterprise-Bean mit einer Geschäftsschnittstelle in einem EJB-Modul. Jede Enterprise-Bean mit einer Geschäftsschnittstelle in einem EJB-Modul muss an einen JNDI-Namen gebunden werden. Eine Zeile mit Taskdaten gibt jeweils eine Enterprise-Bean an, für die ein JNDI-Name angegeben werden kann. - EJBModule - Gibt das EJB-Modul an, das die Enterprise-Beans enthält, die an den JNDI-Namen gebunden werden sollen.
- EJB - Gibt den Namen einer Enterprise-Bean an, die an den JNDI-Namen gebunden werden soll.
- uri - Der Uniform Resource Identifier (URI) gibt die Position des Modularchivs relativ zum Stammverzeichnis der EAR-Datei der Anwendung an.
- businessInterface - Gibt die Geschäftsschnittstelle der Enterprise-Bean in einem EJB-Modul an.
- JNDI - Gibt den JNDI-Namen an, der der Enterprise-Bean-Geschäftsschnittstelle in einem EJB-Modul zugeordnet ist.
MapEJBRefToEJB Ermöglicht die Angabe von JNDI-Namen der EJBs, die an ejb-refs gebunden sind. Jede Zeile mit Taskdaten stellt eine in einem Modul definierte ejb-ref dar. Ein EJB 3.0-Modul kann keine CMP- oder BMP-Entity-Beans enthalten. Die Installation schlägt fehl, wenn eine CMP- oder BMP-Entity-Bean in einem EJB 3.0-Modul einer Java EE-Anwendung enthalten ist. CMP- und BMP-Beans können nur in Modulen der EJB Version 2.1 oder früher gepackt werden.
Wenn die EJB-Referenz von einem EJB-Modul der Version 3.0, einem Webmodul der Version 2.4 oder einem Webmodul der Version 2.5 stammt, ist der JNDI-Name optional. Wenn die Option "Automatische Auflösung von EJB-Referenzzielen zulassen" ausgewählt ist, ist der JNDI-Name für alle Module optional. Die Laufzeitumgebung stellt einen Containerstandardwert bereit oder löst die EJB-Referenz automatisch auf, wenn keine Bindung angegeben ist.
- EJB - Gibt den Namen einer Enterprise-Bean im Modul an.
- uri - Der Uniform Resource Identifier (URI) gibt die Position des Modularchivs relativ zum Stammverzeichnis der EAR-Datei der Anwendung an.
- referenceBinding - Gibt den Namen der EJB-Referenz an, die in der Enterprise-Bean verwendet wird.
- class - Gibt den Namen einer Java-Klasse an, die dieser Enterprise-Bean zugeordnet ist.
- JNDI - Gibt den JNDI-Namen der Enterprise-Bean in einem EJB-Modul an.
MapResRefToEJB Ermöglicht die Angabe von JNDI-Namen für die in der WAS-Konfiguration definierten Ressourcen, die an resource-refs gebunden sind. Jede Zeile mit Taskdaten stellt eine in einem Modul definierte resource-ref dar. - AppVersion - Gibt die Version der Anwendung an.
- ModuleVersion - Gibt die Version des Moduls an.
- Module - Gibt den Namen eines Moduls in der Anwendung an.
- EJB - Gibt den Namen einer Enterprise-Bean an, die die Ressourcenreferenz enthält. (gilt nur für EJB-Module)
- uri - Der Uniform Resource Identifier (URI) gibt die Position des Modularchivs relativ zum Stammverzeichnis der EAR-Datei der Anwendung an.
- referenceBinding - Gibt den Namen einer Ressourcenreferenz im Modul an.
- targetResourceJNDI - Gibt den JNDI-Namen der Ressource an, die das Zuordnungsziel für die Ressourcenreferenz ist.
- Login configuration - Diese Spalte gilt nur für Datenquellen und Verbindungsfactorys
und gibt die Authentifizierungsmethode für das Sichern der Ressource an.
Die Anmeldekonfiguration "DefaultPrincipalMapping" wird von Java 2 Connectors (J2C) verwendet, um Benutzer Principals zuzuordnen, die in J2C-Authentifizierungsdateneinträgen definiert sind. Wenn login.config.name auf DefaultPrincipalMapping gesetzt ist, wird eine Eigenschaft mit dem Namen "com.ibm.mapping.authDataAlias" erstellt. Der Wert der Eigenschaft wird von "authentication.props" gesetzt. Wenn "login.config.name" nicht auf "DefaultPrincipalMapping" gesetzt ist, kann "authentication.props" mehrere Eigenschaften angeben.
- authentication properties - Gibt von der Anmeldekonfiguration verwendete Eigenschaften an. Das Zeichenfolgeformat lautet wie folgt:
websphere:name= <Name1>,value= <Wert1>,description=<Beschr1>
Verwenden Sie das Pluszeichen (+), um mehrere Eigenschaften anzugeben.
- Resource authorization - Gibt den Berechtigungstyp für die Sicherung der Ressource an.
- Extended data source properties - Gibt die erweiterten Datenquelleneigenschaften für eine DB2-Datenbank an. Sie können diese Eigenschaften verwenden, um einer Anwendung die Erweiterung der angepassten Eigenschaften für eine Datenquelle bzw. das Überschreiben von Eigenschaften zu ermöglichen, die keine Basiseigenschaften und für diese Datenquelle bereits vorhanden sind.
MapResEnvRefToRes Ermöglicht die Angabe von JNDI-Namen für die in der WAS-Konfiguration definierten Ressourcen, die an resource-env-refs gebunden sind. Jede Zeile mit Taskdaten stellt eine in einem Modul definierte resource-env-ref dar. - Module - Gibt den Namen eines Moduls in der Anwendung an.
- EJB - Gibt den Namen einer Enterprise-Bean an, die die Ressourcenumgebungsreferenz enthält. (gilt nur für EJB-Module)
- uri - Der Uniform Resource Identifier (URI) gibt die Position des Modularchivs relativ zum Stammverzeichnis der EAR-Datei der Anwendung an.
- referenceBinding - Gibt den Namen einer Ressourcenumgebungsreferenz an. Die Referenz entspricht einer Ressource, die als Ressourcenumgebungseintrag an den JNDI-Namespace des Anwendungsservers gebunden ist.
- resEnvRef.type - Gibt den Typ an, der der Ressourcenumgebungsreferenz zugeordnet ist.
- JNDI - Gibt den JNDI-Namen des Ressourcenumgebungseintrags an, der das Zuordnungsziel der Ressourcenumgebungsreferenz ist.
MapSharedLibForMod Ermöglicht die Zuordnung gemeinsam genutzter Bibliotheken zu einer Anwendung oder einem Webmodul. Eine gemeinsam genutzte Bibliothek ist eine externe Java-Archivdatei (JAR), die von einer oder mehreren Anwendungen verwendet wird. Wenn Sie gemeinsam genutzte Bibliotheken verwenden, können mehrere auf einem Server implementierte Anwendungen eine gemeinsame Bibliothek verwenden, anstatt jeweils eine eigene Kopie derselben Bibliothek. Nachdem Sie gemeinsam genutzte Bibliotheken einer Anwendung oder einem Modul zugeordnet haben, lädt die Anwendung bzw. der Klassenlader Klassen, die von den gemeinsam genutzten Bibliotheken dargestellt werden und stellt diese der Anwendung bzw. dem Modul zur Verfügung. Jede Zeile mit Taskdaten stellt eine Anwendung oder ein Webmodul dar. - application - Gibt den Namen der zu installierenden Anwendung an.
- module - Gibt den Namen des Moduls an, das den gemeinsam genutzten Bibliotheken zugeordnet ist.
- uri - Der Uniform Resource Identifier (URI) gibt die Position des Modularchivs relativ zum Stammverzeichnis der EAR-Datei der Anwendung an.
- sharedLibraries - Gibt den Namen der gemeinsam genutzten Bibliotheksdateien an, die der Anwendung bzw. dem Modul zugeordnet sind.
SharedLibRelationship Ermöglicht Ihnen, Beziehungskennungen und Kompositionseinheitennamen für gemeinsam genutzte Bibliotheken an, auf die Module in Ihrer Unternehmensanwendung verweisen. Wenn Sie Ihre Unternehmensanwendung installieren, erstellt das Produkt eine Kompositionseinheit für jede gemeinsam genutzte Bibliotheksbeziehung in der Geschäftsanwendung, die Sie angegeben haben. Jede Zeile mit Taskdaten stellt eine Anwendung oder ein Webmodul dar. - module - Gibt den Namen des Moduls an, das den gemeinsam genutzten Bibliotheken zugeordnet ist.
- uri - Der Uniform Resource Identifier (URI) gibt die Position des Modularchivs relativ zum Stammverzeichnis der EAR-Datei der Anwendung an.
- relationshipIdentifiers - Gibt ein gemeinsam genutztes Bibliotheksasset oder eine Kompositionseinheitenkennung für die
gemeinsam genutzte Bibliotheksbeziehung des Moduls an.
Das Zeichenfolgeformat lautet wie folgt:
assetname=<Assetname> oder cuname=<KE-Name>
Verwenden Sie das Pluszeichen (+), um mehrere Eigenschaften anzugeben.
- compositionUnit - Gibt den Kompositionseinheitennamen für die gemeinsam genutzte Bibliotheksbeziehung an. Das Produkt verwendet diesen Wert, um der Kompositionseinheit, die es für die gemeinsam genutzte Bibliotheksbeziehung in der Geschäftsanwendung erstellt, einen Namen zuzuweisen. Die Position des Kompositionseinheitennamens wird mit der des Namen des Assets oder der Kompositionseinheitenkennung, der bzw. die im Feld "Beziehung" angegeben ist, abgestimmt.
- matchTarget - Gibt an, ob das Produkt die Kompositionseinheit für die gemeinsam genutzte Bibliotheksbeziehung
demselben Implementierungsziel wie die Geschäftsanwendung zuordnet.
Für diese Spalte sind die folgenden Werte gültig:
- AppConstants.YES_KEY - Gibt an, dass das Produkt die Kompositionseinheit für die gemeinsam genutzte Bibliotheksbeziehung demselben Implementierungsziel zuordnen soll wie die Geschäftsanwendung.
- AppConstants.NO_KEY - Gibt an, dass das Produkt die Kompositionseinheit für die gemeinsam genutzte Bibliotheksbeziehung nicht demselben Implementierungsziel zuordnen soll wie die Geschäftsanwendung.
CtxRootForWebMod Ermöglicht Ihnen, das Kontextstammverzeichnis für Webmodule während oder nach der Installation einer Anwendung in einem Implementierungsziel von WebSphere Application Server anzugeben. Jede Zeile mit Taskdaten stellt ein Webmodul dar. - webModule - Gibt den Namen eines Webmoduls in der Anwendung an, das Sie installieren oder nach der Installation anzeigen möchten.
- uri - Der Uniform Resource Identifier (URI) gibt die Position des Modularchivs relativ zum Stammverzeichnis der EAR-Datei der Anwendung an.
- contextRoot - Gibt das Kontextstammverzeichnis der Webanwendung (WAR) an. Während der Anwendungsassemblierung wird für jedes Webmodul ein Kontextstammverzeichnis im Implementierungsdeskriptor der Anwendung definiert. Der Kontextstamm wird mit der definierten Servletzuordnung (aus der WAR-Datei) zum vollständigen URL kombiniert, den die Benutzer eingeben müssen, um auf das Servlet zugreifen zu können. Beispiel: Wenn das Kontextstammverzeichnis /gettingstarted ist und die Servletzuordnung MeineSitzung lautet, ergibt sich daraus der URL http://host:port/gettingstarted/MeineSitzung.
MapInitParamForServlet Ermöglicht Ihnen, Anfangsparameterwerte für Servlets in Webmodulen während oder nach der Installation einer Anwendung in einem Implementierungsziel von WebSphere Application Server anzugeben. Standardmäßig werden die <param-value>-Werte verwendet, die in den <init-param>-Anweisungen in der Datei "web.xml" der Webmodule angegeben sind. Jede Zeile mit Taskdaten stellt ein Servlet dar. - module - Gibt den Namen eines Moduls in der Anwendung an, das Sie installieren oder nach der Installation anzeigen möchten.
- uri - Der Uniform Resource Identifier (URI) gibt die Position des Modularchivs relativ zum Stammverzeichnis der EAR-Datei der Anwendung an.
- servlet - Gibt einen eindeutigen Namen für das Servlet in der Anwendung an. Sie müssen Servlets in eine WAR-Datei oder ein Webmodul packen, um die Implementierung auf einem Anwendungsserver zu ermöglichen. Servlets werden auf einem Java-fähigen Web-Server ausgeführt und erweitern das Leistungsspektrum des Web-Servers, ähnlich wie es Applets bei Browsern tun.
- name - Gibt den Namen des Anfangsparameters an, der an die Methode init des Servletfilters für Webmodule
übergeben wird.
Die folgende Beispielanweisung des Servletfilters in einer Datei "web.xml" gibt den Namen
"attribute" für den Anfangsparameter an:
<init-param> <param-name>attribute</param-name> <param-value>tests.Filter. DoFilter_Filter.SERVLET_MAPPED </param-value> </init-param>
- value - Gibt den Namen des Anfangsparameters an, der an die Methode init des Servletfilters für Webmodule
übergeben wird.
Die folgende Beispielanweisung des Servletfilters in einer Datei "web.xml"
gibt den Anfangsparameterwert "tests.Filter.DoFilter_Filter.SERVLET_MAPPED"
für den Anfangsparameter "attribute" an:
<init-param> <param-name>attribute</param-name> <param-value>tests.Filter. DoFilter_Filter.SERVLET_MAPPED </param-value> </init-param>
- description - Gibt Informationen zum Anfangsparameter an.
MapEnvEntryForEJBMod Ermöglicht Ihnen, die Umgebungseinträge für EJB-Module (Enterprise JavaBeans™), z. B. Entity-Beans, Session-Beans oder Message-driven-Beans, zu konfigurieren. Jede Zeile mit Taskdaten stellt einen in einem EJB-Modul definierten Umgebungseintrag dar. - module - Gibt den Namen eines EJB-Moduls an.
- uri - Der Uniform Resource Identifier (URI) gibt die Position des Modularchivs relativ zum Stammverzeichnis der EAR-Datei der Anwendung an.
- EJB - Gibt den Namen einer Enterprise-Bean im Modul an.
- name - Gibt den Namen des Umgebungseintrags an, den Sie bearbeiten oder anzeigen möchten. Der Umgebungseintrag ist die Eigenschaft "env-entry" im EJB-Modul.
- type - Gibt einen Datentyp für den mit der Eigenschaft "env-entry" im EJB-Modul definierten Umgebungseintrag an.
- description - Gibt Informationen zum Umgebungseintrag an.
- value - Gibt einen editierbaren Wert für den mit der Eigenschaft "env-entry" im EJB-Modul definierten Umgebungseintrag an.
MapEnvEntryForWebMod Ermöglicht Ihnen, die Umgebungseinträge für Webmodule, z. B. Servlets und JSP-Dateien (JavaServer Pages), zu konfigurieren. Jede Zeile mit Taskdaten stellt einen in einem Webmodul definierten Umgebungseintrag dar. - module - Gibt den Namen eines Webmoduls an.
- uri - Der Uniform Resource Identifier (URI) gibt die Position des Modularchivs relativ zum Stammverzeichnis der EAR-Datei der Anwendung an.
- name - Gibt den Namen des Umgebungseintrags an, den Sie bearbeiten oder anzeigen möchten. Der Umgebungseintrag ist die Eigenschaft "env-entry" im Webmodul.
- type - Gibt einen Datentyp für den mit der Eigenschaft "env-entry" im Webmodul definierten Umgebungseintrag an.
- description - Gibt Informationen zum Umgebungseintrag an.
- value - Gibt einen editierbaren Wert für den mit der Eigenschaft "env-entry" im Webmodul definierten Umgebungseintrag an.
MapMessageDestinationRefToEJB Ermöglicht Ihnen, den JNDI-Namen des verwalteten J2C-Objekts anzugeben, um die Nachrichtenzielreferenz an die MDBs zu binden. Jede Zeile mit Taskdaten stellt eine Nachrichtenzielreferenz in einem Modul dar. - module - Gibt den Namen eines EJB-Moduls an.
- EJB - Gibt den Namen von Message-driven Beans (MDBs) im Modul an.
- uri - Der Uniform Resource Identifier (URI) gibt die Position des Modularchivs relativ zum Stammverzeichnis der EAR-Datei der Anwendung an.
- messageDestinationObject - Gibt den Namen der Nachrichtenzielreferenz oder, falls angegeben, den Nachrichtenziellink an.
- JNDI - Gibt die Ziel-JNDI der referenzierten Nachrichtenziel-Bean an. Wenn ein Nachrichtenziellink angegeben ist, wird in diesem Feld standardmäßig die Ziel-JNDI der Message-driven Bean angegeben, auf die der Nachrichtenziellink verweist.
DataSourceFor10EJBModules Ermöglicht Ihnen, den JNDI-Namen der Standarddatenquelle anzugeben, die für ein EJB-Modul, das EJB-1.x-Beans enthält, verwendet wird. Jede Zeile mit Taskdaten stellt ein EJB-Modul dar. - EJBModule - Gibt den Namen des Moduls an, das die Enterprise-Beans der Version 1.x enthält.
- uri - Der Uniform Resource Identifier (URI) gibt die Position des Modularchivs relativ zum Stammverzeichnis der EAR-Datei der Anwendung an.
- JDNI - Gibt den JNDI-Namen der Standarddatenquelle für das EJB-Modul an.
- userName - Gibt den Benutzernamen an, der zusammen mit dem Kennwort, den Authentifizierungsalias für das Sichern der Datenquelle umfasst.
- password - Gibt das Kennwort an, das zusammen mit dem Benutzernamen, den Authentifizierungsalias für das Sichern der Datenquelle umfasst.
- Login configuration - Gibt die Authentifizierungsmethode für die Sicherung der Datenquelle an.
- authentication properties - Gibt von der Anmeldekonfiguration verwendete Eigenschaften an. Das Zeichenfolgeformat lautet wie folgt:
websphere:name= <Name1>,value=<Wert1>, description=<Beschr1>
Verwenden Sie das Pluszeichen (+), um mehrere Eigenschaften anzugeben.
DataSourceFor20EJBModules Ermöglicht Ihnen, den JNDI-Namen der Standardverbindungsfactory anzugeben, die für ein EJB-Modul, das EJB-2.x-Beans enthält, verwendet wird. Jede Zeile mit Taskdaten stellt ein EJB-Modul dar. - EJBModule - Gibt den Namen des Moduls an, das die Enterprise-Beans der Version 1.x enthält.
- uri - Der Uniform Resource Identifier (URI) gibt die Position des Modularchivs relativ zum Stammverzeichnis der EAR-Datei der Anwendung an.
- JDNI - Gibt den JNDI-Namen der Standarddatenquelle für das EJB-Modul an.
- Resource authorization - Gibt den Berechtigungstyp für die Sicherung der Ressource an. Gültige Werte:
undAppConstants.APPDEPL_CMPBINDING_ RESAUTHTYPE_CONTAINER
.AppConstants.APPDEPL_CMPBINDING_ RESAUTHTYPE_PER_CONNECTION_FACTORY
- Login configuration - Gibt die Authentifizierungsmethode für die Sicherung der Datenquelle an.
- authentication properties - Gibt von der Anmeldekonfiguration verwendete Eigenschaften an. Das Zeichenfolgeformat lautet wie folgt:
websphere:name= <Name1>,value=<Wert1>, description=<Beschr1>
Verwenden Sie das Pluszeichen (+), um mehrere Eigenschaften anzugeben.
- Extended data source properties - Gibt die erweiterten Datenquelleneigenschaften für eine DB2-Datenbank an.
Sie können diese Eigenschaften verwenden, um einer Anwendung die Erweiterung der angepassten Eigenschaften für eine Datenquelle bzw. das Überschreiben von Eigenschaften zu ermöglichen, die keine Basiseigenschaften und für diese Datenquelle bereits vorhanden sind.
DataSourceFor10CMPBeans Ermöglicht Ihnen, den JNDI-Namen der Datenquelle anzugeben, die für eine EJB-1.x-Bean mit containergesteuerter Persistenz verwendet werden soll. Jede Zeile mit Taskdaten stellt ein EJB-Modul dar. - EJBModule - Gibt den Namen des Moduls an, das die Enterprise-Beans der Version 1.x enthält.
- EJB - Gibt den Namen einer Enterprise-Bean im Modul an.
- uri - Der Uniform Resource Identifier (URI) gibt die Position des Modularchivs relativ zum Stammverzeichnis der EAR-Datei der Anwendung an.
- JDNI - Gibt den JNDI-Namen der Standarddatenquelle für das EJB-Modul an.
- userName - Gibt den Benutzernamen an, der zusammen mit dem Kennwort, den Authentifizierungsalias für das Sichern der Datenquelle umfasst.
- password - Gibt das Kennwort an, das zusammen mit dem Benutzernamen, den Authentifizierungsalias für das Sichern der Datenquelle umfasst.
- Login configuration - Gibt die Authentifizierungsmethode für die Sicherung der Datenquelle an.
- authentication properties - Gibt von der Anmeldekonfiguration verwendete Eigenschaften an. Das Zeichenfolgeformat lautet wie folgt:
websphere:name= <Name1>,value=<Wert1>, description=<Beschr1>
Verwenden Sie das Pluszeichen (+), um mehrere Eigenschaften anzugeben.
DataSourceFor20CMPBeans Ermöglicht Ihnen, den JNDI-Namen der Verbindungsfactory anzugeben, die für eine EJB-2.x-Bean mit containergesteuerter Persistenz verwendet werden soll. Jede Zeile mit Taskdaten stellt ein EJB-Modul dar. - EJBModule - Gibt den Namen des Moduls an, das die Enterprise-Beans der Version 1.x enthält.
- EJB - Gibt den Namen einer Enterprise-Bean im Modul an.
- uri - Der Uniform Resource Identifier (URI) gibt die Position des Modularchivs relativ zum Stammverzeichnis der EAR-Datei der Anwendung an.
- JDNI - Gibt den JNDI-Namen der Standarddatenquelle für das EJB-Modul an.
- Resource authorization - Gibt den Berechtigungstyp für die Sicherung der Ressource an. Gültige Werte:
undAppConstants.APPDEPL_CMPBINDING_ RESAUTHTYPE_CONTAINER
.AppConstants.APPDEPL_CMPBINDING_ RESAUTHTYPE_PER_CONNECTION_FACTORY
- Login configuration - Gibt die Authentifizierungsmethode für die Sicherung der Datenquelle an.
- authentication properties - Gibt von der Anmeldekonfiguration verwendete Eigenschaften an. Das Zeichenfolgeformat lautet wie folgt:
websphere:name= <Name1>,value=<Wert1>, description=<Beschr1>
Verwenden Sie das Pluszeichen (+), um mehrere Eigenschaften anzugeben.
- Extended data source properties - Gibt die erweiterten Datenquelleneigenschaften für eine DB2-Datenbank an.
Sie können diese Eigenschaften verwenden, um einer Anwendung die Erweiterung der angepassten Eigenschaften für eine Datenquelle bzw. das Überschreiben von Eigenschaften zu ermöglichen, die keine Basiseigenschaften und für diese Datenquelle bereits vorhanden sind.
MapWebModToVH Ermöglicht Ihnen, virtuelle Hosts für Webmodule anzugeben. Jede Zeile mit Taskdaten stellt ein Webmodul in der Anwendung dar, für die Informationen zu virtuellen Hosts erfasst werden sollen. Webmodule können auf demselben virtuellen Host installiert oder auf mehrere virtuelle Hosts verteilt werden. Jede Zeile mit Taskdaten stellt ein Webmodul dar. - webModule - Gibt den Namen eines Webmoduls in der Anwendung an, das Sie installieren oder nach der Installation anzeigen möchten.
- uri - Der Uniform Resource Identifier (URI) gibt die Position des Modularchivs relativ zum Stammverzeichnis der EAR-Datei der Anwendung an.
- virtualHost - Gibt den Namen des virtuellen Hosts an, dem das Webmodul derzeit zugeordnet ist.
Verwenden Sie nicht denselben virtuellen Host für unterschiedliche Webmodule, die denselben Stammkontext haben und in Zielen implementiert sind, die zu demselben Knoten gehören, selbst wenn die Webmodule in unterschiedlichen Anwendungen enthalten sind. Es treten Validierungsfehler auf, wenn sie denselben virtuellen Host angeben.
EnsureMethodProtectionFor10EJB Ermöglicht Ihnen, anzugeben, dass für alle ungeschützten Methoden eines EJB-1.x-Moduls der Zugriff verweigert werden soll. Jede Zeile mit Taskdaten entspricht einem EJB-1.x-Modul. - EJBModule - Gibt den Namen des Moduls an, das die EJB-2.x-Beans enthält.
- uri - Der Uniform Resource Identifier (URI) gibt die Position des Modularchivs relativ zum Stammverzeichnis der EAR-Datei der Anwendung an.
- method.denyAllAccessPermission - Gibt eine der folgenden Zugriffsschutzmethoden an:
- AAppConstants.YES_KEY - Gibt an, dass dieses EJB-Modul geschützt werden soll, indem allen Benutzern unabhängig von deren Zugriffsberechtigungen der Zugriff verweigert wird.
- AppConstants.NO_KEY - Gibt an, dass dieses EJB-Modul Benutzern, die die entsprechenden Zugriffsberechtigungen haben zugänglich gemacht werden soll.
EnsureMethodProtectionFor20EJB Ermöglicht Ihnen, die Zugriffsschutzebene für ungeschützte Methoden von EJB-2.x-Beans in EJB-Modulen anzugeben. Jede Zeile mit Taskdaten gibt den Methodenschutz für ein EJB-Modul an. - EJBModule - Gibt den Namen des Moduls an, das die EJB-2.x-Beans enthält.
- uri - Der Uniform Resource Identifier (URI) gibt die Position des Modularchivs relativ zum Stammverzeichnis der EAR-Datei der Anwendung an.
- method.protectionType - Gibt eine der folgenden Zugriffsschutzmethoden an:
- AppConstants.APPDEPL_METHOD_PROTECTION_UNCHECK - Gibt an, dass der Anwendungsserver die Zugriffsberechtigungen für das EJB-Modul nicht prüfen soll. Damit kann jeder auf das EJB-Modul zugreifen.
- AppConstants.APPDEPL_METHOD_PROTECTION_EXCLUDE - Gibt an, dass dieses EJB-Modul geschützt werden soll, indem allen Benutzern unabhängig von deren Zugriffsberechtigungen der Zugriff verweigert wird.
AppDeploymentOptions Ermöglicht Ihnen, verschiedene implementierungsspezifische Optionen anzugeben. Diese Task hat nur zwei Zeilen. Die erste Zeile gibt den Optionsnamen und die zweite den entsprechenden Optionswert an. Für diese Optionen sind folgende Werte gültig, falls in der Optionsbeschreibung nicht anders angegeben: - AppConstants.YES_KEY - Gibt an, dass diese Implementierungsoption verwendet werden soll.
- AppConstants.NO_KEY - Gibt an, dass diese Implementierungsoption nicht verwendet werden soll.
Folgende Optionsnamen können angegeben werden: - preCompileJSPs - Gibt an, ob die JSP-Dateien (JavaServer Pages) vorkompiliert sind.
- installed.ear.destination - Gibt das Verzeichnis an, in dem die EAR-Datei installiert werden soll. Für diese Option wird als Wert ein vollständig qualifizierter Verzeichnispfad wie z. B. Profilstammverzeichnis/installedApps/mycell/myapp.ear eingegeben.
- distributeApp - Gibt an, ob die Anwendungsverwaltungskomponente Binärdateien von Anwendungen verteilt.
- useMetaDataFromBinary - Gibt an, ob die zur Laufzeit verwendeten Metadaten, z. B. Implementierungsdeskriptoren, Bindungen, Erweiterungen usw. aus der EAR-Datei stammen müssen.
- deployejb - Gibt an, dass das Tool "EJBDeploy" während der Installation ausgeführt werden soll.
- appname - Gibt den Namen der Anwendung an, die Sie mit diesen Optionen implementieren möchten.
- createMBeansForResources - Gibt an, ob MBeans für alle in einer Anwendung definierten Ressourcen, z. B. Servlets, JSP-Dateien (JavaServer Pages) und Enterprise-Beans, erstellt werden, wenn die Anwendung in einem Implementierungsziel gestartet wird.
- reloadEnabled - Gibt an, dass das Dateisystem der Anwendung nach aktualisierten Dateien durchsucht wird, damit Änderungen dynamisch neu geladen werden.
- reloadInterval - Gibt den Zeitraum an (in Sekunden), in dem das Dateisystem der Anwendung nach aktualisierten Dateien durchsucht wird. Der für diese Option angegebene Wert ist eine Ganzzahl größer als Null.
- eployws - Gibt an, dass das Tool "wsdeploy" während der Implementierung ausgeführt werden soll.
- validateinput - Gibt an, ob das Produkt die Anwendungsreferenzen, die während der Anwendungsinstallation oder -aktualisierung angegeben werden, überprüft und, falls die Validierung aktiviert ist, auf ungültige Referenzen hinweist oder die Operation mit einem Fehler abbricht. Gültig sind folgende Werte: AppConstants.APPDEPL_VALIDATE_INSTALL_OFF, AppConstants.APPDEPL_VALIDATE_INSTALL_WARM und AppConstants.APPDEPL_VALIDATE_INSTALL_FAIL.
- processEmbeddedConfig - Gibt an, ob die eingebettete Konfiguration verarbeitet werden soll. Eine eingebettete Konfiguration enthält Dateien wie "resource.xml" und "variables.xml".
- filepermission - Gibt Zugriffsberechtigungen für die Binärdateien installierter Anwendungen an, die im angegebenen Verzeichnis entpackt werden.
- blaname - Gibt an, ob das Produkt eine neue Geschäftsanwendung mit der Unternehmensanwendung erstellt, die Sie installieren möchten, oder die Unternehmensanwendung zu einer Kompositionseinheit einer vorhandenen Geschäftsanwendung macht.
- autolink - Gibt an, ob das Produkt für unvollständige EJB-Referenzziele JNDI-Standardwerte zuordnet oder diese unvollständigen Ziele automatisch auflöst.
JSPReloadForWebMod Ermöglicht Ihnen, das erneute Laden von Klassen für Webmodule, wie z. B. JSP-Dateien (JavaServer Pages), zu konfigurieren und eine JSF-Implementierung für diese Anwendung auszuwählen. Jede Zeile mit Taskdaten stellt ein Webmodul dar. - webModule - Gibt den Namen eines Webmoduls in der Anwendung an, das Sie installieren oder nach der Installation anzeigen möchten.
- uri - Der Uniform Resource Identifier (URI) gibt die Position des Modularchivs relativ zum Stammverzeichnis der EAR-Datei der Anwendung an.
- enableJSPClassReloading - Gibt an, ob Klassen erneut geladen werden sollen, wenn JSP-Dateien aktualisiert werden.
- JSPReloadInterval - Gibt an, um festzulegen, wie oft (in Sekunden) das Produkt das Dateisystem scannt, um nach aktualisierten JSP-Dateien für die Anwendung zu suchen.
EJBDeployOptions Ermöglicht Ihnen, Optionen für das EJB-Implementierungstool anzugeben. Das Tool generiert Code, der für die Ausführung von Enterprise-Bean-Dateien erforderlich ist. In dieser Anzeige können Sie für die Ausführung des EJB-Implementierungstool einen zusätzlichen Klassenpfad sowie zusätzliche RMIC-Optionen (Remote Invocation Method Compiler), Datenbanktypen und Namen von Datenbankschemata angeben. - deployejb.classpath - Gibt den Klassenpfad einer oder mehrerer komprimierter Dateien oder JAR-Dateien an, von denen die zu installierende JAR- oder EAR-Datei abhängig ist.
- deployejb.rmic - Gibt an, ob das EJB-Implementierungstool RMIC-Optionen an den RMI-Compiler (Remote Method Invocation)
übergibt. Weitere Informationen zu den Optionen finden Sie in der Dokumentation zu den RMI-Tools.
Für diese Spalte sind die folgenden Werte gültig:
- AAppConstants.YES_KEY - Ermöglicht dem EJB-Implementierungstool, RMIC-Optionen an den RMI-Compiler (Remote Method Invocation) zu übergeben.
- AppConstants.NO_KEY - Verhindert, dass der EJB-Implementierungstool RMIC-Optionen an den RMI-Compiler (Remote Method Invocation) übergibt.
- deployejb.dbtype - Gibt den Namen des Datenbankanbieters an, der verwendet wird, um Typen der Datenbankspalten, Zuordnungsinformationen (Table.sql) und weitere Informationen zu bestimmen. Wenn Sie einen Datenbanktyp angeben, werden zuvor definierte Back-End-IDs für alle EJB-Module durch den ausgewählten Datenbanktyp überschrieben. Wenn Sie Back-End-IDs für einzelne EJB-Module aktivieren möchten, geben Sie für diese Spalte keinen Wert an.
- deployejb.dbschema - Gibt den Namen des zu erstellenden Schemas an. Das EJB-Implementierungstool speichert Datenbankinformationen im Schemadokument
in der JAR- bzw. EAR-Datei, d. h., die Optionen müssen nicht erneut angegeben werden.
Dies bedeutet auch, dass beim Generieren einer JAR- oder EAR-Datei die korrekte Datenbank
definiert werden muss, weil sie später nicht mehr geändert werden kann. Wenn der Name des Schemas Leerzeichen enthält, muss der gesamte Name in doppelte Anführungszeichen eingeschlossen werden.
Beispiel:
"mein Schema"
- deployejb.dbaccesstype - Gibt den Datenbankzugriffstyp für eine DB2-Datenbank an, die Structured Query Language for Java (SQLJ) unterstützt. Verwenden Sie SQLJ, um Datenzugriffsanwendungen zu entwickeln, die eine Verbindung zu DB2-Datenbanken herstellen. SQLJ ist ein Satz von Programmierweiterungen, die die Verwendung der Programmiersprache Java für die Einbettung von Anweisungen für SQL-Datenbankanforderungen (Structured Query Language) unterstützen.
- deployejb.SQLJclasspath - Gibt den Klassenpfad der DB2-SQLJ-Tooldatei "sqlj.zip" an. Das Produkt verwendet diesen Klassenpfad, um das DB2-SQLJ-Tool während der Anwendungsinstallation auszuführen und SQLJ-Profile (Dateien mit der Erweiterung ".ser") zu generieren.
- deployejb.JDKcompliancelevel - Gibt die Konformitätsversion des JDK-Compilers an, wenn Sie Anwendungsquellendateien für die Kompilierung einschließen.
JSPCompileOptions Ermöglicht Ihnen, verschiedene Optionen für den JSP-Compiler (JavaServer Pages) anzugeben. - webModule - Gibt den Namen eines Webmoduls in der Anwendung an.
- uri - Der Uniform Resource Identifier (URI) gibt die Position des Modularchivs relativ zum Stammverzeichnis der EAR-Datei der Anwendung an.
- JSPclasspath - Gibt einen temporären Klassenpfad an, den der JSP-Compiler für die Kompilierung von
JSP-Dateien während der Anwendungsinstallation verwenden soll. Dieser Klassenpfad wird nicht gespeichert,
wenn die Anwendungsinstallation abgeschlossen ist, und nicht verwendet, wenn die Anwendung ausgeführt wird.
Dieser Klassenpfad wird nur verwendet, um Ressourcen außerhalb der Anwendung anzugeben, die
für die JSP-Kompilierung erforderlich sind und nach der Installation der Anwendung mit anderen
Mitteln (z. B. gemeinsam genutzten Bibliotheken) angegeben werden.
In Network Deployment-Konfigurationen ist dieser Klassenpfad für die Deployment-Manager-Maschine spezifisch.
- useFullPackageNames - Gibt an, ob die JSP-Engine JSP-Klassen mit vollständigen Paketnamen generiert und lädt. Wenn vollständige Paketnamen verwendet werden, können vorkompilierte JSP-Klassendateien als Servlets in der Datei "web.xml" konfiguriert werden, ohne das Attribut "jsp-file" verwenden zu müssen. Werden keine vollständigen Paketnamen verwendet, werden alle JSP-Klassen in demselben Paket generiert, was den Vorteil kürzerer Dateisystempfad hat.
- JDKSourceLevel - Gibt die Quellenebene an, auf der der Java-Compiler JSP-Java-Quellen kompiliert. Wenn Sie den Wert für diese Spalte angeben, müssen Sie das Dezimalzeichen in der Versionsnummer weglassen. Geben Sie beispielsweise "15" für JDK Version 1.5 an.
- disableJSPRuntimeCompilation - Gibt an, ob JSP-Dateien zur Laufzeit nicht übersetzt und kompiliert werden sollen, selbst wenn
keine Datei mit der Erweiterung ".class" vorhanden ist. Für diese Spalte sind die folgenden Werte gültig:
- AAppConstants.YES_KEY - Gibt an, dass die JSP-Laufzeitkompilierung inaktiviert werden soll.
- AppConstants.NO_KEY - Gibt an, dass die JSP-Laufzeitkompilierung nicht inaktiviert werden soll.
MapModulesToServers Ermöglicht Ihnen, die Zielserver oder -cluster für Module in einer Anwendung anzugeben. Jede Zeile mit Taskdaten stellt ein Modul in der Anwendung dar. Das Serverziel wird mit WebSphere:cell=Zellenname,node=Knotenname,server=Servername und das Clusterziel mit WebSphere:cell=Zellenname,cluster=Clustername angegeben. Es können mehrere Ziele für ein bestimmtes Modul angegeben werden. In diesem Fall wird das Pluszeichen (+) als Begrenzer verwendet. Jede Zeile mit Taskdaten stellt ein Modul dar. - Module - Gibt den Namen eines Moduls in der Anwendung an.
- uri - Der Uniform Resource Identifier (URI) gibt die Position des Modularchivs relativ zum Stammverzeichnis der EAR-Datei der Anwendung an.
- Server - Gibt den Zielserver oder -cluster für dieses Modul an.
CorrectUseSystemIdentity Ermöglicht Ihnen, die Systemidentitätseigenschaften für die EJB-Methode (Enterprise JavaBeans™) in Ihrer Anwendung zu verwalten. - role - Gibt die RunAs-Rolle an, die für diese EJB-Methode verwendet wird.
- userName - Gibt einen Benutzernamen für den Benutzer der RunAs-Rolle an. Der Benutzername wird zusammen mit der RunAs-Rolle verwendet, die Sie für die Rolle auswählen.
- password - Gibt das Kennwort an, das dem Benutzernamen in der Benutzerregistry zugeordnet ist.
CorrectOracleIsolationLevel Ermöglicht Ihnen, die Isolationsstufe für den Provider des Oracle-Typs für Ressourcenreferenzen anzugeben, die Ressourcen zugeordnet sind, die eine Oracle-Datenbank mit Back-End-Verarbeitung verwenden. Jede Zeile stellt eine Ressourcenreferenz dar, die einer Oracle-Datenbankressource zugeordnet ist. - Module - Gibt den Namen eines Moduls in der Anwendung an.
- resourceRef - Gibt den Namen einer Ressourcenreferenz an.
- JNDI - Gibt den JNDI-Namen der Ressource an, die das Zuordnungsziel für die Ressourcenreferenz ist.
- isolationLevel - Gibt die Isolationsstufe an, die Sie für den Provider des Oracle-Typs verwenden möchten. Für diese Spalte
können die folgenden beiden Werte angegeben werden:
- rc - Gibt eine JDBC-Isolationsstufe mit Lesen mit COMMIT an.
- s - Gibt eine serialisierbare JDBC-Isolationsstufe an.
ActSpecJNDI Ermöglicht Ihnen, JNDI-Namen für JCA-Objekte eingebetteter Ressourcenadaptermodule anzugeben. - Module - Gibt den Namen eines Moduls in der Anwendung an.
- uri - Der Uniform Resource Identifier (URI) gibt die Position des Modularchivs relativ zum Stammverzeichnis der EAR-Datei der Anwendung an.
- JCA object - Gibt den Namen eines JCA-Objekts für eine J2C-Verbindungsfactory, ein verwaltetes Objekt oder eine Aktivierungsspezifikation an.
- JNDI - Gibt den JNDI-Namen für das JCA-Objekt an.
BackendIdSelection Ermöglicht Ihnen, die Back-End-ID für die JAR-Module der Enterprise-Bean, die CMP-Beans enthalten, zu ändern. Ein JAR-Modul der Enterprise-Bean kann mehrere Back-End-Konfigurationen wie angegeben mit einem Anwendungsassembliertool unterstützen. Diese Task ist hilfreich, wenn Ihre Anwendung EJB-Module enthält, für die mit einem Assembliertool Implementierungscode für mehrere Back-End-Datenbanken generiert wurde. - Module - Gibt den Namen eines EJB-Moduls in der Anwendung an.
- uri - Der Uniform Resource Identifier (URI) gibt die Position des Modularchivs relativ zum Stammverzeichnis der EAR-Datei der Anwendung an.
- ID - Die vorhandene Back-End-ID, die eine Back-End-Datenbank darstellt.
- currentID - Gibt die neue Back-End-ID an, die die zu verwendende Back-End-Datenbank darstellt.
MetadataCompleteForModules Ermöglicht jedem EJB-Modul der Version 3.0 oder Webmodul der Version 2.5, den vollständigen Implementierungsdeskriptor, einschließlich der Implementierungsinformationen aus Annotationen, auszugeben. Anschließend markiert das System den Implementierungsdeskriptor für das Modul als vollständig. Jede Zeile mit Taskdaten stellt ein Modul dar. - module - Gibt den Namen eines EJB-Moduls der Version 3.0 oder eines Webmoduls der Version 2.5 an.
- uri - Der Uniform Resource Identifier (URI) gibt die Position des Modularchivs relativ zum Stammverzeichnis der EAR-Datei der Anwendung an.
- metadataComplete - Gibt an, ob der vollständige Modulimplementierungsdeskriptor, einschließlich
der Implementierungsinformationen aus Annotationen, in XML-Format geschrieben werden.
Wenn "metadataComplete" für einen Modul auf "true" gesetzt wird, gibt
WebSphere den vollständigen Implementierungsdeskriptor, einschließlich der Implementierungsinformationen aus Annotationen, aus.
Für diese Spalte sind die folgenden Werte gültig:
- AppConstants.YES_KEY - Gibt an, dass EJB-Module der Version 3.0 oder Webmodule der Version 2.5 den vollständigen Implementierungsdeskriptor, einschließlich der Implementierungsinformationen aus Annotationen, ausgeben können.
- AppConstants.NO_KEY - Gibt an, dass EJB-Module der Version 3.0 oder Webmodule der Version 2.5 den vollständigen Implementierungsdeskriptor, einschließlich der Implementierungsinformationen aus Annotationen, nicht ausgeben können.
Die Spalte "URI" in verschiedenen Tasks gibt eindeutig ein Modul in der Anwendung an, wobei das Format als Wert verwendet wird. "moduleURI" ist der Name der Moduldatei, die im Implementierungsdeskriptor der Anwendung definiert ist, "ddURI" steht für den URI des Implementierungsdeskriptors im Modul (Standardimplementierungsdeskriptor) bzw. der URI des alternativen Implementierungsdeskriptors für das Modul, wie im Implementierungsdeskriptor der Anwendung definiert. Wenn eine Anwendung beispielsweise ein Webmodul in "MyWeb.war" hat und das Modul einen Standardimplementierungsdeskriptor verwendet, lautet der Wert der Spalte "URI" in verschiedenen Tasks für dieses Modul "MyWeb.war,WEB-INF/web.xml" Daher garantiert der Wert der Spalte "URI" die eindeutige Identifikation eines Moduls.
Der folgende Codeauszug zeigt, wie Tasks von AppDeploymentController abgerufen werden:
AppDeploymentTask task =flowController.getFirstTask(); while (task != null) { // Taskdaten nach Bedarf bearbeiten. task = flowController.getNextTask(); }
- Taskdaten bearbeiten
Anhand des Tasknamens, der Taskspaltennamen und des J2EE-Artefakts, für das Bindungsinformationen angegeben werden müssen, können die Taskdaten geändert werden, falls die entsprechende Spalte als veränderbar markiert ist. Der folgende Beispielcode zeigt, wie Bindungsinformationen für eine bestimmte Task angegeben werden können. In diesem Beispiel werden Benutzer für eine Sicherheitsrolle angegeben: Beachten Sie, dass die Anwendung eine Sicherheitsrolle mit dem Namen "Role1" hat und Sie dieser Rolle die Benutzer "User1" und "User2" zuordnen müssen:
if (task.getName().equals ("MapRolesToUsers") && !task. isTaskDisabled()) { // Spaltenindex für Spalten role und user herausfinden // Zum Ermitteln der Spaltennamen die Tabelle verwenden int roleColumn = -1; int userColumn = -1; String[] colNames = task.getColumnNames(); for (int i=0; i < colNames.length; i++) { if (colNames[i].equals ("role")) roleColumn = i; else if (colNames[i].equals ("role.user")) userColumn = i; } // Über die Taskdaten iterieren; dabei in Zeile 1 beginnen, weil Zeile 0 // die Spaltennamen enthält String[][]data = task.getTaskData(); for (int i=1; i < data.length; i++) { if (data[i][roleColumn].equals ("Role1")) { data[i][userColumn]="User1|User2"; break; } } // Jetzt sind die Taskdaten geändert und können wieder gespeichert werden task.setTaskData (data); }
Sie können eine ähnliche Logik verwenden, um alle anderen Arten von Bindungsinformationen in verschiedenen Tasks anzugeben, wie z. B. JNDI-Namen für EJBs, Namen virtueller Hosts für Webmodule etc. Die Taskinformationen und der Beispielcode ermöglichen Ihnen nicht, Bindungsinformationen für Anwendungsclientmodule zu erfassen. Sie benötigen das mit WebSphere Application Server gelieferte Clientkonfigurationstool, um Anwendungsclients konfigurieren zu können.
- Speichern Sie die EAR-Datei, und rufen Sie die Installationsoptionen ab.
Nachdem Sie alle notwendigen Bindungsinformationen in verschiedenen Tasks angegeben haben, müssen die Taskdaten wieder in der EAR-Datei gespeichert werden, damit die mit Daten gefüllte EAR-Datei in der Konfiguration von WebSphere Application Server installiert werden kann. Zusätzliche zu den in der EAR-Datei gibt es verschiedene andere Implementierungsoptionen, die von Tasks erfasst werden, wie z. B. "AppDeploymentOptions", "EJBDeployOptions" und "MapModulesToServers". Diese Optionen werden nicht in der EAR-Datei gespeichert, müssen bei der Installation der Anwendung in der Konfiguration von WebSphere Application Server jedoch übergeben werden. Nachdem die Taskdaten bedarfsgemäß bearbeitet wurden und die EAR-Datei gespeichert ist, können diese Optionen als Hashtabelle von AppDeploymentController abgerufen werden. Alternativ dazu können diese Optionen während der Anwendungsinstallation direkt übergeben werden, wie im Abschnitt "Anwendungen installieren" und in der Javadoc zur API "installApplication" der Schnittstelle "com.ibm.websphere.management.application.AppManagement" erläutert.
Der folgende Code veranschaulicht, wie die Taskdaten in der EAR-Datei gespeichert und generierte Installationsoptionen abgerufen werden:
// die folgende Codezeile speichert die Taskdaten // in der in Schritt 1 als earName angegebenen EAR-Datei flowController.saveAndClose(); // Installationsoptionen abrufen Hashtable options = flowController.getAppDeploymentSavedResults();
Nächste Schritte
Installieren Sie die Anwendung durch Programmierung.


http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tjmx_prepappforinstall
Dateiname:tjmx_prepappforinstall.html