Deprecated API

Contents

• Terminally Deprecated
• Classes
• Exceptions
• Methods
• Constructors

Terminally Deprecated Elements

Element	Description
com.github.mizool.core.concurrent.BufferedStreamAdapter.adapt(Stream<ListenableFuture<E>>, int, ExecutorService)	Use BufferedStreamAdapter.listenable() and BufferedStreamAdapter.Listenable.adapt(Stream, int, ExecutorService) instead.
com.github.mizool.core.concurrent.ListenableFutureCollector	This class does not propagate exceptions consistently and will be removed. Use FutureStreamJoiner instead.
com.github.mizool.core.concurrent.Threads.rethrowInterrupt(InterruptedException)	at the usage site, the compiler/IDE can’t know that rethrowInterrupt() contains a throw, so it will complain that an exception was neither handled nor rethrown.
com.github.mizool.core.converter.Converters.fromPojos(List<P>, Function<P, R>)	Use Converters.toRecords(List, Function) instead.
com.github.mizool.core.converter.Converters.fromPojos(Set<P>, Function<P, R>)	Use Converters.toRecords(Set, Function) instead.
com.github.mizool.core.converter.JavaUtilDateConverter	Don't use java.util.Date.
com.github.mizool.core.exception.UnprocessableEntityException	Throwing UnprocessableEntityException doesn't say why the entity is unprocessable and is generally a bad fit as no client ever really has a chance of handling such a response. Instead, consider creating an exception class specific to the respective problem that extends AbstractUnprocessableEntityException.
com.github.mizool.core.GuavaCollectors.toImmutableList()	Use ImmutableList.toImmutableList() instead.
com.github.mizool.core.GuavaCollectors.toImmutableListMultimap(Function<? super T, ? extends K>, Function<? super T, ? extends List<U>>)	Use ImmutableListMultimap.toImmutableListMultimap(Function, Function) instead. This will require some refactoring as it expects the value mapper to map one value instead of a list.
com.github.mizool.core.GuavaCollectors.toImmutableMap(Function<? super T, ? extends K>, Function<? super T, ? extends U>)	Use ImmutableMap.toImmutableMap(Function, Function) instead.
com.github.mizool.core.GuavaCollectors.toImmutableSet()	Use ImmutableSet.toImmutableSet() instead.
com.github.mizool.core.GuavaCollectors.toImmutableSetMultimap(Function<? super T, ? extends K>, Function<? super T, ? extends Set<U>>)	Use ImmutableSetMultimap.toImmutableSetMultimap(Function, Function) instead. This will require some refactoring as it expects the value mapper to map one value instead of a list.
com.github.mizool.core.Identifiable.getIdentifier()	use getId() instead
com.github.mizool.core.Optionals.unwrapRequiredObject(Optional<T>, Class<T>)	Use Optionals.unwrapRequiredObject(Optional, Class) instead.
com.github.mizool.core.Optionals.unwrapUserMentionedObject(Optional<T>, Class<T>)	Use Optionals.unwrapUserMentionedObject(Optional, Class) instead.
com.github.mizool.core.Optionals.unwrapUserRequestedObject(Optional<T>, Class<T>)	Use Optionals.unwrapUserRequestedObject(Optional, Class) instead.

Deprecated Classes

Class	Description
com.github.mizool.core.concurrent.ListenableFutureCollector	This class does not propagate exceptions consistently and will be removed. Use FutureStreamJoiner instead.
com.github.mizool.core.concurrent.ResultVoidingFuture	Use the factory method Futures.toVoidResult(ListenableFuture) instead. This class will cease to be public at some point.
com.github.mizool.core.converter.JavaUtilDateConverter	Don't use java.util.Date.
com.github.mizool.core.password.Pbkdf2WithHmacSha1Hasher	For newly saved passwords, use Pbkdf2WithHmacSha512Hasher instead. This hasher is kept to allow continued verification of old passwords.

Deprecated Exceptions

Exceptions	Description
com.github.mizool.core.exception.UnprocessableEntityException	Throwing UnprocessableEntityException doesn't say why the entity is unprocessable and is generally a bad fit as no client ever really has a chance of handling such a response. Instead, consider creating an exception class specific to the respective problem that extends AbstractUnprocessableEntityException.

Deprecated Methods

Method	Description
com.github.mizool.core.concurrent.BufferedStreamAdapter.adapt(Stream<ListenableFuture<E>>, int, ExecutorService)	Use BufferedStreamAdapter.listenable() and BufferedStreamAdapter.Listenable.adapt(Stream, int, ExecutorService) instead.
com.github.mizool.core.concurrent.Threads.rethrowInterrupt(InterruptedException)	at the usage site, the compiler/IDE can’t know that rethrowInterrupt() contains a throw, so it will complain that an exception was neither handled nor rethrown.
com.github.mizool.core.converter.Converters.fromPojos(List<P>, Function<P, R>)	Use Converters.toRecords(List, Function) instead.
com.github.mizool.core.converter.Converters.fromPojos(Set<P>, Function<P, R>)	Use Converters.toRecords(Set, Function) instead.
com.github.mizool.core.GuavaCollectors.toImmutableList()	Use ImmutableList.toImmutableList() instead.
com.github.mizool.core.GuavaCollectors.toImmutableListMultimap(Function<? super T, ? extends K>, Function<? super T, ? extends List<U>>)	Use ImmutableListMultimap.toImmutableListMultimap(Function, Function) instead. This will require some refactoring as it expects the value mapper to map one value instead of a list.
com.github.mizool.core.GuavaCollectors.toImmutableMap(Function<? super T, ? extends K>, Function<? super T, ? extends U>)	Use ImmutableMap.toImmutableMap(Function, Function) instead.
com.github.mizool.core.GuavaCollectors.toImmutableSet()	Use ImmutableSet.toImmutableSet() instead.
com.github.mizool.core.GuavaCollectors.toImmutableSetMultimap(Function<? super T, ? extends K>, Function<? super T, ? extends Set<U>>)	Use ImmutableSetMultimap.toImmutableSetMultimap(Function, Function) instead. This will require some refactoring as it expects the value mapper to map one value instead of a list.
com.github.mizool.core.Identifiable.getIdentifier()	use getId() instead
com.github.mizool.core.Optionals.unwrapRequiredObject(Optional<T>, Class<T>)	Use Optionals.unwrapRequiredObject(Optional, Class) instead.
com.github.mizool.core.Optionals.unwrapUserMentionedObject(Optional<T>, Class<T>)	Use Optionals.unwrapUserMentionedObject(Optional, Class) instead.
com.github.mizool.core.Optionals.unwrapUserRequestedObject(Optional<T>, Class<T>)	Use Optionals.unwrapUserRequestedObject(Optional, Class) instead.

Deprecated Constructors

Constructor	Description
com.github.mizool.core.concurrent.ResultVoidingFuture(ListenableFuture<T>)	Use the factory method Futures.toVoidResult(ListenableFuture) instead. This class will cease to be public at some point.
com.github.mizool.core.exception.NotYetImplementedException()	Deprecated to remind you to implement the corresponding code before releasing the software.
com.github.mizool.core.exception.NotYetImplementedException(String)	Deprecated to remind you to implement the corresponding code before releasing the software.