example.cmp.single_table
Interface HouseHome

All Superinterfaces:
javax.ejb.EJBLocalHome

public interface HouseHome
extends javax.ejb.EJBLocalHome

The client's view of the house table. Home interfaces define methods to find entries in the table and to create new table entries.

All home interfaces define the findByPrimaryKey method, letting clients find items in the table. Other find methods are allowed. An example for an application-defined find method is in example.cmp.find.

Clients normally use JNDI to get the HouseHome object and then store it for all further requests. The init() method of HouseServlet gives an example of getting the home interface.

All local home interfaces extend EJBLocalHome.


Method Summary
 House findByPrimaryKey(java.lang.String name)
          Returns the house specified by the primary key.
 
Methods inherited from interface javax.ejb.EJBLocalHome
remove
 

Method Detail

findByPrimaryKey

public House findByPrimaryKey(java.lang.String name)
                       throws javax.ejb.FinderException
Returns the house specified by the primary key. Every home interface must define a findByPrimaryKey method. The single argument is the primary key and the return value is the local interface.
Parameters:
name - the house name, i.e. the primary key.
Returns:
the matching house
Throws:
javax.ejb.FinderException - if the database lookup fails.