程序包 org.apache.bookkeeper.mledger

接口 ManagedLedgerFactory

所有已知实现类:

ManagedLedgerFactoryImpl

@LimitedPrivate
@Stable
public interface ManagedLedgerFactory

A factory to open/create managed ledgers and delete them.

方法概要

修饰符和类型	方法	说明
void	asyncDelete(String name, AsyncCallbacks.DeleteLedgerCallback callback, Object ctx)	Delete a managed ledger.
CompletableFuture<Boolean>	asyncExists(String ledgerName)	Check managed ledger has been initialized before.
void	asyncGetManagedLedgerInfo(String name, AsyncCallbacks.ManagedLedgerInfoCallback callback, Object ctx)	Asynchronously get the current metadata info for a managed ledger.
void	asyncOpen(String name, AsyncCallbacks.OpenLedgerCallback callback, Object ctx)	Asynchronous open method.
void	asyncOpen(String name, ManagedLedgerConfig config, AsyncCallbacks.OpenLedgerCallback callback, Supplier<Boolean> mlOwnershipChecker, Object ctx)	Asynchronous open method.
void	asyncOpenReadOnlyCursor(String managedLedgerName, Position startPosition, ManagedLedgerConfig config, AsyncCallbacks.OpenReadOnlyCursorCallback callback, Object ctx)	Open a ReadOnlyCursor positioned to the earliest entry for the specified managed ledger.
void	delete(String name)	Delete a managed ledger.
long	getCacheEvictionTimeThreshold()
EntryCacheManager	getEntryCacheManager()
ManagedLedgerInfo	getManagedLedgerInfo(String name)	Get the current metadata info for a managed ledger.
ManagedLedger	open(String name)	Open a managed ledger.
ManagedLedger	open(String name, ManagedLedgerConfig config)	Open a managed ledger.
ReadOnlyCursor	openReadOnlyCursor(String managedLedgerName, Position startPosition, ManagedLedgerConfig config)	Open a ReadOnlyCursor positioned to the earliest entry for the specified managed ledger.
void	shutdown()	Releases all the resources maintained by the ManagedLedgerFactory.
CompletableFuture<Void>	shutdownAsync()	This method tries it's best to releases all the resources maintained by the ManagedLedgerFactory.
void	updateCacheEvictionTimeThreshold(long cacheEvictionTimeThresholdNanos)	update cache evictionTimeThreshold.

方法详细资料

open

ManagedLedger open(String name)
            throws InterruptedException,
ManagedLedgerException

Open a managed ledger. If the managed ledger does not exist, a new one will be automatically created. Uses the default configuration parameters.

参数:

name - the unique name that identifies the managed ledger

返回:

the managed ledger

抛出:

ManagedLedgerException

InterruptedException

open

ManagedLedger open(String name,
 ManagedLedgerConfig config)
            throws InterruptedException,
ManagedLedgerException

Open a managed ledger. If the managed ledger does not exist, a new one will be automatically created.

参数:

name - the unique name that identifies the managed ledger

config - managed ledger configuration

返回:

the managed ledger

抛出:

ManagedLedgerException

InterruptedException

asyncOpen

void asyncOpen(String name,
 AsyncCallbacks.OpenLedgerCallback callback,
 Object ctx)

Asynchronous open method.

参数:

name - the unique name that identifies the managed ledger

callback - callback object

ctx - opaque context

另请参阅:

• open(String)

asyncOpen

void asyncOpen(String name,
 ManagedLedgerConfig config,
 AsyncCallbacks.OpenLedgerCallback callback,
 Supplier<Boolean> mlOwnershipChecker,
 Object ctx)

Asynchronous open method.

参数:

name - the unique name that identifies the managed ledger

config - managed ledger configuration

callback - callback object

mlOwnershipChecker - checks ml-ownership in case updating ml-metadata fails due to ownership conflict

ctx - opaque context

另请参阅:

• open(String, ManagedLedgerConfig)

openReadOnlyCursor

ReadOnlyCursor openReadOnlyCursor(String managedLedgerName,
 Position startPosition,
 ManagedLedgerConfig config)
                           throws InterruptedException,
ManagedLedgerException

Open a ReadOnlyCursor positioned to the earliest entry for the specified managed ledger.

参数:

managedLedgerName -

startPosition - set the cursor on that particular position. If setting to `PositionImpl.earliest` it will be positioned on the first available entry.

返回:

抛出:

InterruptedException

ManagedLedgerException

asyncOpenReadOnlyCursor

void asyncOpenReadOnlyCursor(String managedLedgerName,
 Position startPosition,
 ManagedLedgerConfig config,
 AsyncCallbacks.OpenReadOnlyCursorCallback callback,
 Object ctx)

Open a ReadOnlyCursor positioned to the earliest entry for the specified managed ledger.

参数:

managedLedgerName -

startPosition - set the cursor on that particular position. If setting to `PositionImpl.earliest` it will be positioned on the first available entry.

callback -

ctx -

getManagedLedgerInfo

ManagedLedgerInfo getManagedLedgerInfo(String name)
                                throws InterruptedException,
ManagedLedgerException

Get the current metadata info for a managed ledger.

参数:

name - the unique name that identifies the managed ledger

抛出:

InterruptedException

ManagedLedgerException

asyncGetManagedLedgerInfo

void asyncGetManagedLedgerInfo(String name,
 AsyncCallbacks.ManagedLedgerInfoCallback callback,
 Object ctx)

Asynchronously get the current metadata info for a managed ledger.

参数:

name - the unique name that identifies the managed ledger

callback - callback object

ctx - opaque context

delete

void delete(String name)
     throws InterruptedException,
ManagedLedgerException

Delete a managed ledger. If it's not open, it's metadata will get regardless deleted.

参数:

name -

抛出:

InterruptedException

ManagedLedgerException

asyncDelete

void asyncDelete(String name,
 AsyncCallbacks.DeleteLedgerCallback callback,
 Object ctx)

Delete a managed ledger. If it's not open, it's metadata will get regardless deleted.

参数:

name -

抛出:

InterruptedException

ManagedLedgerException

shutdown

void shutdown()
       throws InterruptedException,
ManagedLedgerException

Releases all the resources maintained by the ManagedLedgerFactory.

抛出:

ManagedLedgerException

InterruptedException

shutdownAsync

CompletableFuture<Void> shutdownAsync()
                               throws ManagedLedgerException,
InterruptedException

This method tries it's best to releases all the resources maintained by the ManagedLedgerFactory. It will take longer time to shutdown than shutdown();

抛出:

ManagedLedgerException

InterruptedException

另请参阅:

• shutdown()

asyncExists

CompletableFuture<Boolean> asyncExists(String ledgerName)

Check managed ledger has been initialized before.

参数:

ledgerName - String

返回:

a future represents the result of the operation. an instance of Boolean is returned if the operation succeeds.

getEntryCacheManager

EntryCacheManager getEntryCacheManager()

返回:

return EntryCacheManager.

updateCacheEvictionTimeThreshold

void updateCacheEvictionTimeThreshold(long cacheEvictionTimeThresholdNanos)

update cache evictionTimeThreshold.

参数:

cacheEvictionTimeThresholdNanos - time threshold for eviction.

getCacheEvictionTimeThreshold

long getCacheEvictionTimeThreshold()

返回:

time threshold for eviction.