由windy444译Q{载请注明
原文名：Building a Common Navigator Framework (CNF) Viewer Part I: Defining the View Part Q作者：MICHAEL ELDERQ出处：http://scribbledideas.blogspot.com/Q本Z未能打开q，呵呵Q?/p>
先上Copyright
The opinions and ideas expressed herin are my own and do not represent the
intent, opinion, or official statement of any company or organization.
All
postings by me to this site are copyrighted (C) by Michael D. Elder, 2006 and
made available under the terms of the Eclipse Public License 1.0 with the
constraint that any reuse of the content must contain this copyright
statement.
关于扩展点和API的特定文档，可以在Eclipse的^台帮助（(Help > Help ContentQ中扑ֈQPlatform Plug-in Developer's Guide >Reference > API Reference | Extension Points ReferenceQ涉及的扩展Ҏorg.eclipse.ui.navigator.viewerQorg.eclipse.ui.navigator.navigatorContent。相关的API包ؓorg.eclipse.ui.navigator。若你想知道q篇文章中提到的东西的更多细节，q些东西可以作ؓ参考?/p>
好了Q哪里开始呢Q首先，我们对包含该视囄插g作一些配|，把org.eclipse.ui.navigatordC赖（dependenciesQ中。然后，我们用org.eclipse.ui.views扩展Ҏ定义一个view partQƈ把org.eclipse.ui.navigator.CommonNavigatorcM为view part的实现类。这个类ؓ我们的视图提供一些基功能。然后，我们定义org.eclipse.ui.navigator.viewer扩展点，把视N|成通用D器（Common NavigatorQ。最后，能够通过定义org.eclipse.ui.navigator.navigatorContent扩展点以及绑?org.eclipse.ui.navigator.viewer/viewerContentBinding)来关联扩展点和视图?/p>
你不仅可以通过org.eclipse.ui.navigator.CommonNavigatorQ把该架构用于导航器Q你可以通过org.eclipse.ui.navigator.INavigatorContentService把该架构用于从对话框到编辑器的Q何地方，或者定义你自己的视囑֒view part。但在这里，我们只x于基本功能?/p>
基本讄
通用D器架构是Eclipse 3.2的一个新Ҏ，因此Q你臛_需要安装Eclipse 3.2。（译者注Q下面一些是开发过插g的h都知道的事情Q此处略q）
定义View Part
当要定义一个具有通用D器功能的视图Q你必须定义一个实际的view partQ这个是你视囄容器?/p>
Q译者注Q略MD|关紧要的Q插件开发初学者可以去参考基本view的开发，定义完成后的plugin文g如下Q）
定义视图配置
一旦定义好了view partQ我们将通过org.eclipse.ui.navigator.viewerҎ们的视图作一些配|扩展，q些扩展告诉架构一些基的东西，例如Q通用D器的view part是哪个，弹出菜单的结构是怎样的，是否要定义object contributionsQ以及一些会影响视图~省行ؓ的属性?/p>
Q译者注Q略q定义plugin.xml文gq程Q后面会附上该文Ӟ
对于弹出菜单的一些评?/strong>。通用D器架构提供两U方式让视图来定制菜单。第一U方式是通过指定org.eclipse.ui.navigator.viewer扩展点下viewer的popupMenuIdQ来接受~省的分隔符Q以及菜单的group
mark id。缺省D记录在org.eclipse.ui.navigator.viewer扩展点下Qؓ了方便，被列在了下面?/p>
"group.new" separator="true" 另一U方式，你可以选择不去指定popupMenuIdQ作为替换，你可以指?lt;popupmenu />作ؓ<viewer
/>元素的子元素。在q里Q你可以定义自己的分隔符以及group mark idQ能够由后面的用h增加菜单Q。如果你期望l定q_(Resource,
Javatm)提供内容扩展的内容（contentQ或者操作（ActionQ，推荐您用缺省分l（上面列出的）?/p>
对于选项QoptionQ的一些评?/strong>?lt;viewer />元素下的< options
/>元素能够允许指定Z字符串的name=value寏V这里有一些选项被基架构所使用Q在org.eclipse.ui.navigator.viewer扩展Ҏ档的例子部分有记录）Q但你自q视图或扩展点也可以用这U机制来提供额外的扩展。请参考org.eclipse.ui.navigator.INavigatorViewerDescriptor中读?lt;viewer
/>元素中属性的API。你能通过通用D器视囄org.eclipse.ui.navigator.INavigatorContentService得到视图描述W?/p>
定义viewerId后的plugin文gQ?/p>
定义好视囑Q我们需要添加内Ҏ展，q绑定到视图上。我在下一文章中l出一些更具体的信息。作为示例，我们单的把缺省的资源内容Q由org.eclipse.ui.navigator.resources插g定义Q绑定到视图上?/p>
Q译者注Q略q一些基本操作，定义完后的plugin文g如下Q） 你现在可以启动工作台了（Run... > New Eclipse
ApplicationQ，q时能看到我们的视图。但我们q未l视囄定操作，所以，你仍然要通过在资源导航器或包览器中创徏工程Q才能在我们的视图中出现工程。后面，我们会增加资源操作和qo器，但现在，让我们看看该视图拥有的缺省行为。目前有折叠所有按钮（Collapse
AllQ，Link with Editor按钮Q过滤器QFiltersQ按钮（以及一?Available
Filters"标签Q，和一个扩展标{（"Available Content"Q?/p>
要绑定资源过滤器Q我们需要在</includes>元素下增加另一个contentExtension元素Q指?org.eclipse.ui.navigator.resources.filters.*"为标识符。这会选取org.eclipse.ui.navigator.resources定义的所有的qo器。当Ӟ你可以参考org.eclipse.ui.navigator.resources的plugin文gQ选取你自己想要的qo器的标示W?/p>
再一ơ选择Run...Q确认在qo器对话框中出C一些资源过滤器?/p>
接下来，我们绑定默认的资源操作。要l定操作Q需要在我们扩展点的根下面，增加一个viewerActionBinding元素。（译者注Q略q一些操作，定义完后的plugin文g如下Q） 现在Q启动工作台后，在默认的I图中Q在视图中右键空的地方）Q你看到New, Import, Export, ?
Refresh操作。当你选中视图中的一个元素时Q出现的菜单cM与资源导航器中的?/p>
Q译者注Q再ơ略q一D|作，不媄响对文章的理解） 定义qo?/font> 今天我们做的最后一件事Q是用Eclipse核心表达式（Core
ExpressionsQؓ我们的视囑֮义一个过滤器。核心表辑ּ架构的文档在org.eclipse.core.expressions插g中。我们将用org.eclipse.core.resources定义的属性测试者（property
testersQ来试特定的工E性质QNatureQ，然后隐藏所有没有该性质的工E?/p>
Q译者注Q略q一些操作，定义完后的plugin文g如下Q） 你也可以在扩展点中设|activeByDefault属性，来决定该qo器是否在~省配置中被ȀzR?/p>
最后，我们需要ؓ我们的视囑֮义contentExtensionQ来作ؓviewerContentBinding的一部分。确保用了我们新徏的过滤器的idQ或者一个通用的样式（如："org.eclipse.ui.examples.navigator.filters.*"Q来l定所有我们未来定义的匚w样式的过滤器。最后的plug.xml如下Q?/p>
现在Q最后一ơ启动工作台。创Z个新的简单工E和Java工程Q当“Hide non-Java
Projects”被激zLQ简单工E会被隐藏?/p>
Q译者注Q第一部分l于译完了Q?/p>
"group.goto"
"group.open"
separator="true"
"group.openWith"
"group.edit"
separator="true"
"group.show"
separator="true"
"group.reorganize"
"group.port"
"group.generate"
separator="true"
"group.search" separator="true"
"group.build"
separator="true"
"additions" separator="true"
"group.properties"
separator="true"
跣南下年游；
道不逢缘何聚首，
片片清幽点点眸?br />
那年夏天,I气中透着晚秋的寒?
我只w来到成都实现自q梦想,
奈何天意弄h,得到了本不想要的.
|了|了,只ؓ了些许宁静和目光.
]]>
Extension Object同Visitor、Decorator{模式差不多Q都是在不改变类层次机构的前提下向系l添加功能，被称为扩展对象模式?/p>
在了解扩展对象模式之前需要了解一下相关的一条OOD原则Q就是单一职责原则QSingle Responsibility PrincipleQSRPQ?/p>
׃个类而言Q应该仅有一个引起他变化的原因?/p>
大致的意思就是要把职责分配到不同的对象当中去。如果我们把每一个职责的变化看成是变化的一个uU，当需求变化时Q该变化会反映ؓcȝ职责的变化? 如果一个类承担了多余一个的职责Q那么引起他变化的原因就多余一个uU，也就是把q些职责耦合C一赗在某种E度上，q种耦合会导致Fragile DesignQ当变化发生Ӟ设计会遭受到意向不到的破坏?/p>
在具体讨Z前，先来看一个设计问题?br />
我们要开始设计一个RSS ReaderQ一般用一|来呈现对于Feed的管理和l织l构Q类gBloglines、GreatNews那样的。构|的过E中Q我们可以用Composite模式来设计相应的cdơ结构，例如Q基本接口我们可以采?
public interface IChannelNode {
public String getTitle();
public String getId();
... ...
}然后构徏Composite的子c（用来容纳目录{组l结构）和具体类Q例?/p>
public class CompositeChannelNode implements IChannelNode {
public void addChild(IChannelNode node);
... ...
}
public class FeedChannelNode implements IChannelNode {
... ...
}上述q些cȝ构完全可以用来描q这|的层ơ结构了Q而且我们可以使用Eclipse中的TreeViewer来显C。Eclipse中的 TreeViewer是基于Structured Model的，所以，几乎使用很少的代码，可以完成显C个树的功能，q也是Eclipse对于q种ZStructured Model装的比较好的结果。不q简单的使用UI会比较单调，所以，需要对于UI部分q行润色Q那么在q个cdơ中不可避免的要加入UI部分的代码， q就不符合SRP的要求了。另外，假如我们q要完成对于q棵树的persistentQ那么序列化的代码又会污染这个单U的模型了。这里我们就可以使用? 展对象模式了Q把q些变化另外wraph?/p>
对Extension的抽象封?/h3>
q个是Uncle Bob提过的一U优雅的实现机制Q是Z对于Extension的抽象封装，然后在本w模型（上面的Channell织模型Q注册这? ExtensionQ在q行时可以方便的得到合适的扩展来执行相应功能。例如我们来定义一个Extension的注册和使用机制Q然后在 IChannelNode中将hdelegatel这套机Ӟ当然也可以把q个直接集成到IChannelNode的代码中Q下面用Part? PartExtension来完成这部分功能Q代码不是完整的Q?/p>
public abstract class Part {
public void addExtension(String extensionType, PartExtension extension) { ... ... }
public PartExtension getExtension(String extensionType) { ... ... }
}
public interface PartExtension {
}可以单的使用一个HashMap来完成extension的注册和获取。其实这部分的代码就把扩展这部分不变的内容封装v来，而对于可能存在的? 化完全可以利用增加新的类来完成，也就满了开攑ְ闭原则（OCPQ。比如我们说到的persistent部分Q徏立相应的persistent扩展可 以了?/p>
public class PersistentPart extends Part {
public PersistentPart() {
addExtension("CSVFormat", new CSVPersistentPartExtension());
// 注册其他format的存储方?br />
}
}
public interface PersistentExtension extends PartExtension {
public void doPersistent(IChannelNode node);
}
public class CSVPersistentPartExtension implements PersistentExtension {
public void doPersistent(IChannelNode node) {
// save node.getTitle();
// save node.getId();
......
}
}变化的部分就是用什么方式来存储信息了，比如我们不用CVS来存储而改用XML存储Q那么只需要生成相应的XMLPersistentPartExtensionQƈ把他注册到PersistentPart可以了?br /> 看了q个Q当时我觉得搞得真是很麻烦，很复杂，而且可读性很差啊Q呵c不q本wExtension Object的实现就是特别复杂的Q慢慢实践，我想会越来越掌握q种Ҏ的?/p>
我投入精力更大的是下面要说的一U同Adapterl合h的扩展方法，q用这U方法实CUI部分的分，感觉实方便很多Q不q开始理解v来也是比较头疹{?/p>
使用Adapter模式来扩?/h3>
q里要说的是Eclipseq_底层最为核心的IAdaptableQErich Gamma一手打造，我先后看了好久才体会到这U设计的力。这ơ扩展我们拿UI来说事。Eclipse中显CZ个Tree很容易，有了 Structured Model之后Q打造好相应的TreeContentProvider和LabelContentProvider基本完成了。但是对于一个效果复杂的 昄在Provider中的代码׃昄很臃肿，主要也是在LabelContentProvider中，而原有模型的逻辑也会增加很多ZUI部分的代 码，比如Channel不同状态下要显CZ么样的图片，使用什么样的字体，什么样的前景背景色{等。所以，比较好的办法是分离Z套ƈ行的cdơ， IChannelNodeUIQ而且如果在扩展过E中我们能够把IChannelNode适配到IChannelNodeUIQƈ交给 LabelContentProvider好办了Q所有的UI代码搞到IChannelNodeUIq套东西里面M?br /> 现在介绍的扩展方式就是依据Adapter为基的，所以，现在先把Adapterq部分搞?/p>
public interface IChannelNodeUI {
public Image getImage();
public Font getFont();
... ...
}
public class ChannelNodeUIAdapter implements IChannelNodeUI {
private IChannelNode node_;
public ChannelNodeUIAdapter(IChannelNode node) { ... ... }
public Image getImage() {
if (node_.isLoading())
// return loading image;
... ...
}
......
}接下来也是对这些扩展的理Q比如我们还有对于IPersistent的适配Q那么如何更好的来管理这些扩展呢。比较容易想到的q是注册然后获取q样的方法，可是q些适配器和适配关系如何理呢？
看一下，Erich大牛的IAdaptable
org.eclipse.core.runtime/IAdaptable
public interface IAdaptable {
public Object getAdapter(Class adapter);
}如果IChannelNode从IAdaptablel承q来Q那么我们就可以在LabelContentProvider中这样写刎ͼ都没有进行check啊）Q?/p>
public Image getImage(Object element) {
IChannelNode node = (IChannelNode)element;
IChannelNodeUI uiNode = (IChannelNodeUI)node.getAdapter(IChannelNodeUI.class);
return uiNode.getImage();
}
那么需要我们对于IChannelNode中的getAdapter来实玎ͼ比如我们在ChannelNode中：
public Object getAdapter(Class adapter) {
if(adapter == IChannelNodeUI.class)
return new ChannelNodeUIAdapter(this);
return null;
}q样的问题就是不好维护，所以，Erich大牛q提供了对应的IAdapterFactory和IAdapterManagerQ当然AdapterManager是Platform中提供的对于框架部分的封装，不需要我们干什么了?br /> 我们也就需要生成一个AdapterFactoryQ然后把他注册给Platform的AdapterManager可以了Q?/p>
IAdapterManager manager = Platform.getAdapterManager();
IAdapterFactory uiFactory = new ChannelNodeUIFactory();
manager.registerAdapters(uiFactory, IChannelNode.class);那么如何使用呢，Eclipse的Platform里提供了一个PlatformObject的类Q承他直接具有了Adaptable的能力， q自动把getAdapter的请求{交给Platform了，~陷是会媄响你的承体p，毕竟Java无法多元l承Q所以，如果你不是承自 PlatformObject的话Q自p{交一下，
Platform.getAdapterManager().getAdapter(this, IChannelNodeUI.class);q种扩展对象模式是Zq样的Adapter模式Q由IAdaptable、IAdapterFactory和IAdapterManager完成了对框架的封装，从而给Eclipse带来了巨大的灉|性?/p>
参考数目：《敏捯Y件开发》、《Contributing to Eclipse?/p>