alluxio.client.file.cache

Class NoExceptionCacheManager

java.lang.Object

alluxio.client.file.cache.NoExceptionCacheManager

All Implemented Interfaces:

CacheManager, java.lang.AutoCloseable

public class NoExceptionCacheManager
extends java.lang.Object
implements CacheManager

A wrapper class of CacheManager without throwing unchecked exceptions.

Nested Class Summary

Nested classes/interfaces inherited from interface alluxio.client.file.cache.CacheManager

CacheManager.Factory, CacheManager.State

Constructor Summary

Constructors

Constructor and Description
NoExceptionCacheManager(CacheManager cacheManager)

Method Summary

Modifier and Type	Method and Description
boolean	append(PageId pageId, int appendAt, byte[] page, CacheContext cacheContext)
void	close()
boolean	delete(PageId pageId) Deletes a page from the cache.
int	get(PageId pageId, int bytesToRead, byte[] buffer, int offsetInBuffer) Reads the entire page if the queried page is found in the cache, stores the result in buffer.
int	get(PageId pageId, int pageOffset, int bytesToRead, byte[] buffer, int offsetInBuffer) Reads a part of a page if the queried page is found in the cache, stores the result in buffer.
int	get(PageId pageId, int pageOffset, int bytesToRead, byte[] buffer, int offsetInBuffer, CacheContext cacheContext) Reads a part of a page if the queried page is found in the cache, stores the result in buffer.
int	get(PageId pageId, int pageOffset, int bytesToRead, PageReadTargetBuffer buffer, CacheContext cacheContext) Reads a part of a page if the queried page is found in the cache, stores the result in buffer.
java.util.List<PageId>	getCachedPageIdsByFileId(java.lang.String fileId, long fileLength) Get page ids by the given file id.
boolean	put(PageId pageId, byte[] page) Puts a page into the cache manager.
boolean	put(PageId pageId, java.nio.ByteBuffer page, CacheContext cacheContext) Puts a page into the cache manager with scope and quota respected.
CacheManager.State	state()

Methods inherited from class java.lang.Object

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

Methods inherited from interface alluxio.client.file.cache.CacheManager

put, put

Constructor Detail

NoExceptionCacheManager

public NoExceptionCacheManager(CacheManager cacheManager)

Parameters:

cacheManager - delegated cache manager

Method Detail

put

public boolean put(PageId pageId,
                   byte[] page)

Description copied from interface: CacheManager

Puts a page into the cache manager. This method is best effort. It is possible that this put operation returns without page written.

Specified by:

put in interface CacheManager

Parameters:

pageId - page identifier

page - page data

Returns:

true if the put was successful, false otherwise

put

public boolean put(PageId pageId,
                   java.nio.ByteBuffer page,
                   CacheContext cacheContext)

Description copied from interface: CacheManager

Puts a page into the cache manager with scope and quota respected. This method is best effort. It is possible that this put operation returns without page written.

Specified by:

put in interface CacheManager

Parameters:

pageId - page identifier

page - page data

cacheContext - cache related context

Returns:

true if the put was successful, false otherwise

get

public int get(PageId pageId,
               int bytesToRead,
               byte[] buffer,
               int offsetInBuffer)

Description copied from interface: CacheManager

Reads the entire page if the queried page is found in the cache, stores the result in buffer.

Specified by:

get in interface CacheManager

Parameters:

pageId - page identifier

bytesToRead - number of bytes to read in this page

buffer - destination buffer to write

offsetInBuffer - offset in the destination buffer to write

Returns:

number of bytes read, 0 if page is not found, -1 on errors

get

public int get(PageId pageId,
               int pageOffset,
               int bytesToRead,
               byte[] buffer,
               int offsetInBuffer)

Description copied from interface: CacheManager

Reads a part of a page if the queried page is found in the cache, stores the result in buffer.

Specified by:

get in interface CacheManager

Parameters:

pageId - page identifier

pageOffset - offset into the page

bytesToRead - number of bytes to read in this page

buffer - destination buffer to write

offsetInBuffer - offset in the destination buffer to write

Returns:

number of bytes read, 0 if page is not found, -1 on errors

get

public int get(PageId pageId,
               int pageOffset,
               int bytesToRead,
               byte[] buffer,
               int offsetInBuffer,
               CacheContext cacheContext)

Description copied from interface: CacheManager

Reads a part of a page if the queried page is found in the cache, stores the result in buffer.

Specified by:

get in interface CacheManager

Parameters:

pageId - page identifier

pageOffset - offset into the page

bytesToRead - number of bytes to read in this page

buffer - destination buffer to write

offsetInBuffer - offset in the destination buffer to write

cacheContext - cache related context

Returns:

number of bytes read, 0 if page is not found, -1 on errors

get

public int get(PageId pageId,
               int pageOffset,
               int bytesToRead,
               PageReadTargetBuffer buffer,
               CacheContext cacheContext)

Description copied from interface: CacheManager

Reads a part of a page if the queried page is found in the cache, stores the result in buffer.

Specified by:

get in interface CacheManager

Parameters:

pageId - page identifier

pageOffset - offset into the page

bytesToRead - number of bytes to read in this page

buffer - destination buffer to write

cacheContext - cache related context

Returns:

number of bytes read, 0 if page is not found, -1 on errors

delete

public boolean delete(PageId pageId)

Description copied from interface: CacheManager

Deletes a page from the cache.

Specified by:

delete in interface CacheManager

Parameters:

pageId - page identifier

Returns:

true if the page is successfully deleted, false otherwise

state

public CacheManager.State state()

Specified by:

state in interface CacheManager

Returns:

state of this cache

append

public boolean append(PageId pageId,
                      int appendAt,
                      byte[] page,
                      CacheContext cacheContext)

Specified by:

append in interface CacheManager

Returns:

true if append was successful

close

public void close()
           throws java.lang.Exception

Specified by:

close in interface java.lang.AutoCloseable

Throws:

java.lang.Exception

getCachedPageIdsByFileId

public java.util.List<PageId> getCachedPageIdsByFileId(java.lang.String fileId,
                                                       long fileLength)

Description copied from interface: CacheManager

Get page ids by the given file id.

Specified by:

getCachedPageIdsByFileId in interface CacheManager

Parameters:

fileId - file identifier

fileLength - file length (this will not be needed after we have per-file metadata)

Returns:

a list of page ids which belongs to the file