package mf.code.summary.service;

import java.util.List;
import java.util.Map;

/**
 * Created by ldz on 2018年03月02日. 14:34
 * <p>
 * 使用方法:
 * 1.注入 SqlServiceImpl .
 *
 * @author ldz
 * " @Service("sqlService") " 注意:推荐使用构造方式注入.
 * " private SqlServiceImpl sqlService; "
 * 2.拼装条件Map
 * 3.调用
 */
public interface SqlService {

 /**
 * 统计:获取sum结果.在Mapper的查询配置中,需要配置:( resultType="java.lang.Long" )
 *
 * @param sqlId slq语句的id.如:UserMapper.sum
 * UserMapper:UserMapper.xml文件中namespace属性.
 * sum:语句id
 * @param parameter Map类型参数
 * @return sum结果.Long类型
 */
 Long sum(String sqlId, Map parameter);

 /**
 * 统计:获取sum结果.在Mapper的查询配置中,需要配置:( resultType="java.lang.Long" )
 *
 * @param sqlId slq语句的id.如:UserMapper.sum
 * UserMapper:UserMapper.xml文件中namespace属性.
 * sum:语句id
 * @param parameter Map类型参数
 * @return sum结果.
 */
 int sumInt(String sqlId, Map parameter);

 /**
 * 计数:获取count结果.在Mapper的查询配置中,需要配置:( resultType="java.lang.Long" )
 *
 * @param sqlId slq语句的id.如:UserMapper.sum
 * UserMapper:UserMapper.xml文件中namespace属性.
 * sum:语句id
 * @param parameter Map类型参数
 * @return count结果.Long类型
 */
 Long count(String sqlId, Map parameter);

 /**
 * 计数:获取count结果.在Mapper的查询配置中,需要配置:( resultType="java.lang.Long" )
 *
 * @param sqlId slq语句的id.如:UserMapper.sum
 * UserMapper:UserMapper.xml文件中namespace属性.
 * sum:语句id
 * @param parameter Map类型参数
 * @return count结果.
 */
 int countInt(String sqlId, Map parameter);

 /**
 * 获取一个列表. 如果需要分页,需要借助 ( PageHelper )插件.
 *
 * @param sqlId slq语句的id.如:UserMapper.sum
 * UserMapper:UserMapper.xml文件中namespace属性.
 * sum:语句id
 * @param parameter Map类型参数
 * @return List
 */
 List<Map> getList(String sqlId, Map parameter);

 /**
 * 获取一个对象
 *
 * @param sqlId slq语句的id.如:UserMapper.sum
 * UserMapper:UserMapper.xml文件中namespace属性.
 * sum:语句id
 * @param parameter Map类型参数
 * @return Map
 */
 Map getOne(String sqlId, Map parameter);

 /**
 * 例: update `user` set error_count=error_count+1 where user_id=#{id}
 * 以上需求,生成的update语句不能满足.
 *
 * @param sqlId slq语句的id.如:UserMapper.sum
 * UserMapper:UserMapper.xml文件中namespace属性.
 * sum:语句id
 * @param parameter Map类型参数
 * @return int 执行结果
 */
 int update(String sqlId, Map parameter);
}