dw.svc
Class HTTPServiceDefinition
Object
dw.svc.ServiceDefinition
dw.svc.HTTPServiceDefinition
Represents an HTTP Service Definition.

The HTTP Service will use the return value of the createRequest callback as the request body (if supported by the HTTP method). If this is an array of non-null HTTPRequestPart objects, then a multi-part request will be formed. Otherwise the object is converted to a String and used.

See also XML.toXMLString() and JSON.stringify(Object), which must be explicitly called if needed.

API Versioned:
No longer available as of version 19.10.
All Known Subclasses
Deprecated:
This class is only used with the deprecated ServiceRegistry. Use the LocalServiceRegistry instead, which allows configuration on the HTTPService directly.
Properties
authentication  :  String
The authentication type.
cachingTTL  :  Number
The caching time to live value.
encoding  :  String
The request body encoding to declare.
outFile  :  File
The output file, or null if there is none.
requestMethod  :  String
The request method.
Constructor Summary
This class does not have a constructor, so you cannot create it directly. To get an instance of this class, use one of the subclass constructors.
Method Summary
addHeader(name : String, val : String) : HTTPServiceDefinition
Adds an HTTP Header.
addParam(name : String, val : String) : HTTPServiceDefinition
Adds a query parameter that will be appended to the URL.
getAuthentication() : String
Returns the authentication type.
getCachingTTL() : Number
Returns the caching time to live value.
getEncoding() : String
Returns the request body encoding to declare.
getOutFile() : File
Returns the output file, or null if there is none.
getRequestMethod() : String
Returns the request method.
setAuthentication(authentication : String) : HTTPServiceDefinition
Sets the type of authentication.
setCachingTTL(ttl : Number) : HTTPServiceDefinition
Enables caching for GET requests.
setEncoding(encoding : String) : HTTPServiceDefinition
Sets the encoding of the request body (if any).
setOutFile(outFile : File) : HTTPServiceDefinition
Sets the output file in which to write the HTTP response body.
setRequestMethod(requestMethod : String) : HTTPServiceDefinition
Sets the HTTP request method.
Salesforce Commerce Cloud Courses
Salesforce B2C Commerce Developer - Certification Tests
Why risk failing the SFCC exam? Get 180 real questions, killer content, and everything you need to crush the Salesforce B2C Commerce Developer certification.

Becoming a Salesforce B2C Commerce Developer is your ticket to higher salaries, better job opportunities, and the credibility to stand out from the competition. But let's be honestβ€”passing the certification exam isn't easy. That's where we come in.
Salesforce Javascript Developer I - Certification Tests
Not just another prep courseβ€”this is your shortcut to passing. Master JavaScript for Salesforce and go from 'hoping to pass' to knowing you will. Ready to start?

This isn't just another prep courseβ€”it's your shortcut to mastering the skills and confidence you need to pass. With multiple practice tests covering every section and a final exam simulation designed to mirror the real thing, you'll feel like you've already aced it before test day.
Salesforce B2C Commerce Architect - Certification Tests
Think the Developer exam was hard? Welcome to the next level.

The Salesforce B2C Commerce Architect certification is a whole different gameβ€”complex solutions, elevated difficulty, and skills that set you apart in the eCommerce industry. That's why we're including 11 downloadable PDF guides, packed with best practices and strategies to help you prepare for the exam and build confidence in every topic.
Method Detail
addHeader
addHeader(name : String, val : String) : HTTPServiceDefinition
Adds an HTTP Header.
Parameters:
name - Header name.
val - Header value.
Returns:
this HTTP Service Definition.

addParam
addParam(name : String, val : String) : HTTPServiceDefinition
Adds a query parameter that will be appended to the URL.
Parameters:
name - Parameter name.
val - Parameter value.
Returns:
this HTTP Service Definition.

getAuthentication
getAuthentication() : String
Returns the authentication type.
Returns:
Authentication type.

getCachingTTL
getCachingTTL() : Number
Returns the caching time to live value.
Returns:
The caching time to live value in seconds.

getEncoding
getEncoding() : String
Returns the request body encoding to declare.
Returns:
Request encoding.

getOutFile
getOutFile() : File
Returns the output file, or null if there is none.
Returns:
Output file or null.

getRequestMethod
getRequestMethod() : String
Returns the request method.
Returns:
HTTP Request method.

setAuthentication
setAuthentication(authentication : String) : HTTPServiceDefinition
Sets the type of authentication. Valid values include "BASIC" and "NONE".

The default value is BASIC.

Parameters:
authentication - Type of authentication.
Returns:
this HTTP Service Definition.

setCachingTTL
setCachingTTL(ttl : Number) : HTTPServiceDefinition
Enables caching for GET requests.

This only caches status codes 2xx with a content length and size of less than 50k that are not immediately written to file. The URL and the user name are used as cache keys. The total size of cacheable content and the number of cached items is limited and automatically managed by the system.

Cache control information sent by the remote server is ignored.

Caching HTTP responses should be done very carefully. It is important to ensure that the response really depends only on the URL and doesn't contain any remote state information or time information which is independent of the URL. It is also important to verify that the application sends exactly the same URL multiple times.

Parameters:
ttl - The time to live for the cached content in seconds. A value of 0 or less disables caching.

setEncoding
setEncoding(encoding : String) : HTTPServiceDefinition
Sets the encoding of the request body (if any).

The default value is UTF-8.

Parameters:
encoding - Encoding of the request body.
Returns:
this HTTP Service Definition.

setOutFile
setOutFile(outFile : File) : HTTPServiceDefinition
Sets the output file in which to write the HTTP response body.

The default behavior is to not write a file.

Parameters:
outFile - Output file, or null to disable.
Returns:
this HTTP Service Definition.

setRequestMethod
setRequestMethod(requestMethod : String) : HTTPServiceDefinition
Sets the HTTP request method.

Valid values include GET, PUT, POST, and DELETE.

The default value is POST.

Parameters:
requestMethod - HTTP request method.
Returns:
this HTTP Service Definition.

β™₯
Notifications pending to read