Підручник з веб-служб RESTful із прикладом REST API

Зміст:

Anonim

Що таке Restful Web Services?

Restful Web Services - це легкий, що підтримується та масштабований сервіс, побудований на архітектурі REST. Спокійний веб-сервіс, виставляйте API із вашої програми безпечним, рівномірним способом без громадянства для клієнта, що телефонує. Клієнт, що телефонує, може виконувати заздалегідь визначені операції за допомогою служби Restful. Основним протоколом REST є HTTP. REST означає «Представницький державний трансфер».

У цьому підручнику REST API ви дізнаєтесь-

  • RESTful ключові елементи
  • Спокійні методи
  • Чому спокійний
  • Спокійна архітектура
  • Принципи та обмеження RestFul
  • Створіть свою першу веб-службу Restful в ASP.NET
  • Запуск вашої першої веб-служби Restful
  • Тестування вашої першої веб-служби Restful

RESTful ключові елементи

Веб-сервіси REST дійсно пройшли довгий шлях з моменту свого створення. У 2002 році веб-консорціум випустив визначення веб-служб WSDL та SOAP. Це сформувало стандарт реалізації веб-сервісів.

У 2004 році веб-консорціум також оприлюднив визначення додаткового стандарту під назвою RESTful. За останні пару років цей стандарт став досить популярним. І використовується багатьма популярними веб-сайтами по всьому світу, включаючи Facebook та Twitter.

REST - це спосіб отримати доступ до ресурсів, що знаходяться в певному середовищі. Наприклад, у вас може бути сервер, на якому можуть розміщуватися важливі документи, картинки чи відео. Все це є прикладом ресурсів. Якщо клієнт, скажімо, веб-браузер потребує будь-якого з цих ресурсів, він повинен надіслати запит на сервер для доступу до цих ресурсів. Тепер послуги REST визначають спосіб доступу до цих ресурсів.

Ключові елементи реалізації RESTful такі:

  1. Ресурси - Першим ключовим елементом є сам ресурс. Припустимо, що веб-програма на сервері містить записи кількох співробітників. Припустимо, що URL-адреса веб-програми - http://demo.guru99.com . Тепер, щоб отримати доступ до ресурсу запису працівника за допомогою служб REST, можна виконати команду http://demo.guru99.com/employee/1 - Ця команда повідомляє веб-серверу прохання надати інформацію про працівника, чий номер співробітника 1.

  2. Запит дієслів - вони описують, що ви хочете зробити з ресурсом. Браузер видає дієслово GET, щоб вказувати кінцевій точці, яку він хоче отримати, дані. Однак є багато інших дієслів, включаючи такі речі, як POST, PUT та DELETE. Тож у випадку з прикладом http://demo.guru99.com/employee/1 веб-браузер фактично видає GET Verb, оскільки хоче отримати деталі запису працівника.

  3. Заголовки запиту - це додаткові інструкції, надіслані разом із запитом. Вони можуть визначати тип потрібної відповіді або деталі авторизації.

  4. Орган запиту - Дані надсилаються разом із запитом. Зазвичай дані надсилаються у запиті, коли запит POST надсилається до веб-служб REST. Під час виклику POST клієнт фактично повідомляє веб-службам REST, що хоче додати ресурс на сервер. Отже, тіло запиту буде мати деталі ресурсу, який потрібно додати на сервер.

  5. Орган відповіді - це основна частина реакції. Отже, у нашому прикладі RESTful API, якщо ми маємо запитувати веб-сервер через запит http://demo.guru99.com/employee/1 , веб-сервер може повернути XML-документ із усіма деталями працівника у відповіді Тіло.

  6. Коди статусу відповіді - ці коди є загальними кодами, які повертаються разом із відповіддю веб-сервера. Прикладом може служити код 200, який зазвичай повертається, якщо не виникає помилки при поверненні відповіді клієнту.

Спокійні методи

На наведеній нижче схемі показані переважно всі дієслова (POST, GET, PUT та DELETE) та приклад REST API, що вони означають.

