{"id":8535,"date":"2010-12-17T00:23:21","date_gmt":"2010-12-16T22:23:21","guid":{"rendered":"https:\/\/fatihboy.com\/post\/bir-wcf-hizmetine-istemci-olusturma"},"modified":"2010-12-17T00:23:21","modified_gmt":"2010-12-16T22:23:21","slug":"bir-wcf-hizmetine-istemci-olusturma","status":"publish","type":"post","link":"https:\/\/fatihboy.com\/en\/bir-wcf-hizmetine-istemci-olusturma\/","title":{"rendered":"Bir WCF Hizmetine \u0130stemci Olu\u015fturma"},"content":{"rendered":"
\"Hand<\/figure><\/div>\n\n\n\n

   Windows Communication Foundation’\u0131n detaylar\u0131n\u0131 sizlerle payla\u015fmay\u0131 hedefledi\u011fim makale serisinde daha \u00f6nce sizlerle bir WCF hizmetini gerek app.config dosyas\u0131 \u00fczerinden<\/a> gerekse de programsal olarak<\/a> nas\u0131l olu\u015fturabilece\u011finizi payla\u015fm\u0131\u015ft\u0131m. Giri\u015f d\u00fczeyinde g\u00f6rd\u00fc\u011f\u00fcm\u00fcz WCF hizmeti olu\u015fturma konusunda ilerleyen makalelerde daha detayl\u0131 bilgiler payla\u015fmay\u0131 planlamakla birlikte, bu konudaki ileri tekniklere\/ detaylara ge\u00e7meden \u00f6nce isterseniz birlikte bir WCF hizmet istemcisini nas\u0131l olu\u015fturabilece\u011fimizi g\u00f6relim.<\/p>\n\n\n\n

   Bir WCF hizmetine istemci olu\u015fturmada 3 temel y\u00f6ntem bulunmakta; komut sat\u0131r\u0131ndan service model meta veri hizmet arac\u0131n\u0131 kullanarak, Visual Studio i\u00e7erisinde yer alan sihirbazlar\u0131 kullanarak ya da uygulamam\u0131z i\u00e7erisinden programsal olarak. \u0130sterseniz bu 3 y\u00f6ntemin neler oldu\u011funu s\u0131ras\u0131yla g\u00f6relim:<\/p>\n\n\n\n

   \u0130lk y\u00f6ntemimiz olan service model meta veri hizmet arac\u0131n\u0131 (Svcutil.exe)<\/strong> komut sat\u0131r\u0131ndan kullanabilmenin en kolay yolu yeni bir Visual Studio Command Prompt<\/strong> oturumu ba\u015flatmakt\u0131r. Bilgisayar\u0131n\u0131za herhangi bir Visual Studio s\u00fcr\u00fcm\u00fcn\u00fc kurman\u0131zla birlikte ba\u015flat men\u00fcs\u00fcnde Microsoft Visual Studio 2010 ->  Visual Studio Tools<\/em> klas\u00f6r\u00fc alt\u0131na yerle\u015fen Visual Studio Command Prompt ,asl\u0131nda Visual Studio ile birlikte gelen ara\u00e7lar\u0131 kullanmam\u0131z i\u00e7in gerekli MSDOS path ve de\u011fi\u015fken tan\u0131mlar\u0131n\u0131 yapan bir batch dosyas\u0131ndan farkl\u0131 bir \u015fey de\u011fildir; ama bu haliyle bile bizim i\u00e7in olduk\u00e7a kullan\u0131\u015fl\u0131.<\/p>\n\n\n\n

   Svcutil<\/strong> uygulamas\u0131, Microsoft taraf\u0131ndan geli\u015ftirilmi\u015f ve WCF hizmetince yay\u0131nlanan meta veriyi kullanarak otomatik olarak istemci olu\u015fturabilen bir konsol uygulamas\u0131d\u0131r. \u0130stemci kodunu otomatik \u00fcretebilmesi i\u00e7in gerekli bilgiyi alaca\u011f\u0131 bir meta verinin bulunmas\u0131 gerekti\u011fini d\u00fc\u015f\u00fcnecek olursak, hizmetimizin gerekli olan bu meta veriyi online ya da offline olarak bizlere sa\u011fl\u0131yor olmas\u0131 gerekli. Serinin ilk iki makalesini hat\u0131rlayacak olursan\u0131z bir WCF hizmetinin meta verisi iki \u015fekilde yay\u0131nlayabilmekteydik; meta veri de\u011fi\u015fim u\u00e7 noktas\u0131 (Metadata Exchange, MEX endpoint<\/em>) ve servis meta veri davran\u0131\u015f\u0131 (ServiceMetadataBehavior<\/em>). Svcutil uygulamas\u0131 her iki y\u00f6ntemi de destekleyerek tan\u0131mlamas\u0131 verilen WCF hizmetine ba\u011flanmay\u0131 sa\u011flayacak olan kodu otomatik olarak \u00fcretebilir.<\/p>\n\n\n\n

   Makalemin geri kalan\u0131nda bu iki meta veri yay\u0131nlama y\u00f6nteminden en az birisinin WCF hizmetinizde aktif ya da meta verinizin wsdl\/xsd dosyalar\u0131 olarak yerel bilgisayar\u0131m\u0131zda ula\u015f\u0131labilir bir yerde oldu\u011funu varsay\u0131yorum.<\/p>\n\n\n\n

Svcutil.exe <hizmet Meta veri De\u011fi\u015fim (MEX) ya da HTTP GET adresi><\/pre>\n\n\n\n
   Yukar\u0131da en basit haliyle Svcutil arac\u0131n\u0131n komut sat\u0131r\u0131ndan nas\u0131l tetiklenebilece\u011fini g\u00f6rmektesiniz. Uygulamaya parametre olarak MEX adresi verilebilece\u011fi gibi http get y\u00f6ntemi ile payla\u015f\u0131lan meta verinin adresi de verilebilir. Bu bilgi uygulama taraf\u0131ndan kullan\u0131larak meta veri al\u0131n\u0131r ve meta veri ile belirtilen kontrata uygun bir istemci olu\u015fturulur. Svcutil uygulamas\u0131n\u0131 kullanarak otomatik olarak istemci \u00fcretebilmek i\u00e7in her zaman online olarak meta veriye ula\u015fmak zorunda de\u011filiz. G\u00fcvenlik nedeniyle meta veri eri\u015fiminin kapat\u0131ld\u0131\u011f\u0131 ya da kontrol\u00fcm\u00fcz\u00fcn d\u0131\u015f\u0131nda olan ve meta verisi yay\u0131nlanmam\u0131\u015f WCF hizmetlerinin kullan\u0131lmas\u0131 gerekti\u011fi senaryolar da d\u00fc\u015f\u00fcn\u00fclerek, ayn\u0131 i\u015flem \u00e7evrim d\u0131\u015f\u0131 olarak bilgisayar\u0131n\u0131zda bulunan web hizmeti tan\u0131m dili (Web Services Description Language, WSDL<\/em>) ve xml \u015fema tan\u0131m dili (XML Schema definition language, XSD<\/em>) dosyalar\u0131 kullan\u0131larak da yap\u0131labilmektedir. A\u015fa\u011f\u0131da bu \u015fekilde kod \u00fcretimine \u00f6rnek bir kullan\u0131m bulabilirsiniz;<\/p>\n\n\n\n
Svcutil.exe <Bilgisayar\u0131n\u0131zda bulunan WSDL ve XSD dosyalar\u0131n\u0131n listesi><\/pre>\n\n\n\n
   Yukar\u0131daki iki y\u00f6ntemden senaryonuza uygun olan\u0131 kullanmam\u0131z sonras\u0131nda Svcutil uygulamas\u0131 WCF hizmetine ba\u011flanmak i\u00e7in kullanabilece\u011finiz bir istemciye ait kodlar\u0131n bulundu\u011fu bir kaynak dosyas\u0131 \u00fcretecektir.<\/p>\n\n\n\n
   Svcutil uygulamas\u0131 yukar\u0131daki parametreler d\u0131\u015f\u0131nda kullan\u0131lacak olan programlama dili, assembly gibi \u00fcretilecek olan kaynak kod dosyas\u0131n\u0131 \u00f6zelle\u015ftirebilmeniz i\u00e7in farkl\u0131 parametreler de kabul etmektedir. Hatta kod \u00fcretirken mevcutta bulunan uygun s\u0131n\u0131flar\u0131m\u0131z\u0131 kullanmak isteyip istemeyece\u011fimizi dahi belirtebiliriz. Pek \u00e7ok parametreye sahip olan bu ara\u00e7 hakk\u0131nda MSDN sitesinde yer alan uygulama dok\u00fcmantasyonu<\/a> sizlere kullanabilece\u011finiz parametreler konusunda yard\u0131mc\u0131 olacakt\u0131r.<\/p>\n\n\n\n
   Ayn\u0131 bir WCF hizmetinde oldu\u011fu gibi, WCF istemcisinde de gerekli olan yap\u0131land\u0131rma bilgisi uygulama yap\u0131land\u0131rma dosyas\u0131nda (app.config, web.config<\/em>) tutulabilmektedir. Bu dosyan\u0131n da otomatik olarak \u00fcretilmesini destekleyen svcutil uygulamas\u0131 a\u015fa\u011f\u0131daki \u015fekildeki bir kullan\u0131m sonras\u0131nda bize gerekli olan yap\u0131land\u0131rma dosyas\u0131n\u0131 \u00fcretecektir;<\/p>\n\n\n\n
Svcutil.exe <dosya1 [,dosya2]><\/pre>\n\n\n\n
   A\u015fa\u011f\u0131da, \u00f6nceki makalelerimde sizlerle payla\u015fm\u0131\u015f oldu\u011fum \u00f6rnek WCF hizmetine ba\u011flanmakta kullan\u0131lacak olan ve svcutil uygulamas\u0131nca otomatik \u00fcretilmi\u015f olan OrnekHizmetClient s\u0131n\u0131f\u0131 ile bu s\u0131n\u0131f\u0131 \u00fcretmekte kulland\u0131\u011f\u0131m komut sat\u0131r\u0131n\u0131 bulabilirsiniz;<\/p>\n\n\n\n
svcutil http:\/\/localhost:1234\/WCFOrnekleri<\/pre>\n\n\n\n
\/\/------------------------------------------------------------------------------\n\/\/ <auto-generated>\n\/\/     This code was generated by a tool.\n\/\/     Runtime Version:4.0.30319.1\n\/\/\n\/\/     Changes to this file may cause incorrect behavior and will be lost if\n\/\/     the code is regenerated.\n\/\/ <\/auto-generated>\n\/\/------------------------------------------------------------------------------\n\n[System.CodeDom.Compiler.GeneratedCodeAttribute(\"System.ServiceModel\", \"4.0.0.0\")]\n[System.ServiceModel.ServiceContractAttribute(Namespace=\"https:\/\/fatihboy.com\/WCFOrnekleri\", ConfigurationName=\"IOrnekHizmet\")]\npublic interface IOrnekHizmet\n{\n\n    [System.ServiceModel.OperationContractAttribute(Action=\"https:\/\/fatihboy.com\/WCFOrnekleri\/IOrnekHizmet\/Say\", ReplyAction=\"https:\/\/fatihboy.com\/WCFOrnekleri\/IOrnekHizmet\/SayResponse\")]\n    int Say();\n}\n\n[System.CodeDom.Compiler.GeneratedCodeAttribute(\"System.ServiceModel\", \"4.0.0.0\")]\npublic interface IOrnekHizmetChannel : IOrnekHizmet, System.ServiceModel.IClientChannel\n{\n}\n\n[System.Diagnostics.DebuggerStepThroughAttribute()]\n[System.CodeDom.Compiler.GeneratedCodeAttribute(\"System.ServiceModel\", \"4.0.0.0\")]\npublic partial class OrnekHizmetClient : System.ServiceModel.ClientBase<IOrnekHizmet>, IOrnekHizmet\n{\n\n    public OrnekHizmetClient()\n    {\n    }\n\n    public OrnekHizmetClient(string endpointConfigurationName) :\n            base(endpointConfigurationName)\n    {\n    }\n\n    public OrnekHizmetClient(string endpointConfigurationName, string remoteAddress) :\n            base(endpointConfigurationName, remoteAddress)\n    {\n    }\n\n    public OrnekHizmetClient(string endpointConfigurationName, System.ServiceModel.EndpointAddress remoteAddress) :\n            base(endpointConfigurationName, remoteAddress)\n    {\n    }\n\n    public OrnekHizmetClient(System.ServiceModel.Channels.Binding binding, System.ServiceModel.EndpointAddress remoteAddress) :\n            base(binding, remoteAddress)\n    {\n    }\n\n    public int Say()\n    {\n        return base.Channel.Say();\n    }\n}<\/pre>\n\n\n\n
   G\u00f6rd\u00fc\u011f\u00fcn\u00fcz gibi olu\u015fturulan kod 3 s\u0131n\u0131ftan olu\u015fmakta;<\/p>\n\n\n\n