feat(bigquery-jdbc): implement PreparedStatement ParameterMetaData and Calendar date setters

[Neenu1995]

b/535194644

• ParameterMetaData Support: Implemented BigQueryParameterMetaData (java.sql.ParameterMetaData) to support parameter count, type mappings, nullability, and dynamic parameter modes (IN/OUT/INOUT).
• PreparedStatement Setters: Added Calendar-aware temporal setters (setDate, setTime, setTimestamp), setObject support for java.time types (LocalDate, LocalTime, LocalDateTime, Instant), and missing setter overloads (setShort, setBytes, setArray, setNull).
• Unified Timezone Coercions: Centralized Calendar-based temporal conversions in BigQueryTypeCoercionUtility, optimized with java.time APIs for zero-allocation wall-clock field extraction and defensive Calendar cloning.

[gemini-code-assist]

Code Review

This pull request enhances the BigQuery JDBC driver by implementing missing parameter setter methods in BigQueryPreparedStatement, adding BigQueryParameterMetaData support, and updating type mappings to include SMALLINT, TINYINT, and NULL types. The reviewer correctly identified that the setDate, setTime, and setTimestamp methods with Calendar overloads modify the provided Calendar object in-place, which is an unexpected side effect for callers. It is recommended to clone the Calendar object before performing modifications to ensure the original object remains unchanged.

[Neenu1995]

/gemini review

[gemini-code-assist]

Code Review

This pull request implements ParameterMetaData support, adds metadata retrieval for BigQueryPreparedStatement, and introduces support for Java 8 java.time classes alongside timezone-aware conversions using Calendar overloads. The reviewer feedback suggests adding a defensive null check for parameterHandler in BigQueryParameterMetaData to prevent a potential NullPointerException, and optimizing the timezone conversion utility methods by replacing expensive Calendar.getInstance() calls with Java 8 java.time classes.