com.webcab.ejb.finance.portfolio.jdbc
Interface EasyOptimalJDBCHome

All Superinterfaces:

EJBHome, Remote

public interface EasyOptimalJDBCHome

extends EJBHome

Home interface of the EasyOptimalJDBC 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 EasyOptimalHome 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:

EasyOptimal

Method Summary

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

Methods inherited from interface javax.ejb.EJBHome

getEJBMetaData, getHomeHandle, remove, remove

Method Detail

create

public EasyOptimalJDBC create()
                       throws SQLException,
                              CreateException,
                              RemoteException

Creates a EasyOptimalJDBC bean that encapsulates a EasyOptimal instance and allows you to invoke SQL queries on every of its methods using its internal jdbc/EasyOptimalInputDB and jdbc/EasyOptimalOutputDB 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 EasyOptimal component.

SQLException

CreateException

RemoteException

See Also:

EasyOptimalHome.create()

create

public EasyOptimalJDBC 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 EasyOptimalJDBC bean that encapsulates a corresponding EasyOptimal component. The JDBC specific parameters are used to create the JDBC connections, while the others are used to initialize the EasyOptimal 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:

EasyOptimalHome.create()

create

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

Creates a EasyOptimalJDBC bean that encapsulates a corresponding EasyOptimal component. The JDBC specific parameters are used to create the JDBC connection, while the others are used to initialize the EasyOptimal 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:

EasyOptimalHome.create()