Essa é a terceira e última parte da série de artigos sobre a refatoração do ModelLocator do Cairngorm.

Muito obrigado pelo pessoal que veio acompanhando, se interessando e mandando e-mail para discutir suas soluções de implementação.

Como visto no post anterior, vamos hoje liberar o código-fonte completo da refatoração para que vocês possam entender melhor tudo que foi feito e dito, como os padrões de projeto apresentados foram aplicados e principalmente, começar a implementar suas próprias soluções em seus projetos que utilizam o framework Cairngorm.

Você pode encontrar os posts anteriores nos links abaixo:

Refatorando o ModelLocator do Cairngorm – Parte I
Refatorando o ModelLocator do Cairngorm – Parte II

Primeiramente vamos ver como ficou o ModelLocator da aplicação. Atente a como o Domain Model esta sendo inicializado e sua referência injetada no Presentation Model da view principal da aplicação:

public static function getInstance():ModelLocator
{
if( instance==null)
{
instance = new ModelLocator();

/**
* O Domain Model e o Presentation Model principal
* são instanciados no momento que nosso ModelLocator
* também é instanciado
*/
instance.agendaModel = new AgendaModel();
instance.mainPM = new MainPM(instance.agendaModel);
}
return instance;
}

Construtor do nosso Domain Model (AgendaModel.as), inicializando nossos Presentation Models:

/**
*
* @param pAgendaModel – Domain Model da aplicação
* @return
*
*/
public function MainPM(pAgendaModel:AgendaModel)
{
// Recebe instância do Domain Model da aplicação
agendaModel = pAgendaModel;

// Inicializa Presentation Models
contactListPM = new ContactListPM(agendaModel);
contactDetailsPM = new ContactDetailsPM(agendaModel);
}

A view principal da aplicação (AgendaProject.mxml) recupera a instância do ModelLocator:

/**
* Recuperando a instância do ModelLocator.
* Repare como a DI é usada, com a injeção dos
* Presentations Models em suas respectivas views.
*/
[Bindable]
public var appModel:ModelLocator = ModelLocator.getInstance();

Em seguida injeta os Presentation Models nas suas views internas:

Repare que o ModelLocator está sendo usado para recuperarmos os modelos da aplicação e não como nosso modelo em si.

Agora vamos ver como nossa aplicação esta acessando nosso modelo para fazer, por exemplo, uma remoção de um contato da agenda:

/**
* Remove contato através da chama ao método deleteContact(),
* que está presente no Presentation Model da view.
*/
private function deleteConfirmationAnswer(pEvt:CloseEvent):void
{
if(pEvt.detail == Alert.YES)
{
contactDetailsPM.deleteContact();
clearContact();
}
}

Não estamos removendo um item de uma coleção definida no ModelLocator (como estamos acostumados a ver no geral), na realidade não precisamos do ModelLocator daqui pra frente, uma vez que nosso modelo já foi recuperado ao inicializarmos a aplicação, tudo que precisamos com relação ao modelo está agora presente nos Presentation Models e no Domain Model da aplicação.

A chamada do método de remoção de contato visto acima, resulta no disparo de um evento que por fim vai realizar a seguinte operação:

public function execute(event:CairngormEvent):void
{
var contactEvt:ContactEvent = event as ContactEvent;
agendaModel.removeContact(contactEvt.contact);
}

O método que remove o contato, está presente em nosso Domain Model (AgendaModel.as), conforme abaixo:

/**
*
* @param pContact – Contato a ser removido da coleção
*
*/
public function removeContact(pContact:Contact):void
{
var i:int = contactsCollection.getItemIndex(pContact);
contactsCollection.removeItemAt(i);
}

Abaixo, temos o datagrid da view “AgendaList.mxml”, que lista nossos contatos. Repare no dataprovider. Normalmente temos nesse momento uma dependência direta com o ModelLocator, mas na nossa implementação temos uma dependência com o modelo da view. Faz sentido agora !?!? rs

A aplicação de exemplo é extramamente simples, não teve nenhuma preocupação com suas funcionalidades, mas buscou demonstrar de forma objetiva e direta como implementar os padrões Presentation Model e Domain Model juntamente com o ModelLocator do Cairngorm.
Espero ter contribuido para que vocês possam buscar suas próprias soluções de implementação e que com isso possam alcançar um código mais maduro em suas aplicações.

Como prometido, o download do source pode ser feito aqui.

Fico à disposição para discussões, dúvidas e opniões.

Até a próxima pessoal!