《SharpDevelop浅析_4_TextEditor_自动完成、代码折叠》由会员分享，可在线阅读，更多相关《SharpDevelop浅析_4_TextEditor_自动完成、代码折叠（7页珍藏版）》请在金锄头文库上搜索。
1、SharpDevelop浅析_4_TextEditor_自动完成、代码折叠Parser及其应用: Code Completion, Method Insight, Class Scout .1、Demo界面及功能解释2、Parser实现概述3、Parser应用: MouseHover Tooltip4、Parser应用: CodeCompletion & MethodInsight5、Parser应用: QuickClassBrowserPanel6、Parser应用: Folding7、总结Demo下载1、Demo界面及功能解释启动并打开任一 .cs 文件后，界面如下：自动完成界面如下：可见
2、新增功能如下(仅支持.cs文件)：a, 鼠标停留在方法、属性等位置时，会显示出相关的文档描述tooltipb, 输入时支持自动完成c, 编辑窗口顶部有类列表和成员(方法、变量等)列表下拉框用以快速浏览、定位d, 编辑窗口左侧有折叠线用以方法、类等的代码折叠相应的Demo工程中新增项目如下：a, SharpEditor: 包含扩展TextEditor的控件, Dom结构, ParserService， 自动完成功能代码等b, NRefactor : 代码解析功能c, CSharpBinding: 对应 .cs 文件的具体实现支持题外话:关于代码解析(Parser)相关的代码，我没看懂，所以在这里
3、只说个大概，更多地谈谈Parser的使用；抛砖引玉，希望有相关经验的网友提供详尽的分析。前两周工作上的项目实施，每天都搞得比较累，所以这篇文章到现在才写了出来，明天是大年三十了，这个系列的文章也只剩下一篇Windows Form Designer，只能等过了年再放上来喽。另外，这个系列写完后，暂不打算深究一些没明白的细节，接下来想看下os workflow 或 CommunityServer.2、Parser实现概述(1)首先，SharpEditor项目中的Dom下定义了以下重要类：a, IDecoration及其子类: 代码表现的辅助对象，如IClass, IMethod, IPropert
4、y等b, ResolveResult及其子类: 分析结果对象，如MethodResolveResult, TypeResolveResult等c, 其它重要类： IExpressionFinder, IParser, IResolve, ICompilationUnit 等(2)重要服务类：ParserService: 提供 GetExpressionFinder(), Resolve(), ParseFile()等重要方法，相关重要类: ProjectContentRegistry, DefaultProjectContent, ReflectionProjectContent等Ambien
5、ceService: 提供 IAmbience的实现类用以将分析结果转换为相应的字符描述(3)Parser分析步骤：以鼠标悬浮的Tooltip显示为例：DebuggerService根据文件类型返回对应的IExpressionFinder实现类，再根据鼠标位置找到并返回ExpressionResult对象，然后找到适当的IResolver实现类调用Resolve()方法返回结果ResolveResult对象，最后由相应的IAmbience实现类转换成结果字符，并调用e.ShowToolTip(toolTipText);显示。(4)对于.NET默认类库的分析转换：默认引进的命名空间的类结构和文档
6、说明一般可以在C:WINDOWSMicrosoft.NETFrameworkv2.0.50727目录下找到(如System.dll和System.xml)，但是如果每次都要重新分析dll代码结构和xml注释显然是比较花费时间的，于是SharpDevelop采用的方式是将分析过的数据(Dom下的类结构表示数据?，二进制的.dat文件)存储到C:Documents and SettingsmichaelLocal SettingsTempSharpDevelop下，代码结构存储到DomCacheDebug目录下，文档注释存储到DocumentationCacheDebug目录下。首先在Parser
7、Service的CreateDefaultProjectContent()中加载默认命名空间的引用：CreateDefaultProjectContent()其中ProjectContentRegistry的GetProjectContentForReference()方法如下：GetProjectContentForReference()可以看到DomPersistence类的作用即在加载或保存dll的代码结构数据, 如果尚未有分析过的数据，则在ReflectionProjectContnet类的构造函数中加以分析，同时调用XmlDoc类的相关方法加载、保存文档注释数据。(5)对于文件的转换
8、：略3、Parser应用: MouseHover Tooltip注意在SharpEditor项目中有个DebuggerService类，它提供了一个重要方法如下：BindTextAreaEvent()此方法即用以绑定需要鼠标悬浮提示的TextEditor控件，在SharpPad项目的Open菜单类方法中调用此类绑定编辑控件。注意上面的方法中可以看到ICSharpCode.TextEditor控件是通过其TextArea的ToolTipRequest事件公开给外部，用以分析并由外部提供ToolTip数据，而TextArea_ToolTipRequest(object sender, ToolTi
9、pRequestEventArgs e)方法中根据鼠标位置分析出要显示的数据后，最终调用e.ShowToolTip(toolTipText);用以设置提供数据。TextArea_ToolTipRequest()4、Parser应用: CodeCompletion & MethodInsightICSharpCode.TextEditor控件使用ICompletionData类以及ICompletionDataProvider接口(GenerateCompletionData()方法)定义数据自动完成列表的数据及其提供者: SharpEditor项目中的AbstractCodeCompletio
10、nDataProvider类中由GetExpression()及AddResolveResults()两个辅助方法生成数据，代码如下：AbstractCodeCompletionDataProvider 类CommentCompletionDataProvider类提供注释的自动完成，相关代码如下：CommentCompletionDataProvider 类类似地，ICSharpCode.TextEditor控件提供了IInsightDataProvider接口(GetInsightData()方法)，SharpEditor项目中实现类MethodInsightDataProvider和In
11、dexerInsightDataProvider提供相关数据。除了上面需要提供数据的类外，还要绑定TextEditor的TextArea的KeyEventHandler事件(详见SharpEditor项目的SharpDevelopTextAreaControl.cs)，其中辅助类的处理代码如下：KeyEventHandler 事件响应5、Parser应用: QuickClassBrowserPanelQuickClassBrowserPanel即编辑窗口顶部的类及成员快速浏览窗口，其实现如下：首先在SharpDevelopTextAreaControl类中重写override void OnF
12、ileNameChanged(EventArgs e)方法，即打开新文件时，调用ActivateQuickClassBrowserOnDemand()来根据是否有能够分析此文件的Parser来决定是否显示控件，如果可以显示，则实例化出一个新对象，并添加进来。实例化QuickClassBrowserPanel对象的相关代码如下：QuickClassBrowserPanel可以看到类、成员列表的ComboBox数据的填充是在textAreaControl.ActiveTextAreaControl.Caret.PositionChanged事件后执行，因为光标位置的改变可能需要同步更新顶部列表框的
13、显示；注意两个列表的列表项使用自定义类ComboBoxItem, 包括成员的Line, Column等信息；该类中绑定两个列表的SelectedIndexChange事件用以在编辑器中定位相应的类或成员位置：ComboBoxSelectedIndexChanged()6、Parser应用: FoldingICSharpCode.TextEditor控件提供了IFoldingStrategy接口用以定义代码折叠需实现的方法：IFoldingStrategy 接口SharpEditor项目中，SharpDevelopTextAreaControl在构造函数中指明了FoldingStrategy:S
14、harpDevelopTextAreaControl 构造函数同样需要在打开新文件时调用更新代码折叠标签，代码折叠FoldMarker生成的具体实现详见SharpEditor项目的ParserFoldingStrategy.cs7、总结上面简要介绍了Parser的部分实现, 期待有相关经验的网友指定我的理解错误或给予补充解释。以及Parser的部分应用：MouseHover Tooltip, CodeCompletion & MethodInsight, QuickClassBrowserPanel, Folding；SharpDevelop中的其它应用如类视图ClassBrowser, 对象浏览AssemblyPad(SharpDevelop2.0源码中未见到?).
