Package com.google.appengine.api.memcache

Interface BaseMemcacheService

All Known Subinterfaces:

AsyncMemcacheService, MemcacheService

public interface BaseMemcacheService

Methods that are common between MemcacheService and AsyncMemcacheService.

Method Summary

Modifier and Type	Method	Description
ErrorHandler	getErrorHandler()	Fetches the current error handler.
String	getNamespace()	Method returns non-null value if the MemcacheService overrides the default namespace in API calls.
void	setErrorHandler(ErrorHandler handler)	Registers a new ErrorHandler.

Method Detail

getNamespace

String getNamespace()

Method returns non-null value if the MemcacheService overrides the default namespace in API calls. Default namespace is the one returned by NamespaceManager.get().

Returns:

null if the MemcacheService uses default namespace in API calls. Otherwise it returns namespace which is overrides default namespace on the API calls.

getErrorHandler

ErrorHandler getErrorHandler()

Fetches the current error handler. See setErrorHandler(ErrorHandler).

setErrorHandler

void setErrorHandler(ErrorHandler handler)

Registers a new ErrorHandler. The handler 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 the handler 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 is StrictErrorHandler, which will throw a MemcacheServiceException to surface errors to callers.

To guarantee that all instances of MemcacheServiceException are directed to the error handler, use a ConsistentErrorHandler such as ErrorHandlers.getConsistentLogAndContinue(Level) or ErrorHandlers.getStrict().

Parameters:

handler - the new ErrorHandler to use