Das Brokerarchiv bzw. die BAR-Datei ist die Implementierungseinheit für den Broker.
Die BAR-Datei ist eine komprimierte Datei, die eine Reihe verschiedener Dateien enthalten kann:
- Eine Datei des Typs .appzip für jede
Anwendung.
Diese Datei enthält alle Ressourcen, die zur Anwendung gehören, z. B.
.msgflow-, .cmf-,
.esql-, .map- und .xsd-Dateien sowie
alle .dictionary- und .xsdzip-Nachrichtengruppendateien.
Wenn sich eine Anwendung auf eine oder mehrere Bibliotheken bezieht, müssen .libzip-Dateien für die referenzierten Bibliothek ebenfalls zur BAR-Datei hinzugefügt werden.
- Eine Datei des Typs .libzip für jede
Bibliothek.
Diese Datei enthält alle Ressourcen, die zur Bibliothek gehören, z. B.
.msgflow-, .cmf-,
.esql-, .map- und .xsd-Dateien sowie
alle .dictionary- und .xsdzip-Nachrichtengruppendateien.
Wenn sich eine Bibliothek auf eine andere Bibliothek bezieht, müssen .libzip-Dateien für die referenzierten Bibliothek ebenfalls zur BAR-Datei hinzugefügt werden.
- Eine .cmf-Datei für jeden Nachrichtenfluss, wenn Sie im
Brokerarchiveditor die Option Ressourcen kompilieren und integrieren
ausgewählt haben. Hierbei handelt es sich um eine kompilierte Version des
Nachrichtenflusses. Die BAR-Datei kann eine beliebige Anzahl dieser Dateien enthalten.
- Eine .msgflow-Datei für jeden Nachrichtenfluss,
es sei denn, Sie haben im Brokerarchiveditor die Option Ressourcen
kompilieren und integrieren ausgewählt. Diese Dateien enthalten Definitionen für
Nachrichtenflüsse und sind nicht kompiliert.
- Eine oder mehrere .subflow-Dateien.
Diese Dateien enthalten Definitionen untergeordneter Nachrichtenflüsse und können als
Einzelressourcen implementiert werden. Diese Dateien sind nicht kompiliert.
- Eine Datei .appdomainzip für jede AppDomain. Diese Dateien enthalten .NET-Assemblys, die vom Nachrichtenfluss verwendet werden.
- Die Datei .dictionary für die jeweiligen Nachrichtenverzeichnisse.
Die BAR-Datei kann eine beliebige Anzahl dieser Dateien enthalten.
- Eine moder mehrere komprimierte XSD-Dateien (.xsdzip), wenn in einer Nachrichtengruppe XML-Schema und WSDL definiert sind.
- Die Datei broker.xml. Diese Datei wird als Brokerimplementierungsdeskriptor bezeichnet. Die BAR-Datei kann diese Datei nur einmal enthalten. Diese Datei im XML-Format befindet sich im Ordner META-INF der komprimierten Datei und kann mithilfe eines Texteditors oder eines Shell-Scripts geändert werden.
- Von den Knoten in den Nachrichtenflüssen, die Sie zu dieser BAR-Datei hinzugefügt haben, wird
mindestens eine XML-Datei (.xml), Formatvorlage (.xsl)
und XSLT-Datei (.xlst) benötigt. Der XSLTransform-Knoten ist beispielsweise ein Knoten, der diese Dateien benötigt.
- Mindestens eine JAR-Datei, falls von den
JavaCompute-Knoten in den Nachrichtenflüssen, die Sie zu
dieser BAR-Datei hinzugefügt haben, gefordert.
- Mindestens eine ein- oder abgehende Adapterdatei (.inadapter oder
outadapter), falls von den WebSphere Adapter-Knoten (beispielsweise dem
SiebelInput-Knoten) in den Nachrichtenflüssen gefordert,
die Sie zu dieser BAR-Datei hinzugefügt haben.
- Mindestens eine PHP-Scriptdatei (.php), falls von den
PHPCompute-Knoten in den Nachrichtenflüssen, die Sie zu
dieser BAR-Datei hinzugefügt haben, gefordert.
- Eine .esql-Datei für jede ESQL-Datei, es sei
denn, Sie haben im Brokerarchiveditor die Option Ressourcen kompilieren und
integrieren ausgewählt.
- Eine .map-Datei für jede Routine zur grafischen Datenzuordnung.
- Eine .xsd-Datei für jede DFDL- und XML-Schemadatei in einer Anwendung oder Bibliothek.
- Sonstige Dateien, die dieser BAR-Datei zugeordnet werden sollen.
Sie könnten beispielsweise Java™-Quellendateien, .msgflow-Dateien oder .wsdl-Dateien als zukünftige Referenz einschließen. Die Brokerarchivdateien können alle Dateitypen enthalten. Wenn Sie sich für die Aufnahme von Quellendateien in die BAR-Datei entscheiden, werden dem Ordner src der BAR-Datei Quellenprojekte für alle Anwendungen, Bibliotheken und sonstigen kompilierten Ressourcen hinzugefügt.
Eine BAR-Datei wird bei der Erstellung standardmäßig in einem
Nachrichtenbrokerprojekt mit der Bezeichnung 'BARfiles' erstellt. In der
Ansicht Brokerentwicklung wird die neue BAR-Datei unterhalb des
Nachrichtenbrokerprojekts 'BARfiles' im Ordner BARs
angezeigt. Bei Erstellung der BAR-Datei mithilfe des Assistenten Neue
BAR-Datei können Sie ein anderes Ziel (beispielsweise eine Anwendung, eine Bibliothek
oder ein Nachrichtenbrokerprojekt) angeben oder ein
Nachrichtenbrokerprojekt erstellen, das die BAR-Datei enthalten soll.
Die BAR-Datei wird in diesem Fall unter der Anwendung, der Bibliothek oder dem Nachrichtenbrokerprojekt im Ordner BARs angezeigt.
Sie können für die von Ihnen erstellten BAR-Dateien selbst ein Standardziel vorgeben.
Klicken Sie auf , erweitern Sie Brokerentwicklung und wählen Sie Brokerarchiv erstellen aus. Standardmäßig werden BAR-Dateien in dem Projekt mit der Bezeichnung 'BARfiles' erstellt. Sie können den Namen dieses Standardprojekts ändern. Ebenso können
Sie BAR-Dateien auch in der Anwendung oder Bibliothek oder in dem
Nachrichtenbrokerprojekt erstellen, die bzw. das in der Ansicht Brokerentwicklung beim Öffnen des Assistenten Neue BAR-Datei ausgewählt ist.
Änderungen an BAR-Dateien in WebSphere Message
Broker Version 8.0.0.1
Beachten Sie die folgenden Unterschiede zwischen BAR-Dateien in
WebSphere Message
Broker Version 8.0.0.1 und
WebSphere Message Broker Version 8.0.0.0:
- BAR-Dateien in Version 8.0.0.1
können Nachrichtenflüsse als .msgflow-Dateien enthalten. Wenn Sie eine BAR-Datei, die .msgflow-Dateien enthält, in einem Broker der Version
8.0.0.0 implementieren, werden die .msgflow-Dateien nicht implementiert.
- In der Version 8.0.0.1
wurde die Option ESQL-Code beim Kompilieren von .msgflow integrieren im Brokerarchiveditor durch die Option Ressourcen kompilieren und integrieren ersetzt.
Beachten Sie folgende Informationen:
- Bei BAR-Dateien, bei deren Erstellung in der Version
8.0.0.0 die Option ESQL-Code beim Kompilieren von .msgflow integrieren inaktiviert war, ist die Option Ressourcen kompilieren und integrieren ebenfalls inaktiviert, wenn Sie diese in der Version 8.0.0.1
öffnen.
- Wenn Sie in der Version 8.0.0.1
einer BAR-Datei einen Nachrichtenfluss hinzufügen, der einen untergeordneter Nachrichtenfluss enthält, der in der Datei .msgflow definiert ist, müssen Sie die Option Ressourcen kompilieren und integrieren auswählen, um die BAR-Datei zu erstellen.
- Sie müssen Ihre BAR-Dateien der Version
8.0.0.0, die untergeordnete Nachrichtenflüsse enthalten, die in .msgflow-Dateien integriert sind, aktualisieren, damit die Option Ressourcen kompilieren und integrieren in der Version 8.0.0.1
ausgewählt ist. Wenn Sie diese Option nicht auswählen, wird eine Warnung angezeigt, sobald Sie versuchen, diese BAR-Dateien in der Version 8.0.0.1
zu erstellen. Sie können die Option auswählen, indem Sie die BAR-Datei im Brokerarchiveditor in der Version 8.0.0.1
öffnen.
- Sie finden weitere Informationen zur Aufnahme von Dateien in eine BAR-Datei sowie zu den Optionen des Brokerarchiveditors in den Abschnitten Dateien zu einem Brokerarchiv hinzufügen und Brokerarchiveditor.