On Wed, 26 Aug 2015, Yaniv Kunda wrote:
I would like to propose adding support for Java 7’s java.nio.file.Path
as an alternative to those methods in the API that deal with a
java.io.File.
Any chance you could briefly summarise what advantages this would give to
us and/or our users?
1) What can we do with methods returning a File? e.g.
TemporaryResources.createTemporaryFile, TikaInputStream.getFile.
Should we break compatibility and encourage (=force) users to change their
code (Note that since they all use Java 7 now, the change is minimal by
adding .toFile() to the result),
or create new methods with different names (confusing)?
Breaking compatibility outside of a 2.0 release is a big no-no, sorry.
TemporaryResources.createTemporaryPath and TikaInputStream.getPath could
work as naming
2) Should we deprecate the old methods accepting a File, or delete
them?
Deleting would break compatibility, so shouldn't be done. Deprecating
could be done, if there's a strong reason to encourage people off them
https://wiki.apache.org/tika/Tika2_0RoadMap is where we're tracking
proposed API-breaking changes for 2.0
Nick