From dedc053252160d78043a51096438938b275088bd Mon Sep 17 00:00:00 2001 From: Julien Nabet Date: Wed, 23 Oct 2024 12:07:04 +0200 Subject: Following 250e00a51dcf60ac2e028983f5d29c0f68748b38 (JDBC4.3) Change-Id: I08b71b9c0504af7ed4af84456ce49dc2fe7274af Reviewed-on: https://gerrit.libreoffice.org/c/core/+/175472 Tested-by: Julien Nabet Reviewed-by: Julien Nabet Tested-by: Jenkins --- offapi/com/sun/star/sdbc/XDatabaseMetaData3.idl | 38 ++++++++++++------------- 1 file changed, 19 insertions(+), 19 deletions(-) (limited to 'offapi/com') diff --git a/offapi/com/sun/star/sdbc/XDatabaseMetaData3.idl b/offapi/com/sun/star/sdbc/XDatabaseMetaData3.idl index 43c34b4e0cc6..1f92bc754881 100644 --- a/offapi/com/sun/star/sdbc/XDatabaseMetaData3.idl +++ b/offapi/com/sun/star/sdbc/XDatabaseMetaData3.idl @@ -56,7 +56,7 @@ interface XDatabaseMetaData3 : XDatabaseMetaData2 *
  • TYPE_SCHEM String {@code =>} type schema (may be {@code null}) *
  • TYPE_NAME String {@code =>} type name *
  • ATTR_NAME String {@code =>} attribute name - *
  • DATA_TYPE int {@code =>} attribute type SQL type from java.sql.Types + *
  • DATA_TYPE int {@code =>} attribute type SQL type from com::sun::star::sdbc::DataType *
  • ATTR_TYPE_NAME String {@code =>} Data source dependent type name. * For a UDT, the type name is fully qualified. For a REF, the type name is * fully qualified and represents the target type of the reference type. @@ -95,7 +95,7 @@ interface XDatabaseMetaData3 : XDatabaseMetaData2 *
  • SCOPE_TABLE String {@code =>} table name that is the scope of a * reference attribute ({@code null} if the DATA_TYPE isn't REF) *
  • SOURCE_DATA_TYPE short {@code =>} source type of a distinct type or user-generated - * Ref type, SQL type from java.sql.Types ({@code null} if DATA_TYPE + * Ref type, SQL type from com::sun::star::sdbc::DataType ({@code null} if DATA_TYPE * isn't DISTINCT or user-generated REF) * * @param catalog a catalog name; must match the catalog name as it @@ -235,7 +235,7 @@ interface XDatabaseMetaData3 : XDatabaseMetaData2 *
  • functionColumnResult - Indicates that the parameter or column * is a column in the {@code ResultSet} * - *
  • DATA_TYPE int {@code =>} SQL type from java.sql.Types + *
  • DATA_TYPE int {@code =>} SQL type from com::sun::star::sdbc::DataType *
  • TYPE_NAME String {@code =>} SQL type name, for a UDT type the * type name is fully qualified *
  • PRECISION int {@code =>} precision @@ -332,7 +332,7 @@ interface XDatabaseMetaData3 : XDatabaseMetaData2 *
  • TABLE_SCHEM String {@code =>} table schema (may be {@code null}) *
  • TABLE_NAME String {@code =>} table name *
  • COLUMN_NAME String {@code =>} column name - *
  • DATA_TYPE int {@code =>} SQL type from java.sql.Types + *
  • DATA_TYPE int {@code =>} SQL type from com::sun::star::sdbc::DataType *
  • COLUMN_SIZE int {@code =>} column size. *
  • DECIMAL_DIGITS int {@code =>} the number of fractional digits. Null is returned for data types where * DECIMAL_DIGITS is not applicable. @@ -406,18 +406,19 @@ interface XDatabaseMetaData3 : XDatabaseMetaData2 *
  • TABLE_CATALOG String {@code =>} catalog name (may be {@code null}) * * - * - * @param catalog a catalog name; must match the catalog name as it is stored - * in the database;"" retrieves those without a catalog; null means catalog - * name should not be used to narrow down the search. - * @param schemaPattern a schema name; must match the schema name as it is - * stored in the database; null means - * schema name should not be used to narrow down the search. + * @param catalog an optional catalog name; + * if absent (catalog.IsPresent is false), catalog name is not used to narrow down the search. + * if present, then only the results for which catalog.Value matches the catalog name as it + * is stored in the database; + * Note that catalog.IsPresent and catalog.Value == "" retrieves those without a catalog + * @param schemaPattern a optional schema name; + * if absent means it should not be used to narrow down the search + * if present, must match the schema name as it is stored in the database * @return a {@code ResultSet} object in which each row is a * schema description * @throws SQLException if a database access error occurs */ - XResultSet getSchemasFiltered([in]string catalog, [in]string schemaPattern) raises (SQLException); + XResultSet getSchemasFiltered([in] com::sun::star::beans::Optional catalog, [in] com::sun::star::beans::Optional schemaPattern) raises (SQLException); /** * Indicates whether the SQLSTATE returned by {@code SQLException.getSQLState} @@ -513,13 +514,12 @@ interface XDatabaseMetaData3 : XDatabaseMetaData2 */ boolean locatorsUpdateCopy() raises (SQLException); - /** `TRUE` - , if the Database supports the CONVERT between the given SQL types - otherwise `FALSE` in general (see supportsConvert for specific fromType and toType). - @returns - `TRUE` if so - @throws SQLException - if a database access error occurs. + /** + * Retrieves whether this database supports the SQL function CONVERT for the conversion + * between the data types defined in com::sun::star::sdbc::DataType + * (see supportsConvert in com::sun::star::sdbc::XDatabaseMetadata to test for support between specific types) + * @return true if so; false otherwise + * @throws SQLException if a database access error occurs. */ boolean supportsConvertInGeneral() raises (SQLException); -- cgit