Complex Event Processing with Triceps CEP v2.0 Developer's Guide Sergey A. Babkin Complex Event Processing with Triceps CEP v2.0 : Developer's Guide Sergey A. Babkin Copyright © 2014 Sergey A. Babkin All rights reserved. This manual is a part of the Triceps project. It is covered by the same Triceps version of the LGPL v3 license as Triceps itself. The author can be contacted by e-mail at <[email protected]> or <[email protected]>. Many of the designations used by the manufacturers and sellers to distinguish their products are claimed as trademarks. Where those designations appear in this manual, and the author was aware of a trademark claim, the designations have been printed in caps or initial caps. While every precaution has been taken in the preparation of this manual, the author assumes no responsibility for errors or omissions, or for damages resulting from the use of the information contained herein. Table of Contents Preface .................................................................................................................................................. xi 1. About the manual ........................................................................................................................ xi 2. Some concepts ............................................................................................................................ xi 1. The field of CEP .................................................................................................................................. 1 1.1. What is the CEP? ....................................................................................................................... 1 1.2. The uses of CEP ........................................................................................................................ 2 1.3. Surveying the CEP langscape ....................................................................................................... 2 1.4. We're not in 1950s any more, or are we? ........................................................................................ 3 2. Enter Triceps ....................................................................................................................................... 7 2.1. What led to it ............................................................................................................................ 7 2.2. Hello, world! ............................................................................................................................. 8 3. Building Triceps ................................................................................................................................. 11 3.1. Downloading Triceps ................................................................................................................ 11 3.2. The reference environment ......................................................................................................... 11 3.3. The basic build ........................................................................................................................ 12 3.4. Building the documentation ........................................................................................................ 12 3.5. Running the examples and simple programs .................................................................................. 13 3.6. Locale dependency .................................................................................................................... 14 3.7. Installation of the Perl library ..................................................................................................... 14 3.8. Installation of the C++ library ..................................................................................................... 15 3.9. Disambiguation of the C++ library .............................................................................................. 16 3.10. Build configuration settings ...................................................................................................... 17 4. API Fundamentals ............................................................................................................................... 19 4.1. Languages and layers ................................................................................................................ 19 4.2. Errors, deaths and confessions .................................................................................................... 19 4.3. Memory management fundamentals ............................................................................................. 20 4.4. Code references and snippets ...................................................................................................... 21 4.5. Triceps constants ...................................................................................................................... 22 4.6. Printing the object contents ........................................................................................................ 23 4.7. The Hungarian notation ............................................................................................................. 24 4.8. The Perl libraries and examples ................................................................................................... 25 5. Rows ................................................................................................................................................ 27 5.1. Simple types ............................................................................................................................ 27 5.2. Row types ............................................................................................................................... 27 5.3. Row types equivalence .............................................................................................................. 29 5.4. Rows ...................................................................................................................................... 30 6. Labels and Row Operations .................................................................................................................. 33 6.1. Labels basics ........................................................................................................................... 33 6.2. Label construction .................................................................................................................... 34 6.3. Other label methods .................................................................................................................. 35 6.4. Row operations ........................................................................................................................ 36 6.5. Opcodes .................................................................................................................................. 38 7. Scheduling ......................................................................................................................................... 41 7.1. Introduction to the scheduling ..................................................................................................... 41 7.2. Comparative scheduling in the various CEP systems ....................................................................... 41 7.3. Execution unit basics ................................................................................................................. 41 7.4. Trays ...................................................................................................................................... 43 7.5. Error handling during the execution ............................................................................................. 44 7.6. No bundling ............................................................................................................................ 45 7.7. Topological loops ..................................................................................................................... 46 7.8. The main loop ......................................................................................................................... 51 7.9. Main loop with a socket ............................................................................................................ 54 7.10. Tracing the execution .............................................................................................................. 63 iii 7.11. The gritty details of Triceps scheduling ....................................................................................... 69 7.12. The gritty details of Triceps loop scheduling ................................................................................ 72 7.13. Recursion control .................................................................................................................... 74 8. Memory Management .......................................................................................................................... 77 8.1. Reference cycles ....................................................................................................................... 77 8.2. Clearing of the labels ................................................................................................................ 78 8.3. The clearing labels .................................................................................................................... 79 9. Tables ..............................................................................................................................................