com.tsc9526.monalisa.orm.resources.HelpDoc Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of monalisa-orm Show documentation

Very simple database ORM

There is a newer version: 2.2.0

/*******************************************************************************************
 *	Copyright (c) 2016, zzg.zhou([email protected])
 * 
 *  Monalisa is free software: you can redistribute it and/or modify
 *	it under the terms of the GNU Lesser General Public License as published by
 *	the Free Software Foundation, either version 3 of the License, or
 *	(at your option) any later version.

 *	This program is distributed in the hope that it will be useful,
 *	but WITHOUT ANY WARRANTY; without even the implied warranty of
 *	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *	GNU Lesser General Public License for more details.

 *	You should have received a copy of the GNU Lesser General Public License
 *	along with this program.  If not, see .
 *******************************************************************************************/
package com.tsc9526.monalisa.orm.resources;

import com.tsc9526.monalisa.orm.criteria.Example;

/**
 * Only for java doc @see
 *   
 * @author zzg.zhou([email protected])
 */
public interface HelpDoc {
	/**
	 * @param limit 
	 *   The max number of records for this query
	 *    
	 * @param offset  
	 *   Base 0, the first record is 0
	 * 
	 * @param example  
	 *   Use new Model.Example(); 

	 *    
	 * @param whereStatement SQL segment, for example:

	 *   
	 *   1. WHERE col_1=? AND col_2=? ORDER BY 1

	 *   2. col_1=? and col_2=? ORDER BY 1

	 *   3. null

	 *   4. ""  

	 *   5. "ORDER BY ..." 

	 *   6. ", table2 b WHERE a.id=b.id ..." 

	 *   7. "LEFT JOIN table2 b ON a.id=b.id "

	 *   
	 *   
	 * @param args 

	 *   Padding the corresponding ? in whereStatement
	 * 
	 * @return 
	 *   When insert/update/delete, indicate the number of affected rows

     * 
	 */
	public int helpQuery(int limit,int offset,Example example,String whereStatement,Object ... args);
 	 
}