方法: UML モデルの検証制約を定義する

[アーティクル]
02/21/2013

Visual Studio Ultimate では、指定した条件をモデルが満たしているかどうかをテストする検証制約を定義できます。たとえば、ユーザーが継承関係のループを作成していないことを確認するための制約を定義できます。制約は、ユーザーがモデルを開くか、または保存しようとしたときに実行されるほか、手動で実行することもできます。制約が失敗した場合は、ユーザー定義のエラーメッセージがエラーウィンドウに追加されます。これらの制約を Visual Studio Integration Extension (VSIX) にパッケージ化し、他の Visual Studio Ultimate ユーザーに配布できます。

また、モデルをデータベースなどの外部リソースに照らし合わせて検証する制約も定義できます。

[!メモ]

レイヤー図と照らし合わせてプログラムコードを検証する場合は、「レイヤー図へのカスタムアーキテクチャ検証の追加」を参照してください。

要件

から派生した [Visual Studio ギャラリー]できる Visual Studio SDK。
から派生した Code Gallery の Visual Studio の Visualization and Modeling SDKできる Visual Studio の Visualization and Modeling SDK。

検証制約の適用

検証制約は、モデルを保存したとき、モデルを開いたとき、および [アーキテクチャ] メニューの [UML モデルの検証] をクリックしたときの 3 つのケースで適用されます。どのケースでも、そのケースに対して定義された制約だけが適用されますが、通常は、1 つ以上のケースに対して適用されるよう制約を定義します。

検証エラーは Visual Studio エラーウィンドウに報告されるので、エラーをダブルクリックすると、エラーが発生しているモデル要素を選択することができます。

検証の適用の詳細については、「UML モデルの検証」を参照してください。

検証拡張機能の定義

UML デザイナーの検証拡張機能を作成するには、検証制約を定義するクラスを生成し、そのクラスを Visual Studio Integration Extension (VSIX) に埋め込む必要があります。VSIX は、制約をインストールできるコンテナーとして機能します。検証拡張機能を定義する方法は 2 つあります。

**プロジェクトテンプレートを使用して検証拡張機能を独自の VSIX に生成する。**これはより簡単な方法です。検証制約を他の種類の拡張機能 (メニューコマンド、カスタムツールボックス項目、ジェスチャハンドラーなど) と組み合わせない場合は、この方法を使用します。複数の制約を 1 つのクラスで定義できます。
**検証クラスと VSIX プロジェクトを個別に生成する。**複数の種類の拡張機能を同じ VSIX に組み合わせる場合は、この方法を使用します。たとえば、メニューコマンドが特定の制約に従うモデルを必要とする場合は、そのモデルを検証メソッドとして同じ VSIX に埋め込むことができます。

検証拡張機能を独自の VSIX に生成するには

[新しいプロジェクト] ダイアログボックスの [モデリングプロジェクト] で、[検証拡張機能] をクリックします。
新しいプロジェクトで .cs ファイルを開き、クラスを変更して検証制約を実装します。

詳細については、「検証制約の実装」を参照してください。

重要

.cs ファイルに次の using ステートメントが含まれていることを確認します。

using Microsoft.VisualStudio.ArchitectureTools.Extensibility.Uml;
新しいメソッドを定義して制約を追加できます。メソッドを検証メソッドとして識別するには、最初の検証メソッドと同じように属性をタグ付ける必要があります。
F5 キーを押して制約をテストします。詳細については、「検証の実行」を参照してください。
別のコンピューターにメニューコマンドをインストールします。これを行うには、プロジェクトでビルドした bin\*\*.vsix ファイルを別のコンピューターにコピーします。詳細については、「検証制約のインストール」を参照してください。

重要
.cs ファイルに次の using ステートメントが含まれていることを確認します。 using Microsoft.VisualStudio.ArchitectureTools.Extensibility.Uml;

他の .cs ファイルを追加すると、通常は次の using ステートメントが必要になります。

