API应用程序编程接口详解

合集下载

api

api

API简介1.应用程序编程接口API(Application Programming Interface,应用程序编程接口)是一些预先定义的函数,目的是提供应用程序与开发人员基于某软件或硬件的以访问一组例程的能力,而又无需访问源码,或理解内部工作机制的细节。

windows APIWindows API是一套用来控制Windows的各个部件的外观和行为的预先定义的Windows函数。

用户的每个动作都会引发一个或几个函数的运行以告诉Windows发生了什么。

操作系统的用户接口这在某种程度上很像Windows的天然代码。

而其他的语言只是提供一种能自动而且更容易的访问API的方法。

以VB为例,它完全隐藏了API并且提供了在Windows环境下编程的一种完全不同的方法,也就是说,你用VB写出的每行代码都会被VB转换为API函数传递给Windows,同样,当你点击窗体上的一个按钮时,Windows会发送一个消息给窗体,VB获取这个调用并经过分析后生成一个特定事件。

API函数包含在Windows系统目录下的动态连接库文件中。

更易理解来说:Windows系统除了协调应用程序的执行、内存的分配、系统资源的管理外,同时他也是一个很大的服务中心。

调用这个服务中心的各种服务(每一种服务就是一个函数)可以帮助应用程序达到开启视窗、描绘图形和使用周边设备等目的,由于这些函数服务的对象是应用程序,所以称之为Application Programming Interface,简称API 函数。

WIN32 API也就是MicrosoftWindows 32位平台的应用程序编程接口。

凡是在 Windows 工作环境底下执行的应用程序,都可以调用Windows API。

linux中的API在linux中,用户编程接口API遵循了UNIX中最流行的应用编程界面标准---POSIX标准。

POSIX标准是由IEEE和ISO/IEC共同开发的标准系统。

应用程序接口规范

应用程序接口规范

应用程序接口规范1. 简介本文档详细描述了应用程序接口(API)的规范,包括接口的定义、功能、使用方法和技术要求。

开发者应遵循本文档的规范来设计和实现API,以确保系统的兼容性、稳定性和可维护性。

2. API定义与分类2.1 API定义应用程序接口(API)是一套定义良好的协议,它允许不同的软件系统相互通信。

API定义了请求的结构、响应的格式和错误处理机制等,为开发者提供了一种简便的方式来访问系统功能。

2.2 API分类根据不同的功能和用途,API可分为以下几类:- 公共API:提供给外部开发者使用的接口,用于访问系统的公共功能。

- 内部API:供内部团队使用的接口,用于实现系统内部功能和模块之间的通信。

- 管理API:用于管理系统资源、用户权限和系统配置等。

3. API使用方法3.1 接口请求- 请求参数:根据API的具体需求,可以在请求中传递JSON 格式的参数。

- 请求头部:包含API密钥、认证信息等必要头部信息。

3.2 接口响应- 响应格式:返回JSON格式的数据,包含接口调用结果、状态码和错误信息(如有)。

- 错误信息:当发生错误或异常时,返回详细的错误信息,包括错误码、错误描述和解决方案。

4. API技术要求4.1 性能要求- 响应时间:API调用应在500ms内完成,如有特殊需求,可在接口说明中注明。

- 并发能力:支持高并发访问,确保系统稳定性和可靠性。

4.2 安全要求- 认证授权:对访问API的用户进行认证和授权,确保接口安全。

- 访问控制:限制API的访问频率和来源,防止恶意攻击和滥用。

4.3 兼容性要求- 接口版本管理:支持多版本共存,通过版本号区分。

- 数据格式:统一使用JSON格式,确保跨平台和语言的兼容性。

5. 接口示例以下是一个简单的接口示例:请求URL:GET /api/users请求参数:无响应示例:{"status": 200,"data": [{"id": 1,"name": "张三",},{"id": 2,"name": "李四",}],"message": "查询成功"}6. 附录- API列表:列出所有API接口的详细信息,包括接口名称、描述、请求URL、请求参数、响应格式等。

api接口大全

api接口大全

api接口大全API接口大全。

API(Application Programming Interface)是应用程序接口的缩写,是一组定义、规范了软件程序如何与其他软件程序进行交互的接口。

在软件开发中,API接口扮演着非常重要的角色,它们可以让不同的软件系统之间实现数据交换、功能调用等操作。

本文将介绍API接口的基本概念、常见类型以及使用方法,希望能够帮助开发者更好地理解和应用API接口。

一、API接口概述。

API接口是软件系统之间进行交互的桥梁,它定义了一组规范,包括了数据格式、通信协议、调用方式等,使得不同的软件系统可以相互通信、共享数据、调用功能。

API接口可以分为内部API和外部API两种,内部API用于系统内部模块之间的通信,而外部API则用于系统与外部服务、第三方系统的交互。

二、API接口的常见类型。

1. Web API。

Web API是一种基于Web的API接口,它使用HTTP协议进行通信,通过URL地址进行访问。

Web API通常用于提供Web服务、数据接口等功能,常见的Web API包括RESTful API、SOAP API等。

2. Library API。

Library API是一种库函数接口,它是由库文件提供的一组函数接口,用于实现特定功能。

开发者可以通过调用这些函数接口来使用库文件提供的功能,例如操作系统API、数据库API等。

3. Remote API。

Remote API是一种远程调用接口,它允许程序在不同的计算机或设备之间进行远程调用。

