Unlike validation errors, which are generated during validation, invalid business state errors must be constructed manually.

To construct an invalid business state error:

InvalidBusinessStateException objects return a collection of StructuredErrorMessage objects indicating why the failure state occurred. Optionally, the StructuredErrorMessage object can contain a StructuredErrorResolution object, which contains a link which can help the user resolve the error.

For example, AvalabilityException is a fully constructed invalid business state error:

  public class AvailabilityException extends EpSystemException implements InvalidBusinessStateException {
      private final List<StructuredErrorMessage> structuredErrorMessages;
  
      public AvailabilityException(final String message, final Collection<StructuredErrorMessage> structuredErrorMessages) {
          super(message);
          this.structuredErrorMessages = structuredErrorMessages == null ? emptyList() : ImmutableList.copyOf(structuredErrorMessages);
      }
        
      @Override
      public List<StructuredErrorMessage< getStructuredErrorMessages() {
          return structuredErrorMessages;
      }
        
      @Override
      public String getExceptionMessage() {
          return getMessage();
      }   
  }