Вступление

Хочу оговориться сразу, что библиотека для работы с api вконтакте, которую я изначально разрабатывал на C# (.net 2.0) не является для меня приоритетной. Я занимаюсь этой библиотекой в свободное время, или когда скучно.

История библиотеки C# api вконтакте

Изначально эта библиотека разрабатывалась для предоставления пользователю низкоуровневого функционала для работы с api вконтакте. Т.е. пользователь библиотеки сам формировал запрос используя методы Method(string methodName), и передавая параметры используя метод Param(string paramName, string paramValue). На выходе пользователь получал ответ от api в виде xml или json(в зависимости от настроек). Так появился ApiManager - базовый класс библиотеки. Именно на нем основана работа в дальнейшем появившихся в библиотеке оберток над основными методами api вконтакте. Классы MessageFactory, ActivityFactory, и прочие фабрики формируют запросы к api вконтакте используя экземпляр ApiManager, а полученный ответ обрабатывают и на его основе формируют объектную модель ответов.

Появление фабрик в библиотеке. Наглядные примеры

После некоторых экспериментов с api вконтакте я решил дописывать свою библиотеку таким образом, чтобы с api можно было работать на уровне объектов. Допустим, мы хотим получить список входящих сообщений. Изначально это можно было сделать так:

ApiManager manager = new ApiManager(<app_id>, <session_data>);
string xmlResp = manager.Method("messages.get").Execute();
XmlDocumend doc = new XmlDocument();
doc.LoadXml(xmlResp);
XmlNodeList messages = doc.SelectNodes("/response/message");
// и так далее

Как только я ввел фабрики, получение входящих сообщений сразу упростилось:

MessagesFactory mf = new MessagesFactory(manager);
List<Message> messages = mf.Get(MessageType.Incoming, null, null, null, null, null);

Теперь у нас есть список входящих сообщений. Они никак не отфильтрованы, и возвращены только последние 100 штук.

Чтобы получить какие то другие сообщения, с учетом фильтров вместо последних 5 параметров, которые в примере установлены в null, можно указать какие то данные.

Все методы фабрик и классов задокументированы при помощи стандартного XmlDoc Visual Studio.

Точно так же можно поступать и с другими методами из api вконтакте, для которых существуют фабрики-обертки.

На каких языках можно разрабатывать свои приложения с моей библиотекой

На любых managed языках, которые используют платформу .NET 2.0 и выше.

Уже реализовано в библиотеке

В версии моей библиотеки, которая выйдет под версией 0.6.2 beta реализованы следующие фабрики:

• ActivityFactory - позволяет работать со статусами
• FriendsFactory - позволяет работать со списками друзей
• MessagesFactory - позволяет работать с личными сообщениями
• WallFactory - позволяет работать со стеной
• OffersFactory - позволяет работать с сервисом предложений
• QuestionsFactory - позволяет работать с сервисом вопросов

Заключение