package xdata.dao;

import java.util.Properties;
/**
* <p>XJDBCDataLink - XData 数据访问架构，数据连接</p>
*
* <p>XDataLink用于连接具体的数据库，不应该直接创建XDataLink的实例，而应该使用
* <code>XDataLinkFactory</code>的工厂方法来创建不同数据访问架构的具体实例。</p>
*
* <p>XDataLink设计成为抽象连接器，所有参数均使用key=value形式的字符串方式传递，
* 以保证在各种数据访问架构中都具有统一的格式。基于这样的考虑，JDBC的XDataLink
* 实现使用这样的连接参数：</p>
*
* <pre>
* driver=sun.jdbc.odbc.JdbcOdbcDriver
* url=jdbc:odbc:SampleDatabase
* username=your_username
* password=your_password
* <pre>
*
* <p>对于JDBC类型的连接，除上述必须的四个属性外，可以无限制的追加扩展属性，
* 只要系统允许，例如：</p>
* <pre>
* driver=sun.jdbc.odbc.JdbcOdbcDriver
* url=jdbc:odbc:SampleDatabase
* username=your_username
* password=your_password
* readonly=false
* port=2508
* </pre>
*
* <p>对于绑定到JNDI的JDBC数据连接，XData使用独立的JNDI实现方式，请参考
* XJNDIDataLink</p>
*
* @author JoJo
* @version 1.0
*/
public interface IXDataLink {
/**
* 关闭数据连接<br>
* 在使用完数据库后必须关闭连接，以释放资源
*/
public void closeLink();

/**
* 获取数据访问器接口<br>
* 数据访问器接口能够执行查询和DDL命令
* @return IXDataAccessor
*/
public IXDataAccessor getAccessor();

/**
* 获取连接属性
* @return Properties
*/
public Properties getLinkProperties();

/**
* 测试数据连接是否已经关闭
* @return boolean
*/
public boolean isClosed();

/**
* 测试数据连接是否已经打开
* @return boolean
*/
public boolean isOpened();

/**
* 打开数据连接<br>
* 在使用数据库之前必须打开连接，以获取资源
* @return boolean
*/
public boolean openLink();

/**
* 设置连接属性<br>
* 注意：必须保证连接属性有效（即不能为null）
* @param linkProperties Properties
*/
public void setLinkProperties(Properties linkProperties);
}