Diagrammi livello: linee guida

In Visual Studio Ultimate è possibile descrivere a grandi linee la struttura di un'applicazione e verificare che il codice sia conforme a essa mediante i diagrammi livello. Per verificare la coerenza del codice con la progettazione, è possibile includere nel processo di compilazione la convalida dei livelli.

Analogamente a un diagramma dell'architettura tradizionale, un diagramma livello mostra le unità funzionali o i componenti principali della progettazione e le relative interdipendenze. Ogni nodo del diagramma, denominato livello, rappresenta un gruppo logico di spazi dei nomi, progetti o altri elementi. È possibile disegnare le dipendenze che devono esistere nella progettazione. Diversamente da un diagramma dell'architettura tradizionale, è possibile verificare che le dipendenze effettive nel codice sorgente siano conformi alle dipendenze specificate. Includendo la convalida nel normale processo di compilazione in Team Foundation Server, è possibile assicurarsi che il codice del programma sia sempre conforme all'architettura del sistema tramite modifiche future.

Per informazioni sugli elementi dei diagrammi livello e le relative proprietà, vedere Diagrammi livello: riferimento.

Progettazione o aggiornamento dell'applicazione utilizzando diagrammi livello

Nei passaggi seguenti vengono forniti cenni preliminari sull'utilizzo di diagrammi livello all'interno del processo di sviluppo. Nelle sezioni successive di questo argomento ciascun passaggio verrà descritto in modo dettagliato. Se si sviluppa una nuova progettazione, omettere i passaggi che si riferiscono al codice esistente.

1. Creare un diagramma livello per l'intera applicazione o per un livello di essa.

2. Definire i livelli per rappresentare le aree o i componenti funzionali primari dell'applicazione. Assegnare un nome a questi livelli in base alla funzione, ad esempio, "Presentazione" o "Servizi". Se si dispone di una soluzione Visual Studio, è possibile associare ogni livello a un insieme di elementi, ad esempio progetti, spazi dei nomi, file e così via.

3. Individuare le dipendenze esistenti tra i livelli.

4. Modificare i livelli e le dipendenze per mostrare la progettazione aggiornata che si desidera venga riflessa nel codice.

5. Progettare le nuove aree dell'applicazione creando livelli per rappresentare i componenti o i blocchi di architettura principali e definendo le dipendenze in modo da mostrare come ogni livello utilizza gli altri.

6. Modificare il layout e l'aspetto del diagramma per consentire di discuterlo con i colleghi.

7. Convalidare il codice rispetto al diagramma livello per evidenziare i conflitti tra il codice e l'architettura richiesta.

8. Aggiornare il codice per conformità alla nuova architettura. Sviluppare in maniera iterativa ed effettuare il refactoring del codice fino a che la convalida non illustri i conflitti.

9. Includere la convalida dei livelli nel processo di compilazione per assicurarsi che il codice sia sempre conforme alla progettazione.

Creare un diagramma livello

È necessario che il diagramma livello venga creato all'interno di un progetto di modello. È possibile aggiungere un nuovo diagramma livello a un progetto di modello esistente o creare un nuovo progetto di modello nella soluzione per il nuovo diagramma livello.

Per aggiungere un nuovo diagramma livello a un progetto di modello

1. Scegliere Nuovo diagramma dal menu Architettura.

2. In Modelli fare clic su Diagramma livello.

3. Assegnare un nome al diagramma

4. In Aggiungi a progetto di modello individuare e selezionare un progetto di modello esistente nella soluzione.

   - oppure -

   Fare clic su Crea nuovo progetto di modello per aggiungere un nuovo progetto di modello alla soluzione.

   Nota

   È necessario che il diagramma livello sia presente all'interno di un progetto di modello. È tuttavia possibile collegarlo a elementi esistenti in qualsiasi punto della soluzione.

È anche possibile copiare un diagramma livello esistente all'interno dello stesso progetto di modello.

Per copiare un diagramma livello, attenersi alla seguente procedura:

Per copiare un diagramma livello esistente

1. Aggiungere un nuovo diagramma livello al progetto di modello.

2. Copiare gli elementi dal diagramma livello di origine al nuovo diagramma livello.

Definire i livelli per rappresentare aree o componenti funzionali

I livelli rappresentano gruppi logici di elementi, quali progetti, file di codice, spazi dei nomi, classi e metodi. È possibile creare livelli dagli elementi della soluzione di Visual Studio o allegate specifiche o piani a un livello collegando documenti, ad esempio file di Word o presentazioni di PowerPoint. Ogni livello viene visualizzato come un rettangolo nel diagramma e indica il numero di elementi ad esso collegati. Un livello può contenere livelli annidati che descrivono attività più granulari.

