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