it-swarm-ru.tech

Как написать API REST?

Я пишу приложение для iPhone в качестве хобби-проекта, и ему понадобится веб-сервис для предоставления данных. Это не сильно отличается от того, что я делаю на работе, но на работе я пишу только представления и контроллеры. Кто-то другой отвечает за написание модели, и обычно клиенты предоставляют веб-сервис.

Я занимался веб-программированием раньше, еще тогда, когда все использовали MySQL и PHP, поэтому мои навыки немного устарели, но я уверен, что смогу использовать их, используя методы, которые я уже знаю. Однако я не хочу тратить свое время на использование устаревших инструментов. Я понял, что в настоящее время можно написать API REST. Я думал, что должны быть некоторые довольно хорошие фреймворки, которые в значительной степени просто предоставляют вам REST API с функциональностью CRUD, как только вы определили модель.

Наверное, мой вопрос: какой самый быстрый способ получить и запустить REST API? Я действительно хочу сосредоточиться на написании приложения для iPhone и не тратить слишком много времени на этот API. Было бы замечательно, если бы я мог получить веб-администрирование и историю изменений тоже. Я также должен добавить, что API не должен быть общедоступным, поэтому поддержка аутентификации также будет отличной.

Просто быть чистым. Я не возражаю против PHP фреймворка. На самом деле это может быть лучше, так как я знаю, что мой текущий хостинг поддерживает это.

82
Erik B

Просто чтобы вы знали:

В конечном итоге я использовал Ruby в Rails.

РЕДАКТИРОВАТЬ: Поскольку этот ответ был отклонен из-за того, что он не указал причину выбора Ruby для Rails, а также нет инструкций по написанию API REST, я подумал, что дам вам мотивацию и несколько простых инструкций.

Я начал читать книгу о Ruby на Rails и ​​понял, что все, что мне нужно было сделать, - это использовать строительные леса, и я получил JSON REST API бесплатно.

Вот хорошее руководство по началу работы: http://guides.rubyonrails.org/getting_started.html

Когда ваша среда Ruby on Rails запущена и работает, создание API REST не сложнее, чем запуск:

$ Rails generate scaffold Post name:string title:string content:text

(Пример из приведенной выше ссылки.) Я также обнаружил, что Rails очень легко и свободно развернуть на herok , что означало, что мне не пришлось платить за хостинг для моего очень простой, с низким трафиком, REST API. Есть много других причин, почему я очень рад работать с Ruby на Rails, но это выходит за рамки этого вопроса.

8
Erik B

EDIT:

Ссылки ниже, которые, по-видимому, были хорошими в течение 3 лет, больше не работают, поэтому я пошел и нашел пару новых учебников, которые, я думаю, будут на некоторое время задерживаться. Они находятся на сайте Ray Wenderlich, очень уважаемом учебном сайте ios dev. Первая статья на самом деле ссылается на неработающие ссылки ниже, но она завершена сама по себе:

Как написать простой веб-сервис PHP/MySQL для приложения для iOS

и второй имеет небольшой поворот к этому. Он использовал parse.com на сервере и AFNetworking. Оба из которых довольно отлично.

Как синхронизировать основные данные с веб-сервисом - часть 1


Я исправил неработающие ссылки ниже, найдя статьи на обратном пути машины. Людям, похоже, нравятся ссылки, поэтому я их оставлю. Ссылки выше должны предоставить больше пищи для размышлений.


Я делаю то же самое с моим приложением для iPhone. Я нашел эту статью о создании RESTful API в PHP:

https://web.archive.org/web/20130910164802/http://www.gen-x-design.com/archives/create-a-rest-api-with-php/

и здесь также есть продолжение статьи:

https://web.archive.org/web/20130323001500/http://www.gen-x-design.com/archives/making-restful-requests-in-php/

со ссылкой на исходный код внизу статьи.

42
nickfox

Я следовал довольно простому руководству по созданию RESTful API с помощью PHP:

Кори Мейнард - Создание RESTful API с помощью PHP

Основная концепция включает в себя:

  • один абстрактный класс, который обрабатывает разбор URI и возвращает ответ, и
  • один конкретный класс, который состоит только из конечных точек для API.
