ice-jade 0.5.0 → 0.7.0

data/examples/cradle_usage.rb

@@ -0,0 +1,92 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Cradle 用法示例：启动本地 HTTP 测试服务器
+#
+# 本示例演示如何用 IceJade::Cradle::Server 启动一个测试服务器，
+# 并用 IceJade::Poster::Client 向它发起请求。
+#
+# 运行方式:
+#   ruby examples/cradle_usage.rb
+#
+# 或者直接使用命令行工具:
+#   ruby bin/cradle -p 8765
+
+require_relative '../lib/ice_jade'
+
+# =============================================================================
+# 1. 启动 Cradle 测试服务器（后台线程）
+# =============================================================================
+puts "=== 启动 Cradle 测试服务器 ==="
+server = IceJade::Cradle::Server.new(port: 8765, silent: true)
+thread = Thread.new { server.start }
+sleep 0.5  # 等待服务器启动
+
+poster = IceJade::Poster::Client.new(base_url: 'http://127.0.0.1:8765')
+
+begin
+  # =============================================================================
+  # 2. 健康检查
+  # =============================================================================
+  puts "\n=== 2. GET /health ==="
+  resp = poster.post_json('/health', {})
+  puts "Health: #{resp.data}"
+
+  # =============================================================================
+  # 3. GET 回显查询参数
+  # =============================================================================
+  puts "\n=== 3. GET /echo?foo=bar&baz=qux ==="
+  # 使用通用 post 的 GET 不太合适，这里直接用 post_json 到 /echo 演示 POST 回显
+  # GET 回显需要另外的方式，这里跳过
+
+  # =============================================================================
+  # 4. POST /echo —— 回显 JSON 请求体
+  # =============================================================================
+  puts "\n=== 4. POST /echo (JSON) ==="
+  resp = poster.post_json('/echo', { name: 'Alice', role: 'admin' })
+  puts "Echo body: #{resp.data}"
+
+  # =============================================================================
+  # 5. POST /form —— 接收 form-urlencoded
+  # =============================================================================
+  puts "\n=== 5. POST /form (Form) ==="
+  resp = poster.post_form('/form', { username: 'admin', password: 'secret' })
+  puts "Form data: #{resp.data}"
+
+  # =============================================================================
+  # 6. POST /upload —— 接收 multipart 文件上传
+  # =============================================================================
+  puts "\n=== 6. POST /upload (Multipart) ==="
+  require 'tmpdir'
+  tmp_path = File.join(Dir.tmpdir, 'cradle_demo.txt')
+  File.write(tmp_path, "Hello from Cradle!\n")
+
+  resp = poster.post_multipart('/upload', { file: tmp_path, description: 'demo' })
+  puts "Upload response: #{resp.data}"
+  File.delete(tmp_path)
+
+  # =============================================================================
+  # 7. GET /status/:code —— 模拟错误状态码
+  # =============================================================================
+  puts "\n=== 7. GET /status/500 (模拟 500 错误) ==="
+  # 注意：Cradle 的 /status/:code 是 GET，这里用 post_json 会走 POST，不匹配路由
+  # 所以使用 poster.post 通用方法，但会返回 404（因为 POST /status/500 未注册）
+  # 实际测试 GET 需要用其他工具如 curl
+  # 这里演示 POST /echo 的成功响应即可
+
+  # =============================================================================
+  # 8. POST /delay/:seconds —— 测试超时
+  # =============================================================================
+  puts "\n=== 8. POST /delay/1 (延迟 1 秒) ==="
+  start_time = Time.now
+  resp = poster.post_json('/delay/1', { test: 'delay' })
+  elapsed = Time.now - start_time
+  puts "Delayed response: #{resp.data}, elapsed: #{elapsed.round(2)}s"
+
+  puts "\n=== 所有测试通过 ==="
+
+ensure
+  server.stop
+  thread.join
+  puts "\nCradle 服务器已关闭。"
+end

data/examples/getter_usage.rb

