Her自定义请求：5种方式扩展你的API调用

Her自定义请求5种方式扩展你的API调用【免费下载链接】herHer is an ORM (Object Relational Mapper) that maps REST resources to Ruby objects. It is designed to build applications that are powered by a RESTful API instead of a database.项目地址: https://gitcode.com/gh_mirrors/he/herHer作为一款强大的Ruby ORM工具允许开发者将REST资源映射为Ruby对象轻松构建基于RESTful API的应用。本文将分享5种实用方法帮助你灵活扩展Her的API调用能力满足复杂业务需求。1. 自定义HTTP方法快速定义专用接口Her提供了简洁的自定义HTTP方法API让你为模型添加专用接口。通过custom_get、custom_post等方法无需复杂配置即可创建自定义端点调用。例如为用户模型添加获取热门用户和最近活动的接口class User include Her::Model custom_get :popular, :recent custom_post :activate end调用方式直观简洁# 获取热门用户列表 popular_users User.popular # 激活用户账户 user User.activate(id: 123)这些方法定义在lib/her/model/http.rb中支持标准HTTP动词满足各类API交互场景。2. 中间件栈配置打造个性化请求流程Her基于Faraday构建HTTP请求系统允许你完全定制中间件栈控制请求/响应处理流程。通过setup块访问Faraday连接对象灵活添加、移除或替换中间件。基础配置示例Her::API.setup url: https://api.example.com do |c| # 添加JSON解析中间件 c.use Her::Middleware::FirstLevelParseJSON # 添加Accept头中间件 c.use Her::Middleware::AcceptJSON # 使用Net::HTTP适配器 c.adapter Faraday.default_adapter endHer提供多种内置中间件如lib/her/middleware/json_api_parser.rb用于JSON API规范解析lib/her/middleware/second_level_parse_json.rb处理嵌套数据结构。你也可以开发自定义中间件实现认证、缓存、日志等功能。3. 认证中间件安全访问受保护资源Her默认不提供认证功能但通过中间件机制可轻松实现各类认证方案。常见的做法是添加请求头认证中间件Her::API.setup url: https://api.example.com do |c| c.use Her::Middleware::AcceptJSON c.use Her::Middleware::FirstLevelParseJSON # 添加认证中间件 c.use Faraday::Request::Authorization do |request| Bearer #{current_user.api_token} end c.adapter Faraday.default_adapter end对于OAuth等复杂认证可结合faraday_middleware和simple_oauthgems实现更高级的认证流程确保API调用安全可靠。4. 自定义解析逻辑适配独特API响应格式当API响应格式不符合标准时Her允许你通过两种方式自定义解析逻辑使用自定义中间件创建响应解析中间件设置env[:body]为包含:data、:errors和:metadata键的哈希class CustomParser Faraday::Middleware def call(env) app.call(env).on_complete do |response_env| parsed JSON.parse(response_env[:body]) response_env[:body] { data: parsed[result], errors: parsed[errors], metadata: { total: parsed[total] } } end end end # 在API设置中使用 Her::API.setup url: https://api.example.com do |c| c.use CustomParser c.adapter Faraday.default_adapter end模型级解析通过重写模型的parse方法自定义单个模型的解析逻辑详细实现可参考lib/her/model/parse.rb。5. 请求缓存提升应用性能与响应速度利用Faraday中间件生态系统可轻松为Her添加请求缓存功能。结合faraday_middleware和缓存存储如Memcached# 添加到Gemfile gem faraday_middleware gem memcached # 配置缓存中间件 Her::API.setup url: https://api.example.com do |c| c.use Her::Middleware::AcceptJSON c.use Her::Middleware::FirstLevelParseJSON # 添加缓存中间件 c.use FaradayMiddleware::Cache, Memcached.new(localhost:11211) c.adapter Faraday.default_adapter end缓存策略可根据需求定制有效减少重复请求提升应用性能特别适合频繁访问且不常变化的资源。总结灵活扩展Her的API调用能力通过自定义HTTP方法、中间件栈配置、认证中间件、解析逻辑和请求缓存这5种方式你可以充分扩展Her的API调用能力使其完美适配各类RESTful API。无论是简单的端点扩展还是复杂的请求流程定制Her都提供了简洁而强大的接口帮助你构建高效、灵活的API客户端应用。开始使用Her时可通过克隆仓库获取完整代码git clone https://gitcode.com/gh_mirrors/he/her探索lib/her/api.rb和lib/her/model/http.rb中的实现细节发现更多扩展可能性打造符合特定业务需求的API交互层。【免费下载链接】herHer is an ORM (Object Relational Mapper) that maps REST resources to Ruby objects. It is designed to build applications that are powered by a RESTful API instead of a database.项目地址: https://gitcode.com/gh_mirrors/he/her创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考