Vane is server side framework written and optimized for the Dart programming language. Vane comes bundled with a lightweight and performant middleware system and strives to provide commonly used parameters and objects in an easy to use manner such as query parameters or json body data.
Vane supports three different types of handlers:
A vane handler is any class that extends the Vane class. When you extend the Vane class your handler functions get access to many helpers and features that are part of the Vane framework. In a vane handler you have access to a set of top level helpers to make life easier, some example of these are a ready to use parsed version of incoming json data called "json".
A Vane class can either run on it's own or in a pipeline of a set of Vane controllers. When
mulitple a Vane controller is used in a pipeline to process a request those other than the
main controller are called middleware controllers, but it's not a different type of controller
and middleware controllers can themself also have their own middleware controllers. Inside a
Vane controller you can either end the controller by returning next()
or close()
, if you
return with next()
the next middleware controller will run (if there is one, otherwise the
call will be changed to a close()
call). If you call close()
that will end the request
even if there are middleware controllers that have yet not run.
Vane classes registered to as middleware can run either before or after the main controller. Middleware controllers can run synchronously or asynchronously and you are guaranteed that they execute in the order you define. Per default middleware controllers run synchronously and the next controller only starts when the current one has finished. You can choose to run one or more middleware controllers in async and also combine both a set of synchronous and asynchronous controller to create more complex pipelines for processing.
Hello World Example:
class HelloVane extends Vane {
@Route("/")
Future World() {
return close("Hello world! (from vane handler)");
}
}
Middleware Example:
class HelloVane extends Vane {
var pipeline = [MyMiddleware, This]
@Route("/")
Future World() {
return close("Hello world! (from vane handler)");
}
}
class MyMiddleware extends Vane {
Future main() {
write("Hello from middleware!");
return next();
}
}
A podo handler is a "Plain Old Dart Object", basically any Dart class that have 1 or more function handlers with declared with the @Route annotation.
Hello World Example:
class HelloPodo {
@Route("/")
void World(HttpRequest request) {
request.response.write("Hello World! (from podo handler)");
request.response.close();
}
}
A function handler is simple a function that takes at least 1 HttpRequest parameter and optionally 1 or more parameters that can be mapped from the url.
Hello World Example:
@Route("/")
void helloFuncWorld(HttpRequest request) {
request.response.write("Hello World! (from func handler)");
request.response.close();
}
With Vane you don't have to worry about writing a dart/web server, you focus on writing your
controllers/handlers and Vane serves them for you automatically based on your @Route annotations.
All you need to do is to make sure they are in the same library and that you start the serve function.
import 'dart:async';
import 'package:vane/vane.dart';
class HelloWorld extends Vane {
@Route("/")
Future Hello() {
return close("Hello world");
}
}
void main() => serve();
import 'dart:io';
import 'dart:async';
import 'package:vane/vane.dart';
class HelloVane extends Vane {
@Route("/")
@Route("/vane")
Future World() {
return close("Hello world! (from vane handler)");
}
@Route("/{user}")
@Route("/vane/{user}")
Future User(String user) {
return close("Hello ${user}! (from vane handler)");
}
}
class HelloPodo {
@Route("/podo")
void World(HttpRequest request) {
request.response.write("Hello World! (from podo handler)");
request.response.close();
}
@Route("/podo/{user}")
void User(HttpRequest request, String user) {
request.response.write("Hello World $user! (from podo handler)");
request.response.close();
}
}
@Route("/func")
void helloFuncWorld(HttpRequest request) {
request.response.write("Hello World! (from func handler)");
request.response.close();
}
@Route("/func/{user}")
void helloFuncUser(HttpRequest request, String user) {
request.response.write("Hello World $user! (from func handler)");
request.response.close();
}
void main() => serve();