Xtext 2.9范围提供者

J B*_*rns 5 java dsl modeling xtext xtend

Xtext 2.9更改了范围提供程序的工作方式,我不知道它们现在如何工作。

假设我有以下语法:

grammar org.xtext.example.mydsl.MyDsl with org.eclipse.xtext.common.Terminals

generate myDsl "http://www.xtext.org/example/mydsl/MyDsl"

Model:
    ((things+=Thing) | (refs+=Reference))*
;

Thing:
    'thing' name=ID '{'
        stuff += Stuff* 
    '}'
;

Stuff:
    'stuff' name=ID
;

Reference:
    'reference' thing=[Thing] stuff=[Stuff] 
;
Run Code Online (Sandbox Code Playgroud)

为了使Reference子句起作用,我需要一个作用域提供程序。

XText 2.9为您生成以下范围提供程序代码(在MyDslScopeProvider.xtend中):

class MyDslScopeProvider extends AbstractMyDslScopeProvider {
}
Run Code Online (Sandbox Code Playgroud)

AbstractMyDslScopeProvider没有自己的方法,它仅继承自DelegatingScopeProvider。

我无法确定它是如何工作的,或者范围查询的代码应该放在哪里。“文档”并没有真正的帮助,因为只有无用的代码片段,而不是完整的可用示例。

XText的早期版本使用AbstractDeclarativeScopeProvider,并且很容易理解和使用,在2.9之前的版本应该是:

class MyDslScopeProvider extends AbstractDeclarativeScopeProvider {
    def IScope scope_Reference_stuff(Reference reference, EReference ref) {
        scopeFor(reference?.thing.stuff)
    }
}
Run Code Online (Sandbox Code Playgroud)

Sve*_*nge 3

你需要实现该getScope方法

override getScope(EObject ctx, EReference ref) {
   if (ref == MyDslPackage.Literals.REFERENCE_THING) {
      return createScopeForThings()
   } else if (ref == MyDslPackage.Literals.REFERENCE_STUFF) {
      return createScopeForStuff()
   }
}
Run Code Online (Sandbox Code Playgroud)

在您的情况下,您将收到一个调用,其中 EObject 是一个实例Reference,EReference 是 MyDslPackage.Literals.REFERENCE_THING 或 MyDslPackage.Literals.REFERENCE_STUFF。

您需要创建并返回 的实例IScope,链接器和内容辅助可以使用该实例。有关详细信息,请参阅IScopeProvider和的 JavaDoc 。IScope