package tag (JDO metadata), 169
Page view
generating, 343–344
generating for a redundant request, 345
Performance, 355
benefits of JDO to the application, 103
benefits of persistence manager's cache, 137–139
benefits of secondary cache, 140
enhancement and, 164
of optimistic transactions, 140
and Web app design goals, 336
Persistence, transparent, 235–236, 238
Persistence-aware classes, 161
Persistence by reachability, 4, 82
Persistence-capable classes, 7
defined, 16
two types of, 12
Persistence-capable variables (query), 56
Persistence manager, 3, 75–101, 103. See also PersistenceManager interface
behavior of operations ending in All (xxxAll), 79
closing, 77–78, 201–202, 207–208, 216, 334, 336
controlling, 139
getting for a managed object, 231
getting the Transaction object of, 98–99
obtaining from a connection factory, 187–188
obtaining from a PersistenceManagerFactory, 186–187
one Transaction object per, 108, 200
shared, 356
shared read-only, 356–357
Persistence manager factory, 3, 185–225. See also PersistenceManagerFactory interface
acquiring with JDOHelper, 228
closing, 194
code to find in JNDI, 193
configuring, 198
connection-related properties, 198–199
constructing, 194
frozen, 192
getting from JNDI, 193
interrogating, 278–279
obtaining, 188–194
obtaining from JDOHelper, 190–192
obtaining a persistence manager from, 186–187
stored in and retrieved from JNDI, 185, 193
Persistence manager's cache. See Cache
Persistence service thread-safety, 100
Persistence services of JDO, 3–7, 100
Persistence state, flushing, 215
PersistenceCapable class, 16, 148
PersistenceCapable interface, 2–3, 75, 148–150, 153, 161, 234
PersistenceCapable object, 148
PersistenceManager interface, 3, 75–101, 185
close method, 77
deletePersistent method, 7, 79, 82–83, 119, 238, 246
deletePersistentAll method, 247
evict methods, 90, 92–94, 118, 237
getObjectById method, 24, 242
getObjectId method, 36
getPersistenceManagerFactory method, 78
IgnoreCache property, 38, 99, 192
isClosed method, 78
makeNontransactional method, 83–86
makePersistent method, 79–82, 119, 134, 245
makeTransactional method, 83–84, 106, 134
makeTransient method, 86–88
Multithreaded property, 100, 241
newObjectIdInstance method, 242
newQuery methods, 48–49
object and collection method parameters, 76
properties, 99
refresh methods, 90, 94–95
retrieve methods, 90–92
UserObject property, 100, 239
PersistenceManager interface class diagram, 76, 390
PersistenceManager object, 84, 111
PersistenceManager property (Query interface), 48
PersistenceManager property (read-only), 39
PersistenceManager property (Transaction interface), 110–111
PersistenceManagerFactory interface, 3, 185–186
class diagram of, 186, 392
close method, 194
getPersistenceManager, 185, 187
newQuery method, 71
NontransactionalRead property, 223
supportedOptions method, 18, 86, 195–196
PersistenceManagerFactory object, as serializable, 224
PersistenceManagerFactory properties file, example of, 192–193
PersistenceManagerFactory property, 78
PersistenceManagerFactory property vendor dependencies, 190
PersistenceManagerFactoryClass, 189–190
Persistent application data object, unmanaged, 339–340
Persistent-clean object
refreshing, 95
retrieving, 92
Persistent-clean state, 18, 126
Persistent-deleted object, 83, 95
Persistent-deleted state, 19
Persistent-dirty object
refreshing, 95, 127
retrieving, 92
Persistent-dirty state, 18
Persistent field values, cached, 89
Persistent fields, 9, 137
clearing, 115
in default fetch group, 235–236
dirty, 110
of Foo and Bar classes, 50
of Library app classes, 65–66
marking as dirty, 230–231
optionally supported types of, 146–147
of Song and Label classes, 62
types of, 145–147
Persistent-new-deleted object, 82–83
Persistent-new-deleted state, 19
Persistent-new object, 81
Persistent-new state, 19
Persistent-nontransactional object
refreshing, 95, 127–129
retrieving, 92
Persistent-nontransactional state, 18–19, 21, 128
Persistent object model
application, 144
JDO's focus on, 72
Persistent objects, 352
caching, 137–140
cloning, 160
creating, 4
defined, 17
deleting, 7, 79, 82–83
garbage collection of, 33
hollow state and, 248
making, 79–82
making them JDO-transient, 86–88
removing from the cache, 138
retrieving, 5–6
serializing, 154
updating, 6–7
Persistent state
of application data classes, 143
of application data objects, 22
evicting, 92–94
explained, 21
lifetime of, 139
linking a transient object to, 35–36
refreshing, 94–95
retrieving, 90–92
transient state dependent on, 240–241
Pessimistic transactions, 108
Phantom read, explained, 107
Polymorphic equality, 28
Pool of objects, 338
Portability, rules for, 31
Porting an application, 26
Ports, reconfiguring for JBoss and Tomcat together, 361–362
Primary key, 29
Primary key class, 218
Primary key fields, 25, 35–36
printStackTrace method, 252
Private access level, leading hyphen for, 311
Private modifier, declaring managed fields with, 161