STATIC FILE FROM A ROUTE HANDLER----->路由处理中的静态文件

It's possible for a route handler to send a static file, as follows:

路由处理也可以发送一个静态文件，如下：

get '/download/*' => sub {

my $params = shift;

my ($file) = @{ $params->{splat} };

send_file $file;

};

Or even if you want your index page to be a plain old index.html file, just do:

或者更甚者你想让index页面变成一个普通的index.html文件，需如下操作：

get '/' => sub {

send_file '/index.html'

};

SETTINGS------>设置

It's possible to change quite every parameter of the application via the settings mechanism.

你可以通过设置机制来完全的改变应用中的每一个参数。

A setting is key/value pair assigned by the keyword set:

一个设置是由关键字set分配的一个key/value对。

set setting_name => 'setting_value';

More usefully, settings can be defined in a YAML configuration file. Environment-specific settings can also be defined in environment-specific files (for instance, you don't want auto_reload in production, and might want extra logging in development). See the cookbook for examples.

在YAML配置文件中定义那些设置会更加的有效，指定的环境设置可以定义在指定的环境文件中（如：你不希望在生产环境中使用auto_reload功能，也许会在开发环境中使用额外的日志功能），如果想了解更多，请阅读cookbook中的例子。

See Dancer::Config for complete details about supported settings.

如果想了解更多的关于dancer支持的设置请参考Dancer::Config文档。

SERIALIZERS------>序列化

When writing a webservice, data serialization/deserialization is a common issue to deal with. Dancer can automatically handle that for you, via a serializer.

当写web服务时，通常需要处理的一个问题就是数据的序列化和反序列化。但是，dancer会自动的通过serializer功能来处理上述问题。

When setting up a serializer, a new behaviour is authorized for any route handler you define: any response that is a reference will be rendered as a serialized string, via the current serializer.

当设置一个"serializer"时，你所定义的每一个路由处理都会添加一个新的行为，涉及到的每一个响应都会通过当前的"serializer"将每一个响应以serialized 串的形式来响应。

Here is an example of a route handler that will return a HashRef

下面是一个路由处理返回一个hashref的例子：

use Dancer;

set serializer => 'JSON';

get '/user/:id/' => sub {

{ foo => 42,

number => 100234,

list => [qw(one two three)],

}

};

As soon as the content is a reference - and a serializer is set, which is not the case by default - Dancer renders the response via the current serializer.

一旦有内容触发了serializer那么serializer就会被设置，这并不是默认的操作，因为需要前面的设置，dancer会通过当前的serializer发送响应。

Hence, with the JSON serializer set, the route handler above would result in a content like the following:

因此，当设置了JSON-serializer，那么上面的路由处理会返回下面的结果：

{'number':100234,'foo':42,'list':['one','two','three']}

The following serializers are available, be aware they dynamically depend on Perl modules you may not have on your system.

虽然下面的序列化方法是可用的，但是你需要清楚的是，她们都是动态加载的依赖perl模块的，有些模块也许你还没有安装到系统中。

JSON

requires JSON

YAML

requires YAML

XML

requires XML::Simple

Mutable

will try to find the appropriate serializer using the Content-Type and Accept-type header of the request.

Mutable可以通过在请求头中使用Content-Type and Accept-type来寻找合适的可序列化（就是说，看什么序列化能被正确使用）。

EXAMPLE------>范例

This is a possible webapp created with Dancer:

下面是使用dancer编写的一个webapp。

#!/usr/bin/perl

# make this script a webapp

use Dancer;

# declare routes/actions

get '/' => sub {

'Hello World';

};

get '/hello/:name' => sub {

'Hello '.param('name');

};

# run the webserver

Dancer->dance;