diff --git a/src/interfaces/jdbc/org/postgresql/jdbc1/AbstractJdbc1DatabaseMetaData.java b/src/interfaces/jdbc/org/postgresql/jdbc1/AbstractJdbc1DatabaseMetaData.java index 6a8d20d6692..0682737b8b7 100644 --- a/src/interfaces/jdbc/org/postgresql/jdbc1/AbstractJdbc1DatabaseMetaData.java +++ b/src/interfaces/jdbc/org/postgresql/jdbc1/AbstractJdbc1DatabaseMetaData.java @@ -5,10 +5,20 @@ import java.sql.*; import java.util.*; import org.postgresql.Field; import org.postgresql.util.PSQLException; +import org.postgresql.Driver; -public abstract class AbstractJdbc1DatabaseMetaData +public abstract class AbstractJdbc1DatabaseMetaData { + private static final String keywords = "abort,acl,add,aggregate,append,archive," + + "arch_store,backward,binary,change,cluster,"+ + "copy,database,delimiter,delimiters,do,extend,"+ + "explain,forward,heavy,index,inherits,isnull,"+ + "light,listen,load,merge,nothing,notify,"+ + "notnull,oids,purge,rename,replace,retrieve,"+ + "returns,rule,recipe,setof,stdin,stdout,store,"+ + "vacuum,verbose,version"; + protected AbstractJdbc1Connection connection; // The connection association // These define various OID's. Hopefully they will stay constant. @@ -20,7 +30,7 @@ public abstract class AbstractJdbc1DatabaseMetaData public AbstractJdbc1DatabaseMetaData(AbstractJdbc1Connection conn) { - this.connection = conn; + this.connection = conn; } /* @@ -32,7 +42,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean allProceduresAreCallable() throws SQLException { - return true; // For now... + if (Driver.logDebug) Driver.debug("allProceduresAreCallable"); + return true; // For now... } /* @@ -44,6 +55,7 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean allTablesAreSelectable() throws SQLException { + if (Driver.logDebug) Driver.debug("allTablesAreSelectable"); return true; // For now... } @@ -55,7 +67,9 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public String getURL() throws SQLException { - return connection.getURL(); + String url = connection.getURL(); + if (Driver.logDebug) Driver.debug("getURL " + url); + return url; } /* @@ -66,7 +80,9 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public String getUserName() throws SQLException { - return connection.getUserName(); + String userName = connection.getUserName(); + if (Driver.logDebug) Driver.debug("getUserName " + userName); + return userName; } /* @@ -77,7 +93,9 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean isReadOnly() throws SQLException { - return connection.isReadOnly(); + boolean isReadOnly = connection.isReadOnly(); + if (Driver.logDebug) Driver.debug("isReadOnly " + isReadOnly); + return isReadOnly; } /* @@ -88,7 +106,9 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean nullsAreSortedHigh() throws SQLException { - return connection.haveMinimumServerVersion("7.2"); + boolean nullSortedHigh = connection.haveMinimumServerVersion("7.2"); + if (Driver.logDebug) Driver.debug("nullsAreSortedHigh " + nullSortedHigh); + return nullSortedHigh; } /* @@ -99,7 +119,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean nullsAreSortedLow() throws SQLException { - return false; + if (Driver.logDebug) Driver.debug("nullsAreSortedLow false"); + return false; } /* @@ -110,7 +131,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean nullsAreSortedAtStart() throws SQLException { - return false; + if (Driver.logDebug) Driver.debug("nullsAreSortedAtStart false"); + return false; } /* @@ -121,7 +143,9 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean nullsAreSortedAtEnd() throws SQLException { - return ! connection.haveMinimumServerVersion("7.2"); + boolean nullsAreSortedAtEnd = ! connection.haveMinimumServerVersion("7.2"); + if (Driver.logDebug) Driver.debug("nullsAreSortedAtEnd " + nullsAreSortedAtEnd); + return nullsAreSortedAtEnd; } /* @@ -133,7 +157,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public String getDatabaseProductName() throws SQLException { - return "PostgreSQL"; + if (Driver.logDebug) Driver.debug("getDatabaseProductName PostgresSQL"); + return "PostgreSQL"; } /* @@ -144,7 +169,9 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public String getDatabaseProductVersion() throws SQLException { - return connection.getDBVersionNumber(); + String versionNumber = connection.getDBVersionNumber(); + if (Driver.logDebug) Driver.debug("getDatabaseProductVersion " + versionNumber); + return versionNumber; } /* @@ -156,7 +183,9 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public String getDriverName() throws SQLException { - return "PostgreSQL Native Driver"; + String driverName = "PostgreSQL Native Driver"; + if (Driver.logDebug) Driver.debug("getDriverName" + driverName); + return driverName; } /* @@ -168,7 +197,9 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public String getDriverVersion() throws SQLException { - return connection.getDriver().getVersion(); + String driverVersion = connection.this_driver.getVersion(); + if (Driver.logDebug) Driver.debug("getDriverVersion " + driverVersion); + return driverVersion; } /* @@ -178,7 +209,9 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public int getDriverMajorVersion() { - return connection.getDriver().getMajorVersion(); + int majorVersion = connection.this_driver.getMajorVersion(); + if (Driver.logDebug) Driver.debug("getMajorVersion " + majorVersion); + return majorVersion; } /* @@ -188,7 +221,9 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public int getDriverMinorVersion() { - return connection.getDriver().getMinorVersion(); + int minorVersion = connection.this_driver.getMinorVersion(); + if (Driver.logDebug) Driver.debug("getMinorVersion " + minorVersion); + return minorVersion; } /* @@ -200,7 +235,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean usesLocalFiles() throws SQLException { - return false; + if (Driver.logDebug) Driver.debug("usesLocalFiles " + false); + return false; } /* @@ -212,7 +248,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean usesLocalFilePerTable() throws SQLException { - return false; + if (Driver.logDebug) Driver.debug("usesLocalFilePerTable " + false); + return false; } /* @@ -229,7 +266,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsMixedCaseIdentifiers() throws SQLException { - return false; + if (Driver.logDebug) Driver.debug("supportsMixedCaseIdentifiers " + false); + return false; } /* @@ -240,7 +278,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean storesUpperCaseIdentifiers() throws SQLException { - return false; + if (Driver.logDebug) Driver.debug("storesUpperCaseIdentifiers " + false); + return false; } /* @@ -251,7 +290,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean storesLowerCaseIdentifiers() throws SQLException { - return true; + if (Driver.logDebug) Driver.debug("storesLowerCaseIdentifiers " + true); + return true; } /* @@ -262,7 +302,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean storesMixedCaseIdentifiers() throws SQLException { - return false; + if (Driver.logDebug) Driver.debug("storesMixedCaseIdentifiers " + false); + return false; } /* @@ -275,7 +316,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsMixedCaseQuotedIdentifiers() throws SQLException { - return true; + if (Driver.logDebug) Driver.debug("supportsMixedCaseQuotedIdentifiers " + true); + return true; } /* @@ -286,7 +328,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean storesUpperCaseQuotedIdentifiers() throws SQLException { - return false; + if (Driver.logDebug) Driver.debug("storesUpperCaseQuotedIdentifiers " + false); + return false; } /* @@ -297,7 +340,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean storesLowerCaseQuotedIdentifiers() throws SQLException { - return false; + if (Driver.logDebug) Driver.debug("storesLowerCaseQuotedIdentifiers " + false); + return false; } /* @@ -308,7 +352,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean storesMixedCaseQuotedIdentifiers() throws SQLException { - return false; + if (Driver.logDebug) Driver.debug("storesMixedCaseQuotedIdentifiers " + false); + return false; } /* @@ -321,7 +366,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public String getIdentifierQuoteString() throws SQLException { - return "\""; + if (Driver.logDebug) Driver.debug("getIdentifierQuoteString \"" ); + return "\""; } /* @@ -342,31 +388,31 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public String getSQLKeywords() throws SQLException { - return "abort,acl,add,aggregate,append,archive,arch_store,backward,binary,change,cluster,copy,database,delimiter,delimiters,do,extend,explain,forward,heavy,index,inherits,isnull,light,listen,load,merge,nothing,notify,notnull,oids,purge,rename,replace,retrieve,returns,rule,recipe,setof,stdin,stdout,store,vacuum,verbose,version"; + return keywords; } public String getNumericFunctions() throws SQLException { - // XXX-Not Implemented - return ""; + if (Driver.logDebug) Driver.debug("getNumericFunctions"); + return ""; } public String getStringFunctions() throws SQLException { - // XXX-Not Implemented - return ""; + if (Driver.logDebug) Driver.debug("getStringFunctions"); + return ""; } public String getSystemFunctions() throws SQLException { - // XXX-Not Implemented - return ""; + if (Driver.logDebug) Driver.debug("getSystemFunctions"); + return ""; } public String getTimeDateFunctions() throws SQLException { - // XXX-Not Implemented - return ""; + if (Driver.logDebug) Driver.debug("getTimeDateFunctions"); + return ""; } /* @@ -378,7 +424,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public String getSearchStringEscape() throws SQLException { - return "\\"; + if (Driver.logDebug) Driver.debug("getSearchStringEscape"); + return "\\"; } /* @@ -394,7 +441,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public String getExtraNameCharacters() throws SQLException { - return ""; + if (Driver.logDebug) Driver.debug("getExtraNameCharacters"); + return ""; } /* @@ -406,7 +454,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsAlterTableWithAddColumn() throws SQLException { - return true; + if (Driver.logDebug) Driver.debug("supportsAlterTableWithAddColumn " + true); + return true; } /* @@ -418,6 +467,7 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsAlterTableWithDropColumn() throws SQLException { + if (Driver.logDebug) Driver.debug("supportsAlterTableWithDropColumn " + false); return false; } @@ -441,7 +491,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsColumnAliasing() throws SQLException { - return true; + if (Driver.logDebug) Driver.debug("supportsColumnAliasing " + true); + return true; } /* @@ -453,19 +504,20 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean nullPlusNonNullIsNull() throws SQLException { - return true; + if (Driver.logDebug) Driver.debug("nullPlusNonNullIsNull " + true); + return true; } public boolean supportsConvert() throws SQLException { - // XXX-Not Implemented - return false; + if (Driver.logDebug) Driver.debug("supportsConvert " + false); + return false; } public boolean supportsConvert(int fromType, int toType) throws SQLException { - // XXX-Not Implemented - return false; + if (Driver.logDebug) Driver.debug("supportsConvert " + false); + return false; } /* @@ -477,7 +529,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsTableCorrelationNames() throws SQLException { - return true; + if (Driver.logDebug) Driver.debug("supportsTableCorrelationNames " + true); + return true; } /* @@ -489,7 +542,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsDifferentTableCorrelationNames() throws SQLException { - return false; + if (Driver.logDebug) Driver.debug("supportsDifferentTableCorrelationNames " + false); + return false; } /* @@ -502,7 +556,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsExpressionsInOrderBy() throws SQLException { - return true; + if (Driver.logDebug) Driver.debug("supportsExpressionsInOrderBy " + true); + return true; } /* @@ -513,7 +568,9 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsOrderByUnrelated() throws SQLException { - return connection.haveMinimumServerVersion("6.4"); + boolean supportsOrderByUnrelated = connection.haveMinimumServerVersion("6.4"); + if (Driver.logDebug) Driver.debug("supportsOrderByUnrelated " + supportsOrderByUnrelated); + return supportsOrderByUnrelated; } /* @@ -525,7 +582,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsGroupBy() throws SQLException { - return true; + if (Driver.logDebug) Driver.debug("supportsGroupBy " + true); + return true; } /* @@ -536,7 +594,9 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsGroupByUnrelated() throws SQLException { - return connection.haveMinimumServerVersion("6.4"); + boolean supportsGroupByUnrelated = connection.haveMinimumServerVersion("6.4"); + if (Driver.logDebug) Driver.debug("supportsGroupByUnrelated " + supportsGroupByUnrelated); + return supportsGroupByUnrelated; } /* @@ -551,7 +611,9 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsGroupByBeyondSelect() throws SQLException { - return supportsGroupByUnrelated(); + boolean supportsGroupByBeyondSelect = connection.haveMinimumServerVersion("6.4"); + if (Driver.logDebug) Driver.debug("supportsGroupByUnrelated " + supportsGroupByBeyondSelect); + return supportsGroupByBeyondSelect; } /* @@ -563,7 +625,9 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsLikeEscapeClause() throws SQLException { - return connection.haveMinimumServerVersion("7.1"); + boolean supportsLikeEscapeClause = connection.haveMinimumServerVersion("7.1"); + if (Driver.logDebug) Driver.debug("supportsLikeEscapeClause " + supportsLikeEscapeClause); + return supportsLikeEscapeClause; } /* @@ -576,7 +640,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsMultipleResultSets() throws SQLException { - return false; + if (Driver.logDebug) Driver.debug("supportsMultipleResultSets " + false); + return false; } /* @@ -589,7 +654,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsMultipleTransactions() throws SQLException { - return true; + if (Driver.logDebug) Driver.debug("supportsMultipleTransactions " + true); + return true; } /* @@ -604,7 +670,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsNonNullableColumns() throws SQLException { - return true; + if (Driver.logDebug) Driver.debug("supportsNonNullableColumns true"); + return true; } /* @@ -621,7 +688,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsMinimumSQLGrammar() throws SQLException { - return true; + if (Driver.logDebug) Driver.debug("supportsMinimumSQLGrammar TRUE"); + return true; } /* @@ -633,7 +701,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsCoreSQLGrammar() throws SQLException { - return false; + if (Driver.logDebug) Driver.debug("supportsCoreSQLGrammar FALSE "); + return false; } /* @@ -646,7 +715,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsExtendedSQLGrammar() throws SQLException { - return false; + if (Driver.logDebug) Driver.debug("supportsExtendedSQLGrammar FALSE"); + return false; } /* @@ -663,7 +733,9 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsANSI92EntryLevelSQL() throws SQLException { - return false; + boolean schemas = connection.haveMinimumServerVersion("7.3"); + if (Driver.logDebug) Driver.debug("supportsANSI92EntryLevelSQL " + schemas); + return schemas; } /* @@ -675,7 +747,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsANSI92IntermediateSQL() throws SQLException { - return false; + if (Driver.logDebug) Driver.debug("supportsANSI92IntermediateSQL false "); + return false; } /* @@ -686,7 +759,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsANSI92FullSQL() throws SQLException { - return false; + if (Driver.logDebug) Driver.debug("supportsANSI92FullSQL false "); + return false; } /* @@ -698,7 +772,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsIntegrityEnhancementFacility() throws SQLException { - return false; + if (Driver.logDebug) Driver.debug("supportsIntegrityEnhancementFacility false "); + return false; } /* @@ -709,7 +784,9 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsOuterJoins() throws SQLException { - return connection.haveMinimumServerVersion("7.1"); + boolean supportsOuterJoins = connection.haveMinimumServerVersion("7.1"); + if (Driver.logDebug) Driver.debug("supportsOuterJoins " + supportsOuterJoins); + return supportsOuterJoins; } /* @@ -720,7 +797,9 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsFullOuterJoins() throws SQLException { - return connection.haveMinimumServerVersion("7.1"); + boolean supportsFullOuterJoins = connection.haveMinimumServerVersion("7.1"); + if (Driver.logDebug) Driver.debug("supportsFullOuterJoins " + supportsFullOuterJoins); + return supportsFullOuterJoins; } /* @@ -731,7 +810,9 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsLimitedOuterJoins() throws SQLException { - return supportsFullOuterJoins(); + boolean supportsLimitedOuterJoins = connection.haveMinimumServerVersion("7.1"); + if (Driver.logDebug) Driver.debug("supportsFullOuterJoins " + supportsLimitedOuterJoins); + return supportsLimitedOuterJoins; } /* @@ -744,7 +825,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public String getSchemaTerm() throws SQLException { - return "schema"; + if (Driver.logDebug) Driver.debug("getSchemaTerm schema"); + return "schema"; } /* @@ -756,7 +838,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public String getProcedureTerm() throws SQLException { - return "function"; + if (Driver.logDebug) Driver.debug("getProcedureTerm function "); + return "function"; } /* @@ -767,7 +850,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public String getCatalogTerm() throws SQLException { - return "database"; + if (Driver.logDebug) Driver.debug("getCatalogTerm database "); + return "database"; } /* @@ -779,7 +863,10 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean isCatalogAtStart() throws SQLException { - throw org.postgresql.Driver.notImplemented(); + // return true here; we return false for every other catalog function + // so it won't matter what we return here D.C. + if (Driver.logDebug) Driver.debug("isCatalogAtStart not implemented"); + return true; } /* @@ -790,7 +877,10 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public String getCatalogSeparator() throws SQLException { - throw org.postgresql.Driver.notImplemented(); + // Give them something to work with here + // everything else returns false so it won't matter what we return here D.C. + if (Driver.logDebug) Driver.debug("getCatalogSeparator not implemented "); + return "."; } /* @@ -801,7 +891,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsSchemasInDataManipulation() throws SQLException { - return false; + if (Driver.logDebug) Driver.debug("supportsSchemasInDataManipulation false"); + return false; } /* @@ -812,7 +903,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsSchemasInProcedureCalls() throws SQLException { - return false; + if (Driver.logDebug) Driver.debug("supportsSchemasInProcedureCalls false"); + return false; } /* @@ -823,7 +915,10 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsSchemasInTableDefinitions() throws SQLException { - return false; + boolean schemas = connection.haveMinimumServerVersion("7.3"); + + if (Driver.logDebug) Driver.debug("supportsSchemasInTableDefinitions " + schemas); + return schemas; } /* @@ -834,7 +929,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsSchemasInIndexDefinitions() throws SQLException { - return false; + if (Driver.logDebug) Driver.debug("supportsSchemasInIndexDefinitions false"); + return false; } /* @@ -845,7 +941,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsSchemasInPrivilegeDefinitions() throws SQLException { - return false; + if (Driver.logDebug) Driver.debug("supportsSchemasInPrivilegeDefinitions false"); + return false; } /* @@ -856,7 +953,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsCatalogsInDataManipulation() throws SQLException { - return false; + if (Driver.logDebug) Driver.debug("supportsCatalogsInDataManipulation false"); + return false; } /* @@ -867,7 +965,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsCatalogsInProcedureCalls() throws SQLException { - return false; + if (Driver.logDebug) Driver.debug("supportsCatalogsInDataManipulation false"); + return false; } /* @@ -878,7 +977,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsCatalogsInTableDefinitions() throws SQLException { - return false; + if (Driver.logDebug) Driver.debug("supportsCatalogsInTableDefinitions false"); + return false; } /* @@ -889,7 +989,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsCatalogsInIndexDefinitions() throws SQLException { - return false; + if (Driver.logDebug) Driver.debug("supportsCatalogsInIndexDefinitions false"); + return false; } /* @@ -900,7 +1001,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsCatalogsInPrivilegeDefinitions() throws SQLException { - return false; + if (Driver.logDebug) Driver.debug("supportsCatalogsInPrivilegeDefinitions false"); + return false; } /* @@ -912,7 +1014,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsPositionedDelete() throws SQLException { - return false; // For now... + if (Driver.logDebug) Driver.debug("supportsPositionedDelete false"); + return false; // For now... } /* @@ -923,7 +1026,8 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsPositionedUpdate() throws SQLException { - return false; // For now... + if (Driver.logDebug) Driver.debug("supportsPositionedUpdate false"); + return false; // For now... } /* @@ -934,7 +1038,7 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsSelectForUpdate() throws SQLException { - return connection.haveMinimumServerVersion("6.5"); + return connection.haveMinimumServerVersion("6.5"); } /* @@ -946,7 +1050,7 @@ public abstract class AbstractJdbc1DatabaseMetaData */ public boolean supportsStoredProcedures() throws SQLException { - return false; + return false; } /* @@ -1703,7 +1807,7 @@ public abstract class AbstractJdbc1DatabaseMetaData String relKind; switch (r.getBytes(3)[0]) { - case (byte) 'r': + case (byte) 'r': if ( r.getString(1).startsWith("pg_") ) { relKind = "SYSTEM TABLE"; @@ -1991,7 +2095,7 @@ public abstract class AbstractJdbc1DatabaseMetaData tuple[7] = null; // Buffer length // Decimal digits = scale - // From the source (see e.g. backend/utils/adt/numeric.c, + // From the source (see e.g. backend/utils/adt/format_type.c, // function numeric()) the scale and precision can be calculated // from the typmod value. if (typname.equals("numeric") || typname.equals("decimal")) @@ -2080,6 +2184,7 @@ public abstract class AbstractJdbc1DatabaseMetaData { byte[][] tuple = new byte[8][0]; tuple[0] = tuple[1] = "".getBytes(); + if (Driver.logDebug) Driver.debug("relname=\"" + r.getString(1) + "\" relacl=\"" + r.getString(2) + "\""); // For now, don't add to the result as relacl needs to be processed. //v.addElement(tuple); @@ -2088,41 +2193,68 @@ public abstract class AbstractJdbc1DatabaseMetaData return connection.getResultSet(null, f, v, "OK", 1); } - /* - * Get a description of the access rights for each table available - * in a catalog. - * - * This method is currently unimplemented. - * - *

Only privileges matching the schema and table name - * criteria are returned. They are ordered by TABLE_SCHEM, - * TABLE_NAME, and PRIVILEGE. - * - *

Each privilige description has the following columns: - *

    - *
  1. TABLE_CAT String => table catalog (may be null) - *
  2. TABLE_SCHEM String => table schema (may be null) - *
  3. TABLE_NAME String => table name - *
  4. COLUMN_NAME String => column name - *
  5. GRANTOR => grantor of access (may be null) - *
  6. GRANTEE String => grantee of access - *
  7. PRIVILEGE String => name of access (SELECT, - * INSERT, UPDATE, REFRENCES, ...) - *
  8. IS_GRANTABLE String => "YES" if grantee is permitted - * to grant to others; "NO" if not; null if unknown - *
- * - * @param catalog a catalog name; "" retrieves those without a catalog - * @param schemaPattern a schema name pattern; "" retrieves those - * without a schema - * @param tableNamePattern a table name pattern - * @return ResultSet each row is a table privilege description - * @see #getSearchStringEscape - */ - public java.sql.ResultSet getTablePrivileges(String catalog, String schemaPattern, String tableNamePattern) throws SQLException - { - throw org.postgresql.Driver.notImplemented(); - } + /* + * Get a description of the access rights for each table available + * in a catalog. + * + * This method is currently unimplemented. + * + *

Only privileges matching the schema and table name + * criteria are returned. They are ordered by TABLE_SCHEM, + * TABLE_NAME, and PRIVILEGE. + * + *

Each privilige description has the following columns: + *

    + *
  1. TABLE_CAT String => table catalog (may be null) + *
  2. TABLE_SCHEM String => table schema (may be null) + *
  3. TABLE_NAME String => table name + *
  4. COLUMN_NAME String => column name + *
  5. GRANTOR => grantor of access (may be null) + *
  6. GRANTEE String => grantee of access + *
  7. PRIVILEGE String => name of access (SELECT, + * INSERT, UPDATE, REFRENCES, ...) + *
  8. IS_GRANTABLE String => "YES" if grantee is permitted + * to grant to others; "NO" if not; null if unknown + *
+ * + * @param catalog a catalog name; "" retrieves those without a catalog + * @param schemaPattern a schema name pattern; "" retrieves those + * without a schema + * @param tableNamePattern a table name pattern + * @return ResultSet each row is a table privilege description + * @see #getSearchStringEscape + */ + public java.sql.ResultSet getTablePrivileges(String catalog, String schemaPattern, String tableNamePattern) throws SQLException + { + Field f[] = new Field[8]; + Vector v = new Vector(); + + if (tableNamePattern == null) + tableNamePattern = "%"; + + f[0] = new Field(connection, "TABLE_CAT", iVarcharOid, 32); + f[1] = new Field(connection, "TABLE_SCHEM", iVarcharOid, 32); + f[2] = new Field(connection, "TABLE_NAME", iVarcharOid, 32); + f[3] = new Field(connection, "COLUMN_NAME", iVarcharOid, 32); + f[4] = new Field(connection, "GRANTOR", iVarcharOid, 32); + f[5] = new Field(connection, "GRANTEE", iVarcharOid, 32); + f[6] = new Field(connection, "PRIVILEGE", iVarcharOid, 32); + f[7] = new Field(connection, "IS_GRANTABLE", iVarcharOid, 32); + + // This is taken direct from the psql source + java.sql.ResultSet r = connection.ExecSQL("SELECT relname, relacl FROM pg_class, pg_user WHERE ( relkind = 'r' OR relkind = 'i') and relname !~ '^pg_' and relname !~ '^xin[vx][0-9]+' and usesysid = relowner and relname like '" + tableNamePattern.toLowerCase() + "' ORDER BY relname"); + while (r.next()) + { + byte[][] tuple = new byte[8][0]; + tuple[0] = tuple[1] = "".getBytes(); + if (Driver.logDebug) Driver.debug("relname=\"" + r.getString(1) + "\" relacl=\"" + r.getString(2) + "\""); + + // For now, don't add to the result as relacl needs to be processed. + //v.addElement(tuple); + } + + return connection.getResultSet(null, f, v, "OK", 1); + } /* * Get a description of a table's optimal set of columns that @@ -2253,140 +2385,274 @@ public abstract class AbstractJdbc1DatabaseMetaData ); } - private java.sql.ResultSet getImportedExportedKeys(String catalog, String schema, String primaryTable, String foreignTable) throws SQLException - { - Field f[] = new Field[14]; +/* + SELECT + c.relname as primary, + c2.relname as foreign, + t.tgconstrname, + ic.relname as fkeyname, + af.attnum as fkeyseq, + ipc.relname as pkeyname, + ap.attnum as pkeyseq, + t.tgdeferrable, + t.tginitdeferred, + t.tgnargs,t.tgargs, + p1.proname as updaterule, + p2.proname as deleterule +FROM + pg_trigger t, + pg_trigger t1, + pg_class c, + pg_class c2, + pg_class ic, + pg_class ipc, + pg_proc p1, + pg_proc p2, + pg_index if, + pg_index ip, + pg_attribute af, + pg_attribute ap +WHERE + (t.tgrelid=c.oid + AND t.tgisconstraint + AND t.tgconstrrelid=c2.oid + AND t.tgfoid=p1.oid + and p1.proname like '%%upd') - f[0] = new Field(connection, "PKTABLE_CAT", iVarcharOid, 32); - f[1] = new Field(connection, "PKTABLE_SCHEM", iVarcharOid, 32); - f[2] = new Field(connection, "PKTABLE_NAME", iVarcharOid, 32); - f[3] = new Field(connection, "PKCOLUMN_NAME", iVarcharOid, 32); - f[4] = new Field(connection, "FKTABLE_CAT", iVarcharOid, 32); - f[5] = new Field(connection, "FKTABLE_SCHEM", iVarcharOid, 32); - f[6] = new Field(connection, "FKTABLE_NAME", iVarcharOid, 32); - f[7] = new Field(connection, "FKCOLUMN_NAME", iVarcharOid, 32); - f[8] = new Field(connection, "KEY_SEQ", iInt2Oid, 2); - f[9] = new Field(connection, "UPDATE_RULE", iInt2Oid, 2); - f[10] = new Field(connection, "DELETE_RULE", iInt2Oid, 2); - f[11] = new Field(connection, "FK_NAME", iVarcharOid, 32); - f[12] = new Field(connection, "PK_NAME", iVarcharOid, 32); - f[13] = new Field(connection, "DEFERRABILITY", iInt2Oid, 2); + and + (t1.tgrelid=c.oid + and t1.tgisconstraint + and t1.tgconstrrelid=c2.oid + AND t1.tgfoid=p2.oid + and p2.proname like '%%del') - java.sql.ResultSet rs = connection.ExecSQL("SELECT c.relname,c2.relname," - + "t.tgconstrname,ic.relname," - + "t.tgdeferrable,t.tginitdeferred," - + "t.tgnargs,t.tgargs,p.proname " - + "FROM pg_trigger t,pg_class c,pg_class c2," - + "pg_class ic,pg_proc p, pg_index i " - + "WHERE t.tgrelid=c.oid AND t.tgconstrrelid=c2.oid " - + "AND t.tgfoid=p.oid AND tgisconstraint " - + ((primaryTable != null) ? "AND c.relname='" + primaryTable + "' " : "") - + ((foreignTable != null) ? "AND c2.relname='" + foreignTable + "' " : "") - + "AND i.indrelid=c.oid " - + "AND i.indexrelid=ic.oid AND i.indisprimary " - + "ORDER BY c.relname,c2.relname" - ); - Vector tuples = new Vector(); - short seq = 0; - if (rs.next()) - { - boolean hasMore; - do - { - byte tuple[][] = new byte[14][0]; - for (int k = 0;k < 14;k++) - tuple[k] = null; + AND c2.relname='users' - String fKeyName = rs.getString(3); - boolean foundRule = false; - do - { - String proname = rs.getString(9); - if (proname != null && proname.startsWith("RI_FKey_")) - { - int col = -1; - if (proname.endsWith("_upd")) - col = 9; // UPDATE_RULE - else if (proname.endsWith("_del")) - col = 10; // DELETE_RULE - if (col > -1) - { - String rule = proname.substring(8, proname.length() - 4); - int action = java.sql.DatabaseMetaData.importedKeyNoAction; - if ("cascade".equals(rule)) - action = java.sql.DatabaseMetaData.importedKeyCascade; - else if ("setnull".equals(rule)) - action = java.sql.DatabaseMetaData.importedKeySetNull; - else if ("setdefault".equals(rule)) - action = java.sql.DatabaseMetaData.importedKeySetDefault; - tuple[col] = Integer.toString(action).getBytes(); + AND + (if.indrelid=c.oid + AND if.indexrelid=ic.oid + and ic.oid=af.attrelid + AND if.indisprimary) - if (!foundRule) - { - tuple[2] = rs.getBytes(1); //PKTABLE_NAME - tuple[6] = rs.getBytes(2); //FKTABLE_NAME + and + (ip.indrelid=c2.oid + and ip.indexrelid=ipc.oid + and ipc.oid=ap.attrelid + and ip.indisprimary) - // Parse the tgargs data - StringBuffer fkeyColumns = new StringBuffer(); - StringBuffer pkeyColumns = new StringBuffer(); - int numColumns = (rs.getInt(7) >> 1) - 2; - String s = rs.getString(8); - int pos = s.lastIndexOf("\\000"); - for (int c = 0;c < numColumns;c++) - { - if (pos > -1) - { - int pos2 = s.lastIndexOf("\\000", pos - 1); - if (pos2 > -1) - { - if (pkeyColumns.length() > 0) - pkeyColumns.insert(0, ','); - pkeyColumns.insert(0, s.substring(pos2 + 4, pos)); //PKCOLUMN_NAME - pos = s.lastIndexOf("\\000", pos2 - 1); - if (pos > -1) - { - if (fkeyColumns.length() > 0) - fkeyColumns.insert(0, ','); - fkeyColumns.insert(0, s.substring(pos + 4, pos2)); //FKCOLUMN_NAME - } - } - } - } - tuple[3] = pkeyColumns.toString().getBytes(); //PKCOLUMN_NAME - tuple[7] = fkeyColumns.toString().getBytes(); //FKCOLUMN_NAME +*/ +/** + * + * @param catalog + * @param schema + * @param primaryTable if provided will get the keys exported by this table + * @param foreignTable if provided will get the keys imported by this table + * @return ResultSet + * @throws SQLException + */ - tuple[8] = Integer.toString(seq++).getBytes(); //KEY_SEQ - tuple[11] = fKeyName.getBytes(); //FK_NAME - tuple[12] = rs.getBytes(4); //PK_NAME + protected java.sql.ResultSet getImportedExportedKeys(String catalog, String schema, String primaryTable, String foreignTable) throws SQLException + { + Field f[] = new Field[14]; - // DEFERRABILITY - int deferrability = java.sql.DatabaseMetaData.importedKeyNotDeferrable; - boolean deferrable = rs.getBoolean(5); - boolean initiallyDeferred = rs.getBoolean(6); - if (deferrable) - { - if (initiallyDeferred) - deferrability = java.sql.DatabaseMetaData.importedKeyInitiallyDeferred; - else - deferrability = java.sql.DatabaseMetaData.importedKeyInitiallyImmediate; - } - tuple[13] = Integer.toString(deferrability).getBytes(); + f[0] = new Field(connection, "PKTABLE_CAT", iVarcharOid, 32); + f[1] = new Field(connection, "PKTABLE_SCHEM", iVarcharOid, 32); + f[2] = new Field(connection, "PKTABLE_NAME", iVarcharOid, 32); + f[3] = new Field(connection, "PKCOLUMN_NAME", iVarcharOid, 32); + f[4] = new Field(connection, "FKTABLE_CAT", iVarcharOid, 32); + f[5] = new Field(connection, "FKTABLE_SCHEM", iVarcharOid, 32); + f[6] = new Field(connection, "FKTABLE_NAME", iVarcharOid, 32); + f[7] = new Field(connection, "FKCOLUMN_NAME", iVarcharOid, 32); + f[8] = new Field(connection, "KEY_SEQ", iInt2Oid, 2); + f[9] = new Field(connection, "UPDATE_RULE", iInt2Oid, 2); + f[10] = new Field(connection, "DELETE_RULE", iInt2Oid, 2); + f[11] = new Field(connection, "FK_NAME", iVarcharOid, 32); + f[12] = new Field(connection, "PK_NAME", iVarcharOid, 32); + f[13] = new Field(connection, "DEFERRABILITY", iInt2Oid, 2); - foundRule = true; - } - } - } - } - while ((hasMore = rs.next()) && fKeyName.equals(rs.getString(3))); + java.sql.ResultSet rs = connection.ExecSQL( + "SELECT distinct " + + "c.relname as prelname, " + + "c2.relname as frelname, " + + "t.tgconstrname, " + + "a.attnum as keyseq, " + + "ic.relname as fkeyname, " + + "t.tgdeferrable, " + + "t.tginitdeferred, " + + "t.tgnargs,t.tgargs, " + + "p1.proname as updaterule, " + + "p2.proname as deleterule " + + "FROM " + + "pg_trigger t, " + + "pg_trigger t1, " + + "pg_class c, " + + "pg_class c2, " + + "pg_class ic, " + + "pg_proc p1, " + + "pg_proc p2, " + + "pg_index i, " + + "pg_attribute a " + + "WHERE " + // isolate the update rule + + "(t.tgrelid=c.oid " + + "AND t.tgisconstraint " + + "AND t.tgconstrrelid=c2.oid " + + "AND t.tgfoid=p1.oid " + + "and p1.proname like '%%upd') " - if(foundRule) tuples.addElement(tuple); + + "and " + // isolate the delete rule + + "(t1.tgrelid=c.oid " + + "and t1.tgisconstraint " + + "and t1.tgconstrrelid=c2.oid " + + "AND t1.tgfoid=p2.oid " + + "and p2.proname like '%%del') " - } - while (hasMore); - } + // if we are looking for exported keys then primary table will be used + + ((primaryTable != null) ? "AND c.relname='" + primaryTable + "' " : "") - return connection.getResultSet(null, f, tuples, "OK", 1); - } + // if we are looking for imported keys then the foreign table will be used + + ((foreignTable != null) ? "AND c2.relname='" + foreignTable + "' " : "") + + "AND i.indrelid=c.oid " + + "AND i.indexrelid=ic.oid " + + "AND ic.oid=a.attrelid " + + "AND i.indisprimary " + + "ORDER BY " + + // orderby is as follows getExported, orders by FKTABLE, + // getImported orders by PKTABLE + // getCrossReference orders by FKTABLE, so this should work for both, + // since when getting crossreference, primaryTable will be defined + + + (primaryTable != null ? "frelname" : "prelname") + ",keyseq"); + +// returns the following columns +// and some example data with a table defined as follows + +// create table people ( id int primary key); +// create table policy ( id int primary key); +// create table users ( id int primary key, people_id int references people(id), policy_id int references policy(id)) + +// prelname | frelname | tgconstrname | keyseq | fkeyName | tgdeferrable | tginitdeferred +// 1 | 2 | 3 | 4 | 5 | 6 | 7 + +// people | users | | 1 | people_pkey | f | f + +// | tgnargs | tgargs | updaterule | deleterule +// | 8 | 9 | 10 | 11 +// | 6 | \000users\000people\000UNSPECIFIED\000people_id\000id\000 | RI_FKey_noaction_upd | RI_FKey_noaction_del + + Vector tuples = new Vector(); + + + while ( rs.next() ) + { + byte tuple[][] = new byte[14][]; + + tuple[2] = rs.getBytes(1); //PKTABLE_NAME + tuple[6] = rs.getBytes(2); //FKTABLE_NAME + String fKeyName = rs.getString(3); + String updateRule = rs.getString(10); + + if (updateRule != null ) + { + // Rules look like this RI_FKey_noaction_del so we want to pull out the part between the 'Key_' and the last '_' s + + String rule = updateRule.substring(8, updateRule.length() - 4); + + int action = java.sql.DatabaseMetaData.importedKeyNoAction; + + if ( rule == null || "noaction".equals(rule) ) + action = java.sql.DatabaseMetaData.importedKeyNoAction; + if ("cascade".equals(rule)) + action = java.sql.DatabaseMetaData.importedKeyCascade; + else if ("setnull".equals(rule)) + action = java.sql.DatabaseMetaData.importedKeySetNull; + else if ("setdefault".equals(rule)) + action = java.sql.DatabaseMetaData.importedKeySetDefault; + else if ("restrict".equals(rule)) + action = java.sql.DatabaseMetaData.importedKeyRestrict; + + tuple[9] = Integer.toString(action).getBytes(); + + } + + String deleteRule = rs.getString(11); + + if ( deleteRule != null ) + { + + String rule = updateRule.substring(8, updateRule.length() - 4); + + int action = java.sql.DatabaseMetaData.importedKeyNoAction; + if ("cascade".equals(rule)) + action = java.sql.DatabaseMetaData.importedKeyCascade; + else if ("setnull".equals(rule)) + action = java.sql.DatabaseMetaData.importedKeySetNull; + else if ("setdefault".equals(rule)) + action = java.sql.DatabaseMetaData.importedKeySetDefault; + tuple[10] = Integer.toString(action).getBytes(); + } + + + // Parse the tgargs data + String fkeyColumn=""; + String pkeyColumn=""; + + + // Note, I am guessing at most of this, but it should be close + // if not, please correct + // the keys are in pairs and start after the first four arguments + // the arguments are seperated by \000 + + int keySequence = rs.getInt(4); //KEY_SEQ + + // get the args + String targs = rs.getString(9); + + // args look like this + //\000ww\000vv\000UNSPECIFIED\000m\000a\000n\000b\000 + // we are primarily interested in the column names which are the last items in the string + + StringTokenizer st = new StringTokenizer(targs, "\\000"); + + int advance = 4 + (keySequence-1) * 2; + for( int i=0; st.hasMoreTokens() && i < advance ; i++ ) st.nextToken(); // advance to the key column of interest + + if ( st.hasMoreTokens() ) + { + fkeyColumn = st.nextToken(); + } + if ( st.hasMoreTokens() ) + { + pkeyColumn = st.nextToken(); + } + + tuple[3] = pkeyColumn.getBytes(); //PKCOLUMN_NAME + tuple[7] = fkeyColumn.getBytes(); //FKCOLUMN_NAME + + tuple[8] = rs.getBytes(4); //KEY_SEQ + tuple[11] = targs.getBytes(); //FK_NAME this will give us a unique name for the foreign key + tuple[12] = rs.getBytes(5); //PK_NAME + + // DEFERRABILITY + int deferrability = java.sql.DatabaseMetaData.importedKeyNotDeferrable; + boolean deferrable = rs.getBoolean(6); + boolean initiallyDeferred = rs.getBoolean(7); + if (deferrable) + { + if (initiallyDeferred) + deferrability = java.sql.DatabaseMetaData.importedKeyInitiallyDeferred; + else + deferrability = java.sql.DatabaseMetaData.importedKeyInitiallyImmediate; + } + tuple[13] = Integer.toString(deferrability).getBytes(); + + tuples.addElement(tuple); + } + + return connection.getResultSet(null, f, tuples, "OK", 1); + } /* * Get a description of the primary key columns that are diff --git a/src/interfaces/jdbc/org/postgresql/jdbc2/AbstractJdbc2DatabaseMetaData.java b/src/interfaces/jdbc/org/postgresql/jdbc2/AbstractJdbc2DatabaseMetaData.java index 432ee15f528..bed162f9dbe 100644 --- a/src/interfaces/jdbc/org/postgresql/jdbc2/AbstractJdbc2DatabaseMetaData.java +++ b/src/interfaces/jdbc/org/postgresql/jdbc2/AbstractJdbc2DatabaseMetaData.java @@ -1,5 +1,6 @@ package org.postgresql.jdbc2; +import org.postgresql.jdbc1.AbstractJdbc1ResultSet; import java.sql.*; import java.util.*; @@ -15,3052 +16,6 @@ public abstract class AbstractJdbc2DatabaseMetaData extends org.postgresql.jdbc1 super(conn); } - /* - * Can all the procedures returned by getProcedures be called - * by the current user? - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean allProceduresAreCallable() throws SQLException - { - if (Driver.logDebug) Driver.debug("allProceduresAreCallable"); - return true; // For now... - } - - /* - * Can all the tables returned by getTable be SELECTed by - * the current user? - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean allTablesAreSelectable() throws SQLException - { - if (Driver.logDebug) Driver.debug("allTablesAreSelectable"); - return true; // For now... - } - - /* - * What is the URL for this database? - * - * @return the url or null if it cannott be generated - * @exception SQLException if a database access error occurs - */ - public String getURL() throws SQLException - { - String url = connection.getURL(); - if (Driver.logDebug) Driver.debug("getURL " + url); - return url; - } - - /* - * What is our user name as known to the database? - * - * @return our database user name - * @exception SQLException if a database access error occurs - */ - public String getUserName() throws SQLException - { - String userName = connection.getUserName(); - if (Driver.logDebug) Driver.debug("getUserName " + userName); - return userName; - } - - /* - * Is the database in read-only mode? - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean isReadOnly() throws SQLException - { - boolean isReadOnly = connection.isReadOnly(); - if (Driver.logDebug) Driver.debug("isReadOnly " + isReadOnly); - return isReadOnly; - } - - /* - * Are NULL values sorted high? - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean nullsAreSortedHigh() throws SQLException - { - boolean nullSortedHigh = connection.haveMinimumServerVersion("7.2"); - if (Driver.logDebug) Driver.debug("nullsAreSortedHigh " + nullSortedHigh); - return nullSortedHigh; - } - - /* - * Are NULL values sorted low? - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean nullsAreSortedLow() throws SQLException - { - if (Driver.logDebug) Driver.debug("nullsAreSortedLow false"); - return false; - } - - /* - * Are NULL values sorted at the start regardless of sort order? - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean nullsAreSortedAtStart() throws SQLException - { - if (Driver.logDebug) Driver.debug("nullsAreSortedAtStart false"); - return false; - } - - /* - * Are NULL values sorted at the end regardless of sort order? - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean nullsAreSortedAtEnd() throws SQLException - { - boolean nullsAreSortedAtEnd = ! connection.haveMinimumServerVersion("7.2"); - if (Driver.logDebug) Driver.debug("nullsAreSortedAtEnd " + nullsAreSortedAtEnd); - return nullsAreSortedAtEnd; - } - - /* - * What is the name of this database product - we hope that it is - * PostgreSQL, so we return that explicitly. - * - * @return the database product name - * @exception SQLException if a database access error occurs - */ - public String getDatabaseProductName() throws SQLException - { - if (Driver.logDebug) Driver.debug("getDatabaseProductName PostgresSQL"); - return "PostgreSQL"; - } - - /* - * What is the version of this database product. - * - * @return the database version - * @exception SQLException if a database access error occurs - */ - public String getDatabaseProductVersion() throws SQLException - { - String versionNumber = connection.getDBVersionNumber(); - if (Driver.logDebug) Driver.debug("getDatabaseProductVersion " + versionNumber); - return versionNumber; - } - - /* - * What is the name of this JDBC driver? If we don't know this - * we are doing something wrong! - * - * @return the JDBC driver name - * @exception SQLException why? - */ - public String getDriverName() throws SQLException - { - String driverName = "PostgreSQL Native Driver"; - if (Driver.logDebug) Driver.debug("getDriverName" + driverName); - return driverName; - } - - /* - * What is the version string of this JDBC driver? Again, this is - * static. - * - * @return the JDBC driver name. - * @exception SQLException why? - */ - public String getDriverVersion() throws SQLException - { - String driverVersion = connection.this_driver.getVersion(); - if (Driver.logDebug) Driver.debug("getDriverVersion " + driverVersion); - return driverVersion; - } - - /* - * What is this JDBC driver's major version number? - * - * @return the JDBC driver major version - */ - public int getDriverMajorVersion() - { - int majorVersion = connection.this_driver.getMajorVersion(); - if (Driver.logDebug) Driver.debug("getMajorVersion " + majorVersion); - return majorVersion; - } - - /* - * What is this JDBC driver's minor version number? - * - * @return the JDBC driver minor version - */ - public int getDriverMinorVersion() - { - int minorVersion = connection.this_driver.getMinorVersion(); - if (Driver.logDebug) Driver.debug("getMinorVersion " + minorVersion); - return minorVersion; - } - - /* - * Does the database store tables in a local file? No - it - * stores them in a file on the server. - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean usesLocalFiles() throws SQLException - { - if (Driver.logDebug) Driver.debug("usesLocalFiles " + false); - return false; - } - - /* - * Does the database use a file for each table? Well, not really, - * since it doesnt use local files. - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean usesLocalFilePerTable() throws SQLException - { - if (Driver.logDebug) Driver.debug("usesLocalFilePerTable " + false); - return false; - } - - /* - * Does the database treat mixed case unquoted SQL identifiers - * as case sensitive and as a result store them in mixed case? - * A JDBC-Compliant driver will always return false. - * - *

Predicament - what do they mean by "SQL identifiers" - if it - * means the names of the tables and columns, then the answers - * given below are correct - otherwise I don't know. - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsMixedCaseIdentifiers() throws SQLException - { - if (Driver.logDebug) Driver.debug("supportsMixedCaseIdentifiers " + false); - return false; - } - - /* - * Does the database treat mixed case unquoted SQL identifiers as - * case insensitive and store them in upper case? - * - * @return true if so - */ - public boolean storesUpperCaseIdentifiers() throws SQLException - { - if (Driver.logDebug) Driver.debug("storesUpperCaseIdentifiers " + false); - return false; - } - - /* - * Does the database treat mixed case unquoted SQL identifiers as - * case insensitive and store them in lower case? - * - * @return true if so - */ - public boolean storesLowerCaseIdentifiers() throws SQLException - { - if (Driver.logDebug) Driver.debug("storesLowerCaseIdentifiers " + true); - return true; - } - - /* - * Does the database treat mixed case unquoted SQL identifiers as - * case insensitive and store them in mixed case? - * - * @return true if so - */ - public boolean storesMixedCaseIdentifiers() throws SQLException - { - if (Driver.logDebug) Driver.debug("storesMixedCaseIdentifiers " + false); - return false; - } - - /* - * Does the database treat mixed case quoted SQL identifiers as - * case sensitive and as a result store them in mixed case? A - * JDBC compliant driver will always return true. - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsMixedCaseQuotedIdentifiers() throws SQLException - { - if (Driver.logDebug) Driver.debug("supportsMixedCaseQuotedIdentifiers " + true); - return true; - } - - /* - * Does the database treat mixed case quoted SQL identifiers as - * case insensitive and store them in upper case? - * - * @return true if so - */ - public boolean storesUpperCaseQuotedIdentifiers() throws SQLException - { - if (Driver.logDebug) Driver.debug("storesUpperCaseQuotedIdentifiers " + false); - return false; - } - - /* - * Does the database treat mixed case quoted SQL identifiers as case - * insensitive and store them in lower case? - * - * @return true if so - */ - public boolean storesLowerCaseQuotedIdentifiers() throws SQLException - { - if (Driver.logDebug) Driver.debug("storesLowerCaseQuotedIdentifiers " + false); - return false; - } - - /* - * Does the database treat mixed case quoted SQL identifiers as case - * insensitive and store them in mixed case? - * - * @return true if so - */ - public boolean storesMixedCaseQuotedIdentifiers() throws SQLException - { - if (Driver.logDebug) Driver.debug("storesMixedCaseQuotedIdentifiers " + false); - return false; - } - - /* - * What is the string used to quote SQL identifiers? This returns - * a space if identifier quoting isn't supported. A JDBC Compliant - * driver will always use a double quote character. - * - * @return the quoting string - * @exception SQLException if a database access error occurs - */ - public String getIdentifierQuoteString() throws SQLException - { - if (Driver.logDebug) Driver.debug("getIdentifierQuoteString \"" ); - return "\""; - } - - /* - * Get a comma separated list of all a database's SQL keywords that - * are NOT also SQL92 keywords. - * - *

Within PostgreSQL, the keywords are found in - * src/backend/parser/keywords.c - * - *

For SQL Keywords, I took the list provided at - * - * http://web.dementia.org/~shadow/sql/sql3bnf.sep93.txt - * which is for SQL3, not SQL-92, but it is close enough for - * this purpose. - * - * @return a comma separated list of keywords we use - * @exception SQLException if a database access error occurs - */ - public String getSQLKeywords() throws SQLException - { - if (Driver.logDebug) Driver.debug("getSQLKeyWords"); - return "abort,acl,add,aggregate,append,archive,arch_store,backward,binary,change,cluster,copy,database,delimiter,delimiters,do,extend,explain,forward,heavy,index,inherits,isnull,light,listen,load,merge,nothing,notify,notnull,oids,purge,rename,replace,retrieve,returns,rule,recipe,setof,stdin,stdout,store,vacuum,verbose,version"; - } - - public String getNumericFunctions() throws SQLException - { - // XXX-Not Implemented - if (Driver.logDebug) Driver.debug("getNumericFunctions"); - return ""; - } - - public String getStringFunctions() throws SQLException - { - // XXX-Not Implemented - if (Driver.logDebug) Driver.debug("getStringFunctions"); - return ""; - } - - public String getSystemFunctions() throws SQLException - { - // XXX-Not Implemented - if (Driver.logDebug) Driver.debug("getSystemFunctions"); - return ""; - } - - public String getTimeDateFunctions() throws SQLException - { - // XXX-Not Implemented - if (Driver.logDebug) Driver.debug("getTimeDateFunctions"); - return ""; - } - - /* - * This is the string that can be used to escape '_' and '%' in - * a search string pattern style catalog search parameters - * - * @return the string used to escape wildcard characters - * @exception SQLException if a database access error occurs - */ - public String getSearchStringEscape() throws SQLException - { - if (Driver.logDebug) Driver.debug("getSearchStringEscape"); - return "\\"; - } - - /* - * Get all the "extra" characters that can be used in unquoted - * identifier names (those beyond a-zA-Z0-9 and _) - * - *

From the file src/backend/parser/scan.l, an identifier is - * {letter}{letter_or_digit} which makes it just those listed - * above. - * - * @return a string containing the extra characters - * @exception SQLException if a database access error occurs - */ - public String getExtraNameCharacters() throws SQLException - { - if (Driver.logDebug) Driver.debug("getExtraNameCharacters"); - return ""; - } - - /* - * Is "ALTER TABLE" with an add column supported? - * Yes for PostgreSQL 6.1 - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsAlterTableWithAddColumn() throws SQLException - { - if (Driver.logDebug) Driver.debug("supportsAlterTableWithAddColumn " + true); - return true; - } - - /* - * Is "ALTER TABLE" with a drop column supported? - * Peter 10/10/2000 This was set to true, but 7.1devel doesn't support it! - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsAlterTableWithDropColumn() throws SQLException - { - if (Driver.logDebug) Driver.debug("supportsAlterTableWithDropColumn " + false); - return false; - } - - /* - * Is column aliasing supported? - * - *

If so, the SQL AS clause can be used to provide names for - * computed columns or to provide alias names for columns as - * required. A JDBC Compliant driver always returns true. - * - *

e.g. - * - * 

-	 * select count(C) as C_COUNT from T group by C;
-	 *
-	 *

- * should return a column named as C_COUNT instead of count(C) - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsColumnAliasing() throws SQLException - { - if (Driver.logDebug) Driver.debug("supportsColumnAliasing " + true); - return true; - } - - /* - * Are concatenations between NULL and non-NULL values NULL? A - * JDBC Compliant driver always returns true - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean nullPlusNonNullIsNull() throws SQLException - { - if (Driver.logDebug) Driver.debug("nullPlusNonNullIsNull " + true); - return true; - } - - public boolean supportsConvert() throws SQLException - { - // XXX-Not Implemented - if (Driver.logDebug) Driver.debug("supportsConvert " + false); - return false; - } - - public boolean supportsConvert(int fromType, int toType) throws SQLException - { - // XXX-Not Implemented - if (Driver.logDebug) Driver.debug("supportsConvert " + false); - return false; - } - - /* - * Are table correlation names supported? A JDBC Compliant - * driver always returns true. - * - * @return true if so; false otherwise - * @exception SQLException - if a database access error occurs - */ - public boolean supportsTableCorrelationNames() throws SQLException - { - if (Driver.logDebug) Driver.debug("supportsTableCorrelationNames " + true); - return true; - } - - /* - * If table correlation names are supported, are they restricted to - * be different from the names of the tables? - * - * @return true if so; false otherwise - * @exception SQLException - if a database access error occurs - */ - public boolean supportsDifferentTableCorrelationNames() throws SQLException - { - if (Driver.logDebug) Driver.debug("supportsDifferentTableCorrelationNames " + false); - return false; - } - - /* - * Are expressions in "ORDER BY" lists supported? - * - *
e.g. select * from t order by a + b; - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsExpressionsInOrderBy() throws SQLException - { - if (Driver.logDebug) Driver.debug("supportsExpressionsInOrderBy " + true); - return true; - } - - /* - * Can an "ORDER BY" clause use columns not in the SELECT? - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsOrderByUnrelated() throws SQLException - { - boolean supportsOrderByUnrelated = connection.haveMinimumServerVersion("6.4"); - if (Driver.logDebug) Driver.debug("supportsOrderByUnrelated " + supportsOrderByUnrelated); - return supportsOrderByUnrelated; - } - - /* - * Is some form of "GROUP BY" clause supported? - * I checked it, and yes it is. - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsGroupBy() throws SQLException - { - if (Driver.logDebug) Driver.debug("supportsGroupBy " + true); - return true; - } - - /* - * Can a "GROUP BY" clause use columns not in the SELECT? - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsGroupByUnrelated() throws SQLException - { - boolean supportsGroupByUnrelated = connection.haveMinimumServerVersion("6.4"); - if (Driver.logDebug) Driver.debug("supportsGroupByUnrelated " + supportsGroupByUnrelated); - return supportsGroupByUnrelated; - } - - /* - * Can a "GROUP BY" clause add columns not in the SELECT provided - * it specifies all the columns in the SELECT? Does anyone actually - * understand what they mean here? - * - * (I think this is a subset of the previous function. -- petere) - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsGroupByBeyondSelect() throws SQLException - { - boolean supportsGroupByBeyondSelect = connection.haveMinimumServerVersion("6.4"); - if (Driver.logDebug) Driver.debug("supportsGroupByUnrelated " + supportsGroupByBeyondSelect); - return supportsGroupByBeyondSelect; - } - - /* - * Is the escape character in "LIKE" clauses supported? A - * JDBC compliant driver always returns true. - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsLikeEscapeClause() throws SQLException - { - boolean supportsLikeEscapeClause = connection.haveMinimumServerVersion("7.1"); - if (Driver.logDebug) Driver.debug("supportsLikeEscapeClause " + supportsLikeEscapeClause); - return supportsLikeEscapeClause; - } - - /* - * Are multiple ResultSets from a single execute supported? - * Well, I implemented it, but I dont think this is possible from - * the back ends point of view. - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsMultipleResultSets() throws SQLException - { - if (Driver.logDebug) Driver.debug("supportsMultipleResultSets " + false); - return false; - } - - /* - * Can we have multiple transactions open at once (on different - * connections?) - * I guess we can have, since Im relying on it. - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsMultipleTransactions() throws SQLException - { - if (Driver.logDebug) Driver.debug("supportsMultipleTransactions " + true); - return true; - } - - /* - * Can columns be defined as non-nullable. A JDBC Compliant driver - * always returns true. - * - *

This changed from false to true in v6.2 of the driver, as this - * support was added to the backend. - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsNonNullableColumns() throws SQLException - { - if (Driver.logDebug) Driver.debug("supportsNonNullableColumns true"); - return true; - } - - /* - * Does this driver support the minimum ODBC SQL grammar. This - * grammar is defined at: - * - *

http://www.microsoft.com/msdn/sdk/platforms/doc/odbc/src/intropr.htm - * - *

In Appendix C. From this description, we seem to support the - * ODBC minimal (Level 0) grammar. - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsMinimumSQLGrammar() throws SQLException - { - if (Driver.logDebug) Driver.debug("supportsMinimumSQLGrammar TRUE"); - return true; - } - - /* - * Does this driver support the Core ODBC SQL grammar. We need - * SQL-92 conformance for this. - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsCoreSQLGrammar() throws SQLException - { - if (Driver.logDebug) Driver.debug("supportsCoreSQLGrammar FALSE "); - return false; - } - - /* - * Does this driver support the Extended (Level 2) ODBC SQL - * grammar. We don't conform to the Core (Level 1), so we can't - * conform to the Extended SQL Grammar. - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsExtendedSQLGrammar() throws SQLException - { - if (Driver.logDebug) Driver.debug("supportsExtendedSQLGrammar FALSE"); - return false; - } - - /* - * Does this driver support the ANSI-92 entry level SQL grammar? - * All JDBC Compliant drivers must return true. We currently - * report false until 'schema' support is added. Then this - * should be changed to return true, since we will be mostly - * compliant (probably more compliant than many other databases) - * And since this is a requirement for all JDBC drivers we - * need to get to the point where we can return true. - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsANSI92EntryLevelSQL() throws SQLException - { - boolean schemas = connection.haveMinimumServerVersion("7.3"); - if (Driver.logDebug) Driver.debug("supportsANSI92EntryLevelSQL " + schemas); - return schemas; - - } - - /* - * Does this driver support the ANSI-92 intermediate level SQL - * grammar? - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsANSI92IntermediateSQL() throws SQLException - { - if (Driver.logDebug) Driver.debug("supportsANSI92IntermediateSQL false "); - return false; - } - - /* - * Does this driver support the ANSI-92 full SQL grammar? - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsANSI92FullSQL() throws SQLException - { - if (Driver.logDebug) Driver.debug("supportsANSI92FullSQL false "); - return false; - } - - /* - * Is the SQL Integrity Enhancement Facility supported? - * I haven't seen this mentioned anywhere, so I guess not - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsIntegrityEnhancementFacility() throws SQLException - { - if (Driver.logDebug) Driver.debug("supportsIntegrityEnhancementFacility false "); - return false; - } - - /* - * Is some form of outer join supported? - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsOuterJoins() throws SQLException - { - boolean supportsOuterJoins = connection.haveMinimumServerVersion("7.1"); - if (Driver.logDebug) Driver.debug("supportsOuterJoins " + supportsOuterJoins); - return supportsOuterJoins; - } - - /* - * Are full nexted outer joins supported? - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsFullOuterJoins() throws SQLException - { - boolean supportsFullOuterJoins = connection.haveMinimumServerVersion("7.1"); - if (Driver.logDebug) Driver.debug("supportsFullOuterJoins " + supportsFullOuterJoins); - return supportsFullOuterJoins; - } - - /* - * Is there limited support for outer joins? - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsLimitedOuterJoins() throws SQLException - { - boolean supportsLimitedOuterJoins = connection.haveMinimumServerVersion("7.1"); - if (Driver.logDebug) Driver.debug("supportsFullOuterJoins " + supportsLimitedOuterJoins); - return supportsLimitedOuterJoins; - } - - /* - * What is the database vendor's preferred term for "schema"? - * PostgreSQL doesn't have schemas, but when it does, we'll use the - * term "schema". - * - * @return the vendor term - * @exception SQLException if a database access error occurs - */ - public String getSchemaTerm() throws SQLException - { - if (Driver.logDebug) Driver.debug("getSchemaTerm schema"); - return "schema"; - } - - /* - * What is the database vendor's preferred term for "procedure"? - * Traditionally, "function" has been used. - * - * @return the vendor term - * @exception SQLException if a database access error occurs - */ - public String getProcedureTerm() throws SQLException - { - if (Driver.logDebug) Driver.debug("getProcedureTerm function "); - return "function"; - } - - /* - * What is the database vendor's preferred term for "catalog"? - * - * @return the vendor term - * @exception SQLException if a database access error occurs - */ - public String getCatalogTerm() throws SQLException - { - if (Driver.logDebug) Driver.debug("getCatalogTerm database "); - return "database"; - } - - /* - * Does a catalog appear at the start of a qualified table name? - * (Otherwise it appears at the end). - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean isCatalogAtStart() throws SQLException - { - // return true here; we return false for every other catalog function - // so it won't matter what we return here D.C. - if (Driver.logDebug) Driver.debug("isCatalogAtStart not implemented"); - return true; - } - - /* - * What is the Catalog separator. - * - * @return the catalog separator string - * @exception SQLException if a database access error occurs - */ - public String getCatalogSeparator() throws SQLException - { - // Give them something to work with here - // everything else returns false so it won't matter what we return here D.C. - if (Driver.logDebug) Driver.debug("getCatalogSeparator not implemented "); - return "."; - } - - /* - * Can a schema name be used in a data manipulation statement? Nope. - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsSchemasInDataManipulation() throws SQLException - { - if (Driver.logDebug) Driver.debug("supportsSchemasInDataManipulation false"); - return false; - } - - /* - * Can a schema name be used in a procedure call statement? Nope. - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsSchemasInProcedureCalls() throws SQLException - { - if (Driver.logDebug) Driver.debug("supportsSchemasInProcedureCalls false"); - return false; - } - - /* - * Can a schema be used in a table definition statement? Nope. - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsSchemasInTableDefinitions() throws SQLException - { - boolean schemas = connection.haveMinimumServerVersion("7.3"); - - if (Driver.logDebug) Driver.debug("supportsSchemasInTableDefinitions " + schemas); - return schemas; - } - - /* - * Can a schema name be used in an index definition statement? - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsSchemasInIndexDefinitions() throws SQLException - { - if (Driver.logDebug) Driver.debug("supportsSchemasInIndexDefinitions false"); - return false; - } - - /* - * Can a schema name be used in a privilege definition statement? - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsSchemasInPrivilegeDefinitions() throws SQLException - { - if (Driver.logDebug) Driver.debug("supportsSchemasInPrivilegeDefinitions false"); - return false; - } - - /* - * Can a catalog name be used in a data manipulation statement? - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsCatalogsInDataManipulation() throws SQLException - { - if (Driver.logDebug) Driver.debug("supportsCatalogsInDataManipulation false"); - return false; - } - - /* - * Can a catalog name be used in a procedure call statement? - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsCatalogsInProcedureCalls() throws SQLException - { - if (Driver.logDebug) Driver.debug("supportsCatalogsInDataManipulation false"); - return false; - } - - /* - * Can a catalog name be used in a table definition statement? - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsCatalogsInTableDefinitions() throws SQLException - { - if (Driver.logDebug) Driver.debug("supportsCatalogsInTableDefinitions false"); - return false; - } - - /* - * Can a catalog name be used in an index definition? - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsCatalogsInIndexDefinitions() throws SQLException - { - if (Driver.logDebug) Driver.debug("supportsCatalogsInIndexDefinitions false"); - return false; - } - - /* - * Can a catalog name be used in a privilege definition statement? - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsCatalogsInPrivilegeDefinitions() throws SQLException - { - if (Driver.logDebug) Driver.debug("supportsCatalogsInPrivilegeDefinitions false"); - return false; - } - - /* - * We support cursors for gets only it seems. I dont see a method - * to get a positioned delete. - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsPositionedDelete() throws SQLException - { - if (Driver.logDebug) Driver.debug("supportsPositionedDelete false"); - return false; // For now... - } - - /* - * Is positioned UPDATE supported? - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsPositionedUpdate() throws SQLException - { - if (Driver.logDebug) Driver.debug("supportsPositionedUpdate false"); - return false; // For now... - } - - /* - * Is SELECT for UPDATE supported? - * - * @return true if so; false otherwise - * @exception SQLException - if a database access error occurs - */ - public boolean supportsSelectForUpdate() throws SQLException - { - return connection.haveMinimumServerVersion("6.5"); - } - - /* - * Are stored procedure calls using the stored procedure escape - * syntax supported? - * - * @return true if so; false otherwise - * @exception SQLException - if a database access error occurs - */ - public boolean supportsStoredProcedures() throws SQLException - { - return false; - } - - /* - * Are subqueries in comparison expressions supported? A JDBC - * Compliant driver always returns true. - * - * @return true if so; false otherwise - * @exception SQLException - if a database access error occurs - */ - public boolean supportsSubqueriesInComparisons() throws SQLException - { - return true; - } - - /* - * Are subqueries in 'exists' expressions supported? A JDBC - * Compliant driver always returns true. - * - * @return true if so; false otherwise - * @exception SQLException - if a database access error occurs - */ - public boolean supportsSubqueriesInExists() throws SQLException - { - return true; - } - - /* - * Are subqueries in 'in' statements supported? A JDBC - * Compliant driver always returns true. - * - * @return true if so; false otherwise - * @exception SQLException - if a database access error occurs - */ - public boolean supportsSubqueriesInIns() throws SQLException - { - return true; - } - - /* - * Are subqueries in quantified expressions supported? A JDBC - * Compliant driver always returns true. - * - * (No idea what this is, but we support a good deal of - * subquerying.) - * - * @return true if so; false otherwise - * @exception SQLException - if a database access error occurs - */ - public boolean supportsSubqueriesInQuantifieds() throws SQLException - { - return true; - } - - /* - * Are correlated subqueries supported? A JDBC Compliant driver - * always returns true. - * - * (a.k.a. subselect in from?) - * - * @return true if so; false otherwise - * @exception SQLException - if a database access error occurs - */ - public boolean supportsCorrelatedSubqueries() throws SQLException - { - return connection.haveMinimumServerVersion("7.1"); - } - - /* - * Is SQL UNION supported? - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsUnion() throws SQLException - { - return true; // since 6.3 - } - - /* - * Is SQL UNION ALL supported? - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsUnionAll() throws SQLException - { - return connection.haveMinimumServerVersion("7.1"); - } - - /* - * In PostgreSQL, Cursors are only open within transactions. - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsOpenCursorsAcrossCommit() throws SQLException - { - return false; - } - - /* - * Do we support open cursors across multiple transactions? - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsOpenCursorsAcrossRollback() throws SQLException - { - return false; - } - - /* - * Can statements remain open across commits? They may, but - * this driver cannot guarentee that. In further reflection. - * we are talking a Statement object here, so the answer is - * yes, since the Statement is only a vehicle to ExecSQL() - * - * @return true if they always remain open; false otherwise - * @exception SQLException if a database access error occurs - */ - public boolean supportsOpenStatementsAcrossCommit() throws SQLException - { - return true; - } - - /* - * Can statements remain open across rollbacks? They may, but - * this driver cannot guarentee that. In further contemplation, - * we are talking a Statement object here, so the answer is yes, - * since the Statement is only a vehicle to ExecSQL() in Connection - * - * @return true if they always remain open; false otherwise - * @exception SQLException if a database access error occurs - */ - public boolean supportsOpenStatementsAcrossRollback() throws SQLException - { - return true; - } - - /* - * How many hex characters can you have in an inline binary literal - * - * @return the max literal length - * @exception SQLException if a database access error occurs - */ - public int getMaxBinaryLiteralLength() throws SQLException - { - return 0; // no limit - } - - /* - * What is the maximum length for a character literal - * I suppose it is 8190 (8192 - 2 for the quotes) - * - * @return the max literal length - * @exception SQLException if a database access error occurs - */ - public int getMaxCharLiteralLength() throws SQLException - { - return 0; // no limit - } - - /* - * Whats the limit on column name length. The description of - * pg_class would say '32' (length of pg_class.relname) - we - * should probably do a query for this....but.... - * - * @return the maximum column name length - * @exception SQLException if a database access error occurs - */ - public int getMaxColumnNameLength() throws SQLException - { - return 32; - } - - /* - * What is the maximum number of columns in a "GROUP BY" clause? - * - * @return the max number of columns - * @exception SQLException if a database access error occurs - */ - public int getMaxColumnsInGroupBy() throws SQLException - { - return 0; // no limit - } - - /* - * What's the maximum number of columns allowed in an index? - * 6.0 only allowed one column, but 6.1 introduced multi-column - * indices, so, theoretically, its all of them. - * - * @return max number of columns - * @exception SQLException if a database access error occurs - */ - public int getMaxColumnsInIndex() throws SQLException - { - return getMaxColumnsInTable(); - } - - /* - * What's the maximum number of columns in an "ORDER BY clause? - * - * @return the max columns - * @exception SQLException if a database access error occurs - */ - public int getMaxColumnsInOrderBy() throws SQLException - { - return 0; // no limit - } - - /* - * What is the maximum number of columns in a "SELECT" list? - * - * @return the max columns - * @exception SQLException if a database access error occurs - */ - public int getMaxColumnsInSelect() throws SQLException - { - return 0; // no limit - } - - /* - * What is the maximum number of columns in a table? From the - * CREATE TABLE reference page... - * - *

"The new class is created as a heap with no initial data. A - * class can have no more than 1600 attributes (realistically, - * this is limited by the fact that tuple sizes must be less than - * 8192 bytes)..." - * - * @return the max columns - * @exception SQLException if a database access error occurs - */ - public int getMaxColumnsInTable() throws SQLException - { - return 1600; - } - - /* - * How many active connection can we have at a time to this - * database? Well, since it depends on postmaster, which just - * does a listen() followed by an accept() and fork(), its - * basically very high. Unless the system runs out of processes, - * it can be 65535 (the number of aux. ports on a TCP/IP system). - * I will return 8192 since that is what even the largest system - * can realistically handle, - * - * @return the maximum number of connections - * @exception SQLException if a database access error occurs - */ - public int getMaxConnections() throws SQLException - { - return 8192; - } - - /* - * What is the maximum cursor name length (the same as all - * the other F***** identifiers!) - * - * @return max cursor name length in bytes - * @exception SQLException if a database access error occurs - */ - public int getMaxCursorNameLength() throws SQLException - { - return 32; - } - - /* - * Retrieves the maximum number of bytes for an index, including all - * of the parts of the index. - * - * @return max index length in bytes, which includes the composite - * of all the constituent parts of the index; a result of zero means - * that there is no limit or the limit is not known - * @exception SQLException if a database access error occurs - */ - public int getMaxIndexLength() throws SQLException - { - return 0; // no limit (larger than an int anyway) - } - - public int getMaxSchemaNameLength() throws SQLException - { - // XXX-Not Implemented - return 0; - } - - /* - * What is the maximum length of a procedure name? - * (length of pg_proc.proname used) - again, I really - * should do a query here to get it. - * - * @return the max name length in bytes - * @exception SQLException if a database access error occurs - */ - public int getMaxProcedureNameLength() throws SQLException - { - return 32; - } - - public int getMaxCatalogNameLength() throws SQLException - { - // XXX-Not Implemented - return 0; - } - - /* - * What is the maximum length of a single row? - * - * @return max row size in bytes - * @exception SQLException if a database access error occurs - */ - public int getMaxRowSize() throws SQLException - { - if (connection.haveMinimumServerVersion("7.1")) - return 1073741824; // 1 GB - else - return 8192; // XXX could be altered - } - - /* - * Did getMaxRowSize() include LONGVARCHAR and LONGVARBINARY - * blobs? We don't handle blobs yet - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean doesMaxRowSizeIncludeBlobs() throws SQLException - { - return false; - } - - /* - * What is the maximum length of a SQL statement? - * - * @return max length in bytes - * @exception SQLException if a database access error occurs - */ - public int getMaxStatementLength() throws SQLException - { - if (connection.haveMinimumServerVersion("7.0")) - return 0; // actually whatever fits in size_t - else - return 16384; - } - - /* - * How many active statements can we have open at one time to - * this database? Basically, since each Statement downloads - * the results as the query is executed, we can have many. However, - * we can only really have one statement per connection going - * at once (since they are executed serially) - so we return - * one. - * - * @return the maximum - * @exception SQLException if a database access error occurs - */ - public int getMaxStatements() throws SQLException - { - return 1; - } - - /* - * What is the maximum length of a table name? This was found - * from pg_class.relname length - * - * @return max name length in bytes - * @exception SQLException if a database access error occurs - */ - public int getMaxTableNameLength() throws SQLException - { - return 32; - } - - /* - * What is the maximum number of tables that can be specified - * in a SELECT? - * - * @return the maximum - * @exception SQLException if a database access error occurs - */ - public int getMaxTablesInSelect() throws SQLException - { - return 0; // no limit - } - - /* - * What is the maximum length of a user name? Well, we generally - * use UNIX like user names in PostgreSQL, so I think this would - * be 8. However, showing the schema for pg_user shows a length - * for username of 32. - * - * @return the max name length in bytes - * @exception SQLException if a database access error occurs - */ - public int getMaxUserNameLength() throws SQLException - { - return 32; - } - - - /* - * What is the database's default transaction isolation level? We - * do not support this, so all transactions are SERIALIZABLE. - * - * @return the default isolation level - * @exception SQLException if a database access error occurs - * @see Connection - */ - public int getDefaultTransactionIsolation() throws SQLException - { - return Connection.TRANSACTION_READ_COMMITTED; - } - - /* - * Are transactions supported? If not, commit and rollback are noops - * and the isolation level is TRANSACTION_NONE. We do support - * transactions. - * - * @return true if transactions are supported - * @exception SQLException if a database access error occurs - */ - public boolean supportsTransactions() throws SQLException - { - return true; - } - - /* - * Does the database support the given transaction isolation level? - * We only support TRANSACTION_SERIALIZABLE and TRANSACTION_READ_COMMITTED - * - * @param level the values are defined in java.sql.Connection - * @return true if so - * @exception SQLException if a database access error occurs - * @see Connection - */ - public boolean supportsTransactionIsolationLevel(int level) throws SQLException - { - if (level == Connection.TRANSACTION_SERIALIZABLE || - level == Connection.TRANSACTION_READ_COMMITTED) - return true; - else - return false; - } - - /* - * Are both data definition and data manipulation transactions - * supported? - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsDataDefinitionAndDataManipulationTransactions() throws SQLException - { - return true; - } - - /* - * Are only data manipulation statements withing a transaction - * supported? - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean supportsDataManipulationTransactionsOnly() throws SQLException - { - return false; - } - - /* - * Does a data definition statement within a transaction force - * the transaction to commit? I think this means something like: - * - * 

-	 * CREATE TABLE T (A INT);
-	 * INSERT INTO T (A) VALUES (2);
-	 * BEGIN;
-	 * UPDATE T SET A = A + 1;
-	 * CREATE TABLE X (A INT);
-	 * SELECT A FROM T INTO X;
-	 * COMMIT;
-	 *

- * - * does the CREATE TABLE call cause a commit? The answer is no. - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean dataDefinitionCausesTransactionCommit() throws SQLException - { - return false; - } - - /* - * Is a data definition statement within a transaction ignored? - * It seems to be (from experiment in previous method) - * - * @return true if so - * @exception SQLException if a database access error occurs - */ - public boolean dataDefinitionIgnoredInTransactions() throws SQLException - { - return true; - } - - /* - * Get a description of stored procedures available in a catalog - * - *

Only procedure descriptions matching the schema and procedure - * name criteria are returned. They are ordered by PROCEDURE_SCHEM - * and PROCEDURE_NAME - * - *

Each procedure description has the following columns: - *

    - *
  1. PROCEDURE_CAT String => procedure catalog (may be null) - *
  2. PROCEDURE_SCHEM String => procedure schema (may be null) - *
  3. PROCEDURE_NAME String => procedure name - *
  4. Field 4 reserved (make it null) - *
  5. Field 5 reserved (make it null) - *
  6. Field 6 reserved (make it null) - *
  7. REMARKS String => explanatory comment on the procedure - *
  8. PROCEDURE_TYPE short => kind of procedure - *
      - *
    • procedureResultUnknown - May return a result - *
    • procedureNoResult - Does not return a result - *
    • procedureReturnsResult - Returns a result - *
    - *
- * - * @param catalog - a catalog name; "" retrieves those without a - * catalog; null means drop catalog name from criteria - * @param schemaParrern - a schema name pattern; "" retrieves those - * without a schema - we ignore this parameter - * @param procedureNamePattern - a procedure name pattern - * @return ResultSet - each row is a procedure description - * @exception SQLException if a database access error occurs - */ - public java.sql.ResultSet getProcedures(String catalog, String schemaPattern, String procedureNamePattern) throws SQLException - { - // the field descriptors for the new ResultSet - Field f[] = new Field[8]; - java.sql.ResultSet r; // ResultSet for the SQL query that we need to do - Vector v = new Vector(); // The new ResultSet tuple stuff - - f[0] = new Field(connection, "PROCEDURE_CAT", iVarcharOid, 32); - f[1] = new Field(connection, "PROCEDURE_SCHEM", iVarcharOid, 32); - f[2] = new Field(connection, "PROCEDURE_NAME", iVarcharOid, 32); - f[3] = f[4] = f[5] = new Field(connection, "reserved", iVarcharOid, 32); // null; // reserved, must be null for now - f[6] = new Field(connection, "REMARKS", iVarcharOid, 8192); - f[7] = new Field(connection, "PROCEDURE_TYPE", iInt2Oid, 2); - - // If the pattern is null, then set it to the default - if (procedureNamePattern == null) - procedureNamePattern = "%"; - - r = connection.ExecSQL("select proname, proretset from pg_proc where proname like '" + procedureNamePattern.toLowerCase() + "' order by proname"); - - while (r.next()) - { - byte[][] tuple = new byte[8][0]; - - tuple[0] = null; // Catalog name - tuple[1] = null; // Schema name - tuple[2] = r.getBytes(1); // Procedure name - tuple[3] = tuple[4] = tuple[5] = null; // Reserved - tuple[6] = null; - - if (r.getBoolean(2)) - tuple[7] = Integer.toString(java.sql.DatabaseMetaData.procedureReturnsResult).getBytes(); - else - tuple[7] = Integer.toString(java.sql.DatabaseMetaData.procedureNoResult).getBytes(); - - v.addElement(tuple); - } - return connection.getResultSet(null, f, v, "OK", 1); - } - - /* - * Get a description of a catalog's stored procedure parameters - * and result columns. - * - *

Only descriptions matching the schema, procedure and parameter - * name criteria are returned. They are ordered by PROCEDURE_SCHEM - * and PROCEDURE_NAME. Within this, the return value, if any, is - * first. Next are the parameter descriptions in call order. The - * column descriptions follow in column number order. - * - *

Each row in the ResultSet is a parameter description or column - * description with the following fields: - *

    - *
  1. PROCEDURE_CAT String => procedure catalog (may be null) - *
  2. PROCEDURE_SCHEM String => procedure schema (may be null) - *
  3. PROCEDURE_NAME String => procedure name - *
  4. COLUMN_NAME String => column/parameter name - *
  5. COLUMN_TYPE Short => kind of column/parameter: - *
    • procedureColumnUnknown - nobody knows - *
    • procedureColumnIn - IN parameter - *
    • procedureColumnInOut - INOUT parameter - *
    • procedureColumnOut - OUT parameter - *
    • procedureColumnReturn - procedure return value - *
    • procedureColumnResult - result column in ResultSet - *
    - *
  6. DATA_TYPE short => SQL type from java.sql.Types - *
  7. TYPE_NAME String => SQL type name - *
  8. PRECISION int => precision - *
  9. LENGTH int => length in bytes of data - *
  10. SCALE short => scale - *
  11. RADIX short => radix - *
  12. NULLABLE short => can it contain NULL? - *
    • procedureNoNulls - does not allow NULL values - *
    • procedureNullable - allows NULL values - *
    • procedureNullableUnknown - nullability unknown - *
    • REMARKS String => comment describing parameter/column - *
- * @param catalog This is ignored in org.postgresql, advise this is set to null - * @param schemaPattern This is ignored in org.postgresql, advise this is set to null - * @param procedureNamePattern a procedure name pattern - * @param columnNamePattern a column name pattern - * @return each row is a stored procedure parameter or column description - * @exception SQLException if a database-access error occurs - * @see #getSearchStringEscape - */ - // Implementation note: This is required for Borland's JBuilder to work - public java.sql.ResultSet getProcedureColumns(String catalog, String schemaPattern, String procedureNamePattern, String columnNamePattern) throws SQLException - { - if (procedureNamePattern == null) - procedureNamePattern = "%"; - - if (columnNamePattern == null) - columnNamePattern = "%"; - - // for now, this returns an empty result set. - Field f[] = new Field[13]; - ResultSet r; // ResultSet for the SQL query that we need to do - Vector v = new Vector(); // The new ResultSet tuple stuff - - f[0] = new Field(connection, "PROCEDURE_CAT", iVarcharOid, 32); - f[1] = new Field(connection, "PROCEDURE_SCHEM", iVarcharOid, 32); - f[2] = new Field(connection, "PROCEDURE_NAME", iVarcharOid, 32); - f[3] = new Field(connection, "COLUMN_NAME", iVarcharOid, 32); - f[4] = new Field(connection, "COLUMN_TYPE", iInt2Oid, 2); - f[5] = new Field(connection, "DATA_TYPE", iInt2Oid, 2); - f[6] = new Field(connection, "TYPE_NAME", iVarcharOid, 32); - f[7] = new Field(connection, "PRECISION", iInt4Oid, 4); - f[8] = new Field(connection, "LENGTH", iInt4Oid, 4); - f[9] = new Field(connection, "SCALE", iInt2Oid, 2); - f[10] = new Field(connection, "RADIX", iInt2Oid, 2); - f[11] = new Field(connection, "NULLABLE", iInt2Oid, 2); - f[12] = new Field(connection, "REMARKS", iVarcharOid, 32); - - // add query loop here - - return connection.getResultSet(null, f, v, "OK", 1); - } - - /* - * Get a description of tables available in a catalog. - * - *

Only table descriptions matching the catalog, schema, table - * name and type criteria are returned. They are ordered by - * TABLE_TYPE, TABLE_SCHEM and TABLE_NAME. - * - *

Each table description has the following columns: - * - *

    - *
  1. TABLE_CAT String => table catalog (may be null) - *
  2. TABLE_SCHEM String => table schema (may be null) - *
  3. TABLE_NAME String => table name - *
  4. TABLE_TYPE String => table type. Typical types are "TABLE", - * "VIEW", "SYSTEM TABLE", "GLOBAL TEMPORARY", "LOCAL - * TEMPORARY", "ALIAS", "SYNONYM". - *
  5. REMARKS String => explanatory comment on the table - *
- * - *

The valid values for the types parameter are: - * "TABLE", "INDEX", "SEQUENCE", "SYSTEM TABLE" and "SYSTEM INDEX" - * - * @param catalog a catalog name; For org.postgresql, this is ignored, and - * should be set to null - * @param schemaPattern a schema name pattern; For org.postgresql, this is ignored, and - * should be set to null - * @param tableNamePattern a table name pattern. For all tables this should be "%" - * @param types a list of table types to include; null returns - * all types - * @return each row is a table description - * @exception SQLException if a database-access error occurs. - */ - public java.sql.ResultSet getTables(String catalog, String schemaPattern, String tableNamePattern, String types[]) throws SQLException - { - // Handle default value for types - if (types == null) - types = defaultTableTypes; - - if (tableNamePattern == null) - tableNamePattern = "%"; - - // the field descriptors for the new ResultSet - Field f[] = new Field[5]; - java.sql.ResultSet r; // ResultSet for the SQL query that we need to do - Vector v = new Vector(); // The new ResultSet tuple stuff - - f[0] = new Field(connection, "TABLE_CAT", iVarcharOid, 32); - f[1] = new Field(connection, "TABLE_SCHEM", iVarcharOid, 32); - f[2] = new Field(connection, "TABLE_NAME", iVarcharOid, 32); - f[3] = new Field(connection, "TABLE_TYPE", iVarcharOid, 32); - f[4] = new Field(connection, "REMARKS", iVarcharOid, 32); - - // Now form the query - StringBuffer sql = new StringBuffer("select relname,oid,relkind from pg_class where ("); - - boolean notFirst = false; - for (int i = 0;i < types.length;i++) - { - for (int j = 0;j < getTableTypes.length;j++) - if (getTableTypes[j][0].equals(types[i])) - { - if (notFirst) - sql.append(" or "); - sql.append(getTableTypes[j][1]); - notFirst = true; - } - } - - // Added by Stefan Andreasen - // Now take the pattern into account - sql.append(") and relname like '"); - sql.append(tableNamePattern.toLowerCase()); - sql.append("' order by relkind, relname"); - - // Now run the query - r = connection.ExecSQL(sql.toString()); - - while (r.next()) - { - byte[][] tuple = new byte[5][0]; - - // Fetch the description for the table (if any) - String getDescriptionStatement = - connection.haveMinimumServerVersion("7.2") ? - "select obj_description(" + r.getInt(2) + ",'pg_class')" : - "select description from pg_description where objoid=" + r.getInt(2); - - java.sql.ResultSet dr = connection.ExecSQL(getDescriptionStatement); - - byte remarks[] = null; - - if (((AbstractJdbc2ResultSet)dr).getTupleCount() == 1) - { - dr.next(); - remarks = dr.getBytes(1); - } - dr.close(); - - String relKind; - switch (r.getBytes(3)[0]) - { - case (byte) 'r': - if ( r.getString(1).startsWith("pg_") ) - { - relKind = "SYSTEM TABLE"; - } - else - { - relKind = "TABLE"; - } - break; - case (byte) 'i': - relKind = "INDEX"; - break; - case (byte) 'S': - relKind = "SEQUENCE"; - break; - case (byte) 'v': - relKind = "VIEW"; - break; - default: - relKind = null; - } - - tuple[0] = null; // Catalog name - tuple[1] = null; // Schema name - tuple[2] = r.getBytes(1); // Table name - tuple[3] = (relKind == null) ? null : relKind.getBytes(); // Table type - tuple[4] = remarks; // Remarks - v.addElement(tuple); - } - r.close(); - return connection.getResultSet(null, f, v, "OK", 1); - } - - // This array contains the valid values for the types argument - // in getTables(). - // - // Each supported type consists of it's name, and the sql where - // clause to retrieve that value. - // - // IMPORTANT: the query must be enclosed in ( ) - private static final String getTableTypes[][] = { - {"TABLE", "(relkind='r' and relhasrules='f' and relname !~ '^pg_' and relname !~ '^xinv')"}, - {"VIEW", "(relkind='v' and relname !~ '^pg_')"}, - {"INDEX", "(relkind='i' and relname !~ '^pg_')"}, - {"SEQUENCE", "(relkind='S' and relname !~ '^pg_')"}, - {"SYSTEM TABLE", "(relkind='r' and relname ~ '^pg_')"}, - {"SYSTEM INDEX", "(relkind='i' and relname ~ '^pg_')"} - }; - - // These are the default tables, used when NULL is passed to getTables - // The choice of these provide the same behaviour as psql's \d - private static final String defaultTableTypes[] = { - "TABLE", "VIEW", "INDEX", "SEQUENCE" - }; - - /* - * Get the schema names available in this database. The results - * are ordered by schema name. - * - *

The schema column is: - *

    - *
  1. TABLE_SCHEM String => schema name - *
- * - * @return ResultSet each row has a single String column that is a - * schema name - */ - public java.sql.ResultSet getSchemas() throws SQLException - { - // We don't use schemas, so we simply return a single schema name "". - // - Field f[] = new Field[1]; - Vector v = new Vector(); - byte[][] tuple = new byte[1][0]; - f[0] = new Field(connection, "TABLE_SCHEM", iVarcharOid, 32); - tuple[0] = "".getBytes(); - v.addElement(tuple); - return connection.getResultSet(null, f, v, "OK", 1); - } - - /* - * Get the catalog names available in this database. The results - * are ordered by catalog name. - * - *

The catalog column is: - *

    - *
  1. TABLE_CAT String => catalog name - *
- * - * @return ResultSet each row has a single String column that is a - * catalog name - */ - public java.sql.ResultSet getCatalogs() throws SQLException - { - return connection.createStatement().executeQuery("select datname as TABLE_CAT from pg_database;"); - } - - /* - * Get the table types available in this database. The results - * are ordered by table type. - * - *

The table type is: - *

    - *
  1. TABLE_TYPE String => table type. Typical types are "TABLE", - * "VIEW", "SYSTEM TABLE", "GLOBAL TEMPORARY", - * "LOCAL TEMPORARY", "ALIAS", "SYNONYM". - *
- * - * @return ResultSet each row has a single String column that is a - * table type - */ - public java.sql.ResultSet getTableTypes() throws SQLException - { - Field f[] = new Field[1]; - Vector v = new Vector(); - f[0] = new Field(connection, new String("TABLE_TYPE"), iVarcharOid, 32); - for (int i = 0;i < getTableTypes.length;i++) - { - byte[][] tuple = new byte[2][0]; - tuple[0] = getTableTypes[i][0].getBytes(); - v.addElement(tuple); - } - return connection.getResultSet(null, f, v, "OK", 1); - } - - /* - * Get a description of table columns available in a catalog. - * - *

Only column descriptions matching the catalog, schema, table - * and column name criteria are returned. They are ordered by - * TABLE_SCHEM, TABLE_NAME and ORDINAL_POSITION. - * - *

Each column description has the following columns: - *

    - *
  1. TABLE_CAT String => table catalog (may be null) - *
  2. TABLE_SCHEM String => table schema (may be null) - *
  3. TABLE_NAME String => table name - *
  4. COLUMN_NAME String => column name - *
  5. DATA_TYPE short => SQL type from java.sql.Types - *
  6. TYPE_NAME String => Data source dependent type name - *
  7. COLUMN_SIZE int => column size. For char or date - * types this is the maximum number of characters, for numeric or - * decimal types this is precision. - *
  8. BUFFER_LENGTH is not used. - *
  9. DECIMAL_DIGITS int => the number of fractional digits - *
  10. NUM_PREC_RADIX int => Radix (typically either 10 or 2) - *
  11. NULLABLE int => is NULL allowed? - *
      - *
    • columnNoNulls - might not allow NULL values - *
    • columnNullable - definitely allows NULL values - *
    • columnNullableUnknown - nullability unknown - *
    - *
  12. REMARKS String => comment describing column (may be null) - *
  13. COLUMN_DEF String => default value (may be null) - *
  14. SQL_DATA_TYPE int => unused - *
  15. SQL_DATETIME_SUB int => unused - *
  16. CHAR_OCTET_LENGTH int => for char types the - * maximum number of bytes in the column - *
  17. ORDINAL_POSITION int => index of column in table - * (starting at 1) - *
  18. IS_NULLABLE String => "NO" means column definitely - * does not allow NULL values; "YES" means the column might - * allow NULL values. An empty string means nobody knows. - *
- * - * @param catalog a catalog name; "" retrieves those without a catalog - * @param schemaPattern a schema name pattern; "" retrieves those - * without a schema - * @param tableNamePattern a table name pattern - * @param columnNamePattern a column name pattern - * @return ResultSet each row is a column description - * @see #getSearchStringEscape - */ - public java.sql.ResultSet getColumns(String catalog, String schemaPattern, String tableNamePattern, String columnNamePattern) throws SQLException - { - Vector v = new Vector(); // The new ResultSet tuple stuff - Field f[] = new Field[18]; // The field descriptors for the new ResultSet - - f[0] = new Field(connection, "TABLE_CAT", iVarcharOid, 32); - f[1] = new Field(connection, "TABLE_SCHEM", iVarcharOid, 32); - f[2] = new Field(connection, "TABLE_NAME", iVarcharOid, 32); - f[3] = new Field(connection, "COLUMN_NAME", iVarcharOid, 32); - f[4] = new Field(connection, "DATA_TYPE", iInt2Oid, 2); - f[5] = new Field(connection, "TYPE_NAME", iVarcharOid, 32); - f[6] = new Field(connection, "COLUMN_SIZE", iInt4Oid, 4); - f[7] = new Field(connection, "BUFFER_LENGTH", iVarcharOid, 32); - f[8] = new Field(connection, "DECIMAL_DIGITS", iInt4Oid, 4); - f[9] = new Field(connection, "NUM_PREC_RADIX", iInt4Oid, 4); - f[10] = new Field(connection, "NULLABLE", iInt4Oid, 4); - f[11] = new Field(connection, "REMARKS", iVarcharOid, 32); - f[12] = new Field(connection, "COLUMN_DEF", iVarcharOid, 32); - f[13] = new Field(connection, "SQL_DATA_TYPE", iInt4Oid, 4); - f[14] = new Field(connection, "SQL_DATETIME_SUB", iInt4Oid, 4); - f[15] = new Field(connection, "CHAR_OCTET_LENGTH", iVarcharOid, 32); - f[16] = new Field(connection, "ORDINAL_POSITION", iInt4Oid, 4); - f[17] = new Field(connection, "IS_NULLABLE", iVarcharOid, 32); - - StringBuffer sql = new StringBuffer(512); - - /* Build a >= 7.1 SQL statement to list all columns */ - sql.append("select " + - (connection.haveMinimumServerVersion("7.2") ? "a.attrelid, " : "a.oid, ") + - " c.relname, " + - " a.attname, " + - " a.atttypid, " + - " a.attnum, " + - " a.attnotnull, " + - " a.attlen, " + - " a.atttypmod, " + - " d.adsrc, " + - " t.typname, " + - /* Use the new col_description in 7.2 or an additional outer join in 7.1 */ - (connection.haveMinimumServerVersion("7.2") ? "col_description(a.attrelid, a.attnum) " : "e.description ") + - "from" + - " (" + - " (pg_class c inner join pg_attribute a on" + - " (" + - " a.attrelid=c.oid"); - - if ((tableNamePattern != null) && ! tableNamePattern.equals("%")) - { - sql.append(" and c.relname like \'" + tableNamePattern.toLowerCase() + "\'"); - } - - if ((columnNamePattern != null) && ! columnNamePattern.equals("%")) - { - sql.append(" and a.attname like \'" + columnNamePattern + "\'"); - } - - sql.append( - " and a.attnum > 0" + - " )" + - " ) inner join pg_type t on" + - " (" + - " t.oid = a.atttypid" + - " )" + - " )" + - " left outer join pg_attrdef d on" + - " (" + - " c.oid = d.adrelid" + - " and a.attnum = d.adnum" + - " ) "); - - if (!connection.haveMinimumServerVersion("7.2")) - { - /* Only for 7.1 */ - sql.append( - " left outer join pg_description e on" + - " (" + - " e.objoid = a.oid" + - " ) "); - } - - sql.append("order by" + - " c.relname, a.attnum"); - - java.sql.ResultSet r = connection.ExecSQL(sql.toString()); - while (r.next()) - { - byte[][] tuple = new byte[18][0]; - - String nullFlag = r.getString(6); - String typname = r.getString(10); - - tuple[0] = null; // Catalog name, not supported - tuple[1] = null; // Schema name, not supported - tuple[2] = r.getBytes(2); // Table name - tuple[3] = r.getBytes(3); // Column name - tuple[4] = Integer.toString(connection.getSQLType(typname)).getBytes(); // Data type - tuple[5] = typname.getBytes(); // Type name - - // Column size - // Looking at the psql source, - // I think the length of a varchar as specified when the table was created - // should be extracted from atttypmod which contains this length + sizeof(int32) - if (typname.equals("bpchar") || typname.equals("varchar")) - { - int atttypmod = r.getInt(8); - tuple[6] = Integer.toString(atttypmod != -1 ? atttypmod - VARHDRSZ : 0).getBytes(); - } - else - { - tuple[6] = r.getBytes(7); - } - - tuple[7] = null; // Buffer length - // Decimal digits = scale - // From the source (see e.g. backend/utils/adt/format_type.c, - // function numeric()) the scale and precision can be calculated - // from the typmod value. - if (typname.equals("numeric") || typname.equals("decimal")) - { - int attypmod = r.getInt(8) - VARHDRSZ; - tuple[8] = - Integer.toString( attypmod & 0xffff ).getBytes(); - tuple[9] = - Integer.toString( ( attypmod >> 16 ) & 0xffff ).getBytes(); - } - else - { - tuple[8] = "0".getBytes(); - tuple[9] = "10".getBytes(); // Num Prec Radix - assume decimal - } - tuple[10] = Integer.toString(nullFlag.equals("f") ? - java.sql.DatabaseMetaData.columnNullable : - java.sql.DatabaseMetaData.columnNoNulls).getBytes(); // Nullable - tuple[11] = r.getBytes(11); // Description (if any) - tuple[12] = r.getBytes(9); // Column default - tuple[13] = null; // sql data type (unused) - tuple[14] = null; // sql datetime sub (unused) - tuple[15] = tuple[6]; // char octet length - tuple[16] = r.getBytes(5); // ordinal position - tuple[17] = (nullFlag.equals("f") ? "YES" : "NO").getBytes(); // Is nullable - - v.addElement(tuple); - } - r.close(); - - return connection.getResultSet(null, f, v, "OK", 1); - } - - /* - * Get a description of the access rights for a table's columns. - * - *

Only privileges matching the column name criteria are - * returned. They are ordered by COLUMN_NAME and PRIVILEGE. - * - *

Each privilige description has the following columns: - *

    - *
  1. TABLE_CAT String => table catalog (may be null) - *
  2. TABLE_SCHEM String => table schema (may be null) - *
  3. TABLE_NAME String => table name - *
  4. COLUMN_NAME String => column name - *
  5. GRANTOR => grantor of access (may be null) - *
  6. GRANTEE String => grantee of access - *
  7. PRIVILEGE String => name of access (SELECT, - * INSERT, UPDATE, REFRENCES, ...) - *
  8. IS_GRANTABLE String => "YES" if grantee is permitted - * to grant to others; "NO" if not; null if unknown - *
- * - * @param catalog a catalog name; "" retrieves those without a catalog - * @param schema a schema name; "" retrieves those without a schema - * @param table a table name - * @param columnNamePattern a column name pattern - * @return ResultSet each row is a column privilege description - * @see #getSearchStringEscape - */ - public java.sql.ResultSet getColumnPrivileges(String catalog, String schema, String table, String columnNamePattern) throws SQLException - { - Field f[] = new Field[8]; - Vector v = new Vector(); - - if (table == null) - table = "%"; - - if (columnNamePattern == null) - columnNamePattern = "%"; - else - columnNamePattern = columnNamePattern.toLowerCase(); - - f[0] = new Field(connection, "TABLE_CAT", iVarcharOid, 32); - f[1] = new Field(connection, "TABLE_SCHEM", iVarcharOid, 32); - f[2] = new Field(connection, "TABLE_NAME", iVarcharOid, 32); - f[3] = new Field(connection, "COLUMN_NAME", iVarcharOid, 32); - f[4] = new Field(connection, "GRANTOR", iVarcharOid, 32); - f[5] = new Field(connection, "GRANTEE", iVarcharOid, 32); - f[6] = new Field(connection, "PRIVILEGE", iVarcharOid, 32); - f[7] = new Field(connection, "IS_GRANTABLE", iVarcharOid, 32); - - // This is taken direct from the psql source - java.sql.ResultSet r = connection.ExecSQL("SELECT relname, relacl FROM pg_class, pg_user WHERE ( relkind = 'r' OR relkind = 'i') and relname !~ '^pg_' and relname !~ '^xin[vx][0-9]+' and usesysid = relowner and relname like '" + table.toLowerCase() + "' ORDER BY relname"); - while (r.next()) - { - byte[][] tuple = new byte[8][0]; - tuple[0] = tuple[1] = "".getBytes(); - if (Driver.logDebug) Driver.debug("relname=\"" + r.getString(1) + "\" relacl=\"" + r.getString(2) + "\""); - - // For now, don't add to the result as relacl needs to be processed. - //v.addElement(tuple); - } - - return connection.getResultSet(null, f, v, "OK", 1); - } - - /* - * Get a description of the access rights for each table available - * in a catalog. - * - * This method is currently unimplemented. - * - *

Only privileges matching the schema and table name - * criteria are returned. They are ordered by TABLE_SCHEM, - * TABLE_NAME, and PRIVILEGE. - * - *

Each privilige description has the following columns: - *

    - *
  1. TABLE_CAT String => table catalog (may be null) - *
  2. TABLE_SCHEM String => table schema (may be null) - *
  3. TABLE_NAME String => table name - *
  4. COLUMN_NAME String => column name - *
  5. GRANTOR => grantor of access (may be null) - *
  6. GRANTEE String => grantee of access - *
  7. PRIVILEGE String => name of access (SELECT, - * INSERT, UPDATE, REFRENCES, ...) - *
  8. IS_GRANTABLE String => "YES" if grantee is permitted - * to grant to others; "NO" if not; null if unknown - *
- * - * @param catalog a catalog name; "" retrieves those without a catalog - * @param schemaPattern a schema name pattern; "" retrieves those - * without a schema - * @param tableNamePattern a table name pattern - * @return ResultSet each row is a table privilege description - * @see #getSearchStringEscape - */ - public java.sql.ResultSet getTablePrivileges(String catalog, String schemaPattern, String tableNamePattern) throws SQLException - { - Field f[] = new Field[8]; - Vector v = new Vector(); - - if (tableNamePattern == null) - tableNamePattern = "%"; - - f[0] = new Field(connection, "TABLE_CAT", iVarcharOid, 32); - f[1] = new Field(connection, "TABLE_SCHEM", iVarcharOid, 32); - f[2] = new Field(connection, "TABLE_NAME", iVarcharOid, 32); - f[3] = new Field(connection, "COLUMN_NAME", iVarcharOid, 32); - f[4] = new Field(connection, "GRANTOR", iVarcharOid, 32); - f[5] = new Field(connection, "GRANTEE", iVarcharOid, 32); - f[6] = new Field(connection, "PRIVILEGE", iVarcharOid, 32); - f[7] = new Field(connection, "IS_GRANTABLE", iVarcharOid, 32); - - // This is taken direct from the psql source - java.sql.ResultSet r = connection.ExecSQL("SELECT relname, relacl FROM pg_class, pg_user WHERE ( relkind = 'r' OR relkind = 'i') and relname !~ '^pg_' and relname !~ '^xin[vx][0-9]+' and usesysid = relowner and relname like '" + tableNamePattern.toLowerCase() + "' ORDER BY relname"); - while (r.next()) - { - byte[][] tuple = new byte[8][0]; - tuple[0] = tuple[1] = "".getBytes(); - if (Driver.logDebug) Driver.debug("relname=\"" + r.getString(1) + "\" relacl=\"" + r.getString(2) + "\""); - - // For now, don't add to the result as relacl needs to be processed. - //v.addElement(tuple); - } - - return connection.getResultSet(null, f, v, "OK", 1); - } - - /* - * Get a description of a table's optimal set of columns that - * uniquely identifies a row. They are ordered by SCOPE. - * - * This method is currently not implemented. - * - *

Each column description has the following columns: - *

    - *
  1. SCOPE short => actual scope of result - *
      - *
    • bestRowTemporary - very temporary, while using row - *
    • bestRowTransaction - valid for remainder of current transaction - *
    • bestRowSession - valid for remainder of current session - *
    - *
  2. COLUMN_NAME String => column name - *
  3. DATA_TYPE short => SQL data type from java.sql.Types - *
  4. TYPE_NAME String => Data source dependent type name - *
  5. COLUMN_SIZE int => precision - *
  6. BUFFER_LENGTH int => not used - *
  7. DECIMAL_DIGITS short => scale - *
  8. PSEUDO_COLUMN short => is this a pseudo column - * like an Oracle ROWID - *
      - *
    • bestRowUnknown - may or may not be pseudo column - *
    • bestRowNotPseudo - is NOT a pseudo column - *
    • bestRowPseudo - is a pseudo column - *
    - *
- * - * @param catalog a catalog name; "" retrieves those without a catalog - * @param schema a schema name; "" retrieves those without a schema - * @param table a table name - * @param scope the scope of interest; use same values as SCOPE - * @param nullable include columns that are nullable? - * @return ResultSet each row is a column description - */ - // Implementation note: This is required for Borland's JBuilder to work - public java.sql.ResultSet getBestRowIdentifier(String catalog, String schema, String table, int scope, boolean nullable) throws SQLException - { - // for now, this returns an empty result set. - Field f[] = new Field[8]; - ResultSet r; // ResultSet for the SQL query that we need to do - Vector v = new Vector(); // The new ResultSet tuple stuff - - f[0] = new Field(connection, "SCOPE", iInt2Oid, 2); - f[1] = new Field(connection, "COLUMN_NAME", iVarcharOid, 32); - f[2] = new Field(connection, "DATA_TYPE", iInt2Oid, 2); - f[3] = new Field(connection, "TYPE_NAME", iVarcharOid, 32); - f[4] = new Field(connection, "COLUMN_SIZE", iInt4Oid, 4); - f[5] = new Field(connection, "BUFFER_LENGTH", iInt4Oid, 4); - f[6] = new Field(connection, "DECIMAL_DIGITS", iInt2Oid, 2); - f[7] = new Field(connection, "PSEUDO_COLUMN", iInt2Oid, 2); - - return connection.getResultSet(null, f, v, "OK", 1); - } - - /* - * Get a description of a table's columns that are automatically - * updated when any value in a row is updated. They are - * unordered. - * - * This method is currently unimplemented. - * - *

Each column description has the following columns: - *

    - *
  1. SCOPE short => is not used - *
  2. COLUMN_NAME String => column name - *
  3. DATA_TYPE short => SQL data type from java.sql.Types - *
  4. TYPE_NAME String => Data source dependent type name - *
  5. COLUMN_SIZE int => precision - *
  6. BUFFER_LENGTH int => length of column value in bytes - *
  7. DECIMAL_DIGITS short => scale - *
  8. PSEUDO_COLUMN short => is this a pseudo column - * like an Oracle ROWID - *
      - *
    • versionColumnUnknown - may or may not be pseudo column - *
    • versionColumnNotPseudo - is NOT a pseudo column - *
    • versionColumnPseudo - is a pseudo column - *
    - *
- * - * @param catalog a catalog name; "" retrieves those without a catalog - * @param schema a schema name; "" retrieves those without a schema - * @param table a table name - * @return ResultSet each row is a column description - */ - public java.sql.ResultSet getVersionColumns(String catalog, String schema, String table) throws SQLException - { - throw org.postgresql.Driver.notImplemented(); - } - - /* - * Get a description of a table's primary key columns. They - * are ordered by COLUMN_NAME. - * - *

Each column description has the following columns: - *

    - *
  1. TABLE_CAT String => table catalog (may be null) - *
  2. TABLE_SCHEM String => table schema (may be null) - *
  3. TABLE_NAME String => table name - *
  4. COLUMN_NAME String => column name - *
  5. KEY_SEQ short => sequence number within primary key - *
  6. PK_NAME String => primary key name (may be null) - *
- * - * @param catalog a catalog name; "" retrieves those without a catalog - * @param schema a schema name pattern; "" retrieves those - * without a schema - * @param table a table name - * @return ResultSet each row is a primary key column description - */ - public java.sql.ResultSet getPrimaryKeys(String catalog, String schema, String table) throws SQLException - { - return connection.createStatement().executeQuery("SELECT " + - "'' as TABLE_CAT," + - "'' AS TABLE_SCHEM," + - "bc.relname AS TABLE_NAME," + - "a.attname AS COLUMN_NAME," + - "a.attnum as KEY_SEQ," + - "ic.relname as PK_NAME " + - " FROM pg_class bc, pg_class ic, pg_index i, pg_attribute a" + - " WHERE bc.relkind = 'r' " + // -- not indices - " and upper(bc.relname) = upper('" + table + "')" + - " and i.indrelid = bc.oid" + - " and i.indexrelid = ic.oid" + - " and ic.oid = a.attrelid" + - " and i.indisprimary='t' " + - " ORDER BY table_name, pk_name, key_seq" - ); - } -/* - SELECT - c.relname as primary, - c2.relname as foreign, - t.tgconstrname, - ic.relname as fkeyname, - af.attnum as fkeyseq, - ipc.relname as pkeyname, - ap.attnum as pkeyseq, - t.tgdeferrable, - t.tginitdeferred, - t.tgnargs,t.tgargs, - p1.proname as updaterule, - p2.proname as deleterule -FROM - pg_trigger t, - pg_trigger t1, - pg_class c, - pg_class c2, - pg_class ic, - pg_class ipc, - pg_proc p1, - pg_proc p2, - pg_index if, - pg_index ip, - pg_attribute af, - pg_attribute ap -WHERE - (t.tgrelid=c.oid - AND t.tgisconstraint - AND t.tgconstrrelid=c2.oid - AND t.tgfoid=p1.oid - and p1.proname like '%%upd') - - and - (t1.tgrelid=c.oid - and t1.tgisconstraint - and t1.tgconstrrelid=c2.oid - AND t1.tgfoid=p2.oid - and p2.proname like '%%del') - - AND c2.relname='users' - - AND - (if.indrelid=c.oid - AND if.indexrelid=ic.oid - and ic.oid=af.attrelid - AND if.indisprimary) - - and - (ip.indrelid=c2.oid - and ip.indexrelid=ipc.oid - and ipc.oid=ap.attrelid - and ip.indisprimary) - -*/ -/** - * - * @param catalog - * @param schema - * @param primaryTable if provided will get the keys exported by this table - * @param foreignTable if provided will get the keys imported by this table - * @return ResultSet - * @throws SQLException - */ - - private java.sql.ResultSet getImportedExportedKeys(String catalog, String schema, String primaryTable, String foreignTable) throws SQLException - { - Field f[] = new Field[14]; - - f[0] = new Field(connection, "PKTABLE_CAT", iVarcharOid, 32); - f[1] = new Field(connection, "PKTABLE_SCHEM", iVarcharOid, 32); - f[2] = new Field(connection, "PKTABLE_NAME", iVarcharOid, 32); - f[3] = new Field(connection, "PKCOLUMN_NAME", iVarcharOid, 32); - f[4] = new Field(connection, "FKTABLE_CAT", iVarcharOid, 32); - f[5] = new Field(connection, "FKTABLE_SCHEM", iVarcharOid, 32); - f[6] = new Field(connection, "FKTABLE_NAME", iVarcharOid, 32); - f[7] = new Field(connection, "FKCOLUMN_NAME", iVarcharOid, 32); - f[8] = new Field(connection, "KEY_SEQ", iInt2Oid, 2); - f[9] = new Field(connection, "UPDATE_RULE", iInt2Oid, 2); - f[10] = new Field(connection, "DELETE_RULE", iInt2Oid, 2); - f[11] = new Field(connection, "FK_NAME", iVarcharOid, 32); - f[12] = new Field(connection, "PK_NAME", iVarcharOid, 32); - f[13] = new Field(connection, "DEFERRABILITY", iInt2Oid, 2); - - java.sql.ResultSet rs = connection.ExecSQL( - "SELECT distinct " - + "c.relname as prelname, " - + "c2.relname as frelname, " - + "t.tgconstrname, " - + "a.attnum as keyseq, " - + "ic.relname as fkeyname, " - + "t.tgdeferrable, " - + "t.tginitdeferred, " - + "t.tgnargs,t.tgargs, " - + "p1.proname as updaterule, " - + "p2.proname as deleterule " - + "FROM " - + "pg_trigger t, " - + "pg_trigger t1, " - + "pg_class c, " - + "pg_class c2, " - + "pg_class ic, " - + "pg_proc p1, " - + "pg_proc p2, " - + "pg_index i, " - + "pg_attribute a " - + "WHERE " - // isolate the update rule - + "(t.tgrelid=c.oid " - + "AND t.tgisconstraint " - + "AND t.tgconstrrelid=c2.oid " - + "AND t.tgfoid=p1.oid " - + "and p1.proname like '%%upd') " - - + "and " - // isolate the delete rule - + "(t1.tgrelid=c.oid " - + "and t1.tgisconstraint " - + "and t1.tgconstrrelid=c2.oid " - + "AND t1.tgfoid=p2.oid " - + "and p2.proname like '%%del') " - - // if we are looking for exported keys then primary table will be used - + ((primaryTable != null) ? "AND c.relname='" + primaryTable + "' " : "") - - // if we are looking for imported keys then the foreign table will be used - + ((foreignTable != null) ? "AND c2.relname='" + foreignTable + "' " : "") - + "AND i.indrelid=c.oid " - + "AND i.indexrelid=ic.oid " - + "AND ic.oid=a.attrelid " - + "AND i.indisprimary " - + "ORDER BY " - - // orderby is as follows getExported, orders by FKTABLE, - // getImported orders by PKTABLE - // getCrossReference orders by FKTABLE, so this should work for both, - // since when getting crossreference, primaryTable will be defined - - + (primaryTable != null ? "frelname" : "prelname") + ",keyseq"); - -// returns the following columns -// and some example data with a table defined as follows - -// create table people ( id int primary key); -// create table policy ( id int primary key); -// create table users ( id int primary key, people_id int references people(id), policy_id int references policy(id)) - -// prelname | frelname | tgconstrname | keyseq | fkeyName | tgdeferrable | tginitdeferred -// 1 | 2 | 3 | 4 | 5 | 6 | 7 - -// people | users | | 1 | people_pkey | f | f - -// | tgnargs | tgargs | updaterule | deleterule -// | 8 | 9 | 10 | 11 -// | 6 | \000users\000people\000UNSPECIFIED\000people_id\000id\000 | RI_FKey_noaction_upd | RI_FKey_noaction_del - - Vector tuples = new Vector(); - - - while ( rs.next() ) - { - byte tuple[][] = new byte[14][]; - - tuple[2] = rs.getBytes(1); //PKTABLE_NAME - tuple[6] = rs.getBytes(2); //FKTABLE_NAME - String fKeyName = rs.getString(3); - String updateRule = rs.getString(10); - - if (updateRule != null ) - { - // Rules look like this RI_FKey_noaction_del so we want to pull out the part between the 'Key_' and the last '_' s - - String rule = updateRule.substring(8, updateRule.length() - 4); - - int action = java.sql.DatabaseMetaData.importedKeyNoAction; - - if ( rule == null || "noaction".equals(rule) ) - action = java.sql.DatabaseMetaData.importedKeyNoAction; - if ("cascade".equals(rule)) - action = java.sql.DatabaseMetaData.importedKeyCascade; - else if ("setnull".equals(rule)) - action = java.sql.DatabaseMetaData.importedKeySetNull; - else if ("setdefault".equals(rule)) - action = java.sql.DatabaseMetaData.importedKeySetDefault; - else if ("restrict".equals(rule)) - action = java.sql.DatabaseMetaData.importedKeyRestrict; - - tuple[9] = Integer.toString(action).getBytes(); - - } - - String deleteRule = rs.getString(11); - - if ( deleteRule != null ) - { - - String rule = updateRule.substring(8, updateRule.length() - 4); - - int action = java.sql.DatabaseMetaData.importedKeyNoAction; - if ("cascade".equals(rule)) - action = java.sql.DatabaseMetaData.importedKeyCascade; - else if ("setnull".equals(rule)) - action = java.sql.DatabaseMetaData.importedKeySetNull; - else if ("setdefault".equals(rule)) - action = java.sql.DatabaseMetaData.importedKeySetDefault; - tuple[10] = Integer.toString(action).getBytes(); - } - - - // Parse the tgargs data - String fkeyColumn=""; - String pkeyColumn=""; - - - // Note, I am guessing at most of this, but it should be close - // if not, please correct - // the keys are in pairs and start after the first four arguments - // the arguments are seperated by \000 - - int keySequence = rs.getInt(4); //KEY_SEQ - - // get the args - String targs = rs.getString(9); - - // args look like this - //\000ww\000vv\000UNSPECIFIED\000m\000a\000n\000b\000 - // we are primarily interested in the column names which are the last items in the string - - StringTokenizer st = new StringTokenizer(targs, "\\000"); - - int advance = 4 + (keySequence-1) * 2; - for( int i=0; st.hasMoreTokens() && i < advance ; i++ ) st.nextToken(); // advance to the key column of interest - - if ( st.hasMoreTokens() ) - { - fkeyColumn = st.nextToken(); - } - if ( st.hasMoreTokens() ) - { - pkeyColumn = st.nextToken(); - } - - tuple[3] = pkeyColumn.getBytes(); //PKCOLUMN_NAME - tuple[7] = fkeyColumn.getBytes(); //FKCOLUMN_NAME - - tuple[8] = rs.getBytes(4); //KEY_SEQ - tuple[11] = rs.getBytes(3); //FK_NAME - tuple[12] = rs.getBytes(5); //PK_NAME - - // DEFERRABILITY - int deferrability = java.sql.DatabaseMetaData.importedKeyNotDeferrable; - boolean deferrable = rs.getBoolean(6); - boolean initiallyDeferred = rs.getBoolean(7); - if (deferrable) - { - if (initiallyDeferred) - deferrability = java.sql.DatabaseMetaData.importedKeyInitiallyDeferred; - else - deferrability = java.sql.DatabaseMetaData.importedKeyInitiallyImmediate; - } - tuple[13] = Integer.toString(deferrability).getBytes(); - - tuples.addElement(tuple); - } - - return connection.getResultSet(null, f, tuples, "OK", 1); - } - - /* - * Get a description of the primary key columns that are - * referenced by a table's foreign key columns (the primary keys - * imported by a table). They are ordered by PKTABLE_CAT, - * PKTABLE_SCHEM, PKTABLE_NAME, and KEY_SEQ. - * - *

Each primary key column description has the following columns: - *

    - *
  1. PKTABLE_CAT String => primary key table catalog - * being imported (may be null) - *
  2. PKTABLE_SCHEM String => primary key table schema - * being imported (may be null) - *
  3. PKTABLE_NAME String => primary key table name - * being imported - *
  4. PKCOLUMN_NAME String => primary key column name - * being imported - *
  5. FKTABLE_CAT String => foreign key table catalog (may be null) - *
  6. FKTABLE_SCHEM String => foreign key table schema (may be null) - *
  7. FKTABLE_NAME String => foreign key table name - *
  8. FKCOLUMN_NAME String => foreign key column name - *
  9. KEY_SEQ short => sequence number within foreign key - *
  10. UPDATE_RULE short => What happens to - * foreign key when primary is updated: - *
      - *
    • importedKeyCascade - change imported key to agree - * with primary key update - *
    • importedKeyRestrict - do not allow update of primary - * key if it has been imported - *
    • importedKeySetNull - change imported key to NULL if - * its primary key has been updated - *
    - *
  11. DELETE_RULE short => What happens to - * the foreign key when primary is deleted. - *
      - *
    • importedKeyCascade - delete rows that import a deleted key - *
    • importedKeyRestrict - do not allow delete of primary - * key if it has been imported - *
    • importedKeySetNull - change imported key to NULL if - * its primary key has been deleted - *
    - *
  12. FK_NAME String => foreign key name (may be null) - *
  13. PK_NAME String => primary key name (may be null) - *
- * - * @param catalog a catalog name; "" retrieves those without a catalog - * @param schema a schema name pattern; "" retrieves those - * without a schema - * @param table a table name - * @return ResultSet each row is a primary key column description - * @see #getExportedKeys - */ - public java.sql.ResultSet getImportedKeys(String catalog, String schema, String table) throws SQLException - { - return getImportedExportedKeys(catalog, schema, null, table); - } - - /* - * Get a description of a foreign key columns that reference a - * table's primary key columns (the foreign keys exported by a - * table). They are ordered by FKTABLE_CAT, FKTABLE_SCHEM, - * FKTABLE_NAME, and KEY_SEQ. - * - * This method is currently unimplemented. - * - *

Each foreign key column description has the following columns: - *

    - *
  1. PKTABLE_CAT String => primary key table catalog (may be null) - *
  2. PKTABLE_SCHEM String => primary key table schema (may be null) - *
  3. PKTABLE_NAME String => primary key table name - *
  4. PKCOLUMN_NAME String => primary key column name - *
  5. FKTABLE_CAT String => foreign key table catalog (may be null) - * being exported (may be null) - *
  6. FKTABLE_SCHEM String => foreign key table schema (may be null) - * being exported (may be null) - *
  7. FKTABLE_NAME String => foreign key table name - * being exported - *
  8. FKCOLUMN_NAME String => foreign key column name - * being exported - *
  9. KEY_SEQ short => sequence number within foreign key - *
  10. UPDATE_RULE short => What happens to - * foreign key when primary is updated: - *
      - *
    • importedKeyCascade - change imported key to agree - * with primary key update - *
    • importedKeyRestrict - do not allow update of primary - * key if it has been imported - *
    • importedKeySetNull - change imported key to NULL if - * its primary key has been updated - *
    - *
  11. DELETE_RULE short => What happens to - * the foreign key when primary is deleted. - *
      - *
    • importedKeyCascade - delete rows that import a deleted key - *
    • importedKeyRestrict - do not allow delete of primary - * key if it has been imported - *
    • importedKeySetNull - change imported key to NULL if - * its primary key has been deleted - *
    - *
  12. FK_NAME String => foreign key identifier (may be null) - *
  13. PK_NAME String => primary key identifier (may be null) - *
- * - * @param catalog a catalog name; "" retrieves those without a catalog - * @param schema a schema name pattern; "" retrieves those - * without a schema - * @param table a table name - * @return ResultSet each row is a foreign key column description - * @see #getImportedKeys - */ - public java.sql.ResultSet getExportedKeys(String catalog, String schema, String table) throws SQLException - { - return getImportedExportedKeys(catalog, schema, table, null); - } - - /* - * Get a description of the foreign key columns in the foreign key - * table that reference the primary key columns of the primary key - * table (describe how one table imports another's key.) This - * should normally return a single foreign key/primary key pair - * (most tables only import a foreign key from a table once.) They - * are ordered by FKTABLE_CAT, FKTABLE_SCHEM, FKTABLE_NAME, and - * KEY_SEQ. - * - * This method is currently unimplemented. - * - *

Each foreign key column description has the following columns: - *

    - *
  1. PKTABLE_CAT String => primary key table catalog (may be null) - *
  2. PKTABLE_SCHEM String => primary key table schema (may be null) - *
  3. PKTABLE_NAME String => primary key table name - *
  4. PKCOLUMN_NAME String => primary key column name - *
  5. FKTABLE_CAT String => foreign key table catalog (may be null) - * being exported (may be null) - *
  6. FKTABLE_SCHEM String => foreign key table schema (may be null) - * being exported (may be null) - *
  7. FKTABLE_NAME String => foreign key table name - * being exported - *
  8. FKCOLUMN_NAME String => foreign key column name - * being exported - *
  9. KEY_SEQ short => sequence number within foreign key - *
  10. UPDATE_RULE short => What happens to - * foreign key when primary is updated: - *
      - *
    • importedKeyCascade - change imported key to agree - * with primary key update - *
    • importedKeyRestrict - do not allow update of primary - * key if it has been imported - *
    • importedKeySetNull - change imported key to NULL if - * its primary key has been updated - *
    - *
  11. DELETE_RULE short => What happens to - * the foreign key when primary is deleted. - *
      - *
    • importedKeyCascade - delete rows that import a deleted key - *
    • importedKeyRestrict - do not allow delete of primary - * key if it has been imported - *
    • importedKeySetNull - change imported key to NULL if - * its primary key has been deleted - *
    - *
  12. FK_NAME String => foreign key identifier (may be null) - *
  13. PK_NAME String => primary key identifier (may be null) - *
- * - * @param catalog a catalog name; "" retrieves those without a catalog - * @param schema a schema name pattern; "" retrieves those - * without a schema - * @param table a table name - * @return ResultSet each row is a foreign key column description - * @see #getImportedKeys - */ - public java.sql.ResultSet getCrossReference(String primaryCatalog, String primarySchema, String primaryTable, String foreignCatalog, String foreignSchema, String foreignTable) throws SQLException - { - return getImportedExportedKeys(primaryCatalog, primarySchema, primaryTable, foreignTable); - } - - /* - * Get a description of all the standard SQL types supported by - * this database. They are ordered by DATA_TYPE and then by how - * closely the data type maps to the corresponding JDBC SQL type. - * - *

Each type description has the following columns: - *

    - *
  1. TYPE_NAME String => Type name - *
  2. DATA_TYPE short => SQL data type from java.sql.Types - *
  3. PRECISION int => maximum precision - *
  4. LITERAL_PREFIX String => prefix used to quote a literal - * (may be null) - *
  5. LITERAL_SUFFIX String => suffix used to quote a literal - (may be null) - *
  6. CREATE_PARAMS String => parameters used in creating - * the type (may be null) - *
  7. NULLABLE short => can you use NULL for this type? - *
      - *
    • typeNoNulls - does not allow NULL values - *
    • typeNullable - allows NULL values - *
    • typeNullableUnknown - nullability unknown - *
    - *
  8. CASE_SENSITIVE boolean=> is it case sensitive? - *
  9. SEARCHABLE short => can you use "WHERE" based on this type: - *
      - *
    • typePredNone - No support - *
    • typePredChar - Only supported with WHERE .. LIKE - *
    • typePredBasic - Supported except for WHERE .. LIKE - *
    • typeSearchable - Supported for all WHERE .. - *
    - *
  10. UNSIGNED_ATTRIBUTE boolean => is it unsigned? - *
  11. FIXED_PREC_SCALE boolean => can it be a money value? - *
  12. AUTO_INCREMENT boolean => can it be used for an - * auto-increment value? - *
  13. LOCAL_TYPE_NAME String => localized version of type name - * (may be null) - *
  14. MINIMUM_SCALE short => minimum scale supported - *
  15. MAXIMUM_SCALE short => maximum scale supported - *
  16. SQL_DATA_TYPE int => unused - *
  17. SQL_DATETIME_SUB int => unused - *
  18. NUM_PREC_RADIX int => usually 2 or 10 - *
- * - * @return ResultSet each row is a SQL type description - */ - public java.sql.ResultSet getTypeInfo() throws SQLException - { - java.sql.ResultSet rs = connection.ExecSQL("select typname from pg_type"); - if (rs != null) - { - Field f[] = new Field[18]; - ResultSet r; // ResultSet for the SQL query that we need to do - Vector v = new Vector(); // The new ResultSet tuple stuff - - f[0] = new Field(connection, "TYPE_NAME", iVarcharOid, 32); - f[1] = new Field(connection, "DATA_TYPE", iInt2Oid, 2); - f[2] = new Field(connection, "PRECISION", iInt4Oid, 4); - f[3] = new Field(connection, "LITERAL_PREFIX", iVarcharOid, 32); - f[4] = new Field(connection, "LITERAL_SUFFIX", iVarcharOid, 32); - f[5] = new Field(connection, "CREATE_PARAMS", iVarcharOid, 32); - f[6] = new Field(connection, "NULLABLE", iInt2Oid, 2); - f[7] = new Field(connection, "CASE_SENSITIVE", iBoolOid, 1); - f[8] = new Field(connection, "SEARCHABLE", iInt2Oid, 2); - f[9] = new Field(connection, "UNSIGNED_ATTRIBUTE", iBoolOid, 1); - f[10] = new Field(connection, "FIXED_PREC_SCALE", iBoolOid, 1); - f[11] = new Field(connection, "AUTO_INCREMENT", iBoolOid, 1); - f[12] = new Field(connection, "LOCAL_TYPE_NAME", iVarcharOid, 32); - f[13] = new Field(connection, "MINIMUM_SCALE", iInt2Oid, 2); - f[14] = new Field(connection, "MAXIMUM_SCALE", iInt2Oid, 2); - f[15] = new Field(connection, "SQL_DATA_TYPE", iInt4Oid, 4); - f[16] = new Field(connection, "SQL_DATETIME_SUB", iInt4Oid, 4); - f[17] = new Field(connection, "NUM_PREC_RADIX", iInt4Oid, 4); - - // cache some results, this will keep memory useage down, and speed - // things up a little. - byte b9[] = "9".getBytes(); - byte b10[] = "10".getBytes(); - byte bf[] = "f".getBytes(); - byte bnn[] = Integer.toString(java.sql.DatabaseMetaData.typeNoNulls).getBytes(); - byte bts[] = Integer.toString(java.sql.DatabaseMetaData.typeSearchable).getBytes(); - - while (rs.next()) - { - byte[][] tuple = new byte[18][]; - String typname = rs.getString(1); - tuple[0] = typname.getBytes(); - tuple[1] = Integer.toString(connection.getSQLType(typname)).getBytes(); - tuple[2] = b9; // for now - tuple[6] = bnn; // for now - tuple[7] = bf; // false for now - not case sensitive - tuple[8] = bts; - tuple[9] = bf; // false for now - it's signed - tuple[10] = bf; // false for now - must handle money - tuple[11] = bf; // false for now - handle autoincrement - // 12 - LOCAL_TYPE_NAME is null - // 13 & 14 ? - // 15 & 16 are unused so we return null - tuple[17] = b10; // everything is base 10 - v.addElement(tuple); - } - rs.close(); - return connection.getResultSet(null, f, v, "OK", 1); - } - - throw new PSQLException("postgresql.metadata.unavailable"); - } - - /* - * Get a description of a table's indices and statistics. They are - * ordered by NON_UNIQUE, TYPE, INDEX_NAME, and ORDINAL_POSITION. - * - *

Each index column description has the following columns: - *

    - *
  1. TABLE_CAT String => table catalog (may be null) - *
  2. TABLE_SCHEM String => table schema (may be null) - *
  3. TABLE_NAME String => table name - *
  4. NON_UNIQUE boolean => Can index values be non-unique? - * false when TYPE is tableIndexStatistic - *
  5. INDEX_QUALIFIER String => index catalog (may be null); - * null when TYPE is tableIndexStatistic - *
  6. INDEX_NAME String => index name; null when TYPE is - * tableIndexStatistic - *
  7. TYPE short => index type: - *
      - *
    • tableIndexStatistic - this identifies table statistics that are - * returned in conjuction with a table's index descriptions - *
    • tableIndexClustered - this is a clustered index - *
    • tableIndexHashed - this is a hashed index - *
    • tableIndexOther - this is some other style of index - *
    - *
  8. ORDINAL_POSITION short => column sequence number - * within index; zero when TYPE is tableIndexStatistic - *
  9. COLUMN_NAME String => column name; null when TYPE is - * tableIndexStatistic - *
  10. ASC_OR_DESC String => column sort sequence, "A" => ascending - * "D" => descending, may be null if sort sequence is not supported; - * null when TYPE is tableIndexStatistic - *
  11. CARDINALITY int => When TYPE is tableIndexStatisic then - * this is the number of rows in the table; otherwise it is the - * number of unique values in the index. - *
  12. PAGES int => When TYPE is tableIndexStatisic then - * this is the number of pages used for the table, otherwise it - * is the number of pages used for the current index. - *
  13. FILTER_CONDITION String => Filter condition, if any. - * (may be null) - *
- * - * @param catalog a catalog name; "" retrieves those without a catalog - * @param schema a schema name pattern; "" retrieves those without a schema - * @param table a table name - * @param unique when true, return only indices for unique values; - * when false, return indices regardless of whether unique or not - * @param approximate when true, result is allowed to reflect approximate - * or out of data values; when false, results are requested to be - * accurate - * @return ResultSet each row is an index column description - */ - // Implementation note: This is required for Borland's JBuilder to work - public java.sql.ResultSet getIndexInfo(String catalog, String schema, String tableName, boolean unique, boolean approximate) throws SQLException - { - Field f[] = new Field[13]; - java.sql.ResultSet r; // ResultSet for the SQL query that we need to do - Vector v = new Vector(); // The new ResultSet tuple stuff - - f[0] = new Field(connection, "TABLE_CAT", iVarcharOid, 32); - f[1] = new Field(connection, "TABLE_SCHEM", iVarcharOid, 32); - f[2] = new Field(connection, "TABLE_NAME", iVarcharOid, 32); - f[3] = new Field(connection, "NON_UNIQUE", iBoolOid, 1); - f[4] = new Field(connection, "INDEX_QUALIFIER", iVarcharOid, 32); - f[5] = new Field(connection, "INDEX_NAME", iVarcharOid, 32); - f[6] = new Field(connection, "TYPE", iInt2Oid, 2); - f[7] = new Field(connection, "ORDINAL_POSITION", iInt2Oid, 2); - f[8] = new Field(connection, "COLUMN_NAME", iVarcharOid, 32); - f[9] = new Field(connection, "ASC_OR_DESC", iVarcharOid, 32); - f[10] = new Field(connection, "CARDINALITY", iInt4Oid, 4); - f[11] = new Field(connection, "PAGES", iInt4Oid, 4); - f[12] = new Field(connection, "FILTER_CONDITION", iVarcharOid, 32); - - r = connection.ExecSQL("select " + - "c.relname, " + - "x.indisunique, " + - "i.relname, " + - "x.indisclustered, " + - "a.amname, " + - "x.indkey, " + - "c.reltuples, " + - "c.relpages, " + - "x.indexrelid " + - "FROM pg_index x, pg_class c, pg_class i, pg_am a " + - "WHERE ((c.relname = '" + tableName.toLowerCase() + "') " + - " AND (c.oid = x.indrelid) " + - " AND (i.oid = x.indexrelid) " + - " AND (i.relam = a.oid)) " + - "ORDER BY x.indisunique DESC, " + - " x.indisclustered, a.amname, i.relname"); - while (r.next()) - { - // indkey is an array of column ordinals (integers). In the JDBC - // interface, this has to be separated out into a separate - // tuple for each indexed column. Also, getArray() is not yet - // implemented for Postgres JDBC, so we parse by hand. - String columnOrdinalString = r.getString(6); - StringTokenizer stok = new StringTokenizer(columnOrdinalString); - int [] columnOrdinals = new int[stok.countTokens()]; - int o = 0; - while (stok.hasMoreTokens()) - { - columnOrdinals[o++] = Integer.parseInt(stok.nextToken()); - } - - java.sql.ResultSet columnNameRS = connection.ExecSQL("select a.attname FROM pg_attribute a WHERE a.attrelid = " + r.getInt(9)); - for (int i = 0; i < columnOrdinals.length; i++) - { - byte [] [] tuple = new byte [13] []; - tuple[0] = "".getBytes(); - tuple[1] = "".getBytes(); - tuple[2] = r.getBytes(1); - tuple[3] = r.getBoolean(2) ? "false".getBytes() : "true".getBytes(); - tuple[4] = null; - tuple[5] = r.getBytes(3); - tuple[6] = r.getBoolean(4) ? - Integer.toString(java.sql.DatabaseMetaData.tableIndexClustered).getBytes() : - r.getString(5).equals("hash") ? - Integer.toString(java.sql.DatabaseMetaData.tableIndexHashed).getBytes() : - Integer.toString(java.sql.DatabaseMetaData.tableIndexOther).getBytes(); - tuple[7] = Integer.toString(i + 1).getBytes(); - if (columnNameRS.next()) - tuple[8] = columnNameRS.getBytes(1); - else - tuple[8] = "".getBytes(); - - tuple[9] = null; // sort sequence ??? - tuple[10] = r.getBytes(7); // inexact - tuple[11] = r.getBytes(8); - tuple[12] = null; - v.addElement(tuple); - } - } - - return connection.getResultSet(null, f, v, "OK", 1); - } // ** JDBC 2 Extensions ** @@ -3161,10 +116,10 @@ WHERE * Return user defined types in a schema */ public java.sql.ResultSet getUDTs(String catalog, - String schemaPattern, - String typeNamePattern, - int[] types - ) throws SQLException + String schemaPattern, + String typeNamePattern, + int[] types + ) throws SQLException { throw org.postgresql.Driver.notImplemented(); }