alipay-easysdk-ruby 1.0.2 → 1.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e0448e76a0838f021e25e4181ca71d3f28586426a636eda913b93ba9ef221740
-  data.tar.gz: de78cb3ee1ba2e4643e1ee6c7b804f38d5c99fff93b92b59ea5aaced4a9a2702
+  metadata.gz: 9fbf7bcd464b1d9f4c42aaec6030ba6dfc9a4beda7eb5c3ea2587722b2fdff01
+  data.tar.gz: 43c10156f010ca3f98696361f9d9a07478bd1ea44c1533a086f5c2c066956c9b
 SHA512:
-  metadata.gz: 1f6efbf67c297f1bb264c388095e715f6774e3a6bbf555d38d1ddf4a1d28d3d3580c6843b1ec721bb8dc61644261e16c39a816695c5cb06b49026aef82ed6235
-  data.tar.gz: 0d8aec51df7f3f588bf58aa3255840785fbe3357e1fb36870195abe7e308098f69d8f5e50c385cfcec959a876ee71445f61efb8d257ba2043b4a29878b69edc3
+  metadata.gz: d10e78d464ea90c15a6b9e17bcbbf1e6414fb3a842eda95f2662e69e3de245e6209214b096b8b3dd38f8bd0daefcd4c12b664b8947de02feb544b83f0be41b8e
+  data.tar.gz: fddc8561482df008189ba3cfcd93fc3751e1ea192d07c9008f201ee6c211f780da96ddd2de9d90395c48d575481e8f50c766a63e0792b05c1c55f5992f95d728

data/CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+## 1.0.3 - 2024-06-06
+
+- Add `payment/app` client and response model to match PHP EasySDK behaviour.
+- Align kernel utilities (Config, Factory, EasySDKKernel, PageUtil, AES, Signer, JsonUtil, ResponseChecker) with the PHP implementation.
+- Update Payment::Common/Page/Wap clients and models to PHP parity while retaining the custom `payment_url` extension.
+- Refresh parity fixtures, expand test coverage, and remove the deprecated `examples/` directory.
+
+## 1.0.2 - 2024-04-15
+
+- Align `payment/page`, `payment/wap`, and `payment/common` dependencies with the PHP EasySDK implementation.
+- Extend `Kernel::Config` to support certificate paths, proxy, notify URL, and encryption settings used by PHP clients.
+- Introduce certificate environment utilities to derive certificate serial numbers and cached public keys.
+- Update `Payment::Common::Client` to honour proxy and SSL settings and improve parity with PHP HTTP behaviour.
+- Add comprehensive test coverage for certificate handling, extended configuration, and HTTP proxy behaviour.
+
+## 1.0.1 - 2024-03-01
+
+- Initial public release of the Ruby EasySDK port.

data/lib/alipay/easysdk/kernel/alipay_constants.rb

@@ -4,41 +4,39 @@ module Alipay
   module EasySDK
     module Kernel
       module AlipayConstants
-        DEFAULT_CHARSET = "UTF-8"
-
-        # 签名类型
-        SIGN_TYPE_RSA = "RSA"
-        SIGN_TYPE_RSA2 = "RSA2"
+        # Config键名（对齐PHP版）
+        PROTOCOL_CONFIG_KEY = "protocol"
+        HOST_CONFIG_KEY = "gatewayHost"
+        ALIPAY_CERT_PATH_CONFIG_KEY = "alipayCertPath"
+        MERCHANT_CERT_PATH_CONFIG_KEY = "merchantCertPath"
+        ALIPAY_ROOT_CERT_PATH_CONFIG_KEY = "alipayRootCertPath"
+        SIGN_TYPE_CONFIG_KEY = "signType"
+        NOTIFY_URL_CONFIG_KEY = "notifyUrl"
 
