Développement d'un gestionnaire de contacts (CManager) avec ActionScript Foundry (AS Foundry) - Partie 1

${JAVA_HOME} = C:\Program Files\Java\jdk1.5.0_17

Path= ... ;%JAVA_HOME%\bin

${CATALINA_HOME} = C:\Foundry\apache-tomcat-6.0.16

Path= ... ;%CATALINA_HOME%\bin

outputFolderLocation="/C:/Foundry/apache-tomcat-6.0.16/webapps/contactApplication/flex-gui-debug"

serverRoot="C:\Foundry\apache-tomcat-6.0.16\webapps\contactApplication"

<location>/C:/Foundry/apache-tomcat-6.0.16/webapps/contactApplication/flex-gui-debug</location>

//model/ContactModel.as
...
public class ContactModel extends AbstractModel
{
    public function ContactModel()
    {
        super();
    }
}

//model/ContactModel.as
...
private var _contacts : ArrayCollection;
...
public function getContacts(): ArrayCollection
{
    _contacts.source.sortOn("lastName");
    return _contacts;
}
public function setContacts( ar : ArrayCollection ): void
{
    _contacts = ar;
    // Notification des observateurs éventuels
    notifyObservers( new ContactListNotification( null ) );
}
...

//control/MainController.as
...
public class MainController extends AbstractController
{
    private static var _mainControllerInstance : MainController;
    ...
    /**
    * MainController Singleton
    * */
    public static function getInstance() : MainController
    {
        if(_mainControllerInstance == null)
        {
            _mainControllerInstance = new MainController();
        }
        return _mainControllerInstance;
    }
    ...
    /**
    * Initialisation des Modèles
    * */
    override public function initializeModels():void
    {
        ModelLocator.getInstance().registerModel( getQualifiedClassName(ContactModel), new ContactModel() );
    }
    ...
    /**
    * Initialisation des services distants
    * */
    override public function initializeDelegates():void
    {
        //Initialisation des services distants
    }
    ...

//control/MainApplication.as
...
package org.servebox.sample.contactapplication.control
{
    import org.servebox.foundry.control.AbstractApplication;
    public class MainApplication extends AbstractApplication
    {
        public function MainApplication()
        {
            super();
        }
        override protected function getControllerClass():Class
        {
            return MainController;
        }
    }
}

<?xml version="1.0" encoding="utf-8"?>
<control:MainApplication
    xmlns:mx="http://www.adobe.com/2006/mxml"
    xmlns:control="org.servebox.sample.contactapplication.control.*"
    xmlns:view="org.servebox.sample.contactapplication.view.*"
    >
    <mx:Style source="/../resources/css/main.css"/>
</control:MainApplication>

//helper/MainViewHelper.as
package org.servebox.sample.contactapplication.helper
{
import org.servebox.sample.contactapplication.model.ContactModel;
import flash.events.Event;
import flash.utils.getQualifiedClassName;
import org.servebox.foundry.model.ModelLocator;
import org.servebox.foundry.observation.IObservable;
import org.servebox.foundry.observation.Notification;
import org.servebox.foundry.view.ViewHelper;
import org.servebox.sample.contactapplication.control.MainController;
import org.servebox.sample.contactapplication.model.notification.ContactListNotification;
import org.servebox.sample.contactapplication.service.value.vo.ContactVO;
import org.servebox.sample.contactapplication.view.MainView;
public class MainViewHelper extends ViewHelper
{
...
    /**
    * S'enregistre comme un observateur auprès de ContactModel
    * et permet de recevoir les notifications depuis ContactModel
    * */
    override public function registerToModels():void
    {
        var model : IObservable = ModelLocator.getInstance().getModel(getQualifiedClassName( ContactModel ));
        model.registerObserver(this);
    }
    /**
    * Déclenché après une notification de ContactModel
    * */
    override public function update( o:IObservable, n:Notification) :void
    {
        // réalise une action après avoir reçu une notification depuis ContactModel
        dispatchEvent( new Event("contactListChange") );
    }
}
...

<?xml version="1.0" encoding="utf-8"?>
<!-- view/MainView.mxml -->
<view:HBoxView
    xmlns:view="org.servebox.foundry.view.*"
    xmlns:mx="http://www.adobe.com/2006/mxml"
    width="100%"
    height="100%"
    horizontalAlign="center"
    horizontalCenter="0">
    <!-- association de la vue avec MainViewHelper.as -->
    <helper:MainViewHelper id="helper" autoRegisterBasedOnQualifiedClassName="true"/>
...
</view:HBoxView>

<?xml version="1.0" encoding="utf-8"?>
<control:MainApplication
    xmlns:mx="http://www.adobe.com/2006/mxml"
    xmlns:control="org.servebox.sample.contactapplication.control.*"
    xmlns:view="org.servebox.sample.contactapplication.view.*"
    >
    <mx:Style source="/../resources/css/main.css"/>
    <mx:ViewStack id="myViewStack" width="1024" height="720">
        <view:MainView id="mainView"/>
    </mx:ViewStack>
</control:MainApplication>

//business/responder/ContactListResponder.as
...
public class ContactListResponder implements IBusinessResponder
{
    public function ContactListResponder()
    {}
    public function result(data:Object):void
    {
        // Ici on gère la réponse du service distant
    }
    public function fault(info:Object):void
    {
        Alert.show("Error getting contact list !");
    }
}

//business/MainBusinessDelegate.as
...
public class MainBusinessDelegate extends AbstractBusinessDelegate implements IBusinessDelegate
{
    public function MainBusinessDelegate( service : Object=null )
    {
        super(service);
    }
    /**
    * Appel la requete getContactList() du service Java
    * */
    public function getContactList( responder : ContactListResponder ) : void
    {
        linkResponderToCallToken( getService().getContactList(), responder );
    }
...

//control/MainController.as
...
/**
* Récupère le service Java
* */
private function get service() : RemoteObject
{
    var service : RemoteObject = new RemoteObject("java-service");
    service.channelSet = ChannelSetProvider.getInstance().getDefaultChannelSet();
    return service;
}
/**
* Initialisation du service distant
* */
override public function initializeDelegates():void
{
    var bd : MainBusinessDelegate = new MainBusinessDelegate( service );
    registerBusinessDelegate( bd, getQualifiedClassName( MainBusinessDelegate ) );
}
/**
* Appel à la fonction getContactList du MainBusinessDelegate
* */
public function getContactList() : void
{
    getMainBusinessDelegate().getContactList( new ContactListResponder() );
}
...

//helper/MainViewHelper.as
...
    /**
    * Appel la méthide getContactList dans MainController
    * */
    public function retrieveContactList() : void
    {
        MainController.getInstance().getContactList();
    }
...

//helper/MainViewHelper.as
...
    /**
    * Renvoie un tableau des contacts stockés dans le model
    * */
    [Bindable("contactListChange")]
    public function get getContactList() : Array
    {
        return getContactModel().getContacts().source;
    }
    /**
    * Accesseur de ContactModel
    * */
    public function getContactModel() : ContactModel
    {
        return ContactModel(ModelLocator.getInstance().getModel(getQualifiedClassName( ContactModel )));
    }
...

//view/MainView.mxml
...
    <HBoxView
        xmlns="org.servebox.foundry.view.*"
        xmlns:mx="http://www.adobe.com/2006/mxml"
        xmlns:comp="org.servebox.sample.contactapplication.component.*"
        width="{MainConf.SCENE_WIDTH}" height="{MainConf.SCENE_HEIGHT}"
        xmlns:form="org.servebox.toolbox.form.*"
        xmlns:elements="org.servebox.toolbox.form.elements.*"
        xmlns:helper="org.servebox.sample.contactapplication.helper.*"
        horizontalAlign="center"
        horizontalCenter="0"
        horizontalScrollPolicy="off"
        verticalScrollPolicy="off"
    >
...
    <mx:Button
        id="getBtn"
        icon="{EmbeddedMedia.getInstance().updateContactImg}"
        click="{helper.retrieveContactList()}"
    />
...
    <mx:List
        width="300"
        height="648"
        id="contactList"
        dataProvider="{helper.getContactList}" 
    />
...

//service/value/transfer/ContactTO.as
package org.servebox.sample.contactapplication.service.value.transfer
{
    import mx.collections.ArrayCollection;
    import org.servebox.foundry.transfer.TransferObject;
    [Bindable]
    [RemoteClass(alias="org.servebox.sample.contactapplication.service.value.transfer.ContactTO")]
    public class ContactTO extends TransferObject 
    {
        private var _contacts : ArrayCollection;
        public function set contacts( value : ArrayCollection ) :void
        {
            _contacts= value;
        }
        public function get contacts() : ArrayCollection
        {
            return _contacts;
        }
    }
}
...

//service/value/vo/ContactVO.as
package org.servebox.sample.contactapplication.service.value.vo
{
    import org.servebox.foundry.value.AbstractValueObject;
    [Bindable]
    [RemoteClass(alias="org.servebox.sample.contactapplication.service.value.vo.ContactVO")]
    public class ContactVO extends AbstractValueObject implements IContactVO 
    {
        private var _firstName : String;
        private var _lastName : String;
...

//business/responder/ContactListResponder.as
...
public function result(data:Object):void
{
    var contactTO : ContactTO = ResultEvent( data ).result as ContactTO;
    MainController.getInstance().getContactModel().setContacts( contactTO.contacts );
}
...

//helper/MainViewHelper.as
...
/**
* Au déclenchement de l'événement "selectedContactChange",
* récupère l'item sélectionné en tant que ContactVO
* */
[Bindable("selectedContactChange")]
public function get selectedContact():ContactVO
{
    return ContactVO( getCurrentView().contactList.selectedItem );
}
...

//view/MainView.as
...
<mx:List
    styleName="listBox"
    width="300"
    height="648"
    id="contactList"
    rowHeight="{Math.floor( contactList.height / 9 )}"
    dataProvider="{helper.getContactList}"
    itemRenderer="{new ClassFactory( ContactRenderer )}"
    change="helper.dispatchEvent(new Event('selectedContactChange'))">
...

//view/MainView.as
...
<form:SmartForm
    id="leftSmartForm"
    styleName="form"
    width="50%"
    source="{helper.selectedContact}">
...
<form:SmartForm
    id="rightSmartForm"
    styleName="form"
    width="50%"
    source="{helper.selectedContact}">
...
<form:SmartForm
    id="bottomSmartForm"
    styleName="form"
    width="50%"
    source="{helper.selectedContact}">
...