`

EMF开发指南之Item Provider

阅读更多
★adapter是emf.edit ui和command的基础
★item provider可以这样理解,为不同的可编辑的model items提供相应的功能,从ItemProviderAdapter继承将实现我们所要的大部分item provider功能,而ReflectiveItemProvider 则通过反射实现了我们所需要的功能
★每一个emf model对象可以称之为Notifier,因为在model发生改变的时候,将会给相应的监听器发送通知。而通知观察者(也就是监听器)则被称之为adapter,因为这些observer除了有监听消息之外,还可以用来扩展各种被监听对象的行为。
★说到adapter的扩展功能,就不得不提到adapter factory,adapter的每一个功能的扩展都是通过接口来实现,要实现一个功能就实现一个接口),然后使用adpaterfactory的adapt方法取得对应的接口实现,该方法有两个参数,第一个是model对象,另外一个是接口类型,最终得到的就是我们要使用的扩展功能接口对象,这里我们统一称之为adapter,在调用adapter factory的时候,如果model对象已经和某个adapter建立关联,那么直接返回这个adapter对象,否则adapter factory将创建这个adapter,并建立与model 对象之间的关联
★Adapter除了可以和单个的model object关联之外,还可以和具有层次结构关系中的每一个model object关联,这个是EContentAdapter来实现的,所以我们的adapter只要从该类继承便会具有该功能
★item provider是作为model adapter而存在的,但并不总是这样,因为有些item provider除了和model关联之外,还可以和非model关联。
★emf framework使用了一种代理机制来使用item provider,当要使用model的相应功能的时候,framework最终会将这些功能代理到item provider上去。
★item provider跟content(label) provier之间的关系,item provider 是model的adapter,content(label)provider是eclipse application中的控制层,这是两个不同概念,但是view在调用control层的各种方法时候,控制层会根据提供的adapter factory找到对应的item provider,然后执行item provider的相关方法来达到最终的目的。item provider是和ui独立的,除了可以应用于JFace之外,还可以应用于Swing以及非UI的地方。同样的道理,item provider还会采用类似的方式应用于property sheet的编辑只是这时使用的是IPropertySource接口而已,还有一个不同之处就是item provider实现的IItemPropertySource接口返回都是IItemPropertyDescripter类型的对象,而IPropertySource需要的是PropertyDescripter对象,因此这里有一个wrap和转换的过程,即ItemPropertyDescripter->PropertyDescripter,这样转换来转换去的似乎比较烦琐,但是其好处可以实现ui独立。
★对于调用model相关的command来说,其做法跟content(label)provider和property source没有什么区别,也是使用adapter factory找到item provider,由于item provider实现了与command factory相关的接口:IEditingDomainItemProvider,这样调用editing domain adapter factory相关的方法又变成了调用item provider相关的方法了。
★emf通知传递过程:在model被改变的时候,比如修改属性值,作为通知的接收者,在emf中即adapter(item provider也是一种adapter)将触发其notifyChanged方法,根据对这些通知做一个过滤,将属于自己的通知传递给model的通知处理中心(即ItemProviderAdapterFactory),然后由该Factory来调用注册在其内部的各种监听器,通知其他部分做相应的修改,这里有一点需要注意的是,factory内部的各种监听器,实际上是各种content provider,而不是对应的viewer,然后通过content provider对viewer进行更新。
★item provider有两种类型:一种是一个item provider对应一个model,也就是one to one;一种是一个item provider对应一类model,也就是所谓的单例模式。如果是后者的话,那么在访问item provider的方法的时候,需要制定一个参数来指定当前操作的是哪个model对象,比如getChildren(Object object)
★model object的创建流程:model object的创建是跟action相关的,action除了提供一些行为操作之外,还会提供一些与ui相关的text和icon,action的最终操作将被代理到相关的command上
★生成的emf.edit代码分为两部分:一部分是独立于ui的,放在edit plugin工程里面,另一部分是和ui相关的,放在editor plugin工程里面,独立于ui又分为item provider和item provider adapter factory以及plugin相关的部分,而和ui相关的则分为editor, action bar contributor, wizard以及plugin相关的部分
★item provider是emf.edit中最重要的部分,它决定了每一种model如何显示以及如何响应相关的command
★对应每一个model的ItemProvider继承ItemProviderAdapter,这里使用的是template method pattern,父类实现重点方法接口,子类提供具体细节实现,一个ItemProvider要实现4个功能,一个是content 和label provider;一个是property source(descriptor);一个是充当command factory;最后一个就是将对model所做的修改反应到相应的viewer上去.
★由于item provider是如此重要,因此我们有必有对它所要实现的接口一一做个介绍。首先是ITreeItemContentProvider接口,这个接口需要实现的一个方法就是getChildrenReferences,即返回model对象的引用集合。这里我们可以根据需要来定制我们所需要使用的引用
★为了更好的在model进行遍历,通过ItemProviderAdapter父类来提供getParent(),getChildren(), getElements(),hasChildren()等方法。我们可以根据自己的需要来进行定制。比如将与当前选中的对象相关的对象在viewer中进行显示,对getParent()和getChildren()方法进行复写来实现自己的解析处理。
★item provider还要实现IItemLabelProvider 接口,不用说,就是用来为viewer提供显示的text和image的,这里会用到ResourceLocator 这种东西来调用当前classpath下的资源(比如图片,属性文件等),这里的定制操作是显而易见的,就是可以使用我们自己的图片,以及决定使用model的哪个属性来作为label进行显示。
★虽然emf提供的默认editor中使用了table viewer,但是在item provider中并没有实现ITableItemLabelProvider接口,这个是因为在需要使用ITableItemLabelProvider的时候,会使用一个代理,去调用IItemLabelProvider的getImage()和getText()方法。 
★为了在property sheet中对model进行编辑,则需要在实现IPropertySource接口,这里所谓的property就是指的是那些非containment attribute
★ItemPropertyDescriptior的内容包括这个property的label;用于现在status中的description;当前property的一些属性,该属性是否可编辑(通过设置模型的attribute是changeable来设置),该属性要使用的icon。IItemPropertySource 接口还有另外两个方法,一个是根据property id得到对应的property discriptor的getPropertyDescriptor()方法,另一个是对编辑的value进行转换getEditableValue(),这两个方法都是在ItemProvidorAdapter中实现。
★为了进行定制,我们可以对getPropertyDescriptors()方法进行复写,来提供更多的property信息,也可以对在addPropertyDescriptor中调用不同的ItemPropertyDescriptor构造函数来对label,description,icon进行定制。还可以使用ItemPropertyDescriptorDecorator 来为property提供不同的edit widget
★通过实现IEditingDomainItemProvider接口让item provider成为command factory
分享到:
评论

相关推荐

Global site tag (gtag.js) - Google Analytics