README.md

CodeWe1302JavaScript

Coding Weekend Project 2013-02 JavaScript Framework Evaluation

• Allgemeines
• 1. Einführung
• 2. Grundlagen zum JavaScript-Stack
• 3. JavaScript-Frameworks
• 4. Testumfeld
• 5. Evaluierung
• 6. Zusammenfassung und Fazit
• Referenzen

Allgemeines

Struktur

• Ausarbeitung für Whitepaper in diesem Repo
• Entwicklung von Testapplikationen in ausgelagerten Repos (Teilprojekte)

Verzeichnis der Projekt-Repos mit umgesetzten Testapplikationen

• AngularJS & AngularUI mit Bootstrap und jQueryUI
  • https://github.com/dataduke/CodeWe1302AngularJs
• Backbone.js mit Underscore.js und Docco
  • https://github.com/sebastianfuss/backbone-test
• JavaScriptMVC mit StealJS, DocumentJS, jQuery und FuncUnit (QUnit, Selenium, Jasmine)
  • https://github.com/realthargor/javascriptMVCCodingWe

1. Einführung

Projektmotivation

Für mehrschichtige Applikationen (Multitier Enterprise Applications) bestehen neben den Möglichkeiten, welche der Java- oder .NET-Stack bietet, eine Vielzahl an JavaScript-Frameworks um den Frontend-Layer (Tier) zu gestalten.

Aktuell ist die mögliche Auswahl an verfügbaren und aktuellen Frameworks, welche auf JavaScript (JS) setzen, in der Tat so hoch, dass die genauen Vor- und Nachteile der einzelnen Lösungen hinsichtlich Verfügbarkeit und Aktualität der Projektdokumentation, Einarbeitungszeit, Dauer und Qualität des Framework-Lifecycles sowie deren technische Eleganz bei der Implementierung, nicht bekannt oder hinreichend dokumentiert vorzufinden ist.

Um eine Entscheidungsbasis über die allgmeine Reife für den Einstatz in industriellen Großprojekten zu etablieren, oder gar die Entscheidung für eine bestimmte Kombination an JavaScript-Rahmenwerken zu ermöglichen soll ein Vergleich diverser JS-Frameworks pragmatisch vollzogen werden.

Grundidee

• Evaluierung ausgewählter JavaScript-Frameworks durch Realisierung einer äquivalenten Testapplikation
• Vergleiche hierzu ähnliches Projekt mit ToDo-App als Referenz: http://addyosmani.github.com/todomvc/

2. Grundlagen zum JavaScript-Stack

Aufbau des Frontends (Layers und Dependencies)

Top-Down-Architektur:

1. Eigene Applikation (Testapplikation)
2. JS Framework (Framework zur Evaluierung)
3. jQuery und andere JS Framework Dependencies (on Top von Protoype/Utilities)
4. PrototypeJS und/oder andere Utility-Frameworks (Low-Level-Funktionen und Patterns für Objekte)
5. JavaScript

Funktionalitäten von JS-Frameworks

Gemeinsamkeiten (Häufige Standards):

• Templating
• Model-Binding
• Pageflow, Routing
• Messages, REST
• JS Dokumentation

Unterschiede:

• Patterns: MVC (Model-View-Controller) vs. MVVM (Model-View-ViewModel)

3. JavaScript-Frameworks

Ausgewählte Testkandidaten

