Package org.apache.commons.math4.exception

Class NullArgumentException

java.lang.Object
java.lang.Throwable
java.lang.Exception
java.lang.RuntimeException
java.lang.NullPointerException
org.apache.commons.math4.exception.NullArgumentException
All Implemented Interfaces:
java.io.Serializable, ExceptionContextProvider
public class NullArgumentException
extends java.lang.NullPointerException
implements ExceptionContextProvider
All conditions checks that fail due to a null argument must throw this exception. This class is meant to signal a precondition violation ("null is an illegal argument") and so does not extend the standard NullPointerException. Propagation of NullPointerException from within Commons-Math is construed to be a bug.

Note: from 4.0 onwards, this class extends NullPointerException instead of MathIllegalArgumentException.

Since:
2.2
See Also:
Serialized Form

  • Constructor Summary

    Constructors 
    Constructor Description
    NullArgumentException()
    Default constructor.
    NullArgumentException​(Localizable pattern, java.lang.Object... arguments)  

  • Method Summary

    Modifier and Type Method Description
    ExceptionContext getContext()
    Gets a reference to the "rich context" data structure that allows to customize error messages and store key, value pairs in exceptions.
    java.lang.String getLocalizedMessage()
    java.lang.String getMessage()

    Methods inherited from class java.lang.Throwable

    addSuppressed, fillInStackTrace, getCause, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

    Methods inherited from class java.lang.Object

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

  • Constructor Details

    • NullArgumentException

      public NullArgumentException()
      Default constructor.

    • NullArgumentException

      public NullArgumentException​(Localizable pattern, java.lang.Object... arguments)
      Parameters:
      pattern - Message pattern providing the specific context of the error.
      arguments - Values for replacing the placeholders in pattern.

  • Method Details

    • getContext

      public ExceptionContext getContext()
      Gets a reference to the "rich context" data structure that allows to customize error messages and store key, value pairs in exceptions.
      Specified by:
      getContext in interface ExceptionContextProvider
      Returns:
      a reference to the exception context.
      Since:
      4.0

    • getMessage

      public java.lang.String getMessage()
      Overrides:
      getMessage in class java.lang.NullPointerException

    • getLocalizedMessage

      public java.lang.String getLocalizedMessage()
      Overrides:
      getLocalizedMessage in class java.lang.Throwable