Remote API可以通过网络进行通信,实现远程服务的调用和数据交换。

4. Open API。

Open API是一种开放接口,它允许第三方开发者访问特定的功能或数据,通常用于构建开放平台、开发者社区等场景。

开放API可以帮助企业扩大生态圈,吸引更多的开发者参与应用开发。

三、API接口的使用方法。

1. 接口文档。

在使用API接口之前,开发者通常需要查阅相应的接口文档,了解接口的功能、参数、调用方式等信息。

应用程序编程接口API

应用程序编程接口API

Visual C++
5.1 API概述
5.1.1 关于Windows API编程模式 5.1.2 API简介
5.1.3 Windows核心——三个动态链接库
5.1.4 Windows API分类
*5.1.5 操作系统的认识
Visual C++
5.1.1 关于WindowsAPI编程模式
Windows API编程是一种原始的开发Windows应用程 序模式,它主要使用的是C语言、少量的C++通用类及 “原始”的Windows应用程序编程接口API(Application Programming Interface)。这些函数都是比较底层的函 数,其地位大致相当于字符界面环境下C语言的标准库 函数,只不过其运行环境为Windows的图形界面环境。 本篇的后多半部分虽然采用的是相对比较简单的 MFC编程,但使用底层的API函数编写程序可以看到许多 MFC编程看不到的东西,从而对Windows的内部运作有更 深入的了解。进行API编程,要求用户对Windows环境比 较熟悉,并且熟悉C语言。在API编程中用到大量的有关 操作系统的结构体变量和控制操作系统的函数,当在使 用API函数遇到问题时,可以随时查阅Windows的API文 档,它位于MSDN的Platform SDK部分。
Visual C++
5.1.4 WindowsAPI分类(续)
9.打印管理服务 在Windows操作系统下,可以实现在各种设备下的打 印。打印管理服务提供了完整的函数集支持这些操作, 例如检索打印机,准备打印等。这些服务所对应的函数 包含在打印管理函数库——Winspool.drv中。 10.解/压缩文件服务 该服务提供了对文件的压缩和解压服务。这些服务 所对应的函数包含在函数库——Lz32.dll。 在VC6.0中提供了一个文件Win32api.csv。它是一个 Win16与Win32函数的对照表。通过它读者可以浏览到 Windows各种版本下API函数的原型说明。

什么是API,如何区分API和SDK?

什么是API,如何区分API和SDK?

什什么是API,如何区分API和SDK?1.API的概念API即“应⽤用程序编程接⼝口”,是⼀一些预先定义的函数,⽬目的是作为“介⾯面”沟通两个不不同的东⻄西,提供应⽤用程序与开发⼈人员基于某软件或硬件得以访问⼀一组例例程的能⼒力力,⽽而⼜又⽆无需访问源码,或理理解内部⼯工作机制的细节。

其实就是别⼈人已经写好的可以实现特定功能的函数,⽽而你只需要根据他提供好的接⼝口,也就是调⽤用他的⽅方法,传⼊入他规定的参数,然后这个函数就会帮你实现这些功能。

也就是操作系统留留给应⽤用程序的⼀一个调⽤用接⼝口,应⽤用程序通过调⽤用操作系统的 API ⽽而使操作系统去执⾏行行应⽤用程序的命令(动作)。

从接⼝口interface来说,在计算机领域是指两个不不同事物之间交互的地⽅方,⼤大可以到两个完整的不不同系统,⼩小可以到两段程序。

所以这个I就这么理理解。

在这个基础上,⼈人和程序交互的地⽅方,叫做UI,user interface,所有⼈人输⼊入的包括⿏鼠标键盘触摸屏声⾳音输⼊入都算。

那么程序和程序交互的就叫做API,所有⾮非⼈人对⾮非⼈人交互都通过API进⾏行行交互,所谓交互,其实就是传递数据,触发功能。

2.应⽤用案例例(1)示例例场景:你是⼀一家⼩小企业,公司⽹网站上有⼀一个表格是⽤用来给客户注册预约的。

你想要凭借这些预约细节信息,让客户能够⾃自动在⾕谷歌⽇日程上创建活动。

(2)API使⽤用:这就意味着,你的⽹网站服务器器需要直接与⾕谷歌服务器器进⾏行行对话,在掌握既定细节信息的情况下,申请创建活动。

之后,你的服务器器就会接收到⾕谷歌的响应并进⾏行行处理理,然后将相关信息发送回浏览器器,⽐比如说向⽤用户发送⼀一个确认信息。

(3)现在也有公司将API包装成产品案例例:Weather Underground出售其天⽓气数据API的访问权限给其他⼈人。

3.API的分类API⼜又分为(Windows、Linux、Unix等系统的)系统级API,及⾮非操作系统级的⾃自定义API。

api原理

api原理

api原理API(Application Programming Interface)是指应用程序接口,是一套预定义的接口规则、协议、函数或工具的集合,它为应用程序提供了访问操作系统或其他应用程序的指令集。

API原理主要涉及到API的构成和使用,下面将从多个方面详细阐述API原理。

一、API构成的元素1. API函数:API函数是API的基础构成部分,API函数是一组操作命令,它们可控制不同功能,如文件读取、Socket连接、设备驱动程序调用、GUI控制等。

2. API方式:API方式定义了如何发送请求、如何访问和调用API以及如何将应用程序和API进行交互。

