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

对上一篇文中涉及的重要对象进行讲解。我们知道，SAP函数的参数，从方向来说，包括import/export/changing，从数据结构来说，包括单值型/结构型/表参数。NCo3.0对SAP函数相关对象的设计，也是这样的。我们从两个角度来看。第一个角度: Container和Element，函数、结构、表、ABAP对象是container，Container能包含其他对象，比如函数有参数，结构有字段。比较容易理解。如果对象不包含其他对象，就是一个element。

nco3-3-1.jpg

第二个角度：每一个对象都有meta data(元数据）。比如字段，元数据包括数据类型、长度等。SAP对meta data，设计为抽象类，对对象设计为接口。

nco3-3-2.jpg

IRfcFunction

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

• GetTable(string tableName): 根据table参数名，获取Table参数, 方法来自父类IRfcDataContainer

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

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;    
}