com.litongjava.db.activerecord.Model Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of java-db Show documentation
Java Database
There is a newer version: 1.4.7
package com.litongjava.db.activerecord;


import static com.litongjava.db.activerecord.DbKit.NULL_PARA_ARRAY;

import java.io.Serializable;
import java.math.BigDecimal;
import java.math.BigInteger;
import java.sql.Connection;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
import java.sql.Statement;
import java.time.LocalDateTime;
import java.util.ArrayList;
import java.util.Iterator;
import java.util.List;
import java.util.Map;
import java.util.Map.Entry;
import java.util.Set;
import java.util.function.Function;

import com.jfinal.kit.TypeKit;
import com.litongjava.cache.ICache;
import com.litongjava.db.SqlPara;
import com.litongjava.model.db.IRow;
import com.litongjava.model.page.Page;

/**
 * Model.
 * 
 * A clever person solves a problem.
 * A wise person avoids it
 * A stupid person makes it.
 */
@SuppressWarnings({"rawtypes", "unchecked"})
public abstract class Model implements IRow, Serializable {

	private static final long serialVersionUID = -990334519496260591L;

	public static final int FILTER_BY_SAVE = 0;
	public static final int FILTER_BY_UPDATE = 1;

	String configName;

	/**
	 * Flag of column has been modified. update need this flag
	 */
	Set modifyFlag;

	/**
	 * Attributes of this model
	 */
	private Map attrs = createAttrsMap();	// getConfig().containerFactory.getAttrsMap();	// new HashMap();

	private Map createAttrsMap() {
		Config config = _getConfig();
		if (config == null) {
			return DbKit.brokenConfig.containerFactory.getAttrsMap();
		}
		return config.containerFactory.getAttrsMap();
	}

	/**
	 * 将本 model 对象转化为线程安全的 dao 对象.
	 *
	 * 为保障线程安全，转化为线程安全的 dao 对象，只能调用线程安全方法，
	 * 也即只能调用其 find 系列、paginate 系列、deleteBy 系列方法，
	 * 不能再调用其 set 系列以及 get 系列方法，更不能再调用其 save()、
	 * update()、delete() 等方法，否则会抛出异常进行防护
	 *
	 * 
	 * 强烈建议通过 static 修饰过的 dao 对象都要调用一次 dao() 方法，
	 * 以免新手误用造成线程安全问题，示例如下：
	 *
	 * public class UserService {
	 *
	 * 	private static User dao = new User().dao();
	 *
	 * 	public User getUserById(long userId) {
	 * 		return dao.findFirst("select * from `user` where id = ? limit 1", userId);
	 * 	}
	 * }
	 * 
	 */
	public M dao() {
		attrs = DaoContainerFactory.daoMap;
		modifyFlag = DaoContainerFactory.daoSet;
		return (M)this;
	}

	/**
	 * filter () 方法将被 save()、update() 两个方法回调，
	 * 子类可通过覆盖此方法，实现类似于过滤 XSS 攻击脚本的功能
	 *
	 * @param filterBy 0 表示当前正被 save() 调用, 1 表示当前正被 update() 调用
	 */
	protected void filter(int filterBy) {

	}

	/**
	 * Return attribute Map.
	 * 
	 * Danger! The update method will ignore the attribute if you change it directly.
	 * You must use set method to change attribute that update method can handle it.
	 */
	protected Map _getAttrs() {
		return attrs;
	}

	public Map getAttrs() {
		return attrs;
	}

	/**
	 * Return attribute Set.
	 */
	public Set> _getAttrsEntrySet() {
		return attrs.entrySet();
	}

	/**
	 * Return attribute names of this model.
	 */
	public String[] _getAttrNames() {
		Set attrNameSet = attrs.keySet();
		return attrNameSet.toArray(new String[attrNameSet.size()]);
	}

	/**
	 * Return attribute values of this model.
	 */
	public Object[] _getAttrValues() {
		java.util.Collection