3. API参数:API参数是指输入和输出参数,输入参数需要通过API函数接收,输出参数是指API函数返回的数据。

4. 返回值:API函数执行后返回一个值或者一组值,它们可以指示操作的成功或者失败以及其他有用的信息。

二、API的使用方法1. API调用流程:API调用的流程包括:使用API文档了解API 函数的功能和参数信息、定义输入参数并将其传递给API函数、执行API函数、获取返回结果。

2. API的调用方式:常见的API调用方式有:动态链接库方式、静态链接库方式、SOAP方式、HTTP方式等等。

3. 常用API:常用API包括:W3C DOM API、jQuery API、Google Maps API、Twitter API、Facebook API等等,它们都被广泛应用于网站和应用程序的开发中。

三、API的优缺点1. 优点(1)API提供了标准的接口,可帮助开发人员更方便地开发程序,并且减少了开发周期。

(2)API提供了可重用的代码和函数库,这有助于开发人员编写更高效和可靠的代码。

(3)API有助于维护代码,开发人员可以根据需要更改API,而不用修改应用程序的主体结构。

2. 缺点(1)API的学习曲线较陡峭,需要花费时间和精力才能理解和应用。

API基础详解

API基础详解

API基础详解什么是API?API(Advanced Programmers Interface,高级程序员接口)(注:API实际是指Application Programming Interface,应用程序编程接口;此处疑为原文错误,不过在VB中也可以这么说吧!)是一套用来控制Windows的各个部件(从桌面的外观到位一个新进程分配的内存)的外观和行为的一套预先定义的Windows函数.用户的每个动作都会引发一个或几个函数的运行以Windows告诉发生了什么. 这在某种程度上很象Windows的天然代码.其他的语言只是提供一种能自动而且更容易的访问API的方法.VB在这方面作了很多工作.它完全隐藏了API并且提供了在Windows环境下编程的一种完全不同的方法. 这也就是说,你用VB写出的每行代码都会被VB转换为API函数传递给Windows.例如,Form1.Print...VB 将会以一定的参数(你的代码中提供的,或是默认参数)调用TextOut 这个API函数. 同样,当你点击窗体上的一个按钮时,Windows会发送一个消息给窗体(这对于你来说是隐藏的),VB获取这个调用并经过分析后生成一个特定事件(Button_Click). API函数包含在Windows系统目录下的动态连接库文件中(如User32.dll,GDI32.dll,Shell32.dll...). API 声明正如在"什么是API"中所说,API函数包含在位于系统目录下的DLL文件中.你可以自己输入API函数的声明,但VB提供了一种更简单的方法,即使用API Text Viewer. 要想在你的工程中声明API函数,只需运行API Text Viewer,打开Win32api.txt(或.MDB如果你已经把它转换成了数据库的话,这样可以加快速度.注:微软的这个文件有很多的不足,你可以试一下本站提供下载的api32.txt),选择"声明",找到所需函数,点击"添加(Add)"并"复制(Copy)",然后粘贴(Paste)到你的工程里.使用预定义的常量和类型也是同样的方法. 你将会遇到一些问题: 假设你想在你的窗体模块中声明一个函数.粘贴然后运行,VB会告诉你:编译错误...Declare 语句不允许作为类或对象模块中的Public 成员...看起来很糟糕,其实你需要做的只是在声明前面添加一个Private(如Private Declare Function...).--不要忘了,可是这将使该函数只在该窗体模块可用. 在有些情况下,你会得到"不明确的名称"这样的提示,这是因为函数.常量或其他的什么东西共用了一个名称.由于绝大多数的函数(也可能是全部,我没有验证过)都进行了别名化,亦即意味着你可以通过Alias子句使用其它的而不是他们原有的名称,你只需简单地改变一下函数名称而它仍然可以正常运行. 你可以通过查看VB的Declare语句帮助主题来获取有关Alias的详细说明. 消息(Messages) 好了,现在你已经知道什么是API函数了,但你也一定听说过消息(如果你还没有,你很快就会)并且想知道它是什么.消息是Windows告诉你的程序发生了哪些事件或要求执行特定操作的基本方法.例如,当用户点击一个按钮,移动鼠标,或是向文本框中键入文字时,一条消息就会被发送给你的窗体. 所有发送的消息都有四个参数--一个窗口句柄(hwnd),一个消息编号(msg)还有两个32位长度(Long)的参数. hwnd即要接受消息的一个窗口的句柄,msg即消息的标识符(编号).该标识符是指引发消息的动作类型(如移动鼠标),另外两个参数是该消息的附加参数(例如当鼠标移动时光标的当前位置) 但是,当消息发送给你时你为什么看不到呢--就象有人在偷你的信一样?请先别恼火,让我告诉你. 小偷其实是Visual Basic.但它并没有偷走你的信,而是在阅读了之后挑出重要的以一种好的方式告诉你.这种方式就是你代码中的事件(Event). 这样,当用户在你的窗体上移动鼠标时,Windows会发送一条WM_MOUSEMOVE消息给你的窗口,VB得到这条消息以及它的参数并运行你在事件MouseMove中的代码,同时VB 会把这条消息的第二个32位数(它包含了x,y坐标,单位为像素(Pixel),每个位16位)转换为两个单精度数,单位为缇(Twip). 现在,如果你需要光标坐标的像素表示,然而VB已经把它转换成了缇,因此你需要重新把它转换为以像素为单位.在这里,Windows给了你所需要的,但VB"好意地"进行了转换而使你不得不重新转换.你可能会问--我难道不能自己接收消息吗?答案是肯定的,你可以使用一种叫做子类处理(Subclass)的方法.但你除非必须否则最好不要使用,因为这与VB的安全程序设计有一点点的违背.(注:子类处理确实有很大的风险,但如果使用得当,是很有用处的.不过有一点一定要注意,即千万不要使用VB的断点调试功能,这可能会导致VB崩溃!) 需要补充说明的是:你可以发送消息给你自己的窗口或其他的窗口,只需调用SendMessage或PostMessage(SendMessage会使接受到消息的窗口立刻处理消息,而PostMessage是把消息发送到一个称为消息队列的队列中去,等候处理(它将会在该消息处理完后返回,例如有些延迟)).你必须制定接受消息的窗口的句柄,欲发送消息的编号(所有的消息的编号均为常量,你可以通过API Text Viewer查得)以及两个32位的参数. Windows的一些特别之处这个主题是要告诉你Windows 的一些与在VB中的不同的细节Windows通过句柄(Handle)识别每个窗体,控件,菜单,菜单项或其他任何你能想得到的东西.当你的程序运行时,它所包含的每个部件都有一个唯一确定的句柄用来同其他的部件相区别.例如,某个按钮得句柄就与其他部件不同,当你想要通过API来执行有关该按钮的某种操作时就必须使用这个句柄.从哪儿得到它呢?VB 为每个拥有Windows句柄的控件都提供了Hwnd属性来表示其句柄. Windows 使用像素(Pixel)而不是缇(Twip).因此,把涉及API函数调用的控件的ScaleMode属性设为3--(Pixel)是个不错的主意,这样你可以通过ScaleXXX属性得到它们的公制单位值.尽管这样,你可能有时仍需要进行从Twip到Pixel的转换(反之亦然),你可以通过Screen 对象的TwipsPerPixelX和TwipsPerPixelY来实现.举例如下: PixelXValue=TwipXValue\Screen.TwipsPerPixelX PixelYValue=TwipYValue\Screen.TwipsPerPixelY TwipXValue=PixelXValue*Screen.TwipsPerPixelX TwipYValue=PixelYValue*Screen.TwipsPerPixelY 我并没有在实际中见到过TwipsPerPixelX 和TwipsPerPixelY 的值有什么不同,但你最好是把它们区别开来而不是混用,这至少是一种好的程序设计风格.另外需要注意的是,这里用的是" \ "(整除) 而不是" / " ,这是因为像素值必须是整数. 另外需要提到的是,Windows函数中用到了不同的坐标系统,因此需要注意. 最后要注意的是,一旦你使用了API 函数,VB就可能不再可靠了---API调用中一个简单的语法错误就会导致VB 崩溃!(请经常保存您的工程).VB 并不能识别API调用中的错误,因此一旦你的程序出现异常,要先检查API调用---是否缺少ByVal,或者是错误的类型,参数等等. 从哪里得到有关函数的说明? 这个主题不会告诉你如何通过API函数改变按钮文字或如何快速查找一个文件.这不是一个API函数文档. 为了得到有关函数的说明,你需要SDK帮助或微软的SDK文档(至少有40M---我怎么可能放在这里?).这些SDK帮助通常都包含在Borland Dephli 3.0 开发包或者MS Visual C++中.到网上去或找您的朋友要一个,版本越新越好注意Win3.x 的SDK 帮助对你并没有用,因为很多函数已经过于陈旧甚至废弃不用,尽管他们中的大多数由于与Windows95兼容而依然存在. API参数类型如果你已经有了一个SDK帮助,你肯定主意到了函数的返回之或参数有很多奇怪的类型如VOID,LPCSTR, 和DWORD.如果你对C语言比较熟悉的话,那你肯定明白它们的意思.对于其他不熟悉C语言的人,这里有一张摘自VB Books Online(标题是:C语言声明到Visual Basic的转换)注释: 你应该注意到了BOOL类型(Boolean)求出的值为Long而不是Boolean.因此0表示"假"(False),其他任何值表示"真"(True). HWND,HDC,HMENU,etc.---etc.指其他所有与于前面所述相似的类型.它们都以"H"开头来表示不同对象的句柄.举例来说,HBITMAP表示一副位图的句柄,HBRUSH标是一个刷子的句柄等等.它们均为Long而且要按值传递(ByVal). 同样要注意LPVOID被声明为Any型变量,本文将会有独立的一个主题用来论述Any类型. 有些类型以"LP"开头.LP 是Long Pointer的缩写.因此LPWORD实际表示数据所存的内存地址.不过,你并没有必要调用某个函数来获取这个地址.当你按引用(ByRef)传递参数时,你实际上传递的就是它的地址.在这里你只需记住:如果某个参数的类型以"LP"开头,应该按引用(ByRef)传递.顺便说一句,LPARAM 与Lparam 很相似但不是Lparam,Lparam不是一个指针, 在这里你必须传递它的真实值,因此要按值(ByVal)传递. NULL也是一种奇怪的类型.你可以从VB 中了解到有关它的描述,这里我不去讨论它.按你需要的形式传递它吧,在大多数情况下,可以用ByVal 0& 或vbNullString. 最后,VOID是用来指那些没有返回值的函数的.API中没有SUBs,这就是它们的标志.只要记住:如果一个函数被声明为VOID ,你必须在VB 中把它声明为SUB. Any 有些消息的参数声明为Any.这表示该参数是一种可变的类型(你可以以整型,字符串,用户自定义或其他的类型来传递). 这有一个这样的例子: Public Declare Function SendMessage Lib "User32" Alias "SendMessageA" ByVal Hwnd as Long, ByVal wMsg as Long, ByVal wParam as Long, lParam as Any) as Long lParam 声明为Any并按引用(ByRef)传递. 这里是在这个函数中如果lParam是不同类型的值时应遵循的规则: 如果该值是传递形式numeric ByVal(as Long,or as Any) Null ByVal(as Long,or as Any) String ByRef(as String,or as Any) Type ByRef(as Any) array of Type ByRef(as Any) 如果你的函数声明同上面的一个而且你想传递一个Long 型数,你应该这样写: Call SendMessage(Me.Hwnd,WM_XXXX,0&,ByVal LongValue) 注意尽管头三个参数也是数值,但它们前边并没有ByVal.这是因为在函数声明中它们已经被声明为按值传递(ByVal).第四个参数,由于是按引用传递(ByRef)(VB并不知道你要传递参数的类型),因此你必须加上ByVal 你可以使用别名技术来传递不同类型的参数: Public Declare Function SendMessageLng Lib "User32" Alias "SendMessageA"(ByVal Hwnd as Long, ByVal wMsg as Long, ByVal wParam as Long, ByVal lParam as Long) as Long 或: Public Declare Function SendMessageStr Lib "User32" Alias "SendMessageA"(ByVal Hwnd as Long, ByVal wMsg as Long, ByVal wParam as Long, lParam as String) as Long 注意API参数类型本身是不会改变的.例子中的第四个参数总是一个4字节的长型数.当你按值(ByVal)传递一个Long或Null时,该4字节长的数值就直接传递给函数.如果你传递一个String或其他的什么,你是按引用(ByRef)传递,VB 传递的实际上是变量的地址,也是4个字节. 参数传递你已经知道如何传递参数了,只需把他放到调用的函数中即刻.然而,当你使用API函数时,在传递参数是有一些你应该注意的细节. ByVal还是ByRef. 通常情况下,你不用为此担心,VB的API浏览器已经为你做好了一切,只需你输入数值它就会照所声明的方式传递.总的来说,ByVal是把实际的数值传递给函数,而ByRef是把地址传给函数.唯一的麻烦就是Any 类型. 把字符串传递给API函数也并不难.API 函数需要的是字符串首字符的地址,然后读取该地址直到遇到一个Null字符.听起来很糟糕,但只是VB处理字符串的实际方法.你唯一要记住的是一定要按引用传递(ByRef)字符串当你想得到所需的函数返回值信息时,情况有稍微的一点不同. 这里是GetComputerName函数的声明: Declare Function GetComputerName Lib "kernel32" Alias "GetComputerNameA"(ByVal lpBuffer As String, nSize As Long) As Long 第一个参数是一个指向字符串的远程指针,第二个参数是字符串的长度. 如果你只是简单的声明一个字符串类型的变量并把它传递给函数,就会出现错误.因此,你首先需要初始化字符串.这里是如何得到计算机名字的例子: Dim Buffer As String Buffer = Space(255) Ret& = GetComputerName(Buffer, Len(Buffer)) if Ret& > 0 then CompName$ = Left(Buffer, Ret&) 在这里,待传递的字符串被初始化为有255个空格的字符串.我们把它传递给函数同时还有它的长度.如果出错则返回值为0. CompName中将保存计算机名. 有些函数也需要传递数组,这里是一个例子: Declare Function SetSysColors Lib "user32" Alias "SetSysColors" (ByVal nChanges As Long, lpSysColor As Long, lpColorValues As Long) As Long 最后两个参数是Long型数组.为了传递数组,你只需传递它的第一个元素.下面是示例代码: Const COLOR_ACTIVECAPTION = 2 Const COLOR_INACTIVECAPTION = 3 Const COLOR_CAPTIONTEXT = 9 Const COLOR_INACTIVECAPTIONTEXT = 19 Dim SysColor(3) As Long Dim ColorValues(3) As Long Dim Ret& SysColor(0) = COLOR_ACTIVECAPTION SysColor(1) = COLOR_INACTIVECAPTION SysColor(2) = COLOR_CAPTIONTEXT SysColor(3) = COLOR_INACTIVECAPTIONTEXT ColorValues(0) = RGB(58, 158, 58) '深绿ColorValues(1) = RGB(93, 193, 93) '浅绿ColorValues(2) = 0 '黑色ColorValues(3) = RGB(126, 126, 126) '灰色Ret& = SetSysColors(4&, SysColor(0), ColorValues(0)) 该程序将改变所有活动和非活动窗口的标题栏背景和文本的颜色. 回调(CallBacks) 所谓回调,就是你自己定义一个函数,并告诉Windows何时为何调用.你可以写一个有特定数量和类型参数的函数,然后告诉Windows何时调用,并传递给它所需的参数.Windows就会调用你定义的函数,处理参数,并给你返回值. 回调的一个典型应用是从Windows获得连续的数据流.这里是一个需要回调的函数的声明: Declare Function EnumWindows Lib "User32"ByVal lpEnumFunc As Long, ByVal lParam As Long) As Long 第一个参数是你的回调函数的地址,第二个参数是你想传递的的任意数值.该值将被传递到你的函数,于是你就知道了它要调用什么. VB 5.0已经提供了一个很有用的操作符AddressOf ,可以得到一个函数的地址.当你调用一个函数时它只能用在参数的前面,下面这种用法是错误的并且会导致出错: FuncP = AddressOf MyFunction 因此你必须这样调用EnumWindows函数: Success& = EnumWindows(AddressOf cbFunc, 58&) 你必须也要自己写回调函数.问题是有很多不同类别的回调并且有各种各样的参数,有关这些参数的描述可以在SDK帮助或MS SDK文档中找到.这里是一个回调的声明: Function cbFunc (ByVal Hwnd, ByVal lParam) as Long 这里是一个回调的例子: Private Declare Function GetWindowText Lib "user32" Alias "GetWindowTextA"(ByVal hwnd As Long,ByVal lpString As String,ByVal cch As Long) As Long Success& = EnumWindows(AddressOf cbFunc, 58&) Function cbFunc (ByVal Hwnd, ByVal lParam) as Long If lParam = 58 then 'enum windows Str$ = Space(255) Ret& = GetWindowText(Str$, Len(Str$)) Debug.Print Left(Str$, Ret&) End If End Function 这个例子将列出窗口的标题,(不包含子窗体) 窗口程序Windows并不知道事件. 这些是VB特有的隐藏Windows获取你的窗口发生事件的真正方法的一种方式.VB很像是一个将Windows 语言翻译成VB语言的解释器. 但是事实并非如此,你很快就会遇到.设想你想知道用户何时加亮了菜单选项(不是点击,只是加亮即选择了)VB并不提供这种事件,但你可能见到其他的程序,但你浏览它的菜单时状态栏会出现相应的文字.如果他们能,你为何不能? OK,这里是大致的真实情况.每个窗口都有一个特殊的程序叫做窗口程序.它实际上是一个回调函数.该函数将在你的窗口发生事件的任何时间发送消息.这样当用户加亮一个菜单项时就会发送一条消息(WM_COMMAND). 那为什么我看不到这条消息呢?这是因为是VB创建窗口程序而不是你.当Windows发送消息时,该程序将为之分派特定的事件,并将其参数转换为比较容易用的事件的参数.但是在有些情况下,它会忽略有些消息而不能收到真实的输入.如果你真的想得到这些消息,你必须对你的窗体进行子类处理,我们将在另外一个主题中谈到. 这里是一个回调窗口程序的声明: Function WindowProc(ByVal Hwnd As Long, ByVal wMsg As Long,ByVal wParam As Long, ByVal lParam As Long) As Long 第一个参数指定窗口的句柄,第二个参数是消息的标识符(如WM_COMMAND或WM_MOUSEMOVE),wParam和lParam时两个32位的数值,它们的意义依赖于消息的类型. 子类处理当你一最大限度利用了VB所给你的并且还想知道更多的东西,或只是想更多地了解你自己的窗口,你将会发现子类处理的优势. 子类处理是指用一个新的窗口函数来取代当前活动窗口函数.这个用户自定义函数能处理任何需要的消息,并能调用原来的窗口函数,它将在原来的窗口函数之前收到各种消息.但原来的那个窗口处理函数依然存在,并没有消失.如果你不想处理某条消息,你应该让原来的窗口函数去处理它. 子类处理是通过调用SetWindowLong函数实现的,该函数将改变指定窗口的特殊属性.下面是它的声明: Declare Function SetWindowLong Lib "user32" Alias "SetWindowLongA"(ByVal hwnd As Long, ByVal nIndex As Long,ByVal dwNewLong As Long) As Long 第一个参数代表要进行子类处理的窗口,第二个参数应该是GWL_WNDPROC(-4),第三个参数是新的窗口函数的地址.参见回调和窗口函数一节. 此函数将在窗口取得焦点,发生事件,或其他情况下(如其他进程改变了系统的某些参数)被随时调用. 如果发生错误SetWindowLong函数将返回0,否则将返回原来的窗口函数的地址.这个地址特别重要,你应该把它保存在一个变量中或其他地方.当你不处理某些消息时(实际上,你可能只处理不到1%的消息,其他的都将由原窗口函数处理),调用原来的窗口函数就需要该地址. 调用原窗口函数将由CallWindowProc来完成.这里是它的声明: Declare Function CallWindowProc Lib "user32" Alias"CallWindowProcA"(ByVal lpPrevWndFunc As Long,ByVal hWnd As Long,ByVal Msg As Long,ByVal wParam As Long, ByVal lParam As Long) As Long 第一个参数是原窗口函数的地址,其他的同你接收到的四个参数一样.你可以改变其中的值来控制对消息的处理.例如,当你收到了一条WM_MOUSEMOVE消息时,你从lParam中得到鼠标所在位置的坐标并将其改成了其他的坐标.那么原窗口函数就会认为鼠标位于其他的位置从而做出一些有趣的事如显示其他控件的Tooltip. 你指定的返回值也是有意义的,它依赖于发送的消息. 在结束你的程序时将控制权交回给原窗口函数是很重要的,通常在Form_Unload中完成如下: Ret& = SetWindowLong(Me.Hwnd, GWL_WNDPROC, oldWndProcAddress) 如果你在VB中启动程序时忘掉了这一行,结果将是VB崩溃并会丢失尚未保存的数据.千万要小心. 这里是子类处理的一个简单示例: Dim oldWndProc As Long Private Sub Form_Load() oldWndProc = SetWindowLong(Me.Hwnd, GWL_WNDPROC, AddressOf MyWndProc) End Sub Private Sub Form_Unload() Ret& = SetWindowLong(Me.Hwnd, GWL_WNDPROC, oldWndProc) End Sub Function MyWndProc(ByVal Hwnd As Long,ByVal wMsg as Long,ByVal wParam As Long,ByVal lParam As Long) Debug.Print wMsg & " " & wParam & " " & lParam Ret& = CallWindowProc(oldWndProc, Hwnd, wMsg, wParam, lParam) End Function 处理参数有时函数并不以你所需的方式返回信息.一个典型的例子是将两个代表鼠标位置的整形(2 byte)数合并为一个4 Byte的数.还有一个例子是判断一个数的某位是否为1.你还可能得到一个代表一个结构地址的Long型数. 合并和分离一个数并不需要过多的描述。

