Что делает "res.render", и как выглядит файл html?

Что делает res.render, и как выглядит файл html?

Моя конечная цель - загрузить произвольные значения, разделенные запятыми, из текстового файла в html файл (например). Я мог только вывести, что представление было html файлом, а callback возвращает этот html файл.

Вот документация: http://expressjs.com/api.html#res.render.

Теперь, учитывая контекст из некоторого кода кода, который я нашел, есть что-то об использовании ejs (встроенного javascript) с <% и %>.

Но если я могу добавить, я просто некомпетентен или действительно действительно расплывчатая документация и предполагает, что читатель все знает? Как я мог разобраться с этим? Есть ли официальная документация, чтобы я мог получить полное представление об использовании, преимуществах и ошибках?

Изменить 1

Я просто хочу добавить, что у меня чертовски время обучения node.js. Это я или общая документация действительно расплывчата? Помимо паршивых объяснений, как описано выше, спецификаций типа для параметров или возвращаемых значений нет.

Изменить 2

Позвольте мне задать вам несколько более конкретных вопросов над кодом.

Фактический orders.ejs файл находится в views/orders.ejs. Как этот код ссылается на него?

Отрывок из HTML:

<tbody>
  <% for(var i=0; i<orders.length; i++) {%>
     <tr>
       <td><%= orders[i].id %></td>
       <td><%= orders[i].amount %></td>
       <td><%= orders[i].time %></td>
     </tr>
     <% } %>

И js. Пожалуйста, смотрите/заказы:

  // Define routes for simple SSJS web app. 
// Writes Coinbase orders to database.
var async   = require('async')
  , express = require('express')
  , fs      = require('fs')
  , http    = require('http')
  , https   = require('https')
  , db      = require('./models');

var app = express();
app.set('views', __dirname + '/views');
app.set('view engine', 'ejs');
app.set('port', process.env.PORT || 8080);

// Render homepage (note trailing slash): example.com/
app.get('/', function(request, response) {
  var data = fs.readFileSync('index.html').toString();
  response.send(data);
});

// Render example.com/orders
app.get('/orders', function(request, response) {
  global.db.Order.findAll().success(function(orders) {
    var orders_json = [];
    orders.forEach(function(order) {
      orders_json.push({id: order.coinbase_id, amount: order.amount, time: order.time});
    });
    // Uses views/orders.ejs
    response.render("orders", {orders: orders_json});
  }).error(function(err) {
    console.log(err);
    response.send("error retrieving orders");
  });
});

// Hit this URL while on example.com/orders to refresh
app.get('/refresh_orders', function(request, response) {
  https.get("https://coinbase.com/api/v1/orders?api_key=" + process.env.COINBASE_API_KEY, function(res) {
    var body = '';
    res.on('data', function(chunk) {body += chunk;});
    res.on('end', function() {
      try {
        var orders_json = JSON.parse(body);
        if (orders_json.error) {
          response.send(orders_json.error);
          return;
        }
        // add each order asynchronously
        async.forEach(orders_json.orders, addOrder, function(err) {
          if (err) {
            console.log(err);
            response.send("error adding orders");
          } else {
            // orders added successfully
            response.redirect("/orders");
          }
        });
      } catch (error) {
        console.log(error);
        response.send("error parsing json");
      }
    });

    res.on('error', function(e) {
      console.log(e);
      response.send("error syncing orders");
    });
  });

});

// sync the database and start the server
db.sequelize.sync().complete(function(err) {
  if (err) {
    throw err;
  } else {
    http.createServer(app).listen(app.get('port'), function() {
      console.log("Listening on " + app.get('port'));
    });
  }
});

// add order to the database if it doesn't already exist
var addOrder = function(order_obj, callback) {
  var order = order_obj.order; // order json from coinbase
  if (order.status != "completed") {
    // only add completed orders
    callback();
  } else {
    var Order = global.db.Order;
    // find if order has already been added to our database
    Order.find({where: {coinbase_id: order.id}}).success(function(order_instance) {
      if (order_instance) {
        // order already exists, do nothing
        callback();
      } else {
        // build instance and save
          var new_order_instance = Order.build({
          coinbase_id: order.id,
          amount: order.total_btc.cents / 100000000, // convert satoshis to BTC
          time: order.created_at
        });
          new_order_instance.save().success(function() {
          callback();
        }).error(function(err) {
          callback(err);
        });
      }
    });
  }
};

Ответы

Ответ 1

Что делает res.render и как выглядит файл html?

res.render() функция компилирует ваш шаблон (пожалуйста, не используйте ejs), вставляет туда locals и создает html-выход из этих двух вещей.

Ответ на Редактировать 2.

// here you set that all templates are located in `/views` directory
app.set('views', __dirname + '/views');

// here you set that you're using `ejs` template engine, and the
// default extension is `ejs`
app.set('view engine', 'ejs');

// here you render `orders` template
response.render("orders", {orders: orders_json});

Итак, путь шаблона views/ (первая часть) + orders (вторая часть) + .ejs (третья часть) === views/orders.ejs

В любом случае, документация express.js хороша для того, что она делает. Это ссылка на API, а не "как использовать книгу node.js".