java/sql-dk/src/info/globalcode/sql/dk/SQLCommandNamed.java
author František Kučera <franta-hg@frantovo.cz>
Thu, 02 Jan 2014 19:59:33 +0100
branchv_0
changeset 113 575a8c6b91ad
parent 78 d98f33d91553
child 143 1336bb9a4499
permissions -rw-r--r--
Relax NG schema for XML configuration
franta-hg@16
     1
/**
franta-hg@16
     2
 * SQL-DK
franta-hg@16
     3
 * Copyright © 2013 František Kučera (frantovo.cz)
franta-hg@16
     4
 *
franta-hg@16
     5
 * This program is free software: you can redistribute it and/or modify
franta-hg@16
     6
 * it under the terms of the GNU General Public License as published by
franta-hg@16
     7
 * the Free Software Foundation, either version 3 of the License, or
franta-hg@16
     8
 * (at your option) any later version.
franta-hg@16
     9
 *
franta-hg@16
    10
 * This program is distributed in the hope that it will be useful,
franta-hg@16
    11
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
franta-hg@16
    12
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
franta-hg@16
    13
 * GNU General Public License for more details.
franta-hg@16
    14
 *
franta-hg@16
    15
 * You should have received a copy of the GNU General Public License
franta-hg@16
    16
 * along with this program. If not, see <http://www.gnu.org/licenses/>.
franta-hg@16
    17
 */
franta-hg@1
    18
package info.globalcode.sql.dk;
franta-hg@1
    19
franta-hg@49
    20
import static info.globalcode.sql.dk.Functions.notNull;
franta-hg@49
    21
import static info.globalcode.sql.dk.Functions.findByName;
franta-hg@49
    22
import java.sql.Connection;
franta-hg@1
    23
import java.sql.PreparedStatement;
franta-hg@34
    24
import java.sql.SQLException;
franta-hg@49
    25
import java.util.ArrayList;
franta-hg@34
    26
import java.util.List;
franta-hg@51
    27
import java.util.logging.Level;
franta-hg@51
    28
import java.util.logging.Logger;
franta-hg@49
    29
import java.util.regex.Matcher;
franta-hg@49
    30
import java.util.regex.Pattern;
franta-hg@61
    31
import java.util.regex.PatternSyntaxException;
franta-hg@1
    32
franta-hg@1
    33
/**
franta-hg@1
    34
 *
franta-hg@1
    35
 * @author Ing. František Kučera (frantovo.cz)
franta-hg@1
    36
 */
franta-hg@1
    37