应用程序接口(API)

应用程序接口(API)

应用程序接口(API)应用程序接口(API)是允许两个软件程序相互通信的代码。

API定义了开发人员从操作系统(OS)或其他应用程序请求服务并在不同上下文和多个通道中公开数据的正确方法。

在Web 2.0的早期,将来自不同来源的数据和应用程序集成的概念称为mashup。

任何数据都可以与应用程序接口共享。

API 由动词和名词组成的函数调用实现。

所调用的应用程序的文档中描述了所需的语法。

例如,在房地产网站上,一个API可能用于按地理位置发布可用的房地产属性,而第二个API为访问者提供当前利率,第三个API提供抵押计算器。

使用API公开数据可以改善客户体验,因为它在单个应用程序或其他数字财产中提供更多功能和服务范围。

例如,通过预测客户与搜索房地产相关的需求,发布网站的公司不仅增加了向用户提供的价值,而且还为与相关服务提供商的新业务伙伴关系开辟了机会。

API如何工作API由两个相关元素组成。

第一个是描述如何在程序之间交换信息的规范,以处理请求和返回必要数据的形式完成。

第二个是写入该规范的软件接口,并以某种方式发布以供使用。

据说想要访问API的特性和功能的软件可以调用它,并且创建API的软件据说可以发布它。

