Кумир святого Исидора

Nodejs. Первые шаги

() — Sun, 05 May 2013 23:20:00 GMT

Одна из самых больших проблем с nodejs - это отсутствие актуальных материалов для тех, кто начинает изучение платформы. Многие статьи сильно устарели и в них встречаются упоминания о том, что nodejs не запускается под Windows, хотя это уже давно не так.

Знакомство в nodejs требует одновременного изучения нескольких технологий и библиотек одновременно, для меня этот список выглядит примерно так (nodejs, express, mongodb, mongoose, asyncjs, mocha, jade vs haml, web sockets). Надо хотябы немного ознакомиться со всем этим, чтобы не изобретать собственные велосипеды на каждом шагу. Хотелось бы почитать что-нибудь связанное с общими подходами при организации кода в nodejs, модульном тестировании, изучить что-то более глубокое, чем одинаковые статьи-введения.

В прошлой статье о ноде, я ссылался на пару статей с habrahabr и теперь я нашел ее продолжение на гитхаб, в которой есть третья часть Контроллер страниц. Она еще не дописана и не так интересна, как предыдущие две.

Пенемногу ищу ответы на свои вопросы: Jade - Haml killer for nodejs и сравнительная таблица по этому же вопросу. Так как по умолчанию экспресс использует jade, то и я остановлюсь на нем.

Вот и видео про организацию кода подоспело. В оригинале оно называется Modular web applications with Node.js and Express, а его автор TJ Holowaychuk - это создатель Express, Jade, Stylus, and Mocha (три кодовых слова из моего набора)

В поисках нестарого видео по nodejs нашел парочку интересных источников (кончно же на английском), которыми спешу поделиться:

Node.js Step by Step - ссылка на первую (из пяти) часть руководства.

Node Tuts - это совсем свежее творение, последняя часть (на данный момент их 8) датируется матром 2013 года. Его оглавлене выглядит заметно интереснее, потому и начну я с него.

Первый эпизод, Introduction to Node, не обманул моих ожданий, хотя и не продемонстрировал чего-то нового. Многие обзорные статьи по node содержат примерно ту же информацию. Большинстов из них этим и ограничивается, но в даном случае впереди еще 7 уроков и их названия обещают интересное содержание.

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

В первом эпизоде автор расказывает об установке nodejs, и приводит пример создания веб-сервера "Hello World". Он объясняет разницу между блокирующим и неблокирующим кодом, демонстрирует пример многопоточного асинхронного кода и рассказывает о событийной (event-driven) модели, которая используется в nodejs.

В следующих постах непременно расскажу о других эпизодах руководства и поделюсь своими находками на пути изучения nodejs

Знакомство с nodejs

() — Thu, 02 May 2013 14:33:00 GMT

На горизонте появился проект с nodejs на серверной строне. Я давно хотел приступить к изучению этой технолгии и теперь мне совершенно точно не отвертеться. Пожалуй, начну.

Не стану рассказывать о том, как найти nodejs с помощью google, но упомяну те статьи и сайты, которые буду использовать в процессе обучения. Первый поисковый запрос "запуск express на nodejs" привел меня на хабр Web-разработка на node.js и express. Изучаем node.js на практике

Полезная привычка: начал что-то новое - заведи репозиторий на битбакет. Я предпочитаю mercurial из-за большей, по сравнению с git, дружелюбности.

Установка express

npm install -g express

Создание тестового приложения

express test cd test npm install

В итоге имеем проект почти на 2 мегабайта и содержащий 730 файлов. Запуск приложения

node app

На этом полезная часть хабра-статьи для меня закончилась, оставив на последок ссылку на книгу Node.js для начинающих. Во второй части статьи Web разработка на node.js и express. Глава 2 — тестирование приложения автор еще раз рассказывает о создании приложения и ипользовании git, а потом переходит к TDD.

Unit-тесты - это моя мечта. Однаждя я пробовал программировать с их использованием и это было действительно полезно, особенно в те моменты когда требовалось изменить что-то, от чего зависит половина модулей приложения. В моем нынешнем рабочем проекте нет автоматизированных тестов и потому я вынужден придумывать патчи. За два для до релиза, мне не хватает смелости исправить некоторые архитектурные решения, просто потому, что я не могу предсказать, как это скажется на компанентах, написанных моими коллегами.

