Introduzione ai linguaggi specifici del dominio

In questo argomento vengono illustrati i concetti di base nella definizione e nell'utilizzo del linguaggio specifico di (DSL) dominio.

Se non si ha familiarità con DSLs, si consiglia di utilizzare DSL Tools Lab, disponibile nel sito: SDK modellare e di Visualizaton

Le operazioni che è possibile eseguire con un linguaggio specifico di dominio?

Un linguaggio specifico di dominio è una notazione, in genere grafica, progettata per essere utilizzata per un particolare scopo.Al contrario, i linguaggi quali UML sono di tipo generico.In un modello DSL, è possibile definire i tipi di elemento del modello e relative relazioni e come vengono visualizzati sullo schermo.

Quando è stato progettato un linguaggio specifico di dominio, è possibile distribuirlo come parte di un pacchetto extension progetto VSIX (Visual Studio integration extension).Gli utenti interagiscono con il modello DSL in Visual Studio:

La notazione fa parte solo di un modello DSL.Insieme all'annotazione, il pacchetto VSIX include strumenti che gli utenti possono applicare a per aiutarli per modificare e generare il materiale dai modelli.

Una delle applicazioni principali di DSLs è necessario generare codice di programma, i file di configurazione e altri elementi.Soprattutto nei progetti di grandi dimensioni e le righe di test, in cui più varianti di un prodotto verranno creati, generare molti degli aspetti variabili da DSLs possibile fornire un grande aumento nell'affidabilità e una risposta molto rapida alle modifiche dei requisiti.

Il resto di questi cenni preliminari è una procedura dettagliata che introduce le operazioni di base di creare e utilizzare un linguaggio specifico di dominio in Visual Studio.

Prerequisiti

Per definire un modello DSL, è necessario installare i componenti seguenti:

Creare una soluzione DSL

Per creare un nuovo linguaggio specifico di dominio, si crea un nuovo Visual Studio soluzione utilizzando il modello di progetto di linguaggio specifico di dominio.

Per creare una soluzione DSL

1. Scegliere Nuovo dal menu File, quindi fare clic su Progetto.

2. In tipi di progettoespandere, altri tipi di progetto nodo e scegliere Estensibilità.

3. Fare clic su Finestra di progettazione del linguaggio specifico di dominio.

   

4. in nome casella, digitare FamilyTree.Scegliere OK.

   Procedura guidata del linguaggio specifico di dominio verrà aperto e verrà visualizzato un elenco delle soluzioni DSL del modello.

   Fare clic su ogni modello per visualizzare una descrizione,

   I modelli sono i punti iniziali utili.Ciascuno di essi fornisce un computer completo DSL, che è possibile modificare alle necessità.In genere, scegliereste il modello il più vicino che si desidera creare.

5. per questa procedura dettagliata, scegliere linguaggio minimo modello.

6. Fornire un'estensione di file per il modello DSL nella pagina appropriata della procedura guidata.Si tratta di estensione che i file che contengono le istanze del linguaggio DSL utilizzeranno.

   • Scegliere un'estensione che non è associata ad alcuna applicazione nel computer, o in qualsiasi computer in cui si desidera installare il modello DSL.Ad esempio, docx e htm essere estensioni di file inaccettabili.

   • La procedura guidata per la seconda se l'estensione immessa viene utilizzata come modello DSL.Considerare l'utilizzo di un'estensione di file diversa.È inoltre possibile reimpostare istanza sperimentale di Visual Studio SDK per cancellare le finestre di progettazione controversi anziane.Fare clic su inizio, quindi Tutti i programmi, Microsoft Visual Studio 2010 SDK, strumentiquindi Reimpostare istanza sperimentale di Microsoft Visual Studio 2010.

7. Controllare le altre pagine quindi fare clic su - Fine.

   Una soluzione viene generata un'eccezione che contiene due progetti.sono denominati Dsl e DslPackage.Un file diagramma verrà aperto denominato DslDefinition.dsl.

   [!NOTA]

   La maggior parte del codice che è possibile visualizzare le cartelle dei due progetti viene generato da DslDefinition.dsl.Per questo motivo, la maggior parte delle modifiche al modello DSL ogni volta che vengono apportate in questo file.

