Mercurial > pub > Impl

diff Lib/IMPL/Object/Factory.pm @ 180:d1676be8afcc

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Перекодировка в utf-8
author sourcer
date Fri, 30 Dec 2011 23:40:00 +0300
parents 4267a2ac3d46
children 47dac58691ee
line wrap: on
line diff
--- a/Lib/IMPL/Object/Factory.pm	Tue Dec 20 23:00:30 2011 +0300
+++ b/Lib/IMPL/Object/Factory.pm	Fri Dec 30 23:40:00 2011 +0300
@@ -95,7 +95,7 @@
 
 =end code
 
-    XML.
+Или сериализованная форма в XML.
 
 =begin code xml
 
@@ -112,17 +112,17 @@
 
 C<[Serializable]>
 
-,   .
+Класс, реализующий фабрику классов.
 
-    ,    C< new >      
-.      , ,     
-C< new >,    .  ,     Perl, 
- ,  ,   .
+Фабрика классов это любой объект, который имеет метод C< new > вызов которого приводит к созданию нового
+объекта. Например каждый класс сам явялется фабрикой, поскольку, если у него вызвать метод
+C< new >, то будет создан объект. Полученные объекты, в силу механизмов языка Perl, также
+являются фабриками, притом такимиже, что и класс.
 
-     C< new >     : 
-   .    C< new >     
-   .  -     
-     .
+Данный класс меняет поведение метода C< new > в зависимости от контекста вызова: статического
+метода или метода объекта. При вызове метода C< new > у класса происходит создание объекта
+фабрики с определенными параметрами. Далее объект-фабрика может быть использована для создания
+объектов уже на основе параметров фабрики.
 
 =head1 MEMBERS
 
@@ -130,49 +130,49 @@
 
 =item C< CTOR($factory,$parameters,$method) >
 
-   .
+Создает новый экземпляр фабрики.
 
 =over
 
 =item C<$factory>
 
-  ,   .
+Либо имя класса, либо другая фабрика.
 
 =item C<$parameters>
 
-     ,     ,   ..
+Ссылка на параметры для создания объектов, может быть ссылкой на хеш, массив и т.д.
 
-    ,        
-        C<new>.
+Если является ссылкой на хеш, то при создании объектов данной фабрикой этот хеш
+будет развернут в список и передан параметрами методу C<new>.
 
-    ,        
-        C<new>.
+Если является ссылкой на массив, то при создании объектов данной фабрикой этот массив
+будет передан в списк и передан параметрами методу C<new>.
 
-      ,     
-C<new>  .
+Если является любым другим объектом или скаляром, то будет передан параметром методу
+C<new> как есть.
 
 =item C<$method>
 
-  (   ),     C<$factory>  
-   .
+Имя метода (или ссылка на процедуру), который будет вызван у C<$factory> при создании
+текущей фабрикой нового объекта.
 
 =back
 
 =item C< [get] factory >
 
-,        .    
- .
+Свойство, содержащее фабрику для создание новых объектов текущей фабрикой. Чаще всего оно содержит
+имя класса.
 
 =item C< [get] parameters >
 
-,       ,      
-      C< new >    C< factory >,   
-    .
+Свойство, содержит ссылку на параметры для создания объектов, при создании объекта эти параметры будут
+развернуты в список и переданы оператору C< new > фабрике из свойства C< factory >, за ними будут
+следовать параметры непосредственно текущей фабрики.
 
 =item C<new(@params)>
 
-  ,   C<factory>      
-  C<parameters>   C<@params>.    ,   .
+Создает новый объект, используя свйство C<factory> как фабрику и передавая туда параметры
+из свойства C<parameters> и списка C<@params>. Ниже приведен упрощенный пример, как это происходит.
 
 =begin code
 
@@ -188,4 +188,4 @@
 
 =back
 
-=cut
\ No newline at end of file
+=cut