Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space WDESIGNER and version 24.0

With the URL adapter, it is possible to get and put messages via the FTP protocol. The input and output of this adapter is always of type Blob to support all possible data types (e.g. binary for images, text with HTML code, XML messages, etc.).

FTP commands like RNFR, RNTO, etc. are also supported (see also http://www.faqs.org/rfcs/rfc959.html).

Differences between FTP and FTPS

A lot of times these protocols get confused and mixed up due to the similarity in function and names. The xUML Runtime supports the following file transfer protocols:

FTPFTPS
File Transfer ProtocolFTP Secure and FTP-SSL
Classic insecure FTPFTP over TLS/SSL
Plain FTPPlain FTP over TLS/SSL channel
Username and password are sent as clear text over the networkUser name and password are encrypted
Transfer is not encryptedTransfer is encrypted
Uses TCP port 21Uses TCP port 21 or 990
Info

FTP via SSH is not supported by the xUML Runtime.

Transfer Mode

The transfer mode by default is set to binary, only the list command is transferred in ASCII mode.

You can change the transfer mode by using cURL option CURLOPT_QUOTE (see chapter Setting cURL Options on the URL Adapter ). When using this option, the transfer mode is changed before any method is executed.
Using the command TYPE Ib in the command array, you can change this behavior and these commands are executed after any method.

Streaming FTP

When reading or writing files, the examples load the whole file into memory. This might cause problems if these files are big.

In order to avoid consuming too much memory the URL adapter offers the option to read and write data in little chunks. This mechanism is called streaming, since, after reading a small data chunk from the FTP server, it is immediately written to a file before doing the next read. For sending data, the mechanism works analogously.

Alias Attributes

Find below a list of relevant alias attributes, if the URL adapter is used with the FTP protocol. Default values used when an option is not explicitly set are written in bold.

AttributeDescriptionAllowed Values / Examples
Standard
protocol

Multiexcerpt include
MultiExcerptNameprotocol
PageWithExcerptURL

ftp

port

Multiexcerpt include
MultiExcerptNameport
PageWithExcerptURL

a valid port number (default: 21)
path

Multiexcerpt include
MultiExcerptNamepath
PageWithExcerptURL


method

Multiexcerpt include
MultiExcerptNamemethod
PageWithExcerptURL

one of: get (default), post, put, list
Advanced
userUsername/password.
options
Multiexcerpt include
MultiExcerptNameoptions
PageWithExcerptURL
valid cURL options, e.g. CURLOPT_TIMEOUT=20
Proxy
proxyURL

Multiexcerpt include
MultiExcerptNameproxyURL
PageWithExcerptURL


proxyUser

Multiexcerpt include
MultiExcerptNameproxyUser
PageWithExcerptURL


proxyType

Multiexcerpt include
MultiExcerptNameproxyType
PageWithExcerptURL

one of: HTTP, SOCKS5
Panel
titleOn this Page:
Table of Contents
Panel
titleRelated Pages:

Otp
Floatingfalse

rp

Children Display