L'interfaccia utente è ora simile all'immagine seguente.

Questa soluzione definisce un linguaggio specifico di dominio.Per ulteriori informazioni, vedere Informazioni sull'interfaccia utente degli strumenti di linguaggio specifico di dominio.

Le parti importanti della soluzione DSL

Si notino i seguenti aspetti della nuova soluzione.

• **Dsl \DslDefinition .dsl   **Si tratta del file visualizzati quando si crea una soluzione DSL.Qualsiasi codice nella soluzione viene generato dal file e la maggior parte delle modifiche apportate a una definizione di modello DSL vengono effettuate qui.Per ulteriori informazioni, vedere le operazioni con Utilizzo del diagramma di definizione DSL.

• **progetto di Dsl   **questo progetto contiene il codice che definisce il linguaggio specifico di dominio.

• progetto DslPackage   Questo progetto contiene codice che consente le istanze del linguaggio DSL da aprire e modificare in Visual Studio.

Eseguire il modello DSL

È possibile eseguire la soluzione DSL non appena viene creato.Successivamente, sarà possibile modificare gradualmente la definizione di modello DSL, eseguendo nuovamente la soluzione dopo ogni modifica.

Per sperimentare il modello DSL

1. Fare clic su Trasformazione di tutti i modelli nella barra degli strumenti di Esplora soluzioni.Si rigenera la maggior parte del codice sorgente da DslDefinition.dsl.

   [!NOTA]

   Ogni volta che si modifica DslDefinition.dsl, è necessario fare clic su Trasformazione di tutti i modelli prima di ricompilare la soluzione.È possibile automatizzare questo passaggio.Per ulteriori informazioni, vedere Procedura: automatizzare la trasformazione di tutti i modelli.

2. Premere F5, o su debug menu, fare clic su Avviare il debug.

   Le compilazioni DSL e viene installato nell'istanza sperimentale di Visual Studio.

   Verrà avviata un'istanza sperimentale di Visual Studio.L'istanza sperimentale accetta le impostazioni da un sottoalbero separato del Registro di sistema, dove Visual Studio le estensioni vengono registrate per eseguire il debug.istanze normali di Visual Studio non avere accesso alle estensioni registrate in.

3. Nell'istanza sperimentale di Visual Studio, aprire il file di modello denominato test da Esplora soluzioni.

   - oppure -

   Fare clic con il pulsante destro del mouse sul progetto di debug, quindi aggiungerequindi scegliere elemento.in aggiungere l'elemento la finestra di dialogo, selezionare il tipo di file del modello DSL.

   Il file di modello viene aperto come diagramma vuoto.

   La casella degli strumenti verrà aperto e verranno visualizzati gli strumenti appropriati al tipo di diagramma.

4. Utilizzare gli strumenti per creare forme e i connettori nel diagramma.

   1. Per creare forme, trascinare lo strumento di esempio di forma del diagramma.

   2. Per connettere due forme, fare clic sullo strumento di esempio del connettore, fare clic sulla prima forma quindi fare clic sulla seconda forma.

5. Fare clic sulle etichette delle forme per modificarli.

lo sperimentale Visual Studio sarà simile al seguente:

il contenuto di un modello

Il contenuto di un file che è un'istanza di un modello DSL viene chiamato a modello.il modello contiene modelloelementi e collegamenti tra gli elementi.La definizione di modello DSL specifica il tipo di elementi del modello e collegamenti possono essere presente nel modello.Ad esempio, in un modello DSL creato dal modello minimo di linguaggio, esiste un tipo di elemento del modello e un tipo di collegamento.

La definizione di modello DSL possibile specificare come il modello viene visualizzato in un diagramma.È possibile scegliere tra diversi stili delle forme e i connettori.È possibile specificare che alcune forme vengono visualizzati in altre forme.

È possibile visualizzare un modello in una struttura ad albero in Esplora risorse visualizzazione durante la modifica di un modello.Quando si aggiungono forme nel diagramma, gli elementi del modello vengono visualizzati anche nell'esploratore.In esplora modelli scegliere da può essere utilizzato anche se non esiste alcun diagramma.

Se non è possibile visualizzare Esplora il debug dell'istanza di Visual Studioin, visualizzazione il menu a altre finestrequindi scegliere <Il linguaggio>  Esplora risorse.

L'API del linguaggio DSL

Il modello DSL genera un'api che consente di leggere e aggiornare i modelli che sono istanze del linguaggio DSL.Un'applicazione API è necessario generare i file di testo da un modello.Per ulteriori informazioni, vedere Generazione di codice in fase di progettazione tramite modelli di testo T4.

Nella soluzione di debug, aprire i file di modello con estensione “tt„.In questi esempi viene mostrato come è possibile generare testo dai modelli e che consentono di controllare l'API del linguaggio DSL.Uno degli esempi è scritta Visual Basic, l'altro in Visual C#.

In ogni file modello è il file generato da.Espandere il file modello in Esplora soluzioni e aprire il file generato.

Il file modello contiene un breve segmento di codice in cui sono elencati tutti gli elementi del modello.

il file generato contiene il risultato.

Quando si modifica un file di modello, verranno visualizzate le modifiche corrispondenti nei file generati dopo aver rigenerate i file.

Per rigenerare file di testo dopo aver modificato il file di modello

1. Nell'istanza sperimentale di Visual Studio, salvare il file modello.

2. Assicurarsi che il parametro del nome file in ogni file .tt faccia riferimento al file di modello utilizzato per gli esperimenti.Salvare il file .tt.

3. Fare clic su Trasformazione di tutti i modelli nella barra degli strumenti di Esplora soluzioni.

   - oppure -

   Fare clic con il pulsante destro del mouse sui modelli che si desidera rigenerare quindi fare clic su eseguire lo strumento personalizzato.

È possibile aggiungere qualsiasi numero di file modello di testo a un progetto.ogni modello genera un file di risultati.

[!NOTA]

Quando si modifica la definizione di modello DSL, il codice del modello di testo di esempio non verrà eseguito, a meno che lo aggiornare.

Per ulteriori informazioni, vedere Generazione di codice da un linguaggio specifico di dominio e Scrittura di codice per personalizzare un linguaggio specifico di dominio.

Personalizzare il modello DSL

Quando si desidera modificare la definizione di modello DSL, chiudere l'istanza sperimentale e aggiornare la definizione principalmente Visual Studio istanza.

[!NOTA]

Dopo aver modificato la definizione di modello DSL, è possibile perdere le informazioni nei modelli di test create tramite versioni precedenti.Ad esempio, la soluzione di debug contiene un file denominato esempio, che contiene alcune forme e i connettori.Dopo aver iniziare a compilare la definizione di modello DSL, non saranno visibili e verranno persi salvare il file.

È possibile eseguire una vasta gamma delle estensioni al modello DSL.Negli esempi forniranno un'impressione delle possibilità.

Dopo ogni modifica, salvare la definizione DSL, fare clic su Trasformazione di tutti i modelli in Esplora soluzioniquindi premere F5 per sperimentare il modello DSL modificato.

rinominare i tipi e gli strumenti

rinominare le classi di dominio e le relazioni esistenti.Ad esempio, a partire da una definizione di Dsl creata dal modello minimo di linguaggio, è possibile eseguire le seguenti operazioni di ridenominazione, utilizzare il modello DSL rappresentare strutture ad albero genealogici.

Per rinominare le classi di dominio, le relazioni e gli strumenti

1. Nel diagramma di DslDefinition, rinominare ExampleModel a FamilyTreeModel, ExampleElement all'utente, alla destinazione a padre e all'origine agli elementi figlio.È possibile fare clic su ogni etichetta per modificarla.

   

