उदाहरण के रूप में GetRegions विधि का उपयोग कर Yandex डायरेक्ट सेवा का उपयोग करना (WCF क्लाइंट)

Yandex.Direct SOAP प्रोटोकॉल का उपयोग करते हुए सही तरीके से काम नहीं करता है, क्योंकि अनुरोधों के जवाब में उपयोग की जाने वाली वास्तविक डेटा योजना इस सेवा द्वारा प्रदान किए गए WSDL विवरण से योजना से मेल नहीं खाती है। अर्थात्, नाम स्थान से मेल नहीं खाता ("API" के बजाय " namespaces.soaplite.com/perl " और " xml.apache.org/xml-soap ") आता है, साथ ही पैरामीटर नाम (उदाहरण के लिए, नाम "वापसी" के बजाय GetRegions विधि में) आता है "ArrayOfRegionInfo")।

पहली समस्या को खत्म करने के लिए, नामस्थान की सेवा और समायोजन से संदेशों का अवरोधन लागू किया गया था।
दूसरी समस्या को ठीक करने के लिए, Reference.cs ऑटो-जेनरेट की गई WSDL फ़ाइल को केवल ठीक किया गया था।
आधिकारिक तौर पर, Yandex.Direct सेवा WCF का उपयोग करके C # में विकसित अनुप्रयोगों का समर्थन नहीं करती है।
Yandex.Direct JSON डेटा स्टोरेज प्रारूप और एक साधारण WebClient का उपयोग करके सेवा के साथ सहभागिता करने का एक उदाहरण प्रदान करता है। यह उदाहरण SOAP के विपरीत सही तरीके से काम करता है, लेकिन इसके कई नुकसान भी हैं, जैसे: आपको प्राप्त ऑब्जेक्ट को खुद से डीरिशियल करने की आवश्यकता है, सेवा और क्लाइंट के बीच अनुबंध का कोई समर्थन नहीं है।

ट्रेनिंग

सेवा प्रलेखन यहाँ प्रस्तुत किया गया है ।
सेवा के साथ काम करने के लिए आपको चाहिए:
1. रजिस्टर (लॉगिन प्रमाणीकरण पैरामीटर में स्थानांतरण के लिए),
2. एक क्लाइंट एप्लिकेशन बनाएं (प्रमाणीकरण पैरामीटर में application_id पास करने के लिए),
3. एक परीक्षण टोकन प्राप्त करें (टोकन प्रमाणीकरण पैरामीटर में संचरण के लिए),
4. प्रमाणीकरण पैरामीटर लोकेल में मूल्य "आरयू" पास करने के लिए इस्तेमाल किया जा सकता है।
आप सेवा के लिए प्रलेखन में अधिक पढ़ सकते हैं, इसे यहां फिर से न लिखें।

अनुप्रयोग निर्माण

1. MS Visual Studio में एक नया एप्लिकेशन बनाएं।
2. सेवा में एक नया लिंक जोड़ें, wsdl निर्दिष्ट करें: " api.direct.yandex.ru/wsdl/v4 ", नामस्थान, उदाहरण के लिए, यैंडेक्सैपिस सर्विस (अच्छी तरह से, या जो भी आपको पसंद है)।
3. Reference.cs फ़ाइल में, System.Nullable <System.DateTime> को System.DateTime द्वारा बदल दिया जाता है
4. YandexAPIService.APIPort.GetRegions विधि के विवरण में Reference.cs फ़ाइल में, "ArrayOfRegionInfo" के साथ "वापसी" पैरामीटर नाम बदलें।
5. एक मैसेज इंस्पेक्टर बनाएं जिसमें सेवा से आए संदेशों को इंटरसेप्ट किया जाएगा और "गलत" नामस्थान को "सही" एक के साथ बदल दिया जाएगा।

