01: // CustomerHome.java
02:
03: package org.objectweb.jonas.stests.appli;
04:
05: import java.rmi.RemoteException;
06: import java.util.Enumeration;
07:
08: import javax.ejb.CreateException;
09: import javax.ejb.EJBHome;
10: import javax.ejb.FinderException;
11:
12: /**
13: * Home interface for the Customer. This will handle all lifecycle
14: * related operations for the class of Customers: creation, location,
15: * deletion.
16: * <p>
17: * Several finder methods are provided to locate customers according
18: * to various search criteria.
19: */
20:
21: public interface CustomerHome extends EJBHome {
22:
23: /**
24: * Create a new Customer with minimal information.
25: * <p>
26: * @param id Customer ID for the customer being created, must be unique
27: * @param fN First name of the customer
28: * @param lN Last name of the customer
29: * @param phone Phone number of the customer
30: * @return Customer
31: * @exception javax.ejb.CreateException Creation Exception
32: * @exception java.rmi.RemoteException Remote Exception
33: */
34:
35: public Customer create(Integer Id, String fN, String lN,
36: String phone) throws CreateException, RemoteException;
37:
38: /**
39: * Create a new Customer with all parameters, except balances which will automatically
40: * be initialized to zero
41: * <p>
42: * @param id Customer ID for the customer being created, must be unique
43: * @param fN First name of the customer
44: * @param lN Last name of the customer
45: * @param inits Middle initials of the customer
46: * @param phone Phone number of the customer
47: * @param addr1 First address line of the customer
48: * @param addr2 Second address line of the customer
49: * @param city City of the customer's mailing address
50: * @param state State of the customer's mailing address
51: * @param zip Zip code of the customer's mailing address
52: * @param creditLimit Credit limit allowed for this cusomter
53: * @return Customer
54: * @exception javax.ejb.CreateException Creation Exception
55: * @exception java.rmi.RemoteException Remote Exception
56: */
57:
58: public Customer create(Integer Id, String fN, String lN,
59: String inits, String addr1, String addr2, String city,
60: String state, String zip, String phone, float creditLimit)
61: throws CreateException, RemoteException;
62:
63: /**
64: * Retrieve an individual customer by their customer ID number.
65: * <p>
66: * @param primaryKey Primary key to find the customer with
67: * @return Customer
68: * @exception javax.ejb.FinderException Find Exception
69: * @exception java.rmi.RemoteException Remote Exception
70: */
71:
72: public Customer findByPrimaryKey(Integer primaryKey)
73: throws FinderException, RemoteException;
74:
75: /**
76: * Retrieve all of the customers with a given last name.
77: * <p>
78: * <strong>Note:</strong>This returns a list of 1 or more customers with the specified last name
79: * @param primaryKey Primary key to find the customer with
80: * @return Customer
81: * @exception javax.ejb.FinderException Find Exception
82: * @exception java.rmi.RemoteException Remote Exception
83: */
84:
85: public Enumeration findCustomers(String lastName)
86: throws FinderException, RemoteException;
87:
88: /**
89: * Retrieve all of the customers.
90: * <p>
91: * @return Enumeration
92: * @exception javax.ejb.FinderException Find Exception
93: * @exception java.rmi.RemoteException Remote Exception
94: */
95:
96: public Enumeration findAllCustomers() throws FinderException,
97: RemoteException;
98:
99: }
|