1. 首页
  2. 编程与技术

如何构建Sinatra？

发布于 2015-12-14 00:55:21 | 100 次阅读 | 评论: 0 | 来源: PHPERZ

这里有新鲜出炉的精品教程，程序狗速度看过来！

Sinatra 微型Web框架(Ruby)

Sinatra：一个优雅地包装了Web开发的DSL

构建一个Sinatra

Sinatra是一个基于Ruby的快速开发Web应用程序基于特定域（domain-specific）语言。在一些小项目中使用过它后，我决定一探究竟。

什么是Sinatra？

Sinatra的核心是Rack。如果你对Rack的工作原理有些困惑，那篇文章值得一读。Sinatra构建在Rack之上：它在Rack之上提供了一个给力的DSL。来看个例子：

get "/hello" do
  [200, {}, "Hello from Sinatra!"]
end

post "/hello" do
  [200, {}, "Hello from a post-Sinatra world!"]
end

当这段代码执行的时候，我们发送一个GET给/hello，将看到Hello from Sinatra!；发送一个POST请求给/hello将看到Hello from a post-Sinatra world!。但这个时候，任何其他请求都将返回404.

结构

Sinatra 的源码，我们一起提炼出一个类似Sinatra的结构。

我们将创造一个基于Sinatra那种可继承可扩展的类。它保存请求路由表（GET /hello handleHello），当收到GET /hello请求的时候，能去调用handleHello函数。事实上，它能很好的处理所有的请求。当收到请求的时候，它会遍历一遍路由表，如果没有合适的请求，就返回404。

OK，开搞。

就叫它Nancy吧，别问我为什么。

我们第一步要做的事是：创建一个类，它有一个get方法，能捕获请求的path并找到对应的函数。


# nancy.rb

require "rack"

module Nancy

 class Base

 def initialize

 @routes = {}

 end

 attr_reader :routes

 def get(path, &handler)

 route("GET", path, &handler)

 end

 private

 def route(verb, path, &handler)

 @routes[verb] ||= {}

 @routes[verb][path] = handler

 end

 end

end

route函数接收一个动词（请求方法名），一个路径和一回调方法并保存到一个Hash结构中。这样设计可以让POST /hello和GET /hello不会混乱。

然后在下面加一些测试代码：

nancy = Nancy::Base.new

nancy.get "/hello" do
  [200, {}, ["Nancy says hello"]]
end

puts nancy.routes

应该注意到，我们用了nancy.get替代了get显得没那么简洁，但是不要着急，本文最后会解决这个问题。

如果我们这时执行程序，会看到：


