次の方法で共有

データ コントラクトのバージョン管理

  • [アーティクル]

アプリケーションの進化に伴って、サービスが使用するデータ コントラクトを変更することが必要になる場合があります。ここでは、データ コントラクトをバージョン管理する方法について説明します。データ コントラクトのバージョン管理のメカニズムについても説明します。バージョン管理全般の概要および規範となるガイダンスについては、「ベスト プラクティス : データ コントラクトのバージョン管理」を参照してください。

互換性に影響する変更と影響しない変更

データ コントラクトへの変更には、互換性に影響するものと影響しないものとがあります。互換性に影響しない方法でデータ コントラクトを変更すると、古いバージョンのコントラクトを使用するアプリケーションは新しいバージョンを使用するアプリケーションと通信できます。また、新しいバージョンを使用するアプリケーションも古いバージョンを使用するアプリケーションと通信できます。一方、互換性に影響する変更では、一方向または双方向で通信できなくなります。

型を変更してもその送受信方法に影響しない場合は、互換性に影響しない変更と呼びます。このような変更では、データ コントラクトは変更されず、基になる型のみが変更されます。たとえば、フィールドの名前を変更した後で DataMemberAttribute の Name プロパティを以前のバージョン名に設定すれば、互換性に影響しません。次のコードに、バージョン 1 のデータ コントラクトを示します。

互換性に影響しない変更を次のコードに示します。

変更によっては、送信されるデータを変更しても、必ずしも互換性に影響しない場合もあります。次の変更は常に互換性に影響します。

  • データ コントラクトの Name 値または Namespace 値の変更。
  • DataMemberAttribute の Order プロパティを使用したデータ メンバの順序の変更。
  • データ メンバの名前の変更。
  • データ メンバのデータ コントラクトの変更 (たとえば、データ メンバの型を整数型から文字列型に変更したり、"Customer" という名前のデータ コントラクトを持つ型を "Person" という名前のデータ コントラクトを持つ型に変更したりするなど)。

以下のような変更も考えられます。

データ メンバの追加と削除

厳密なスキーマ検証 (古いスキーマに基づく新しいインスタンスの検証) が必要ではない限り、多くの場合、データ メンバの追加または削除は互換性に影響する変更ではありません。

追加のフィールドを持つ型が、そのフィールドを持たない型に逆シリアル化された場合、追加のフィールドにある情報は無視されます (ラウンド トリップのために、この情報が保存される場合もあります。詳細については、「上位互換性のあるデータ コントラクト」を参照してください)。

一部のフィールドが足りない型が、追加のフィールドを持つ型に逆シリアル化された場合、追加のフィールドは既定値 (通常はゼロまたは null) のままになります (既定値は変更される場合があります。詳細については、「バージョン トレラントなシリアル化コールバック」を参照してください)。

たとえば、クライアントで CarV1 クラスを使用し、サービスで CarV2 クラスを使用することも、サービスで CarV1 クラスを使用し、クライアントで CarV2 クラスを使用することもできます。

バージョン 2 のエンドポイントからバージョン 1 のエンドポイントに正常にデータを送信できます。Car データ コントラクトのバージョン 2 をシリアル化すると、次のような XML が生成されます。

<Car>
    <Model>Porsche</Model>
    <HorsePower>300</HorsePower>
</Car>

バージョン 1 の逆シリアル化エンジンでは、HorsePower フィールドに一致するデータ メンバを見つけられないため、データは破棄されます。

また、バージョン 1 のエンドポイントからバージョン 2 のエンドポイントにデータを送信することもできます。Car データ コントラクトのバージョン 1 をシリアル化すると、次のような XML が生成されます。

<Car>
    <Model>Porsche</Model>
</Car>

受信 XML に一致するデータがないため、バージョン 2 のデシリアライザでは HorsePower フィールドを何に設定するのか判別できません。そのため、このフィールドには既定値である 0 が設定されます。

必須データ メンバ

DataMemberAttribute の IsRequired プロパティを true に設定すると、データ メンバを必須のデータ メンバとしてマークできます。逆シリアル化中に必須データがない場合、データ メンバは既定値に設定されず、代わりに例外がスローされます。

必須のデータ メンバの追加は、互換性に影響する変更です。つまり、新しい型を古い型のエンドポイントに送信することはできますが、その逆はできなくなります。以前のバージョンで必須としてマークされていたデータ メンバを削除することも、互換性に影響する変更です。

IsRequired プロパティの値を true から false に変更することは互換性に影響しませんが、false から true に変更すると、これよりも以前のいずれかのバージョンの型にこのデータ メンバが存在していない場合、互換性に影響することがあります。

