配置步骤（非安全增强型实例）

安装EncDB扩展。

CREATE EXTENSION encdb;

创建加密表。

CREATE TABLE example (
  id      INTEGER,
  name    VARCHAR,
  price   INTEGER,
  miles   REAL,
  secret  TEXT,
  PRIMARY KEY (id)
);

CREATE TABLE example (
  id     INTEGER,
  name   VARCHAR,
  price  rnd_type,
  miles  det_type,
  secret rnd_type,
  PRIMARY KEY (id)
);

安装EncDB依赖包。

mvn install:install-file -DgroupId=com.alibaba.encdb -DartifactId=<安装的Jar包名> -Dversion=<安装的Jar版本> -Dpackaging=jar -Dfile=<下载的Jar包所在路径>/<安装的Jar包名.jar>

mvn install:install-file -DgroupId=com.alibaba.encdb -DartifactId=libencdb -Dversion=1.2.12 -Dpackaging=jar -Dfile=D:\encdb\libs\libencdb-1.2.12.jar

添加依赖。

<dependencies>
   ...
   <dependency>
      <groupId>com.alibaba.encdb</groupId>
      <artifactId>libencdb</artifactId>
      <version>1.2.12</version>
   </dependency>
   <!-- https://mvnrepository.com/artifact/org.bouncycastle/bcprov-jdk15on -->
   <dependency>
     <groupId>org.bouncycastle</groupId>
     <artifactId>bcprov-jdk15on</artifactId>
     <version>1.70</version>
   </dependency>
   <!-- https://mvnrepository.com/artifact/org.bouncycastle/bcpkix-jdk15on -->
   <dependency>
     <groupId>org.bouncycastle</groupId>
     <artifactId>bcpkix-jdk15on</artifactId>
     <version>1.70</version>
   </dependency>
   <dependency>
      <groupId>com.google.code.gson</groupId>
      <artifactId>gson</artifactId>
      <version>2.10.1</version>
    </dependency>
   <!-- https://mvnrepository.com/artifact/org.postgresql/postgresql -->
   <dependency>
     <groupId>org.postgresql</groupId>
     <artifactId>postgresql</artifactId>
     <version>42.2.23</version>
   </dependency>
   <dependency>
     <groupId>com.google.guava</groupId>
     <artifactId>guava</artifactId>
     <version>31.1-jre</version>
   </dependency>
   ...
</dependencies>

全加密功能使用示例。

1. 连接数据库。

   说明

   此示例中MEK仅为测试用，实际应用中请使用自己的MEK。参数Mek和EncAlgo只作为EncDB SDK的加解密模块使用，不会直接传送给服务器端。

    try {
       Class.forName("org.postgresql.Driver");
   } catch (ClassNotFoundException e) {
       e.printStackTrace();
   }
   
    String hostname = "pgm-uf6qw1ap115gr2****.pg.rds.aliyuncs.com";
    String port = "5432";
    String dbname = "encdbtest";
    String username = "username";
    String password = "userpassword";
    String tableName = "example";
    String mek = "0x00112233445566778899aabbccddeeff";
   
    String dbUrl = "jdbc:postgresql://" + hostname + ":" + port + "/" + dbname + "?binaryTransfer=true";
    try {
       dbConnection = DriverManager.getConnection(dbUrl, username, password);
   } catch (SQLException throwables) {
       throwables.printStackTrace();
   }
   
    /*创建EncdbSDK实例*/
    EncdbSDK sdk = EncdbSDKBuilder.newInstance()
            .setDbConnection(dbConnection)
            .setMek(mek)
            .setEncAlgo(Constants.EncAlgo.SM4_128_CBC)
            .setDekGenMode(Constants.DekGenMode.LOCAL)
            .setSdkMode(Constants.SDKMode.Crypto)
            .build();
   
    Cryptor crypto = sdk.getCryptor();

   上述示例中关键参数解释及取值示例如下：

   参数	取值示例（字符串类型）	说明
   Mek	0x00112233445566778899aabbccddeeff	用户主密钥。 取值范围：长度为16字节的16进制字符串。
   EncAlgo	SM4_128_CBC	加密算法。 取值范围： AES_128_GCM AES_128_CBC SM4_128_CBC（默认值）
   DekGenMode	LOCAL	生成数据密钥的方式。固定为LOCAL，不能修改。
   SdkMode	Crypto	SDK模式。固定为Crypto，不能修改。

2. 插入加密数据。

    PreparedStatement stmt = dbConnection.prepareStatement("insert into " + tableName + " (id, name, price, miles, secret) values(?,?,?,?,?)");
    int price = 1234;
    float miles = 12.34f;
    String secret = "aliyun";
   
    stmt.setInt(1, 1);
    stmt.setString(2, "name");
    stmt.setBytes(3, crypto.encrypt(tableName, "price", String.valueOf(price)));
    stmt.setBytes(4, crypto.encrypt(tableName, "miles", String.valueOf(miles)));
    stmt.setBytes(5, crypto.encrypt(tableName, "secret", secret));
    stmt.execute();

3. 查询解密数据。

    String sqlCmd = "SELECT * from " + tableName + " where miles = ?";
    PreparedStatement stmt = dbConnection.prepareStatement(sqlCmd);
    stmt.setBytes(1, crypto.encrypt(tableName, "miles", "12.34"));
    ResultSet rs = stmt.executeQuery();
    while (rs.next()) {
        int id = rs.getInt(1);
        String name = rs.getString(2);
   
        int price = Integer.parseInt(crypto.decryptString(rs.getBytes(3)));
        float miles = Float.parseFloat(crypto.decryptString(rs.getBytes(4)));
        String text = crypto.decryptString(rs.getBytes(5));
   
        System.out.println(id + ", " + name + ", " + price + ", " + miles + ", " + text);
    }