using System.Collections.Generic;
using System.ComponentModel.Composition;
using System.Linq;
using Microsoft.VisualStudio.ArchitectureTools.Extensibility.Uml;
using Microsoft.VisualStudio.Modeling.Validation;
using Microsoft.VisualStudio.Uml.Classes;

代替制御が:を次に示します。

クラスライブラリプロジェクトで個別の検証制約を生成するには

クラスライブラリプロジェクトを作成し、それを既存の VSIX ソリューションに追加するか、または新規のソリューションを作成します。
1. [ファイル] メニューで、[新規]、[プロジェクト] クリックします。
2. **[インストールされているテンプレート]**の下に、Visual C# か **[Visual Basic]**を展開して、中央の列で **[クラスライブラリ]**を選択します。
ソリューションが既に 1 種類が含まれていない場合は、VSIX プロジェクトを作成する:
1. ソリューションのショートカットメニューの **[ソリューションエクスプローラー]では、追加、[新しいプロジェクト]**を選択します。
2. **[インストールされているテンプレート]**の下に、Visual C# か **[Visual Basic]**を展開し、を [機能拡張]を選択します。中央の列で、[VSIX プロジェクト] をクリックします。
VSIX プロジェクトをソリューションのスタートアッププロジェクトとして設定します。
- VSIX プロジェクトのショートカットメニューの [ソリューションエクスプローラーで、**[スタートアッププロジェクトに設定]**を選択します。
source.extension.vsixmanifestでは、**[コンテンツ]**の下に、MEF コンポーネントとしてクラスライブラリプロジェクトを追加します:
1. [メタデータ] のタブで、VSIX の名前を設定します。
2. [対象のインストール] のタブで、ターゲットとして Visual Studio Premium および Ultimate を設定します。
3. [アセット] のタブで、ダイアログボックスの新規を、選択した場合:
  
  [種類] = MEF コンポーネント
  
  [ソース] = [現在のソリューション内のプロジェクト]
  
  [プロジェクト] = 、クラスライブラリプロジェクト

検証クラスを定義するには

検証プロジェクトテンプレートから検証クラスを独自の VSIX と共に生成した場合、この手順は必要ありません。
検証クラスプロジェクトで、次の .NET アセンブリへの参照を追加します。

Microsoft.VisualStudio.Modeling.Sdk.11.0

Microsoft.VisualStudio.ArchitectureTools.Extensibility.Uml

Microsoft.VisualStudio.Uml.Interfaces

System.ComponentModel.Composition

次の例と似たコードを含むクラスライブラリプロジェクトにファイルを追加します。

各検証制約は、特定の属性でマークされているメソッド内に含まれています。このメソッドは、モデル要素の型のパラメーターを受け取ります。検証が起動されると、検証フレームワークは、パラメーター型に対応するすべてのモデル要素に対して、すべての検証メソッドを適用します。
このようなメソッドは任意のクラスおよび名前空間に配置できます。それらのメソッドをカスタマイズします。

using System.Collections.Generic;
using System.ComponentModel.Composition;
using System.Linq;
using Microsoft.VisualStudio.Modeling.Validation;
using Microsoft.VisualStudio.ArchitectureTools.Extensibility.Uml;
using Microsoft.VisualStudio.Uml.Classes;
// You might also need the other Microsoft.VisualStudio.Uml namespaces.

namespace Validation
{
  public class MyValidationExtensions
  {
    // SAMPLE VALIDATION METHOD.
    // All validation methods have the following attributes.
    [Export(typeof(System.Action<ValidationContext, object>))]
    [ValidationMethod(
       ValidationCategories.Save
     | ValidationCategories.Open
     | ValidationCategories.Menu)]
    public void ValidateClassNames
      (ValidationContext context, 
       // This type determines what elements 
       // will be validated by this method:
       IClass elementToValidate)
    {
      // A validation method should not change the model.

      List<string> attributeNames = new List<string>();
      foreach (IProperty attribute in elementToValidate.OwnedAttributes)
      {
        string name = attribute.Name;
        if (!string.IsNullOrEmpty(name) && attributeNames.Contains(name))
        {
          context.LogError(
            string.Format("Duplicate attribute name '{0}' in class {1}", name, elementToValidate.Name),
            "001", elementToValidate);
        }
        attributeNames.Add(name);
      }

    }
    // Add more validation methods for different element types.
  }
}

検証制約の実行

テストを行う場合は、検証メソッドをデバッグモードで実行します。

検証制約をテストするには

[デバッグ] のメニューの **[F5]**を、またはを選択します **[デバッグの開始]**を押します。

Visual Studio の実験用のインスタンスが開始します。

トラブルシューティング: 新しい Visual Studio が起動しない場合:
- 複数のプロジェクトがある場合は、VSIX プロジェクトがソリューションのスタートアッププロジェクトとして設定されていることを確認してください。
- 起動時またはプロジェクトのショートカットメニューのソリューションエクスプローラーで、[プロパティ]、を選択します。プロジェクトのプロパティエディターで、[デバッグ] のタブをクリックします。[外部プログラムの開始] フィールドの文字列が Visual Studio の完全なパス名であることを確認してください。通常は次のようになります。
  
  C:\Program Files\Microsoft Visual Studio 11.0\Common7\IDE\devenv.exe
実験用の Visual Studio で、モデリングプロジェクトを開くか、または生成し、モデリング図を開くか、または生成します。
前のセクションの制約のサンプルのテストを設定するには、次の手順に従います。
1. クラス図を開きます。
2. クラスを作成し、名前が同じ 2 つの属性を追加します。
図のショートカットメニュー内のどこにでも、**[検証]**を選択します。
モデル内のエラーがエラーウィンドウで報告されます。
エラー報告をダブルクリックします。この報告にある要素が画面に表示された場合は、強調表示されます。

トラブルシューティング: [検証] コマンドがメニューに表示されない場合は、次の点について確認してください。
- 検証プロジェクトは、VSIX プロジェクトの source.extensions.manifest の [アセット] のタブに MEF コンポーネントとして表示されます。
- 適切な Export 属性と ValidationMethod 属性が検証メソッドに追加されている。
- ValidationCategories.Menu が ValidationMethod 属性の引数に含まれており、論理 OR (|) を使用して他の値と共に構成される。
- すべての Import 属性と Export 属性のパラメーターが有効である。

制約の評価

検証メソッドは、適用される検証制約が true と false のどちらかであるかを判定します。true の場合、検証メソッドは何も行いません。false の場合、検証メソッドは、ValidationContext パラメーターによって提供されるメソッドを使用して、エラーを報告します。

[!メモ]

検証メソッドによってモデルが変更されることはありません。制約がいつどのような順序で実行されるかは保証されません。検証実行内の検証メソッドの連続的な実行の間で情報を渡す必要がある場合は、「複数の検証の調整」で説明されているコンテキストキャッシュを使用できます。

たとえば、すべての型 (クラス、インターフェイス、または列挙子) の名前が 3 文字以上であることを確認するには、次のメソッドを使用できます。

public void ValidateTypeName(ValidationContext context, IType type)
{
  if (!string.IsNullOrEmpty(type.Name) && type.Name.Length < 3)
  {
    context.LogError(
      string.Format("Type name {0} is too short", type.Name),
               "001", type);
   }
 }

モデルをナビゲートして読み込むために使用できるメソッドおよび型の詳細については、「UML API を使用したプログラミング」を参照してください。

検証制約のメソッドについて

それぞれの検証制約は、次の形式のメソッドで定義されます。

[Export(typeof(System.Action<ValidationContext, object>))]
 [ValidationMethod(ValidationCategories.Save 
  | ValidationCategories.Menu 
  | ValidationCategories.Open)]
public void ValidateSomething
  (ValidationContext context, IClassifier elementToValidate)
{...}

各検証メソッドの属性およびパラメーターを次に示します。

[Export(typeof(System.Action <ValidationContext, object>))]

Managed Extensibility Framework (MEF) を使用して、メソッドを検証制約として定義します。

[ValidationMethod (ValidationCategories.Menu)]

検証をいつ実行するかを指定します。複数のオプションを組み合わせる場合は、ビットごとの OR (|) を使用します。

Menu は、[検証] メニューによって呼び出されます。

Save は、モデルを保存するときに呼び出されます。

Open は、モデルを開くときに呼び出されます。Load は、モデルを保存するときに呼び出されますが、違反の場合は、モデルを再度開くことができない可能性があることをユーザーに警告します。また、読み込み時 (モデルが解析される前) にも呼び出されます。

public void ValidateSomething

(ValidationContext context,

IElement element)

IElement という 2 番目のパラメーターを、制約を適用する要素の型に置き換えます。制約メソッドは、指定された型のすべての要素に対して呼び出されます。

メソッドの名前は重要ではありません。

2 番目のパラメーターに異なる型を指定し、任意の数の検証メソッドを定義できます。検証が起動されると、パラメーター型に対応する各モデル要素に対し、それぞれの検証メソッドが呼び出されます。

検証エラーの報告

エラーレポートを生成するには、ValidationContext によって提供されるメソッドを使用します。

context.LogError("error string", errorCode, elementsWithError);

"error string" が、Visual Studio エラー一覧に表示されます。
errorCode は、エラーの一意の識別子である文字列です。
elementsWithError は、モデル内の要素を識別します。ユーザーがエラーレポートをダブルクリックすると、この要素を表すシェイプが選択されます。

LogError(),、LogWarning()、および LogMessage() は、エラー一覧の複数の異なるセクションにメッセージを配置します。

検証メソッドの適用方法

検証は、リレーションシップや、クラスの属性や操作のパラメーターなどの大きい要素のパートを含む、モデルのすべての要素に対して適用されます。

どの検証メソッドも、2 番目のパラメーターの型に対応する各要素に対して適用されます。つまり、たとえば、2 番目のパラメーターが IUseCase の検証メソッドと、スーパータイプが IElement の検証メソッドを定義すると、これらのメソッドはどちらも、モデルの各ユースケースに対して適用されます。

型の階層は、「モデル要素の型」にまとめられています。

また、リレーションシップに従うことによって要素にアクセスすることもできます。たとえば、IClass で検証メソッドを定義する場合、所有されているプロパティに対してループ処理を行うことができます。

public void ValidateTypeName(ValidationContext context, IClass c)
{
   foreach (IProperty property in c.OwnedAttributes)
   {
       if (property.Name.Length < 3)
       {
            context.LogError(
                 string.Format(
                        "Property name {0} is too short", 
                        property.Name), 
                 "001", property);
        }
   }
}

モデルでの検証メソッドの生成

検証を実行するたびに検証メソッドが必ず 1 回呼び出されるようにする必要がある場合、IModel を検証できます。

using Microsoft.VisualStudio.Uml.AuxiliaryConstructs; ...
[Export(typeof(System.Action<ValidationContext, object>))]
[ValidationMethod(ValidationCategories.Menu)]
public void ValidateModel(ValidationContext context, IModel model)
{  foreach (IElement element in model.OwnedElements)
   { ...

図形と図の検証

検証メソッドの主な目的とはモデルを検証することなので、図や図形などの表示要素では呼び出されません。ただし、図コンテキストを使用すると、現在の図にアクセスすることができます。

検証クラス内で、インポートプロパティとして DiagramContext を宣言します。

using Microsoft.VisualStudio.ArchitectureTools.Extensibility.Presentation; 
...
[Import]
public IDiagramContext DiagramContext { get; set; }

検証メソッドで、DiagramContext を使用して現在のフォーカス図にアクセスできます (存在する場合)。

[Export(typeof(System.Action<ValidationContext, object>))]
[ValidationMethod(ValidationCategories.Menu)]
public void ValidateModel(ValidationContext context, IModel model)
{
  IDiagram focusDiagram = DiagramContext.CurrentDiagram;
  if (focusDiagram != null)
  {
    foreach (IShape<IUseCase> useCaseShape in
              focusDiagram.GetChildShapes<IUseCase>())
    { ...

LogError に図形を渡すことはできないため、エラーを記録するには、図形が表しているモデル要素を取得する必要があります。

       IUseCase useCase = useCaseShape.Element;
       context.LogError(... , usecase);

複数の検証の調整

たとえば、ユーザーによって図のメニューから検証が起動されると、それぞれのモデル要素にそれぞれの検証メソッドが適用されます。これは、検証フレームワークの 1 回の起動において、同じメソッドが異なる要素に何度も適用される可能性があることを示します。

これは、要素間の関係を対象とする検証において問題となります。たとえば、ユースケースから始まり、include 関係までを対象として、ループが存在しないことを確認するための検証を記述したとします。しかし、多くの include リンクを含むモデル内の各ユースケースにこのメソッドを適用した場合、モデルの同じ領域が繰り返し処理される可能性があります。

このような状況を回避するには、検証実行中に情報を保持するコンテキストキャッシュを使用できます。コンテキストキャッシュを使用すると、検証メソッドの実行間で情報を渡すことができます。たとえば、この検証実行によって処理済みの要素のリストを格納できます。キャッシュは、それぞれの検証実行の開始時に生成されます。キャッシュを使用して検証実行間で情報を渡すことはできません。

context.SetCacheValue<T> (name, value)	値を格納します。
context.TryGetCacheValue<T> (name, out value)	値を取得します。正常に終了した場合は true を返します。
context.GetValue<T>(name)	値を取得します。
Context.GetValue<T>()	指定した型の値を取得します。

拡張機能のインストールとアンインストール

Visual Studio 拡張機能は、自分のコンピューターと他のコンピューターの両方にインストールできます。

拡張機能をインストールするには

自分のコンピューターで、VSIX プロジェクトによってビルドされた .vsix ファイルを見つけます。
1. VSIX プロジェクトのショートカットメニューの **[ソリューションエクスプローラー]では、[Windows エクスプローラーでフォルダーを開く]**を選択します。
2. bin\*\<プロジェクト>.vsix ファイルを見つけます。
拡張機能をインストールする対象のコンピューターに .vsix ファイルをコピーします。自分のコンピューターでも別のコンピューターでもかまいません。
- インストール先のコンピューターには、source.extension.vsixmanifest に指定した Visual Studio のいずれかのエディションがインストールされている必要があります。
ターゲットコンピューターで、.vsix ファイルを開きます。

Visual Studio 拡張機能インストーラーが起動され、拡張機能がインストールされます。
Visual Studio を起動または再起動します。

拡張機能をアンインストールするには

[ツール] で、メニューの **[拡張機能マネージャー]**を選択します。
[インストール済みの拡張機能] を展開します。
拡張機能を選択し、**[アンインストール]**を選択します。

拡張機能の障害が原因で読み込みが失敗し、エラーウィンドウにレポートが生成されることがまれにありますが、それは拡張機能マネージャーには表示されません。その場合は、次の場所からファイルを削除して、拡張機能を削除します (%LocalAppData% は通常、DriveName:\Users\UserName\AppData\Local)。

%LocalAppData%\Microsoft\VisualStudio\11.0\Extensions

例

この例は、要素間の依存関係におけるループを検索します。

保存したときと検証メニューコマンドを選択したときに検証が実行されます。

/// <summary>
/// Verify that there are no loops in the dependency relationsips.
/// In our project, no element should be a dependent of itself.
/// </summary>
/// <param name="context">Validation context for logs.</param>
/// <param name="element">Element to start validation from.</param>
[Export(typeof(System.Action<ValidationContext, object>))]
[ValidationMethod(ValidationCategories.Menu 
     | ValidationCategories.Save | ValidationCategories.Open)]
public void NoDependencyLoops(ValidationContext context, INamedElement element)
{
    // The validation framework will call this method
    // for every element in the model. But when we follow
    // the dependencies from one element, we will validate others.
    // So we keep a list of the elements that we don't need to validate again. 
    // The list is kept in the context cache so that it is passed
    // from one execution of this method to another.
    List<INamedElement> alreadySeen = null;
    if (!context.TryGetCacheValue("No dependency loops", out alreadySeen))
    {
       alreadySeen = new List<INamedElement>();
       context.SetCacheValue("No dependency loops", alreadySeen);
    }

    NoDependencyLoops(context, element, 
                new INamedElement[0], alreadySeen);    
}

/// <summary>
/// Log an error if there is any loop in the dependency relationship.
/// </summary>
/// <param name="context">Validation context for logs.</param>
/// <param name="element">The element to be validated.</param>
/// <param name="dependants">Elements we've followed in this recursion.</param>
/// <param name="alreadySeen">Elements that have already been validated.</param>
/// <returns>true if no error was detected</returns>
private bool NoDependencyLoops(ValidationContext context, 
    INamedElement element, INamedElement[] dependants, 
    List<INamedElement> alreadySeen)
{
    if (dependants.Contains(element))
    {
        context.LogError(string.Format("{0} should not depend on itself", element.Name), 
        "Fabrikam.UML.NoGenLoops", // unique code for this error
        dependants.SkipWhile(e => e != element).ToArray()); 
            // highlight elements that are in the loop
        return false;
    }
    INamedElement[] dependantsPlusElement = 
        new INamedElement[dependants.Length + 1];
    dependants.CopyTo(dependantsPlusElement, 0);
    dependantsPlusElement[dependantsPlusElement.Length - 1] = element;

    if (alreadySeen.Contains(element))
    {
        // We have already validated this when we started 
        // from another element during this validation run.
        return true;
    }
    alreadySeen.Add(element);

    foreach (INamedElement supplier in element.GetDependencySuppliers())
    {
        if (!NoDependencyLoops(context, supplier,
             dependantsPlusElement, alreadySeen))
        return false;
    }
    return true;
}

参照

概念

方法: モデリング拡張機能を定義およびインストールする

UML API を使用したプログラミング

次の方法で共有

方法: UML モデルの検証制約を定義する

要件

検証制約の適用

検証拡張機能の定義

検証拡張機能を独自の VSIX に生成するには

クラスライブラリプロジェクトで個別の検証制約を生成するには

検証クラスを定義するには

検証制約の実行

検証制約をテストするには

制約の評価

検証制約のメソッドについて

検証エラーの報告

検証メソッドの適用方法

モデルでの検証メソッドの生成

図形と図の検証

複数の検証の調整

拡張機能のインストールとアンインストール

拡張機能をインストールするには

拡張機能をアンインストールするには

例

参照

概念

その他のリソース

次の方法で共有

方法: UML モデルの検証制約を定義する

要件

検証制約の適用

検証拡張機能の定義

検証拡張機能を独自の VSIX に生成するには

クラス ライブラリ プロジェクトで個別の検証制約を生成するには

検証クラスを定義するには

検証制約の実行

検証制約をテストするには

制約の評価

検証制約のメソッドについて

検証エラーの報告

検証メソッドの適用方法

モデルでの検証メソッドの生成

図形と図の検証

複数の検証の調整

拡張機能のインストールとアンインストール

拡張機能をインストールするには

拡張機能をアンインストールするには

例

参照

概念

その他のリソース

クラスライブラリプロジェクトで個別の検証制約を生成するには