FieldMutationException class final

Exception thrown when writing to a field or setter fails on a given type.

This error is typically raised when:

• The specified field does not exist
• Access to the field or setter is restricted (e.g., private or final)
• The resolver attempts dynamic field mutation using reflection or metadata

Extends RuntimeResolverException, inheriting support for:

• message — a description of the error
• cause — optional underlying exception
• stackTrace — optional diagnostic stack trace

Usage Example

throw FieldMutationException(
  "User",
  "email",
  cause: NoSuchMethodError(),
);

Design Notes

• Provides clear diagnostics including both type and field name.
• Supports exception chaining for better debugging.
• Indicates a terminal resolution error; cannot automatically recover.

Example Behavior

Type	Field/Setter	Result
User	email	❌ Throws if field missing or inaccessible
Config	version	❌ Throws if setter not available
Widget	final property	❌ Throws on restricted write access

See Also

• RuntimeResolverException
• RuntimeException
• NoSuchMethodError

Inheritance

• Object
• Error
• RuntimeException
• RuntimeResolverException
• FieldMutationException

Available extensions

• ErrorExtensions
• ExceptionExtensions
• RuntimeExceptionExtensions
• ThrowableExtensions

Constructors

FieldMutationException(Object type, String fieldName, {Object? cause, StackTrace? stack})

Exception thrown when writing to a field or setter fails on a given type.

Properties

cause → Object?

The underlying cause of this exception, if any.

final, inherited

hashCode → int

The hash code for this object.

no setter, inherited

message → String

The message describing the error.

final, inherited

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

stackTrace → StackTrace

The associated stack trace.

final, inherited

Methods

getCause() → Object

The cause of this exception, if any.

inherited

getMessage() → String

The message associated with this exception.

inherited

getStackTrace() → StackTrace

The stack trace associated with this exception.

inherited

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

printStackTrace([bool useErrorPrint = false]) → void

Available on Error, provided by the ErrorExtensions extension

Prints the error along with its stack trace.

printStackTrace([StackTrace? stacktrace, bool useErrorPrint = false]) → void

Available on Exception, provided by the ExceptionExtensions extension

Prints the exception and optional StackTrace if available.

printStackTrace([bool useErrorPrint = false]) → void

Available on RuntimeException, provided by the RuntimeExceptionExtensions extension

Extension on RuntimeException to support pretty stack trace printing.

printStackTrace([bool useErrorPrint = false]) → void

Available on Throwable, provided by the ThrowableExtensions extension

Extension on Throwable to support printing stack traces in a unified way.

toString() → String

A string representation of this object.

inherited

Operators

operator ==(Object other) → bool

The equality operator.

inherited