Available in versions: Dev (3.20) | Latest (3.19) | 3.18 | 3.17 | 3.16 | 3.15 | 3.14 | 3.13 | 3.12 | 3.11 | 3.10
This documentation is for the unreleased development version of jOOQ. Click on the above version links to get this documentation for a supported version of jOOQ.
Custom data
Applies to ✅ Open Source Edition ✅ Express Edition ✅ Professional Edition ✅ Enterprise Edition
In advanced use cases of integrating your application with jOOQ, you may want to put custom data into your Configuration, which you can then access from your...
Here is an example of how to use the custom data API. Let's assume that you have written an ExecuteListener, that prevents INSERT statements, when a given flag is set to true:
public class NoInsertListener implements ExecuteListener {
@Override
public void start(ExecuteContext ctx) {
// This listener is active only, when your custom flag is set to true
if (Boolean.TRUE.equals(ctx.configuration().data("com.example.my-namespace.no-inserts"))) {
// If active, fail this execution, if an INSERT statement is being executed
if (ctx.query() instanceof Insert) {
throw new DataAccessException("No INSERT statements allowed");
}
}
}
}
See the manual's section about ExecuteListeners to learn more about how to implement an ExecuteListener.
Now, the above listener can be added to your Configuration, but you will also need to pass the flag to the Configuration, in order for the listener to work:
// Create your Configuration
Configuration configuration = new DefaultConfiguration().set(connection).set(dialect);
// Set a new execute listener provider onto the configuration:
configuration.set(new DefaultExecuteListenerProvider(new NoInsertListener()));
// Use any String literal to identify your custom data
configuration.data("com.example.my-namespace.no-inserts", true);
// Try to execute an INSERT statement
try {
DSL.using(configuration)
.insertInto(AUTHOR, AUTHOR.ID, AUTHOR.LAST_NAME)
.values(1, "Orwell")
.execute();
// You shouldn't get here
Assert.fail();
}
// Your NoInsertListener should be throwing this exception here:
catch (DataAccessException expected) {
Assert.assertEquals("No INSERT statements allowed", expected.getMessage());
}
Using the data() methods, you can store and retrieve custom data in your Configurations.
Feedback
Do you have any feedback about this page? We'd love to hear it!