pub struct AppServer { /* private fields */ }Expand description
An application’s server.
Implementations§
Source§impl AppServer
impl AppServer
Sourcepub fn new(ctx: &'static AppContext, version: &'static str) -> AppServer
pub fn new(ctx: &'static AppContext, version: &'static str) -> AppServer
A server for ctx’s application, reporting version in its handshake.
Sourcepub fn app_name(&self) -> &'static str
pub fn app_name(&self) -> &'static str
The application this server serves, as its AppContext names it.
FrameworkCommand reads it to build the CLI’s endpoint,
so an application never passes its own name twice.
Sourcepub fn endpoint(self, endpoint: Endpoint) -> AppServer
pub fn endpoint(self, endpoint: Endpoint) -> AppServer
Listen somewhere other than the application’s default endpoint. Used by tests.
Sourcepub fn app_api(self, version: u32) -> AppServer
pub fn app_api(self, version: u32) -> AppServer
Report version as the application’s own API version in the handshake: the major
of the application’s API crate, which carries the methods it adds with
extend. A client that calls those methods names the version it
expects, and the handshake refuses a server that speaks another.
Sourcepub fn config(self, config: ServerConfig) -> AppServer
pub fn config(self, config: ServerConfig) -> AppServer
Use config rather than reading <config dir>/server.toml: for fixtures.
Sourcepub fn selection_file(self, path: PathBuf) -> AppServer
pub fn selection_file(self, path: PathBuf) -> AppServer
Keep the selected workspace (workspace.toml) at path rather than in the
application’s config directory: for fixtures that run several hosts in one process.
Sourcepub fn sync(self, runtime: Arc<SyncRuntime>) -> AppServer
pub fn sync(self, runtime: Arc<SyncRuntime>) -> AppServer
Serve sync.enable, sync.disable, sync.map and sync.status, and keep a replica
of the workspace in step with its files while it is synced.
Without this the server has no sync at all: an application that does not call it never talks to the bridge. The runtime is built by the caller because it needs the bridge connection, which is the caller’s to open and to close.
Sourcepub fn sync_via_bridge(self) -> Result<AppServer>
pub fn sync_via_bridge(self) -> Result<AppServer>
Sync through the host’s sapphire-bridge: sync with a runtime that
reaches the bridge itself, and reaches it again whenever it is lost (#244).
run makes the first attempt. No bridge running is not fatal — the
server serves without sync and picks the bridge up once it starts, and sync.*
answers that it is not connected meanwhile — but any other failure, such as a bridge
of another API version, stops the start.
Sourcepub fn status_rows(
self,
rows: Arc<dyn Fn() -> Vec<StatusRow> + Send + Sync>,
) -> AppServer
pub fn status_rows( self, rows: Arc<dyn Fn() -> Vec<StatusRow> + Send + Sync>, ) -> AppServer
The application’s own rows for the status report: shown after the framework’s
running / version / pid / managed_by lines.
The closure is called once per report, so an application’s rows may read live
state; the CLI’s status and the IPC server.info method render the same call’s
output.
Sourcepub fn service_spec(&self) -> ServiceSpec
pub fn service_spec(&self) -> ServiceSpec
What this application’s service is: the arguments a service manager starts it with.
["serve"]: a service manager starts the executable directly, and the executable’s
bare invocation is serve — the subcommand-less default of
FrameworkCommand::Serve. A CLI that wants its
service installed hands this to
ServiceCommand.
Sourcepub fn extend(
self,
f: impl FnOnce(Router) -> Router + Send + 'static,
) -> AppServer
pub fn extend( self, f: impl FnOnce(Router) -> Router + Send + 'static, ) -> AppServer
Add the application’s own methods.
Sourcepub fn host(&self) -> &Arc<WorkspaceHost> ⓘ
pub fn host(&self) -> &Arc<WorkspaceHost> ⓘ
The workspace this server has open. An application’s own handlers use it to reach
the workspace the same way the framework’s do: WorkspaceHost::backend.
Auto Trait Implementations§
impl !RefUnwindSafe for AppServer
impl !Sync for AppServer
impl !UnwindSafe for AppServer
impl Freeze for AppServer
impl Send for AppServer
impl Unpin for AppServer
impl UnsafeUnpin for AppServer
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
Source§impl<T> Downcast for Twhere
T: Any,
impl<T> Downcast for Twhere
T: Any,
Source§fn into_any(self: Box<T>) -> Box<dyn Any>
fn into_any(self: Box<T>) -> Box<dyn Any>
Box<dyn Trait> (where Trait: Downcast) to Box<dyn Any>, which can then be
downcast into Box<dyn ConcreteType> where ConcreteType implements Trait.Source§fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
Rc<Trait> (where Trait: Downcast) to Rc<Any>, which can then be further
downcast into Rc<ConcreteType> where ConcreteType implements Trait.Source§fn as_any(&self) -> &(dyn Any + 'static)
fn as_any(&self) -> &(dyn Any + 'static)
&Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot
generate &Any’s vtable from &Trait’s.Source§fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
&mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot
generate &mut Any’s vtable from &mut Trait’s.Source§impl<T> DowncastSend for T
impl<T> DowncastSend for T
impl<T> Fruit for T
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
Source§fn in_current_span(self) -> Instrumented<Self> ⓘ
fn in_current_span(self) -> Instrumented<Self> ⓘ
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read more