Давайте припустимо, що у нас є веб-служба RESTful, яка визначена в цьому місці. http://demo.guru99.com/employee . Коли клієнт робить будь-який запит до цієї веб-служби, він може вказати будь-який із звичайних HTTP-дієслів GET, POST, DELETE та PUT. Нижче наведено, що сталося б, якби відповідні дієслова були надіслані клієнтом.

  1. POST - Це буде використано для створення нового співробітника за допомогою веб-служби RESTful
  2. GET - Це буде використано для отримання списку всіх співробітників, які використовують веб-службу RESTful
  3. PUT - Це буде використано для оновлення всіх працівників за допомогою веб-служби RESTful
  4. ВИДАЛИТИ - Це буде використано для видалення всіх працівників, які користуються послугами RESTful

Давайте подивимось з точки зору лише одного запису. Скажімо, був запис про працівника з номером 1.

Наступні дії мали б відповідне значення.

  1. POST - Це не застосовується, оскільки ми отримуємо дані працівника 1, які вже створені.
  2. GET - Це буде використано для отримання інформації про працівника з працівником № 1 за допомогою веб-служби RESTful
  3. PUT - Це буде використано для оновлення даних працівника з працівником № 1 за допомогою веб-служби RESTful
  4. ВИДАЛИТИ - Використовується для видалення даних працівника з номером Працівник як 1

Чому спокійний

Restful в основному набув популярності з наступних причин:

  1. Неоднорідні мови та середовища - це одна з фундаментальних причин, яка така ж, як ми бачили і для SOAP.
  • Це дозволяє веб-програмам, побудованим на різних мовах програмування, взаємодіяти між собою
  • За допомогою служб Restful ці веб-програми можуть розміщуватися в різних середовищах, деякі можуть бути в Windows, а інші - в Linux.

Але врешті-решт, незалежно від середовища, кінцевий результат повинен завжди бути однаковим, щоб вони мали можливість спілкуватися між собою. Інші веб-служби пропонують цю гнучкість для програм, побудованих на різних мовах програмування та платформ для спілкування між собою.

На малюнку нижче наведено приклад веб-програми, яка вимагає спілкування з іншими програмами, такими як Facebook, Twitter та Google.

Тепер, якби клієнтська програма мала працювати з такими сайтами, як Facebook, Twitter тощо, вони, мабуть, повинні були б знати, на якій мові побудовані Facebook, Google і Twitter, а також на якій платформі вони побудовані.

Виходячи з цього, ми можемо написати інтерфейсний код для нашого веб-додатку, але це може виявитись кошмаром.

Facebook, Twitter і Google надають свої функціональні можливості у вигляді веб-служб Restful. Це дозволяє будь-якій клієнтській програмі викликати ці веб-служби через REST.

  1. Подія пристроїв - Сьогодні на мобільних пристроях має працювати все, будь то мобільний пристрій, ноутбуки чи навіть автомобільні системи.

    Чи можете ви уявити, скільки зусиль намагаються кодувати програми на цих пристроях для спілкування із звичайними веб-програмами? Знову ж таки, Restful API можуть спростити цю роботу, оскільки, як згадувалося в пункті 1, вам дійсно не потрібно знати, що є основним шаром для пристрою.

  2. Нарешті, подія Хмари - все рухається до хмари. Програми повільно переходять до хмарних систем, таких як Azure або Amazon. Azure та Amazon надають багато API на основі архітектури Restful. Отже, додатки тепер потрібно розробляти таким чином, щоб вони стали сумісними з Хмарою. Отож, оскільки всі хмарні архітектури працюють за принципом REST, для веб-сервісів має більше сенсу програмуватися на архітектурі, що базується на REST, для найкращого використання хмарних служб.

Спокійна архітектура

