PureMVC AS3 标准框架启动与配置教程

1. 项目的目录结构及介绍

PureMVC AS3 标准框架的目录结构如下：

• src
  • main
    • as3
      • org
        • puremvc
          • patterns
            • command
            • controller
            • core
            • facade
            • mediator
            • proxy
          • interfaces
          • utils
  • test
  • examples

目录详细介绍：

• src: 源代码目录，包含所有的AS3源文件。
  • main: 主代码目录，包含了项目的核心代码。
    • as3: AS3代码目录，进一步细分为以下子目录：
      • org: 包含 PureMVC 框架的核心类和接口。
        • puremvc: 包含 PureMVC 模式（patterns）、接口（interfaces）、工具（utils）等。
          • patterns: 包含 PureMVC 设计模式相关的类，如命令（Command）、控制器（Controller）、中介（Mediator）、代理（Proxy）等。
          • interfaces: 包含 PureMVC 框架的接口定义。
          • utils: 包含 PureMVC 框架的工具类。
  • test: 测试代码目录，用于存放单元测试相关的代码。
  • examples: 示例代码目录，包含使用 PureMVC 框架的示例项目。

2. 项目的启动文件介绍

在 PureMVC AS3 标准框架中，启动文件通常是位于 src/main/as3 目录下的某个主类文件，例如 Main.as。

package
{
    import org.puremvc.as3.core.Controller;
    import org.puremvc.as3.core.Model;
    import org.puremvc.as3.core.View;
    import org.puremvc.as3.patterns.facade.Facade;

    public class Main extends Sprite
    {
        public function Main()
        {
            super();
            // 初始化Facade
            var facade:Facade =Facade.getInstance();
            facade.initializeController();
            facade.initializeModel();
            facade.initializeView();
            
            // 启动应用
            facade startup();
        }
    }
}

在上述启动文件中，我们创建了一个 Main 类，它继承自 Sprite 类，并在构造函数中初始化了 PureMVC 的核心组件：控制器（Controller）、模型（Model）和视图（View）。

3. 项目的配置文件介绍

PureMVC AS3 框架的配置通常是通过定义 Facade 的子类来实现的。在 Facade 子类中，你可以定义特定于应用的控制命令、模型代理和视图中介。

以下是一个简单的 Facade 子类示例，用于配置应用：

package
{
    import org.puremvc.as3.core.Facade;
    import org.puremvc.as3.patterns.command.SimpleCommand;
    import org.puremvc.as3.patterns.mediator.Mediator;
    import org.puremvc.as3.patterns.proxy.Proxy;

    public class MyFacade extends Facade
    {
        public static const NAME:String = "MyFacade";

        public static function getInstance():MyFacade
        {
            if ( instance == null ) instance = new MyFacade( NAME );
            return instance as MyFacade;
        }

        override protected function initializeController():void
        {
            super.initializeController();
            // 注册控制命令
            registerCommand( CommandNames.COMMAND_NAME, MyCommand );
        }

        override protected function initializeModel():void
        {
            super.initializeModel();
            // 注册模型代理
            registerProxy( new MyProxy() );
        }

        override protected function initializeView():void
        {
            super.initializeView();
            // 注册视图中介
            registerMediator( new MyMediator() );
        }

        // 其他自定义方法
    }
}

在这个配置文件中，我们扩展了 Facade 类并覆盖了 initializeController、initializeModel 和 initializeView 方法，以注册特定的命令、代理和中介。这样，当应用启动时，就可以通过 Facade 实例来访问这些已注册的组件。