Struct ExpressionTreeServer 

pub struct ExpressionTreeServer { /* private fields */ }

Authoritative bounded expression-tree session server.

Implementations

impl ExpressionTreeServer

pub fn new( address: ServerAddress, codecs: Vec<Symbol>, clock: Arc<dyn WallClock>, limits: ExpressionTreeServerLimits, ) -> Result<Self, ExpressionTreeServerError>

Creates a server with explicit address, codecs, wall clock, and hard lifecycle limits.

pub fn local() -> Self

Creates a local server using the system wall clock and binary server frames.

pub fn address(&self) -> &ServerAddress

Returns the configured server address.

pub fn codecs(&self) -> &[Symbol]

Returns the configured frame codecs.

pub const fn limits(&self) -> ExpressionTreeServerLimits

Returns the configured lifecycle limits.

pub fn create_session( &self, cx: &mut Cx, storage_name: &str, ) -> Result<SessionId, ExpressionTreeServerError>

Creates one authoritative session, capturing the creator’s runtime and immutable authority ceiling in the underlying expression tree.

pub fn snapshot( &self, session: &SessionId, ) -> Result<Expr, ExpressionTreeServerError>

Returns the current bounded snapshot for a session.

pub fn revision( &self, session: &SessionId, ) -> Result<u64, ExpressionTreeServerError>

Returns the current optimistic revision.

pub fn apply_intent( &self, cx: &mut Cx, session: &SessionId, expected_revision: u64, intent: &Expr, ) -> Result<Expr, ExpressionTreeServerError>

Decodes and commits one standard Intent through the existing expression-tree SurfaceCodec.

pub fn close_session( &self, session: &SessionId, ) -> Result<bool, ExpressionTreeServerError>

Closes and removes one authoritative session.

pub fn subscribe( &self, session: &SessionId, ) -> Result<WatchId, ExpressionTreeServerError>

Subscribes one bounded independent watch.

pub fn poll_watch( &self, session: &SessionId, watch: &WatchId, limit: usize, ) -> Result<WatchBatch, ExpressionTreeServerError>

Drains at most limit changes from one watch.

pub fn cancel_watch( &self, session: &SessionId, watch: &WatchId, ) -> Result<(), ExpressionTreeServerError>

Cancels a watch idempotently with respect to future event delivery.

pub fn maintenance_tick( &self, steps: u64, ) -> Result<usize, ExpressionTreeServerError>

Advances the server’s mandatory logical lifecycle clock and expires idle sessions. No wall-clock value participates in the comparison.

Trait Implementations

impl Default for ExpressionTreeServer

fn default() -> Self

Returns the “default value” for a type.

impl EvalFabric for ExpressionTreeServer

fn realize(&self, cx: &mut Cx, request: EvalRequest) -> Result<EvalReply>

Evaluates request and returns its reply.

impl EvalSite for ExpressionTreeServer

fn site_kind(&self) -> &'static str

Returns a short label naming the kind of site.

fn address(&self) -> &ServerAddress

Returns the address this site answers at.

fn codecs(&self) -> &[Symbol]

Returns the codecs this site can decode and encode.

fn answer(&self, cx: &mut Cx, frame: ServerFrame) -> Result<ServerFrame>

Answers frame, returning the reply frame.

fn answer_with_timeout( &self, cx: &mut Cx, frame: ServerFrame, timeout: Option<Duration>, ) -> Result<ServerFrame>

Answers frame with an optional deadline. Defaults to EvalSite::answer.

fn as_eval_fabric(&self) -> Option<&dyn EvalFabric>

Returns this site as an EvalFabric when it backs one. Defaults to None.

fn as_any(&self) -> &dyn Any

Returns the site as &dyn Any for downcasting.

fn close_connection(&self, _cx: &mut Cx) -> Result<(), Error>

Closes any connection backing the site. Defaults to a no-op.

fn stream( &self, cx: &mut Cx, frame: ServerFrame, sink: &mut dyn StreamSink, ) -> Result<(), Error>

Streams the answer to frame into sink. The default path answers once and emits a single chunk followed by end.

impl Object for ExpressionTreeServer

fn display(&self, _cx: &mut Cx) -> Result<String>

Render the object as a human-readable display string.

fn as_any(&self) -> &dyn Any

Expose the object for Rust downcasting.

fn header(&self) -> &ObjectHeader

Identity and trust header for the object; defaults to the shared anonymous header.

fn op(&self, _key: &OpKey) -> Option<&dyn Op>

Resolve the operation registered under key, if any.

fn claims( &self, _cx: &mut Cx, _pattern: &ClaimPattern, _sink: &mut dyn ClaimSink, ) -> Result<(), Error>

Emit the object’s claims matching pattern into sink.

fn snapshot(&self, _cx: &mut Cx) -> Result<Option<Datum>, Error>

Optional content-addressable snapshot of the object’s state.

impl ObjectCompat for ExpressionTreeServer

fn class(&self, cx: &mut Cx) -> Result<ClassRef>

Class object this value belongs to; defaults to nil.

fn as_eval_fabric(&self) -> Option<&dyn EvalFabric>

Eval-fabric view, if the object is a distributed eval surface.

fn as_table(&self, cx: &mut Cx) -> Result<Value>

Project the object into a table value; the default exposes its display.

fn as_callable(&self) -> Option<&dyn Callable>

Callable view, if the object can be invoked.

fn as_class(&self) -> Option<&dyn Class>

Class view, if the object is a class.

fn as_shape(&self) -> Option<&dyn Shape>

Shape view, if the object is a shape.

fn as_object_encoder(&self) -> Option<&dyn ObjectEncode>

Object-encoder view, if the object encodes other objects.

fn as_read_constructor(&self) -> Option<&dyn ReadConstructor>

Read-constructor view, if the object decodes data forms.

fn as_number_domain(&self) -> Option<&(dyn NumberDomain + 'static)>

Number-domain view, if the object is a number domain.

fn as_number_value(&self) -> Option<&dyn NumberValue>

Number-value view, if the object is a domain number.

fn as_stream(&self) -> Option<&dyn Stream>

Stream view, if the object is a stream.

fn as_sequence(&self) -> Option<&dyn Sequence>

Sequence view, if the object is a sequence.

fn as_thunk(&self) -> Option<&dyn Thunk>

Thunk view, if the object is a deferred computation.

fn as_list(&self) -> Option<&(dyn ListValue + 'static)>

List view, if the object is a list value.

fn as_table_impl(&self) -> Option<&(dyn Table + 'static)>

Table-implementation view, if the object is a table.

fn as_dir(&self) -> Option<&(dyn Dir + 'static)>

Directory view, if the object is a directory.

fn as_expr(&self, cx: &mut Cx) -> Result<Expr, Error>

Expression form of the object; defaults to an opaque extension node.

fn truth(&self, _cx: &mut Cx) -> Result<bool, Error>

Truthiness of the object; defaults to true.

fn publish_shape_satisfaction_claims( &self, _cx: &mut Cx, _shape: &Ref, ) -> Result<bool, Error>

Publish claims asserting that the object satisfies shape; returns whether any were published.