annotate Lib/IMPL/Config.pm @ 394:2c14f66efa08

minor changes
author cin
date Tue, 18 Feb 2014 18:17:20 +0400
parents 4ddb27ff4a0b
children 212cc86e470b
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
49
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
1 package IMPL::Config;
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
2 use strict;
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
3 use warnings;
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
4
278
4ddb27ff4a0b core refactoring
cin
parents: 263
diff changeset
5 use IMPL::Const qw(:access);
263
0f59b2de72af *fixed IMPL::DOM::Schema circular module references
sergey
parents: 205
diff changeset
6 use IMPL::declare {
0f59b2de72af *fixed IMPL::DOM::Schema circular module references
sergey
parents: 205
diff changeset
7 base => [
0f59b2de72af *fixed IMPL::DOM::Schema circular module references
sergey
parents: 205
diff changeset
8 'IMPL::Object::Accessor' => undef,
0f59b2de72af *fixed IMPL::DOM::Schema circular module references
sergey
parents: 205
diff changeset
9 'IMPL::Object::Serializable' => undef,
0f59b2de72af *fixed IMPL::DOM::Schema circular module references
sergey
parents: 205
diff changeset
10 'IMPL::Object::Autofill' => '@_'
0f59b2de72af *fixed IMPL::DOM::Schema circular module references
sergey
parents: 205
diff changeset
11 ]
0f59b2de72af *fixed IMPL::DOM::Schema circular module references
sergey
parents: 205
diff changeset
12 };
49
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
13
170
b88b7fe60aa3 refactoring
sourcer
parents: 165
diff changeset
14 use File::Spec();
b88b7fe60aa3 refactoring
sourcer
parents: 165
diff changeset
15
49
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
16 use IMPL::Class::Member;
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
17 use IMPL::Class::PropertyInfo;
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
18 use IMPL::Exception;
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
19
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
20 use IMPL::Serialization;
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
21 use IMPL::Serialization::XmlFormatter;
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
22
170
b88b7fe60aa3 refactoring
sourcer
parents: 165
diff changeset
23 our $ConfigBase ||= '';
204
d63f9a92d6d4 +IMPL::Config::Include - simple way to include external config
sergey
parents: 194
diff changeset
24 our $AppBase;
60
b0c068da93ac Lazy activation for the configuration objects (final concept)
wizard
parents: 58
diff changeset
25
49
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
26 sub LoadXMLFile {
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
27 my ($self,$file) = @_;
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
28
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
29 my $class = ref $self || $self;
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
30
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
31 my $serializer = new IMPL::Serializer(
278
4ddb27ff4a0b core refactoring
cin
parents: 263
diff changeset
32 formatter => new IMPL::Serialization::XmlFormatter(
49
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
33 IdentOutput => 1,
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
34 SkipWhitespace => 1
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
35 )
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
36 );
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
37
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
38 open my $hFile,'<',$file or die new IMPL::Exception("Failed to open file",$file,$!);
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
39
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
40 my $obj;
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
41 eval {
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
42 $obj = $serializer->Deserialize($hFile);
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
43 };
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
44
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
45 if ($@) {
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
46 my $e=$@;
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
47 die new IMPL::Exception("Can't load the configuration file",$file,$e);
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
48 }
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
49 return $obj;
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
50 }
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
51
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
52 sub SaveXMLFile {
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
53 my ($this,$file) = @_;
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
54
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
55 my $serializer = new IMPL::Serializer(
278
4ddb27ff4a0b core refactoring
cin
parents: 263
diff changeset
56 formatter => new IMPL::Serialization::XmlFormatter(
49
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
57 IdentOutput => 1,
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
58 SkipWhitespace => 1
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
59 )
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
60 );
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
61
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
62 open my $hFile,'>',$file or die new IMPL::Exception("Failed to open file",$file,$!);
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
63
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
64 $serializer->Serialize($hFile, $this);
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
65 }
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
66
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
67 sub xml {
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
68 my $this = shift;
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
69 my $serializer = new IMPL::Serializer(
278
4ddb27ff4a0b core refactoring
cin
parents: 263
diff changeset
70 formatter => new IMPL::Serialization::XmlFormatter(
49
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
71 IdentOutput => 1,
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
72 SkipWhitespace => 1
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
73 )
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
74 );
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
75 my $str = '';
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
76 open my $hFile,'>',\$str or die new IMPL::Exception("Failed to open stream",$!);
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
77
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
78 $serializer->Serialize($hFile, $this);
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
79
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
80 undef $hFile;
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
81
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
82 return $str;
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
83 }
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
84
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
85 sub save {
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
86 my ($this,$ctx) = @_;
63
76b878ad6596 Added serialization support for the IMPL::Object::List
wizard
parents: 60
diff changeset
87
76b878ad6596 Added serialization support for the IMPL::Object::List
wizard
parents: 60
diff changeset
88 my $val;
49
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
89
63
76b878ad6596 Added serialization support for the IMPL::Object::List
wizard
parents: 60
diff changeset
90 $val = $this->rawGet($_) and $ctx->AddVar($_ => $val) foreach map $_->Name, $this->get_meta(
194
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
91 'IMPL::Class::PropertyInfo',
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
92 sub {
278
4ddb27ff4a0b core refactoring
cin
parents: 263
diff changeset
93 $_->access == ACCESS_PUBLIC and
4ddb27ff4a0b core refactoring
cin
parents: 263
diff changeset
94 $_->setter;
194
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
95 },
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
96 1);
49
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
97 }
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
98
58
a35b60b16a99 Configuration, late activation
wizard
parents: 49
diff changeset
99 sub spawn {
194
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
100 my ($this,$file) = @_;
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
101 unless ($file) {
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
102 ($file = ref $this || $this) =~ s/:+/./g;
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
103 $file .= ".xml";
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
104 }
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
105 return $this->LoadXMLFile( File::Spec->catfile($ConfigBase,$file) );
58
a35b60b16a99 Configuration, late activation
wizard
parents: 49
diff changeset
106 }
a35b60b16a99 Configuration, late activation
wizard
parents: 49
diff changeset
107
60
b0c068da93ac Lazy activation for the configuration objects (final concept)
wizard
parents: 58
diff changeset
108 sub get {
194
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
109 my $this = shift;
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
110
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
111 if (@_ == 1) {
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
112 my $obj = $this->SUPER::get(@_);
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
113 return UNIVERSAL::isa($obj,'IMPL::Config::Activator') ? $obj->activate : $obj;
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
114 } else {
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
115 my @objs = $this->SUPER::get(@_);
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
116 return map UNIVERSAL::isa($_,'IMPL::Config::Activator') ? $_->activate : $_, @objs ;
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
117 }
60
b0c068da93ac Lazy activation for the configuration objects (final concept)
wizard
parents: 58
diff changeset
118 }
b0c068da93ac Lazy activation for the configuration objects (final concept)
wizard
parents: 58
diff changeset
119
b0c068da93ac Lazy activation for the configuration objects (final concept)
wizard
parents: 58
diff changeset
120 sub rawGet {
194
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
121 my $this = shift;
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
122 return $this->SUPER::get(@_);
60
b0c068da93ac Lazy activation for the configuration objects (final concept)
wizard
parents: 58
diff changeset
123 }
b0c068da93ac Lazy activation for the configuration objects (final concept)
wizard
parents: 58
diff changeset
124
b0c068da93ac Lazy activation for the configuration objects (final concept)
wizard
parents: 58
diff changeset
125 sub Exists {
194
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
126 $_[0]->SUPER::get($_[1]) ? 1 : 0;
60
b0c068da93ac Lazy activation for the configuration objects (final concept)
wizard
parents: 58
diff changeset
127 }
b0c068da93ac Lazy activation for the configuration objects (final concept)
wizard
parents: 58
diff changeset
128
204
d63f9a92d6d4 +IMPL::Config::Include - simple way to include external config
sergey
parents: 194
diff changeset
129 sub AppBase {
205
891c04080658 IMPL::Web::View fixed template selection, release candidate
sergey
parents: 204
diff changeset
130 shift;
891c04080658 IMPL::Web::View fixed template selection, release candidate
sergey
parents: 204
diff changeset
131 File::Spec->catdir($AppBase,@_);
204
d63f9a92d6d4 +IMPL::Config::Include - simple way to include external config
sergey
parents: 194
diff changeset
132 }
d63f9a92d6d4 +IMPL::Config::Include - simple way to include external config
sergey
parents: 194
diff changeset
133
d63f9a92d6d4 +IMPL::Config::Include - simple way to include external config
sergey
parents: 194
diff changeset
134 sub ConfigBase {
205
891c04080658 IMPL::Web::View fixed template selection, release candidate
sergey
parents: 204
diff changeset
135 shift;
891c04080658 IMPL::Web::View fixed template selection, release candidate
sergey
parents: 204
diff changeset
136 File::Spec->catdir($ConfigBase,@_);
204
d63f9a92d6d4 +IMPL::Config::Include - simple way to include external config
sergey
parents: 194
diff changeset
137 }
d63f9a92d6d4 +IMPL::Config::Include - simple way to include external config
sergey
parents: 194
diff changeset
138
49
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
139 1;
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
140 __END__
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
141
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
142 =pod
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
143
73
wizard
parents: 63
diff changeset
144 =head1 NAME
wizard
parents: 63
diff changeset
145
180
d1676be8afcc Перекодировка в utf-8
sourcer
parents: 179
diff changeset
146 C<IMPL::Config> - базовый класс для настраиваемого приложения.
73
wizard
parents: 63
diff changeset
147
wizard
parents: 63
diff changeset
148 =head1 SYNOPSIS
49
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
149
73
wizard
parents: 63
diff changeset
150 =begin code
wizard
parents: 63
diff changeset
151
wizard
parents: 63
diff changeset
152 # define application
wizard
parents: 63
diff changeset
153
wizard
parents: 63
diff changeset
154 package MyApp;
165
76515373dac0 Added Class::Template,
wizard
parents: 73
diff changeset
155 use parent qw(IMPL::Config);
49
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
156
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
157 use IMPL::Class::Property;
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
158 use IMPL::Config::Class;
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
159
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
160 BEGIN {
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
161 public property SimpleString => prop_all;
60
b0c068da93ac Lazy activation for the configuration objects (final concept)
wizard
parents: 58
diff changeset
162 public property DataSource => prop_all;
49
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
163 }
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
164
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
165 sub CTOR {
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
166 my $this = shift;
73
wizard
parents: 63
diff changeset
167
60
b0c068da93ac Lazy activation for the configuration objects (final concept)
wizard
parents: 58
diff changeset
168 $this->DataSource(
194
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
169 new IMPL::Config::Activator(
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
170 factory => 'MyDataSource',
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
171 parameters=>{
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
172 host => 'localhost',
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
173 user => 'dbuser'
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
174 }
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
175 )
60
b0c068da93ac Lazy activation for the configuration objects (final concept)
wizard
parents: 58
diff changeset
176 ) unless $this->Exists('DataSource');
49
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
177 }
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
178
73
wizard
parents: 63
diff changeset
179 # using application object
58
a35b60b16a99 Configuration, late activation
wizard
parents: 49
diff changeset
180
73
wizard
parents: 63
diff changeset
181 my $app = spawn MyApp('default.xml');
58
a35b60b16a99 Configuration, late activation
wizard
parents: 49
diff changeset
182
a35b60b16a99 Configuration, late activation
wizard
parents: 49
diff changeset
183 $app->Run();
a35b60b16a99 Configuration, late activation
wizard
parents: 49
diff changeset
184
73
wizard
parents: 63
diff changeset
185 =end code
wizard
parents: 63
diff changeset
186
180
d1676be8afcc Перекодировка в utf-8
sourcer
parents: 179
diff changeset
187 Ниже приведен пример файла C<default.xml> содержащего настройки приложения
73
wizard
parents: 63
diff changeset
188
wizard
parents: 63
diff changeset
189 =begin code xml
wizard
parents: 63
diff changeset
190
wizard
parents: 63
diff changeset
191 <app type='MyApp'>
194
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
192 <SimpleString>The application</SimpleString>
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
193 <DataSource type='IMPL::Config::Activator'>
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
194 <factory>MyDataSourceClass</factory>
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
195 <parameters type='HASH'>
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
196 <host>localhost</host>
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
197 <user>dbuser</user>
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
198 </parameters>
4d0e1962161c Replaced tabs with spaces
cin
parents: 180
diff changeset
199 </DataSource>
73
wizard
parents: 63
diff changeset
200 </app>
wizard
parents: 63
diff changeset
201
wizard
parents: 63
diff changeset
202 =end code xml
wizard
parents: 63
diff changeset
203
49
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
204 =head1 DESCRIPTION
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
205
73
wizard
parents: 63
diff changeset
206 C<[Serializable]>
wizard
parents: 63
diff changeset
207
wizard
parents: 63
diff changeset
208 C<[Autofill]>
wizard
parents: 63
diff changeset
209
165
76515373dac0 Added Class::Template,
wizard
parents: 73
diff changeset
210 C<use parent IMPL::Object::Accessor>
73
wizard
parents: 63
diff changeset
211
180
d1676be8afcc Перекодировка в utf-8
sourcer
parents: 179
diff changeset
212 Базовый класс для приложений. Использует подход, что приложение
d1676be8afcc Перекодировка в utf-8
sourcer
parents: 179
diff changeset
213 является объектом, состояние которого предтавляет собой конфигурацию,
d1676be8afcc Перекодировка в utf-8
sourcer
parents: 179
diff changeset
214 а методы - логику.
73
wizard
parents: 63
diff changeset
215
180
d1676be8afcc Перекодировка в utf-8
sourcer
parents: 179
diff changeset
216 Данный класс реализует функционал десериализации (и сериализации) экземпляра
d1676be8afcc Перекодировка в utf-8
sourcer
parents: 179
diff changeset
217 приложения из XML документа. Для этого используется механизм C<IMPL::Serialization>.
d1676be8afcc Перекодировка в utf-8
sourcer
parents: 179
diff changeset
218 При этом используются опции C<IMPL::Serialization::XmlFormatter> C<IdentOutput> и
d1676be8afcc Перекодировка в utf-8
sourcer
parents: 179
diff changeset
219 C<SkipWhitespace> для записи документа в легко читаемом виде.
73
wizard
parents: 63
diff changeset
220
180
d1676be8afcc Перекодировка в utf-8
sourcer
parents: 179
diff changeset
221 Поскольку в результате восстановления приложения восстанавливаются все элементы
d1676be8afcc Перекодировка в utf-8
sourcer
parents: 179
diff changeset
222 из файла конфигурации, то это может потребовать значительных ресурсов для
d1676be8afcc Перекодировка в utf-8
sourcer
parents: 179
diff changeset
223 создания частей, которые могут никогда не понадобиться. Например, не требуется инициализация
d1676be8afcc Перекодировка в utf-8
sourcer
parents: 179
diff changeset
224 источника данных для передачи пользователю статических данных, сохраненных на диске.
73
wizard
parents: 63
diff changeset
225
180
d1676be8afcc Перекодировка в utf-8
sourcer
parents: 179
diff changeset
226 Для решения этой проблемы используются специальные объекты C<IMPL::Config::Activator>.
73
wizard
parents: 63
diff changeset
227
180
d1676be8afcc Перекодировка в utf-8
sourcer
parents: 179
diff changeset
228 Если у приложения описано свойство, в котором хранится C<IMPL::Config::Activator>, то
d1676be8afcc Перекодировка в utf-8
sourcer
parents: 179
diff changeset
229 при первом обращении к такому свойству, будет создан объект вызовом метода
d1676be8afcc Перекодировка в utf-8
sourcer
parents: 179
diff changeset
230 C<< IMPL::Config::Activator->activate() >> и возвращен как значение этого свойства.
d1676be8afcc Перекодировка в utf-8
sourcer
parents: 179
diff changeset
231 Таким образом реализуется прозрачная отложенная активация объектов, что позволяет
d1676be8afcc Перекодировка в utf-8
sourcer
parents: 179
diff changeset
232 экономить ресурсы.
49
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
233
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
234 =head1 MEMBERS
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
235
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
236 =over
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
237
73
wizard
parents: 63
diff changeset
238 =item C<[static] LoadXMLFile($fileName) >
60
b0c068da93ac Lazy activation for the configuration objects (final concept)
wizard
parents: 58
diff changeset
239
180
d1676be8afcc Перекодировка в utf-8
sourcer
parents: 179
diff changeset
240 Создает из XML файла C<$fileName> экземпляр приложения
49
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
241
73
wizard
parents: 63
diff changeset
242 =item C<SaveXMLFile($fileName)>
60
b0c068da93ac Lazy activation for the configuration objects (final concept)
wizard
parents: 58
diff changeset
243
180
d1676be8afcc Перекодировка в utf-8
sourcer
parents: 179
diff changeset
244 Сохраняет приложение в файл C<$fileName>
73
wizard
parents: 63
diff changeset
245
wizard
parents: 63
diff changeset
246 =item C<[get] xml >
49
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
247
180
d1676be8afcc Перекодировка в utf-8
sourcer
parents: 179
diff changeset
248 Сохраняет конфигурацию приложения в XML строку.
60
b0c068da93ac Lazy activation for the configuration objects (final concept)
wizard
parents: 58
diff changeset
249
73
wizard
parents: 63
diff changeset
250 =item C<[static,operator] spawn($file)>
49
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
251
180
d1676be8afcc Перекодировка в utf-8
sourcer
parents: 179
diff changeset
252 Синоним для C<LoadXMLFile>, предполагается использование как оператора.
60
b0c068da93ac Lazy activation for the configuration objects (final concept)
wizard
parents: 58
diff changeset
253
73
wizard
parents: 63
diff changeset
254 =item C<rawGet($propname,...)>
wizard
parents: 63
diff changeset
255
180
d1676be8afcc Перекодировка в utf-8
sourcer
parents: 179
diff changeset
256 Метод для получения значений свойств приложения. Данный метод позволяет избежать
d1676be8afcc Перекодировка в utf-8
sourcer
parents: 179
diff changeset
257 использование активации объектов через C<IMPL::Config::Activator>.
60
b0c068da93ac Lazy activation for the configuration objects (final concept)
wizard
parents: 58
diff changeset
258
49
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
259 =back
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
260
16ada169ca75 migrating to the Eclipse IDE
wizard@linux-odin.local
parents: 47
diff changeset
261 =cut