第 10 章 JBoss Developer Studio 集​成​

EGT 包​含​两​个​视​图​ - 库​浏​览​器​（Repository Explorer）和​版​本​历​史​（Version History）- 它​们​是​和​ Guvnor 库​交​互​的​中​心​点​。​

"Guvnor Repository Exploring" 视​角​是​我​们​建​议​的​格​式​。​它​可​以​通​过​ Open Perspective 对​话​框​（Window -> Open Perspective -> Other...）来​访​问​。​

左​侧​是​ Guvnor Repository Explorer 和​ Eclipse Properties 视​图​，Guvnor Resource History 视​图​位​于​底​部​，而​ Eclipse Resource Navigator 位​于​右​侧​。​Guvnor Repository Explorer 为​访​问​ Guvnor 库​资​源​提​供​了​可​浏​览​的​树​型​格​式​。​Guvnor Resource History 视​图​显​示​了​库​里​可​用​资​源​的​修​订​记​录​。​

打​开​ Guvnor 视​角​后​，第​一​个​任​务​是​连​接​连​接​到​ Guvnor 库​。​这​是​由​ Guvnor 连​接​向​导​处​理​的​。​这​个​向​导​出​现​在​ EGT 里​的​多​个​地​方​（参​见​下​面​的​详​情​），但​在​本​节​我​们​只​介​绍​两​个​最​基​本​的​入​口​点​。​Guvnor 连​接​向​导​可​以​用​ Eclipse 菜​单​启​动​：File -> New -> Other -> Guvnor -> Guvnor repository location 或​通​过​ Guvnor 浏​览​器​的​下​拉​菜​单​：

或​者​使​用​菜​单​按​钮​：

选​择​其​中​一​个​都​将​启​动​ Guvnor 连​接​向​导​：

缺​省​值​会​出​现​在​ Location、​Port 和​ Repository 字​段​。​（关​于​如​何​修​改​这​些​缺​省​值​，请​参​考​下​面​的​ "Guvnor 首​选​项​" 章​节​。​）

当​然​，你​可​以​在​对​应​的​文​本​框​里​输​入​来​编​辑​这​些​字​段​。​将​典​型​的​ Guvnor 库​ URL 拖​放​或​粘​贴​到​ Location 字​段​，如​：http://localhost:8080/jboss-brms/org.drools.guvnor.Guvnor/webdav。​

URL 里​的​结​果​也​会​被​粘​贴​到​对​应​的​字​段​。​选​择​ ”​Save user name and password“​ 可​以​将​验​证​信​息​（用​户​名​和​密​码​）存​储​到​ Eclipse 工​作​台​的​ key-ring 文​件​里​。​如​果​验​证​信​息​没​有​存​储​在​ key-ring 文​件​里​，EGT 将​使​用​会​话​验​证​。​这​表​示​提​供​的​凭​证​只​能​用​于​ Eclipse 工​作​台​实​例​的​生​命​周​期​内​。​

如​果​验​证​信​息​没​有​存​储​在​ key-ring 文​件​里​或​者​它​是​无​效​的​，当​EGT 需​要​访​问​ Guvnor 库​时​它​将​提​示​你​：

如​果​验​证​失​败​，EGT 将​重​试​并​显​示​验​证​失​败​错​误​。​如​果​验​证​失​败​，你​可​以​重​试​相​同​的​操​作​并​使​用​不​同​的​凭​证​。​EGT 在​不​同​的​情​况​下​会​调​用​ Guvnor 库​，如​当​决​定​资​源​更​新​是​否​可​用​时​，所​以​，如​果​你​使​用​会​话​验​证​方​式​，根​据​你​执​行​的​行​为​，验​证​对​话​框​将​在​ Eclipse 工​作​台​会​话​期​间​多​次​出​现​。​为​了​便​于​使​用​，我​们​推​荐​你​将​验​证​信​息​保​存​在​ key-ring 里​。​Eclipse 的​ key-ring 文​件​和​其​他​平​台​如​ Mac OS X 和​许​多​ Linux 的​ key-ring 文​件​不​同​。​因​此​，有​时​候​如​果​你​在​ EGT 之​外​访​问​ Guvnor 库​，key-ring 文​件​可​能​无​法​同​步​，从​而​导​致​验​证​失​败​。​这​令​人​讨​厌​，但​在​这​种​情​况​下​你​应​该​使​用​平​时​的​凭​证​。​

Guvnor 连​接​向​导​执​行​完​毕​后​，新​的​库​连​接​将​出​现​在​ Guvnor Repository Explorer 里​。​然​后​你​就​可​以​扩​展​树​来​参​看​库​的​内​容​。​

Guvnor 库​浏​览​器​视​图​显​示​ Guvnor 库​内​容​的​树​型​结​构​。​如​上​所​述​，它​具​有​创​建​ Guvnor 库​连​接​的​菜​单​和​工​具​栏​行​为​。​工​具​栏​里​的​红​色​ "X" 和​菜​单​条​里​的​ “​Delete“​ 都​可​以​删​除​ Guvnor 库​连​接​，而​ “​Refresh" 菜​单​则​为​所​选​节​点​加​载​树​型​内​容​。​最​后​，它​有​大​量​的​工​具​栏​/菜​单​项​支​持​ “​drill-into" 功​能​：工​具​栏​里​是​房​子​（“​return to top level/home”​）和​箭​头​（go into/back）。​当​用​于​深​度​嵌​套​的​树​型​结​构​且​你​希​望​专​注​于​树​的​分​支​时​，Drill-down 是​很​有​用​的​。​

对​于​ Guvnor 库​文​件​，有​大​量​的​操​作​可​以​执​行​。​在​ Guvnor 库​里​选​择​一​个​文​件​将​导​致​ Eclipse 属​性​视​图​更​新​该​文​件​的​细​节​：

双​击​树​里​到​文​件​夹​（目​录​）将​扩​展​或​收​缩​该​文​件​夹​。​双​击​文​件​夹​里​的​文​件​将​在​ Eclipse 里​打​开​一​个​只​读​编​辑​器​，显​示​该​文​件​的​内​容​：

从​ Guvnor 库​树​里​拖​动​一​个​文​件​到​ Eclipse 本​地​项​目​（如​ Eclipse 资​源​导​航​器​视​图​）里​的​文​件​夹​里​将​在​本​地​ Eclipse 工​作​区​里​创​建​该​文​件​的​拷​贝​。​（请​注​意​：在​只​读​编​辑​器​里​打​开​文​件​时​你​也​可​以​用​ “​Save As...”​ 保​存​一​个​本​地​到​可​写​版​本​，但​这​样​并​不​能​关​联​所​创​建​的​文​件​和​它​的​ Guvnor 源​。​）最​后​，你​可​以​用​ "Show History" 上​下​文​菜​单​查​看​所​选​文​件​的​修​订​历​史​记​录​。​（下​面​将​讨​论​资​源​历​史​记​录​的​细​节​。​）

如​“​简​介​”​章​节​里​所​提​及​的​，EGT 的​主​要​目​的​是​允​许​使​用​ Guvnor 库​里​的​资​源​进​行​开​发​。​有​两​个​方​法​可​获​取​ Guvnor 库​资​源​的​本​地​版​本​：

1. 如​上​所​述​，从​ Guvnor 库​浏​览​器​里​拖​-放​。​

2. 如​ 第 10.6 节 “导​入​ Guvnor 库​资​源​” 所​解​释​的​，使​用​ “​import from Guvnor”​ 向​导​。​

