er.extensions.validation
Class ERXValidationException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          java.lang.RuntimeException
              com.webobjects.foundation.NSValidation.ValidationException
                  er.extensions.validation.ERXValidationException

All Implemented Interfaces:

com.webobjects.foundation.NSKeyValueCoding, java.io.Serializable

Direct Known Subclasses:

ERAttachmentProcessor.ERXAttachmentExceedsLengthException

public class ERXValidationException
extends com.webobjects.foundation.NSValidation.ValidationException
implements com.webobjects.foundation.NSKeyValueCoding

ERXValidationExceptions extends the regular NSValidation.ValidationException to add template based resolution of the validation exception. See more information about resolving templates in the ERXValidationFactory.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface com.webobjects.foundation.NSKeyValueCoding

com.webobjects.foundation.NSKeyValueCoding._BooleanFieldBinding, com.webobjects.foundation.NSKeyValueCoding._BooleanMethodBinding, com.webobjects.foundation.NSKeyValueCoding._FieldBinding, com.webobjects.foundation.NSKeyValueCoding._ForwardingBinding, com.webobjects.foundation.NSKeyValueCoding._KeyBinding, com.webobjects.foundation.NSKeyValueCoding._KeyBindingCreation, com.webobjects.foundation.NSKeyValueCoding._MethodBinding, com.webobjects.foundation.NSKeyValueCoding._NumberFieldBinding, com.webobjects.foundation.NSKeyValueCoding._NumberMethodBinding, com.webobjects.foundation.NSKeyValueCoding._ReflectionKeyBindingCreation, com.webobjects.foundation.NSKeyValueCoding.DefaultImplementation, com.webobjects.foundation.NSKeyValueCoding.ErrorHandling, com.webobjects.foundation.NSKeyValueCoding.Null, com.webobjects.foundation.NSKeyValueCoding.UnknownKeyException, com.webobjects.foundation.NSKeyValueCoding.Utility, com.webobjects.foundation.NSKeyValueCoding.ValueAccessor

Field Summary

protected com.webobjects.foundation.NSKeyValueCoding	_context holds a reference to the context of the exception
protected com.webobjects.foundation.NSArray	additionalExceptions caches any set additionalExceptions
static java.lang.String	CustomMethodException corresponds to a custom method exception
protected java.lang.Object	delegate holds a reference to the exception delegate
static java.lang.String	ExceedsMaximumLengthException corresponds to a model thrown 'maximum length of attribute exceeded' exception
static java.lang.String	InvalidNumberException corresponds to a number formatter exception
static java.lang.String	InvalidValueException corresponds to a generic 'invalid value' exception
static org.apache.log4j.Logger	log logging support
static java.lang.String	MandatoryToManyRelationshipException corresponds to a model thrown 'manditory toMany relationship' exception
static java.lang.String	MandatoryToOneRelationshipException corresponds to a model thrown 'mandatory toOne relationship' exception
protected java.lang.String	message caches the validation message
protected java.lang.String	method holds the method if one is provided
static java.lang.String	NullPropertyException corresponds to a model thrown 'null property' exception
protected java.lang.Object	object holds the object that failed validation
static java.lang.String	ObjectRemovalException corresponds to a model thrown 'object removal' exception
static java.lang.String	ObjectsRemovalException corresponds to a model thrown 'objects removal' exception
protected java.lang.String	targetLanguage holds the target language if provided
protected java.lang.String	type holds the type of the exception
protected java.lang.Object	value holds the value that failed validation
static java.lang.String	ValueConversionException corresponds to a model thrown 'Error converting value of class' exception

Fields inherited from class com.webobjects.foundation.NSValidation.ValidationException

_CLASS, AdditionalExceptionsKey, ValidatedKeyUserInfoKey, ValidatedObjectUserInfoKey

Fields inherited from interface com.webobjects.foundation.NSKeyValueCoding

_CLASS, NullValue

Constructor Summary

ERXValidationException(java.lang.String type, java.lang.Object object, java.lang.String key)
Default constructor that builds a validation exception without the failed value specified.

