[Java] Improve java API

[satur9nine]

• Makes Java API for vectors cleaner like Rust, Swift and Python
• Don't silently drop arrays of incorrect fixed length, throw instead
• Restore missing JavaTest.sh
• Ensure all vector creation examples in tutorial mention reverse order
• Fix Kotlin shell script to ensure bash is used

[jtdavis777]

hey @satur9nine - any concerns that a change like this will break existing code?

[satur9nine]

hey @satur9nine - any concerns that a change like this will break existing code?

Overall test coverage is very good so I don't see any big risks but there is one notable behavior change. I fixed a bug I mentioned in the commit message "Don't silently drop arrays of incorrect fixed length, throw instead". Notice IllegalArgumentException is now thrown if the user passes an array of the wrong size rather than the incorrectly sized array being dropped. It's possible that some subset of users are adding arrays that are getting dropped and they simple never cared about that data being dropped, anything is possible but its easily fixed on their end and they probably would want to know about silent data loss, but of course some users could consider fixing a bug as a "break".

[jtdavis777]

what I am more asking about is that you have updated the tutorial in that users will need to change the behavior of their code to get the same output they did in the past. I think this is likely fine, as it more closely aligns with the other languages? Just sanity checking before I ship it :D