JAR-Projekte für EJB-Client

Ein JAR-Projekt für EJB-Client enthält alle Klassendateien, die ein Clientprogramm benötigt, um die Clientsicht der Enterprise-Beans zu nutzen, die in dem EJB-Modul enthalten sind.

Mit den EJB-Tools können Sie ein EJB-Projekt mit einem entsprechenden JAR-Projekt für EJB-Client erstellen. Das EJB-Projekt ist von dem JAR-Projekt für EJB-Client abhängig. Das JAR-Projekt für EJB-Client enthält alle erforderlichen Klassen für einen Client der Enterprise-Beans, einschließlich aller Schnittstellenklassen, Schlüsselklassen und unterstützenden Klassen. Da diese Klassen im EJB-Projekt nicht dupliziert werden, ist das EJB-Projekt von dem zugehörigen JAR-Projekt für EJB-Client abhängig. Jedes Projekt, das über einen Verweis auf eine Enterprise-Bean in dem EJB-Projekt verfügt, benötigt einen Verweis auf das JAR-Projekt für EJB-Client. Wenn Sie das JAR-Projekt für EJB-Client in einer anderen Unternehmensanwendung befindet, muss die JAR-Datei für EJB-Client als Dienstprogramm-JAR-Datei zur referenzierenden EAR-Datei hinzugefügt werden.

Nachdem das JAR-Projekt für EJB-Client erstellt ist, liegt es an Ihnen, die von den Home- oder Komponentenschnittstellen benötigten Wertobjekte zu diesem Projekt hinzuzufügen. Wenn die Objekte nicht vorhanden sind, führt dies zu Kompilierungsfehlern.

JAR-Dateien für EJB-Client

EJB-Clientprojekte werden beim Exportieren der Anwendung als JAR-Dateien für EJB-Client exportiert. Die JAR-Datei für EJB-Client wird im Implementierungsdeskriptor der EJB-JAR-Datei mit Hilfe des optionalen Elements ejb-client-jar angegeben. Der Wert für das Element ejb-client-jar ist der Pfadname, der die Position der JAR-Datei für EJB-Client in der übergeordneten J2EE Enterprise Application Archive-Datei (.ear) angibt. Der Wert des Pfadnamens ist eine einheitliche Referenz-ID (URI) in Relation zu der EJB-JAR-Datei innerhalb der Anwendung.

Anmerkung: Der relative URI-Pfad der JAR-Datei für EJB-Client sollte in allen Anwendungen, zu denen das EJB-Projekt gehört, gleich sein.

Wenn Sie ein JAR-Projekt für EJB-Client für ein EJB-Projekt erstellen, wird die JAR-Datei für EJB-Client der übergeordneten Unternehmensanwendung als Projekt-Dienstprogramm-JAR hinzugefügt. Der Verweis auf diese JAR-Datei für EJB-Client kann nicht aus der Unternehmensanwendung entfernt werden, so lange das EJB-Projekt als Modul für die Anwendung definiert ist.

Wichtig: Wenn Sie ein EJB-Projekt mit Hilfe des Exportassistenten für EJB-JAR-Datei exportieren, schließt der Exportassistent kein dem EJB-Projekt zugeordnetes JAR-Projekt für EJB-Client mit ein. Damit die JAR-Datei für EJB-Client angegeben wird, empfiehlt es sich, die EAR-Datei der Unternehmensanwendung zu exportieren, in der das EJB-Projekt enthalten ist. Die resultierende EAR-Datei enthält alle abhängigen JAR-Dateien für EJB-Client als Dienstprogramm-JAR-Dateien. Alternativ dazu können Sie das JAR-Projekt für EJB-Client separat als JAR-Datei exportieren.