preferenceshomelocal.java

Oracle的J2EE Sample

/*
 * @author : Umesh Kulkarni
 * @version 1.0
 *
 * Development Environment : Oracle9i JDeveloper
 *
 * Name of the File : PreferencesHomeLocal.java
 *
 * Creation / Modification History
 *    Umesh           26-Apr-2002        Created
 *
 */
package oracle.otnsamples.ibfbs.usermanagement.ejb;

// Import Required Packages
import javax.ejb.CreateException;
import javax.ejb.FinderException;

/**
 * This Class is Local Home Interface to Preferences Bean. Using this local 
 * home interface, clients can create objects implementing 'PreferencesLocal'
 * local interface.
 *
 * The Session Facade Bean namely 'UserManagementSessionFacadeBean' invokes the 
 * create() method of this home interface to get PreferencesBean Local EJB 
 * Object. Note : It is recommdended that Local EJB Objects are invoked by the 
 * Session Bean/Entity Bean executing in the same EJB container. Here in this 
 * application, UserManagementSessionFacadeBean invokes the methods on the 
 * Local Objects.
 * @version 1.0
 * @since   1.0
 */
public interface PreferencesHomeLocal extends javax.ejb.EJBLocalHome {

  /**
   * Method to create PreferencesBean Local EJB Object.
   *
   * @param id            ID of the Preference
   * @param accountNumber AccountNumber associated with the Preference
   * @param symbol        Stock Symbol Value associated with Preference
   * @param prefType      Preference Type associated with the Preference
   * @return Local EJB Object implementing PreferencesLocal interface
   * @since   1.0
   */
  public PreferencesLocal create(Integer id, Integer accountNumber, 
                                 String symbol, String prefType)
      throws CreateException;

  /**
   * Method to Find a particular PreferencesBean Local EJB Object 
   * by providing its primary key.
   *
   * @param primaryKey Primary Key Field.
   * @return Local EJB Object implementing PreferencesLocal interface.
   * @since   1.0
   */
  public PreferencesLocal findByPrimaryKey(Integer primaryKey)
      throws FinderException;
}