Додаток чи архітектура, що вважаються RESTful чи REST-стилем, має такі характеристики

  1. Стан та функціональність поділяються на розподілені ресурси - Це означає, що кожен ресурс повинен бути доступний за допомогою звичайних команд HTTP GET, POST, PUT або DELETE. Отже, якщо хтось хотів отримати файл із сервера, він повинен мати змогу надіслати запит GET і отримати файл. Якщо вони хочуть розмістити файл на сервері, вони повинні мати можливість видавати запит POST або PUT. І нарешті, якщо вони хочуть видалити файл із сервера, вони видають запит DELETE.
  2. Архітектура клієнт / сервер, без стану, багаторівнева і підтримує кешування -
  • Клієнт-сервер - це типова архітектура, де сервером може бути веб-сервер, що розміщує додаток, а клієнт може бути таким же простим, як веб-браузер.
  • Без громадянства означає, що стан програми не підтримується в REST.

    Наприклад, якщо ви видаляєте ресурс із сервера за допомогою команди DELETE, ви не можете очікувати, що інформація про видалення буде передана наступному запиту.

    Для того, щоб забезпечити видалення ресурсу, вам потрібно буде надіслати запит GET. Запит GET буде використаний, щоб спочатку отримати всі ресурси на сервері. Після чого потрібно було б перевірити, чи ресурс був насправді видалений.

RESTПовні принципи та обмеження

Архітектура REST базується на кількох характеристиках, які описані нижче. Будь-яка веб-служба RESTful повинна відповідати наведеним нижче характеристикам, щоб її можна було назвати RESTful. Ці характеристики також відомі як принципи проектування, яких потрібно дотримуватися при роботі з послугами на базі RESTful.

  1. Клієнт-сервер RESTFul

Це найбільш фундаментальна вимога архітектури на основі REST. Це означає, що сервер матиме веб-службу RESTful, яка надаватиме необхідну функціональність клієнту. Клієнт надсилає запит до веб-служби на сервері. Сервер або відхилить запит, або виконає його та надасть адекватну відповідь клієнту.

  1. Без громадянства

Концепція без громадянства означає, що клієнт повинен забезпечити надання всієї необхідної інформації серверу. Це потрібно для того, щоб сервер міг належним чином обробити відповідь. Сервер не повинен зберігати будь-яку інформацію між запитами клієнта. Це дуже проста незалежна послідовність запитання-відповідь. Клієнт задає питання, сервер відповідає на нього належним чином. Клієнт поставить інше питання. Сервер не пам’ятатиме попередній сценарій відповіді на запитання і повинен буде відповісти на нове запитання самостійно.

  1. Кеш

Концепція кеш-пам'яті полягає у допомозі у вирішенні проблеми без громадянства, яка була описана в останньому пункті. Оскільки кожен запит клієнта сервера є незалежним за своєю суттю, іноді клієнт може знову запитати у сервера той самий запит. Це навіть незважаючи на те, що воно вже про це вимагало раніше. Цей запит надійде на сервер, і сервер дасть відповідь. Це збільшує трафік у мережі. Кеш - це концепція, реалізована на клієнті для зберігання запитів, які вже були відправлені на сервер. Отже, якщо той самий запит дається клієнтом, замість того, щоб переходити до сервера, він переходить у кеш і отримує необхідну інформацію. Це економить обсяг мережевого трафіку від клієнта до сервера.

  1. Шарувата система

Концепція багатошарової системи полягає в тому, що будь-який додатковий рівень, такий як рівень проміжного програмного забезпечення, може бути вставлений між клієнтом і фактичним сервером, що розміщує веб-службу RESTFul (на рівні проміжного програмного забезпечення створюється вся бізнес-логіка. Це може бути додатковою послугою створені, з якими клієнт міг взаємодіяти до здійснення дзвінка до веб-служби.). Але впровадження цього рівня повинно бути прозорим, щоб воно не порушувало взаємодію між клієнтом та сервером.

  1. Інтерфейс / єдиний контракт

Це основна техніка роботи веб-служб RESTful. RESTful в основному працює на веб-рівні HTTP і використовує наведені нижче ключові дієслова для роботи з ресурсами на сервері

  • POST - для створення ресурсу на сервері
  • ОТРИМАТИ - отримати ресурс із сервера
  • PUT - змінити стан ресурсу або оновити його
  • ВИДАЛИТИ - Щоб видалити або видалити ресурс із сервера

Створіть свою першу веб-службу Restful в ASP.NET

Тепер у цьому посібнику REST API ми дізнаємось, як створити веб-службу Restful в ASP.NET:

Веб-сервіси можуть створюватися різними мовами. Багато інтегрованих середовищ розробки можуть бути використані для створення служб на основі REST.

