use std::fmt;
use parking_lot::RwLock;
use serde::{Deserialize, Serialize};
use tracing::{error, info};
use crate::{
addr::Addr,
envelope::Envelope,
errors::{SendError, TryRecvError, TrySendError},
mailbox::Mailbox,
request_table::RequestTable,
};
pub(crate) struct Actor {
mailbox: Mailbox,
request_table: RequestTable,
control: RwLock<ControlBlock>,
}
struct ControlBlock {
status: ActorStatus,
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ActorStatus {
kind: ActorStatusKind,
details: Option<String>,
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
enum ActorStatusKind {
Normal,
Initializing,
Alarming,
Restarting,
}
impl fmt::Display for ActorStatus {
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
match &self.details {
Some(details) => write!(f, "{:?}: {}", self.kind, details),
None => write!(f, "{:?}", self.kind),
}
}
}
impl ActorStatus {
pub const ALARMING: ActorStatus = ActorStatus::new(ActorStatusKind::Alarming);
pub(crate) const INITIALIZING: ActorStatus = ActorStatus::new(ActorStatusKind::Initializing);
pub const NORMAL: ActorStatus = ActorStatus::new(ActorStatusKind::Normal);
pub(crate) const RESTARTING: ActorStatus = ActorStatus::new(ActorStatusKind::Restarting);
const fn new(kind: ActorStatusKind) -> Self {
Self {
kind,
details: None,
}
}
pub fn with_details(&self, details: &dyn fmt::Display) -> Self {
ActorStatus {
kind: self.kind.clone(),
details: Some(format!("{}", details)),
}
}
}
impl Actor {
pub(crate) fn new(addr: Addr) -> Self {
Actor {
mailbox: Mailbox::new(),
request_table: RequestTable::new(addr),
control: RwLock::new(ControlBlock {
status: ActorStatus::INITIALIZING,
}),
}
}
pub(crate) fn try_send(&self, envelope: Envelope) -> Result<(), TrySendError<Envelope>> {
if self.is_restarting() {
return Err(TrySendError::Closed(envelope));
}
self.mailbox.try_send(envelope)
}
pub(crate) async fn send(&self, envelope: Envelope) -> Result<(), SendError<Envelope>> {
if self.is_restarting() {
return Err(SendError(envelope));
}
self.mailbox.send(envelope).await
}
pub(crate) async fn recv(&self) -> Option<Envelope> {
if self.is_initializing() {
self.set_status(ActorStatus::NORMAL);
}
self.mailbox.recv().await
}
pub(crate) fn try_recv(&self) -> Result<Envelope, TryRecvError> {
if self.is_initializing() {
self.set_status(ActorStatus::NORMAL);
}
self.mailbox.try_recv()
}
pub(crate) fn request_table(&self) -> &RequestTable {
&self.request_table
}
pub(crate) fn set_status(&self, status: ActorStatus) {
let mut control = self.control.write();
let details = status.details.as_deref().unwrap_or("");
if matches!(
status.kind,
ActorStatusKind::Normal | ActorStatusKind::Initializing
) {
info!(status = ?status.kind, %details, "status changed");
} else {
error!(status = ?status.kind, %details, "status changed");
}
control.status = status;
}
pub(crate) fn is_restarting(&self) -> bool {
matches!(self.control.read().status.kind, ActorStatusKind::Restarting)
}
pub(crate) fn is_initializing(&self) -> bool {
matches!(
self.control.read().status.kind,
ActorStatusKind::Initializing
)
}
}