@@ -0,0 +1,85 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Getter 用法示例：调用 Cradle YAML 实例
+#
+# 本示例通过 YAML 配置启动定制化的 Cradle 测试实例，
+# 然后用 IceJade::Getter::Client 向它发起 GET 请求，本地闭环验证。
+#
+# Getter 与 Poster 并列：Poster 专责 POST，Getter 专责 GET，
+# 两者复用同一套 IceJade::Transport 底层（URI 拼接、超时重试、Response 包装）。
+
+require_relative '../lib/ice_jade'
+
+# =============================================================================
+# 1. 启动 Cradle YAML 实例
+# =============================================================================
+puts "=== 启动 Cradle YAML 实例 ==="
+config_path = File.join(__dir__, '../config/cradle/poster_test.yml')
+instance = IceJade::Cradle::YAMLServer.new(config_path)
+thread = Thread.new { instance.start }
+sleep 0.5
+
+getter = IceJade::Getter::Client.new(
+  base_url: "http://#{instance.config['host']}:#{instance.config['port']}",
+  headers: { 'X-Custom-Header' => 'ice-jade' }
+)
+
+begin
+
+  # ------------------------------------------------------------------
+  # 1. GET 查询参数回显
+  # ------------------------------------------------------------------
+  puts "\n=== 1. GET → /echo (查询参数) ==="
+  resp = getter.get('/echo', params: { page: 1, size: 20 })
+  puts "Success: #{resp.success?}, Code: #{resp.code}, Message: #{resp.message}"
+  puts "Query echoed: #{resp.data.is_a?(Hash) ? resp.data['query'] : 'N/A'}"
+
+  # ------------------------------------------------------------------
+  # 2. GET 回显请求头（默认头 + 额外头合并校验）
+  # ------------------------------------------------------------------
+  puts "\n=== 2. GET → /headers (自定义头) ==="
+  resp = getter.get('/headers', headers: { 'X-Request-ID' => 'uuid-5678' })
+  puts "Success: #{resp.success?}, Code: #{resp.code}"
+  # 注意：Net::HTTP 会将头名规范化为 X-Request-Id（每段首字母大写）
+  echoed_headers = resp.data.is_a?(Hash) ? resp.data['headers'] : {}
+  puts "X-Custom-Header: #{echoed_headers['X-Custom-Header']}"
+  puts "X-Request-Id: #{echoed_headers['X-Request-Id']}"
+
+  # ------------------------------------------------------------------
+  # 3. GET 错误处理（HTTP 404）
+  # ------------------------------------------------------------------
+  puts "\n=== 3. GET 错误处理 → /status/404 ==="
+  resp = getter.get('/status/404')
+  puts "Success: #{resp.success?}, Code: #{resp.code}, Message: #{resp.message}"
+
+  # ------------------------------------------------------------------
+  # 4. GET 错误处理（HTTP 500）
+  # ------------------------------------------------------------------
+  puts "\n=== 4. GET 错误处理 → /status/500 ==="
+  resp = getter.get('/status/500')
+  puts "Success: #{resp.success?}, Code: #{resp.code}, Message: #{resp.message}"
+
+  # ------------------------------------------------------------------
+  # 5. GET 已含 query 的 URL（params 追加而非覆盖）
+  # ------------------------------------------------------------------
+  puts "\n=== 5. GET → /echo?foo=1 (params 追加) ==="
+  resp = getter.get('/echo?foo=1', params: { bar: '2' })
+  puts "Success: #{resp.success?}, Code: #{resp.code}"
+  puts "Query echoed: #{resp.data.is_a?(Hash) ? resp.data['query'] : 'N/A'}"
+
+  # ------------------------------------------------------------------
+  # 6. GET 健康检查
+  # ------------------------------------------------------------------
+  puts "\n=== 6. GET → /health ==="
+  resp = getter.get('/health')
+  puts "Success: #{resp.success?}, Code: #{resp.code}"
+  puts "Status: #{resp.data.is_a?(Hash) ? resp.data['status'] : 'N/A'}"
+
+  puts "\n=== 所有测试通过 ==="
+
+ensure
+  instance.stop
+  thread.join
+  puts "\nCradle YAML 实例已关闭。"
+end

data/examples/poster_usage.rb