8
jim_kastrin

Я запрограммировал API REST в ZEND Framework с помощью Zend_Rest_Controller на iPhone, который я использовал ASIHTTPRequest . Мой опыт с обоими, где хорошо. Вначале у меня были некоторые проблемы с настройкой ZEND и подключением его к mySQL, но как только я понял, как это сделать, я смог написать API очень быстро. Я могу поделиться с вами дополнительной информацией, если у вас возникнут дополнительные вопросы.

Правка: Кажется, нет официальной документации по Zend_Rest_Controller. Эта ссылка описывает, как использовать его для создания вашего API. Вам просто нужно отключить рендеринг в init() вашего подкласса и реализовать методы для каждого вызова REST.

8
Philipp Flenker

А как насчет Python?

Я бы использовал Python, Django и ​​Piston.

  1. Я бы сгенерировал модели Django из вашей существующей БД, используя inspectdb .
  2. Добавьте Django admin к своим моделям.
  3. Добавьте Django Piston в свое приложение.
  4. Прибыль.

Без опыта работы с Python или Django, вероятно, вам понадобится день, чтобы разработать это решение, и весь код будет проверен модулем и доказано, что он работает .

3
igorgue

Если вы хотите использовать PHP, я рекомендую использовать среду CodeIgniter с сервером REST Фила Стерджена:

http://net.tutsplus.com/tutorials/php/working-with-restful-services-in-codeigniter-2

https://github.com/philsturgeon/codeigniter-restserver

2
adamkrell

Извлеките следующий класс PHP, следующий за MVC. http://www.phpclasses.org/package/5080-PHP-Implement-REST-Web-services-servers.html

Надеюсь это поможет.

1
shauvik

Другим вариантом является restSQL, сверхлегкий каркас персистентности. Смотрите http://restsql.org . Он поддерживает MySQL и PostgreSQL и работает в стандартном контейнере Java EE, например, Apache Tomcat.

restSQL - очень нестандартный уровень доступа к данным. restSQL не является объектно-ориентированным представлением базы данных. Он представляет плоские или иерархические "представления" таблиц реляционных баз данных Эти представления могут запрашиваться и обновляться через простой HTTP-интерфейс на основе REST или API-интерфейс Java. HTTP-интерфейс основан на принципах REST, которые используют встроенные функции HTTP, а не абстрагируются от них.

Вам нужен "REST API с функциональностью CRUD", и это именно то, что нужно для restSQL. Вы можете сделать это без кода. Просто определите свои ресурсы SQL с помощью файлов XML и начните выполнять HTTP-вызовы против них с полной возможностью CRUD.

0
Mark Sawers

Вы должны использовать любые языки, которые вам нравятся, для веб-сервиса. Подойдет любой язык, который может формулировать REST ответы на запросы.

Тем не менее, если вы хотите быстро запустить что-то, я предлагаю использовать Python в Google App Engine. Это бесплатно, и вы можете использовать Java вместо Python, если хотите. App Engine поддерживает аутентификацию с использованием OpenID и/или учетных записей Google (не уверен, что они взаимоисключающие), так что это облегчит кодирование.

Что касается выполнения запросов на устройстве iOS, я предлагаю использовать ASIHTTPRequest .

0
Moshe

Если вы уже знаете PHP, нет ничего плохого в бэкэнде PHP/MySQL. Вы можете отправить все ответы в xml-формате, совместимом с iPhone, и мгновенно превратить ответ в структуру данных NSDictionary/NSArray/NSNumber с помощью этого короткого фрагмента кода:

NSString *response = [request responseString];
NSData* plistData = [response dataUsingEncoding:NSUTF8StringEncoding];
NSPropertyListFormat format;
NSString *errorStr;
NSDictionary* plist = [NSPropertyListSerialization propertyListFromData:plistData 
                                                       mutabilityOption:NSPropertyListImmutable 
                                                                 format:&format 
                                                       errorDescription:&errorStr];

Я также использую пакет ASIHTTP для формирования URL-адресов, отправки асинхронных запросов и получения ответов, я настоятельно рекомендую его:

http://allseeing-i.com/ASIHTTPRequest/

0
Bogatyr