三种基本类型的APIAPI采用三种基本形式:私有,公共和合作伙伴。

私有API或内部API在内部发布,供公司开发人员用于改进其自己的产品和服务。

私有API不会暴露给第三方。

公共API或开放API是公开发布的,可供任何第三方使用。

这些API没有限制。

合作伙伴API只能由公司同意共享数据的特定方使用。

合作伙伴API用于业务关系中,通常用于在合作公司之间集成软件。

API可以进一步分类为本地,Web或程序API:本地API是原始形式,名称来自该形式。

它们为应用程序提供OS或中间件服务。

Microsoft的.NET API,用于语音应用程序的TAPI (Telephony API)和数据库访问API是本地API表单的示例。

  1. 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
  2. 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
  3. 3、如文档侵犯您的权益,请联系客服反馈,我们会尽快为您处理(人工客服工作时间:9:00-18:30)。

API应用程序编程接口
API(Application Programming Interface,应用程序编程接口)是一些预先定义的函数,目的是提供应用程序与开发人员基于某软件或硬件的以访问一组例程的能力,而又无需访问源码,或理解内部工作机制的细节。

API除了有应用“应用程序接口”的意思外,还特指API的说明文档,也称为帮助文档。

另外,也是美国石油协会、空气污染指数、医药、空中位置指示器的英文简称。

