Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## 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 $
Author:
  Matthew Hawthorne
See Also:
  Serialized Form

Constructor Summary
`IncompleteArgumentException(String argName)` Instantiates with the specified description.
`IncompleteArgumentException(String argName, String[] items)` Instantiates with the specified description.

Methods inherited from class java.lang.Throwable
`fillInStackTrace, getLocalizedMessage, getMessage, printStackTrace, printStackTrace, printStackTrace, 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

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Copyright © 2001-2005 - Apache Software Foundation