Category: Writing

Recovered from the Wayback Machine.

After denouncing the use of Ruby and Rails terms to describe Node and Node modules, I must now confess that I did use a Rails resource in the section on MVC in Chapter 6.

The Rails Guide has an absolutely beautifully written overview on MVC and routing, Rails Routing from the Outside In, I used as inspiration for the design of the MVC section in Chapter 6.

However, in my defense I’ll note that most of this overview really doesn’t depend on knowing either Ruby or Rails in order to benefit from the writing. It simply and easily demonstrates a mapping between HTTP verbs, routes, controller actions, and database CRUD (Create-Read-Update-Delete) probably better than anything else I’ve ever read.

Recovered from the Wayback Machine.

The Learning Node book is far enough along so that I can publish the Table of Contents for the book and it shouldn’t differ significantly from the TOC for the book when it’s finished. The chapters with an expanded TOC are those already finished—the rest are still in work. Before I print out the TOC, though, I thought I’d write about some of the underlying themes that helped define the book structure and determine the direction of the writing.

The primary theme behind the book is simple: you don’t have to have prior experience working with Ruby or Rails in order to understand this book.

Seems like a silly thing to say when we’re talking about a technology based in JavaScript, but you’d be amazed at how much a Ruby/Rails background assumption flavors interactions in the Node world. One of the real issues I found with Node in the last year is that all too often explanations are given in Ruby or Rail terms. For instance, when a person asked about what framework to use, another answered him that “Express is like Sinatra, while Geddy is more like Rails”. Well, that’s just peachy…if you’ve worked with Ruby, Sinatra, or Rails. If you haven’t then the answer might as well be Martian for all the useful information it provided.

My book assumes you have experience with client-side JavaScript, and you’ve mainly worked with more traditional web/Ajax type of development. There are no references to unknown technologies, and no esoteric Rubyesque or Python asides. Even when I cover how to create an MVC (Model-View-Controller) application using a popular framework, Express, I do it in such a way that you can follow along no matter how much experience you’ve had with MVC.

This doesn’t mean I talk down to my readers, but I happen to believe that Node is actually a lot easier to use than may be first apparent, and one major roadblock to understanding are all the assumptions shared among many of the current practitioners.

Another underlying theme to the book is dealing with a second major roadblock to Node adoption: lack of documentation. Or I should say, uneven documentation. Some of the third-pary modules are nicely documented, others have no documentation, and the Node modules, themselves, fit somewhere in-between. There are tutorials and other reference material—some very good material, in fact— but it’s scattered about and you have to hunt for most of it.

Having said this, the one thing the Node modules all seem to share is really nicely written code. They all seem to make excellent use of white space, good variable naming conventions, and effective use of in-line comments. The objects aren’t bizarrely defined, the coding isn’t excessively cryptic, the methods aren’t overlong, and the purpose of most can be deduced without too much trouble. Once you have a good grounding in how Node works, you can discover what you need to know about how a module works just by looking at the source.

Of course, it would still be nice if Node module developers provided a little more documentation.

(I won’t even get into the odd fascination with light gray text on darker gray backgrounds that seems to be shared by so many Node developers. Pure headache inducing web design.)

The third underlying theme in the book is to focus on providing the tools so that you can build the awesome applications—not try to create awesome applications in the book to impress you with how great I am. My examples are focused, they’re simple, they’re clean, and they show how things work. That’s it. When I want to learn how to do something, I want simple, clear examples that demonstrate exactly what I need—no more, no less. I don’t want fancy and I don’t want something overly complex. I assume most folks feel the same way, and write accordingly.

I’m also not especially creative in my writing—I try to avoid the cutesy, and definitely stay away from the profound. I’m writing a book on computer technology, not Gone with the Node.

I don’t know if all of this leaves you more interested or less, but best to set expectations right from the beginning.

My editor, Simon St. Laurent, has mentioned about the possibility of releasing my book under the Early Release and/or Rough Cuts program. I hesitate doing so, because I’ve seen reviewers who have been extremely critical of a book primarily because it is Early Release and/or a Rough Cut. Seems to me that the early release programs are equivalent to firewalking: may be great when it works, but the consequences when it doesn’t can be unfortunate.

Stay tuned on this one. If I do release early, the book will probably be available in May; otherwise, July.

Now, on with the TOC:

