【1】JDBC体系结构
在Java中,数据库存取技术可分为如下几类:
JDBC直接访问数据库 JDO技术 第三方O/R工具,如Hibernate, ibatis-MyBatis 等
JDBC(Java Database Connectivity)
是一个独立于特定数据库管理系统、通用的SQL数据库存取和操作的公共接口(一组API),定义了用来访问数据库的标准Java类库,使用这个类库可以以一种标准的方法、方便地访问数据库资源。
如下所示,在rt.jar/java.sql
包下有系列接口:
DBC为访问不同的数据库提供了一种统一的途径,为开发者屏蔽了一些细节问题。
JDBC的目标是使Java程序员使用JDBC可以连接任何提供了JDBC驱动程序的数据库系统,这样就使得程序员无需对特定的数据库系统的特点有过多的了解,从而大大简化和加快了开发过程。
JDBC是java访问数据库的基石,JDO, Hibernate等只是更好的封装了JDBC。
JDBC接口(API)包括两个层次:
- 面向应用的API:Java API,抽象接口,供应用程序开发人员使用(连接数据库,执行SQL语句,获得结果)。
- 面向数据库的API:Java Driver API,供开发商开发数据库驱动程序用。
【2】JDBC驱动程序分类
JDBC驱动程序:各个数据库厂商根据JDBC的规范制作的 JDBC 实现类的类库 。
JDBC驱动程序总共有四种类型:
- 第一类:JDBC-ODBC桥。
- 第二类:部分本地API部分Java的驱动程序。
- 第三类:JDBC网络纯Java驱动程序。
- 第四类:本地协议的纯 Java 驱动程序。
第三、四两类都是纯Java的驱动程序,因此,对于Java开发者来说,它们在性能、可移植性、功能等方面都有优势
① ODBC
早期对数据库的访问,都是调用数据库厂商提供的专有的 API。为了在 Windows 平台下提供统一的访问方式,微软推出了 ODBC(Open Database Connectivity,开放式数据库连接),并提供了 ODBC API,使用者在程序中只需要调用 ODBC API,由 ODBC 驱动程序将调用转换成为对特定的数据库的调用请求。
一个基于ODBC的应用程序对数据库的操作不依赖任何DBMS(database manager system),不直接与DBMS打交道,所有的数据库操作由对应的DBMS的ODBC驱动程序完成。也就是说,不论是FoxPro、Access , MYSQL还是Oracle数据库,均可用ODBC API进行访问。由此可见,ODBC的最大优点是能以统一的方式处理所有的数据库。
② JDBC-ODBC桥
JDBC-ODBC 桥本身也是一个驱动,利用这个驱动,可以使用 JDBC-API 通过ODBC 去访问数据库。这种机制实际上是把标准的 JDBC 调用转换成相应的 ODBC 调用,并通过 ODBC 访问数据库。
因为需要通过多层调用,所以利用 JDBC-ODBC 桥访问数据库的效率较低。
在 JDK 中,提供了 JDBC-ODBC 桥的实现类(sun.jdbc.odbc.JdbcOdbcDriver)。
③ 部分本地API部分Java的驱动程序
这种类型的 JDBC 驱动程序使用 Java 编写,它调用数据库厂商提供的本地 API。
通过这种类型的 JDBC 驱动程序访问数据库减少了 ODBC 的调用环节,提高了数据库访问的效率。
在这种方式下需要在客户的机器上安装本地 JDBC 驱动程序和特定厂商的本地 API。
④ JDBC网络纯Java驱动程序
这种驱动利用中间件的应用服务器来访问数据库。应用服务器作为一个到多个数据库的网关,客户端通过它可以连接到不同的数据库服务器。
应用服务器通常有自己的网络协议,Java 用户程序通过 JDBC 驱动程序将 JDBC 调用发送给应用服务器,应用服务器使用本地程序驱动访问数据库,从而完成请求。
⑤ 本地协议的纯 Java 驱动程序
多数数据库厂商已经支持允许客户程序通过网络直接与数据库通信的网络协议。
这种类型的驱动程序完全使用 Java 编写,通过与数据库建立的 Socket 连接,采用具体与厂商的网络协议把 JDBC 调用转换为直接连接的网络调用。
【3】JDBC API
JDBC API 是一系列的接口,它使得应用程序能够进行数据库联接,执行SQL语句,并且得到返回结果。
① Driver 接口
Java.sql.Driver 接口是所有 JDBC 驱动程序需要实现的接口。这个接口是提供给数据库厂商使用的,不同数据库厂商提供不同的实现。
在程序中不需要直接去访问实现了 Driver 接口的类,而是由驱动程序管理器类(java.sql.DriverManager)去调用这些Driver实现。
② 加载与注册 JDBC 驱动
加载 JDBC 驱动需调用 Class 类的静态方法 forName(),向其传递要加载的 JDBC 驱动的类名。
DriverManager 类是驱动程序管理器类,负责管理驱动程序。
通常不用显式调用 DriverManager 类的 registerDriver() 方法来注册驱动程序类的实例,因为 Driver 接口的驱动程序类都包含了静态代码块,在这个静态代码块中,会调用 DriverManager.registerDriver() 方法来注册自身的一个实例。
③ 建立连接
可以调用 DriverManager 类的 getConnection() 方法建立到数据库的连接。
JDBC URL 用于标识一个被注册的驱动程序,驱动程序管理器通过这个 URL 选择正确的驱动程序,从而建立到数据库的连接。
JDBC URL的标准由三部分组成,各部分间用冒号分隔。
jdbc:<子协议>:<子名称>;
协议:JDBC URL中的协议总是jdbc ;
子协议:子协议用于标识一个数据库驱动程序;
子名称:一种标识数据库的方法。子名称可以依不同的子协议而变化,用子名称的目的是为了定位数据库提供足够的信息 。
④ 几种常用数据库的JDBC URL
这里数据库名字为sid。对于 Oracle 数据库连接,URL采用如下形式:
jdbc:oracle:thin:@localhost:1521:sid
对于 SQLServer 数据库连接,URL采用如下形式:
jdbc:microsoft:sqlserver//localhost:1433; DatabaseName=sid
对于 MYSQL 数据库连接,URL采用如下形式:
jdbc:mysql://localhost:3306/sid
⑤ 访问数据库
数据库连接被用于向数据库服务器发送命令和 SQL 语句,在连接建立后,需要对数据库进行访问,执行 sql 语句。
在 java.sql 包中有 3 个接口分别定义了对数据库的调用的不同方式:
Statement --PrepatedStatement ---CallableStatement
⑥ Statement
通过调用 Connection 对象的 createStatement 方法创建该对象。
该对象用于执行静态的 SQL 语句,并且返回执行结果。
Statement 接口中定义了下列方法用于执行 SQL 语句:
ResultSet excuteQuery(String sql) int excuteUpdate(String sql)
ResultSet
通过调用 Statement 对象的 excuteQuery() 方法创建该对象。
ResultSet 对象以逻辑表格的形式封装了执行数据库操作的结果集,ResultSet 接口由数据库厂商实现。
ResultSet 对象维护了一个指向当前数据行的游标,初始的时候,游标在第一行之前,可以通过 ResultSet 对象的 next() 方法移动到下一行。ResultSet 接口的常用方法:
boolean next() getString() ...
数据类型转换表
java类型 | SQL类型 |
boolean | BIT |
byte | TINYINT |
short | SMALLINT |
int | INTEGER |
long | BIGINT |
String | CHAR VARCHAR LONGVARCHAR |
byte array | BINART VARBINARY |
java.sql.Date | DATE |
java.sql.Time | TIME |
java.sql.Timestamp | TIMESTAMP |
⑦ PreparedStatement
可以通过调用 Connection 对象的 preparedStatement() 方法获PreparedStatement 对象。
PreparedStatement 接口是 Statement 的子接口,它表示一条预编译过的 SQL 语句。
PreparedStatement 对象所代表的 SQL 语句中的参数用问号(?)来表示,调用 PreparedStatement 对象的 setXXX() 方法来设置这些参数. setXXX() 方法有两个参数,第一个参数是要设置的 SQL 语句中的参数的索引(从 1 开始),第二个是设置的 SQL 语句中的参数的值。
⑧ PreparedStatement vs Statement
代码的可读性和可维护性。
PreparedStatement 能最大可能提高性能:
DBServer会对预编译语句提供性能优化。因为预编译语句有可能被重复调用,所以语句在被DBServer的编译器编译后的执行代码被缓存下来,那么下次调用时只要是相同的预编译语句就不需要编译,只要将参数直接传入编译过的语句执行代码中就会得到执行。
.
在statement语句中,即使是相同操作但因为数据内容不一样,所以整个语句本身不能匹配,没有缓存语句的意义.事实是没有数据库会对普通语句编译后的执行代码缓存.这样每执行一次都要对传入的语句编译一次.
PreparedStatement 语法检查,语义检查,翻译成二进制命令,缓存
PreparedStatement 可以防止 SQL 注入
SQL 注入攻击
SQL 注入是利用某些系统没有对用户输入的数据进行充分的检查,而在用户输入数据中注入非法的 SQL 语句段或命令,从而利用系统的 SQL 引擎完成恶意行为的做法。
.
对于 Java 而言,要防范 SQL 注入,只要用 PreparedStatement 取代 Statement 就可以了。为什么PreparedStatement 可以防止SQL注入攻击?
因为SQL语句在程序运行前已经进行了预编译,在程序运行时第一次操作数据库之前,SQL语句已经被数据库分析,编译和优化,对应的执行计划也会缓存下来并允许数据库已参数化的形式进行查询,当运行时动态地把参数传给PreprareStatement时,即使参数里有敏感字符如 or '1=1’也数据库会作为一个参数一个字段的属性值来处理而不会作为一个SQL指令。这样保证了SQL的逻辑不变。
具体的说PreparedStatement 会对该条sql首先进行预编译,然后会将传入的字符串参数以字符串的形式去处理,即会在参数的两边自动加上单引号(’param’),而Statement则是直接简单粗暴地通过人工的字符串拼接的方式去写sql,那这样就很容易被sql注入。
总结:
java.sql.DriverManager用来装载驱动程序,获取数据库连接。
java.sql.Connection完成对某一指定数据库的联接。
java.sql.Statement在一个给定的连接中作为SQL执行声明的容器,他包含了两个重要的子类型。
Java.sql.PreparedSatement 用于执行预编译的sql声明。
Java.sql.CallableStatement用于执行数据库中存储过程的调用。
java.sql.ResultSet对于给定声明取得结果的途径。
【4】JDBC常用操作
① 执行insert update delete操作
//不定个数的参数args; public void update(String sql, Object... args) throws Exception { Connection connection = null; PreparedStatement pStatement = null; try { connection = JDBCToolss.getConnection(); //链接使用sql创建prepareStatement对象 pStatement = connection.prepareStatement(sql); //循环为sql中占位符 ? 赋值 for (int i = 0; i < args.length; i++) { pStatement.setObject(i + 1, args[i]); } // 执行更新操作 pStatement.executeUpdate(); } catch (Exception e) { e.printStackTrace(); } finally { JDBCToolss.release(null, pStatement, connection); } }
② get(Class<T> clazz, String sql, Object... args
)
查询一条记录,返回对应的对象
public <T> T get(Class<T> clazz, String sql, Object... args) throws Exception { /* * List<T> result = getForList(clazz,sql,args); * if(result.size()>0){ * return result.get(0); * } * return null; * */ T entity = null; Connection connection = null; PreparedStatement preparedStatement = null; ResultSet resultSet = null; try { connection = JDBCToolss.getConnection(); preparedStatement = connection.prepareStatement(sql); for (int i = 0; i < args.length; i++) { preparedStatement.setObject(i + 1, args[i]); } resultSet = preparedStatement.executeQuery(); /*result是对从数据库读到的结果集进行处理*/ ResultSetMetaData rsmd = resultSet.getMetaData(); Map<String, Object> valueMap = new HashMap<String, Object>(); /* 得到列的别名及值 */ while (resultSet.next()) { /* 打印每一列的列名---getcolumncount 得到結果集中多少列 */ for (int i = 0; i < rsmd.getColumnCount(); i++) { /* 索引默认从 1 开始,获取列名 */ String columnLabel = rsmd.getColumnLabel(i + 1); /* 获取对应的列值 */ Object columnValue = resultSet.getObject(columnLabel); // Object columnValue = resultSet.getObject(i+1); /* 放入map里面 */ valueMap.put(columnLabel, columnValue); } } /* 反射得到clazz对应的实例对象 赋值给entity */ entity = clazz.newInstance(); if (valueMap.size() > 0) { /* 循环遍历map,取出key value */ for (Map.Entry<String, Object> entry : valueMap.entrySet()) { String fieldName = entry.getKey(); Object fieldValue = entry.getValue(); /* 使用beanutils工具类进行赋值 */ BeanUtils.setProperty(entity, fieldName, fieldValue); /* 使用反射进行赋值 */ // ReflectionUtils.setFieldValue(entity, fieldName, // fieldValue); } } } catch (Exception e) { e.printStackTrace(); } finally { JDBCToolss.release(resultSet, preparedStatement, connection); } return entity; }
③ getForList( )
查询多条记录,返回对应的对象集合list
// <T> List<T> 使用泛型。。。 public <T> List<T> getForList(Class<T> clazz, String sql, Object... args) throws Exception { List<T> list = new ArrayList<T>(); Connection connection = null; PreparedStatement preparedStatement = null; ResultSet resultSet = null; try { /* 得到结果集 */ connection = JDBCToolss.getConnection(); preparedStatement = connection.prepareStatement(sql); for (int i = 0; i < args.length; i++) { preparedStatement.setObject(i + 1, args[i]); } resultSet = preparedStatement.executeQuery(); /* 处理结果集,得到map的一个list,其实一个map对象就是一条记录,map的key为列的别名,值为列值 */ List<Map<String, Object>> valueList = handleResultSetToMapList(resultSet); /* * 将map的list转换为clazz对应的list map的key为clazz对应的对象的propertyName * map的value为clazz对应的对象的propertyValue */ list = transferMapListToBeanList(clazz, valueList); } catch (Exception e) { e.printStackTrace(); } finally { JDBCToolss.release(resultSet, preparedStatement, connection); } return list; }
④ MapListToBeanList
把每一行对应的map转化为一个bean;
private <T> List<T> transferMapListToBeanList(Class<T> clazz, List<Map<String, Object>> valueList) throws Exception { List<T> result = new ArrayList<T>(); Object entity = null; if (valueList.size() > 0) { for (Map<String, Object> map : valueList) { /* 循环遍历map,取出key value */ entity = clazz.newInstance(); for (Map.Entry<String, Object> entry : map.entrySet()) { String propertyName = entry.getKey(); Object propertyValue = entry.getValue(); /* 使用beanutils进行赋值 */ BeanUtils.setProperty(entity, propertyName, propertyValue); /* 使用反射进行赋值 */ // ReflectionUtils.setFieldValue(entity, propertyName, // propertyValue); } result.add((T) entity); } } return result; }
⑤ ResultSetToMapList
- 把每一行记录放入一个新的map中,并添加到list;
- map中key为列名,value为列值;
private List<Map<String, Object>> handleResultSetToMapList( ResultSet resultSet) throws SQLException { List<String> columnLabels = getColumnLabels(resultSet); List<Map<String, Object>> valueList = new ArrayList<Map<String, Object>>(); /* 对结果集进行每行循环取值 */ while (resultSet.next()) { Map<String, Object> valueMap = new HashMap<String, Object>(); /* 打印每一列的列名---getcolumncount 得到結果集中多少列 */ for (String columnLabel : columnLabels) { /* 获取根据列名获取该行对应列值 */ Object columnValue = resultSet.getObject(columnLabel); /* * for(int i=0;i<columnLabels.size();i++) { String columanLabe = * columnLabels.get(i); Object columnValue = * resultSet.getObject(i+1); } */ /* 放入map里面 */ valueMap.put(columnLabel, columnValue); } valueList.add(valueMap); } return valueList; }
⑥ 得到列别名的list
- 通过resultSet获取所有列的名字
private List<String> getColumnLabels(ResultSet rs) throws SQLException { List<String> labels = new ArrayList<String>(); ResultSetMetaData rsmd = rs.getMetaData(); for (int i = 0; i < rsmd.getColumnCount(); i++) { labels.add(rsmd.getColumnLabel(i + 1)); } return labels; }
⑦ getForValue
得到某一条记录的某个字段值,或一个统计的值(一共有多少条记录)
public <E> E getForValue(String sql, Object... args) throws Exception { Connection connection = null; PreparedStatement preparedStatement = null; ResultSet resultSet = null; try { /* 得到结果集 */ connection = JDBCToolss.getConnection(); preparedStatement = connection.prepareStatement(sql); for (int i = 0; i < args.length; i++) { preparedStatement.setObject(i + 1, args[i]); } resultSet = preparedStatement.executeQuery(); if (resultSet.next()) { return (E) resultSet.getObject(1); } return null; }catch (Exception e) { e.printStackTrace(); }finally{ JDBCToolss.release(resultSet, preparedStatement, connection); } return null; }
⑧ JDBCTools工具类
package com.jdbc.mvc; import java.io.InputStream; import java.sql.Connection; import java.sql.ResultSet; import java.sql.SQLException; import java.util.Properties; import com.mysql.jdbc.Driver; import java.sql.Statement; //statement connection 都是java.sql.*; 数据库驱动则是 com.mysql.jdbc.*; public class JDBCTools { public static void release(ResultSet rs,Statement statement , Connection connection) throws Exception{ //connection statement rs 都是应用服务器与数据库的连接资源,需要关闭 if (rs!=null) { try { rs.close(); } catch (Exception e) { e.printStackTrace(); } } if (statement!=null) { try { statement.close(); } catch (Exception e) { e.printStackTrace(); } } if (connection!=null) { try { connection.close(); } catch (Exception e) { e.printStackTrace(); } } } public static Connection getConnection() throws Exception{ String driverClas = null; String jdbcURL = null; String user = null; String password = null; //读取类路径下的properties InputStream in = JDBCTools.class.getClass().getClassLoader().getResourceAsStream("jdbc.properties"); Properties properties = new Properties(); properties.load(in); driverClas = properties.getProperty("driver"); jdbcURL = properties.getProperty("jdbcURL"); user = properties.getProperty("user"); password = properties.getProperty("password"); Driver driver = (Driver) Class.forName(driverClas).newInstance(); Properties info = new Properties(); info.put("user", user); info.put("password", password); Connection connection = driver.connect(jdbcURL, info); return connection; } }
【5】Apache—DBUtils
commons-dbutils 是 Apache 组织提供的一个开源 JDBC工具类库,它是对JDBC的简单封装,使用dbutils能极大简化jdbc编码的工作量,同时也不会影响程序的性能。
API介绍:
–org.apache.commons.dbutils.QueryRunner
–org.apache.commons.dbutils.ResultSetHandler
工具类
–org.apache.commons.dbutils.DbUtils。
① DbUtils类
DbUtils :提供如关闭连接、装载JDBC驱动程序等常规工作的工具类,里面的所有方法都是静态的。
主要方法如下:
public static void close(…) throws java.sql.SQLException:DbUtils类提供了三个重载的关闭方法。这些方法检查所提供的参数是不是NULL,如果不是的话,它们就关闭Connection、Statement和ResultSet。
public static void closeQuietly(…):这一类方法不仅能在Connection、Statement和ResultSet为NULL情况下避免关闭,还能隐藏一些在程序中抛出的SQLEeception。
public static void commitAndCloseQuietly(Connection conn): 用来提交连接,然后关闭连接,并且在关闭连接时不抛出SQL异常。
public static boolean loadDriver(java.lang.String driverClassName):这一方装载并注册JDBC驱动程序,如果成功就返回true。使用该方法,你不需要捕捉这个异常ClassNotFoundException。
② QueryRunner类
该类简单化了SQL查询,它与ResultSetHandler组合在一起使用可以完成大部分的数据库操作,能够大大减少编码量。
QueryRunner类提供了两个构造方法:
默认的构造方法 需要一个 javax.sql.DataSource 来作参数的构造方法。
主要方法如下:
public Object query(Connection conn, String sql, Object[] params, ResultSetHandler rsh) throws SQLException:执行一个查询操作,在这个查询中,对象数组中的每个元素值被用来作为查询语句的置换参数。该方法会自行处理 PreparedStatement 和 ResultSet 的创建和关闭。
public Object query(String sql, Object[] params, ResultSetHandler rsh) throws SQLException:几乎与第一种方法一样;唯一的不同在于它不将数据库连接提供给方法,并且它是从提供给构造方法的数据源(DataSource) 或使用的setDataSource 方法中重新获得 Connection。
public Object query(Connection conn, String sql, ResultSetHandler rsh) throws SQLException :执行一个不需要置换参数的查询操作。
public int update(Connection conn, String sql, Object[] params) throws SQLException:用来执行一个更新(插入、更新或删除)操作。
public int update(Connection conn, String sql) throws SQLException:用来执行一个不需要置换参数的更新操作。
③ ResultSetHandler接口
该接口用于处理 java.sql.ResultSet,将数据按要求转换为另一种形式。
ResultSetHandler 接口提供了一个单独的方法:Object handle (java.sql.ResultSet .rs)。
其实现类如下:
ArrayHandler:把结果集中的第一行数据转成对象数组。
ArrayListHandler:把结果集中的每一行数据都转成一个数组,再存放到List中。
BeanHandler:将结果集中的第一行数据封装到一个对应的JavaBean实例中。
BeanListHandler:将结果集中的每一行数据都封装到一个对应的JavaBean实例中,存放到List里。
ColumnListHandler:将结果集中某一列的数据存放到List中。
KeyedHandler(name):将结果集中的每一行数据都封装到一个Map里,再把这些map再存到一个map里,其key为指定的key。
MapHandler:将结果集中的第一行数据封装到一个Map里,key是列名,value就是对应的值。
MapListHandler:将结果集中的每一行数据都封装到一个Map里,然后再存放到List。
【6】数据库分页
在编写Web应用程序等系统时,会涉及到与数据库的交互,如果数据库中数据量很大的话,一次检索所有的记录,会占用系统很大的资源,因此常常采用分页语句:需要多少数据就只从数据库中取多少条记录。
以下是Sql Server,Oracle和MySQL的分页语句(从数据库表中的第M条数据开始取N条记录)。
① SQL Server 分页
从数据库表中的第M条记录开始取N条记录,利用Top关键字(如果Select语句中既有top,又有order by,则是从排序好的结果集中选择)。
SELECT * FROM ( SELECT Top N* FROM (SELECT Top (M + N - 1) * FROM 表名称 Order by 主键 desc) t1 ) t2 Order by 主键 asc
例如从表Sys_option(主键为sys_id)中从10条记录开始检索20条记录,语句如下:
SELECT * FROM ( SELECT TOP 20 * FROM (SELECT TOP 29 * FROM Sys_option order by sys_id desc)t1 ) t2 Order by sys_id asc
② Oralce分页
从数据库表中第M条记录 开始检索N条记录。
例如从表employees(主键为employee_id)中从11条记录开始检索20条记录,语句如下:
③ MySQL分页
My sql数据库最简单,是利用mySQL的LIMIT函数,LIMIT [offset,] rows
。
从数据库表中M条记录开始检索N条记录的语句为:
SELECT [列名列表] FROM 表名称 LIMIT M,N
例如从表Sys_option(主键为sys_id)中从10条记录开始检索20条记录,语句如下:
select * from sys_option limit 10,20
【7】使用JDBC调用函数或存储过程
实例代码如下:
@Test public void testCallableStatment() { Connection connection = null; CallableStatement callableStatement = null; try { connection = JDBCTools.getConnection(); // 1. 通过 Connection 对象的 prepareCall() // 方法创建一个 CallableStatement 对象的实例. // 在使用 Connection 对象的 preparedCall() 方法时, // 需要传入一个 String 类型的字符串, 该字符串用于指明如何调用存储过程. String sql = "{?= call sum_salary(?, ?)}"; callableStatement = connection.prepareCall(sql); // 2. 通过 CallableStatement 对象的 //reisterOutParameter() 方法注册 OUT 参数. callableStatement.registerOutParameter(1, Types.NUMERIC); callableStatement.registerOutParameter(3, Types.NUMERIC); // 3. 通过 CallableStatement 对象的 setXxx() 方法设定 IN 或 IN OUT 参数. //若想将参数默认值设为 null, 可以使用 setNull() 方法. callableStatement.setInt(2, 80); // 4. 通过 CallableStatement 对象的 execute() 方法执行存储过程 callableStatement.execute(); // 5. 如果所调用的是带返回参数的存储过程, //还需要通过 CallableStatement 对象的 getXxx() 方法获取其返回值. double sumSalary = callableStatement.getDouble(1); long empCount = callableStatement.getLong(3); System.out.println(sumSalary); System.out.println(empCount); } catch (Exception e) { e.printStackTrace(); } finally { JDBCTools.releaseDB(null, callableStatement, connection); } }