Untitled Slide

Untitled Slide

Untitled Slide

Untitled Slide

Andreas håkansson

Inspired by a framework called Sinatra

(note the word inspired)

Who's This Nancy?

These boots are made for Walkin'

Untitled Slide

Hardest problem in programming is naming things

Why Nancy?

It's Easier and More Funner

Built from the ground up

Not a simple DSL on top of an existing framework

Run Anywhere

• ASP.NET
• IIS
• Self Host
• WCF
• Any OWIN (including Mono)

Easier Testing

Out of the Box

TinyIOC
(or use your favorite IOC)

Automatic Dependency Resolution

Ultra light Action Declarations

View Engines

• Razor
• Spark
• Super Simple View Engine
• dotLiquid
• Markdown and many more...

Powerful request path matching

Content NEgotiation

OPen Source

community

super-duper-happy path

Minimal Configuration Required

Easily Customized

LoW Ceremony

Low Friction

Exploring Nancy Modules

Modules are the LynchPin

Nancy Modules

• Define behavior using routes and actions
• Accesses the current request and context
• Helpers for building responses and rendering views
• Model bindings
• Security and Authentication

You can have as many modules as you like in your application, just as long as there is at least one and that it has at least one route defined

Module Paths

Untitled Slide

Routes

DELETE, GET, HEAD, OPTIONS, POST, PUT and PATCH

Patterns

• Literal segments - /some/literal/segments
• Capture segments - /{name}
• Capture segments (optional) - /{name?}
• Capture Segments (optional/default) - /{name?unnamed}
• RegEx Segment - /(?[\d]{1,2})

More Patterns

• Greedy Segment - /{name*}
• Greedy RegEx Segment - ^(?[a-z]{3,10}(?:/{1})(?[a-z]{5,10}))$
• Multiple Captures Segment -- /{file}.{extension} or /{file}.ext

actions

Condition

Model Binding

Click to Edit

Blacklist Properties

Deserializing rich request body payloads

• Nancy ships with JSON and XML Deserializers
• Content Type determines which to use
• You can add your own body deserializers

BootStrapper

The bootstrapper is responsible for some of the magic that you are treated to when working with the framework, such as automatic discovery of modules, custom model binders, dependencies and much more.

Untitled Slide

Untitled Slide

Views

Rendering a View

Locating Views

• Look in the root
• Look in the views folder
• Look in the module path folder
• Look in folder with module name
• Look in views folder with module name

View from Model Type

• Same rules but use the model name as view name
• If type ends in "Model" it is stripped off
• Customer model type -> Customer view name
• CustomerModel model type -> Customer view name

Not good Enough for You?

Super SimPle View Engine

• Built in, no additional dependencies
• Has layouts, partials, models, conditions, iterations
• Serves up .html and .sshtml
• No expression evaluation
• Can only reference properties of models

Untitled Slide

Untitled Slide

TEsting

Untitled Slide

Untitled Slide

Untitled Slide

Untitled Slide

Untitled Slide

TL;DR: stick stuff in /Content .. done.

Untitled Slide

Untitled Slide

Untitled Slide

Diagnostics

Diagnostics

• Built-in to the main assembly
• http://
  /_Nancy/
• Fast, extensible and cross-browser compliant.
• Information, Interactive Diagnostics, Request Tracing
• Password protected

Untitled Slide

Untitled Slide

Content Negotiation

Untitled Slide

The content negotiation pipeline will inspect the incoming Accept headers and determine which of the requested media types is the most suitable and format the response accordingly.

Default Response Processors

• JSON - application/json, application/vnd.foo+json
• View - text/html
• XML - application/xml, application/vnd.foo+xml

Untitled Slide

File extenstion support

• extension-based access “hotwires” negotiation
• Example: /ratpack.json => JSON response

Authentication

There is no Authentication

What did you say your name Was?

• Nancy has the concept of a User
• No built-in way to authenticate a user
• No inflexible, hard coded, “built in” authentication providers
• Extension points are provided
• Basic, Stateless and Forms mechanisms via Nuget

Untitled Slide

Untitled Slide

Roll Your Own

Untitled Slide

Untitled Slide

Untitled Slide

Untitled Slide

Forms Authentication

• Install the Nancy.Authentication.Forms package
• Implement an IUserMapper
• Implement routes to handle login and logout
• Configure and enable Forms Authentication

Untitled Slide

Untitled Slide

Untitled Slide

Why Nancy?

It's LIghtWeight

But it's No Lightweight

Sensible Conventions

Pay as you Go

Extensible

Great Community

Untitled Slide

Mike-Ward.Net

@mikeward_aa