SHOW Signed
 

net.rim.device.api.synchronization
Class SyncItem

java.lang.Object
  |
  +--net.rim.device.api.synchronization.SyncItem
All Implemented Interfaces:
Collection, SyncCollection, SyncConverter, SyncObject
Direct Known Subclasses:
OTASyncCapableSyncItem

public abstract class SyncItem
extends Object
implements SyncObject, SyncCollection, SyncConverter

Provides an implementation of SyncCollection to provide small objects with easy access to the Synchronization API. This class is used to provide backup/restore functionality to small bits of information, typically configuration options.

Implementers should extend this object and implement the abstract functions:

Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:
JDE 3.6.0
See Also:
SyncCollection, SyncManager.enableSynchronization(net.rim.device.api.synchronization.SyncCollection), SyncConverter, SyncObject

Constructor Summary
 Category: Signed protected SyncItem()
           
 
Method Summary
 Category: Signed  boolean addSyncObject(SyncObject object)
          Adds a SyncObject to this SyncCollection.
 Category: Signed  void beginTransaction()
          Starts a transaction.
 Category: Signed  void clearSyncObjectDirty(SyncObject object)
          Marks the specified SyncObject as not dirty.
 Category: Signed  SyncObject convert(DataBuffer data, int version, int uid)
          Extracts a SyncObject from the synchronization data.
 Category: Signed  boolean convert(SyncObject object, DataBuffer buffer, int version)
          Converts a SyncObject into synchronization data.
 Category: Signed  void endTransaction()
          Ends a transaction.
 Category: Signed  SyncConverter getSyncConverter()
          Returns the synchronization message converter (SyncConverter) for this SyncCollection.
 Category: Signed abstract  boolean getSyncData(DataBuffer buffer, int version)
          Gets the data of this object for use in synchronization.
 Category: Signed abstract  String getSyncName()
          Returns the name of this SyncCollection.
 Category: Signed abstract  String getSyncName(Locale locale)
          Returns the translated user-friendly name of this SyncCollection.
 Category: Signed  SyncObject getSyncObject(int uid)
          Return the SyncObject in this SyncCollection with the given UID.
 Category: Signed  int getSyncObjectCount()
          Returns a the number of SyncObjects in this SyncCollection.
 Category: Signed  SyncObject[] getSyncObjects()
          Returns an array of SyncObjects representing all SyncObjects in this SyncCollection.
 Category: Signed abstract  int getSyncVersion()
          Returns the current version number of this SyncCollection.
 Category: Signed  int getUID()
          Returns the unique ID stored in this SyncObject.
 Category: Signed  boolean isSyncObjectDirty(SyncObject object)
          Determines whether a specified SyncObject is dirty.
 Category: Signed  boolean removeAllSyncObjects()
          Called to remove all SyncObjects from the SyncCollection.
 Category: Signed  boolean removeSyncObject(SyncObject object)
          Removes a SyncObject from this SyncCollection.
 Category: Signed abstract  boolean setSyncData(DataBuffer buffer, int version)
          Sets the data of this object from the data recived through synchronization.
 Category: Signed  void setSyncObjectDirty(SyncObject object)
          Marks the specified SyncObject as dirty.
 Category: Signed  boolean updateSyncObject(SyncObject oldObject, SyncObject newObject)
          Updates a SyncObject in this SyncCollection.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

SyncItem

protected SyncItem()
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Method Detail

addSyncObject

public boolean addSyncObject(SyncObject object)
Description copied from interface: SyncCollection
Adds a SyncObject to this SyncCollection.

The SyncObject's dirty bit is set to clean by default.

Since:
JDE 3.6.0
See Also:
*
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

beginTransaction

public void beginTransaction()
Description copied from interface: SyncCollection
Starts a transaction.

Transactions are required to execute synchronizations that involve a large number of data records. The beginTransaction method is invoked by the SyncManager before adding, modifying or deleting a data record serially.

Since:
JDE 3.6.0
See Also:
*
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

clearSyncObjectDirty

public void clearSyncObjectDirty(SyncObject object)
Description copied from interface: SyncCollection
Marks the specified SyncObject as not dirty.

"Dirty" refers to whether or not the object has been modified on the handheld.

Since:
JDE 3.6.0
See Also:
*
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

convert

public SyncObject convert(DataBuffer data,
                          int version,
                          int uid)
Description copied from interface: SyncConverter
Extracts a SyncObject from the synchronization data.

