Tworzenie diagramów warstwy na podstawie kodu

Aby zwizualizować logiczną architekturę wysokiego poziomu systemu oprogramowania, utwórz diagram warstwowy za pomocą programu Visual Studio Ultimate.Aby upewnić się, że kod pozostaje zgodny z tym projektem, przeprowadź walidację kodu przy użyciu diagramu warstwowego w programie Visual Studio Ultimate lub Visual Studio Premium.Możesz tworzyć diagramy warstwowe do projektów programu Visual C# .NET i Visual Basic .NET.

Co chcesz zrobić?

• Dowiedz się więcej o diagramach warstwowych

• Tworzenie diagramu warstwowego

• Tworzenie warstw z artefaktów

• Zarządzanie połączeniami między warstwami i artefaktami

• Odtwarzanie istniejących zależności

• Edytowanie warstw i zależności w celu przedstawienia zamierzonego projektu

• Zmienianie sposobu wyświetlania elementów na diagramie

Dowiedz się więcej o diagramach warstwowych

Diagram warstwowy pozwala organizować elementy rozwiązania Visual Studio w logiczne, abstrakcyjne grupy o nazwie warstwy.Można użyć warstw do opisania głównych zadań wykonywanych przez te artefakty lub główne składniki systemu.Każda warstwa może zawierać innych warstwy opisujące bardziej szczegółowe zadania.Możesz również określić zamierzone lub istniejące zależności między warstwami.Te zależności, które są reprezentowane jako strzałki, wskazują, które warstwy mogą używać lub obecnie używają funkcje reprezentowane przez inne warstwy.Aby utrzymać kontrolę architektury kodu, wyświetl zamierzone zależności na diagramie i przeprowadź walidację kodu na podstawie diagramu.

Zobacz:

• Wideo Channel 9: Projektowanie i walidacja architektury za pomocą diagramów warstwowych

• Diagramy warstw: Odwołanie

• Diagramy warstw: Zalecenia

• Walidacja kodu przy użyciu diagramów warstwy

• Wzorce & praktyki dotyczące witryn sieci Web

Porada

Podczas tworzenia diagramu warstwowego możesz rozważyć utworzenie wykresów zależność ułatwiających analizowanie i zrozumienie kodu.Te wykresy mogą być pomocne w odkrywaniu klastrów, wzorców, naturalnych warstw i zależności w kodzie.Ułatwia to przypisywanie artefaktów do warstw.Możesz także użyć Eksploratora architektury do zbadania przestrzeni nazw i klas, które często dobrze odpowiadają istniejącym warstwom.Możesz następnie użyć diagramów warstwowych, aby ułatwić aktualizowanie kodu. Zobacz: Mapowanie zależności w kodzie na wykresach zależności Wyszukiwanie kodu za pomocą narzędzia Architecture Explorer

Tworzenie diagramu warstwowego

Przed utworzeniem diagramu warstwowego upewnij się, że rozwiązanie ma projektu modelowania.Zobacz Tworzenie projektów i diagramów modelowania UML.

Ważne

Nie dodawaj, nie przeciągaj ani nie kopiuj istniejącego diagramu warstwowego z projektu modelowania do innego projektu modelowania ani do innej lokalizacji w rozwiązaniu.Pozwala to zachować odniesienia z oryginalnego diagramu nawet po zmianie diagramu.Mogłoby to także uniemożliwić prawidłowe działanie walidacji warstwy i spowodować wystąpienie innych problemów, takich jak brakujące elementy lub inne błędy, przy próbie otwarcia diagramu. Zamiast tego dodaj nowy diagram warstwowy do projektu modelowania.Skopiuj elementy z diagramu źródłowego do nowego diagramu.Zapisz zarówno projekt modelowania, jak i nowy diagram warstwowy.

Aby dodać nowy diagram warstwowy do projektu modelowania

1. W menu Architektura wybierz Nowy Diagram.

