|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
java.lang.Object | +--net.rim.device.api.system.ObjectGroup
Object groups An object group is a collection of objects which all reside in the same filesystem record. Use the ObjectGroup class to consolidate persistent object handles for an object into one group and reduce the number of persistent object handles being used by the system. The number of available persistent object handles is determined by a handheld device's flash memory and an application's data structures. Consolidating persistent object handles reduces the number of used object handles. Consider a record that contains 10 string fields. This record consumes 11 persistent object handles. Using the ObjectGroup class to group the record, just one object handle is used for the record instead of 11. The persistent object handles for the String fields are consolidated under the record object handle. A grouped object is read-only. Attempting to modify a grouped object without ungrouping it throws an ObjectGroupReadOnlyException. See 'Memory Best Practices for the BlackBerry Java Development Environment' for more information.
| Method Summary | ||
|
static void |
createGroup(Object obj)
Groups an object and everything it references to (recursively) into one orphan filesystem record. |
|
static void |
createGroupIgnoreTooBig(Object obj)
Groups an object and everything it references to (recursively) into one orphan filesystem record. |
|
static Object |
expandGroup(Object obj)
Return a new object which is a read-write clone of an object group |
|
static boolean |
isInGroup(Object obj)
|
| Methods inherited from class java.lang.Object |
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Method Detail |
public static void createGroup(Object obj)
obj - the object to groupObjectGroupTooBigException - if there are too many objects to fit in 64kpublic static void createGroupIgnoreTooBig(Object obj)
obj - the object to grouppublic static Object expandGroup(Object obj)
obj - the object to ungroupIllegalArgumentException - if obj is not the root of the ObjectGroup.public static boolean isInGroup(Object obj)
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
Copyright 1999-2008 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.