Elektra  0.8.23
Public Member Functions | Static Public Member Functions | Protected Member Functions | List of all members
org.libelektra.KDB Class Reference

Represents session with the Key database. More...

Inherits AutoCloseable.

Public Member Functions

 KDB (final Pointer p)
 Helper constructor for duplication by pointer. More...
 
void close ()
 Clean-up function initiating closing of the KDB session.
 
void get (final KeySet ks, final Key parentKey) throws KDBException
 Will fetch at least all keys that are sub-keys or children of sub-keys of the supplied parent key. More...
 
void set (final KeySet ks, final Key parentKey) throws KDBException
 Will update changed keys of the given keyset in the backend. More...
 
void close (final Key parentKey)
 Clean-up method that closes the KDB session. More...
 

Static Public Member Functions

static KDB open (final Key parentKey)
 Basic constructor of KDB class
Opens KDB session with the given parentKey to write possible warning and error information to. More...
 

Protected Member Functions

Pointer get ()
 Native pointer being used by JNA. More...
 

Detailed Description

Represents session with the Key database.

Close after usage, or simply use a try-with-resources statement.

Constructor & Destructor Documentation

◆ KDB()

org.libelektra.KDB.KDB ( final Pointer  p)
inline

Helper constructor for duplication by pointer.

Parameters
pPointer to another KDB object

Member Function Documentation

◆ close()

void org.libelektra.KDB.close ( final Key  parentKey)
inline

Clean-up method that closes the KDB session.

Parameters
parentKeyKey holding error and warning information

◆ get() [1/2]

void org.libelektra.KDB.get ( final KeySet  ks,
final Key  parentKey 
) throws KDBException
inline

Will fetch at least all keys that are sub-keys or children of sub-keys of the supplied parent key.

Parameters
ksKeySet where the fetched keys will be stored in
parentKeyRoot key which name will be used to fetch keys below it
Exceptions
KDBExceptionIn case of an error when loading keys

◆ get() [2/2]

Pointer org.libelektra.KDB.get ( )
inlineprotected

Native pointer being used by JNA.

Returns
Native pointer object

◆ open()

static KDB org.libelektra.KDB.open ( final Key  parentKey)
inlinestatic

Basic constructor of KDB class
Opens KDB session with the given parentKey to write possible warning and error information to.

Parameters
parentKeyParent key being used for this KDB session; it is used to store warning and error information
Returns
New KDB session object

◆ set()

void org.libelektra.KDB.set ( final KeySet  ks,
final Key  parentKey 
) throws KDBException
inline

Will update changed keys of the given keyset in the backend.

get() has to be called before this function may be executed.

Parameters
ksKeySet which contains keys to be updated in the backend
parentKeyIs used to add warnings and set an error, if necessary
Exceptions
KDBExceptionIn case of an error when storing keys

The documentation for this class was generated from the following file: