Útmutató: WCF-szolgáltatás üzemeltetésére a WAS-ban
Ez a témakör a Windows Communication Foundation (WCF) által üzemeltetett Windows-folyamataktiválási szolgáltatások (más néven WAS) létrehozásához szükséges alapvető lépéseket ismerteti. A WAS az új folyamataktiválási szolgáltatás, amely az Internet Information Services (IIS) azon funkcióinak általánosítása, amelyek nem HTTP átviteli protokollokkal működnek. A WCF a figyelőadapter-adapterrel kommunikálja a WCF által támogatott nem HTTP protokollokon keresztül fogadott aktiválási kérelmeket, például a TCP-t, a nevesített csöveket és a Message Queuinget.
Ez az üzemeltetési beállítás megköveteli, hogy a WAS aktiválási összetevők megfelelően legyenek telepítve és konfigurálva, de nem igényel semmilyen üzemeltetési kódot az alkalmazás részeként. A WAS telepítésével és konfigurálásával kapcsolatos további információkért lásd : A WCF aktiválási összetevőinek telepítése és konfigurálása.
Figyelmeztetés
A WAS aktiválás nem támogatott, ha a webkiszolgáló kérésfeldolgozási folyamata klasszikus módra van állítva. A webkiszolgáló kérésfeldolgozási folyamatának integrált üzemmódra kell állítania, ha WAS aktiválást szeretne használni.
Ha egy WCF-szolgáltatást a WAS-ban üzemeltetnek, a szokásos módon használják a standard kötéseket. Ha azonban a NetTcpBinding WAS által üzemeltetett szolgáltatást használja és NetNamedPipeBinding konfigurálja, meg kell felelnie egy korlátozásnak. Ha a különböző végpontok ugyanazt az átvitelt használják, a kötési beállításoknak a következő hét tulajdonságon kell egyezniük:
Csatlakozás ionBufferSize
ChannelInitializationTimeout
MaxPending Csatlakozás ions
MaxOutputDelay
MaxPendingAccepts
Csatlakozás ionPool Gépház. IdleTimeout
Csatlakozás ionPool Gépház. MaxOutbound Csatlakozás ionsPerEndpoint
Ellenkező esetben az elsőként inicializált végpont mindig meghatározza ezeknek a tulajdonságoknak az értékeit, a később hozzáadott végpontok pedig a beállításoknak nem megfelelő végpontokat.ServiceActivationException
A példa forráspéldányát a TCP-aktiválás című témakörben találhatja meg.
A WAS által üzemeltetett alapszolgáltatás létrehozása
Szolgáltatási szerződés definiálása a szolgáltatás típusához.
[ServiceContract] public interface ICalculator { [OperationContract] double Add(double n1, double n2); [OperationContract] double Subtract(double n1, double n2); [OperationContract] double Multiply(double n1, double n2); [OperationContract] double Divide(double n1, double n2); }
A szolgáltatási szerződés implementálása egy szolgáltatásosztályban. Vegye figyelembe, hogy a cím- vagy kötésadatok nincsenek megadva a szolgáltatás implementációja során. Emellett a kódot nem kell írni ahhoz, hogy lekérje ezeket az információkat a konfigurációs fájlból.
public class CalculatorService : ICalculator { public double Add(double n1, double n2) { return n1 + n2; } public double Subtract(double n1, double n2) { return n1 - n2; } public double Multiply(double n1, double n2) { return n1 * n2; } public double Divide(double n1, double n2) { return n1 / n2; } }
Hozzon létre egy Web.config fájlt a NetTcpBinding végpontok által
CalculatorService
használandó kötés meghatározásához.<?xml version="1.0" encoding="utf-8" ?> <configuration> <system.serviceModel> <bindings> <netTcpBinding> <binding portSharingEnabled="true"> <security mode="None" /> </binding> </netTcpBinding> </bindings> </system.serviceModel> </configuration>
Hozzon létre egy Service.svc fájlt, amely a következő kódot tartalmazza.
<%@ServiceHost language=c# Service="CalculatorService" %>
Helyezze a Service.svc fájlt az IIS virtuális könyvtárába.
Ügyfél létrehozása a szolgáltatás használatához
A ServiceModel Metadata Segédprogram (Svcutil.exe) használatával a parancssorból hozhat létre kódot a szolgáltatás metaadataiból.
Svcutil.exe <service's Metadata Exchange (MEX) address or HTTP GET address>
A létrehozott ügyfél tartalmazza azt a
ICalculator
felületet, amely meghatározza azt a szolgáltatási szerződést, amelyet az ügyfél-implementációnak teljesítenie kell.//Generated interface defining the ICalculator contract [System.ServiceModel.ServiceContractAttribute( Namespace="http://Microsoft.ServiceModel.Samples", ConfigurationName="Microsoft.ServiceModel.Samples.ICalculator")] public interface ICalculator { [System.ServiceModel.OperationContractAttribute( Action="http://Microsoft.ServiceModel.Samples/ICalculator/Add", ReplyAction="http://Microsoft.ServiceModel.Samples/ICalculator/AddResponse")] double Add(double n1, double n2); [System.ServiceModel.OperationContractAttribute( Action="http://Microsoft.ServiceModel.Samples/ICalculator/Subtract", ReplyAction="http://Microsoft.ServiceModel.Samples/ICalculator/SubtractResponse")] double Subtract(double n1, double n2); [System.ServiceModel.OperationContractAttribute( Action="http://Microsoft.ServiceModel.Samples/ICalculator/Multiply", ReplyAction="http://Microsoft.ServiceModel.Samples/ICalculator/MultiplyResponse")] double Multiply(double n1, double n2); [System.ServiceModel.OperationContractAttribute( Action="http://Microsoft.ServiceModel.Samples/ICalculator/Divide", ReplyAction="http://Microsoft.ServiceModel.Samples/ICalculator/DivideResponse")] double Divide(double n1, double n2); }
A létrehozott ügyfélalkalmazás a
ClientCalculator
. Vegye figyelembe, hogy a cím- és kötésadatok sehol nem vannak megadva a szolgáltatás megvalósításán belül. Emellett a kódot nem kell írni ahhoz, hogy lekérje ezeket az információkat a konfigurációs fájlból.// Implementation of the CalculatorClient public partial class CalculatorClient : System.ServiceModel.ClientBase<Microsoft.ServiceModel.Samples.ICalculator>, Microsoft.ServiceModel.Samples.ICalculator { public CalculatorClient() { } public CalculatorClient(string endpointConfigurationName) : base(endpointConfigurationName) { } public CalculatorClient(string endpointConfigurationName, string remoteAddress) : base(endpointConfigurationName, remoteAddress) { } public CalculatorClient(string endpointConfigurationName, System.ServiceModel.EndpointAddress remoteAddress) : base(endpointConfigurationName, remoteAddress) { } public CalculatorClient(System.ServiceModel.Channels.Binding binding, System.ServiceModel.EndpointAddress remoteAddress) : base(binding, remoteAddress) { } public double Add(double n1, double n2) { return base.Channel.Add(n1, n2); } public double Subtract(double n1, double n2) { return base.Channel.Subtract(n1, n2); } public double Multiply(double n1, double n2) { return base.Channel.Multiply(n1, n2); } public double Divide(double n1, double n2) { return base.Channel.Divide(n1, n2); } }
Az ügyfelet használó NetTcpBinding ügyfél konfigurációját a Svcutil.exe is létrehozza. Ezt a fájlt el kell nevezni az App.config fájlban a Visual Studio használatakor.
<?xml version="1.0" encoding="utf-8" ?> <configuration> <system.serviceModel> <bindings> <netTcpBinding> <binding name="NetTcpBinding_ICalculator"> <security mode="None"/> </binding> </netTcpBinding> </bindings> <client> <endpoint address="net.tcp://localhost/servicemodelsamples/service.svc" binding="netTcpBinding" bindingConfiguration="NetTcpBinding_ICalculator" contract="ICalculator" name="NetTcpBinding_ICalculator" /> </client> </system.serviceModel> </configuration>
Hozzon létre egy példányt egy
ClientCalculator
alkalmazásban, majd hívja meg a szolgáltatásműveleteket.//Client implementation code. class Client { static void Main() { // Create a client with given client endpoint configuration CalculatorClient client = new CalculatorClient(); // Call the Add service operation. double value1 = 100.00D; double value2 = 15.99D; double result = client.Add(value1, value2); Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result); // Call the Subtract service operation. value1 = 145.00D; value2 = 76.54D; result = client.Subtract(value1, value2); Console.WriteLine("Subtract({0},{1}) = {2}", value1, value2, result); // Call the Multiply service operation. value1 = 9.00D; value2 = 81.25D; result = client.Multiply(value1, value2); Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result); // Call the Divide service operation. value1 = 22.00D; value2 = 7.00D; result = client.Divide(value1, value2); Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result); //Closing the client gracefully closes the connection and cleans up resources client.Close(); Console.WriteLine(); Console.WriteLine("Press <ENTER> to terminate client."); Console.ReadLine(); } }
Állítsa össze és futtassa az ügyfelet.