2. W obszarze Szablony wybierz Diagram warstwowy.

3. Nadaj nazwę diagramowi.

4. W sekcji Dodaj do projektu modelowaniaodszukaj i wybierz istniejący projekt modelowania w rozwiązaniu.

   —lub—

   Wybierz Utwórz nowy projekt modelowania, aby dodać nowy projekt modelowania do rozwiązania.

   [!UWAGA]

   Diagram warstwowy musi istnieć w projekcie modelowania.Możesz jednak połączyć elementy w innym miejscu rozwiązania.

5. Pamiętaj, aby zapisać zarówno projekt modelowania, jak i diagram warstwowy.

Tworzenie warstw z artefaktów

Warstwy możesz tworzyć z elementów rozwiązania Visual Studio, takich jak projekty, pliki kodu, przestrzenie nazw, klasy i metody.Powoduje to automatyczne tworzenie łączy między warstwami i elementami, uwzględniając je w procesie walidacji warstwy.

Możesz również połączyć warstwy z elementami, które nie obsługują walidacji, takimi jak dokumenty programu Word lub prezentacji programu PowerPoint, tak aby można było skojarzyć warstwy ze specyfikacjami lub planami.Możesz również połączyć warstwy z plikami projektów współużytkowanymi przez wiele aplikacji, ale proces walidacji nie uwzględni warstw wyświetlanych z nazwami rodzajowymi, takimi jak „Warstwa 1” i „Warstwa 2”.

Aby sprawdzić, czy połączony element obsługuje walidację, otwórz Eksplorator warstw i sprawdź właściwość Obsługuje walidację elementu.Zobacz Zarządzanie łączami do artefaktów.

Aby	Wykonaj następujące kroki
Utworzyć warstwę dla pojedynczego artefakt	Przeciągnij element do diagramu warstwowego z jednego z następujących źródeł: Eksplorator rozwiązań Możesz na przykład przeciągać pliki lub projekty. Eksplorator architektury Możesz na przykład przeciągać zestawy, pliki binarne, przestrzenie nazw, klasy lub metody.Zobacz Wyszukiwanie kodu za pomocą narzędzia Architecture Explorer. Wykresy zależności Zobacz Mapowanie zależności w kodzie na wykresach zależności. Warstwy jest wyświetlana na diagramie i jest połączona z artefaktem. Zmień nazwę warstwy, aby odzwierciedlała obowiązki skojarzonego kodu lub artefaktów. Ważne Przeciąganie plików binarnych do diagramu warstwowego nie powoduje automatycznego dodania odniesień do nich do projektu modelowania.Musisz ręcznie dodać do projektu modelowania pliki binarne, które chcesz walidować. Aby dodać pliki binarne do projektu modelowania W Eksploratorze rozwiązań otwórz menu skrótów projektu modelowania, a następnie wybierz Dodaj istniejący element. W oknie dialogowym Dodaj istniejący element poszukaj plików binarnych, zaznacz je, a następnie wybierz OK. Pliki binarne pojawią się w projekcie modelowania. W Eksploratorze rozwiązań wybierz dodany plik binarny, a następnie naciśnij F4, aby otworzyć okno Właściwości. Dla każdego pliku binarnego ustaw właściwość Akcja kompilacji na wartość Sprawdź poprawność.
Utwórz jedną warstwę dla wszystkich zaznaczonych artefaktów	Przeciągnij wszystkie artefakty do diagramu warstwowego w tym samym czasie. Warstw pojawi się na diagramie i będzie połączona z artefaktami.
Tworzenie warstwy dla każdego zaznaczonego artefaktu	Naciśnij i przytrzymaj klawisz SHIFT podczas przeciągania wszystkich artefaktów na diagram warstwowy w tym samym czasie. [!UWAGA] Jeśli używasz klawisza SHIFT do zaznaczenia zakresu elementów, zwolnij klawisz po zaznaczeniu artefaktów.Naciśnij i przytrzymaj go ponownie podczas przeciągania artefaktów do diagramu. Warstwa dla każdego artefaktu pojawia się na diagramie i jest połączona z poszczególnymi artefaktami.
Dodawanie artefaktu do warstwy	Przeciągnij artefakt do warstwy.
Tworzenie nowej niepołączonej warstwy	W Przyborniku rozwiń sekcję Diagram warstwowy, a następnie przeciągnij warstwę do diagramu warstwowego. Aby dodać wiele warstw, kliknij dwukrotnie narzędzie.Gdy skończysz, wybierz narzędzie Wskaźnik lub naciśnij klawisz ESC. - lub - Otwórz menu skrótów dla diagramu warstwowego, wybierz Dodaj, a następnie wybierz Warstwa.
Tworzenie zagnieżdżonych warstw	Przeciągnij istniejącą warstwę na inną warstwę. - lub - Otwórz menu skrótów dla warstwy, wybierz Dodaj, a następnie wybierz Warstwa.
Tworzenie nowej warstwy zawierającej dwie lub więcej istniejących warstw	Zaznacz warstwy, otwórz menu skrótów dla zaznaczenia, a następnie wybierz Grupa.
Zmienianie koloru warstwy	Ustaw jej właściwość Kolor na odpowiedni kolor.
Określanie, że artefakty skojarzone z warstwą nie mogą należeć do określonych przestrzeni nazw	Wpisz przestrzenie nazw do właściwości Zabronione przestrzenie nazw warstwy.Użyj średnika (;) do oddzielenia przestrzeni nazw.
Określanie, że artefakty skojarzone z warstwą nie mogą zależeć od określonych przestrzeni nazw	Wpisz przestrzenie nazw do właściwości Zabronione zależności przestrzeni nazw warstwy.Użyj średnika (;) do oddzielenia przestrzeni nazw.
Określanie, że artefakty skojarzone z warstwą muszą należeć do jednej z określonych przestrzeni nazw	Wpisz przestrzeń nazw do właściwości Wymagane przestrzenie nazw warstwy.Użyj średnika (;) do oddzielenia przestrzeni nazw.

