Beispiel: Container Managed Relationship mit Container-Generated Primary Keys (JBoss 4.0)

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

   * @ejb.bean name="KuchenAutoPK"	
   *           description="Ein Kuchen, mit Container-erzeugtem Primary Key"
   *           display-name="KuchenAutoPK"
   *           jndi-name="KuchenAutoPK"
   *           type="CMP" 
   *           transaction-type="Container"
   *           cmp-version="2.x"  
   *           view-type="local"  
   * @ejb.pk  
   *           class="java.lang.Object"  
   *           generate="false"  
   * @jboss.unknown-pk  
   *           class="java.lang.Integer"  
   *           column-name="kuchenid"  
   *           field-name="kuchenid"  
   *           sql-type="INTEGER"  
   *           jdbc-type="INTEGER"  
   *           auto-increment="true"  
   * @jboss.entity-command  
   *           name="hsqldb-fetch-key"  
   

  Wir möchten eine CMP-Entity-Bean haben. Der Primary Key soll vom Container generiert werden und vom Typ java.lang.Object sein. Wir geben außerdem die JBoss-spezifischen Angaben für das Erzeugen des Primary Keys an.
  
  
• Die Dummy-Methode "foo" wird entfernt.
  
  
• Jetzt wird das einzige Feld der Klasse zugefügt: Name (vom Typ java.lang.String).

    /**Abrufen des Kuchen-Namens.
     * @return der Kuchen-Name.
     * 
     * @ejb.persistence column-name="name" sql-type="VARCHAR"  
     * @ejb.interface-method view-type="local" 
     */
    public abstract String getName();
  
    /**Setzen des Kuchen-Namens.
     * @param str_Name der Name
     * 
     * @ejb.persistence column-name="name" sql-type="VARCHAR" 
     * @ejb.interface-method view-type="local" 
     */
    public abstract void setName (String str_Name); 

• Die beiden ejbCreate-Methoden werden erzeugt, die jeweils NULL zurückgeben und den Rückgabetyp java.lang.Object haben. "ejbCreate" mit dem Kuchennamen als Parameter sieht so aus (für ejbCreate ohne Parameter analog):
  

    /**Erzeugen eines Kuchen-Objekts, wobei der Name angegeben wird. 
     * Es wird kein Key erzeugt (macht der Container)
     * @param str_Name Der Name des Kuchens.
     * @return NULL da die ID vom Container kommt.
     * @exception CreateException Fehler beim Erzeugen.
     * 
     * @ejb.create-method view-type="local" 
     */
    public Object ejbCreateByName (String str_Name) throws CreateException
    {
      KuchenAutoPKBean.logger.info("ejbCreateByName: " + str_Name);
      this.setName(str_Name);
  
      return null;
    } 

  Natürlich müssen die zugehörigen ejbPostCreate-Methoden ebenfalls deklariert werden.
  
  
• Die Deklaration der Finder-Methode wird im Klassen-Kopf zugefügt:

   * @ejb.finder 
   *           signature="java.util.Collection findAll()" 
   *           query="select Object(o) from KuchenAutoPK o order by o.name"  

Hinzufügen der Relationships

  /**Abrufen aller Zutaten dieses Kuchens.
   * @return Collection von Zutat-Objekten.
   * @ejb.interface-method view-type="local" 
   * @ejb.relation  
   *   name="KuchenZutaten"  
   *   role-name="kuchen-hat-zutaten" 
   */
  public abstract Collection getZutaten();

  /**Setzen der kompletten Zutaten-Liste des Kuchens.
   * Wird vom Container übernommen.
   * @param coll_Zutaten Liste der Zutaten.
   * 
   * @ejb.interface-method view-type="local" 
   */
  public abstract void setZutaten (Collection coll_Zutaten); 

  /**Abrufen des Kuchens, zu dem die Zutat gehört.
   * @return Der Kuchen der Zutat.
   *
   * @ejb.interface-method view-type="local"  
   * @ejb.relation  
   *   name="KuchenZutaten"  
   *   role-name="zutat-hat-kuchen" 
   *   cascade-delete="yes" 
   * @jboss.relation fk-constraint="true"  
   *   related-pk-field="kuchenid"  
   *   fk-column="kuchen_fk"  
   */
  public abstract KuchenAutoPKLocal getKuchen();

  /**Setzen des Kuchens, zu dem die Zutat gehört.
   * @param kuchen Der Kuchen der Zutat.
   * 
   * @ejb.interface-method view-type="local" 
   */
  public abstract void setKuchen(KuchenAutoPKLocal kuchen); 

   <relationships >
      <ejb-relation >
         <ejb-relation-name>KuchenZutaten</ejb-relation-name>

         <ejb-relationship-role >
            <ejb-relationship-role-name>zutat-hat-kuchen</ejb-relationship-role-name>
            <multiplicity>Many</multiplicity>
            <relationship-role-source >
               <ejb-name>ZutatAutoPK</ejb-name>
            </relationship-role-source>
            <cmr-field >
               <cmr-field-name>kuchen</cmr-field-name>
            </cmr-field>
         </ejb-relationship-role>

         <ejb-relationship-role >
            <ejb-relationship-role-name>kuchen-hat-zutaten</ejb-relationship-role-name>
            <multiplicity>One</multiplicity>
            <cascade-delete/>
            <relationship-role-source >
               <ejb-name>KuchenAutoPK</ejb-name>
            </relationship-role-source>
            <cmr-field >
               <cmr-field-name>zutaten</cmr-field-name>
               <cmr-field-type>java.util.Collection</cmr-field-type>
            </cmr-field>
         </ejb-relationship-role>

      </ejb-relation>
   </relationships> 

<ejb-local-ref>
	<ejb-ref-name>ejb/ZutatAutoPK</ejb-ref-name>
	<ejb-ref-type>Entity</ejb-ref-type>
	<local-home>com.knauf.ejb.kuchenzutatautopk.ZutatAutoPKLocalHome</local-home>
	<local>com.knauf.ejb.kuchenzutatautopk.ZutatAutoPKLocal</local>
	<ejb-link>ZutatAutoPK</ejb-link>
</ejb-local-ref>
<ejb-local-ref>
	<ejb-ref-name>ejb/KuchenAutoPK</ejb-ref-name>
	<ejb-ref-type>Entity</ejb-ref-type>
	<local-home>com.knauf.ejb.kuchenzutatautopk.KuchenAutoPKLocalHome</local-home>
	<local>com.knauf.ejb.kuchenzutatautopk.KuchenAutoPKLocal</local>
	<ejb-link>KuchenAutoPK</ejb-link>
</ejb-local-ref>