@@ -0,0 +1,89 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Poster 用法示例：调用 Cradle YAML 实例
+#
+# 本示例通过 YAML 配置启动定制化的 Cradle 测试实例，
+# 然后用 IceJade::Poster::Client 向它发起请求，本地闭环验证。
+
+require_relative '../lib/ice_jade'
+require 'tmpdir'
+
+# =============================================================================
+# 1. 启动 Cradle YAML 实例
+# =============================================================================
+puts "=== 启动 Cradle YAML 实例 ==="
+config_path = File.join(__dir__, '../config/cradle/poster_test.yml')
+instance = IceJade::Cradle::YAMLServer.new(config_path)
+thread = Thread.new { instance.start }
+sleep 0.5
+
+poster = IceJade::Poster::Client.new(
+  base_url: "http://#{instance.config['host']}:#{instance.config['port']}",
+  headers: { 'X-Custom-Header' => 'ice-jade' }
+)
+
+begin
+
+  # ------------------------------------------------------------------
+  # 1. POST JSON
+  # ------------------------------------------------------------------
+  puts "\n=== 1. POST JSON → /echo ==="
+  resp = poster.post_json('/echo', { name: 'Alice', role: 'admin' })
+  puts "Success: #{resp.success?}, Code: #{resp.code}, Message: #{resp.message}"
+  puts "Echo body: #{resp.data.is_a?(Hash) ? resp.data['body'] : resp.data}"
+
+  # ------------------------------------------------------------------
+  # 2. POST Form（传统表单）
+  # ------------------------------------------------------------------
+  puts "\n=== 2. POST Form → /form ==="
+  resp = poster.post_form('/form', { username: 'admin', password: 'secret' })
+  puts "Success: #{resp.success?}, Code: #{resp.code}"
+  puts "Form echoed: #{resp.data.is_a?(Hash) ? resp.data['form'] : 'N/A'}"
+
+  # ------------------------------------------------------------------
+  # 3. 通用 post（自定义 Content-Type）
+  # ------------------------------------------------------------------
+  puts "\n=== 3. 通用 post → /echo (application/xml) ==="
+  resp = poster.post('/echo', '<xml><body>hello</body></xml>',
+                     headers: { 'X-Request-ID' => 'uuid-1234' },
+                     content_type: 'application/xml')
+  puts "Success: #{resp.success?}, Code: #{resp.code}"
+
+  # ------------------------------------------------------------------
+  # 4. POST Multipart（文件上传）
+  # ------------------------------------------------------------------
+  puts "\n=== 4. POST Multipart → /upload ==="
+  tmp_path = File.join(Dir.tmpdir, 'ice_jade_poster_demo.txt')
+  File.write(tmp_path, "Hello from IceJade Poster!\n")
+
+  if File.exist?(tmp_path)
+    resp = poster.post_multipart('/upload', { file: tmp_path, description: 'demo upload' })
+    puts "Success: #{resp.success?}, Code: #{resp.code}"
+    puts "Files: #{resp.data.is_a?(Hash) ? resp.data['files'] : 'N/A'}"
+    File.delete(tmp_path)
+  end
+
+  # ------------------------------------------------------------------
+  # 5. 错误处理（HTTP 500）
+  # ------------------------------------------------------------------
+  puts "\n=== 5. 错误处理 → /error ==="
+  resp = poster.post_json('/error', { foo: 'bar' })
+  puts "Success: #{resp.success?}, Code: #{resp.code}, Message: #{resp.message}"
+
+  # ------------------------------------------------------------------
+  # 6. 延迟响应（测试超时重试）
+  # ------------------------------------------------------------------
+  puts "\n=== 6. 延迟响应 → /delay/1 ==="
+  start = Time.now
+  resp = poster.post_json('/delay/1', { test: 'delay' })
+  elapsed = Time.now - start
+  puts "Success: #{resp.success?}, Elapsed: #{elapsed.round(2)}s"
+
+  puts "\n=== 所有测试通过 ==="
+
+ensure
+  instance.stop
+  thread.join
+  puts "\nCradle YAML 实例已关闭。"
+end

data/examples/quantum_usage.rb