{ "name": "application-name", "version": "0.0.1", "private": true, "scripts": { "start": "node app.js" }, "dependencies": { "express": "3.2.0", "jade": "*" }, "devDependencies": { "mocha": "*", "should": "*", "supertest": "*" } }

После изменения package.json вызываю npm install для загрузки библиотек для тестирования (попробую взять последние версии). Примеры тестов можно найти в статье, на которую я сослался выше, здесь же приведу только команду для их запуска.

node_modules\.bin\_mocha --require should --reporter spec

Следующий шаг - установка mongodb и запуск базы данных

C:\mongodb\bin\mongod.exe --dbpath C:\mongodb\data

Порт БД - 27017, Веб-интерфейс - 28017

Несколько команд для работы с MongoDB в качевтве сервиса Windows

C:\mongodb\bin\mongod.exe --config C:\mongodb\mongod.cfg --install net start MongoDB net stop MongoDB C:\mongodb\bin\mongod.exe --remove

Пытаюсь перейти от псевдотестов к чему-нибудь более реальному. Пока получается, что-то такое - код:

var mongoose = require('mongoose'); mongoose.connect('mongodb://localhost/test'); var db = mongoose.connection; module.exports = db;

Сам тест:

var db = require(__dirname + '/../db'); describe('Database', function() { describe('connection', function() { it('should opened w/o errors', function(done) { db.once('open', function callback () { done(); }); }) }) });

Вызов функции done означает успешное завершение теста, в противном случае будет сгенерировано сообщение об ошибке. Самы простой способ испробовать это на собственном опыте - остановить сервер базы данных. Осталось понять, насколько такой тест может быть полезен, проверят ли он что-то действительно важное или является еще одним сферическим конем?

Подборка библиотек для nodejs

Объединение ячеек в xlsx при использовании OpenTBS

() — Thu, 01 Nov 2012 17:28:00 GMT

Что-то давно я ничего не писал о PHP, к которому приходится обращаться все реже из-за моей нынешней любви к javascript. Однако, некоторые задачи попрежнему тяжело реализовать на клиенте и потому приходится вспоминать о серверных технологиях. В очередной раз мне потребовалось сгенерировать отчет в excel, точнее заполнить существующую форму данными.

Первначальное решение с помощью Excel.Automation требует наличия на каждой клиентской машине и грозит потенциальными проблемами с версиями MS Office. В поисках решения, я стал поглядывать в сторону шаблонных генераторов и не нашел практически ничего. Тут-то на глаза мне попался проект TBS, который с помощью своего плагина OpenTBS обещал мне золотые горы, в виде, генерации документов OpenXML (в том числе и xlsx) на основе шаблона.

Он действительно это умеет! При этом количесво кода, который нужно написать совсем невелико, в отличие от PHPExcel. Внешний вид полей задается небосредственно в шаблоне xslx-документа. Синтаксис полей в шаблоне прост и понятен. Ура!!! Лучше всего возможности OpenTBS демонстрируется на этой демо странице

Но! Куда же без этого. Плагин не имеет средств для построчного объединения ячеек при выводе списков и потому его пришлось немного доработать напильником, расширив шаблон параметром merge и написав для него соответсвующий обработчик. Теперь поле, для которого необходимо выполнить объединение должно задаваться примерно вот так:

[a.num;block=row;ope=xlsxMerge;merge=7:A:M]

В качестве значения merge испольуется строка с тремя параметрами base:start:end, где base - номер первой строки списка, start и end - начальный и конечный индесы объединения. Пример выше указывает, что необходимо объеденить ячейки A7:M7, A8:M8, A9:M9 и так далее, пока в выводимом списке есть значения.

Для запуска необходимо выполнить команду Merge Cells, которой я расширил плагин OpenTBS.

  $template = 'template.xlsx';
  if(!file_exists($template))
  {
    echo "file $template not found";
  }
  $TBS->LoadTemplate($template);
  $TBS->PlugIn(OPENTBS_SELECT_SHEET, 1);
  $TBS->MergeBlock('a', $data);
  $TBS->PlugIn(OPENTBS_MERGE_CELLS);
  $filename = "output.xlsx";
  $TBS->Show(OPENTBS_FILE+TBS_EXIT, $filename);

Модифицированная версия плагина и пример его использования доступны на GitHub OpenTBS with cells merge for xlsx

IT Дайджест #1

