Spock-0.7.12.0: Another Haskell web framework for rapid development

Safe HaskellNone
LanguageHaskell98

Web.Spock.Safe

Contents

Description

This module implements the type safe routing aproach. It should be used by all new Spock powered applications. To learn more about the routing, read the corresponding blog post available at http://www.spock.li/2015/04/19/type-safe_routing.html

Synopsis

Spock's route definition monad

spock :: SessionCfg sess -> PoolOrConn conn -> st -> SpockM conn sess st () -> IO Middleware Source

Create a spock application using a given db storageLayer and an initial state. Spock works with database libraries that already implement connection pooling and with those that don't come with it out of the box. For more see the PoolOrConn type. Use runSpock to run the app or spockAsApp to create a Wai.Application

type SpockM conn sess st a = SpockT (WebStateM conn sess st) a Source

spockT :: MonadIO m => (forall a. m a -> IO a) -> SpockT m () -> IO Middleware Source

Create a raw spock application with custom underlying monad Use runSpock to run the app or spockAsApp to create a Wai.Application

data SpockT m a Source

Instances

Defining routes

data Path as :: [*] -> *

Instances

(~) [*] a ([] *) => IsString (Path a) 

root :: Path ([] *)

The root of a path piece. Use to define a handler for "/"

type Var a = Path ((:) * a ([] *))

var :: (Typeable * a, PathPiece a) => Path ((:) * a ([] *))

A route parameter

static :: String -> Path ([] *)

A static route piece

(<//>) :: Path as -> Path bs -> Path (Append as bs) Source

Combine two path components

Rendering routes

renderRoute :: Path as -> HVectElim as Text Source

Render a route applying path pieces

Hooking routes

subcomponent :: Monad m => Path [] -> SpockT m () -> SpockT m () Source

Define a subcomponent. Usage example:

subcomponent "site" $
  do get "home" homeHandler
     get ("misc" <//> var) $ -- ...
subcomponent "admin" $
  do get "home" adminHomeHandler

The request /site/home will be routed to homeHandler and the request /admin/home will be routed to adminHomeHandler

get :: MonadIO m => Path xs -> HVectElim xs (ActionT m ()) -> SpockT m () Source

Specify an action that will be run when the HTTP verb GET and the given route match

post :: MonadIO m => Path xs -> HVectElim xs (ActionT m ()) -> SpockT m () Source

Specify an action that will be run when the HTTP verb POST and the given route match

getpost :: MonadIO m => Path xs -> HVectElim xs (ActionT m ()) -> SpockT m () Source

Specify an action that will be run when the HTTP verb 'GET'/'POST' and the given route match

head :: MonadIO m => Path xs -> HVectElim xs (ActionT m ()) -> SpockT m () Source

Specify an action that will be run when the HTTP verb HEAD and the given route match

put :: MonadIO m => Path xs -> HVectElim xs (ActionT m ()) -> SpockT m () Source

Specify an action that will be run when the HTTP verb PUT and the given route match

delete :: MonadIO m => Path xs -> HVectElim xs (ActionT m ()) -> SpockT m () Source

Specify an action that will be run when the HTTP verb DELETE and the given route match

patch :: MonadIO m => Path xs -> HVectElim xs (ActionT m ()) -> SpockT m () Source

Specify an action that will be run when the HTTP verb PATCH and the given route match

hookRoute :: Monad m => StdMethod -> Path xs -> HVectElim xs (ActionT m ()) -> SpockT m () Source

Specify an action that will be run when a HTTP verb and the given route match

hookAny :: Monad m => StdMethod -> ([Text] -> ActionT m ()) -> SpockT m () Source

Specify an action that will be run when a HTTP verb matches but no defined route matches. The full path is passed as an argument

data StdMethod :: *

HTTP standard method (as defined by RFC 2616, and PATCH which is defined by RFC 5789).

Constructors

GET 
POST 
HEAD 
PUT 
DELETE 
TRACE 
CONNECT 
OPTIONS 
PATCH 

Adding Wai.Middleware

middleware :: Monad m => Middleware -> SpockT m () Source

Hook wai middleware into Spock

Safe actions

class (Hashable a, Eq a, Typeable a) => SafeAction conn sess st a where Source

SafeActions are actions that need to be protected from csrf attacks

Methods

runSafeAction :: a -> SpockAction conn sess st () Source

The body of the safe action. Either GET or POST

safeActionPath :: forall conn sess st a. (SafeAction conn sess st a, HasSpock (SpockAction conn sess st), SpockConn (SpockAction conn sess st) ~ conn, SpockSession (SpockAction conn sess st) ~ sess, SpockState (SpockAction conn sess st) ~ st) => a -> SpockAction conn sess st Text Source

Wire up a safe action: Safe actions are actions that are protected from csrf attacks. Here's a usage example:

newtype DeleteUser = DeleteUser Int deriving (Hashable, Typeable, Eq)

instance SafeAction Connection () () DeleteUser where
   runSafeAction (DeleteUser i) =
      do runQuery $ deleteUserFromDb i
         redirect "/user-list"

get ("user-details" <//> var) $ \userId ->
  do deleteUrl <- safeActionPath (DeleteUser userId)
     html $ "Click <a href='" <> deleteUrl <> "'>here</a> to delete user!"

Note that safeActions currently only support GET and POST requests.