У цьому прикладі RESTful API ми збираємося створити наш додаток REST у .Net за допомогою Visual Studio. У нашому прикладі для веб-служб Restful ми будемо імітувати наступний приклад служби REST.

У нас буде веб-сервіс Restful, який працюватиме з наведеним нижче набором даних.

Наведений нижче набір даних представляє приклад REST API про наявність компанії, яка розкриває підручники, які вони мають, на основі Tutorialid.

Туторіалід Ім'я підручника
0 Масиви
1 Черги
2 Стеки

У нашому прикладі підручника з REST API ми збираємось реалізувати наведені нижче Restful Verbs.

  1. GET Tutorial - Коли клієнт викликає цей Restful API, йому буде надано весь набір підручників, доступних із веб-служби.
  2. GET Tutorial / Tutorialid - Коли клієнт викликає цей Restful API, йому буде надано ім'я підручника на основі Tutorialid, надісланого клієнтом.
  3. POST Tutorial / Tutorialname - Коли клієнт викликає цей Restful API, клієнт подасть запит на вставку імені підручника. Потім веб-служба додасть надіслану назву підручника до колекції.
  4. DELETE Tutorial / Tutorialid - Коли клієнт викликає цей Restful API, клієнт подасть запит на видалення імені підручника на основі Tutorialid. Потім веб-служба видалить надіслане ім’я підручника зі збірки.

Давайте виконуватимемо наведені нижче кроки в цьому посібнику з RESTful API, щоб створити наші перші веб-служби RESTful, які виконують вищевказану реалізацію.

Крок 1) Першим кроком є ​​створення порожнього веб-додатку Asp.Net. У Visual Studio 2013 натисніть пункт меню Файл-> Новий проект.

Після натискання параметра «Новий проект» Visual Studio надасть вам інше діалогове вікно для вибору типу проекту та надання необхідних деталей проекту. Це пояснюється на наступному кроці цього підручника з RESTful API

Крок 2) На цьому кроці

  1. Спочатку переконайтесь, що вибрали веб-шаблон R #ful веб-служб C # веб-програми ASP.NET. Проект повинен бути такого типу для створення проекту веб-сервісів. Вибравши ці параметри, Visual Studio виконає необхідні кроки для додавання необхідних файлів, необхідних будь-якій веб-програмі.
  2. Укажіть назву для вашого проекту, який у нашому випадку отримав назву "Webservice.REST".
  3. Потім переконайтеся, що вказали місце, де будуть зберігатися файли проекту.

Після закінчення ви побачите файл проекту, створений у вашому провіднику рішень у Visual Studio 2013.

Крок 3) Наступним кроком є ​​створення файлу веб-служби, який буде мати веб-службу RESTful

  1. Спочатку клацніть правою кнопкою миші на файлі проекту, як показано нижче
  1. На цьому кроці
    1. Клацніть правою кнопкою миші на файлі проекту
    2. Виберіть опцію "Додати-> новий елемент".

У діалоговому вікні, що з’явиться, потрібно виконати наступне

  1. Виберіть параметр WCF Service (з підтримкою Ajax) - Виберіть файл цього типу, це призведе до того, що Visual studio додасть базовий код, який допоможе створити веб-службу RESTful. WCF розшифровується як Windows Communication Foundation. WCF - це бібліотека для додатків різних платформ або однієї і тієї ж платформи для зв'язку через різні протоколи, такі як TCP, HTTP, HTTPS. Ajax - це в основному асинхронний JavaScript та XML. AJAX дозволяє асинхронно оновлювати веб-сторінки, обмінюючись невеликим обсягом даних із кулуарним сервером.
  2. Далі дайте назву сервісу, який у нашому випадку є TutorialService.
  3. Нарешті, натисніть кнопку Додати, щоб додати послугу до рішення.

Крок 4) Наступним кроком є ​​фактичне внесення змін до конфігурації, щоб цей проект міг завершити роботу з веб-службами RESTful. Для цього потрібно внести зміни до файлу, який називається Web.config . Цей файл відображається у тому ж вікні, що і файл проекту Webservice. Файл Web.config містить усі конфігурації, завдяки яким веб-програма працює належним чином. Внесені зміни фактично дозволяють програмі надсилати та отримувати дані як чисту веб-службу RESTful.

  1. Клацніть на файл Web.config, щоб відкрити код
  1. Знайдіть рядок
  1. Змініть рядок на

