AO Lang Changelog

• API supports arriving at an attribute in any order, such as scope → context → name or name → context.
• API provides generic type safety (assumes casts will be OK behind the scenes, which is acceptable when all access to attributes is through this API).
• Also provides additional functional-friendly methods similar to those in Map, such as computeIfAbsent.

1. IOBiConsumer
2. IOBiConsumerE
3. IOConsumer
4. IOConsumerE
5. IOFunction
6. IOFunctionE
7. IOPredicate
8. IOPredicateE
9. IORunnable
10. IORunnableE
11. IOSupplier
12. IOSupplierE

1. Using optimized writer for all writes. This can help maintain string identity for in-context translation tools.
2. trim(…) methods convert to empty string in more cases.
3. trim(…) methods return original char[] when non-empty and not trimmed. This is to allow subsequent writes to use the char[] directly.
4. Added optimization for Segment to write the underlying char[] directly.
5. Added support for Optional by unwrapping the value.

1. Non-localized parts moved to this project.
2. Localized parts moved to AO Hodgepodge and renamed to MarkupCoercion.
3. New pluggable CoercionOptimizer to allow this decoupling.
4. Servlet-specific optimizations moved to AO Servlet Util.

1. BiConsumerE
2. LocalizedConsumer
3. LocalizedConsumerE
4. LocalizedSupplier
5. LocalizedSupplierE

1. ConsumerE
2. FunctionE
3. PredicateE
4. SupplierE

New methods in Resources for obtaining resources relative to a Class or Package.

Being accessed relative to the package, the application resources can still be correctly located after packages are renamed by code obfuscation.

• createTempDirectory(…)
• delete(…)
• deleteRecursive(…)
• mkdir(…)
• mkdirs(…)

New method Throwables.newSurrogate(Throwable) that supports creating new instances of throwables in order to have caller stack trace. When wrapped, the new throwable has a state compatible with the original, and the original throwable is the cause of the new throwable. When not wrapped, the original throwable is used directly and caller stack trace is lost.

This is used to maintain exception types and states across thread boundaries, such as when an exception cause is obtained from an ExecutionException.

1. Made isNameStartChar(int), isNameChar(int), and isHyphen(int) public.
2. Renamed isValidId(String) to isValidName(String), since IDs are defined as being valid Name.
3. Created variant of isValidName(String,int,int) to validate a substring without allocation.

New class Iterables with a set of various Iterable over common Java types, useful to avoid conflict after type erasure.

Sometimes different method overloads want to accept different types of Iterable, but they cannot due to conflict after type erasure.

1. com.aoindustries.util.StringUtility → Strings

1. NotImplementedException
2. WrappedException
3. WrappedExceptions

1. com.aoindustries.util.StringUtility

1. CalendarUtils returns GregorianCalendar instead of Calendar where appropriate.

1. This project uses managed dependencies.
2. This project's managed dependencies may also be imported by other projects.

• LocalizedParseException
• LocalizedTimeoutException

Deprecating methods in favor of Apache Commons Lang and Apache Commons Collections where functionality is redundant.

This does not introduce any runtime dependency on commons-lang or commons-collections. The dependencies are both <optional /> and <provided /> because they are only used for javadoc @link and @see generation.

This is not an exhaustive search for redundant behavior. We will identify and deprecate over time as we go.

1. exec method now allows varargs.
2. Now uses only one additional thread to read standard error.
3. Delays the allocation of StringBuilder objects until needed.
4. Provides an appropriate starting buffer size to the StringBuilder objects.
5. Reduces the amount of synchronization.

1. Uses soft references to avoid potential runaway memory leaks.
2. Provides additional statistics including the number of buffers zero-filled and detected as garbage collected.
3. Javadoc comment improvements.

1. Added Listener hook for code interested in calls to getMessage.
2. Used this new hook to decouple AO Lang from AO Hodgepodge.

1. writeFastUTF compares strings with .equals to find all duplicates.
2. Removed internal quick-scan arrays. We've learned to not underestimate the performance of HashMap.
3. Improved Javadocs.

1. Improved Javadocs.

1. New filterByValue methods to get the key set from maps for all entries matching a given value.
2. unmodifiableCopy* methods allow wider generic bounds for more versatility.
3. optimalUnmodifiable* methods allow wider generic bounds for more versatility.
4. unmodifiableIterator method allows wider generic bounds for more versatility.
5. filter method allows wider generic bounds for more versatility.
6. filterByValue methods allow wider generic bounds for more versatility.