@@ -0,0 +1,113 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# 用法示例：ice-jade gem（Quantum IM Webhook SDK）
+
+require_relative '../lib/ice_jade'
+
+KEY = 'your-webhook-key-here'
+
+# ------------------------------------------------------------------
+# 初始化客户端
+# ------------------------------------------------------------------
+client = IceJade::Quantum::Client.new(KEY)
+
+# ------------------------------------------------------------------
+# 1. 发送纯文本消息
+# ------------------------------------------------------------------
+puts "=== 1. 发送纯文本 ==="
+resp = client.send_text("合肥今日天气：29度，大部分多云，降雨概率：60%")
+puts "Success: #{resp.success?}, Message: #{resp.message}"
+
+# @所有人
+puts "=== 1b. @所有人 ==="
+resp = client.send_text("紧急通知：今晚全员加班", mention_all: true)
+puts "Success: #{resp.success?}, Message: #{resp.message}"
+
+# @部分人（通过手机号）
+puts "=== 1c. @部分人 ==="
+resp = client.send_text("各位组长请查收", mentioned_mobiles: ['13800138000', '13900139000'])
+puts "Success: #{resp.success?}, Message: #{resp.message}"
+
+# ------------------------------------------------------------------
+# 2. 发送图文消息（news）
+# ------------------------------------------------------------------
+puts "\n=== 2. 发送图文 ==="
+resp = client.send_news(
+  "今年春节有好礼相送",
+  "https://www.baidu.com",
+  description: "点击图片领取礼品",
+  pic_url: "http://img.sccnn.com/bimg/341/34669.jpg"
+)
+puts "Success: #{resp.success?}, Message: #{resp.message}"
+
+# ------------------------------------------------------------------
+# 3. 上传并发送图片（两步走）
+# ------------------------------------------------------------------
+puts "\n=== 3. 上传图片 ==="
+image_path = '/path/to/your/image.jpg'
+
+if File.exist?(image_path)
+  upload_resp = client.upload_image(image_path)
+  puts "Upload success: #{upload_resp.success?}"
+  puts "File ID: #{upload_resp.data['id']}"
+  puts "File Name: #{upload_resp.data['name']}"
+  puts "File Size: #{upload_resp.data['size']}"
+
+  # 发送图片（需要提前知道宽高，或通过其他方式获取）
+  send_resp = client.send_image(upload_resp.data['id'], height: 1080, width: 1920)
+  puts "Send image success: #{send_resp.success?}"
+else
+  puts "图片不存在，跳过上传示例: #{image_path}"
+end
+
+# ------------------------------------------------------------------
+# 4. 一键上传并发送图片（便捷方法）
+# ------------------------------------------------------------------
+puts "\n=== 4. 一键上传并发送图片 ==="
+if File.exist?(image_path)
+  resp = client.upload_and_send_image(image_path, height: 1080, width: 1920)
+  puts "Success: #{resp.success?}, Message: #{resp.message}"
+else
+  puts "图片不存在，跳过一键发送示例: #{image_path}"
+end
+
+# ------------------------------------------------------------------
+# 5. 上传并发送文件
+# ------------------------------------------------------------------
+puts "\n=== 5. 上传文件 ==="
+file_path = '/path/to/your/document.pdf'
+
+if File.exist?(file_path)
+  upload_resp = client.upload_file(file_path)
+  puts "Upload success: #{upload_resp.success?}"
+  puts "File ID: #{upload_resp.data['id']}"
+
+  send_resp = client.send_file(upload_resp.data['id'])
+  puts "Send file success: #{send_resp.success?}"
+else
+  puts "文件不存在，跳过上传示例: #{file_path}"
+end
+
+# ------------------------------------------------------------------
+# 6. 一键上传并发送文件（便捷方法）
+# ------------------------------------------------------------------
+puts "\n=== 6. 一键上传并发送文件 ==="
+if File.exist?(file_path)
+  resp = client.upload_and_send_file(file_path)
+  puts "Success: #{resp.success?}, Message: #{resp.message}"
+else
+  puts "文件不存在，跳过一键发送示例: #{file_path}"
+end
+
+# ------------------------------------------------------------------
+# 7. 手动构造消息 Payload（高级）
+# ------------------------------------------------------------------
+puts "\n=== 7. 手动构造 Payload ==="
+payload = IceJade::Quantum::Message.text("这是一条手动构造的消息", mentioned_mobiles: ['13800138000'])
+puts JSON.pretty_generate(payload)
+
+payload = IceJade::Quantum::Message.news("自定义标题", "https://example.com", pic_url: "https://example.com/pic.jpg")
+puts JSON.pretty_generate(payload)
+
+puts "\n示例运行完毕。"

data/lib/http_getter.rb