2. Rinominare gli strumenti del connettore e dell'elemento.

   1. Aprire la finestra di esplorazione DSL facendo clic sulla scheda in Esplora soluzioni.Se non è visibile, scegliere visualizzazione il menu a altre finestre quindi scegliere DSL Esplora Risorse.Il modello DSL Esplora Risorse è visibile solo quando il diagramma della definizione di modello DSL è la finestra attiva.

   2. Aprire la Finestra Proprietà e inserirlo in modo da poter visualizzare il linguaggio DSL Esplora Risorse e proprietà contemporaneamente.

   3. Nel modello DSL Esplora Soluzioni, espandere editor, Schede della casella degli strumenti, <il modello DSL> quindi strumenti.

   4. Scegliere ExampleElement.Si tratta dell'elemento della casella degli strumenti utilizzato per creare elementi.

   5. Nella Finestra Proprietà, impostare nome proprietà alla persona.

      Si noti che Barra del titolo la proprietà cambia anche.

   6. Analogamente, modificare il nome dello strumento di ExampleConnector a ParentLink.alterare Barra del titolo proprietà in modo che non sia una copia della proprietà name.Ad esempio, immettere il collegamento padre.

3. Ricompilare il modello DSL.

   1. Salvare il file di definizione DSL.

   2. Fare clic su Trasformazione di tutti i modelli nella barra degli strumenti di Esplora soluzioni

   3. Premere F5.Attendere fino all'istanza sperimentale di Visual Studio verrà visualizzata la.

4. Nella soluzione di debug nell'istanza sperimentale di Visual Studio, aprire un file di modello di test.Trascinare gli elementi nella casella degli strumenti.Si noti che le didascalie dello strumento e i nomi del tipo nel modello DSL Esplora Risorse sono stati modificati.

5. Salvare il file modello.

6. Aprire un file .tt e le occorrenze di sostituzione del tipo e i nomi delle proprietà obsoleti con i nuovi nomi.

7. Assicurarsi che il nome file specificato nel file .tt specifica il modello di test.

8. Salvare il file .tt.Aprire il file generato per visualizzare il risultato di eseguire il codice nel file .tt.Verificare che sia corretto.

Aggiungere le proprietà di dominio alle classi

Aggiungere proprietà a una classe di dominio, ad esempio per rappresentare gli anni di nascita-e-morte di una persona.

Per rendere le nuove proprietà visibili nel diagramma, è necessario aggiungere elementi Decorator la forma che visualizza l'elemento del modello.È inoltre necessario eseguire il mapping delle proprietà agli elementi Decorator.

Per aggiungere proprietà e visualizzare

1. aggiungere le proprietà.

   1. Nel diagramma della definizione di modello DSL, fare clic con il pulsante destro del mouse sulla classe di dominio person, quindi aggiungerequindi scegliere Proprietà del dominio.

   2. digitare un elenco di nuovi nomi proprietà, come nascita-e-morte.stampa Immettere dopo ogni oggetto.

2. Aggiungere gli elementi Decorator visualizzate le proprietà della forma.

   1. Dopo la riga grigia che si estende dalla classe di dominio person fino a lato del diagramma.Si tratta di un mapping dell'elemento del diagramma.Collega la classe di dominio a una classe di forma.

   2. Fare clic con il pulsante destro del mouse sulla classe di formato, quindi aggiungerequindi scegliere Il testo all'elemento Decorator.

   3. Aggiungere due elementi Decorator con nomi quali BirthDecorator e DeathDecorator.

   4. Selezionare ogni nuovo elemento Decorator, quindi nella Finestra Proprietà impostare posizionare campo.In questo modo è possibile determinare dove il valore della proprietà del dominio verrà visualizzato nella forma.Ad esempio, set InnerBottomLeft e InnerBottomRight.

      

3. Eseguire il mapping degli elementi Decorator alle proprietà.

   1. Aprire la finestra dettagli DSL.È in genere in una scheda accanto alla finestra di output.Se non è visibile, scegliere visualizzazione menu, quindi altre finestrequindi scegliere Dettagli DSL.

   2. Nel diagramma della definizione di modello DSL, fare clic sulla linea che collega la classe di dominio della persona alla classe della forma.

   3. in Dettagli DSLin, Mapping dell'elemento Decorator la scheda, fare clic sulla casella di controllo in un elemento Decorator non mappato.in Proprietà diselezionare la proprietà, il dominio a cui si desidera eseguire il mapping.Ad esempio, corrisponde BirthDecorator di nascita.

4. Salvare il modello DSL, fare clic sulla trasformazione tutti i modelli e premere F5.

