View Javadoc

1   /*
2    * Licensed to the Apache Software Foundation (ASF) under one or more
3    * contributor license agreements.  See the NOTICE file distributed with
4    * this work for additional information regarding copyright ownership.
5    * The ASF licenses this file to You under the Apache License, Version 2.0
6    * (the "License"); you may not use this file except in compliance with
7    * the License.  You may obtain a copy of the License at
8    *
9    *     http://www.apache.org/licenses/LICENSE-2.0
10   *
11   * Unless required by applicable law or agreed to in writing, software
12   * distributed under the License is distributed on an "AS IS" BASIS,
13   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14   * See the License for the specific language governing permissions and
15   * limitations under the License.
16   */
17  
18  package javax.jdo;
19  
20  /**
21   * Constant values used in JDO.
22   *
23   * @since 2.1
24   * @version 2.2
25   */
26  public interface Constants {
27  
28      /**
29       * The name of the standard service configuration resource text file containing
30       * the name of an implementation of {@link PersistenceManagerFactory}.
31       * Constant value is <code>META-INF/services/javax.jdo.PersistenceManagerFactory</code>.
32       *
33       * @since 2.1
34       */
35      static String SERVICE_LOOKUP_PMF_RESOURCE_NAME
36          = "META-INF/services/javax.jdo.PersistenceManagerFactory";
37  
38      /**
39       * The name of the standard service configuration resource text file containing
40       * the name of an enhancer of {@link JDOEnhancer}.
41       * Constant value is <code>META-INF/services/javax.jdo.JDOEnhancer</code>.
42       * @since 2.3
43       */
44      static String SERVICE_LOOKUP_ENHANCER_RESOURCE_NAME
45          = "META-INF/services/javax.jdo.JDOEnhancer";
46  
47      /**
48       * The name of the standard JDO configuration resource file(s).
49       * Constant value is <code>META-INF/jdoconfig.xml</code>.
50       *
51       * @since 2.1
52       */
53      static String JDOCONFIG_RESOURCE_NAME
54          = "META-INF/jdoconfig.xml";
55  
56      /**
57       * The standard JDO configuration schema namespace.
58       * Constant value is <code>http://java.sun.com/xml/ns/jdo/jdoconfig</code>.
59       *
60       * @since 2.1
61       */
62      static String JDOCONFIG_XSD_NS
63          = "http://java.sun.com/xml/ns/jdo/jdoconfig";
64  
65      /**
66       * The standard JDO metadata schema namespace.
67       * Constant value is <code>http://java.sun.com/xml/ns/jdo/jdo</code>.
68       *
69       * @since 2.1
70       */
71      static String JDO_XSD_NS
72          = "http://java.sun.com/xml/ns/jdo/jdo";
73  
74      /**
75       * The standard JDO object-repository mapping schema namespace.
76       * Constant value is <code>http://java.sun.com/xml/ns/jdo/orm</code>.
77       *
78       * @since 2.1
79       */
80      static String ORM_XSD_NS
81          = "http://java.sun.com/xml/ns/jdo/orm";
82  
83      /**
84       * The standard JDO query schema namespace.
85       * Constant value is <code>http://java.sun.com/xml/ns/jdo/jdoquery</code>.
86       *
87       * @since 2.1
88       */
89      static String JDOQUERY_XSD_NS
90          = "http://java.sun.com/xml/ns/jdo/jdoquery";
91  
92      /**
93       * The name of the persistence manager factory element in the JDO
94       * configuration file.
95       * Constant value is <code>persistence-manager-factory</code>.
96       *
97       * @since 2.1
98       */
99      static String ELEMENT_PERSISTENCE_MANAGER_FACTORY
100         = "persistence-manager-factory";
101 
102     /**
103      * The name of the persistence manager factory element's "class" attribute.
104      *
105      * @since 2.1
106      */
107     static String PMF_ATTRIBUTE_CLASS
108         = "class";
109     /**
110      * The name of the persistence manager factory element's
111      * "name" attribute.
112      *
113      * @since 2.1
114      */
115     static String PMF_ATTRIBUTE_NAME
116         = "name";
117     /**
118      * The name of the persistence manager factory element's
119      * "persistence-unit-name" attribute.
120      *
121      * @since 2.1
122      */
123     static String PMF_ATTRIBUTE_PERSISTENCE_UNIT_NAME
124         = "persistence-unit-name";
125     /**
126      * The name of the persistence manager factory element's "optimistic"
127      * attribute.
128      *
129      * @since 2.1
130      */
131     static String PMF_ATTRIBUTE_OPTIMISTIC
132         = "optimistic";
133     /**
134      * The name of the persistence manager factory element's "readonly"
135      * attribute.
136      *
137      * @since 2.2
138      */
139     static String PMF_ATTRIBUTE_READONLY
140         = "readonly";
141     /**
142      * The name of the persistence manager factory element's "retain-values"
143      * attribute.
144      *
145      * @since 2.1
146      */
147     static String PMF_ATTRIBUTE_RETAIN_VALUES
148         = "retain-values";
149     /**
150      * The name of the persistence manager factory element's "restore-values"
151      * attribute.
152      *
153      * @since 2.1
154      */
155     static String PMF_ATTRIBUTE_RESTORE_VALUES
156         = "restore-values";
157     /**
158      * The name of the persistence manager factory element's "ignore-cache"
159      * attribute.
160      *
161      * @since 2.1
162      */
163     static String PMF_ATTRIBUTE_IGNORE_CACHE
164         = "ignore-cache";
165     /**
166      * The name of the persistence manager factory element's
167      * "nontransactional-read" attribute.
168      *
169      * @since 2.1
170      */
171     static String PMF_ATTRIBUTE_NONTRANSACTIONAL_READ
172         = "nontransactional-read";
173     /**
174      * The name of the persistence manager factory element's
175      * "nontransactional-write" attribute.
176      *
177      * @since 2.1
178      */
179     static String PMF_ATTRIBUTE_NONTRANSACTIONAL_WRITE
180         = "nontransactional-write";
181     /**
182      * The name of the persistence manager factory element's "multithreaded"
183      * attribute.
184      *
185      * @since 2.1
186      */
187     static String PMF_ATTRIBUTE_MULTITHREADED
188         = "multithreaded";
189     /**
190      * The name of the persistence manager factory element's
191      * "connection-driver-name" attribute.
192      *
193      * @since 2.1
194      */
195     static String PMF_ATTRIBUTE_CONNECTION_DRIVER_NAME
196         = "connection-driver-name";
197     /**
198      * The name of the persistence manager factory element's
199      * "connection-user-name" attribute.
200      *
201      * @since 2.1
202      */
203     static String PMF_ATTRIBUTE_CONNECTION_USER_NAME
204         = "connection-user-name";
205     /**
206      * The name of the persistence manager factory element's
207      * "connection-password" attribute.
208      *
209      * @since 2.1
210      */
211     static String PMF_ATTRIBUTE_CONNECTION_PASSWORD
212         = "connection-password";
213     /**
214      * The name of the persistence manager factory element's "connection-url"
215      * attribute.
216      *
217      * @since 2.1
218      */
219     static String PMF_ATTRIBUTE_CONNECTION_URL
220         = "connection-url";
221     /**
222      * The name of the persistence manager factory element's
223      * "connection-factory-name" attribute.
224      *
225      * @since 2.1
226      */
227     static String PMF_ATTRIBUTE_CONNECTION_FACTORY_NAME
228         = "connection-factory-name";
229     /**
230      * The name of the persistence manager factory element's
231      * "connection-factory2-name" attribute.
232      *
233      * @since 2.1
234      */
235     static String PMF_ATTRIBUTE_CONNECTION_FACTORY2_NAME
236         = "connection-factory2-name";
237     /**
238      * The name of the persistence manager factory element's
239      * "detach-all-on-commit" attribute.
240      *
241      * @since 2.1
242      */
243     static String PMF_ATTRIBUTE_DETACH_ALL_ON_COMMIT
244         = "detach-all-on-commit";
245     /**
246      * The name of the persistence manager factory element's
247      * "copy-on-attach" attribute.
248      *
249      * @since 2.1
250      */
251     static String PMF_ATTRIBUTE_COPY_ON_ATTACH
252         = "copy-on-attach";
253     /**
254      * The name of the persistence manager factory element's "mapping"
255      * attribute.
256      *
257      * @since 2.1
258      */
259     static String PMF_ATTRIBUTE_MAPPING
260         = "mapping";
261     /**
262      * The name of the persistence manager factory element's
263      * "server-time-zone-id" attribute.
264      *
265      * @since 2.1
266      */
267     static String PMF_ATTRIBUTE_SERVER_TIME_ZONE_ID
268         = "server-time-zone-id";
269     /**
270      * The name of the persistence manager factory element's
271      * "query-timeout-millis" attribute.
272      *
273      * @since 2.3
274      */
275     static String PMF_ATTRIBUTE_QUERY_TIMEOUT
276         = "query-timeout-millis";
277 
278     /**
279      * The name of the persistence manager factory property elements in the JDO
280      * configuration file.
281      */
282     static String ELEMENT_PROPERTY
283         = "property";
284     /**
285      * The name of the persistence manager factory property element's "name"
286      * attribute.
287      */
288     static String PROPERTY_ATTRIBUTE_NAME
289         = "name";
290     /**
291      * The name of the persistence manager factory property element's "value"
292      * attribute.
293      */
294     static String PROPERTY_ATTRIBUTE_VALUE
295         = "value";
296 
297     /**
298      * The name of the instance lifecycle listener element in the JDO
299      * configuration file.
300      */
301     static String ELEMENT_INSTANCE_LIFECYCLE_LISTENER
302         = "instance-lifecycle-listener";
303 
304     /**
305      * The name of the instance lifecycle listener element's "listener"
306      * attribute.
307      */
308     static String INSTANCE_LIFECYCLE_LISTENER_ATTRIBUTE_LISTENER
309         = "listener";
310     /**
311      * The name of the instance lifecycle listener element's "classes"
312      * attribute.
313      */
314     static String INSTANCE_LIFECYCLE_LISTENER_ATTRIBUTE_CLASSES
315         = "classes";
316 
317     /**
318      * "javax.jdo.option.TransientTransactional"
319      *
320      * @see PersistenceManagerFactory#supportedOptions()
321      * @since 2.1
322      */
323     static String OPTION_TRANSACTIONAL_TRANSIENT
324         = "javax.jdo.option.TransientTransactional";
325     /**
326      * "javax.jdo.option.NontransactionalRead"
327      *
328      * @see PersistenceManagerFactory#supportedOptions()
329      * @since 2.1
330      */
331     static String OPTION_NONTRANSACTIONAL_READ
332         = "javax.jdo.option.NontransactionalRead";
333     /**
334      * "javax.jdo.option.NontransactionalWrite"
335      *
336      * @see PersistenceManagerFactory#supportedOptions()
337      * @since 2.1
338      */
339     static String OPTION_NONTRANSACTIONAL_WRITE
340         = "javax.jdo.option.NontransactionalWrite";
341     /**
342      * "javax.jdo.option.RetainValues"
343      *
344      * @see PersistenceManagerFactory#supportedOptions()
345      * @since 2.1
346      */
347     static String OPTION_RETAIN_VALUES
348         = "javax.jdo.option.RetainValues";
349     /**
350      * "javax.jdo.option.Optimistic"
351      *
352      * @see PersistenceManagerFactory#supportedOptions()
353      * @since 2.1
354      */
355     static String OPTION_OPTIMISTIC
356         = "javax.jdo.option.Optimistic";
357     /**
358      * "javax.jdo.option.ApplicationIdentity"
359      *
360      * @see PersistenceManagerFactory#supportedOptions()
361      * @since 2.1
362      */
363     static String OPTION_APPLICATION_IDENTITY
364         = "javax.jdo.option.ApplicationIdentity";
365     /**
366      * "javax.jdo.option.DatastoreIdentity"
367      *
368      * @see PersistenceManagerFactory#supportedOptions()
369      * @since 2.1
370      */
371     static String OPTION_DATASTORE_IDENTITY
372         = "javax.jdo.option.DatastoreIdentity";
373     /**
374      * "javax.jdo.option.NonDurableIdentity"
375      *
376      * @see PersistenceManagerFactory#supportedOptions()
377      * @since 2.1
378      */
379     static String OPTION_NONDURABLE_IDENTITY
380         = "javax.jdo.option.NonDurableIdentity";
381     /**
382      * "javax.jdo.option.ArrayList"
383      *
384      * @see PersistenceManagerFactory#supportedOptions()
385      * @since 2.1
386      */
387     static String OPTION_ARRAYLIST
388         = "javax.jdo.option.ArrayList";
389     /**
390      * "javax.jdo.option.LinkedList"
391      *
392      * @see PersistenceManagerFactory#supportedOptions()
393      * @since 2.1
394      */
395     static String OPTION_LINKEDLIST
396         = "javax.jdo.option.LinkedList";
397     /**
398      * "javax.jdo.option.TreeMap"
399      *
400      * @see PersistenceManagerFactory#supportedOptions()
401      * @since 2.1
402      */
403     static String OPTION_TREEMAP
404         = "javax.jdo.option.TreeMap";
405     /**
406      * "javax.jdo.option.TreeSet"
407      *
408      * @see PersistenceManagerFactory#supportedOptions()
409      * @since 2.1
410      */
411     static String OPTION_TREESET
412         = "javax.jdo.option.TreeSet";
413     /**
414      * "javax.jdo.option.Vector"
415      *
416      * @see PersistenceManagerFactory#supportedOptions()
417      * @since 2.1
418      */
419     static String OPTION_VECTOR
420         = "javax.jdo.option.Vector";
421     /**
422      * "javax.jdo.option.Array"
423      *
424      * @see PersistenceManagerFactory#supportedOptions()
425      * @since 2.1
426      */
427     static String OPTION_ARRAY
428         = "javax.jdo.option.Array";
429     /**
430      * "javax.jdo.option.NullCollection"
431      *
432      * @see PersistenceManagerFactory#supportedOptions()
433      * @since 2.1
434      */
435     static String OPTION_NULL_COLLECTION
436         = "javax.jdo.option.NullCollection";
437     /**
438      * "javax.jdo.option.ChangeApplicationIdentity"
439      *
440      * @see PersistenceManagerFactory#supportedOptions()
441      * @since 2.1
442      */
443     static String OPTION_CHANGE_APPLICATION_IDENTITY
444         = "javax.jdo.option.ChangeApplicationIdentity";
445     /**
446      * "javax.jdo.option.BinaryCompatibility"
447      *
448      * @see PersistenceManagerFactory#supportedOptions()
449      * @since 2.1
450      */
451     static String OPTION_BINARY_COMPATIBILITY
452         = "javax.jdo.option.BinaryCompatibility";
453     /**
454      * "javax.jdo.option.GetDataStoreConnection"
455      *
456      * @see PersistenceManagerFactory#supportedOptions()
457      * @since 2.1
458      */
459     static String OPTION_GET_DATASTORE_CONNECTION
460         = "javax.jdo.option.GetDataStoreConnection";
461     /**
462      * "javax.jdo.option.GetJDBCConnection"
463      *
464      * @see PersistenceManagerFactory#supportedOptions()
465      * @since 2.1
466      */
467     static String OPTION_GET_JDBC_CONNECTION
468         = "javax.jdo.option.GetJDBCConnection";
469     /**
470      * "javax.jdo.query.SQL"
471      *
472      * @see PersistenceManagerFactory#supportedOptions()
473      * @since 2.1
474      */
475     static String OPTION_QUERY_SQL
476         = "javax.jdo.query.SQL";
477     /**
478      * "javax.jdo.option.UnconstrainedQueryVariables"
479      *
480      * @see PersistenceManagerFactory#supportedOptions()
481      * @since 2.1
482      */
483     static String OPTION_UNCONSTRAINED_QUERY_VARIABLES
484         = "javax.jdo.option.UnconstrainedQueryVariables";
485     /**
486      * "javax.jdo.option.version.DateTime"
487      *
488      * @see PersistenceManagerFactory#supportedOptions()
489      * @since 2.1
490      */
491     static String OPTION_VERSION_DATETIME
492         = "javax.jdo.option.version.DateTime";
493     /**
494      * "javax.jdo.option.version.StateImage"
495      *
496      * @see PersistenceManagerFactory#supportedOptions()
497      * @since 2.1
498      */
499     static String OPTION_VERSION_STATE_IMAGE
500         = "javax.jdo.option.version.StateImage";
501     /**
502      * "javax.jdo.option.PreDirtyEvent"
503      *
504      * @see PersistenceManagerFactory#supportedOptions()
505      * @since 2.1
506      */
507     static String OPTION_PREDIRTY_EVENT
508         = "javax.jdo.option.PreDirtyEvent";
509     /**
510      * "javax.jdo.option.mapping.HeterogeneousObjectType"
511      *
512      * @see PersistenceManagerFactory#supportedOptions()
513      * @since 2.1
514      */
515     static String OPTION_MAPPING_HETEROGENEOUS_OBJECT_TYPE
516         = "javax.jdo.option.mapping.HeterogeneousObjectType";
517     /**
518      * "javax.jdo.option.mapping.HeterogeneousInterfaceType"
519      *
520      * @see PersistenceManagerFactory#supportedOptions()
521      * @since 2.1
522      */
523     static String OPTION_MAPPING_HETEROGENEOUS_INTERFACE_TYPE
524         = "javax.jdo.option.mapping.HeterogeneousInterfaceType";
525     /**
526      * "javax.jdo.option.mapping.JoinedTablePerClass"
527      *
528      * @see PersistenceManagerFactory#supportedOptions()
529      * @since 2.1
530      */
531     static String OPTION_MAPPING_JOINED_TABLE_PER_CLASS
532         = "javax.jdo.option.mapping.JoinedTablePerClass";
533     /**
534      * "javax.jdo.option.mapping.JoinedTablePerConcreteClass"
535      *
536      * @see PersistenceManagerFactory#supportedOptions()
537      * @since 2.1
538      */
539     static String OPTION_MAPPING_JOINED_TABLE_PER_CONCRETE_CLASS
540         = "javax.jdo.option.mapping.JoinedTablePerConcreteClass";
541     /**
542      * "javax.jdo.option.mapping.NonJoinedTablePerConcreteClass"
543      *
544      * @see PersistenceManagerFactory#supportedOptions()
545      * @since 2.1
546      */
547     static String OPTION_MAPPING_NON_JOINED_TABLE_PER_CONCRETE_CLASS
548         = "javax.jdo.option.mapping.NonJoinedTablePerConcreteClass";
549     /**
550      * "javax.jdo.option.mapping.RelationSubclassTable"
551      *
552      * @see PersistenceManagerFactory#supportedOptions()
553      * @since 2.1
554      */
555     static String OPTION_MAPPING_RELATION_SUBCLASS_TABLE
556         = "javax.jdo.option.mapping.RelationSubclassTable";
557 
558     /**
559      * "javax.jdo.PersistenceManagerFactoryClass"
560      *
561      * @see JDOHelper#getPersistenceManagerFactory(java.util.Map)
562      * @since 2.1
563      */
564     static String PROPERTY_PERSISTENCE_MANAGER_FACTORY_CLASS
565         = "javax.jdo.PersistenceManagerFactoryClass";
566 
567     /**
568      * "javax.jdo.option.Optimistic"
569      *
570      * @see PersistenceManagerFactory#getOptimistic()
571      * @since 2.1
572      */
573     static String PROPERTY_OPTIMISTIC
574         = "javax.jdo.option.Optimistic";
575     /**
576      * "javax.jdo.option.ReadOnly"
577      *
578      * @see PersistenceManagerFactory#getReadOnly()
579      * @since 2.2
580      */
581     static String PROPERTY_READONLY
582         = "javax.jdo.option.ReadOnly";
583     /**
584      * "javax.jdo.option.RetainValues"
585      *
586      * @see PersistenceManagerFactory#getRetainValues()
587      * @since 2.1
588      */
589     static String PROPERTY_RETAIN_VALUES
590         = "javax.jdo.option.RetainValues";
591     /**
592      * "javax.jdo.option.RestoreValues"
593      *
594      * @see PersistenceManagerFactory#getRestoreValues()
595      * @since 2.1
596      */
597     static String PROPERTY_RESTORE_VALUES
598         = "javax.jdo.option.RestoreValues";
599     /**
600      * "javax.jdo.option.IgnoreCache"
601      *
602      * @see PersistenceManagerFactory#getIgnoreCache()
603      * @since 2.1
604      */
605     static String PROPERTY_IGNORE_CACHE
606         = "javax.jdo.option.IgnoreCache";
607     /**
608      * "javax.jdo.option.NontransactionalRead"
609      *
610      * @see PersistenceManagerFactory#getNontransactionalRead()
611      * @since 2.1
612      */
613     static String PROPERTY_NONTRANSACTIONAL_READ
614         = "javax.jdo.option.NontransactionalRead";
615     /**
616      * "javax.jdo.option.NontransactionalWrite"
617      *
618      * @see PersistenceManagerFactory#getNontransactionalWrite()
619      * @since 2.1
620      */
621     static String PROPERTY_NONTRANSACTIONAL_WRITE
622         = "javax.jdo.option.NontransactionalWrite";
623     /**
624      * "javax.jdo.option.Multithreaded"
625      *
626      * @see PersistenceManagerFactory#getMultithreaded()
627      * @since 2.1
628      */
629     static String PROPERTY_MULTITHREADED
630         = "javax.jdo.option.Multithreaded";
631     /**
632      * "javax.jdo.option.TransactionIsolationLevel"
633      *
634      * @since 2.2
635      */
636     static String PROPERTY_TRANSACTION_ISOLATION_LEVEL
637         = "javax.jdo.option.TransactionIsolationLevel";
638     /**
639      * "javax.jdo.option.TransactionIsolationLevel.read-uncommitted"
640      *
641      * @see PersistenceManagerFactory#supportedOptions()
642      * @since 2.2
643      */
644     static String PROPERTY_TRANSACTION_ISOLATION_LEVEL_READ_UNCOMMITTED
645         = "javax.jdo.option.TransactionIsolationLevel.read-uncommitted";
646     /**
647      * "javax.jdo.option.TransactionIsolationLevel.read-committed"
648      *
649      * @see PersistenceManagerFactory#supportedOptions()
650      * @since 2.2
651      */
652     static String PROPERTY_TRANSACTION_ISOLATION_LEVEL_READ_COMMITTED
653         = "javax.jdo.option.TransactionIsolationLevel.read-committed";
654     /**
655      * "javax.jdo.option.TransactionIsolationLevel.repeatable-read"
656      *
657      * @see PersistenceManagerFactory#supportedOptions()
658      * @since 2.2
659      */
660     static String PROPERTY_TRANSACTION_ISOLATION_LEVEL_REPEATABLE_READ
661         = "javax.jdo.option.TransactionIsolationLevel.repeatable-read";
662     /**
663      * "javax.jdo.option.TransactionIsolationLevel.snapshot"
664      *
665      * @see PersistenceManagerFactory#supportedOptions()
666      * @since 2.2
667      */
668     static String PROPERTY_TRANSACTION_ISOLATION_LEVEL_SNAPSHOT
669         = "javax.jdo.option.TransactionIsolationLevel.snapshot";
670     /**
671      * "javax.jdo.option.TransactionIsolationLevel.serializable"
672      *
673      * @see PersistenceManagerFactory#supportedOptions()
674      * @since 2.2
675      */
676     static String PROPERTY_TRANSACTION_ISOLATION_LEVEL_SERIALIZABLE
677         = "javax.jdo.option.TransactionIsolationLevel.serializable";
678     /**
679      * "javax.jdo.option.DetachAllOnCommit"
680      *
681      * @see PersistenceManagerFactory#getDetachAllOnCommit()
682      * @since 2.1
683      */
684     static String PROPERTY_DETACH_ALL_ON_COMMIT
685         = "javax.jdo.option.DetachAllOnCommit";
686     /**
687      * "javax.jdo.option.CopyOnAttach"
688      *
689      * @see PersistenceManagerFactory#getCopyOnAttach()
690      * @since 2.1
691      */
692     static String PROPERTY_COPY_ON_ATTACH
693         = "javax.jdo.option.CopyOnAttach";
694     /**
695      * "javax.jdo.option.ConnectionDriverName"
696      *
697      * @see PersistenceManagerFactory#getConnectionDriverName()
698      * @since 2.1
699      */
700     static String PROPERTY_CONNECTION_DRIVER_NAME
701         = "javax.jdo.option.ConnectionDriverName";
702     /**
703      * "javax.jdo.option.ConnectionUserName"
704      *
705      * @see PersistenceManagerFactory#getConnectionUserName()
706      * @since 2.1
707      */
708     static String PROPERTY_CONNECTION_USER_NAME
709         = "javax.jdo.option.ConnectionUserName";
710     /**
711      * "javax.jdo.option.Password"
712      *
713      * @since 2.1
714      */
715     static String PROPERTY_CONNECTION_PASSWORD
716         = "javax.jdo.option.ConnectionPassword";
717     /**
718      * "javax.jdo.option.ConnectionURL"
719      *
720      * @see PersistenceManagerFactory#getConnectionURL()
721      * @since 2.1
722      */
723     static String PROPERTY_CONNECTION_URL
724         = "javax.jdo.option.ConnectionURL";
725     /**
726      * "javax.jdo.option.ConnectionFactoryName"
727      *
728      * @see PersistenceManagerFactory#getConnectionFactoryName()
729      * @since 2.1
730      */
731     static String PROPERTY_CONNECTION_FACTORY_NAME
732         = "javax.jdo.option.ConnectionFactoryName";
733     /**
734      * "javax.jdo.option.ConnectionFactory2Name"
735      *
736      * @see PersistenceManagerFactory#getConnectionFactory2Name()
737      * @since 2.1
738      */
739     static String PROPERTY_CONNECTION_FACTORY2_NAME
740         = "javax.jdo.option.ConnectionFactory2Name";
741     /**
742      * "javax.jdo.option.Mapping"
743      *
744      * @see PersistenceManagerFactory#getMapping()
745      * @since 2.1
746      */
747     static String PROPERTY_MAPPING
748         = "javax.jdo.option.Mapping";
749     /**
750      * "javax.jdo.option.PersistenceUnitName"
751      *
752      * @see PersistenceManagerFactory#getPersistenceUnitName()
753      * @since 2.1
754      */
755     static String PROPERTY_PERSISTENCE_UNIT_NAME
756         = "javax.jdo.option.PersistenceUnitName";
757     /**
758      * "javax.jdo.option.Name"
759      *
760      * @see PersistenceManagerFactory#getName()
761      * @since 2.1
762      */
763     static String PROPERTY_NAME
764         = "javax.jdo.option.Name";
765 
766     /**
767      * "javax.jdo.option.spi.ResourceName"
768      * @since 2.1
769      */
770     static String PROPERTY_SPI_RESOURCE_NAME
771         = "javax.jdo.option.spi.ResourceName";
772 
773     /**
774      * "javax.jdo.listener.InstanceLifecycleListener"
775      *
776      * @see PersistenceManagerFactory#addInstanceLifecycleListener(javax.jdo.listener.InstanceLifecycleListener,Class[])
777      * @see PersistenceManagerFactory#removeInstanceLifecycleListener(javax.jdo.listener.InstanceLifecycleListener)
778      */
779     static String PROPERTY_INSTANCE_LIFECYCLE_LISTENER
780         = "javax.jdo.listener.InstanceLifecycleListener";
781 
782     /**
783      * Prefix used to configure
784      * {@link javax.jdo.listener.InstanceLifecycleListener} instances
785      * externally.
786      * To configure an <code>InstanceLifecycleListener</code> via properties,
787      * create a property name with the prefix of
788      * this constant and append the fully qualified listener class name, then
789      * set its value to the comma- or whitespace-delimited list
790      * of persistence-capable classes whose instances are to be observed.
791      * Use no value to indicate that instances of
792      * all persistence-capable classes are to be observed.<br>
793      * For example,<br>
794      * <code>javax.jdo.option.InstanceLifecycleListener.com.example.MyListener=com.example.Foo,com.example.Bar</code><br>
795      * is equivalent to calling<br>
796      * <code>pmf.addInstanceLifecycleListener(new com.example.MyListener(), new Class[] {com.example.Foo.class, com.example.Bar.class});</code><br>
797      * where <code>pmf</code> is an instance of type
798      * <code>PersistenceManagerFactory</code>.
799      *
800      * @see javax.jdo.PersistenceManagerFactory#addInstanceLifecycleListener(javax.jdo.listener.InstanceLifecycleListener,Class[])
801      * @since 2.1
802      */
803     static String PROPERTY_PREFIX_INSTANCE_LIFECYCLE_LISTENER
804         = PROPERTY_INSTANCE_LIFECYCLE_LISTENER + ".";
805 
806     /**
807      * Mapping "javax.jdo.mapping.Catalog"
808      *
809      * @since 2.1
810      */
811     static String PROPERTY_MAPPING_CATALOG
812         = "javax.jdo.mapping.Catalog";
813     /**
814      * Mapping "javax.jdo.mapping.Schema"
815      *
816      * @since 2.1
817      */
818     static String PROPERTY_MAPPING_SCHEMA
819         = "javax.jdo.mapping.Schema";
820 
821     /**
822      * Mapping "javax.jdo.option.ServerTimeZoneID"
823      *
824      * @since 2.1
825      */
826     static String PROPERTY_SERVER_TIME_ZONE_ID
827         = "javax.jdo.option.ServerTimeZoneID";
828     /**
829      * Mapping "javax.jdo.option.QueryTimeoutMillis"
830      *
831      * @since 2.3
832      */
833     static String PROPERTY_QUERY_TIMEOUT
834         = "javax.jdo.option.QueryTimeoutMillis";
835 
836     /**
837      * Nonconfigurable property constanct "VendorName"
838      *
839      * @see PersistenceManagerFactory#getProperties()
840      * @since 2.1
841      */
842     static String NONCONFIGURABLE_PROPERTY_VENDOR_NAME
843         = "VendorName";
844     /**
845      * Nonconfigurable property constanct "VersionNumber"
846      *
847      * @see PersistenceManagerFactory#getProperties()
848      * @since 2.1
849      */
850     static String NONCONFIGURABLE_PROPERTY_VERSION_NUMBER
851         = "VersionNumber";
852 
853     /**
854      * The value for TransactionType to specify that transactions
855      * are managed by the Java Transactions API, as documented in
856      * JSR-220.
857      *
858      * @since 2.1
859      */
860     static String JTA
861         = "JTA";
862 
863     /**
864      * The value for TransactionType to specify that transactions
865      * are managed by the javax.jdo.Transaction instance, similar
866      * to the usage as documented in JSR-220.
867      *
868      * @since 2.1
869      */
870     static String RESOURCE_LOCAL
871         = "RESOURCE_LOCAL";
872 
873     /**
874      * The name of the resource for the DTD of the standard JDO configuration
875      * file.
876      *
877      * @since 2.1
878      */
879     static String JDOCONFIG_DTD_RESOURCE
880         = "javax/jdo/jdoconfig_2_2.dtd";
881 
882     /**
883      * The name of the resource for the XML schema of the standard JDO
884      * configuration file.
885      *
886      * @since 2.1
887      */
888     static String JDOCONFIG_XSD_RESOURCE
889         = "javax/jdo/jdoconfig_2_2.xsd";
890 
891     /**
892      * The name of the resource for the DTD of the standard JDO metadata file.
893      *
894      * @since 2.1
895      */
896     static String JDO_DTD_RESOURCE
897         = "javax/jdo/jdo_2_2.dtd";
898 
899     /**
900      * The name of the resource for the XML schema of the standard JDO
901      * metadata file.
902      *
903      * @since 2.1
904      */
905     static String JDO_XSD_RESOURCE
906         = "javax/jdo/jdo_2_2.xsd";
907 
908     /**
909      * The name of the resource for the DTD of the standard JDO
910      * object-relational mapping metadata file.
911      *
912      * @since 2.1
913      */
914     static String ORM_DTD_RESOURCE
915         = "javax/jdo/orm_2_2.dtd";
916 
917     /**
918      * The name of the resource for the XML schema of the standard JDO
919      * object-relational mapping metadata file.
920      *
921      * @since 2.1
922      */
923     static String ORM_XSD_RESOURCE
924         = "javax/jdo/orm_2_2.xsd";
925 
926     /**
927      * The name of the resource for the DTD of the standard JDO query
928      * metadata file.
929      *
930      * @since 2.1
931      */
932     static String JDOQUERY_DTD_RESOURCE
933         = "javax/jdo/jdoquery_2_2.dtd";
934 
935     /**
936      * The name of the resource for the XML schema of the standard JDO query
937      * metadata file.
938      *
939      * @since 2.1
940      */
941     static String JDOQUERY_XSD_RESOURCE
942         = "javax/jdo/jdoquery_2_2.xsd";
943 
944     /**
945      * The name of the anonymous PersistenceManagerFactory, which
946      * is the empty string.
947      *
948      * @since 2.1
949      */
950     static String ANONYMOUS_PERSISTENCE_MANAGER_FACTORY_NAME
951         = "";
952 
953     /**
954      * Transaction isolation level representing the ability to read
955      * uncommitted data.
956      * @see PersistenceManagerFactory#getTransactionIsolationLevel()
957      * @see Transaction#getIsolationLevel()
958      * @since 2.2
959      */
960     public static final String TX_READ_UNCOMMITTED = "read-uncommitted"; 
961 
962     /**
963      * Transaction isolation level representing the requirement to read
964      * committed data only.
965      * @see PersistenceManagerFactory#getTransactionIsolationLevel()
966      * @see Transaction#getIsolationLevel()
967      * @since 2.2
968      */
969     public static final String TX_READ_COMMITTED = "read-committed"; 
970 
971     /**
972      * Transaction isolation level representing the requirement to read
973      * the same data in the same transaction.
974      * @see PersistenceManagerFactory#getTransactionIsolationLevel()
975      * @see Transaction#getIsolationLevel()
976      * @since 2.2
977      */
978     public static final String TX_REPEATABLE_READ = "repeatable-read"; 
979 
980     /**
981      * Transaction isolation level representing the requirement to keep
982      * a snapshot for reading data.
983      * @see PersistenceManagerFactory#getTransactionIsolationLevel()
984      * @see Transaction#getIsolationLevel()
985      * @since 2.2
986      */
987     public static final String TX_SNAPSHOT = "snapshot"; 
988 
989     /**
990      * Transaction isolation level representing the requirement to serialize
991      * transactions.
992      * @see PersistenceManagerFactory#getTransactionIsolationLevel()
993      * @see Transaction#getIsolationLevel()
994      * @since 2.2
995      */
996     public static final String TX_SERIALIZABLE = "serializable"; 
997 
998 }