Známé typy
Ukázka PoleTypes ukazuje, jak zadat informace o odvozených typech v kontraktu dat. Kontrakty dat umožňují předávat strukturovaná data do a ze služeb. V objektově orientovaném programování lze použít typ, který dědí z jiného typu místo původního typu. V programování orientovaném na služby jsou schémata spíše než typy komunikována, a proto není zachován vztah mezi typy. Atribut KnownTypeAttribute umožňuje zahrnout informace o odvozených typech do datového kontraktu. Pokud se tento mechanismus nepoužívá, odvozený typ nelze odeslat ani přijímat, pokud se očekává základní typ.
Poznámka:
Postup nastavení a pokyny k sestavení pro tuto ukázku najdete na konci tohoto tématu.
Kontrakt služby pro službu používá komplexní čísla, jak je znázorněno v následujícím vzorovém kódu.
// Define a service contract.
[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]
public interface ICalculator
{
[OperationContract]
ComplexNumber Add(ComplexNumber n1, ComplexNumber n2);
[OperationContract]
ComplexNumber Subtract(ComplexNumber n1, ComplexNumber n2);
[OperationContract]
ComplexNumber Multiply(ComplexNumber n1, ComplexNumber n2);
[OperationContract]
ComplexNumber Divide(ComplexNumber n1, ComplexNumber n2);
}
DataMemberAttribute A DataContractAttribute použije se na ComplexNumber třídu, která určuje, která pole třídy lze předat mezi klientem a službou. Odvozenou ComplexNumberWithMagnitude třídu lze použít místo ComplexNumber. Atribut KnownTypeAttribute typu ComplexNumber to označuje.
[DataContract(Namespace="http://Microsoft.ServiceModel.Samples")]
[KnownType(typeof(ComplexNumberWithMagnitude))]
public class ComplexNumber
{
[DataMember]
public double Real = 0.0D;
[DataMember]
public double Imaginary = 0.0D;
public ComplexNumber(double real, double imaginary)
{
this.Real = real;
this.Imaginary = imaginary;
}
}
Typ ComplexNumberWithMagnitude je odvozen od ComplexNumber , ale přidá další datový člen , Magnitude.
[DataContract(Namespace="http://Microsoft.ServiceModel.Samples")]
public class ComplexNumberWithMagnitude : ComplexNumber
{
public ComplexNumberWithMagnitude(double real, double imaginary) :
base(real, imaginary) { }
[DataMember]
public double Magnitude
{
get { return Math.Sqrt(Imaginary*Imaginary + Real*Real); }
set { throw new NotImplementedException(); }
}
}
Aby bylo možné předvést funkci známých typů, služba se implementuje takovým způsobem, že vrátí ComplexNumberWithMagnitude pouze pro sčítání a odčítání. (I když smlouva určuje ComplexNumber, je to povoleno z důvodu atributu KnownTypeAttribute ). Násobení a dělení stále vrací základní ComplexNumber typ.
public class DataContractCalculatorService : IDataContractCalculator
{
public ComplexNumber Add(ComplexNumber n1, ComplexNumber n2)
{
//Return the derived type.
return new ComplexNumberWithMagnitude(n1.Real + n2.Real,
n1.Imaginary + n2.Imaginary);
}
public ComplexNumber Subtract(ComplexNumber n1, ComplexNumber n2)
{
//Return the derived type.
return new ComplexNumberWithMagnitude(n1.Real - n2.Real,
n1.Imaginary - n2.Imaginary);
}
public ComplexNumber Multiply(ComplexNumber n1, ComplexNumber n2)
{
double real1 = n1.Real * n2.Real;
double imaginary1 = n1.Real * n2.Imaginary;
double imaginary2 = n2.Real * n1.Imaginary;
double real2 = n1.Imaginary * n2.Imaginary * -1;
//Return the base type.
return new ComplexNumber(real1 + real2, imaginary1 +
imaginary2);
}
public ComplexNumber Divide(ComplexNumber n1, ComplexNumber n2)
{
ComplexNumber conjugate = new ComplexNumber(n2.Real,
-1*n2.Imaginary);
ComplexNumber numerator = Multiply(n1, conjugate);
ComplexNumber denominator = Multiply(n2, conjugate);
//Return the base type.
return new ComplexNumber(numerator.Real / denominator.Real,
numerator.Imaginary);
}
}
V klientovi jsou kontrakt služby i datový kontrakt definovány ve zdrojovém souboru generatedClient.cs, který je generován nástrojem ServiceModel Metadata Utility (Svcutil.exe) z metadat služby. Vzhledem k tomu, že KnownTypeAttribute atribut je určen ve smlouvě o datech služby, klient může přijímat jak třídy ComplexNumberComplexNumberWithMagnitude , tak i při použití služby. Klient zjistí, jestli získal ComplexNumberWithMagnitude a vygeneroval příslušný výstup:
// Create a client
DataContractCalculatorClient client =
new DataContractCalculatorClient();
// Call the Add service operation.
ComplexNumber value1 = new ComplexNumber() { real = 1, imaginary = 2 };
ComplexNumber value2 = new ComplexNumber() { real = 3, imaginary = 4 };
ComplexNumber result = client.Add(value1, value2);
Console.WriteLine("Add({0} + {1}i, {2} + {3}i) = {4} + {5}i",
value1.real, value1.imaginary, value2.real, value2.imaginary,
result.real, result.imaginary);
if (result is ComplexNumberWithMagnitude)
{
Console.WriteLine("Magnitude: {0}",
((ComplexNumberWithMagnitude)result).Magnitude);
}
else
{
Console.WriteLine("No magnitude was sent from the service");
}
Při spuštění ukázky se požadavky a odpovědi operace zobrazí v okně konzoly klienta. Všimněte si, že velikost se vytiskne pro sčítání a odčítání, ale ne pro násobení a dělení kvůli způsobu implementace služby. Stisknutím klávesy ENTER v okně klienta klienta ukončete klienta.
Add(1 + 2i, 3 + 4i) = 4 + 6i
Magnitude: 7.21110255092798
Subtract(1 + 2i, 3 + 4i) = -2 + -2i
Magnitude: 2.82842712474619
Multiply(2 + 3i, 4 + 7i) = -13 + 26i
No magnitude was sent from the service
Divide(3 + 7i, 5 + -2i) = 0.0344827586206897 + 41i
No magnitude was sent from the service
Press <ENTER> to terminate client.
Nastavení, sestavení a spuštění ukázky
Ujistěte se, že jste pro ukázky windows Communication Foundation provedli jednorázovou instalační proceduru.
Pokud chcete sestavit edici C# nebo Visual Basic .NET řešení, postupujte podle pokynů v části Sestavení ukázek windows Communication Foundation.
Pokud chcete spustit ukázku v konfiguraci s jedním nebo více počítači, postupujte podle pokynů v části Spuštění ukázek windows Communication Foundation.