经定性化注释的代码制造技术

可以对与至少一个代码模块相关联的数据进行注释，以便提供关于该模块的使用的向导。

【技术实现步骤摘要】
【国外来华专利技术】经定性化注释的代码 背景应用程序、程序、函数、以及其它可编程和可执行代码的程序集(assemblage)通常是为第三方(即，"客户")的使用而编写的。因此，有 效代码是以一种启用第三方使用情景并且满足第三方期望的方式来编写的。概述由于应用程序、程序、函数、以及其它可编程和可执行代码的程序集被模 块化，所以可以对与至少一个这样的代码模块相关联的数据进行注释以便提供 关于模块使用的定性化向导。附图简述本描述参考以下附图。附图说明图1示出通过网络与实现产生并利用经注释的代码中的至少一种的示例技 术的设备进行通信的设备。图2示出用于实现产生并利用经注释的代码中的至少一种的示例性技术的 执行环境的示例。图3示出关于产生经注释的代码的一个示例的工具的示例数据流。图4示出关于利用经注释的代码的工具的示例数据流。详细描述此处描述用于产生经注释的代码并使用该注释以提供关于代码使用的向 导的工具、系统和方法。此外，有关对代码的至少数部分进行注释并使用该注 释的描述可涉及用于将代码的数部分的预期使用告知客户的工具、系统、过程、 指令、技术和例程。即，通过采用表示例如代码的相应部分的功能性意图的角 色或分类来注释代码的至少一些部分，可允许客户编写不太可能被破坏或崩溃的高效的应用程序、程序、函数、或其它可编程和可执行代码的程序集。此外， 这种工具、系统和过程可在网络环境中的一个或多个设备或节点中实现。此处描述的"模块"可表示可使用公共物理和/或逻辑资源的诸如方法、类、 DLL (动态链接库)、框架等独立实体。此处描述的"程序集"可表示代码的部署单元。图1示出在其中实现生成经注释的代码并利用该注释来提供关于代码使用的向导的示例技术的示例网络环境100。然而，该示例技术并不局限于网络环 境。该技术可包括，但不限于，此处描述的与经定性化注释的代码120相关联 的工具、方法(例如，技术)和系统。在图1中，客户机设备105、服务器设 备10以及"其它"设备115可以通过网络125以通信方式彼此耦合；并且此 外，客户机设备105、服务器设备110以及"其它"设备115中的至少一个能 够实现上述技术。客户机设备105可表示各种已知计算设备中的至少一个，包括能够实现产 生和使用经定性化注释的代码120中的至少一个的示例技术的台式个人计算机 (PC)、工作站、大型计算机、因特网设备、机顶盒或游戏控制台。客户机设 备105还可表示能够通过有线和/或无线链路与网络125相关联的至少一个设 备，这些设备包括移动(即，蜂窝)电话、个人数字助理(PDA)、膝上型计 算机等。此外，客户机设备105可按各种数量和/或其组合来表示上述客户机设 备。"其它"设备115也可由上述客户机设备105的示例中的任一个来实施。服务器设备IIO可表示能够根据产生和使用经定性化注释的代码120中的 至少一个的至少一个实现向客户机设备105或"其它"设备115提供各种数据 和/或功能中的任何一种的任何设备。数据可以公共可获得或者受限制的，例如， 仅限于某些用户或只有当支付了适当的订阅费或许可费时才可用。服务器设备 IIO可以是网络服务器、应用程序服务器、刀片服务器或其任意组合中的至少 一个。通常，服务器设备IIO可表示作为内容源的任何设备，而客户机设备105 可表示通过网络125或者以离线方式接收这样的内容的任何设备。然而，根据 此处描述的示例实现，客户机设备105和服务器设备IIO可互换地成为网络环 境100中的发送节点或接收节点。"其它设备"还可由服务器设备110的上述 示例中的任何一个来实施。"其它"设备115可以表示根据此处描述的一个或多个示例技术的能够开 发和/或使用经定性化注释的代码120的任何另外的设备。S卩，"其它"设备115可以表示能够采用角色或分类对至少一部分代码进行注释的设备，其中该角色或分类指示例如代码的相应部分的功能性意图和/或根据所赋予的角色向客户提供关于该部分代码使用的向导。因此，"其它"设备115可以是在其上 实现了操作系统、解释器、转换器、编译器、或运行时执行环境中的任何一个 的计算或处理设备。这些示例并不意在以任何方式为限制性的，并且因此，不 应该以那种方式来解释。网络125可以表示包括有线和/或无线网络等各种常规网络拓扑和类型中 的任何一种。网络125还可采用包括公共和/或专用协议等各种常规网络协议中 的任何一种。网络125可包括(例如)因特网以及诸如802.11系统等一个或多 个局域网(也被个别地称为"LAN")，或者规模更大一点的广域网(即， "WAN")，或者诸如蓝牙等个人区域网(即，PAN)中的至少一些部分。设备105、 110及115中的至少一个设备中的计算机体系结构通常按照硬 件与软件来定义计算平台。用于计算设备的软件基于功能被归类成组，这些组 包括硬件抽象层(或者称为"HAL")、操作系统(或者称为"OS")以及 应用程序。运行时执行环境可驻留在OS与应用程序、程序、函数、或其它代码的程 序集之间。运行时执行环境可用作一个空间，在该空间中，应用程序、程序、 函数、或其它代码的程序集可在处理设备105、 110和115中的一个或多个设 备上执行具体任务。更具体地，运行时执行环境可通过向在包括服务器、台式 计算机、膝上型计算机、和移动处理/通信设备等范围不断增加的处理设备105、 110和115上运行的应用程序提供抽象层和服务并进一步向该应用程序提供包 括存储器管理及其配置的能力，来提高在这些处理设备上执行应用程序、程序、 函数、或其它代码的程序集的可靠性。运行时执行环境可用作编程和执行平台中的至少一种。作为编程平台，运 行时执行环境可将以多种计算语言中的一种语言编写的一个或多个目标应用 程序、程序、函数、或其它代码的程序集编译为中间语言(下文称"IL")或 字节代码。IL通常独立于平台，并且中央处理单元(下文称"CPU")执行IL。 事实上，IL是比许多CPU机器语言更高级的语言。作为执行平台，运行时执行环境可将已编译的IL解释成本机机器指令。 运行时执行环境可以采用解释器或者编译器(例如，"即时(just-in-time)"， 或称JIT编译器)来执行这样的指令。不管怎样，接着，本机机器指令可被CPU 直接执行。由于IL是独立于CPU的，因此只要在任何CPU平台上运行的OS 主宿适当的运行时执行环境，IL即可在该CPU平台上执行。或者，应用程序、程序、函数、或其它代码的程序集中的至少数部分可作 为本机映像文件在运行时执行环境中被预编译和安装，由此绕开了 JIT编译所 需要的CPU消耗。有效的是，预编译部分是以IL格式(例如，程序集、方法 或类型)而不是以本机平台执行格式分发的软件组件。这种预编译IL的源可 被置于非托管执行环境中或在设备105、 110和115中的同一个或不同的设备 上的运行时执行环境的单独实现中。该源可在与该预编译IL对应的应用程序、 程序、方法、函数或其它可编程和可执行代码的程序集的安装时期间或之前部 署预编译IL。不管怎样，在其中实现生成和/或利用经定性化注释的代码120的运行时环 境的示例包括Visual Basic运行时环境；用于运行例如Java 例程的Java 虚 拟机运行时环境；或本文档来自技高网...

【技术保护点】
至少一种具有存储于其上的数据结构的计算机可读介质，所述数据结构包括：　应用程序编程接口（ＡＰＩ）；以及　基于所述ＡＰＩ的定性化属性来规定编程向导的注释。

【技术特征摘要】
【国外来华专利技术】...

【专利技术属性】
技术研发人员：R玛丽安尼，
申请(专利权)人：微软公司，
类型：发明
国别省市：US[美国]