Eclipse Community Forums: TMF (Xtext) » [SOLVED] What is the generated file ".File.dslbin"?

Home » Modeling » TMF (Xtext) » [SOLVED] What is the generated file ".File.dslbin"?

[SOLVED] What is the generated file ".File.dslbin"? [message #1758162]

Fri, 24 March 2017 04:04

Eclipse User

With my DSL, several hidden files are generated. I have understood the meaning of the "*.java._trace" file.

But something I'm finding hidden files with the ".dslbin" (where "dsl" is the name of my dsl) file extension into the binary folder of my application coded with the DSL.

What is the purpose of this file?
Should I include it in the binary or source jar libraries that I want to create from my project?

I did not find any valuable information on Internet.

Thank you.
All the best.
Stéphane.

[Updated on: Fri, 31 March 2017 11:42] by Moderator

Re: What is the generated file ".File.dslbin"? [message #1758163 is a reply to message #1758162]

Fri, 24 March 2017 04:13

Eclipse User

in you dsl you can decide to store a complete resource as binary for faster reading/accessing e.g. when the resource is needed as dependency during build.
this is does by ResourceStorageFacade.

=> it depends if you package you dsl files in a jar you should package the dslbin files as well.

Re: What is the generated file ".File.dslbin"? [message #1758169 is a reply to message #1758163]

Fri, 24 March 2017 04:37

Eclipse User

Thank you Christian.
That's very clear now.

Re: What is the generated file ".File.dslbin"? [message #1758294 is a reply to message #1758169]

Mon, 27 March 2017 05:53

Eclipse User

Let the following files exist after my DSL compiler has ran:

src/mypackage/myscript.dsl
src-gen/mypackage/MyType.java
src-gen/mypackage/.MyType.java._trace
src-gen/mypackage/.myscript.dslbin
bin/mypackage/MyType.class

I want to create the binary and source Jar files. Am I right by putting the different files as:

In myprogram-1.0.jar:
- mypackage/MyType.class
In myprogram-1.0-sources.jar:
- mypackage/myscript.dsl
- mypackage/MyType.java
- mypackage/.MyType.java._trace
- mypackage/.myscript.dslbin

Thank you.
Stéphane.

Re: What is the generated file ".File.dslbin"? [message #1758297 is a reply to message #1758294]

Mon, 27 March 2017 07:02

Eclipse User

Are you referencing any other elements from our dsl then the inferred JVMElements.
If not then I recommend to link to the *.class concepts in binaries.
The *.dslbin are merely an optimization for loading referenced resources in editors.

Re: What is the generated file ".File.dslbin"? [message #1758299 is a reply to message #1758297]

Mon, 27 March 2017 07:29

Eclipse User

The generated content from myscript.dsl, i.e. the MyType.java content does not have any reference to types outside the standard Java API.
The myprogram-1.0.jar library is supposed to be included into the classpath of a third party program.

Assuming that this third party program is also written in a Xtext-based editor, is it a good practice to put the ".dslbin" file into the binary archive and not in the source archive, in order to increase the speed of the Xtext-based editor? Assuming that the source archive is not be given to the editing environment.

Or, is the best practice to put the ".dslbin" file into the source archive, and "force" the third-party programmer to link the binary and source archives in its Eclipse IDE?

All the best.
Stéphane.

Re: What is the generated file ".File.dslbin"? [message #1758560 is a reply to message #1758299]

Thu, 30 March 2017 03:04

Eclipse User

The dslbin files only make sense as long as you're in a closed environment, like the workspace in which you're developing them. The Xtext builder will update them if necessary as you add remove resources.
You cannot tell what is in the workspace of someone using your jar, so it doesn't make sense to include them in the binary archive.

An example:
Your DSL model refers to something named Foo. The builder locates that Foo in your workspace and stores its URI in the dslbin.
When you change your workspace such that the reference must point to some other Foo (with regards to your scoping) then the builder detects that and updates the dslbin.
Next time an editor needs to you open your model it can be loaded from the binary representation, saving the time for initial parsing and linking.
When you use the same model from a binary jar in another workspace, you cannot predict which kinds of Foo are there, so your model has to be relinked entirely.
The .dslbin is of little use here.

What Sven means is that if you just link against JvmElements it doesn't matter as these have to be resolved against the classpath anyway. The dslbin does not store any other information than their fully qualified names.

Re: What is the generated file ".File.dslbin"? [message #1758680 is a reply to message #1758560]

Fri, 31 March 2017 11:39

Eclipse User

Thank you to both of you for your explanation.
I will update my building process accordingly.

All the best.
Stéphane.

Previous Topic:	Question on ContentAssistProcessorTestBuilder#append
Next Topic:	Hyperlink to external file

Goto Forum:

-=] Back to Top [=-

Current Time: Sun Jul 27 02:28:27 EDT 2025

.:: Contact :: Home ::.

Breadcrumbs

Sign up to our Newsletter