Layanan HTTP Dasar
Sampel BasicHttpService menunjukkan cara mengimplementasikan layanan berbasis HTTP dan berbasis RPC, yang populer disebut sebagai layanan "POX" (Plain Old XML) – menggunakan model Pemrograman REST Windows Communication Foundation (WCF). Sampel ini terdiri dari dua komponen: layanan HTTP WCF yang dihosting sendiri (Service.cs) dan aplikasi konsol (Program.cs) yang membuat layanan dan melakukan panggilan ke layanan tersebut.
Detail Sampel
Layanan WCF mengekspos 2 operasi, EchoWithGet
dan EchoWithPost
, yang mengembalikan string yang diteruskan sebagai input.
Operasi EchoWithGet
diannotasikan dengan WebGetAttribute, yang menunjukkan bahwa operasi memproses permintaan GET
HTTP. Karena WebGetAttribute tidak secara eksplisit menentukan UriTemplate, operasi mengharapkan string input diteruskan menggunakan parameter string kueri dengan nama s
. Perhatikan bahwa format URI yang diharapkan layanan dapat disesuaikan menggunakan properti UriTemplate.
Operasi EchoWithPost
diannotasikan dengan WebInvokeAttribute, yang menunjukkan bahwa itu bukan operasi GET
(memiliki efek samping). Karena WebInvokeAttribute tidak secara eksplisit menentukan Method
, operasi memproses permintaan POST
HTTP yang memiliki string dalam isi permintaan (misalnya dalam format XML). Perhatikan bahwa metode HTTP dan format URI untuk permintaan dapat disesuaikan menggunakan properti Method dan UriTemplate.
File App.config mengonfigurasi layanan WCF dengan WebHttpEndpoint default yang memiliki properti HelpEnabled yang diatur ke true
. Hasilnya, infrastruktur WCF membuat halaman bantuan berbasis HTML otomatis di http://localhost:8000/Customers/help
yang menyediakan informasi tentang cara membuat permintaan HTTP ke layanan dan cara menggunakan respons HTTP layanan.
Program.cs menunjukkan bagaimana pabrik saluran WCF dapat digunakan untuk melakukan panggilan ke layanan dan memproses respons. Perhatikan bahwa ini hanyalah salah satu cara untuk mengakses layanan WCF. Dimungkinkan juga untuk mengakses layanan menggunakan kelas .NET Framework lainnya seperti HttpWebRequest dan WebClient.
Sampel terdiri dari layanan yang dihosting sendiri dan klien yang keduanya berjalan dalam aplikasi konsol. Saat aplikasi konsol berjalan, klien membuat permintaan ke layanan dan menulis informasi yang berkaitan dari respons ke jendela konsol.
Untuk menggunakan sampel ini
Buka solusi untuk Sampel Layanan Http Dasar. Saat meluncurkan Visual Studio 2012, Anda harus menjalankannya sebagai administrator agar sampel berhasil dijalankan. Lakukan ini dengan mengeklik kanan ikon Visual Studio dan memilih Jalankan sebagai Administrator dari menu konteks.
Tekan Ctrl+Shift+B untuk membangun solusi, kemudian tekan Ctrl+F5 untuk menjalankan aplikasi konsol tanpa penelusuran kesalahan. Jendela konsol muncul dan menyediakan URI layanan yang sedang berjalan dan URI halaman bantuan HTML untuk layanan yang sedang berjalan. Anda dapat melihat halaman bantuan HTML kapan saja dengan mengetik URI halaman bantuan di browser. Saat sampel berjalan, klien menulis status aktivitas saat ini.
Tekan tombol apa pun untuk menghentikan sampel.