SMC - 状态机代码生成工具

一、介绍

1.1 smc简介

     smc官网地址: smc官方网站.
  SMC是用java开发的一个状态机软件代码生成工具,SMC支持多种开发语言:C、JavaScript、Python、C++、Lua、Ruby、C#、Objective-C、Scala、Groovy、Perl、TCL、Java、PHP、VB.NET等,而我们需要做的就是完成一个.sm的脚本和拥有这些状态的主体类。
  利用有限状态机来控制对象的行为,其原理就是利用多态,常常我们自己写代码,需要很大篇幅,万一需要再加一个或者几个状态,自己维护时就会很麻烦,SMC这个工具可以帮助我们解决这个问题。
  SMC可以通过一个配置文件,生成有限状态机所需的所有状态类以及状态机类,同时还包括了所有的状态间的转换逻辑。

1.2 环境准备

  我们这里以java语言为例来进行说明。
  使用这个工具之前我们需要jdk环境,最新版的SMC支持jdk1.7,之前版本的SMC支持jdk1.6,要想中间没有问题,一定要将电脑上的jdk版本与SMC的jdk版本对应起来。
smc下载地址: http://sourceforge.net/projects/smc/files/.

二、 smc文件格式说明

%class 状态机所作用的类
%package 类所在的包
%access 生成类的可访问级别
%start 指定状态机的开始状态
%map 状态机的名字
%%...%%:这一对%%中间定义了各个状态类以及状态的各种行为。格式说明如下:

注意:sm文件名称需要与.sm文件中指定的%class 类名称 相同

Start  --状态1(名称可自定义)
{
      DoStart  --Do状态名:执行状态1
           State2–执行完状态1之后,跳转到该状态(状态2)
			{method1();}–执行状态1时,需要实现的功能
}
State2-状态2
{      
      DoState2
             [ctxt.isSuccessState2()== true] – ctxt:上下文,实体类CoreSchMatch  中isSuccessState2()函数返回值为true时,执行该功能
               State3
               {
                    notifyClientState2Ok();
               }
      DoState2
             [ctxt.isSuccessState2()==== false] – ctxt:上下文,实体类CoreSchMatch  中isSuccessState2()函数返回值为false时,执行该功能
             State2Fail{notifyClientState2Fail();}
}
State3
{
      DoState3
      nil{method3();releaseStm();}–表示清空资源;nli-结束状态
}
State2Fail
{
      DoState2Fail
      nil{releaseStm();}–表示清空资源;nli-结束状态
      Default -- 默认状态转换:被放置在一个状态中,用于备份所有转换。
        {
           nil{ process();}
        }
}
Default –默认状态,如果状态机接收到未在该状态机中定义的转换时,定义该状态下的动作或转换
{
    DoStart
        nil
        {}
    DoState2
   		nil
        {}
   DoState3
		nil
	    {}
   DoState2Fail
		nil
	    {}
}

三、java - smc 代码生成过程

3.1 java环境

1、创建java工程;
2、引入jar包:Smc.jar
3、创建:SchMatchState.sm文件
1

3.2 编写smc文件

  下面设计这样一个简单状态机,程序初始化时,进入"start"初始状态;当在”"start"初始状态收到信号时,进入”busy“状态;当在"busy"状态收到一个"special"的信号时,进入"idle"状态,当在"busy"状态收到一个"exception"的信号时,进入"stop"退出状态。

实现这个状态机的.sm脚本我们将它命名为SchMatchState.sm,
具体的脚本如下所示:

%{

%}
%class SchMatchState
%package com.math.sch
%start SchMatchStateMap::Start
%map SchMatchStateMap
%%
Start
{
      DoStart
      Busy{state2Busy();}
}
Busy  
{
     DoBusy [ctxt.isSpecialState() == true] Idle{idleProcess();}
     DoBusy [ctxt.isSpecialState() == false] Stop{stopProcess();}
}
Idle{
	DoIdle
	nil {release();}
}
Stop{
	DoStop
	nil {release();}
}
Default
{
    DoStart
        nil
        {}
    DoBusy
    	nil
        {}
   	DoIdle
   		nil
   		{}
   	DoStop
   		nil
   		{}
}
%%

3.3 执行.sm文件

执行.sm文件,生成对应的类和方法,有两种方法:
1、通过命令行执行生成;
2、通过ant自动化编译工具生成;

