org.eclipse.ptp.rdt.sync.core

Class SyncConfig

java.lang.Object

org.eclipse.ptp.rdt.sync.core.SyncConfig

All Implemented Interfaces:

java.lang.Comparable<SyncConfig>

public class SyncConfig
extends java.lang.Object
implements java.lang.Comparable<SyncConfig>

Class to encapsulate information about syncing a project

Since:

3.0

Constructor Summary

Constructors

Constructor and Description
SyncConfig(java.lang.String name) Create a new sync configuration.

Method Summary

Methods

Modifier and Type	Method and Description
int	compareTo(SyncConfig config)
boolean	equals(java.lang.Object obj)
java.lang.String	getConnectionName()
java.lang.String[]	getKeys() Get the keys for all properties set for this configuration.
java.lang.String	getLocation() Get the raw remote location unresolved
java.lang.String	getLocation(org.eclipse.core.resources.IProject project) Get location (directory), resolved in terms of the passed project TODO: Legacy code.
java.lang.String	getName() Get the configuration name
org.eclipse.core.resources.IProject	getProject() Get the synchronized project
java.lang.String	getProperty(java.lang.String key) Get an arbitrary property for the configuration
IRemoteConnection	getRemoteConnection() Get remote connection.
RemoteLocation	getRemoteLocation() Get remote location
java.lang.String	getRemoteServicesId() Get the remote services ID
java.lang.String	getSyncProviderId() Get sync provider ID
int	hashCode()
boolean	isSyncOnPostBuild() Check if syncs should occur on post-build
boolean	isSyncOnPreBuild() Check if syncs should occur on pre-build
boolean	isSyncOnSave() Check if syncs should occur on saves
void	setConfigName(java.lang.String configName) Set the configuration name
void	setConnection(IRemoteConnection connection) Set the remote connection
void	setConnectionName(java.lang.String connectionName) Set the connection name
void	setLocation(java.lang.String location) Set the sync location
void	setProject(org.eclipse.core.resources.IProject project) Set the synchronized project
void	setProperty(java.lang.String key, java.lang.String value) Set an arbitrary property for the configuration
void	setRemoteServicesId(java.lang.String remoteServicesId) Set the remote services ID
void	setSyncOnPostBuild(boolean syncOnPostBuild) Set the sync on post-build flag
void	setSyncOnPreBuild(boolean syncOnPreBuild) Set the sync on pre-build flag
void	setSyncOnSave(boolean syncOnSave) Set the sync on save flag
void	setSyncProviderId(java.lang.String syncProviderId) Set the sync provider ID

Methods inherited from class java.lang.Object

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

Constructor Detail

SyncConfig

public SyncConfig(java.lang.String name)

Create a new sync configuration. Should not be called by clients directly. Use SyncConfigManager.newConfig(String, String, IRemoteConnection, String) instead.

Parameters:

name - Name of this configuration. Must be unique per project.

Method Detail

compareTo

public int compareTo(SyncConfig config)

Specified by:

compareTo in interface java.lang.Comparable<SyncConfig>

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

getConnectionName

public java.lang.String getConnectionName()

Returns:

connection name

getKeys

public java.lang.String[] getKeys()

Get the keys for all properties set for this configuration.

Returns:

configuration properties keys

getLocation

public java.lang.String getLocation()

Get the raw remote location unresolved

Returns:

remote directory

getLocation

public java.lang.String getLocation(org.eclipse.core.resources.IProject project)

Get location (directory), resolved in terms of the passed project TODO: Legacy code. It doesn't make sense to pass in a project different from the one stored. For now, add an assertion to see if this ever occurs.

Parameters:

project -

Returns:

remote directory

getName

public java.lang.String getName()

Get the configuration name

Returns:

config name

getProject

public org.eclipse.core.resources.IProject getProject()

Get the synchronized project

Returns:

getProperty

public java.lang.String getProperty(java.lang.String key)

Get an arbitrary property for the configuration

Parameters:

key -

Returns:

value

getRemoteConnection

public IRemoteConnection getRemoteConnection()
                                      throws MissingConnectionException

Get remote connection. If connection is missing, this function calls the missing-connection handler. Thus, after catching the exception, callers can assume user has already been notified and given an opportunity to define the connection. So callers only need to worry about recovering gracefully.

Returns:

remote connection - never null

Throws:

MissingConnectionException - if no connection with the stored name exist. This can happen for various reasons: 1) The connection was renamed 2) The connection was deleted 3) The connection never existed, such as when a project is imported to a different workspace

Since:

4.0

getRemoteLocation

public RemoteLocation getRemoteLocation()

Get remote location

Returns:

remote location

Since:

4.0

getRemoteServicesId

public java.lang.String getRemoteServicesId()

Get the remote services ID

Returns:

remote services ID

getSyncProviderId

public java.lang.String getSyncProviderId()

Get sync provider ID

Returns:

sync provider ID

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

isSyncOnPostBuild

public boolean isSyncOnPostBuild()

Check if syncs should occur on post-build

Returns:

isSyncOnPreBuild

public boolean isSyncOnPreBuild()

Check if syncs should occur on pre-build

Returns:

isSyncOnSave

public boolean isSyncOnSave()

Check if syncs should occur on saves

Returns:

setConfigName

public void setConfigName(java.lang.String configName)

Set the configuration name

Parameters:

configName -

setConnection

public void setConnection(IRemoteConnection connection)

Set the remote connection

Parameters:

connection -

Since:

4.0

setConnectionName

public void setConnectionName(java.lang.String connectionName)

Set the connection name

Parameters:

connectionName -

setLocation

public void setLocation(java.lang.String location)

Set the sync location

Parameters:

location -

setProject

public void setProject(org.eclipse.core.resources.IProject project)

Set the synchronized project

Parameters:

project -

setProperty

public void setProperty(java.lang.String key,
               java.lang.String value)

Set an arbitrary property for the configuration

Parameters:

key -

value -

setRemoteServicesId

public void setRemoteServicesId(java.lang.String remoteServicesId)

Set the remote services ID

Parameters:

remoteServicesId -

setSyncOnPostBuild

public void setSyncOnPostBuild(boolean syncOnPostBuild)

Set the sync on post-build flag

Parameters:

syncOnPostBuild -

setSyncOnPreBuild

public void setSyncOnPreBuild(boolean syncOnPreBuild)

Set the sync on pre-build flag

Parameters:

syncOnPreBuild -

setSyncOnSave

public void setSyncOnSave(boolean syncOnSave)

Set the sync on save flag

Parameters:

syncOnSave -

setSyncProviderId

public void setSyncProviderId(java.lang.String syncProviderId)

Set the sync provider ID

Parameters:

syncProvider -