Changes between Version 4 and Version 5 of WF/fabrica

Timestamp:

06/09/10 11:55:13 (14 years ago)

Author:

viani

Comment:

--

WF/fabrica

@@ -5 +5 @@
 '''Exemplo de uso'''
 
-Na camada Model de uma atividade:
+{{{
+  $obj_ldap = Factory::getInstance("wf_ldap");
+}}}
+
+Neste exemplo, será retornado um objeto da classe wf_ldap e atribuído para a variável $obj_ldap.
+
+Caso uma chamada semelhante já tenha sido feita anteriormente para a mesma classe, será retornado o mesmo objeto das chamadas anteriores (reaproveitamento), o que economiza tempo e memória do sistema.
+
+Caso o desenvolvedor queria um objeto totalmente novo da classe, deve mudar a chamada para:
 
 {{{
-  $obj_ldap = $this->factory->getInstance("wf_ldap");
+  $obj_ldap = Factory::newInstance("wf_ldap");
 }}}
 
-Se o acesso à factory for necessário na camada controller, o código ficaria assim:
+Ambas formas de utilização da factory podem ser usadas em qualquer parte do código do processo.
+
+== Importante ==
+
+Os exemplos anteriores demonstram a nova forma de utilizar a factory, que veio a substituir a forma antiga, exemplificada a seguir:
 
 {{{
- $obj_ldap = $this->model->factory->getInstance("wf_ldap");
+  Na camada Model de uma atividade:
+
+  $obj_ldap = $this->factory->getInstance("wf_ldap");
+
+  Na camada Controller de uma atividade:
+
+  $obj_ldap = $this->model->factory->getInstance("wf_ldap");
 }}}
+
+Deve-se providenciar a substituição das chamadas antigas pelo novo formato, o quanto antes, pois o mesmo está depreciado e será removido das versões futuras do módulo.
 
 == Função: wf_create_object ==
 
-Esta função está depreciada, e ainda é mantida no Workflow, para compatibilidade com processos antigos. Evite utilizá-la.
+Esta função também está depreciada, e será removida na versão 2.2 do módulo. Deve-se substituí-la o quanto antes, para evitar problemas futuros.
 
 '''Exemplo de uso:'''