GH-46465: [C++][FlightRPC] Refactor ODBC namespaces and file structure (#47703)

### Rationale for this change
Closes #46465.

### What changes are included in this PR?
Multiple `utils` files have been merged into a single `util.cc/h`.
The project/subdirectory `flight_sql` has been renamed to `odbc_impl`.
The project/subdirectory `odbcabstraction` is removed and its files have been moved to `odbc_impl`.
Header files inside `include` directories have been relocated to the same directory as their implementation files.

### Are these changes tested?
N/A

### Are there any user-facing changes?
No
* GitHub Issue: #46465

Authored-by: justing-bq <[email protected]>
Signed-off-by: David Li <[email protected]>

Author: justing-bq

cpp/src/arrow/flight/sql/odbc/CMakeLists.txt

@@ -33,8 +33,7 @@ else()
   set(ODBCINST odbcinst)
 endif()
 
-add_subdirectory(flight_sql)
-add_subdirectory(odbcabstraction)
+add_subdirectory(odbc_impl)
 
 arrow_install_all_headers("arrow/flight/sql/odbc")
 
@@ -70,7 +69,6 @@ add_arrow_lib(arrow_flight_sql_odbc
               SHARED_PRIVATE_LINK_LIBS
               ODBC::ODBC
               ${ODBCINST}
-              odbcabstraction
               arrow_odbc_spi_impl)
 
 foreach(LIB_TARGET ${ARROW_FLIGHT_SQL_ODBC_LIBRARIES})

cpp/src/arrow/flight/sql/odbc/entry_points.cc

@@ -16,7 +16,7 @@
 // under the License.
 
 // platform.h includes windows.h, so it needs to be included first
-#include "arrow/flight/sql/odbc/odbcabstraction/include/odbcabstraction/platform.h"
+#include "arrow/flight/sql/odbc/odbc_impl/platform.h"
 
 #include <sql.h>
 #include <sqlext.h>
@@ -26,10 +26,10 @@
 #include "arrow/flight/sql/odbc/odbc_api_internal.h"
 #include "arrow/flight/sql/odbc/visibility.h"
 
-#include "arrow/flight/sql/odbc/odbcabstraction/include/odbcabstraction/odbc_impl/odbc_connection.h"
-#include "arrow/flight/sql/odbc/odbcabstraction/include/odbcabstraction/odbc_impl/odbc_descriptor.h"
-#include "arrow/flight/sql/odbc/odbcabstraction/include/odbcabstraction/odbc_impl/odbc_environment.h"
-#include "arrow/flight/sql/odbc/odbcabstraction/include/odbcabstraction/odbc_impl/odbc_statement.h"
+#include "arrow/flight/sql/odbc/odbc_impl/odbc_connection.h"
+#include "arrow/flight/sql/odbc/odbc_impl/odbc_descriptor.h"
+#include "arrow/flight/sql/odbc/odbc_impl/odbc_environment.h"
+#include "arrow/flight/sql/odbc/odbc_impl/odbc_statement.h"
 
 #include "arrow/util/logging.h"
 
@@ -191,8 +191,8 @@ SQLRETURN SQL_API SQLBindCol(SQLHSTMT stmt, SQLUSMALLINT record_number,
 SQLRETURN SQL_API SQLCancel(SQLHSTMT stmt) {
   ARROW_LOG(DEBUG) << "SQLCancel called with stmt: " << stmt;
   return ODBC::ODBCStatement::ExecuteWithDiagnostics(stmt, SQL_ERROR, [=]() {
-    throw driver::odbcabstraction::DriverException("SQLCancel is not implemented",
-                                                   "IM001");
+    throw arrow::flight::sql::odbc::DriverException("SQLCancel is not implemented",
+                                                    "IM001");
     return SQL_ERROR;
   });
 }
@@ -252,8 +252,8 @@ SQLRETURN SQL_API SQLForeignKeys(
                    << ", fk_table_name: " << static_cast<const void*>(fk_table_name)
                    << ", fk_table_name_length: " << fk_table_name_length;
   return ODBC::ODBCStatement::ExecuteWithDiagnostics(stmt, SQL_ERROR, [=]() {
-    throw driver::odbcabstraction::DriverException("SQLForeignKeysW is not implemented",
-                                                   "IM001");
+    throw arrow::flight::sql::odbc::DriverException("SQLForeignKeysW is not implemented",
+                                                    "IM001");
     return SQL_ERROR;
   });
 }
@@ -295,8 +295,8 @@ SQLRETURN SQL_API SQLPrimaryKeys(SQLHSTMT stmt, SQLWCHAR* catalog_name,
                    << ", table_name: " << static_cast<const void*>(table_name)
                    << ", table_name_length: " << table_name_length;
   return ODBC::ODBCStatement::ExecuteWithDiagnostics(stmt, SQL_ERROR, [=]() {
-    throw driver::odbcabstraction::DriverException("SQLPrimaryKeysW is not implemented",
-                                                   "IM001");
+    throw arrow::flight::sql::odbc::DriverException("SQLPrimaryKeysW is not implemented",
+                                                    "IM001");
     return SQL_ERROR;
   });
 }