Index_P

P

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