Μετατροπή curl σε ColdFusion

Το cfhttp είναι η ενσωματωμένη ετικέτα (tag) και συνάρτηση του ColdFusion για την πραγματοποίηση αιτημάτων HTTP. Υποστηρίζει GET, POST, PUT, DELETE και μεταφορτώσεις αρχείων με εγγενή ενσωμάτωση στα variable scopes του ColdFusion. Δεν απαιτείται εγκατάσταση — αποτελεί μέρος του runtime των ColdFusion/Lucee. Το curl2code παράγει κώδικα cfhttp/CFML για μετατροπές ColdFusion.

Η ετικέτα cfhttp χρησιμοποιεί σήμανση CFML με ονομασμένα attributes — παραδοσιακή, αναλυτική και ευανάγνωστη σε αρχεία template. Η συνάρτηση cfhttp() χρησιμοποιεί CFScript με ορίσματα σε παρενθέσεις: cfhttp(url=url, method="GET") — σύγχρονη και συνοπτική. Και οι δύο μεταγλωττίζονται στην ίδια κλήση engine. Χρησιμοποιήστε CFScript για συνέπεια σε σύγχρονα ColdFusion projects. Για παρόμοιες επιλογές σύνταξης, δείτε curl σε PHP.

Προσθέστε κεφαλίδες με cfhttpparam type="header" name="Authorization" value="Bearer #token#". Για Basic auth, χρησιμοποιήστε τα attributes username και password απευθείας στο cfhttp. Το ColdFusion χειρίζεται αυτόματα την κωδικοποίηση Base64 για το Basic auth. Το curl2code μετατρέπει τις παραμέτρους πιστοποίησης σε CFML.

Χρησιμοποιήστε το cfhttpparam type="file" name="upload" file="#filePath#" για μεταφορτώσεις αρχείων. Για πεδία φόρμας: cfhttpparam type="formfield" name="key" value="value". Το ColdFusion ορίζει αυτόματα το multipart Content-Type και τα boundaries. Το curl2code χειρίζεται τις μετατροπές της παραμέτρου -F.

Περιβάλλετε σε try/catch: try { httpResult = cfhttp(...); } catch(any e) { ... }. Ελέγξτε το cfhttp.statusCode για την κατάσταση HTTP και το cfhttp.errorDetail για πληροφορίες σφάλματος. Οι αποκρίσεις που δεν είναι 2xx δεν εκπέμπουν σφάλμα από προεπιλογή — ελέγχετε πάντα τον κωδικό κατάστασης χειροκίνητα.

Χρησιμοποιήστε το deserializeJSON(cfhttp.fileContent) για να αναλύσετε το JSON σε structs και arrays του ColdFusion. Για αποστολή JSON: serializeJSON(data). Οι συναρτήσεις JSON του ColdFusion χειρίζονται αυτόματα σύνθετες ένθετες δομές, μετατρέποντας απρόσκοπτα μεταξύ των τύπων δεδομένων CFML και JSON.

Περάστε την παράμετρο timeout: cfhttp(url=url, timeout=30). Η τιμή είναι σε δευτερόλεπτα. Δεν υπάρχει ενσωματωμένος μηχανισμός επανάληψης — υλοποιήστε τον με βρόχο και try/catch. Το προεπιλεγμένο timeout διαφέρει ανάλογα με την έκδοση ColdFusion/Lucee.

Περάστε παραμέτρους proxy: cfhttp(url=url, proxyServer="proxy.host", proxyPort=8080). Για πιστοποίηση proxy, προσθέστε τις παραμέτρους proxyUser και proxyPassword. Το curl2code μετατρέπει τις σημαίες -x σε ρυθμίσεις proxy του CFML.

Μετατρέψτε μια curl POST εντολή όπως curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL σε ColdFusion χρησιμοποιώντας το curl2code. Ο παραγόμενος κώδικας χρησιμοποιεί cfhttpparam type='body' value='#serializeJSON(data)#'. Το curl2code εντοπίζει αυτόματα τα -d/--data flags με JSON περιεχόμενο και ορίζει την κατάλληλη Content-Type κεφαλίδα στον κώδικα cfhttp.

Περάστε το curl -H "Authorization: Bearer YOUR_TOKEN" URL στο curl2code και αυτό θα δημιουργήσει κώδικα cfhttp με την κεφαλίδα εξουσιοδότησης: cfhttpparam type='header' name='Authorization' value='Bearer TOKEN'. Το curl2code εντοπίζει τα Bearer tokens τόσο από τα -H "Authorization: Bearer ..." όσο και από τα --oauth2-bearer flags. Για Basic auth, χρησιμοποιήστε το -u user:pass.

Το curl2code μετατρέπει το curl -H "Content-Type: application/json" URL σε κώδικα cfhttp με τη σωστή κεφαλίδα: cfhttpparam type='header' name='Content-Type' value='application/json'. Για δεδομένα -d, το curl χρησιμοποιεί από προεπιλογή το application/x-www-form-urlencoded· για μεταφορτώσεις φορμών -F, χρησιμοποιεί το multipart/form-data. Το curl2code αντιστοιχίζει το καθένα στο σωστό cfhttp API.