Revision as of 16:28, 8 February 2007

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

General

• All library dependencies have moved
• MylarStatusHandler and IStatusHandler
  • moved from org.eclipse.mylar.context.core to org.eclipse.mylar.core

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.
  • createSection now takes a SECTION_NAME enum. SECTION_NAME is an enum that hold default labels for the section titles. The enum passed to new method getSectionLabel which will return the default pretty print name for that section. alternateSectionLabels can be set which will override the default labels.

• WebClientUtil
  • moved from ..mylar.tasks.core to ..mylar.core.net

• 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
• HandleObfuscator
  • moved to InteractionEventObfuscator

• org.eclipse.mylar.monitor.usage.core and org.eclipse.mylar.monitor.usage.ui
  • moved to ..mylar.monitor.core, ..mylar.monitor.usage and ..mylar.monitor.usage.internal