此版本仍在开发中,尚未被视为稳定版本。对于最新的稳定版本,请使用 Spring Vault 3.1.2spring-doc.cn

开始

Spring Vault 支持需要 Vault 0.6 或更高版本以及 Java SE 6 或更高版本。 引导设置工作环境的一种简单方法是在 STS 中创建一个基于 Spring 的项目。spring-doc.cn

首先,您需要设置一个正在运行的 Vault 服务器。 有关如何启动 Vault 实例的说明,请参阅 Vaultspring-doc.cn

要在 STS 中创建 Spring 项目,请转到 File → New → Spring 模板项目 → 简单的 Spring Utility Project → 出现提示时按 Yes。 然后输入项目和包名称,例如 .org.spring.vault.examplespring-doc.cn

然后将以下内容添加到 dependencies 部分。pom.xmlspring-doc.cn

示例 1.添加 Spring Vault 依赖项
<dependencies>

  <!-- other dependency elements omitted -->

  <dependency>
    <groupId>org.springframework.vault</groupId>
    <artifactId>spring-vault-core</artifactId>
    <version>3.2.0-SNAPSHOT</version>
  </dependency>

</dependencies>

如果你正在使用里程碑或候选版本,你还需要将 Spring 里程碑存储库的位置添加到你的 maven 中,该位置与你的元素处于同一级别。pom.xml<dependencies/>spring-doc.cn

<repositories>
  <repository>
    <id>spring-milestone</id>
    <name>Spring Maven MILESTONE Repository</name>
    <url>https://repo.spring.io/milestone</url>
  </repository>
</repositories>

存储库也可以在此处浏览spring-doc.cn

如果您使用的是 SNAPSHOT,则还需要将 Spring Snapshot 存储库的位置添加到您的 maven 中,该位置位于元素的同一级别。pom.xml<dependencies/>spring-doc.cn

<repositories>
  <repository>
    <id>spring-snapshot</id>
    <name>Spring Maven SNAPSHOT Repository</name>
    <url>https://repo.spring.io/snapshot</url>
  </repository>
</repositories>

存储库也可以在此处浏览spring-doc.cn

创建一个简单的类以持久化:Secretsspring-doc.cn

示例 2.映射的数据对象
package org.spring.vault.example;

public class Secrets {

    String username;
    String password;

    public String getUsername() {
        return username;
    }

    public String getPassword() {
        return password;
    }
}

以及要运行的主应用程序spring-doc.cn

例 3.使用 Spring Vault 的示例应用程序
package org.springframework.vault.example;

import org.springframework.vault.authentication.TokenAuthentication;
import org.springframework.vault.client.VaultEndpoint;
import org.springframework.vault.core.VaultTemplate;
import org.springframework.vault.support.VaultResponseSupport;

public class VaultApp {

    public static void main(String[] args) {

        VaultTemplate vaultTemplate = new VaultTemplate(new VaultEndpoint(),
                new TokenAuthentication("00000000-0000-0000-0000-000000000000"));

        Secrets secrets = new Secrets();
        secrets.username = "hello";
        secrets.password = "world";

        vaultTemplate.write("secret/myapp", secrets);

        VaultResponseSupport<Secrets> response = vaultTemplate.read("secret/myapp", Secrets.class);
        System.out.println(response.getData().getUsername());

        vaultTemplate.delete("secret/myapp");
    }
}

即使在这个简单的例子中,也很少有事情需要注意spring-doc.cn

  • 您可以使用对象和 . 你不需要启动 Spring Context 来使用 Spring Vault。org.springframework.vault.client.VaultEndpointClientAuthenticationspring-doc.cn

  • Vault 应配置根令牌 of 以运行此应用程序。00000000-0000-0000-0000-000000000000spring-doc.cn

  • Mapper 可以处理标准 POJO 对象,而无需任何其他元数据(尽管您可以选择提供该信息)。spring-doc.cn

  • 映射约定可以使用字段访问。 请注意,该类只有 getter。Secretsspring-doc.cn

  • 如果构造函数参数名称与存储文档的字段名称匹配,则它们将用于实例化对象。spring-doc.cn