Muunna curl kielelle ColdFusion

Q: Mikä on ColdFusion cfhttp?

cfhttp on ColdFusionin sisäänrakennettu tagi ja funktio HTTP-pyyntöjen tekemiseen. Se tukee GET-, POST-, PUT- ja DELETE-metodeja sekä tiedostojen latauksia natiivilla integraatiolla ColdFusionin muuttuja-alueisiin (scopes). Asennusta ei tarvita — se on osa ColdFusion/Lucee-ajoympäristöä. curl2code generoi cfhttp/CFML-koodia ColdFusion-muunnoksia varten.

Q: cfhttp-tagi vs cfhttp-funktio — kumpaa syntaksia käyttää?

cfhttp-tagi käyttää CFML-merkintäkieltä nimetyillä attribuuteilla — perinteinen, monisanainen ja luettava mallipohjatiedostoissa. cfhttp()-funktio käyttää CFScriptiä sulkeisilla argumenteilla: cfhttp(url=url, method="GET") — moderni ja tiivis. Molemmat kääntyvät samaan moottorikutsuun. Käytä CFScriptiä johdonmukaisuuden vuoksi moderneissa ColdFusion-projekteissa. Vastaavista syntaksivalinnoista katso curl PHP:ksi.

Q: Miten hallita autentikointia ColdFusionissa?

Lisää otsakkeet komennolla cfhttpparam type="header" name="Authorization" value="Bearer #token#". Basic-autentikointia varten käytä username- ja password-attribuutteja suoraan cfhttp-tagissa. ColdFusion hoitaa Base64-koodauksen automaattisesti Basic-autentikoinnille. curl2code muuntaa autentikointiliput CFML:ksi.

Q: Miten lähettää multipart-lomakedataa ColdFusionissa?

Käytä cfhttpparam type="file" name="upload" file="#filePath#" tiedostojen lataamiseen. Lomakekentille: cfhttpparam type="formfield" name="key" value="value". ColdFusion asettaa multipart Content-Type-otsakkeen ja rajausmerkit automaattisesti. curl2code käsittelee -F-lipun muunnokset.

Q: Miten hallita HTTP-virheitä ColdFusionissa?

Kääri try/catch-rakenteeseen: try { httpResult = cfhttp(...); } catch(any e) { ... }. Tarkista cfhttp.statusCode HTTP-tilakoodia varten ja cfhttp.errorDetail virhetietoja varten. Muut kuin 2xx-vastaukset eivät heitä virhettä oletuksena — tarkista tilakoodi aina manuaalisesti.

Q: Miten jäsentää JSON-vastauksia ColdFusionissa?

Käytä deserializeJSON(cfhttp.fileContent) jäsentääksesi JSON:in ColdFusion-structeiksi ja -taulukoiksi. JSON:in lähettämiseen: serializeJSON(data). ColdFusionin JSON-funktiot käsittelevät monimutkaiset sisäkkäiset rakenteet automaattisesti muuntaen CFML-tietotyypit ja JSON:in välillä saumattomasti.

Q: Miten asettaa aikakatkaisuja ColdFusionissa?

Välitä timeout-parametri: cfhttp(url=url, timeout=30). Arvo on sekunneissa. Sisäänrakennettua uudelleenyritysmekanismia ei ole — toteuta se silmukalla ja try/catch-rakenteella. Oletusaikakatkaisu vaihtelee ColdFusion/Lucee-version mukaan.

Q: Miten käyttää välityspalvelinta ColdFusionissa?

Välitä proxy-parametrit: cfhttp(url=url, proxyServer="proxy.host", proxyPort=8080). Välityspalvelimen autentikointiin lisää proxyUser- ja proxyPassword-parametrit. curl2code muuntaa -x-liput CFML-proxy-asetuksiksi.

Q: Miten lähetetään POST-pyyntö JSON-rungolla ColdFusion-ympäristössä?

Muunna curl POST -komento kuten curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL ColdFusion-koodiksi curl2code-työkalulla. Luotu koodi käyttää cfhttpparam type='body' value='#serializeJSON(data)#'. curl2code tunnistaa automaattisesti -d/--data-liput JSON-sisällöllä ja asettaa oikean Content-Type-otsikon cfhttp-koodiin.

Q: Miten lisätään Bearer-token-valtuutus ColdFusion-ympäristössä?

Syötä curl -H "Authorization: Bearer YOUR_TOKEN" URL curl2code-työkaluun, ja se luo cfhttp-koodin valtuutusotsikolla: cfhttpparam type='header' name='Authorization' value='Bearer TOKEN'. curl2code tunnistaa Bearer-tokenit sekä -H "Authorization: Bearer ..."- että --oauth2-bearer-lipuista. Käytä Basic auth -valtuutukseen -u user:pass.

