SHOW Signed

net.rim.device.api.system
Class ObjectGroup

java.lang.Object
  |
  +--net.rim.device.api.system.ObjectGroup

public final class ObjectGroup
extends Object

NEW NEW NEW Object groups An object group is a collection of objects which all reside in the same filesystem record. A reference to any member of a group (from outside the group) will keep the entire group from being garbage collected.

Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

Since:
JDE 4.0.0

Method Summary
 Category: Signed static void createGroup(Object obj)
          Groups an object and everything it references to (recursively) into one orphan filesystem record.
 Category: Signed static void createGroupIgnoreTooBig(Object obj)
          Groups an object and everything it references to (recursively) into one orphan filesystem record.
 Category: Signed static Object expandGroup(Object obj)
           
 Category: Signed static boolean isInGroup(Object obj)
           
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

createGroup

public static void createGroup(Object obj)
Groups an object and everything it references to (recursively) into one orphan filesystem record. References between objects in a group are rewritten as relative references which do not consume an object handle. Any attempt to modify an object in a group will result in ObjectGroupReadOnlyException being thrown.
Parameters:
obj - the object to group
Throws:
ObjectGroupTooBigException - if there are too many object to fit in 64k
Since:
JDE 4.0.2
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

createGroupIgnoreTooBig

public static void createGroupIgnoreTooBig(Object obj)
Groups an object and everything it references to (recursively) into one orphan filesystem record. References between objects in a group are rewritten as relative references which do not consume an object handle. Any attempt to modify an object in a group will result in ObjectGroupReadOnlyException being thrown. This version will record (in the event log) if a grouping failed.
Parameters:
obj - the object to group
Since:
JDE 4.0.2
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

expandGroup

public static Object expandGroup(Object obj)
Since:
JDE 4.0.2
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

isInGroup

public static boolean isInGroup(Object obj)
Since:
JDE 4.0.2
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.


Copyright 1999-2004 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.