using System; using System.IO; using System.ServiceModel; using System.ServiceModel.Channels; using System.ServiceModel.Configuration; using System.ServiceModel.Description; using System.ServiceModel.Dispatcher; using System.Xml; namespace YandexDirectRegions { // Client message inspector public class YandexDirectMessageInspector : IClientMessageInspector { public void AfterReceiveReply(ref Message reply, object correlationState) { XmlDocument doc = new XmlDocument(); MemoryStream ms = new MemoryStream(); XmlWriter writer = XmlWriter.Create(ms); reply.WriteMessage(writer); writer.Flush(); ms.Position = 0L; doc.Load(ms); foreach (XmlAttribute attr in doc.DocumentElement.Attributes) if (attr.Value == "http://namespaces.soaplite.com/perl" || attr.Value == "http://xml.apache.org/xml-soap") attr.Value = "API"; ms.Position = 0L; ms.SetLength(0); writer = XmlWriter.Create(ms); doc.WriteTo(writer); writer.Flush(); ms.Position = 0L; XmlReader reader = XmlReader.Create(ms); Message newReply = Message.CreateMessage(reader, int.MaxValue, reply.Version); newReply.Properties.CopyProperties(reply.Properties); newReply.Headers.CopyHeadersFrom(reply); reply = newReply; } public object BeforeSendRequest(ref System.ServiceModel.Channels.Message request, IClientChannel channel) { return null; } } // Endpoint behavior public class YandexDirectEndpointBehavior : IEndpointBehavior { public void AddBindingParameters(ServiceEndpoint endpoint, System.ServiceModel.Channels.BindingParameterCollection bindingParameters) { // No implementation necessary } public void ApplyClientBehavior(ServiceEndpoint endpoint, ClientRuntime clientRuntime) { clientRuntime.MessageInspectors.Add(new YandexDirectMessageInspector()); } public void ApplyDispatchBehavior(ServiceEndpoint endpoint, EndpointDispatcher endpointDispatcher) { // No implementation necessary } public void Validate(ServiceEndpoint endpoint) { // No implementation necessary } } // Configuration element public class YandexDirectBehaviorExtension : BehaviorExtensionElement { public override Type BehaviorType { get { return typeof(YandexDirectEndpointBehavior); } } protected override object CreateBehavior() { // Create the endpoint behavior that will insert the message // inspector into the client runtime return new YandexDirectEndpointBehavior(); } } } 

6. कॉन्फ़िगरेशन फ़ाइल में [ऐप | वेब] .config, एंडपॉइंट कॉन्फ़िगर करें

 <?xml version="1.0" encoding="utf-8" ?> <configuration> <system.serviceModel> <bindings> <basicHttpBinding> <binding name="YandexDirectSoapBinding" maxReceivedMessageSize="100000"> <security mode="Transport" /> </binding> </basicHttpBinding> </bindings> <client> <endpoint address="https://soap.direct.yandex.ru/v4/soap/" binding="basicHttpBinding" bindingConfiguration="YandexDirectSoapBinding" contract="YandexAPIService.APIPort" behaviorConfiguration="YandexDirectBehavior" name="APIPort" /> </client> <behaviors> <endpointBehaviors> <behavior name="YandexDirectBehavior"> <YandexDirectBehaviorExtension /> </behavior> </endpointBehaviors> </behaviors> <extensions> <behaviorExtensions> <add name="YandexDirectBehaviorExtension" type="YandexDirectRegions.YandexDirectBehaviorExtension, YandexDirectRegions" /> </behaviorExtensions> </extensions> </system.serviceModel> </configuration> 

7. हम एक विधि कॉल को लागू करते हैं

 using System; using System.Linq; using System.ServiceModel; using System.ServiceModel.Channels; using YandexDirectRegions.YandexAPIService; namespace YandexDirectRegions { //     ,       -  / "" public class Region { public int RegionID { get; set; } public int? ParentID { get; set; } public string RegionName { get; set; } } public class UnitOfWork { YandexAPIService.APIPortClient yandexAPIPortClient; #region Singleton private static volatile UnitOfWork instance; private static object syncRoot = new Object(); private UnitOfWork() { yandexAPIPortClient = new YandexAPIService.APIPortClient(); System.Net.ServicePointManager.ServerCertificateValidationCallback = delegate { return true; }; } public static UnitOfWork Instance { get { if (instance == null) { lock (syncRoot) { if (instance == null) instance = new UnitOfWork(); } } return instance; } } #endregion public Region[] GetRegions(string application_id, string token, string login, string locale) { Region[] regions = null; var applicationIdHeader = MessageHeader.CreateHeader("application_id", "ns", application_id); var tokenHeader = MessageHeader.CreateHeader("token", "ns", token); var loginHeader = MessageHeader.CreateHeader("login", "ns", login); var localeHeader = MessageHeader.CreateHeader("locale", "ns", locale); using (var scope = new OperationContextScope(yandexAPIPortClient.InnerChannel)) { OperationContext.Current.OutgoingMessageHeaders.Add(applicationIdHeader); OperationContext.Current.OutgoingMessageHeaders.Add(tokenHeader); OperationContext.Current.OutgoingMessageHeaders.Add(loginHeader); OperationContext.Current.OutgoingMessageHeaders.Add(localeHeader); var regionsInfo = yandexAPIPortClient.GetRegions(); if (regionsInfo != null) { regions = regionsInfo.Select<RegionInfo, Region>((regionInfo) => { return new Region() { RegionID = regionInfo.RegionID, ParentID = regionInfo.ParentID, RegionName = regionInfo.RegionName }; } ).ToArray(); } } return regions; } } }