Come regola generale, assegnare un nome a questi livelli in base alla funzione, ad esempio, "Presentazione" o "Servizi". Se gli elementi sono strettamente interdipendenti, posizionarli nello stesso livello. Se è possibile aggiornare gli elementi separatamente o utilizzarli in applicazioni separate, posizionarli in livelli diversi. Per informazioni sui modelli di livello, visitare il sito Web relativo ai modelli e alle procedure all'indirizzo https://go.microsoft.com/fwlink/?LinkId=145794.

Quando si aggiorna un'applicazione non conosciuta, è possibile utilizzare i grafici delle dipendenze per facilitare l'esplorazione e la comprensione del codice. Questi grafici agevolano l'individuazione di cluster e dipendenze nel codice. È inoltre possibile utilizzare Esplora architettura per esaminare spazi dei nomi e classi che spesso corrispondono correttamente ai livelli esistenti. In questo modo è più semplice assegnare gli elementi ai livelli. È quindi possibile utilizzare diagrammi livello per aggiornare il codice.

Per ulteriori informazioni, vedere i seguenti argomenti:

• Procedura: esplorare il codice con grafici di dipendenze

• Procedura: trovare codice tramite Esplora architettura

Per creare livelli, utilizzare le attività descritte di seguito:

Per	Eseguire questi passaggi
Creare un livello per un solo elemento	Trascinare l'elemento nel diagramma livello da una qualsiasi delle origini seguenti: Esplora soluzioni Ad esempio, è possibile trascinare file o progetti. Esplora architettura Ad esempio, è possibile trascinare spazi dei nomi, classi o metodi. Per ulteriori informazioni, vedere Procedura: trovare codice tramite Esplora architettura. Grafici delle dipendenze Per ulteriori informazioni, vedere Procedura: generare grafici di dipendenze per il codice .NET. Nel diagramma viene visualizzato un livello collegato all'elemento. Rinominare il livello per riflettere le responsabilità del codice o degli elementi associati.
Creare un singolo livello per tutti gli elementi selezionati	Trascinare contemporaneamente tutti gli elementi selezionati nel diagramma. Sul diagramma viene visualizzato un livello collegato all'intero gruppo di elementi.
Creare un livello per ogni elemento selezionato	Tenere premuto il tasto MAIUSC mentre si trascinano contemporaneamente tutti gli elementi nel diagramma livello. Nota Se si utilizza MAIUSC per selezionare un intervallo di elementi, rilasciare il tasto dopo avere selezionato gli elementi.Premerlo e tenerlo premuto nuovamente quando si trascinano gli elementi nel diagramma. Sul diagramma di ogni elemento viene visualizzato un livello collegato all'elemento.
Aggiungere un elemento a un livello	Trascinare l'elemento nel livello.
Creare un nuovo livello non collegato	In Casella degli strumenti espandere la sezione Diagramma livello, quindi trascinare un Livello nel diagramma livello. Per aggiungere più livelli, fare doppio clic sullo strumento. Una volta completata l'operazione, fare clic sullo strumento Puntatore o premere ESC. - oppure - Fare clic con il pulsante destro del mouse sul diagramma livello, scegliere Aggiungi, quindi fare clic su Livello. È possibile, ad esempio, eseguire questa operazione per rappresentare una parte dell'applicazione che non si è ancora iniziato a sviluppare. È un'operazione utile per creare il codice segnaposto per tali livelli nella fase iniziale.
Creare livelli annidati	Trascinare un livello esistente in un altro livello. - oppure - Fare clic con il pulsante destro del mouse su un livello, scegliere Aggiungi, quindi fare clic su Livello.
Creare un nuovo livello contenente due o più livelli esistenti	Selezionare i livelli, fare clic con il pulsante destro del mouse su un livello selezionato, quindi scegliere Gruppo.
Modificare il colore di un livello	Impostare la proprietà Colore del livello sul colore desiderato.
Specificare che gli elementi associati a un livello non possono dipendere dagli spazi dei nomi specificati	Digitare gli spazi dei nomi nella proprietà Forbidden Namespace Dependencies del livello. Utilizzare un punto e virgola (;) per separare gli spazi dei nomi.
Specificare che gli elementi associati a un livello non devono appartenere agli spazi dei nomi specificati	Digitare gli spazi dei nomi nella proprietà Forbidden Namespaces del livello. Utilizzare un punto e virgola (;) per separare gli spazi dei nomi.
Specificare che gli elementi associati a un livello non devono appartenere a uno degli spazi dei nomi specificati	Digitare lo spazio dei nomi nella proprietà Required Namespaces del livello. Utilizzare un punto e virgola (;) per separare gli spazi dei nomi.

