AF-BedSheetUser Guide
Overview
BedSheet is a Fantom framework for delivering web applications. Built on top of afIoc and Wisp, BedSheet aims to be Powerful, Flexible, Simple.
Quick Start
- Create an
AppModule
, this is where all your service configuration will go. - Contribute to
Router
and other services - Create some page / request handlers
- Start the app...
using afBedSheet using afIoc class AppModule { @Contribute { serviceType=RouteSource# } static Void contributeRoutes(OrderedConfig config) { config.addUnordered(Route(`/hello`, HelloPage#hello)) } } class HelloPage { TextResult hello(Str name, Int iq := 666) { return TextResult.fromPlain("Hello! I'm $name and I have an IQ of $iq!") } }
From the command line:
$ fan afBedSheet <mypod>::AppModule 8080 ... IoC started up in 323ms $ curl http://localhost:8080/hello/Traci/69 Hello! I'm Traci and I have an IQ of 69! $ curl http://localhost:8080/hello/Luci Hello! I'm Luci and I have an IQ of 666!
Wow! That's awesome! But what just happened!?
Routing
Every application has an AppModule
that is used to contribute to afIoc services. There we told the Router
service to route all requests to /hello
to our HelloPage
class.
The #hello
handler now owns all uris that start with /hello
.
Handling
Deeper path segments are converted into method parameters. Hence our handler method takes a Str
and an Int
. Parameters of type Uri
or Str[]
are capture all parameters and match the whole uri.
TIP: Contribute your own
ValueEncoders
to convert uris into Entities. That way BedSheet can call your handlers with real Entities, and not just str IDs.
As per our example, you can use default parameter values to declare optional uri segments. Any urls that don't match the handler parameters are reported as 404s.
Result Processing
Handlers should perform the logic processing of your request and not attempt to write to the HTTP OutStream. That way, if there's an Err, it can be gracefully handled and a suitable response sent to the user.
Instead handlers return objects that ResultProcessors
deal with. Current default handlers include TextResult
and JsonResult
.
If the response is over a given size, and is deemed compressible then it is gzipped before being sent to the user.
More!
All URI handlers and processors are built by afIoc so feel free to @Inject
DAOs and other services. BedSheet itself is built with afIoc so look at the BedSheet source for afIoc examples.
TIP:
const
handler classes are cached by BedSheet and reused on every request.
There's also some Err reporting, HTTP status handling and probably more besides. It's early days still...
Push To Live!
In a hurry to go live?
Check out Heroku and see how ridiculously easy it is to deploy your app to a live server with the heroku-fantom-buildpack.
Release Notes
...coming soon.