Database.Memcache.Errors

Memcached related errors and exception handling.

Error types

data MemcacheError

All exceptions that a Memcached client may throw.

Constructors

OpError Status

Memcached operation error.

ClientError ClientError

Error occuring on client side.

ProtocolError ProtocolError

Errors occurring communicating with Memcached server.

Instances

Eq MemcacheError

Methods

(==) :: MemcacheError -> MemcacheError -> Bool

(/=) :: MemcacheError -> MemcacheError -> Bool

Show MemcacheError

Methods

showsPrec :: Int -> MemcacheError -> ShowS

show :: MemcacheError -> String

showList :: [MemcacheError] -> ShowS

Exception MemcacheError

Methods

toException :: MemcacheError -> SomeException

fromException :: SomeException -> Maybe MemcacheError

displayException :: MemcacheError -> String

data Status

The status (success or error) of a Memcached operation returned in a Response.

Constructors

NoError

Operation successful.

ErrKeyNotFound

Key not found.

ErrKeyExists

Key exists when not expected.

ErrValueTooLarge

Value too large to store at server.

ErrInvalidArgs

Invalid arguments for operation.

ErrItemNotStored

Key-Value pair not stored at server (internal error).

ErrValueNonNumeric

Value not numeric when increment or decrement requested.

ErrUnknownCommand

Server doesn't know requested command.

ErrOutOfMemory

Server out of memory.

SaslAuthFail

SASL authentication failed.

SaslAuthContinue

SASL authentication requires more steps.

Instances

Eq Status

Methods

(==) :: Status -> Status -> Bool

(/=) :: Status -> Status -> Bool

Show Status

Methods

showsPrec :: Int -> Status -> ShowS

show :: Status -> String

showList :: [Status] -> ShowS

data ClientError

Errors that occur on the client.

Constructors

NoServersReady

All servers are currently marked failed.

Timeout

Timeout occurred sending request to server.

Instances

Eq ClientError

Methods

(==) :: ClientError -> ClientError -> Bool

(/=) :: ClientError -> ClientError -> Bool

Show ClientError

Methods

showsPrec :: Int -> ClientError -> ShowS

show :: ClientError -> String

showList :: [ClientError] -> ShowS

data ProtocolError

Errors related to Memcached protocol and bytes on the wire.

Constructors

UnknownPkt

Received an unknown response packet.

Fields

• protocolError :: String

UnknownOp

Unknown Memcached operation.

Fields

• protocolError :: String

UnknownStatus

Unknown Memcached status field value.

Fields

• protocolError :: String

BadLength

Unexpected length of a Memcached field (extras, key, or value).

Fields

• protocolError :: String

WrongOp

Response packet is for a different operation than expected.

Fields

• protocolError :: String

UnexpectedEOF

Network socket closed without receiving enough bytes.

Fields

• protocolError :: String

Instances

Eq ProtocolError

Methods

(==) :: ProtocolError -> ProtocolError -> Bool

(/=) :: ProtocolError -> ProtocolError -> Bool

Show ProtocolError

Methods

showsPrec :: Int -> ProtocolError -> ShowS

show :: ProtocolError -> String

showList :: [ProtocolError] -> ShowS

Error creation

throwStatus :: Status -> IO a

Convert a status to MemcacheError exception.

wrongOp :: Response -> String -> MemcacheError

Create a properly formatted WrongOp protocol error.