Muunna curl-komennot ColdFusion-koodiksi käyttäen cfhttp-tagia. curl2code toimii kokonaan selaimessasi WebAssemblyn kautta — tietosi pysyvät yksityisinä. PHP-kielelle, kokeile curl to PHP -muunnintamme. Javalle, katso curl to Java. Alta löydät käyttövalmiita ColdFusion-esimerkkejä.

Kuinka kopioida curl selaimestasi

1
Avaa kehittäjätyökalut
Paina F12 tai Ctrl+Shift+I avataksesi selaimen kehittäjätyökalut.
2
Siirry Network-välilehdelle
Napsauta Network-välilehteä ja suorita toiminto, joka käynnistää HTTP-pyynnön.
3
Kopioi cURL-muodossa
Napsauta pyyntöä hiiren kakkospainikkeella → Copy → Copy as cURL. Liitä se sitten yläpuolelle.

ColdFusion-koodiesimerkkejä

1Yksinkertainen GET-pyyntö

curl-komento

curl https://api.example.com/users

ColdFusion · cfhttp

httpService = new http();
httpService.setUrl("https://api.example.com/users");
httpService.setMethod("GET");

result = httpService.send().getPrefix();
writeDump(result);

2POST JSON-rungolla

curl-komento

curl -X POST https://api.example.com/users \
  -H "Content-Type: application/json" \
  -d '{"name":"John","email":"john@example.com"}'

ColdFusion · cfhttp

httpService = new http();
httpService.setUrl("https://api.example.com/users");
httpService.setMethod("POST");
httpService.addParam(type="header", name="Content-Type", value="application/json");
httpService.addParam(type="body", value='{"name":"John","email":"john@example.com"}');

result = httpService.send().getPrefix();
writeDump(result);

3Pyyntö Bearer-tokenilla

curl-komento

curl https://api.example.com/me \
  -H "Authorization: Bearer token123"

ColdFusion · cfhttp

httpService = new http();
httpService.setUrl("https://api.example.com/me");
httpService.setMethod("GET");
httpService.addParam(type="header", name="Authorization", value="Bearer token123");

result = httpService.send().getPrefix();
writeDump(result);

4Multipart-lomakkeen lähetys

curl-komento

curl -X POST https://api.example.com/upload \
  -F "file=@document.pdf" \
  -F "description=My file"

ColdFusion · cfhttp

httpService = new http();
httpService.setUrl("https://api.example.com/upload");
httpService.setMethod("POST");
httpService.addParam(type="file", name="file", file="#expandPath("document.pdf")#");
httpService.addParam(type="formfield", name="description", value="My file");

result = httpService.send().getPrefix();
writeDump(result);

5Mukautetut otsakkeet

curl-komento

curl https://api.example.com/data \
  -H "X-API-Key: abc123" \
  -H "Accept: application/json" \
  -H "X-Request-ID: req-456"

ColdFusion · cfhttp

httpService = new http();
httpService.setUrl("https://api.example.com/data");
httpService.setMethod("GET");
httpService.addParam(type="header", name="X-API-Key", value="abc123");
httpService.addParam(type="header", name="Accept", value="application/json");
httpService.addParam(type="header", name="X-Request-ID", value="req-456");

result = httpService.send().getPrefix();
writeDump(result);

Usein kysytyt kysymykset

Mikä on ColdFusion cfhttp?

cfhttp on ColdFusionin sisäänrakennettu tagi ja funktio HTTP-pyyntöjen tekemiseen. Se tukee GET-, POST-, PUT- ja DELETE-metodeja sekä tiedostojen latauksia natiivilla integraatiolla ColdFusionin muuttuja-alueisiin (scopes). Asennusta ei tarvita — se on osa ColdFusion/Lucee-ajoympäristöä. curl2code generoi cfhttp/CFML-koodia ColdFusion-muunnoksia varten.

cfhttp-tagi vs cfhttp-funktio — kumpaa syntaksia käyttää?

cfhttp-tagi käyttää CFML-merkintäkieltä nimetyillä attribuuteilla — perinteinen, monisanainen ja luettava mallipohjatiedostoissa. cfhttp()-funktio käyttää CFScriptiä sulkeisilla argumenteilla: cfhttp(url=url, method="GET") — moderni ja tiivis. Molemmat kääntyvät samaan moottorikutsuun. Käytä CFScriptiä johdonmukaisuuden vuoksi moderneissa ColdFusion-projekteissa. Vastaavista syntaksivalinnoista katso curl PHP:ksi.

Miten hallita autentikointia ColdFusionissa?

Lisää otsakkeet komennolla cfhttpparam type="header" name="Authorization" value="Bearer #token#". Basic-autentikointia varten käytä username- ja password-attribuutteja suoraan cfhttp-tagissa. ColdFusion hoitaa Base64-koodauksen automaattisesti Basic-autentikoinnille. curl2code muuntaa autentikointiliput CFML:ksi.

