SCXML Invoke

Invoke montre comment utiliser l'élément ` <invoke> ` avec des machines à états imbriquées générées, où le fichier SCXML est compilé en une classe C++. L'élément ` <invoke> ` est utilisé pour créer une instance d'un service externe.

Exécution de l'exemple

Vous pouvez exécuter l’exemple à partir de :

• Qt Creator

  Ouvrez le mode « Welcome » et sélectionnez l’exemple dans « Examples ». Pour plus d’informations, consultez Qt Creator: Tutoriel : Compiler et exécuter.

• Qt Extension for Visual Studio Code

  Exécutez la commande « Qt: Open Qt examples » à partir de Command Palette, puis sélectionnez l’exemple dans la liste. Pour plus d’informations, consultez Qt Extension for Visual Studio Code: Tutoriel : Compiler et exécuter.

Appel de la machine à états

Dans statemachine.scxml, nous définissons une machine à états nommée DirectionsStateMachine de type http://www.w3.org/TR/scxml/ à invoquer :

<scxml
    xmlns="http://www.w3.org/2005/07/scxml"
    version="1.0"
    name="DirectionsStateMachine"
    initial="anyplace"
>
    <state id="anyplace">
        <transition event="goNowhere" target="nowhere"/>
        <transition event="goSomewhere" target="somewhere"/>

        <state id="nowhere"/>
        <state id="somewhere">
            <invoke type="http://www.w3.org/TR/scxml/">
                <content>
                    <scxml name="anywhere" version="1.0">
                        <state id="here">
                            <transition event="goThere" target="there"/>
                        </state>
                        <state id="there">
                            <transition event="goHere" target="here"/>
                        </state>
                    </scxml>
                </content>
            </invoke>
        </state>
    </state>
</scxml>

Compilation de la machine à états

Nous effectuons la liaison avec le module Qt SCXML en ajoutant les lignes suivantes aux fichiers de compilation de l’exemple.

invoke.pro lorsque l’on utilise qmake :

QT += qml scxml

Nous spécifions ensuite la machine à états à compiler :

STATECHARTS = statemachine.scxml

CMakeLists.txt en cas d’utilisation de cmake :

find_package(Qt6 REQUIRED COMPONENTS Core Gui Qml Scxml)

target_link_libraries(invoke PRIVATE
    Qt6::Core
    Qt6::Gui
    Qt6::Qml
    Qt6::Scxml
)

Nous spécifions ensuite la machine à états à compiler :

qt6_add_statecharts(invoke
    statemachine.scxml
)

Les directives de diagramme d’états STATECHARTS ou qt6_add_statecharts invoquent le compilateur Qt SCXML, qscxmlc, qui s’exécute automatiquement pour générer les fichiers statemachine.h et statemachine.cpp, lesquels sont ensuite ajoutés de manière appropriée en tant qu’en-têtes et fichiers source pour la compilation.

Déclaration de la machine à états en tant qu’élément QML

La machine à états est déclarée en tant qu'élément QML comme suit :

struct DirectionsStateMachineRegistration
{
    Q_GADGET
    QML_FOREIGN(DirectionsStateMachine)
    QML_NAMED_ELEMENT(DirectionsStateMachine)
    QML_ADDED_IN_VERSION(1, 0)
};

Instanciation de la machine à états

Nous instancions l’élément « DirectionsStateMachine » généré dans le fichier MainView.qml, comme suit :

    DirectionsStateMachine {
        id: stateMachine
        running: true
    }

Exemple de projet sur code.qt.io