• • Chapter 1: Node.js, Up and Running
    • Setting up a Node Development Environment
    • • Installing Node on Linux
      • Partnering Node with WebMatrix on Windows 7
      • Updating Node
    • Node: Jumping In
    • • Hello, World in Node
      • Hello World, from the Top
    • Asynchronous Functions and the Node Event Loop
    • • Reading a File Asynchronously
      • A Closer Look at Asynchronous Program Flow
    • Summary: Why We Like Node
  • Chapter 2: Interactive Node with REPL
    • REPL: First Looks and Undefined Expressions
    • REPL’s Own Unique Hello World
    • Multiline and More Complex JavaScript
      • REPL Commands
      • REPL and rlwrap
      • Creating Your Own REPL
    • Stuff Happens. Save Often.
  • Chapter 3: The Node Core
    • Globals: Global, Process, and Buffer
      • Global
      • Process
      • Buffer
    • The Timers: setTimeout, setInterval, clearTimeout, setInterval, and clearInterval
    • Servers, Streams, and Sockets
      • TCP Sockets and Servers
      • HTTP
      • UDP/Datagram Socket
      • Streams, Pipes, and Readline
    • Child Processes
      • child_process.spawn
      • child_process.exec and child_process.execFile
      • child_process.fork
      • Running a Child Process Application in Windows>/li>
    • Domain Resolution and URL Processing
    • Utilities and a JavaScript OO Refresher
    • Events and EventEmitter
  • Chapter 4: The Node Module System
    • Loading a Module with Require and Default Paths
    • External Modules and the Node Package Manager
    • Finding Modules
      • The Colors Module: Simple is Best
      • Optimist: Another Short and Simple
      • Exploring JSDOM
      • Underscore
    • Creating Your Own Custom Module
      • Packaging an Entire Directory
      • Preparing Your Module for Publication
      • Publishing the Module
  • Chapter 5: Control Flow, Asynchronous Patterns, and Exception Handling
    • Promises, No Promises, Callbacks Instead
    • Sequential Functionality, Nested Callbacks, and Exception Handling
    • Asynchronous Patterns and Control Flow Modules
      • Step
      • Async
    • Speaking of Node Style
  • Chapter 6: Routing Traffic, Serving Files, and Middleware
    • Building a Simple Static File Server from Scratch
    • Middleware
      • Connect Basics
      • The Connect Middleware
        • connect.static
        • connect.logger
        • connect.parseCookie and connect.cookieSession<.li>
      • Creating a Connect Middleware
    • Routers
    • Proxies
  • Chapter 7: The Express Framework
    • Express: Up and Running
    • The app.js File in More Detail
    • Error Handling
    • A Closer Look at the Express/Connect Handshake
    • Routing
      • Routing Path
      • Routing and HTTP Verbs
    • Cue the MVC
  • Chapter 8: Express, Template Systems, and CSS
    • The Embedded JavaScript (EJS) Template System
      • The Basic Syntax
      • Using EJS with Node
      • Using the EJS for Node Filters
    • Using a Template System (EJS) with Express
      • Restructuring for a Multiple Object Environment
      • Routing to Static Files
      • Processing a New Object Post
      • Widgets Index and Generating a Picklist
      • Showing an Individual Object and Confirming an Object Deletion
      • Providing an Update Form and Processing a PUT Request
    • The Jade Template System
      • The Quick Nickel Tour of the Jade Syntax
      • The Use of Block and Extend to Modularize the View Templates
      • Converting the Widget Views into Jade Templates
    • Incorporating Stylus for Simplified CSS
  • Chapter 9: Structured Data with Node + Redis
    • Getting Started with Node + Redis
    • Building a Game Leaderboard
    • Creating a Message Queue
    • Adding a Stats Middleware to an Express Application
  • Chapter 10: Storing Content with MongoDB
  • Chapter 11: The Node Relational Database Bindings
  • Chapter 12: Graphics, Video, and Audio

(Notes: Creating, streaming Canvas, Working with Imagemagic, Working with image files, multipart upload with progress, livestreaming-js. How connect.static implements ranges, allowing functionality for HTML5 video to work. Discuss ranges.)

• • Chapter 13: Creating a Quick Chat with Sockets.io

(Notes: No, not everyone needs to implement a chat client, but it is the best way to demo websockets, Speaking of which, explain websockets. (socket.io does not have session info))

• • Chapter 14: Testing and Debugging Node Applications
  • Chapter 15: Security (chapter title TBD)

(Notes: connect-auth, EveryAuth, OAuth, crypto, SSL, injection attacks, hardening code, Validating (node-validator), Sandbox (vm))

• • Chapter 16: Scaling and Deploying Node Applications

Using gearman for parallel machine deployment? Benchmarking, Deploying app to one of the clouds, Possibly Azure if I can get to work, Heroku, Joyent, others, Creating and landing a module, nodemon, hook.io?)

• Appendix A: Git and Github
• Appendix B: Useful Resources and References
• Appendix C: A Redis Primer