MultiBackgroundInitializer.MultiBackgroundInitializerResults (Apache Commons Lang 3.20.0 API)
Description: declaration: package: org.apache.commons.lang3.concurrent, class: MultiBackgroundInitializer, class: MultiBackgroundInitializerResults

# Class MultiBackgroundInitializer.MultiBackgroundInitializerResults

java.lang.Object
org.apache.commons.lang3.concurrent.MultiBackgroundInitializer.MultiBackgroundInitializerResults

Enclosing class:
  `MultiBackgroundInitializer`

public static class MultiBackgroundInitializer.MultiBackgroundInitializerResults extends Object
A data class for storing the results of the background initialization performed by `MultiBackgroundInitializer`. Objects of this inner class are returned by `MultiBackgroundInitializer.initialize()`. They allow access to all result objects produced by the `BackgroundInitializer` objects managed by the owning instance. It is also possible to retrieve status information about single `BackgroundInitializer`s, i.e. whether they completed normally or caused an exception.

Since:
  3.0

- ## Method Summary

  Modifier and Type
  Method
  Description
  `ConcurrentException`
  `getException(String name)`
  Gets the `ConcurrentException` object that was thrown by the `BackgroundInitializer` with the given name.
  `BackgroundInitializer<?>`
  `getInitializer(String name)`
  Gets the `BackgroundInitializer` with the given name.
  `Object`
  `getResultObject(String name)`
  Gets the result object produced by the `BackgroundInitializer` with the given name.
  `Set<String>`
  `initializerNames()`
  Returns a set with the names of all `BackgroundInitializer` objects managed by the `MultiBackgroundInitializer`.
  `boolean`
  `isException(String name)`
  Tests whether the `BackgroundInitializer` with the given name caused an exception.
  `boolean`
  `isSuccessful()`
  Tests whether the whole initialization was successful.

  ### Methods inherited from class Object

  `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- ## Method Details

  - ### getException

    public ConcurrentException getException(String name)
    Gets the `ConcurrentException` object that was thrown by the `BackgroundInitializer` with the given name. If this initializer did not throw an exception, the return value is null. If the name cannot be resolved, an exception is thrown.
    Parameters:
      `name` - the name of the `BackgroundInitializer`.
    Returns:
      the exception thrown by this initializer.
    Throws:
      `NoSuchElementException` - if the name cannot be resolved.

  - ### getInitializer

    public BackgroundInitializer<?> getInitializer(String name)
    Gets the `BackgroundInitializer` with the given name. If the name cannot be resolved, an exception is thrown.
    Parameters:
      `name` - the name of the `BackgroundInitializer`.
    Returns:
      the `BackgroundInitializer` with this name.
    Throws:
      `NoSuchElementException` - if the name cannot be resolved.

  - ### getResultObject

    public Object getResultObject(String name)
    Gets the result object produced by the `BackgroundInitializer` with the given name. This is the object returned by the initializer's `initialize()` method. If this `BackgroundInitializer` caused an exception, null is returned. If the name cannot be resolved, an exception is thrown.
    Parameters:
      `name` - the name of the `BackgroundInitializer`.
    Returns:
      the result object produced by this `BackgroundInitializer`.
    Throws:
      `NoSuchElementException` - if the name cannot be resolved.

  - ### initializerNames

    public Set<String> initializerNames()
    Returns a set with the names of all `BackgroundInitializer` objects managed by the `MultiBackgroundInitializer`.
    Returns:
      an (unmodifiable) set with the names of the managed `BackgroundInitializer` objects.

  - ### isException

    public boolean isException(String name)
    Tests whether the `BackgroundInitializer` with the given name caused an exception.
    Parameters:
      `name` - the name of the `BackgroundInitializer`.
    Returns:
      a flag whether this initializer caused an exception.
    Throws:
      `NoSuchElementException` - if the name cannot be resolved.

  - ### isSuccessful

    public boolean isSuccessful()
    Tests whether the whole initialization was successful. This is the case if no child initializer has thrown an exception.
    Returns:
      a flag whether the initialization was successful.