创​建​了​ Gunvor 库​文​件​的​本​地​拷​贝​后​，EGT 将​设​置​本​地​拷​贝​和​库​里​的​主​文​件​间​的​关​联​。​（这​个​信​息​保​存​在​本​地​项​目​的​ “​.guvnorinfo”​ 文​件​夹​里​，象​所​有​的​元​数​据​，最​终​用​户​不​应​该​修​改​它​。​）这​个​关​联​使​得​一​些​操​作​（如​更​新​和​提​交​）可​与​ Guvnor 库​里​的​主​文​件​进​行​同​步​。​EGT 会​装​饰​和​主​文​件​关​联​的​本​地​资​源​。​这​种​装​饰​出​现​在​遵​循​通​用​导​航​器​框​架​的​ Eclipse 视​图​里​，如​ Eclipse 资​源​导​航​器​和​ Java 软​件​包​浏​览​器​。​下​图​显​示​了​ Eclipse 资​源​导​航​器​里​的​装​饰​：

注​意​文​件​图​像​右​上​角​的​ Guvnor 图​标​装​饰​以​及​附​加​在​文​件​名​后​的​ Guvnor 修​订​记​录​细​节​。​（你​可​以​修​改​这​些​东​西​的​存​在​与​否​和​位​置​。​细​节​请​参​考​下​面​的​ “​Guvnor 首​选​项​”​ ）这​里​我​们​可​以​看​到​，例​如​，“​simpleRule.drl”​ 和​ Guvnor 库​资​源​关​联​而​本​地​拷​贝​基​于​版​本​ 3，并​带​有​ “​7-15-2008, 15:37:34“​ 时​间​戳​。​而​文​件​ “​deleteTest.txt”​ 没​有​和​ Guvnor 库​文​件​关​联​。​通​过​上​下​文​菜​单​到​ ”​Properties“​ 部​分​，你​可​以​在​标​准​的​ Eclihttps://translate.jboss.org/webtrans/clear.cache.gifpse 属​性​页​面​找​到​关​于​关​联​的​更​多​细​节​：

EGT 为​标​准​的​ Eclipse 属​性​对​话​框​贡​献​了​一​个​属​性​页​面​，上​面​显​示​了​它​的​内​容​。​其​中​包​括​专​门​的​ Guvnor 库​、​库​里​的​位​置​、​版​本​（日​期​/时​间​戳​）和​版​本​号​码​。​

EGT 提​供​大​量​的​行​为​（通​过​文​件​的​“​Guvnor”​上​下​文​菜​单​）以​用​于​处​理​文​件​，包​括​那​些​和​ Guvnor 库​主​拷​贝​相​关​和​不​相​关​联​的​。​这​些​行​为​是​： 每​种​行​为​都​将​在​下​面​进​行​描​述​。​

更​新​（Update）行​为​：

更​新​（Update）行​为​可​用​于​一​个​或​多​个​没​有​和​ Guvnor 库​主​拷​贝​同​步​的​ Guvnor 资​源​。​这​些​资​源​将​不​会​进​行​同​步​，因​为​（1）发​生​了​本​地​的​修​改​，或​（2）Guvnor 库​里​的​主​拷​贝​已​经​发​生​了​变​化​。​执​行​更​新​动​作​将​用​当​前​的​主​拷​贝​替​换​本​地​文​件​内​容​（相​当​于​“​切​换​版​本​（Switch to version）”​到​最​新​的​版​本​）。​

添​加​（Add）行​为​：

添​加​（Add）行​为​可​用​于​和​ Guvnor 库​主​拷​贝​没​有​关​联​的​一​个​或​多​个​本​地​文​件​。​选​择​ Add 行​为​将​启​动​ “​Add to Guvnor”​ 向​导​：

向​导​的​第​一​页​将​请​求​你​选​择​目​标​ Guvnor 库​以​及​创​建​一​个​新​的​ Guvnor 库​连​接​（第​二​页​和​上​面​描​述​的​ Guvnor 连​接​向​导​的​相​同​）。​选​择​了​目​标​ Guvnor 库​以​后​，向​导​将​要​求​你​选​择​添​加​所​选​文​件​的​文​件​夹​位​置​：

