NautilusTrader Docs · ภาษาไทย

เขียน Actor (Rust)

actor รับ market data, custom data/signal และ system event แต่ไม่ได้จัดการ order คู่มือนี้จะพาสร้าง SpreadMonitor ที่ subscribe quote และ log ค่า bid-ask spread

สำหรับพื้นฐานเรื่อง actor, trait และการ dispatch handler ดูคู่มือ concept Actors และ Rust

กำหนด struct

actor เป็นเจ้าของ DataActorCore และ state ที่ตัวเองต้องใช้ core เก็บ runtime state ของ actor ไว้ โดยปกติ user code จะเข้าถึง state นั้นผ่าน facade method ของ DataActor เช่น:

  • clock()
  • cache()
  • config()
  • actor_id()
  • trader_id()
  • method สำหรับ subscription
use nautilus_common::{nautilus_actor, actor::{DataActor, DataActorConfig, DataActorCore}};
use nautilus_model::{data::QuoteTick, identifiers::{ActorId, InstrumentId}};

pub struct SpreadMonitor {
    core: DataActorCore,
    instrument_id: InstrumentId,
}

Implement constructor

สร้าง DataActorConfig พร้อม actor ID แล้วส่งให้ DataActorCore::new ฟิลด์ของ config ใช้ Option ที่มีค่าเริ่มต้น ดังนั้น ..Default::default() จะครอบคลุมทุกอย่างยกเว้น actor ID

impl SpreadMonitor {
    pub fn new(instrument_id: InstrumentId) -> Self {
        let config = DataActorConfig {
            actor_id: Some(ActorId::from("SPREAD_MON-001")),
            ..Default::default()
        };
        Self {
            core: DataActorCore::new(config),
            instrument_id,
        }
    }
}

เชื่อม core และ implement Debug

macro nautilus_actor! เชื่อมฟิลด์ DataActorCore ของ actor เข้ากับ runtime contract โดยค่าเริ่มต้นจะ delegate ไปยังฟิลด์ชื่อ core หากใช้ชื่อฟิลด์อื่นให้ส่ง argument ตัวที่สองเข้าไป callback ทั่วไปไม่ต้องเรียก native accessor ที่ macro generate ขึ้น ให้ใช้ facade method ของ DataActor บน self แทน

การ register กับ runtime ใช้ blanket implementation ของ Actor และ Component macro จัดเตรียมการเชื่อมต่อกับ native runtime ให้ ส่วน Debug ให้ implement เองหรือ derive เอา

nautilus_actor!(SpreadMonitor);

impl std::fmt::Debug for SpreadMonitor {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        f.debug_struct("SpreadMonitor").finish()
    }
}

Implement trait DataActor

override handler method เพื่อรับข้อมูล handler ทุกตัวมี implementation เริ่มต้นแบบ no-op ดังนั้น override เฉพาะตัวที่ ต้องการก็พอ handler แต่ละตัวคืนค่า anyhow::Result<()>

impl DataActor for SpreadMonitor {
    fn on_start(&mut self) -> anyhow::Result<()> {
        self.subscribe_quotes(self.instrument_id, None, None);
        Ok(())
    }

    fn on_quote(&mut self, quote: &QuoteTick) -> anyhow::Result<()> {
        let spread = quote.ask_price.as_f64() - quote.bid_price.as_f64();
        log::info!("Spread: {spread:.5}");
        Ok(())
    }
}

subscribe_quotes เรียกใช้ได้โดยตรงบน self ผ่าน trait DataActor ดู handler ทั้งหมดที่มีได้ใน ตาราง handler

การเข้าถึง native runtime

โดยค่าเริ่มต้นให้ใช้ facade สาธารณะของ DataActor เพิ่ม DataActorNative เฉพาะเมื่อต้องการ access path แบบ native-only อย่างชัดเจนที่ facade method ให้ไม่ได้ property แบบอ่านอย่างเดียวมีให้ใช้บน facade:

  • config()
  • actor_id()
  • trader_id()
  • is_registered()

ส่วน Rust native traits ครอบคลุม applicability matrix ของ native trait และ ตาราง method นี้:

actor ที่ต้องการความ portable จึงควรใช้ facade method เช่น:

  • clock()
  • cache()

Register actor

กับ BacktestEngine:

let actor = SpreadMonitor::new(instrument_id);
engine.add_actor(actor)?;

กับ LiveNode:

let actor = SpreadMonitor::new(instrument_id);
node.add_actor(actor)?;

ความปลอดภัยของ guard

เมื่อระบบ dispatch message ไปยัง actor ของคุณ ระบบจะขอ guard ActorRef อายุสั้นจาก registry คุณไม่ต้องจัดการ guard เหล่านี้เอง แต่หากเขียน code ที่เข้าถึง actor ตัวอื่นภายใน callback ให้ทำตามกฎเหล่านี้:

  • ค้นหา actor ด้วย ID ทุกครั้ง อย่า cache ActorRef ไว้
  • drop guard ก่อนที่ scope จะจบ ห้ามเก็บไว้ในฟิลด์
  • ห้ามถือ guard ข้ามจุด .await

method สำหรับ subscription บน DataActorCore จัดการเรื่องนี้ได้ถูกต้องอยู่แล้ว โดยจับ actor ID ไว้และทำการค้นหาภายใน callback closure ดูโมเดลด้าน threading และ registry ฉบับเต็มได้ที่ Runtime invariants

ตัวอย่างฉบับเต็ม

ดู BookImbalanceActor สำหรับ actor ที่สมบูรณ์กว่า ซึ่งติดตาม state แยกตาม instrument และพิมพ์สรุปเมื่อหยุดทำงาน

แปลจาก เอกสาร NautilusTrader © Nautech Systems Pty Ltd และผู้ร่วมพัฒนา เผยแพร่ภายใต้ LGPL-3.0 ฉบับแปลนี้ตัดเนื้อหาเฉพาะ Python ออกและเน้น Rust