Miten lähettää multipart-lomakedataa ColdFusionissa?

Käytä cfhttpparam type="file" name="upload" file="#filePath#" tiedostojen lataamiseen. Lomakekentille: cfhttpparam type="formfield" name="key" value="value". ColdFusion asettaa multipart Content-Type-otsakkeen ja rajausmerkit automaattisesti. curl2code käsittelee -F-lipun muunnokset.

Miten hallita HTTP-virheitä ColdFusionissa?

Kääri try/catch-rakenteeseen: try { httpResult = cfhttp(...); } catch(any e) { ... }. Tarkista cfhttp.statusCode HTTP-tilakoodia varten ja cfhttp.errorDetail virhetietoja varten. Muut kuin 2xx-vastaukset eivät heitä virhettä oletuksena — tarkista tilakoodi aina manuaalisesti.

Miten jäsentää JSON-vastauksia ColdFusionissa?

Käytä deserializeJSON(cfhttp.fileContent) jäsentääksesi JSON:in ColdFusion-structeiksi ja -taulukoiksi. JSON:in lähettämiseen: serializeJSON(data). ColdFusionin JSON-funktiot käsittelevät monimutkaiset sisäkkäiset rakenteet automaattisesti muuntaen CFML-tietotyypit ja JSON:in välillä saumattomasti.

Miten asettaa aikakatkaisuja ColdFusionissa?

Välitä timeout-parametri: cfhttp(url=url, timeout=30). Arvo on sekunneissa. Sisäänrakennettua uudelleenyritysmekanismia ei ole — toteuta se silmukalla ja try/catch-rakenteella. Oletusaikakatkaisu vaihtelee ColdFusion/Lucee-version mukaan.

Miten käyttää välityspalvelinta ColdFusionissa?

Välitä proxy-parametrit: cfhttp(url=url, proxyServer="proxy.host", proxyPort=8080). Välityspalvelimen autentikointiin lisää proxyUser- ja proxyPassword-parametrit. curl2code muuntaa -x-liput CFML-proxy-asetuksiksi.

Miten lähetetään POST-pyyntö JSON-rungolla ColdFusion-ympäristössä?

Muunna curl POST -komento kuten curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL ColdFusion-koodiksi curl2code-työkalulla. Luotu koodi käyttää cfhttpparam type='body' value='#serializeJSON(data)#'. curl2code tunnistaa automaattisesti -d/--data-liput JSON-sisällöllä ja asettaa oikean Content-Type-otsikon cfhttp-koodiin.

Miten lisätään Bearer-token-valtuutus ColdFusion-ympäristössä?

Syötä curl -H "Authorization: Bearer YOUR_TOKEN" URL curl2code-työkaluun, ja se luo cfhttp-koodin valtuutusotsikolla: cfhttpparam type='header' name='Authorization' value='Bearer TOKEN'. curl2code tunnistaa Bearer-tokenit sekä -H "Authorization: Bearer ..."- että --oauth2-bearer-lipuista. Käytä Basic auth -valtuutukseen -u user:pass.

Miten asetetaan Content-Type-otsikko ColdFusion-ympäristössä?

curl2code muuntaa curl -H "Content-Type: application/json" URL cfhttp-koodiksi oikealla otsikolla: cfhttpparam type='header' name='Content-Type' value='application/json'. -d-datalle curl käyttää oletuksena application/x-www-form-urlencoded; -F-lomakelatauksille se käyttää multipart/form-data. curl2code yhdistää kunkin oikeaan cfhttp API -kutsuun.

Hyödyllisiä linkkejä

cfhttp-dokumentaatio

cfdocs.org

Standardikirjaston viiteopas

helpx.adobe.com

curl-man-sivu

curl.se

curl-oppaat

curl-virhekoodit

Hae mikä tahansa curl-paluukoodi — syyt, korjaukset ja virheenkorjausvinkit.

Tiedostojen lataaminen curlilla

Tallenna tiedostoja -o, -O -lipuilla, seuraa uudelleenohjauksia, jatka latauksia ja paljon muuta.

SSL, TLS ja välityspalvelin

Määritä varmenteet, TLS-versiot, HTTP/SOCKS-välityspalvelimet ja mukautettu DNS.

Kuinka kopioida curl selaimestasi

ColdFusion-koodiesimerkkejä

1Yksinkertainen GET-pyyntö

2POST JSON-rungolla

3Pyyntö Bearer-tokenilla

4Multipart-lomakkeen lähetys

5Mukautetut otsakkeet

Usein kysytyt kysymykset

Hyödyllisiä linkkejä

curl-oppaat

Muunna curl muille kielille

ColdFusion-koodiesimerkkejä

1Yksinkertainen GET-pyyntö

2POST JSON-rungolla

3Pyyntö Bearer-tokenilla

4Multipart-lomakkeen lähetys

5Mukautetut otsakkeet