跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

Durable Object 生存时间

Implement a Time To Live (TTL) for Durable Object instances.

最后更新 查看 MarkdownAgent 设置

Durable Objects 的常见功能请求是为 Durable Object 实例设置生存时间(TTL)。Durable Objects 为开发者提供了仅用几行代码实现自定义 TTL 的工具。此示例演示如何使用 alarms 实现 TTL。虽然此 TTL 会在每次对 Durable Object 的新请求时延长,但可以根据特定用例进行自定义。

import { DurableObject } from "cloudflare:workers";

// Durable Object
export class MyDurableObject extends DurableObject {
  // Time To Live (TTL) in milliseconds
  timeToLiveMs = 1000;

  constructor(ctx, env) {
    super(ctx, env);
  }

  async fetch(_request) {
    // Extend the TTL immediately following every fetch request to a Durable Object.
    await this.ctx.storage.setAlarm(Date.now() + this.timeToLiveMs);
    ...
   }

  async alarm() {
    await this.ctx.storage.deleteAll();
  }
}

// Worker
export default {
  async fetch(request, env) {
    const stub = env.MY_DURABLE_OBJECT.getByName("foo");
    return await stub.fetch(request);
  },
};
import { DurableObject } from "cloudflare:workers";

export interface Env {
  MY_DURABLE_OBJECT: DurableObjectNamespace<MyDurableObject>;
}

// Durable Object
export class MyDurableObject extends DurableObject {
  // Time To Live (TTL) in milliseconds
  timeToLiveMs = 1000;

  constructor(ctx: DurableObjectState, env: Env) {
    super(ctx, env);
  }

  async fetch(_request: Request) {
    // Extend the TTL immediately following every fetch request to a Durable Object.
    await this.ctx.storage.setAlarm(Date.now() + this.timeToLiveMs);
    ...
   }

  async alarm() {
    await this.ctx.storage.deleteAll();
  }
}

// Worker
export default {
  async fetch(request, env) {
    const stub = env.MY_DURABLE_OBJECT.getByName("foo");
    return await stub.fetch(request);
  },
} satisfies ExportedHandler<Env>;
from workers import DurableObject, Response, WorkerEntrypoint
import time

# Durable Object
class MyDurableObject(DurableObject):
	# Time To Live (TTL) in milliseconds
	timeToLiveMs = 1000

	def __init__(self, ctx, env):
		super().__init__(ctx, env)

	async def fetch(self, _request):
		# Extend the TTL immediately following every fetch request to a Durable Object.
		await self.ctx.storage.setAlarm(int(time.time() * 1000) + self.timeToLiveMs)
		...

	async def alarm(self):
		await self.ctx.storage.deleteAll()

# Worker
class Default(WorkerEntrypoint):
	async def fetch(self, request):
		stub = self.env.MY_DURABLE_OBJECT.getByName("foo")
		return await stub.fetch(request)

要测试和部署此示例,请配置 Wrangler 文件以包含基于先前选择的 namespace 和类名称的 Durable Object 绑定 和 迁移。

{
	"$schema": "./node_modules/wrangler/config-schema.json",
	"name": "durable-object-ttl",
	"main": "src/index.ts",
	"upload_source_maps": true,
	"durable_objects": {
		"bindings": [
			{
				"name": "MY_DURABLE_OBJECT",
				"class_name": "MyDurableObject"
			}
		]
	},
	"migrations": [
		{
			"tag": "v1",
			"new_sqlite_classes": [
				"MyDurableObject"
			]
		}
	]
}
"$schema" = "./node_modules/wrangler/config-schema.json"
name = "durable-object-ttl"
main = "src/index.ts"
upload_source_maps = true

[[durable_objects.bindings]]
name = "MY_DURABLE_OBJECT"
class_name = "MyDurableObject"

[[migrations]]
tag = "v1"
new_sqlite_classes = [ "MyDurableObject" ]

这篇文档对您有帮助吗?