-        # 字段常量
-        APP_ID_FIELD = "app_id"
-        METHOD_FIELD = "method"
-        FORMAT_FIELD = "format"
-        TIMESTAMP_FIELD = "timestamp"
-        VERSION_FIELD = "version"
-        SIGN_TYPE_FIELD = "sign_type"
-        SIGN_FIELD = "sign"
+        # 与网关交互使用的字段
         BIZ_CONTENT_FIELD = "biz_content"
-        CHARSET_FIELD = "charset"
-        BODY_FIELD = "body"
         ALIPAY_CERT_SN_FIELD = "alipay_cert_sn"
+        SIGN_FIELD = "sign"
+        BODY_FIELD = "http_body"
         NOTIFY_URL_FIELD = "notify_url"
-        NOTIFY_URL_CONFIG_KEY = "notifyUrl"
-        PROTOCOL_CONFIG_KEY = "protocol"
-        HOST_CONFIG_KEY = "gatewayHost"
+        METHOD_FIELD = "method"
         RESPONSE_SUFFIX = "_response"
         ERROR_RESPONSE = "error_response"
 
-        # 默认值
+        DEFAULT_CHARSET = "UTF-8"
         DEFAULT_FORMAT = "json"
         DEFAULT_VERSION = "1.0"
-        DEFAULT_SIGN_TYPE = SIGN_TYPE_RSA2
+        DEFAULT_SIGN_TYPE = "RSA2"
+
+        SIGN_TYPE_RSA = "RSA"
+        SIGN_TYPE_RSA2 = "RSA2"
+        RSA2 = "RSA2"
+        SHA_256_WITH_RSA = "SHA256WithRSA"
+        RSA = "RSA"
 
-        # 请求方式
         GET = "GET"
         POST = "POST"
 
-        # SDK信息
         SDK_VERSION = "alipay-easysdk-ruby-#{Alipay::EasySDK::VERSION}"
       end
     end

data/lib/alipay/easysdk/kernel/cert_environment.rb

@@ -0,0 +1,35 @@
+require 'openssl'
+require 'digest/md5'
+
+require_relative 'util/ant_certification_util'
+
+module Alipay
+  module EasySDK
+    module Kernel
+      class CertEnvironment
+        attr_reader :root_cert_sn, :merchant_cert_sn
+
+        def initialize
+          @cert_util = Util::AntCertificationUtil.new
+          @root_cert_sn = nil
+          @merchant_cert_sn = nil
+          @cached_alipay_public_key = nil
+        end
+
+        def setup(merchant_cert_path, alipay_cert_path, alipay_root_cert_path)
+          if [merchant_cert_path, alipay_cert_path, alipay_root_cert_path].any? { |path| path.nil? || path.to_s.strip.empty? }
+            raise RuntimeError, '证书参数merchantCertPath、alipayCertPath或alipayRootCertPath设置不完整。'
+          end
+
+          @root_cert_sn = @cert_util.root_cert_sn(alipay_root_cert_path)
+          @merchant_cert_sn = @cert_util.cert_sn(merchant_cert_path)
+          @cached_alipay_public_key = @cert_util.public_key(alipay_cert_path)
+        end
+
+        def cached_alipay_public_key
+          @cached_alipay_public_key
+        end
+      end
+    end
+  end
+end

data/lib/alipay/easysdk/kernel/config.rb

@@ -1,81 +1,108 @@
-require_relative 'alipay_constants'
-
 module Alipay
   module EasySDK
     module Kernel
       class Config
         attr_accessor :protocol,
