Siphalor/tweed5
1
0
Fork 0
Code Issues 6 Pull Requests Packages Projects 1 Releases Wiki Activity

[serde-api, serde-extension] Make handling of data read exceptions more explicit

Browse Source
This commit is contained in:
Siphalor
2025-06-29 00:08:06 +02:00
parent 25faea92d8
commit 35768550d3
3 changed files with 101 additions and 63 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
tweed5-serde-api/src/main/java/de/siphalor/tweed5/dataapi/api/TweedDataReadException.java
View File

@@ -6,7 +6,7 @@ import lombok.Setter;
import org.jspecify.annotations.Nullable;
@Getter
public class TweedDataReadException extends RuntimeException {
public class TweedDataReadException extends Exception {
@Nullable
private final TweedDataReaderRecoverMode recoverMode;

5
tweed5-serde-extension/src/main/java/de/siphalor/tweed5/data/extension/impl/ReadWriteExtensionImpl.java
View File

@@ -9,7 +9,6 @@ import de.siphalor.tweed5.core.api.middleware.DefaultMiddlewareContainer;
import de.siphalor.tweed5.data.extension.api.*;
import de.siphalor.tweed5.data.extension.api.extension.ReadWriteExtensionSetupContext;
import de.siphalor.tweed5.data.extension.api.extension.ReadWriteRelatedExtension;
import de.siphalor.tweed5.dataapi.api.TweedDataReadException;
import de.siphalor.tweed5.dataapi.api.TweedDataReader;
import de.siphalor.tweed5.dataapi.api.TweedDataVisitor;
import de.siphalor.tweed5.dataapi.api.TweedDataWriteException;
@@ -146,11 +145,7 @@ public class ReadWriteExtensionImpl implements ReadWriteExtension {
Patchwork contextExtensionsData
) throws TweedEntryReadException {
TweedReadContext context = new TweedReadWriteContextImpl(this, contextExtensionsData);
try {
return getReaderChain(entry).read(reader, entry, context);
} catch (TweedDataReadException e) {
throw new TweedEntryReadException("Failed to read entry", e, context);
}
}
@Override

67
tweed5-serde-extension/src/main/java/de/siphalor/tweed5/data/extension/impl/TweedEntryReaderWriterImpls.java
View File

@@ -9,12 +9,11 @@ import de.siphalor.tweed5.dataapi.api.*;
import lombok.AccessLevel;
import lombok.NoArgsConstructor;
import lombok.RequiredArgsConstructor;
import lombok.var;
import org.jetbrains.annotations.Contract;
import org.jspecify.annotations.Nullable;
import java.util.*;
import java.util.function.BiConsumer;
import java.util.function.Function;
import java.util.function.Predicate;
@NoArgsConstructor(access = AccessLevel.PRIVATE)
@@ -39,10 +38,14 @@ public class TweedEntryReaderWriterImpls {
@Override
public T read(TweedDataReader reader, C entry, TweedReadContext context) throws TweedEntryReadException {
try {
if (reader.peekToken().isNull()) {
reader.readToken();
return null;
}
} catch (TweedDataReadException e) {
throw new TweedEntryReadException(e, context);
}
return delegate.read(reader, entry, context);
}
}
@@ -62,19 +65,24 @@ public class TweedEntryReaderWriterImpls {
}
@RequiredArgsConstructor
private static class PrimitiveReaderWriter<T extends @Nullable Object> implements TweedEntryReaderWriter<T, ConfigEntry<T>> {
private final Function<TweedDataToken, T> readerCall;
private final BiConsumer<TweedDataVisitor, T> writerCall;
private static class PrimitiveReaderWriter<T> implements TweedEntryReaderWriter<T, ConfigEntry<T>> {
private final PrimitiveReadFunction<T> readerFunction;
private final PrimitiveWriteFunction<T> writerFunction;
@Override
public T read(TweedDataReader reader, ConfigEntry<T> entry, TweedReadContext context) {
return readerCall.apply(reader.readToken());
public T read(TweedDataReader reader, ConfigEntry<T> entry, TweedReadContext context)
throws TweedEntryReadException {
try {
return readerFunction.read(reader.readToken());
} catch (TweedDataReadException e) {
throw new TweedEntryReadException(e, context);
}
}
@Override
public void write(TweedDataVisitor writer, @Nullable T value, ConfigEntry<T> entry, TweedWriteContext context) throws TweedEntryWriteException, TweedDataWriteException {
requireNonNullWriteValue(value, context);
writerCall.accept(writer, value);
writerFunction.write(writer, value);
}
}
@@ -82,8 +90,13 @@ public class TweedEntryReaderWriterImpls {
@Override
public C read(TweedDataReader reader, CollectionConfigEntry<T, C> entry, TweedReadContext context) throws
TweedEntryReadException {
TweedDataToken token;
try {
assertIsToken(reader.readToken(), TweedDataToken::isListStart, "Expected list start", context);
TweedDataToken token = reader.peekToken();
token = reader.peekToken();
} catch (TweedDataReadException e) {
throw new TweedEntryReadException("Failed reading collection start", e, context);
}
if (token.isListEnd()) {
return entry.instantiateCollection(0);
}
@@ -93,6 +106,7 @@ public class TweedEntryReaderWriterImpls {
List<@Nullable T> list = new ArrayList<>(20);
while (true) {
try {
token = reader.peekToken();
if (token.isListEnd()) {
reader.readToken();
@@ -105,6 +119,13 @@ public class TweedEntryReaderWriterImpls {
context
);
}
} catch (TweedDataReadException e) {
throw new TweedEntryReadException(
"Failed reading element " + list.size() + " of collection",
e,
context
);
}
}
C result = entry.instantiateCollection(list.size());
@@ -113,7 +134,8 @@ public class TweedEntryReaderWriterImpls {
}
@Override
public void write(TweedDataVisitor writer, C value, CollectionConfigEntry<T, C> entry, TweedWriteContext context) throws TweedEntryWriteException, TweedDataWriteException {
public void write(TweedDataVisitor writer, C value, CollectionConfigEntry<T, C> entry, TweedWriteContext context)
throws TweedEntryWriteException, TweedDataWriteException {
requireNonNullWriteValue(value, context);
if (value.isEmpty()) {
@@ -136,11 +158,16 @@ public class TweedEntryReaderWriterImpls {
@Override
public T read(TweedDataReader reader, CompoundConfigEntry<T> entry, TweedReadContext context) throws
TweedEntryReadException {
try {
assertIsToken(reader.readToken(), TweedDataToken::isMapStart, "Expected map start", context);
} catch (TweedDataReadException e) {
throw new TweedEntryReadException("Failed reading compound start", e, context);
}
Map<String, ConfigEntry<?>> compoundEntries = entry.subEntries();
T compoundValue = entry.instantiateCompoundValue();
while (true) {
try {
TweedDataToken token = reader.readToken();
if (token.isMapEnd()) {
break;
@@ -149,7 +176,7 @@ public class TweedEntryReaderWriterImpls {
//noinspection unchecked
ConfigEntry<Object> subEntry = (ConfigEntry<Object>) compoundEntries.get(key);
TweedEntryReader<Object, ConfigEntry<Object>> subEntryReaderChain = context.readWriteExtension().getReaderChain(subEntry);
var subEntryReaderChain = context.readWriteExtension().getReaderChain(subEntry);
Object subEntryValue = subEntryReaderChain.read(reader, subEntry, context);
entry.set(compoundValue, key, subEntryValue);
} else {
@@ -158,6 +185,9 @@ public class TweedEntryReaderWriterImpls {
context
);
}
} catch (TweedDataReadException e) {
throw new TweedEntryReadException("Failed reading compound entry", e, context);
}
}
return compoundValue;
}
@@ -186,7 +216,9 @@ public class TweedEntryReaderWriterImpls {
public static class NoopReaderWriter implements TweedEntryReaderWriter<@Nullable Object, ConfigEntry<Object>> {
@Override
public @Nullable Object read(TweedDataReader reader, ConfigEntry<Object> entry, TweedReadContext context) {
public @Nullable Object read(TweedDataReader reader, ConfigEntry<Object> entry, TweedReadContext context)
throws TweedEntryReadException {
try {
TweedDataToken token = reader.readToken();
if (!token.isListStart() && !token.isMapStart()) {
return null;
@@ -212,6 +244,9 @@ public class TweedEntryReaderWriterImpls {
return null;
}
}
} catch (TweedDataReadException e) {
throw new TweedEntryReadException("Failed skipping through value", e, context);
}
}
@Override
@@ -224,6 +259,14 @@ public class TweedEntryReaderWriterImpls {
}
}
private interface PrimitiveReadFunction<T extends Object> {
T read(TweedDataToken token) throws TweedDataReadException;
}
private interface PrimitiveWriteFunction<T extends Object> {
void write(TweedDataVisitor writer, T value) throws TweedDataWriteException;
}
@Contract("null, _ -> fail")
private static <T> void requireNonNullWriteValue(
@Nullable T value,