ACE_LIB.getConfig-moreExample

ACE_LIB.getConfig - More Examples

Repository ini berisi contoh-contoh penggunaan fungsi ACE_LIB.getConfig() untuk parsing YAML nested dengan berbagai skenario.

📋 Overview

Fungsi getConfig() adalah YAML parser yang dapat membaca file konfigurasi dengan struktur nested (object dan array) dan mengembalikan JSON yang dapat langsung diakses di ESQL.

🧪 Test Scenarios

Repository ini menyediakan 5 skenario testing yang mencakup berbagai use case:

Config	Scenario	Description
CONFIG1.yaml	Standard Nested YAML	Multiple root keys dengan nested objects dan arrays
CONFIG2.yaml	Flat YAML	Structure flat tanpa root key, diakses dengan wildcard '*'
CONFIG3.yaml	Corner Case: Empty Values	Testing empty values, mixed arrays, dan special characters
CONFIG4.yaml	Corner Case: Deep Nesting	Deep nesting (5+ levels) dan complex nested structures
CONFIG5.yaml	Simple Key-Value	Practical real-world config dengan arrays dan nested objects

📂 Repository Structure

ACE_LIB.getConfig-moreExample/
├── README.md                           # File ini
├── configs/                            # 5 File YAML untuk testing
│   ├── CONFIG1.yaml
│   ├── CONFIG2.yaml
│   ├── CONFIG3.yaml
│   ├── CONFIG4.yaml
│   └── CONFIG5.yaml
├── parseResults/                       # Hasil JSON dari parsing
│   ├── hasilParseConfig1.json
│   ├── hasilParseConfig2.json
│   ├── hasilParseConfig3.json
│   ├── hasilParseConfig4.json
│   └── hasilParseConfig5.json
└── docs/                               # Detailed documentation
    ├── config1-scenario.md
    ├── config2-scenario.md
    ├── config3-scenario.md
    ├── config4-scenario.md
    └── config5-scenario.md

📖 Detailed Documentation

Untuk penjelasan lengkap setiap skenario, lihat dokumentasi berikut:

• Config 1: Standard Nested YAML
• Config 2: Flat YAML with Wildcard
• Config 3: Empty Values & Mixed Content
• Config 4: Deep Nesting & Complex Structures
• Config 5: Simple & Practical Config

🚀 Quick Start

Cara Menggunakan Test Files

-- Example: Load CONFIG1 dengan key 'fundtastic'
DECLARE config REFERENCE TO Environment.Variables;
DECLARE success BOOLEAN;

CALL ACE_LIB.getConfig(
    'TEST_CONFIG1',           -- Cache ID
    'fundtastic',             -- Key yang akan diambil
    '/path/to/CONFIG1.yaml',  -- Path ke file
    '600',                    -- Cache expiry (seconds)
    config                    -- OUT: Reference hasil parse
) INTO success;

IF success THEN
    -- Akses data
    DECLARE apiSecret CHARACTER config.ApiSecret;
    DECLARE endpoint CHARACTER config.endpoint;
END IF;

✅ Test Coverage

Feature	Config 1	Config 2	Config 3	Config 4	Config 5
Nested Objects	✅	✅	✅	✅	✅
Arrays of Strings	✅	✅	-	✅	✅
Arrays of Objects	✅	✅	✅	✅	✅
Multiple Root Keys	✅	-	-	-	✅
Flat YAML (wildcard)	-	✅	-	-	-
Empty Values	-	-	✅	-	-
Mixed Arrays	-	-	✅	-	-
Deep Nesting (5+ levels)	-	-	-	✅	-
Special Characters	-	-	✅	-	-

📝 Notes

• Semua config menggunakan indentasi 2 spasi per level
• Parser support struktur nested unlimited depth (limited by memory)
• Semua values di-parse sebagai string (tidak ada type conversion)
• Empty values (key:) di-parse menjadi empty string ""

---

Version: 1.0.0
Last Updated: October 2026
Maintainer: IBM ACE Middleware Team