public class SQLCommandNamed extends SQLCommand {
franta-hg@1
    38
franta-hg@51
    39
	private static final Logger log = Logger.getLogger(SQLCommandNamed.class.getName());
franta-hg@49
    40
	private String namePrefix;
franta-hg@49
    41
	private String nameSuffix;
franta-hg@34
    42
	private List<NamedParameter> parameters;
franta-hg@49
    43
	private List<NamedParameter> parametersUsed = new ArrayList<>();
franta-hg@49
    44
	private StringBuilder updatedQuery;
franta-hg@49
    45
	private Pattern pattern;
franta-hg@34
    46
franta-hg@49
    47
	public SQLCommandNamed(String query, List<NamedParameter> parameters, String namePrefix, String nameSuffix) {
franta-hg@37
    48
		super(query);
franta-hg@49
    49
		this.updatedQuery = new StringBuilder(query.length());
franta-hg@34
    50
		this.parameters = parameters;
franta-hg@49
    51
		this.namePrefix = namePrefix;
franta-hg@49
    52
		this.nameSuffix = nameSuffix;
franta-hg@49
    53
	}
franta-hg@49
    54
franta-hg@49
    55
	@Override
franta-hg@49
    56
	public PreparedStatement prepareStatement(Connection c) throws SQLException {
franta-hg@61
    57
		try {
franta-hg@61
    58
			buildPattern();
franta-hg@61
    59
			placeParametersAndUpdateQuery();
franta-hg@61
    60
			logPossiblyMissingParameters();
franta-hg@61
    61
		} catch (PatternSyntaxException e) {
franta-hg@61
    62
			throw new SQLException("Name prefix „" + namePrefix + "“ or suffix „" + nameSuffix + "“ contain a wrong regular expression. " + e.getLocalizedMessage(), e);
franta-hg@61
    63
		}
franta-hg@49
    64
		return c.prepareStatement(updatedQuery.toString());
franta-hg@34
    65
	}
franta-hg@34
    66
franta-hg@1
    67
	@Override
franta-hg@34
    68
	public void parametrize(PreparedStatement ps) throws SQLException {
franta-hg@49
    69
		int i = 1;
franta-hg@49
    70
		for (Parameter p : notNull(parametersUsed)) {
franta-hg@68
    71
			ps.setObject(i++, p.getValue(), p.getType().getCode());
franta-hg@49
    72
		}
franta-hg@49
    73
	}
franta-hg@49
    74
franta-hg@49
    75
	/**
franta-hg@49
    76
	 * Builds a regexp pattern that matches all parameter names (with prefix/suffix) and which has
franta-hg@49
    77
	 * one group: parameter name (without prefix/suffix)
franta-hg@49
    78
	 */
franta-hg@49
    79
	private void buildPattern() {
franta-hg@49
    80
		StringBuilder patternString = new StringBuilder();
franta-hg@49
    81
franta-hg@54
    82
		patternString.append(namePrefix);
franta-hg@54
    83
		patternString.append("(?<paramName>");
franta-hg@49
    84
		for (int i = 0; i < parameters.size(); i++) {
franta-hg@51
    85
			patternString.append(Pattern.quote(parameters.get(i).getName()));
franta-hg@51
    86
			if (i < parameters.size() - 1) {
franta-hg@49
    87
				patternString.append("|");
franta-hg@49
    88
			}
franta-hg@49
    89
		}
franta-hg@49
    90
		patternString.append(")");
franta-hg@54
    91
		patternString.append(nameSuffix);
franta-hg@49
    92
franta-hg@49
    93
		pattern = Pattern.compile(patternString.toString());
franta-hg@49
    94
	}
franta-hg@49
    95
franta-hg@49
    96
	private void placeParametersAndUpdateQuery() throws SQLException {
franta-hg@49
    97
		final String originalQuery = getQuery();
franta-hg@49
    98
		Matcher m = pattern.matcher(originalQuery);
franta-hg@49
    99
franta-hg@49
   100
		int lastPosition = 0;
franta-hg@49
   101
		while (m.find(lastPosition)) {
franta-hg@54
   102
			String name = m.group("paramName");
franta-hg@49
   103
franta-hg@49
   104
			updatedQuery.append(originalQuery.substring(lastPosition, m.start()));
franta-hg@49
   105
			updatedQuery.append("?");
franta-hg@49
   106
franta-hg@49
   107
			parametersUsed.add(findByName(parameters, name));
franta-hg@49
   108
franta-hg@49
   109
			lastPosition = m.end();
franta-hg@49
   110
		}
franta-hg@49
   111
		updatedQuery.append(originalQuery.substring(lastPosition, originalQuery.length()));
franta-hg@49
   112
franta-hg@49
   113
		for (NamedParameter definedParameter : parameters) {
franta-hg@49
   114
			if (findByName(parametersUsed, definedParameter.getName()) == null) {
franta-hg@54
   115
				/**
franta-hg@54
   116
				 * User can have predefined set of parameters and use them with different SQL
franta-hg@54
   117
				 * queries that use only subset of these parameters → just warning, not exception.
franta-hg@54
   118
				 */
franta-hg@54
   119
				log.log(Level.WARNING, "Parameter „{0}“ is defined but not used in the query: „{1}“", new Object[]{definedParameter.getName(), originalQuery});
franta-hg@49
   120
			}
franta-hg@49
   121
		}
franta-hg@1
   122
	}
franta-hg@34
   123
franta-hg@51
   124
	private void logPossiblyMissingParameters() {
franta-hg@78
   125
		Pattern p = Pattern.compile(namePrefix + "(?<paramName>.+?)" + nameSuffix);
franta-hg@51
   126
		Matcher m = p.matcher(updatedQuery);
franta-hg@51
   127
		int lastPosition = 0;
franta-hg@51
   128
		while (m.find(lastPosition)) {
franta-hg@54
   129
			/**
franta-hg@54
   130
			 * We have not parsed and understood the SQL query; the parameter-like looking string
franta-hg@54
   131
			 * could be inside a literal part of the query → just warning, not exception.
franta-hg@54
   132
			 */
franta-hg@54
   133
			log.log(Level.WARNING, "Possibly missing parameter „{0}“ in the query: „{1}“", new Object[]{m.group("paramName"), getQuery()});
franta-hg@51
   134
			lastPosition = m.end();
franta-hg@51
   135
		}
franta-hg@51
   136
	}
franta-hg@51
   137
franta-hg@34
   138
	@Override
franta-hg@34
   139
	public List<NamedParameter> getParameters() {
franta-hg@34
   140
		return parameters;
franta-hg@34
   141
	}
franta-hg@1
   142
}