Крок 5) Наступним кроком у цьому підручнику RESTful API є додавання нашого коду для реалізації. Весь згаданий код повинен бути записаний у файл TutorialService.svc

  1. Перший біт - це додати код для представлення наших даних, які будуть використовуватися в нашій програмі. Отже, ми отримаємо список рядкових змінних зі значеннями "Масиви", "Черги" та "Стек". Це буде представляти назву навчальних посібників, доступних через наш веб-сервіс хостингу.
namespace Webservice.REST{[ServiceContract(Namespace = "")][AspNetCompatibilityRequirements(RequirementsMode = AspNetCompatibilityRequirementsMode.Allowedpublic class TutorialService{private static List  lst = new List  (new String[] {"Arrays","Queues","Stacks"});

Крок 6) Далі ми визначимо код нашого методу GET. Цей код також міститиметься в тому ж файлі TutorialService.svc. Цей код запускатиметься кожного разу, коли ми зателефонуємо до служби з нашого браузера.

Наведений нижче метод буде використаний для реалізації згаданого сценарію

  • Якщо користувачеві потрібен список усіх підручників, то для цього потрібно написати код нижче.
[WebGet(UriTemplate="/Tutorial")]public String GetAllTutorial(){int count = 1st.Count;String TutorialList = "";for (int i = 0; i < count; i++)TutorialList = TutorialList + lst[i] + ",";return TutorialList;}

Пояснення коду: -

  1. Перший рядок коду є найважливішим. Він використовується для визначення того, як ми можемо викликати цей метод за допомогою URL-адреси. Отже, якщо посиланням на наш веб-сервіс є http: // localhost: 52645 / TutorialService.svc, і якщо ми додаємо '/ Tutorial' до URL-адреси як http: // localhost: 52645 / TutorialService.svc / Tutorial , наведений вище код буде викликано. Атрибут 'WebGet' є параметром, який дозволяє цьому методу бути методом RESTful, щоб його можна було викликати за допомогою дієслова GET.
  2. Цей розділ коду використовується для перегляду нашого списку рядків у змінній 'lst' і повернення всіх їх до програми, що викликає.

Крок 7) Наведений нижче код гарантує, що якщо GET-дзвінок буде здійснено до Служби підручників з ідентифікатором навчального посібника, то він поверне відповідне ім'я підручника на основі ідентифікатора підручника.

[WebGet (UriTemplate = "/Tutorial/{Tutorialid}")]public String GetTutorialbyID(String Tutorialid){int pid;Int32.TryParse(Tutorialid, out pid);return lst[pid];}

Пояснення коду: -

  1. Перший рядок коду є найважливішим. Він використовується для визначення того, як ми можемо викликати цей метод за допомогою URL-адреси. Отже, якщо посиланням на наш веб-сервіс є http: // localhost: 52645 / TutorialService.svc, і якщо ми додаємо '/ Tutorial / {Tutorialid}' до URL-адреси, то ми зможемо викликати веб-службу як http: // //localhost:52645/TutorialService.svc/Tutorial/1 як приклад. Потім веб-службі потрібно буде повернути ім'я підручника, який мав ідентифікатор підручника №1.
  2. Цей розділ коду використовується для повернення "Імені підручника", що має ідентифікатор підручника, переданий веб-методу.
  • За замовчуванням потрібно пам’ятати, що те, що передається URL-адресі у браузері, є рядком.
  • Але ви повинні пам’ятати, що індекс до нашого списку має бути цілим числом, тому ми додаємо необхідний код, щоб спочатку перетворити Tutorialid у ціле число, а потім використовувати його для доступу до позиції індексу в нашому списку та
  • Потім поверніть значення програмі, що викликає, відповідно.

Крок 8) Наступним кроком є ​​написання коду для нашого методу POST. Цей метод буде викликаний кожного разу, коли ми хочемо додати значення рядка до нашого списку Підручників за допомогою методу POST. Наприклад, якщо ви хочете додати назву підручника "Тестування програмного забезпечення", вам доведеться використовувати метод POST.

Пояснення коду: -

