com.ceph.rados

Class IoCTX

java.lang.Object

com.ceph.rados.IoCTX

public class IoCTX
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
IoCTX(com.sun.jna.Pointer p) Create a new IO Context object This constructor should never be called, IO Context objects are created by the RADOS class and returned when creating a IO Context there

Method Summary

Methods

Modifier and Type	Method and Description
void	append(java.lang.String oid, byte[] buf) Append data to an object
void	append(java.lang.String oid, byte[] buf, int len)
void	append(java.lang.String oid, java.lang.String buf) Append data to an object
void	clone(java.lang.String dst, long dst_off, java.lang.String src, long src_off, long len) Efficiently copy a portion of one object to another If the underlying filesystem on the OSD supports it, this will be a copy-on-write clone.
long	getAuid() Get the associated auid owner of the current pool
long	getId() Get the pool ID of this context
com.sun.jna.Pointer	getPointer() Return the pointer to the IO Context This method is used internally and by the RADOS class to destroy a IO Context
java.lang.String	getPoolName() Get the pool name of the context
java.lang.String[]	listObjects() List all objects in a pool
void	locatorSetKey(java.lang.String key) Set the locator key
RadosPoolInfo	poolStat() Stat the currently open pool
int	read(java.lang.String oid, int length, long offset, byte[] buf) Read data from an object
void	remove(java.lang.String oid) Remove an object
void	setAuid(long auid) Set the associated auid owner of the current pool
void	snapCreate(java.lang.String snapname) Create a snapshot
java.lang.String	snapGetName(long id) Get the name of a snapshot by it's ID
long	snapGetStamp(long id) Get the timestamp of a snapshot
java.lang.Long[]	snapList() List all snapshots
long	snapLookup(java.lang.String snapname) Get the ID of a snapshot
void	snapRemove(java.lang.String snapname) Remove a snapshot
RadosObjectInfo	stat(java.lang.String oid) Stat an object
void	truncate(java.lang.String oid, long size) Resize an object
void	write(java.lang.String oid, byte[] buf) Write to an object without an offset
void	write(java.lang.String oid, byte[] buf, long offset) Write to an object
void	write(java.lang.String oid, java.lang.String buf) Write to an object without an offset
void	write(java.lang.String oid, java.lang.String buf, long offset) Write to an object without an offset
void	writeFull(java.lang.String oid, byte[] buf, int len) Write an entire object The object is filled with the provided data.

Methods inherited from class java.lang.Object

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

Constructor Detail

IoCTX

public IoCTX(com.sun.jna.Pointer p)

Create a new IO Context object This constructor should never be called, IO Context objects are created by the RADOS class and returned when creating a IO Context there

Method Detail

getPointer

public com.sun.jna.Pointer getPointer()

Return the pointer to the IO Context This method is used internally and by the RADOS class to destroy a IO Context

Returns:

Pointer

getId

public long getId()

Get the pool ID of this context

Returns:

long

setAuid

public void setAuid(long auid)
             throws RadosException

Set the associated auid owner of the current pool

Parameters:

auid - The new auid

Throws:

RadosException

getAuid

public long getAuid()
             throws RadosException

Get the associated auid owner of the current pool

Returns:

long

Throws:

RadosException

getPoolName

public java.lang.String getPoolName()
                             throws RadosException

Get the pool name of the context

Returns:

String

Throws:

RadosException

locatorSetKey

public void locatorSetKey(java.lang.String key)

Set the locator key

Parameters:

key - The new locator key or NULL to remove a previous one

listObjects

public java.lang.String[] listObjects()
                               throws RadosException

List all objects in a pool

Returns:

String[]

Throws:

RadosException

write

public void write(java.lang.String oid,
         byte[] buf,
         long offset)
           throws RadosException,
                  java.lang.IllegalArgumentException

Write to an object

Parameters:

oid - The object to write to

buf - The content to write

offset - The offset when writing

Throws:

RadosException

java.lang.IllegalArgumentException

write

public void write(java.lang.String oid,
         byte[] buf)
           throws RadosException

Write to an object without an offset

Parameters:

oid - The object to write to

buf - The content to write

Throws:

RadosException

writeFull

