All Downloads are FREE. Search and download functionalities are using the official Maven repository.
Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $
You can buy this project and download/modify it how often you want.
io.vertx.ext.sql.assist.SQLStatement Maven / Gradle / Ivy
package io.vertx.ext.sql.assist;
import java.lang.reflect.Constructor;
import java.util.List;
import io.vertx.core.json.JsonArray;
import io.vertx.ext.sql.assist.sql.MySQLStatementSQL;
/**
* SQL执行语句
*
* @author Mirren
*
*/
public interface SQLStatement {
/** SQLStatement的使用哪个类的key */
final static String PROVIDER_CLASS_KEY = "VQA_SQL_STATEMENT_PROVIDER_CLASS_NAME";
/**
* 设置SQL语句使用哪个类实现
*
* @param statementImplClass
*/
static void register(Class statementImplClass) {
System.setProperty(PROVIDER_CLASS_KEY, statementImplClass.getName());
}
/**
* 设置SQL语句使用哪个类实现
*
* @param className
*/
static void register(String className) {
System.setProperty(PROVIDER_CLASS_KEY, className);
}
/**
* 创建实例,默认使用MySQL规范实现,如果使用其他数据库可以使用{@link #register(Class) }注册或者使用{@link #create(Class, Class)}方法
*
* @param entityClass
* 实体类,类必须包含{@link Table} {@link TableId} {@link TableColumn}注解
* @return
*/
static SQLStatement create(Class entityClass) {
String className = System.getProperty(PROVIDER_CLASS_KEY);
if (className == null) {
return new MySQLStatementSQL(entityClass);
}
try {
Class forClass = Class.forName(className);
Constructor constructor = forClass.getConstructor(Class.class);
return (SQLStatement) constructor.newInstance(entityClass);
} catch (Exception e) {
throw new RuntimeException(e);
}
}
/**
* 创建实例
*
* @param entityClass
* 实体类,类必须包含{@link Table} {@link TableId} {@link TableColumn}注解
* @param statementClass
* 实现了{@link SQLStatement}的类
* @return
*/
static SQLStatement create(Class entityClass, Class statementClass) {
try {
Constructor constructor = statementClass.getConstructor(Class.class);
return (SQLStatement) constructor.newInstance(entityClass);
} catch (Exception e) {
throw new RuntimeException(e);
}
}
/**
* 获得数据总行数SQL语句
* @param primaryValue
* 主键的值
* @param resultColumns
* 指定返回列 格式 [table.]列名 [as 类的属性名字],...
* @param joinOrReference
* 多表查询或表连接的语句,示例 as t inner join table2 as t2 on t.id=t2.id
* @return
*/
SqlAndParams selectByIdSQL(S primaryValue, String resultColumns, String joinOrReference);
/**
* 将对象属性不为null的属性作为条件查询出数据
*
* @param obj
* 对象
* @param resultColumns
* 自定义返回列
* @param joinOrReference
* 多表查询或表连接的语句,示例 as t inner join table2 as t2 on t.id=t2.id
* @param single
* 是否支取一条数据true支取一条,false取全部
* @return 返回sql 或 sql与params
*
*/
SqlAndParams selectByObjSQL(T obj, String resultColumns, String joinOrReference, boolean single);
/**
* 插入一个对象包括属性值为null的值 SqlAndParams insertAllSQL(T obj);
/**
* 插入一个对象,只插入对象中值不为null的属性 SqlAndParams insertNonEmptySQL(T obj);
/**
* 批量添加全部所有字段
*
* @param list
* 对象
*/
SqlAndParams insertBatchSQL(List list);
/**
* 批量添加自定字段
*
* @param column
* 字段的名称示例:["id","name",...]
* @param params
* 字段对应的参数示例:[["id","name"],["id","name"]...]
*/
SqlAndParams insertBatchSQL(List columns, List params);
/**
* 插入一个对象,如果该对象不存在就新建如果该对象已经存在就更新
*
* @param obj
* 对象
* @return 返回:sql 或 sql与params
*/
SqlAndParams replaceSQL(T obj);
/**
* 更新一个对象中所有的属性包括null值,条件为对象中的主键值
*
* @param obj
* @return 返回:sql or sql与params, 如果对象中的id为null将会返回SQL:"there is no primary key
* in your SQL statement"
*/
SqlAndParams updateAllByIdSQL(T obj);
/**
* 更新一个对象中所有的属性包括null值,条件为SqlAssist条件集 SqlAndParams updateAllByAssistSQL(T obj, SqlAssist assist);
/**
* 更新一个对象中属性不为null值,条件为对象中的主键值
*
* @param obj
* 对象
* @return 返回:sql or sql与params , 如果id为null或者没有要更新的数据将返回SQL:"there is no
* primary key in your SQL statement"
*/
SqlAndParams updateNonEmptyByIdSQL(T obj);
/**
* 将对象中属性值不为null的进行更新,条件为SqlAssist条件集
*
* @param obj
* 对象
* @param assist
* 查询工具
* @return 返回:sql or sql与params , 如果assist为null将会返回sql:"SqlAssist or
* SqlAssist.condition is null"
*/
SqlAndParams updateNonEmptyByAssistSQL(T obj, SqlAssist assist);
/**
* 通过id将指定列设置为null
*
* @param
* @param primaryValue
* id
* @param columns
* 要设置为空的列
* @return
*/
SqlAndParams updateSetNullByIdSQL(S primaryValue, List columns);
/**
*
* 将指定的列设置为空,条件为SqlAssist条件集
*
* @param assist
* 查询工具
* @param columns
* 要设置为空的列
* @return 返回:sql or sql与params , 如果assist为null将会返回sql:"SqlAssist or
* SqlAssist.condition is null"
* @return
*/
SqlAndParams updateSetNullByAssistSQL(SqlAssist assist, List columns);
/**
* 通过主键值删除对应的数据行
*
* @param primaryValue
* id值
* @return 返回:sql or sql与params , 如果id为null或者没有要更新的数据将返回SQL:"there is no
* primary key in your SQL statement"
*/
SqlAndParams deleteByIdSQL(S primaryValue);
/**
* 通过SqlAssist条件集删除对应的数据行
*
* @param assist
* 查询工具
* @return 返回:sql or sql与params , 如果assist为null将会返回sql: "SqlAssist or
* SqlAssist.condition is null"
*/
SqlAndParams deleteByAssistSQL(SqlAssist assist);
}