-                      :gateway_host,
-                      :app_id,
-                      :sign_type,
-                      :alipay_public_key,
-                      :merchant_private_key,
-                      :merchant_cert_path,
-                      :alipay_cert_path,
-                      :alipay_root_cert_path,
-                      :merchant_cert_sn,
-                      :alipay_cert_sn,
-                      :alipay_root_cert_sn,
-                      :notify_url,
-                      :encrypt_key,
-                      :http_proxy,
-                      :ignore_ssl,
-                      :charset,
-                      :format,
-                      :version
-
-        def initialize(options = {})
-          opts = options || {}
-
-          @protocol = fetch_option(opts, :protocol, 'protocol') || 'https'
-          @gateway_host = fetch_option(opts, :gateway_host, 'gateway_host', :gatewayHost, 'gatewayHost') || 'openapi.alipay.com/gateway.do'
-          @app_id = fetch_option(opts, :app_id, 'app_id', :appId, 'appId')
-          @sign_type = fetch_option(opts, :sign_type, 'sign_type', :signType, 'signType') || AlipayConstants::DEFAULT_SIGN_TYPE
-          @alipay_public_key = fetch_option(opts, :alipay_public_key, 'alipay_public_key', :alipayPublicKey, 'alipayPublicKey')
-          @merchant_private_key = fetch_option(opts, :merchant_private_key, 'merchant_private_key', :merchantPrivateKey, 'merchantPrivateKey')
-          @merchant_cert_path = fetch_option(opts, :merchant_cert_path, 'merchant_cert_path', :merchantCertPath, 'merchantCertPath')
-          @alipay_cert_path = fetch_option(opts, :alipay_cert_path, 'alipay_cert_path', :alipayCertPath, 'alipayCertPath')
-          @alipay_root_cert_path = fetch_option(opts, :alipay_root_cert_path, 'alipay_root_cert_path', :alipayRootCertPath, 'alipayRootCertPath')
-          @merchant_cert_sn = fetch_option(opts, :merchant_cert_sn, 'merchant_cert_sn', :merchantCertSN, 'merchantCertSN')
-          @alipay_cert_sn = fetch_option(opts, :alipay_cert_sn, 'alipay_cert_sn', :alipayCertSN, 'alipayCertSN')
-          @alipay_root_cert_sn = fetch_option(opts, :alipay_root_cert_sn, 'alipay_root_cert_sn', :alipayRootCertSN, 'alipayRootCertSN')
-          @notify_url = fetch_option(opts, :notify_url, 'notify_url', :notifyUrl, 'notifyUrl')
-          @encrypt_key = fetch_option(opts, :encrypt_key, 'encrypt_key', :encryptKey, 'encryptKey')
-          @http_proxy = fetch_option(opts, :http_proxy, 'http_proxy', :httpProxy, 'httpProxy')
-          @ignore_ssl = fetch_option(opts, :ignore_ssl, 'ignore_ssl', :ignoreSSL, 'ignoreSSL')
-          @charset = fetch_option(opts, :charset, 'charset') || AlipayConstants::DEFAULT_CHARSET
-          @format = fetch_option(opts, :format, 'format') || AlipayConstants::DEFAULT_FORMAT
-          @version = fetch_option(opts, :version, 'version') || AlipayConstants::DEFAULT_VERSION
-        end
+                      :gatewayHost,
+                      :appId,
+                      :signType,
+                      :alipayPublicKey,
+                      :merchantPrivateKey,
+                      :merchantCertPath,
+                      :alipayCertPath,
+                      :alipayRootCertPath,
+                      :merchantCertSN,
+                      :alipayCertSN,
+                      :alipayRootCertSN,
+                      :notifyUrl,
+                      :encryptKey,
+                      :httpProxy,
+                      :ignoreSSL
 
-        def gateway_url
-          "#{@protocol}://#{@gateway_host}"
+        def initialize(options = nil)
+          assign_attributes(options) if options
         end
 
