# Patent

## Title
Annotation processing of computer files

## Abstract

A method and apparatus for annotation processing of computer files. An embodiment of A method for processing a data stream includes receiving a data stream input at a scanner component, where the data stream input represents multiple program elements. The data stream input is scanned for annotations, with scanning the data stream input including: encountering a description of a data type; informing a handler component regarding the data type description; determining whether to process program elements within the data type, with the determination being based at least in part on any messages received from the handler component indicating that data type is not of interest; and, if there is a determination to process the program elements in the data type, scanning the program elements of the type to identify annotated program elements and associated annotation values.

## Background
RELATED APPLICATIONS
This application is related to and claims priority to U.S. provisional patent application 60/953,935, entitled “Annotation Processing of Computer Files”, filed Aug. 3, 2007, which is hereby incorporated herein by reference in its entirety.
This application is further related to:

    
    
        U.S. patent application Ser. No. 11/648,065, entitled “Computer File System Traversal”, filed Dec. 30, 2006;
        U.S. patent application Ser. No. 12/184,896, entitled “Computer Archive Traversal”, filed Aug. 1, 2008, claiming priority to U.S. provisional application 60/953,932, filed Aug. 3, 2007;
        U.S. patent application Ser. No. 12/184,904, entitled “Computer File Processing”, filed Aug. 1, 2008, claiming priority to U.S. provisional application 60/953,933, filed Aug. 3, 2007;
        U.S. patent application Ser. No. 12/184,915, entitled “Annotation Data Filtering of Computer Files”, filed Aug. 1, 2008, claiming priority to U.S. provisional application 60/953,937, filed Aug. 3, 2007;
        U.S. patent application Ser. No. 12/184,924, entitled “Annotation Data Handlers for Data Stream Processing”, filed Aug. 1, 2008, claiming priority to U.S. provisional application 60/953,938, filed Aug. 3, 2007;
        U.S. patent application Ser. No. 12/184,932, entitled “Dependency Processing of Computer Files”, filed Aug. 1, 2008, claiming priority to U.S. provisional application 60/953,963, filed Aug. 3, 2007; and
        U.S. patent application Ser. No. 12/184,938, entitled “Data Listeners for Type Dependency Processing”, filed Aug. 1, 2008, claiming priority to U.S. provisional application 60/953,964, filed Aug. 3, 2007.
    
    




TECHNICAL FIELD
Embodiments of the invention generally relate to the field of computer systems and, more particularly, to a method and apparatus for annotation processing of computer files.
BACKGROUND
Computer files, such as Java class files, may have specific standard formats. The standard formats of computer may limit the data that can be provided in relation to the files. For this reason, annotations may be provided to add additional information regarding computer files. Annotations may potentially be found anywhere within a set of computer files.
In a particular example, Java allows annotations to Java class files, with the practice now being specifically described in annotations under Java release 5.0 (Java under the JDK (Java Development Kit) 5.0) as provided in JSR-175 recommendation regarding code annotations. The annotations may add guidance regarding certain class files. Thus, a Java class file may include one or more annotations associated with program elements.
It may become necessary or useful to determine what annotations are present in a set of computer files. However, locating annotations within files can be time consuming and inefficient because the process generally requires searching through all of the files, which may be in the form of a hierarchical file structure or contained within an archive.
SUMMARY OF THE INVENTION
A method and apparatus are provided for annotation processing of computer files.
In a first aspect of the invention, an embodiment of a method includes receiving a data stream input at a scanner component, where the data stream input represents multiple program elements. The data stream input is scanned for annotations, with scanning the data stream input including: encountering a description of a data type; informing a handler component regarding the data type description; determining whether to process program elements within the data type, with the determination being based at least in part on any messages received from the handler component indicating that the data type is not of interest; and, if there is a determination to process the program elements in the data type, scanning the program elements of the type to identify annotated program elements and associated annotation values.
In a second aspect of the invention, a embodiment of a system includes a data scanning module, where the data scanning module is to receive a data stream input containing multiple program elements and is to scan the data stream input for annotations to the program elements, the data scanning module to provide notice when a data type description is encountered. The system further includes a data handling module, where the data handling module is to receive the notice regarding the data type description, the data handling module to provide a callback control flow to notify the data scanning module if the data type is not of interest.



