///////////////////////////////////////////////////////////////////////////////
// File     : EJB_ADDRESSHome.java
// Creation : 2002.04.29 (generated by ejen 1.0.0)

package org.ejb.test;

import javax.ejb.EJBHome;
import javax.ejb.CreateException;
import javax.ejb.EJBException;
import javax.ejb.ObjectNotFoundException;
import javax.ejb.FinderException;
import java.rmi.RemoteException;
import java.util.Collection;


/**
 * Home interface for the entity bean that maps the ADDRESS table.
 * <br><i>Ejen EJB 1.1 (BMP) demonstration</i>
 * @version 1.0
 * @author (unknown)
 * @see org.ejb.test.ADDRESSValues
 * @see org.ejb.test.EJB_ADDRESS
 * @see org.ejb.test.EJB_ADDRESSBean
 * @see org.ejb.test.EJB_ADDRESS_PK
 */
public interface EJB_ADDRESSHome extends EJBHome {

    /**
     * Creates a new ADDRESS row.
     * @param values a values object that contains values for the
     *        ADDRESS row to be created.
     * @return remote interface of the created entity bean.
     * @throws javax.ejb.CreateException row count for INSERT != 1
     *                                   or unable to get the sequence value.
     * @throws javax.ejb.EJBException SQL error.
     * @throws java.rmi.RemoteException
     */
    public EJB_ADDRESS create(ADDRESSValues values) throws CreateException, RemoteException;

    /**
     * Finds a single row, provided a primary key.
     * @param pk the primary key that indentifies the row to retrieve.
     * @return remote interface mapping the founded row.
     * @throws javax.ejb.ObjectNotFoundException no row with this primary key.
     * @throws javax.ejb.EJBException SQL error.
     * @throws java.rmi.RemoteException
     */
    public EJB_ADDRESS findByPrimaryKey(EJB_ADDRESS_PK pk) throws ObjectNotFoundException, RemoteException;

    /**
     * Finds rows by id.
     * @param id value of the ID column.
     * @return remote interfaces collection mapping the founded rows.
     * @throws javax.ejb.EJBException SQL error.
     * @throws javax.ejb.FinderException unused.
     * @throws java.rmi.RemoteException
     */
    public Collection findById(int id) throws FinderException, RemoteException;

    /**
     * Finds rows by firstname.
     * @param firstname value of the FIRSTNAME column.
     * @return remote interfaces collection mapping the founded rows.
     * @throws javax.ejb.EJBException SQL error.
     * @throws javax.ejb.FinderException unused.
     * @throws java.rmi.RemoteException
     */
    public Collection findByFirstname(java.lang.String firstname) throws FinderException, RemoteException;

    /**
     * Finds rows by lastname.
     * @param lastname value of the LASTNAME column.
     * @return remote interfaces collection mapping the founded rows.
     * @throws javax.ejb.EJBException SQL error.
     * @throws javax.ejb.FinderException unused.
     * @throws java.rmi.RemoteException
     */
    public Collection findByLastname(java.lang.String lastname) throws FinderException, RemoteException;

    /**
     * Finds rows by street.
     * @param street value of the STREET column.
     * @return remote interfaces collection mapping the founded rows.
     * @throws javax.ejb.EJBException SQL error.
     * @throws javax.ejb.FinderException unused.
     * @throws java.rmi.RemoteException
     */
    public Collection findByStreet(java.lang.String street) throws FinderException, RemoteException;

    /**
     * Finds rows by city.
     * @param city value of the CITY column.
     * @return remote interfaces collection mapping the founded rows.
     * @throws javax.ejb.EJBException SQL error.
     * @throws javax.ejb.FinderException unused.
     * @throws java.rmi.RemoteException
     */
    public Collection findByCity(java.lang.String city) throws FinderException, RemoteException;

    /**
     * Finds all rows in the ADDRESS table.
     * @return remote interfaces collection mapping the founded rows.
     * @throws javax.ejb.EJBException SQL error.
     * @throws javax.ejb.FinderException unused.
     * @throws java.rmi.RemoteException
     */
    public Collection findAll() throws FinderException, RemoteException;
}

EJB_ADDRESSHome.html (HTML view generated by ejen v.1.0.0).