iWiW Fejlesztői Blog

var IWIW = {};
IWIW.loadFriends = function(options) {
  // az objektumot később is fogjuk még használni, amikor a "this" más értékkel fog
  // bírni, ezért letároljuk az "obj" változóba
  var obj = this;
  // az ismerősök száma
  obj.totalSize = 0;
  // a params paraméterrel átadhatunk paramétereket a newFetchPeopleRequest hívásnak
  obj.params = options.params || {};
  // az ismerősök lekérdezését a legelején kezdjük
  obj.params[opensocial.DataRequest.PeopleRequestFields.FIRST] = 0;
  // és 50-et kérünk le (iWiW-en az egy csomagban lekérhető maximum)
  obj.params[opensocial.DataRequest.PeopleRequestFields.MAX] = 50;
  // a userId paraméter segítségével megmondhatjuk, hogy az OWNER vagy VIEWER
  // ismerőseire vagyunk-e kíváncsiak
  var userId = options.userId;
  // az onFirstFriends egy függvény, mely akkor hívódik meg, amikor az első ismerős
  // csomag megérkezik
  var onFirstFriends = options.onFirstFriends || function(){};
  // az onAllFriends egy függvény, mely akkor hívódik meg, amikor az összes ismerős
  // csomag megérkezett
  var onAllFriends = options.onAllFriends || function(){};
  // egy adatlekérés objektumot hozunk létre
  var request = opensocial.newDataRequest();
  // egy csoportot definiálunk: az alkalmazás nézőjének vagy tulajdonosának (userId) az ismerőseit
  obj.usergroup = opensocial.newIdSpec({"userId": userId, "groupId": "FRIENDS"});
  // a kéréshez hozzáadjuk az előbb definiált csoport lekérdezését, a választ
  // "friends0" néven fogjuk visszakapni
  request.add(request.newFetchPeopleRequest(obj.usergroup, obj.params), "friends0");
  // a függvény, mely az első adatlekérés után fut le
  var firstReady = function(response) {
    // itt a this értéke különbözik az eredeti objektumunktól,
    // ezért is használjuk az obj változót.
    // az obj.friends egy tömb lesz, melybe a válasz csomagokat pakoljuk
    obj.friends = [response.get("friends0").getData()];
    // a válaszban benne van az az információ, hogy összesen mennyi ismerős van, letároljuk
    obj.totalSize = obj.friends[0].getTotalSize();
    // a size értéke a jelen csomagban érkezett ismerősök száma (jellemzően 50, hacsak nincs
    // 50-nél kevesebb ismerőse a felhasználónak)
    var size = obj.friends[0].size();
    // a pozíció, ahol az ismerősök listájával járunk (0, 50, 100, stb. lesz)
    var pos = 0;
    // ha nem jött meg az összes ismerős, akkor...
    if (size < obj.totalSize) {
      // meghívjuk az első ismerősök megérkezésekor lefutó függvényt
      onFirstFriends(obj);
      // egy adatlekérés objektumot hozunk létre
      var request = opensocial.newDataRequest();
      // amíg nem érjük el az ismerősök számát...
      while (pos + size < obj.totalSize) {
        // következő csomag ott kezdődik, ahol az előző abbamaradt
        pos += size;
        // beállítjuk, hogy honnantól kezdje letölteni az ismerősöket, mi legyen az első elem
        obj.params[opensocial.DataRequest.PeopleRequestFields.FIRST] = pos;
        // a kéréshez hozzáadjuk a korábban már definiált csoport lekérdezését, a választ
        // "friendsXXX" néven fogjuk visszakapni, ahol az XXX a pozíció
        request.add(request.newFetchPeopleRequest(obj.usergroup, obj.params), "friends"+pos);
      }
      // elküldjük a több csomagot is tartalmazó kérést (második kérés)
      request.send(allReady);
    } else {
      // ha az első kérés során megjött az összes ismerős, akkor csak az onAllFriends kerül
      // meghívásra, mert már most tartalmazza az összes ismerőst.
      onAllFriends(obj);
    }
  }
  // a függvény, melyet a második lekérdezés válaszának megérkezésekor hívunk meg
  var allReady = function(response) {
    // csomag változó
    var package;
    // az első csomag végéről indulunk
    var pos = obj.friends[0].size();
    // ha nem értünk a végére, akkor...
    while (pos < obj.totalSize) {
      // a csomagot kivesszük a válaszból
      var package = response.get("friends"+pos).getData();
      // és betesszük az obj.friends tömbbe
      obj.friends.push(package);
      // növelkjük a pozíciót
      pos += package.size();
    }
    // meghívjuk az onAllFriends függvényt az összes ismerőssel
    onAllFriends(obj);
  }
  // elküldjük a lekérdezést, a függvény paramétere egy másik függvény,
  // ami akkor kerül meghívásra, amikor a szervertől megérkezik a válasz
  request.send(firstReady);
  // visszatérünk az IWIW.loadFriends objektumunkkal, ez egyelőre elég üres
  // de már beindítottuk az első lekérdezést, melyre hamarosan megjön a válasz
  return this;
};

// új kérés
new IWIW.loadFriends({
  // a tulajdonos ismerőseit fogjuk lekérdezni
  userId: "OWNER",
  // ha megjött az első adag ismerős
  onFirstFriends: function(response) {
    // az objektum friends tulajdonsága a fentebb emlegetett tömb
    var friends = response.friends;
    // a friends tömbnek még csak egy eleme van
    friends[0].each(function(person){
      // person.getDisplayName() használható, például
    })
  },
  // ha megjött az összes ismerős
  onAllFriends: function(response) {
    // az objektum friends tulajdonsága a fentebb emlegetett tömb
    var friends = response.friends;
    // végigmegyünk a tömb elemein, a csomagokon
    for(var i=0; i<friends.length; i++) {
      // minden csomagból kiolvassuk a benne levő személyeket
      friends[i].each(function(person){
        // person.getDisplayName() használható, például
      })
    }
  }
});