Interface BaseMemcacheService
-
- All Known Subinterfaces:
- AsyncMemcacheService, MemcacheService
public interface BaseMemcacheService
Methods that are common betweenMemcacheService
andAsyncMemcacheService
.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method and Description ErrorHandler
getErrorHandler()
Fetches the current error handler.java.lang.String
getNamespace()
Method returns non-null value if the MemcacheService overrides the default namespace in API calls.void
setErrorHandler(ErrorHandler handler)
Registers a newErrorHandler
.
-
-
-
Method Detail
-
getNamespace
java.lang.String getNamespace()
Method returns non-null value if the MemcacheService overrides the default namespace in API calls. Default namespace is the one returned byNamespaceManager.get()
.- Returns:
null
if the MemcacheService uses default namespace in API calls. Otherwise it returnsnamespace
which is overrides default namespace on the API calls.
-
getErrorHandler
ErrorHandler getErrorHandler()
Fetches the current error handler. SeesetErrorHandler(ErrorHandler)
.
-
setErrorHandler
void setErrorHandler(ErrorHandler handler)
Registers a newErrorHandler
. Thehandler
is called for errors which are not the application's fault, like a network timeout. The handler can choose to propagate the error or suppress it. Errors which are caused by an incorrect use of the API will not be directed to thehandler
but rather will be thrown directly.The default error handler is an instance of
LogAndContinueErrorHandler
. In most cases, this will log exceptions without throwing, which looks like a cache-miss behavior to the caller. A less permissive alternative isStrictErrorHandler
, which will throw aMemcacheServiceException
to surface errors to callers.To guarantee that all instances of
MemcacheServiceException
are directed to the error handler, use aConsistentErrorHandler
such asErrorHandlers.getConsistentLogAndContinue(Level)
orErrorHandlers.getStrict()
.- Parameters:
handler
- the newErrorHandler
to use
-
-