-        def validate
-          raise "app_id is required" if @app_id.nil? || @app_id.empty?
-          raise "merchant_private_key is required" if @merchant_private_key.nil? || @merchant_private_key.empty?
-          raise "alipay_public_key is required" if @alipay_public_key.nil? || @alipay_public_key.empty?
-        end
+        # 下划线风格的访问器保持向后兼容
+        alias_method :gateway_host, :gatewayHost
+        alias_method :gateway_host=, :gatewayHost=
+
+        alias_method :app_id, :appId
+        alias_method :app_id=, :appId=
+
+        alias_method :sign_type, :signType
+        alias_method :sign_type=, :signType=
+
+        alias_method :alipay_public_key, :alipayPublicKey
+        alias_method :alipay_public_key=, :alipayPublicKey=
+
+        alias_method :merchant_private_key, :merchantPrivateKey
+        alias_method :merchant_private_key=, :merchantPrivateKey=
+
+        alias_method :merchant_cert_path, :merchantCertPath
+        alias_method :merchant_cert_path=, :merchantCertPath=
+
+        alias_method :alipay_cert_path, :alipayCertPath
+        alias_method :alipay_cert_path=, :alipayCertPath=
+
+        alias_method :alipay_root_cert_path, :alipayRootCertPath
+        alias_method :alipay_root_cert_path=, :alipayRootCertPath=
+
+        alias_method :merchant_cert_sn, :merchantCertSN
+        alias_method :merchant_cert_sn=, :merchantCertSN=
+
+        alias_method :alipay_cert_sn, :alipayCertSN
+        alias_method :alipay_cert_sn=, :alipayCertSN=
+
+        alias_method :alipay_root_cert_sn, :alipayRootCertSN
+        alias_method :alipay_root_cert_sn=, :alipayRootCertSN=
+
+        alias_method :notify_url, :notifyUrl
+        alias_method :notify_url=, :notifyUrl=
+
+        alias_method :encrypt_key, :encryptKey
+        alias_method :encrypt_key=, :encryptKey=
+
+        alias_method :http_proxy, :httpProxy
+        alias_method :http_proxy=, :httpProxy=
+
+        alias_method :ignore_ssl, :ignoreSSL
+        alias_method :ignore_ssl=, :ignoreSSL=
 
         private
 
-        def fetch_option(options, *keys)
-          keys.each do |key|
-            if key.is_a?(String)
-              symbol_key = key.tr('-', '_').to_sym
-              return options[key] if options.key?(key)
-              return options[symbol_key] if options.key?(symbol_key)
-            elsif key.is_a?(Symbol)
-              string_key = key.to_s
-              camel_case_key = string_key.gsub(/_([a-z])/) { Regexp.last_match(1).upcase }
-              return options[key] if options.key?(key)
-              return options[string_key] if options.key?(string_key)
-              return options[camel_case_key] if options.key?(camel_case_key)
-            end
+        def assign_attributes(options)
+          options.each do |key, value|
+            setter = attribute_writer_for(key)
+            public_send(setter, value) if setter && respond_to?(setter, true)
           end
+        end
+
+        def attribute_writer_for(key)
+          string_key = key.to_s
+          writer = "#{string_key}="
+          return writer if respond_to?(writer, true)
+
+          camel_case = underscore_to_camel(string_key)
+          writer = "#{camel_case}="
+          return writer if respond_to?(writer, true)
+
+          snake_case = camel_to_snake(string_key)
+          writer = "#{snake_case}="
+          return writer if respond_to?(writer, true)
+
           nil
         end
+
+        def underscore_to_camel(str)
+          str.split('_').inject do |memo, part|
+            memo + part.capitalize
+          end
+        end
+
+        def camel_to_snake(str)
+          str.gsub(/([A-Z]+)/) { "_#{$1.downcase}" }.sub(/^_/, '')
+        end
       end
     end
   end

data/lib/alipay/easysdk/kernel/easy_sdk_kernel.rb

@@ -3,6 +3,8 @@ require_relative 'config'
 require_relative 'util/json_util'
 require_relative 'util/signer'
 require_relative 'util/sign_content_extractor'
+require_relative 'util/aes'
+require_relative 'util/page_util'
 require 'net/http'
 require 'uri'
 require 'cgi'
@@ -39,47 +41,16 @@ module Alipay
       end
 
       def get_config(key)
