Mercurial > pub > Impl

diff Lib/IMPL/DOM/Schema/ValidationError.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 76515373dac0
children 4d0e1962161c
line wrap: on
line diff
--- a/Lib/IMPL/DOM/Schema/ValidationError.pm	Tue Dec 20 23:00:30 2011 +0300
+++ b/Lib/IMPL/DOM/Schema/ValidationError.pm	Fri Dec 30 23:40:00 2011 +0300
@@ -48,16 +48,16 @@
 
 =head1 NAME
 
-C<IMPL::DOM::Schema::ValidationError> -    .
+C<IMPL::DOM::Schema::ValidationError> - Описывает ошибку в документе.
 
 =head1 DESCRIPTION
 
-         
-C<IMPL::DOM::Schema::ValidationError>,      
- .
+При проверке документа на ошибки формирования возвращается массив с объектами
+C<IMPL::DOM::Schema::ValidationError>, каждая из которых описывает одну ошибку
+в документе.
 
-       ,  
-     .
+С помощью данного объекта осущетсвляется привязка элемента схемы, элемента документа
+и сообщения о причине возникновения ошибки.
 
 =head1 MEMBERS
 
@@ -65,40 +65,40 @@
 =item C<[get] Node>
 
 
-      .      , 
-,         .
+Узел в документе который привел к ошибке. Как правило это либо простые узлы, либо
+узлы, которые не могут присутствоать в данном месте по схеме.
 
-    C<undef>. 
+Данное свойство может быть C<undef>. 
 
 =item C<[get] Parent>
 
-     .   ,  C<Node>
- , ,         
-,      .
+Родительский узел в котором произошла ошибка. Используется в случаях, когда C<Node>
+не указан, например, если по схеме должен существовать дочерний узел с определенным
+именем, а в реальном документе его нет.
 
-       .
+Также это свойство может использоваться при формировании сообщения.
 
 =item C<[get] Schema>
 
-  C<Node>       C<Node>  .
+Схема для C<Node> или узла который должен присутсвовать если C<Node> не задан.
 
 =item C<[get] Source>
 
-,      .   
- ,        ,  
-  .
+Схема, проверка которой привела к возникновению ошибки. Поскольку схемы могут
+использовать ссылки, то данное свойство нужно для получения схемы узла, а не
+схемы его типа.
 
-    C<IMPL::DOM::Schema::Node>    
-, , C<IMPL::DOM::Schema::ComplexType>,   C<Source> 
-   C<IMPL::DOM::Schema::Node>.
+Тоесть проверка схемы узла C<IMPL::DOM::Schema::Node> приводит к проверке схемы
+типа, например, C<IMPL::DOM::Schema::ComplexType>, а свойство C<Source> будет
+указывать именно на C<IMPL::DOM::Schema::Node>.
 
 =item C<[get] Message>
 
-    .
+Возвращает форматированное сообщение об ошибке.
 
 =item C<toString()>
 
-   ,    C<Message>
+Преобразует ошибку к строке, возвращает значение свойства C<Message>
 
 =back
 
@@ -113,7 +113,7 @@
 
 my $node = $doc->selectSingleNode('user','name');
 
-#       
+# Получаем все ошибки относящиеся к данному узлу
 my @nodeErrors = grep { ($_->Node || $_->Parent) == $node } @errors;  
 
 =end code