package com.oreilly.jent.annotation.xdoclet.ejb;

/**
 * In general, you may use the code in this book in your programs and 
 * documentation. You do not need to contact us for permission unless 
 * you're reproducing a significant portion of the code. For example, 
 * writing a program that uses several chunks of code from this book does 
 * not require permission. Selling or distributing a CD-ROM of examples 
 * from O'Reilly books does require permission. Answering a question by 
 * citing this book and quoting example code does not require permission. 
 * Incorporating a significant amount of example code from this book into 
 * your product's documentation does require permission.
 * 
 * We appreciate, but do not require, attribution. An attribution usually 
 * includes the title, author, publisher, and ISBN. For example: 
 * 
 *   "Java Enterprise in a Nutshell, Third Edition, 
 *    by Jim Farley and William Crawford 
 *    with Prakash Malani, John G. Norman, and Justin Gehtland. 
 *    Copyright 2006 O'Reilly Media, Inc., 0-596-10142-2."
 *  
 *  If you feel your use of code examples falls outside fair use or the 
 *  permission given above, feel free to contact us at 
 *  permissions@oreilly.com.
 */

/**
 * ProfileManagerBean: Stateless session implementation of the 
 *   ProfileManager EJB.
 * 
 * @ejb.bean
 *     name="ProfileManager"
 *     type="Stateless"
 */

import javax.ejb.SessionBean;
import javax.ejb.SessionContext;

import com.oreilly.jent.annotation.ejb.NoSuchPersonException;
import com.oreilly.jent.annotation.ejb.stateless.ProfileBean;

public class ProfileManagerBean implements SessionBean {
  // Store session context
  private SessionContext mContext = null;

  public ProfileManagerBean() {}
  
  //--------------------------------------------------
  // Session bean methods
  //--------------------------------------------------

  // No need for us to activate anything in this bean, but we need to
  // provide an implementation.
  public void ejbActivate() {
    System.out.println("ProfileManagerBean activated.");
  }

  // Nothing to do on a remove for this bean.
  public void ejbRemove() {
    System.out.println("ProfileManagerBean removed.");
  }

  // No state to store on passivation.
  public void ejbPassivate() {
    System.out.println("ProfileManagerBean passivated.");
  }

  // Get context from container, store in a member variable.
  public void setSessionContext(SessionContext context) {
    System.out.println("ProfileManagerBean context set.");
    mContext = context;
  }

  /**
   * No-argument create() -- nothing to initialize in this case.
   * 
   * @ejb.create-method
   */ 
  public void ejbCreate() {
    System.out.println("ProfileManagerBean created.");
  }

  //--------------------------------------------------
  // Business methods
  //--------------------------------------------------
  
  /**
   * 
   * Get a profile for a named person.  Throws NoSuchPersonException if the
   * named person cannot be found in the persistent storage used to store
   * profile information.
   * 
   * @ejb.interface-method
   *     view-type=both
   */
  public ProfileBean getProfile(String name) throws NoSuchPersonException {
    // Here, we just create one of our serializable Profile objects and return
    // it (i.e., no persistence of profile data is provided).
    ProfileBean profile = new com.oreilly.jent.annotation.ejb.stateless.ProfileBean(name);
    return profile;
  }
}