-        lookup = {
-          'protocol' => :protocol,
-          'gatewayHost' => :gateway_host,
-          'gateway_host' => :gateway_host,
-          'appId' => :app_id,
-          'app_id' => :app_id,
-          'merchantPrivateKey' => :merchant_private_key,
-          'merchant_private_key' => :merchant_private_key,
-          'alipayPublicKey' => :alipay_public_key,
-          'alipay_public_key' => :alipay_public_key,
-          'signType' => :sign_type,
-          'sign_type' => :sign_type,
-          'charset' => :charset,
-          'format' => :format,
-          'version' => :version,
-          'notifyUrl' => :notify_url,
-          'notify_url' => :notify_url,
-          'encryptKey' => :encrypt_key,
-          'encrypt_key' => :encrypt_key,
-          'httpProxy' => :http_proxy,
-          'http_proxy' => :http_proxy,
-          'ignoreSSL' => :ignore_ssl,
-          'ignore_ssl' => :ignore_ssl,
-          'merchantCertPath' => :merchant_cert_path,
-          'merchant_cert_path' => :merchant_cert_path,
-          'alipayCertPath' => :alipay_cert_path,
-          'alipay_cert_path' => :alipay_cert_path,
-          'alipayRootCertPath' => :alipay_root_cert_path,
-          'alipay_root_cert_path' => :alipay_root_cert_path,
-          'merchantCertSN' => :merchant_cert_sn,
-          'merchant_cert_sn' => :merchant_cert_sn,
-          'alipayCertSN' => :alipay_cert_sn,
-          'alipay_cert_sn' => :alipay_cert_sn,
-          'alipayRootCertSN' => :alipay_root_cert_sn,
-          'alipay_root_cert_sn' => :alipay_root_cert_sn
-        }
-
-        method = lookup[key]
-        return unless method
-
-        @config.public_send(method)
+        method = key.to_s
+        return @config.public_send(method) if @config.respond_to?(method)
+
+        snake = method.gsub(/([A-Z]+)/) { "_#{$1.downcase}" }.sub(/^_/, '')
+        return @config.public_send(snake) if @config.respond_to?(snake)
+
+        camel = snake.split('_').inject { |memo, part| memo + part.capitalize }
+        return @config.public_send(camel) if camel && @config.respond_to?(camel)
+
+        nil
       end
 
       def get_sdk_version
@@ -97,9 +68,9 @@ module Alipay
       def read_as_json(response, method)
         response_body = response.body
         map = {}
-        map['body'] = response_body
-        map['method'] = method
-        return map
+        map[AlipayConstants::BODY_FIELD] = response_body
+        map[AlipayConstants::METHOD_FIELD] = method
+        map
       end
 
       def get_random_boundary
@@ -109,11 +80,12 @@ module Alipay
       def generate_page(method, system_params, biz_params, text_params, sign)
         puts "[DEBUG] generate_page - sign长度: #{sign.length}" if ENV['DEBUG']
         signed_params = build_signed_params(system_params, biz_params, text_params, sign)
-        if method == 'GET'
-          return build_gateway_url(signed_params)
-        elsif method == 'POST'
+        case method
+        when AlipayConstants::GET
+          build_gateway_url(signed_params)
+        when AlipayConstants::POST
           puts "[DEBUG] generate_page POST - sorted_map中sign长度: #{signed_params[AlipayConstants::SIGN_FIELD].length}" if ENV['DEBUG']
-          return build_form(get_gateway_server_url, signed_params)
+          build_form(get_gateway_server_url, signed_params)
         else
           raise "不支持" + method
         end
@@ -130,8 +102,8 @@ module Alipay
 
       def get_alipay_cert_sn(resp_map)
         if !@config.merchant_cert_sn.nil? && !@config.merchant_cert_sn.empty?
-          body = JSON.parse(resp_map['body'])
-          alipay_cert_sn = body['alipay_cert_sn']
+          body = JSON.parse(resp_map[AlipayConstants::BODY_FIELD])
+          alipay_cert_sn = body[AlipayConstants::ALIPAY_CERT_SN_FIELD]
           return alipay_cert_sn
         end
       end
@@ -150,10 +122,10 @@ module Alipay
       end
 
       def verify(resp_map, alipay_public_key)
