Qt Creator 4.2 のSCXML Editorを使ってみる！

こんにちは、[Qt Advent Calendar 2016](http://qiita.com/advent-calendar/2016/qt)の20日目の記事です。

何を記事にするか迷っていた時にQt Creator 4.2がリリースされ、新機能としてSCXML Editorが追加されました。自分も仕事でよく状態遷移図を使用するのでQt SCXMLのリリースは興味があり記事にしてみました。

Qt SCXMLはState Chart XMLファイルから状態遷移図を作成し、Qt C ++およびQt Quickアプリケーションに埋め込むことができるQtの新しいモジュールです。 

SCXML Editorを使用するには
========================
Qt Creator の[ヘルプ]メニューの[プラグインについて]を選択して、Modeling-ScxmlEditorをチェックします。ScxmlEditorはディフォルトでチェックされていません。
![Screenshot .png](https://qiita-image-store.s3.amazonaws.com/0/150127/1ab64bc1-8f38-c9f3-7b56-5b2cea5577f7.png)

State Chart XMLの追加
====================
Qt Creatorの[ファイル]メニューから[ファイル/プロジェクトの新規作成]を選択してモデリングの状態遷移を選択します。
![新しファイル.png](https://qiita-image-store.s3.amazonaws.com/0/150127/93a6794d-1242-914c-9193-908fff4cd3d2.png)

次に状態遷移名とパスを決定します。。
![状態遷移名.png](https://qiita-image-store.s3.amazonaws.com/0/150127/fd0dd1b3-e014-018d-66de-95f7be952702.png)

State Chart XMLの編集
====================
サイドバーにあるプロジェクト ブラウザからscxmlファイルをクリックしてSCXML Editorを開きます。

### ステート要素の追加
Common Statesからステート要素を選択してメインウィンドウにドラック＆ドロップします。
![path4151.png](https://qiita-image-store.s3.amazonaws.com/0/150127/6b0a3232-ee38-3503-be1d-7a02baac0bbd.png)

### ステート間の接続方法
メインウィンドウに配置されたFinal以外のステート要素を選択すると上部にいくつかのアイコンが表示されます。[↗アイコン]をクリックして接続したいステート要素の上で右クリックします。そうするとステート要素間を接続することができます。
![updateScxml1.png](https://qiita-image-store.s3.amazonaws.com/0/150127/fd1e42da-82a5-b72f-3bdb-7df4a7072e41.png)

### ステート要素の作成と接続方法
先ほどと同様に、ステート要素を選択します。上部の[□アイコン]をクリックして適当なところで右クリックします。そうすると、新規Stateの作成とステート要素間の接続が同時に行われます。
![updateScxml2.png](https://qiita-image-store.s3.amazonaws.com/0/150127/8259d50c-e523-3dd0-4675-d27f5c62b5ff.png)

> 同様にFinal/Parallel/Historyもステート要素の作成と接続が同時に可能です。

サンプル プログラム
==================
簡単なサンプルプログラムを書いてみました。

## サンプルプログラムの動作
- S1ボタンをクリックすると、S11 → S12 → S13の状態を繰り返し遷移します。
- S2ボタンをクリックするとS2状態に遷移します。
- S2状態に遷移している状態で、S1ボタンをクリックすると最後のS1状態に復元します。(ヒストリー機能)
- S2状態に遷移している状態で、Exitボタンをクリックすると、サンプルプログラムが終了します。

![testWidget.png](https://qiita-image-store.s3.amazonaws.com/0/150127/4a6af756-df18-85fb-597b-8e26116bab97.png)

### サンプル プログラムの状態遷移図
(statemachine.scxml / scxml name: LessonStateMachine)
![StateMachine70.png](https://qiita-image-store.s3.amazonaws.com/0/150127/8b58d6ba-3476-06a0-69cb-614f5629b1d5.png)

## サンプルプログラムの説明

**stateChartXML.proの補足**

- プロジェクト ファイルにQt SCXMLモジュールをリンク対象にするためQT +=scxmlを追記します。
- 状態遷移図を追加します。Qt CreatorからState Chart XMLを追加した場合は自動で記述されます。 (STATECHARTS += statemachine.scxml)
- 最後に、load(qscxmlc)を追加します。  
Qt SCXML コンパイラ(qscxmlc)はscxmlファイルを読み取り、SCXMLで定義された状態遷移を実装するためのC++のソースとヘッダーファイルを生成します。


```cpp:stateChartXML.pro
QT     += core gui scxml
CONFIG += c++11

greaterThan(QT_MAJOR_VERSION, 4): QT += widgets

TARGET = stateChartXML
TEMPLATE = app

# The following define makes your compiler emit warnings if you use
# any feature of Qt which as been marked as deprecated (the exact warnings
# depend on your compiler). Please consult the documentation of the
# deprecated API in order to know how to port your code away from it.
DEFINES += QT_DEPRECATED_WARNINGS

# You can also make your code fail to compile if you use deprecated APIs.
# In order to do so, uncomment the following line.
# You can also select to disable deprecated APIs only up to a certain version of Qt.
#DEFINES += QT_DISABLE_DEPRECATED_BEFORE=0x060000    # disables all the APIs deprecated before Qt 6.0.0


SOURCES += main.cpp\
        testsignal.cpp

HEADERS  += testsignal.h

FORMS    += testsignal.ui

STATECHARTS += \
    statemachine.scxml

load(qscxmlc)
```


**main.cppの補足**

- main.cppでLessonStateMachineのインスタンスを生成します。
- LessonStateMachineクラスは、statemachine.scxmlで定義された状態遷移をQt SCXML コンパイラがビルドディレクトリに生成したstatemachine.cppとstatemachine.hに定義されています。


> cpp/hのファイル名はscxmlファイル名から使用され、クラス名は状態遷移の名前(scxml name)が使用されるようです。

```cpp:main.cpp
#include "testsignal.h"
#include "statemachine.h"

#include <QApplication>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);

    LessonStateMachine machine;
    TestSignal widget(&machine);

    machine.start();
    widget.show();

    return app.exec();
}
```



**testsignal.h/cppの補足**

シグナルとスロットの処理をしています。


```cpp:testsignal.h
#ifndef TESTSIGNAL_H
#define TESTSIGNAL_H

#include <QWidget>

namespace Ui {
class TestSignal;
}
class QScxmlStateMachine;

class TestSignal : public QWidget
{
    Q_OBJECT

public:
    explicit TestSignal(QScxmlStateMachine *machine, QWidget *parent = 0);
    ~TestSignal();

private:
    Ui::TestSignal *ui;
    QScxmlStateMachine *m_machine;

public slots:
    void onStateS11();
    void onStateS12();
    void onStateS13();
    void onStateS2();
};

#endif // TESTSIGNAL_H
```



```cpp:testsignal.cpp
#include "testsignal.h"
#include "ui_testsignal.h"

#include <QScxmlStateMachine>

TestSignal::TestSignal(QScxmlStateMachine *machine, QWidget *parent) :
    QWidget(parent),
    ui(new Ui::TestSignal),
    m_machine(machine)
{
    ui->setupUi(this);

    connect(ui->pushButtonS1, &QAbstractButton::clicked, [this] {
        m_machine->submitEvent("S1.Clicked");
    });
    connect(ui->pushButtonS2, &QAbstractButton::clicked, [this] {
        m_machine->submitEvent("S2.Clicked");
    });
    connect(ui->pushButtonExit, &QAbstractButton::clicked, [this] {
        m_machine->submitEvent("Exit.Clicked");
    });

    machine->connectToState(QStringLiteral("S11"),
                     this, SLOT(onStateS11()));
    machine->connectToState(QStringLiteral("S12"),
                     this, SLOT(onStateS12()));
    machine->connectToState(QStringLiteral("S13"),
                     this, SLOT(onStateS13()));
    machine->connectToState(QStringLiteral("S2"),
                     this, SLOT(onStateS2()));
    machine->connectToState(QStringLiteral("Final"),
                     this, SLOT(close()));

    ui->log->setText(QString());

}

TestSignal::~TestSignal()
{
    delete ui;
}

void TestSignal::onStateS11()
{
    ui->log->setText("S11");
}

void TestSignal::onStateS12()
{
    ui->log->setText("S12");
}

void TestSignal::onStateS13()
{
    ui->log->setText("S13");
}

void TestSignal::onStateS2()
{
    ui->log->setText("S2");
}
```


まとめ
=====

- 状態遷移の管理を直接、状態遷移図で使用できるのは便利です。
- scxmlファイルを動的に読むことも可能なので、面白い使用方法もありそな感じで楽しみな機能です。

明日もQt Creator ネタです。[ynuma](http://qiita.com/ynuma)さんの“Qt Creator Autotest Pluginについて“ です。