Class AbstractSynchronizeParticipant
- All Implemented Interfaces:
IAdaptable
,IExecutableExtension
,ISynchronizeParticipant
- Direct Known Subclasses:
ModelSynchronizeParticipant
,SubscriberParticipant
ISynchronizeParticipant
.
This class provides lifecycle support and hooks for configuration of synchronize view pages.
- Since:
- 3.0
- See Also:
-
Field Summary
Modifier and TypeFieldDescriptionprotected IConfigurationElement
static final String
Property key used in the property change event fired when the pinned state of a participant changes.static final String
Property key used in the property change event fired when the participants refresh schedule changes.Fields inherited from interface org.eclipse.team.ui.synchronize.ISynchronizeParticipant
P_CONTENT
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionvoid
Adds a listener for changes to properties of this synchronize participant.Creates the configuration for the participant page.boolean
Return whether this participant can be refreshed.boolean
void
firePropertyChange
(Object source, String property, Object oldValue, Object newValue) Notify all listeners that the given property has changed.Returns the help context id of this participant or value ofIHelpContextIds.SYNC_VIEW
when no specific id has been provided.getId()
Returns the unique id that identified the type of this synchronize participant.Returns an image descriptor for this synchronize participant, ornull
if none.getName()
Returns the name of this synchronize participant.Return the list of preference pages that are associated with this participantReturns the instance id that identified the unique instance of this participant.int
hashCode()
void
Classes that are persisted must override this method and perform the following initialization.protected abstract void
initializeConfiguration
(ISynchronizePageConfiguration configuration) This method is invoked after a page configuration is created but before it is returned by thecreatePageConfiguration
method.final boolean
isPinned()
Returns if this participant is pinned.protected boolean
Return whether this participant supports the contribution of actions to the context menu by contributing aviewerContribution
to theorg.eclipse.ui.popupMenus
extension point.protected void
pinned
(boolean pinned) Called when the pinned state is changed.void
prepareCompareInput
(ISynchronizeModelElement element, CompareConfiguration config, IProgressMonitor monitor) Default implementation will update the labels in the given configuration using information from the provided element if it adapts toSyncInfo
.void
Removes the given property listener from this synchronize participant.void
Saves the participants object state within the memento.protected void
setImageDescriptor
(ImageDescriptor imageDescriptor) Sets the image descriptor for this participant to the specified value and notifies property listeners of the change.void
setInitializationData
(IConfigurationElement config, String propertyName, Object data) This method is called by the implementation of the methodIConfigurationElement.createExecutableExtension
on a newly constructed extension, passing it its relevant configuration information.protected void
protected void
Sets the name of this participant to the specified value and notifies property listeners of the change.final void
setPinned
(boolean pinned) Sets whether this participant is pinned.protected void
setSecondaryId
(String secondaryId) Sets the secondary id for this participant.Methods inherited from class org.eclipse.core.runtime.PlatformObject
getAdapter
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface org.eclipse.core.runtime.IAdaptable
getAdapter
Methods inherited from interface org.eclipse.team.ui.synchronize.ISynchronizeParticipant
createPage, dispose, run
-
Field Details
-
P_PINNED
Property key used in the property change event fired when the pinned state of a participant changes.- See Also:
-
P_SCHEDULED
Property key used in the property change event fired when the participants refresh schedule changes.- Since:
- 3.2
- See Also:
-
configElement
-
-
Constructor Details
-
AbstractSynchronizeParticipant
public AbstractSynchronizeParticipant()Default constructor is a no-op. Subclasses that are persistable must support a no-arg constructor and
-
-
Method Details
-
getName
Description copied from interface:ISynchronizeParticipant
Returns the name of this synchronize participant. This name is displayed to the user.- Specified by:
getName
in interfaceISynchronizeParticipant
- Returns:
- the name of this synchronize participant
-
getImageDescriptor
Description copied from interface:ISynchronizeParticipant
Returns an image descriptor for this synchronize participant, ornull
if none.- Specified by:
getImageDescriptor
in interfaceISynchronizeParticipant
- Returns:
- an image descriptor for this synchronize participant, or
null
if none
-
getId
Description copied from interface:ISynchronizeParticipant
Returns the unique id that identified the type of this synchronize participant. The synchronize manager supports registering several instances of the same participant type.- Specified by:
getId
in interfaceISynchronizeParticipant
- Returns:
- the unique id that identified the type of this synchronize participant.
-
getSecondaryId
Description copied from interface:ISynchronizeParticipant
Returns the instance id that identified the unique instance of this participant. The synchronize manager supports registering several instances of the same participant type and this id is used to differentiate between them.- Specified by:
getSecondaryId
in interfaceISynchronizeParticipant
- Returns:
- the instance id that identified the unique instance of this
participant or
null
if this participant doesn't support multiple instances.
-
getHelpContextId
Returns the help context id of this participant or value ofIHelpContextIds.SYNC_VIEW
when no specific id has been provided.- Specified by:
getHelpContextId
in interfaceISynchronizeParticipant
- Returns:
- the help context id of this participant
- Since:
- 3.5
- See Also:
-
ISynchronizeParticipant.getHelpContextId()
IHelpContextIds.SYNC_VIEW
- Restriction:
- This method is not intended to be re-implemented or extended by clients.
-
setPinned
public final void setPinned(boolean pinned) Description copied from interface:ISynchronizeParticipant
Sets whether this participant is pinned.- Specified by:
setPinned
in interfaceISynchronizeParticipant
- Parameters:
pinned
- sets if the participant is pinned.
-
isPinned
public final boolean isPinned()Description copied from interface:ISynchronizeParticipant
Returns if this participant is pinned. Pinned participants will only be removed from the synchronize manager until they are un-pinned.- Specified by:
isPinned
in interfaceISynchronizeParticipant
- Returns:
true
if this participant is pinned andfalse
otherwise.
-
pinned
protected void pinned(boolean pinned) Called when the pinned state is changed. Allows subclasses to react to pin state changes.- Parameters:
pinned
- whether the participant is pinned.
-
equals
-
hashCode
public int hashCode() -
doesSupportSynchronize
public boolean doesSupportSynchronize()Return whether this participant can be refreshed. Participants that can be refreshed may have a Synchronize menu item contributed to their context menu and can also be refreshed from the Synchronize drop-down toolbar item. When refreshed from the toolbar item, theISynchronizeParticipant.run(org.eclipse.ui.IWorkbenchPart)
method is called.- Returns:
- whether this participant can be refreshed
-
addPropertyChangeListener
Description copied from interface:ISynchronizeParticipant
Adds a listener for changes to properties of this synchronize participant. Has no effect if an identical listener is already registered.The changes supported by the synchronize view are as follows:
IBasicPropertyConstants.P_TEXT
- indicates the name of a synchronize participant has changedIBasicPropertyConstants.P_IMAGE
- indicates the image of a synchronize participant has changed
Clients may define additional properties as required.
- Specified by:
addPropertyChangeListener
in interfaceISynchronizeParticipant
- Parameters:
listener
- a property change listener
-
removePropertyChangeListener
Description copied from interface:ISynchronizeParticipant
Removes the given property listener from this synchronize participant. Has no effect if an identical listener is not already registered.- Specified by:
removePropertyChangeListener
in interfaceISynchronizeParticipant
- Parameters:
listener
- a property listener
-
firePropertyChange
Notify all listeners that the given property has changed.- Parameters:
source
- the object on which a property has changedproperty
- identifier of the property that has changedoldValue
- the old value of the property, ornull
newValue
- the new value of the property, ornull
-
setInitializationData
public void setInitializationData(IConfigurationElement config, String propertyName, Object data) throws CoreException Description copied from interface:IExecutableExtension
This method is called by the implementation of the methodIConfigurationElement.createExecutableExtension
on a newly constructed extension, passing it its relevant configuration information. Most executable extensions only make use of the first two call arguments.Regular executable extensions specify their Java implementation class name as an attribute of the configuration element for the extension. For example
<action run="com.example.BaseAction"/>
In the above example, this method would be called with a reference to the
<action>
element (first argument), and"run"
as the name of the attribute that defined this executable extension (second argument).The last parameter is for the specific use of extension adapters and is typically not used by regular executable extensions.
There are two supported ways of associating additional adapter-specific data with the configuration in a way that is transparent to the extension point implementor:
(1) by specifying adapter data as part of the implementation class attribute value. The Java class name can be followed by a ":" separator, followed by any adapter data in string form. For example, if the extension point specifies an attribute
"run"
to contain the name of the extension implementation, an adapter can be configured as<action run="com.example.ExternalAdapter:./cmds/util.exe -opt 3"/>
(2) by converting the attribute used to specify the executable extension to a child element of the original configuration element, and specifying the adapter data in the form of xml markup. Using this form, the example above would become
<action> <run class="com.xyz.ExternalAdapter"> <parameter name="exec" value="./cmds/util.exe"/> <parameter name="opt" value="3"/> </run> </action>
Form (2) will typically only be used for extension points that anticipate the majority of extensions configured into it will in fact be in the form of adapters.
In either case, the specified adapter class is instantiated using its 0-argument public constructor. The adapter data is passed as the last argument of this method. The data argument is defined as Object. It can have the following values:
null
, if no adapter data was supplied- in case (1), the initialization data string is passed as a
String
- in case (2), the initialization data is passed as a
Hashtable
containing the actual parameter names and values (bothString
s)
- Specified by:
setInitializationData
in interfaceIExecutableExtension
- Parameters:
config
- the configuration element used to trigger this execution. It can be queried by the executable extension for specific configuration propertiespropertyName
- the name of an attribute of the configuration element used on thecreateExecutableExtension(String)
call. This argument can be used in the cases where a single configuration element is used to define multiple executable extensions.data
- adapter data in the form of aString
, aHashtable
, ornull
.- Throws:
CoreException
- if error(s) detected during initialization processing- See Also:
-
setInitializationData
protected void setInitializationData(ISynchronizeParticipantDescriptor descriptor) throws CoreException - Throws:
CoreException
-
setName
Sets the name of this participant to the specified value and notifies property listeners of the change.- Parameters:
name
- the new name
-
setImageDescriptor
Sets the image descriptor for this participant to the specified value and notifies property listeners of the change.- Parameters:
imageDescriptor
- the new image descriptor
-
setSecondaryId
Sets the secondary id for this participant.- Parameters:
secondaryId
- the secondary id for this participant.
-
init
Classes that are persisted must override this method and perform the following initialization.super.init(secondaryId, memento); try { ISynchronizeParticipantDescriptor descriptor = TeamUI.getSynchronizeManager().getParticipantDescriptor(PARTICIPANT_ID); setInitializationData(descriptor); } catch (CoreException e) { TeamUIPlugin.log(e); }
wherePARTICIPANT_ID
is the id of the participant as defined in the plugin manifest.- Specified by:
init
in interfaceISynchronizeParticipant
- Parameters:
secondaryId
- the secondayId of this participant instance ornull
if this participant doesn't support multiple instances.memento
- the participant state ornull
if there is no previous saved state- Throws:
PartInitException
- if this participant was not initialized successfully- See Also:
-
saveState
Description copied from interface:ISynchronizeParticipant
Saves the participants object state within the memento. This state will be available when the participant is restored viainit
.This method can be called multiple times during the lifetime of the participant object.
- Specified by:
saveState
in interfaceISynchronizeParticipant
- Parameters:
memento
- a memento to receive the object state
-
createPageConfiguration
Description copied from interface:ISynchronizeParticipant
Creates the configuration for the participant page. The configuration controls the options for displaying the participant. The configuration used to initialize the page whenISynchronizeParticipant.createPage(ISynchronizePageConfiguration)
is called and as such can be used to pre-configure visual properties of the displayed page.- Specified by:
createPageConfiguration
in interfaceISynchronizeParticipant
- Returns:
- the configuration for the participant page.
-
initializeConfiguration
This method is invoked after a page configuration is created but before it is returned by thecreatePageConfiguration
method. Subclasses can implement this method to tailor the configuration in ways appropriate to the participant.- Parameters:
configuration
- the newly create page configuration
-
prepareCompareInput
public void prepareCompareInput(ISynchronizeModelElement element, CompareConfiguration config, IProgressMonitor monitor) throws TeamException Default implementation will update the labels in the given configuration using information from the provided element if it adapts toSyncInfo
. It will also cache the contents for the remote and base if the element is sync info based.- Specified by:
prepareCompareInput
in interfaceISynchronizeParticipant
- Parameters:
element
- the sync model element whose contents are about to be displayed to the user in a compare editor or compare dialogconfig
- the compare configuration that will be used to configure the compare editor or dialogmonitor
- a progress monitor that can be used if contacting a server to prepare the element and configuration- Throws:
TeamException
- if an error occurred that should prevent the display of the compare editor containing the element- Since:
- 3.1
- See Also:
-
getPreferencePages
Description copied from interface:ISynchronizeParticipant
Return the list of preference pages that are associated with this participant- Specified by:
getPreferencePages
in interfaceISynchronizeParticipant
- Returns:
- the list of preference pages that are associated with this participant
-
isViewerContributionsSupported
protected boolean isViewerContributionsSupported()Return whether this participant supports the contribution of actions to the context menu by contributing aviewerContribution
to theorg.eclipse.ui.popupMenus
extension point. By default,false
is returned. If a subclasses overrides to returntrue
, theid
of the participant is used as thetargetId
. Here is an extension that could be added to the plugin manifest to contribute an action to the context menu for a participant<extension point="org.eclipse.ui.popupMenus"> <viewerContribution id="org.eclipse.team.cvs.ui.viewContributionId" targetID="org.eclipse.team.cvs.ui.cvsworkspace-participant"> <action label="Add" menubarPath="additions" tooltip="Add a file to CVS version control" class="org.eclipse.team.internal.ccvs.ui.actions.AddAction" helpContextId="org.eclipse.team.cvs.ui.workspace_subscriber_add" id="org.eclipse.team.ccvs.ui.CVSWorkspaceSubscriber.add"> </action> </viewerContribution> </extension>
- Returns:
- whether this participant supports the contribution of actions to
the context menu using the
org.eclipse.ui.popupMenus
extension point - Since:
- 3.1
-