Liczba na warstwie oznacza liczbę artefaktów, które są połączone z warstwą.Jednak odczytując tę liczbę, należy pamiętać, że:

• Jeśli warstwa jest połączona z artefaktem zawierającym inne artefakty, ale warstwy nie łączy się bezpośrednio z innymi artefaktami, wówczas liczba uwzględnia tylko połączony artefakt.Jednak inne artefakty są uwzględniane w analizie podczas walidacji warstwy.

  Na przykład, jeżeli warstwa jest połączona z pojedynczą przestrzenią nazw, liczba połączonych artefaktów wynosi 1, nawet jeśli przestrzeń nazw zawiera klasy.Jeśli warstwa zawiera także łącza do każdej klasy w przestrzeni nazw, liczba będzie uwzględniać połączone klasy.

• Jeśli warstwa zawiera inne warstwy, które są połączone z artefaktami, warstwa kontenerów jest także połączona z tymi artefaktami, mimo że liczba na warstwie kontenerów nie uwzględnia tych artefaktów.

Zarządzanie połączeniami między warstwami i artefaktami

1. Na diagramie warstwowym otwórz menu skrótów dla warstwy, a następnie wybierz Wyświetl łącza.

   Eksplorator warstw wyświetla łącza artefaktów dla zaznaczonej warstwy.

2. Wykonaj następujące zadania, aby zarządzać tymi łączami:

