Package app.ductape.sdk.cache

Class CacheService

java.lang.Object

app.ductape.sdk.cache.CacheService

public class CacheService
extends Object

TS cache.service.ts: remote cache via ProcessorApiService, optional local Redis (Lettuce) for reads/writes.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	CacheService.CacheLogSink

Constructor Summary

Constructors

Constructor	Description
CacheService(EnvType env, RequestContext auth)
CacheService(EnvType env, RequestContext auth, ProductsService productsService, ProcessorApiService processorApi)
CacheService(RequestContext auth)	Backward-compatible constructor for pre-env wiring.

Method Summary

Modifier and Type	Method	Description
RequestContext	auth()
boolean	clear(CacheTypes.ClearKeyOptions options)	TS clear.
CacheTypes.ClearAllResult	clearAll(CacheTypes.ClearAllOptions options)	TS clearAll.
void	connectRedis(String url)	TS connectRedis: local Redis for two-tier caching (Lettuce client).
boolean	delete(CacheTypes.ClearKeyOptions options)	Legacy alias for clear-by-key.
CacheTypes.ClearAllResult	deleteAll(CacheTypes.ClearAllOptions options)	Legacy alias for clearing cache values in batch.
void	disconnectRedis()	TS disconnectRedis.
void	enableApiLogging()	Enable lightweight API-backed cache logging.
EnvType	env()
CacheTypes.DashboardMetrics	fetchDashboard(CacheTypes.DashboardOptions options)	TS fetchDashboard.
CacheTypes.FetchValuesResult	fetchValues(CacheTypes.FetchValuesOptions options)	TS fetchValues.
CacheTypes.CacheValue	get(CacheTypes.GetValueOptions options)	TS get: Redis hash first, then remote ProcessorApiService.fetchRemoteCacheByKey(java.lang.String, app.ductape.sdk.core.RequestContext).
boolean	isRedisConnected()	TS isRedisConnected.
boolean	set(CacheTypes.SetValueOptions options)	TS set: local Redis + fire-and-forget remote persist.
void	setLogSink(CacheService.CacheLogSink sink)	Provide a non-blocking cache event sink (disabled when null).
void	setRuntimeDefaults(RuntimeDefaults runtimeDefaults)
void	updateAuth(RequestContext next)	TS updateConfig: replace credentials (typically after auth refresh).
void	updateConfig(String workspaceId, String userId, String publicKey, String token, String accessKey)	TS-style config refresh helper for token/key rotation.
void	updateConfig(Map<String,Object> config)	TS parity overload for partial config updates.

Methods inherited from class java.lang.Object

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

Constructor Details

CacheService

public CacheService(RequestContext auth)

Backward-compatible constructor for pre-env wiring. Defaults to EnvType.PRODUCTION base URLs.

CacheService

public CacheService(EnvType env,
 RequestContext auth)

CacheService

public CacheService(EnvType env,
 RequestContext auth,
 ProductsService productsService,
 ProcessorApiService processorApi)

Method Details

env

public EnvType env()

auth

public RequestContext auth()

updateAuth

public void updateAuth(RequestContext next)

TS updateConfig: replace credentials (typically after auth refresh).

updateConfig

public void updateConfig(String workspaceId,
 String userId,
 String publicKey,
 String token,
 String accessKey)

TS-style config refresh helper for token/key rotation. Any null override keeps the existing auth value.

updateConfig

public void updateConfig(Map<String,Object> config)

TS parity overload for partial config updates. Supported keys: workspace_id, user_id, public_key, token, access_key.

setRuntimeDefaults

public void setRuntimeDefaults(RuntimeDefaults runtimeDefaults)

setLogSink

public void setLogSink(CacheService.CacheLogSink sink)

Provide a non-blocking cache event sink (disabled when null).

enableApiLogging

public void enableApiLogging()

Enable lightweight API-backed cache logging. Logging failures are swallowed (cache operations remain non-blocking).

connectRedis

public void connectRedis(String url)

TS connectRedis: local Redis for two-tier caching (Lettuce client).

disconnectRedis

public void disconnectRedis()

TS disconnectRedis.

isRedisConnected

public boolean isRedisConnected()

TS isRedisConnected.

fetchValues

public CacheTypes.FetchValuesResult fetchValues(CacheTypes.FetchValuesOptions options)

TS fetchValues.

fetchDashboard

public CacheTypes.DashboardMetrics fetchDashboard(CacheTypes.DashboardOptions options)

TS fetchDashboard.

get

public CacheTypes.CacheValue get(CacheTypes.GetValueOptions options)

TS get: Redis hash first, then remote ProcessorApiService.fetchRemoteCacheByKey(java.lang.String, app.ductape.sdk.core.RequestContext).

set

public boolean set(CacheTypes.SetValueOptions options)

TS set: local Redis + fire-and-forget remote persist.

clear

public boolean clear(CacheTypes.ClearKeyOptions options)

TS clear.

delete

public boolean delete(CacheTypes.ClearKeyOptions options)

Legacy alias for clear-by-key.

clearAll

public CacheTypes.ClearAllResult clearAll(CacheTypes.ClearAllOptions options)

TS clearAll.

deleteAll

public CacheTypes.ClearAllResult deleteAll(CacheTypes.ClearAllOptions options)

Legacy alias for clearing cache values in batch.