InvalidPropertyValueException (GeoAPI normative 3.1-SNAPSHOT)

Object
- Throwable
- - Exception
  - - RuntimeException
    - - IllegalArgumentException
      - InvalidPropertyValueException

All Implemented Interfaces:

Serializable
```
public class InvalidPropertyValueException
extends IllegalArgumentException
```
Thrown when an Attribute value or a FeatureAssociation does not met the constraints (other than Java class) specified by its type. This exception can be thrown by implementations that perform validity checks. Such verifications happen typically in the following methods:
- In Attribute:
  - setValue(Object)
  - setValues(Collection)
- In FeatureAssociation:
  - setValue(Feature)
  - setValues(Collection)
- In Feature:
  - setProperty(Property)
  - setPropertyValue(String, Object)
Exception for invalid class
Libraries may throw ClassCastException instead than this InvalidPropertyValueException when the given value is not an instance of the expected class (typically AttributeType.getValueClass()). The reason is that libraries may rely on Java parameterized types, which throws ClassCastException at runtime when the objects are used in an unsafe way. Libraries may also rely on Class.cast(Object) or Class.asSubclass(Class) standard methods, which are designed to throw ClassCastException, or may way to be consistent with all the above.
Since:

3.1

See Also:

Serialized Form

Constructor Summary

Constructors
Constructor	Description
`InvalidPropertyValueException()`	Creates an exception with no message.
`InvalidPropertyValueException(String message)`	Creates an exception with the specified message.
`InvalidPropertyValueException(String message, Throwable cause)`	Creates an exception with the specified message and cause.

Method Summary
- Methods inherited from class Throwable
  addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
- Methods inherited from class Object
  clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - InvalidPropertyValueException
```
public InvalidPropertyValueException()
```
    Creates an exception with no message.
  - InvalidPropertyValueException
```
public InvalidPropertyValueException(String message)
```
    Creates an exception with the specified message.
    
    Parameters:
    
    message - the detail message, saved for later retrieval by the Throwable.getMessage() method.
  - InvalidPropertyValueException
```
public InvalidPropertyValueException(String message,
                                     Throwable cause)
```
    Creates an exception with the specified message and cause.
    
    Parameters:
    
    message - the detail message, saved for later retrieval by the Throwable.getMessage() method.
    
    cause - the cause, saved for later retrieval by the Throwable.getCause() method.