() — Wed, 10 Oct 2012 21:38:00 GMT

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

1. Node.js + Chromium = AppJS: один из перспективных вариантов второго шага эволюции веборазработчика

Ох, как близка мне эта тема, потому как сам ковыряю связку MFC + Chromium, да и node.js хочется попробовать уже давно.

2. Динамическое подключение Javascript на Javascript

Решение этой задачи, конечно же, тривиальное, но почему-то сразу не пришло в голову. Чтобы не гуглить его в следующий раз, сохраню в собственном блоге

var script = document.createElement('script');
script.type = 'text/javascript';
script.src = 'snip.js';
document.getElementsByTagName('head')[0].appendChild(script);

3. Стратегия для технического интервью

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

4. Включение чего угодно по HTTP без заморочек c OpenWRT

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

5. Pandoc - универсальный конвертер документов.

Pandoc это швейцарский нож, который помогает конвертировать различные текстовые форматы друг в друга. Документы предстваленные в markdown, reStructuredText, textile, HTML, DocBook, или LaTeX можно конвертировать в:

HTML форматы: XHTML, HTML5, а так же HTML слайд-шоу с использованием Slidy, Slideous, S5, или DZSlides
Форматы текстовых процессоров: Microsoft Word docx, OpenOffice/LibreOffice ODT, OpenDocument XML
Электронные книги: EPUB
Форматы документации: DocBook, GNU TexInfo, Groff man pages
TeX: LaTeX, ConTeXt, LaTeX Beamer slides
PDF через LaTeX
Текстовые форматы разметки: Markdown, reStructuredText, AsciiDoc, MediaWiki markup, Emacs Org-Mode, Textile

Pandoc распознает расширенный синтаксис markdown, включая мета-данные документа (заголовок, автор, дата), колонтитулы, таблицы, списки, индексыб перечеркнутый текст, выделенные блоки кода с подсветкой синтаксиса, умные кавычки и прочее. При необходимости использовать строгий markdown все расширения можно отключить.

Описание обещает столько вкусного, что я хочу использовать этот инструмент не только для генерации .docx в одном из текущих проектов, но и для написания статей в блоге (сейчас я пишу их в текстовом редакторе, при необходимости вставляя html-разметку)

6. Лучшее с хабра

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

7. Инструкция начинающего разработчика игр

Статья рассказывает о том, почему не надо писать игры. Иногда я все еще подумываю об этом, но пока все мои начинания сводятся к созданию концепции. Скорее я отважусь на создание своей настолки - пока есть интересная механика, но никак не придумаю какими же тварями населить игру.

P.S.

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

Динамические CSS стили в knockout

() — Fri, 21 Sep 2012 16:56:00 GMT

В knockoutjs достаточно удобная система шаблонизации, которая, кроме всего прочего, позволяет использовать вложенные шаблоны. В последний раз я столкнулся с ними, когда делал некоторое подобие CRUD на javascript. Кроме всего прочего мне потребовалась устанавливать стили тем элементам, которые создавались с помощью шаблонов. Причем информация о внешнем виде редактора и его полей хранится в прототипе конструктора.

В поисках решения я наткнулся на блог, который предлагает вот такое решение для динамического назначения стилей - How to use a computed observable in KnockoutJS CSS binding

На его основе я сделал небольшой, пример, который показывает код в действии

function viewModel() {
    var self = this,
        defs = {
            name: "base",
            color: false,
            background: false,
            bold: true
        }
        ko.mapping.fromJS(defs, {}, self);

    self.style = ko.computed(function() {
        return {
            red: self.color(),
            yellow: self.background(),
            bold: self.bold()
        };
    })
};

$(function() {
    vm = new viewModel();
    ko.applyBindings(vm);
});

Демо на jsfiddle

Loginza. Проблема с авторизацией с вКонтакте

() — Tue, 18 Sep 2012 10:06:00 GMT

Проблемы у loginz'ы со входом в Контакт подтвердились. И скорость их решения заставляет задуматься о поиске альтернативы, например, uLogin

Ниже приведен комментарий от службы поддержки, yandex, которым в настоящее время принадлежит loginza.

Приношу свои извинения за задержку с ответом.

Проблема связана с тем, что сервис Вконтакте неожиданно и без предупреждения изменили собственную документацию, поэтому возникла проблема с авторизациями не только у сервиса Loginza, но и у других сайтов. Мы работаем над проблемой с нашей стороны, постараемся решить её в ближайшее время.

