GH-38369: [MATLAB] Create utility functions for simplifying management of Proxy instances for Arrays

[sgilmore10]

Rationale for this change

This is a follow up to #38357 (comment).

In the C++ code for the MATLAB interface, we frequently wrap/unwrap Arrow types, like arrow::Array, into/from a corresponding libmexclass Proxy objects. This currently takes several lines of code, leading to lots of code duplication and introduces room for subtle implementation errors.

It would be helpful to abstract away some of the steps involved in Proxy creation/management into a set of helper utilities that we can reuse in the C++ code for the MATLAB interface.

What changes are included in this PR?

1. Added a new utility function that wraps a std::shared_ptr<arrow::Array> in a std::shared_ptr<arrow::matlab::array::proxy::Array>. Its function signature is

arrow::Result<std::shared_ptr<arrow::matlab::array::proxy::Array>> wrap(const std::shared_ptr<arrow::Array>& array);`

2. Added a new utility function that wraps a std::shared_ptr<arrow::Array> in a std::shared_ptr<arrow::matlab::array::proxy::Array> and adds the proxy to the libmexclass::proxy::ProxyManager. Its function signature is

arrow::Result<std::shared_ptr<arrow::matlab::array::proxy::Array>> wrap_and_manage(const std::shared_ptr<arrow::Array>& array);

3. Added a new utility function that wraps a std::shared_ptr<arrow::DataType> in a std::shared_ptr<arrow::matlab::type::proxy::Type>. Its function signature is

arrow::Result<std::shared_ptr<arrow::matlab::type::proxy::Type>> wrap(const std::shared_ptr<arrow::DataType>& type);

4. Added a new utility function that wraps a std::shared_ptr<arrow::DataType> in a std::shared_ptr<arrow::matlab::type::proxy::DataType> and adds the proxy to the libmexclass::proxy::ProxyManager. It's function signature is

arrow::Result<std::shared_ptr<arrow::matlab::type::proxy::Type>> wrap_and_manage(const std::shared_ptr<arrow::DataType>& type);

5. Deleted arrow::matlab::array::proxy::wrap and arrow::matlab::type::proxy::wrap functions.

Are these changes tested?

Tested via the existing MATLAB test classes.

Are there any user-facing changes?

No.

• GitHub Issue: [MATLAB] Create utility functions for simplifying management of Proxy instances for Arrays #38369

[kevingurney]

This looks like a great improvement to the way we are working with Proxy objects! Thanks for working on this!

[kevingurney]

+1

[conbench-apache-arrow]

After merging your PR, Conbench analyzed the 2 benchmarking runs that have been run so far on merge-commit c5fdc8e.

There were no benchmark performance regressions. 🎉

The full Conbench report has more details.