Lightning talk at EclipseCon 2010, Santa Clara, CA

1. Combining
Graphics and Text
in
Modeling Tools
Jan Köhnlein

3. GMF
Graphical

4. GMF
Graphical
Xtext
Textual

5. GMF
Graphical
Just two different views
on the same thing
Xtext
Textual

6. Synchronization

7. Xtext

8. Xtext
Textual Model
Serializer
Parser
Node Model
Ecore Model
Instance

9. Xtext
XtextResource
Textual Model
Serializer
Parser
Node Model
Ecore Model
Instance

10. Xtext
XtextResource
Textual Model
Serializer
Parser
Node Model
Ecore Model
Instance
getContents()

11. Xtext load(), save()
XtextResource
Textual Model
Serializer
Parser
Node Model
Ecore Model
Instance
getContents()

12. Xtext load(), save()
XtextResource
Textual Model
Serializer
Parser
Node Model
Ecore Model
Instance FragmentProvider
getContents() getURIFragment()
getEObject()

13. ResourceSet
XtextResource DiagramResource

14. diagram
change
ResourceSet
XtextResource DiagramResource

15. ResourceSet
XtextResource DiagramResource

16. reparse()
w/ errors
ResourceSet
XtextResource DiagramResource

17. ResourceSet
XtextResource DiagramResource

18. ResourceSet
XtextResource DiagramResource
Canonical
EditPolicy

19. ResourceSet
XtextResource DiagramResource
Canonical
EditPolicy

20. ResourceSet
XtextResource DiagramResource
Canonical
EditPolicy

21. Fi e l
od a
M xtu
le l
Te
ResourceSet ResourceSet
XtextResource XtextResource DiagramResource

22. Fi e l
od a
M xtu
le l
Te
ResourceSet ResourceSet
XtextResource XtextResource DiagramResource

23. Fi e l
od a
M xtu
le l
Te
ResourceSet ResourceSet
XtextResource XtextResource DiagramResource

24. Fi e l
od a
M xtu
le l
Te
ResourceSet ResourceSet
XtextResource save() XtextResource DiagramResource

25. Fi e l
od a
M xtu
le l
Te
ResourceSet ResourceSet
XtextResource reload() XtextResource DiagramResource

26. Fi e l
od a
M xtu
le l
Te
ResourceSet ResourceSet
XtextResource reload() XtextResource DiagramResource

27. Fi e l
od a
M xtu
le l
Te
ResourceSet ResourceSet
XtextResource XtextResource DiagramResource

28. Demo Time

30. Create a Diagram

33. Save Diagram

36. Open Textual Model

39. Edit Textual Model

42. Save Textual Model

45. Edit Diagram

48. Reorder Objects

51. Diagram With Unsaved Changes

54. Try to Edit Text

57. Other Way Around...

60. Navigation

63. Popup Editor

65. Alignment

66. grammar org.xtext.cg2009.Entities
with org.eclipse.xtext.common.Terminals
generate entities "http://www.xtext.org/cg2009/Entities"
Model :
{Model} (entities += Entity)*;
Entity returns Entity:
'entity' (name=ID)? ('extends' superType=[Entity])? '{'
(properties+=Property)*
'}';
Property:
SimpleProperty | ReferenceProperty;
SimpleProperty:
'property' (name=ID)? ':' type=('String'|'Number'|'Bool');
ReferenceProperty :
(name=ID)? 'refs' ('one' | many?='many')? type=[Entity];

67. grammar org.xtext.cg2009.Entities
with org.eclipse.xtext.common.Terminals
Avoid empty
generate entities "http://www.xtext.org/cg2009/Entities"
models
Model :
{Model} (entities += Entity)*;
Entity returns Entity:
'entity' (name=ID)? ('extends' superType=[Entity])? '{'
(properties+=Property)*
'}';
Property:
SimpleProperty | ReferenceProperty;
SimpleProperty:
'property' (name=ID)? ':' type=('String'|'Number'|'Bool');
ReferenceProperty :
(name=ID)? 'refs' ('one' | many?='many')? type=[Entity];

68. grammar org.xtext.cg2009.Entities
with org.eclipse.xtext.common.Terminals
Avoid empty
generate entities "http://www.xtext.org/cg2009/Entities"
models
Model :
{Model} (entities += Entity)*;
Entity returns Entity:
'entity' (name=ID)? ('extends' superType=[Entity])? '{'
(properties+=Property)*
'}';
Property:
Cover mandatory
SimpleProperty | ReferenceProperty;
properties in
SimpleProperty:
validation
'property' (name=ID)? ':' type=('String'|'Number'|'Bool');
ReferenceProperty :
(name=ID)? 'refs' ('one' | many?='many')? type=[Entity];

69. grammar org.xtext.cg2009.Entities
with org.eclipse.xtext.common.Terminals
Avoid empty
generate entities "http://www.xtext.org/cg2009/Entities"
Carefully select
models
Model : containment or cross
{Model} (entities += Entity)*; references
Entity returns Entity:
'entity' (name=ID)? ('extends' superType=[Entity])? '{'
(properties+=Property)*
'}';
Property:
Cover mandatory
SimpleProperty | ReferenceProperty;
properties in
SimpleProperty:
validation
'property' (name=ID)? ':' type=('String'|'Number'|'Bool');
ReferenceProperty :
(name=ID)? 'refs' ('one' | many?='many')? type=[Entity];

70. Xtext

71. Xtext
Implement a
Formatter

72. Xtext
Implement a
Formatter
Implement a
FragmentProvider

73. Xtext
Implement a
Formatter
Implement a
FragmentProvider
Implement a
JavaValidator

74. GMF

75. GMF
Initialize
mandatory
properties

76. GMF
Initialize
mandatory
properties
Avoid Phantom
Nodes

77. Add a
transaction on
GMF
load
Initialize
mandatory
properties
Avoid Phantom
Nodes

78. Glue Code
• Prevent conflicting modifications
• Navigate
• diagram ➜ text
• text ➜ diagram
(needs index)
• Popup editor
• Shipped as an Xtext example

79. Thanks for your
attention!
More information at
www.itemis.de
www.xtext.org
koehnlein.blogspot.com