2025-08-12 01:35:36 +00:00
|
|
|
|
/*! 📡 P2PBox - Modern P2P Communication Node
|
2025-08-11 05:11:52 +09:00
|
|
|
|
*
|
|
|
|
|
|
* ## 📝 概要
|
2025-08-12 01:35:36 +00:00
|
|
|
|
* P2PBoxは現代的なP2P通信ノードを表現するBoxです。
|
|
|
|
|
|
* 新しいアーキテクチャ(IntentBox + MessageBus + Transport)を使用し、
|
|
|
|
|
|
* 構造化メッセージによる安全で明示的な通信を実現します。
|
|
|
|
|
|
*
|
|
|
|
|
|
* ## 🎯 AI大会議決定事項準拠
|
|
|
|
|
|
* - **個別送信のみ**: `send(to, message)` 固定API
|
|
|
|
|
|
* - **ブロードキャスト除外**: 安全性のため完全除外
|
|
|
|
|
|
* - **明示的API**: 関数オーバーロード不採用
|
|
|
|
|
|
* - **構造化メッセージ**: IntentBox (name + payload) 使用
|
2025-08-11 05:11:52 +09:00
|
|
|
|
*
|
|
|
|
|
|
* ## 🛠️ 利用可能メソッド
|
2025-08-12 01:35:36 +00:00
|
|
|
|
* - `new(node_id, transport)` - ノードを作成
|
|
|
|
|
|
* - `send(to, intent)` - 特定ノードにメッセージ送信
|
|
|
|
|
|
* - `on(intent_name, handler)` - イベントリスナー登録
|
|
|
|
|
|
* - `getNodeId()` - ノードID取得
|
|
|
|
|
|
* - `isReachable(node_id)` - ノード到達可能性確認
|
2025-08-11 05:11:52 +09:00
|
|
|
|
*
|
|
|
|
|
|
* ## 💡 使用例
|
|
|
|
|
|
* ```nyash
|
2025-08-12 01:35:36 +00:00
|
|
|
|
* // ノード作成
|
|
|
|
|
|
* local alice = new P2PBox("alice", "inprocess")
|
|
|
|
|
|
* local bob = new P2PBox("bob", "inprocess")
|
2025-08-11 05:11:52 +09:00
|
|
|
|
*
|
2025-08-12 01:35:36 +00:00
|
|
|
|
* // 受信ハンドラ登録
|
|
|
|
|
|
* bob.on("chat.message", function(intent, from) {
|
|
|
|
|
|
* print("From " + from + ": " + intent.payload.text)
|
2025-08-11 05:11:52 +09:00
|
|
|
|
* })
|
|
|
|
|
|
*
|
|
|
|
|
|
* // メッセージ送信
|
2025-08-12 01:35:36 +00:00
|
|
|
|
* local msg = new IntentBox("chat.message", { text: "Hello P2P!" })
|
|
|
|
|
|
* alice.send("bob", msg)
|
2025-08-11 05:11:52 +09:00
|
|
|
|
* ```
|
|
|
|
|
|
*/
|
|
|
|
|
|
|
2025-08-11 12:09:14 +09:00
|
|
|
|
use crate::box_trait::{NyashBox, StringBox, BoolBox, BoxCore, BoxBase};
|
2025-08-12 01:35:36 +00:00
|
|
|
|
use crate::boxes::IntentBox;
|
|
|
|
|
|
use crate::transport::{Transport, InProcessTransport, TransportError};
|
2025-08-12 01:39:51 +00:00
|
|
|
|
use crate::messaging::IntentHandler;
|
2025-08-11 05:11:52 +09:00
|
|
|
|
use std::any::Any;
|
|
|
|
|
|
use std::sync::{Arc, Mutex};
|
|
|
|
|
|
|
2025-08-12 01:35:36 +00:00
|
|
|
|
/// P2PBox内部データ構造
|
|
|
|
|
|
pub struct P2PBoxData {
|
2025-08-11 12:09:14 +09:00
|
|
|
|
base: BoxBase,
|
2025-08-11 05:11:52 +09:00
|
|
|
|
node_id: String,
|
2025-08-12 01:35:36 +00:00
|
|
|
|
transport: Arc<Mutex<Box<dyn Transport>>>,
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
impl std::fmt::Debug for P2PBoxData {
|
|
|
|
|
|
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
|
|
|
|
|
|
f.debug_struct("P2PBoxData")
|
|
|
|
|
|
.field("base", &self.base)
|
|
|
|
|
|
.field("node_id", &self.node_id)
|
|
|
|
|
|
.field("transport", &"<Transport>")
|
|
|
|
|
|
.finish()
|
|
|
|
|
|
}
|
2025-08-11 05:11:52 +09:00
|
|
|
|
}
|
|
|
|
|
|
|
2025-08-12 01:35:36 +00:00
|
|
|
|
/// P2PBox - P2P通信ノード(Arc<Mutex>統一パターン)
|
|
|
|
|
|
pub type P2PBox = Arc<Mutex<P2PBoxData>>;
|
|
|
|
|
|
|
|
|
|
|
|
/// P2PBox作成時のトランスポート種類
|
2025-08-11 05:11:52 +09:00
|
|
|
|
#[derive(Debug, Clone)]
|
2025-08-12 01:35:36 +00:00
|
|
|
|
pub enum TransportKind {
|
|
|
|
|
|
InProcess,
|
|
|
|
|
|
// 将来: WebSocket, WebRTC, etc.
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
impl std::str::FromStr for TransportKind {
|
|
|
|
|
|
type Err = String;
|
|
|
|
|
|
|
|
|
|
|
|
fn from_str(s: &str) -> Result<Self, Self::Err> {
|
|
|
|
|
|
match s.to_lowercase().as_str() {
|
|
|
|
|
|
"inprocess" => Ok(TransportKind::InProcess),
|
|
|
|
|
|
_ => Err(format!("Unknown transport kind: {}", s)),
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
2025-08-11 05:11:52 +09:00
|
|
|
|
}
|
|
|
|
|
|
|
2025-08-12 01:35:36 +00:00
|
|
|
|
impl P2PBoxData {
|
|
|
|
|
|
/// 新しいP2PBoxを作成
|
|
|
|
|
|
pub fn new(node_id: String, transport_kind: TransportKind) -> P2PBox {
|
|
|
|
|
|
let transport: Box<dyn Transport> = match transport_kind {
|
|
|
|
|
|
TransportKind::InProcess => Box::new(InProcessTransport::new(node_id.clone())),
|
|
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
|
|
Arc::new(Mutex::new(P2PBoxData {
|
2025-08-11 12:09:14 +09:00
|
|
|
|
base: BoxBase::new(),
|
2025-08-11 05:11:52 +09:00
|
|
|
|
node_id,
|
2025-08-12 01:35:36 +00:00
|
|
|
|
transport: Arc::new(Mutex::new(transport)),
|
|
|
|
|
|
}))
|
2025-08-11 05:11:52 +09:00
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/// ノードIDを取得
|
2025-08-12 01:35:36 +00:00
|
|
|
|
pub fn get_node_id(&self) -> &str {
|
|
|
|
|
|
&self.node_id
|
2025-08-11 05:11:52 +09:00
|
|
|
|
}
|
|
|
|
|
|
|
2025-08-12 01:35:36 +00:00
|
|
|
|
/// 特定ノードにメッセージを送信
|
|
|
|
|
|
pub fn send(&self, to: &str, intent: IntentBox) -> Result<(), TransportError> {
|
|
|
|
|
|
let transport = self.transport.lock().unwrap();
|
|
|
|
|
|
transport.send(to, intent, Default::default())
|
2025-08-11 05:11:52 +09:00
|
|
|
|
}
|
|
|
|
|
|
|
2025-08-12 01:35:36 +00:00
|
|
|
|
/// イベントハンドラーを登録
|
|
|
|
|
|
pub fn on(&self, intent_name: &str, handler: IntentHandler) -> Result<(), String> {
|
|
|
|
|
|
// InProcessTransportの場合のハンドラー追加
|
|
|
|
|
|
// 現在は簡略化された実装
|
|
|
|
|
|
Ok(())
|
2025-08-11 05:11:52 +09:00
|
|
|
|
}
|
|
|
|
|
|
|
2025-08-12 01:35:36 +00:00
|
|
|
|
/// ノードが到達可能かチェック
|
|
|
|
|
|
pub fn is_reachable(&self, node_id: &str) -> bool {
|
|
|
|
|
|
let transport = self.transport.lock().unwrap();
|
|
|
|
|
|
transport.is_reachable(node_id)
|
2025-08-11 05:11:52 +09:00
|
|
|
|
}
|
|
|
|
|
|
|
2025-08-12 01:35:36 +00:00
|
|
|
|
/// トランスポート種類を取得
|
|
|
|
|
|
pub fn get_transport_type(&self) -> String {
|
|
|
|
|
|
let transport = self.transport.lock().unwrap();
|
|
|
|
|
|
transport.transport_type().to_string()
|
2025-08-11 05:11:52 +09:00
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
|
2025-08-12 01:35:36 +00:00
|
|
|
|
|
2025-08-11 05:11:52 +09:00
|
|
|
|
|
|
|
|
|
|
impl NyashBox for P2PBox {
|
|
|
|
|
|
fn to_string_box(&self) -> StringBox {
|
2025-08-12 01:35:36 +00:00
|
|
|
|
let data = self.lock().unwrap();
|
|
|
|
|
|
StringBox::new(format!("P2PBox[{}:{}]", data.node_id, data.get_transport_type()))
|
2025-08-11 05:11:52 +09:00
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
fn equals(&self, other: &dyn NyashBox) -> BoolBox {
|
|
|
|
|
|
if let Some(other_p2p) = other.as_any().downcast_ref::<P2PBox>() {
|
2025-08-12 01:35:36 +00:00
|
|
|
|
let self_data = self.lock().unwrap();
|
|
|
|
|
|
let other_data = other_p2p.lock().unwrap();
|
|
|
|
|
|
BoolBox::new(self_data.base.id == other_data.base.id)
|
2025-08-11 05:11:52 +09:00
|
|
|
|
} else {
|
|
|
|
|
|
BoolBox::new(false)
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
fn type_name(&self) -> &'static str {
|
|
|
|
|
|
"P2PBox"
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
fn clone_box(&self) -> Box<dyn NyashBox> {
|
2025-08-12 01:35:36 +00:00
|
|
|
|
// P2PBoxは共有されるので、新しいインスタンスではなく同じ参照を返す
|
2025-08-11 05:11:52 +09:00
|
|
|
|
Box::new(self.clone())
|
|
|
|
|
|
}
|
2025-08-11 12:09:14 +09:00
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
impl BoxCore for P2PBox {
|
2025-08-11 05:11:52 +09:00
|
|
|
|
fn box_id(&self) -> u64 {
|
2025-08-12 01:35:36 +00:00
|
|
|
|
self.lock().unwrap().base.id
|
2025-08-11 15:01:11 +09:00
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
fn parent_type_id(&self) -> Option<std::any::TypeId> {
|
2025-08-12 01:35:36 +00:00
|
|
|
|
self.lock().unwrap().base.parent_type_id
|
2025-08-11 12:09:14 +09:00
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
fn fmt_box(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
|
2025-08-12 01:35:36 +00:00
|
|
|
|
let data = self.lock().unwrap();
|
|
|
|
|
|
write!(f, "P2PBox[{}:{}]", data.node_id, data.get_transport_type())
|
2025-08-11 12:09:14 +09:00
|
|
|
|
}
|
2025-08-11 15:01:11 +09:00
|
|
|
|
|
|
|
|
|
|
fn as_any(&self) -> &dyn Any {
|
|
|
|
|
|
self
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
fn as_any_mut(&mut self) -> &mut dyn Any {
|
|
|
|
|
|
self
|
|
|
|
|
|
}
|
2025-08-11 12:09:14 +09:00
|
|
|
|
}
|
|
|
|
|
|
|
2025-08-12 01:35:36 +00:00
|
|
|
|
impl std::fmt::Display for P2PBoxData {
|
2025-08-11 12:09:14 +09:00
|
|
|
|
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
|
2025-08-12 01:35:36 +00:00
|
|
|
|
write!(f, "P2PBox[{}:{}]", self.node_id, self.get_transport_type())
|
2025-08-11 05:11:52 +09:00
|
|
|
|
}
|
|
|
|
|
|
}
|