SCXML Invoke

Invoke montre comment utiliser l'élément <invoke> avec des machines d'état 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

Pour exécuter l'exemple à partir de Qt CreatorOuvrez le mode Welcome et sélectionnez l'exemple à partir de Examples. Pour plus d'informations, voir Qt Creator: Tutoriel : Construire et exécuter.

Invocation de la machine d'état

Dans le fichier statemachine.scxml, nous spécifions 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 établissons un lien avec le module Qt SCXML en ajoutant les lignes suivantes aux fichiers de compilation de l'exemple.

invoke.pro lors de l'utilisation de qmake :

QT += qml scxml

Nous spécifions ensuite la machine d'état à compiler :

STATECHARTS = statemachine.scxml

CMakeLists.txt lors de l'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 d'état à compiler :

qt6_add_statecharts(invoke
    statemachine.scxml
)

Les directives STATECHARTS ou qt6_add_statecharts invoquent le compilateur Qt SCXML, qscxmlc, qui est exécuté automatiquement pour générer statemachine.h et statemachine.cpp, qui sont ensuite ajoutés de manière appropriée en tant qu'en-têtes et sources 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 @ code.qt.io