在​这​里​我​已​经​选​择​了​ mortages 文​件​夹​为​目​的​地​。​点​击​ “​Finish”​ 添​加​所​选​文​件​到​ Guvnor 库​并​创​建​本​地​文​件​和​ Guvnor 库​文​件​间​的​关​联​。​这​个​向​导​不​会​允​许​你​在​添​加​新​文​件​时​覆​盖​现​有​的​ Guvnor 库​文​件​。​

比​较​版​本​（Compare with Version）行​为​：

Compare with Version 行​为​对​于​和​ Guvnor 库​相​关​联​的​文​件​是​启​用​的​。​它​首​先​启​动​一​个​向​导​并​要​求​选​择​需​要​比​较​的​版​本​（和​本​地​文​件​内​容​）：

选​择​了​版​本​后​，这​个​行​为​打​开​ Eclipse 比​较​编​辑​器​（只​读​）：

这​个​编​辑​器​使​用​ Eclipse 标​准​的​比​较​技​术​来​显​示​两​个​版​本​的​不​同​。​如​果​没​有​不​同​，编​辑​器​将​不​会​被​打​开​而​是​弹​出​一​个​对​话​框​说​明​没​有​任​何​不​同​。​

切​换​版​本​（Switch to Version）行​为​：

Switch to Version 行​为​对​于​和​ Guvnor 库​相​关​联​的​文​件​是​启​用​的​。​它​首​先​提​示​选​择​版​本​：

选​择​了​版​本​后​，Switch to Version 行​为​将​用​所​选​版​本​替​换​本​地​文​件​的​内​容​。​

删​除​（Delete）行​为​：

删​除​（Delete）行​为​对​于​和​ Guvnor 库​相​关​联​的​文​件​是​启​用​的​。​通​过​对​话​框​进​行​确​认​后​，Delete 行​为​删​除​ Guvnor 库​里​的​文​件​并​和​它​相​关​联​的​本​地​元​数​据​。​

断​开​连​接​（Disconnect）行​为​：

断​开​连​接​（Disconnect）行​为​对​于​一​个​或​多​个​和​ Guvnor 库​相​关​联​的​文​件​是​启​用​的​它​删​除​和​ Guvnor 库​相​关​联​的​本​地​元​数​据​。​

Guvnor 资​源​历​史​视​图​：

Guvnor 资​源​历​史​视​图​应​该​提​供​所​选​文​件​的​修​订​历​史​记​录​，对​于​本​地​文​件​和​ Guvnor 库​都​是​一​样​。​这​个​视​图​的​初​始​状​态​是​：

Guvnor 资​源​历​史​视​图​是​由​本​地​的​ “​Guvnor”​ 上​下​文​菜​单​或​ Guvnor 库​浏​览​器​里​的​文​件​的​上​下​文​菜​单​里​的​ “​Show History”​ 选​项​决​定​的​。​执​行​了​这​个​动​作​后​，Guvnor 资​源​历​史​视​图​将​进​行​更​新​以​显​示​修​订​历​史​记​录​：

在​这​里​我​们​看​到​文​件​ “​simpleRule.drl”​ 有​三​个​修​订​版​本​。​双​击​某​个​版​本​（或​选​择​上​下​文​菜​单​的​『​打​开​（只​读​）』​）将​打​开​一​个​带​有​版​本​内​容​的​ Eclipse 只​读​编​辑​器​。​（请​注​意​：在​只​读​编​辑​器​里​打​开​文​件​时​你​也​可​以​用​ “​Save As...”​ 保​存​一​个​本​地​到​可​写​版​本​，但​这​样​并​不​能​关​联​所​创​建​的​文​件​和​它​的​ Guvnor 源​。​）

