Package dev.gmitch215.bytebox.binding

Interface DurableObjectNamespace

All Superinterfaces:

org.teavm.jso.JSObject

public interface DurableObjectNamespace
extends org.teavm.jso.JSObject

A Durable Object binding. Declared with durableObject(), named DO_ followed by the class name.

One instance per id, in one location, with storage of its own. Two requests for the same id reach the same instance, which is what makes a Durable Object the place to put state that has to be consistent.

 DurableObjectStub counter = env.durableObject("DO_COUNTER").byName("global");
 Response current = counter.fetch(request);

Since:

1.0.0

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	DurableObjectNamespace.DurableObjectId	An instance's identity.
static interface	DurableObjectNamespace.DurableObjectStub	A handle on one instance.

Method Summary

Modifier and Type	Method	Description
default DurableObjectNamespace.DurableObjectStub	byName(String name)	The stub for a name, in one step.
DurableObjectNamespace.DurableObjectStub	get(DurableObjectNamespace.DurableObjectId id)	The stub for an id, which is a handle rather than a round trip.
DurableObjectNamespace.DurableObjectId	idFromName(String name)	The id for a name, which is stable: the same name always gives the same id.
DurableObjectNamespace.DurableObjectId	idFromString(String hex)	Parses an id previously produced by DurableObjectNamespace.DurableObjectId.asString().
DurableObjectNamespace.DurableObjectId	newUniqueId()	Returns a fresh id nothing has used, placed near whoever asked for it.

Methods inherited from interface org.teavm.jso.JSObject

cast

Method Details

idFromName

DurableObjectNamespace.DurableObjectId idFromName(String name)

The id for a name, which is stable: the same name always gives the same id.

Parameters:

name - the name

Returns:

the id

idFromString

DurableObjectNamespace.DurableObjectId idFromString(String hex)

Parses an id previously produced by DurableObjectNamespace.DurableObjectId.asString().

Parameters:

hex - the id as hexadecimal

Returns:

the id

newUniqueId

DurableObjectNamespace.DurableObjectId newUniqueId()

Returns a fresh id nothing has used, placed near whoever asked for it.

Returns:

a fresh id nothing has used, placed near whoever asked for it

get

DurableObjectNamespace.DurableObjectStub get(DurableObjectNamespace.DurableObjectId id)

The stub for an id, which is a handle rather than a round trip.

Parameters:

id - the id

Returns:

the stub

byName

default DurableObjectNamespace.DurableObjectStub byName(String name)

The stub for a name, in one step.

Parameters:

name - the name

Returns:

the stub