Желание яндекса оперативно решить проблему радует, но судя по сообщениям на странице с обсуждением проблемы (Выдаёт ошибку: sign validation Invalid session or session signature) такая канитель продолжается уже неделю. Похоже, что яндекс не знает, как извлечь прибыль из логинзы и потому решил похоронить сервис. Я не верю, что изменение API со стороны контакта требует титанических усилий для исправления ошибки.

knockoutjs. Интеграция chosen

() — Tue, 18 Sep 2012 00:02:00 GMT

Для меня навсегда останется загадкой, почему разработчики браузеров не потрудились создать красивый выпадающий списко select. К счастью, есть плагин chosen, который успещно заменяет стандартные списки. Именно о его интеграции knockoutjs и пойдет речь.

Прежде, чем изобретать собственный велосипед я обратился к всезнающему (и потому пугающему) гуглу и нашел тех, кто уже сталкивался с подобной проблемой Does not work with Knockout.js и её решение. Там же можно найти ссылку на рабочий пример, однако не сложно убедиться, что он не работает, достаточно для первого списка так же указать knockout.binding chosen

Итак, нужно создать custom binding, который позволит использовать привязку данных knockoutjs и интерфейс chosen. После нескольких попыток у меня получилось следующее

ko.bindingHandlers.chosen =
{
  init: function(element)
  {
    $(element).addClass('chzn-select');
    $(element).chosen();
  },
  update: function(element)
  {
    $(element).trigger('liszt:updated');
  }
};

Для вызова использовался вот такой код

data-bind="options: items,
           optionsText: 'name',
           optionsCaption: 'Select item...',
           value: selectedItem,
           chosen: {}"

Однако код не заработал, так как мне было нужно, потому что не обновлялось привязанное значение при изменении значения в списке. Стоило убрать вызов chosen и все работало, как часы. Но каждая попытка использовать плагин снова приводила к неудаче, selectedItem не изменял своекл значения.

Оказалось, что knockout не устанавливает атрибут value, а без него chosen не отличет один элемент от другого и потому не посылает сообщение о новом значении селектора. Решить проблему со стороны knockout не получилось и потому пришлось править файл chosen.jquery.js

Потребовалось изменить лишь одну строку, отключив проверку на изменение value в методе Chosen.prototype.result_select

//if (this.is_multiple || this.form_field_jq.val() !== this.current_value)
        {
          this.form_field_jq.trigger("change", {
            'selected': this.form_field.options[item.options_index].value
          });
        }

Посмотреть, как все это работает можно на jsFiddle

Отладка mod_rewrite

() — Sat, 08 Sep 2012 09:16:00 GMT

Каждый раз работа с .htaccess и mod_rewrite становится для меня испытанием. Я не так часто сталкиваюсь с ними и потому мои знания несколько разрозненны, да и логи, которые предлагается использовать в качестве средства отладки доступны далеко не всегда. Уже несколько раз я сталкивался с ситуацией, когда .htaccess переставал работать при переносе файлов с локальной машины на сервер.

Включение логов для mod_rewrite

<IfModule mod_rewrite.c>
RewriteLog "/home/rob4/www/logs/rewrite.log"
RewriteLogLevel 3
</IfModule>

Недавно наткнулся на статью, которая предлагает использовать возможности самого mod_rewrite для отладки

RewriteCond %{QUERY_STRING} !vardump
RewriteRule (.*) %{REQUEST_URI}?vardump=1&r=%{REQUEST_URI} [R=302,L,QSA]

Все запросы будут обработаны этим правилом и для каждого из них сервер выполнит редирект, выведя в строке запроса необходимые параметры. В данном случае get-переменная r - будет содержать запрос (REQUEST_URI). Аналогичным образом можно вывести другие переменные.

Переменная vardump используется для того, чтобы избежать зацикливания mod_rewrite и гарантировать, что правлио будет использовано лишь однажды, для каждого запроса.

JavaScript. Отмена прехода к предыдущей странице при нажатии Backspace

() — Fri, 31 Aug 2012 22:56:00 GMT

Последний раз я писал в блог месяц назад - в последний день июля. С тех пор я побывал в отпуске и снова успел устать, с головой окунувшись в работу. Которой, как обычно, больше, чем я когда-либо смогу сделать. Считая проекты, в которые я вовлечен, я сбился, когда закончались пальцы на руке. Удручает, что совсем не остается времени на собственные задумки, вновь отложены в сторону учет личных финансов и GTD. Я вернусь к ним. Позже. Наверно.