{ "GET" =\> { "/hello" =\> \#\<Proc:0x007fea4a185a88@nancy.rb:26\> } }

这个返回结果。我们的路由表工作正常。

引入了 Rack 的 Nancy

现在我们给Nancy增加调用Rake的call方法，让它成为一个最小的Rake程序。这些代码是我的另一篇Rack文章中的：

# nancy.rb
def call(env)
  @request = Rack::Request.new(env)
  verb = @request.request_method
  requested_path = @request.path_info

  handler = @routes[verb][requested_path]

  handler.call
end

首先，我们从Rack的请求的env环境变量参数中的得到请求方法（HTTP/GET等）和路径（/the/path），然后根据这些信息去路由表中招对应的回调方法并调用它。回调方法需返回一个固定的结构，这个结构包含状态码、HTTP Header和返回的内容，这个结构正是Rack的Call所需要的，它会经由Rack返回给用户。

我们增加一个这样的回调给Nancy::Base：

nancy = Nancy::Base.new

nancy.get "/hello" do
  [200, {}, ["Nancy says hello"]]
end

# This line is new!
Rack::Handler::WEBrick.run nancy, Port: 9292

现在这个Rack App已经能运行了。我们使用WEBrick作为服务端，因为它是内置的。

nancy = Nancy::Base.new

nancy.get "/hello" do
  [200, {}, ["Nancy says hello"]]
end

# This line is new!
Rack::Handler::WEBrick.run nancy, Port: 9292

执行ruby nancy.rb，然后访问http://localhost:9292/hello，一切工作的很好。这个时候你可能想修改一些返回信息，需要注意，Nancy还不能自动重新加载，你做的任何改动都必须重新执行才会生效。Ctrl+C能在终端中停止它的执行。

错误处理

访问路由表中处理的路径它能工作的很好，但是访问路由表中不存在的路径比如http://localhost:9292/bad你只能看到Rack返回的默认错误信息，一个Internal Server Error页面。这很不友好，我们看下如何自定义一个错误页面。

我们需要修改call方法：

def call(env)
   @request = Rack::Request.new(env)
   verb = @request.request_method
   requested_path = @request.path_info

-  handler = @routes[verb][requested_path]
-
-  handler.call
+  handler = @routes.fetch(verb, {}).fetch(requested_path, nil)

+  if handler
+    handler.call
+  else
+    [404, {}, ["Oops! No route for #{verb} #{requested_path}"]]
+  end
 end

现在，如果请求一个路由表中没有定义的路径回返回一个404状态码和错误信息。

从 HTTP 请求中得到更多信息

我们的nancy.get现在只能得到路径，我们需要得到更多的信息，比如请求的参数等。有关请求的环境变量被封装在Rack::Request的params中。

我们给Nancy::Base增加一个新的方法params：

module Nancy
  class Base
    #
    # ...other methods....
    #

    def params
      @request.params
    end
  end
end

需要这些请求信息的回调处理中，可以访问这个params方法来得到。

访问 params

再来看一下刚刚添加的这个params实例方法。

修改调用回调这部分代码：

 if handler
-  handler.call
+  instance_eval(&handler)
 else
   [404, {}, ["Oops! Couldn't find #{verb} #{requested_path}"]]
 end

这里面有一些小把戏让人困惑，为啥要用instance_eval替代call呢？

  • handler是一个没有上下文的lambda

  • 如果我们使用call去调用这个lambda，它是没法访问Nancy::Base的实例方法的。

  • 使用instance_eval替代call来调用，Nancy::Base的实例信息会被注入进去，它可以访问Nancy::Base的实例变量和方法了。

所以，现在我们能访问params在handler block中了。试试看：

nancy.get "/" do
  [200, {}, ["Your params are #{params.inspect}"]]
end

访问http://localhost:9292/?foo=bar&hello=goodbye，有关请求的信息，都会被打印出来。

支持任意的 HTTP 方法

到目前为止，nancy.get能很好的工作。但这还不够，我们要支持更多的HTTP方法。支持它们的代码和get很相似：

# nancy.rb
def post(path, &handler)
  route("POST", path, &handler)
end

def put(path, &handler)
  route("PUT", path, &handler)
end

def patch(path, &handler)
  route("PATCH", path, &handler)
end

def delete(path, &handler)
  route("DELETE", path, &handler)
end

通常在POST和PUT请求中，我们会想访问请求的内容（request body）。既然现在在回调中，我们已经可以访问Nancy::Base的实例方法和变量了，让@request变得可见就好（迷糊的去翻上面的call方法代码）：

attr_reader :request

访问requrest实例变量在回调中：

nancy.post "/" do
  [200, {}, request.body]
end

访问测试：

$ curl --data "body is hello" localhost:9292
body is hello

现代化进程

我们来做以下优化：

  1. 使用params实例方法来替代直接调用request.params

def params
  request.params
end

  1. 允许回调方法返回一个字符串

   if handler
-    instance_eval(&handler)
+    result = instance_eval(&handler)
+    if result.class == String
+      [200, {}, [result]]
+    else
+      result
+    end
   else
     [404, {}, ["Oops! Couldn't find #{verb} #{requested_path}"]]
   end

这样处理回调就简化很多：

nancy.get "/hello" do
  "Nancy says hello!"
end

使用代理模式继续优化 Nancy::Application

在使用Sinatra的时候，我们使用get，post来进行请求处理优雅强大又直观。它是怎么做到的呢？先考虑Nancy的结构。它执行的时候，我们调用Nancy::Base.new得到一个新的实例，然后添加处理path的函数，然后执行。那么，如果有一个单例，就可以实现Sinatra的效果，将文件中处理路径的方法添加给这个单例并执行即可。（译者注：这段的译文和原文没关系，纯属杜撰。如果迷惑，请参考原文）

是时候考虑将nancy.get优化为get了。
增加Nancy::Base单例：

module Nancy
  class Base
    # methods...
  end

  Application = Base.new
end

增加回调：

nancy_application = Nancy::Application

nancy_application.get "/hello" do
  "Nancy::Application says hello"
end

# Use `nancy_application,` not `nancy`
Rack::Handler::WEBrick.run nancy_application, Port: 9292

增加代理器（这部分代码来自Sinatra的源码）：

module Nancy
  module Delegator
    def self.delegate(*methods, to:)
      Array(methods).each do |method_name|
        define_method(method_name) do |*args, &block|
          to.send(method_name, *args, &block)
        end

        private method_name
      end
    end

    delegate :get, :patch, :put, :post, :delete, :head, to: Application
  end
end

引入Nancy::Delegate 到 Nancy模块：

include Nancy::Delegator

Nancy::Delegator提供代理如get，patch，post，等一系列方法。当在Nancy::Application中调用这些方法的时候，它会按图索骥找到代理器的这些方法。我们实现了和Sinatra一样的效果。

现在可以删掉那些创建Nancy::Base::new和nancy_application的代码啦！Nancy的使用已经无限接近Sinatra了：

t "/bare-get" do
  "Whoa, it works!"
end

post "/" do
  request.body.read
end

Rack::Handler::WEBrick.run Nancy::Application, Port: 9292

还能使用rackup来进行调用：

# config.ru
require "./nancy"

run Nancy::Application

Nancy的完整代码：

# nancy.rb
require "rack"

module Nancy
  class Base
    def initialize
      @routes = {}
    end

    attr_reader :routes

    def get(path, &handler)
      route("GET", path, &handler)
    end

    def post(path, &handler)
      route("POST", path, &handler)
    end

    def put(path, &handler)
      route("PUT", path, &handler)
    end

    def patch(path, &handler)
      route("PATCH", path, &handler)
    end

    def delete(path, &handler)
      route("DELETE", path, &handler)
    end

    def head(path, &handler)
      route("HEAD", path, &handler)
    end

    def call(env)
      @request = Rack::Request.new(env)
      verb = @request.request_method
      requested_path = @request.path_info

      handler = @routes.fetch(verb, {}).fetch(requested_path, nil)

      if handler
        result = instance_eval(&handler)
        if result.class == String
          [200, {}, [result]]
        else
          result
        end
      else
        [404, {}, ["Oops! No route for #{verb} #{requested_path}"]]
      end
    end

    attr_reader :request

    private

    def route(verb, path, &handler)
      @routes[verb] ||= {}
      @routes[verb][path] = handler
    end

    def params
      @request.params
    end
  end

  Application = Base.new

  module Delegator
    def self.delegate(*methods, to:)
      Array(methods).each do |method_name|
        define_method(method_name) do |*args, &block|
          to.send(method_name, *args, &block)
        end

        private method_name
      end
    end

    delegate :get, :patch, :put, :post, :delete, :head, to: Application
  end
end

include Nancy::Delegator

Nancy的使用代码：

# app.rb
# run with `ruby app.rb`
require "./nancy"

get "/" do
  "Hey there!"
end

Rack::Handler::WEBrick.run Nancy::Application, Port: 9292

我们来回顾一下都发生了什么：

  • 起名为N(T)an(i)c(r)y Sinatra（别问为什么）

  • 实现一个以来Rack的Web App

  • 简化nancy.get为get

  • 支持子类Nancy::Base来实现更丰富的自定义。

课外阅读

Sinatra的代码几乎全部都在base.rb。代码密度有点大，阅读完本文再去看，更容易理解一些了。从call!开始是个不错的开始。然后是Response类，它是Rack::Response的子类。需要注意的是Sinatra是基于类的，Nancy是基于对象。有些在Nancy中的示例方法，在Sinatra中是作为类方法实现的。



最新网友评论  共有(0)条评论 发布评论 返回顶部
推荐阅读
  • 终极炫富——2016 年 iOS 开发者收入调查报告
  • 年度大片：Stack Overflow 2017 开发者调查报告发布！
  • 开发者需要大学学位吗？
  • 程序员多大年纪算高龄，届时该何去何从？
  • 2017 年高薪编程语言排行榜，你的语言上榜没？
  • 各编程语言开发者最常使用的按键，中了没?
  • 伤不起的三十岁，干不动的程序员要何去何从？
  • 2016年中国加班最狠IT公司排行
  • 一句话"面试"漫画：黑了苹果、谷歌、三星
  • 拿代码量算 KPI ……跟程序员们来这套？
  • 程序员遇到 Bug 时的 30 个反应，你是哪一种？
  • 2016年收入最高的5个编程语言 Java和C没在前五?
  • 为什么很少见人傻钱多的程序员炫富？
  • 阿里月薪两万是什么体验？
  • 代码缩进时 程序员更喜欢空格键还是Tab键？
    • 最新资讯
  • Python获取系统所有进程PID及进程名称的方法示例
  • Python简单获取网卡名称及其IP地址的方法【基于psutil模块】
  • Python实现的根据IP地址计算子网掩码位数功能示例
  • 好的Python培训机构应该具备哪些条件
  • 详解Pytorch 使用Pytorch拟合多项式(多项式回归)
  • Python加载带有注释的Json文件实例
  • 对python的文件内注释 help注释方法
  • Python实现判断一行代码是否为注释的方法
  • Oracle数据库表中字段顺序的修改方法
  • ASP.NET MVC 4使用PagedList.Mvc分页的实现代码
  • Oracle实例启动时报错：ORA-32004的解决方法
  • 解读ASP.NET 5 & MVC6系列教程（7）：依赖注入
  • 详解IDEA用maven创建springMVC项目和配置
  • ASP.NET MVC5网站开发之展示层架构（五）
  • SpringBoot创建maven多模块项目实战代码
    • 后端技术
    前端技术
    数据库
    热门框架
    常用IDE
    其他
    Copyright © 2007-2017 PHPERZ.COM All Rights Reserved   冀ICP备14009818号  版权声明  广告服务