6. 附录

6.1 常用API

6.1.1 Result

API	说明
Result(boolean success)	构造结果对象（设置成功标志）
Result data(Object data)	构造结果对象（添加返回数据）
Result error(int error)	构造结果对象（添加错误代码）
boolean isSuccess()	获取成功标记
void setSuccess(boolean success)	设置成功标志
int getError()	获取错误代码
void setError(int error)	设置错误代码
Object getData()	获取返回数据
void setData(Object data)	设置返回数据

示例1：返回删除操作的结果

public Result delete(long id) {
     boolean success = productService.deleteProduct(id);
     return new Result(success);
}

示例2：生成成功标记的对象，设置返回数据“abc”

Result result = new Result(true).data(“abc”);

示例3：生成成功标记的对象，设置返回数据“abc”，并设置错误代码 1

Result result = new Result(true).data(“abc”).error(1);

6.1.2 Page

API	说明
Page(String path)	构造页面对象（指定显示页面，创建页面数据对象）
Page data(String key, Object value)	构造页面对象（设置页面数据）
boolean isRedirect()	判断显示页面是否为转发路径
String getPath()	获取显示页面
void setPath(String path)	设置显示页面
Map<String, Object> getData()	获取页面数据
void setData(Map<String, Object> data)	设置页面数据

示例1：获取所有产品类型数据作为页面数据，并指定显示页面为"product_create.jsp"

public Page create() {
     List<ProductType> productTypeList = productService.getProductTypeList();
     return new Page("product_create.jsp").data("productTypeList", productTypeList);
}

6.1.3 Dataset

API	说明
<T> T select( Class<T> cls, String condition, Object... params )	按条件查询单条数据，并转为实体对象
<T> List<T> selectList( Class<T> cls, String condition, String order, Object... params )	查询多条数据，并转为列表对象
boolean insert( Class<?> cls, Map<String, Object> fieldMap )	插入一条数据
boolean update( Class<?> cls, Map<String, Object> fieldMap, String condition, Object... params )	按条件更新相关数据
boolean delete( Class<?> cls, String condition, Object... params )	按条件删除相关数据
int selectCount( Class<?> cls, String condition, Object... params )	按条件查询数据条数
<T> List<T> selectListForPager( int pageNumber, int pageSize, Class<T> cls, String condition, String sort, Object... params )	按条件查询多条数据，并转为列表（分页方式）
<T> Map<Long, T> selectMap( Class<T> cls, String condition, Object... params )	按条件查询多条数据，并转为映射对象
<T> T selectColumn( Class<T> cls, String column, String condition, Object... Params )	按条件、列名查询单条数据，并转为对应的实体对象
<T> List<T> selectColumnList( Class<?> cls, String column, String condition, String sort, Object... Params )	按条件、列名查询多条数据，并转为对应的列表体对象

示例1：查询Id为1的对象

Product product = DataSet.select(Product.class, "id = ?", 1);

示例2：不限条件查询所有产品类型数据

List<ProductType> listProductType = DataSet.selectList(ProductType.class, "", "");

示例3：模糊查询name，查询数据条数

String condition = "name like ?";
Object[] params = {'%' + name + '%'};
long count = DataSet.selectCount(Product.class, condition, params);

示例4：模糊查询name，结果id 倒序排序，获取第一页前10条数据，并转化为对应的列表对象

int pageNumber= 1;
int pageSize = 10;
String condition = "name like ?";
String sort = "id desc";
Object[] params = {'%' + name + '%'};
List<Product> productList = DataSet.selectListForPager(pageNumber, pageSize, Product.class, condition, sort, params);

示例5：创建产品

Map<String, Object>  fieldMap = new HashMap<String, Object>();
fieldMap2.put("id",2);
fieldMap2.put("name","Apple");
boolean result = DataSet.insert(Product.class, fieldMap);

示例6：修改id为2的产品

Map<String, Object>  fieldMap = new HashMap<String, Object>();
fieldMap2.put("name","Pear");
boolean result = DataSet.update(Product.class, fieldMap, "id = ?", 2);

示例7：删除id为1的产品

boolean result = DataSet.delete(Product.class, "id = ?", 1);

6.1.4 DataContext

类	API	说明
DataContext	void init(HttpServletRequest request, HttpServletResponse response)	初始化
void destroy()	上下文容器销毁
DataContext getInstance()	得到上下文实例
HttpServletRequest getRequest()	获取Request对象
HttpServletResponse getResponse()	获取Response对象
HttpSession getSession()	获取Session对象
ServletContext getServletContext()	获取Servlet上下文对象
Request	void put(String key, Object value)	将数据放入 Request 中
<T> T get(String key)	从 Request 中获取数据
void remove(String key)	移除 Request 中的数据
Map<String, Object> getAll()	从 Request 中获取所有数据
Response	void put(String key, Object value)	将数据放入 Response 中
<T> T get(String key)	从 Response 中获取数据
Map<String, Object> getAll()	从 Response 中获取所有数据
Session	void put(String key, Object value)	将数据放入 Session 中
<T> T get(String key)	从 Session 中获取数据
void remove(String key)	移除 Session 中的数据
Map<String, Object> getAll()	从 Session 中获取所有数据
removeAll()	移除 Session 中所有的数据
Cookie	void put(String key, Object value)	将数据放入 Cookie 中
<T> T get(String key)	从 Cookie 中获取数据
Map<String, Object> getAll()	从 Cookie 中获取所有数据
ServletContext	void put(String key, Object value)	将数据放入 ServletContext 中
<T> T get(String key)	从 ServletContext 中获取数据
void remove(String key)	移除 ServletContext 中的数据
Map<String, Object> getAll()	从 ServletContext 中获取所有数据

注1：Request,Response,Session,Cookie,ServletContext 为DataContext的内部类

注2：DataContext为线程安全的(线程安全解析请参考“ThreadLocal 那点事儿”)

示例1：获取HTTP请求内a的值

String a =  DataContext.Request.get("a");

示例2：设置HTTP响应内a的值

DataContext.Response.put("a","123");

示例3：移除Seesion内的a

DataContext.Session.remove(“a”);

6.1.5 Multipart

API	说明
Multipart(String fileName, String contentType, long fileSize, InputStream inputStream)	构造媒体对象（参数为名称，类型，大小及字节流）
String getFileName()	获取媒体名称
String getContentType()	获取媒体类型
long getFileSize()	获取媒体大小
InputStream getInputStream()	获取媒体输入字节流