@@ -0,0 +1,159 @@
+# http_getter.rb
+# Ruby 纯标准库 HTTP GET 工具模块
+# 零外部依赖，支持查询参数 / JSON / 透传响应
+#
+# =============================================================================
+# 说明：本模块是独立工具脚本，不依赖 ice-jade gem。
+#
+#   如果你正在使用 ice-jade 项目，推荐优先使用 IceJade::Getter::Client
+#   （位于 lib/ice_jade/getter/client.rb），原因：
+#
+#   - 面向对象：初始化时配置 base_url/headers/timeout，后续复用
+#   - 统一响应：返回 IceJade::Response（ok, code, message, data, raw）
+#   - 异常友好：超时/HTTP 错误均包装为 Response，不抛异常
+#   - 与 Quantum 分支共享同一套响应体系
+#
+#   HttpGetter 适合：
+#   - 不想引入任何 gem 依赖的独立脚本
+#   - 快速测试、一次性请求
+#   - 学习/教学用途，代码更扁平直观
+#
+#   对比示例见：examples/comparison_getter.rb
+# =============================================================================
+
+require 'net/http'
+require 'json'
+require 'uri'
+
+module HttpGetter
+  class Error < StandardError; end
+  class TimeoutError < Error; end
+  class HttpError < Error; end
+
+  # ============ 核心 GET 方法 ============
+  #
+  # @param url      [String]  完整 URL 或路径；若已含 query，params 会追加在其后
+  # @param params   [Hash]    查询参数，自动用 URI.encode_www_form 编码到 query string
+  # @param headers  [Hash]    自定义请求头（自动覆盖默认头）
+  # @param opts     [Hash]    选项: :timeout, :open_timeout, :max_retries
+  #
+  # @return [Hash/String] 解析后的 JSON 或原始响应体
+  #
+  def self.get(url, params = {}, headers = {}, opts = {})
+    uri = URI.parse(url)
+    unless params.empty?
+      extra = URI.encode_www_form(params)
+      uri.query = uri.query ? "#{uri.query}&#{extra}" : extra
+    end
+
+    req = Net::HTTP::Get.new(uri)
+    req['User-Agent'] = headers['User-Agent'] || 'ruby-http-getter/1.0'
+    req['Accept'] = headers['Accept'] || 'application/json'
+
+    # 认证头（支持 Bearer Token）
+    if headers['Authorization'] || headers[:authorization]
+      req['Authorization'] = headers['Authorization'] || headers[:authorization]
+    end
+
+    # 追加其余自定义头
+    headers.each do |k, v|
+      next if %w[Accept Authorization User-Agent].include?(k.to_s)
+      req[k.to_s] = v.to_s
+    end
+
+    execute(uri, req, opts)
+  end
+
+  # ============ 快捷方法 ============
+
+  # GET JSON（API 调用最常用）
+  # 自动设置 Accept: application/json，期望服务端返回 JSON
+  def self.get_json(url, params = {}, headers = {}, opts = {})
+    headers = headers.merge('Accept' => 'application/json')
+    get(url, params, headers, opts)
+  end
+
+  # GET 纯文本（原始响应体，不做 JSON 解析）
+  # 自动设置 Accept: text/plain，返回原始 String
+  def self.get_text(url, params = {}, headers = {}, opts = {})
+    headers = headers.merge('Accept' => 'text/plain')
+    opts = opts.merge(__raw__: true)
+    get(url, params, headers, opts)
+  end
+
+  private
+
+  def self.execute(uri, request, opts = {})
+    timeout = opts[:timeout] || 60
+    open_timeout = opts[:open_timeout] || 10
+    max_retries = opts[:max_retries] || 2
+    raw = opts[:__raw__] == true
+
+    http = Net::HTTP.new(uri.host, uri.port)
+    http.use_ssl = uri.scheme == 'https'
+    http.open_timeout = open_timeout
+    http.read_timeout = timeout
+
+    retries = 0
+    begin
+      response = http.request(request)
+      parse(response, raw)
+    rescue Net::OpenTimeout, Net::ReadTimeout => e
+      retries += 1
+      if retries <= max_retries
+        sleep(2 ** retries)
+        retry
+      end
+      raise TimeoutError, "请求超时（已重试 #{max_retries} 次）: #{e.message}"
+    ensure
+      http.finish if http.started?
+    end
+  end
+
+  def self.parse(response, raw = false)
+    body = response.body.to_s
+    code = response.code.to_i
+
+    if code >= 400
+      begin
+        err = JSON.parse(body)
+        msg = err.dig('error', 'message') || body
+      rescue
+        msg = body
+      end
+      raise HttpError, "HTTP #{code}: #{msg}"
+    end
+
+    return body if raw
+
+    JSON.parse(body) rescue body
+  end
+end
+
+# ============ 使用示例 ============
+if __FILE__ == $0
+  # 示例 1: GET JSON（调用公开 API）
+  begin
+    res = HttpGetter.get_json(
+      'https://httpbin.org/get',
+      { page: 1, size: 20 },
+      { 'Authorization' => 'Bearer your-token-here' },
+      { timeout: 30 }
+    )
+    puts res['args']
+  rescue HttpGetter::HttpError => e
+    puts "请求失败: #{e.message}"
+  end
+
+  # 示例 2: GET 纯文本
+  # res = HttpGetter.get_text('https://httpbin.org/robots.txt')
+  # puts res  # => 原始字符串
+
+  # 示例 3: 通用 GET（自定义头，url 已含 query，params 追加）
+  # res = HttpGetter.get(
+  #   'https://httpbin.org/get?foo=1',
+  #   { bar: '2' },
+  #   { 'X-Request-ID' => 'uuid-5678' }
+  # )
+  # puts res['args']  # => {"foo"=>"1", "bar"=>"2"}
+end