Since:
JDE 3.6.0
See Also:
*
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

convert

public boolean convert(SyncObject object,
                       DataBuffer buffer,
                       int version)
Description copied from interface: SyncConverter
Converts a SyncObject into synchronization data.

Since:
JDE 3.6.0
See Also:
*
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

endTransaction

public void endTransaction()
Description copied from interface: SyncCollection
Ends a transaction.

Transactions are required to execute synchronizations that involve a large number of data records. The endTransaction method is invoked to signal the end of the transaction.

Since:
JDE 3.6.0
See Also:
*
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

getSyncConverter

public SyncConverter getSyncConverter()
Description copied from interface: SyncCollection
Returns the synchronization message converter (SyncConverter) for this SyncCollection.

A SyncConverter serializes SyncObjects and processes serialized data to create SyncObjects.

Since:
JDE 3.6.0
See Also:
*
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

getSyncData

public abstract boolean getSyncData(DataBuffer buffer,
                                    int version)
Gets the data of this object for use in synchronization.
Parameters:
buffer - The DataBuffer into which the data should be placed.
version - The version of the information to be provided.
Returns:
true if the operation was successful; false otherwise.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

getSyncName

public abstract String getSyncName()
Description copied from interface: SyncCollection
Returns the name of this SyncCollection. NOTE: The name that is returned must be unique across all SyncCollections and should never be localized.
Since:
JDE 3.6.0
See Also:
*
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

getSyncName

public abstract String getSyncName(Locale locale)
Description copied from interface: SyncCollection
Returns the translated user-friendly name of this SyncCollection.

If this returns null, then the result from getSyncName() will be shown instead.

Since:
JDE 3.6.0
See Also:
*
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

getSyncObject

public SyncObject getSyncObject(int uid)
Description copied from interface: SyncCollection
Return the SyncObject in this SyncCollection with the given UID.
Since:
JDE 3.6.0
See Also:
*
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

getSyncObjectCount

public int getSyncObjectCount()
Description copied from interface: SyncCollection
Returns a the number of SyncObjects in this SyncCollection.
Since:
JDE 3.6.0
See Also:
*
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

getSyncObjects

public SyncObject[] getSyncObjects()
Description copied from interface: SyncCollection
Returns an array of SyncObjects representing all SyncObjects in this SyncCollection.

The synchronization manager assumes that it is free to manipulate this array as it requires.

Since:
JDE 3.6.0
See Also:
*
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

getSyncVersion

public abstract int getSyncVersion()
Description copied from interface: SyncCollection
Returns the current version number of this SyncCollection.
Since:
JDE 3.6.0
See Also:
*
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

getUID

public int getUID()
Description copied from interface: SyncObject
Returns the unique ID stored in this SyncObject.

Since:
JDE 3.6.0
See Also:
*
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

isSyncObjectDirty

public boolean isSyncObjectDirty(SyncObject object)
Description copied from interface: SyncCollection
Determines whether a specified SyncObject is dirty.

"Dirty" refers to whether or not the object has been modified on the handheld.

Since:
JDE 3.6.0
See Also:
*
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

removeAllSyncObjects

public boolean removeAllSyncObjects()
Description copied from interface: SyncCollection
Called to remove all SyncObjects from the SyncCollection.
Since:
JDE 3.6.0
See Also:
*
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

removeSyncObject

public boolean removeSyncObject(SyncObject object)
Description copied from interface: SyncCollection
Removes a SyncObject from this SyncCollection.
Since:
JDE 3.6.0
See Also:
*
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

setSyncData

public abstract boolean setSyncData(DataBuffer buffer,
                                    int version)
Sets the data of this object from the data recived through synchronization.
Parameters:
buffer - The data received through synchronization.
version - The version number specified with the data.
Returns:
true if the operation was successful; false otherwise.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

setSyncObjectDirty

public void setSyncObjectDirty(SyncObject object)
Description copied from interface: SyncCollection
Marks the specified SyncObject as dirty.

"Dirty" refers to whether or not the object has been modified on the handheld.

Since:
JDE 3.6.0
See Also:
*
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

updateSyncObject

public boolean updateSyncObject(SyncObject oldObject,
                                SyncObject newObject)
Description copied from interface: SyncCollection
Updates a SyncObject in this SyncCollection.

The method accepts the old object to be replaced as well as the new object that will replace it in the collection. The SyncObject should subsequently be marked clean.

Since:
JDE 3.6.0
See Also:
*
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.



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