Aby	W Eksploratorze warstw
Usuwanie łącza między warstwą i artefaktem	Otwórz menu skrótów dla łącza artefaktu, a następnie wybierz Usuń.
Przenoszenie łącza z jednej warstwy na drugą	Przeciągnij łącze artefaktu do istniejącej warstwy na diagramie. - lub - Otwórz menu skrótów dla łącza artefaktu, a następnie wybierz Wytnij. Na diagramie warstwowym otwórz menu skrótów dla warstwy, a następnie wybierz Wklej.
Kopiowanie łącza z jednej warstwy na drugą	Otwórz menu skrótów dla łącza artefaktu, a następnie wybierz Kopiuj. Na diagramie warstwowym otwórz menu skrótów dla warstwy, a następnie wybierz Wklej.
Tworzenie nowej warstwy z istniejącego łącza artefaktu	Przeciągnij łącze artefaktu do pustego obszaru na diagramie.
Sprawdź, czy połączony artefakt obsługuje walidację na podstawie diagramu warstwowego.	Spójrz na kolumnę Obsługuje walidację dla łącza artefaktu.

Odtwarzanie istniejących zależności

Zależność istnieje wszędzie tam, gdzie artefakt, który jest skojarzony z jedną warstwą zawiera odwołanie do artefaktu skojarzonego z inną warstwą.Na przykład klasa w jednej warstwie deklaruje zmienną, która zawiera klasę w innej warstwie.Możesz odtwarzać istniejące zależności dla artefaktów, które są połączone z warstwami na diagramie.

[!UWAGA]

Zależności nie mogą być odtwarzane dla niektórych rodzajów artefaktów.Na przykład nie zostaną odtworzone żadne zależności z lub do warstwy, która jest połączona z plikiem tekstowym.Aby zobaczyć, które artefakty mają zależności, które można odtworzyć, otwórz menu skrótów dla jednej lub wielu warstw, a następnie wybierz Wyświetl łącza.W Eksploratorze warstw, przeanalizuj kolumnę Obsługuje walidację.Zależności nie będą odtwarzane dla artefaktów, w których w tej kolumnie jest wyświetlana wartość Fałsz.

• Zaznacz jedną lub wiele warstw, otwórz menu skrótów dla zaznaczonej warstwy, a następnie wybierz Wygeneruj zależności.

Zazwyczaj zobaczysz niektóre zależności, które nie powinny istnieć.Możesz edytować te zależności, aby dopasować je do zamierzonego projektu.

Edytowanie warstw i zależności w celu przedstawienia zamierzonego projektu

Do opisania zmian, które planujesz wprowadzić do systemu lub zamierzonej architektury, przeprowadź edycję diagramu warstwowego:

Aby	Wykonaj następujące kroki
Zmień lub ogranicz kierunek zależności	Ustaw właściwość Kierunek.
Tworzenie nowych zależności	Użyj narzędzi Zależność i Dwukierunkowe zależności. Aby narysować wiele zależności, kliknij dwukrotnie narzędzie.Gdy skończysz, wybierz narzędzie Wskaźnik lub naciśnij klawisz ESC.
Określanie, że artefakty skojarzone z warstwą nie mogą zależeć od określonych przestrzeni nazw	Wpisz przestrzenie nazw do właściwości Zabronione zależności przestrzeni nazw warstwy.Użyj średnika (;) do oddzielenia przestrzeni nazw.
Określanie, że artefakty skojarzone z warstwą nie mogą należeć do określonych przestrzeni nazw	Wpisz przestrzenie nazw do właściwości Zabronione przestrzenie nazw warstwy.Użyj średnika (;) do oddzielenia przestrzeni nazw.
Określanie, że artefakty skojarzone z warstwą muszą należeć do jednej z określonych przestrzeni nazw	Wpisz przestrzeń nazw do właściwości Wymagane przestrzenie nazw warstwy.Użyj średnika (;) do oddzielenia przestrzeni nazw.

Zmienianie sposobu wyświetlania elementów na diagramie

Możesz zmieniać rozmiar, kształt, kolor i położenie warstw lub kolor zależności, edytując ich właściwości.

Zobacz też

Koncepcje

Tworzenie wizualizacji kodu