Connecting the GenRocket Runtime to your Database
You will want to connect to your database for two reasons:
- To retrieve data from the database while generating data using GenRocket runtime using generators like ListQueryGen, QueryBeforeLoop etc.
- To populate tables in the database using receivers like GenericSQLInsertReceiver, MySQLInsertReceiver etc.
To use these Generators and Receivers, GenRocket leverages JDBC.
What is JDBC?
JDBC stands for Java™ database connectivity (JDBC) and is the JavaSoft specification of a standard application programming interface (API) that allows Java programs to access database management systems. GenRocket can connect to any database that supports JDBC.
Step 1: Create a JDBC Configuration Properties File
For GenRocket to connect to a database via JDBC you will need to create a config.properties file. GenRocket can connect a SQL database via JDBC by reading a JDBC properties file that contains the following information.
If you are not using a MySQL database your configuration file may look different. Your configuration file will need to match the JDBC configuration file requirements for your database.
- driver - Defines the name of the specific database driver to use to access the given database. The actual driver file must be placed in the $GEN_ROCKET_HOME/lib folder on your local computer.
- user - Defines the Username used to access the database.
- password - Defines the password used to access the database.
- url - Defines the specific URL to access the database.
- batchCount - Defines the number of SQL statements that are batched together and sent to the database for execution. This property is only mandatory for GenRocket Receivers.
driver=<JDBCDriverClassName> user=<userToConnectToDatabase> password=<passwordToConnectToDatabase> url=<URL>/<databaseName> batchCount=1000
Example config.properties for MySQL database
GenRocket will read this config file and connect to employee database on localhost using username root and password root. If you are connecting to a different type of database your configuration file will look different.
driver=com.mysql.jdbc.Driver user=root password=root url=jdbc:mysql://localhost:3306/employee?rewriteBatchedStatements=true batchCount=1000
Step 2: Next step is to add a new resource named resource.jdbc.config in the GenRocket Web.
The resource.jdbc.config resource in this image points to the dev folder.
- Set the value of resource variable to the config file name with the full file path.
- For example, say you have added config.properties at location /home/user/Desktop/. Then the resource value will be /home/user/Desktop/config.properties.
- Make sure to update your Profile (in ~/.genrocket folder) on your system after adding the new resource with its value. GenRocket will read this resource value from your profile on your system to make a connection with the database.
Step 3: Download and place the JDBC connector Jar file to the $GENROCKET_HOME/lib/ folder
- Download and place a MySQL Connector in your genrocket-3.5.6/lib folder
- It is OK if your version doesn't match the one above -- still just place the MySQL connector in the lib directory
- You can download the latest version of MySQL Connector at this link
- Or you can download the connector we attached to this article (see bottom of page).
Step 4: Reference the JDBC Resource in your Generators or Receivers
When you create a Scenario that has a Generator or Receiver that references your jdbc.config resource it will connect directly to your database and perform its specified action.