-        resp = JSON.parse(resp_map['body'])
+        resp = JSON.parse(resp_map[AlipayConstants::BODY_FIELD])
         sign = resp[AlipayConstants::SIGN_FIELD]
         sign_content_extractor = Alipay::EasySDK::Kernel::Util::SignContentExtractor.new
-        content = sign_content_extractor.get_sign_source_data(resp_map['body'], resp_map['method'])
+        content = sign_content_extractor.get_sign_source_data(resp_map[AlipayConstants::BODY_FIELD], resp_map[AlipayConstants::METHOD_FIELD])
         signer = Alipay::EasySDK::Kernel::Util::Signer.new
         return signer.verify(content, sign, alipay_public_key)
       end
@@ -178,18 +150,55 @@ module Alipay
         URI.encode_www_form(sorted_map)
       end
 
+      def to_multipart_request_body(text_params, file_params, boundary)
+        @text_params = text_params
+        @biz_params = nil
+        if text_params != nil && !@optional_text_params.empty?
+          @text_params = text_params.merge(@optional_text_params)
+        elsif text_params == nil
+          @text_params = @optional_text_params.dup
+        end
+
+        parts = []
+        (@text_params || {}).each do |key, value|
+          parts << build_multipart_text_part(boundary, key, value)
+        end
+
+        (file_params || {}).each do |key, path|
+          raise "文件#{path}不存在" unless File.exist?(path.to_s)
+          file_content = File.binread(path)
+          filename = File.basename(path)
+          parts << build_multipart_file_part(boundary, key, filename, file_content)
+        end
+
+        return nil if parts.empty?
+
+        parts << "--#{boundary}--\r\n"
+        parts.join
+      end
+
+      def aes_encrypt(content, encrypt_key)
+        aes = Alipay::EasySDK::Kernel::Util::AES.new
+        aes.aes_encrypt(content, encrypt_key)
+      end
+
+      def aes_decrypt(content, encrypt_key)
+        aes = Alipay::EasySDK::Kernel::Util::AES.new
+        aes.aes_decrypt(content, encrypt_key)
+      end
+
       def sort_map(random_map)
         return random_map
       end
 
       def to_resp_model(resp_map)
-        body = resp_map['body']
-        method_name = resp_map['method']
+        body = resp_map[AlipayConstants::BODY_FIELD]
+        method_name = resp_map[AlipayConstants::METHOD_FIELD]
         response_node_name = method_name.gsub(".", "_") + "_response"
 
         model = JSON.parse(body)
-        if body.include?("error_response")
-          result = model["error_response"]
+        if body.include?(AlipayConstants::ERROR_RESPONSE)
+          result = model[AlipayConstants::ERROR_RESPONSE]
           result['body'] = body
         else
           result = model[response_node_name]
@@ -236,15 +245,15 @@ module Alipay
           @biz_params = @optional_biz_params
         end
 
-        json = Alipay::EasySDK::Kernel::Util::JsonUtil.new
-        if @biz_params != nil
-          biz_params = json.to_json_string(@biz_params)
-        end
+        json_util = Alipay::EasySDK::Kernel::Util::JsonUtil.new
+        biz_content = json_util.to_json_string(@biz_params) unless @biz_params.nil?
+
         sorted_map = (system_params || {}).dup
-        if !biz_params.nil? && !biz_params.empty?
-          # 模拟PHP json_encode($bizParams, JSON_UNESCAPED_UNICODE)
-          json_string = JSON.generate(JSON.parse(biz_params)).gsub('/', "\\/")
-          sorted_map[AlipayConstants::BIZ_CONTENT_FIELD] = json_string
+        if !biz_content.nil?
+          unless biz_content.respond_to?(:empty?) && biz_content.empty?
+            serialized = JSON.generate(biz_content, ascii_only: false).gsub('/', '\\/')
+            sorted_map[AlipayConstants::BIZ_CONTENT_FIELD] = serialized
+          end
         end
         if !@text_params.nil? && !@text_params.empty?
           if !sorted_map.empty?