Windows API是一套用来控制Windows的各个部件(从桌面的外观到为一个新进程分配的内存)的外观和行为的一套预先定义的Windows函数.用户的每个动作都会引发一个或几个函数的运行以告
诉Windows发生了什么.
这在某种程度上很象Windows的天然代码.其他的语言只是提供一种能自动而且更容易的访问API的方法.VB在这方面作了很多工作.它完全隐藏了API并且提供了在Windows环境下编程的一种完全不同的方法. 这也就是说,你用VB写出的每行代码都会被VB转换为API函数传递给Windows.例如,Form1.Print...VB 将会以一定的参数(你的代码中提供的,或是默认参数)调用TextOut 这个API函数。

同样,当你点击窗体上的一个按钮时,Windows会发送一个消息给窗体(这对于你来说是隐藏的),VB获取这个调用并经过分析后生成一个
特定事件(Button_Click).
API函数包含在Windows系统目录下的动态连接库文件中(如User32.dll,GDI32.dll,Shell32.dll...).
更易理解地说:Windows 这个多作业系统除了协调应用程式的执行、分配内存、管理系统资源…之外,她同时也是一个很大的服务中心,调用这个服务中心的各种服务(每一种服务就是一个函数),可以帮应用程式达到开启视窗、描绘图形、使用周边设备…等目的,由於这些函数服务的对象是应用程式(Application),所以便称之为Application Programming Interface,简称API 函数。

