Package org.apache.commons.lang

## Class IncompleteArgumentException

- java.lang.Object
- - java.lang.Throwable
  - - java.lang.Exception
    - - java.lang.RuntimeException
      - - java.lang.IllegalArgumentException
        - - org.apache.commons.lang.IncompleteArgumentException

- All Implemented Interfaces:
    `Serializable`

      public class IncompleteArgumentException
      extends IllegalArgumentException

  Thrown to indicate an incomplete argument to a method. This exception supplements the standard `IllegalArgumentException` by providing a more semantically rich description of the problem.

  `IncompleteArgumentException` represents the case where a method takes in a parameter that has a number of properties, some of which have not been set. A case might be a search requirements bean that must have three properties set in order for the method to run, but only one is actually set. This exception would be used in place of `IllegalArgumentException`, yet it still extends it.

       public void foo(PersonSearcher search) {
         if (search.getSurname() == null ||
             search.getForename() == null ||
             search.getSex() == null) {
           throw new IncompleteArgumentException("search");
         }
         // do something with the searcher
       }

  Since:
    2.0
  Version:
    $Id: IncompleteArgumentException.java 437554 2006-08-28 06:21:41Z bayard $
  See Also:
    Serialized Form

- - ### Constructor Summary

    Constructors
    Constructor | Description
    --- | ---
    `IncompleteArgumentException​(String argName)` | Instantiates with the specified description.
    `IncompleteArgumentException​(String argName, String[] items)` | Instantiates with the specified description.

  - ### Method Summary

    - ### Methods inherited from class java.lang.Throwable

      `addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, 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 Detail

    - #### IncompleteArgumentException

          public IncompleteArgumentException​(String argName)

      Instantiates with the specified description.

      Parameters:
        `argName` - a description of the incomplete argument

    - #### IncompleteArgumentException

          public IncompleteArgumentException​(String argName,
                                             String[] items)

      Instantiates with the specified description.

      Parameters:
        `argName` - a description of the incomplete argument
        `items` - an array describing the arguments missing