除​了​从​ Guvnor 库​浏​览​器​视​图​里​拖​放​单​个​文​件​以​外​，EGT 也​包​括​一​个​可​复​制​多​个​文​件​到​本​地​工​作​区​的​向​导​（以​及​设​置​和​ Guvnor 库​的​关​联​）。​在​ Eclipse Import 、​Guvnor、​Resource from Guvnor 和​ Eclipse File、​New、​Other、​Guvnor、​Resource from Guvnor 菜​单​选​项​里​，这​个​向​导​都​是​可​用​的​。​（请​注​意​：在​这​两​个​位​置​这​个​向​导​是​相​同​的​，只​是​为​了​方​便​用​户​在​不​同​的​类​别​里​使​用​这​个​功​能​。​）向​导​的​第​一​页​将​要​求​选​择​源​ Guvnor 库​并​创​建​新​的​ Guvnor 库​连​接​（第​二​页​和​上​面​描​述​的​ Guvnor 连​接​向​导​相​同​）。​

选​择​了​源​ Guvnor 库​后​，向​导​会​提​示​你​选​择​资​源​：

最​后​，选​择​本​地​工​作​区​里​的​目​标​位​置​：

之​后​向​导​将​从​ Guvnor 库​复​制​所​选​的​文​件​到​本​地​工​作​区​。​如​果​目​的​地​已​经​存​在​相​同​名​字​的​文​件​，向​导​将​使​用​ Eclipse 的​标​准​ “​prompt for rename”​ 对​话​框​：

EGT 在​提​供​

首​选​项​有​两​个​类​别​：Guvnor 库​连​接​和​本​地​ Guvnor 库​资​源​装​饰​。​

Guvnor 库​连​接​的​首​选​项​

对​于​ Guvnor 库​连​接​，你​可​以​设​置​两​个​首​选​项​，它​们​是​在​创​建​新​连​接​时​使​用​的​。​第​一​个​是​缺​省​的​ Guvnor 库​ URL 模​板​，通​过​简​单​地​修​改​部​分​字​段​（如​主​机​名​），它​使​得​创​建​多​个​类​似​的​连​接​更​为​容​易​。​第​二​个​是​是​否​在​ Eclipse 平​台​ Key-ring 里​保​存​验​证​信​息​，在​缺​省​情​况​下​你​应​该​启​用​它​。​使​用​ Guvnor 库​ URL 模​板​时​，是​否​在​ Eclipse 平​台​ Key-ring 里​保​存​特​定​的​验​证​信​息​实​例​是​可​以​在​创​建​连​接​时​决​定​的​。​也​就​是​说​，这​两​个​首​选​项​都​已​经​简​单​设​置​为​了​合​理​的​缺​省​值​。​

本​地​ Guvnor 库​资​源​装​饰​的​首​选​项​

EGT 提​供​的​首​选​项​的​第​二​个​类​别​处​理​和​ Guvnor 库​资​源​相​关​联​的​本​地​资​源​的​外​观​。​既​然​ Guvnor 库​不​是​ SCM 的​替​代​物​，且​ Eclipse 里​的​ SCM 工​具​倾​向​于​装​饰​本​地​资​源​，能​够​控​制​ EGT 装​饰​其​本​地​资​源​以​避​免​和​ SCM 软​件​包​冲​突​是​很​有​用​的​。​在​首​选​项​页​面​的​ “​File Decoration”​ 部​分​里​，你​可​以​选​择​装​饰​图​标​的​位​置​（top right, bottom right, top left, bottom left），或​者​你​可​以​选​择​不​显​示​它​。​在​ "Text" 部​分​，你​可​以​格​式​化​附​加​到​文​件​名​上​的​ Guvnor 元​数​据​：当​本​地​文​件​已​经​发​生​变​动​但​还​未​提​交​会​ Guvnor 库​时​是​否​显​示​一​个​标​记​(>)。​是​否​显​示​修​订​版​本​号​码​。​是​否​显​示​日​期​/时​间​戳​。​在​点​击​了​ “​Apply”​ 或​ “​Ok”​ 后​，对​这​些​首​选​项​的​任​何​修​改​都​是​立​即​生​效​的​。​