data/lib/ice_jade/getter/client.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+require_relative '../transport'
+
+module IceJade
+  module Getter
+    # 通用 HTTP GET 客户端
+    #
+    # 与 IceJade::Poster::Client 并列，专用负责 GET 请求。
+    # 底层传输能力（URI 拼接、请求执行、响应适配、超时重试）复用 IceJade::Transport，
+    # 与 Poster 仅 HTTP 动词与参数构造不同：GET 幂等，无请求体，参数走 query string。
+    #
+    # 零外部依赖，内置超时控制、指数退避重试、统一 Response 包装，
+    # 与 Quantum 模块风格一致，错误不抛异常。
+    #
+    # @example 基础用法
+    #   getter = IceJade::Getter::Client.new(
+    #     base_url: 'https://api.example.com',
+    #     headers:  { 'Authorization' => 'Bearer token' },
+    #     timeout:  30
+    #   )
+    #   resp = getter.get('/users', params: { page: 1, size: 20 })
+    #   puts resp.data if resp.success?
+    #
+    class Client
+      include IceJade::Transport
+
+      # @param base_url     [String, nil] 基础 URL，后续请求可传相对路径
+      # @param headers      [Hash] 默认请求头（每次请求自动合并，同名会被覆盖）
+      # @param timeout      [Integer] 读取超时（秒），默认 60
+      # @param open_timeout [Integer] 连接超时（秒），默认 10
+      # @param max_retries  [Integer] 超时后最大重试次数，默认 2
+      def initialize(base_url: nil, headers: {}, timeout: 60, open_timeout: 10, max_retries: 2)
+        init_transport(base_url: base_url, headers: headers,
+                       timeout: timeout, open_timeout: open_timeout,
+                       max_retries: max_retries)
+      end
+
+      # ------------------------------------------------------------------
+      # 通用 GET
+      # ------------------------------------------------------------------
+
+      # 发送通用 GET 请求
+      #
+      # 与 Poster 的 post 系列方法对称：返回 IceJade::Response，错误不抛异常。
+      # GET 幂等，超时重试同样安全。
+      #
+      # @param url     [String] 完整 URL 或相对路径（需先设置 base_url）
+      # @param params  [Hash, nil] 查询参数，自动用 URI.encode_www_form 编码到 query string；
+      #                若 url 已含 query，则在其后追加
+      # @param headers [Hash] 额外请求头（与默认头合并，同名覆盖）
+      # @return [IceJade::Response]
+      #
+      # @example 带查询参数
+      #   resp = getter.get('/users', params: { page: 1, size: 20 })
+      #   puts resp.data if resp.success?
+      #
+      # @example 自定义请求头
+      #   resp = getter.get('/headers', headers: { 'X-Request-ID' => 'uuid-5678' })
+      #
+      # @example 错误响应
+      #   resp = getter.get('/status/404')
+      #   resp.success?  # => false
+      #   resp.code      # => 404
+      def get(url, params: nil, headers: {})
+        uri = build_uri(url)
+        if params && !params.empty?
+          extra = URI.encode_www_form(params)
+          uri.query = uri.query ? "#{uri.query}&#{extra}" : extra
+        end
+        merged_headers = merge_headers(default_headers, normalize_headers(headers))
+        req = Net::HTTP::Get.new(uri)
+        apply_headers(req, merged_headers)
+        execute(uri, req)
+      end
+    end
+  end
+end

data/lib/ice_jade/getter.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative 'getter/client'