ms731138.note(ja-jp,VS.90).gifメモ :
IsRequired プロパティが true に設定されていても、受信データは NULL またはゼロの場合があるので、型ではこの可能性を処理できるようにしておく必要があります。不適切な受信データに対するセキュリティ保護メカニズムとして IsRequired を使用しないでください。

既定値の省略

「データ メンバの既定値」で説明したように、DataMemberAttribute 属性の EmitDefaultValue プロパティを false に設定できます (ただし、この設定はお勧めしません)。このプロパティが false に設定されている場合、データ メンバが既定値 (通常 NULL またはゼロ) に設定されていても、そのデータ メンバは出力されません。これにより、次の 2 つの点で、異なるバージョンの必須データ メンバの互換性が失われます。

  • あるバージョンで必須になっているデータ メンバを持つデータ コントラクトは、データ メンバの EmitDefaultValue が false に設定されている別のバージョンから既定 (NULL またはゼロ) のデータを受信できません。
  • EmitDefaultValue が false に設定されている必須データ メンバは、既定値 (NULL またはゼロ) をシリアル化で使用できませんが、逆シリアル化ではこのような値を受信できます。これによりラウンド トリップの問題が発生します (データを読み取ることはできますが、書き込むことができません)。そのため、あるバージョンにおいて IsRequired が true であり、EmitDefaultValue が false である場合、どのバージョンのデータ コントラクトにおいてもラウンド トリップを発生させる値を生成できるように、これ以外のすべてのバージョンに同じ組み合わせを適用する必要があります。

スキーマの考慮事項

データ コントラクト型用に生成されるスキーマについては、「データ コントラクト スキーマの参照」を参照してください。

データ コントラクト型用に WCF が生成するスキーマは、バージョン管理に対応していません。つまり、あるバージョンの型からエクスポートされたスキーマには、そのバージョンに存在するデータ メンバのみが含まれます。IExtensibleDataObject インターフェイスを実装しても、型のスキーマは変更されません。

データ メンバは、既定でオプション要素としてスキーマにエクスポートされます。つまり、minOccurs (XML 属性) の値は 0 に設定されています。minOccurs を 1 に設定した場合、必須データ メンバがエクスポートされます。

スキーマを厳密に遵守する必要がある場合、互換性に影響しないと思われる変更の多くが、実際には互換性に影響します。前述の例では、Model 要素だけを持つ CarV1 インスタンスは、CarV2 スキーマ (Model と Horsepower の 2 つの要素を持ちますが、いずれも省略可能です) に対して有効です。しかし、この逆は真ではありません。つまり、CarV2 インスタンスは CarV1 スキーマに対して検証が失敗します。

ラウンド トリップにもいくつかの考慮事項があります。詳細な情報については、次のページを参照してください。 「上位互換性のあるデータ コントラクト」の「スキーマの考慮事項」を参照してください。

許可されるその他の変更

IExtensibleDataObject インターフェイスの実装は、互換性に影響しない変更です。ただし、IExtensibleDataObject が実装されていたものより前のバージョンについては、型のバージョンのラウンド トリップはサポートされていません。詳細な情報については、次のページを参照してください。 「上位互換性のあるデータ コントラクト」を参照してください。

列挙体

列挙体メンバの追加や削除は、互換性に影響する変更です。EnumMemberAtttribute 属性を使用して古いバージョンのコントラクト名を保持しない限り、列挙体メンバの名前の変更は互換性に影響します。詳細な情報については、次のページを参照してください。 「データ コントラクトの列挙型」を参照してください。

コレクション

コレクション型の大半はデータ コントラクト モデル内で交換可能であるため、多くの場合、コレクションの変更は互換性に影響しません。ただし、カスタマイズされていないコレクションからカスタマイズされたコレクションへの変更またはその逆の変更は、互換性に影響する変更です。また、コレクションのカスタマイズ設定の変更 (データ コントラクトの名前と名前空間の変更、要素名、キー要素名、および値要素名の反復) も互換性に影響します。コレクションのカスタマイズ詳細については、 、「データ コントラクトのコレクション型」を参照してください。

当然のことですが、コレクションの内容のデータ コントラクトの変更 (整数のリストから文字列のリストへの変更など) は互換性に影響する変更です。

関連項目

リファレンス

Name
DataMemberAttribute
Name
Namespace
Order
IsRequired
SerializationException
IExtensibleDataObject

概念

バージョン トレラントなシリアル化コールバック
ベスト プラクティス : データ コントラクトのバージョン管理
データ コントラクトの使用
データ コントラクトの等価性
上位互換性のあるデータ コントラクト