Class Almanac.Builder

java.lang.Object

io.leandev.appfuse.almanac.Almanac.Builder

Enclosing class:

Almanac

public static class Almanac.Builder
extends Object

Almanac 建構器

Since:

4.0

Constructor Summary

Constructors

Constructor	Description
Builder()

Method Summary

Modifier and Type	Method	Description
Almanac.Builder	apiKey(String apiKey)	設定固定 API Key（預設認證方式）
Almanac.Builder	apiKey(Supplier<String> apiKeySupplier)	設定動態 API Key 來源
Almanac.Builder	baseUrl(String baseUrl)	覆寫 almanac base URL（含 context-path）；預設為正式環境
Almanac	build()	建構 Almanac
Almanac.Builder	cacheManager(CacheManager cacheManager)	注入外部的 CacheManager（必填）；由消費端負責配置與關閉
Almanac.Builder	client(AlmanacClient client)	注入自訂的 AlmanacClient（注入後 base URL / 認證設定不再生效）； 由消費端負責關閉
Almanac.Builder	credentials(AlmanacCredentials credentials)	直接指定認證策略（覆寫 API Key 設定；供 service account 等擴充使用）
Almanac.Builder	ttl(Duration ttl)	設定快取存活時間（預設 Almanac.DEFAULT_TTL）

Methods inherited from class Object

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

Constructor Details

Builder

public Builder()

Method Details

baseUrl

public Almanac.Builder baseUrl(String baseUrl)

覆寫 almanac base URL（含 context-path）；預設為正式環境

apiKey

public Almanac.Builder apiKey(String apiKey)

設定固定 API Key（預設認證方式）

apiKey

public Almanac.Builder apiKey(Supplier<String> apiKeySupplier)

設定動態 API Key 來源

credentials

public Almanac.Builder credentials(AlmanacCredentials credentials)

直接指定認證策略（覆寫 API Key 設定；供 service account 等擴充使用）

client

public Almanac.Builder client(AlmanacClient client)

注入自訂的 AlmanacClient（注入後 base URL / 認證設定不再生效）； 由消費端負責關閉

cacheManager

public Almanac.Builder cacheManager(CacheManager cacheManager)

注入外部的 CacheManager（必填）；由消費端負責配置與關閉

almanac 不代建快取、也不提供預設；未注入時 build() 拋 IllegalStateException。 治理模式（governed / ungoverned）由此 CacheManager 決定，almanac 保持治理無關； 建議注入專屬、ungoverned 的磁碟 CacheManager，與其他受預算管制的快取隔離。

ttl

public Almanac.Builder ttl(Duration ttl)

設定快取存活時間（預設 Almanac.DEFAULT_TTL）

build

public Almanac build()

建構 Almanac

Returns:

Almanac

Throws:

IllegalStateException - 若未經 cacheManager(CacheManager) 注入快取