WIN32 API也就是MicrosoftWindows 32位平台的应用程序编程接口。

凡是在Windows 工作环境底下执行的应用程式,都可以
调用Windows API。

API的历史与现状
当WINDOWS操作系统开始占据主导地位的时候,开发WINDOWS平台下的应用程序成为人们的需要。

而在WINDOWS程序设计领域处于发展的初期,WINDOWS程序员所能使用的编程工具唯有API函数,这些函数是WINDOWS提供给应用程序与操作系统的接口,他们犹如“积木块”一样,可以搭建出各种界面丰富,功能灵活的应用程序。

所以可以认为API函数是构筑整个WINDOWS框架的基石,在它的下面是WINDOWS的操作系统核心,而它的上面则是所有的华丽的WINDOWS应用程序。

但是,没有合适的Windows编程平台,程序员想编写具有Windows风格的软件,必须借助API,API也因此被赋予至高无上的地位。

那时的WINDOWS程序开发还是比较复杂的工作,程序员必须熟记一大堆常用的API函数,而且还得对WINDOWS操作系统有深入的了解。

然而随着软件技术的不断发展,在WINDOWS平台上出现了很多优秀的可视化编程环境,程序员可以采用“即见即所得”的编程方式来开发具有精美用户界面和功能强大的应用程序。

