Mercurial > pub > Impl
diff Lib/IMPL/DOM/Navigator/Builder.pm @ 64:259cd3df6e53
Doc generation
Minor fixes
author | wizard |
---|---|
date | Mon, 15 Mar 2010 17:45:13 +0300 |
parents | 16ada169ca75 |
children | cf3b6ef2be22 |
line wrap: on
line diff
--- a/Lib/IMPL/DOM/Navigator/Builder.pm Mon Mar 15 02:38:09 2010 +0300 +++ b/Lib/IMPL/DOM/Navigator/Builder.pm Mon Mar 15 17:45:13 2010 +0300 @@ -56,10 +56,17 @@ 1; __END__ + =pod +=head1 NAME + +C< IMPL::DOM::Navigator::Builder > - Навигатор, строящий документ по указанной схеме. + =head1 SYNOPSIS +=begin code + my $builder = new IMPL::DOM::Navigator::Builder(new MyApp::Document,$schema); my $reader = new IMPL::DOM::XMLReader(Navigator => $builder); @@ -67,6 +74,8 @@ my @errors = $schema->Validate($builder->Document); +=end code + =head1 DESCRIPTION Построитель DOM документов по указанной схеме. Обычно используется в связке @@ -76,21 +85,27 @@ =over -=item C<CTOR($domDocument,$schema)> +=item C< CTOR($classDocument,$schema) > -Создает новый объект, принимает на вход пустой (но не обязательно) документ и -схему. +Создает новый объект, принимает на вход класс документа (или фабрику, например +L<IMPL::Object::Factory>) и схему. В процессе процедуры построения документа +будет создан объект документа. -=item C<< $obj->NavigateCreate($nodeName) >> +=item C< NavigateCreate($nodeName,\%props) > Создает новый узел с указанным именем и переходит в него. В случае если в схеме подходящий узел не найден, то вызывается исключение. При этом по имени узла ищется его схема, после чего определяется класс для -создания экземпляра и созданный узел доавляется в документ. +создания экземпляра и созданный узел доавляется в документ. При создании +нового узла используется метод документа C<< IMPL::DOM::Document->Create >> -Также имя создаваемого узла НЕ может быть переопределено свойством nodeName, оно -будет проигнорировано. +Свойства узла передаются при создании через параметр C<props>, но имя создаваемого +узла НЕ может быть переопределено свойством C<nodeName>, оно будет проигнорировано. + +=item C< Document > + +Свойство, которое содержит документ по окончании процедурв построения. =back