PSI文件

原文鏈接:
http://www.jetbrains.org/intellij/sdk/docs/basics/architectural_overview/psi_files.html

PSI(程序結(jié)構(gòu)接口)文件是將文件內(nèi)容抽象為特定編程語言元素的層次結(jié)構(gòu)的文件。

PsiFile類是所有PSI文件的基類宵凌,特定語言的PSI文件是其子類宫盔。例如,PsiJavaFile類代表Java文件近速,XmlFile類代表XML文件。

不像VirtualFileDocument的作用域?yàn)閼?yīng)用 (即使多個項(xiàng)目被打開,每個文件只被相同的VirtualFile所代表)吗坚,PSI的作用域?yàn)轫?xiàng)目(如果一個文件屬于多個同時打開項(xiàng)目菇晃,這個文件被多個PsiFile實(shí)例所代表)册倒。

我怎樣得到一個PSI文件?

  • 操作:e.getData(LangDataKeys.PSI_FILE)磺送;
  • 虛擬文件:PsiManager.getInstance(project).findFile()驻子;
  • 文檔:PsiDocumentManager.getInstance(project).getPsiFile()
  • 文件內(nèi)的元素:psiElement.getContainingFile()估灿;
  • 在項(xiàng)目的任何地方查找指定名字的文件崇呵,使用FilenameIndex.getFilesByName(project, name, scope)

我能用它來做什么馅袁?

大多數(shù)修改操作都在單獨(dú)的PSI元素上進(jìn)行域慷,而不是整個文件。

要遍歷文件中的元素汗销,使用psiFile.accept(new PsiRecursiveElementWalkingVisitor()...)犹褒。

它從何而來?

由于PSI是依賴于語言的弛针,PSI文件是通過Language對象使用LanguageParserDefinitions.INSTANCE.forLanguage(language).createFile(fileViewProvider)方法創(chuàng)建的叠骑。

像文檔一樣,PSI文件也是被訪問時按需創(chuàng)建的削茁。

PSI文件可以持久化多長時間宙枷?

像文檔一樣,PSI文件也是相應(yīng)的VirtualFile實(shí)例的弱引用茧跋,如果沒有任何引用就會被垃圾回收機(jī)制回收慰丛。

我怎樣創(chuàng)建一個PSI文件?

PsiFileFactory.getInstance(project).createFileFromText()方法創(chuàng)建一個相應(yīng)內(nèi)容的內(nèi)存PSI文件瘾杭。

要保存PSI文件到磁盤诅病,使用PsiDirectory.add()方法。

PSI文件改變時我怎樣得到通知?

PsiManager.getInstance(project).addPsiTreeChangeListener()允許你接受項(xiàng)目中PSI樹所有更改的通知睬隶。

我怎樣擴(kuò)展PSI锣夹?

PSI可以通過自定義語言插件擴(kuò)展支持其它語言 。更多關(guān)于開發(fā)自定義語言插件詳情苏潜,參閱自定義語言支持银萍。

使用PSI有什么規(guī)則?

所有對PSI文件內(nèi)容的更改都會反映到文檔上,所以使用文檔時所有規(guī)則(讀寫操作恤左、命令贴唇、只讀處理) 都是有效的。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末飞袋,一起剝皮案震驚了整個濱河市戳气,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌巧鸭,老刑警劉巖瓶您,帶你破解...
    沈念sama閱讀 218,858評論 6 508
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異纲仍,居然都是意外死亡呀袱,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,372評論 3 395
  • 文/潘曉璐 我一進(jìn)店門郑叠,熙熙樓的掌柜王于貴愁眉苦臉地迎上來夜赵,“玉大人,你說我怎么就攤上這事乡革】苌” “怎么了?”我有些...
    開封第一講書人閱讀 165,282評論 0 356
  • 文/不壞的土叔 我叫張陵沸版,是天一觀的道長嘁傀。 經(jīng)常有香客問我,道長推穷,這世上最難降的妖魔是什么心包? 我笑而不...
    開封第一講書人閱讀 58,842評論 1 295
  • 正文 為了忘掉前任,我火速辦了婚禮馒铃,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘痕惋。我一直安慰自己区宇,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,857評論 6 392
  • 文/花漫 我一把揭開白布值戳。 她就那樣靜靜地躺著议谷,像睡著了一般。 火紅的嫁衣襯著肌膚如雪堕虹。 梳的紋絲不亂的頭發(fā)上卧晓,一...
    開封第一講書人閱讀 51,679評論 1 305
  • 那天芬首,我揣著相機(jī)與錄音,去河邊找鬼逼裆。 笑死郁稍,一個胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的胜宇。 我是一名探鬼主播耀怜,決...
    沈念sama閱讀 40,406評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼桐愉!你這毒婦竟也來了财破?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 39,311評論 0 276
  • 序言:老撾萬榮一對情侶失蹤从诲,失蹤者是張志新(化名)和其女友劉穎左痢,沒想到半個月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體系洛,經(jīng)...
    沈念sama閱讀 45,767評論 1 315
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡俊性,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,945評論 3 336
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了碎罚。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片磅废。...
    茶點(diǎn)故事閱讀 40,090評論 1 350
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖荆烈,靈堂內(nèi)的尸體忽然破棺而出拯勉,到底是詐尸還是另有隱情,我是刑警寧澤憔购,帶...
    沈念sama閱讀 35,785評論 5 346
  • 正文 年R本政府宣布宫峦,位于F島的核電站,受9級特大地震影響玫鸟,放射性物質(zhì)發(fā)生泄漏导绷。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,420評論 3 331
  • 文/蒙蒙 一屎飘、第九天 我趴在偏房一處隱蔽的房頂上張望妥曲。 院中可真熱鬧,春花似錦钦购、人聲如沸檐盟。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,988評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽葵萎。三九已至,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間羡忘,已是汗流浹背谎痢。 一陣腳步聲響...
    開封第一講書人閱讀 33,101評論 1 271
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留卷雕,地道東北人节猿。 一個月前我還...
    沈念sama閱讀 48,298評論 3 372
  • 正文 我出身青樓,卻偏偏與公主長得像爽蝴,于是被迫代替她去往敵國和親沐批。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,033評論 2 355

推薦閱讀更多精彩內(nèi)容

  • PSI(Program Structure Interface) 文件是表示一個文件的內(nèi)容作為在一個特定的編程語言...
    斯科特安閱讀 5,017評論 1 3
  • Spring Cloud為開發(fā)人員提供了快速構(gòu)建分布式系統(tǒng)中一些常見模式的工具(例如配置管理蝎亚,服務(wù)發(fā)現(xiàn)九孩,斷路器,智...
    卡卡羅2017閱讀 134,659評論 18 139
  • Android 自定義View的各種姿勢1 Activity的顯示之ViewRootImpl詳解 Activity...
    passiontim閱讀 172,164評論 25 707
  • 每一位菜鳥設(shè)計(jì)師发框,都會有一個高大上的設(shè)計(jì)總監(jiān)夢躺彬。 夢想大家每天都在談,怎樣才能實(shí)現(xiàn)梅惯。很多問題不是一廂情愿就可以宪拥,更...
    陳妃閱讀 643評論 0 0