Package org.mockserver.grpc.connect

Class ConnectError

java.lang.Object

org.mockserver.grpc.connect.ConnectError

public class ConnectError
extends Object

A Connect protocol (buf.build Connect) unary error.

Connect unary errors are returned as a non-200 HTTP response with a JSON body of the shape:

 {
   "code": "not_found",
   "message": "...",
   "details": [ ... ]
 }
 

where code is one of the canonical Connect error code strings. Connect error codes are the lower-case snake_case forms of the gRPC status names (e.g. gRPC INVALID_ARGUMENT -> Connect invalid_argument), and each maps to a specific HTTP status code per the Connect specification (https://connectrpc.com/docs/protocol#error-codes).

The HTTP status mapping mirrors the Connect reference implementation's codeToHTTP (connectrpc/connect-go), which is in turn consistent with GrpcStatusMapper. There is no Connect code for gRPC OK; a successful unary response is an HTTP 200 with the message body, not an error envelope.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	ConnectError.Code	The canonical Connect error codes.

Constructor Summary

Constructors

Constructor	Description
ConnectError()
ConnectError(ConnectError.Code code, String message)

Method Summary

Modifier and Type	Method	Description
ConnectError	addDetail(Object detail)
static ConnectError	connectError(String code, String message)
static ConnectError	connectError(ConnectError.Code code, String message)
String	getCode()
List<Object>	getDetails()
String	getMessage()
int	httpStatus()	The HTTP status this error maps to, resolved via ConnectError.Code.fromString(String) so an unrecognised or null code degrades to the unknown mapping (HTTP 500).
ConnectError	setCode(String code)
ConnectError	setDetails(List<Object> details)
ConnectError	setMessage(String message)

Methods inherited from class java.lang.Object

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

Constructor Details

ConnectError

public ConnectError()

ConnectError

public ConnectError(ConnectError.Code code,
 String message)

Method Details

connectError

public static ConnectError connectError(ConnectError.Code code,
 String message)

connectError

public static ConnectError connectError(String code,
 String message)

getCode

public String getCode()

setCode

public ConnectError setCode(String code)

getMessage

public String getMessage()

setMessage

public ConnectError setMessage(String message)

getDetails

public List<Object> getDetails()

setDetails

public ConnectError setDetails(List<Object> details)

addDetail

public ConnectError addDetail(Object detail)

httpStatus

public int httpStatus()

The HTTP status this error maps to, resolved via ConnectError.Code.fromString(String) so an unrecognised or null code degrades to the unknown mapping (HTTP 500).