SAP接口编程之 NCo3.0之RfcDestination(转)

Posted 阿文

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了SAP接口编程之 NCo3.0之RfcDestination(转)相关的知识,希望对你有一定的参考价值。

转载地址:http://www.jianshu.com/p/5a5b4de5e1f1

http://www.jianshu.com/u/fd37d4449963

 

进入新的系列:.net connector 3.0,简称Nco3.0。Nco3.0是SAP针对.net平台提供的编程接口,由nco1.0/nco2.0演变而来。如果使用.net平台编程,推荐使用nco3.0,3.0和之前1.0/2.0比较,不管是API还是架构,都重新设计过,也借鉴了Jco3.0的设计,所以相对来说比较成熟,给程序员提供更好的控制和方便性。

Nco3.0的优点

  • 更加稳定、健壮、安全。关于安全,后面会有相关介绍。
  • 重新设计SAP连接的处理方法:nco3.0程序员不需要自己去管理与SAP的连接(Connection),不需要打开连接、关闭连接、对象销毁。所有这一切由.net connectior 3.0来管理。
  • 增强对大交易数据(不是big data,是mass transactions或heavy load scenario)处理的能力
  • 减少内存耗用
  • 不绑定Visual Studio版本

.net connector 3.0下载和安装

下载地址: https://service.sap.com/connectors。 安装比较简单,其实就是解压,释放几个文件。我们在程序中主要使用sapnco.dll和sapnco_utils.dll这两个动态链接库。WIN7安装(32位),默认的路径是: C:\Program Files (x86)\SAP\SAP_DotNetConnector3。

项目环境准备

1、项目添加引用:添加对sapnco.dll和sapnco_utils.dll的引用。

技术分享
nco3-1-1.jpg

2、NCO3.0的namespace: nco3.0的namesapce只有一个:SAPP.Middleware.Connector,要在class中导入这个namespace

using SAP.Middleware.Connector;

RfcDestination

RfcDestination代表后端SAP系统。之前SAP的接口技术对SAP系统一般使用Connection对象连接后端系统,nco3.0设计的一个重大改变就是程序员不用再关心SAP的连接,名称也体现了这一点,现在叫Destination了。 RfcDestination对象的创建需要用RfcDestinationManager类的GetDestination方法,以保证只有一个Destination(单例模式)和安全:

// 方法一 
public static RfcDestination GetDestination(RfcConfigParameters parameters);

// 方法二 
public static RfcDestination GetDestination(string destinationName);

方法1使用RfcConfigParameters作为参数,这个参数包含必要的logon parameters。
方法2使用一个字符串作为参数。必须定义一个类,实现IDestinationConfiguration接口,并实现IDestinationConfiguration接口的GetParameters()方法。在GetParameters方法中定义destinationName,RfcDestinationManager.GetDestination方法会自动调用GetParameters方法,获取其中的logon parameters。程序员可以在GetParameters方法中通过文件、UI界面多种方法填充logon parameters,从而赋予程序员较大的自由度,.net connector则保证连接的安全性。

示例一

文件:RfcDestinationDemo.cs

using SAP.Middleware.Connector;

namespace Nco01
{
    public class RfcDestinationDemo
    {
        private RfcConfigParameters GetConfigParams()
        {
            RfcConfigParameters configParams = new RfcConfigParameters();

            // Name property is neccessary, otherwise, NonInvalidParameterException will be thrown
            configParams.Add(RfcConfigParameters.Name, "ECC"); 
            configParams.Add(RfcConfigParameters.AppServerHost, "192.168.65.100");
            configParams.Add(RfcConfigParameters.SystemNumber, "00"); // instance number
            configParams.Add(RfcConfigParameters.SystemID, "D01");

            configParams.Add(RfcConfigParameters.User, "STONE");
            configParams.Add(RfcConfigParameters.Password, "xxx");
            configParams.Add(RfcConfigParameters.Client, "001");
            configParams.Add(RfcConfigParameters.Language, "EN");
            configParams.Add(RfcConfigParameters.PoolSize, "5");
            configParams.Add(RfcConfigParameters.MaxPoolSize, "10");
            configParams.Add(RfcConfigParameters.IdleTimeout, "30");

            return configParams;
        }

