• 技术与支持
  • 技术资料
    您现在的位置:首页 >> 技术与支持 >> 技术资料

    如何使用紫金桥WebService

    2014-1-10 11:24:26 来源:原创 点击:

    1、配置紫金桥WebService


    首先运行想支持WebService功能的工程,然后在紫金桥安装目录下找到RealDbWebService.exe程序,运行它,可以看到如下图所示的运行界面。

    程序运行后上方是菜单,中间详细的列出了支持的各个函数被调用的次数,以及响应超时的次数。

    显示的信息的第一行为WebService在哪个端口提供服务,第二行为响应的询问的次数,超时的次数,以及发生严重错误的次数。这里的超时是指的和Db数据库通讯时的超时次数,严重错误是指的和Db数据库通讯时发生的严重错误次数。
    选择菜单,可以看到有文件和帮助两个子菜单,其中帮助菜单用来显示当前程序的版本号。文件菜单又有“属性设置”和“退出”两个选项,其中退出选项用来退出当前的WebService服务,属性设置用来更改Web服务所在的端口号。选择属性设置菜单,如下图所示:


    会弹出如下图所示的设置端口号对话框:


    可以在这里输入新的端口号,值得注意的是,更改端口号之后,并不能马上生效,只有当RealDbWebService程序重启后,所做的更改才会生效。

    2、紫金桥WebService发布的方法

    1)取得实时数据

    bool GetRealData(string[] names, out string[] datas);
    调用此函数可以获得相应的位号的实时数据,其中names是输入参数,为字符串数组,每一个字符串为位号的名称比如“A1.PV”,注意这里需要包括参数名称。
    datas为输出参数,为字符串数组,它包含的字符串个数和输入参数names包括的字符串个数相同。
    如果函数返回true,那么就可以通过datas来获得相应位号的实时数据。

    2)设置实时数据
    bool SetRealData(string[] names, string[] datas);
    调用此函数可以修改实时数据库中相应位号的实时数据,names和datas都是输入参数,意义请参见GetRealData。
    如果函数返回true,那么实时数据库中的相应位号的实时数据被成功修改。

    3)取批量历史数据
    bool GetHisData(string name, DtTime startTime, double secondSpace, int nDataCount, out HisData[] datas);
    其中name是需要取批量历史数据的位号,比如“A1.PV”;startTime是取历史的起始时间;secondSpace是读取历史数据的间隔,单位秒;nDataCount是读取的历史数据个数;datas为输出数组参数,返回读取的所有历史数据。
    其中HisData的定位如下:
    public class DtTime
    {
    public DateTime time;
    public short millsec;
    }
    public class HisData
    {
    public DtTime time;
    public double data;
    }
    HisData由两个成员构成,一个为数据的时间time,一个为数据data
    数据的时间DtTime也由两个成员构成,一个为DateTime类型,一个为时间的毫秒数。

    4)取一段时间范围内的所有历史数据
    bool GetAllHisData(string name, DtTime startTime, int secondSpan, out HisData[] datas);
    其中name是需要取批量历史数据的位号,比如“A1.PV”;startTime是取历史的起始时间;secondSpan是读取历史数据的时间跨度,单位秒;datas为输出数组参数,返回读取的所有历史数据。HisData的定义请参见GetHisData。

    5)插入批量历史数据
    bool InsertHisData(string name, HisData[] datas);
    其中name是需要取批量历史数据的位号,比如“A1.PV”;datas为输入数组参数,传入需要插入的所有历史数据。HisData的定义请参见GetHisData。

    6)取得实时报警信息
    bool GetRealAlarm(int areaNo, int unitNo, out AlarmData[] alarms);
    areaNo为获取的实时报警的区域号,-1代表所有区域;unitNo为获取的实时报警的单元号,-1表示所有单元。alarms返回当前的符号条件的所有实时报警。AlarmData的定义如下:
    public class AlarmData
    {
    public string name;
    public string desc;
    public int type;
    public int prio;
    public int ack;
    public DtTime time;
    public double data;
    public double limit;
    public string eu;
    public int area;
    }
    其中参数的意义如下:
    name表示位号名称。
    desc表示点说明。
    type为报警的类型意义为0低低报,1低报,2高报,3高高报,4变化率,5偏差报警。
    prio是报警的优先级,0恢复,1低级,2高级,3紧急
    ack表示报警的确认状态,0没有确认,1确认,2恢复
    time是报警的时间,DtTime的定义请参考GetHisData。
    data是报警时刻的数据。
    limit是报警发生时的限值。
    eu是位号的工程单位。
    area是位号所在的区域号。

    7)取得历史报警信息
    bool GetHisAlarm(int areaNo, int unitNo, int day, out AlarmData[] alarms);
    areaNo为获取的实时报警的区域号,-1代表所有区域;unitNo为获取的实时报警的单元号,-1表示所有单元。day表示获取哪一天的报警历史,0表示是当天,-1表示前一天,其他类推。alarms返回当前的符号条件的所有历史报警信息。AlarmData的定义请参考GetRealAlarm。

    8)进行Sql查询
    bool SqlQuery(string sql, out string[] types, out string[][] result);
    参数sql是所查询的sql命令,types返回result中每一列的类型,字符型为“string”,整型为“int”,浮点类型为“real”。result是一个二维数组,返回查询的结果。

    3、在C#下调用紫金桥WebService


    使用C#调用紫金桥WebService的步骤主要有两步:
    1)根据WSDL文件产生调用WebService的接口
    打开VS进入C#开发环境,选择菜单“工具/Visual Studio Command Prompt”进入命令行模式:

    在命令行键入:
    wsdl /l:CS /o:x:/realDb.cs x:/realdb.wsdl
    上面的X:为紫金桥提供的realdb.wsdl文件所在的目录,也是输出realDb.cs的目录,可以根据具体情况灵活处理。
    执行命令后,就会生成realDb.cs文件,可以在C#项目中使用。

    2)在C#下编写代码调用接口访问WebService

    把realDb.cs加入到C#项目中,并调用相应的接口函数即可调用相应的WebService功能。注意在realDb.cs的前面有如下的代码:
    this.Url = "http://localhost:1997";
    这里是说当前WebService所在的机器为本机,端口号为1997,这里可以根据需要修改成合适的地址。
    取实时数据的示例代码:
    string[] names = new string[4];
    names[0] = "A1.PV";
    names[1] = "A2.PV";
    names[2] = "A3.PV";
    names[3] = "A4.DESC";

    string[] datas;
    Service s = new Service();
    s.GetRealData(names, out datas);
    int nCount = datas.GetUpperBound(0) + 1;
    realData.Text = "";
    for (int i = 0; i < nCount; ++i)
    {
    realData.Text += datas[i] + " ";
    }
    设置实时数据的示例代码:
    string[] names = new string[4];
    names[0] = "A1.PV";
    names[1] = "A2.PV";
    names[2] = "A3.PV";
    names[3] = "A4.DESC";
    string[] datas = new string[4];
    datas[0] = "1";
    datas[1] = "2";
    datas[2] = "3";
    datas[3] = "设置成功";
    Service s = new Service();
    s.SetRealData(names, datas);

    取历史数据的示例代码:
    Service s = new Service();
    DtTime dt = new DtTime();
    dt.time = new System.DateTime(2013, 11, 29, 15, 36, 0);
    dt.millsec = 0;
    HisData[] datas;
    s.GetHisData("A1.PV", dt, 1, 4, out datas);
    int nCount = datas.GetUpperBound(0) + 1;
    his_data_edit.Text = "";
    for (int i = 0; i < nCount; ++i)
    {
    his_data_edit.Text += datas[i].time.time.ToString() + " " + datas[i].data.ToString() + "\r\n";
    }
    插入历史数据的示例代码:
    Service s = new Service();
    DtTime dt = new DtTime();
    HisData[] datas = new HisData[4];
    datas[0] = new HisData();
    datas[0].time = new DtTime();
    datas[0].time.time = new System.DateTime(2013, 11, 29, 15, 36, 0);
    datas[0].data = 1;
    datas[1] = new HisData();
    datas[1].time = new DtTime();
    datas[1].time.time = new System.DateTime(2013, 11, 29, 15, 36, 1);
    datas[1].data = 12;
    datas[2] = new HisData();
    datas[2].time = new DtTime();
    datas[2].time.time = new System.DateTime(2013, 11, 29, 15, 36, 2);
    datas[2].data = 123;
    datas[3] = new HisData();
    datas[3].time = new DtTime();
    datas[3].time.time = new System.DateTime(2013, 11, 29, 15, 36, 3);
    datas[3].data = 1234;
    s.InsertHisData("A1.PV", datas);
    取得实时报警的示例代码如下:
    Service s = new Service();
    AlarmData[] alarms;
    s.GetRealAlarm(-1, -1, out alarms);
    int nCount = alarms.GetUpperBound(0) + 1;
    alarm_edit.Text = "";
    for (int i = 0; i < nCount; ++i)
    {
    alarm_edit.Text += alarms[i].time.time.ToString() + " " + alarms[i].data.ToString() + " " + alarms[i].name + " " + alarms[i].desc + " " + alarms[i].eu + " " + alarms[i].data.ToString() + " " + alarms[i].limit.ToString() + "\r\n";
    }

    4、在Java下调用紫金桥WebService



    在Java下可以使用Axis2来调用紫金桥的WebService,Axis2是Apache下的一个重量级WebService框架,准确说它是一个Web Services / SOAP / WSDL 的引擎,是WebService框架的集大成者,它能不但能制作和发布WebService,而且可以生成Java和其他语言版WebService客户端和服务端代码。

    Axis2的下载地址为:


    http://apache.dataguru.cn//axis/axis2/java/core/1.6.2/axis2-1.6.2-bin.zip

    下面着重介绍在Java下如何通过Axis2 调用紫金桥Web Service。

    使用Axis2调用紫金桥WebService的步骤主要有两步:

    1)根据WSDL文件产生调用WebService的接口
    Axis2提供了一个wsdl2java.bat命令,可以根据WSDL文件自动产生调用WebService的接口代码。在紫金桥安装目录下可以找到realdb.wsdl文件,通过wsdl2java.bat命令即可利用此文件生成相应的调用WebService的接口代码。
    wsdl2java.bat命令可以在/bin目录中找到。在使用wsdl2java.bat命令之前需要设置AXIS2_HOME环境变量,该变量值是
    在Windows控制台输出如下的命令行来生成调用WebService的代码:%AXIS2_HOME%\bin\wsdl2java -uri <紫金桥软件安装目录>/realdb.wsdl -p realdb -s -o realdb
    其中-url参数指定了wsdl文件的路径,可以是本地路径,也可以是网络路径。
    -p参数指定了生成的Java类的包名,
    -o参数指定了生成的一系列文件保存的根目录。
    在执行完上面的命令后,在当前目录下多了个realdb目录,在realdb\src\realdb目录可以找到ServiceStub.java文件,该文件封装了调用WebService的方法,在程序中直接使用这个类.
    需要注意的是,wsdl2java.bat命令生成的ServiceStub类将WebService方法的参数都封装在了相应的类中,类名为方法名,例如,GetRealData方法的参数都封装在了GetRealData类中,要想调用GetRealData方法,必须先创建GetRealData类的对象实例。

    2)在java下调用接口访问紫金桥WebServcie
    下面将介绍通过Eclipse来编写java调用WebService的方法,使用其他编辑环境类似。
    解压eclipse-jee-helios-SR1-win32.zip文件,运行eclipse.exe出现下图界面:




    设置工作目录,这里采用默认配置,直接“OK”按钮,完成配置。
    在eclipse中新建 Java Project,在Project Name输入
    RealDBServiceExample,点击Finish按钮完成工程创建。
    在工程中新建 class 类,画面如下图所示:

    输入类名RealDBWebService,选中 public static void main(String[] args)选项,点击Finish按钮完成类创建。
    将src目录下的realdb文件夹拷贝到工程目录下的src文件夹下。
    在Eclipse中编写Service调用代码,具体代码如下:
    引入工程所需 package。具体如下所示:
    import realdb.*;
    import java.rmi.RemoteException;
    import javax.xml.namespace.QName;
    import org.apache.axis2.AxisFault;
    import org.apache.axis2.addressing.EndpointReference;
    import org.apache.axis2.client.Options;
    import org.apache.axis2.rpc.client.RPCServiceClient;

    在main函数中编写代码如下:

    ServiceStub realdb = new ServiceStub();
    ServiceStub.GetRealData getData = new ServiceStub.GetRealData();
    //定义GetRealData方法所需参数
    ServiceStub.ArrayOfString pointParameters
    = new ServiceStub.ArrayOfString();
    pointParameters.addString("A1.PV");
    pointParameters.addString("A2.PV");
    pointParameters.addString("A3.PV");

    getData.setNames(pointParameters);
    ServiceStub.ArrayOfString pointValues
    = realdb.getRealData(getData).getDatas();
    //输出参数与所回值
    String paraValue[] = pointValues.getString();
    String paraName[] = pointParameters.getString();
    for (int i = 0; i<3; ++i)
    {
    System.out.println(paraName[i] + " = " + paraValue[i]);
    }

    在Eclipse中加载axis2 libraries
    进入Java Project属性设置对话框,点击Java Build Path,选择Libraries标签页,如下图所示:

    点击 Add External JARs ... 对话框,在弹出对话框选择axis2 libraries,完成axis2 libraries加载。

    运行后结果如下图所示:

    A1.PV = 10000.990
    A2.PV = 20000.330
    A3.PV = 30000.230


     

    注意事项:

      Realdb.wsdl中的soap:address location和soap12:address location默认为localhost,端口号默认为1997。

      如果想让其他网络机器可以访问Web Service,需将localhost替换成本机IP,如本机IP为 192.168.0.1 替换后如下所示:

      替换完毕后,重新运行wsdl2java即可重新生成调用WebService的接口代码。

    关键字:紫金桥,实时数据库,WebService