Module dev.metaschema.databind

Package dev.metaschema.databind.io

Interface IProblemHandler

All Known Subinterfaces:

IJsonProblemHandler, IXmlProblemHandler

All Known Implementing Classes:

AbstractProblemHandler, DefaultJsonProblemHandler, DefaultXmlProblemHandler

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
public interface IProblemHandler

Implementations support handling common parsing issues.

Method Summary

Modifier and Type	Method	Description
void	handleMissingInstances(IBoundDefinitionModelComplex parentDefinition, IBoundObject targetObject, Collection<? extends IBoundProperty<?>> unhandledInstances)	A callback used to handle bound properties for which no data was found when the content was parsed.
default void	handleMissingInstances(IBoundDefinitionModelComplex parentDefinition, IBoundObject targetObject, Collection<? extends IBoundProperty<?>> unhandledInstances, ValidationContext context)	A callback used to handle bound properties for which no data was found when the content was parsed, with additional validation context.

Method Details

handleMissingInstances

void handleMissingInstances(@NonNull
 IBoundDefinitionModelComplex parentDefinition,
 @NonNull
 IBoundObject targetObject,
 @NonNull
 Collection<? extends IBoundProperty<?>> unhandledInstances)
                     throws IOException

A callback used to handle bound properties for which no data was found when the content was parsed.

This can be used to supply default or prescribed values based on application logic.

Parameters:

parentDefinition - the bound class on which the missing properties are found

targetObject - the Java object for the parentDefinition

unhandledInstances - the set of instances that had no data to parse

Throws:

IOException - if an error occurred while handling the missing instances

handleMissingInstances

default void handleMissingInstances(@NonNull
 IBoundDefinitionModelComplex parentDefinition,
 @NonNull
 IBoundObject targetObject,
 @NonNull
 Collection<? extends IBoundProperty<?>> unhandledInstances,
 @Nullable
 ValidationContext context)
                             throws IOException

A callback used to handle bound properties for which no data was found when the content was parsed, with additional validation context.

This method provides richer context information for error messages including source location, document path, and format-specific details.

The default implementation delegates to handleMissingInstances(IBoundDefinitionModelComplex, IBoundObject, Collection) for backward compatibility.

Parameters:

parentDefinition - the bound class on which the missing properties are found

targetObject - the Java object for the parentDefinition

unhandledInstances - the set of instances that had no data to parse

context - the validation context with location and path information, may be null for backward compatibility

Throws:

IOException - if an error occurred while handling the missing instances