第十三步：Express API 路由（1/2）

第十三步：Express API 路由（1/2）

在這一節(jié)我們將實(shí)現(xiàn)一個(gè)Express路由，以獲取角色信息并存儲(chǔ)進(jìn)數(shù)據(jù)庫(kù)。我們將使用EVE Online API來(lái)獲取給定character name的Character ID，Race以及Bloodline。

注意：角色性別并不是公開數(shù)據(jù)，它需要一個(gè)API key。在我看來(lái)，讓New Eden
Faces變得非常棒的是它的開放生態(tài)：用戶并不需要登錄即可添加、查看EVE中的角色。這也是為什么我在表單里添加了性別選項(xiàng)讓用戶自己填寫的緣故，雖
然它的準(zhǔn)確性的確依賴于用戶的誠(chéng)信。

下面的表格列出了每個(gè)路由的職責(zé)。不過(guò)，我們不會(huì)實(shí)現(xiàn)所有的路由，如果需要的話你可以自己實(shí)現(xiàn)它們。

在server.js文件前面添加下列依賴：

var async = require('async');var request = require('request');

我們將使用async.waterfall來(lái)管理多異步操作，使用request來(lái)向EVE Online API發(fā)起HTTP請(qǐng)求。

將我們的第一個(gè)路由添加到Express中間件后面，在第8步創(chuàng)建的React中間件前面：

/**
 * POST /api/characters
 * Adds new character to the database.
 */
app.post('/api/characters', function(req, res, next) {
  var gender = req.body.gender;
  var characterName = req.body.name;
  var characterIdLookupUrl = 'https://api.eveonline.com/eve/CharacterID.xml.aspx?names=' + characterName;

  var parser = new xml2js.Parser();

  async.waterfall([
    function(callback) {
      request.get(characterIdLookupUrl, function(err, request, xml) {
        if (err) return next(err);
        parser.parseString(xml, function(err, parsedXml) {
          if (err) return next(err);
          try {
            var characterId = parsedXml.eveapi.result[0].rowset[0].row[0].$.characterID;

            Character.findOne({ characterId: characterId }, function(err, character) {
              if (err) return next(err);

              if (character) {
                return res.status(409).send({ message: character.name + ' is already in the database.' });
              }

              callback(err, characterId);
            });
          } catch (e) {
            return res.status(400).send({ message: 'XML Parse Error' });
          }
        });
      });
    },
    function(characterId) {
      var characterInfoUrl = 'https://api.eveonline.com/eve/CharacterInfo.xml.aspx?characterID=' + characterId;

      request.get({ url: characterInfoUrl }, function(err, request, xml) {
        if (err) return next(err);
        parser.parseString(xml, function(err, parsedXml) {
          if (err) return res.send(err);
          try {
            var name = parsedXml.eveapi.result[0].characterName[0];
            var race = parsedXml.eveapi.result[0].race[0];
            var bloodline = parsedXml.eveapi.result[0].bloodline[0];

            var character = new Character({
              characterId: characterId,
              name: name,
              race: race,
              bloodline: bloodline,
              gender: gender,
              random: [Math.random(), 0]
            });

            character.save(function(err) {
              if (err) return next(err);
              res.send({ message: characterName + ' has been added successfully!' });
            });
          } catch (e) {
            res.status(404).send({ message: characterName + ' is not a registered citizen of New Eden.' });
          }
        });
      });
    }
  ]);
});

注意：我一般在路由上面寫塊級(jí)注釋，包括完整路徑和簡(jiǎn)介，這樣我就能使用查找功能（Command+F）來(lái)快速尋找路由，如下圖所示：

下面就來(lái)按部就班的看一下它是如何工作的：

1. 利用Character Name獲取Character ID。
   
2. 解析XML響應(yīng)。
3. 查詢數(shù)據(jù)庫(kù)看這個(gè)角色是否已經(jīng)存在。
4. 將Character ID傳遞給async.waterfall中的下一個(gè)函數(shù)。
5. 利用Character ID獲取基本的角色信息。
   
6. 解析XML響應(yīng)。
7. 添加新角色到數(shù)據(jù)庫(kù)。

在瀏覽器打開http://localhost:3000/add 并添加一些角色，你可以使用下面的名字：

• Daishan Auergni
• CCP Falcon
• Celeste Taylor

或者，你也可以下載這個(gè)MongoDB文件dump并將它導(dǎo)入到你的數(shù)據(jù)庫(kù)，它包含4000以上個(gè)角色。如果你之前添加了其中的一些角色，可能會(huì)出現(xiàn)“duplicate key errors”錯(cuò)誤，不用管它：

• newedenfaces.bson

下載之后使用下面的命令將它導(dǎo)入到數(shù)據(jù)庫(kù)：

$ mongorestore newedenfaces.bson

鑒于我們還沒有實(shí)現(xiàn)相關(guān)的API，現(xiàn)在你還不能看到總的角色數(shù)，我們將在下下節(jié)來(lái)實(shí)現(xiàn)。

下面讓我們先創(chuàng)建Home組件，這是一個(gè)初始頁(yè)面，上面會(huì)并排顯示兩個(gè)角色。

（譯者注：下面會(huì)先第15節(jié)再第14節(jié)，原文如此）