5. In un diagramma del modello di esempio, verificare che sia possibile ora fare clic sulle posizioni scelto e valori di tipo in essi.Inoltre, quando si seleziona una forma person, nella Finestra Proprietà vengono visualizzate la nuova nascita-e-morte delle proprietà.

6. In un file .tt, è possibile aggiungere il codice che ottiene le proprietà di ogni persona.

Definire nuove classi

È possibile aggiungere classi di dominio e le relazioni in un modello.Ad esempio, è possibile creare una nuova classe per rappresentare le città e una nuova relazione per rappresentare che una persona dispone di vissuto in una città.

Per rendere i diversi tipi distinti in un diagramma di modello, è possibile eseguire il mapping delle classi di dominio per diversi tipi di forme, o alle forme con diversi geometria e colori.

Per aggiungere e viene visualizzata una nuova classe di dominio

1. Aggiungere una classe di dominio e impostarla come figlio della radice del modello.

   1. Nel diagramma della definizione di modello DSL, fare clic su incorporare relazione lo strumento, fare clic sulla classe radice FamilyTreeModel quindi fare clic su una parte vuota del diagramma.

      Una nuova classe di dominio viene visualizzato, che si connette al FamilyTreeModel con una relazione che utilizza.

      Impostare il nome, ad esempio città.

      [!NOTA]

      Ogni classe di dominio a meno che la radice del modello deve essere il database di destinazione di almeno una relazione che utilizza, o ereditare da una classe che rappresenta la destinazione di un incorporare.Per questo motivo, è spesso utile creare una classe di dominio utilizzando lo strumento l'inserimento di una relazione.

   2. Aggiungere una proprietà di dominio alla nuova classe, ad esempio nome.

2. Aggiungere una relazione di riferimento tra la persona e la città.

   1. Fare clic su Fare riferimento alla relazione lo strumento, utente di scegliere e quindi la città.

      

      [!NOTA]

      Le relazioni di riferimento rappresentano i riferimenti incrociati da una parte della struttura ad albero di modello a un altro.

3. Aggiungere una forma per rappresentare le città nei diagrammi di modellazione.

   1. Trascinare un oggetto Forma della geometria dalla casella degli strumenti nel diagramma e rinominarlo, ad esempio TownShape.

   2. Nella Finestra Proprietà, impostare i campi dell'aspetto della nuova forma, quale il colore di riempimento e la geometria.

   3. Aggiungere un elemento Decorator per visualizzare il nome della città e rinominarlo NameDecorator.Impostare la relativa proprietà Position.

4. Eseguire il mapping della classe di dominio della città al TownShape.

   1. Fare clic su Mapping dell'elemento del diagramma lo strumento, quindi fare clic sulla classe di dominio della città e quindi la classe di forma di TownShape.

   2. in Mapping dell'elemento Decorator scheda di Dettagli DSL finestra con il connettore di mapping selezionato, il controllo NameDecorator e impostare Proprietà di per denominare.

5. Creare un connettore per visualizzare la relazione tra la persona e le città.

   1. Trascinare un connettore dalla casella degli strumenti nel diagramma.Rinominarlo e impostare l'aspetto delle proprietà.

   2. utilizzare Mapping dell'elemento del diagramma strumento per collegare il nuovo connettore alla relazione tra la persona e la città.

      

6. Creare uno strumento dell'elemento per la creazione di una città nuova.

   1. in DSL Esplora Risorseespandere, editor quindi Schede della casella degli strumenti.

   2. Fare clic con il pulsante destro del mouse <il modello DSL> quindi scegliere Aggiungere il nuovo strumento dell'elemento.

   3. impostare nome la proprietà del nuovo strumento e imposta il proprio classe proprietà alla città.

   4. impostare L'icona casella degli strumenti proprietà.Fare clic su [...] e in nome file il campo, selezionare un file di icona.

7. Creare uno strumento del connettore per la creazione del collegamento tra le città e le persone.

   1. Fare clic con il pulsante destro del mouse <il modello DSL> quindi scegliere Aggiungere il nuovo strumento del connettore.

   2. Impostare la proprietà del nome del nuovo strumento.

   3. in ConnectionBuilder la proprietà, selezionare il generatore che contiene il nome della relazione di Persona-Città.

   4. impostare L'icona casella degli strumenti.

