From 7ca09d7e3df0f16457d83a1a1577f9bb5b768605 Mon Sep 17 00:00:00 2001 From: Sam Brannen Date: Tue, 29 Oct 2013 23:44:53 +0100 Subject: [PATCH] Polish NamedParameterUtils - Fixed typos in Javadoc - Formatted Javadoc --- .../core/namedparam/NamedParameterUtils.java | 29 ++++++++++--------- 1 file changed, 15 insertions(+), 14 deletions(-) diff --git a/spring-jdbc/src/main/java/org/springframework/jdbc/core/namedparam/NamedParameterUtils.java b/spring-jdbc/src/main/java/org/springframework/jdbc/core/namedparam/NamedParameterUtils.java index b28f05c620..ef554f5600 100644 --- a/spring-jdbc/src/main/java/org/springframework/jdbc/core/namedparam/NamedParameterUtils.java +++ b/spring-jdbc/src/main/java/org/springframework/jdbc/core/namedparam/NamedParameterUtils.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2012 the original author or authors. + * Copyright 2002-2013 the original author or authors. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -32,7 +32,8 @@ import org.springframework.util.Assert; /** * Helper methods for named parameter parsing. - * Only intended for internal use within Spring's JDBC framework. + * + *

Only intended for internal use within Spring's JDBC framework. * * @author Thomas Risberg * @author Juergen Hoeller @@ -229,18 +230,18 @@ public abstract class NamedParameterUtils { } /** - * Parse the SQL statement and locate any placeholders or named parameters. - * Named parameters are substituted for a JDBC placeholder and any select list - * is expanded to the required number of placeholders. Select lists may contain - * an array of objects and in that case the placeholders will be grouped and - * enclosed with parantheses. This allows for the use of "expression lists" in - * the SQL statement like:
- * select id, name, state from table where (name, age) in (('John', 35), ('Ann', 50)) - *

The parameter values passed in are used to determine the number of - * placeholder to be used for a select list. Select lists should be limited - * to 100 or fewer elements. A larger number of elements is not guaramteed to - * be supported by the database and is strictly vendor-dependent. - * @param parsedSql the parsed represenation of the SQL statement + * Parse the SQL statement and locate any placeholders or named parameters. Named + * parameters are substituted for a JDBC placeholder, and any select list is expanded + * to the required number of placeholders. Select lists may contain an array of + * objects, and in that case the placeholders will be grouped and enclosed with + * parentheses. This allows for the use of "expression lists" in the SQL statement + * like:

+ * {@code select id, name, state from table where (name, age) in (('John', 35), ('Ann', 50))} + *

The parameter values passed in are used to determine the number of placeholders to + * be used for a select list. Select lists should be limited to 100 or fewer elements. + * A larger number of elements is not guaranteed to be supported by the database and + * is strictly vendor-dependent. + * @param parsedSql the parsed representation of the SQL statement * @param paramSource the source for named parameters * @return the SQL statement with substituted parameters * @see #parseSqlStatement