When encountering an invalid time zone offset, produce a more informa…

…tive error and ensure that declaration validation encapsulates the error with a status event, rather than an exception, #24.
NOAA-OWP · Jul 3, 2024 · 8e6f4d7 · 8e6f4d7
1 parent 5b07a6e
commit 8e6f4d7
Show file tree

Hide file tree

Showing 3 changed files with 46 additions and 7 deletions.
diff --git a/wres-config/src/wres/config/yaml/DeclarationFactory.java b/wres-config/src/wres/config/yaml/DeclarationFactory.java
@@ -22,6 +22,7 @@
 import com.fasterxml.jackson.core.JsonParser;
 import com.fasterxml.jackson.core.JsonProcessingException;
 import com.fasterxml.jackson.core.io.IOContext;
+import com.fasterxml.jackson.databind.JsonMappingException;
 import com.fasterxml.jackson.databind.SerializationFeature;
 import com.fasterxml.jackson.dataformat.yaml.YAMLFactory;
 import com.fasterxml.jackson.dataformat.yaml.YAMLGenerator;
@@ -464,8 +465,15 @@ static JsonSchema getSchema() throws IOException
 
     static EvaluationDeclaration deserialize( JsonNode declaration ) throws IOException
     {
-        return DESERIALIZER.reader()
-                           .readValue( declaration, EvaluationDeclaration.class );
+        try
+        {
+            return DESERIALIZER.reader()
+                               .readValue( declaration, EvaluationDeclaration.class );
+        }
+        catch ( JsonMappingException e )
+        {
+            throw new IOException( "Failed to deserialize an evaluation declaration.", e );
+        }
     }
 
     /**

diff --git a/wres-config/src/wres/config/yaml/DeclarationValidator.java b/wres-config/src/wres/config/yaml/DeclarationValidator.java
@@ -205,11 +205,30 @@ public static List<EvaluationStatusEvent> validate( String yaml,
         // schema validation errors: see #57969
         if ( schemaEvents.isEmpty() )
         {
-            EvaluationDeclaration deserialized = DeclarationFactory.deserialize( declaration );
+            try
+            {
+                EvaluationDeclaration deserialized = DeclarationFactory.deserialize( declaration );
+
+                // Validate against business logic
+                List<EvaluationStatusEvent> businessEvents = DeclarationValidator.validate( deserialized, omitSources );
+                events.addAll( businessEvents );
+            }
+            // Catch exceptions here that can occur during deserialization
+            catch ( IOException | DeclarationException e )
+            {
+                EvaluationStatusEvent error =
+                        EvaluationStatusEvent.newBuilder()
+                                             .setStatusLevel( StatusLevel.ERROR )
+                                             .setEventMessage( "Failed to deserialize and fully validate the "
+                                                               + "declaration because it contains errors: "
+                                                               + "please fix the declaration and try "
+                                                               + "again. The cause of the error was: \n"
+                                                               + e.getCause()
+                                                                  .getMessage() )
+                                             .build();
 
-            // Validate against business logic
-            List<EvaluationStatusEvent> businessEvents = DeclarationValidator.validate( deserialized, omitSources );
-            events.addAll( businessEvents );
+                return List.of( error );
+            }
         }
 
         return Collections.unmodifiableList( events );

diff --git a/wres-config/src/wres/config/yaml/deserializers/ZoneOffsetDeserializer.java b/wres-config/src/wres/config/yaml/deserializers/ZoneOffsetDeserializer.java
@@ -15,6 +15,8 @@
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
+import wres.config.yaml.DeclarationException;
+
 /**
  * Custom deserializer for a {@link ZoneId} that admits several informal shorthands, as well as all named time zones
  * accepted by {@link ZoneId#of(String)}.
@@ -115,7 +117,17 @@ public static ZoneOffset getZoneOffset( String zoneOffset )
         // Otherwise, pass through directly
         else
         {
-            return ZoneOffset.of( zoneOffset );
+            try
+            {
+                return ZoneOffset.of( zoneOffset );
+            }
+            catch ( DateTimeException e )
+            {
+                throw new DeclarationException( "Failed to deserialize a 'time_zone_offset'. Please use a valid offset "
+                                                + "name, such as 'EST' or a valid ISO 8601 UTC offset, such as "
+                                                + "'-05:00'.",
+                                                e );
+            }
         }
     }
 }