Package org.a2aproject.sdk.server.tasks

Class TaskStoreException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

org.a2aproject.sdk.spec.A2AException

org.a2aproject.sdk.spec.A2AServerException

org.a2aproject.sdk.server.tasks.TaskStoreException

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

TaskPersistenceException, TaskSerializationException

public class TaskStoreException
extends A2AServerException

Base exception for TaskStore persistence layer failures.

Root exception for all task storage and retrieval errors. Specialized subclasses provide specific failure contexts:

• TaskSerializationException - JSON/data format errors
• TaskPersistenceException - Database/storage system failures

Usage Context

Thrown by TaskStore implementations during:

• save(Task, boolean) - Task persistence failures
• get(String) - Task retrieval failures
• delete(String) - Task deletion failures
• list(ListTasksParams, ServerCallContext) - Task listing failures

Error Handling Pattern

Caught by MainEventBusProcessor which:

1. Logs the failure with full context (taskId, operation)
2. Distributes InternalError event to clients
3. Preserves exception cause chain for diagnostics

See Also:

• for data format errors
• for storage system failures
• TaskStore
• Serialized Form

Constructor Summary

Constructors

Constructor	Description
TaskStoreException()	Creates a new TaskStoreException with no message or cause.
TaskStoreException(@Nullable String taskId, String msg)	Creates a new TaskStoreException with the specified task ID and message.
TaskStoreException(@Nullable String taskId, String msg, Throwable cause)	Creates a new TaskStoreException with the specified task ID, message, and cause.
TaskStoreException(String msg)	Creates a new TaskStoreException with the specified message.
TaskStoreException(String msg, Throwable cause)	Creates a new TaskStoreException with the specified message and cause.
TaskStoreException(Throwable cause)	Creates a new TaskStoreException with the specified cause.

Method Summary

Modifier and Type	Method	Description
@Nullable String	getTaskId()	Returns the task ID associated with this exception.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

TaskStoreException

public TaskStoreException()

Creates a new TaskStoreException with no message or cause.

TaskStoreException

public TaskStoreException(String msg)

Creates a new TaskStoreException with the specified message.

Parameters:

msg - the exception message

TaskStoreException

public TaskStoreException(Throwable cause)

Creates a new TaskStoreException with the specified cause.

Parameters:

cause - the underlying cause

TaskStoreException

public TaskStoreException(String msg,
 Throwable cause)

Creates a new TaskStoreException with the specified message and cause.

Parameters:

msg - the exception message

cause - the underlying cause

TaskStoreException

public TaskStoreException(@Nullable String taskId,
 String msg)

Creates a new TaskStoreException with the specified task ID and message.

Parameters:

taskId - the task identifier (may be null for operations not tied to a specific task)

msg - the exception message

TaskStoreException

public TaskStoreException(@Nullable String taskId,
 String msg,
 Throwable cause)

Creates a new TaskStoreException with the specified task ID, message, and cause.

Parameters:

taskId - the task identifier (may be null for operations not tied to a specific task)

msg - the exception message

cause - the underlying cause

Method Details

getTaskId

public @Nullable String getTaskId()

Returns the task ID associated with this exception.

Returns:

the task ID, or null if not associated with a specific task