SAP接口编程之NCo3.0系列(03) : Meta data和Container

对上一篇博文中代码所涉及要点进行讲解。我们知道，SAP 函数的参数，从参数的方向来说，包括 importing / exporting / changing，从参数本身的数据结构来说，包括单值型 / 结构型 / 表类型。我们从两个角度来看 SAP NCo3.0 函数数据结构的设计。第一个角度: Container和 Element，函数、结构、表、ABAP 对象都是 container，Container 是能包含其他对象对对象，比如函数有参数，结构中有字段。容易理解。如果对象不包含其他对象，则是一个 element。

第二个角度：每一个对象都有meta data (元数据）。比如对于字段来说，其元数据包括数据类型、长度等。SAP将 meta data 设计为抽象类，其他对象设计为接口，如下图所示。

IRfcFunction 接口

IRfcFunction 继承自 IRfcDataContainer，实现了 IEnumerable 接口。常用的方法如下：

• GetTable(string tableName): 根据table参数名，获取Table参数, 方法来自父类 IRfcDataContainer
• GetStructure(string paramName): 根据参数名，获取structure参数, 方法来自父类IRfcDataContainer
• GetElementMetaData(int index): 根据索引获取元数据的值
• SetValue(string paramName, int/string value): 对参数赋值，可以设置的值有多种数据类型，因此有多个重载的版本。

获取 SAP 函数的参数

函数的参数属于 meta data，所以可以通过 GetElementMetaData() 方法获取。下面的代码演示了基本用法：

public void ListFunctionParameters(String fmName)
{
    RfcDestination dest = DestinationProvider.GetDestination();
    IRfcFunction fm = dest.Repository.CreateFunction(fmName);

    for (int i = 0; i < fm.ElementCount; i++) {
        RfcElementMetadata elementMeta = fm.GetElementMetadata(i);
        if (elementMeta.GetType() == typeof(RfcParameterMetadata)) {
            RfcParameterMetadata param = (RfcParameterMetadata)elementMeta;
            System.Console.WriteLine("Name: " + param.Name);
            System.Console.WriteLine("Data type: " + param.DataType);
            System.Console.WriteLine("UcLength: " + param.UcLength);
            System.Console.WriteLine("NucLength: " + param.NucLength);                    
            System.Console.WriteLine("Documentation: " + param.Documentation);
            System.Console.WriteLine("--------------------------");
        }
    }            
}

单元测试：

[TestMethod]
public void Test_ListFunctionParameters()
{
    RfcCall rfc = new RfcCall();
    rfc.ListFunctionParameters("RFC_READ_TABLE");
}

RfcFunctionMetaData 类

前面我们从 Repository 直接创建函数，另外一种方法是通过 RfcFunctionMetaData 类来创建函数对象，代码如下：

public ArrayList GetCocdInfo2(String cocd)
{
    var list = new ArrayList(); // return value
             
    RfcDestination dest = DestinationProvider.GetDestination();
    RfcFunctionMetadata fmMeta = dest.Repository.GetFunctionMetadata("BAPI_COMPANYCODE_GETDETAIL");
    IRfcFunction fm = fmMeta.CreateFunction();

    fm.SetValue("COMPANYCODEID", cocd);
    fm.Invoke(dest);

    IRfcStructure cocdDetail = fm.GetStructure("COMPANYCODE_DETAIL");
    list = Utils.ToArrayList(cocdDetail);

    return list;    
}