@@ -253,15 +262,19 @@ module Alipay
             sorted_map = @text_params
           end
         end
-        if get_config('notify_url') != nil
-          sorted_map['notify_url'] = get_config('notify_url')
+        notify_value = get_config(AlipayConstants::NOTIFY_URL_CONFIG_KEY)
+        if !notify_value.nil? && notify_value.to_s.strip != ''
+          sorted_map[AlipayConstants::NOTIFY_URL_FIELD] = notify_value
         end
         return sorted_map
       end
 
       def get_sign_content(params)
         # 模拟PHP的ksort
-        sorted_params = params.sort_by { |k, _| k.to_s }.to_h
+        normalized = params.each_with_object({}) do |(key, value), acc|
+          acc[key.to_s] = value
+        end
+        sorted_params = normalized.sort.to_h
 
         string_to_be_signed = ""
         i = 0
@@ -281,7 +294,9 @@ module Alipay
       end
 
       def get_gateway_server_url
-        return get_config('protocol') + '://' + get_config('gatewayHost').gsub('/gateway.do', '') + '/gateway.do'
+        protocol = get_config(AlipayConstants::PROTOCOL_CONFIG_KEY)
+        host = get_config(AlipayConstants::HOST_CONFIG_KEY)
+        return protocol + '://' + host.gsub('/gateway.do', '') + '/gateway.do'
       end
 
       def check_empty(value)
@@ -322,25 +337,8 @@ module Alipay
         puts "[DEBUG] build_form - 原始params keys: #{params.keys.join(', ')}" if ENV['DEBUG']
         puts "[DEBUG] build_form - sign长度: #{params[AlipayConstants::SIGN_FIELD].length}" if ENV['DEBUG'] && params[AlipayConstants::SIGN_FIELD]
 
-        # 完全按照PHP版本的PageUtil::buildForm方法：过滤空值参数
-        form_fields = ""
-        params.each do |key, val|
-          if !check_empty(val)  # 与PHP版本的checkEmpty逻辑完全一致
-            # 按照PHP版本：将单引号替换为&amp;apos;
-            escaped_val = val.to_s.gsub("'", "&apos;")
-            form_fields += "<input type='hidden' name='#{key}' value='#{escaped_val}'/>"
-          end
-        end
-
-        # 完全按照PHP版本：在action URL中添加charset参数
-        action_url = "#{url}?charset=#{AlipayConstants::DEFAULT_CHARSET}"
-
-        <<~HTML
-          <form id='alipaysubmit' name='alipaysubmit' action='#{action_url}' method='POST'>
-            #{form_fields}
-            <input type='submit' value='ok' style='display:none;'></form>
-          <script>document.forms['alipaysubmit'].submit();</script>
-        HTML
+        page_util = Alipay::EasySDK::Kernel::Util::PageUtil.new
+        page_util.build_form(url, params)
       end
 
       def build_signed_params(system_params, biz_params, text_params, sign)
@@ -350,10 +348,25 @@ module Alipay
       end
 
       def build_gateway_url(signed_params)
-        base_url = get_gateway_server_url + "?charset=#{AlipayConstants::DEFAULT_CHARSET}"
+        base_url = get_gateway_server_url
         query = build_query_string(signed_params)
         return base_url if query.nil? || query.empty?
-        base_url + '&' + query
+        base_url + '?' + query
+      end
+
+      def build_multipart_text_part(boundary, key, value)
+        "--#{boundary}\r\n" \
+          "Content-Disposition: form-data; name=\"#{key}\"\r\n" \
+          "\r\n" \
+          "#{value}\r\n"
+      end
+
+      def build_multipart_file_part(boundary, key, filename, content)
+        "--#{boundary}\r\n" \
+          "Content-Disposition: form-data; name=\"#{key}\"; filename=\"#{filename}\"\r\n" \
+          "Content-Type: application/octet-stream\r\n" \
+          "\r\n" \
+          "#{content}\r\n"
       end
       end
     end