feat(agents): move agents into dbx repo
This commit is contained in:
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();
|
||||
}
|
||||
}
|
||||
+16
@@ -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());
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user