dw.net
Class FTPClient
dw.net.FTPClient
The FTPClient class supports the FTP commands CD, GET, PUT, DEL, MKDIR, RENAME, and LIST. The FTP connection is
established using passive transfer mode (PASV). The transfer of files can be text or binary.
Note: when this class is used with sensitive data, be careful in persisting sensitive information to disk.
An example usage is as follows:
var ftp : FTPClient = new dw.net.FTPClient();
ftp.connect("my.ftp-server.com", "username", "password");
var data : String = ftp.get("simple.txt");
ftp.disconnect();
The default connection timeout depends on the script context timeout and will be set to a maximum of 30 seconds (default script context timeout is 10 seconds within storefront requests and 15 minutes within jobs).
IMPORTANT NOTE: Before you can make an outbound FTP connection, the FTP server IP address must be enabled for outbound traffic at the Commerce Cloud Digital firewall for your POD. Please file a support request to request a new firewall rule.
Deprecated:
The FTPClient is deprecated. Use SFTPClient for a secure alternative.
Constants
DEFAULT_GET_FILE_SIZE
:
Number = 5242880
The default size for
get() returning a File is 5MB
Deprecated:
The default size is not supported any more. The
get() methods returning a file will always try to return MAX_GET_FILE_SIZE bytes instead.
DEFAULT_GET_STRING_SIZE
:
Number = 2097152
The default size for
get() returning a String is 2MB
Deprecated:
The default size is not supported any more. The
get() methods returning a String will always try to return MAX_GET_STRING_SIZE bytes instead.
MAX_GET_FILE_SIZE
:
Number = 209715200
The maximum size for
get() returning a File is forty times the default size for getting a file. The
largest file allowed is 200MB.
MAX_GET_STRING_SIZE
:
Number = 10485760
The maximum size for
get() returning a String is five times the default size for getting a String.
The largest String allowed is 10MB.Properties
connected
:
boolean
(Read Only)
Identifies if the FTP client is currently connected to the FTP server.
replyCode
:
Number
(Read Only)
The reply code from the last FTP action.
replyMessage
:
String
(Read Only)
The string message from the last FTP action.
timeout
:
Number
The timeout for this client, in milliseconds.
Constructor Summary
FTPClient()
Constructs the FTPClient instance.
Method Summary
connect(host
:
String)
:
boolean
Connects and logs on to an FTP Server as "anonymous" and returns a boolean indicating success or failure.
connect(host
:
String, user
:
String, password
:
String)
:
boolean
Connects and logs on to an FTP server and returns a boolean indicating success or failure.
connect(host
:
String, port
:
Number)
:
boolean
Connects and logs on to an FTP Server as "anonymous" and returns a boolean indicating success or failure.
connect(host
:
String, port
:
Number, user
:
String, password
:
String)
:
boolean
Connects and logs on to an FTP server and returns a boolean indicating success or failure.
del(path
:
String)
:
boolean
Deletes the remote file on the server identified by the path parameter.
disconnect()
:
void
The method first logs the current user out from the server and then disconnects from the server.
get(path
:
String)
:
String
Reads the content of a remote file and returns it as a string using "ISO-8859-1" encoding to read it.
get(path
:
String, encoding
:
String)
:
String
Reads the content of a remote file and returns it as string using the passed encoding.
get(path
:
String, maxGetSize
:
Number)
:
String
Reads the content of a remote file and returns it as a string using "ISO-8859-1" encoding to read it.
get(path
:
String, encoding
:
String, maxGetSize
:
Number)
:
String
Reads the content of a remote file and returns it as a string using the specified encoding.
get(path
:
String, encoding
:
String, file
:
File)
:
boolean
Reads the content of a remote file and creates a local copy in the given file using the passed string encoding to read the file content and using the system standard encoding "UTF-8" to write the file.
get(path
:
String, encoding
:
String, file
:
File, maxGetSize
:
Number)
:
boolean
Reads the content of a remote file and creates a local copy in the given file using the passed string encoding to read the file content and using the system standard encoding "UTF-8" to write the file.
getBinary(path
:
String, file
:
File)
:
boolean
Reads the content of a remote file and creates a local copy in the given file.
getBinary(path
:
String, file
:
File, maxGetSize
:
Number)
:
boolean
Reads the content of a remote file and creates a local copy in the given file.
getConnected()
:
boolean
Identifies if the FTP client is currently connected to the FTP server.
getReplyCode()
:
Number
Returns the reply code from the last FTP action.
getReplyMessage()
:
String
Returns the string message from the last FTP action.
getTimeout()
:
Number
Returns the timeout for this client, in milliseconds.
list()
:
FTPFileInfo[]
Returns a list of FTPFileInfo objects containing information about the files in the current directory.
list(path
:
String)
:
FTPFileInfo[]
Returns a list of FTPFileInfo objects containing information about the files in the remote directory defined by the given path.
put(path
:
String, content
:
String)
:
boolean
Puts the specified content to the specified full path using "ISO-8859-1" encoding.
put(path
:
String, content
:
String, encoding
:
String)
:
boolean
Put the given content to a file on the given full path on the FTP server.
putBinary(path
:
String, file
:
File)
:
boolean
Put the content of the given file into a file on the remote FTP server with the given full path.
removeDirectory(path
:
String)
:
boolean
Deletes the remote directory on the server identified by the path parameter.
setTimeout(timeoutMillis
:
Number)
:
void
Sets the timeout for connections made with the FTP client to the given number of milliseconds.
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.
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.
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.
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.
Methods inherited from class
Object
assign, create, create, defineProperties, defineProperty, entries, freeze, fromEntries, getOwnPropertyDescriptor, getOwnPropertyNames, getOwnPropertySymbols, getPrototypeOf, hasOwnProperty, is, isExtensible, isFrozen, isPrototypeOf, isSealed, keys, preventExtensions, propertyIsEnumerable, seal, setPrototypeOf, toLocaleString, toString, valueOf, values
Method Detail
cd
cd(path
:
String)
:
boolean
Changes the current directory on the remote server to the given path.
Parameters:
path
-
the new current directory
Returns:
true if the directory change was okay
connect
connect(host
:
String)
:
boolean
Connects and logs on to an FTP Server as "anonymous" and returns a boolean indicating success or failure.
Parameters:
host
-
Name of the FTP sever
Returns:
true when connection is successful, false otherwise.
connect
Connects and logs on to an FTP server and returns a boolean indicating success or failure.
Parameters:
host
-
Name of the FTP sever
user
-
User name for the login
password
-
Password for the login
Returns:
true when connection is successful, false otherwise.
connect
Connects and logs on to an FTP Server as "anonymous" and returns a boolean indicating success or failure.
Parameters:
host
-
Name of the FTP sever
port
-
Port for FTP server
Returns:
true when connection is successful, false otherwise.
connect
Connects and logs on to an FTP server and returns a boolean indicating success or failure.
Parameters:
host
-
Name of the FTP sever
port
-
Port for FTP server
user
-
User name for the login
password
-
Password for the login
Returns:
true when connection is successful, false otherwise.
del
del(path
:
String)
:
boolean
Deletes the remote file on the server identified by the path parameter.
Parameters:
path
-
the path to the file.
Returns:
true if the file was successfully deleted, false otherwise.
disconnect
disconnect()
:
void
The method first logs the current user out from the server and then disconnects from the server.
get
Reads the content of a remote file and returns it as a string using "ISO-8859-1" encoding to read it. Read at
most MAX_GET_STRING_SIZE bytes.
Parameters:
path
-
remote path of the file to be read.
Returns:
the contents of the file or null if an error occured while reading the file.
get
Reads the content of a remote file and returns it as string using the passed encoding. Read at most
MAX_GET_STRING_SIZE characters.
Parameters:
path
-
remote path of the file to be read.
encoding
-
an ISO 8859 character encoding labeled as a string, e.g. "ISO-8859-1"
Returns:
the contents of the file or null if an error occurred while reading the file.
get
Reads the content of a remote file and returns it as a string using "ISO-8859-1" encoding to read it. Read at
most maxGetSize characters.
Deprecated:
The maxGetSize attribute is not supported anymore. Use the method get(String) instead.
Parameters:
path
-
remote path of the file to be read.
maxGetSize
-
the maximum bytes fetched from the remote file.
Returns:
the contents of the file or null if an error occurred while reading the file.
get
Reads the content of a remote file and returns it as a string using the specified encoding. Returns at most
maxGetSize characters.
Deprecated:
The maxGetSize attribute is not supported anymore. Use the method get(String, String) instead.
Parameters:
path
-
remote path of the file to be read.
encoding
-
the encoding to use.
maxGetSize
-
the maximum bytes fetched from the remote file.
Returns:
the contents of the file or null if an error occurred while reading the file.
get
Reads the content of a remote file and creates a local copy in the given file using the passed string encoding to
read the file content and using the system standard encoding "UTF-8" to write the file. Copies at most
MAX_GET_FILE_SIZE bytes.
Parameters:
path
-
remote path of the file to be read.
encoding
-
the encoding to use.
file
-
the local file name
Returns:
true if remote file is fetched and copied into local file.
get
Reads the content of a remote file and creates a local copy in the given file using the passed string encoding to
read the file content and using the system standard encoding "UTF-8" to write the file. Copies at most maxGetSize
bytes.
Deprecated:
The maxGetSize attribute is not supported anymore. Use the method get(String, String, File) instead.
Parameters:
path
-
remote path of the file to be read.
encoding
-
the encoding to use.
file
-
the local file name
maxGetSize
-
the maximum number of bytes to fetch
Returns:
true if remote file is fetched and copied into local file.
getBinary
Reads the content of a remote file and creates a local copy in the given file. Copies at most MAX_GET_FILE_SIZE
bytes. The FTP transfer is done in Binary mode.
Parameters:
path
-
remote path of the file to be read.
file
-
the local file name
Returns:
true if remote file is fetched and copied into local file.
getBinary
Reads the content of a remote file and creates a local copy in the given file. Copies at most maxGetSize bytes.
The FTP transfer is done in Binary mode.
Deprecated:
The maxGetSize attribute is not supported anymore. Use the method getBinary(String, File) instead.
Parameters:
path
-
remote path of the file to be read.
file
-
the local file name
maxGetSize
-
the maximum number of bytes to fetch
Returns:
true if remote file is fetched and copied into local file.
getConnected
getConnected()
:
boolean
Identifies if the FTP client is currently connected to the FTP server.
Returns:
true if the client is currently connected.
getReplyCode
getReplyCode()
:
Number
Returns the reply code from the last FTP action.
Returns:
the reply code from the last FTP action.
getReplyMessage
getReplyMessage()
:
String
Returns the string message from the last FTP action.
Returns:
the string message from the last FTP action.
getTimeout
getTimeout()
:
Number
Returns the timeout for this client, in milliseconds.
Returns:
the timeout in milliseconds
list
list()
:
FTPFileInfo[]
Returns a list of FTPFileInfo objects containing information about the files in the current directory.
Returns:
list of objects with remote file information.
list
Returns a list of FTPFileInfo objects containing information about the files in the remote directory defined by
the given path.
Parameters:
path
-
the remote path from which the file info is listed.
Returns:
list of objects with remote file information.
mkdir
mkdir(path
:
String)
:
boolean
Creates a directory
Parameters:
path
-
the path to the directory to create.
Returns:
true if the directory was successfully created, false otherwise.
put
Puts the specified content to the specified full path using "ISO-8859-1" encoding. The full path must include the
path and the file name. If the content of a local file is to be uploaded, please use method
putBinary(String, File) instead.
Parameters:
path
-
full path on the remote FTP server where the file will be stored.
content
-
the content to put.
Returns:
true or false indicating success or failure.
put
Put the given content to a file on the given full path on the FTP server. The full path must include the path and
the file name. The transformation from String into binary data is done via the encoding provided with the method
call. If the content of a local file is to be uploaded, please use method putBinary(String, File)
instead.
Parameters:
path
-
the full path on the remote FTP server where the file will be stored.
content
-
the content to put.
encoding
-
the encoding to use.
Returns:
true or false indicating success or failure.
putBinary
Put the content of the given file into a file on the remote FTP server with the given full path. The full path
must include the path and the file name.
Parameters:
path
-
the full path on the remote FTP server where the file will be stored.
file
-
the file on the local system, which content is send to the remote FTP server.
Returns:
true or false indicating success or failure.
removeDirectory
removeDirectory(path
:
String)
:
boolean
Deletes the remote directory on the server identified by the path parameter. In order to delete the directory
successfully the directory needs to be empty, otherwise the removeDirectory() method will return false.
Parameters:
path
-
the path to the directory.
Returns:
true if the directory was successfully deleted, false otherwise.
rename
Renames an existing file.
Parameters:
from
-
the file that will be renamed.
to
-
the name of the new file.
Returns:
true if the file was successfully renamed, false otherwise.
setTimeout
setTimeout(timeoutMillis
:
Number)
:
void
Sets the timeout for connections made with the FTP client to the given number of milliseconds. If the given
timeout is less than or equal to zero, the timeout is set to the same value as the script context timeout but
will only be set to a maximum of 30 seconds.
The maximum and default timeout depend on the script context timeout. The maximum timeout is set to a maximum of 2 minutes. The default timeout for a new client is set to a maximum of 30 seconds.
This method can be called at any time, and will affect the next connection made with this client. It is not possible to set the timeout for an open connection.
Parameters:
timeoutMillis
-
timeout, in milliseconds, up to a maximum of 2 minutes.