3.3.1 命令行方式

1、命令行内容:
java -jar Smc.jar -java -g -d ./ 需要处理的状态机.sm文件名
示例:

java -jar Smc.jar  -java -g -d ./ SchMatchState.sm

2、执行命令:
(1)Window+R,打开cmd命令行窗口;
(2)在命令行中进入smc.jar包的位置:
(3)执行命令:

注意:sm文件名称需要与.sm文件中指定的%class 类名称 相同,我这边因为名称不相同导致生成异常:
2

执行过程:
3
3、执行之后,程序会自动创建SchMatchStateContext类,类中定义状态机的全过程。
4
4、 SchMatchState类中会自动创建状态机中定义的所有功能函数,根据实际需要实现对应的功能即可。

  如果没有生成SchMatchState类,可在SchMatchStateContext类中根据提示,依次生成对应的类和函数,并实现对应的函数功能。

5、 在SchMatchState类中实现startCoreSchMatch()函数,用于状态机启动 --> 执行所有的动作函数:

public void startCoreSchMatch(){
		fsm.enterStartState();
		fsm.DoStart();
		fsm.DoBusy();
		fsm.DoIdle();
		fsm.DoStop();
	}

3.3.2 通过ant自动化编译工具生成

  Apache Ant 是一个将软件编译、测试、部署等步骤联系在一起加以自动化的一个工具,大多用于Java环境中的软件开发。在实际软件开发中,有很多地方可以用到ant。
  ant的相关介绍和下载可参考链接: Apache Ant的基础使用教程.

3.4 java代码

本文案例的资源链接:SMC - 状态机 - Java工程实现示例.

3.4.1 SchMatchState类

package com.math.sch;


public class SchMatchState {
    private SchMatchStateContext fsm;
    private String currentState = "start";
    public static void main(String[] args) {
		new SchMatchState().start();
	}
    public void start(){
		System.out.println("状态机开始: ");
		this.fsm = new SchMatchStateContext(this);
		startCoreSchMatch();
	}
	public void startCoreSchMatch(){
		fsm.enterStartState();
		fsm.DoStart();
		fsm.DoBusy();
		fsm.DoIdle();
		fsm.DoStop();
	}
	public void state2Busy() {
		this.currentState = "busy";
		System.out.println("当前状态:"+currentState+" -> 转换状态至:busy");
	}

	public boolean isSpecialState() {
		if("busy".equals(currentState)){
			this.currentState = "Special";
			return true;
		}
		return false;
	}

	public void idleProcess() {
		System.out.println("当前状态:"+currentState+" -> 转换状态至:idle");
		this.currentState = "stop";
	}

	public void stopProcess() {
		this.currentState = "stop";
		System.out.println("当前状态:"+currentState);
	}

	public void release() {
		this.currentState = "start";
		System.out.println("状态机结束并清空");
	}

}

执行结果输出情况:
4

总结:FSM是一种固定的范式,因此采用工具帮我们实现可以减少犯错误的机会。输入的文件就是:实体.sm。我们把重点放在业务逻辑上,所以与状态有关的代码smc都帮我们生成好了。

3.4.2 SchMatchStateContext类

/*
 * ex: set ro:
 * DO NOT EDIT.
 * generated by smc (http://smc.sourceforge.net/)
 * from file : SchMatchState.sm
 */





package com.math.sch;

import java.io.PrintStream;

