En esta página

Cliente FTP SCXML

Implementa un cliente FTP sencillo utilizando una máquina de estados.

El cliente FTP utiliza « Qt SCXML » para implementar un cliente FTP capaz de comunicarse con un servicio FTP enviando mensajes de control FTP traducidos a partir de eventos de la máquina de estados y traduciendo las respuestas del servidor a eventos de la máquina de estados. Los datos recibidos del servidor FTP se muestran en la consola.

El RFC 959 especifica diagramas de estados para la gestión de comandos del cliente FTP. Estos pueden traducirse fácilmente a SCXML para aprovechar los estados anidados de SCXML. Las conexiones entre el cliente y el servidor, así como la transferencia de datos, se implementan mediante C++. Además, se utilizan señales y ranuras de Qt.

La máquina de estados tiene los siguientes estados:

Diagrama de estados de un cliente FTP con los estados I, S, F y P, y los subsistemas B y W para los flujos de trabajo de inicio de sesión y transferencia

  • I como estado inicial.
  • B para el envío de comandos.
  • S para éxito.
  • F para el fallo.
  • W: en espera de una respuesta.
  • P: para proporcionar una contraseña a petición del servidor.

La máquina de estados se especifica en el archivo simpleftp.scxml y se compila en la clase ` FtpClient `, que implementa la lógica del protocolo FTP. Esta reacciona a las entradas del usuario y a las respuestas del canal de control cambiando de estado y enviando eventos externos. Además, implementamos una clase ` FtpControlChannel ` y una clase ` FtpDataChannel ` que gestionan los sockets y servidores TCP y convierten los finales de línea.

Ejecución del ejemplo

Puedes ejecutar el ejemplo desde:

Compilación de la máquina de estados

Enlazamos con el módulo « Qt SCXML » añadiendo la siguiente línea a los archivos de compilación del proyecto.

Con qmake, añadimos lo siguiente a ftpclient.pro

QT = core scxml network

A continuación, especificamos la máquina de estados que se va a compilar:

STATECHARTS += simpleftp.scxml

Con CMake, añadimos lo siguiente al archivo CMakeLists.txt

find_package(Qt6 REQUIRED COMPONENTS Core Network Scxml)

target_link_libraries(ftpclient PRIVATE
    Qt6::Core
    Qt6::Network
    Qt6::Scxml
)

A continuación, especificamos la máquina de estados que se va a compilar:

qt6_add_statecharts(ftpclient
    simpleftp.scxml
)

El compilador « Qt SCXML », qscxmlc, se ejecuta automáticamente para generar los archivos simpleftp.h y simpleftp.cpp, y para añadirlos adecuadamente al proyecto como archivos de cabecera y de código fuente.

Instanciación de la máquina de estados

Instanciamos la clase FtpClient generada, así como las clases FtpDataChannel y FtpControlChannel en el archivo main.cpp:

#include "ftpcontrolchannel.h"
#include "ftpdatachannel.h"
#include "simpleftp.h"
    ...
int main(int argc, char *argv[])
{
    ...
    QCoreApplication app(argc, argv);
    FtpClient ftpClient;
    FtpDataChannel dataChannel;
    FtpControlChannel controlChannel;
    ...

Comunicación con un servidor FTP

Mostramos en la consola todos los datos recuperados del servidor:

    QObject::connect(&dataChannel, &FtpDataChannel::dataReceived,
                     [](const QByteArray &data) {
        std::cout << data.constData() << std::flush;
    });

Convertimos las respuestas del servidor en eventos de la máquina de estados:

    QObject::connect(&controlChannel, &FtpControlChannel::reply, &ftpClient,
                     [&ftpClient](int code, const QString &parameters) {
        ftpClient.submitEvent(QString("reply.%1xx")
                              .arg(code / 100), parameters);
    });

Convertimos los comandos de la máquina de estados en mensajes de control FTP:

    ftpClient.connectToEvent("submit.cmd", &controlChannel,
                             [&controlChannel](const QScxmlEvent &event) {
        controlChannel.command(event.name().mid(11).toUtf8(),
                               event.data().toMap()["params"].toByteArray());
    });

Enviamos comandos para iniciar sesión en el servidor FTP como usuario anónimo, para indicar un puerto para la conexión de datos y para recuperar un archivo:

    QList<Command> commands({
        {"cmd.USER", "anonymous"},// login
        {"cmd.PORT", ""},         // announce port for data connection,
                                  // args added below.
        {"cmd.RETR", file}        // retrieve a file
    });

Especificamos que el cliente FTP debe enviar el siguiente comando al entrar en el estado B:

    ftpClient.connectToState("B", QScxmlStateMachine::onEntry([&]() {
        if (commands.isEmpty()) {
            app.quit();
            return;
        }
        Command command = commands.takeFirst();
        qDebug() << "Posting command" << command.cmd << command.args;
        ftpClient.submitEvent(command.cmd, command.args);
    }));

Especificamos que el cliente FTP debe enviar una cadena vacía como contraseña si el servidor la solicita:

    ftpClient.connectToState("P", QScxmlStateMachine::onEntry([&ftpClient]() {
        qDebug() << "Sending password";
        ftpClient.submitEvent("cmd.PASS", QString());
    }));

Por último, nos conectamos al servidor FTP especificado como primer argumento del método y recuperamos el archivo especificado como segundo argumento:

    controlChannel.connectToServer(server);
    QObject::connect(&controlChannel, &FtpControlChannel::opened, &dataChannel,
                     [&](const QHostAddress &address, int) {
        dataChannel.listen(address);
        commands[1].args = dataChannel.portspec();
        ftpClient.start();
    });

Por ejemplo, la siguiente llamada muestra el archivo especificado del servidor indicado: ftpclient <server> <file>.

Proyecto de ejemplo en @ code.qt.io

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.