这些优秀可视化编程环境操作简单、界面友好(诸如VB、VC++、DELPHI等),在这些工具中提供了大量的类库和各种控件,它们替代了API的神秘功能,事实上这些类库和控件都是构架在WIN32 API函数基础之上的,是封装了的API函数的集合。

它们把常用的API函数的组合在一起成为一个控件或类库,并赋予其方便的使用方法,所以极大的加速了WINDOWS应用程序开发的过程。


了这些控件和类库,程序员便可以把主要精力放在程序整体功能的设
计上,而不必过于关注技术细节。

实际上如果我们要开发出更灵活、更实用、更具效率的应用程序,必然要涉及到直接使用API函数,虽然类库和控件使应用程序的开发简单的多,但它们只提供WINDOWS的一般功能,对于比较复杂和特殊的功能来说,使用类库和控件是非常难以实现的,这时就
需要采用API函数来实现。

API 声明
正如在"什么是API"中所说,API函数包含在位于系统目录下的DLL文件中.你可以自己输入API函数的声明,但VB提供了一种更简单的方法,即使用API Text Viewer. 要想在你的工程中声明API函数,只需运行API Text Viewer,打开Win32api.txt(或.MDB如果你已经把它转换成了数据库的话,这样可以加快速度.注:微软的这个文件有很多的不足,你可以试一下本站提供下载的api32.txt),选择"声明",找到所需函数,点击"添加(Add)"并"复制(Copy)",然后粘贴(Paste)到你的工程里.使用预定义的常量和类型也是同样的方法. API除了有应用“应用程序接口”的意思外,还特指API的说明文档,也称为帮助文档。

你将会遇到一些问题:
假设你想在你的窗体模块中声明一个函数.粘贴然后运行,VB 会告诉你:编译错误...Declare 语句不允许作为类或对象模块中的Public 成员...看起来很糟糕,其实你需要做的只是在声明前面添加一
个Private(如Private Declare Function...).--不要忘了,可是这将使该函数只在该窗体模块可用. 在有些情况下,你会得到"不明确的名称"这样的提示,这是因为函数.常量或其他的什么东西共用了一个名称.由于绝大多数的函数(也可能是全部,我没有验证过)都进行了别名化,亦即意味着你可以通过Alias子句使用其它的而不是他们原有的名称,你只需简单地改变一下函数名称而它仍然可以正常运行.
API 分为四种类型:
远程过程调用(RPC):通过作用在共享数据缓存器上的过
程(或任务)实现程序间的通信。

标准查询语言(SQL):是标准的访问数据的查询语言,通过通用数据库实现应用程序间的数据共享。

文件传输:文件传输通过发送格式化文件实现应用程序间数
据共享。

信息交付:指松耦合或紧耦合应用程序间的小型格式化信息,通过程序间的直接通信实现数据共享。

当前应用于API 的标准包括ANSI 标准SQL API。

另外还有一些应用于其它类型的标准尚在制定之中。

API 可以应用于所有计算机平台和操作系统。

这些API 以不同的格式连接数据(如共享数据缓存器、数据库结构、文件框架)。

每种数据格式要求以不同的数据命令和参数实现正确的数据通信,但同时也会产生不同类型的错误。

因此,除了具备执行数据共享任务所需的知识以外,这些类型的
API 还必须解决很多网络参数问题和可能的差错条件,即每个应用程序都必须清楚自身是否有强大的性能支持程序间通信。

相反由于这种API 只处理一种信息格式,所以该情形下的信息交付API 只提供较小的命令、网络参数以及差错条件子集。

正因为如此,交付API 方式大大降低了系统复杂性,所以当应用程序需要通过多个平台实现数据共享时,采用信息交付API 类型是比较理想的选择。

API 与图形用户接口(GUI)或命令接口有着鲜明的差别:
API 接口属于一种操作系统或程序接口,而后两者都属于直接用户接口。

有时公司会将API 作为其公共开放系统。

也就是说,公司制定自己的系统接口标准,当需要执行系统整合、自定义和程序应用等操作时,公司所有成员都可以通过该接口标准调用源代码,该
接口标准被称之为开放式API。

相关文档
最新文档