ars.database.service.ImportService Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of ars-database Show documentation

Ars framework database

There is a newer version: 2.0.0

package ars.database.service;

import java.util.Map;

import ars.util.Nfile;
import ars.invoke.local.Api;
import ars.invoke.local.Param;
import ars.invoke.request.Requester;
import ars.database.service.Service;

/**
 * 数据导入业务接口
 * 
 * @author yongqiangwu
 * 
 * @param 
 *            数据模型
 */
public interface ImportService extends Service {
	/**
	 * 数据导入结果类
	 * 
	 * @author yongqiangwu
	 * 
	 */
	class Result {
		private int total; // 总数目
		private int failed; // 失败数目
		private String file; // 文件名称
		private String size; // 文件大小
		private String spend; // 操作耗时

		public int getTotal() {
			return total;
		}

		public void setTotal(int total) {
			this.total = total;
		}

		public int getFailed() {
			return failed;
		}

		public void setFailed(int failed) {
			this.failed = failed;
		}

		public String getFile() {
			return file;
		}

		public void setFile(String file) {
			this.file = file;
		}

		public String getSize() {
			return size;
		}

		public void setSize(String size) {
			this.size = size;
		}

		public String getSpend() {
			return spend;
		}

		public void setSpend(String spend) {
			this.spend = spend;
		}

	}

	/**
	 * 数据批量导入
	 * 
	 * @param requester
	 *            请求对象
	 * @param file
	 *            导入文件对象
	 * @param start
	 *            开始数据行下标（从0开始）
	 * @param parameters
	 *            请求参数
	 * @return 导入结果对象
	 * @throws Exception 操作异常
	 */
	@Api("import")
	public Result import_(Requester requester, @Param(name = "file", required = true) Nfile file,
			@Param(name = "start", required = true, regex = "^[0-9]+$") Integer start, Map parameters)
			throws Exception;

	/**
	 * 下载批量导入失败文件
	 * 
	 * @param requester
	 *            请求对象
	 * @param name
	 *            文件名称
	 * @param parameters
	 *            请求参数
	 * @return 文件对象
	 */
	@Api("file")
	public Nfile file(Requester requester, @Param(name = "name", required = true) String name,
			Map parameters);
}