Mercurial > pub > Impl

diff Lib/IMPL/Config.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 b3d91ff7aea9
children 4d0e1962161c
line wrap: on
line diff
--- a/Lib/IMPL/Config.pm	Tue Dec 20 23:00:30 2011 +0300
+++ b/Lib/IMPL/Config.pm	Fri Dec 30 23:40:00 2011 +0300
@@ -127,7 +127,7 @@
 
 =head1 NAME
 
-C<IMPL::Config> -     .
+C<IMPL::Config> - базовый класс для настраиваемого приложения.
 
 =head1 SYNOPSIS
 
@@ -168,7 +168,7 @@
 
 =end code
 
-    C<default.xml>   
+Ниже приведен пример файла C<default.xml> содержащего настройки приложения
 
 =begin code xml
 
@@ -193,27 +193,27 @@
 
 C<use parent IMPL::Object::Accessor>
 
-   .  ,  
- ,     ,
-  - .
+Базовый класс для приложений. Использует подход, что приложение
+является объектом, состояние которого предтавляет собой конфигурацию,
+а методы - логику.
 
-     ( ) 
-  XML .     C<IMPL::Serialization>.
-    C<IMPL::Serialization::XmlFormatter> C<IdentOutput> 
-C<SkipWhitespace>       .
+Данный класс реализует функционал десериализации (и сериализации) экземпляра
+приложения из XML документа. Для этого используется механизм C<IMPL::Serialization>.
+При этом используются опции C<IMPL::Serialization::XmlFormatter> C<IdentOutput> и
+C<SkipWhitespace> для записи документа в легко читаемом виде.
 
-       
-  ,       
- ,     . ,   
-      ,   .
+Поскольку в результате восстановления приложения восстанавливаются все элементы
+из файла конфигурации, то это может потребовать значительных ресурсов для
+создания частей, которые могут никогда не понадобиться. Например, не требуется инициализация
+источника данных для передачи пользователю статических данных, сохраненных на диске.
 
-       C<IMPL::Config::Activator>.
+Для решения этой проблемы используются специальные объекты C<IMPL::Config::Activator>.
 
-    ,    C<IMPL::Config::Activator>, 
-     ,     
-C<< IMPL::Config::Activator->activate() >>      .
-      ,  
- . 
+Если у приложения описано свойство, в котором хранится C<IMPL::Config::Activator>, то
+при первом обращении к такому свойству, будет создан объект вызовом метода
+C<< IMPL::Config::Activator->activate() >> и возвращен как значение этого свойства.
+Таким образом реализуется прозрачная отложенная активация объектов, что позволяет
+экономить ресурсы. 
 
 =head1 MEMBERS
 
@@ -221,24 +221,24 @@
 
 =item C<[static] LoadXMLFile($fileName) >
 
-  XML  C<$fileName>  
+Создает из XML файла C<$fileName> экземпляр приложения
 
 =item C<SaveXMLFile($fileName)>
 
-    C<$fileName>
+Сохраняет приложение в файл C<$fileName>
 
 =item C<[get] xml >
 
-    XML .
+Сохраняет конфигурацию приложения в XML строку.
 
 =item C<[static,operator] spawn($file)>
 
-  C<LoadXMLFile>,    .
+Синоним для C<LoadXMLFile>, предполагается использование как оператора.
 
 =item C<rawGet($propname,...)>
 
-     .    
-    C<IMPL::Config::Activator>.
+Метод для получения значений свойств приложения. Данный метод позволяет избежать
+использование активации объектов через C<IMPL::Config::Activator>.
 
 =back