Container System Examples

This directory contains example applications demonstrating the enhanced container system features.

Examples

async_coroutine_example

Demonstrates C++20 coroutine-based async API features (requires CONTAINER_ENABLE_COROUTINES=ON):

• Async Serialization: Non-blocking container serialization and deserialization
• Async File I/O: Non-blocking file load/save operations with progress callbacks
• Streaming: Generator-based chunked serialization for large data
• Executor Context: Global executor configuration for thread pool integration

asio_integration_example

Shows integration with Boost.Asio/standalone Asio (requires Asio package):

• Strand-based Processing: Thread-safe message processing with Asio strands
• Timer-based Scheduling: Scheduled container processing with async timers
• Concurrent Processing: Thread pool patterns with work guards
• Message Queue Pattern: Producer/consumer pattern with Asio io_context
• Hybrid Approach: Combining container coroutines with Asio operations

messaging_integration_example

Demonstrates the new messaging integration features including:

• Enhanced Container Creation: Optimized containers for messaging workloads
• Builder Pattern: Fluent API for container construction
• Performance Monitoring: Real-time metrics collection (if enabled)
• External Integration: Callback system for external systems (if enabled)
• Compatibility: Seamless integration with messaging systems

Building Examples

Examples are built automatically when BUILD_CONTAINER_SAMPLES is enabled:

mkdir build && cd build
cmake .. -DBUILD_CONTAINER_SAMPLES=ON
cmake --build .

Running Examples

After building, examples are available in the bin/examples directory:

# Run the messaging integration example
./bin/examples/messaging_integration_example

Configuration Options

Examples support various build-time configurations:

Messaging Features

cmake .. -DENABLE_MESSAGING_FEATURES=ON

Enables enhanced container creation, builder pattern, and optimized serialization.

Performance Metrics

cmake .. -DENABLE_PERFORMANCE_METRICS=ON

Enables real-time performance monitoring and metrics collection.

External Integration

cmake .. -DENABLE_EXTERNAL_INTEGRATION=ON

Enables callback system for external system integration.

Combined Configuration

cmake .. \
  -DENABLE_MESSAGING_FEATURES=ON \
  -DENABLE_PERFORMANCE_METRICS=ON \
  -DENABLE_EXTERNAL_INTEGRATION=ON

Expected Output

The messaging integration example will show different features based on the build configuration:

• Basic features: Always available, shows standard container operations
• Enhanced features: Available when messaging features are enabled
• Performance metrics: Available when metrics are enabled
• External callbacks: Available when external integration is enabled

Integration with Messaging Systems

These examples demonstrate how the container system can be used both:

1. Standalone: As an independent container library
2. Integrated: As part of a larger messaging system

The dual alias system (ContainerSystem::container and MessagingSystem::container) ensures compatibility with both usage patterns.