[发明专利]经定性化注释的代码

说明书

背景

应用程序、程序、函数、以及其它可编程和可执行代码的程序集 (assemblage)通常是为第三方(即，“客户”)的使用而编写的。因此，有 效代码是以一种启用第三方使用情景并且满足第三方期望的方式来编写的。

概述

由于应用程序、程序、函数、以及其它可编程和可执行代码的程序集被模 块化，所以可以对与至少一个这样的代码模块相关联的数据进行注释以便提供 关于模块使用的定性化向导。

附图简述

本描述参考以下附图。

图1示出通过网络与实现产生并利用经注释的代码中的至少一种的示例技 术的设备进行通信的设备。

图2示出用于实现产生并利用经注释的代码中的至少一种的示例性技术的 执行环境的示例。

图3示出关于产生经注释的代码的一个示例的工具的示例数据流。

图4示出关于利用经注释的代码的工具的示例数据流。

详细描述

此处描述用于产生经注释的代码并使用该注释以提供关于代码使用的向 导的工具、系统和方法。此外，有关对代码的至少数部分进行注释并使用该注 释的描述可涉及用于将代码的数部分的预期使用告知客户的工具、系统、过程、 指令、技术和例程。即，通过采用表示例如代码的相应部分的功能性意图的角 色或分类来注释代码的至少一些部分，可允许客户编写不太可能被破坏或崩溃 的高效的应用程序、程序、函数、或其它可编程和可执行代码的程序集。此外， 这种工具、系统和过程可在网络环境中的一个或多个设备或节点中实现。

此处描述的“模块”可表示可使用公共物理和/或逻辑资源的诸如方法、类、 DLL(动态链接库)、框架等独立实体。

此处描述的“程序集”可表示代码的部署单元。

图1示出在其中实现生成经注释的代码并利用该注释来提供关于代码使用 的向导的示例技术的示例网络环境100。然而，该示例技术并不局限于网络环 境。该技术可包括，但不限于，此处描述的与经定性化注释的代码120相关联 的工具、方法(例如，技术)和系统。在图1中，客户机设备105、服务器设 备110以及“其它”设备115可以通过网络125以通信方式彼此耦合；并且此 外，客户机设备105、服务器设备110以及“其它”设备115中的至少一个能 够实现上述技术。

客户机设备105可表示各种已知计算设备中的至少一个，包括能够实现产 生和使用经定性化注释的代码120中的至少一个的示例技术的台式个人计算机 (PC)、工作站、大型计算机、因特网设备、机顶盒或游戏控制台。客户机设 备105还可表示能够通过有线和/或无线链路与网络125相关联的至少一个设 备，这些设备包括移动(即，蜂窝)电话、个人数字助理(PDA)、膝上型计 算机等。此外，客户机设备105可按各种数量和/或其组合来表示上述客户机设 备。“其它”设备115也可由上述客户机设备105的示例中的任一个来实施。

服务器设备110可表示能够根据产生和使用经定性化注释的代码120中的 至少一个的至少一个实现向客户机设备105或“其它”设备115提供各种数据 和/或功能中的任何一种的任何设备。数据可以公共可获得或者受限制的，例如， 仅限于某些用户或只有当支付了适当的订阅费或许可费时才可用。服务器设备 110可以是网络服务器、应用程序服务器、刀片服务器或其任意组合中的至少 一个。通常，服务器设备110可表示作为内容源的任何设备，而客户机设备105 可表示通过网络125或者以离线方式接收这样的内容的任何设备。然而，根据 此处描述的示例实现，客户机设备105和服务器设备110可互换地成为网络环 境100中的发送节点或接收节点。“其它设备”还可由服务器设备110的上述 示例中的任何一个来实施。

“其它”设备115可以表示根据此处描述的一个或多个示例技术的能够开 发和/或使用经定性化注释的代码120的任何另外的设备。即，“其它”设备 115可以表示能够采用角色或分类对至少一部分代码进行注释的设备，其中该 角色或分类指示例如代码的相应部分的功能性意图和/或根据所赋予的角色向 客户提供关于该部分代码使用的向导。因此，“其它”设备115可以是在其上 实现了操作系统、解释器、转换器、编译器、或运行时执行环境中的任何一个 的计算或处理设备。这些示例并不意在以任何方式为限制性的，并且因此，不 应该以那种方式来解释。