public void writeFull(java.lang.String oid,
             byte[] buf,
             int len)
               throws RadosException

Write an entire object The object is filled with the provided data. If the object exists, it is atomically truncated and then written.

Parameters:

oid - The object to write to

buf - The content to write

len - The length of the data to write

Throws:

RadosException

write

public void write(java.lang.String oid,
         java.lang.String buf,
         long offset)
           throws RadosException

Write to an object without an offset

Parameters:

oid - The object to write to

buf - The content to write

offset - The offset when writing

Throws:

RadosException

write

public void write(java.lang.String oid,
         java.lang.String buf)
           throws RadosException

Write to an object without an offset

Parameters:

oid - The object to write to

buf - The content to write

Throws:

RadosException

remove

public void remove(java.lang.String oid)
            throws RadosException

Remove an object

Parameters:

oid - The object to remove

Throws:

RadosException

read

public int read(java.lang.String oid,
       int length,
       long offset,
       byte[] buf)
         throws java.lang.IllegalArgumentException

Read data from an object

Parameters:

oid - The object's name

length - Amount of bytes to read

offset - The offset where to start reading

buf - The buffer to store the result

Returns:

Number of bytes read or negative on error

Throws:

java.lang.IllegalArgumentException

truncate

public void truncate(java.lang.String oid,
            long size)
              throws RadosException,
                     java.lang.IllegalArgumentException

Resize an object

Parameters:

oid - The object to resize

size - The new length of the object. If this enlarges the object, the new area is logically filled with zeroes. If this shrinks the object, the excess data is removed.

Throws:

RadosException

java.lang.IllegalArgumentException

append

public void append(java.lang.String oid,
          byte[] buf)
            throws RadosException

Append data to an object

Parameters:

oid - The name to append to

buf - The data to append

Throws:

RadosException

append

public void append(java.lang.String oid,
          byte[] buf,
          int len)
            throws RadosException

Parameters:

oid - The name to append to

buf - The data to append

len - The number of bytes to write from buf

Throws:

RadosException

append

public void append(java.lang.String oid,
          java.lang.String buf)
            throws RadosException

Append data to an object

Parameters:

oid - The name to append to

buf - The data to append

Throws:

RadosException

clone

public void clone(java.lang.String dst,
         long dst_off,
         java.lang.String src,
         long src_off,
         long len)
           throws RadosException

Efficiently copy a portion of one object to another If the underlying filesystem on the OSD supports it, this will be a copy-on-write clone. The src and dest objects must be in the same pg. To ensure this, the io context should have a locator key set (see IoCTX.locatorSetKey()).

Parameters:

dst - The destination object

dst_off - The offset at the destination object

src - The source object

src_off - The offset at the source object

len - The amount of bytes to copy

Throws:

RadosException

stat

public RadosObjectInfo stat(java.lang.String oid)
                     throws RadosException

Stat an object

Parameters:

oid - The name of the object

Returns:

RadosObjectInfo The size and mtime of the object

Throws:

RadosException

poolStat

public RadosPoolInfo poolStat()
                       throws RadosException

Stat the currently open pool

Returns:

RadosPoolInfo

Throws:

RadosException

snapCreate

public void snapCreate(java.lang.String snapname)
                throws RadosException

Create a snapshot

Parameters:

snapname - The name of the snapshot

Throws:

RadosException

snapRemove

public void snapRemove(java.lang.String snapname)
                throws RadosException

Remove a snapshot

Parameters:

snapname - The name of the snapshot

Throws:

RadosException

snapLookup

public long snapLookup(java.lang.String snapname)
                throws RadosException

Get the ID of a snapshot

Parameters:

snapname - The name of the snapshot

Returns:

long

Throws:

RadosException

snapGetName

public java.lang.String snapGetName(long id)
                             throws RadosException

Get the name of a snapshot by it's ID

Parameters:

id - The ID of the snapshot

Returns:

String

Throws:

RadosException

snapGetStamp

public long snapGetStamp(long id)
                  throws RadosException

Get the timestamp of a snapshot

Parameters:

id - The ID of the snapshot

Returns:

long

Throws:

RadosException

snapList

public java.lang.Long[] snapList()
                          throws RadosException

List all snapshots

Returns:

Long[]

Throws:

RadosException