X-Git-Url: http://wamblee.org/gitweb/?a=blobdiff_plain;f=test%2Fenterprise%2Fsrc%2Fmain%2Fjava%2Forg%2Fwamblee%2Fsupport%2Fpersistence%2Fpackage-info.java;h=1ea78e255d6e9e6bb1c712431c4dac3085637de0;hb=8d321e0d26d7d1d8c461fc9ca8bd7105e86e6ac2;hp=d38be5796fed215c5341d165ce549af23a5d4bbd;hpb=28a9820d1b2fe0dbf9a05aed5a84b79f96cde743;p=utils diff --git a/test/enterprise/src/main/java/org/wamblee/support/persistence/package-info.java b/test/enterprise/src/main/java/org/wamblee/support/persistence/package-info.java index d38be579..1ea78e25 100644 --- a/test/enterprise/src/main/java/org/wamblee/support/persistence/package-info.java +++ b/test/enterprise/src/main/java/org/wamblee/support/persistence/package-info.java @@ -72,6 +72,12 @@ * This also requires a number of environment variables or system properties to be set, * see {@link ExternalDatabase}. * + *
+ * However, the most convenient way to set the capabilities is usually to set a system property or environment + * variable see the javadocs of {@link DatabaseBuilder}. and + * specifically {@link DatabaseBuilder#DB_CAPABILITIES_PROP} + *
+ * * * *
+ * {@link DatabaseProvider} uses java.util.ServiceLoader
to find all implementations
+ * of {@link DatabaseProvider} on the classpath. It then asks the database providers whether
+ * they support the required capabilities (by default inmemory), and the first provider that
+ * supports the capabilities is used to create the database.
+ *
+ * Note that the Database
interface is not intended to always create a database.
+ * It will do so for {@link DerbyDatabase} (inmemory), but with {@link ExternalDatabase}
+ * it simply connects to an external database based on system properties or environment
+ * variables.
+ *
JPATester
is responsible for: