com.sap.ip.me.api.sync
Class SyncManager

java.lang.Object
  com.sap.ip.me.api.sync.SyncManager

Deprecated. Generic sync has been replaced by MBO synchronization. This class is only there for compatibility issues and will be removed in further releases of SAP NetWeaver Mobile Client

public class SyncManager
extends java.lang.Object

Handles synchronization tasks with backend including outbound and inbound processing

Author:

SAP

Field Summary

static java.lang.String	CONNECTION_TYPE_DISC Deprecated. Value for Configuration property SYNCSETTINGS_CONNECTION_TYPE. If Connection type is set to disc SyncManager exchanges the outbound and inbound queue via file system.
static java.lang.String	CONNECTION_TYPE_HTTP Deprecated. Value for Configuration property SYNCSETTINGS_CONNECTION_TYPE. If Connection type is set up to http SyncManager exchanges the outbound and inbound queue via http If Connection type is set up to http the SYNCSETTINGS_GATEWAY in the Configuration must be set up to a gateway url.
protected static java.lang.String	SYNC_PROTOCOL_VERSION Deprecated. The property tells the framework which internal transport protocol is used. Possible values: any integer value.

Constructor Summary

SyncManager()
Deprecated.

Method Summary

static SyncManager	getInstance() Deprecated. Gets the only one instance of the SyncManager class
static int	getSyncProtocolVersion() Deprecated. Get version number of used synchronization protocol.
boolean	isConnectionTerminatable() Deprecated. Checks whether the connection to the Mobile Infrastructure Middleware system can be terminated or not.
boolean	isFilterOnTimedSync() Deprecated. Gets the parameter for the Filter on Timed Sync.
boolean	isSAPLogonTicketSupportEnabled() Deprecated. Checks whether the framework is configured for SAP logon ticket support.
boolean	isSuppressDownload() Deprecated. Gets the parameter for the suppress download feature.
boolean	isSyncCredentialAvailable() Deprecated. Checks whether the required synchronization credentials (user ID/synchronization password or SAP logon ticket) are available.
boolean	isSyncRunning() Deprecated. Checks whether a synchronization process (except background synchronizations) is running or not.
void	setFilterOnTimedSync(boolean filtered) Deprecated. Set the 'Filter on Timed Sync' flag.
void	setSuppressDownload(boolean activateSuppressDownload) Deprecated. Sets the parameter for suppress download.
void	setSyncPasswordOfCurrentUser(java.lang.String password) Deprecated. Sets the synchronization password of the current user.
void	synchronizeWithBackend() Deprecated. Handles the complete synchronization for the current user.
void	synchronizeWithBackend(VisibilityType visibility) Deprecated. Handles the complete synchronization for current user or for all other users.
boolean	terminateConnection() Deprecated. Terminates the connection to the Mobile Infrastructure Middleware system.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

SYNC_PROTOCOL_VERSION

protected static java.lang.String SYNC_PROTOCOL_VERSION

Deprecated.

The property tells the framework which internal transport protocol is used.
Possible values: any integer value. If value is < 251300 the default old ASCII protocol is used. Old protocols (like 251300 the binary new protocol) are not supported any more.
Default value: 710000

Since:

MI 2.5 SP 13

CONNECTION_TYPE_HTTP

public static final java.lang.String CONNECTION_TYPE_HTTP

Deprecated.

Value for Configuration property SYNCSETTINGS_CONNECTION_TYPE.
If Connection type is set up to http SyncManager exchanges the outbound and inbound queue via http If Connection type is set up to http the SYNCSETTINGS_GATEWAY in the Configuration must be set up to a gateway url.

See Also:

Constant Field Values

CONNECTION_TYPE_DISC

public static final java.lang.String CONNECTION_TYPE_DISC

Deprecated.

Value for Configuration property SYNCSETTINGS_CONNECTION_TYPE.
If Connection type is set to disc SyncManager exchanges the outbound and inbound queue via file system. If Connection type is set to disc the SYNCSETTINGS_GATEWAY in the Configuration must be set up to a file directory.

See Also:

Constant Field Values

Constructor Detail

SyncManager

public SyncManager()

Deprecated.

Method Detail

getInstance

public static SyncManager getInstance()

Deprecated.

Gets the only one instance of the SyncManager class

Returns:

SyncManager singleton

synchronizeWithBackend

public void synchronizeWithBackend()

Deprecated.

Handles the complete synchronization for the current user.

synchronizeWithBackend

public void synchronizeWithBackend(VisibilityType visibility)

Deprecated.

Handles the complete synchronization for current user or for all other users.

Parameters:

visibility - Determines if the synchronization happens only for containers which are created for the current user and as shared containers or for all outbound containers on the device user independent

See Also:

VisibilityType

setFilterOnTimedSync

public final void setFilterOnTimedSync(boolean filtered)

Deprecated.

Set the 'Filter on Timed Sync' flag. I this filter is set, background synchronization via Timed Sync starts only if new application data is available. Framework data is ignored

Parameters:

boolean - filtered true = activate Filter on Timed Sync / false = deactivate Filter on Tmed Sync

isFilterOnTimedSync

public final boolean isFilterOnTimedSync()

Deprecated.

Gets the parameter for the Filter on Timed Sync. It indicates whether 'Filter on TZimed Sync is currently activated or deactivated.

Returns:

true if the 'Filter on Timed sync' feature is activated false if the 'Filter on Timed sync' feature is deactivated

setSuppressDownload

public final void setSuppressDownload(boolean activateSuppressDownload)

Deprecated.

Sets the parameter for suppress download. It is valid for a single sync cycle. After the sync process gets back to the client framework(either after complete synchronization or after an sync exceptiob occured) the parameter will automatically be reset to false.

Parameters:

boolean - paramvalue true = suppress download is activated / false= suppress download is deactivated Caution!! : Use this feature exclusively together with the call for synchronization. Otherwise you will interfere sync processes of other mobile applications on the device.

isSuppressDownload

public final boolean isSuppressDownload()

Deprecated.

Gets the parameter for the suppress download feature. It indicates whether the feature is currently activated or deactivated.

Returns:

true if the suppress download feature is activated false if the suppress download feature is deactivated

setSyncPasswordOfCurrentUser

public void setSyncPasswordOfCurrentUser(java.lang.String password)
                                  throws SyncPasswordException

Deprecated.

Sets the synchronization password of the current user. If the setting of the synchronization password cannot be performed, an SyncPasswordException with an appropriate message ID (containing the resaon) will be thrown.

Parameters:

password - The synchronization password

Throws:

SyncPasswordException - Contains the reason why the setting of the synchronization password failed if it fails.

See Also:

SyncPasswordException

isSyncCredentialAvailable

public boolean isSyncCredentialAvailable()

Deprecated.

Checks whether the required synchronization credentials (user ID/synchronization password or SAP logon ticket) are available. If the synchronization credentails are not (completely) availabe, the next synchronization try will fail. This method should always be invoked to decide whether a synchronization can be performed with respect to (completely) available synchronization credentials.

Returns:

True if the synchronization credentials are available, false otherwise.

isSyncRunning

public boolean isSyncRunning()

Deprecated.

Checks whether a synchronization process (except background synchronizations) is running or not.

Returns:

true if an UI triggered synchronization is running, false if no synchronization is running or if background synchronization is running.

isSAPLogonTicketSupportEnabled

public boolean isSAPLogonTicketSupportEnabled()

Deprecated.

Checks whether the framework is configured for SAP logon ticket support.

Returns:

true if the framework is enabled for SAP logon ticket support, false otherwise.

getSyncProtocolVersion

public static int getSyncProtocolVersion()

Deprecated.

Get version number of used synchronization protocol.

Returns:

version number of used synchronization protocol

Since:

MI 2.5 SP 13

terminateConnection

public boolean terminateConnection()

Deprecated.

Terminates the connection to the Mobile Infrastructure Middleware system. It overrides the WaitForResultsTimeout value set in the Mobile Engine configuration settings. This API can be invoked only if
isConnectionTerminatable() returns a true value

Returns:

true if connection was terminated successfully false otherwise.

Since:

MI 2.5 SP 17

See Also:

isConnectionTerminatable

isConnectionTerminatable

public boolean isConnectionTerminatable()

Deprecated.

Checks whether the connection to the Mobile Infrastructure Middleware system can be terminated or not.

Returns:

true if connection can be terminated false otherwise.

Since:

MI 2.5 SP 17

See Also:

terminateConnection