Я думаю, так происходит из-за отсутствия быстрого результата. Хочется очень кортоких проектов в противовес тому, что приходится делать на работе - когда разработка программы длится месяцами. Попробую сосредоточиться (в очередной раз) на каких-то вещах, которые мне действительно интересны. Надеюсь, что в сферу моих нынешних увлечений попадет и этот блог.

Я же пишу код почти каждый день, так почему не могу выдать несколько мыслей по этому поводу на станицах блога. Может от того, что боюсь написать банальщину?Может потому, что объяснить десятичасовой поиск ошибки, не представляется возможным, без подробного описания проекта? Может быть из-за лени?

Я попробую снова что-то изменить? Если не пытаться, то уж точно ничего не получиться.

К делу:

Я многократно писал о своей любви к веб-интерфейсу даже в обычных приложениях. Потому приходится решать проблемы свойственные браузерам. Например, Internet Explorer обладает неприятной особеннойстью переходить к предыдущей странице, при нажатии кнопки Backspace. Причем это происходит даже в том случае, когда фокус находится в поле ввода (input) или textarea. Гугл помог отыскать решение для этой проблемы, которое я не хочу потеряти и потому публикую здесь.

function killBackSpace(e)
{
  e = e ? e : window.event;
  var t = e.target ? e.target : e.srcElement ? e.srcElement : null;
  if(t && t.tagName && (t.type && /(password)|(text)|(file)/.test(t.type.toLowerCase()))
  || t.tagName.toLowerCase() == 'textarea')
  {
    return true;
  }
  var k = e.keyCode ? e.keyCode : e.which ? e.which : null;
  if (k == 8)
  {
    if (e.preventDefault)
    {
      e.preventDefault();
    }
    return false;
  };
  return true;
};

if(typeof document.addEventListener!='undefined')
{
  document.addEventListener('keydown', killBackSpace, false);
}
else if(typeof document.attachEvent!='undefined')
{
  document.attachEvent('onkeydown', killBackSpace);
}
else
{
  if(document.onkeydown!=null)
  {
    var oldOnkeydown=document.onkeydown;
    document.onkeydown=function(e)
    {
      oldOnkeydown(e);
      killBackSpace(e);
    };
  }
  else
  {
    document.onkeydown=killBackSpace;
  }
}

jsFiddle. Тестирование JSONP

() — Mon, 30 Jul 2012 17:37:00 GMT

Я - консерватор. Это не самое лучшее качество для программиста из-за стремительного изменения технологий в IT. Чтобы угнаться за ними, надо как можно чаще использовать новинки. Я же, больше года тянул с тем, чтобы попробовать jQuery, долго изобретал собственный велосипед, убеждая себя и других, что knockoutjs не подойдет для нашего проекта. Теперь стараюсь наверстать упущенное и потому знакомлюсь, с TDD, XP, юнит-тестированием и прочими IT-новинками, открывая для себя технологии, которые для других программистов уже стали привычными инструментами.

Чтобы избавиться от большого количества тестовых страничек, разбросанных по моему HDD, я решил ближе познакомиться с jsFiddle. Непременно наделаю себе базовых проектов на все случаи жизни и буду активно ими пользоваться. Лучше всего изучать что-то на конкретном примере и мой выбор пал на JSONP, протокол, который, в скором времени, понадобится в одном из моих проектов, для кросс-доменной передачи запросов.

Вот результат моих экспериментов, во время которых я познакомился с тем, как jQuery взаимодействует с echo-сервисом jsFiddle и написал свой собственный echo-script на php

var data = {
      json: ko.toJSON({
          id: 12345,
          name: 'Legion',
          isReal: true
      }),
      delay: 1
    },
    vm = {
        json: ko.observable('json'),
        onJSON: function() {
            $.ajax({
                type: 'post',
                url: '/echo/json/',
                dataType: 'json',
                data: data,
                success: function(js) {
                    vm.json(ko.toJSON(js) + ' ' + (new Date()).getTime());
                }
            });
        },
        jsonp: ko.observable('jsonp'),
        onJSONP: function() {
            $.ajax(
            jsonpData);
        },
        nittis: ko.observable('nittis'),
        onNittis: function() {
            $.ajax(
            nittisData);
        }
    },
    jsonpData = {
        type: 'post',
        url: 'http://jsfiddle.net/echo/jsonp/',
        dataType: 'jsonp',
        data: data,
        success: function(js) {
            vm.jsonp(js.json + ' ' + js._);
        }
    },
    nittisData = {};