BRIEF DESCRIPTION OF THE DRAWINGS
Embodiments of the invention are illustrated by way of example, and not by way of limitation, in the figures of the accompanying drawings in which like reference numerals refer to similar elements.
FIG. 1 is an illustration of an embodiment of processing of computer file data;
FIG. 2 is an illustration of a computer file processing system;
FIG. 3 is an illustration of an embodiment of a system to process annotated program elements;
FIG. 4 is a flowchart to illustrate an embodiment of the scanning of a serial data stream for annotations to class file elements;
FIG. 5 is an illustration of an embodiment of a class file program element as a data stream;
FIG. 6 is an illustration of an embodiment of an annotation to a class file program element presented as a data stream;
FIG. 7 is an embodiment of library utilities;
FIG. 8 is an illustration of a computer system in an embodiment of the invention; and
FIG. 9 illustrates an embodiment of a client-server network system.



DETAILED DESCRIPTION
Embodiments of the invention are generally directed to annotation processing of computer files.
As used herein:
“Annotation” means additional information or metadata that is associated with or attached to a particular point in a computer program. The term annotation includes formal and informal annotation methods, including, but not limited to, annotations under Java release 5.0 (Java under the JDK (Java Development Kit) 5.0) as provided in JSR (Java Specification Request) 175 recommendation regarding code annotations (“A Metadata Facility for the Java Programming Language”).
“Computer file” means any file structure used in a computer system. Computer files include files with specific required structures, including Java class files.
“Class file” means a Java class file. A Java class file is a defined format for compiled Java code, which may then be loaded and executed by any Java virtual machine. The format and structure for a Java class file is provided in JSR 000202, Java Class File Specification Update (Oct. 2, 2006) and subsequent specifications.
“Traversal” means a process for progressing through the elements of a computer system, including a process for progressing through the elements of a computer archive.
“Archive” means a single file that may contain one or more separate files. An archive may also be empty. The files within an archive are extracted, or separated, from the archive for use by a computer program. The files contained within an archive are commonly compressed, and the compressed files are decompressed prior to use. An archive may further include data required to extract the files from the archive. “Archive” may also refer to act of transferring one or more files into an archive.
In an embodiment of the invention, processing of computer files to identify annotations is provided. In an embodiment, the computer files are in the form of a serial data stream, with the data stream being scanned for annotation occurrences. In one embodiment, a set of computer files includes a set of Java class files, where the Java class files include one or more annotations.
The Java platform has included various ad hoc mechanisms to provide annotations. Java release 5.0 (Java under the JDK (Java Development Kit) 5.0) includes a formal general purpose annotation (or metadata) facility, as provided in the JSR-175 recommendation regarding code annotations. The annotation facility permits a user to define and use the user's own annotation types. The facility includes a syntax for declaring annotation types, a syntax for annotating declarations, APIs for reading annotations, a class file representation for annotations, and an annotation processing tool. Annotations generally allow programmers to add attributes to computer code, including Java code. These attributes may be used for multiple purposes, including code documentation, code generation, and, during runtime, for providing special services such as enhanced business-level security or special business logic.
In an embodiment of the invention, annotation data is extracted into a neutral format to allow efficient filtering of annotations of interest. The annotations in a data stream are provided in a form to allow a scanner to address the elements in a data stream. In an embodiment, a type definition appears prior to any annotations on the elements of the particular type. In an embodiment, there is further an annotation announcement appearing directly before reporting the annotation value, thus informing a scanner to be forewarned that an annotation will follow.
In an embodiment of the invention, a process is provided to receive a data stream input representing a computer program or other computer files, scan the data stream for instances of annotations, and to generate a data stream output. The data stream output includes selected annotated elements and annotation values.
In an embodiment of the invention, a processing system includes a scanning module to scan the data stream input and output a data stream that includes selected annotated elements and annotation values. In an embodiment, the processing system further includes a handler module to handle the data stream output. In an embodiment, the handler module further provides feedback to the scanning module to direct the selection of annotations by the scanning module. In an embodiment, the file processor may include additional handlers to provide other functions. In one embodiment of the invention, a dedicated, independent processing module is provided for annotation processing, but embodiments of the invention are not limited to a dedicated module implementation.
In an embodiment of the invention, a scanner operates by sending data to the handler as it is identified in the data stream. In an embodiment, a type definition is thus received before receiving any of the program elements within the type, and thus also prior to any annotation value for the program elements within the type. In this manner, the handler may receive a type definition and may provide a callback to the scanner if the handler is not interested in annotations for type definition. If the handler indicates that it is not interested in any annotations for the type definition, the scanner may then skip any annotation values for the type definition.
In an embodiment of the invention, a set of computer files are processed in a single pass as a serial data stream without requiring multiple readings of the file data. In an embodiment, the same serial data stream format is maintained both on input and output, thereby allowing further processing of class files without further file conversion. In an embodiment, the same data format is used for the data input and the data output. In an embodiment, the data stream conversion allows processing without any dependency on random access files, and broadens the applicable scope of the process for the input. In an embodiment, the processing of class files as a data stream allows processing without requiring use of, for example, Java library utilities that may normally be required to conduct the file processing.
In an embodiment of the invention, the conversion of computer files to a data stream allows for the use of a protocol for both the data producer (the computer file processor) and the data consumer without creating a complete file representation, thereby simplifying the data structure. In an implementation for Java class files, the processing system operates with a class file data model, without requiring the addition of any major abstraction for data processing.
In an embodiment, the conversion of computer files to a serial data format may include, but is not limited to, the operation of a traversal of a hierarchical data structure or of a data archive as provided respectively in patent application Ser. No. 11/648,065, entitled “Computer File System Traversal”, filed Dec. 30, 2006. Other processes for conversion of a set of files to a serial data stream may also be utilized in embodiments of the invention.
In an embodiment of the invention, for the processing of computer files it is assumed that processing occurs on an inner loop for critical processing stages. In an embodiment, a system requires high performance for inner loop of class file processing itself.
In an embodiment of the invention, processing is designed to provide sufficient performance for overall computer file processing. For example, in an embodiment a system includes stream buffering to buffer data as it is obtained and processed. In addition, an embodiment of the invention provides a compact internal file state in the data stream, thereby minimizing the amount of data that will be required in the process of transferring and processing the computer files.
In an embodiment of the invention, a data scanner may be provided in multiple implementations, depending on the system requirements. A data scanner may be a portion of a file processor. In one example, native processing implementations may be provided for a computer file scanner, with the native implementations being based upon relevant Java standards. In another example, a non-native implementation may be provided, as required. A particular non-native implementation may include a BCEL (Byte Code Engineering Library) implementation, with the BCEL API being a toolkit for the static analysis and dynamic creation or transformation of Java class files.
In an embodiment of the invention, a data consumer that receives generated annotation output data is a main framework expansion point for which neutral utility implementations might be required. In an embodiment of the invention, a file processor (the data producer) operates using the same data protocol as the data consumer protocol. In an embodiment of the invention, the data consumer may have control over the data to be provided to the data consumer. In an embodiment, the data producer and the data consumer may operate to agree on the data to be provided from the serial data stream. In an embodiment of the invention, a system may include complexity control, including configuring the file processor to deliver the data of interest. In an embodiment, the data of interest includes data meeting a certain degree of detail, or certain types of data. In an embodiment of the invention, the structure of the data processing may allow for a system to be utilized with loose semantics and implementation constraints. For example, the technical framework and protocol data types may be defined. However, there may be leeway for implementation characteristics, such as the result order sequence and analysis capabilities.
In an embodiment of the invention, file processing may be included within a set of tools that are provided to search files. The tools may, for example, provide for the conversion of files into serial form by a traversal process, the scanning of data for desired elements, and other related processes.
FIG. 1 is an illustration of an embodiment of processing of computer file data. In this illustration, a computer file conversion module 105 is provided to convert computer file data into a serial data stream 110. The computer file data may be, but is not limited to, Java class file program elements. The conversion of the computer file data may include, but is not limited to, the traversal of a hierarchical file or archive. The output of the processing of computer file data is a serial data stream 110 representing the computer file data.
In an embodiment, the serial data stream includes one more annotations. For example, the data stream 110 is illustrated as a series of program elements arriving as a data stream 130. In this data stream, there is a type definition prior to any elements within the type, and an annotation announcement occurs prior to any annotations. For example, Type1 135 is a first type definition, which is followed by program element Element1 140 within Type1. Element1 140 is associated with an annotation, with ANNO1 145 being a first annotation announcement for annotation value AnnoValue1 150. The data stream further includes a second type definition Type2 155, which includes program elements Element2 160 and Element3 165. Element3 165 is associated with a second annotation, as shown by second annotation announcement ANNO2 170 and annotation value AnnoValue2 175.
In an embodiment of the invention, the serial data stream 110 then is provided to a data scanner 115, which processes the data, including scanning the data stream for program elements of interest, including annotations to the program elements within the data stream. The scanner 115 may contain multiple modules or sub-modules, depending on the particular embodiment. The scanner 115 outputs an extracted data stream 120, which represents elements of the data stream that have been selected by the scanner 115. In this implementation, the extracted data stream would contain the annotated program elements and associated annotation values. The extracted data stream 120 then is eventually provided to a data consumer 125. The consumer 125 may receive additional reports or data processing as required for the needs of the consumer 125.
FIG. 2 is an illustration of a computer file processing system 200. While this illustration shows the processes occurring within a single system for simplicity in description, the processes may occur in multiple systems, including multiple systems within a network. In this illustration, a computer file data stream input 205 is provided to a file processor 210, which may include a scanner to scan the data for desired program elements. The data stream 205 may, for example, represent Java class file data that has been converted into a serial data stream. The file processor 210 may include multiple components, depending on the particular embodiment of the invention. The file processor 210 generates an extracted computer file data stream 215, which may be presented to a data consumer 220.
In an embodiment of the invention, the operation of the computer file processing system 200 is directed by certain inputs and settings. The operation of the file processor 210 may be directed by a scanner configuration 225. In addition, a data mode configuration 230 affects both the file processor 210 and the data consumer 220. The file processor 210 also may include one of multiple implementations. In particular embodiments, the implementation may be a native implementation 235 or a BCEL (Byte Code Engineering Library) implementation 240. The BCEL implementation 240 may include the Apache BCEL process 245, as developed by the Apache Software Foundation. In addition, the consumer 220 may utilize a framework utility 250 and a framework extension 255 in the operation of the computer file processing.
FIG. 3 is an illustration of an embodiment of a system to process annotated program elements. The system 300 may include a data scanner 310 and a data handler 320. The data scanner 310 may, for example, represent the file processor 210 illustrated in FIG. 2 or a subpart of the file processor 210. The data handler 320 may represent the data consumer 220 illustrated in FIG. 2 or a subpart of the data consumer 210. In this illustration, the data scanner 310 is to scan a received data stream input 305 for annotations, and to produce a data stream containing selected annotated program elements and annotation values. The data handler 320 is to receive and handle the output of the scanner 310. The operation of the data handler includes the provision of feedback to the data scanner 315. As illustrated, in addition to any other functions, the data handler 320 provides a callback control flow 325 to inform the scanner whether particular program elements are desired. For example, the data scanner 310 may encounter a particular data type (such as a type description for a Java class file), and the data handler 320 may inform the data scanner 310 via the callback control flow 325 that annotations for the particular data type are not of interest. Upon being informed via the callback control flow 325 that annotations for the particular data type are not of interest, the data scanner 310 may then skip the elements in the data type.
The data scanner 310 may include a native implementation 340 and a BCEL implementation 345, illustrated with Apache BCEL 350. The implementations may be associated with a parsing module to parse type descriptors and identify the appropriate data types. Also illustrated are the scanner configuration 330 and the data mode configuration 335.
FIG. 4 is a flowchart to illustrate an embodiment of the scanning of a serial data stream for annotations to class file elements. In this illustration, a set of class files is converted into a serial class file data stream 400. The class file data stream may include, but is not limited to, a data stream generated through the traversal of a hierarchical file system or an archive.
The serial class file data stream 400 is received by a scanning module 405, which operates in conjunction with a handling module 410 to identify and output annotations of interest in the data stream. In this process, a particular type description is received in the data stream 415, and the handling module is informed regarding the class type that was encountered. There is then a determination whether the elements of the class type should be processed 420. This determination may be based at least in part on any feedback received from the handling module 410 indicating that the class type is not of interest 455. If the program elements in the class type should not be processed, then the elements in the class type are skipped and the process continues to a determination whether there are more program elements remaining 435. If the class is of interest, then the scanning module 405 scans the program elements for annotations 425.
If any annotations are found 430, then a data stream provided to the handling module 410 includes the annotated element and the annotation value 445. When no more program elements remain in the received data stream, then the process ends 440. The processing of program elements may include other processes not illustrated here, depending on the embodiment of the invention.
FIG. 5 is an illustration of an embodiment of a class file program element as a data stream. In this illustration, a class file program element 506 is shown within a code walk module 502 (used in the traversal of class files). The class file program element 506 is represented by an element type 508 (including an element kind, type name, and type flags), an element field 510 (also including an element name and element flags), and one or more element methods 512 (also including a method signature), and an element parameter 514 (paramldx). The element further includes a class file element record 516 in the code walk implementation 504, including one or more operations (defining field accessors, shallow or deep equality, ordering relation, binary serialization, and XML serialization).
FIG. 6 is an illustration of an embodiment of an annotation to a class file program element presented as a data stream. In this illustration, an annotation is represented in the code walk 602 as a class file annotation value 606, including whether the value is visible at runtime, a type name, and the annotation elements. The class file annotation value 606 is related to a particular named program element 608, which includes the element name. The annotated program element 610 includes the element tag and element value, as well as tag-specific accessors. The program element 610 is shown in relation to the annotation 614, as well as either Boolean 616, char (character) 618, double, float 620, byte, short, int (integer), or long 622. The program element further may include a string 624 or class 626, an enum (enumeration constant) 628, and an array 630. The enumeration constant 628 is illustrated 612 as including an enumeration type and enumeration literal.
The annotation is further illustrated as a class file annotation record 632 in a code walk implementation 604. The class file annotation record 632 includes operations, including shallow or deep equality, the ordering relation, binary serialization, and XML serialization 632. The class file annotation record 632 is shown in relation with the named element 634. Also illustrated are the annotated element 636 and the enumeration constant 638.
FIG. 7 is an embodiment of library utilities. FIG. 7 may illustrate software modules, hardware modules, or modules including a combination of software and hardware. In this illustration, the utilities relate to an interface layer comprising code walk interfaces (code.walk 780); for class file processing and file walk interfaces (file.walk 710) for locating files; and further to an implementation toolbox comprising code processing 750 and a code walk implementation (code.walk.impl 760) for class file processing, and file processing 755 and a file walk implementation (file.walk.impl 730) for locating files.
In the interface layer, the code walk interfaces 780 may include a class file annotation value interface module 782, a class file program element interface module 784, a class file annotation handler interface module 786, a class file annotation scanner interface module 788, a class file dependency scanner interface module 790, and a class file dependency listener interface module 792. The file walk interfaces then may include a file condition interface module 712, a file name classifier interface module 714, a directory walker handler interface module 716, a directory walker interface module 718, a zip walker handler interface module (“zip” indicating use for archives) 720, a zip walker interface module 722, and a file notification interface module 724.
In an embodiment of the invention, the code processing 750 may provide for parsing types from class file descriptors. Code processing 750 may include a class file format helper module 752 and a class file descriptor parser module. The code walk implementation 760 for class file processing may include a class file annotation record module 762, a class file element record module 764, a class file annotation filter 766, a class file annotation for native elements 768, a class file dependencies module for native elements 770, a class file dependencies module for BCEL (Byte Code Engineering Library) elements 772, a class file dependency concentrator module 774, and a class file dependency filter 776.
In an embodiment of the invention, the file processing 755 may include a comma separated value (CSV) formatter and a CSV scanner. The file walk implementation 730 for locating files may include a simple file condition module 732, a basic file name classifier module 734, a directory finder module 736, a directory walker implementation module 738, a walk recorder module 740, a zip (archive) condenser module 742, and a zip walker implementation module 744.
FIG. 8 is an illustration of a computer system in an embodiment of the invention. The computer system may be utilized as a system for processing of computer files in the form of a data stream, or may represent one of multiple systems used in such processing. The computing system illustrated in FIG. 8 is only one of various possible computing system architectures, and is a simplified illustration that does include many well-known elements. As illustrated, a computing system 800 can execute program code stored by an article of manufacture. Computer system 800 may be a J2EE system, ABAP system, or administration system. A computer system 800 includes one or more processors 805 and memory 810 coupled to a bus system 820. The bus system 820 is an abstraction that represents any one or more separate physical buses, point-to-point connections, or both connected by appropriate bridges, adapters, or controllers. The bus system 820 may include, for example, a system bus, a Peripheral Component Interconnect (PCI) bus, a HyperTransport or industry standard architecture (ISA) bus, a small computer system interface (SCSI) bus, a universal serial bus (USB), or an Institute of Electrical and Electronics Engineers (IEEE) standard 1394 bus, sometimes referred to as “Firewire”. (“Standard for a High Performance Serial Bus” 1394-1995, IEEE, published Aug. 30, 1996, and supplements thereto)
As illustrated in FIG. 8, the processors 805 are central processing units (CPUs) of the computer system 800 and control the overall operation of the computer system 800. The processors 805 execute software stored in memory 810. A processor 805 may be, or may include, one or more programmable general-purpose or special-purpose microprocessors, digital signal processors (DSPs), programmable controllers, application specific integrated circuits (ASICs), programmable logic devices (PLDs), or the like, or a combination of such devices.
Memory 810 is or includes the main memory of the computer system 800. Memory 810 represents any form of random access memory (RAM), read-only memory (ROM), flash memory, or the like, or a combination of such devices. Memory 810 stores, among other things, the operating system 815 of the computer system 800.
Also connected to the processors 805 through the bus system 820 are one or more mass storage devices 825 and a network adapter 835. Mass storage devices 825 may be or may include any conventional medium for storing large volumes of instructions and data 830 in a non-volatile manner, such as one or more magnetic or optical based disks. In an embodiment of the invention, the mass storage devices may include storage of file or an archive 832 that requires processing. In an embodiment of the invention, the processors 805 may operate to traverse the files or archive 832, the traversal of the files or archive 832 resulting in output of a serial data stream representing selected elements of the archive. The processor 805 may scan the serial stream for desired program elements within the computer files. In another embodiment the computer system 800 may provide for the conversion of the computer files into a serial data stream, while another system or systems is responsible for scanning the data stream for desired program elements.
The network adapter 835 provides the computer system 800 with the ability to communicate with remote devices, over a network 840 and may be, for example, an Ethernet adapter. In one embodiment, the network adapter may be utilized to output data including, for example, an extracted serial data stream representing selected elements of the files or archive 832.
FIG. 9 illustrates an embodiment of a client-server network system. As illustrated, a network 925 links a server 930 with client systems 905, 910, and 915. Client 915 may include certain data storage 920, including computer files in the form of, for example, a computer file hierarchy or computer archive 922. Server 930 includes programming data processing system suitable for implementing apparatus, programs, and/or methods in accordance with one or more embodiments of the present invention. Server 930 includes processor 935 and memory 940. Server 930 provides a core operating environment for one or more runtime systems, including, for example, virtual machine 945, at memory 940 to process user requests. Memory 940 may include a shared memory area that is accessible by multiple operating system processes executing in server 930. For example, virtual machine 945 may include an enterprise server (e.g., a J2EE-compatible server or node, Web Application Server developed by SAP AG, WebSphere Application Server developed by IBM Corp. of Armonk, N.Y., and the like). Memory 940 can be used to store an operating system, a Transmission Control Protocol/Internet Protocol (TCP/IP) stack for communicating over network 925, and machine executable instructions executed by processor 935. The memory 945 may also include data 950 for processing, including the processing of data that includes data of one or more computer file hierarchies or computer archives 952. In an embodiment, the data has been converted into a serial data stream for processing. In some embodiments, server 935 may include multiple processors, each of which can be used to execute machine executable instructions.
Client systems 905-915 may execute multiple application or application interfaces. Each instance or application or application interface may constitute a user session. Each user session may generate one or more requests to be processed by server 930. The requests may include instructions or code to be executed on a runtime system, such as virtual machine 945 on server 930.
In the description above, for the purposes of explanation, numerous specific details are set forth in order to provide a thorough understanding of the present invention. It will be apparent, however, to one skilled in the art that the present invention may be practiced without some of these specific details. In other instances, well-known structures and devices are shown in block diagram form.
The present invention may include various processes. The processes of the present invention may be performed by hardware components or may be embodied in machine-executable instructions, which may be used to cause a general-purpose or special-purpose processor or logic circuits programmed with the instructions to perform the processes. Alternatively, the processes may be performed by a combination of hardware and software.
Portions of the present invention may be provided as a computer program product, which may include a computer-readable medium having stored thereon computer program instructions, which may be used to program a computer (or other electronic devices) to perform a process according to the present invention. The machine-readable medium may include, but is not limited to, floppy diskettes, optical disks, CD-ROMs (compact disk read-only memory), and magneto-optical disks, ROMs (read-only memory), RAMs (random access memory), EPROMs (erasable programmable read-only memory), EEPROMs (electrically-erasable programmable read-only memory), magnet or optical cards, flash memory, or other type of media/machine-readable medium suitable for storing electronic instructions. Moreover, the present invention may also be downloaded as a computer program product, wherein the program may be transferred from a remote computer to a requesting computer.
Many of the methods are described in their most basic form, but processes can be added to or deleted from any of the methods and information can be added or subtracted from any of the described messages without departing from the basic scope of the present invention. It will be apparent to those skilled in the art that many further modifications and adaptations can be made. The particular embodiments are not provided to limit the invention but to illustrate it. The scope of the present invention is not to be determined by the specific examples provided above but only by the claims below.
It should also be appreciated that reference throughout this specification to “one embodiment” or “an embodiment” means that a particular feature may be included in the practice of the invention. Similarly, it should be appreciated that in the foregoing description of exemplary embodiments of the invention, various features of the invention are sometimes grouped together in a single embodiment, figure, or description thereof for the purpose of streamlining the disclosure and aiding in the understanding of one or more of the various inventive aspects. This method of disclosure, however, is not to be interpreted as reflecting an intention that the claimed invention requires more features than are expressly recited in each claim. Rather, as the following claims reflect, inventive aspects lie in less than all features of a single foregoing disclosed embodiment. Thus, the claims are hereby expressly incorporated into this description, with each claim standing on its own as a separate embodiment of this invention.