Gestire collegamenti tra livelli ed elementi

1. Nel diagramma livello fare clic con il pulsante destro del mouse su un livello, quindi scegliere Visualizza collegamenti.

   Gli elementi collegati al livello selezionato sono visualizzati in Esplora livello. Per vedere tutti gli elementi collegati ai livelli nel diagramma, fare clic sul diagramma.

2. Utilizzare le seguenti attività per gestire tali collegamenti:

   Per	In Esplora livello
   Eliminare il collegamento tra il livello e un elemento	Fare clic con il pulsante destro del mouse sul collegamento dell'elemento, quindi scegliere Elimina.
   Spostare il collegamento da un livello a un altro	Trascinare il collegamento dell'elemento in un livello esistente del diagramma. - oppure - Fare clic con il pulsante destro del mouse sul collegamento dell'elemento, quindi scegliere Taglia. Nel diagramma livello fare clic con il pulsante destro del mouse sul livello, quindi scegliere Incolla.
   Copiare il collegamento da un livello a un altro	Fare clic con il pulsante destro del mouse sul collegamento dell'elemento, quindi scegliere Copia. Nel diagramma livello, fare clic con il pulsante destro del mouse sul livello, quindi scegliere Incolla.
   Creare un nuovo livello da un collegamento dell'elemento esistente	Trascinare il collegamento dell'elemento in un'area vuota del diagramma.
   Verificare che un elemento collegato supporti la convalida in base al diagramma livello.	Cercare nella colonna Convalida supporti il collegamento all'elemento. Tra gli elementi che non supportano la convalida in base a un diagramma livello sono inclusi i progetti C++, i siti Web, i documenti di Office e i file di testo normale. È possibile collegare tali elementi ai livelli, ma verranno ignorati dal processo di convalida. Gli errori di convalida non vengono visualizzati per i riferimenti a progetti o assembly collegati a livelli separati quando tra tali livelli non è presente alcuna dipendenza. Tali riferimenti non vengono considerati dipendenze a meno che il codice non li utilizzi.

Individuare le dipendenze esistenti tra livelli

Una dipendenza esiste laddove un elemento associato a un livello contiene un riferimento a un elemento associato a un altro livello. Ad esempio, una classe di un livello dichiara una variabile che ha una classe in un altro livello. È possibile individuare le dipendenze esistenti eseguendone il reverse engineering.

Per eseguire il reverse engineering di dipendenze esistenti tra livelli

• Selezionare uno o più livelli, fare clic con il pulsante destro del mouse su un livello selezionato, quindi fare clic su Genera dipendenze.

In genere vengono visualizzate alcune dipendenze che non dovrebbero esistere. È possibile modificare queste dipendenze per allinearle con la progettazione desiderata.

Modificare livelli e dipendenze per ottenere la progettazione desiderata

Per descrivere le modifiche da apportare al sistema, è possibile modificare il diagramma per riflettere la progettazione aggiornata. È inoltre possibile considerare di apportare alcune modifiche di refactoring per migliorare la struttura del codice prima di estenderlo. Per ulteriori informazioni, vedere Miglioramento della struttura del codice.

Miglioramento della struttura del codice

Le modifiche di refactoring sono miglioramenti che non influenzano il comportamento dell'applicazione, ma semplificano le operazioni future di modifica ed estensione del codice. Il codice ben strutturato presenta una progettazione che potrà essere facilmente sottoposta all'astrazione in un diagramma livello.

Ad esempio, se si crea un livello per ogni spazio dei nomi nel codice e si esegue il reverse engineering delle dipendenze, si otterrà un set minimo di dipendenze unidirezionali tra i livelli. Se si crea un diagramma più dettagliato utilizzando classi o metodi come livelli, il risultato rifletterà le stesse caratteristiche.

Se ciò non si verifica, il codice sarà più difficile da modificare in futuro e meno adatto alla convalida tramite i diagrammi livello.

Progettare nuove aree dell'applicazione

Quando si inizia a sviluppare un nuovo progetto o una nuova area di un nuovo progetto, è possibile disegnare livelli e dipendenze per consentire l'individuazione dei componenti principali prima di iniziare a sviluppare il codice.

