feat(agents): move agents into dbx repo

This commit is contained in:
t8y2 committed 2026-06-23 11:38:16 +08:00
1 parent ab35fda299
commit 3a25487dea
215 files changed
+29740 -15

No files matched your search

@@ -0,0 +1,385 @@
package com.dbx.agent.db2;
import com.dbx.agent.BaseDatabaseAgent;
import com.dbx.agent.ColumnInfo;
import com.dbx.agent.ConnectParams;
import com.dbx.agent.DatabaseInfo;
import com.dbx.agent.ExecuteQueryOptions;
import com.dbx.agent.ForeignKeyInfo;
import com.dbx.agent.IndexInfo;
import com.dbx.agent.JdbcExecutor;
import com.dbx.agent.JdbcIdentifiers;
import com.dbx.agent.JsonRpcServer;
import com.dbx.agent.ObjectInfo;
import com.dbx.agent.ObjectSource;
import com.dbx.agent.QueryResult;
import com.dbx.agent.TableInfo;
import com.dbx.agent.TriggerInfo;
import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
import java.util.ArrayList;
import java.util.List;
import java.util.Locale;
import java.util.Set;
public final class Db2Agent extends BaseDatabaseAgent {
private static final Set<String> NUMERIC_PRECISION_TYPES = Set.of(
"DECIMAL", "NUMERIC", "INTEGER", "SMALLINT", "BIGINT", "REAL", "DOUBLE", "FLOAT"
);
private static final Set<String> NUMERIC_SCALE_TYPES = Set.of("DECIMAL", "NUMERIC");
private static final Set<String> CHARACTER_LENGTH_TYPES = Set.of("VARCHAR", "CHAR", "CLOB", "GRAPHIC", "VARGRAPHIC");
private Connection connection;
@Override
public Connection getConnection() {
return connection;
}
@Override
public String setSchemaSQL(String schema) {
return "SET SCHEMA " + JdbcIdentifiers.INSTANCE.doubleQuote(schema);
}
@Override
public void connect(ConnectParams params) {
uncheckedVoid(() -> {
Class.forName("com.ibm.db2.jcc.DB2Driver");
connection = DriverManager.getConnection(buildUrl(params), params.getUsername(), params.getPassword());
});
}
@Override
public boolean testConnection(ConnectParams params) {
return unchecked(() -> {
Class.forName("com.ibm.db2.jcc.DB2Driver");
try (Connection conn = DriverManager.getConnection(buildUrl(params), params.getUsername(), params.getPassword())) {
return conn.isValid(5);
}
});
}
@Override
public List<DatabaseInfo> listDatabases() {
return unchecked(() -> {
List<DatabaseInfo> result = new ArrayList<>();
String sql = "SELECT CURRENT_SERVER FROM SYSIBM.SYSDUMMY1";
try (java.sql.Statement stmt = requireConnected().createStatement();
ResultSet rs = stmt.executeQuery(sql)) {
while (rs.next()) {
result.add(new DatabaseInfo(rs.getString(1).trim()));
}
}
return result;
});
}
@Override
public List<String> listSchemas() {
return unchecked(() -> {
List<String> result = new ArrayList<>();
String sql = "SELECT SCHEMANAME FROM SYSCAT.SCHEMATA ORDER BY SCHEMANAME";
try (java.sql.Statement stmt = requireConnected().createStatement();
ResultSet rs = stmt.executeQuery(sql)) {
while (rs.next()) {
result.add(rs.getString(1).trim());
}
}
return result;
});
}
@Override
public List<TableInfo> listTables(String schema) {
return unchecked(() -> {
List<TableInfo> result = new ArrayList<>();
String sql = "SELECT TABNAME, TYPE FROM SYSCAT.TABLES WHERE TABSCHEMA = ? AND TYPE IN ('T','V') ORDER BY TABNAME";
try (PreparedStatement stmt = requireConnected().prepareStatement(sql)) {
stmt.setString(1, schema);
try (ResultSet rs = stmt.executeQuery()) {
while (rs.next()) {
String db2Type = rs.getString(2).trim();
String type = switch (db2Type) {
case "T" -> "TABLE";
case "V" -> "VIEW";
default -> db2Type;
};
result.add(new TableInfo(rs.getString(1).trim(), type, null));
}
}
}
return result;
});
}
@Override
public List<ObjectInfo> listObjects(String schema) {
return unchecked(() -> {
List<ObjectInfo> result = new ArrayList<>();
for (TableInfo table : listTables(schema)) {
result.add(new ObjectInfo(table.getName(), table.getTable_type(), schema, table.getComment()));
}
String sql = "SELECT PROCNAME, 'PROCEDURE' FROM SYSCAT.PROCEDURES WHERE PROCSCHEMA = ? ORDER BY PROCNAME";
try (PreparedStatement stmt = requireConnected().prepareStatement(sql)) {
stmt.setString(1, schema);
try (ResultSet rs = stmt.executeQuery()) {
while (rs.next()) {
result.add(new ObjectInfo(rs.getString(1).trim(), rs.getString(2), schema, null));
}
}
}
return result;
});
}
@Override
public ObjectSource getObjectSource(String schema, String name, String objectType) {
return unchecked(() -> {
String sql = "SELECT TEXT FROM SYSCAT.ROUTINES WHERE ROUTINESCHEMA = ? AND ROUTINENAME = ?";
String source;
try (PreparedStatement stmt = requireConnected().prepareStatement(sql)) {
stmt.setString(1, schema);
stmt.setString(2, name);
try (ResultSet rs = stmt.executeQuery()) {
source = rs.next() ? coalesce(rs.getString(1)) : "";
}
}
return new ObjectSource(name, objectType, schema, source);
});
}
@Override
public List<ColumnInfo> getColumns(String schema, String table) {
return unchecked(() -> {
Set<String> pkColumns = new java.util.HashSet<>();
String pkSql = """
SELECT kc.COLNAME FROM SYSCAT.KEYCOLUSE kc
JOIN SYSCAT.TABCONST tc ON kc.CONSTNAME = tc.CONSTNAME AND kc.TABSCHEMA = tc.TABSCHEMA AND kc.TABNAME = tc.TABNAME
WHERE tc.TYPE = 'P' AND tc.TABSCHEMA = ? AND tc.TABNAME = ?
""".stripIndent().trim();
try (PreparedStatement stmt = requireConnected().prepareStatement(pkSql)) {
stmt.setString(1, schema);
stmt.setString(2, table);
try (ResultSet rs = stmt.executeQuery()) {
while (rs.next()) {
pkColumns.add(rs.getString(1).trim());
}
}
}
List<ColumnInfo> result = new ArrayList<>();
String colSql = """
SELECT COLNAME, TYPENAME, NULLS, DEFAULT, LENGTH, SCALE
FROM SYSCAT.COLUMNS
WHERE TABSCHEMA = ? AND TABNAME = ?
ORDER BY COLNO
""".stripIndent().trim();
try (PreparedStatement stmt = requireConnected().prepareStatement(colSql)) {
stmt.setString(1, schema);
stmt.setString(2, table);
try (ResultSet rs = stmt.executeQuery()) {
while (rs.next()) {
String name = rs.getString("COLNAME").trim();
String typeName = rs.getString("TYPENAME").trim();
Integer length = intObject(rs, "LENGTH");
Integer scale = intObject(rs, "SCALE");
String dataType = formatDataType(typeName, length, scale);
result.add(new ColumnInfo(
name,
dataType,
"Y".equals(rs.getString("NULLS").trim()),
trimNullable(rs.getString("DEFAULT")),
pkColumns.contains(name),
null,
null,
NUMERIC_PRECISION_TYPES.contains(typeName) ? length : null,
NUMERIC_SCALE_TYPES.contains(typeName) ? scale : null,
CHARACTER_LENGTH_TYPES.contains(typeName) ? length : null
));
}
}
}
return result;
});
}
@Override
public List<IndexInfo> listIndexes(String schema, String table) {
return unchecked(() -> {
List<IndexInfo> result = new ArrayList<>();
String sql = "SELECT INDNAME, COLNAMES, UNIQUERULE FROM SYSCAT.INDEXES WHERE TABSCHEMA = ? AND TABNAME = ? ORDER BY INDNAME";
try (PreparedStatement stmt = requireConnected().prepareStatement(sql)) {
stmt.setString(1, schema);
stmt.setString(2, table);
try (ResultSet rs = stmt.executeQuery()) {
while (rs.next()) {
String colNames = trimToEmpty(rs.getString(2));
List<String> columns = splitColumns(colNames, "[+-]");
String uniqueRule = trimToEmpty(rs.getString(3));
result.add(new IndexInfo(
rs.getString(1).trim(),
columns,
"U".equals(uniqueRule) || "P".equals(uniqueRule),
"P".equals(uniqueRule),
null,
null,
null,
null
));
}
}
}
return result;
});
}
@Override
public List<ForeignKeyInfo> listForeignKeys(String schema, String table) {
return unchecked(() -> {
List<ForeignKeyInfo> result = new ArrayList<>();
String sql = "SELECT CONSTNAME, FK_COLNAMES, REFTABNAME, PK_COLNAMES FROM SYSCAT.REFERENCES WHERE TABSCHEMA = ? AND TABNAME = ? ORDER BY CONSTNAME";
try (PreparedStatement stmt = requireConnected().prepareStatement(sql)) {
stmt.setString(1, schema);
stmt.setString(2, table);
try (ResultSet rs = stmt.executeQuery()) {
while (rs.next()) {
List<String> fkColList = splitColumns(trimToEmpty(rs.getString(2)), "\\s+");
List<String> pkColList = splitColumns(trimToEmpty(rs.getString(4)), "\\s+");
String refTable = rs.getString(3).trim();
String constName = rs.getString(1).trim();
for (int i = 0; i < fkColList.size(); i++) {
result.add(new ForeignKeyInfo(
constName,
fkColList.get(i),
refTable,
i < pkColList.size() ? pkColList.get(i) : ""
));
}
}
}
}
return result;
});
}
@Override
public List<TriggerInfo> listTriggers(String schema, String table) {
return unchecked(() -> {
List<TriggerInfo> result = new ArrayList<>();
String sql = "SELECT TRIGNAME, TRIGEVENT, TRIGTIME FROM SYSCAT.TRIGGERS WHERE TABSCHEMA = ? AND TABNAME = ? ORDER BY TRIGNAME";
try (PreparedStatement stmt = requireConnected().prepareStatement(sql)) {
stmt.setString(1, schema);
stmt.setString(2, table);
try (ResultSet rs = stmt.executeQuery()) {
while (rs.next()) {
result.add(new TriggerInfo(
rs.getString(1).trim(),
rs.getString(2).trim(),
rs.getString(3).trim()
));
}
}
}
return result;
});
}
@Override
public QueryResult executeQuery(String sql, String schema, ExecuteQueryOptions options) {
return JdbcExecutor.INSTANCE.execute(
requireConnected(),
sql,
schema,
this::setSchemaSQL,
options.getMaxRows(),
options.getFetchSize(),
options.getTimeoutSecs(),
this::stringResultValue
);
}
@Override
public void disconnect() {
uncheckedVoid(() -> {
if (connection != null) {
connection.close();
}
connection = null;
});
}
private Object stringResultValue(ResultSet rs, int index, int sqlType) {
return unchecked(() -> {
Object value = rs.getObject(index);
return rs.wasNull() ? null : value == null ? null : value.toString();
});
}
static String buildUrl(ConnectParams params) {
if (!params.getConnection_string().trim().isEmpty()) {
return params.getConnection_string();
}
String url = "jdbc:db2://" + params.getHost() + ":" + params.getPort() + "/" + params.getDatabase();
String extraParams = trimDb2UrlParams(params.getUrl_params());
if (extraParams.isEmpty()) {
return url;
}
return url + ":" + extraParams + (extraParams.endsWith(";") ? "" : ";");
}
private static String trimDb2UrlParams(String urlParams) {
String value = urlParams == null ? "" : urlParams.trim();
while (value.startsWith("?") || value.startsWith("&") || value.startsWith(":") || value.startsWith(";")) {
value = value.substring(1);
}
return value;
}
private static String formatDataType(String typeName, Integer length, Integer scale) {
return switch (typeName.toUpperCase(Locale.ROOT)) {
case "VARCHAR", "CHAR", "CLOB", "GRAPHIC", "VARGRAPHIC" -> length != null ? typeName + "(" + length + ")" : typeName;
case "DECIMAL", "NUMERIC" -> {
if (length != null && scale != null && scale > 0) {
yield typeName + "(" + length + "," + scale + ")";
}
yield length != null ? typeName + "(" + length + ")" : typeName;
}
default -> typeName;
};
}
private static Integer intObject(ResultSet rs, String column) throws Exception {
Object value = rs.getObject(column);
return value == null ? null : ((Number) value).intValue();
}
private static List<String> splitColumns(String value, String regex) {
List<String> result = new ArrayList<>();
for (String part : value.split(regex)) {
if (!part.isBlank()) {
result.add(part);
}
}
return result;
}
private static String trimNullable(String value) {
return value == null ? null : value.trim();
}
private static String trimToEmpty(String value) {
return value == null ? "" : value.trim();
}
private static String coalesce(String value) {
return value == null ? "" : value;
}
public static void main(String[] args) {
new JsonRpcServer(new Db2Agent()).run();
}
}
@@ -0,0 +1,163 @@
package com.dbx.agent.db2;
import com.dbx.agent.DatabaseAgent;
import com.dbx.agent.ConnectParams;
import com.dbx.agent.test.JdbcFakeExecutionBehaviorTest;
import com.dbx.agent.test.TestSupport;
import org.junit.jupiter.api.Test;
import java.lang.reflect.InvocationHandler;
import java.lang.reflect.Method;
import java.lang.reflect.Proxy;
import java.sql.Connection;
import java.sql.ResultSet;
import java.sql.Statement;
import java.util.Arrays;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
import java.util.concurrent.atomic.AtomicReference;
import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertFalse;
class Db2AgentTest extends JdbcFakeExecutionBehaviorTest {
@Override
protected DatabaseAgent createAgent() {
return new Db2Agent();
}
@Override
protected String resultSetSql() {
return "CALL ADMIN_CMD('list applications')";
}
@Test
void buildsJdbcUrlWithDb2PropertySuffix() {
ConnectParams params = new ConnectParams();
params.setHost("db.example.com");
params.setPort(50000);
params.setDatabase("SAMPLE");
params.setUrl_params("sslConnection=true");
assertEquals("jdbc:db2://db.example.com:50000/SAMPLE:sslConnection=true;", Db2Agent.buildUrl(params));
}
@Test
void listsAllCatalogSchemasWithoutOwnerTypeFiltering() {
Db2Agent agent = new Db2Agent();
AtomicReference<String> executedSql = new AtomicReference<>();
TestSupport.setPrivateConnection(agent, connection(
executedSql,
rows(row("SCHEMANAME", "APP"), row("SCHEMANAME", "SZ"), row("SCHEMANAME", "TOOLS"))
));
List<String> schemas = agent.listSchemas();
assertEquals(Arrays.asList("APP", "SZ", "TOOLS"), schemas);
assertEquals("SELECT SCHEMANAME FROM SYSCAT.SCHEMATA ORDER BY SCHEMANAME", executedSql.get());
assertFalse(executedSql.get().contains("OWNERTYPE"));
}
private static Connection connection(AtomicReference<String> executedSql, ResultSet resultSet) {
Statement statement = proxy(Statement.class, new MethodHandler() {
@Override
public Object handle(Method method, Object[] args) {
if ("executeQuery".equals(method.getName())) {
executedSql.set(String.valueOf(args[0]));
return resultSet;
}
if ("close".equals(method.getName())) {
return null;
}
return defaultValue(method.getReturnType());
}
});
return proxy(Connection.class, new MethodHandler() {
@Override
public Object handle(Method method, Object[] args) {
if ("createStatement".equals(method.getName())) {
return statement;
}
if ("isClosed".equals(method.getName())) {
return false;
}
return defaultValue(method.getReturnType());
}
});
}
private static ResultSet rows(Map<String, Object>... rows) {
return proxy(ResultSet.class, new MethodHandler() {
private int index = -1;
@Override
public Object handle(Method method, Object[] args) {
String name = method.getName();
if ("next".equals(name)) {
index += 1;
return index < rows.length;
}
if ("getString".equals(name)) {
Object key = args[0] instanceof Number ? rows[index].keySet().iterator().next() : args[0];
Object value = rows[index].get(key);
return value == null ? null : String.valueOf(value);
}
if ("close".equals(name)) {
return null;
}
return defaultValue(method.getReturnType());
}
});
}
private static Map<String, Object> row(Object... values) {
Map<String, Object> row = new LinkedHashMap<>();
for (int i = 0; i < values.length; i += 2) {
row.put(String.valueOf(values[i]), values[i + 1]);
}
return row;
}
private static <T> T proxy(Class<T> type, final MethodHandler handler) {
InvocationHandler invocationHandler = new InvocationHandler() {
@Override
public Object invoke(Object proxy, Method method, Object[] args) {
return handler.handle(method, args);
}
};
return type.cast(Proxy.newProxyInstance(type.getClassLoader(), new Class<?>[]{type}, invocationHandler));
}
private static Object defaultValue(Class<?> type) {
if (Boolean.TYPE.equals(type)) {
return false;
}
if (Byte.TYPE.equals(type)) {
return (byte) 0;
}
if (Short.TYPE.equals(type)) {
return (short) 0;
}
if (Integer.TYPE.equals(type)) {
return 0;
}
if (Long.TYPE.equals(type)) {
return 0L;
}
if (Float.TYPE.equals(type)) {
return 0f;
}
if (Double.TYPE.equals(type)) {
return 0.0d;
}
if (Character.TYPE.equals(type)) {
return '\0';
}
return null;
}
private interface MethodHandler {
Object handle(Method method, Object[] args);
}
}