com.fr.data.impl.Connection

package com.fr.data.impl;

import com.fr.json.JSONException;
import com.fr.json.JSONObject;
import com.fr.stable.UrlDriver;
import com.fr.stable.xml.XMLable;

import java.sql.Array;
import java.sql.Blob;
import java.sql.CallableStatement;
import java.sql.Clob;
import java.sql.DatabaseMetaData;
import java.sql.NClob;
import java.sql.PreparedStatement;
import java.sql.SQLClientInfoException;
import java.sql.SQLException;
import java.sql.SQLWarning;
import java.sql.SQLXML;
import java.sql.Savepoint;
import java.sql.Statement;
import java.sql.Struct;
import java.util.List;
import java.util.Map;
import java.util.Properties;
import java.util.concurrent.Executor;

/**
 * 数据连接接口
 */
public interface Connection extends UrlDriver, XMLable {
    
    long serialVersionUID = 7499789136617115596L;
    
    String XML_MAP_TAG = "ConnectionMap";
    String XML_TAG = "Connection";

    /**
     * Gets the original charset name.<br>
     * The default value is null, do not convert the object of ResultSet.
     */
    String getOriginalCharsetName();

    /**
     * Sets the original charset name.<br>
     * The default value is null, do not convert the object of ResultSet.
     */
    void setOriginalCharsetName(String originalCharsetName);

    /**
     * Gets the new charset name.<br>
     * The default value is null, using the default charset to convert the object of ResultSet.
     */
    String getNewCharsetName();

    /**
     * Sets the new charset name.<br>
     * The default value is null, using the default charset to convert the object of ResultSet.
     */
    void setNewCharsetName(String newCharsetName);

    /**
     * 测试连接
     *
     * @throws Exception 异常
     */
    void testConnection() throws Exception;

    /**
     * 创建连接
     *
     * @return 返回连接
     * @throws Exception 异常
     */
    java.sql.Connection createConnection() throws Exception;

    /**
     * 连接成功或失败时给出的信息
     *
     * @return 信息
     */
    String connectMessage(boolean status);

    /**
     * 将连接名添加到列表中
     *
     * @param list           列表
     * @param connectionName 连接名
     * @param acceptTypes    满足的条件
     */
    void addConnection(List<String> list, String connectionName, Class<? extends com.fr.data.impl.Connection>[] acceptTypes);


    /**
     * 判断当前连接是否为同一个数据库的依据.
     * 用于检测lic中限制的数据连接数, 同一个url的数据库允许建立多个连接.
     *
     * @return 数据连接属于同一个数据库的依据
     */
    String feature();

    /**
     * 获取数据连接的摘要信息
     * @return 摘要
     */
    String[] summary(String... args);

    JSONObject toJSONObject() throws JSONException;

    boolean hasSchema();

    boolean equals(Object ob);

    /**
     * 创建者信息
     * @param creator 创建者
     */
    void setCreator(String creator);

    String getCreator();
}