• Visualizzare i modelli d'architettura identificabili nei diagrammi livello, se possibile. Ad esempio, un diagramma livello che descrive un'applicazione desktop potrebbe includere livelli quale Presentazione, Logica dominio e Archivio dati. Un diagramma livello che analizza una sola funzionalità all'interno di un'applicazione potrebbe disporre di livelli quale Modello, Visualizza e Controller. Per ulteriori informazioni su tali modelli, vedere Modelli e procedure: architettura dell'applicazione (informazioni in lingua inglese).

  Se si creano spesso modelli simili, creare uno strumento personalizzato. Per ulteriori informazioni, vedere Procedura: definire un elemento personalizzato della Casella degli strumenti di modellazione.

• Creare un elemento del codice per ogni livello quale uno spazio dei nomi, una classe o un componente. Grazie a questa possibilità, risulterà più semplice seguire il codice e collegare gli elementi del codice ai livelli. Non appena viene creato un elemento, connetterlo al livello adatto.

• La maggior parte delle classi e degli altri elementi non dovranno essere collegati ai livelli perché sono inclusi in elementi più grandi quali spazi dei nomi già collegati ai livelli.

• Creare un nuovo diagramma per una nuova funzionalità. In genere, uno o più diagrammi livello descrivono l'applicazione intera. Se si progetta una nuova funzionalità all'interno dell'applicazione, non eseguire modifiche o aggiunte a diagrammi esistenti. Al contrario, creare un diagramma che rifletta le nuove parti del codice. I livelli del nuovo diagramma potrebbero includere la presentazione, la logica del dominio e i livelli del database per la nuova funzionalità.

  Quando si compila l'applicazione, il codice sarà convalidato in base al diagramma complessivo e al diagramma della funzionalità più dettagliato.

Modificare il layout per la presentazione e la discussione

Per consentire l'identificazione di livelli e dipendenze o la discussione degli stessi con i membri del team, modificare l'aspetto e il layout del diagramma nei modi seguenti:

• Modificare le dimensioni, le forme e le posizioni dei livelli.

• Modificare i colori dei livelli e delle dipendenze.

  • Selezionare uno o più livelli o dipendenze, fare clic con il pulsante destro del mouse e scegliere Proprietà. Nella finestra Proprietà modificare la proprietà Colore.

Convalidare il codice in base al diagramma

Una volta modificato il diagramma, è possibile convalidarlo rispetto al codice manualmente in qualsiasi momento o automaticamente ogni volta che si esegue una compilazione locale. È possibile eseguire la convalida anche automaticamente ogni volta che si effettua la compilazione mediante Team Foundation Server.

Per ulteriori informazioni, vedere:

• Procedura: convalidare il codice .NET in base ai diagrammi livello

• Includere la convalida del livello nel processo di compilazione

Per aggiungere manualmente assembly o progetti per la convalida

1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto di modello o sulla cartella Riferimenti livello, quindi scegliere Aggiungi riferimento.

2. Nella finestra di dialogo Aggiungi riferimento selezionare gli assembly o i progetti, quindi fare clic su OK.

Per convalidare manualmente il codice da un diagramma livello aperto

1. Fare clic con il pulsante destro del mouse sulla superficie del diagramma e scegliere Convalida architettura.

   Nota

   Per impostazione predefinita, la proprietà Operazione di compilazione del file del diagramma livello (con estensione layerdiagram) viene impostata su Convalida al fine di includere il diagramma nel processo di convalida.

   Nella finestra Elenco errori vengono riportati gli eventuali errori verificatisi. Per ulteriori informazioni sugli errori di convalida, vedere Informazioni sugli errori di convalida del livello.

2. Per visualizzare l'origine di ciascun errore, fare doppio clic sull'errore nella finestra Elenco errori.

   Nota

   In Visual Studio potrebbe essere visualizzato un grafico delle dipendenze anziché l'origine dell'errore. Ciò si verifica quando il codice presenta una dipendenza in un assembly che non è specificata nel diagramma livello o quando al codice manca una dipendenza specificata nel diagramma livello. Esaminare il grafico delle dipendenze o il codice per determinare se la dipendenza deve esistere. Per ulteriori informazioni sui grafici delle dipendenze, vedere Procedura: esplorare documenti grafico e spostarsi tra di essi.

3. Per gestire gli errori, vedere Aggiornare il codice per conformità alla nuova architettura.

Per convalidare manualmente il codice dal prompt dei comandi

1. Aprire il prompt dei comandi di Visual Studio.

   Per aprire il prompt dei comandi, nel menu Start scegliere Tutti i programmi, Microsoft Visual Studio 2010, Visual Studio Tools, quindi fare clic su Prompt dei comandi di Visual Studio 2010.