## Claims

1. A method for processing a data stream comprising:
receiving a data stream input at a scanner component, the data stream input representing a plurality of program elements; and
scanning the data stream input for annotations of the program elements, the scanning of the data stream input including:
encountering a data type description for a Java class type,
informing a handler component regarding the data type description,
determining whether to process program elements within the class type, the determination being based at least in part on any messages received from the handler component indicating that the class type is not of interest,
scanning the program elements within the class type to identify annotated program elements and annotation values of the identified annotated program elements based on the determination to process the program elements within the class type, and
skipping the program elements within the class type and annotation values of the program elements within the class type based on the determination not to process the program elements within the class type.

2. The method of claim 1, further comprising generating a data stream output containing the identified annotated program elements and the annotation values of the identified annotated program elements.

3. The method of claim 2, wherein the data stream output is provided to the handling component.

4. The method of claim 2, wherein the data stream output and the data stream input have the same data format.

5. The method of claim 1, wherein the scanning of the program elements is also based at least in part on a configuration.

6. The method of claim 5, wherein the configuration includes a scanner configuration and a data mode configuration.

7. The method of claim 1, wherein the plurality of program elements comprises Java class file program elements.

8. The method of claim 7, further comprising converting a set of class files into the data stream input.

9. A computer data processing system comprising:
a memory;
a data scanning module comprising at least one processor, the data scanning module to receive a data stream input containing a plurality of program elements and to provide notice when a data type description for a Java class type is encountered in the data stream input; and
a data handling module to receive the notice regarding the data type description, the data handling module to provide a callback control flow to notify the data scanning module whether the class type indicated by the data type description is of interest;
the data scanning module to scan the program elements within the class type to identify annotated program elements and annotation values of the identified annotated program elements based on the class type being of interest, and to skip the program elements within the class type and annotation values of the program elements within the class type based on the class type not being of interest.

