Apache Camel Java: पूर्ण गाइड उदाहरणों के साथ

1. यह क्या है और क्यों ज़रूरी है?

Apache Camel एक शक्तिशाली ओपन-सोर्स इंटीग्रेशन फ्रेमवर्क है जो एंटरप्राइज़ इंटीग्रेशन पैटर्न (EIP) को लागू करता है। अगर आपने कभी कई सिस्टम को जोड़ा है जो अलग-अलग प्रोटोकॉल (HTTP, JMS, FTP, फ़ाइलें, डेटाबेस) के ज़रिए डेटा एक्सचेंज करते हैं, तो आप जानते हैं कि यह कितनी जल्दी "स्पेगेटी कोड" में बदल जाता है। Camel इस समस्या को हल करता है, एक एकीकृत, डिक्लेरेटिव DSL (Domain Specific Language) प्रदान करके डेटा रूट्स का वर्णन करने के लिए।

Camel का मुख्य विचार यह है कि आप रूट्स (routes) परिभाषित करते हैं जिन पर मैसेज (messages) चलते हैं। हर रूट में "एंट्री पॉइंट" (from), "प्रोसेसर" (processors) और "एग्ज़िट पॉइंट" (to) होते हैं। Camel सारा "उबाऊ" काम अपने हाथ में ले लेता है: स्रोतों से कनेक्शन, फ़ॉर्मेट कन्वर्ज़न (JSON, XML, CSV), मार्शलिंग/अनमार्शलिंग, एरर हैंडलिंग और कंटेंट-बेस्ड रूटिंग। इससे डेवलपर बिज़नेस लॉजिक पर फोकस कर सकता है, नेटवर्क कम्युनिकेशन के लिए boilerplate कोड लिखने के बजाय।

व्यवहार में, Apache Camel का उपयोग ESB (Enterprise Service Bus), माइक्रोसर्विस आर्किटेक्चर, ETL प्रोसेस, क्लाउड सर्विसेज़ (AWS, Google Cloud) के साथ इंटीग्रेशन और यहां तक कि साधारण फ़ाइल "वॉचर" बनाने के लिए भी किया जाता है। यह फ्रेमवर्क 300 से अधिक कंपोनेंट्स को सपोर्ट करता है, जो इसे Java दुनिया में इंटीग्रेशन का "स्विस आर्मी नाइफ" बनाता है।

2. इंस्टॉलेशन

Apache Camel JAR फ़ाइलों के सेट के रूप में वितरित किया जाता है। शुरू करने का सबसे आसान तरीका Maven या Gradle बिल्ड सिस्टम का उपयोग करना है। नीचे Maven (pom.xml) में डिपेंडेंसी जोड़ने का तरीका दिया गया है:

<!-- मुख्य Camel इंजन -->
<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-core</artifactId>
    <version>4.6.0</version> <!-- वेबसाइट पर नवीनतम वर्ज़न चेक करें -->
</dependency>

<!-- HTTP के लिए कंपोनेंट (जैसे REST API) -->
<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-http</artifactId>
    <version>4.6.0</version>
</dependency>

<!-- फ़ाइलों के लिए कंपोनेंट -->
<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-file</artifactId>
    <version>4.6.0</version>
</dependency>

<!-- JSON के लिए कंपोनेंट (Jackson) -->
<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-jackson</artifactId>
    <version>4.6.0</version>
</dependency>

Gradle (build.gradle) के लिए:

implementation 'org.apache.camel:camel-core:4.6.0'
implementation 'org.apache.camel:camel-http:4.6.0'
implementation 'org.apache.camel:camel-file:4.6.0'
implementation 'org.apache.camel:camel-jackson:4.6.0'

महत्वपूर्ण: सभी कंपोनेंट्स का वर्ज़न समान होना चाहिए। हमेशा आधिकारिक वेबसाइट से नवीनतम स्थिर वर्ज़न का उपयोग करने की सलाह दी जाती है।

3. त्वरित शुरुआत — न्यूनतम कार्यशील उदाहरण

एक सरल रूट बनाएं जो एक फ़ोल्डर से फ़ाइलें पढ़े और उन्हें दूसरे फ़ोल्डर में कॉपी करे, फ़ाइल नाम में "COPY_" प्रीफ़िक्स जोड़ते हुए।

import org.apache.camel.CamelContext;
import org.apache.camel.builder.RouteBuilder;
import org.apache.camel.impl.DefaultCamelContext;

public class QuickStart {
    public static void main(String[] args) throws Exception {
        // 1. Camel कॉन्टेक्स्ट बनाएं
        try (CamelContext context = new DefaultCamelContext()) {
            // 2. रूट जोड़ें
            context.addRoutes(new RouteBuilder() {
                @Override
                public void confi