傳回一個 MessageEncryptor，其設定為從給定的 salt 衍生的機密，以及 rotate 的選項。 MessageEncryptor 執行個體會被備忘，因此相同的 salt 會傳回相同的執行個體。

覆寫與給定 salt 關聯的 MessageEncryptor 執行個體。

清除選項集清單。

初始化新執行個體。secret_generator 必須接受 salt 和 secret_length kwarg，並傳回適當的機密（字串）或機密（字串陣列）。secret_generator 也可能接受其他任意 kwarg。如果 rotate 呼叫任何與這些 kwarg 相符的選項，這些選項將傳遞給 secret_generator，而不是傳遞給訊息加密器。

encryptors = ActiveSupport::MessageEncryptors.new do |salt, secret_length:, base:|
  MySecretGenerator.new(base).generate(salt, secret_length)
end

encryptors.rotate(base: "...")

設定一個在使用非第一個選項集解密訊息時呼叫的 callback。

例如，此 callback 可以記錄每次呼叫的時間，並因此指出舊的選項集是否仍在使用中，或可以從輪替中移除。

將 options 新增至選項集清單。Messages 將使用清單中的第一個集合進行加密。然而，在解密時，每個集合將依序嘗試，直到其中一個成功為止。

值得注意的是，:secret_generator 選項可以指定與最初指定的不同的機密產生器。機密產生器必須回應 call，接受 salt 和 secret_length kwarg，並傳回適當的機密（字串）或機密（字串陣列）。機密產生器也可能接受其他任意 kwarg。

如果任何選項與運作中的機密產生器的 kwarg 相符，這些選項將傳遞給機密產生器，而不是傳遞給訊息加密器。

對於細緻的每個 salt 輪替，支援區塊形式。區塊將接收 salt，並應傳回適當的選項 Hash。區塊也可以傳回 nil 以指出輪替不適用於給定的 salt。例如

encryptors = ActiveSupport::MessageEncryptors.new { ... }

encryptors.rotate do |salt|
  case salt
  when :foo
    { serializer: JSON, url_safe: true }
  when :bar
    { serializer: Marshal, url_safe: true }
  end
end

encryptors.rotate(serializer: Marshal, url_safe: false)

# Uses `serializer: JSON, url_safe: true`.
# Falls back to `serializer: Marshal, url_safe: false`.
encryptors[:foo]

# Uses `serializer: Marshal, url_safe: true`.
# Falls back to `serializer: Marshal, url_safe: false`.
encryptors[:bar]

# Uses `serializer: Marshal, url_safe: false`.
encryptors[:baz]

使用預設選項呼叫 rotate。