com.aliyun.dc.opplat.sdk.api.internal.mapping.Reader Maven / Gradle / Ivy

Go to download
package com.aliyun.dc.opplat.sdk.api.internal.mapping;

import java.util.List;

import com.aliyun.dc.opplat.sdk.api.exception.OpplatApiException;

/**
 * 格式转换器。
 *
 * @author carver.gu
 * @since 1.0, Apr 11, 2010
 */
public interface Reader {

    /**
     * 判断返回结果是否包含指定的属性。
     *
     * @param name 属性名称
     * @return true/false
     */
    boolean hasReturnField(Object name);

    /**
     * 读取单个基本对象。
     *
     * @param name 映射名称
     * @return 基本对象值
     */
    Object getPrimitiveObject(Object name);

    /**
     * 读取单个自定义对象。
     *
     * @param name 映射名称
     * @param type 映射类型
     * @return 映射类型的实例
     * @throws OpplatApiException
     */
    Object getObject(Object name, Class type) throws OpplatApiException;

    /**
     * 读取多个对象的值。
     *
     * @param listName 列表名称
     * @param itemName 映射名称
     * @return 嵌套映射类型实例列表
     */
    List getListObjects(Object listName, Object itemName) ;

    /**
     * 读取多个对象的值。
     *
     * @param listName 列表名称
     * @param itemName 映射名称
     * @param subType  嵌套映射类型
     * @return 嵌套映射类型实例列表
     * @throws OpplatApiException
     */
    List getListObjects(Object listName, Object itemName, Class subType) throws OpplatApiException;

}