115 lines
3.3 KiB
Markdown
115 lines
3.3 KiB
Markdown
# プラグインBoxは既に箱を引数に取れる！
|
||
|
||
## 🎯 重要な発見
|
||
|
||
**プラグインBoxは既にC ABIレベルで箱を引数に取ることができます！**
|
||
|
||
## 📊 実装の詳細
|
||
|
||
### 1. TLVプロトコルでのハンドルサポート
|
||
|
||
```rust
|
||
// TLVタグ定義
|
||
const TAG_HANDLE: u8 = 8; // プラグインハンドル用
|
||
|
||
// ハンドルエンコード関数
|
||
pub fn plugin_handle(buf: &mut Vec<u8>, type_id: u32, instance_id: u32) {
|
||
buf.push(TAG_HANDLE);
|
||
buf.push(0u8); // reserved
|
||
buf.extend_from_slice(&(8u16).to_le_bytes()); // size = 8
|
||
buf.extend_from_slice(&type_id.to_le_bytes()); // 4 bytes
|
||
buf.extend_from_slice(&instance_id.to_le_bytes()); // 4 bytes
|
||
}
|
||
```
|
||
|
||
### 2. プラグイン呼び出し時の処理
|
||
|
||
```rust
|
||
// Nyashコード
|
||
box1.process(box2, box3)
|
||
|
||
// ↓ VM/プラグインローダーでの処理
|
||
for arg in args {
|
||
if let Some(p) = arg.as_any().downcast_ref::<PluginBoxV2>() {
|
||
// 箱引数はハンドルとしてエンコード
|
||
encode::plugin_handle(&mut tlv, p.type_id, p.instance_id);
|
||
}
|
||
// ... 他の型の処理
|
||
}
|
||
|
||
// ↓ C ABIプラグイン側
|
||
int32_t nyash_plugin_invoke(
|
||
uint32_t type_id,
|
||
uint32_t method_id,
|
||
uint32_t instance_id,
|
||
const uint8_t* args, // TLVエンコードされた引数
|
||
size_t args_len,
|
||
uint8_t* result,
|
||
size_t* result_len
|
||
) {
|
||
// TLVデコード
|
||
uint8_t tag;
|
||
uint32_t arg_type_id, arg_instance_id;
|
||
|
||
if (decode_handle(args, &tag, &arg_type_id, &arg_instance_id)) {
|
||
// ハンドル引数を処理
|
||
// arg_type_id と arg_instance_id で箱を特定
|
||
}
|
||
}
|
||
```
|
||
|
||
## 🔄 実際の使用例
|
||
|
||
### Nyashレベル
|
||
```nyash
|
||
// FileBoxがStringBoxを引数に取る例
|
||
local file = new FileBox()
|
||
local path = new StringBox("/tmp/test.txt")
|
||
file.open(path) // StringBox（プラグインBox）を引数に！
|
||
|
||
// ArrayBoxがMapBoxを引数に取る例
|
||
local array = new ArrayBox()
|
||
local map = new MapBox()
|
||
array.push(map) // MapBox（プラグインBox）を引数に！
|
||
```
|
||
|
||
### プラグイン間の相互運用
|
||
```nyash
|
||
// NetBoxがJSONBoxを引数に取る例
|
||
local net = new NetBox()
|
||
local json = new JSONBox()
|
||
json.set("url", "https://api.example.com")
|
||
net.post(json) // JSONBoxを引数として渡す
|
||
```
|
||
|
||
## 💡 重要なポイント
|
||
|
||
### 1. ハンドルによる間接参照
|
||
- 箱の実体は渡さない（メモリ安全性）
|
||
- `(type_id, instance_id)`のペアで識別
|
||
- プラグイン側でハンドルから実体にアクセス
|
||
|
||
### 2. 型安全性
|
||
- `type_id`で型を識別可能
|
||
- 不正な型の場合はエラー返却
|
||
|
||
### 3. 所有権管理
|
||
- インスタンスIDで参照管理
|
||
- プラグイン間でも安全に共有
|
||
|
||
## 🎯 結論
|
||
|
||
**C ABIの制約があっても、ハンドル機構により箱は箱を引数に取れる！**
|
||
|
||
これは既に実装済みの機能であり、プラグイン間での高度な連携が可能です。
|
||
|
||
### 埋め込みVMへの示唆
|
||
|
||
既存のTLVハンドル機構をそのまま使えば、埋め込みVMでも同じように箱引数をサポートできます：
|
||
|
||
1. Nyashスクリプト内で箱を引数に使用
|
||
2. MIRバイトコードにBoxCall命令を含める
|
||
3. 埋め込みVMがTLVエンコードでC ABIプラグインを呼び出し
|
||
4. ハンドル経由で箱を渡す
|
||
|
||
**Everything is Box、そしてC ABIでも箱は箱を扱える！** |