【基本类型接口使用说明】

admin

本教材以易语言为模板讲解，其他语言的可看教程进行参考，相信大家可以解决

基本类型接口有2种：
1：文本类型接口（t）   用于接收文本数据
2：字节集类型接口（b） 用于接收字节集（文件）数据

【1】复制接口

如果你要向EWEB传输文本，则复制文本接口
如果你要传输文件，则复制字节集接口，字节集接口可用于数据文件的分析，验证码图片识别，上传个性化数据等地方


复制的接口是标志符，是不带请求网址的
如复制文本接口得到的是A467848AF93D6415,请求网址是http://127.0.0.1/，那么最终的文本请求地址是：http://127.0.0.1/A467848AF93D6415

【2】dll映射的默认规则

在不指定所使用的dll的情况下

EWEB默认将得的的http数据传递给et.dll

在不指定子程序名的情况下

如果是文本接口，EWEB默认将得到的http数据传递给子程序t

如果是字节集接口，EWEB默认将得到的http数据传递给子程序b

【3】dll接口类型的参数说明

  

子程序名	返回值类型	公开	备 注
t	文本型	√	文本拓展接口
参数名	类 型	参考	可空	数组	备 注
get数据	文本型
post数据	文本型
ip	文本型
传递序号	整数型
请求序号	整数型

变量名	类 型	静态	数组	备 注
传入文本值	文本型
返回文本值	文本型

' 中间写运算代码
返回文本值 ＝ “文本接口调用成功”
返回 (返回文本值)

子程序名	返回值类型	公开	备 注
b	文本型	√
参数名	类 型	参考	可空	数组	备 注
get数据	文本型
字节集地址	整数型
字节集长度	整数型
ip	文本型
传递序号	整数型
请求序号	整数型

变量名	类 型	静态	数组	备 注
传入字节集	字节集
返回字符串	文本型

传入字节集 ＝ 指针到字节集 (字节集地址, 字节集长度)  ' 这里得到的就是接收到的字节集
' 中间写运算代码
返回字符串 ＝ 校验_取md5 (传入字节集)  ' 这是教程写的一个返回md5的功能，目的是检测传输是否丢包
返回 (返回字符串)

.版本 2<br /> <br /> .子程序 t, 文本型, 公开, 文本拓展接口<br /> .参数 get数据, 文本型<br /> .参数 post数据, 文本型<br /> .参数 ip, 文本型<br /> .参数 传递序号, 整数型<br /> .参数 请求序号, 整数型<br /> .局部变量 传入文本值, 文本型<br /> .局部变量 返回文本值, 文本型<br /> <br /> <br /> <br /> ' 中间写运算代码<br /> 返回文本值 ＝ “文本接口调用成功”<br /> 返回 (返回文本值)<br /> <br /> .子程序 b, 文本型, 公开<br /> .参数 get数据, 文本型<br /> .参数 字节集地址, 整数型<br /> .参数 字节集长度, 整数型<br /> .参数 ip, 文本型<br /> .参数 传递序号, 整数型<br /> .参数 请求序号, 整数型<br /> .局部变量 传入字节集, 字节集<br /> .局部变量 返回字符串, 文本型<br /> <br /> 传入字节集 ＝ 指针到字节集 (字节集地址, 字节集长度)  ' 这里得到的就是接收到的字节集<br /> <br /> ' 中间写运算代码<br /> 返回字符串 ＝ 校验_取md5 (传入字节集)  ' 这是教程写的一个返回md5的功能，目的是检测传输是否丢包<br /> 返回 (返回字符串)

文本型接口默认为5个参数，字节集接口为6个，这个是统一格式无法更改

因为dll无法直接字节集，所以在设计上使用先把字节集数据写入内存，然后传递给dll2个参数（字节集地址、字节集长度），使用post数据 ＝ 指针到字节集 (字节集地址, 字节集长度)的方法来得到post数据，这一段话可能有些人听不懂，不过大家一般用不到字节集接口，需要用到的应该也可以听明白

get数据：请求地址后？后附加的参数，比如https://shuxiangyage.net/forum.php?123456，get数据就是123456

post数据：这个应该都知道

ip：指的是请求端的ip地址

传递序号：大家一般用不上，是用来防冲突的，后面会出专门的帖子来讲解，操作难度较大，大家可以暂且理解为当前的子程序被调用了多少次，起到统计的作用

请求序号：每次软件重启则重新计算，相当于记录当前是第几条请求数据，配合模块功能使用，可用于bug测试

【4】编译

大家写好自己的dll功能后编译到指定位置即可，如ed.dll就编译到\plugin\ed\ed.dll

【6】测试

大家可以在你的客户端上使用post相关函数提交请求测试了，易语言用户可以打开目录下的调用例子目录查看其中的源码，也可以使用EWEB软件上自带的测试功能

点击返回： 【EWEB总览】