  1. Перший рядок - це атрибут 'WebInvoke', який був доданий до нашого методу. Це дозволяє викликати метод за допомогою виклику POST. Атрибут RequestFormat та ResponseFormat слід згадувати як JSON, оскільки при розміщенні значень у веб-службі RESTFul значення повинні бути в цьому форматі.
  2. Другий рядок коду використовується для додавання значення рядка, переданого через виклик POST, до нашого існуючого списку рядків підручника.

Крок 9) Нарешті ми додамо наш метод для обробки операції DELETE. Цей метод буде викликаний, коли ми хочемо видалити існуюче значення рядка з нашого списку Підручників методом DELETE.

[WebInvoke(Method = "DELETE", RequestFormat = WebMessageFormat.Ison,UriTemplate = "/Tutorial/{Tutorialid}", ResponseFormat = WebMessageFormat.Json,BodyStyle = WebMessageBodyStyle.Wrapped)]public void DeleteTutorial(String Tutorialid){int pid;Int32.TryParse(Tutorialid, out pid);1st.RemoveAt(pid);}

Пояснення коду: -

  1. Перший рядок - це атрибут 'WebInvoke', який був доданий до нашого методу. Це дозволяє викликати метод за допомогою виклику POST. Атрибут RequestFormat та ResponseFormat повинні бути згадані як JSON, оскільки при розміщенні значень у веб-службі RESTFul значення повинні бути в цьому форматі. Зверніть увагу, що для параметра Method встановлюється значення "DELETE". Це означає, що кожного разу, коли ми видаємо дієслово DELETE, буде використано цей метод.
  2. Другий рядок коду використовується для отримання Tutorialid, надісланого за допомогою виклику DELETE, а потім видалення цього ідентифікатора з нашого списку. (Функція Int32 у коді використовується для перетворення ідентифікатора підручника із рядкової змінної у ціле число).

Запуск вашої першої веб-служби Restful

Тепер, коли ми створили весь наш веб-сервіс у наведеному вище розділі. Давайте подивимося, як ми можемо запустити службу підручника, щоб її можна було викликати від будь-якого клієнта.

Щоб запустити веб-службу, виконайте наведені нижче дії

Крок 1) Клацніть правою кнопкою миші на файлі проекту - Webservice.REST

Крок 2) Виберіть пункт меню "Встановити як стартовий проект". Це забезпечить запуск цього проекту, коли Visual Studio запускає все рішення

Крок 3) Наступним кроком є ​​запуск самого проекту. Тепер, залежно від встановленого в системі браузера за замовчуванням, відповідне ім’я браузера з’явиться поруч із кнопкою запуску у Visual Studio. У нашому випадку з’являється Google Chrome. Просто натисніть на цю кнопку.

Вихід: -

Коли проект запущено, ви можете переглянути ваш розділ TutorialService.svc / Tutorial, і ви отримаєте наведені нижче результати.

У наведеному вище результаті

  • Ви можете бачити, що браузер викликає дієслово 'GET' та виконує метод 'GetAllTutorial' у веб-службі. Цей модуль використовується для відображення всіх підручників, виставлених нашою веб-службою.

Тестування вашої першої веб-служби Restful

У наведеному вище розділі ми вже бачили, як за допомогою браузера виконувати дієслово „GET” та викликати „GetAllTutorial”.

  1. Давайте тепер використаємо браузер для виконання наступного сценарію використання.

GET Tutorial / Tutorialid - Коли клієнт викликає цей Restful API, йому буде надано ім'я підручника на основі Tutorialid, надісланого клієнтом

У своєму браузері додайте рядок / 1 після слова-підручника в URL-адресі. Якщо натиснути кнопку введення, ви отримаєте нижченаведений результат

Тепер ви побачите вихідні черги, які насправді відповідають номеру 1 у нашому списку рядків підручників. Це означає, що метод "GetTutorialbyID" тепер викликається з нашого веб-сервісу. Це також показує, що значення 1 успішно передається через браузер до нашої веб-служби та до нашого методу, і саме тому ми отримуємо правильне відповідне значення "Черги" у браузері.

  1. Далі давайте споживатимемо наш веб-сервіс, виконуючи наведений нижче сценарій. Для цього вам потрібно встановити інструмент під назвою "Скрипаль", який є безкоштовним інструментом для завантаження з сайту.

