Ruby/Rack HTTP 路由器
Add this line to your application's Gemfile:
gem "hanami-router"And then execute:
$ bundleOr install it yourself as:
$ gem install hanami-routerCreate a file named config.ru
# frozen_string_literal: true
require "hanami/router"
app = Hanami::Router.new do
get "/", to: ->(env) { [200, {}, ["Welcome to Hanami!"]] }
end
run appFrom the shell:
$ bundle exec rackupHanami::Router is designed to work as a standalone framework or within a context of a Hanami application.
For the standalone usage, it supports neat features:
Hanami::Router.new do
root to: ->(env) { [200, {}, ["Hello"]] }
get "/lambda", to: ->(env) { [200, {}, ["World"]] }
get "/dashboard", to: Dashboard::Index
get "/rack-app", to: RackApp.new
permanent_redirect "/legacy", to: "/"
mount Api::App, at: "/api"
scope "admin" do
get "/users", to: Users::Index
end
endHanami::Router.new do
get "/hanami", to: ->(env) { [200, {}, ["Hello from Hanami!"]] }
endHanami::Router.new do
get "/flowers/:id", to: ->(env) { [200, {}, ["Hello from Flower no. #{ env["router.params"][:id] }!"]] }
endHanami::Router.new do
get "/flowers/:id", id: /\d+/, to: ->(env) { [200, {}, [":id must be a number!"]] }
endHanami::Router.new do
get "/*match", to: ->(env) { [200, {}, ["This is catch all: #{ env["router.params"].inspect }!"]] }
endHanami::Router.new do
get "/hanami(.:format)" to: ->(env) { [200, {}, ["You"ve requested #{ env["router.params"][:format] }!"]] }
endendpoint = ->(env) { [200, {}, ["Hello from Hanami!"]] }
Hanami::Router.new do
get "/hanami", to: endpoint
post "/hanami", to: endpoint
put "/hanami", to: endpoint
patch "/hanami", to: endpoint
delete "/hanami", to: endpoint
trace "/hanami", to: endpoint
options "/hanami", to: endpoint
endHanami::Router.new do
root to: ->(env) { [200, {}, ["Hello from Hanami!"]] }
endHanami::Router.new do
get "/redirect_destination", to: ->(env) { [200, {}, ["Redirect destination!"]] }
permanent_redirect "/legacy", to: "/redirect_destination"
temporary_redirect "/today", to: "/redirect_destination"
permanent_redirect "/learn-more", to: "https://hanamirb.org/"
permanent_redirect "/chat", to: URI("xmpp://myapp.net/")
# For less common codes (303, 307, 308), use redirect with an explicit code:
redirect "/submit", to: "/result", code: 303
endrouter = Hanami::Router.new(scheme: "https", host: "hanamirb.org") do
get "/hanami", to: ->(env) { [200, {}, ["Hello from Hanami!"]] }, as: :hanami
end
router.path(:hanami) # => "/hanami"
router.url(:hanami) # => "https://hanamirb.org/hanami"router = Hanami::Router.new do
scope "animals" do
scope "mammals" do
get "/cats", to: ->(env) { [200, {}, ["Meow!"]] }, as: :cats
end
end
end
# and it generates:
router.path(:animals_mammals_cats) # => "/animals/mammals/cats"Mounting a Rack application will forward all kind of HTTP requests to the app,
when the request path matches the at: path.
Hanami::Router.new do
mount MyRackApp.new, at: "/foo"
endEverything that responds to #call is invoked as it is:
Hanami::Router.new do
get "/hanami", to: ->(env) { [200, {}, ["Hello from Hanami!"]] }
get "/rack-app", to: RackApp.new
get "/method", to: ActionControllerSubclass.action(:new)
endrouter = Hanami::Router.new
router.call(Rack::MockRequest.env_for("/unknown")).status # => 404router = Hanami::Router.new(not_found: ->(_) { [499, {}, []]})
router.call(Rack::MockRequest.env_for("/unknown")).status # => 499Rack ignores request bodies unless they come from a form submission. If we have a JSON endpoint, the payload isn't available in the params hash:
Rack::Request.new(env).params # => {}This feature enables body parsing for specific MIME Types. It comes with a built-in JSON parser and allows to pass custom parsers.
# frozen_string_literal: true
require "hanami/router"
require "hanami/middleware/body_parser"
app = Hanami::Router.new do
patch "/books/:id", to: ->(env) { [200, {}, [env["router.params"].inspect]] }
end
use Hanami::Middleware::BodyParser, :json
run appcurl http://localhost:2300/books/1 \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"published":"true"}' \
-X PATCH
# => [200, {}, ["{:published=>\"true\",:id=>\"1\"}"]]If the json can't be parsed an exception is raised:
Hanami::Middleware::BodyParser::BodyParsingErrormulti_jsonIf you want to use a different JSON backend, include multi_json in your Gemfile.
# frozen_string_literal: true
require "hanami/router"
require "hanami/middleware/body_parser"
# See Hanami::Middleware::BodyParser::Parser
class XmlParser e
raise Hanami::Middleware::BodyParser::BodyParsingError.new(e)
end
end
app = Hanami::Router.new do
patch "/authors/:id", to: ->(env) { [200, {}, [env["router.params"].inspect]] }
end
use Hanami::Middleware::BodyParser, XmlParser
run appcurl http://localhost:2300/authors/1 \
-H "Content-Type: application/xml" \
-H "Accept: application/xml" \
-d 'LG' \
-X PATCH
# => [200, {}, ["{:name=>\"LG\",:id=>\"1\"}"]]# frozen_string_literal: true
require "hanami/router"
router = Hanami::Router.new do
get "/books/:id", to: "books.show", as: :book
end
route = router.recognize("/books/23")
route.verb # "GET"
route.endpoint # => "books.show"
route.params # => {:id=>"23"}
route.routable? # => true
route = router.recognize(:book, id: 23)
route.verb # "GET"
route.endpoint # => "books.show"
route.params # => {:id=>"23"}
route.routable? # => true
route = router.recognize("/books/23", {}, method: :post)
route.verb # "POST"
route.routable? # => falsegit clone [email protected]:your-pseudo/your-cloned-repo.git)git checkout -b my-new-feature)bundle install)rake spec)git commit -am 'Add some feature')git push origin my-new-feature)Thank you for contributing!
See LICENSE file.
暂无开放 Issues,或尚未同步最近议题。