        public RfcDestination GetDestination()
        {
            RfcConfigParameters configParams = this.GetConfigParams();
            RfcDestination dest = RfcDestinationManager.GetDestination(configParams);

            return dest;
        }

        public void PingDestination()
        {
            RfcDestination destination = this.GetDestination();
            destination.Ping();
        }
    }
}

  

单元测试:

using System;
using Microsoft.VisualStudio.TestTools.UnitTesting;
using Nco01;

namespace UnitTestProject1
{
    [TestClass]
    public class TestRfcDestinationDemo
    {
        [TestMethod]
        public void TestPing()
        {
            RfcDestinationDemo rfc = new RfcDestinationDemo();
            rfc.PingDestination();
        }
    }
}

示例2

定义一个类,实现IDestinationConfiguration接口,起始代码如下:
DestinationConfig.cs

using System;
using SAP.Middleware.Connector;

namespace Nco01
{
    class DestinationConfig : IDestinationConfiguration
    {
        public bool ChangeEventsSupported()
        {
            throw new NotImplementedException();
        }

        public event RfcDestinationManager.ConfigurationChangeHandler ConfigurationChanged;

        public RfcConfigParameters GetParameters(string destinationName)
        {
            throw new NotImplementedException();
        }
    }
}

  

将代码改写成下面这个样子,填充destinationName为ECC的logon parameters。

using System;
using SAP.Middleware.Connector;

namespace Nco01
{
    class DestinationConfig : IDestinationConfiguration
    {
        public bool ChangeEventsSupported()
        {
            return false; // 不支持ChangeEvent
        }

        public event RfcDestinationManager.ConfigurationChangeHandler ConfigurationChanged;

        public RfcConfigParameters GetParameters(string destinationName)
        {
            // get logon parameteres according to destinationName
            // the following is logon paramters for ‘ECC‘
            if ("ECC".Equals(destinationName)) {
                RfcConfigParameters configParams = new RfcConfigParameters();
                configParams.Add(RfcConfigParameters.AppServerHost, "192.168.65.100");
                configParams.Add(RfcConfigParameters.SystemNumber, "00"); // instance number
                configParams.Add(RfcConfigParameters.SystemID, "D01");

                configParams.Add(RfcConfigParameters.User, "STONE");
                configParams.Add(RfcConfigParameters.Password, "xxx");
                configParams.Add(RfcConfigParameters.Client, "001");
                configParams.Add(RfcConfigParameters.Language, "EN");
                configParams.Add(RfcConfigParameters.PoolSize, "5");
                configParams.Add(RfcConfigParameters.MaxPoolSize, "10");
                configParams.Add(RfcConfigParameters.IdleTimeout, "30");

                return configParams;
            }
            else {
                return null;
            }
        }
    }
}

  

连接模块代码:
RfcDestinationUsingConfig.cs

using SAP.Middleware.Connector;

namespace Nco01
{
    public class RfcDestUsingConfig
    {
        private RfcDestination destination;

        // initialize in constructor
        public RfcDestUsingConfig()
        {
            DestinationConfig destConfig = new DestinationConfig();
            RfcDestinationManager.RegisterDestinationConfiguration(destConfig);
            destination = RfcDestinationManager.GetDestination("ECC");
        }

        public RfcDestination GetConnection()
        {
            return destination;
        }

        public void PingDestination()
        {
            destination.Ping();
        }
    }
}

  

在构造器中初始化RfcDestination,搞得这么复杂,主要就是安全原因。根据ECC这个destinationName,自动调用DestinationConfig类的GetParameters方法,获取logon parameters进行注册,然后进行管理。程序员呢,只需要关心destination就行。

单元测试:

using System;
using Microsoft.VisualStudio.TestTools.UnitTesting;
using Nco01;

namespace UnitTestProject1
{
    [TestClass]
    public class TestRfcDestinationDemo
    {
        [TestMethod]
        public void TestPing()
        {
            RfcDestinationDemo rfc = new RfcDestinationDemo();
            rfc.PingDestination();
        }
    }
}

以上是关于SAP接口编程之 NCo3.0之RfcDestination(转)的主要内容,如果未能解决你的问题,请参考以下文章

数据交换中间件之SAP接口集成平台

sap接口开发前需要搭建结构吗

PowerScript语法参考手册之数据类型

OC编程之道-接口适配之适配器

C#编程利器之三:接口(Interface)

PHP契约Contracts之面向接口编程