StillHammer
c37f7d245e
- **IEngine**: Add run(), step(), loadModules(), socket management, health monitoring - **IModuleSystem**: Inherit ITaskScheduler, 1:1 module relationship, task delegation - **IModule**: Service injection (IIO*, ITaskScheduler*), pub/sub communication, void process() - **IIO**: Pull-based pub/sub with wildcards, low-frequency batching, health monitoring - **ITaskScheduler**: Task delegation interface for module→execution system Architecture completed with quadruple interface pattern optimized for: - Thread-safe pull-based messaging - Module task delegation to execution systems - Engine health monitoring of all IIO instances - Immutable interface foundation for future development 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
102 lines
3.2 KiB
C++
102 lines
3.2 KiB
C++
#pragma once
|
|
|
|
#include <string>
|
|
#include <vector>
|
|
#include <functional>
|
|
#include <nlohmann/json.hpp>
|
|
|
|
using json = nlohmann::json;
|
|
|
|
namespace warfactory {
|
|
|
|
enum class IOType {
|
|
INTRA = 0, // Same process
|
|
LOCAL = 1, // Same machine
|
|
NETWORK = 2 // TCP/WebSocket
|
|
};
|
|
|
|
struct SubscriptionConfig {
|
|
bool replaceable = false; // Replace vs accumulate for low-freq
|
|
int batchInterval = 30000; // ms for low-freq batching
|
|
int maxBatchSize = 100; // Max messages per batch
|
|
bool compress = false; // Compress batched data
|
|
};
|
|
|
|
struct Message {
|
|
std::string topic;
|
|
json data;
|
|
uint64_t timestamp;
|
|
};
|
|
|
|
struct IOHealth {
|
|
int queueSize;
|
|
int maxQueueSize;
|
|
bool dropping = false; // Started dropping messages?
|
|
float averageProcessingRate; // Messages/second processed by module
|
|
int droppedMessageCount = 0; // Total dropped since last check
|
|
};
|
|
|
|
/**
|
|
* @brief Pub/Sub communication interface with pull-based synchronous design
|
|
*
|
|
* Pull-based pub/sub system optimized for game modules. Modules have full control
|
|
* over when they process messages, avoiding threading issues.
|
|
*
|
|
* Features:
|
|
* - Topic patterns with wildcards (e.g., "player:*", "economy:*")
|
|
* - Low-frequency subscriptions for bandwidth optimization
|
|
* - Message consumption (pull removes message from queue)
|
|
* - Engine health monitoring for backpressure management
|
|
*/
|
|
class IIO {
|
|
public:
|
|
virtual ~IIO() = default;
|
|
|
|
/**
|
|
* @brief Publish message to a topic
|
|
* @param topic Topic name (e.g., "player:123", "economy:prices")
|
|
* @param message JSON message data
|
|
*/
|
|
virtual void publish(const std::string& topic, const json& message) = 0;
|
|
|
|
/**
|
|
* @brief Subscribe to topic pattern (high-frequency)
|
|
* @param topicPattern Topic pattern with wildcards (e.g., "player:*")
|
|
* @param config Optional subscription configuration
|
|
*/
|
|
virtual void subscribe(const std::string& topicPattern, const SubscriptionConfig& config = {}) = 0;
|
|
|
|
/**
|
|
* @brief Subscribe to topic pattern (low-frequency batched)
|
|
* @param topicPattern Topic pattern with wildcards
|
|
* @param config Subscription configuration (batchInterval, etc.)
|
|
*/
|
|
virtual void subscribeLowFreq(const std::string& topicPattern, const SubscriptionConfig& config = {}) = 0;
|
|
|
|
/**
|
|
* @brief Get count of pending messages
|
|
* @return Number of messages waiting to be pulled
|
|
*/
|
|
virtual int hasMessages() const = 0;
|
|
|
|
/**
|
|
* @brief Pull and consume one message
|
|
* @return Message from queue (oldest first). Message is removed from queue.
|
|
* @throws std::runtime_error if no messages available
|
|
*/
|
|
virtual Message pullMessage() = 0;
|
|
|
|
/**
|
|
* @brief Get IO health status for Engine monitoring
|
|
* @return Health metrics including queue size, drop status, processing rate
|
|
*/
|
|
virtual IOHealth getHealth() const = 0;
|
|
|
|
/**
|
|
* @brief Get IO type identifier
|
|
* @return IO type enum value for identification
|
|
*/
|
|
virtual IOType getType() const = 0;
|
|
};
|
|
|
|
} // namespace warfactory
|