DSL Tools

Lucas Mello Nancy Lyra

DSL Tools Visual Studio

Permite definir conceitos a serem utilizados em um domnio Alm disso:
Como os conceitos se relacionam Representao grfica para eles Gerao de cdigo

Nosso Demo
Jogo: Quiz Language
Perguntas e Respostas

Permitir que um desenvolvedor use a DSL criada para construir jogos de perguntas e respostas

Papis
Projetista
Define conceitos e representao grfica da DSL

Desenvolvedor
Utiliza a DSL para criar aplicaes

Usurio
Utiliza as aplicaes

Importante
As regras que compem o domnio precisam ser claramente descritas. Regras para o nosso DEMO:
Um jogo (quiz game) composto por uma sequncia de quizzes Uma quiz contm uma pergunta e um conjunto de respostas (choices) Cada quiz vale uma quantidade de pontos (score)
Se tiver mais de uma alternativa correta, o ponto s ser considerado se todas as respostas corretas forem assinaladas

Placar final equivale a soma dos pontos das quizzes acertadas possvel associar dicas (hints) s quizzes

Nosso alvo

Toolbox com conceitos do domnio Propriedades especficas ao elemento do domnio Conceitos com representao visual distinta selecionado Error List (Validao em alto nvel) Elementos visualizados de maneira hierrquica

Criando um Projeto DSL Designer

Minimal Language - contm os elementos bsicos de uma DSL, que voc pode estender para criar a sua prpria

Extenso dos arquivos que vo conter os diagramas da DSL

Contm informaes sobre os conceitos e a representao visual de sua DSL

Abra este

Utilizado para registrar a DSL no VS.NET. A princpio, voc no deve se preocupar com este ltimo.

Conceitos (ou Classes) e Relacionamentos

Como os conceitos sero exibidos graficamente

A idia do DSL Tools prover, aos usurios mais experientes, elementos bsicos prontos para uso e modificao, permitindo que uma DSL possa ser minimamente construda (isso justifica o nome Minimal Language do template)

Faz mais sentido pro nosso Demo

Instncias podero ter nome. Ex: Conceito Cidade Instncias como: Recife, Olinda, etc

Conceitos e Propriedades do Demo

Criando tipos
Adicionando uma enumerao

Adicione uma nova propriedade ao conceito Quiz:

Type, do tipo AnswerType

Definindo Relacionamentos
Relacionamento Forte Ex: Quiz e Choice S existe Choice se existir Quiz

Relacionamento Fraco Ex: Hint e Quiz Existe Quiz sem Hint

Herana Ex: IllustratedQuiz herdaria de Quiz

Papis
Quiz tem papel Quiz em Choice Choice tem papel Choices em Quiz

Nem todo papel recebe o nome do conceito. EX: Professor e Universidade. Um professor pode ser Reitor, Vice-Reitor, Coordenador, Professor, etc.

No nosso Demo

Projetando Representao Grfica Sintaxe Visual

Nem todo conceito est associado a uma imagem. H formas grficas.

Adicionando Diagrama
Antes de adicionar formas, criar um diagrama (um conjunto de mapeamentos entre conceitos/relacionamentos e formas grficas.)
QuizLanguageDiagram

Uma vez definido um Diagram para a DSL e o conceito da linguagem por ele representado, hora de modelar as formas grficas (shapes).

Modelando Formas Grficas

Hint
Imagem (Image Shape) Name: HintShape Image: HintImage Outline Color: Transparent Initial Height: 0,4 Initial Width: 0,4

Informaes sobre o conceito associado forma: Obs. preciso habilitar a associao (Diagram Element Map da Toolbox)
Associar Hint a HintShape
Exibir/Ocultar linhas de mapeamento

 Quiz
Forma grfica pr-definida Compartment Shape Name: QuizShape Geometry: RoundedRectangle Fill Color: Qualquer uma, ex: Sky Blue Associar Quiz QuizShape Adicionar um Compartment chamado Choices
Title Fill: Lime Fill Color: Yellow Title: Choices Associar o conceito Choice a Choices (DSL Details)
Papel choice do relacionamento QuizHasChoices

Adicionando Decoradores Textuais e Grficos

Hint at agora s tem imagem
Add new Text Decorator
Name: ContentDecorator Position: OuterTopCenter

Associar Hint a ContentDecorator

 Text decorator ao QuizShape

Name: QuestionDecorator VerticalOffset: 0,3

Mapear Question a Quiz Icon Decorators ao QuizShape:

indicar se um Quiz SingleChoice ou MultiChoice associar imagens correspondentes Position: InnerTopRight

Mapeamento Quiz-QuizShape

Representao Grfica de Relacionamentos

Como aparecero conectados (Connector) os conceitos na DSL grfica No nosso Demo
Uma quiz a outra quiz Uma dica a uma quis Connector
Name: HintLinkConnector Dash Style: Dot Thickness: 0,01

Mapear este conector ao relacionamento HintReferencesQuizzes Fazer a mesma coisa para o connector NextQuizConnector

Customizar Toolbox
Quiz
Toolbox Icon: QuizIcon Class: Quiz

Root Class: QuizGame

Hint (Idem) Somente estes dois pois:

QuizGame: o prprio QuizLanguageDiagram Choice: tem um mapeamento dentro do QuizShape

Os elementos da toolbox no so apenas conceitos, h relacionamentos:

Add New Connection Tool Name: HintLink Toolbox Icon: HintLinkIcon ConnectionBuilder: HintReferencesQuizzesBuilder

Add New Element Tool

Relacionamento entre duas quizzes: idem (name QuizLink) SALVAR o DslDefinition.dsl sem erros

Testando a DSL

Ctrl + F5 (ou acesse a opo Debug>Start Without Debugging)

Validadores Semnticos
A definio de uma DSL
Conceitos Relacionamentos Especificao de seu comportamento grfico Regras de negcio, dependendo do domnio modelado. EX:
qualquer texto da pergunta de uma quiz precisa terminar ou com o caractere de interrogao (?) ou com o caractere de dois pontos (:).

Adicionando Validadores
Adicionar ao projeto Dsl, uma classe parcial

Lgica da Validao
Mtodo que contm a lgica de validao. 3 Restries:
Retornar void; Possuir como parmetro um objeto do tipo ValidationContext; Possuir um atributo de mtodo do tipo ValidationMethod.
parmetro do tipo ValidationCategories (Custom, Load, Menu, Open e Save)

Habilitar Validaes

Testando Tudo