ERXValidationException(java.lang.String type, java.lang.Object object, java.lang.String key, java.lang.Object value)
Default constructor that builds a validation exception based on the type, object, key and failed value.Usually for creating custom validation exceptions the ERXValidationFactory should be used.

Method Summary

protected java.lang.String	_getMessage()
com.webobjects.foundation.NSArray	additionalExceptions() Cover method to return any additional exceptions that occurred.
com.webobjects.eoaccess.EOAttribute	attribute() Cover method for getting the attribute corresponding to the propertyKey and entity off of the objet.
com.webobjects.foundation.NSKeyValueCoding	context() The current context of the validation exception.
java.lang.Object	delegate() Gets the current delegate for this validation exception.
java.lang.String	displayNameForEntity() Generates a displayable and localized version of the current object's entity name.
java.lang.String	displayNameForProperty() Generates a displayable and localized version of the current propertyKey (also called key).
com.webobjects.eocontrol.EOEnterpriseObject	eoObject() Cover method that casts the object of the validation exception to an EOEnterpriseObject.
boolean	equals(java.lang.Object anotherObject) Compares this exception to anything else.
java.lang.String	getMessage() Gets the message for this exception.
int	hashCode()
boolean	isCustomMethodException() Convience method to determine if this exception was a custom thrown exception instead of a model thrown exception.
protected java.lang.String	localizedDisplayNameForKey(java.lang.String key) Creates a localized display name for a given key trying to localize it with the current "targetLanguage" or the current localizer.
java.lang.String	method() Returns method name.
java.lang.Object	object() Overrides super implementation to allow for setable object value.
java.lang.String	propertyKey() Cover method for returning the key of the validation exception under the name propertyKey.
void	setAdditionalExceptions(com.webobjects.foundation.NSArray exceptions) Sets the array of additional exceptions that has occurried.
void	setContext(com.webobjects.foundation.NSKeyValueCoding context) Sets the context that can be used to resolve key bindings in validation templates.
void	setDelegate(java.lang.Object obj) Sets the delegate for the current validation exception.
void	setMethod(java.lang.String aMethod) Sets the custom method name that threw the validation exception.
void	setObject(java.lang.Object aValue) Sets the object that failed validation.
void	setTargetLanguage(java.lang.String aValue) Sets the target language to use when rendering the validation message.
void	setType(java.lang.String aType) Sets the validation type of this exception.
void	setValue(java.lang.Object aValue) Sets the value that failed validation.
void	takeValueForKey(java.lang.Object obj, java.lang.String key) Implementation of the key value coding.
java.lang.String	targetLanguage() Returns the target language to display the validation message in.
java.lang.String	toString() Returns the formatted description of the validation exception without calling getMessage.
java.lang.String	type() Cover method to return the type of the validation exception.
java.lang.Object	value() Returns the value that failed validation.
java.lang.Object	valueForKey(java.lang.String key) Implementation of key value coding.

Methods inherited from class com.webobjects.foundation.NSValidation.ValidationException

aggregateExceptionWithExceptions, exceptionAddingEntriesToUserInfo, exceptionWithObjectAndKey, key, userInfo

Methods inherited from class java.lang.Throwable

fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

log

public static final org.apache.log4j.Logger log

logging support

NullPropertyException

public static final java.lang.String NullPropertyException

corresponds to a model thrown 'null property' exception

See Also:

Constant Field Values

InvalidNumberException

public static final java.lang.String InvalidNumberException

corresponds to a number formatter exception

See Also:

Constant Field Values

InvalidValueException

public static final java.lang.String InvalidValueException

corresponds to a generic 'invalid value' exception

See Also:

Constant Field Values

MandatoryToOneRelationshipException

public static final java.lang.String MandatoryToOneRelationshipException

corresponds to a model thrown 'mandatory toOne relationship' exception

See Also:

Constant Field Values

MandatoryToManyRelationshipException

public static final java.lang.String MandatoryToManyRelationshipException

corresponds to a model thrown 'manditory toMany relationship' exception

See Also:

Constant Field Values

ObjectRemovalException

public static final java.lang.String ObjectRemovalException

corresponds to a model thrown 'object removal' exception