POST Tutorial / Tutorialname - Коли клієнт викликає цей Restful API, клієнт подасть запит на вставку імені підручника. Потім веб-служба додасть надіслану назву підручника до колекції.

Запустіть інструмент Filddler і виконайте наведені нижче дії;

  1. Перейдіть до розділу композитора. Це використовується для створення запитів, які можна подати до будь-якої мережі

    застосування.

  2. Переконайтеся, що тип запиту - "POST" та потрапляє правильна URL-адреса, яка в нашому випадку має бути http: // localhost: 52645 / TutorialService.svc / Tutorial
  3. Переконайтеся, що Content-Type позначено як application / json. Пам'ятайте, що наш метод запиту POST у нашій веб-службі приймає лише дані стилю json, тому нам потрібно переконатися, що це вказано під час надсилання запиту до нашої програми.
  4. Нарешті, нам потрібно ввести наші дані. Пам'ятайте, що наш метод для POST приймає параметр, який називається 'str.' Отже, тут ми вказуємо, що ми хочемо додати значення, яке називається «Дерева», до нашої колекції імен підручників та переконатися, що воно позначене як ім’я змінної str.

Нарешті, просто натисніть кнопку Виконати у скрипті. Це надішле запит до веб-служби для розміщення даних "Дерева" до нашої веб-служби.

Тепер, коли ми переходимо до URL-адреси підручника, щоб показати всі рядки у нашому підручнику, ви побачите, що значення "Дерева" також присутнє. Це свідчить про те, що запит POST до веб-служби було успішно виконано та успішно додано до нашого списку навчальних посібників.

  1. Далі давайте споживатимемо наш веб-сервіс, виконуючи наведений нижче сценарій. Для цього нам також потрібно використовувати інструмент скрипки

DELETE Tutorial / Tutorialid - Коли клієнт викликає цей Restful API, клієнт подасть запит на видалення імені підручника на основі Tutorialid. Потім веб-служба видалить надіслане ім’я підручника зі збірки.

Запустіть інструмент Filddler і виконайте наведені нижче дії

  1. Перейдіть до розділу композитора. Це використовується для створення запитів, які можна подати до будь-якої мережі

    застосування.

  2. Переконайтеся, що тип запиту - "ВИДАЛИТИ" та потрапляє правильна URL-адреса, яка в нашому випадку має бути http: // localhost: 52645 / TutorialService.svc / Tutorial . Переконайтеся, що ідентифікатор, який використовується для видалення рядка зі списку, надісланого через URL-адресу, як параметр. У нашому прикладі REST ми надсилаємо 1, таким чином це видалить 2- й елемент у нашій колекції, який називається "Черги".

Нарешті, просто натисніть кнопку Виконати у скрипті. Це надішле веб-службі запит на ВИДАЛЕННЯ даних "Черги" до нашої веб-служби.

Тепер, коли ми переходимо до URL-адреси підручника, щоб показати всі рядки у нашому списку підручників, ви помітите, що значення "Черги" більше не існує.

Це показує, що запит DELETE до веб-служби успішно виконано. Елемент з індексом № 1 у нашому списку рядків навчальних посібників успішно видалено.

Резюме

  • REST означає «Представницький державний трансфер». REST використовується для створення веб-сервісів, які є легкими, ремонтопридатними та масштабованими.
  • Все більше програм переходить до архітектури Restful. Це пов’язано з тим, що зараз багато людей використовують мобільні пристрої та широкий спектр програм, що переходять у хмару.
  • Основними аспектами REST є ресурси, що знаходяться на сервері, та дієслова GET, POST, PUT та DELETE, які можна використовувати для роботи з цими ресурсами.
  • Visual Studio та .Net можна використовувати для створення веб-служб Restful.
  • Під час тестування веб-служб на POST та PUT вам потрібно використовувати інший інструмент, який називається fiddler, який можна використовувати для надсилання запиту POST та PUT на сервер.