feat: 新增 8 个语言客户端 SDK

- PHP 客户端 (kenaito-conf-php-client)
- .NET 客户端 (kenaito-conf-dotnet-client)
- C 客户端 (kenaito-conf-c-client)
- C++ 客户端 (kenaito-conf-cpp-client)
- Lua 客户端 (kenaito-conf-lua-client)
- Kotlin 客户端 (kenaito-conf-kotlin-client)
- Rust 客户端 (kenaito-conf-rust-client)
- Ruby 客户端 (kenaito-conf-ruby-client)

每个客户端包含完整的 SDK 实现和 demo 示例,支持:
- 配置拉取(全量/增量)
- AES-128-CBC 解密
- 本地缓存
- 变更回调
- Token 认证

更新根目录 README.md:
- 技术栈列表新增 8 种语言
- 项目结构新增 16 个目录
- 客户端接入章节新增 8 个使用示例
This commit is contained in:
2026-03-05 21:14:42 +08:00
parent 2f5c343347
commit 4c3648cf7f
40 changed files with 2824 additions and 2 deletions
@@ -0,0 +1,204 @@
# frozen_string_literal: true
require 'net/http'
require 'json'
require 'openssl'
require 'base64'
module KenaitoConf
class Config
attr_accessor :base_url, :app_name, :env, :version, :token, :sync_interval, :ignore_global, :cache_dir
def initialize(options = {})
@base_url = options[:base_url] || ''
@app_name = options[:app_name] || ''
@env = options[:env] || 'dev'
@version = options[:version] || 'latest'
@token = options[:token] || ''
@sync_interval = options[:sync_interval] || 60
@ignore_global = options[:ignore_global] || false
@cache_dir = options[:cache_dir] || '.'
end
end
module Crypto
CRYPT_PREFIX = '{Cipher}'
def self.decrypt_config(secret, data)
return data unless data.start_with?(CRYPT_PREFIX)
encrypted = data[CRYPT_PREFIX.length..]
decrypt_with_aes(secret, encrypted)
end
def self.decrypt_with_aes(key, data)
md5_hash = OpenSSL::Digest::MD5.hexdigest(key)
aes_key = md5_hash[16..]
cipher_text = Base64.decode64(data)
iv = "\0" * 16
cipher = OpenSSL::Cipher::AES128.new(:CBC)
cipher.decrypt
cipher.key = aes_key
cipher.iv = iv
cipher.padding = 0
plain_text = cipher.update(cipher_text) + cipher.final
padding = plain_text[-1].ord
plain_text[0...-padding]
end
end
class Cache
CACHE_FILE = 'config-cache.json'
def initialize(cache_dir = '.')
@cache_dir = cache_dir
end
def write(data)
File.write(File.join(@cache_dir, CACHE_FILE), JSON.pretty_generate(data))
end
def read
path = File.join(@cache_dir, CACHE_FILE)
return nil unless File.exist?(path)
JSON.parse(File.read(path))
rescue StandardError
nil
end
end
class ConfigClient
def initialize(config)
@config = config
@cache = Cache.new(config.cache_dir)
@configs = {}
@secret = ''
@global_secret = ''
@last_time = 0
@handlers = []
@started = false
end
def on_change(&handler)
@handlers << handler
end
def get(key)
@configs[key]
end
def get_all
@configs.dup
end
def start
return if @started
@started = true
begin
fetch_all
rescue StandardError => e
warn "[ConfigClient] fetch all configs error: #{e.message}, trying cache"
cached = @cache.read
if cached
apply_configs(cached)
warn "[ConfigClient] loaded #{@configs.size} configs from cache"
else
raise "fetch configs failed and no cache: #{e.message}"
end
end
Thread.new do
loop do
sleep @config.sync_interval
begin
fetch_changed
rescue StandardError => e
warn "[ConfigClient] sync error: #{e.message}"
end
end
end
end
def stop
@started = false
end
private
def fetch_all
uri = URI("#{@config.base_url}/api/fetchAllConfigs")
http = Net::HTTP.new(uri.host, uri.port)
http.read_timeout = 10
request = Net::HTTP::Post.new(uri.path, 'Content-Type' => 'application/json')
request.body = JSON.generate({
appName: @config.app_name,
env: @config.env,
version: @config.version,
ignoreGlobal: @config.ignore_global,
token: @config.token
})
response = http.request(request)
raise "HTTP #{response.code}" unless response.code == '200'
data = JSON.parse(response.body)
raise "server error: #{data['msg']}" if data['code'] && data['code'] != 0
@secret = data['kenaito.config.encrypt-secret'] if data['kenaito.config.encrypt-secret']
@global_secret = data['kenaito.config.global-encrypt-secret'] if data['kenaito.config.global-encrypt-secret']
@last_time = data['latest.fetch.timestamp'].to_i if data['latest.fetch.timestamp']
@cache.write(data)
apply_configs(data)
warn "[ConfigClient] fetched #{@configs.size} configs"
end
def fetch_changed
uri = URI("#{@config.base_url}/api/fetchChangedConfigs")
http = Net::HTTP.new(uri.host, uri.port)
http.read_timeout = 10
request = Net::HTTP::Post.new(uri.path, 'Content-Type' => 'application/json')
request.body = JSON.generate({
appName: @config.app_name,
env: @config.env,
version: @config.version,
lastTime: @last_time,
ignoreGlobal: @config.ignore_global,
token: @config.token
})
response = http.request(request)
result = JSON.parse(response.body)
raise "server error" if !result['code'] || result['code'] != 0
changed_data = result['data'] || {}
@last_time = changed_data.delete('latest.fetch.timestamp').to_i if changed_data['latest.fetch.timestamp']
changed = {}
changed_data.each do |k, v|
changed[k] = try_decrypt(v)
end
@configs.merge!(changed)
@handlers.each { |h| h.call(changed) rescue warn "[ConfigClient] handler error: #{$!.message}" }
end
def apply_configs(data)
data.each do |k, v|
next if k.start_with?('kenaito.') || k == 'latest.fetch.timestamp'
next unless v.is_a?(String)
@configs[k] = try_decrypt(v)
end
end
def try_decrypt(value)
decrypted = Crypto.decrypt_config(@secret, value)
decrypted = Crypto.decrypt_config(@global_secret, value) if decrypted == value && !@global_secret.empty?
decrypted
end
end
end