com.webcab.ejb.finance.interest.jdbc
Interface InterestJDBCHome

All Superinterfaces:

EJBHome, Remote

public interface InterestJDBCHome

extends EJBHome

Home interface of the InterestJDBC Enterprise JavaBean. Use this interface to establish a JDBC connection to your database, by specifying the following when invoking the creation methods:

• Driver Name

  The name of the driver distributed by your DBMS vendor. For example, if you wish to connect to Oracle9i the driver name you will use will be "oracle.jdbc.driver.OracleDriver".

• URL

  The url is database vendor specific as well and will describe the name of the server, the database port number and maybe a service name. Under Oracle9i the URL you would use would have the following format:

  jdbc:oracle:thin:@servername:1521:service

• Username and Password

  The username and password are in most cases indispensable when connecting to any database.

• Properties

  This variable may be left null in most cases. It should be used in order to transfer properties additional to username and password.

This home interfaces defines every method from the InterestHome home interface with either one input/output database connection or two different input and output database connections. It also provides a create method which uses your Application Server DataSource Connection Pools as defined at deployment time. Every connection is defined as described above.

See Also:

Interest

Method Summary

InterestJDBC	create() Creates a InterestJDBC bean that encapsulates a Interest instance and allows you to invoke SQL queries on every of its methods using its internal jdbc/InterestInputDB and jdbc/InterestOutputDB DataSource references.
InterestJDBC	create(String driverName, String url, String user, String password, Properties info) Creates a InterestJDBC bean that encapsulates a corresponding Interest component.
InterestJDBC	create(String inputDriverName, String inputURL, String inputUser, String inputPassword, Properties inputInfo, String outputDriverName, String outputURL, String outputUser, String outputPassword, Properties outputInfo) Creates a InterestJDBC bean that encapsulates a corresponding Interest component.

Methods inherited from interface javax.ejb.EJBHome

getEJBMetaData, getHomeHandle, remove, remove

Method Detail

create

public InterestJDBC create()
                    throws SQLException,
                           CreateException,
                           RemoteException

Creates a InterestJDBC bean that encapsulates a Interest instance and allows you to invoke SQL queries on every of its methods using its internal jdbc/InterestInputDB and jdbc/InterestOutputDB DataSource references. This method does not require JDBC Connection properties as it relies on the Input and Output JDBC DataSource references configured at deployment time.

Notice that this creation method has the same parameters as the creation method from the Interest component.

SQLException

CreateException

RemoteException

See Also:

InterestHome.create()

create

public InterestJDBC create(String inputDriverName,
                           String inputURL,
                           String inputUser,
                           String inputPassword,
                           Properties inputInfo,
                           String outputDriverName,
                           String outputURL,
                           String outputUser,
                           String outputPassword,
                           Properties outputInfo)
                    throws SQLException,
                           CreateException,
                           RemoteException

Creates a InterestJDBC bean that encapsulates a corresponding Interest component. The JDBC specific parameters are used to create the JDBC connections, while the others are used to initialize the Interest Enterprise component.

Parameters:

inputDriverName - The name of the driver used for the input connection.

inputURL - The URL that describes the input connection address.

inputUser - The input connection username.

inputPassword - The input connection password.

inputInfo - Additional input connection properties, null for none.

outputDriverName - The name of the driver used for the output connection.

outputURL - The URL that describes the input connection address.

outputUser - The output connection username.

outputPassword - The output connection password.

outputInfo - Additional output connection properties, leave null for none.

SQLException

CreateException

RemoteException

See Also:

InterestHome.create()

create

public InterestJDBC create(String driverName,
                           String url,
                           String user,
                           String password,
                           Properties info)
                    throws SQLException,
                           CreateException,
                           RemoteException

Creates a InterestJDBC bean that encapsulates a corresponding Interest component. The JDBC specific parameters are used to create the JDBC connection, while the others are used to initialize the Interest Enterprise component.

Parameters:

driverName - The name of the driver used for establishing the connection.

url - The URL that describes the connection address.

user - The username to use when establishing the connection.

password - The password to use when establishing the connection.

info - Additional JDBC properties. Leave null for none.

SQLException

CreateException

RemoteException

See Also:

InterestHome.create()