x7.repository.Repository Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of x7-repository Show documentation
http://x7.xream.io
There is a newer version: 2.2.7.RELEASE
/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package x7.repository;

import x7.core.bean.Criteria;
import x7.core.bean.condition.InCondition;
import x7.core.bean.condition.ReduceCondition;
import x7.core.bean.condition.RefreshCondition;
import x7.core.web.Direction;
import x7.core.web.Page;

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


/**
 * 
 * X7 Persistence Interface

 * @author Sim
 *
 */
public interface Repository {


	int IN_MAX = 500;
	/**
	 * 更新缓存
	 * @param clz
	 */
	 void refreshCache(Class clz);

	/**
	 * 创建
	 * @param obj
	 * @return
	 */
	long create(Object obj);

	/**
	 * 更新, 支持局部更新
	 * @param obj
	 */
	boolean refresh(Object obj);
	
	/**
	 * 带条件支持局部更新
	 * @param refreshCondition
	 * @return true | false
	 */
	 boolean refresh(RefreshCondition refreshCondition);

	/**
	 * 删除
	 * @param obj
	 */
	boolean remove(Object obj);

	
	/**
	 * 根据主键查出单条
	 * @param clz
	 * @param idOne
	 * @return
	 */
	 T get(Class clz, long idOne);


	/**
	 * 根据对象内容查询

	 * 
	 * @param conditionObj
	 * 
	 */
	 List list(Object conditionObj);
	
	/**
	 * 
	 * @param conditionObj
	 * @return T
	 */
	 T getOne(T conditionObj);
	/**
	 * 根据对象查一条记录
	 * @param conditionObj
	 * @param orderBy
	 * @param sc "DESC", "ASC"
	 * @return
	 */
	 T getOne(T conditionObj, String orderBy, Direction sc);

	/**
	 * 根据对象内容查询

	 *
	 *            可以拼接的条件
	 *  @param criteria
	 */
	 Page find(Criteria criteria);

	/**
	 * loadAll
	 * @param clz
	 * 
	 */
	 List list(Class clz);
	
	/**
	 * 支持单一的指定property的in查询, 包括主键
	 * @param inCondition
	 */
	 List in(InCondition inCondition);

	
	/**
	 * 条件查询累计
	 * 
	 */
	Object reduce(ReduceCondition reduceCondition);

	
	/**
	 * 连表查询，标准化拼接
	 * 尽量避免在互联网业务系统中使用

	 * 不支持缓存

	 * @param resultMapped
	 * 
	 */
	Page> find(Criteria.ResultMappedCriteria resultMapped);
	
	/**
	 * 
	 * 不要通过WEB传来的参数调用此接口, 因为没有分页限制
	 * @param resultMapped
	 * 
	 */
	List> list(Criteria.ResultMappedCriteria resultMapped);

	 List list(Criteria criteria);

	boolean createBatch(List objList);
}