See Also:

Constant Field Values

ObjectsRemovalException

public static final java.lang.String ObjectsRemovalException

corresponds to a model thrown 'objects removal' exception

See Also:

Constant Field Values

ExceedsMaximumLengthException

public static final java.lang.String ExceedsMaximumLengthException

corresponds to a model thrown 'maximum length of attribute exceeded' exception

See Also:

Constant Field Values

ValueConversionException

public static final java.lang.String ValueConversionException

corresponds to a model thrown 'Error converting value of class' exception

See Also:

Constant Field Values

CustomMethodException

public static final java.lang.String CustomMethodException

corresponds to a custom method exception

See Also:

Constant Field Values

message

protected java.lang.String message

caches the validation message

method

protected java.lang.String method

holds the method if one is provided

type

protected java.lang.String type

holds the type of the exception

value

protected java.lang.Object value

holds the value that failed validation

object

protected java.lang.Object object

holds the object that failed validation

targetLanguage

protected java.lang.String targetLanguage

holds the target language if provided

additionalExceptions

protected com.webobjects.foundation.NSArray additionalExceptions

caches any set additionalExceptions

_context

protected volatile com.webobjects.foundation.NSKeyValueCoding _context

holds a reference to the context of the exception

delegate

protected volatile java.lang.Object delegate

holds a reference to the exception delegate

Constructor Detail

ERXValidationException

public ERXValidationException(java.lang.String type,
                              java.lang.Object object,
                              java.lang.String key)

Default constructor that builds a validation exception without the failed value specified. If you want to have validation templates that refer to the value that didn't pass validation use the four argument constructor. Usually for creating custom validation exceptions the ERXValidationFactory should be used.

Parameters:

type - of the exception, should be one of the constaints defined in this class.

object - that is throwing the exception

key - property key that failed validation

ERXValidationException

public ERXValidationException(java.lang.String type,
                              java.lang.Object object,
                              java.lang.String key,
                              java.lang.Object value)

Default constructor that builds a validation exception based on the type, object, key and failed value.Usually for creating custom validation exceptions the ERXValidationFactory should be used.

Parameters:

type - of the exception, should be one of the constaints defined in this class.

object - that is throwing the exception

key - property key that failed validation

value - that failed validation

Method Detail

getMessage

public java.lang.String getMessage()

Gets the message for this exception.

Overrides:

getMessage in class java.lang.Throwable

Returns:

the correctly formatted validation exception.

_getMessage

protected java.lang.String _getMessage()

valueForKey

public java.lang.Object valueForKey(java.lang.String key)

Implementation of key value coding. Uses the default implementation.

Specified by:

valueForKey in interface com.webobjects.foundation.NSKeyValueCoding

Parameters:

key - to look up

Returns:

result of the lookup on the object

takeValueForKey

public void takeValueForKey(java.lang.Object obj,
                            java.lang.String key)

Implementation of the key value coding. Uses the default implementation.

Specified by:

takeValueForKey in interface com.webobjects.foundation.NSKeyValueCoding

Parameters:

obj - value to be set on this exception

key - to be set

isCustomMethodException

public boolean isCustomMethodException()

Convience method to determine if this exception was a custom thrown exception instead of a model thrown exception. A custom exception would be an exception that you throw in your validateFoo method if a particular constraint is not valid.

Returns:

if this exception is a custom thrown exception.

method

public java.lang.String method()

Returns method name. The method name is only set if the validation exception is a custom validation exception.

Returns:

custom method name.

setMethod

public void setMethod(java.lang.String aMethod)

Sets the custom method name that threw the validation exception.

Parameters:

aMethod - name to be set.

eoObject

public com.webobjects.eocontrol.EOEnterpriseObject eoObject()

Cover method that casts the object of the validation exception to an EOEnterpriseObject.

Returns:

object cast as an enterprise object.

object

public java.lang.Object object()

Overrides super implementation to allow for setable object value.

Overrides:

object in class com.webobjects.foundation.NSValidation.ValidationException

Returns:

object object for this exception.

propertyKey

public java.lang.String propertyKey()

