Mylyn/Porting Guide

This document will have Mylar 2.0 specific API changes added to it as we make them. If interested in keeping up with these changes we suggest setting a watch for this page.

Porting from Mylar 1.0 to 2.0

Tasks Framework

• AbstractRepositoryConnectorUi
  • openRemoteTask(String repositoryUrl, String id): removed, this method no longer needs to be implemented by the connector. Instead classes can rely on the new openRepositoryTask(..) method, and override it if necessary.
• ITaskListElement: now extends java.lang.Comparable, so Collections support of sorting can be used, since task list elements have a natural ordering. Default implementations are provided for tasks and containers. (bug 171590)
• TasksUiUtil
  • openUrl(String url): moved to openBrowser(String url)

• Task
  • getTooltipText(): deleted, not used

• MylarStatus (place holder, will improve as we solidify this)
  • MylarStatusHandler.displayStatus(dialog title, IStatus status) - call to display error and information dialogs
  • When returning CoreException pass in a MylarStatus with appropriate code (see IMylarStatusConstants).
  • If IMylarStatusConstants.INTERNAL_ERROR is sent to MylarStatusHandler.displayStatus an error dialog will appear and the error will be logged.
  • IMylarStatusConstants.REPOSITORY_COLLISION used for mid-air collision. Pass repository url and appropriate dialog will be displayed.

• ITaskDataHandler
  • getChangedSinceLastSync() method moved to AbstractRepositoryConnector
  • New comment now held in an attribute: RepositoryTaskAttribute.COMMENT_NEW will need to update handler and factory to produce connector specific attribute

• RepositorySynchronizationManager
  • updateOfflineState is now saveIncoming and saveOutgoing.
  • discardOutgoing discards any pending outgoing changes

• TaskEditor
  • protected void pageChange(intNewPageIndex) method removed (only called super)

• AbstractRepositoryTaskEditor
  • attributeChanged() Anything that needs to be saved must be in attribute form and passed to this method. Most if this is all done for you but if you override AbstractRepositoryTaskEditor.createCustomAttributeLayout() then you will want to ensure that attributeChanged is called upon editing. Utility method createTextField() handles this call.
  • createLabel() Utility method added. It will put an '*' at the front of the label if the attribute has been modified. Eventually this will be applied upon editing but currently only happens after re-freshing or re-opening the editor.

• TaskList
  • getChangeListeners(): returns a Set instead of List

Context Framework

• AbstractContextStore
  • notifyContextStoreMoved(): change to contextStoreMoved()

Monitor Framework

• org.eclipse.mylar.monitor: split into monitor.core and monitor.ui, organize imports and update extension point IDs