Class HttpIntakeException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

ai.pipeline.connector.intake.error.IntakeException

ai.pipeline.connector.intake.error.HttpIntakeException

All Implemented Interfaces:

Serializable

public class HttpIntakeException
extends IntakeException

A failure attributable to the HTTP request itself — a malformed shape, a missing header, an undeterminable document identity, or an oversized body.

Always a 4xx: the client can correct it and retry. Carries no upstream detail because none is involved — the request never got far enough to call a dependency. These are the validation rejections raised at the very top of the resource, before any work is attempted.

See Also:

• Serialized Form

Method Summary

Modifier and Type	Method	Description
static HttpIntakeException	badRequest(String clientMessage)	Generic malformed request with an explicit, safe explanation.
static HttpIntakeException	docIdTooLong(int max)	A derived or caller-supplied doc_id exceeds the storable maximum.
static HttpIntakeException	missingHeader(String headerName)	A required header was absent or blank.
static HttpIntakeException	payloadTooLarge()	The declared or streamed body exceeds the permitted size.
static HttpIntakeException	rejected(IntakeErrorCode code, String clientMessage)	A client rejection with an explicit code and curated message — used by policy/security checks (e.g.
static HttpIntakeException	undeterminableDocId()	None of the identity-bearing headers were sufficient to derive a doc_id.

Methods inherited from class IntakeException

clientFacingMessage, clientMessage, code, errorId, httpStatus, isError, trackingToken, withTrackingToken

Methods inherited from class Throwable

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

Methods inherited from class Object

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

Method Details

badRequest

public static HttpIntakeException badRequest(String clientMessage)

Generic malformed request with an explicit, safe explanation.

missingHeader

public static HttpIntakeException missingHeader(String headerName)

A required header was absent or blank.

undeterminableDocId

public static HttpIntakeException undeterminableDocId()

None of the identity-bearing headers were sufficient to derive a doc_id.

payloadTooLarge

public static HttpIntakeException payloadTooLarge()

The declared or streamed body exceeds the permitted size.

docIdTooLong

public static HttpIntakeException docIdTooLong(int max)

A derived or caller-supplied doc_id exceeds the storable maximum.

rejected

public static HttpIntakeException rejected(IntakeErrorCode code,
 String clientMessage)

A client rejection with an explicit code and curated message — used by policy/security checks (e.g. a blocked file type) that decide the code themselves rather than mapping an upstream failure.