Cover method for returning the key of the validation exception under the name propertyKey.

Returns:

the key of the validation exception

attribute

public com.webobjects.eoaccess.EOAttribute attribute()

Cover method for getting the attribute corresponding to the propertyKey and entity off of the objet.

Returns:

EOAttribute corresponding to the propertyKey and entity.

type

public java.lang.String type()

Cover method to return the type of the validation exception. The corresponds to one of the constant strings defined in this class.

Returns:

the type of this validation exception.

setType

public void setType(java.lang.String aType)

Sets the validation type of this exception. Should correspond to one of the type constants defined in this class. All of the model thrown validation exceptions should have the correct type already set.

Parameters:

aType - name to set on this validation exception.

value

public java.lang.Object value()

Returns the value that failed validation.

Returns:

failed validation value.

setValue

public void setValue(java.lang.Object aValue)

Sets the value that failed validation.

Parameters:

aValue - that failed validation

setObject

public void setObject(java.lang.Object aValue)

Sets the object that failed validation.

Parameters:

aValue - object that failed validation

targetLanguage

public java.lang.String targetLanguage()

Returns the target language to display the validation message in. If a target language is not set then the current default language for the current thread is used.

Returns:

target language if one is set.

setTargetLanguage

public void setTargetLanguage(java.lang.String aValue)

Sets the target language to use when rendering the validation message. Only set a target language if you want to override the current language of the thread.

Parameters:

aValue - name fo the language to render the validation exception in.

delegate

public java.lang.Object delegate()

Gets the current delegate for this validation exception. If one is not set then the default delegate for the ERXValidationFactory is returned.

Returns:

delegate for this validation exception.

setDelegate

public void setDelegate(java.lang.Object obj)

Sets the delegate for the current validation exception. The delegate can intervine to provide a different template for the validation exception or resolve the template in a different manner.

Parameters:

obj - delegate to be used for this validation exception.

context

public com.webobjects.foundation.NSKeyValueCoding context()

The current context of the validation exception. Context objects are mainly used for resolving keys in validation templates. When validation exceptions are thrown in D2W pages the current D2WContext is set as the current context on the exceptions. If a context is not set then the contextForException is called off of the default ERXValidationFactory. When this also returns null, then the exception will be used as its context. This is needed because of some of the templates in ERDirectToWeb which use context.propertyKey and will display ? if none is given.

Returns:

current context for the validation exception.

setContext

public void setContext(com.webobjects.foundation.NSKeyValueCoding context)

Sets the context that can be used to resolve key bindings in validation templates.

Parameters:

context - of the current exception

setAdditionalExceptions

public void setAdditionalExceptions(com.webobjects.foundation.NSArray exceptions)

Sets the array of additional exceptions that has occurried.

Parameters:

exceptions - array of additional exceptions

additionalExceptions

public com.webobjects.foundation.NSArray additionalExceptions()

Cover method to return any additional exceptions that occurred. The reason this method is needed is because we wanted to have the ability to set the additional exceptions.

Overrides:

additionalExceptions in class com.webobjects.foundation.NSValidation.ValidationException

Returns:

array of additional exceptions

displayNameForProperty

public java.lang.String displayNameForProperty()

Generates a displayable and localized version of the current propertyKey (also called key).

Returns:

localized displayable version of the current propertyKey.

displayNameForEntity

public java.lang.String displayNameForEntity()

Generates a displayable and localized version of the current object's entity name.

Returns:

localized displayable version of an object's entity name.

localizedDisplayNameForKey

protected java.lang.String localizedDisplayNameForKey(java.lang.String key)

Creates a localized display name for a given key trying to localize it with the current "targetLanguage" or the current localizer. If there is an eoObject first try to localize "entityName.key" then "key" if nothing found.

Parameters:

key - to be translated

Returns:

localized display version of the given key.

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object anotherObject)

Compares this exception to anything else.

Overrides:

equals in class java.lang.Object

Returns:

description of the validation exception

toString

public java.lang.String toString()

Returns the formatted description of the validation exception without calling getMessage.

Overrides:

toString in class java.lang.Throwable

Returns:

description of the validation exception