Re: [mylar-dev] Connector Tutorial

[Eugene Kuleshov <eu@xxxxxxxx>]

John Vliet wrote:
> I have been looking into creating mylar connectors for our project 
> wiki (on jotspot.com <http://jotspot.com>) and for PVCS Tracker. While 
> doing so I have found the documentation quite sparse. I looked through 
> http://wiki.eclipse.org/index.php/Mylar_Integrator_Reference#Tasks_framework 
> and have modeled my connector after the Trac connector as suggested by 
> this page.
 Hmm, there are several sections in that document on that suppose to 
give more or less step by step instructions. You are very welcome to 
extend and clarify this information.

 For example, web connector only implementing first 3 sections from 
this list:

http://wiki.eclipse.org/index.php/Mylar_Integrator_Reference#Creating_connector_projects
http://wiki.eclipse.org/index.php/Mylar_Integrator_Reference#Implementing_core_extension_points
http://wiki.eclipse.org/index.php/Mylar_Integrator_Reference#Implementing_UI_extension_points
http://wiki.eclipse.org/index.php/Mylar_Integrator_Reference#Query_support
http://wiki.eclipse.org/index.php/Mylar_Integrator_Reference#Task_editor
http://wiki.eclipse.org/index.php/Mylar_Integrator_Reference#Offline_data_handling
http://wiki.eclipse.org/index.php/Mylar_Integrator_Reference#Deployment_tips

> I have found that you can't really incrementally implement your 
> connector. Once you start adding a new task, the calls Mylar makes to 
> your connector plugin require a pretty complete understanding of 
> repository implementation. 
 Not quite true. You do have to have all the methods, but most of them 
can be just stubs (i.e. return null or false).
> With the scant documentation you have to reverse engineer the 
> functionality with the debugger. It seems that it should be possible 
> to have an abstract or basic implementation and model that functions 
> with minimal work, then you evolve the rest of the features.
>
> I have started to document my experience 
> (http://jvliet.blogspot.com/2007/02/creating-mylar-connector-plugin-for.html) 
> but this is incomplete and I suspect wrong in a few places. 
 Nice.
> I want to contribute either documentation on how to create a mylar 
> connector, a template project that makes it easy to start slowly or a 
> combination. How should I go about doing this? Is there better 
> documentation to start with for connectors? Is this the right mailing 
> list to watch (it seems a little light on traffic)?
 You can contribute to the above sections on Mylar's wiki. I think it 
would make sense to break your document along those sections and add 
pieces into above sections as a practical illustration.

 regards,
 Eugene