|
1 | 1 | use crate::error::Error;
|
| 2 | +use crate::DBImpl; |
2 | 3 |
|
3 |
| -/** |
4 |
| -Representation of a CREATE INDEX builder. |
5 |
| -*/ |
6 |
| -pub trait CreateIndex<'until_build> { |
7 |
| - /** |
8 |
| - Creates a unique index. |
9 |
| -
|
10 |
| - Null values are considered different from all other null values. |
11 |
| - */ |
12 |
| - fn unique(self) -> Self; |
13 |
| - |
14 |
| - /** |
15 |
| - Creates the index only if it doesn't exist yet. |
16 |
| - */ |
17 |
| - fn if_not_exists(self) -> Self; |
18 |
| - |
19 |
| - /** |
20 |
| - Adds a column to the index. |
21 |
| -
|
22 |
| - **Parameter**: |
23 |
| - - `column`: String representing the column to index. |
24 |
| - */ |
25 |
| - fn add_column(self, column: &'until_build str) -> Self; |
26 |
| - |
27 |
| - /** |
28 |
| - Sets the condition to apply. This will build a partial index. |
29 |
| -
|
30 |
| - **Parameter**: |
31 |
| - - `condition`: String representing condition to apply the index to |
32 |
| - */ |
33 |
| - fn set_condition(self, condition: String) -> Self; |
34 |
| - |
35 |
| - /** |
36 |
| - This method is used to build the create index operation |
37 |
| - */ |
38 |
| - fn build(self) -> Result<String, Error>; |
39 |
| -} |
40 |
| - |
41 |
| -/** |
42 |
| -Representation of a create index operation |
43 |
| -*/ |
44 |
| -pub struct CreateIndexData<'until_build> { |
| 4 | +/// The builder for a `CREATE INDEX` statement |
| 5 | +pub struct CreateIndexBuilder<'until_build> { |
45 | 6 | pub(crate) name: &'until_build str,
|
46 | 7 | pub(crate) table_name: &'until_build str,
|
47 | 8 | pub(crate) unique: bool,
|
48 | 9 | pub(crate) if_not_exists: bool,
|
49 | 10 | pub(crate) columns: Vec<&'until_build str>,
|
50 | 11 | pub(crate) condition: Option<String>,
|
| 12 | + pub(crate) dialect: DBImpl, |
51 | 13 | }
|
52 | 14 |
|
53 |
| -/** |
54 |
| -Implementation of database specific implementations of the [CreateIndex] trait. |
55 |
| -
|
56 |
| -Should only be constructed via [crate::DBImpl::create_index]. |
57 |
| -*/ |
58 |
| -pub enum CreateIndexImpl<'until_build> { |
59 |
| - /** |
60 |
| - SQLite representation of the CREATE INDEX operation. |
61 |
| - */ |
62 |
| - #[cfg(feature = "sqlite")] |
63 |
| - Sqlite(CreateIndexData<'until_build>), |
64 |
| - /** |
65 |
| - MySQL representation of the CREATE INDEX operation. |
66 |
| - */ |
67 |
| - #[cfg(feature = "mysql")] |
68 |
| - MySQL(CreateIndexData<'until_build>), |
69 |
| - /** |
70 |
| - Postgres representation of the CREATE INDEX operation. |
71 |
| - */ |
72 |
| - #[cfg(feature = "postgres")] |
73 |
| - Postgres(CreateIndexData<'until_build>), |
74 |
| -} |
75 |
| - |
76 |
| -impl<'until_build> CreateIndex<'until_build> for CreateIndexImpl<'until_build> { |
| 15 | +impl<'until_build> CreateIndexBuilder<'until_build> { |
| 16 | + /// Creates a unique index. |
| 17 | + /// |
| 18 | + /// Null values are considered different from all other null values. |
77 | 19 | fn unique(mut self) -> Self {
|
78 |
| - match self { |
79 |
| - #[cfg(feature = "sqlite")] |
80 |
| - CreateIndexImpl::Sqlite(ref mut d) => d.unique = true, |
81 |
| - #[cfg(feature = "mysql")] |
82 |
| - CreateIndexImpl::MySQL(ref mut d) => d.unique = true, |
83 |
| - #[cfg(feature = "postgres")] |
84 |
| - CreateIndexImpl::Postgres(ref mut d) => d.unique = true, |
85 |
| - }; |
| 20 | + self.unique = true; |
86 | 21 | self
|
87 | 22 | }
|
88 | 23 |
|
| 24 | + /// Creates the index only if it doesn't exist yet. |
89 | 25 | fn if_not_exists(mut self) -> Self {
|
90 |
| - match self { |
91 |
| - #[cfg(feature = "sqlite")] |
92 |
| - CreateIndexImpl::Sqlite(ref mut d) => d.if_not_exists = true, |
93 |
| - #[cfg(feature = "mysql")] |
94 |
| - CreateIndexImpl::MySQL(ref mut d) => d.if_not_exists = true, |
95 |
| - #[cfg(feature = "postgres")] |
96 |
| - CreateIndexImpl::Postgres(ref mut d) => d.if_not_exists = true, |
97 |
| - }; |
| 26 | + self.if_not_exists = true; |
98 | 27 | self
|
99 | 28 | }
|
100 | 29 |
|
| 30 | + /// Adds a column to the index. |
| 31 | + /// |
| 32 | + /// **Parameter**: |
| 33 | + /// - `column`: String representing the column to index. |
101 | 34 | fn add_column(mut self, column: &'until_build str) -> Self {
|
102 |
| - match self { |
103 |
| - #[cfg(feature = "sqlite")] |
104 |
| - CreateIndexImpl::Sqlite(ref mut d) => d.columns.push(column), |
105 |
| - #[cfg(feature = "mysql")] |
106 |
| - CreateIndexImpl::MySQL(ref mut d) => d.columns.push(column), |
107 |
| - #[cfg(feature = "postgres")] |
108 |
| - CreateIndexImpl::Postgres(ref mut d) => d.columns.push(column), |
109 |
| - } |
| 35 | + self.columns.push(column); |
110 | 36 | self
|
111 | 37 | }
|
112 | 38 |
|
| 39 | + /// Sets the condition to apply. This will build a partial index. |
| 40 | + /// |
| 41 | + /// **Parameter**: |
| 42 | + /// - `condition`: String representing condition to apply the index to |
113 | 43 | fn set_condition(mut self, condition: String) -> Self {
|
114 |
| - match self { |
115 |
| - #[cfg(feature = "sqlite")] |
116 |
| - CreateIndexImpl::Sqlite(ref mut d) => d.condition = Some(condition), |
117 |
| - #[cfg(feature = "mysql")] |
118 |
| - CreateIndexImpl::MySQL(ref mut d) => d.condition = Some(condition), |
119 |
| - #[cfg(feature = "postgres")] |
120 |
| - CreateIndexImpl::Postgres(ref mut d) => d.condition = Some(condition), |
121 |
| - } |
| 44 | + self.condition = Some(condition); |
122 | 45 | self
|
123 | 46 | }
|
124 | 47 |
|
| 48 | + /// This method is used to build the create index operation. |
125 | 49 | fn build(self) -> Result<String, Error> {
|
126 |
| - match self { |
| 50 | + match self.dialect { |
127 | 51 | #[cfg(feature = "sqlite")]
|
128 |
| - CreateIndexImpl::Sqlite(d) => { |
129 |
| - if d.columns.is_empty() { |
| 52 | + DBImpl::SQLite => { |
| 53 | + if self.columns.is_empty() { |
130 | 54 | return Err(Error::SQLBuildError(format!(
|
131 | 55 | "Couldn't create index on {}: Missing column(s) to create the index on",
|
132 |
| - d.table_name |
| 56 | + self.table_name |
133 | 57 | )));
|
134 | 58 | }
|
135 | 59 |
|
136 | 60 | Ok(format!(
|
137 | 61 | "CREATE {} INDEX{} {} ON {} ({}) {};",
|
138 |
| - if d.unique { "UNIQUE" } else { "" }, |
139 |
| - if d.if_not_exists { |
| 62 | + if self.unique { "UNIQUE" } else { "" }, |
| 63 | + if self.if_not_exists { |
140 | 64 | " IF NOT EXISTS"
|
141 | 65 | } else {
|
142 | 66 | ""
|
143 | 67 | },
|
144 |
| - d.name, |
145 |
| - d.table_name, |
146 |
| - d.columns.join(", "), |
147 |
| - d.condition.as_ref().map_or("", |x| x.as_str()), |
| 68 | + self.name, |
| 69 | + self.table_name, |
| 70 | + self.columns.join(", "), |
| 71 | + self.condition.as_ref().map_or("", |x| x.as_str()), |
148 | 72 | ))
|
149 | 73 | }
|
150 | 74 | #[cfg(feature = "mysql")]
|
151 |
| - CreateIndexImpl::MySQL(d) => { |
152 |
| - if d.columns.is_empty() { |
| 75 | + DBImpl::MySQL => { |
| 76 | + if self.columns.is_empty() { |
153 | 77 | return Err(Error::SQLBuildError(format!(
|
154 | 78 | "Couldn't create index on {}: Missing column(s) to create the index on",
|
155 |
| - d.table_name |
| 79 | + self.table_name |
156 | 80 | )));
|
157 | 81 | }
|
158 | 82 |
|
159 | 83 | Ok(format!(
|
160 | 84 | "CREATE {} INDEX{} {} ON {} ({});",
|
161 |
| - if d.unique { "UNIQUE" } else { "" }, |
162 |
| - if d.if_not_exists { |
| 85 | + if self.unique { "UNIQUE" } else { "" }, |
| 86 | + if self.if_not_exists { |
163 | 87 | " IF NOT EXISTS"
|
164 | 88 | } else {
|
165 | 89 | ""
|
166 | 90 | },
|
167 |
| - d.name, |
168 |
| - d.table_name, |
169 |
| - d.columns.join(", "), |
| 91 | + self.name, |
| 92 | + self.table_name, |
| 93 | + self.columns.join(", "), |
170 | 94 | ))
|
171 | 95 | }
|
172 | 96 | #[cfg(feature = "postgres")]
|
173 |
| - CreateIndexImpl::Postgres(d) => { |
174 |
| - if d.columns.is_empty() { |
| 97 | + DBImpl::Postgres => { |
| 98 | + if self.columns.is_empty() { |
175 | 99 | return Err(Error::SQLBuildError(format!(
|
176 | 100 | "Couldn't create index on {}: Missing column(s) to create the index on",
|
177 |
| - d.table_name |
| 101 | + self.table_name |
178 | 102 | )));
|
179 | 103 | }
|
180 | 104 |
|
181 | 105 | Ok(format!(
|
182 | 106 | "CREATE{} INDEX{} {} ON {} ({}){};",
|
183 |
| - if d.unique { " UNIQUE" } else { "" }, |
184 |
| - if d.if_not_exists { |
| 107 | + if self.unique { " UNIQUE" } else { "" }, |
| 108 | + if self.if_not_exists { |
185 | 109 | " IF NOT EXISTS"
|
186 | 110 | } else {
|
187 | 111 | ""
|
188 | 112 | },
|
189 |
| - d.name, |
190 |
| - d.table_name, |
191 |
| - d.columns.join(", "), |
192 |
| - match d.condition { |
| 113 | + self.name, |
| 114 | + self.table_name, |
| 115 | + self.columns.join(", "), |
| 116 | + match self.condition { |
193 | 117 | None => String::from(""),
|
194 | 118 | Some(cond) => format!(" WHERE {}", cond.as_str()),
|
195 | 119 | }
|
|
0 commit comments