errors.go 3.0 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667
  1. package protocol
  2. import "errors"
  3. // KError is the type of error that can be returned directly by the Kafka broker.
  4. // See https://cwiki.apache.org/confluence/display/KAFKA/A+Guide+To+The+Kafka+Protocol#AGuideToTheKafkaProtocol-ErrorCodes
  5. type KError int16
  6. const (
  7. NO_ERROR KError = 0
  8. UNKNOWN KError = -1
  9. OFFSET_OUT_OF_RANGE KError = 1
  10. INVALID_MESSAGE KError = 2
  11. UNKNOWN_TOPIC_OR_PARTITION KError = 3
  12. INVALID_MESSAGE_SIZE KError = 4
  13. LEADER_NOT_AVAILABLE KError = 5
  14. NOT_LEADER_FOR_PARTITION KError = 6
  15. REQUEST_TIMED_OUT KError = 7
  16. BROKER_NOT_AVAILABLE KError = 8
  17. REPLICA_NOT_AVAILABLE KError = 9
  18. MESSAGE_SIZE_TOO_LARGE KError = 10
  19. STALE_CONTROLLER_EPOCH_CODE KError = 11
  20. OFFSET_METADATA_TOO_LARGE KError = 12
  21. )
  22. func (err KError) Error() string {
  23. // Error messages stolen/adapted from
  24. // https://cwiki.apache.org/confluence/display/KAFKA/A+Guide+To+The+Kafka+Protocol
  25. switch err {
  26. case NO_ERROR:
  27. return "kafka server: Not an error, why are you printing me?"
  28. case UNKNOWN:
  29. return "kafka server: Unexpected (unknown?) server error."
  30. case OFFSET_OUT_OF_RANGE:
  31. return "kafka server: The requested offset is outside the range of offsets maintained by the server for the given topic/partition."
  32. case INVALID_MESSAGE:
  33. return "kafka server: Message contents does not match its CRC."
  34. case UNKNOWN_TOPIC_OR_PARTITION:
  35. return "kafka server: Request was for a topic or partition that does not exist on this broker."
  36. case INVALID_MESSAGE_SIZE:
  37. return "kafka server: The message has a negative size."
  38. case LEADER_NOT_AVAILABLE:
  39. return "kafka server: In the middle of a leadership election, there is currently no leader for this partition and hence it is unavailable for writes."
  40. case NOT_LEADER_FOR_PARTITION:
  41. return "kafka server: Tried to send a message to a replica that is not the leader for some partition. Your metadata is out of date."
  42. case REQUEST_TIMED_OUT:
  43. return "kafka server: Request exceeded the user-specified time limit in the request."
  44. case BROKER_NOT_AVAILABLE:
  45. return "kafka server: Broker not available. Not a client facing error, we should never receive this!!!"
  46. case REPLICA_NOT_AVAILABLE:
  47. return "kafka server: Replica not available. What is the difference between this and LeaderNotAvailable?"
  48. case MESSAGE_SIZE_TOO_LARGE:
  49. return "kafka server: Message was too large, server rejected it to avoid allocation error."
  50. case STALE_CONTROLLER_EPOCH_CODE:
  51. return "kafka server: Stale controller epoch code. ???"
  52. case OFFSET_METADATA_TOO_LARGE:
  53. return "kafka server: Specified a string larger than the configured maximum for offset metadata."
  54. default:
  55. return "Unknown error, how did this happen?"
  56. }
  57. }
  58. // AlreadyConnected is the error returned when calling Connect() on a Broker that is already connected.
  59. var AlreadyConnected = errors.New("kafka: broker: already connected")
  60. // NotConnected is the error returned when trying to send or call Close() on a Broker that is not connected.
  61. var NotConnected = errors.New("kafka: broker: not connected")