[kikoso]

Fixes #1834

The data parsers propagate IOException at runtime (stream failures, and for KMZ the entry count and uncompressed size limits), but their Java signatures did not declare it. Java callers could not write catch (IOException e) around a parse call and had to catch Exception instead.

This adds @Throws(IOException::class) to the public entry points:

• KmzParser.parse
• KmlParser.parse and KmlParser.parseAsKml
• GpxParser.parse
• GeoJsonParser.parse

I annotated the existing methods instead of adding a separate parseChecked() method. A second method doing the same thing adds API surface for little gain, and v7.0.0 is already a breaking release.

Compatibility

• Kotlin callers are unaffected.
• Binary compatible: already-compiled Java code keeps working.
• Source-breaking for Java: callers that recompile must catch or declare IOException. Documented in MIGRATION.md (section 6), hence the !.

Tests

ParserCheckedExceptionTest is written in Java, so each catch (IOException e) only compiles if the method declares the exception. It also checks that a stream read failure reaches that catch.

• ./gradlew :data:testDebugUnitTest: 192 tests, 0 failures
• ./gradlew :data:lintDebug spotlessCheck: passing

[googlemaps-bot]

Code Coverage

Overall Project	62.53%	🍏

Module	Coverage
Kover Gradle Plugin XML report for :data	61.12%	🍏

Files

Module	File	Coverage
Kover Gradle Plugin XML report for :data	KmlParser.kt	90.53%	🍏
	GpxParser.kt	88.68%	🍏
	GeoJsonParser.kt	88.24%	🍏
	KmzParser.kt	87.85%	🍏