2 * Copyright (C) 2015 Roland Haeder
4 * This program is free software: you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License as published by
6 * the Free Software Foundation, either version 3 of the License, or
7 * (at your option) any later version.
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
14 * You should have received a copy of the GNU General Public License
15 * along with this program. If not, see <http://www.gnu.org/licenses/>.
17 package org.mxchange.pizzaapplication.database.frontend.product;
19 import java.io.IOException;
20 import java.sql.ResultSet;
21 import java.sql.SQLException;
22 import java.text.MessageFormat;
23 import java.util.Iterator;
24 import org.mxchange.jcore.criteria.searchable.SearchCriteria;
25 import org.mxchange.jcore.criteria.searchable.SearchableCritera;
26 import org.mxchange.jcore.database.frontend.BaseDatabaseFrontend;
27 import org.mxchange.jcore.database.result.DatabaseResult;
28 import org.mxchange.jcore.database.result.Result;
29 import org.mxchange.jcore.database.storage.Storeable;
30 import org.mxchange.jcore.exceptions.BadTokenException;
31 import org.mxchange.jcore.exceptions.UnsupportedDatabaseBackendException;
32 import org.mxchange.pizzaapplication.database.product.PizzaProductDatabaseConstants;
33 import org.mxchange.pizzaapplication.product.Product;
36 * Stores and retrieves Contact instances
38 * @author Roland Haeder
40 public class PizzaProductDatabaseFrontend extends BaseDatabaseFrontend implements ProductFrontend {
44 * @throws org.mxchange.jcore.exceptions.UnsupportedDatabaseBackendException If the configured backend is not supported
45 * @throws java.sql.SQLException If any SQL error occurs
47 public PizzaProductDatabaseFrontend () throws UnsupportedDatabaseBackendException, SQLException {
49 this.getLogger().trace("CALLED!"); //NOI18N
52 this.setTableName("products"); //NOI18N
59 * Shuts down the database layer
61 * @throws java.sql.SQLException If an SQL error occurs
62 * @throws java.io.IOException If any IO error occurs
65 public void doShutdown () throws SQLException, IOException {
67 this.getLogger().trace("CALLED!"); //NOI18N
70 this.getBackend().doShutdown();
73 this.getLogger().trace("EXIT!"); //NOI18N
77 * Depending on column, an empty value may be converted to null
79 * @param key Key to check
80 * @param value Value to check
81 * @return Possible previous value or null
84 public Object emptyStringToNull (final String key, final Object value) {
86 this.getLogger().trace(MessageFormat.format("key={0},value={1} - CALLED!", key, value));
91 // Is the value empty?
92 if ((value instanceof String) && ("".equals(value))) {
93 // This value may need to be changed
99 this.getLogger().trace(MessageFormat.format("v={0} - EXIT!", v));
106 @SuppressWarnings ("unchecked")
107 public Iterator<Product> getProducts () throws IOException, BadTokenException, SQLException {
109 this.getLogger().trace("CALLED!"); //NOI18N
111 // Instance search criteria
112 SearchableCritera critera = new SearchCriteria();
115 critera.addCriteria(PizzaProductDatabaseConstants.COLUMN_AVAILABLE, true);
118 Result<? extends Storeable> result = this.getBackend().doSelectByCriteria(critera);
121 this.getLogger().debug(MessageFormat.format("result={0}", result)); //NOI18N
124 Iterator<?> iterator = result.iterator();
127 this.getLogger().trace(MessageFormat.format("iterator={0} - EXIT!", iterator)); //NOI18N
129 // Get iterator and return it
130 return (Iterator<Product>) iterator;
134 * Gets a Result back from given ResultSet instance
136 * @param resultSet ResultSet instance from SQL driver
137 * @return A typorized Result instance
138 * @throws java.sql.SQLException If any SQL error occurs
141 public Result<? extends Storeable> getResultFromSet (final ResultSet resultSet) throws SQLException {
143 this.getLogger().trace(MessageFormat.format("resultSet={0} - CALLED!", resultSet));
145 // Init result instance
146 Result<? extends Storeable> result = new DatabaseResult();
148 // Reset result set before first row
149 resultSet.beforeFirst();
151 // "Walk" through all entries
152 while (resultSet.next()) {
153 // Unwrap whole object
154 Product product = resultSet.unwrap(Product.class);
157 this.getLogger().debug(MessageFormat.format("product={0}", product));
164 this.getLogger().trace(MessageFormat.format("result({0})={1} - EXIT!", result.size(), result));
171 * Checks wether the given product title is already used.
173 * @param title Product title
174 * @return Whether the product title is already used
175 * @throws java.io.IOException If any IO error occurs
176 * @throws org.mxchange.jcore.exceptions.BadTokenException If a bad token was found in a file-based database backend's file ... ;-)
177 * @throws java.sql.SQLException If any SQL errors occur
180 public boolean isProductTitleUsed (String title) throws IOException, SQLException, BadTokenException {
182 this.getLogger().trace(MessageFormat.format("title={0} - CALLED!", title));
184 // Get search criteria
185 SearchableCritera criteria = new SearchCriteria();
188 criteria.addCriteria(PizzaProductDatabaseConstants.COLUMN_TITLE, title);
190 // Only one entry is find
191 criteria.setLimit(1);
194 Result<? extends Storeable> result = this.getBackend().doSelectByCriteria(criteria);
197 this.getLogger().debug(MessageFormat.format("result({0}={1}", result, result.size()));
199 // Now check size of the result
200 boolean isFound = (result.size() == 1);
203 this.getLogger().trace(MessageFormat.format("isFound={0} - EXIT!", isFound));
210 * Parses given line from database backend into a Storeable instance. Please
211 * note that not all backends need this.
213 * @param line Line from database backend
214 * @return A Storeable instance
217 public Storeable parseLineToStoreable (final String line) throws BadTokenException {
219 this.getLogger().trace(MessageFormat.format("line={0} - CALLED!", line)); //NOI18N
222 Product product = this.parseLineToProduct(line);
225 this.getLogger().trace(MessageFormat.format("product={0} - EXIT!", product)); //NOI18N
232 * Parses given line to a Product instance
235 * @return A Product instance from given line
237 private Product parseLineToProduct (final String line) {
238 throw new UnsupportedOperationException(MessageFormat.format("Not supported yet: line={0}", line)); //NOI18N
242 * Adds product to database by given title, price and category id
243 * @param title Product title
244 * @param price Product price
245 * @param category Product category id
246 * @throws java.sql.SQLException If any SQL errors occur
249 public void addProduct (final String title, final Float price, final Integer category) throws SQLException {
251 this.getLogger().trace(MessageFormat.format("title={0},price={1},category={2} - CALLED!", title, price, category));
253 // Title should not be null
256 throw new NullPointerException("title is null");
257 } else if (price == null) {
259 throw new NullPointerException("price is null");
260 } else if (category == null) {
262 throw new NullPointerException("category is null");
265 // Clear dataset from previous usage
268 // Add title and parent
269 this.addToDataSet(PizzaProductDatabaseConstants.COLUMN_TITLE, title);
270 this.addToDataSet(PizzaProductDatabaseConstants.COLUMN_PRICE, price);
271 this.addToDataSet(PizzaProductDatabaseConstants.COLUMN_CATEGORY, category);
273 // Handle this over to the backend
274 Result<? extends Storeable> result = this.doInsertDataSet();
277 this.getLogger().debug(MessageFormat.format("result={0}", result));
280 this.getLogger().trace("EXIT!");