10. The system of claim 9, further comprising a configuration, the operation of the scanning module being based at least in part on the configuration.

11. The system of claim 10, wherein the configuration comprises a scanner configuration associated with the scanning module and a data mode configuration associated with the handling module.

12. The system of claim 9, further comprising a parsing module to parse the data type descriptions in the data stream input.

13. The system of claim 9, the data scanning module to generate a data stream output containing the identified annotated program elements and the annotation values of the identified annotated program elements, wherein the data stream input and the data stream output use the same format.

14. An article of manufacture comprising:
a non-transitory computer-readable storage medium including instructions that, when executed by at least one processor of a machine, cause the machine to perform operations comprising:
receiving a data stream input at a scanner component, the data stream input representing a plurality of program elements; and
scanning the data stream input for annotations of the program elements, the scanning of the data stream input including:
encountering a data type description for a Java class type,
informing a handler component regarding the data type description,
determining whether to scan program elements within the class type, the determination being based at least in part on any messages from the handler component indicating that the class type is not of interest,
scanning the program elements within the class type to identify annotated program elements and annotation values of the identified annotated program elements based on the determination to process the program elements within the class type, and
skipping the program elements within the class type and annotation values of the program elements within the class type based on the determination not to process the program elements within the class type.

15. The article of manufacture of claim 14, the operations further comprising:
generating a data stream output containing the identified annotated program elements and the annotation values of the identified annotated program elements.

16. The article of manufacture of claim 15, wherein the data stream output is provided to the handling component.

17. The article of manufacture of claim 15, wherein the data stream output and the data stream input have the same data format.

18. The article of manufacture of claim 14, wherein the scanning of the program elements is also based at least in part on a configuration.

19. The article of manufacture of claim 18, wherein the configuration includes a scanner configuration and a data mode configuration.

20. The article of manufacture of claim 14, wherein the plurality of program elements comprises Java class file program elements.

21. The article of manufacture of claim 20, the operations further comprising:
converting a set of class files to generate the data stream input.