熱門精品專業(yè)最后一步就是實(shí)現(xiàn)各種功能
語(yǔ)法高亮
首先我們要實(shí)現(xiàn)的是語(yǔ)法高亮.如下圖所示:
從本質(zhì)上來(lái)說(shuō),語(yǔ)法高亮就是給分割后的Token指定相應(yīng)的顯示屬性,在語(yǔ)法高亮的處理機(jī)制里面也需要用到Token, Scanner和Rule這些東西.通過(guò)復(fù)寫SourceViewerConfiguration的getPresentationReconciler()方法來(lái)給指定的內(nèi)容類型添加語(yǔ)法高亮的特性:
- public IPresentationReconciler getPresentationReconciler(ISourceViewer sourceViewer)
- {
- PresentationReconciler reconciler = new PresentationReconciler();
- DefaultDamagerRepairer dr = new DefaultDamagerRepairer(getXMLTagScanner());
- reconciler.setDamager(dr, XMLPartitionScanner.XML_TAG);
- reconciler.setRepairer(dr, XMLPartitionScanner.XML_TAG);
- dr = new DefaultDamagerRepairer(getXMLScanner());
- reconciler.setDamager(dr, IDocument.DEFAULT_CONTENT_TYPE);
- reconciler.setRepairer(dr, IDocument.DEFAULT_CONTENT_TYPE);
- ...
- return reconciler;
- }
在上面的代碼中有一個(gè)IPresentationReconciler實(shí)例,他是用來(lái)監(jiān)聽(tīng)底層的IDocument實(shí)例的變動(dòng),一個(gè)內(nèi)容類型會(huì)跟一個(gè)IPresentationDamager和IPresentationRepairer實(shí)例相關(guān)聯(lián),當(dāng)編輯文檔時(shí),將會(huì)給受影響的文檔區(qū)域?qū)?yīng)內(nèi)容類型的IPresentationDamager實(shí)例發(fā)送消息,接著IPresentationDamager會(huì)返回一個(gè)IRegion實(shí)例,并將這些信息傳遞給IPresentationRepairer實(shí)例,該實(shí)例會(huì)對(duì)發(fā)生改變的區(qū)域重新設(shè)置顯示屬性.
上述過(guò)程聽(tīng)起來(lái)可能比較復(fù)雜,不過(guò)萬(wàn)幸的是我們并不需要自己去實(shí)現(xiàn)這些東西, JFace提供了一個(gè)DefaultDamagerRepairer來(lái)處理IPresentationDamager和IPresentationRepairer要做的事情,同時(shí)還提供了一個(gè)PresentationReconciler類用來(lái)將二者關(guān)聯(lián)起來(lái),而我們要做的就是告訴編輯器在使用給定的內(nèi)容類型對(duì)文檔進(jìn)行分割之后的結(jié)構(gòu)是怎樣的,以及每一種文檔類型的顯示屬性
DefaultDamagerRepairer的構(gòu)造器需要一個(gè)ITokenScanner 參數(shù),該接口跟分割Token Scanner非常類似,兩種Scanner得到的Token都是IToken的一種實(shí)現(xiàn),不同之處在于Token粒度不同,分割Token Scanner得到的Token是一個(gè)具有某種內(nèi)容類型的文檔區(qū)域,而使用語(yǔ)法高亮Scanner得到的Token是一段具有相同文本格式的字符串序列,顯然后者的粒度更細(xì)
這里我們拿XMLTagScanner來(lái)說(shuō),該Scanner主要針對(duì)XML_TAG內(nèi)容類型, 因此它得到的Token表示的是位于XML標(biāo)識(shí)符之間的文本內(nèi)容
- public class XMLTagScanner extends RuleBasedScanner
- {
- public XMLTagScanner(ColorManager manager)
- {
- Color color = manager.getColor(IXMLColorConstants.STRING);
- TextAttribute textAttribute = new TextAttribute(color);
- IToken string = new Token(textAttribute);
- IRule[] rules = new IRule[3];
- // Add rule for double quotes
- rules[0] = new SingleLineRule("\"", "\"", string, '\\');
- // Add a rule for single quotes
- rules[1] = new SingleLineRule("'", "'", string, '\\');
- // Add generic whitespace rule.
- rules[2] = new WhitespaceRule(new XMLWhitespaceDetector());
- setRules(rules);
- }
- }
XMLTagScanner繼承了RuleBasedScanner,因此和我們?cè)赗uleBasedPartitionScanner中看到的一樣,它也是使用某種規(guī)則處理機(jī)制來(lái)識(shí)別Token的
這里我們定義了三個(gè)規(guī)則:一個(gè)用于匹配雙引號(hào)中的字符,一個(gè)用于匹配單引號(hào)中的字符,還有一個(gè)則用來(lái)匹配空格
為了給XML的標(biāo)簽名顯示為藍(lán)色,我們使用以下的代碼,即給Token設(shè)置一個(gè)默認(rèn)的顏色值:
- protected XMLTagScanner getXMLTagScanner()
- {
- if (tagScanner == null)
- {
- tagScanner = new XMLTagScanner(colorManager);
- Color color = colorManager.getColor(IXMLColorConstants.TAG);
- TextAttribute textAttribute = new TextAttribute(color);
- Token token = new Token(textAttribute);
- tagScanner.setDefaultReturnToken(token);
- }
- return tagScanner;
- }
內(nèi)容格式化
格式化就是通過(guò)使用縮進(jìn)和空格使文檔結(jié)構(gòu)化,從而更具有可讀性, 格式化處理包括兩個(gè)步驟:
第一步,為即將格式化的內(nèi)容定義格式化策略,這些策略可以是全局性的,也可以是針對(duì)某個(gè)分割區(qū)域的.通過(guò)IFormattingStrategy接口來(lái)實(shí)現(xiàn).
第二步,通過(guò)SourceViewerConfiguration實(shí)現(xiàn)類給ISourceViewer添加這些策略
格式化也會(huì)使用到分割處理,這讓我們?cè)僖淮误w會(huì)到了掌握以及正確使用文檔分割的重要性.下面我們就以最簡(jiǎn)單的TextFormattingStrategy來(lái)進(jìn)行說(shuō)明,該格式化策略用于處理嵌套在XML元素中的文本內(nèi)容
- public class TextFormattingStrategy extends DefaultFormattingStrategy
- {
- private static final String lineSeparator = System.getProperty("line.separator");
- public String format(String content,
- boolean isLineStart,
- String indentation,
- int[] positions)
- {
- if (indentation.length() == 0)
- return content;
- return lineSeparator + content.trim() + lineSeparator + indentation;
- }
- }
這里我們通過(guò)繼承DefaultFormattingStrategy并復(fù)寫format方法來(lái)實(shí)現(xiàn), 其具體做法是對(duì)文本內(nèi)容進(jìn)行trim處理,然后在文本前后加上換行符
上面的介紹可能太簡(jiǎn)單,在我們的實(shí)現(xiàn)類XMLFormattingStrategy中包含了更復(fù)雜的格式化處理代碼,這里我們對(duì)其細(xì)節(jié)不再一一展開(kāi),有興趣的讀者可以自己去加以體會(huì),可以說(shuō)格式化處理是一項(xiàng)非常有挑戰(zhàn)性的活兒,因?yàn)樗�涉及到對(duì)選擇的文本進(jìn)行智能識(shí)別的處理,這個(gè)需要反復(fù)的實(shí)驗(yàn)才能得到理想的結(jié)果
通過(guò)重載SourceViewerConfiguration.getContentFormatter()方法可以非常容易的將格式化操作添加到編輯器中
- public IContentFormatter getContentFormatter(ISourceViewer sourceViewer)
- {
- ContentFormatter formatter = new ContentFormatter();
- XMLFormattingStrategy formattingStrategy = new XMLFormattingStrategy();
- DefaultFormattingStrategy defaultStrategy = new DefaultFormattingStrategy();
- TextFormattingStrategy textStrategy = new TextFormattingStrategy();
- DocTypeFormattingStrategy doctypeStrategy = new DocTypeFormattingStrategy();
- PIFormattingStrategy piStrategy = new PIFormattingStrategy();
- formatter.setFormattingStrategy(defaultStrategy, IDocument.DEFAULT_CONTENT_TYPE);
- formatter.setFormattingStrategy(textStrategy, XMLPartitionScanner.XML_TEXT);
- formatter.setFormattingStrategy(doctypeStrategy, XMLPartitionScanner.XML_DOCTYPE);
- formatter.setFormattingStrategy(piStrategy, XMLPartitionScanner.XML_PI);
- formatter.setFormattingStrategy(textStrategy, XMLPartitionScanner.XML_CDATA);
- formatter.setFormattingStrategy(formattingStrategy, XMLPartitionScanner.XML_START_TAG);
- formatter.setFormattingStrategy(formattingStrategy, XMLPartitionScanner.XML_END_TAG);
- return formatter;
- }
上述代碼首選創(chuàng)建了一個(gè)formatter,然后通過(guò)formatter的setFormattingStrategy()方法給我們的每一個(gè)內(nèi)容類型指定一個(gè)個(gè)格式化策略即可.
安徽新華電腦學(xué)校專業(yè)職業(yè)規(guī)劃師為你提供更多幫助【在線咨詢】
