From 70fc0505b223f7bf17d3671d0532773359cf7858 Mon Sep 17 00:00:00 2001
From: Paul Buetow <paul@buetow.org>
Date: Fri, 20 Jun 2025 18:47:45 +0300
Subject: Implement proper exception hierarchy and consistent error handling
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Create base exception classes:
  - VSSimulatorException: Base checked exception for all simulator errors
  - VSSimulatorRuntimeException: Base unchecked exception for unrecoverable errors
- Refactor existing exceptions to extend from base class:
  - VSEventNotCopyableException: Now includes better error messages
  - VSParseIntegerVectorException: Added constructors with cause support
  - VSNegativeNumberException: Added field name and value parameters
- Add new specific exception types:
  - VSConfigurationException: For configuration errors
  - VSSerializationException: For save/load operations
  - VSProcessException: For process-related errors
  - VSProtocolException: For protocol execution errors
- Create VSErrorHandler utility class:
  - Centralized error logging and user notification
  - Consistent error handling patterns
  - Helper methods for warning and error dialogs
- Update exception handling in code:
  - VSClassLoader: Better error messages and specific exception handling
  - Timestamp events: Catch RuntimeException for custom actions
- All 132 unit tests pass

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 .../java/exceptions/VSSerializationException.java  | 42 ++++++++++++++++++++++
 1 file changed, 42 insertions(+)
 create mode 100644 src/main/java/exceptions/VSSerializationException.java

(limited to 'src/main/java/exceptions/VSSerializationException.java')

diff --git a/src/main/java/exceptions/VSSerializationException.java b/src/main/java/exceptions/VSSerializationException.java
new file mode 100644
index 0000000..62594ef
--- /dev/null
+++ b/src/main/java/exceptions/VSSerializationException.java
@@ -0,0 +1,42 @@
+package exceptions;
+
+/**
+ * Exception thrown when serialization or deserialization of simulator objects fails.
+ * This is used when saving or loading simulation states.
+ *
+ * @author Paul C. Buetow
+ */
+public class VSSerializationException extends VSSimulatorException {
+    /** The serial version uid */
+    private static final long serialVersionUID = 1L;
+    
+    /**
+     * Constructs a new serialization exception with the specified detail message.
+     *
+     * @param message the detail message
+     */
+    public VSSerializationException(String message) {
+        super(message);
+    }
+    
+    /**
+     * Constructs a new serialization exception with the specified detail message and cause.
+     *
+     * @param message the detail message
+     * @param cause the cause (typically an IOException)
+     */
+    public VSSerializationException(String message, Throwable cause) {
+        super(message, cause);
+    }
+    
+    /**
+     * Constructs a new serialization exception for a specific object type.
+     *
+     * @param objectType the type of object that failed to serialize
+     * @param operation either "serialize" or "deserialize"
+     * @param cause the underlying cause
+     */
+    public VSSerializationException(String objectType, String operation, Throwable cause) {
+        super(String.format("Failed to %s object of type: %s", operation, objectType), cause);
+    }
+}
\ No newline at end of file
-- 
cgit v1.2.3