Module org.opengis.geoapi

Package org.opengis.feature

Class InvalidPropertyValueException

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 of 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 Details

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.