Introduce GetJsonObjectOptions in getJSONObject Java API

[SurajAralihalli]

Description

Addresses 10219

This PR introduces a new class named GetJsonObjectOptions that holds the configurations to control the behavior of the underlying cudf::get_json_object function. It incorporates this new class into the getJSONObject JAVA API as an additional argument but also keeps the previous API to maintain backwards compatibility. It also includes a test case, testGetJSONObjectWithSingleQuotes, validating the behavior of getJSONObject when single quotes are enabled.

Checklist

• I am familiar with the Contributing Guidelines.
• New or existing tests cover these changes.
• The documentation is up to date with these changes.

[revans2]

Looks great

[karthikeyann]

Question: Just curious about the design choices used here.
The Java public interface has aGetJsonObjectOptions.
then JNI.cpp interface uses 3 booleans.
libcudf uses get_json_object_options (constructed from these 3 booleans)

The data flows as (Java object) -> 3 booleans in function arguments -> (C++ object)

Is this a limitation of JNI?
Can we directly use (Java object) or (C++ object) in the function argument?

[revans2]

@karthikeyann it really is about JNI limitations. We have a few choices for what we could do.

We could have a java class that creates an instance of a C++ object and holds a reference to it. Then anything that interacts with the object needs to call into JNI to change things. It also has the possibility of being leaked if the java code does not close it, or if we don't put in a finalizer to make sure that the data is released when GC happens. Neither is very user friendly from a java standpoint.

We could have a pure java class that holds the values, and we could pass an instance of that class into JNI. But it is very slow to call back into java from JNI. So if we know that all of the values are going to be used, we typically just pull it apart in java and send them down as separate parameters so the performance is not too bad.

[revans2]

/merge