| Class | Line # | Actions | |||||
|---|---|---|---|---|---|---|---|
| DatabaseActions | 22 | 0 | - | 0 | 0 |
| 1 | package org.europa.together.business; | |
| 2 | ||
| 3 | import java.sql.ResultSet; | |
| 4 | import java.sql.SQLException; | |
| 5 | import org.apiguardian.api.API; | |
| 6 | import static org.apiguardian.api.API.Status.STABLE; | |
| 7 | import org.europa.together.domain.JdbcConnection; | |
| 8 | import org.springframework.stereotype.Component; | |
| 9 | ||
| 10 | /** | |
| 11 | * DatabaseActions is a simple helper class to execute SQL queries and other | |
| 12 | * database operations out of the DAO Context. To establish a JDBC connection | |
| 13 | * for unit tests call the constructor: <br> | |
| 14 | * DatabaseActions(boolean activateTestMode); | |
| 15 | * | |
| 16 | * @author elmar.dott@gmail.com | |
| 17 | * @version 2.0 | |
| 18 | * @since 1.0 | |
| 19 | */ | |
| 20 | @API(status = STABLE, since = "1.0", consumers = "JdbcActions") | |
| 21 | @Component | |
| 22 | public interface DatabaseActions { | |
| 23 | ||
| 24 | /** | |
| 25 | * Identifier for the given feature. | |
| 26 | */ | |
| 27 | @API(status = STABLE, since = "1.2") | |
| 28 | String FEATURE_ID = "CM-08"; | |
| 29 | ||
| 30 | /** | |
| 31 | * Establish an JDBC connection. If the propertyFile parameter is empty, | |
| 32 | * then the method load by default the configuration from the classpath. The | |
| 33 | * path to the external property file have to be relative to the execution | |
| 34 | * path. | |
| 35 | * | |
| 36 | * @param propertyFile as String | |
| 37 | * @return true on success | |
| 38 | */ | |
| 39 | @API(status = STABLE, since = "1.0") | |
| 40 | boolean connect(String propertyFile); | |
| 41 | ||
| 42 | /** | |
| 43 | * Execute a plain SQL query and get the ResultSet. If there exist multiple | |
| 44 | * SELECT statements, then the ResultSet contains only the rusultSet of the | |
| 45 | * last SELECT statement. | |
| 46 | * | |
| 47 | * @param sql as String | |
| 48 | * @return result as ResultSet | |
| 49 | * @throws java.sql.SQLException in case of error | |
| 50 | */ | |
| 51 | @API(status = STABLE, since = "3.0") | |
| 52 | ResultSet executeQuery(String sql) throws SQLException; | |
| 53 | ||
| 54 | /** | |
| 55 | * Load an SQL file from the classpath and execute the script. | |
| 56 | * <b>Attention:</b> This function should be used to populate a database and | |
| 57 | * so on. It is not designed to handle multiple ResultSets by using SELECT. | |
| 58 | * If multiple SELECT statements appears in an SQL file, then only the | |
| 59 | * ResultSet of the last SELECT statement will be available. <br> | |
| 60 | * Internal call this function for each single SQL statement the | |
| 61 | * executeQuery() method. | |
| 62 | * | |
| 63 | * @param sqlFile as String | |
| 64 | * @return true on success | |
| 65 | */ | |
| 66 | @API(status = STABLE, since = "1.0") | |
| 67 | boolean executeSqlFromClasspath(String sqlFile); | |
| 68 | ||
| 69 | /** | |
| 70 | * Count the size of a ResultSet. | |
| 71 | * | |
| 72 | * @param results as ResultSet | |
| 73 | * @return count the results | |
| 74 | * @throws java.sql.SQLException in case of error | |
| 75 | */ | |
| 76 | @API(status = STABLE, since = "3.0") | |
| 77 | int countResultSets(ResultSet results) throws SQLException; | |
| 78 | ||
| 79 | /** | |
| 80 | * Return a object with all JDBC connection meta date. | |
| 81 | * | |
| 82 | * @return JdbcConnection as Object | |
| 83 | * @throws java.sql.SQLException in case of error | |
| 84 | */ | |
| 85 | @API(status = STABLE, since = "3.0") | |
| 86 | JdbcConnection getJdbcMetaData() throws SQLException; | |
| 87 | } |