Работа с Player IO API part #4 - База данных (практика)

Настало время попрактиковаться. Начнём с основ и попробуем перейти к более сложным вещам. Однако раскрыть всю суть работы с базами данных в одном посте, к сожалению, не получится.

Попробуем выполнить различные операции с использованием обоих языков — AS3 и C#.

Работа со стандарной таблицей PlayerObject

Добавление объекта

PlayerObject таблица по умолчанию. И ключ объекта будет относиться к имени пользователя создавшего этот объект (имя пользователя указывается при соединении с Player IO сервером). Это значительно упращает работу с данной таблицей. Давайте попробуем загрузить таблицу во флеше и что-нибудь передать в качестве объекта.

AS3

private function handleConnect(client:Client) {
...
client.bigDB.loadMyPlayerObject(function(playerObject:DatabaseObject):void{
       playerObject.Name = "Noob";
       playerObject.Pass = "xxx";
       playerObject.save();
});
...
};

Получаем следующее:


Вложенность данных

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

AS3

private function handleConnect(client:Client) {
...
client.bigDB.loadMyPlayerObject(function(playerObject:DatabaseObject):void{
       playerObject.Name = "Noob";
       playerObject.Pass = "xxx";
       playerObject.Items = {item1:"sword",item2:"bow",item3:"gun"};
       playerObject.save();
});
...
};

C#

public override void UserJoined(Player player){
            ...
            player.PlayerObject.Set("Name", "Noob");
            player.PlayerObject.Set("Pass", "xxx");
            DatabaseObject items = new DatabaseObject(); 
            items.Set("item1", "sword"); 
            items.Set("item2", "bow"); 
            items.Set("item3", "gun"); 
            player.PlayerObject.Set("Items", items);
            player.PlayerObject.Save();
            ...
};

Вот что получаем:


Ну а для того, чтобы изменить значение переменной вложенного объекта стоит обратиться к нему соответственно вот так:

AS3

private function handleConnect(client:Client) {
...
client.bigDB.loadMyPlayerObject(function(playerObject:DatabaseObject):void{
       playerObject.Items.item1 = "super_sword";
       playerObject.save();
});
...
};

Работа с собственной таблицей

Добавление объекта с помощью AS3

(Проверяйте наличие созданной таблицы, объектов и переменных а также настройку прав доступа для таблицы, иначе вас ждут ошибки на этапе выполнения программы)

AS3

private function handleConnect(client:Client) {
...
client.bigDB.createObject("MyNewTable","NewObject",{"Name":"","Level":0});
...
};

В данном случае, в заранее созданную таблицу мы добавляем новый объект, и объявляем его переменные вот таким образом — {«Name»:"",«Level»:0}. Объявлять переменные не обязательно. Также не обязательно именовать созданный объект, однако, метод должен получить 3 аргумента. Если мы напишем в качестве имени объекта null, будет создан объект с ключём в виде уникального id. Если в качестве объявления переменных использовать null, будет создан пустой объект.

Также, метод позволяет добавлять callback и errorHandler функции после объявления переменных.

Добавление объекта с помощью C#

C#

public override void UserJoined(Player player){
      ...
      var MyNewObj = new DatabaseObject();
      MyNewObj.Set("Username", player.ConnectUserId);
      PlayerIO.BigDB.CreateObject("LoginRegistration", player.ConnectUserId, MyNewObj, null);
      ...
};

Стоит заметить, что в C# варианте аргумент callBack ожидаемый. Передаём либо null, либо реальную ссылку. А вот errorHandler здесь также, не обязателен.

Удаление объектов с помощью AS3

В Player IO существует 2 метода удаления объектов. Первый метод удаляет указанный по ключам массив объектов; второй метод удаляет объекты в заданных границах используя индекс. В данном посте, методы работы с базой данных с использованием индексов рассмотрены не будут.

AS3

private function handleConnect(client:Client) {
...
client.bigDB.deleteKeys("PlayerObjects",["guest176","guest45",username]);
client.bigDB.deleteKeys("MyNewTable",["guest176"]);
...
};

Удаление объектов с помощью C#

C#

public override void UserJoined(Player player){
      ...
      PlayerIO.BigDB.DeleteKeys("MyNewTable", new string[]{"MyObjectKey","MyObjectKey2"}); 
      ...
};

В обоих случаях, данным методом также удаляются объекты из стандартной таблицы PlayerObjects. Метод включает в себя не обязательные callback и errorHandler.

Загрузка объектов с помощью AS3

Загрузка объектов может быть произведена с использованием нескольких методов:

load() — загрузка объекта по указанному ключу из указанной таблицы.
loadOrCreate() — загрузка объекта по указанному ключу из указанной таблицы. Если объект отсутствует — будет создан новый объект с указанным ключём.
loadKeys() — загрузка объектов по указанным ключам из указанной таблицы.
loadKeysOrCreate() — загрузка массива объектов по указанным ключам из указанной таблицы. Если объекты отсутствуют — будут созданы новые объекты с указанными ключами.
Также существуют методы loadRange() и loadSingle(), с использованием индексов, которые, в данном посте, рассматриваться не будут. Про эти методы вы можете почитать в официальной документации Player IO здесь.

Так как эти методы практически аналогичны, рассмотрим для примера самый сложный — loadKeysOrCreate().

AS3

private function handleConnect(client:Client) {
...
client.bigDB.loadKeysOrCreate("MyNewTable",["Admin","Moderator","monster1"],function(dbarr:Array):void{
dbarr[0].Name = "cool";
dbarr[1].Name = "must die";
dbarr[2].Name = "big daddy";
for(var i:int=dbarr.length-1;i>=0;i--){
        dbarr[i].save();
   }
});
...
};

C#

public override void UserJoined(Player player){
      ...
      PlayerIO.BigDB.LoadKeysOrCreate("MyNewTable", new string[] { "dedmoroz1", "dedmoroz2" }, delegate(DatabaseObject[] result)
            {
                result[0].Set("Name", "Pavel");
                result[0].Save();
                result[1].Set("Name", "Petrovich");
                result[1].Save(); 
            }); 
      ...
};

Получение ключа объекта

Для того, чтобы получить ключ объекта используем конструкцию типа:

AS3

DatabaseObject.key;

C#

DatabaseObject.Key;

На этом, о работе с БД, пока всё. Каким будет следующим шаг «осады крепости» под названием Player IO? =)