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,429 @@
package com.dbx.agent.informix;
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.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.ResultSet;
import java.sql.SQLException;
import java.util.ArrayList;
import java.util.Collections;
import java.util.HashSet;
import java.util.List;
import java.util.Locale;
import java.util.Set;
public final class InformixAgent extends BaseDatabaseAgent {
private Connection connection;
@Override
public Connection getConnection() {
return connection;
}
public static String buildJdbcUrl(ConnectParams params) {
String rawUrlParams = params.getUrl_params();
String extraParams = rawUrlParams == null ? "" : trimEnd(trimStart(rawUrlParams.trim(), ':', ';'), ';');
String rawDatabase = params.getDatabase();
String database = rawDatabase == null || rawDatabase.trim().isEmpty()
? "sysmaster" : rawDatabase.trim();
// Determine INFORMIXSERVER: from dedicated field, url_params, or default
String informixServer = params.getInformix_server();
informixServer = informixServer == null ? "" : informixServer.trim();
if (informixServer.isEmpty()) {
informixServer = containsIgnoreCase(extraParams, "INFORMIXSERVER=") ? "" : defaultInformixServer(params.getHost());
}
String serverParam = informixServer.isEmpty() ? "" : "INFORMIXSERVER=" + informixServer;
// Add CLIENT_LOCALE and DB_LOCALE defaults if not already specified
if (!containsIgnoreCase(extraParams, "CLIENT_LOCALE=")) {
String localeParam = "CLIENT_LOCALE=en_US.utf8";
extraParams = extraParams.isEmpty() ? localeParam : extraParams + ";" + localeParam;
}
if (!containsIgnoreCase(extraParams, "DB_LOCALE=")) {
String localeParam = "DB_LOCALE=en_US.utf8";
extraParams = extraParams.isEmpty() ? localeParam : extraParams + ";" + localeParam;
}
List<String> jdbcParams = new ArrayList<>();
if (!serverParam.isEmpty()) {
jdbcParams.add(serverParam);
}
if (!extraParams.isEmpty()) {
jdbcParams.add(extraParams);
}
return "jdbc:informix-sqli://" + params.getHost() + ":" + params.getPort() + "/" + database + ":"
+ String.join(";", jdbcParams);
}
private static String defaultInformixServer(String host) {
return isIpAddress(host) ? "informix" : host;
}
private static boolean isIpAddress(String host) {
return host.matches("\\d{1,3}(\\.\\d{1,3}){3}") || host.contains(":");
}
/**
* Map Informix coltype integer codes to type names.
* See Informix documentation for coltype values.
*/
public static String mapColType(int coltype) {
int baseType = coltype % 256;
return switch (baseType) {
case 0 -> "CHAR";
case 1 -> "SMALLINT";
case 2 -> "INTEGER";
case 3 -> "FLOAT";
case 4 -> "SMALLFLOAT";
case 5 -> "DECIMAL";
case 6 -> "SERIAL";
case 7 -> "DATE";
case 8 -> "MONEY";
case 9 -> "NULL";
case 10 -> "DATETIME";
case 11 -> "BYTE";
case 12 -> "TEXT";
case 13 -> "VARCHAR";
case 14 -> "INTERVAL";
case 15 -> "NCHAR";
case 16 -> "NVARCHAR";
case 17 -> "INT8";
case 18 -> "SERIAL8";
case 19 -> "SET";
case 20 -> "MULTISET";
case 21 -> "LIST";
case 22 -> "ROW";
case 23 -> "COLLECTION";
case 40 -> "LVARCHAR";
case 41 -> "BOOLEAN";
case 43, 52 -> "BIGINT";
case 44, 53 -> "BIGSERIAL";
default -> "UNKNOWN(" + baseType + ")";
};
}
public static Set<Integer> primaryKeyColumnNumbers(List<Integer> parts) {
Set<Integer> result = new HashSet<>();
for (Integer part : parts) {
if (part == null) {
continue;
}
int value = Math.abs(part);
if (value > 0) {
result.add(value);
}
}
return result;
}
public static String databaseCatalogSql() {
return "SELECT name FROM sysmaster:sysdatabases ORDER BY name";
}
@Override
public void connect(ConnectParams params) {
String url = buildJdbcUrl(params);
uncheckedVoid(() -> {
Class.forName("com.informix.jdbc.IfxDriver");
try {
connection = DriverManager.getConnection(url, params.getUsername(), params.getPassword());
} catch (SQLException e) {
throw new SQLException(
"Informix connection failed.\nURL: " + url.replaceAll("//[^@]+@", "//***@") + "\nError: " + e.getMessage(),
e.getSQLState(), e.getErrorCode()
);
}
});
}
@Override
public boolean testConnection(ConnectParams params) {
String url = buildJdbcUrl(params);
return unchecked(() -> {
Class.forName("com.informix.jdbc.IfxDriver");
try (Connection conn = DriverManager.getConnection(url, params.getUsername(), params.getPassword())) {
return conn.isValid(5);
}
});
}
@Override
public List<DatabaseInfo> listDatabases() {
return unchecked(() -> {
List<DatabaseInfo> result = new ArrayList<>();
try (java.sql.Statement stmt = requireConnected().createStatement();
ResultSet rs = stmt.executeQuery(databaseCatalogSql())) {
while (rs.next()) {
result.add(new DatabaseInfo(rs.getString(1).trim()));
}
}
return result;
});
}
@Override
public List<String> listSchemas() {
List<String> result = new ArrayList<>();
for (DatabaseInfo database : listDatabases()) {
result.add(database.getName());
}
return result;
}
@Override
public List<TableInfo> listTables(String schema) {
return unchecked(() -> {
List<TableInfo> result = new ArrayList<>();
String sql = """
SELECT tabname,
CASE tabtype WHEN 'T' THEN 'TABLE' WHEN 'V' THEN 'VIEW' ELSE tabtype END
FROM systables
WHERE tabid >= 100
ORDER BY tabname
""";
try (java.sql.Statement stmt = requireConnected().createStatement();
ResultSet rs = stmt.executeQuery(sql.stripIndent().trim())) {
while (rs.next()) {
result.add(new TableInfo(rs.getString(1).trim(), rs.getString(2).trim(), 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()));
}
try (java.sql.Statement stmt = requireConnected().createStatement();
ResultSet rs = stmt.executeQuery(
"SELECT procname FROM sysprocedures WHERE owner != 'informix' AND isproc = 'f' ORDER BY procname"
)) {
while (rs.next()) {
result.add(new ObjectInfo(rs.getString(1).trim(), "FUNCTION", schema, null));
}
}
try (java.sql.Statement stmt = requireConnected().createStatement();
ResultSet rs = stmt.executeQuery(
"SELECT procname FROM sysprocedures WHERE owner != 'informix' AND isproc = 't' ORDER BY procname"
)) {
while (rs.next()) {
result.add(new ObjectInfo(rs.getString(1).trim(), "PROCEDURE", schema, null));
}
}
return result;
});
}
@Override
public ObjectSource getObjectSource(String schema, String name, String objectType) {
return unchecked(() -> {
String sql = """
SELECT b.data FROM sysprocbody b
JOIN sysprocedures p ON b.procid = p.procid
WHERE p.procname = ? AND b.datakey = 'T'
ORDER BY b.seqno
""";
StringBuilder sb = new StringBuilder();
try (java.sql.PreparedStatement stmt = requireConnected().prepareStatement(sql.stripIndent().trim())) {
stmt.setString(1, name);
try (ResultSet rs = stmt.executeQuery()) {
while (rs.next()) {
String value = rs.getString(1);
sb.append(value == null ? "" : value);
}
}
}
return new ObjectSource(name, objectType, schema, sb.toString());
});
}
@Override
public List<ColumnInfo> getColumns(String schema, String table) {
return unchecked(() -> {
Connection conn = requireConnected();
Set<Integer> primaryKeyColumns = getPrimaryKeyColumnNumbers(conn, table);
List<ColumnInfo> result = new ArrayList<>();
String sql = """
SELECT c.colname, c.coltype, c.colno
FROM syscolumns c
WHERE c.tabid = (SELECT tabid FROM systables WHERE tabname = ?)
ORDER BY c.colno
""";
try (java.sql.PreparedStatement stmt = conn.prepareStatement(sql.stripIndent().trim())) {
stmt.setString(1, table);
try (ResultSet rs = stmt.executeQuery()) {
while (rs.next()) {
String colname = rs.getString(1).trim();
int coltype = rs.getInt(2);
result.add(new ColumnInfo(
colname,
mapColType(coltype),
(coltype & 256) == 0,
null,
primaryKeyColumns.contains(rs.getInt(3)),
null,
null,
null,
null,
null
));
}
}
}
return result;
});
}
private Set<Integer> getPrimaryKeyColumnNumbers(Connection conn, String table) throws SQLException {
String sql = """
SELECT i.part1, i.part2, i.part3, i.part4, i.part5, i.part6, i.part7, i.part8,
i.part9, i.part10, i.part11, i.part12, i.part13, i.part14, i.part15, i.part16
FROM sysconstraints c
JOIN sysindexes i ON i.idxname = c.idxname AND i.tabid = c.tabid
JOIN systables t ON t.tabid = c.tabid
WHERE t.tabname = ? AND c.constrtype = 'P'
""";
try (java.sql.PreparedStatement stmt = conn.prepareStatement(sql.stripIndent().trim())) {
stmt.setString(1, table);
try (ResultSet rs = stmt.executeQuery()) {
if (!rs.next()) {
return Collections.emptySet();
}
List<Integer> parts = new ArrayList<>();
for (int index = 1; index <= 16; index++) {
int value = rs.getInt(index);
parts.add(rs.wasNull() ? null : value);
}
return primaryKeyColumnNumbers(parts);
}
}
}
@Override
public List<IndexInfo> listIndexes(String schema, String table) {
return Collections.emptyList();
}
@Override
public List<ForeignKeyInfo> listForeignKeys(String schema, String table) {
return Collections.emptyList();
}
@Override
public List<TriggerInfo> listTriggers(String schema, String table) {
return unchecked(() -> {
List<TriggerInfo> result = new ArrayList<>();
String sql = """
SELECT t.trigname, t.event, 'TRIGGER'
FROM systriggers t
JOIN systables s ON t.tabid = s.tabid
WHERE s.tabname = ?
""";
try (java.sql.PreparedStatement stmt = requireConnected().prepareStatement(sql.stripIndent().trim())) {
stmt.setString(1, 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) {
String normalizedSql = switch (trimEnd(sql.trim(), ';').toUpperCase(Locale.ROOT)) {
case "BEGIN WORK" -> "BEGIN";
case "COMMIT WORK" -> "COMMIT";
case "ROLLBACK WORK" -> "ROLLBACK";
default -> sql;
};
return JdbcExecutor.INSTANCE.execute(
requireConnected(),
normalizedSql,
schema,
this::setSchemaSQL,
options.getMaxRows(),
options.getFetchSize(),
options.getTimeoutSecs(),
this::stringResultValue
);
}
@Override
public String setSchemaSQL(String schema) {
return "";
}
@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();
});
}
private static String trimStart(String value, char... chars) {
int index = 0;
while (index < value.length() && contains(chars, value.charAt(index))) {
index++;
}
return value.substring(index);
}
private static String trimEnd(String value, char... chars) {
int end = value.length();
while (end > 0 && contains(chars, value.charAt(end - 1))) {
end--;
}
return value.substring(0, end);
}
private static boolean contains(char[] chars, char value) {
for (char candidate : chars) {
if (candidate == value) {
return true;
}
}
return false;
}
private static boolean containsIgnoreCase(String value, String needle) {
return value.toLowerCase(Locale.ROOT).contains(needle.toLowerCase(Locale.ROOT));
}
public static void main(String[] args) {
new JsonRpcServer(new InformixAgent()).run();
}
}
@@ -0,0 +1,16 @@
package com.dbx.agent.informix;
import com.dbx.agent.DatabaseAgent;
import com.dbx.agent.test.JdbcFakeExecutionBehaviorTest;
class InformixAgentExecutionTest extends JdbcFakeExecutionBehaviorTest {
@Override
protected DatabaseAgent createAgent() {
return new InformixAgent();
}
@Override
protected String resultSetSql() {
return "EXECUTE PROCEDURE sample_proc()";
}
}
@@ -0,0 +1,128 @@
package com.dbx.agent.informix;
import com.dbx.agent.ConnectParams;
import java.util.Arrays;
import java.util.Set;
import org.junit.jupiter.api.Assertions;
import org.junit.jupiter.api.Test;
class InformixAgentTest {
@Test
void buildsJdbcUrlWithExplicitInformixServerAndLocaleParameters() {
String url = InformixAgent.buildJdbcUrl(
new ConnectParams(
"172.26.128.159",
20013,
"testdb",
"",
"",
"INFORMIXSERVER=informix;CLIENT_LOCALE=en_US.utf8;DB_LOCALE=en_US.utf8",
"",
false
)
);
Assertions.assertEquals(
"jdbc:informix-sqli://172.26.128.159:20013/testdb:INFORMIXSERVER=informix;CLIENT_LOCALE=en_US.utf8;DB_LOCALE=en_US.utf8",
url
);
}
@Test
void fallsBackToHostAsInformixServerWhenNoExplicitServerIsConfigured() {
String url = InformixAgent.buildJdbcUrl(
new ConnectParams(
"informix-host",
9088,
"sysmaster",
"",
"",
"",
"",
false
)
);
Assertions.assertEquals(
"jdbc:informix-sqli://informix-host:9088/sysmaster:INFORMIXSERVER=informix-host;CLIENT_LOCALE=en_US.utf8;DB_LOCALE=en_US.utf8",
url
);
}
@Test
void fallsBackToInformixServerNameWhenHostIsAnIpAddress() {
String url = InformixAgent.buildJdbcUrl(
new ConnectParams(
"172.26.128.159",
20013,
"sysmaster",
"",
"",
"",
"",
false
)
);
Assertions.assertEquals(
"jdbc:informix-sqli://172.26.128.159:20013/sysmaster:INFORMIXSERVER=informix;CLIENT_LOCALE=en_US.utf8;DB_LOCALE=en_US.utf8",
url
);
}
@Test
void usesInformixServerFromDedicatedFieldWhenProvided() {
ConnectParams params = new ConnectParams(
"172.26.128.159",
20013,
"testdb",
"",
"",
"CLIENT_LOCALE=en_US.utf8",
"",
false
);
params.setInformix_server("ol_informix1410");
String url = InformixAgent.buildJdbcUrl(params);
Assertions.assertEquals(
"jdbc:informix-sqli://172.26.128.159:20013/testdb:INFORMIXSERVER=ol_informix1410;CLIENT_LOCALE=en_US.utf8;DB_LOCALE=en_US.utf8",
url
);
}
@Test
void usesSysmasterWhenDatabaseIsBlank() {
String url = InformixAgent.buildJdbcUrl(
new ConnectParams(
"informix-host",
9088,
"",
"",
"",
"INFORMIXSERVER=informix",
"",
false
)
);
Assertions.assertEquals(
"jdbc:informix-sqli://informix-host:9088/sysmaster:INFORMIXSERVER=informix;CLIENT_LOCALE=en_US.utf8;DB_LOCALE=en_US.utf8",
url
);
}
@Test
void extractsPrimaryKeyColumnNumbersFromInformixIndexParts() {
Assertions.assertEquals(
Set.of(1, 3, 5),
InformixAgent.primaryKeyColumnNumbers(Arrays.asList(1, -3, 0, 5, null))
);
}
@Test
void listsDatabasesFromSysmasterCatalog() {
Assertions.assertEquals("SELECT name FROM sysmaster:sysdatabases ORDER BY name", InformixAgent.databaseCatalogSql());
}
}