$.extend(nittisData, jsonpData);
nittisData.success = function(js) {
    vm.nittis(js.json + ' ' + js._);
};
nittisData.url = 'http://it.nittis.ru/jsonp.echo.php';

ko.applyBindings(vm);

  extract($_GET);
  $arr['json'] = $json;
  $arr['_'] = $_;
  $out = json_encode($arr); 
  $out = "$callback($out);";
  echo $out;

Программирование должно быть веселым занятием, чтобы приносить не только деньги, но и удовольствие. jsFiddle определенно делает работу веселее.

Knockout JS. Плагин mapping

() — Fri, 27 Jul 2012 11:51:00 GMT

Никак не могу проснуться сегодня. Попробую сделать это с помощью небольшой статьи для блога. Сегодня я возвращаюсь к описанию knockout.js и хочу рассказать о замечательной плагине mapping. Плагин настолько хорош, что только он удостоился ссылки с официального сайта knockoutjs.com

Плагин mapping испольуется для создания knockout-модели на основе javascript-модели и, естественно, для обратного преобразования. Очень часто плагин используется для преобразования данных полученых с сервера от backend-приложения.

//пример создания модели на основе полученных данных
var viewModel = ko.mapping.fromJS(data);
...
//обновление модели
ko.mapping.fromJS(data, {}, viewModel);

Все свойства объекта data будет пребразованы в observable или observableArray, в зависимости от своего типа.

Для обратного преобразования модели в объект используется функция ko.mapping.toJS. При этом в полученном объекте будут присутствовать только те свойства, которые были в исходном объекте при вызове ko.mapping.fromJS

  var data = {id: '1', name: 'Ann'};
  var model = ko.mapping.fromJS(data);
  model.job = 'Pretty girl';
  console.log(typeof(model.job)); // >> string
  var js = ko.mapping.toJS(model);
  console.log(typeof(js.job)); // >> undefined

Advanced usage

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

Опция update позволяет определить функцию, которая будет вызвана, если свойство с определенным именем уже существует в обновляемом объекте.

С помощью опции ignore можно указать имена свойств, которые не должны обрабатываться при формировании модели.

include позволяет дополнить список свойств, которые будут использоваться при обратном преобразовании с помощью функции ko.mapping.toJS

copy задает список свойств, которые должны быть скопированы при формировании модели без изменений. То есть они не будут преобразованы в observable или observableArray

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

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

create - позволяет определить функцию, которая будет вызвана при обработке каждого элемента массива. Её можно использовать, для вызова функции-конструктора и создания объектов нужного типа.

Пример

В своем проекте по учету линых финансов, я использую плагин mapping для сохранения и загрузки информации о счетах. Вот как выглядят функции загрузки и сохранения.

account.prototype.save = function()
{
  return this.ajax('save', ko.mapping.toJS(this));
};

account.prototype.load = function()
{
  var self = this;
  var promise = this.ajax('load', {})
    .done(function()
    {
      var json = this;
      var mapping = 
      {
        'transfers' : 
        {
          create: function(options)
          {
            return transfer(options.data);
          }
        }
      }
      ko.mapping.fromJS(json[getType(self)], mapping, self);
    });
  return promise;    
};

Функция ajax() отправляет асинхронный запрос на сервер, который, в случае опреации load возаращает данные завернутые в JSON. В полученном объекте, хранится массив transfers, содержащий информацию обо всех движениях средств по счету.

Функция transfer, которая вызывается для обработки элементов массива - это функция конструктор, которая выглядит примерно вот так:


function transfer(data)
{
  if(!(this instanceof transfer))
  {
    return new transfer(data)
  }
  var self = this; 

  var defs = 
  {
    id: getKey(),
    date: round((new Date()).getTime() / 1000, 0), /* fix for php */ 
    sum: 0.0,
    from: 0, 
    to: 0
  };

  $.extend(defs, data);

  ko.mapping.fromJS(defs, {}, self);

  ...
}

На github этот код можно обнаружить в этой ревизии