Binary uncompatible changes in FilterBuilder class

[rulle-io]

We have a code piece like (new FilterBuilder().includePackage("XXX")).

It suddenly started to fail at runtime (after upgrade org.reflections:reflections:jar:0.9.12 => 0.10.2)

Caused by: java.lang.NoSuchMethodError:
'org.reflections.util.FilterBuilder org.reflections.util.FilterBuilder.includePackage(java.lang.String[])'

It turned out that public interface in FilterBuilder was changed here:

-public FilterBuilder includePackage(final String... prefixes)
+public FilterBuilder includePackage(String value)

-- Old one

reflections/src/main/java/org/reflections/util/FilterBuilder.java

Line 42 in 7741e8f

public FilterBuilder includePackage(final String... prefixes) {

-- New one

reflections/src/main/java/org/reflections/util/FilterBuilder.java

Line 36 in 1f05c17

public FilterBuilder includePackage(String value) {

This change is problematic in so many different ways: :)

1. You usually never just delete a public method in a public library without a proper deprecation cycle.
2. Changing parameter from java.lang.String[] to String will make compilation work for some use-cases, and not for others.
3. It breaks the binary compatibility.