public class SchMatchStateContext
    extends statemap.FSMContext
{
//---------------------------------------------------------------
// Member methods.
//

    public SchMatchStateContext(SchMatchState owner)
    {
        super (SchMatchStateMap.Start);

        _owner = owner;
    }

    public SchMatchStateContext(SchMatchState owner, SchMatchStateState initState)
    {
        super (initState);

        _owner = owner;
    }

    public void enterStartState()
    {
        getState().Entry(this);
        return;
    }

    public void DoBusy()
    {
        _transition = "DoBusy";
        getState().DoBusy(this);
        _transition = "";
        return;
    }

    public void DoIdle()
    {
        _transition = "DoIdle";
        getState().DoIdle(this);
        _transition = "";
        return;
    }

    public void DoStart()
    {
        _transition = "DoStart";
        getState().DoStart(this);
        _transition = "";
        return;
    }

    public void DoStop()
    {
        _transition = "DoStop";
        getState().DoStop(this);
        _transition = "";
        return;
    }

    public SchMatchStateState getState()
        throws statemap.StateUndefinedException
    {
        if (_state == null)
        {
            throw(
                new statemap.StateUndefinedException());
        }

        return ((SchMatchStateState) _state);
    }

    protected SchMatchState getOwner()
    {
        return (_owner);
    }

    public void setOwner(SchMatchState owner)
    {
        if (owner == null)
        {
            throw (
                new NullPointerException(
                    "null owner"));
        }
        else
        {
            _owner = owner;
        }

        return;
    }

//---------------------------------------------------------------
// Member data.
//

    transient private SchMatchState _owner;

//---------------------------------------------------------------
// Inner classes.
//

    public static abstract class SchMatchStateState
        extends statemap.State
    {
    //-----------------------------------------------------------
    // Member methods.
    //

        protected SchMatchStateState(String name, int id)
        {
            super (name, id);
        }

        protected void Entry(SchMatchStateContext context) {}
        protected void Exit(SchMatchStateContext context) {}

        protected void DoBusy(SchMatchStateContext context)
        {
            Default(context);
        }

        protected void DoIdle(SchMatchStateContext context)
        {
            Default(context);
        }

        protected void DoStart(SchMatchStateContext context)
        {
            Default(context);
        }

        protected void DoStop(SchMatchStateContext context)
        {
            Default(context);
        }

        protected void Default(SchMatchStateContext context)
        {
            if (context.getDebugFlag() == true)
            {
                PrintStream str = 
                    context.getDebugStream();

                str.println(
                    "TRANSITION   : Default");
            }

            throw (
                new statemap.TransitionUndefinedException(
                    "State: " +
                    context.getState().getName() +
                    ", Transition: " +
                    context.getTransition()));
        }

    //-----------------------------------------------------------
    // Member data.
    //
    }

    /* package */ static abstract class SchMatchStateMap
    {
    //-----------------------------------------------------------
    // Member methods.
    //

    //-----------------------------------------------------------
    // Member data.
    //

        //-------------------------------------------------------
        // Constants.
        //
        public static final SchMatchStateMap_Default.SchMatchStateMap_Start Start =
            new SchMatchStateMap_Default.SchMatchStateMap_Start("SchMatchStateMap.Start", 0);
        public static final SchMatchStateMap_Default.SchMatchStateMap_Busy Busy =
            new SchMatchStateMap_Default.SchMatchStateMap_Busy("SchMatchStateMap.Busy", 1);
        public static final SchMatchStateMap_Default.SchMatchStateMap_Idle Idle =
            new SchMatchStateMap_Default.SchMatchStateMap_Idle("SchMatchStateMap.Idle", 2);
        public static final SchMatchStateMap_Default.SchMatchStateMap_Stop Stop =
            new SchMatchStateMap_Default.SchMatchStateMap_Stop("SchMatchStateMap.Stop", 3);
        private static final SchMatchStateMap_Default Default =
            new SchMatchStateMap_Default("SchMatchStateMap.Default", -1);

    }

    protected static class SchMatchStateMap_Default
        extends SchMatchStateState
    {
    //-----------------------------------------------------------
    // Member methods.
    //

        protected SchMatchStateMap_Default(String name, int id)
        {
            super (name, id);
        }

        protected void DoStart(SchMatchStateContext context)
        {

            if (context.getDebugFlag() == true)
            {
                PrintStream str = context.getDebugStream();

                str.println("TRANSITION   : SchMatchStateMap.Default.DoStart()");
            }


            return;
        }

        protected void DoBusy(SchMatchStateContext context)
        {

            if (context.getDebugFlag() == true)
            {
                PrintStream str = context.getDebugStream();

                str.println("TRANSITION   : SchMatchStateMap.Default.DoBusy()");
            }


            return;
        }

        protected void DoIdle(SchMatchStateContext context)
        {

            if (context.getDebugFlag() == true)
            {
                PrintStream str = context.getDebugStream();

                str.println("TRANSITION   : SchMatchStateMap.Default.DoIdle()");
            }


            return;
        }

        protected void DoStop(SchMatchStateContext context)
        {

            if (context.getDebugFlag() == true)
            {
                PrintStream str = context.getDebugStream();

                str.println("TRANSITION   : SchMatchStateMap.Default.DoStop()");
            }


            return;
        }

    //-----------------------------------------------------------
    // Inner classse.
    //


        private static final class SchMatchStateMap_Start
            extends SchMatchStateMap_Default
        {
        //-------------------------------------------------------
        // Member methods.
        //

            private SchMatchStateMap_Start(String name, int id)
            {
                super (name, id);
            }

            protected void DoStart(SchMatchStateContext context)
            {
                SchMatchState ctxt = context.getOwner();

                if (context.getDebugFlag() == true)
                {
                    PrintStream str = context.getDebugStream();

                    str.println("TRANSITION   : SchMatchStateMap.Start.DoStart()");
                }


                (context.getState()).Exit(context);
                context.clearState();
                try
                {
                    ctxt.state2Busy();
                }
                finally
                {
                    context.setState(SchMatchStateMap.Busy);
                    (context.getState()).Entry(context);
                }
                return;
            }

        //-------------------------------------------------------
        // Member data.
        //
        }

        private static final class SchMatchStateMap_Busy
            extends SchMatchStateMap_Default
        {
        //-------------------------------------------------------
        // Member methods.
        //

            private SchMatchStateMap_Busy(String name, int id)
            {
                super (name, id);
            }

            protected void DoBusy(SchMatchStateContext context)
            {
                SchMatchState ctxt = context.getOwner();

                if (context.getDebugFlag() == true)
                {
                    PrintStream str = context.getDebugStream();

                    str.println("TRANSITION   : SchMatchStateMap.Busy.DoBusy()");
                }

                if (ctxt.isSpecialState() == true)
                {

                    (context.getState()).Exit(context);
                    context.clearState();
                    try
                    {
                        ctxt.idleProcess();
                    }
                    finally
                    {
                        context.setState(SchMatchStateMap.Idle);
                        (context.getState()).Entry(context);
                    }
                }
                else if (ctxt.isSpecialState() == false)
                {

                    (context.getState()).Exit(context);
                    context.clearState();
                    try
                    {
                        ctxt.stopProcess();
                    }
                    finally
                    {
                        context.setState(SchMatchStateMap.Stop);
                        (context.getState()).Entry(context);
                    }
                }                else
                {
                    super.DoBusy(context);
                }

                return;
            }

        //-------------------------------------------------------
        // Member data.
        //
        }

        private static final class SchMatchStateMap_Idle
            extends SchMatchStateMap_Default
        {
        //-------------------------------------------------------
        // Member methods.
        //

            private SchMatchStateMap_Idle(String name, int id)
            {
                super (name, id);
            }

            protected void DoIdle(SchMatchStateContext context)
            {
                SchMatchState ctxt = context.getOwner();

                if (context.getDebugFlag() == true)
                {
                    PrintStream str = context.getDebugStream();

                    str.println("TRANSITION   : SchMatchStateMap.Idle.DoIdle()");
                }

                SchMatchStateState endState = context.getState();

                context.clearState();
                try
                {
                    ctxt.release();
                }
                finally
                {
                    context.setState(endState);
                }
                return;
            }

        //-------------------------------------------------------
        // Member data.
        //
        }

        private static final class SchMatchStateMap_Stop
            extends SchMatchStateMap_Default
        {
        //-------------------------------------------------------
        // Member methods.
        //

            private SchMatchStateMap_Stop(String name, int id)
            {
                super (name, id);
            }

            protected void DoStop(SchMatchStateContext context)
            {
                SchMatchState ctxt = context.getOwner();

                if (context.getDebugFlag() == true)
                {
                    PrintStream str = context.getDebugStream();

                    str.println("TRANSITION   : SchMatchStateMap.Stop.DoStop()");
                }

                SchMatchStateState endState = context.getState();

                context.clearState();
                try
                {
                    ctxt.release();
                }
                finally
                {
                    context.setState(endState);
                }
                return;
            }

        //-------------------------------------------------------
        // Member data.
        //
        }

    //-----------------------------------------------------------
    // Member data.
    //
    }
}

/*
 * Local variables:
 *  buffer-read-only: t
 * End:
 */

四、工作流程图生成

  生成sm工作流程图,可以通过图形直观看到当前.sm文件定义的状态及转移过程情况。
详情链接:Graphviz - 生成smc 的.sm文件对应的工作流程图.

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值