Beispiel: Bean Managed Persistence (JBoss 4.0)

• Zuerst einmal ändern wir die XDoclet-Definition im Klassenkopf:

   * @ejb.bean name="KuchenBMP"	
   *           description="Bean-Klasse für ein Objekt 'Kuchen'."
   *           display-name="KuchenBMP"
   *           jndi-name="KuchenBMP"
   *           type="BMP" 
   *           transaction-type="Container"
   *           view-type="local" 
   *           primkey-field="id" 
   * @ejb.pk 
   *           class="java.lang.Long" 
   *           generate="false"  
   * @ejb.ejb-ref 
   *           ejb-name="ZutatBMP" 
   *           view-type="local" 
   *           ref-name="ejb/ZutatBMP"
   

  Wir möchten eine BMP-Entity-Bean haben. Der Primary Key soll vom Typ java.lang.Long sein (das Tag @ejb.pk können wir uns scheinbar auch sparen).
  Außerdem deklarieren wir eine EJB-Referenz auf die Zutat-Bean.
  
  
• Die Dummy-Methode "foo" wird entfernt, ebenso "ejbCreate".
  
  
• Jetzt die gesammelten Methoden zufügen (z.B. aus einem anderen Beispiel klauen).
  Folgende Deklarationen sind zu beachten:
  • "getId" soll ein PrimaryKey-Feld sein:

      /**@ejb.interface-method view-type="local"
       * @ejb.pk-field
       * @ejb.persistence 
       */
      public Long getId()
      {
        return this.lngID;
      } 

  • getName/setName sind persistente Felder:

     * @ejb.interface-method view-type="local"
     * @ejb.persistence  

  • Methoden des Local Interface (@ejb.interface-method view-type="local"):
    -getZutaten
    -addZutat
    -getZutatenListe (diese Methode ist eigentlich nicht nötig da "getZutaten" hier keine Container-Interne Liste zurückliefert. Damit der Webclient im Vergleich zu den anderen KuchenZutat-Beispielen nicht geändert werden muss habe ich sie trotzdem belassen).
  • ejbHomeGetNextId soll eine Home-Methode werden: @ejb.home-method view-type="local"
  • ejbCreateByName ist eine Create-Methode: @ejb.create-method view-type="local"
  Grund für diesen Aufwand bei der Deklaration der persistenten Felder: Der Webtools-Plugin erzeugt automatisch eine Data Object-Klasse die alle Felder enthält. Für diese wiederum benötigen wir einen sauber definierten Primary Key.

Datenbank-Resource

 * @ejb.resource-ref 
 *           res-ref-name="jdbc/KuchenZutatBMPDB" 
 *           res-type="javax.sql.DataSource" 
 *           res-auth="Container" 
 * @jboss.resource-ref 
 *           res-ref-name="jdbc/KuchenZutatBMPDB" 
 *           jndi-name="java:/DefaultDS"  

<datasources>
   <local-tx-datasource>

      <!-- The jndi name of the DataSource, it is prefixed with java:/ -->
      <!-- Datasources are not available outside the virtual machine -->
      <jndi-name>DefaultDS</jndi-name> 
      ...

  </local-tx-datasource>
</datasources> 

CREATE TABLE KUCHENBMPBEAN
(
  kuchenid INTEGER  NOT NULL, 
  name VARCHAR ( 256),
  CONSTRAINT KuchenBMPBean_PK PRIMARY KEY ( kuchenid) 
);

CREATE TABLE ZUTATBMPBEAN
(
  ZutatId INTEGER  NOT NULL, 
  ZutatName VARCHAR ( 256), 
  Menge VARCHAR ( 256),
  KuchenID INTEGER  NOT NULL,
  CONSTRAINT ZutatBMPBean_PK PRIMARY KEY ( ZutatId), 
  CONSTRAINT ZutatBMPBean_FK1 FOREIGN KEY ( KuchenID)  REFERENCES KUCHENBMPBEAN( KUCHENID) 
);  

	<ejb-local-ref>
		<ejb-ref-name>ejb/ZutatBMP</ejb-ref-name>
		<ejb-ref-type>Entity</ejb-ref-type>
		<local-home>de.fhw.swtvertiefung.knauf.kuchenzutatbmp.ZutatBMPLocalHome</local-home>
		<local>de.fhw.swtvertiefung.knauf.kuchenzutatbmp.ZutatBMPLocal</local>
		<ejb-link>ZutatBMP</ejb-link>
	</ejb-local-ref>
	<ejb-local-ref>
		<ejb-ref-name>ejb/KuchenBMP</ejb-ref-name>
		<ejb-ref-type>Entity</ejb-ref-type>
		<local-home>de.fhw.swtvertiefung.knauf.kuchenzutatbmp.KuchenBMPLocalHome</local-home>
		<local>de.fhw.swtvertiefung.knauf.kuchenzutatbmp.KuchenBMPLocal</local>
		<ejb-link>KuchenBMP</ejb-link>
	</ejb-local-ref>