2. Effettuare una delle seguenti operazioni:

   • Per convalidare il codice rispetto a un progetto di modello specifico nella soluzione, eseguire MSBuild con la seguente proprietà personalizzata.

     msbuild <FilePath+ModelProjectFileName>.modelproj
     /p:ValidateArchitecture=true
     

     - oppure -

     Passare alla cartella contenente il file di progetto di modello (con estensione modelproj) e il diagramma livello, quindi eseguire MSBuild con la seguente proprietà personalizzata.

     msbuild /p:ValidateArchitecture=true 
     

   • Per convalidare il codice rispetto a tutti i progetti di modello nella soluzione, eseguire MSBuild con la seguente proprietà personalizzata:

     msbuild <FilePath+SolutionName>.sln /p:ValidateArchitecture=true 
     

     - oppure -

     Individuare la cartella della soluzione che deve contenere un progetto di modello che a sua volta contiene un diagramma livello, quindi eseguire MSBuild con la seguente proprietà personalizzata.

     msbuild /p:ValidateArchitecture=true
     

   Verranno elencati tutti gli errori che si verificano. Per ulteriori informazioni su MSBuild, vedere MSBuild e Attività MSBuild.

Per ulteriori informazioni sugli errori di convalida, vedere Informazioni sugli errori di convalida del livello.

Per convalidare automaticamente il codice da una compilazione locale

• Utilizzare un editor di testo per aprire il file del progetto di modello (.modelproj), quindi includere la proprietà seguente:

<ValidateArchitecture>true</ValidateArchitecture>

- oppure -

1. In Esplora soluzioni, fare clic con il pulsante destro del mouse nel progetto di modello contenente il diagramma o i diagrammi livello, quindi fare clic su Proprietà.

2. Nella finestra Proprietà, impostare la proprietà Convalida architettura del progetto di modello su True.

   Il progetto di modello viene incluso nel processo di convalida.

3. In Esplora soluzioni fare clic sul file del diagramma livello (con estensione layerdiagram) che si desidera utilizzare per la convalida.

4. Nella finestra Proprietà controllare che la proprietà Azione compilazione del diagramma sia impostata su Convalida.

   Il diagramma livello viene incluso nel processo di convalida.

Per ulteriori informazioni sugli errori di convalida, vedere Informazioni sugli errori di convalida del livello. Per gestire gli errori, vedere Aggiornare il codice per conformità alla nuova architettura.

Aggiornare il codice per conformità alla nuova architettura

In genere, gli errori verranno visualizzati alla prima convalida del codice rispetto a un diagramma livello aggiornato. Le cause di questi errori possono essere molteplici:

• Un elemento viene assegnato al livello errato. In questo caso spostare l'elemento.

• Un elemento, ad esempio una classe, utilizza un'altra classe in un modo che causa conflitti con l'architettura. In questo caso, eseguire il refactoring del codice per rimuovere la dipendenza.

Per risolvere questi errori, aggiornare il codice finché non vengono più visualizzati errori durante la convalida. Si tratta generalmente di un processo iterativo.

Durante il processo di sviluppo, potrebbe essere necessario eliminare alcuni conflitti segnalati durante la convalida. Ad esempio, è possibile eliminare gli errori che sono già stati corretti o che non sono attinenti allo scenario in questione. Quando si elimina un errore, è buona norma registrare un elemento di lavoro in Team Foundation.

Per creare un elemento di lavoro per un errore di convalida

• Nella finestra Elenco errori fare clic con il pulsante destro del mouse sull'errore, scegliere Crea elemento di lavoro, quindi fare clic sul tipo di elemento di lavoro che si desidera creare.

Per gestire errori di convalida nella finestra Elenco errori utilizzare queste attività:

Includere la convalida del livello nel processo di compilazione

Per assicurarsi che le modifiche al codice apportate successivamente siano conformi ai diagrammi livello, includere la convalida dei livelli al processo di compilazione standard della soluzione. Ogni qualvolta gli altri membri del team compilano la soluzione, qualsiasi differenza tra le dipendenze del codice e del diagramma livello sarà riportata come errore di compilazione.

Per convalidare il codice durante l'esecuzione di Team Foundation Build

1. In Team Explorer, fare doppio clic sulla definizione della compilazione e scegliere Processo.

2. Sotto Parametri processo di compilazione, espandere Compilazione e digitare il seguente nel parametro MSBuild Arguments:

   /p:ValidateArchitecture=true

Per ulteriori informazioni, vedere Definire una compilazione utilizzando il modello predefinito.

Vedere anche

Attività

Procedura: creare diagrammi livello da elementi

Procedura: convalidare il codice .NET in base ai diagrammi livello

Concetti

Diagrammi livello: riferimento