KodoJDO Resource Adapter for integration of the Kodo Java Data Objects (JDO) implementation with J2EE 1.3 compliant managed environments kodo16.gif kodo32.gif Solarmetric, Inc. 1.0 jdo 1.0 See http://www.solarmetric.com for terms and license conditions. true kodo.jdbc.ee.JDBCManagedConnectionFactory javax.resource.cci.ConnectionFactory kodo.jdbc.ee.JDBCConnectionFactory javax.resource.cci.Connection kodo.runtime.PersistenceManagerImpl NoTransaction A comma-separated list of query aggregate listeners to add to the default list of extensions. Each listener must implement the kodo.jdbc.query.JDBCAggregateListener interface. AggregateListeners java.lang.String If true, Kodo will order all SQL to meet constraints introduced by auto-incrementing primary keys. If you only use auto-incrementing columns for non-primary key values or none of your objects have relations to auto-incrementing primary key objects, you can leave this property false. Defaults to false. AutoIncrementConstraints java.lang.Boolean false The kodo.jdbc.meta.ClassIndicator to use by default for new mappings. The class indicator is responsible for tracking the concrete class or subclass implemented by the object stored in each row of a table. ClassIndicator java.lang.String in-class-name The kodo.util.ClassResolver implementation that should be used for JDO class resolution. Defaults to a JDO spec-compliant resolver. ClassResolver java.lang.String spec The class name of either the JDBC java.sql.Driver, or an instance of a javax.sql.DataSource to use to connect to the non-XA data source. Connection2DriverName java.lang.String The password for the user specified in Connection2UserName Connection2Password java.lang.String A comma-separated list of properties to be passed to the non-XA JDBC Driver when obtaining a Connection. Properties are of the form "key=value". If the given JDBC Driver class is a DataSource, these properties will be used to configure the bean properties of the DataSource. Connection2Properties java.lang.String The URL for the non-XA data source. Connection2URL java.lang.String The username for the connection listed in Connection2URL. Connection2UserName java.lang.String A comma-separated list of com.solarmetric.jdbc.ConnectionDecorator implementations to install on all connection pools. ConnectionDecorators java.lang.String The class name of either the JDBC java.sql.Driver, or an instance of a javax.sql.DataSource to use to connect to the data source. ConnectionDriverName java.lang.String The JNDI name of the connection factory to use for finding non-XA connections. If specified, this is the connection that will be used for obtaining sequence numbers. ConnectionFactory2Name java.lang.String A comma-separated list of properties used to configure the javax.sql.DataSource used as the non-XA ConnectionFactory. Each property should be of the form "key=value", where "key" is the name of some bean-like property of the data source. ConnectionFactory2Properties java.lang.String The JNDI name of the connection factory to use for obtaining connections. ConnectionFactoryName java.lang.String AuctionDataSource A comma-separated list of properties used to configure the javax.sql.DataSource used as the ConnectionFactory. Each property should be of the form "key=value", where "key" is the name of some bean-like property of the data source. ConnectionFactoryProperties java.lang.String The password for the user specified in ConnectionUserName ConnectionPassword java.lang.String A comma-separated list of properties to be passed to the JDBC Driver when obtaining a Connection. Properties are of the form "key=value". If the given JDBC Driver class is a DataSource, these properties will be used to configure the bean properties of the DataSource. ConnectionProperties java.lang.String This property dictates when PersistenceManagers will retain and release data store connections. Available options are "on-demand" for retaining a connection only during pessimistic transactions and data store operations, "transaction" for retaining a connection for the life of each transaction, or "persistence-manager" to indicate that a persistence manager should retain and reuse a single connection for its entire lifespan. ConnectionRetainMode java.lang.String on-demand The URL for the data source. ConnectionURL java.lang.String The username for the connection listed in ConnectionURL. ConnectionUserName java.lang.String Set to true if you''d like Kodo to copy all object ids before returning them to your code. If you do not plan on modifying identity objects, you can set this property to false to avoid the copying overhead. CopyObjectIds java.lang.Boolean false Plugin used to cache data loaded from the data store. Must implement kodo.datacache.DataCache. DataCache java.lang.String true The number of seconds that data in the data cache is valid for. A value of 0 or less means that by default, cached data does not time out. DataCacheTimeout java.lang.Integer -1 The type of data source in use. Available options are "local" for a standard data source under Kodo''s control, or "enlisted" for a data source managed by an application server and automatically enlisted in global transactions. DataSourceMode java.lang.String enlisted The kodo.jdbc.sql.DBDictionary to use for database interaction. This is auto-detected based on the setting of javax.jdo.option.ConnectionURL, so you need only set this to override the default with your own custom dictionary or if you are using an unrecognized driver. DBDictionary java.lang.String JoinSyntax=sql92 Specifies the default eager fetch mode to use. Either "none" to never eagerly-load relations, "join" for selecting 1-1 relations along with the target object using inner or outer joins, or "parallel" for selecting 1-1 relations via joins, and collections (including to-many relations) along with the target object using separate select statements executed in parallel. EagerFetchMode java.lang.String parallel The number of rows that will be pre-fetched when an element in a Query result is accessed. Use -1 to pre-fetch all results. FetchBatchSize java.lang.Integer -1 The name of the JDBC fetch direction to use. Standard values are "forward", "reverse", and "unknown". FetchDirection java.lang.String forward A comma-separated list of fetch group names that PersistenceManagers will load by default when loading data from the data store. FetchGroups java.lang.String A comma-separated list of query filter listeners to add to the default list of extensions. Each listener must implement the kodo.jdbc.query.JDBCFilterListener interface. FilterListeners java.lang.String Whether or not Kodo should automatically flush modifications to the data store before executing queries. FlushBeforeQueries java.lang.String with-connection If true, Kodo will order all SQL inserts, updates, and deletes to meet your schema''s foreign key constraints. Defaults to false. ForeignKeyConstraints java.lang.Boolean false If false, then the JDO implementation must consider modifications, deletions, and additions in the PersistenceManager transaction cache when executing a query inside a transaction. Else, the implementation is free to ignore the cache and execute the query directly against the data store. IgnoreCache java.lang.Boolean true Plugin used to manage inverse relations during flush. Set to true to use the default inverse manager. Custom inverse managers must extend kodo.runtime.InverseManager. InverseManager java.lang.String false A comma-separated list of com.solarmetric.jdbc.JDBCListener implementations to install on all connection pools. JDBCListeners java.lang.String Plugin used to provide local management via JMX. Must implement com.solarmetric.manage.jmx.gui.JMXInterface. JMXInterface java.lang.String none The license key provided to you by SolarMetric. Keys are available at www.solarmetric.com LicenseKey java.lang.String Enter your license key here Plugin used to handle acquiring locks on persistent instances. Must implement kodo.runtime.LockManager. LockManager java.lang.String pessimistic The number of milliseconds to wait for an object lock before throwing an exception, or -1 for no limit. LockTimeout java.lang.Integer -1 LogFactory and configuration for Kodo''s logging needs. Log java.lang.String kodo(DefaultLevel=WARN, Tool=INFO, Runtime=INFO) The mode to use for calculating the size of large result sets. Legal values are "unknown", "last", and "query". LRSSize java.lang.String query Plugin used to integrate with an external transaction manager. Must implement kodo.runtime.ManagedRuntime. ManagedRuntime java.lang.String auto The kodo.jdbc.meta.MappingFactory that will provide the object-relational mapping information needed to map each persistent class to the database. MappingFactory java.lang.String file The MBeans to register for monitoring via JMX. MBeans java.lang.String Strategy for finding/creating JMX MBeanServer. MBeanServerStrategy java.lang.String If true, then the application plans to have multiple threads simultaneously accessing a single PersistenceManager, so measures must be taken to ensure that the implementation is thread-safe. Otherwise, the implementation need not address thread safety. Multithreaded java.lang.Boolean false If true, then it is possible to read persistent data outside the context of a transaction. Otherwise, a transaction must be in progress in order read data. NontransactionalRead java.lang.Boolean true If true, then it is possible to write to fields of a persistent-nontransactional object when a transaction is not in progress. If false, such a write will result in a JDOUserException. NontransactionalWrite java.lang.Boolean false Determines the persistence manager's behavior in calls to getObjectById with a validate parameter of false. Use "check" to check that a database record exists for the object and load its fetch group fields. Use "hollow" to return a hollow instance. ObjectLookupMode java.lang.String hollow Selects between optimistic and pessimistic (data store) transactional modes. Optimistic java.lang.Boolean true The name of the concrete implementation of javax.jdo.PersistenceManagerFactory that javax.jdo.JDOHelper.getPersistenceManagerFactory () should create. For Kodo JDO, this should be kodo.jdbc.runtime.JDBCPersistenceManagerFactory or a custom extension of this type. PersistenceManagerFactoryClass java.lang.String kodo.jdbc.runtime.JDBCPersistenceManagerFactory Persistence manager plugin and properties. If you use a custom class, it must extend kodo.runtime.PersistenceManagerImpl. PersistenceManagerImpl java.lang.String default Configure this persistence manager factory to service remote persistence managers. PersistenceManagerServer java.lang.String false A comma-separated list of the class names of all persistent classes to register whenever a persistence manager is obtained. PersistentClasses java.lang.String Plugin used as the ProfilingAgent. ProfilingAgent java.lang.String none Plugin used as the ProfilingHelper. ProfilingHelper java.lang.String stack Plugin used as the ProfilingInterface. ProfilingInterface java.lang.String none Plugin used to proxy second class object fields of managed instances. Must implement kodo.util.ProxyManager. ProxyManager java.lang.String default Plugin used to cache query results loaded from the data store. Must implement kodo.datacache.QueryCache. QueryCache java.lang.String true Plugin used to cache query compilation data. Must implement java.util.Map. Does not need to be thread-safe -- it will be wrapped via the Collections.synchronizedMap() method if it does not extend kodo.util.CacheMap. QueryCompilationCache java.lang.String true The default lock level to use when loading objects within non-optimistic transactions. Set to none, read, write, or the numeric value of the desired lock level for your lock manager. ReadLockLevel java.lang.String read Plugin used to communicate commit information among JVMs. Must implement kodo.event.RemoteCommitProvider. RemoteCommitProvider java.lang.String sjvm Plugin used to provide remote management via JMX. Must implement com.solarmetric.manage.jmx.RemoteJMXAdaptor. RemoteJMXAdaptor java.lang.String none If true, then mutable second-class object fields in a persistence-capable object that have been changed during a transaction will be rolled back to their original values upon a rollback. Otherwise, the values will be set to null and re-loaded on next access. RestoreMutableValues java.lang.Boolean false If true, then fields in a persistence-capable object that have been changed during a transaction will be rolled back to their original values upon a rollback. Otherwise, the values will not be changed upon rollback. RestoreValues java.lang.Boolean true The name of the JDBC result set type to use. Standard values are "forward-only", "scroll-sensitive", and "scroll-insensitive". ResultSetType java.lang.String forward-only If true, then fields in a persistence-capable object that have been read during a transaction must be preserved in memory after the transaction commits. Otherwise, persistence-capable objects must transition to the hollow state upon commit, meaning that subsequent reads will result in a database round-trip. RetainValues java.lang.Boolean true If false, then nontransactional objects will be cleared when they are first modified in an optimistic transaction. This cuts down on the possible number of optimistic locking exceptions, but it not JDO-standard behavior and can also have negative performance consequences. RetainValuesInOptimistic java.lang.Boolean true The kodo.jdbc.schema.SchemaFactory that will provide information about the existing tables and other database structures at runtime. SchemaFactory java.lang.String native A comma-separated list of the schemas you are using for persistent class tables. Schemas java.lang.String The kodo.jdbc.schema.SequenceFactory to use to generate primary key values. SequenceFactory java.lang.String db Specifies the default subclass fetch mode to use. Eitehr "none" to always select data in base class tables only, "join" to outer-join to tables for all subclasses, or "parallel" to execute a separate select in parallel for each possible subclass. Parallel mode is only applicable to JDO Query execution; in other situations it mirrors join mode. SubclassFetchMode java.lang.String join The kodo.jdbc.meta.ClassMapping to use by default for new subclass mappings. Typical subclass mapping types are "flat" (the subclass columns are added to the parent table) and "vertical" (a new table is created for the extra subclass columns). SubclassMapping java.lang.String flat Controls whether Kodo will attempt to run the mapping tool on all persistent classes to synchronize their mappings and schema at runtime. SynchronizeMappings java.lang.String The name of the JDBC transaction isolation level to use. "default" indicates to use the JDBC driver''s default level. Other standard values are "none", "read-committed", "read-uncommitted", "repeatable-read", and "serializable". TransactionIsolation java.lang.String default Either "local" or "managed". TransactionMode java.lang.String managed The kodo.jdbc.runtime.UpdateManager to use to flush persistent object modifications to the database. UpdateManager java.lang.String default The kodo.jdbc.meta.VersionIndicator to use by default for new mappings. The version indicator is responsible for versioning objects so that optimistic lock violations can be detected. VersionIndicator java.lang.String version-number The default lock level to use when changing objects within non-optimistic transactions. Set to none, read, write, or the numeric value of the desired lock level for your lock manager. WriteLockLevel java.lang.String write BasicPassword javax.resource.security.PasswordCredential false