• AngularJS (http://angularjs.org/, http://www.youtube.com/user/angularjs) & AngularUI (http://angular-ui.github.com/)
  • [DONE] TestApp Build mit Bootstrap, jQueryUI
• Backbone.js (http://backbonejs.org/)
  • [DONE] TestApp Build mit Underscore.js, Docco
• Ember.js (http://emberjs.com/)
• Knockout (http://knockoutjs.com/)
• JavaScriptMVC (http://javascriptmvc.com/)
  • [DONE] TestApp Build mit StealJS, DocumentJS, jQuery, FuncUnit (QUnit, Selenium, Jasmine)

Kurzvorstellung und Beschreibungen

siehe Dokumentation in einzelnen Projekt-Repos

4. Testumfeld

Geschäftsprozess

Kundenerfassung mit Personendaten, Adressdaten und Bestätigung der gemachten Angaben.

Felder der Testapplikation (Referenzimplementierung)

Personendaten (Page):

• Name und Vorname: Text-Fields (required)
• Geburtstag: Date-Field mit DatePicker (required)
• Kreditkarten Nummer: Number-Field (required, genau 10-stellig)

Adressdaten (Page):

• Land: Drop-Down-Box (required, mit Default-Wert)
• Strasse und Hausnummer: Text-Field und Number-Field (required)
• PLZ und Ort: Number-Field (Validierung mit automatischer Befüllung des Ortes)
• Wohnhaft seit: Date-Field mit DatePicker (required)
• if (Wohnhaft seit) < 2 Jahre: Neue Adressegruppe mit vorheriger Adresse (Toogle show/hide)

Zusammenfassung (Page):

• Datenwiedergabe (Labels, Output Fields)
• Datenbestätigung (Checkbox)
• Submit (Gemockter REST-Call zum Backend)

Ende (Page):

• Danke (Text)
• Neubestellung (Link zu Personendaten, Loop)

Features der Testapplikation

siehe Beschreibung bei https://github.com/sebastianfuss/backbone-test

5. Evaluierung

Evaluierungskriterien

• Pageflow, Routing
• Model, Data-Binding
• Felderdeklaration, Validierung
• REST-Anbindung
• Dokumentation
• Unit-Tests für Validierung, Pageflow

Evaluierungsergebnisse

siehe Dokumentation in einzelnen Projekt-Repos

6. Zusammenfassung und Fazit

TBD

Referenzen

Unterstützende Frameworks

• jQuery (http://jquery.com/), jQueryUI (http://jqueryui.com/), QUnit (http://qunitjs.com/) : Einige JS Frameworks bauen darauf auf (Dependencies)
• PrototypeJS (http://prototypejs.org/) : Sammlung von JavaScript-Basisfunktionalitäten; wird in Kombination mit jQuery und Backbone.js häufig verwendet
• Bootstrap (http://twitter.github.com/bootstrap/) : Utility-Framework für Layout, HTML, CSS etc.
• Underscore.js (http://underscorejs.org/) : Utility-Framework, welches grundlegende Hilfsfunktionen liefert (vgl. Java Commons API)
• Docco (http://jashkenas.github.com/docco/) : Codedokumentation
• Node.js (http://nodejs.org/) : Event-driven I/O server-side JavaScript environment
• RequireJS (http://requirejs.org/) : Module and File Loader for JS, verwendet bei einigen JS Frameworks (Dependencies)
• DocumentJS (http://javascriptmvc.com/docs.html#!/search/DocumentJS) : Codedokumentation
• StealJS (http://javascriptmvc.com/docs.html#!steal) : Collection of command line and JS client utilities that make building, packaging, and sharing JS applications
• FuncUnit (http://javascriptmvc.com/docs.html#!FuncUnit) : Testing of web applications with a simple jQuery-like syntax via integration with Jasmin (behavior-driven development framework), Selenium (capture and replay tool) and PhantomJS (headless WebKit with JavaScript API with support for DOM handling, CSS selector, JSON, Canvas, and SVG) and automated QUnit tests (unit testing).

Tools und Literatur

• JS Editoren/IDEs:
  • WebStorm (http://www.jetbrains.com/webstorm/) : Kommerzielle IDE
  • NetBeans (http://netbeans.org/) : Open Source IDE
  • Cloud9IDE (https://c9.io/) : Online Editor mit Konsole und Repo-Anbindug nach GitHub, BitBucket etc.
  • Sublime Text (http://www.sublimetext.com/) : Kommerzieller Editor
  • Vim (http://www.vim.org/) oder Emacs (http://www.gnu.org/software/emacs/) : freie, stark erweiter- & konfiguierbare Editoren
• JS Web Tools:
  • JSFiddle (http://jsfiddle.net/) : Online Editor with Code Sharing
  • cdnjs (http://cdnjs.com/) : Online hosted JS libraries/frameworks
  • Google CDN (https://developers.google.com/speed/libraries/devguide) : Online hosted libraries
  • Microsoft CDN (http://www.asp.net/ajaxlibrary/cdn.ashx) : Online hosted libraries
• Books:
  • JavaScript Patterns (Stoyan Stefanov)