|
49
|
1 use strict;
|
|
|
2 package IMPL::SQL::Schema;
|
|
|
3
|
|
165
|
4 use IMPL::_core::version;
|
|
|
5 use IMPL::lang;
|
|
|
6 use parent qw(
|
|
163
|
7 IMPL::Object
|
|
|
8 IMPL::Object::Disposable
|
|
|
9 IMPL::Object::Autofill
|
|
|
10 IMPL::Object::Clonable
|
|
|
11 );
|
|
165
|
12
|
|
49
|
13 use IMPL::Class::Property;
|
|
|
14 use IMPL::Class::Property::Direct;
|
|
|
15
|
|
|
16 require IMPL::SQL::Schema::Table;
|
|
|
17
|
|
|
18 __PACKAGE__->PassThroughArgs;
|
|
|
19
|
|
|
20 BEGIN {
|
|
165
|
21 public _direct property version => prop_get;
|
|
|
22 public _direct property name => prop_get;
|
|
|
23 private _direct property tables => prop_get;
|
|
49
|
24 }
|
|
|
25
|
|
|
26 sub AddTable {
|
|
|
27 my ($this,$table) = @_;
|
|
|
28
|
|
|
29 if (UNIVERSAL::isa($table,'IMPL::SQL::Schema::Table')) {
|
|
165
|
30
|
|
49
|
31 $table->Schema == $this or die new IMPL::InvalidOperationException('The specified table must belong to the database');
|
|
165
|
32 not exists $this->{$tables}->{$table->name} or die new IMPL::InvalidOperationException('a table with the same name already exists in the database');
|
|
|
33
|
|
49
|
34 } elsif (UNIVERSAL::isa($table,'HASH')) {
|
|
165
|
35
|
|
|
36 not exists $this->{$tables}->{$table->{'name'}} or die new IMPL::InvalidOperationException('a table with the same name already exists in the database');
|
|
|
37 $table = { %$table };
|
|
|
38 $table->{'schema'} = $this;
|
|
49
|
39 $table = new IMPL::SQL::Schema::Table(%{$table});
|
|
|
40 } else {
|
|
|
41 die new IMPL::InvalidArgumentException('Either a table object or a hash with table parameters is required');
|
|
|
42 }
|
|
|
43
|
|
165
|
44 $this->{$tables}{$table->name} = $table;
|
|
49
|
45 }
|
|
|
46
|
|
|
47 sub RemoveTable {
|
|
|
48 my ($this,$table) = @_;
|
|
|
49
|
|
165
|
50 my $tn = UNIVERSAL::isa($table,'IMPL::SQL::Schema::Table') ? $table->name : $table;
|
|
|
51
|
|
|
52 $table = delete $this->{$tables}{$tn} or die new IMPL::InvalidArgumentException('The table doesn\'t exists',$tn);
|
|
49
|
53
|
|
|
54 # drop foreign keys
|
|
165
|
55 map { $_->table->RemoveConstraint($_) } values %{$table->primaryKey->connectedFK} if $table->primaryKey;
|
|
49
|
56
|
|
|
57 # drop table contents
|
|
|
58 $table->Dispose();
|
|
|
59
|
|
|
60 return 1;
|
|
|
61 }
|
|
|
62
|
|
163
|
63 sub ResolveTable {
|
|
|
64 my ($this,$table) = @_;
|
|
|
65
|
|
165
|
66 UNIVERSAL::isa($table,'IMPL::SQL::Schema::Table') ? $table : $this->{$tables}{$table};
|
|
|
67 }
|
|
|
68
|
|
|
69 sub Table {
|
|
|
70 goto &GetTable;
|
|
163
|
71 }
|
|
|
72
|
|
164
|
73 sub GetTable {
|
|
|
74 my ($this,$tableName) = @_;
|
|
165
|
75 return $this->{$tables}{$tableName};
|
|
|
76 }
|
|
|
77
|
|
|
78 sub GetTables {
|
|
|
79 my ($this) = @_;
|
|
|
80
|
|
|
81 return wantarray ? values %{$this->{$tables}} : [values %{$this->{$tables}}];
|
|
164
|
82 }
|
|
|
83
|
|
|
84 sub RenameTable {
|
|
|
85 my ($this,$oldName,$newName) = @_;
|
|
|
86
|
|
165
|
87 die new IMPL::InvalidOperationException("A source table doesn't exists", $oldName) unless exists $this->{$tables}{$oldName};
|
|
|
88 die new IMPL::InvalidOperationException("A target table already exists", $newName) if exists $this->{$tables}{$newName};
|
|
164
|
89
|
|
165
|
90 my $table = delete $this->{$tables}{$oldName};
|
|
|
91 $table->_setName($newName);
|
|
|
92 $this->{$tables}{$newName} = $table;
|
|
164
|
93 }
|
|
|
94
|
|
49
|
95 sub Dispose {
|
|
|
96 my ($this) = @_;
|
|
|
97
|
|
165
|
98 $_->Dispose foreach values %{$this->{$tables}};
|
|
49
|
99
|
|
165
|
100 delete $this->{$tables};
|
|
49
|
101
|
|
|
102 $this->SUPER::Dispose;
|
|
|
103 }
|
|
|
104
|
|
|
105 1;
|
|
|
106
|
|
|
107 __END__
|
|
|
108 =pod
|
|
|
109
|
|
165
|
110 =head1 SYNOPSIS
|
|
49
|
111
|
|
163
|
112 =begin code
|
|
|
113
|
|
49
|
114 require IMPL::SQL::Schema;
|
|
|
115 use IMPL::SQL::Types qw(Varchar Integer);
|
|
|
116
|
|
|
117 my $dbSchema = new IMPL::SQL::Schema;
|
|
|
118
|
|
165
|
119 my $tbl = $dbSchema->AddTable({name => 'Person' });
|
|
49
|
120 $tbl->AddColumn({
|
|
165
|
121 name => 'FirstName',
|
|
|
122 canBeNull => 1,
|
|
|
123 type => Varchar(255)
|
|
49
|
124 });
|
|
|
125 $tbl->AddColumn({
|
|
165
|
126 name => 'Age',
|
|
|
127 type => Integer
|
|
49
|
128 });
|
|
|
129
|
|
|
130 # so on
|
|
|
131
|
|
|
132 # and finally don't forget to
|
|
|
133
|
|
163
|
134 $dbSchema->Dispose();
|
|
|
135
|
|
|
136 =end code
|
|
49
|
137
|
|
|
138 =head1 DESCRIPTION
|
|
|
139
|
|
|
140 Схема реляциоонной базы данных, орентированная на язык SQL, содержит описания таблиц
|
|
|
141 которые являются частью базы. Позволяет создавать и удалать таблицы.
|
|
|
142
|
|
165
|
143 =head1 MEMBERS
|
|
|
144
|
|
|
145 =over
|
|
|
146
|
|
|
147 =item C<CTOR(%props)>
|
|
|
148
|
|
|
149 Конструктор заполняет объект свойствами из C<props>.
|
|
|
150
|
|
|
151 =item C<[get]name>
|
|
|
152
|
|
|
153 Имя схемы.
|
|
|
154
|
|
|
155 =item C<[get]version>
|
|
|
156
|
|
|
157 Версия схемы.
|
|
|
158
|
|
|
159 =item C<AddTable($table)>
|
|
|
160
|
|
|
161 Доавляет таблицу в схему. C<$table> может быть либо таблице, либо хешем с набором
|
|
|
162 свойств для создания новой таблицы. Если таблица с таким именем уже существует в сехеме,
|
|
|
163 то вызывается исключение.
|
|
|
164
|
|
|
165 =item C<GetTable($name)>
|
|
|
166
|
|
|
167 Возвращает таблицу с именем C<$name> или C<undef>.
|
|
|
168
|
|
|
169 =item C<GetTables()>
|
|
|
170
|
|
|
171 Возвращает список таблиц. В скалярном контексте - ссылку на массив с таблицами.
|
|
|
172
|
|
|
173 =item C<ResolveTable($table)>
|
|
|
174
|
|
|
175 Если параметр C<$table> - таблица, то возвращается C<$table>, если C<$table> строка, то
|
|
|
176 ищется таблица с таким именем, если таблица не найдена, возвращается C<undef>.
|
|
|
177
|
|
|
178 =item C<RenameTable($oldName,$newName)>
|
|
|
179
|
|
|
180 Происходит переименование таблицы. Если C<$oldName> не существует, либо если C<$newName>
|
|
|
181 существует, вызывается исключение.
|
|
|
182
|
|
|
183 =item C<RemoveTable($table)>
|
|
|
184
|
|
|
185 Удаляется таблица C<$table> с удалением всех связей и ограничений. Если такой таблицы нет,
|
|
|
186 то вызывается исключение. C<$table> может быть либо именем таблицы, либо объектом.
|
|
|
187
|
|
|
188 =back
|
|
49
|
189
|
|
|
190 =cut
|