8. Salvare la definizione DSL, fare clic su Trasformazione di tutti i modelliquindi premere F5.

9. Nell'istanza sperimentale di Visual Studio, aprire un file di modello di test.Utilizzare i nuovi strumenti per creare le città e collegamenti tra le città e le persone.Si noti che è possibile creare solo i collegamenti tra i tipi corretti di elementi.

10. Creare il codice che elenca la città in cui ogni persona attive.I modelli di testo sono uno dei punti in cui è possibile eseguire tale codice.Ad esempio, è possibile modificare il file esistente di Sample.tt nella soluzione di debug in modo che contenga il seguente codice:

    <#@ template inherits="Microsoft.VisualStudio.TextTemplating.VSHost.ModelingTextTransformation" debug="true" #>
    <#@ output extension=".txt" #>
    <#@ FamilyTree processor="FamilyTreeDirectiveProcessor" requires="fileName='Sample.ftree'" #>
    
    <#
      foreach (Person person in this.FamilyTreeModel.People)
      {
    #>
        <#= person.Name #><#if (person.Town != null) {#> of <#= person.Town.Name #> <#}#>
    
    <#
          foreach (Person child in person.Children)
      {
    #>
                <#= child.Name #>
    <#
      }
      }
    #>
    

    Quando si salva il file di *.tt, verrà creato un file sussidiario che contiene l'elenco di persone e le residenze.Per ulteriori informazioni, vedere Generazione di codice da un linguaggio specifico di dominio.

Convalida e controlli

È possibile compilare questo modello DSL ulteriormente aggiungendo i vincoli di convalida.Questi vincoli sono metodi che è possibile definire, che garantiscono che il modello sia in uno stato corretto.Ad esempio, è possibile definire un vincolo per assicurarsi che la data di nascita di un figlio è successiva a quella dei rispettivi padri.La funzionalità di convalida viene visualizzato un avviso se l'utente DSL tenta di salvare un modello che interrompe tutti i vincoli.Per ulteriori informazioni, vedere Convalida in un linguaggio specifico di dominio.

È inoltre possibile definire i comandi di menu che l'utente può richiamare.I controlli possono modificare il modello.È possibile interagire con altri modelli in Visual Studio e con le risorse esterne.Per ulteriori informazioni, vedere Procedura: modificare un comando di menu standard in un linguaggio specifico di dominio.

Implementare il modello DSL

Per consentire ad altri utenti del linguaggio specifico di dominio, distribuire un oggetto Visual Studio File extension (VSIX).Ciò viene creato quando si compila la soluzione DSL.

Individuare il file .vsix nella cartella bin della soluzione.Copiarlo nel computer in cui si desidera installare l'estensione.In tale computer, fare doppio clic sul file VSIX.Il modello DSL può essere utilizzato in tutte le istanze di Visual Studio nel computer.

È possibile seguire la stessa procedura per installare il modello DSL su per contenere il computer in modo da non dover utilizzare l'istanza sperimentale di Visual Studio.

Per ulteriori informazioni, vedere Distribuzione di soluzioni per un linguaggio specifico di dominio.

rimuovere DSLs sperimentale obsoleto

Se è stato creato DSLs sperimentale che si desidera, è possibile rimuoverli dal computer reimpostando Visual Studio istanza sperimentale.

In questo modo dal computer qualsiasi DSLs sperimentale e altre funzioni Visual Studio estensioni.Queste sono estensioni che sono state eseguite in modalità di debug.

Questa procedura non rimuove DSLs o altro Visual Studio estensioni con sono state installate eseguendo il file VSIX.

Per reimpostare istanza sperimentale di Visual Studio

1. Fare clic su inizio, quindi Tutti i programmi, Microsoft Visual Studio 2010 SDK, strumentiquindi Reimpostare istanza sperimentale di Microsoft Visual Studio 2010.

2. ricompilare tutto il DSLs sperimentale o altro sperimentale Visual Studio estensioni che si desidera comunque utilizzare.

Vedere anche

Concetti

Informazioni su modelli, classi e relazioni

Procedura: definire un linguaggio specifico di dominio

Altre risorse

SDK modellare e di Visualizaton