Module java.sql
Package java.sql

Interface ShardingKeyBuilder

public interfaceShardingKeyBuilder
A builder created from aDataSource orXADataSource object, used to create aShardingKey with sub-keys of supported data types. Implementations must support JDBCType.VARCHAR and may also support additional data types.

The following example illustrates the use ofShardingKeyBuilder to create aShardingKey:

     DataSource ds = new MyDataSource();     ShardingKey shardingKey = ds.createShardingKeyBuilder()                           .subkey("abc", JDBCType.VARCHAR)                           .subkey(94002, JDBCType.INTEGER)                           .build();

Since:
9

  • Method Summary

    Modifier and Type
    Method
    Description
    Returns an instance of the object defined by this builder.
    subkey(Object subkey,SQLType subkeyType)
    This method will be called to add a subkey into a Sharding Key object being built.

  • Method Details

    • subkey

      ShardingKeyBuilder subkey(Object subkey,SQLType subkeyType)
      This method will be called to add a subkey into a Sharding Key object being built. The order in which subkey method is called is important as it indicates the order of placement of the subkey within the Sharding Key.
      Parameters:
      subkey - contains the object that needs to be part of shard sub key
      subkeyType - sub-key data type of type java.sql.SQLType
      Returns:
      this builder object

    • build

      ShardingKey build() throwsSQLException
      Returns an instance of the object defined by this builder.
      Returns:
      The built object
      Throws:
      SQLException - If an error occurs building the object