From e0adf009afac7b2a25ffb161802b0ea7fd0e3405 Mon Sep 17 00:00:00 2001 From: lihanghang Date: Thu, 7 Mar 2019 22:40:41 +0800 Subject: [PATCH] =?UTF-8?q?[summary]=20fork=20zookeeper-3.4.13=E6=BA=90?= =?UTF-8?q?=E7=A0=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .gitattributes | 19 + .gitignore | 81 + LICENSE.txt | 202 + NOTICE.txt | 5 + README_packaging.txt | 65 + bin/README.txt | 6 + bin/zkCleanup.sh | 51 + bin/zkCli.cmd | 24 + bin/zkCli.sh | 41 + bin/zkEnv.cmd | 52 + bin/zkEnv.sh | 115 + bin/zkServer.cmd | 24 + bin/zkServer.sh | 225 + bin/zkTxnLogToolkit.cmd | 24 + bin/zkTxnLogToolkit.sh | 38 + build.xml | 1993 ++++++++ conf/configuration.xsl | 24 + conf/log4j.properties | 58 + conf/zoo.cfg | 28 + conf/zoo_sample.cfg | 28 + docs/bookkeeperConfig.html | 384 ++ docs/bookkeeperConfig.pdf | Bin 0 -> 13793 bytes docs/bookkeeperOverview.html | 694 +++ docs/bookkeeperOverview.pdf | Bin 0 -> 147554 bytes docs/bookkeeperProgrammer.html | 1083 ++++ docs/bookkeeperProgrammer.pdf | Bin 0 -> 24945 bytes docs/bookkeeperStarted.html | 448 ++ docs/bookkeeperStarted.pdf | Bin 0 -> 17103 bytes docs/bookkeeperStream.html | 612 +++ docs/bookkeeperStream.pdf | Bin 0 -> 13188 bytes docs/broken-links.xml | 2 + docs/images/2pc.jpg | Bin 0 -> 15174 bytes docs/images/bk-overview.jpg | Bin 0 -> 124211 bytes docs/images/built-with-forrest-button.png | Bin 0 -> 1936 bytes docs/images/favicon.ico | Bin 0 -> 766 bytes docs/images/hadoop-logo.jpg | Bin 0 -> 9443 bytes docs/images/instruction_arrow.png | Bin 0 -> 285 bytes docs/images/state_dia.jpg | Bin 0 -> 51364 bytes docs/images/zkcomponents.jpg | Bin 0 -> 30831 bytes docs/images/zknamespace.jpg | Bin 0 -> 35414 bytes docs/images/zkperfRW-3.2.jpg | Bin 0 -> 41948 bytes docs/images/zkperfRW.jpg | Bin 0 -> 161542 bytes docs/images/zkperfreliability.jpg | Bin 0 -> 69825 bytes docs/images/zkservice.jpg | Bin 0 -> 86790 bytes docs/images/zookeeper_small.gif | Bin 0 -> 4847 bytes docs/index.html | 391 ++ docs/index.pdf | Bin 0 -> 13511 bytes docs/javaExample.html | 908 ++++ docs/javaExample.pdf | Bin 0 -> 33763 bytes docs/linkmap.html | 434 ++ docs/linkmap.pdf | Bin 0 -> 12455 bytes docs/recipes.html | 974 ++++ docs/recipes.pdf | Bin 0 -> 31017 bytes docs/releasenotes.html | 1822 +++++++ docs/skin/CommonMessages_de.xml | 23 + docs/skin/CommonMessages_en_US.xml | 23 + docs/skin/CommonMessages_es.xml | 23 + docs/skin/CommonMessages_fr.xml | 23 + docs/skin/basic.css | 167 + docs/skin/breadcrumbs-optimized.js | 90 + docs/skin/breadcrumbs.js | 237 + docs/skin/fontsize.js | 166 + docs/skin/getBlank.js | 40 + docs/skin/getMenu.js | 45 + docs/skin/images/README.txt | 1 + docs/skin/images/add.jpg | Bin 0 -> 1142 bytes docs/skin/images/apache-thanks.png | Bin 0 -> 4840 bytes docs/skin/images/built-with-cocoon.gif | Bin 0 -> 2252 bytes .../skin/images/built-with-forrest-button.png | Bin 0 -> 1936 bytes docs/skin/images/chapter.gif | Bin 0 -> 49 bytes docs/skin/images/chapter_open.gif | Bin 0 -> 49 bytes docs/skin/images/current.gif | Bin 0 -> 54 bytes docs/skin/images/error.png | Bin 0 -> 1709 bytes docs/skin/images/external-link.gif | Bin 0 -> 71 bytes docs/skin/images/fix.jpg | Bin 0 -> 932 bytes docs/skin/images/forrest-credit-logo.png | Bin 0 -> 4633 bytes docs/skin/images/hack.jpg | Bin 0 -> 743 bytes docs/skin/images/header_white_line.gif | Bin 0 -> 37 bytes docs/skin/images/info.png | Bin 0 -> 1320 bytes docs/skin/images/instruction_arrow.png | Bin 0 -> 285 bytes docs/skin/images/label.gif | Bin 0 -> 54 bytes docs/skin/images/page.gif | Bin 0 -> 79 bytes docs/skin/images/pdfdoc.gif | Bin 0 -> 1008 bytes docs/skin/images/poddoc.png | Bin 0 -> 856 bytes docs/skin/images/printer.gif | Bin 0 -> 603 bytes .../images/rc-b-l-15-1body-2menu-3menu.png | Bin 0 -> 348 bytes .../images/rc-b-r-15-1body-2menu-3menu.png | Bin 0 -> 319 bytes ...-5-1header-2tab-selected-3tab-selected.png | Bin 0 -> 200 bytes ...rc-t-l-5-1header-2searchbox-3searchbox.png | Bin 0 -> 199 bytes ...-5-1header-2tab-selected-3tab-selected.png | Bin 0 -> 209 bytes ...header-2tab-unselected-3tab-unselected.png | Bin 0 -> 199 bytes .../images/rc-t-r-15-1body-2menu-3menu.png | Bin 0 -> 390 bytes ...rc-t-r-5-1header-2searchbox-3searchbox.png | Bin 0 -> 214 bytes ...-5-1header-2tab-selected-3tab-selected.png | Bin 0 -> 215 bytes ...header-2tab-unselected-3tab-unselected.png | Bin 0 -> 214 bytes docs/skin/images/remove.jpg | Bin 0 -> 1251 bytes docs/skin/images/rss.png | Bin 0 -> 360 bytes docs/skin/images/spacer.gif | Bin 0 -> 43 bytes docs/skin/images/success.png | Bin 0 -> 1291 bytes docs/skin/images/txtdoc.png | Bin 0 -> 784 bytes docs/skin/images/update.jpg | Bin 0 -> 990 bytes docs/skin/images/valid-html401.png | Bin 0 -> 2948 bytes docs/skin/images/vcss.png | Bin 0 -> 1134 bytes docs/skin/images/warning.png | Bin 0 -> 1215 bytes docs/skin/images/xmldoc.gif | Bin 0 -> 992 bytes docs/skin/menu.js | 48 + docs/skin/note.txt | 50 + docs/skin/print.css | 54 + docs/skin/profile.css | 168 + docs/skin/prototype.js | 1257 +++++ docs/skin/screen.css | 587 +++ docs/zookeeperAdmin.html | 2231 ++++++++ docs/zookeeperAdmin.pdf | Bin 0 -> 86044 bytes docs/zookeeperHierarchicalQuorums.html | 276 + docs/zookeeperHierarchicalQuorums.pdf | Bin 0 -> 6650 bytes docs/zookeeperInternals.html | 805 +++ docs/zookeeperInternals.pdf | Bin 0 -> 48806 bytes docs/zookeeperJMX.html | 479 ++ docs/zookeeperJMX.pdf | Bin 0 -> 16471 bytes docs/zookeeperObservers.html | 366 ++ docs/zookeeperObservers.pdf | Bin 0 -> 12867 bytes docs/zookeeperOtherInfo.html | 230 + docs/zookeeperOtherInfo.pdf | Bin 0 -> 2947 bytes docs/zookeeperOver.html | 704 +++ docs/zookeeperOver.pdf | Bin 0 -> 302479 bytes docs/zookeeperProgrammers.html | 2285 +++++++++ docs/zookeeperProgrammers.pdf | Bin 0 -> 134096 bytes docs/zookeeperQuotas.html | 290 ++ docs/zookeeperQuotas.pdf | Bin 0 -> 11180 bytes docs/zookeeperReconfig.pdf | Bin 0 -> 62192 bytes docs/zookeeperStarted.html | 629 +++ docs/zookeeperStarted.pdf | Bin 0 -> 28069 bytes docs/zookeeperTutorial.html | 937 ++++ docs/zookeeperTutorial.pdf | Bin 0 -> 34208 bytes ivy.xml | 155 + ivysettings.xml | 41 + src/LICENSE.txt | 216 + src/NOTICE.txt | 100 + src/c/CMakeLists.txt | 237 + src/c/ChangeLog | 116 + src/c/INSTALL | 234 + src/c/LICENSE | 202 + src/c/Makefile.am | 128 + src/c/NOTICE.txt | 41 + src/c/README | 156 + src/c/acinclude.m4 | 312 ++ src/c/aminclude.am | 186 + src/c/c-doc.Doxyfile | 1252 +++++ src/c/cmake_config.h.in | 154 + src/c/configure.ac | 165 + src/c/include/proto.h | 47 + src/c/include/recordio.h | 83 + src/c/include/winconfig.h | 15 + src/c/include/zookeeper.h | 1589 ++++++ src/c/include/zookeeper_log.h | 51 + src/c/include/zookeeper_version.h | 33 + src/c/src/cli.c | 697 +++ src/c/src/hashtable/LICENSE.txt | 30 + src/c/src/hashtable/hashtable.c | 274 + src/c/src/hashtable/hashtable.h | 209 + src/c/src/hashtable/hashtable_itr.c | 176 + src/c/src/hashtable/hashtable_itr.h | 119 + src/c/src/hashtable/hashtable_private.h | 85 + src/c/src/load_gen.c | 282 ++ src/c/src/mt_adaptor.c | 519 ++ src/c/src/recordio.c | 366 ++ src/c/src/st_adaptor.c | 113 + src/c/src/winport.c | 302 ++ src/c/src/winport.h | 138 + src/c/src/zk_adaptor.h | 276 + src/c/src/zk_hashtable.c | 337 ++ src/c/src/zk_hashtable.h | 69 + src/c/src/zk_log.c | 180 + src/c/src/zookeeper.c | 3767 ++++++++++++++ src/c/tests/CollectionUtil.h | 195 + src/c/tests/CppAssertHelper.h | 37 + src/c/tests/LibCMocks.cc | 333 ++ src/c/tests/LibCMocks.h | 408 ++ src/c/tests/LibCSymTable.cc | 83 + src/c/tests/LibCSymTable.h | 107 + src/c/tests/MocksBase.cc | 36 + src/c/tests/MocksBase.h | 36 + src/c/tests/PthreadMocks.cc | 106 + src/c/tests/PthreadMocks.h | 449 ++ src/c/tests/TestClient.cc | 1135 +++++ src/c/tests/TestClientRetry.cc | 273 + src/c/tests/TestDriver.cc | 173 + src/c/tests/TestMulti.cc | 703 +++ src/c/tests/TestOperations.cc | 710 +++ src/c/tests/TestWatchers.cc | 773 +++ src/c/tests/TestZookeeperClose.cc | 472 ++ src/c/tests/TestZookeeperInit.cc | 301 ++ src/c/tests/ThreadingUtil.cc | 87 + src/c/tests/ThreadingUtil.h | 261 + src/c/tests/Util.cc | 51 + src/c/tests/Util.h | 137 + src/c/tests/Vector.h | 37 + src/c/tests/ZKMocks.cc | 519 ++ src/c/tests/ZKMocks.h | 509 ++ src/c/tests/wrappers-mt.opt | 3 + src/c/tests/wrappers.opt | 7 + src/c/tests/zkServer.sh | 161 + src/contrib/build-contrib.xml | 248 + src/contrib/build.xml | 88 + src/contrib/fatjar/README.txt | 2 + src/contrib/fatjar/build.xml | 74 + src/contrib/fatjar/conf/mainClasses | 10 + .../org/apache/zookeeper/util/FatJarMain.java | 126 + src/contrib/huebrowser/README | 62 + src/contrib/huebrowser/zkui/Makefile | 21 + src/contrib/huebrowser/zkui/setup.py | 46 + .../huebrowser/zkui/src/zkui/__init__.py | 16 + src/contrib/huebrowser/zkui/src/zkui/forms.py | 29 + .../huebrowser/zkui/src/zkui/models.py | 17 + src/contrib/huebrowser/zkui/src/zkui/rest.py | 230 + .../huebrowser/zkui/src/zkui/settings.py | 30 + .../zkui/src/zkui/static/art/line_icons.png | Bin 0 -> 7499 bytes .../zkui/src/zkui/static/art/zkui.png | Bin 0 -> 4430 bytes .../zkui/src/zkui/static/bootstrap.js | 32 + .../zkui/src/zkui/static/css/zkui.css | 56 + .../zkui/src/zkui/static/help/index.html | 26 + .../src/zkui/static/js/Source/Zkui/Zkui.js | 50 + .../zkui/src/zkui/static/js/package.yml | 19 + src/contrib/huebrowser/zkui/src/zkui/stats.py | 170 + .../zkui/src/zkui/templates/clients.mako | 51 + .../zkui/src/zkui/templates/create.mako | 34 + .../zkui/src/zkui/templates/edit.mako | 34 + .../zkui/src/zkui/templates/index.mako | 54 + .../src/zkui/templates/shared_components.mako | 66 + .../zkui/src/zkui/templates/tree.mako | 75 + .../zkui/src/zkui/templates/view.mako | 128 + src/contrib/huebrowser/zkui/src/zkui/urls.py | 28 + src/contrib/huebrowser/zkui/src/zkui/utils.py | 33 + src/contrib/huebrowser/zkui/src/zkui/views.py | 165 + .../huebrowser/zkui/src/zkui/windmilltests.py | 23 + src/contrib/loggraph/README.txt | 69 + src/contrib/loggraph/bin/loggraph-dev.sh | 43 + src/contrib/loggraph/bin/loggraph.sh | 48 + src/contrib/loggraph/build.xml | 70 + src/contrib/loggraph/ivy.xml | 44 + .../zookeeper/graph/FilterException.java | 22 + .../org/apache/zookeeper/graph/FilterOp.java | 75 + .../apache/zookeeper/graph/FilterParser.java | 131 + .../apache/zookeeper/graph/JsonGenerator.java | 223 + .../apache/zookeeper/graph/Log4JEntry.java | 40 + .../apache/zookeeper/graph/Log4JSource.java | 391 ++ .../org/apache/zookeeper/graph/LogEntry.java | 46 + .../apache/zookeeper/graph/LogIterator.java | 26 + .../org/apache/zookeeper/graph/LogServer.java | 66 + .../apache/zookeeper/graph/LogSkipList.java | 95 + .../org/apache/zookeeper/graph/LogSource.java | 33 + .../zookeeper/graph/MeasureThroughput.java | 103 + .../zookeeper/graph/MergedLogSource.java | 219 + .../graph/RandomAccessFileReader.java | 329 ++ .../zookeeper/graph/TransactionEntry.java | 59 + .../apache/zookeeper/graph/TxnLogSource.java | 376 ++ .../zookeeper/graph/filterops/AndOp.java | 33 + .../apache/zookeeper/graph/filterops/Arg.java | 36 + .../zookeeper/graph/filterops/EqualsOp.java | 44 + .../graph/filterops/GreaterThanOp.java | 70 + .../zookeeper/graph/filterops/LessThanOp.java | 69 + .../zookeeper/graph/filterops/NotOp.java | 31 + .../zookeeper/graph/filterops/NumberArg.java | 28 + .../zookeeper/graph/filterops/OrOp.java | 33 + .../zookeeper/graph/filterops/StringArg.java | 28 + .../zookeeper/graph/filterops/SymbolArg.java | 27 + .../zookeeper/graph/filterops/XorOp.java | 40 + .../zookeeper/graph/servlets/FileLoader.java | 60 + .../apache/zookeeper/graph/servlets/Fs.java | 69 + .../zookeeper/graph/servlets/GraphData.java | 85 + .../zookeeper/graph/servlets/JsonServlet.java | 85 + .../zookeeper/graph/servlets/NumEvents.java | 88 + .../graph/servlets/StaticContent.java | 53 + .../zookeeper/graph/servlets/Throughput.java | 125 + .../apache/zookeeper/graph/log4j.properties | 11 + .../zookeeper/graph/resources/date.format.js | 126 + .../apache/zookeeper/graph/resources/g.bar.js | 385 ++ .../apache/zookeeper/graph/resources/g.dot.js | 110 + .../zookeeper/graph/resources/g.line.js | 230 + .../apache/zookeeper/graph/resources/g.pie.js | 205 + .../zookeeper/graph/resources/g.raphael.js | 481 ++ .../zookeeper/graph/resources/load-big.gif | Bin 0 -> 1924 bytes .../apache/zookeeper/graph/resources/load.gif | Bin 0 -> 673 bytes .../zookeeper/graph/resources/loggraph.css | 54 + .../zookeeper/graph/resources/loggraph.js | 262 + .../zookeeper/graph/resources/loggraph.log.js | 57 + .../graph/resources/loggraph.server.js | 329 ++ .../graph/resources/loggraph.session.js | 202 + .../graph/resources/loggraph.stats.js | 44 + .../zookeeper/graph/resources/loggraph.ui.js | 377 ++ .../zookeeper/graph/resources/main.html | 60 + .../zookeeper/graph/resources/raphael.js | 3296 ++++++++++++ .../zookeeper/graph/resources/yui-min.js | 12 + src/contrib/monitoring/JMX-RESOURCES | 38 + src/contrib/monitoring/README | 85 + src/contrib/monitoring/cacti/README | 56 + src/contrib/monitoring/check_zookeeper.py | 395 ++ src/contrib/monitoring/ganglia/README | 48 + src/contrib/monitoring/ganglia/Screenshot.png | Bin 0 -> 111055 bytes src/contrib/monitoring/ganglia/modpython.conf | 28 + .../monitoring/ganglia/zookeeper.pyconf | 50 + .../monitoring/ganglia/zookeeper_ganglia.py | 210 + src/contrib/monitoring/nagios/README.txt | 86 + .../monitoring/nagios/Screenshot-1.png | Bin 0 -> 196668 bytes src/contrib/monitoring/nagios/Screenshot.png | Bin 0 -> 163646 bytes src/contrib/monitoring/nagios/hostgroups.cfg | 25 + src/contrib/monitoring/nagios/services.cfg | 67 + src/contrib/monitoring/nagios/zookeeper.cfg | 30 + src/contrib/monitoring/test.py | 282 ++ src/contrib/rest/NOTICE.txt | 7 + src/contrib/rest/README.txt | 72 + src/contrib/rest/SPEC.txt | 355 ++ src/contrib/rest/build.xml | 183 + src/contrib/rest/conf/keys/README | 8 + src/contrib/rest/conf/keys/rest.cer | Bin 0 -> 595 bytes src/contrib/rest/conf/keys/rest.jks | Bin 0 -> 1363 bytes src/contrib/rest/conf/log4j.properties | 68 + src/contrib/rest/conf/rest.properties | 70 + src/contrib/rest/ivy.xml | 48 + src/contrib/rest/rest.sh | 90 + .../zookeeper/server/jersey/RestMain.java | 151 + .../server/jersey/ZooKeeperService.java | 242 + .../server/jersey/cfg/Credentials.java | 47 + .../zookeeper/server/jersey/cfg/Endpoint.java | 72 + .../zookeeper/server/jersey/cfg/HostPort.java | 51 + .../server/jersey/cfg/HostPortSet.java | 51 + .../zookeeper/server/jersey/cfg/RestCfg.java | 110 + .../server/jersey/filters/HTTPBasicAuth.java | 87 + .../server/jersey/jaxb/ZChildren.java | 80 + .../server/jersey/jaxb/ZChildrenJSON.java | 76 + .../zookeeper/server/jersey/jaxb/ZError.java | 41 + .../zookeeper/server/jersey/jaxb/ZPath.java | 63 + .../server/jersey/jaxb/ZSession.java | 55 + .../zookeeper/server/jersey/jaxb/ZStat.java | 106 + .../jersey/resources/JAXBContextResolver.java | 72 + .../resources/KeeperExceptionMapper.java | 86 + .../resources/RuntimeExceptionMapper.java | 55 + .../jersey/resources/SessionsResource.java | 135 + .../server/jersey/resources/ZErrorWriter.java | 63 + .../jersey/resources/ZNodeResource.java | 412 ++ src/contrib/rest/src/python/README.txt | 9 + .../rest/src/python/demo_master_election.py | 90 + src/contrib/rest/src/python/demo_queue.py | 99 + src/contrib/rest/src/python/test.py | 163 + src/contrib/rest/src/python/zk_dump_tree.py | 108 + src/contrib/rest/src/python/zkrest.py | 218 + .../apache/zookeeper/server/jersey/Base.java | 94 + .../zookeeper/server/jersey/CreateTest.java | 163 + .../zookeeper/server/jersey/DeleteTest.java | 95 + .../zookeeper/server/jersey/ExistsTest.java | 80 + .../server/jersey/GetChildrenTest.java | 139 + .../zookeeper/server/jersey/GetTest.java | 123 + .../server/jersey/RestTestSuite.java | 42 + .../zookeeper/server/jersey/RootTest.java | 68 + .../zookeeper/server/jersey/SessionTest.java | 134 + .../zookeeper/server/jersey/SetTest.java | 155 + .../zookeeper/server/jersey/WadlTest.java | 44 + src/contrib/rest/src/test/zkServer.sh | 91 + src/contrib/zkfuse/Makefile.am | 4 + src/contrib/zkfuse/README.txt | 63 + src/contrib/zkfuse/build.xml | 61 + src/contrib/zkfuse/configure.ac | 72 + src/contrib/zkfuse/src/Makefile.am | 7 + src/contrib/zkfuse/src/blockingqueue.h | 154 + src/contrib/zkfuse/src/doxygen.cfg | 1242 +++++ src/contrib/zkfuse/src/event.cc | 29 + src/contrib/zkfuse/src/event.h | 553 ++ src/contrib/zkfuse/src/log.cc | 36 + src/contrib/zkfuse/src/log.h | 116 + src/contrib/zkfuse/src/log4cxx.properties | 28 + src/contrib/zkfuse/src/mutex.h | 169 + src/contrib/zkfuse/src/thread.cc | 41 + src/contrib/zkfuse/src/thread.h | 99 + src/contrib/zkfuse/src/zkadapter.cc | 884 ++++ src/contrib/zkfuse/src/zkadapter.h | 718 +++ src/contrib/zkfuse/src/zkfuse.cc | 4492 +++++++++++++++++ src/contrib/zkperl/Changes | 65 + src/contrib/zkperl/LICENSE | 202 + src/contrib/zkperl/MANIFEST | 23 + src/contrib/zkperl/Makefile.PL | 73 + src/contrib/zkperl/NOTICE | 6 + src/contrib/zkperl/README | 86 + src/contrib/zkperl/ZooKeeper.pm | 1257 +++++ src/contrib/zkperl/ZooKeeper.xs | 2664 ++++++++++ src/contrib/zkperl/build.xml | 61 + src/contrib/zkperl/t/10_invalid.t | 773 +++ src/contrib/zkperl/t/15_thread.t | 121 + src/contrib/zkperl/t/20_tie.t | 353 ++ src/contrib/zkperl/t/22_stat_tie.t | 438 ++ src/contrib/zkperl/t/24_watch_tie.t | 292 ++ src/contrib/zkperl/t/30_connect.t | 202 + src/contrib/zkperl/t/35_log.t | 88 + src/contrib/zkperl/t/40_basic.t | 277 + src/contrib/zkperl/t/45_class.t | 408 ++ src/contrib/zkperl/t/50_access.t | 356 ++ src/contrib/zkperl/t/60_watch.t | 304 ++ src/contrib/zkperl/t/util.pl | 62 + src/contrib/zkperl/typemap | 38 + src/contrib/zkpython/README | 109 + src/contrib/zkpython/build.xml | 198 + src/contrib/zkpython/ivy.xml | 43 + src/contrib/zkpython/src/c/pyzk_docstrings.h | 594 +++ src/contrib/zkpython/src/c/zookeeper.c | 1664 ++++++ src/contrib/zkpython/src/examples/README | 8 + .../src/examples/watch_znode_for_changes.py | 202 + .../src/packages/deb/zkpython.control/control | 23 + .../src/packages/rpm/spec/zkpython.spec | 81 + src/contrib/zkpython/src/python/setup.py | 36 + src/contrib/zkpython/src/python/zk.py | 76 + src/contrib/zkpython/src/test/acl_test.py | 109 + src/contrib/zkpython/src/test/async_test.py | 33 + .../zkpython/src/test/callback_test.py | 155 + .../zkpython/src/test/clientid_test.py | 48 + .../zkpython/src/test/close_deadlock_test.py | 50 + .../zkpython/src/test/connection_test.py | 131 + src/contrib/zkpython/src/test/create_test.py | 104 + src/contrib/zkpython/src/test/delete_test.py | 68 + src/contrib/zkpython/src/test/exists_test.py | 64 + src/contrib/zkpython/src/test/get_set_test.py | 211 + src/contrib/zkpython/src/test/run_tests.sh | 40 + src/contrib/zkpython/src/test/zkServer.sh | 77 + src/contrib/zkpython/src/test/zktestbase.py | 101 + src/contrib/zktreeutil/Makefile.am | 4 + src/contrib/zktreeutil/README.txt | 74 + src/contrib/zktreeutil/build.xml | 61 + src/contrib/zktreeutil/configure.ac | 66 + src/contrib/zktreeutil/src/Makefile.am | 24 + src/contrib/zktreeutil/src/SimpleTree.h | 150 + src/contrib/zktreeutil/src/ZkAdaptor.cc | 513 ++ src/contrib/zktreeutil/src/ZkAdaptor.h | 327 ++ src/contrib/zktreeutil/src/ZkTreeUtil.cc | 705 +++ src/contrib/zktreeutil/src/ZkTreeUtil.h | 262 + src/contrib/zktreeutil/src/ZkTreeUtilMain.cc | 247 + src/contrib/zktreeutil/tests/zk_sample.xml | 44 + src/contrib/zooinspector/NOTICE.txt | 3 + src/contrib/zooinspector/README.txt | 94 + src/contrib/zooinspector/build.xml | 152 + .../config/defaultConnectionSettings.cfg | 21 + .../config/defaultNodeVeiwers.cfg | 17 + .../zooinspector/icons/edtsrclkup_co.gif | Bin 0 -> 204 bytes src/contrib/zooinspector/icons/file_obj.gif | Bin 0 -> 354 bytes src/contrib/zooinspector/icons/fldr_obj.gif | Bin 0 -> 216 bytes src/contrib/zooinspector/icons/info_obj.gif | Bin 0 -> 121 bytes src/contrib/zooinspector/icons/jspdecl.gif | Bin 0 -> 190 bytes src/contrib/zooinspector/icons/launch_run.gif | Bin 0 -> 379 bytes .../zooinspector/icons/launch_stop.gif | Bin 0 -> 916 bytes src/contrib/zooinspector/icons/new_con.gif | Bin 0 -> 353 bytes src/contrib/zooinspector/icons/refresh.gif | Bin 0 -> 327 bytes src/contrib/zooinspector/icons/save_edit.gif | Bin 0 -> 639 bytes .../zooinspector/icons/search_next.gif | Bin 0 -> 332 bytes .../zooinspector/icons/search_prev.gif | Bin 0 -> 323 bytes src/contrib/zooinspector/icons/trash.gif | Bin 0 -> 132 bytes src/contrib/zooinspector/ivy.xml | 48 + .../zooinspector/lib/jtoaster-1.0.4.jar | Bin 0 -> 14975 bytes src/contrib/zooinspector/lib/log4j.properties | 9 + .../licences/Apache Software Licence v2.0.txt | 202 + .../zooinspector/licences/epl-v10.html | 261 + .../zookeeper/inspector/ZooInspector.java | 66 + .../BasicDataEncryptionManager.java | 50 + .../encryption/DataEncryptionManager.java | 39 + .../gui/NodeViewersChangeListener.java | 37 + .../gui/ZooInspectorAboutDialog.java | 80 + ...ooInspectorConnectionPropertiesDialog.java | 321 ++ .../gui/ZooInspectorIconResources.java | 118 + .../gui/ZooInspectorNodeViewersDialog.java | 605 +++ .../gui/ZooInspectorNodeViewersPanel.java | 140 + .../inspector/gui/ZooInspectorPanel.java | 361 ++ .../inspector/gui/ZooInspectorTreeViewer.java | 362 ++ .../apache/zookeeper/inspector/gui/about.html | 21 + .../gui/nodeviewer/NodeViewerACL.java | 187 + .../gui/nodeviewer/NodeViewerData.java | 146 + .../gui/nodeviewer/NodeViewerMetaData.java | 186 + .../nodeviewer/ZooInspectorNodeViewer.java | 138 + .../inspector/logger/LoggerFactory.java | 36 + .../inspector/manager/NodeListener.java | 37 + .../zookeeper/inspector/manager/Pair.java | 120 + .../manager/ZooInspectorManager.java | 139 + .../manager/ZooInspectorManagerImpl.java | 884 ++++ .../manager/ZooInspectorNodeManager.java | 33 + .../manager/ZooInspectorNodeTreeManager.java | 43 + .../manager/ZooInspectorReadOnlyManager.java | 99 + .../zookeeper/retry/ZooKeeperRetry.java | 288 ++ src/contrib/zooinspector/zooInspector-dev.sh | 18 + src/contrib/zooinspector/zooInspector.cmd | 18 + src/contrib/zooinspector/zooInspector.sh | 18 + src/docs/forrest.properties | 109 + src/docs/src/documentation/README.txt | 7 + src/docs/src/documentation/TODO.txt | 227 + .../classes/CatalogManager.properties | 37 + src/docs/src/documentation/conf/cli.xconf | 328 ++ .../content/xdocs/bookkeeperConfig.xml | 156 + .../content/xdocs/bookkeeperOverview.xml | 419 ++ .../content/xdocs/bookkeeperProgrammer.xml | 678 +++ .../content/xdocs/bookkeeperStarted.xml | 208 + .../content/xdocs/bookkeeperStream.xml | 331 ++ .../src/documentation/content/xdocs/index.xml | 98 + .../content/xdocs/javaExample.xml | 663 +++ .../documentation/content/xdocs/recipes.xml | 637 +++ .../src/documentation/content/xdocs/site.xml | 103 + .../src/documentation/content/xdocs/tabs.xml | 36 + .../content/xdocs/zookeeperAdmin.xml | 1861 +++++++ .../xdocs/zookeeperHierarchicalQuorums.xml | 75 + .../content/xdocs/zookeeperInternals.xml | 487 ++ .../content/xdocs/zookeeperJMX.xml | 236 + .../content/xdocs/zookeeperObservers.xml | 145 + .../content/xdocs/zookeeperOtherInfo.xml | 46 + .../content/xdocs/zookeeperOver.xml | 464 ++ .../content/xdocs/zookeeperProgrammers.xml | 1640 ++++++ .../content/xdocs/zookeeperQuotas.xml | 71 + .../content/xdocs/zookeeperStarted.xml | 418 ++ .../content/xdocs/zookeeperTutorial.xml | 712 +++ .../documentation/resources/images/2pc.jpg | Bin 0 -> 15174 bytes .../resources/images/bk-overview.jpg | Bin 0 -> 124211 bytes .../resources/images/favicon.ico | Bin 0 -> 766 bytes .../resources/images/hadoop-logo.jpg | Bin 0 -> 9443 bytes .../resources/images/state_dia.dia | Bin 0 -> 2597 bytes .../resources/images/state_dia.jpg | Bin 0 -> 51364 bytes .../documentation/resources/images/zkarch.jpg | Bin 0 -> 24535 bytes .../resources/images/zkcomponents.jpg | Bin 0 -> 30831 bytes .../resources/images/zknamespace.jpg | Bin 0 -> 35414 bytes .../resources/images/zkperfRW-3.2.jpg | Bin 0 -> 41948 bytes .../resources/images/zkperfRW.jpg | Bin 0 -> 161542 bytes .../resources/images/zkperfreliability.jpg | Bin 0 -> 69825 bytes .../resources/images/zkservice.jpg | Bin 0 -> 86790 bytes .../resources/images/zookeeper_small.gif | Bin 0 -> 4847 bytes src/docs/src/documentation/skinconf.xml | 360 ++ src/docs/status.xml | 74 + src/java/OldChangeLog | 0 .../lhh/corator/CoratorSessionExample.java | 37 + .../com/lhh/corator/LeaderLatchExample.java | 42 + .../lhh/corator/LeaderSelectorExample.java | 58 + .../lhh/com/lhh/corator/ZkCoratorTest.java | 41 + .../native1/client/ZookeeperClientTest.java | 27 + .../lhh/com/lhh/zkclient/WatchClient.java | 17 + src/java/lhh/com/lhh/zkclient/client.java | 30 + src/java/lib/cobertura/README.txt | 3 + src/java/lib/curator/curator-client-4.0.1.jar | Bin 0 -> 2657457 bytes .../lib/curator/curator-framework-4.0.1.jar | Bin 0 -> 307645 bytes .../lib/curator/curator-recipes-4.0.1.jar | Bin 0 -> 294593 bytes src/java/lib/curator/curator-test-4.0.1.jar | Bin 0 -> 2661037 bytes src/java/lib/jdiff/zookeeper_3.1.1.xml | 2717 ++++++++++ src/java/lib/jline-0.9.94.LICENSE.txt | 33 + src/java/lib/log4j-1.2.17.LICENSE.txt | 202 + src/java/lib/slf4j-1.7.25.LICENSE.txt | 24 + src/java/lib/zkclient-0.3.jar | Bin 0 -> 64009 bytes src/java/main/log4j.properties | 58 + .../org/apache/jute/BinaryInputArchive.java | 130 + .../org/apache/jute/BinaryOutputArchive.java | 146 + .../main/org/apache/jute/CsvInputArchive.java | 208 + .../org/apache/jute/CsvOutputArchive.java | 150 + src/java/main/org/apache/jute/Index.java | 38 + .../main/org/apache/jute/InputArchive.java | 43 + .../main/org/apache/jute/OutputArchive.java | 47 + src/java/main/org/apache/jute/Record.java | 35 + .../main/org/apache/jute/RecordReader.java | 93 + .../main/org/apache/jute/RecordWriter.java | 113 + src/java/main/org/apache/jute/Utils.java | 282 ++ .../main/org/apache/jute/XmlInputArchive.java | 251 + .../org/apache/jute/XmlOutputArchive.java | 251 + .../org/apache/jute/compiler/CGenerator.java | 142 + .../apache/jute/compiler/CSharpGenerator.java | 53 + .../apache/jute/compiler/CppGenerator.java | 136 + .../org/apache/jute/compiler/JBoolean.java | 50 + .../org/apache/jute/compiler/JBuffer.java | 106 + .../main/org/apache/jute/compiler/JByte.java | 34 + .../org/apache/jute/compiler/JCompType.java | 66 + .../org/apache/jute/compiler/JDouble.java | 40 + .../main/org/apache/jute/compiler/JField.java | 140 + .../main/org/apache/jute/compiler/JFile.java | 84 + .../main/org/apache/jute/compiler/JFloat.java | 39 + .../main/org/apache/jute/compiler/JInt.java | 34 + .../main/org/apache/jute/compiler/JLong.java | 38 + .../main/org/apache/jute/compiler/JMap.java | 149 + .../org/apache/jute/compiler/JRecord.java | 776 +++ .../org/apache/jute/compiler/JString.java | 46 + .../main/org/apache/jute/compiler/JType.java | 204 + .../org/apache/jute/compiler/JVector.java | 153 + .../apache/jute/compiler/JavaGenerator.java | 57 + .../compiler/generated/ParseException.java | 210 + .../apache/jute/compiler/generated/Rcc.java | 525 ++ .../jute/compiler/generated/RccConstants.java | 88 + .../compiler/generated/RccTokenManager.java | 833 +++ .../compiler/generated/SimpleCharStream.java | 457 ++ .../apache/jute/compiler/generated/Token.java | 99 + .../compiler/generated/TokenMgrError.java | 151 + .../jute/compiler/generated/package.html | 28 + .../org/apache/jute/compiler/generated/rcc.jj | 374 ++ .../org/apache/jute/compiler/package.html | 30 + src/java/main/org/apache/jute/package.html | 801 +++ .../org/apache/zookeeper/AsyncCallback.java | 309 ++ .../main/org/apache/zookeeper/ClientCnxn.java | 1481 ++++++ .../apache/zookeeper/ClientCnxnSocket.java | 175 + .../apache/zookeeper/ClientCnxnSocketNIO.java | 431 ++ .../apache/zookeeper/ClientWatchManager.java | 40 + .../main/org/apache/zookeeper/CreateMode.java | 94 + .../org/apache/zookeeper/Environment.java | 103 + .../apache/zookeeper/JLineZNodeCompletor.java | 84 + .../org/apache/zookeeper/KeeperException.java | 728 +++ src/java/main/org/apache/zookeeper/Login.java | 407 ++ .../org/apache/zookeeper/MultiResponse.java | 166 + .../zookeeper/MultiTransactionRecord.java | 160 + src/java/main/org/apache/zookeeper/Op.java | 351 ++ .../main/org/apache/zookeeper/OpResult.java | 185 + .../main/org/apache/zookeeper/Quotas.java | 68 + .../zookeeper/SaslClientCallbackHandler.java | 104 + .../apache/zookeeper/ServerAdminClient.java | 316 ++ src/java/main/org/apache/zookeeper/Shell.java | 477 ++ .../main/org/apache/zookeeper/StatsTrack.java | 101 + .../main/org/apache/zookeeper/Testable.java | 29 + .../org/apache/zookeeper/Transaction.java | 70 + .../main/org/apache/zookeeper/Version.java | 90 + .../org/apache/zookeeper/WatchedEvent.java | 81 + .../main/org/apache/zookeeper/Watcher.java | 156 + .../main/org/apache/zookeeper/ZKUtil.java | 124 + .../main/org/apache/zookeeper/ZooDefs.java | 125 + .../main/org/apache/zookeeper/ZooKeeper.java | 1857 +++++++ .../org/apache/zookeeper/ZooKeeperMain.java | 871 ++++ .../apache/zookeeper/ZooKeeperTestable.java | 47 + .../zookeeper/client/ConnectStringParser.java | 87 + .../zookeeper/client/FourLetterWordMain.java | 107 + .../apache/zookeeper/client/HostProvider.java | 66 + .../zookeeper/client/StaticHostProvider.java | 179 + .../zookeeper/client/ZooKeeperSaslClient.java | 439 ++ .../common/AtomicFileOutputStream.java | 126 + .../org/apache/zookeeper/common/IOUtils.java | 123 + .../org/apache/zookeeper/common/PathTrie.java | 293 ++ .../apache/zookeeper/common/PathUtils.java | 103 + .../org/apache/zookeeper/common/Time.java | 52 + .../org/apache/zookeeper/jmx/CommonNames.java | 29 + .../apache/zookeeper/jmx/MBeanRegistry.java | 219 + .../org/apache/zookeeper/jmx/ManagedUtil.java | 72 + .../org/apache/zookeeper/jmx/ZKMBeanInfo.java | 36 + .../server/ByteBufferInputStream.java | 82 + .../server/ByteBufferOutputStream.java | 52 + .../zookeeper/server/ConnectionBean.java | 173 + .../zookeeper/server/ConnectionMXBean.java | 98 + .../org/apache/zookeeper/server/DataNode.java | 180 + .../org/apache/zookeeper/server/DataTree.java | 1237 +++++ .../apache/zookeeper/server/DataTreeBean.java | 61 + .../zookeeper/server/DataTreeMXBean.java | 47 + .../server/DatadirCleanupManager.java | 192 + .../org/apache/zookeeper/server/ExitCode.java | 27 + .../server/FinalRequestProcessor.java | 406 ++ .../apache/zookeeper/server/LogFormatter.java | 108 + .../zookeeper/server/NIOServerCnxn.java | 1218 +++++ .../server/NIOServerCnxnFactory.java | 320 ++ .../zookeeper/server/NettyServerCnxn.java | 897 ++++ .../server/NettyServerCnxnFactory.java | 422 ++ .../apache/zookeeper/server/ObserverBean.java | 49 + .../server/PrepRequestProcessor.java | 774 +++ .../apache/zookeeper/server/PurgeTxnLog.java | 236 + .../server/ReferenceCountedACLCache.java | 226 + .../org/apache/zookeeper/server/Request.java | 254 + .../zookeeper/server/RequestProcessor.java | 44 + .../apache/zookeeper/server/ServerCnxn.java | 548 ++ .../zookeeper/server/ServerCnxnFactory.java | 226 + .../apache/zookeeper/server/ServerConfig.java | 112 + .../apache/zookeeper/server/ServerStats.java | 158 + .../zookeeper/server/SessionTracker.java | 81 + .../zookeeper/server/SessionTrackerImpl.java | 280 + .../zookeeper/server/SnapshotFormatter.java | 128 + .../org/apache/zookeeper/server/Stats.java | 68 + .../server/SyncRequestProcessor.java | 234 + .../zookeeper/server/TraceFormatter.java | 123 + .../server/UnimplementedRequestProcessor.java | 48 + .../apache/zookeeper/server/WatchManager.java | 171 + .../apache/zookeeper/server/ZKDatabase.java | 499 ++ .../server/ZooKeeperCriticalThread.java | 52 + .../zookeeper/server/ZooKeeperSaslServer.java | 65 + .../zookeeper/server/ZooKeeperServer.java | 1104 ++++ .../zookeeper/server/ZooKeeperServerBean.java | 162 + .../server/ZooKeeperServerListener.java | 35 + .../server/ZooKeeperServerListenerImpl.java | 45 + .../server/ZooKeeperServerMXBean.java | 126 + .../zookeeper/server/ZooKeeperServerMain.java | 155 + .../ZooKeeperServerShutdownHandler.java | 46 + .../zookeeper/server/ZooKeeperThread.java | 62 + .../org/apache/zookeeper/server/ZooTrace.java | 91 + .../server/auth/AuthenticationProvider.java | 82 + .../auth/DigestAuthenticationProvider.java | 139 + .../server/auth/DigestLoginModule.java | 61 + .../server/auth/IPAuthenticationProvider.java | 117 + .../zookeeper/server/auth/KerberosName.java | 418 ++ .../server/auth/ProviderRegistry.java | 77 + .../auth/SASLAuthenticationProvider.java | 70 + .../auth/SaslServerCallbackHandler.java | 154 + .../org/apache/zookeeper/server/package.html | 101 + .../server/persistence/FilePadding.java | 112 + .../server/persistence/FileSnap.java | 255 + .../server/persistence/FileTxnLog.java | 691 +++ .../server/persistence/FileTxnSnapLog.java | 428 ++ .../server/persistence/SnapShot.java | 66 + .../zookeeper/server/persistence/TxnLog.java | 128 + .../server/persistence/TxnLogToolkit.java | 273 + .../persistence/TxnLogToolkitCliParser.java | 101 + .../zookeeper/server/persistence/Util.java | 321 ++ .../server/quorum/AckRequestProcessor.java | 54 + .../server/quorum/AuthFastLeaderElection.java | 980 ++++ .../server/quorum/CommitProcessor.java | 195 + .../zookeeper/server/quorum/Election.java | 27 + .../server/quorum/FastLeaderElection.java | 1015 ++++ .../zookeeper/server/quorum/Follower.java | 172 + .../zookeeper/server/quorum/FollowerBean.java | 55 + .../server/quorum/FollowerMXBean.java | 46 + .../quorum/FollowerRequestProcessor.java | 114 + .../quorum/FollowerZooKeeperServer.java | 165 + .../zookeeper/server/quorum/Leader.java | 1083 ++++ .../zookeeper/server/quorum/LeaderBean.java | 77 + .../server/quorum/LeaderElection.java | 295 ++ .../server/quorum/LeaderElectionBean.java | 42 + .../server/quorum/LeaderElectionMXBean.java | 31 + .../zookeeper/server/quorum/LeaderMXBean.java | 61 + .../server/quorum/LeaderZooKeeperServer.java | 182 + .../zookeeper/server/quorum/Learner.java | 570 +++ .../server/quorum/LearnerHandler.java | 715 +++ .../server/quorum/LearnerSessionTracker.java | 98 + .../server/quorum/LearnerSyncRequest.java | 34 + .../server/quorum/LearnerZooKeeperServer.java | 146 + .../server/quorum/LocalPeerBean.java | 79 + .../server/quorum/LocalPeerMXBean.java | 77 + .../zookeeper/server/quorum/Observer.java | 141 + .../server/quorum/ObserverMXBean.java | 37 + .../quorum/ObserverRequestProcessor.java | 128 + .../quorum/ObserverZooKeeperServer.java | 152 + .../quorum/ProposalRequestProcessor.java | 93 + .../server/quorum/ProposalStats.java | 71 + .../zookeeper/server/quorum/QuorumBean.java | 44 + .../server/quorum/QuorumCnxManager.java | 1152 +++++ .../zookeeper/server/quorum/QuorumMXBean.java | 34 + .../zookeeper/server/quorum/QuorumPeer.java | 1544 ++++++ .../server/quorum/QuorumPeerConfig.java | 483 ++ .../server/quorum/QuorumPeerMain.java | 182 + .../zookeeper/server/quorum/QuorumStats.java | 68 + .../server/quorum/QuorumZooKeeperServer.java | 65 + .../zookeeper/server/quorum/ReadOnlyBean.java | 38 + .../quorum/ReadOnlyRequestProcessor.java | 129 + .../quorum/ReadOnlyZooKeeperServer.java | 155 + .../server/quorum/RemotePeerBean.java | 45 + .../server/quorum/RemotePeerMXBean.java | 33 + .../quorum/SendAckRequestProcessor.java | 80 + .../zookeeper/server/quorum/ServerBean.java | 38 + .../zookeeper/server/quorum/ServerMXBean.java | 33 + .../zookeeper/server/quorum/StateSummary.java | 57 + .../apache/zookeeper/server/quorum/Vote.java | 169 + .../quorum/auth/NullQuorumAuthLearner.java | 33 + .../quorum/auth/NullQuorumAuthServer.java | 34 + .../server/quorum/auth/QuorumAuth.java | 96 + .../server/quorum/auth/QuorumAuthLearner.java | 40 + .../server/quorum/auth/QuorumAuthServer.java | 41 + .../quorum/auth/SaslQuorumAuthLearner.java | 225 + .../quorum/auth/SaslQuorumAuthServer.java | 180 + .../auth/SaslQuorumServerCallbackHandler.java | 148 + .../quorum/flexible/QuorumHierarchical.java | 275 + .../server/quorum/flexible/QuorumMaj.java | 63 + .../quorum/flexible/QuorumVerifier.java | 33 + .../zookeeper/server/upgrade/DataNodeV1.java | 129 + .../zookeeper/server/upgrade/DataTreeV1.java | 567 +++ .../zookeeper/server/upgrade/UpgradeMain.java | 185 + .../server/upgrade/UpgradeSnapShot.java | 33 + .../server/upgrade/UpgradeSnapShotV1.java | 332 ++ .../zookeeper/server/util/KerberosUtil.java | 44 + .../zookeeper/server/util/OSMXBean.java | 181 + .../zookeeper/server/util/Profiler.java | 41 + .../zookeeper/server/util/SerializeUtils.java | 159 + .../zookeeper/server/util/ZxidUtils.java | 34 + .../apache/zookeeper/util/SecurityUtils.java | 298 ++ .../apache/zookeeper/version/util/VerGen.java | 178 + src/java/main/overview.html | 26 + src/java/systest/README.txt | 62 + .../zookeeper/test/system/BaseSysTest.java | 280 + .../test/system/DuplicateNameException.java | 26 + .../zookeeper/test/system/GenerateLoad.java | 720 +++ .../zookeeper/test/system/Instance.java | 59 + .../test/system/InstanceContainer.java | 310 ++ .../test/system/InstanceManager.java | 357 ++ .../test/system/NoAssignmentException.java | 24 + .../test/system/NoAvailableContainers.java | 28 + .../test/system/QuorumPeerInstance.java | 284 ++ .../zookeeper/test/system/SimpleClient.java | 118 + .../zookeeper/test/system/SimpleSysTest.java | 171 + src/java/test/bin/check_compatibility.py | 204 + src/java/test/bin/test-github-pr.sh | 616 +++ src/java/test/bin/test-patch.properties | 18 + src/java/test/bin/test-patch.sh | 637 +++ src/java/test/checkstyle-noframes-sorted.xsl | 178 + src/java/test/checkstyle.xml | 187 + src/java/test/config/findbugsExcludeFile.xml | 166 + .../data/buffersize/create/version-2/log.1 | Bin 0 -> 51216 bytes .../buffersize/create/version-2/snapshot.0 | Bin 0 -> 296 bytes .../test/data/buffersize/set/version-2/log.1 | Bin 0 -> 51216 bytes .../data/buffersize/set/version-2/snapshot.0 | Bin 0 -> 296 bytes .../data/buffersize/snapshot/version-2/log.1 | Bin 0 -> 51216 bytes .../buffersize/snapshot/version-2/snapshot.0 | Bin 0 -> 296 bytes .../buffersize/snapshot/version-2/snapshot.2 | Bin 0 -> 5429 bytes .../test/data/invalidsnap/version-2/log.1 | Bin 0 -> 59360 bytes .../test/data/invalidsnap/version-2/log.274 | Bin 0 -> 91616 bytes .../test/data/invalidsnap/version-2/log.42 | Bin 0 -> 184 bytes .../test/data/invalidsnap/version-2/log.63b | Bin 0 -> 49008 bytes .../data/invalidsnap/version-2/snapshot.0 | Bin 0 -> 296 bytes .../data/invalidsnap/version-2/snapshot.272 | Bin 0 -> 56408 bytes .../data/invalidsnap/version-2/snapshot.273 | Bin 0 -> 56521 bytes .../data/invalidsnap/version-2/snapshot.639 | Bin 0 -> 143163 bytes .../data/invalidsnap/version-2/snapshot.83f | Bin 0 -> 4824 bytes src/java/test/data/kerberos/minikdc-krb5.conf | 30 + src/java/test/data/kerberos/minikdc.ldiff | 52 + src/java/test/data/upgrade/log.100000001 | Bin 0 -> 2458624 bytes src/java/test/data/upgrade/log.100001bf0 | Bin 0 -> 1025024 bytes src/java/test/data/upgrade/snapshot.100000000 | Bin 0 -> 73 bytes src/java/test/data/upgrade/snapshot.100001bec | Bin 0 -> 2567595 bytes .../apache/jute/BinaryInputArchiveTest.java | 43 + .../apache/zookeeper/ClientReconnectTest.java | 78 + .../apache/zookeeper/JUnit4ZKTestRunner.java | 86 + .../apache/zookeeper/JaasConfiguration.java | 75 + .../test/org/apache/zookeeper/MockPacket.java | 46 + .../apache/zookeeper/MultiResponseTest.java | 72 + .../zookeeper/MultiTransactionRecordTest.java | 68 + .../org/apache/zookeeper/PortAssignment.java | 35 + .../org/apache/zookeeper/SaslAuthTest.java | 213 + .../apache/zookeeper/ServerConfigTest.java | 74 + .../apache/zookeeper/TestableZooKeeper.java | 133 + .../test/org/apache/zookeeper/VerGenTest.java | 78 + .../test/org/apache/zookeeper/ZKTestCase.java | 88 + .../org/apache/zookeeper/ZooKeeperTest.java | 281 ++ .../org/apache/zookeeper/common/TimeTest.java | 109 + .../org/apache/zookeeper/server/CRCTest.java | 190 + .../apache/zookeeper/server/DataNodeTest.java | 65 + .../apache/zookeeper/server/DataTreeTest.java | 235 + .../zookeeper/server/DataTreeUnitTest.java | 60 + .../server/DatadirCleanupManagerTest.java | 91 + .../server/DeserializationPerfTest.java | 119 + .../server/InvalidSnapCountTest.java | 126 + .../zookeeper/server/InvalidSnapshotTest.java | 84 + .../zookeeper/server/MockNIOServerCnxn.java | 45 + .../zookeeper/server/NIOServerCnxnTest.java | 106 + .../zookeeper/server/NettyServerCnxnTest.java | 103 + .../server/PrepRequestProcessorTest.java | 262 + .../apache/zookeeper/server/PurgeTxnTest.java | 604 +++ .../server/ReferenceCountedACLCacheTest.java | 287 ++ .../server/SerializationPerfTest.java | 125 + .../server/ServerCnxnFactoryAccessor.java | 24 + .../zookeeper/server/ServerStatsTest.java | 145 + .../zookeeper/server/SessionTrackerTest.java | 156 + .../apache/zookeeper/server/ToStringTest.java | 38 + .../server/ZooKeeperServerMainTest.java | 615 +++ .../server/ZooKeeperServerStartupTest.java | 302 ++ .../zookeeper/server/ZooKeeperServerTest.java | 137 + .../zookeeper/server/ZooKeeperThreadTest.java | 84 + .../zookeeper/server/ZxidRolloverTest.java | 444 ++ .../server/persistence/FileTxnLogTest.java | 139 + .../persistence/FileTxnSnapLogTest.java | 148 + .../TxnLogToolkitCliParserTest.java | 110 + .../server/persistence/TxnLogToolkitTest.java | 155 + .../server/quorum/CnxManagerTest.java | 463 ++ .../quorum/EphemeralNodeDeletionTest.java | 219 + .../quorum/FLEBackwardElectionRoundTest.java | 159 + .../server/quorum/FLECompatibilityTest.java | 350 ++ .../server/quorum/FLEDontCareTest.java | 262 + .../server/quorum/FLELostMessageTest.java | 113 + .../zookeeper/server/quorum/FLETestUtils.java | 86 + .../server/quorum/LeaderBeanTest.java | 151 + .../server/quorum/LeaderWithObserverTest.java | 177 + .../zookeeper/server/quorum/LearnerTest.java | 135 + .../server/quorum/ProposalStatsTest.java | 58 + .../server/quorum/QuorumCnxManagerTest.java | 967 ++++ .../server/quorum/QuorumPeerMainTest.java | 1361 +++++ .../server/quorum/QuorumPeerTestBase.java | 225 + .../server/quorum/WatchLeakTest.java | 306 ++ .../zookeeper/server/quorum/Zab1_0Test.java | 1376 +++++ .../zookeeper/server/quorum/ZabUtils.java | 142 + .../quorum/auth/KerberosSecurityTestcase.java | 120 + .../server/quorum/auth/KerberosTestUtils.java | 76 + .../zookeeper/server/quorum/auth/MiniKdc.java | 574 +++ .../server/quorum/auth/MiniKdcTest.java | 185 + .../quorum/auth/QuorumAuthTestBase.java | 248 + .../quorum/auth/QuorumAuthUpgradeTest.java | 239 + .../quorum/auth/QuorumDigestAuthTest.java | 380 ++ .../quorum/auth/QuorumKerberosAuthTest.java | 115 + .../auth/QuorumKerberosHostBasedAuthTest.java | 192 + .../zookeeper/server/util/PortForwarder.java | 256 + .../server/util/SerializeUtilsTest.java | 128 + .../apache/zookeeper/test/ACLCountTest.java | 136 + .../apache/zookeeper/test/ACLRootTest.java | 98 + .../org/apache/zookeeper/test/ACLTest.java | 186 + .../zookeeper/test/AsyncHammerTest.java | 245 + .../org/apache/zookeeper/test/AsyncOps.java | 655 +++ .../apache/zookeeper/test/AsyncOpsTest.java | 227 + .../org/apache/zookeeper/test/AsyncTest.java | 172 + .../test/AtomicFileOutputStreamTest.java | 200 + .../org/apache/zookeeper/test/AuthTest.java | 174 + .../apache/zookeeper/test/BufferSizeTest.java | 132 + .../zookeeper/test/ChrootAsyncTest.java | 47 + .../zookeeper/test/ChrootClientTest.java | 54 + .../org/apache/zookeeper/test/ChrootTest.java | 136 + .../org/apache/zookeeper/test/ClientBase.java | 757 +++ .../zookeeper/test/ClientHammerTest.java | 246 + .../zookeeper/test/ClientPortBindTest.java | 127 + .../apache/zookeeper/test/ClientRetry.java | 72 + .../org/apache/zookeeper/test/ClientTest.java | 805 +++ .../test/ConnectStringParserTest.java | 68 + .../apache/zookeeper/test/CreateModeTest.java | 81 + .../test/DisconnectableZooKeeper.java | 58 + .../test/DisconnectedWatcherTest.java | 258 + .../apache/zookeeper/test/EventTypeTest.java | 50 + .../zookeeper/test/FLENewEpochTest.java | 192 + .../zookeeper/test/FLEPredicateTest.java | 104 + .../apache/zookeeper/test/FLERestartTest.java | 203 + .../org/apache/zookeeper/test/FLETest.java | 473 ++ .../zookeeper/test/FLEZeroWeightTest.java | 181 + .../test/FollowerResyncConcurrencyTest.java | 607 +++ .../apache/zookeeper/test/FollowerTest.java | 140 + .../test/FourLetterWordsQuorumTest.java | 113 + .../zookeeper/test/FourLetterWordsTest.java | 238 + .../test/FourLetterWordsWhiteListTest.java | 253 + .../zookeeper/test/GetChildren2Test.java | 136 + .../test/HierarchicalQuorumTest.java | 309 ++ .../apache/zookeeper/test/IntegrityCheck.java | 232 + .../zookeeper/test/InvalidSnapshotTest.java | 125 + .../org/apache/zookeeper/test/JMXEnv.java | 325 ++ .../zookeeper/test/KeeperStateTest.java | 76 + .../zookeeper/test/LENonTerminateTest.java | 378 ++ .../org/apache/zookeeper/test/LETest.java | 137 + .../test/LoadFromLogNoServerTest.java | 175 + .../zookeeper/test/LoadFromLogTest.java | 223 + .../apache/zookeeper/test/MaxCnxnsTest.java | 139 + .../zookeeper/test/MultiTransactionTest.java | 805 +++ .../zookeeper/test/NioNettySuiteBase.java | 43 + .../test/NioNettySuiteHammerTest.java | 30 + .../zookeeper/test/NioNettySuiteTest.java | 37 + .../test/NonRecoverableErrorTest.java | 183 + .../apache/zookeeper/test/NullDataTest.java | 75 + .../org/apache/zookeeper/test/OOMTest.java | 161 + .../apache/zookeeper/test/OSMXBeanTest.java | 70 + .../test/ObserverHierarchicalQuorumTest.java | 43 + .../apache/zookeeper/test/ObserverLETest.java | 76 + .../test/ObserverQuorumHammerTest.java | 39 + .../apache/zookeeper/test/ObserverTest.java | 233 + .../org/apache/zookeeper/test/QuorumBase.java | 341 ++ .../zookeeper/test/QuorumHammerTest.java | 51 + .../zookeeper/test/QuorumQuotaTest.java | 63 + .../org/apache/zookeeper/test/QuorumTest.java | 296 ++ .../org/apache/zookeeper/test/QuorumUtil.java | 261 + .../zookeeper/test/QuorumZxidSyncTest.java | 171 + .../zookeeper/test/ReadOnlyModeTest.java | 291 ++ .../apache/zookeeper/test/RecoveryTest.java | 209 + .../zookeeper/test/RepeatStartupTest.java | 69 + .../test/RestoreCommittedLogTest.java | 91 + .../test/SaslAuthDesignatedClientTest.java | 104 + .../test/SaslAuthDesignatedServerTest.java | 104 + .../SaslAuthFailDesignatedClientTest.java | 108 + .../test/SaslAuthFailNotifyTest.java | 98 + .../zookeeper/test/SaslAuthFailTest.java | 76 + .../test/SaslAuthMissingClientConfigTest.java | 97 + .../apache/zookeeper/test/SaslClientTest.java | 62 + .../test/SessionInvalidationTest.java | 105 + .../apache/zookeeper/test/SessionTest.java | 394 ++ .../zookeeper/test/SessionTimeoutTest.java | 129 + .../apache/zookeeper/test/SledgeHammer.java | 115 + .../apache/zookeeper/test/StandaloneTest.java | 65 + .../org/apache/zookeeper/test/StatTest.java | 205 + .../test/StaticHostProviderTest.java | 362 ++ .../apache/zookeeper/test/SyncCallTest.java | 108 + .../org/apache/zookeeper/test/TestHammer.java | 63 + .../org/apache/zookeeper/test/TestUtils.java | 60 + .../apache/zookeeper/test/TruncateTest.java | 256 + .../apache/zookeeper/test/UpgradeTest.java | 105 + .../test/WatchEventWhenAutoReset.java | 212 + .../zookeeper/test/WatchedEventTest.java | 95 + .../zookeeper/test/WatcherFuncTest.java | 478 ++ .../apache/zookeeper/test/WatcherTest.java | 408 ++ .../test/ZkDatabaseCorruptionTest.java | 161 + .../zookeeper/test/ZooKeeperQuotaTest.java | 85 + .../zookeeper/test/ZooKeeperTestClient.java | 422 ++ src/lastRevision.bat | 22 + src/lastRevision.sh | 21 + src/packages/deb/init.d/zookeeper | 140 + src/packages/deb/zookeeper.control/conffile | 15 + src/packages/deb/zookeeper.control/control | 23 + src/packages/deb/zookeeper.control/postinst | 23 + src/packages/deb/zookeeper.control/postrm | 19 + src/packages/deb/zookeeper.control/preinst | 20 + src/packages/deb/zookeeper.control/prerm | 24 + src/packages/rpm/init.d/zookeeper | 84 + src/packages/rpm/spec/zookeeper.spec | 166 + src/packages/templates/conf/zookeeper-env.sh | 16 + src/packages/update-zookeeper-env.sh | 163 + src/pom.template | 41 + src/recipes/README.txt | 25 + src/recipes/build-recipes.xml | 177 + src/recipes/build.xml | 79 + src/recipes/election/README.txt | 27 + src/recipes/election/build.xml | 128 + .../recipes/leader/LeaderElectionAware.java | 37 + .../recipes/leader/LeaderElectionSupport.java | 461 ++ .../zookeeper/recipes/leader/LeaderOffer.java | 84 + .../leader/LeaderElectionSupportTest.java | 249 + src/recipes/lock/README.txt | 28 + src/recipes/lock/build.xml | 128 + src/recipes/lock/src/c/INSTALL | 234 + src/recipes/lock/src/c/LICENSE | 202 + src/recipes/lock/src/c/Makefile.am | 46 + src/recipes/lock/src/c/README.txt | 28 + src/recipes/lock/src/c/acinclude.m4 | 312 ++ src/recipes/lock/src/c/aminclude.am | 186 + src/recipes/lock/src/c/c-doc.Doxyfile | 1252 +++++ src/recipes/lock/src/c/configure.ac | 82 + src/recipes/lock/src/c/include/zoo_lock.h | 168 + src/recipes/lock/src/c/src/zoo_lock.c | 396 ++ src/recipes/lock/src/c/tests/TestClient.cc | 201 + src/recipes/lock/src/c/tests/TestDriver.cc | 114 + src/recipes/lock/src/c/tests/Util.cc | 30 + src/recipes/lock/src/c/tests/Util.h | 134 + src/recipes/lock/src/c/tests/zkServer.sh | 75 + .../zookeeper/recipes/lock/LockListener.java | 38 + .../recipes/lock/ProtocolSupport.java | 193 + .../zookeeper/recipes/lock/WriteLock.java | 296 ++ .../zookeeper/recipes/lock/ZNodeName.java | 112 + .../recipes/lock/ZooKeeperOperation.java | 38 + .../zookeeper/recipes/lock/WriteLockTest.java | 156 + .../zookeeper/recipes/lock/ZNodeNameTest.java | 71 + src/recipes/queue/README.txt | 30 + src/recipes/queue/build.xml | 128 + src/recipes/queue/src/c/INSTALL | 234 + src/recipes/queue/src/c/LICENSE | 202 + src/recipes/queue/src/c/Makefile.am | 46 + src/recipes/queue/src/c/README.txt | 30 + src/recipes/queue/src/c/acinclude.m4 | 312 ++ src/recipes/queue/src/c/aminclude.am | 186 + src/recipes/queue/src/c/c-doc.Doxyfile | 1252 +++++ src/recipes/queue/src/c/configure.ac | 82 + src/recipes/queue/src/c/include/zoo_queue.h | 118 + src/recipes/queue/src/c/src/zoo_queue.c | 442 ++ src/recipes/queue/src/c/tests/TestClient.cc | 452 ++ src/recipes/queue/src/c/tests/TestDriver.cc | 114 + src/recipes/queue/src/c/tests/Util.cc | 30 + src/recipes/queue/src/c/tests/Util.h | 134 + src/recipes/queue/src/c/tests/zkServer.sh | 75 + .../recipes/queue/DistributedQueue.java | 313 ++ .../recipes/queue/DistributedQueueTest.java | 286 ++ src/zookeeper.jute | 293 ++ 1039 files changed, 203756 insertions(+) create mode 100644 .gitattributes create mode 100644 .gitignore create mode 100644 LICENSE.txt create mode 100644 NOTICE.txt create mode 100644 README_packaging.txt create mode 100644 bin/README.txt create mode 100644 bin/zkCleanup.sh create mode 100644 bin/zkCli.cmd create mode 100644 bin/zkCli.sh create mode 100644 bin/zkEnv.cmd create mode 100644 bin/zkEnv.sh create mode 100644 bin/zkServer.cmd create mode 100644 bin/zkServer.sh create mode 100644 bin/zkTxnLogToolkit.cmd create mode 100644 bin/zkTxnLogToolkit.sh create mode 100644 build.xml create mode 100644 conf/configuration.xsl create mode 100644 conf/log4j.properties create mode 100644 conf/zoo.cfg create mode 100644 conf/zoo_sample.cfg create mode 100644 docs/bookkeeperConfig.html create mode 100644 docs/bookkeeperConfig.pdf create mode 100644 docs/bookkeeperOverview.html create mode 100644 docs/bookkeeperOverview.pdf create mode 100644 docs/bookkeeperProgrammer.html create mode 100644 docs/bookkeeperProgrammer.pdf create mode 100644 docs/bookkeeperStarted.html create mode 100644 docs/bookkeeperStarted.pdf create mode 100644 docs/bookkeeperStream.html create mode 100644 docs/bookkeeperStream.pdf create mode 100644 docs/broken-links.xml create mode 100644 docs/images/2pc.jpg create mode 100644 docs/images/bk-overview.jpg create mode 100644 docs/images/built-with-forrest-button.png create mode 100644 docs/images/favicon.ico create mode 100644 docs/images/hadoop-logo.jpg create mode 100644 docs/images/instruction_arrow.png create mode 100644 docs/images/state_dia.jpg create mode 100644 docs/images/zkcomponents.jpg create mode 100644 docs/images/zknamespace.jpg create mode 100644 docs/images/zkperfRW-3.2.jpg create mode 100644 docs/images/zkperfRW.jpg create mode 100644 docs/images/zkperfreliability.jpg create mode 100644 docs/images/zkservice.jpg create mode 100644 docs/images/zookeeper_small.gif create mode 100644 docs/index.html create mode 100644 docs/index.pdf create mode 100644 docs/javaExample.html create mode 100644 docs/javaExample.pdf create mode 100644 docs/linkmap.html create mode 100644 docs/linkmap.pdf create mode 100644 docs/recipes.html create mode 100644 docs/recipes.pdf create mode 100644 docs/releasenotes.html create mode 100644 docs/skin/CommonMessages_de.xml create mode 100644 docs/skin/CommonMessages_en_US.xml create mode 100644 docs/skin/CommonMessages_es.xml create mode 100644 docs/skin/CommonMessages_fr.xml create mode 100644 docs/skin/basic.css create mode 100644 docs/skin/breadcrumbs-optimized.js create mode 100644 docs/skin/breadcrumbs.js create mode 100644 docs/skin/fontsize.js create mode 100644 docs/skin/getBlank.js create mode 100644 docs/skin/getMenu.js create mode 100644 docs/skin/images/README.txt create mode 100644 docs/skin/images/add.jpg create mode 100644 docs/skin/images/apache-thanks.png create mode 100644 docs/skin/images/built-with-cocoon.gif create mode 100644 docs/skin/images/built-with-forrest-button.png create mode 100644 docs/skin/images/chapter.gif create mode 100644 docs/skin/images/chapter_open.gif create mode 100644 docs/skin/images/current.gif create mode 100644 docs/skin/images/error.png create mode 100644 docs/skin/images/external-link.gif create mode 100644 docs/skin/images/fix.jpg create mode 100644 docs/skin/images/forrest-credit-logo.png create mode 100644 docs/skin/images/hack.jpg create mode 100644 docs/skin/images/header_white_line.gif create mode 100644 docs/skin/images/info.png create mode 100644 docs/skin/images/instruction_arrow.png create mode 100644 docs/skin/images/label.gif create mode 100644 docs/skin/images/page.gif create mode 100644 docs/skin/images/pdfdoc.gif create mode 100644 docs/skin/images/poddoc.png create mode 100644 docs/skin/images/printer.gif create mode 100644 docs/skin/images/rc-b-l-15-1body-2menu-3menu.png create mode 100644 docs/skin/images/rc-b-r-15-1body-2menu-3menu.png create mode 100644 docs/skin/images/rc-b-r-5-1header-2tab-selected-3tab-selected.png create mode 100644 docs/skin/images/rc-t-l-5-1header-2searchbox-3searchbox.png create mode 100644 docs/skin/images/rc-t-l-5-1header-2tab-selected-3tab-selected.png create mode 100644 docs/skin/images/rc-t-l-5-1header-2tab-unselected-3tab-unselected.png create mode 100644 docs/skin/images/rc-t-r-15-1body-2menu-3menu.png create mode 100644 docs/skin/images/rc-t-r-5-1header-2searchbox-3searchbox.png create mode 100644 docs/skin/images/rc-t-r-5-1header-2tab-selected-3tab-selected.png create mode 100644 docs/skin/images/rc-t-r-5-1header-2tab-unselected-3tab-unselected.png create mode 100644 docs/skin/images/remove.jpg create mode 100644 docs/skin/images/rss.png create mode 100644 docs/skin/images/spacer.gif create mode 100644 docs/skin/images/success.png create mode 100644 docs/skin/images/txtdoc.png create mode 100644 docs/skin/images/update.jpg create mode 100644 docs/skin/images/valid-html401.png create mode 100644 docs/skin/images/vcss.png create mode 100644 docs/skin/images/warning.png create mode 100644 docs/skin/images/xmldoc.gif create mode 100644 docs/skin/menu.js create mode 100644 docs/skin/note.txt create mode 100644 docs/skin/print.css create mode 100644 docs/skin/profile.css create mode 100644 docs/skin/prototype.js create mode 100644 docs/skin/screen.css create mode 100644 docs/zookeeperAdmin.html create mode 100644 docs/zookeeperAdmin.pdf create mode 100644 docs/zookeeperHierarchicalQuorums.html create mode 100644 docs/zookeeperHierarchicalQuorums.pdf create mode 100644 docs/zookeeperInternals.html create mode 100644 docs/zookeeperInternals.pdf create mode 100644 docs/zookeeperJMX.html create mode 100644 docs/zookeeperJMX.pdf create mode 100644 docs/zookeeperObservers.html create mode 100644 docs/zookeeperObservers.pdf create mode 100644 docs/zookeeperOtherInfo.html create mode 100644 docs/zookeeperOtherInfo.pdf create mode 100644 docs/zookeeperOver.html create mode 100644 docs/zookeeperOver.pdf create mode 100644 docs/zookeeperProgrammers.html create mode 100644 docs/zookeeperProgrammers.pdf create mode 100644 docs/zookeeperQuotas.html create mode 100644 docs/zookeeperQuotas.pdf create mode 100644 docs/zookeeperReconfig.pdf create mode 100644 docs/zookeeperStarted.html create mode 100644 docs/zookeeperStarted.pdf create mode 100644 docs/zookeeperTutorial.html create mode 100644 docs/zookeeperTutorial.pdf create mode 100644 ivy.xml create mode 100644 ivysettings.xml create mode 100644 src/LICENSE.txt create mode 100644 src/NOTICE.txt create mode 100644 src/c/CMakeLists.txt create mode 100644 src/c/ChangeLog create mode 100644 src/c/INSTALL create mode 100644 src/c/LICENSE create mode 100644 src/c/Makefile.am create mode 100644 src/c/NOTICE.txt create mode 100644 src/c/README create mode 100644 src/c/acinclude.m4 create mode 100644 src/c/aminclude.am create mode 100644 src/c/c-doc.Doxyfile create mode 100644 src/c/cmake_config.h.in create mode 100644 src/c/configure.ac create mode 100644 src/c/include/proto.h create mode 100644 src/c/include/recordio.h create mode 100644 src/c/include/winconfig.h create mode 100644 src/c/include/zookeeper.h create mode 100644 src/c/include/zookeeper_log.h create mode 100644 src/c/include/zookeeper_version.h create mode 100644 src/c/src/cli.c create mode 100644 src/c/src/hashtable/LICENSE.txt create mode 100644 src/c/src/hashtable/hashtable.c create mode 100644 src/c/src/hashtable/hashtable.h create mode 100644 src/c/src/hashtable/hashtable_itr.c create mode 100644 src/c/src/hashtable/hashtable_itr.h create mode 100644 src/c/src/hashtable/hashtable_private.h create mode 100644 src/c/src/load_gen.c create mode 100644 src/c/src/mt_adaptor.c create mode 100644 src/c/src/recordio.c create mode 100644 src/c/src/st_adaptor.c create mode 100644 src/c/src/winport.c create mode 100644 src/c/src/winport.h create mode 100644 src/c/src/zk_adaptor.h create mode 100644 src/c/src/zk_hashtable.c create mode 100644 src/c/src/zk_hashtable.h create mode 100644 src/c/src/zk_log.c create mode 100644 src/c/src/zookeeper.c create mode 100644 src/c/tests/CollectionUtil.h create mode 100644 src/c/tests/CppAssertHelper.h create mode 100644 src/c/tests/LibCMocks.cc create mode 100644 src/c/tests/LibCMocks.h create mode 100644 src/c/tests/LibCSymTable.cc create mode 100644 src/c/tests/LibCSymTable.h create mode 100644 src/c/tests/MocksBase.cc create mode 100644 src/c/tests/MocksBase.h create mode 100644 src/c/tests/PthreadMocks.cc create mode 100644 src/c/tests/PthreadMocks.h create mode 100644 src/c/tests/TestClient.cc create mode 100644 src/c/tests/TestClientRetry.cc create mode 100644 src/c/tests/TestDriver.cc create mode 100644 src/c/tests/TestMulti.cc create mode 100644 src/c/tests/TestOperations.cc create mode 100644 src/c/tests/TestWatchers.cc create mode 100644 src/c/tests/TestZookeeperClose.cc create mode 100644 src/c/tests/TestZookeeperInit.cc create mode 100644 src/c/tests/ThreadingUtil.cc create mode 100644 src/c/tests/ThreadingUtil.h create mode 100644 src/c/tests/Util.cc create mode 100644 src/c/tests/Util.h create mode 100644 src/c/tests/Vector.h create mode 100644 src/c/tests/ZKMocks.cc create mode 100644 src/c/tests/ZKMocks.h create mode 100644 src/c/tests/wrappers-mt.opt create mode 100644 src/c/tests/wrappers.opt create mode 100644 src/c/tests/zkServer.sh create mode 100644 src/contrib/build-contrib.xml create mode 100644 src/contrib/build.xml create mode 100644 src/contrib/fatjar/README.txt create mode 100644 src/contrib/fatjar/build.xml create mode 100644 src/contrib/fatjar/conf/mainClasses create mode 100644 src/contrib/fatjar/src/java/org/apache/zookeeper/util/FatJarMain.java create mode 100644 src/contrib/huebrowser/README create mode 100644 src/contrib/huebrowser/zkui/Makefile create mode 100644 src/contrib/huebrowser/zkui/setup.py create mode 100644 src/contrib/huebrowser/zkui/src/zkui/__init__.py create mode 100644 src/contrib/huebrowser/zkui/src/zkui/forms.py create mode 100644 src/contrib/huebrowser/zkui/src/zkui/models.py create mode 100644 src/contrib/huebrowser/zkui/src/zkui/rest.py create mode 100644 src/contrib/huebrowser/zkui/src/zkui/settings.py create mode 100644 src/contrib/huebrowser/zkui/src/zkui/static/art/line_icons.png create mode 100644 src/contrib/huebrowser/zkui/src/zkui/static/art/zkui.png create mode 100644 src/contrib/huebrowser/zkui/src/zkui/static/bootstrap.js create mode 100644 src/contrib/huebrowser/zkui/src/zkui/static/css/zkui.css create mode 100644 src/contrib/huebrowser/zkui/src/zkui/static/help/index.html create mode 100644 src/contrib/huebrowser/zkui/src/zkui/static/js/Source/Zkui/Zkui.js create mode 100644 src/contrib/huebrowser/zkui/src/zkui/static/js/package.yml create mode 100644 src/contrib/huebrowser/zkui/src/zkui/stats.py create mode 100644 src/contrib/huebrowser/zkui/src/zkui/templates/clients.mako create mode 100644 src/contrib/huebrowser/zkui/src/zkui/templates/create.mako create mode 100644 src/contrib/huebrowser/zkui/src/zkui/templates/edit.mako create mode 100644 src/contrib/huebrowser/zkui/src/zkui/templates/index.mako create mode 100644 src/contrib/huebrowser/zkui/src/zkui/templates/shared_components.mako create mode 100644 src/contrib/huebrowser/zkui/src/zkui/templates/tree.mako create mode 100644 src/contrib/huebrowser/zkui/src/zkui/templates/view.mako create mode 100644 src/contrib/huebrowser/zkui/src/zkui/urls.py create mode 100644 src/contrib/huebrowser/zkui/src/zkui/utils.py create mode 100644 src/contrib/huebrowser/zkui/src/zkui/views.py create mode 100644 src/contrib/huebrowser/zkui/src/zkui/windmilltests.py create mode 100644 src/contrib/loggraph/README.txt create mode 100644 src/contrib/loggraph/bin/loggraph-dev.sh create mode 100644 src/contrib/loggraph/bin/loggraph.sh create mode 100644 src/contrib/loggraph/build.xml create mode 100644 src/contrib/loggraph/ivy.xml create mode 100644 src/contrib/loggraph/src/java/org/apache/zookeeper/graph/FilterException.java create mode 100644 src/contrib/loggraph/src/java/org/apache/zookeeper/graph/FilterOp.java create mode 100644 src/contrib/loggraph/src/java/org/apache/zookeeper/graph/FilterParser.java create mode 100644 src/contrib/loggraph/src/java/org/apache/zookeeper/graph/JsonGenerator.java create mode 100644 src/contrib/loggraph/src/java/org/apache/zookeeper/graph/Log4JEntry.java create mode 100644 src/contrib/loggraph/src/java/org/apache/zookeeper/graph/Log4JSource.java create mode 100644 src/contrib/loggraph/src/java/org/apache/zookeeper/graph/LogEntry.java create mode 100644 src/contrib/loggraph/src/java/org/apache/zookeeper/graph/LogIterator.java create mode 100644 src/contrib/loggraph/src/java/org/apache/zookeeper/graph/LogServer.java create mode 100644 src/contrib/loggraph/src/java/org/apache/zookeeper/graph/LogSkipList.java create mode 100644 src/contrib/loggraph/src/java/org/apache/zookeeper/graph/LogSource.java create mode 100644 src/contrib/loggraph/src/java/org/apache/zookeeper/graph/MeasureThroughput.java create mode 100644 src/contrib/loggraph/src/java/org/apache/zookeeper/graph/MergedLogSource.java create mode 100644 src/contrib/loggraph/src/java/org/apache/zookeeper/graph/RandomAccessFileReader.java create mode 100644 src/contrib/loggraph/src/java/org/apache/zookeeper/graph/TransactionEntry.java create mode 100644 src/contrib/loggraph/src/java/org/apache/zookeeper/graph/TxnLogSource.java create mode 100644 src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/AndOp.java create mode 100644 src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/Arg.java create mode 100644 src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/EqualsOp.java create mode 100644 src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/GreaterThanOp.java create mode 100644 src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/LessThanOp.java create mode 100644 src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/NotOp.java create mode 100644 src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/NumberArg.java create mode 100644 src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/OrOp.java create mode 100644 src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/StringArg.java create mode 100644 src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/SymbolArg.java create mode 100644 src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/XorOp.java create mode 100644 src/contrib/loggraph/src/java/org/apache/zookeeper/graph/servlets/FileLoader.java create mode 100644 src/contrib/loggraph/src/java/org/apache/zookeeper/graph/servlets/Fs.java create mode 100644 src/contrib/loggraph/src/java/org/apache/zookeeper/graph/servlets/GraphData.java create mode 100644 src/contrib/loggraph/src/java/org/apache/zookeeper/graph/servlets/JsonServlet.java create mode 100644 src/contrib/loggraph/src/java/org/apache/zookeeper/graph/servlets/NumEvents.java create mode 100644 src/contrib/loggraph/src/java/org/apache/zookeeper/graph/servlets/StaticContent.java create mode 100644 src/contrib/loggraph/src/java/org/apache/zookeeper/graph/servlets/Throughput.java create mode 100644 src/contrib/loggraph/web/org/apache/zookeeper/graph/log4j.properties create mode 100644 src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/date.format.js create mode 100644 src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/g.bar.js create mode 100644 src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/g.dot.js create mode 100644 src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/g.line.js create mode 100644 src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/g.pie.js create mode 100644 src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/g.raphael.js create mode 100644 src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/load-big.gif create mode 100644 src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/load.gif create mode 100644 src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/loggraph.css create mode 100644 src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/loggraph.js create mode 100644 src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/loggraph.log.js create mode 100644 src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/loggraph.server.js create mode 100644 src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/loggraph.session.js create mode 100644 src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/loggraph.stats.js create mode 100644 src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/loggraph.ui.js create mode 100644 src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/main.html create mode 100644 src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/raphael.js create mode 100644 src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/yui-min.js create mode 100644 src/contrib/monitoring/JMX-RESOURCES create mode 100644 src/contrib/monitoring/README create mode 100644 src/contrib/monitoring/cacti/README create mode 100644 src/contrib/monitoring/check_zookeeper.py create mode 100644 src/contrib/monitoring/ganglia/README create mode 100644 src/contrib/monitoring/ganglia/Screenshot.png create mode 100644 src/contrib/monitoring/ganglia/modpython.conf create mode 100644 src/contrib/monitoring/ganglia/zookeeper.pyconf create mode 100644 src/contrib/monitoring/ganglia/zookeeper_ganglia.py create mode 100644 src/contrib/monitoring/nagios/README.txt create mode 100644 src/contrib/monitoring/nagios/Screenshot-1.png create mode 100644 src/contrib/monitoring/nagios/Screenshot.png create mode 100644 src/contrib/monitoring/nagios/hostgroups.cfg create mode 100644 src/contrib/monitoring/nagios/services.cfg create mode 100644 src/contrib/monitoring/nagios/zookeeper.cfg create mode 100644 src/contrib/monitoring/test.py create mode 100644 src/contrib/rest/NOTICE.txt create mode 100644 src/contrib/rest/README.txt create mode 100644 src/contrib/rest/SPEC.txt create mode 100644 src/contrib/rest/build.xml create mode 100644 src/contrib/rest/conf/keys/README create mode 100644 src/contrib/rest/conf/keys/rest.cer create mode 100644 src/contrib/rest/conf/keys/rest.jks create mode 100644 src/contrib/rest/conf/log4j.properties create mode 100644 src/contrib/rest/conf/rest.properties create mode 100644 src/contrib/rest/ivy.xml create mode 100644 src/contrib/rest/rest.sh create mode 100644 src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/RestMain.java create mode 100644 src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/ZooKeeperService.java create mode 100644 src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/cfg/Credentials.java create mode 100644 src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/cfg/Endpoint.java create mode 100644 src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/cfg/HostPort.java create mode 100644 src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/cfg/HostPortSet.java create mode 100644 src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/cfg/RestCfg.java create mode 100644 src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/filters/HTTPBasicAuth.java create mode 100644 src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/jaxb/ZChildren.java create mode 100644 src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/jaxb/ZChildrenJSON.java create mode 100644 src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/jaxb/ZError.java create mode 100644 src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/jaxb/ZPath.java create mode 100644 src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/jaxb/ZSession.java create mode 100644 src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/jaxb/ZStat.java create mode 100644 src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/resources/JAXBContextResolver.java create mode 100644 src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/resources/KeeperExceptionMapper.java create mode 100644 src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/resources/RuntimeExceptionMapper.java create mode 100644 src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/resources/SessionsResource.java create mode 100644 src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/resources/ZErrorWriter.java create mode 100644 src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/resources/ZNodeResource.java create mode 100644 src/contrib/rest/src/python/README.txt create mode 100644 src/contrib/rest/src/python/demo_master_election.py create mode 100644 src/contrib/rest/src/python/demo_queue.py create mode 100644 src/contrib/rest/src/python/test.py create mode 100644 src/contrib/rest/src/python/zk_dump_tree.py create mode 100644 src/contrib/rest/src/python/zkrest.py create mode 100644 src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/Base.java create mode 100644 src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/CreateTest.java create mode 100644 src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/DeleteTest.java create mode 100644 src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/ExistsTest.java create mode 100644 src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/GetChildrenTest.java create mode 100644 src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/GetTest.java create mode 100644 src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/RestTestSuite.java create mode 100644 src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/RootTest.java create mode 100644 src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/SessionTest.java create mode 100644 src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/SetTest.java create mode 100644 src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/WadlTest.java create mode 100644 src/contrib/rest/src/test/zkServer.sh create mode 100644 src/contrib/zkfuse/Makefile.am create mode 100644 src/contrib/zkfuse/README.txt create mode 100644 src/contrib/zkfuse/build.xml create mode 100644 src/contrib/zkfuse/configure.ac create mode 100644 src/contrib/zkfuse/src/Makefile.am create mode 100644 src/contrib/zkfuse/src/blockingqueue.h create mode 100644 src/contrib/zkfuse/src/doxygen.cfg create mode 100644 src/contrib/zkfuse/src/event.cc create mode 100644 src/contrib/zkfuse/src/event.h create mode 100644 src/contrib/zkfuse/src/log.cc create mode 100644 src/contrib/zkfuse/src/log.h create mode 100644 src/contrib/zkfuse/src/log4cxx.properties create mode 100644 src/contrib/zkfuse/src/mutex.h create mode 100644 src/contrib/zkfuse/src/thread.cc create mode 100644 src/contrib/zkfuse/src/thread.h create mode 100644 src/contrib/zkfuse/src/zkadapter.cc create mode 100644 src/contrib/zkfuse/src/zkadapter.h create mode 100644 src/contrib/zkfuse/src/zkfuse.cc create mode 100644 src/contrib/zkperl/Changes create mode 100644 src/contrib/zkperl/LICENSE create mode 100644 src/contrib/zkperl/MANIFEST create mode 100644 src/contrib/zkperl/Makefile.PL create mode 100644 src/contrib/zkperl/NOTICE create mode 100644 src/contrib/zkperl/README create mode 100644 src/contrib/zkperl/ZooKeeper.pm create mode 100644 src/contrib/zkperl/ZooKeeper.xs create mode 100644 src/contrib/zkperl/build.xml create mode 100644 src/contrib/zkperl/t/10_invalid.t create mode 100644 src/contrib/zkperl/t/15_thread.t create mode 100644 src/contrib/zkperl/t/20_tie.t create mode 100644 src/contrib/zkperl/t/22_stat_tie.t create mode 100644 src/contrib/zkperl/t/24_watch_tie.t create mode 100644 src/contrib/zkperl/t/30_connect.t create mode 100644 src/contrib/zkperl/t/35_log.t create mode 100644 src/contrib/zkperl/t/40_basic.t create mode 100644 src/contrib/zkperl/t/45_class.t create mode 100644 src/contrib/zkperl/t/50_access.t create mode 100644 src/contrib/zkperl/t/60_watch.t create mode 100644 src/contrib/zkperl/t/util.pl create mode 100644 src/contrib/zkperl/typemap create mode 100644 src/contrib/zkpython/README create mode 100644 src/contrib/zkpython/build.xml create mode 100644 src/contrib/zkpython/ivy.xml create mode 100644 src/contrib/zkpython/src/c/pyzk_docstrings.h create mode 100644 src/contrib/zkpython/src/c/zookeeper.c create mode 100644 src/contrib/zkpython/src/examples/README create mode 100644 src/contrib/zkpython/src/examples/watch_znode_for_changes.py create mode 100644 src/contrib/zkpython/src/packages/deb/zkpython.control/control create mode 100644 src/contrib/zkpython/src/packages/rpm/spec/zkpython.spec create mode 100644 src/contrib/zkpython/src/python/setup.py create mode 100644 src/contrib/zkpython/src/python/zk.py create mode 100644 src/contrib/zkpython/src/test/acl_test.py create mode 100644 src/contrib/zkpython/src/test/async_test.py create mode 100644 src/contrib/zkpython/src/test/callback_test.py create mode 100644 src/contrib/zkpython/src/test/clientid_test.py create mode 100644 src/contrib/zkpython/src/test/close_deadlock_test.py create mode 100644 src/contrib/zkpython/src/test/connection_test.py create mode 100644 src/contrib/zkpython/src/test/create_test.py create mode 100644 src/contrib/zkpython/src/test/delete_test.py create mode 100644 src/contrib/zkpython/src/test/exists_test.py create mode 100644 src/contrib/zkpython/src/test/get_set_test.py create mode 100644 src/contrib/zkpython/src/test/run_tests.sh create mode 100644 src/contrib/zkpython/src/test/zkServer.sh create mode 100644 src/contrib/zkpython/src/test/zktestbase.py create mode 100644 src/contrib/zktreeutil/Makefile.am create mode 100644 src/contrib/zktreeutil/README.txt create mode 100644 src/contrib/zktreeutil/build.xml create mode 100644 src/contrib/zktreeutil/configure.ac create mode 100644 src/contrib/zktreeutil/src/Makefile.am create mode 100644 src/contrib/zktreeutil/src/SimpleTree.h create mode 100644 src/contrib/zktreeutil/src/ZkAdaptor.cc create mode 100644 src/contrib/zktreeutil/src/ZkAdaptor.h create mode 100644 src/contrib/zktreeutil/src/ZkTreeUtil.cc create mode 100644 src/contrib/zktreeutil/src/ZkTreeUtil.h create mode 100644 src/contrib/zktreeutil/src/ZkTreeUtilMain.cc create mode 100644 src/contrib/zktreeutil/tests/zk_sample.xml create mode 100644 src/contrib/zooinspector/NOTICE.txt create mode 100644 src/contrib/zooinspector/README.txt create mode 100644 src/contrib/zooinspector/build.xml create mode 100644 src/contrib/zooinspector/config/defaultConnectionSettings.cfg create mode 100644 src/contrib/zooinspector/config/defaultNodeVeiwers.cfg create mode 100644 src/contrib/zooinspector/icons/edtsrclkup_co.gif create mode 100644 src/contrib/zooinspector/icons/file_obj.gif create mode 100644 src/contrib/zooinspector/icons/fldr_obj.gif create mode 100644 src/contrib/zooinspector/icons/info_obj.gif create mode 100644 src/contrib/zooinspector/icons/jspdecl.gif create mode 100644 src/contrib/zooinspector/icons/launch_run.gif create mode 100644 src/contrib/zooinspector/icons/launch_stop.gif create mode 100644 src/contrib/zooinspector/icons/new_con.gif create mode 100644 src/contrib/zooinspector/icons/refresh.gif create mode 100644 src/contrib/zooinspector/icons/save_edit.gif create mode 100644 src/contrib/zooinspector/icons/search_next.gif create mode 100644 src/contrib/zooinspector/icons/search_prev.gif create mode 100644 src/contrib/zooinspector/icons/trash.gif create mode 100644 src/contrib/zooinspector/ivy.xml create mode 100644 src/contrib/zooinspector/lib/jtoaster-1.0.4.jar create mode 100644 src/contrib/zooinspector/lib/log4j.properties create mode 100644 src/contrib/zooinspector/licences/Apache Software Licence v2.0.txt create mode 100644 src/contrib/zooinspector/licences/epl-v10.html create mode 100644 src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/ZooInspector.java create mode 100644 src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/encryption/BasicDataEncryptionManager.java create mode 100644 src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/encryption/DataEncryptionManager.java create mode 100644 src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/NodeViewersChangeListener.java create mode 100644 src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/ZooInspectorAboutDialog.java create mode 100644 src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/ZooInspectorConnectionPropertiesDialog.java create mode 100644 src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/ZooInspectorIconResources.java create mode 100644 src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/ZooInspectorNodeViewersDialog.java create mode 100644 src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/ZooInspectorNodeViewersPanel.java create mode 100644 src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/ZooInspectorPanel.java create mode 100644 src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/ZooInspectorTreeViewer.java create mode 100644 src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/about.html create mode 100644 src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/nodeviewer/NodeViewerACL.java create mode 100644 src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/nodeviewer/NodeViewerData.java create mode 100644 src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/nodeviewer/NodeViewerMetaData.java create mode 100644 src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/nodeviewer/ZooInspectorNodeViewer.java create mode 100644 src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/logger/LoggerFactory.java create mode 100644 src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/manager/NodeListener.java create mode 100644 src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/manager/Pair.java create mode 100644 src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/manager/ZooInspectorManager.java create mode 100644 src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/manager/ZooInspectorManagerImpl.java create mode 100644 src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/manager/ZooInspectorNodeManager.java create mode 100644 src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/manager/ZooInspectorNodeTreeManager.java create mode 100644 src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/manager/ZooInspectorReadOnlyManager.java create mode 100644 src/contrib/zooinspector/src/java/org/apache/zookeeper/retry/ZooKeeperRetry.java create mode 100644 src/contrib/zooinspector/zooInspector-dev.sh create mode 100644 src/contrib/zooinspector/zooInspector.cmd create mode 100644 src/contrib/zooinspector/zooInspector.sh create mode 100644 src/docs/forrest.properties create mode 100644 src/docs/src/documentation/README.txt create mode 100644 src/docs/src/documentation/TODO.txt create mode 100644 src/docs/src/documentation/classes/CatalogManager.properties create mode 100644 src/docs/src/documentation/conf/cli.xconf create mode 100644 src/docs/src/documentation/content/xdocs/bookkeeperConfig.xml create mode 100644 src/docs/src/documentation/content/xdocs/bookkeeperOverview.xml create mode 100644 src/docs/src/documentation/content/xdocs/bookkeeperProgrammer.xml create mode 100644 src/docs/src/documentation/content/xdocs/bookkeeperStarted.xml create mode 100644 src/docs/src/documentation/content/xdocs/bookkeeperStream.xml create mode 100644 src/docs/src/documentation/content/xdocs/index.xml create mode 100644 src/docs/src/documentation/content/xdocs/javaExample.xml create mode 100644 src/docs/src/documentation/content/xdocs/recipes.xml create mode 100644 src/docs/src/documentation/content/xdocs/site.xml create mode 100644 src/docs/src/documentation/content/xdocs/tabs.xml create mode 100644 src/docs/src/documentation/content/xdocs/zookeeperAdmin.xml create mode 100644 src/docs/src/documentation/content/xdocs/zookeeperHierarchicalQuorums.xml create mode 100644 src/docs/src/documentation/content/xdocs/zookeeperInternals.xml create mode 100644 src/docs/src/documentation/content/xdocs/zookeeperJMX.xml create mode 100644 src/docs/src/documentation/content/xdocs/zookeeperObservers.xml create mode 100644 src/docs/src/documentation/content/xdocs/zookeeperOtherInfo.xml create mode 100644 src/docs/src/documentation/content/xdocs/zookeeperOver.xml create mode 100644 src/docs/src/documentation/content/xdocs/zookeeperProgrammers.xml create mode 100644 src/docs/src/documentation/content/xdocs/zookeeperQuotas.xml create mode 100644 src/docs/src/documentation/content/xdocs/zookeeperStarted.xml create mode 100644 src/docs/src/documentation/content/xdocs/zookeeperTutorial.xml create mode 100644 src/docs/src/documentation/resources/images/2pc.jpg create mode 100644 src/docs/src/documentation/resources/images/bk-overview.jpg create mode 100644 src/docs/src/documentation/resources/images/favicon.ico create mode 100644 src/docs/src/documentation/resources/images/hadoop-logo.jpg create mode 100644 src/docs/src/documentation/resources/images/state_dia.dia create mode 100644 src/docs/src/documentation/resources/images/state_dia.jpg create mode 100644 src/docs/src/documentation/resources/images/zkarch.jpg create mode 100644 src/docs/src/documentation/resources/images/zkcomponents.jpg create mode 100644 src/docs/src/documentation/resources/images/zknamespace.jpg create mode 100644 src/docs/src/documentation/resources/images/zkperfRW-3.2.jpg create mode 100644 src/docs/src/documentation/resources/images/zkperfRW.jpg create mode 100644 src/docs/src/documentation/resources/images/zkperfreliability.jpg create mode 100644 src/docs/src/documentation/resources/images/zkservice.jpg create mode 100644 src/docs/src/documentation/resources/images/zookeeper_small.gif create mode 100644 src/docs/src/documentation/skinconf.xml create mode 100644 src/docs/status.xml create mode 100644 src/java/OldChangeLog create mode 100644 src/java/lhh/com/lhh/corator/CoratorSessionExample.java create mode 100644 src/java/lhh/com/lhh/corator/LeaderLatchExample.java create mode 100644 src/java/lhh/com/lhh/corator/LeaderSelectorExample.java create mode 100644 src/java/lhh/com/lhh/corator/ZkCoratorTest.java create mode 100644 src/java/lhh/com/lhh/native1/client/ZookeeperClientTest.java create mode 100644 src/java/lhh/com/lhh/zkclient/WatchClient.java create mode 100644 src/java/lhh/com/lhh/zkclient/client.java create mode 100644 src/java/lib/cobertura/README.txt create mode 100644 src/java/lib/curator/curator-client-4.0.1.jar create mode 100644 src/java/lib/curator/curator-framework-4.0.1.jar create mode 100644 src/java/lib/curator/curator-recipes-4.0.1.jar create mode 100644 src/java/lib/curator/curator-test-4.0.1.jar create mode 100644 src/java/lib/jdiff/zookeeper_3.1.1.xml create mode 100644 src/java/lib/jline-0.9.94.LICENSE.txt create mode 100644 src/java/lib/log4j-1.2.17.LICENSE.txt create mode 100644 src/java/lib/slf4j-1.7.25.LICENSE.txt create mode 100644 src/java/lib/zkclient-0.3.jar create mode 100644 src/java/main/log4j.properties create mode 100644 src/java/main/org/apache/jute/BinaryInputArchive.java create mode 100644 src/java/main/org/apache/jute/BinaryOutputArchive.java create mode 100644 src/java/main/org/apache/jute/CsvInputArchive.java create mode 100644 src/java/main/org/apache/jute/CsvOutputArchive.java create mode 100644 src/java/main/org/apache/jute/Index.java create mode 100644 src/java/main/org/apache/jute/InputArchive.java create mode 100644 src/java/main/org/apache/jute/OutputArchive.java create mode 100644 src/java/main/org/apache/jute/Record.java create mode 100644 src/java/main/org/apache/jute/RecordReader.java create mode 100644 src/java/main/org/apache/jute/RecordWriter.java create mode 100644 src/java/main/org/apache/jute/Utils.java create mode 100644 src/java/main/org/apache/jute/XmlInputArchive.java create mode 100644 src/java/main/org/apache/jute/XmlOutputArchive.java create mode 100644 src/java/main/org/apache/jute/compiler/CGenerator.java create mode 100644 src/java/main/org/apache/jute/compiler/CSharpGenerator.java create mode 100644 src/java/main/org/apache/jute/compiler/CppGenerator.java create mode 100644 src/java/main/org/apache/jute/compiler/JBoolean.java create mode 100644 src/java/main/org/apache/jute/compiler/JBuffer.java create mode 100644 src/java/main/org/apache/jute/compiler/JByte.java create mode 100644 src/java/main/org/apache/jute/compiler/JCompType.java create mode 100644 src/java/main/org/apache/jute/compiler/JDouble.java create mode 100644 src/java/main/org/apache/jute/compiler/JField.java create mode 100644 src/java/main/org/apache/jute/compiler/JFile.java create mode 100644 src/java/main/org/apache/jute/compiler/JFloat.java create mode 100644 src/java/main/org/apache/jute/compiler/JInt.java create mode 100644 src/java/main/org/apache/jute/compiler/JLong.java create mode 100644 src/java/main/org/apache/jute/compiler/JMap.java create mode 100644 src/java/main/org/apache/jute/compiler/JRecord.java create mode 100644 src/java/main/org/apache/jute/compiler/JString.java create mode 100644 src/java/main/org/apache/jute/compiler/JType.java create mode 100644 src/java/main/org/apache/jute/compiler/JVector.java create mode 100644 src/java/main/org/apache/jute/compiler/JavaGenerator.java create mode 100644 src/java/main/org/apache/jute/compiler/generated/ParseException.java create mode 100644 src/java/main/org/apache/jute/compiler/generated/Rcc.java create mode 100644 src/java/main/org/apache/jute/compiler/generated/RccConstants.java create mode 100644 src/java/main/org/apache/jute/compiler/generated/RccTokenManager.java create mode 100644 src/java/main/org/apache/jute/compiler/generated/SimpleCharStream.java create mode 100644 src/java/main/org/apache/jute/compiler/generated/Token.java create mode 100644 src/java/main/org/apache/jute/compiler/generated/TokenMgrError.java create mode 100644 src/java/main/org/apache/jute/compiler/generated/package.html create mode 100644 src/java/main/org/apache/jute/compiler/generated/rcc.jj create mode 100644 src/java/main/org/apache/jute/compiler/package.html create mode 100644 src/java/main/org/apache/jute/package.html create mode 100644 src/java/main/org/apache/zookeeper/AsyncCallback.java create mode 100644 src/java/main/org/apache/zookeeper/ClientCnxn.java create mode 100644 src/java/main/org/apache/zookeeper/ClientCnxnSocket.java create mode 100644 src/java/main/org/apache/zookeeper/ClientCnxnSocketNIO.java create mode 100644 src/java/main/org/apache/zookeeper/ClientWatchManager.java create mode 100644 src/java/main/org/apache/zookeeper/CreateMode.java create mode 100644 src/java/main/org/apache/zookeeper/Environment.java create mode 100644 src/java/main/org/apache/zookeeper/JLineZNodeCompletor.java create mode 100644 src/java/main/org/apache/zookeeper/KeeperException.java create mode 100644 src/java/main/org/apache/zookeeper/Login.java create mode 100644 src/java/main/org/apache/zookeeper/MultiResponse.java create mode 100644 src/java/main/org/apache/zookeeper/MultiTransactionRecord.java create mode 100644 src/java/main/org/apache/zookeeper/Op.java create mode 100644 src/java/main/org/apache/zookeeper/OpResult.java create mode 100644 src/java/main/org/apache/zookeeper/Quotas.java create mode 100644 src/java/main/org/apache/zookeeper/SaslClientCallbackHandler.java create mode 100644 src/java/main/org/apache/zookeeper/ServerAdminClient.java create mode 100644 src/java/main/org/apache/zookeeper/Shell.java create mode 100644 src/java/main/org/apache/zookeeper/StatsTrack.java create mode 100644 src/java/main/org/apache/zookeeper/Testable.java create mode 100644 src/java/main/org/apache/zookeeper/Transaction.java create mode 100644 src/java/main/org/apache/zookeeper/Version.java create mode 100644 src/java/main/org/apache/zookeeper/WatchedEvent.java create mode 100644 src/java/main/org/apache/zookeeper/Watcher.java create mode 100644 src/java/main/org/apache/zookeeper/ZKUtil.java create mode 100644 src/java/main/org/apache/zookeeper/ZooDefs.java create mode 100644 src/java/main/org/apache/zookeeper/ZooKeeper.java create mode 100644 src/java/main/org/apache/zookeeper/ZooKeeperMain.java create mode 100644 src/java/main/org/apache/zookeeper/ZooKeeperTestable.java create mode 100644 src/java/main/org/apache/zookeeper/client/ConnectStringParser.java create mode 100644 src/java/main/org/apache/zookeeper/client/FourLetterWordMain.java create mode 100644 src/java/main/org/apache/zookeeper/client/HostProvider.java create mode 100644 src/java/main/org/apache/zookeeper/client/StaticHostProvider.java create mode 100644 src/java/main/org/apache/zookeeper/client/ZooKeeperSaslClient.java create mode 100644 src/java/main/org/apache/zookeeper/common/AtomicFileOutputStream.java create mode 100644 src/java/main/org/apache/zookeeper/common/IOUtils.java create mode 100644 src/java/main/org/apache/zookeeper/common/PathTrie.java create mode 100644 src/java/main/org/apache/zookeeper/common/PathUtils.java create mode 100644 src/java/main/org/apache/zookeeper/common/Time.java create mode 100644 src/java/main/org/apache/zookeeper/jmx/CommonNames.java create mode 100644 src/java/main/org/apache/zookeeper/jmx/MBeanRegistry.java create mode 100644 src/java/main/org/apache/zookeeper/jmx/ManagedUtil.java create mode 100644 src/java/main/org/apache/zookeeper/jmx/ZKMBeanInfo.java create mode 100644 src/java/main/org/apache/zookeeper/server/ByteBufferInputStream.java create mode 100644 src/java/main/org/apache/zookeeper/server/ByteBufferOutputStream.java create mode 100644 src/java/main/org/apache/zookeeper/server/ConnectionBean.java create mode 100644 src/java/main/org/apache/zookeeper/server/ConnectionMXBean.java create mode 100644 src/java/main/org/apache/zookeeper/server/DataNode.java create mode 100644 src/java/main/org/apache/zookeeper/server/DataTree.java create mode 100644 src/java/main/org/apache/zookeeper/server/DataTreeBean.java create mode 100644 src/java/main/org/apache/zookeeper/server/DataTreeMXBean.java create mode 100644 src/java/main/org/apache/zookeeper/server/DatadirCleanupManager.java create mode 100644 src/java/main/org/apache/zookeeper/server/ExitCode.java create mode 100644 src/java/main/org/apache/zookeeper/server/FinalRequestProcessor.java create mode 100644 src/java/main/org/apache/zookeeper/server/LogFormatter.java create mode 100644 src/java/main/org/apache/zookeeper/server/NIOServerCnxn.java create mode 100644 src/java/main/org/apache/zookeeper/server/NIOServerCnxnFactory.java create mode 100644 src/java/main/org/apache/zookeeper/server/NettyServerCnxn.java create mode 100644 src/java/main/org/apache/zookeeper/server/NettyServerCnxnFactory.java create mode 100644 src/java/main/org/apache/zookeeper/server/ObserverBean.java create mode 100644 src/java/main/org/apache/zookeeper/server/PrepRequestProcessor.java create mode 100644 src/java/main/org/apache/zookeeper/server/PurgeTxnLog.java create mode 100644 src/java/main/org/apache/zookeeper/server/ReferenceCountedACLCache.java create mode 100644 src/java/main/org/apache/zookeeper/server/Request.java create mode 100644 src/java/main/org/apache/zookeeper/server/RequestProcessor.java create mode 100644 src/java/main/org/apache/zookeeper/server/ServerCnxn.java create mode 100644 src/java/main/org/apache/zookeeper/server/ServerCnxnFactory.java create mode 100644 src/java/main/org/apache/zookeeper/server/ServerConfig.java create mode 100644 src/java/main/org/apache/zookeeper/server/ServerStats.java create mode 100644 src/java/main/org/apache/zookeeper/server/SessionTracker.java create mode 100644 src/java/main/org/apache/zookeeper/server/SessionTrackerImpl.java create mode 100644 src/java/main/org/apache/zookeeper/server/SnapshotFormatter.java create mode 100644 src/java/main/org/apache/zookeeper/server/Stats.java create mode 100644 src/java/main/org/apache/zookeeper/server/SyncRequestProcessor.java create mode 100644 src/java/main/org/apache/zookeeper/server/TraceFormatter.java create mode 100644 src/java/main/org/apache/zookeeper/server/UnimplementedRequestProcessor.java create mode 100644 src/java/main/org/apache/zookeeper/server/WatchManager.java create mode 100644 src/java/main/org/apache/zookeeper/server/ZKDatabase.java create mode 100644 src/java/main/org/apache/zookeeper/server/ZooKeeperCriticalThread.java create mode 100644 src/java/main/org/apache/zookeeper/server/ZooKeeperSaslServer.java create mode 100644 src/java/main/org/apache/zookeeper/server/ZooKeeperServer.java create mode 100644 src/java/main/org/apache/zookeeper/server/ZooKeeperServerBean.java create mode 100644 src/java/main/org/apache/zookeeper/server/ZooKeeperServerListener.java create mode 100644 src/java/main/org/apache/zookeeper/server/ZooKeeperServerListenerImpl.java create mode 100644 src/java/main/org/apache/zookeeper/server/ZooKeeperServerMXBean.java create mode 100644 src/java/main/org/apache/zookeeper/server/ZooKeeperServerMain.java create mode 100644 src/java/main/org/apache/zookeeper/server/ZooKeeperServerShutdownHandler.java create mode 100644 src/java/main/org/apache/zookeeper/server/ZooKeeperThread.java create mode 100644 src/java/main/org/apache/zookeeper/server/ZooTrace.java create mode 100644 src/java/main/org/apache/zookeeper/server/auth/AuthenticationProvider.java create mode 100644 src/java/main/org/apache/zookeeper/server/auth/DigestAuthenticationProvider.java create mode 100644 src/java/main/org/apache/zookeeper/server/auth/DigestLoginModule.java create mode 100644 src/java/main/org/apache/zookeeper/server/auth/IPAuthenticationProvider.java create mode 100644 src/java/main/org/apache/zookeeper/server/auth/KerberosName.java create mode 100644 src/java/main/org/apache/zookeeper/server/auth/ProviderRegistry.java create mode 100644 src/java/main/org/apache/zookeeper/server/auth/SASLAuthenticationProvider.java create mode 100644 src/java/main/org/apache/zookeeper/server/auth/SaslServerCallbackHandler.java create mode 100644 src/java/main/org/apache/zookeeper/server/package.html create mode 100644 src/java/main/org/apache/zookeeper/server/persistence/FilePadding.java create mode 100644 src/java/main/org/apache/zookeeper/server/persistence/FileSnap.java create mode 100644 src/java/main/org/apache/zookeeper/server/persistence/FileTxnLog.java create mode 100644 src/java/main/org/apache/zookeeper/server/persistence/FileTxnSnapLog.java create mode 100644 src/java/main/org/apache/zookeeper/server/persistence/SnapShot.java create mode 100644 src/java/main/org/apache/zookeeper/server/persistence/TxnLog.java create mode 100644 src/java/main/org/apache/zookeeper/server/persistence/TxnLogToolkit.java create mode 100644 src/java/main/org/apache/zookeeper/server/persistence/TxnLogToolkitCliParser.java create mode 100644 src/java/main/org/apache/zookeeper/server/persistence/Util.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/AckRequestProcessor.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/AuthFastLeaderElection.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/CommitProcessor.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/Election.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/FastLeaderElection.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/Follower.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/FollowerBean.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/FollowerMXBean.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/FollowerRequestProcessor.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/FollowerZooKeeperServer.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/Leader.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/LeaderBean.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/LeaderElection.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/LeaderElectionBean.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/LeaderElectionMXBean.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/LeaderMXBean.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/LeaderZooKeeperServer.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/Learner.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/LearnerHandler.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/LearnerSessionTracker.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/LearnerSyncRequest.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/LearnerZooKeeperServer.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/LocalPeerBean.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/LocalPeerMXBean.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/Observer.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/ObserverMXBean.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/ObserverRequestProcessor.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/ObserverZooKeeperServer.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/ProposalRequestProcessor.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/ProposalStats.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/QuorumBean.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/QuorumCnxManager.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/QuorumMXBean.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/QuorumPeer.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/QuorumPeerConfig.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/QuorumPeerMain.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/QuorumStats.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/QuorumZooKeeperServer.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/ReadOnlyBean.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/ReadOnlyRequestProcessor.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/ReadOnlyZooKeeperServer.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/RemotePeerBean.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/RemotePeerMXBean.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/SendAckRequestProcessor.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/ServerBean.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/ServerMXBean.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/StateSummary.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/Vote.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/auth/NullQuorumAuthLearner.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/auth/NullQuorumAuthServer.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/auth/QuorumAuth.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/auth/QuorumAuthLearner.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/auth/QuorumAuthServer.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/auth/SaslQuorumAuthLearner.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/auth/SaslQuorumAuthServer.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/auth/SaslQuorumServerCallbackHandler.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/flexible/QuorumHierarchical.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/flexible/QuorumMaj.java create mode 100644 src/java/main/org/apache/zookeeper/server/quorum/flexible/QuorumVerifier.java create mode 100644 src/java/main/org/apache/zookeeper/server/upgrade/DataNodeV1.java create mode 100644 src/java/main/org/apache/zookeeper/server/upgrade/DataTreeV1.java create mode 100644 src/java/main/org/apache/zookeeper/server/upgrade/UpgradeMain.java create mode 100644 src/java/main/org/apache/zookeeper/server/upgrade/UpgradeSnapShot.java create mode 100644 src/java/main/org/apache/zookeeper/server/upgrade/UpgradeSnapShotV1.java create mode 100644 src/java/main/org/apache/zookeeper/server/util/KerberosUtil.java create mode 100644 src/java/main/org/apache/zookeeper/server/util/OSMXBean.java create mode 100644 src/java/main/org/apache/zookeeper/server/util/Profiler.java create mode 100644 src/java/main/org/apache/zookeeper/server/util/SerializeUtils.java create mode 100644 src/java/main/org/apache/zookeeper/server/util/ZxidUtils.java create mode 100644 src/java/main/org/apache/zookeeper/util/SecurityUtils.java create mode 100644 src/java/main/org/apache/zookeeper/version/util/VerGen.java create mode 100644 src/java/main/overview.html create mode 100644 src/java/systest/README.txt create mode 100644 src/java/systest/org/apache/zookeeper/test/system/BaseSysTest.java create mode 100644 src/java/systest/org/apache/zookeeper/test/system/DuplicateNameException.java create mode 100644 src/java/systest/org/apache/zookeeper/test/system/GenerateLoad.java create mode 100644 src/java/systest/org/apache/zookeeper/test/system/Instance.java create mode 100644 src/java/systest/org/apache/zookeeper/test/system/InstanceContainer.java create mode 100644 src/java/systest/org/apache/zookeeper/test/system/InstanceManager.java create mode 100644 src/java/systest/org/apache/zookeeper/test/system/NoAssignmentException.java create mode 100644 src/java/systest/org/apache/zookeeper/test/system/NoAvailableContainers.java create mode 100644 src/java/systest/org/apache/zookeeper/test/system/QuorumPeerInstance.java create mode 100644 src/java/systest/org/apache/zookeeper/test/system/SimpleClient.java create mode 100644 src/java/systest/org/apache/zookeeper/test/system/SimpleSysTest.java create mode 100644 src/java/test/bin/check_compatibility.py create mode 100644 src/java/test/bin/test-github-pr.sh create mode 100644 src/java/test/bin/test-patch.properties create mode 100644 src/java/test/bin/test-patch.sh create mode 100644 src/java/test/checkstyle-noframes-sorted.xsl create mode 100644 src/java/test/checkstyle.xml create mode 100644 src/java/test/config/findbugsExcludeFile.xml create mode 100644 src/java/test/data/buffersize/create/version-2/log.1 create mode 100644 src/java/test/data/buffersize/create/version-2/snapshot.0 create mode 100644 src/java/test/data/buffersize/set/version-2/log.1 create mode 100644 src/java/test/data/buffersize/set/version-2/snapshot.0 create mode 100644 src/java/test/data/buffersize/snapshot/version-2/log.1 create mode 100644 src/java/test/data/buffersize/snapshot/version-2/snapshot.0 create mode 100644 src/java/test/data/buffersize/snapshot/version-2/snapshot.2 create mode 100644 src/java/test/data/invalidsnap/version-2/log.1 create mode 100644 src/java/test/data/invalidsnap/version-2/log.274 create mode 100644 src/java/test/data/invalidsnap/version-2/log.42 create mode 100644 src/java/test/data/invalidsnap/version-2/log.63b create mode 100644 src/java/test/data/invalidsnap/version-2/snapshot.0 create mode 100644 src/java/test/data/invalidsnap/version-2/snapshot.272 create mode 100644 src/java/test/data/invalidsnap/version-2/snapshot.273 create mode 100644 src/java/test/data/invalidsnap/version-2/snapshot.639 create mode 100644 src/java/test/data/invalidsnap/version-2/snapshot.83f create mode 100644 src/java/test/data/kerberos/minikdc-krb5.conf create mode 100644 src/java/test/data/kerberos/minikdc.ldiff create mode 100644 src/java/test/data/upgrade/log.100000001 create mode 100644 src/java/test/data/upgrade/log.100001bf0 create mode 100644 src/java/test/data/upgrade/snapshot.100000000 create mode 100644 src/java/test/data/upgrade/snapshot.100001bec create mode 100644 src/java/test/org/apache/jute/BinaryInputArchiveTest.java create mode 100644 src/java/test/org/apache/zookeeper/ClientReconnectTest.java create mode 100644 src/java/test/org/apache/zookeeper/JUnit4ZKTestRunner.java create mode 100644 src/java/test/org/apache/zookeeper/JaasConfiguration.java create mode 100644 src/java/test/org/apache/zookeeper/MockPacket.java create mode 100644 src/java/test/org/apache/zookeeper/MultiResponseTest.java create mode 100644 src/java/test/org/apache/zookeeper/MultiTransactionRecordTest.java create mode 100644 src/java/test/org/apache/zookeeper/PortAssignment.java create mode 100644 src/java/test/org/apache/zookeeper/SaslAuthTest.java create mode 100644 src/java/test/org/apache/zookeeper/ServerConfigTest.java create mode 100644 src/java/test/org/apache/zookeeper/TestableZooKeeper.java create mode 100644 src/java/test/org/apache/zookeeper/VerGenTest.java create mode 100644 src/java/test/org/apache/zookeeper/ZKTestCase.java create mode 100644 src/java/test/org/apache/zookeeper/ZooKeeperTest.java create mode 100644 src/java/test/org/apache/zookeeper/common/TimeTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/CRCTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/DataNodeTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/DataTreeTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/DataTreeUnitTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/DatadirCleanupManagerTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/DeserializationPerfTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/InvalidSnapCountTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/InvalidSnapshotTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/MockNIOServerCnxn.java create mode 100644 src/java/test/org/apache/zookeeper/server/NIOServerCnxnTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/NettyServerCnxnTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/PrepRequestProcessorTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/PurgeTxnTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/ReferenceCountedACLCacheTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/SerializationPerfTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/ServerCnxnFactoryAccessor.java create mode 100644 src/java/test/org/apache/zookeeper/server/ServerStatsTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/SessionTrackerTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/ToStringTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/ZooKeeperServerMainTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/ZooKeeperServerStartupTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/ZooKeeperServerTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/ZooKeeperThreadTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/ZxidRolloverTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/persistence/FileTxnLogTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/persistence/FileTxnSnapLogTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/persistence/TxnLogToolkitCliParserTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/persistence/TxnLogToolkitTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/quorum/CnxManagerTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/quorum/EphemeralNodeDeletionTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/quorum/FLEBackwardElectionRoundTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/quorum/FLECompatibilityTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/quorum/FLEDontCareTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/quorum/FLELostMessageTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/quorum/FLETestUtils.java create mode 100644 src/java/test/org/apache/zookeeper/server/quorum/LeaderBeanTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/quorum/LeaderWithObserverTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/quorum/LearnerTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/quorum/ProposalStatsTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/quorum/QuorumCnxManagerTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/quorum/QuorumPeerMainTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/quorum/QuorumPeerTestBase.java create mode 100644 src/java/test/org/apache/zookeeper/server/quorum/WatchLeakTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/quorum/Zab1_0Test.java create mode 100644 src/java/test/org/apache/zookeeper/server/quorum/ZabUtils.java create mode 100644 src/java/test/org/apache/zookeeper/server/quorum/auth/KerberosSecurityTestcase.java create mode 100644 src/java/test/org/apache/zookeeper/server/quorum/auth/KerberosTestUtils.java create mode 100644 src/java/test/org/apache/zookeeper/server/quorum/auth/MiniKdc.java create mode 100644 src/java/test/org/apache/zookeeper/server/quorum/auth/MiniKdcTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/quorum/auth/QuorumAuthTestBase.java create mode 100644 src/java/test/org/apache/zookeeper/server/quorum/auth/QuorumAuthUpgradeTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/quorum/auth/QuorumDigestAuthTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/quorum/auth/QuorumKerberosAuthTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/quorum/auth/QuorumKerberosHostBasedAuthTest.java create mode 100644 src/java/test/org/apache/zookeeper/server/util/PortForwarder.java create mode 100644 src/java/test/org/apache/zookeeper/server/util/SerializeUtilsTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/ACLCountTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/ACLRootTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/ACLTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/AsyncHammerTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/AsyncOps.java create mode 100644 src/java/test/org/apache/zookeeper/test/AsyncOpsTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/AsyncTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/AtomicFileOutputStreamTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/AuthTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/BufferSizeTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/ChrootAsyncTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/ChrootClientTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/ChrootTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/ClientBase.java create mode 100644 src/java/test/org/apache/zookeeper/test/ClientHammerTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/ClientPortBindTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/ClientRetry.java create mode 100644 src/java/test/org/apache/zookeeper/test/ClientTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/ConnectStringParserTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/CreateModeTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/DisconnectableZooKeeper.java create mode 100644 src/java/test/org/apache/zookeeper/test/DisconnectedWatcherTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/EventTypeTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/FLENewEpochTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/FLEPredicateTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/FLERestartTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/FLETest.java create mode 100644 src/java/test/org/apache/zookeeper/test/FLEZeroWeightTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/FollowerResyncConcurrencyTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/FollowerTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/FourLetterWordsQuorumTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/FourLetterWordsTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/FourLetterWordsWhiteListTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/GetChildren2Test.java create mode 100644 src/java/test/org/apache/zookeeper/test/HierarchicalQuorumTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/IntegrityCheck.java create mode 100644 src/java/test/org/apache/zookeeper/test/InvalidSnapshotTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/JMXEnv.java create mode 100644 src/java/test/org/apache/zookeeper/test/KeeperStateTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/LENonTerminateTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/LETest.java create mode 100644 src/java/test/org/apache/zookeeper/test/LoadFromLogNoServerTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/LoadFromLogTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/MaxCnxnsTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/MultiTransactionTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/NioNettySuiteBase.java create mode 100644 src/java/test/org/apache/zookeeper/test/NioNettySuiteHammerTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/NioNettySuiteTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/NonRecoverableErrorTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/NullDataTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/OOMTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/OSMXBeanTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/ObserverHierarchicalQuorumTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/ObserverLETest.java create mode 100644 src/java/test/org/apache/zookeeper/test/ObserverQuorumHammerTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/ObserverTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/QuorumBase.java create mode 100644 src/java/test/org/apache/zookeeper/test/QuorumHammerTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/QuorumQuotaTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/QuorumTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/QuorumUtil.java create mode 100644 src/java/test/org/apache/zookeeper/test/QuorumZxidSyncTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/ReadOnlyModeTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/RecoveryTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/RepeatStartupTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/RestoreCommittedLogTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/SaslAuthDesignatedClientTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/SaslAuthDesignatedServerTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/SaslAuthFailDesignatedClientTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/SaslAuthFailNotifyTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/SaslAuthFailTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/SaslAuthMissingClientConfigTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/SaslClientTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/SessionInvalidationTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/SessionTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/SessionTimeoutTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/SledgeHammer.java create mode 100644 src/java/test/org/apache/zookeeper/test/StandaloneTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/StatTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/StaticHostProviderTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/SyncCallTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/TestHammer.java create mode 100644 src/java/test/org/apache/zookeeper/test/TestUtils.java create mode 100644 src/java/test/org/apache/zookeeper/test/TruncateTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/UpgradeTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/WatchEventWhenAutoReset.java create mode 100644 src/java/test/org/apache/zookeeper/test/WatchedEventTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/WatcherFuncTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/WatcherTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/ZkDatabaseCorruptionTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/ZooKeeperQuotaTest.java create mode 100644 src/java/test/org/apache/zookeeper/test/ZooKeeperTestClient.java create mode 100644 src/lastRevision.bat create mode 100644 src/lastRevision.sh create mode 100644 src/packages/deb/init.d/zookeeper create mode 100644 src/packages/deb/zookeeper.control/conffile create mode 100644 src/packages/deb/zookeeper.control/control create mode 100644 src/packages/deb/zookeeper.control/postinst create mode 100644 src/packages/deb/zookeeper.control/postrm create mode 100644 src/packages/deb/zookeeper.control/preinst create mode 100644 src/packages/deb/zookeeper.control/prerm create mode 100644 src/packages/rpm/init.d/zookeeper create mode 100644 src/packages/rpm/spec/zookeeper.spec create mode 100644 src/packages/templates/conf/zookeeper-env.sh create mode 100644 src/packages/update-zookeeper-env.sh create mode 100644 src/pom.template create mode 100644 src/recipes/README.txt create mode 100644 src/recipes/build-recipes.xml create mode 100644 src/recipes/build.xml create mode 100644 src/recipes/election/README.txt create mode 100644 src/recipes/election/build.xml create mode 100644 src/recipes/election/src/java/org/apache/zookeeper/recipes/leader/LeaderElectionAware.java create mode 100644 src/recipes/election/src/java/org/apache/zookeeper/recipes/leader/LeaderElectionSupport.java create mode 100644 src/recipes/election/src/java/org/apache/zookeeper/recipes/leader/LeaderOffer.java create mode 100644 src/recipes/election/test/org/apache/zookeeper/recipes/leader/LeaderElectionSupportTest.java create mode 100644 src/recipes/lock/README.txt create mode 100644 src/recipes/lock/build.xml create mode 100644 src/recipes/lock/src/c/INSTALL create mode 100644 src/recipes/lock/src/c/LICENSE create mode 100644 src/recipes/lock/src/c/Makefile.am create mode 100644 src/recipes/lock/src/c/README.txt create mode 100644 src/recipes/lock/src/c/acinclude.m4 create mode 100644 src/recipes/lock/src/c/aminclude.am create mode 100644 src/recipes/lock/src/c/c-doc.Doxyfile create mode 100644 src/recipes/lock/src/c/configure.ac create mode 100644 src/recipes/lock/src/c/include/zoo_lock.h create mode 100644 src/recipes/lock/src/c/src/zoo_lock.c create mode 100644 src/recipes/lock/src/c/tests/TestClient.cc create mode 100644 src/recipes/lock/src/c/tests/TestDriver.cc create mode 100644 src/recipes/lock/src/c/tests/Util.cc create mode 100644 src/recipes/lock/src/c/tests/Util.h create mode 100644 src/recipes/lock/src/c/tests/zkServer.sh create mode 100644 src/recipes/lock/src/java/org/apache/zookeeper/recipes/lock/LockListener.java create mode 100644 src/recipes/lock/src/java/org/apache/zookeeper/recipes/lock/ProtocolSupport.java create mode 100644 src/recipes/lock/src/java/org/apache/zookeeper/recipes/lock/WriteLock.java create mode 100644 src/recipes/lock/src/java/org/apache/zookeeper/recipes/lock/ZNodeName.java create mode 100644 src/recipes/lock/src/java/org/apache/zookeeper/recipes/lock/ZooKeeperOperation.java create mode 100644 src/recipes/lock/test/org/apache/zookeeper/recipes/lock/WriteLockTest.java create mode 100644 src/recipes/lock/test/org/apache/zookeeper/recipes/lock/ZNodeNameTest.java create mode 100644 src/recipes/queue/README.txt create mode 100644 src/recipes/queue/build.xml create mode 100644 src/recipes/queue/src/c/INSTALL create mode 100644 src/recipes/queue/src/c/LICENSE create mode 100644 src/recipes/queue/src/c/Makefile.am create mode 100644 src/recipes/queue/src/c/README.txt create mode 100644 src/recipes/queue/src/c/acinclude.m4 create mode 100644 src/recipes/queue/src/c/aminclude.am create mode 100644 src/recipes/queue/src/c/c-doc.Doxyfile create mode 100644 src/recipes/queue/src/c/configure.ac create mode 100644 src/recipes/queue/src/c/include/zoo_queue.h create mode 100644 src/recipes/queue/src/c/src/zoo_queue.c create mode 100644 src/recipes/queue/src/c/tests/TestClient.cc create mode 100644 src/recipes/queue/src/c/tests/TestDriver.cc create mode 100644 src/recipes/queue/src/c/tests/Util.cc create mode 100644 src/recipes/queue/src/c/tests/Util.h create mode 100644 src/recipes/queue/src/c/tests/zkServer.sh create mode 100644 src/recipes/queue/src/java/org/apache/zookeeper/recipes/queue/DistributedQueue.java create mode 100644 src/recipes/queue/test/org/apache/zookeeper/recipes/queue/DistributedQueueTest.java create mode 100644 src/zookeeper.jute diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..af96048 --- /dev/null +++ b/.gitattributes @@ -0,0 +1,19 @@ +# Auto detect text files and perform LF normalization +* text=auto + +*.cs text diff=csharp +*.java text diff=java +*.html text diff=html +*.py text diff=python +*.pl text diff=perl +*.pm text diff=perl +*.css text +*.js text +*.sql text + +*.sh text eol=lf + +*.bat text eol=crlf +*.cmd text eol=crlf +*.csproj text merge=union eol=crlf +*.sln text merge=union eol=crlf diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..f89c90a --- /dev/null +++ b/.gitignore @@ -0,0 +1,81 @@ +# Java +hs_err_pid* + +# Git +*.orij +*.rej + +# SVN +.svn +.revision + +# Eclipse +.metadata +.classpath +.eclipse/ +.idea/ +.project +.revision/ +.settings/ +.externalToolBuilders/ +local.properties +.recommenders +*.launch +build/ +target/ +out/ + +# Intellij +*.ipr +*.iws +*.iml + +# NetBeans +*~.nib +nbbuild/ +dist/ +nbdist/ +.ndb-gradle/ +.cproject +.buildpath + +# Other +*~ +logs/ +*.out +*.log +*.bak +*.tmp +tmp/** +tmp/**/* +.DS_Store +.gradle +*.patch +*.swp + +# C +tags +.cproject +.project +obj +src/c/core.* +src/c/TEST-*.txt +src/c/*.la +src/c/*.lo +src/c/*.o +src/c/generated/ +src/java/generated/ +src/java/lib/ant-eclipse-* +src/java/lib/ivy-* +src/c/Makefile.in +src/c/aclocal.m4 +src/c/autom4te.cache/ +src/c/compile +src/c/config.guess +src/c/config.h.in +src/c/config.sub +src/c/configure +src/c/depcomp +src/c/install-sh +src/c/ltmain.sh +src/c/missing diff --git a/LICENSE.txt b/LICENSE.txt new file mode 100644 index 0000000..d645695 --- /dev/null +++ b/LICENSE.txt @@ -0,0 +1,202 @@ + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. diff --git a/NOTICE.txt b/NOTICE.txt new file mode 100644 index 0000000..1ae3351 --- /dev/null +++ b/NOTICE.txt @@ -0,0 +1,5 @@ +Apache ZooKeeper +Copyright 2009-2018 The Apache Software Foundation + +This product includes software developed at +The Apache Software Foundation (http://www.apache.org/). diff --git a/README_packaging.txt b/README_packaging.txt new file mode 100644 index 0000000..48b6918 --- /dev/null +++ b/README_packaging.txt @@ -0,0 +1,65 @@ +README file for Packaging Notes + +Requirement +----------- + +gcc, cppunit and python-setuptools are required to build +C and python bindings. + +On RHEL machine: + +yum install cppunit +yum install python-setuptools + +On Ubuntu: + +apt-get --install cppunit +apt-get --install python-setuptools + +Package build command +--------------------- + +Command to build Debian package: ant deb +Command to build RPM Package: ant rpm + +rpm and deb packages are generated and placed in: + +build/zookeeper*.[rpm|deb] +build/contrib/**.[rpm|deb] + +Default package file structure layout + + /usr/bin - User executable + /usr/sbin - System executable + /usr/libexec - Configuration boot trap script + /usr/lib - Native libraries + /usr/share/doc/zookeeper - Documents + /usr/share/zookeeper - Project files + /usr/share/zookeeper/template/conf - Configuration template files + /etc/zookeeper - Configuration files + /etc/init.d/zookeeper - OS startup script + +Source file structure layout +--------------------- + +src/packages/update-zookeeper-env.sh + - setup environment variables and symlink $PREFIX/etc/zookeeper to + /etc/zookeeper. + - This script is designed to run in post installation, and pre-remove + phase of ZooKeeper package. + - Run update-zookeeper-env.sh -h to get a list of supported parameters. + +src/packages/template + - Standard configuration template + +src/packages/deb + Meta data for creating Debian package + +src/packages/deb/init.d + Daemon start/stop script for Debian flavor of Linux + +src/packages/rpm + Meta data for creating RPM package + +src/packages/rpm/init.d + Daemon start/stop script for Redhat flavor of Linux diff --git a/bin/README.txt b/bin/README.txt new file mode 100644 index 0000000..e70506d --- /dev/null +++ b/bin/README.txt @@ -0,0 +1,6 @@ +This directory contain scripts that allow easy access (classpath in particular) +to the ZooKeeper server and command line client. + +Files ending in .sh are unix and cygwin compatible + +Files ending in .cmd are msdos/windows compatible diff --git a/bin/zkCleanup.sh b/bin/zkCleanup.sh new file mode 100644 index 0000000..38ee2e8 --- /dev/null +++ b/bin/zkCleanup.sh @@ -0,0 +1,51 @@ +#!/usr/bin/env bash + +# Licensed to the Apache Software Foundation (ASF) under one or more +# contributor license agreements. See the NOTICE file distributed with +# this work for additional information regarding copyright ownership. +# The ASF licenses this file to You under the Apache License, Version 2.0 +# (the "License"); you may not use this file except in compliance with +# the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +# +# This script cleans up old transaction logs and snapshots +# + +# +# If this scripted is run out of /usr/bin or some other system bin directory +# it should be linked to and not copied. Things like java jar files are found +# relative to the canonical path of this script. +# + +# use POSTIX interface, symlink is followed automatically +ZOOBIN="${BASH_SOURCE-$0}" +ZOOBIN="$(dirname "${ZOOBIN}")" +ZOOBINDIR="$(cd "${ZOOBIN}"; pwd)" + +if [ -e "$ZOOBIN/../libexec/zkEnv.sh" ]; then + . "$ZOOBINDIR"/../libexec/zkEnv.sh +else + . "$ZOOBINDIR"/zkEnv.sh +fi + +ZOODATADIR="$(grep "^[[:space:]]*dataDir=" "$ZOOCFG" | sed -e 's/.*=//')" +ZOODATALOGDIR="$(grep "^[[:space:]]*dataLogDir=" "$ZOOCFG" | sed -e 's/.*=//')" + +if [ "x$ZOODATALOGDIR" = "x" ] +then +"$JAVA" "-Dzookeeper.log.dir=${ZOO_LOG_DIR}" "-Dzookeeper.root.logger=${ZOO_LOG4J_PROP}" \ + -cp "$CLASSPATH" $JVMFLAGS \ + org.apache.zookeeper.server.PurgeTxnLog "$ZOODATADIR" $* +else +"$JAVA" "-Dzookeeper.log.dir=${ZOO_LOG_DIR}" "-Dzookeeper.root.logger=${ZOO_LOG4J_PROP}" \ + -cp "$CLASSPATH" $JVMFLAGS \ + org.apache.zookeeper.server.PurgeTxnLog "$ZOODATALOGDIR" "$ZOODATADIR" $* +fi diff --git a/bin/zkCli.cmd b/bin/zkCli.cmd new file mode 100644 index 0000000..0ffa030 --- /dev/null +++ b/bin/zkCli.cmd @@ -0,0 +1,24 @@ +@echo off +REM Licensed to the Apache Software Foundation (ASF) under one or more +REM contributor license agreements. See the NOTICE file distributed with +REM this work for additional information regarding copyright ownership. +REM The ASF licenses this file to You under the Apache License, Version 2.0 +REM (the "License"); you may not use this file except in compliance with +REM the License. You may obtain a copy of the License at +REM +REM http://www.apache.org/licenses/LICENSE-2.0 +REM +REM Unless required by applicable law or agreed to in writing, software +REM distributed under the License is distributed on an "AS IS" BASIS, +REM WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +REM See the License for the specific language governing permissions and +REM limitations under the License. + +setlocal +call "%~dp0zkEnv.cmd" + +set ZOOMAIN=org.apache.zookeeper.ZooKeeperMain +call %JAVA% "-Dzookeeper.log.dir=%ZOO_LOG_DIR%" "-Dzookeeper.root.logger=%ZOO_LOG4J_PROP%" -cp "%CLASSPATH%" %ZOOMAIN% %* + +endlocal + diff --git a/bin/zkCli.sh b/bin/zkCli.sh new file mode 100644 index 0000000..992a913 --- /dev/null +++ b/bin/zkCli.sh @@ -0,0 +1,41 @@ +#!/usr/bin/env bash + +# Licensed to the Apache Software Foundation (ASF) under one or more +# contributor license agreements. See the NOTICE file distributed with +# this work for additional information regarding copyright ownership. +# The ASF licenses this file to You under the Apache License, Version 2.0 +# (the "License"); you may not use this file except in compliance with +# the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +# +# This script cleans up old transaction logs and snapshots +# + +# +# If this scripted is run out of /usr/bin or some other system bin directory +# it should be linked to and not copied. Things like java jar files are found +# relative to the canonical path of this script. +# + +# use POSTIX interface, symlink is followed automatically +ZOOBIN="${BASH_SOURCE-$0}" +ZOOBIN="$(dirname "${ZOOBIN}")" +ZOOBINDIR="$(cd "${ZOOBIN}"; pwd)" + +if [ -e "$ZOOBIN/../libexec/zkEnv.sh" ]; then + . "$ZOOBINDIR"/../libexec/zkEnv.sh +else + . "$ZOOBINDIR"/zkEnv.sh +fi + +"$JAVA" "-Dzookeeper.log.dir=${ZOO_LOG_DIR}" "-Dzookeeper.root.logger=${ZOO_LOG4J_PROP}" \ + -cp "$CLASSPATH" $CLIENT_JVMFLAGS $JVMFLAGS \ + org.apache.zookeeper.ZooKeeperMain "$@" diff --git a/bin/zkEnv.cmd b/bin/zkEnv.cmd new file mode 100644 index 0000000..fbc017f --- /dev/null +++ b/bin/zkEnv.cmd @@ -0,0 +1,52 @@ +@echo off +REM Licensed to the Apache Software Foundation (ASF) under one or more +REM contributor license agreements. See the NOTICE file distributed with +REM this work for additional information regarding copyright ownership. +REM The ASF licenses this file to You under the Apache License, Version 2.0 +REM (the "License"); you may not use this file except in compliance with +REM the License. You may obtain a copy of the License at +REM +REM http://www.apache.org/licenses/LICENSE-2.0 +REM +REM Unless required by applicable law or agreed to in writing, software +REM distributed under the License is distributed on an "AS IS" BASIS, +REM WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +REM See the License for the specific language governing permissions and +REM limitations under the License. + +set ZOOCFGDIR=%~dp0%..\conf +set ZOO_LOG_DIR=%~dp0%.. +set ZOO_LOG4J_PROP=INFO,CONSOLE + +REM for sanity sake assume Java 1.6 +REM see: http://java.sun.com/javase/6/docs/technotes/tools/windows/java.html + +REM add the zoocfg dir to classpath +set CLASSPATH=%ZOOCFGDIR% + +REM make it work in the release +SET CLASSPATH=%~dp0..\*;%~dp0..\lib\*;%CLASSPATH% + +REM make it work for developers +SET CLASSPATH=%~dp0..\build\classes;%~dp0..\build\lib\*;%CLASSPATH% + +set ZOOCFG=%ZOOCFGDIR%\zoo.cfg + +@REM setup java environment variables + +if not defined JAVA_HOME ( + echo Error: JAVA_HOME is not set. + goto :eof +) + +set JAVA_HOME=%JAVA_HOME:"=% + +if not exist "%JAVA_HOME%"\bin\java.exe ( + echo Error: JAVA_HOME is incorrectly set. + goto :eof +) + +REM strip off trailing \ from JAVA_HOME or java does not start +if "%JAVA_HOME:~-1%" EQU "\" set "JAVA_HOME=%JAVA_HOME:~0,-1%" + +set JAVA="%JAVA_HOME%"\bin\java diff --git a/bin/zkEnv.sh b/bin/zkEnv.sh new file mode 100644 index 0000000..43cbc22 --- /dev/null +++ b/bin/zkEnv.sh @@ -0,0 +1,115 @@ +#!/usr/bin/env bash + +# Licensed to the Apache Software Foundation (ASF) under one or more +# contributor license agreements. See the NOTICE file distributed with +# this work for additional information regarding copyright ownership. +# The ASF licenses this file to You under the Apache License, Version 2.0 +# (the "License"); you may not use this file except in compliance with +# the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +# This script should be sourced into other zookeeper +# scripts to setup the env variables + +# We use ZOOCFGDIR if defined, +# otherwise we use /etc/zookeeper +# or the conf directory that is +# a sibling of this script's directory + +ZOOBINDIR="${ZOOBINDIR:-/usr/bin}" +ZOOKEEPER_PREFIX="${ZOOBINDIR}/.." + +if [ "x$ZOOCFGDIR" = "x" ] +then + if [ -e "${ZOOKEEPER_PREFIX}/conf" ]; then + ZOOCFGDIR="$ZOOBINDIR/../conf" + else + ZOOCFGDIR="$ZOOBINDIR/../etc/zookeeper" + fi +fi + +if [ -f "${ZOOCFGDIR}/zookeeper-env.sh" ]; then + . "${ZOOCFGDIR}/zookeeper-env.sh" +fi + +if [ "x$ZOOCFG" = "x" ] +then + ZOOCFG="zoo.cfg" +fi + +ZOOCFG="$ZOOCFGDIR/$ZOOCFG" + +if [ -f "$ZOOCFGDIR/java.env" ] +then + . "$ZOOCFGDIR/java.env" +fi + +if [ "x${ZOO_LOG_DIR}" = "x" ] +then + ZOO_LOG_DIR="." +fi + +if [ "x${ZOO_LOG4J_PROP}" = "x" ] +then + ZOO_LOG4J_PROP="INFO,CONSOLE" +fi + +if [ "$JAVA_HOME" != "" ]; then + JAVA="$JAVA_HOME/bin/java" +else + JAVA=java +fi + +#add the zoocfg dir to classpath +CLASSPATH="$ZOOCFGDIR:$CLASSPATH" + +for i in "$ZOOBINDIR"/../src/java/lib/*.jar +do + CLASSPATH="$i:$CLASSPATH" +done + +#make it work in the binary package +#(use array for LIBPATH to account for spaces within wildcard expansion) +if [ -e "${ZOOKEEPER_PREFIX}"/share/zookeeper/zookeeper-*.jar ]; then + LIBPATH=("${ZOOKEEPER_PREFIX}"/share/zookeeper/*.jar) +else + #release tarball format + for i in "$ZOOBINDIR"/../zookeeper-*.jar + do + CLASSPATH="$i:$CLASSPATH" + done + LIBPATH=("${ZOOBINDIR}"/../lib/*.jar) +fi + +for i in "${LIBPATH[@]}" +do + CLASSPATH="$i:$CLASSPATH" +done + +#make it work for developers +for d in "$ZOOBINDIR"/../build/lib/*.jar +do + CLASSPATH="$d:$CLASSPATH" +done + +#make it work for developers +CLASSPATH="$ZOOBINDIR/../build/classes:$CLASSPATH" + +case "`uname`" in + CYGWIN*) cygwin=true ;; + *) cygwin=false ;; +esac + +if $cygwin +then + CLASSPATH=`cygpath -wp "$CLASSPATH"` +fi + +#echo "CLASSPATH=$CLASSPATH" \ No newline at end of file diff --git a/bin/zkServer.cmd b/bin/zkServer.cmd new file mode 100644 index 0000000..6b4cf02 --- /dev/null +++ b/bin/zkServer.cmd @@ -0,0 +1,24 @@ +@echo off +REM Licensed to the Apache Software Foundation (ASF) under one or more +REM contributor license agreements. See the NOTICE file distributed with +REM this work for additional information regarding copyright ownership. +REM The ASF licenses this file to You under the Apache License, Version 2.0 +REM (the "License"); you may not use this file except in compliance with +REM the License. You may obtain a copy of the License at +REM +REM http://www.apache.org/licenses/LICENSE-2.0 +REM +REM Unless required by applicable law or agreed to in writing, software +REM distributed under the License is distributed on an "AS IS" BASIS, +REM WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +REM See the License for the specific language governing permissions and +REM limitations under the License. + +setlocal +call "%~dp0zkEnv.cmd" + +set ZOOMAIN=org.apache.zookeeper.server.quorum.QuorumPeerMain +echo on +call %JAVA% "-Dzookeeper.log.dir=%ZOO_LOG_DIR%" "-Dzookeeper.root.logger=%ZOO_LOG4J_PROP%" -cp "%CLASSPATH%" %ZOOMAIN% "%ZOOCFG%" %* + +endlocal diff --git a/bin/zkServer.sh b/bin/zkServer.sh new file mode 100644 index 0000000..51dbe9f --- /dev/null +++ b/bin/zkServer.sh @@ -0,0 +1,225 @@ +#!/usr/bin/env bash + +# Licensed to the Apache Software Foundation (ASF) under one or more +# contributor license agreements. See the NOTICE file distributed with +# this work for additional information regarding copyright ownership. +# The ASF licenses this file to You under the Apache License, Version 2.0 +# (the "License"); you may not use this file except in compliance with +# the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +# +# If this scripted is run out of /usr/bin or some other system bin directory +# it should be linked to and not copied. Things like java jar files are found +# relative to the canonical path of this script. +# + + + +# use POSTIX interface, symlink is followed automatically +ZOOBIN="${BASH_SOURCE-$0}" +ZOOBIN="$(dirname "${ZOOBIN}")" +ZOOBINDIR="$(cd "${ZOOBIN}"; pwd)" + +if [ -e "$ZOOBIN/../libexec/zkEnv.sh" ]; then + . "$ZOOBINDIR/../libexec/zkEnv.sh" +else + . "$ZOOBINDIR/zkEnv.sh" +fi + +# See the following page for extensive details on setting +# up the JVM to accept JMX remote management: +# http://java.sun.com/javase/6/docs/technotes/guides/management/agent.html +# by default we allow local JMX connections +if [ "x$JMXLOCALONLY" = "x" ] +then + JMXLOCALONLY=false +fi + +if [ "x$JMXDISABLE" = "x" ] || [ "$JMXDISABLE" = 'false' ] +then + echo "ZooKeeper JMX enabled by default" >&2 + if [ "x$JMXPORT" = "x" ] + then + # for some reason these two options are necessary on jdk6 on Ubuntu + # accord to the docs they are not necessary, but otw jconsole cannot + # do a local attach + ZOOMAIN="-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.local.only=$JMXLOCALONLY org.apache.zookeeper.server.quorum.QuorumPeerMain" + else + if [ "x$JMXAUTH" = "x" ] + then + JMXAUTH=false + fi + if [ "x$JMXSSL" = "x" ] + then + JMXSSL=false + fi + if [ "x$JMXLOG4J" = "x" ] + then + JMXLOG4J=true + fi + echo "ZooKeeper remote JMX Port set to $JMXPORT" >&2 + echo "ZooKeeper remote JMX authenticate set to $JMXAUTH" >&2 + echo "ZooKeeper remote JMX ssl set to $JMXSSL" >&2 + echo "ZooKeeper remote JMX log4j set to $JMXLOG4J" >&2 + ZOOMAIN="-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=$JMXPORT -Dcom.sun.management.jmxremote.authenticate=$JMXAUTH -Dcom.sun.management.jmxremote.ssl=$JMXSSL -Dzookeeper.jmx.log4j.disable=$JMXLOG4J org.apache.zookeeper.server.quorum.QuorumPeerMain" + fi +else + echo "JMX disabled by user request" >&2 + ZOOMAIN="org.apache.zookeeper.server.quorum.QuorumPeerMain" +fi + +if [ "x$SERVER_JVMFLAGS" != "x" ] +then + JVMFLAGS="$SERVER_JVMFLAGS $JVMFLAGS" +fi + +if [ "x$2" != "x" ] +then + ZOOCFG="$ZOOCFGDIR/$2" +fi + +# if we give a more complicated path to the config, don't screw around in $ZOOCFGDIR +if [ "x$(dirname "$ZOOCFG")" != "x$ZOOCFGDIR" ] +then + ZOOCFG="$2" +fi + +if $cygwin +then + ZOOCFG=`cygpath -wp "$ZOOCFG"` + # cygwin has a "kill" in the shell itself, gets confused + KILL=/bin/kill +else + KILL=kill +fi + +echo "Using config: $ZOOCFG" >&2 + +case "$OSTYPE" in +*solaris*) + GREP=/usr/xpg4/bin/grep + ;; +*) + GREP=grep + ;; +esac +if [ -z "$ZOOPIDFILE" ]; then + ZOO_DATADIR="$($GREP "^[[:space:]]*dataDir" "$ZOOCFG" | sed -e 's/.*=//')" + if [ ! -d "$ZOO_DATADIR" ]; then + mkdir -p "$ZOO_DATADIR" + fi + ZOOPIDFILE="$ZOO_DATADIR/zookeeper_server.pid" +else + # ensure it exists, otw stop will fail + mkdir -p "$(dirname "$ZOOPIDFILE")" +fi + +if [ ! -w "$ZOO_LOG_DIR" ] ; then +mkdir -p "$ZOO_LOG_DIR" +fi + +_ZOO_DAEMON_OUT="$ZOO_LOG_DIR/zookeeper.out" + +case $1 in +start) + echo -n "Starting zookeeper ... " + if [ -f "$ZOOPIDFILE" ]; then + if kill -0 `cat "$ZOOPIDFILE"` > /dev/null 2>&1; then + echo $command already running as process `cat "$ZOOPIDFILE"`. + exit 0 + fi + fi + nohup "$JAVA" "-Dzookeeper.log.dir=${ZOO_LOG_DIR}" "-Dzookeeper.root.logger=${ZOO_LOG4J_PROP}" \ + -cp "$CLASSPATH" $JVMFLAGS $ZOOMAIN "$ZOOCFG" > "$_ZOO_DAEMON_OUT" 2>&1 < /dev/null & + if [ $? -eq 0 ] + then + case "$OSTYPE" in + *solaris*) + /bin/echo "${!}\\c" > "$ZOOPIDFILE" + ;; + *) + /bin/echo -n $! > "$ZOOPIDFILE" + ;; + esac + if [ $? -eq 0 ]; + then + sleep 1 + echo STARTED + else + echo FAILED TO WRITE PID + exit 1 + fi + else + echo SERVER DID NOT START + exit 1 + fi + ;; +start-foreground) + ZOO_CMD=(exec "$JAVA") + if [ "${ZOO_NOEXEC}" != "" ]; then + ZOO_CMD=("$JAVA") + fi + "${ZOO_CMD[@]}" "-Dzookeeper.log.dir=${ZOO_LOG_DIR}" "-Dzookeeper.root.logger=${ZOO_LOG4J_PROP}" \ + -cp "$CLASSPATH" $JVMFLAGS $ZOOMAIN "$ZOOCFG" + ;; +print-cmd) + echo "\"$JAVA\" -Dzookeeper.log.dir=\"${ZOO_LOG_DIR}\" -Dzookeeper.root.logger=\"${ZOO_LOG4J_PROP}\" -cp \"$CLASSPATH\" $JVMFLAGS $ZOOMAIN \"$ZOOCFG\" > \"$_ZOO_DAEMON_OUT\" 2>&1 < /dev/null" + ;; +stop) + echo -n "Stopping zookeeper ... " + if [ ! -f "$ZOOPIDFILE" ] + then + echo "no zookeeper to stop (could not find file $ZOOPIDFILE)" + else + $KILL -9 $(cat "$ZOOPIDFILE") + rm "$ZOOPIDFILE" + echo STOPPED + fi + exit 0 + ;; +upgrade) + shift + echo "upgrading the servers to 3.*" + "$JAVA" "-Dzookeeper.log.dir=${ZOO_LOG_DIR}" "-Dzookeeper.root.logger=${ZOO_LOG4J_PROP}" \ + -cp "$CLASSPATH" $JVMFLAGS org.apache.zookeeper.server.upgrade.UpgradeMain ${@} + echo "Upgrading ... " + ;; +restart) + shift + "$0" stop ${@} + sleep 3 + "$0" start ${@} + ;; +status) + # -q is necessary on some versions of linux where nc returns too quickly, and no stat result is output + clientPortAddress=`$GREP "^[[:space:]]*clientPortAddress[^[:alpha:]]" "$ZOOCFG" | sed -e 's/.*=//'` + if ! [ $clientPortAddress ] + then + clientPortAddress="localhost" + fi + clientPort=`$GREP "^[[:space:]]*clientPort[^[:alpha:]]" "$ZOOCFG" | sed -e 's/.*=//'` + STAT=`"$JAVA" "-Dzookeeper.log.dir=${ZOO_LOG_DIR}" "-Dzookeeper.root.logger=${ZOO_LOG4J_PROP}" \ + -cp "$CLASSPATH" $JVMFLAGS org.apache.zookeeper.client.FourLetterWordMain \ + $clientPortAddress $clientPort srvr 2> /dev/null \ + | $GREP Mode` + if [ "x$STAT" = "x" ] + then + echo "Error contacting service. It is probably not running." + exit 1 + else + echo $STAT + exit 0 + fi + ;; +*) + echo "Usage: $0 {start|start-foreground|stop|restart|status|upgrade|print-cmd}" >&2 + +esac diff --git a/bin/zkTxnLogToolkit.cmd b/bin/zkTxnLogToolkit.cmd new file mode 100644 index 0000000..362dc44 --- /dev/null +++ b/bin/zkTxnLogToolkit.cmd @@ -0,0 +1,24 @@ +@echo off +REM Licensed to the Apache Software Foundation (ASF) under one or more +REM contributor license agreements. See the NOTICE file distributed with +REM this work for additional information regarding copyright ownership. +REM The ASF licenses this file to You under the Apache License, Version 2.0 +REM (the "License"); you may not use this file except in compliance with +REM the License. You may obtain a copy of the License at +REM +REM http://www.apache.org/licenses/LICENSE-2.0 +REM +REM Unless required by applicable law or agreed to in writing, software +REM distributed under the License is distributed on an "AS IS" BASIS, +REM WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +REM See the License for the specific language governing permissions and +REM limitations under the License. + +setlocal +call "%~dp0zkEnv.cmd" + +set ZOOMAIN=org.apache.zookeeper.server.persistence.TxnLogToolkit +call %JAVA% -cp "%CLASSPATH%" %ZOOMAIN% %* + +endlocal + diff --git a/bin/zkTxnLogToolkit.sh b/bin/zkTxnLogToolkit.sh new file mode 100644 index 0000000..8beed20 --- /dev/null +++ b/bin/zkTxnLogToolkit.sh @@ -0,0 +1,38 @@ +#!/usr/bin/env bash + +# Licensed to the Apache Software Foundation (ASF) under one or more +# contributor license agreements. See the NOTICE file distributed with +# this work for additional information regarding copyright ownership. +# The ASF licenses this file to You under the Apache License, Version 2.0 +# (the "License"); you may not use this file except in compliance with +# the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +# +# If this scripted is run out of /usr/bin or some other system bin directory +# it should be linked to and not copied. Things like java jar files are found +# relative to the canonical path of this script. +# + +# use POSIX interface, symlink is followed automatically +ZOOBIN="${BASH_SOURCE-$0}" +ZOOBIN="$(dirname "${ZOOBIN}")" +ZOOBINDIR="$(cd "${ZOOBIN}"; pwd)" + +if [ -e "$ZOOBIN/../libexec/zkEnv.sh" ]; then + . "$ZOOBINDIR"/../libexec/zkEnv.sh +else + . "$ZOOBINDIR"/zkEnv.sh +fi + +"$JAVA" -cp "$CLASSPATH" $JVMFLAGS \ + org.apache.zookeeper.server.persistence.TxnLogToolkit "$@" + + diff --git a/build.xml b/build.xml new file mode 100644 index 0000000..8017e2e --- /dev/null +++ b/build.xml @@ -0,0 +1,1993 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ') +} + + +function SwitchMenu(obj, thePath) +{ +var open = 'url("'+thePath + 'images/chapter_open.gif")'; +var close = 'url("'+thePath + 'images/chapter.gif")'; + if(document.getElementById) { + var el = document.getElementById(obj); + var title = document.getElementById(obj+'Title'); + + if(el.style.display != "block"){ + title.style.backgroundImage = open; + el.style.display = "block"; + }else{ + title.style.backgroundImage = close; + el.style.display = "none"; + } + }// end - if(document.getElementById) +}//end - function SwitchMenu(obj) diff --git a/docs/skin/images/README.txt b/docs/skin/images/README.txt new file mode 100644 index 0000000..e0932f4 --- /dev/null +++ b/docs/skin/images/README.txt @@ -0,0 +1 @@ +The images in this directory are used if the current skin lacks them. diff --git a/docs/skin/images/add.jpg b/docs/skin/images/add.jpg new file mode 100644 index 0000000000000000000000000000000000000000..06831eeb3ddf196c72e23557e0ed23ab5eebef14 GIT binary patch literal 1142 zcmex=8LQWSUGXZw=a9;-CH1opy?hi@Re9OjXnTmIP&sRNi|KfA6jNG!RuT!@9YtHw( z9erp2Zq<%rjVqhBF6#`j(Nz7-sP^lFKTm1Gh0D`qPDac0FaMRdT;F`zq?kW-W@pz% ze5s1wt~F!ht0dJ-6Wtq2zbVbV=fB~?vunDX+mkr&9obTxINM8acHwgGD`nz_>c8~X z#64k4<|uMwTb-nlGND71x8e8h0CS_Z??Mj^qF+we3cIj#)xArPJbFc z1J^&EzSnzGz5a8z`w3oY3k27{($?ztW&09(=ivnpp{KI7WqXY09TH4GKIhxFx{~WE za;gV-Un(Aaa&M}6?~U3j!7KUi>iU;l*gowzla$PHmbcrJ<^Kv-hZ^4yNZ?w%@WRrg z9hKMiif_BPt>>(?=HJZAb?S+a3uMc;RsFTId)L4BO>y9_%h9vu@!Dqx|QqvyOz9SIJ(F^=e;T^m(oCzw|lXRk=EsYqq%^ zT`d)L>*v{G>#v@6=iH9&5}xL?Y5R3H&Bwh9=Y-v2RZ~9aIrWlLlqS2Jh$?@c!KtzFq_@~|twFFteiZSS44jqO(VSv>5s zSk$Z3r4sR|%QU3V;-b@%!bJ@$Iu>ZHYFM=ZnC>fE$}45(-kf`P=H0v9*1LrwXLhOr z(Tqu+Dw97yVxO<^>3%?xVY_#66#K#toTr`}oRP~sdOKTC=ER@XAKDdr{M$Kf7M%Ki l%F17_Xw@h6ZS#V!{>|Nxc>kE literal 0 HcmV?d00001 diff --git a/docs/skin/images/apache-thanks.png b/docs/skin/images/apache-thanks.png new file mode 100644 index 0000000000000000000000000000000000000000..c0bea09cc8bcb9783fa3a67cb35db96f761002c3 GIT binary patch literal 4840 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 literal 0 HcmV?d00001 diff --git a/docs/skin/images/built-with-forrest-button.png b/docs/skin/images/built-with-forrest-button.png new file mode 100644 index 0000000000000000000000000000000000000000..4a787abe4dc7831124c5a3105d328309d671654e GIT binary patch literal 1936 zcmeAS@N?(olHy`uVBq!ia0vp^5kM@@!3-or#C}}@QVJ!m5hWp+B{``KPNkVSB?{%4 zB^e5i1&PTSsS0lSMMbH_C5p!XSU`qIg48;emSp4?F%*}imZj$9IV6Hr>g5-upPn-{ z7N|%Aq{unHpt2}4J)?vn1ZWJ@wBY=-lJdkNkg=tCDTyVS`FXqD1Vn&(#K3xrQo&*h zA(^?U42FjK2B!K3Mr$wBh5%Ktmw5WRvR~q672y_j(|Vu{6yhxKh%9Dc;Q9c)(aAfd*^e>N}8ml8GDLnbh$Vh8yg>#P$;PF zC>QelbcQQ9twO^-_C801qj=2GblKSS!fj&e!5;2=cvDr4f*v|q3raa`n#2k(0Hfotk0b1J=Zc zVix-wb&f*FNxFAB>YkC+NOHE=$eo>CQlF6FW+Y*C$UweP(%~&@q>7f$#X#{A z;Q~QbwWpj0XSnm#bgimu&2m(IKJ4T((08AzspZ9!kdUPob@ zhUPNf9CfQG1}XglS^Z_=`jsLf7uek{k1Lkt=SCSE_Dw?nen%L4B7i^>@v~C&d=nR^FdJVP^0Cp33}tc?Gq$O(FfPpv_~AIPICFic;5W(Z>PHY@&p}`TbikKkV444Jk93Se-mtf*V{`vIwng zXu9Mqxh&@_YxVKtE1Q|E&EFj=C=gTZUe?$exv?(b$cHuUKkhedO?dx=U+Qq@<*v^rKUcg+uGXdSD-c1$LjDs$D3&%&n#_h{2#BhC!i@(`b;D9TORRq zdb5xI_xrb_^#0kXwa*@ycsr?PYU?avxGJe9GyUl7*!OiS zyFPrgF>;P=eC379dw#zycy~ibF5adl<@V%<|Ac&Q-%p5$abw8I1(|q!`K$Bs-$Ufi zn-NYN)w4{zw?yhbQXIC#@eD+l6OwziP6C9qB=6m^)Bp&s4|Xb_eY#M_>}{ahob-+F#617?*~$q0=_@T*^V)U2LV1m;&(&(TU%TRD_D(n) zkt5*A;KlgCw)x%rA4f%Q=dtWM=lnF0i|2Y{YvH!Kii;L@-PURI*lQP0-t8T_&{^nm zamG&RnUcY0o~~6qWBy(4eNK5~Ox(I2w%NP3-IJSYEYXC!` B3(^1p literal 0 HcmV?d00001 diff --git a/docs/skin/images/chapter_open.gif b/docs/skin/images/chapter_open.gif new file mode 100644 index 0000000000000000000000000000000000000000..eecce18b50a0146d663334eb5b38691fa40b4d5a GIT binary patch literal 49 zcmZ?wbhEHbWM^PuXkcJiy6xEi|Nj+#vM@3*Ff!;c00Bsbfr+Dqzfm%aH&TPa8UR61 B3ljhU literal 0 HcmV?d00001 diff --git a/docs/skin/images/current.gif b/docs/skin/images/current.gif new file mode 100644 index 0000000000000000000000000000000000000000..fd82c082012faa682ecd4e68d2eedef9ae2e6231 GIT binary patch literal 54 zcmZ?wbhEHbdvgf9JlRm%f*ED|^)zR->+Co862^^pk!u5$EP!3fjzw8XU#}8Il-2 zEI`Z*Zh{lXkg>50Py~%EL5*|HpdHu^uz_@DjRE$?+OB>2cHigy_~CiltzA2q(dY-R zE0ws?)uol-wpiR0>Zwh8gwrE{IE4kjFcsa zE<)u6=*0rOQdlXmQsSg~b2v>_e&*;)omVU%Jn>|M%;yddYu#v-EI}s0b+HN;3oue* zQpwmBX(`VSO8MC}-CeIu#fheb@BCT0%4VJ)QmWBvMb)yUR4#8pr71Q^aZ=)y#HSK3 zi^EBYPE(AO)UWyiAN=;Wkbp|%%%IeP9kb@tPsPeiHEF9Vw+tJ-#7Rk}u8!&z%Kp{@mlFk3&u$Ct;y9Gvwjj5D*FIBO$!^50-oB?3Lr$5Eqo7T}kG=xr4bXpv< z*R5s2hBg2OdwSTmay3J5pCob)Pe6dk!R?o=fVuO#q_s7>Q>ALh8Y@Tzqa&PbKSJ$w z&E#upxTXuR!K0ET*c*tT*NLtS0W6A@QMF#>Raf`zl9=%LrG z(NhYzXXUD;0X283s6e9Dd0|~m^4KvDJaG4riJ9HtH#%5 zaygn>T9_F{)I}5FE|f$7HUxB-XnqrXz$VE+aIOd*cRo4pZbnIJuD_l|_iaJMF{b2v z6}7djx&K}&m8Sc#-9!PrU_5gRxDe1l5`6!(6;Mgig`AkVPSWw?R@KtNqOJE6WwThV z+4@nHho0%-^oygxpzfTX|wxJzZvc-fOu>C=>| zWlLH7!>vTQ9Nsy0-SQ1y|IGoCW5@W#+E(;vf`}qM|Il_CZf<3SfDQp$f?ERp-nl;S z+NTw;=$B7>lP1rNXI_F=E^cP=_6LZ{%5c{5*sUA+`*Xi$P8>5giWz;mgJ)WAMvsmX z#WAaY@?#plw2I^+xCzkb{lQLarr!d9k z_v$o7%i?F%JCApceRpoAeb3$ra3{b8hy|QJc!>RN8!%Ghyr<7QhJ!~2&s)|WI_2C8 zlX+9#2cBNKd`5+_uVl4q)Ka1AW^ksWoPTt7QWr&B9mSL(CUm+3ObDbQ5M6r>eco}V zyPH{2Ou_rXE^AhFTHXDg1OV)8Y+6!n%%QwCGo>*Mc!vy7E+AWiy9vi^%ya@W1crjg z0tN47w>4ipX7%r<;#~Gh_Wc?4%W8Z$P%Xp)AHtZQ<1PX^iU#9K^J87Fg6E{OgWcAy ze`OjtOmQE$IQ}S;cbYPp{R$ccVo@xF@LXyzMb|4n8(_dYPB{Cg6VBe)X-&uF81MO7 zeoIC54K*UVy+Vi^D}^YFgdmi%H3SkLIPab7_5R>lZ+EWYIZTJA00000NkvXXu0mjf DMgv2X literal 0 HcmV?d00001 diff --git a/docs/skin/images/external-link.gif b/docs/skin/images/external-link.gif new file mode 100644 index 0000000000000000000000000000000000000000..ff2f7b2a0edcd149b45744fdcb0868e37143710c GIT binary patch literal 71 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 P00000NkvXXu0mjfVyU~g literal 0 HcmV?d00001 diff --git a/docs/skin/images/hack.jpg b/docs/skin/images/hack.jpg new file mode 100644 index 0000000000000000000000000000000000000000..f38d50fe4e87cb4ede05ce4b6f124460b77f2a0f GIT binary patch literal 743 zcmex=i3*BJ!6k`h{6D}T z$iX1OAi~Tj$iO7X$SlbC{|JKw10w@7BLfm(XJ%pJ0LrKcFfc&?GgOv|nURH6kWENf zkwJ-FL|MfMs7f5@Q$`g1tjr8-KnXQL1_q#~fqGzOGcpM(GO!prCNi@M1qv57PW)i> z{}uxePyv%5vmk>#!z=Hw)gfzchs_dwb)6~u-lc{J9p#OZ6SG*{l#7i&yEVyNe`52m z?8<(|$z{?4i%i3(tlGKv6RT2AO_XoH_ze@T4q^E^|1Do4E?duNoY48XDn;^jy+5zl z+XU5E*B@I8^sa2*)?&wgVr`M0ezaz8!s?*grt`V(_w>!37OKV~GNofv@IAJ)s`t@z z^FlA$8!_%?Z7SXJL&p2U66xZ5uJx0j=v`Qu{B@(m?4Vh@_!qo9xtn^QNZp*i{dALZZD-PQj)&8J`hMPbAhvS`-8>JA6F4^r=zKIWe^-BH${BtgXXyz|z4k0IlcQSn1w>fm t4@cY%T^+SFHFVX2^CbaS}9ZZyUVQ>#nGL-7*pWflJ-z4MzO#pq+?lJ%X literal 0 HcmV?d00001 diff --git a/docs/skin/images/header_white_line.gif b/docs/skin/images/header_white_line.gif new file mode 100644 index 0000000000000000000000000000000000000000..369cae8dcf2da7d30c4ed7a8781b6bdf95a022d6 GIT binary patch literal 37 pcmZ?wbh9u|6k%XwXkcLY|NsA?3y*XdfB+=Iz{JwhKa-Wg8UV|E3E%(# literal 0 HcmV?d00001 diff --git a/docs/skin/images/info.png b/docs/skin/images/info.png new file mode 100644 index 0000000000000000000000000000000000000000..2e53447e8c2446ea0f6a56fec811e1786e691d49 GIT binary patch literal 1320 zcmWlXZ&1?)7>7&1q8${icL>E5?6e0xt=eJLszo9c2$*4!0MS*JoAHQRSf*8T8ZdHE zdRib#rv*B$t7TU0vk_F6krFk# z{0M25qh^EI4M??m+775mn6kUQeL~QvCalpgYqHn@xlXRFsY7J;T8#q3zT}0 zu;LUag($-0k|C^~pi$aJ+k6t3L20L!v>^lo$Y9Rx2UH}^x-^6ZHrfE0PN-#QtCz1f z$hAb9uTRgoFxDjmDTUq~4U%GrF>-CTwtj@536oo*Mj+BAL(FDpH_5djlwFBglzL7_ zImJ4Y0yT+YMx>=BIuoEW@TH&(ra*%YrCmY|X|i|o6{wD~Tikw$3IUXOG{hP$UI}P` zNV`bOptuoZ-C~#(g27uJi_6d2y8*c#P~aNE3LEVTJtu+~HExxooWbm&tX?T%mZ4_8 znv4$qX=ww*Y5_<~btZ&z;;h@(_dw6OL7bDotl8-=iC<6|G$~}44$kAP9Ua1hVMbYI z(YHL_C!&vp+epy%d z_3j;s5joeyGfxrfn#PmK8C#pN@SD3&FD!}K(X#nWD%6oXH({C}Y6y*4m3X)(buAR@ z4_u-yOwl?l(jk_j&-{tbZdh$!_x1T+6Jg2bX;OMh!&bv=a;{VYmguFkd>YejL z(yTq&UT55&C3U5Wc1=z%)jo#Yy zen~|sWUbU>aWPdDk^bhLbiZ$$`@YGsl+Uv~3ilO$Jt!N&UyaY^nfEtyNxtf*>aZ0P zYs$CH`_7_B`7<&$#o^RQSmo zVQlJ$#Y0d3y_u4%5I*UAefd&)*3;{b6J4v+)5D0SPOme`?20|p-rCw|0gnzQ=TAF# z^l^V6aX8}eo%wKHvLh@tv_@JJd7i&)WJBOUUKy47jkq_-)i|*w;aVUrH|R!ZNY~pb U&-nRQwxE@~taLcd4Hh&10}nn9o^tnS&|T3i>qxFe$? f}PJadT6$68(tDnm{r-UW|L@jfU literal 0 HcmV?d00001 diff --git a/docs/skin/images/label.gif b/docs/skin/images/label.gif new file mode 100644 index 0000000000000000000000000000000000000000..c83a3893c5526efb52f2edab685a1b0d7a1ecc74 GIT binary patch literal 54 zcmZ?wbhEHbdhCYGe8D3oWGWGIAWq$;?3`UWs4{$yd~ fVqj#@VE_V<76vBXp8m=M4RQ+_jm%nu85yhr=NMS;ykzBV zGV@+Ib>8iG+0i+5o5%e;$DOmCbGDtGouBno)Pp@O`xkod^YDHAe&7q={KCBSjEXQs zia-R}v;dr7tR!PTU@gZjorczO*Y4(!3udEUXj^5nt6CcbI=M{9lA3*v!R*V{5Xk12*s*W`tyJQzcOyP zZ|4nGYCwl+^~R>oQ9yIziSOk@uI9c7MHdfo+O=dPhNjo`t2TAlmN1bw7PY!& zb8wiMUN#=~j?AJaqD?aaD8@$vs`?(gvBH&H+cp7{2^cJn$wdq^+uv$+z|MKKt+?hr z*QsL5i(y(cUzD}JiFa$qb^-fga2lYfPWKeWPkU;dXzH zDz+;0UGiO>WV7RjIU=PTtqnMrXIV?F-0jLxCcN%Rd*oPrek$=zU&fPf)RHo>wLjZ` v{OiZh;9_~M^1Bpx^As`Ho2BPVXIo0*@-_bK23aA9FY1)%eyY46N3#9^6k+17 literal 0 HcmV?d00001 diff --git a/docs/skin/images/poddoc.png b/docs/skin/images/poddoc.png new file mode 100644 index 0000000000000000000000000000000000000000..a393df7372349f6df300eacf8d62987dba6f85aa GIT binary patch literal 856 zcmV-e1E>6nP)004R> z004l5008;`004mK004C`008P>0026e000+ooVrmw00004XF*Lt006syVXTxM00006 zVoOIv0RI600RN!9r;`8x010qNS#tmY4#WTe4#WYKD-Ig~00O*8L_t(|+QpVTNE|^J z$A2fM1T`LdK8|#PiddK?TFD{e3)I2~C^izoQX5IcN=2)r5d^`Af`y%hg(!sB1jJZ~ zhhQQ2xbuN2jD|xCJ-y4!uDkAD*4y(U^S#%Bffg1Pd~Ubu+KBq}=IwO^pm2rcF!(l?9kaD>;J^+QI_c}?CwAUL!v{63b zMSwIAqZURm`P~-C@AoSl%Ul|ean#u3@mK?mz^4>(UJ5^_rrx+pOJh1dEH4pbk^qc| zxl{Vd?dDxqS8R>E@IiO~%8JU*q-C#{P-mxZ#<)zE2x%c6UoZ>}L4H2$?ZMa>l$5Az zCnqp40PXEiQ={%(Ux)d5xVqAT?1CXlpEWmw&j&3nP+JR&i!e6_d3i883OPBDoD7?r z(Ax`*jr!5wmzQj8Y$$vp9wq^w1`@Agd>pp7p{ECymW1(_Rc*9OkB?zu0%m5QzFt52 zIwONp5k!(jWwFu7;ZU_IFNgDUI6PF>PfsBw#e8aa7qYWWK9VNW%oiI-Qd5&^mWvCx zzE;=L)BgraO_f<|84UJ5lBVnKhSgPATT?+LwYI{+f%#Nf8EkDmS@Y~Q(i21YCNmR; zhoPb2F}ErzV0IP?3QYMH3+f~e}F{5Y&DV_64k;u-pUk+1@tdkX!Dz!8_URaM9J0C iRWA_nQh{&$5BdZ3oY`MtoEnh;0000axdUs$VmXNZB}bC%VxwSp6_waJ)d|kVIc)zPRqeIZZsP!%PWP&!rJ{ccrcVef_824V*rcNe`YK8X6u^&TVfiYDOC!)l_wikn`gg#xkmuz4&!! zCzsZ~Q+eXo?}^E*8nm^kOS`apx&1SHP xOSk{*ch5;mUqxD8)P4*PsMYcJGhc`tpL?Kv*ou)#zg(Cser$hB&OAcs)<55`ex3jT literal 0 HcmV?d00001 diff --git a/docs/skin/images/rc-b-l-15-1body-2menu-3menu.png b/docs/skin/images/rc-b-l-15-1body-2menu-3menu.png new file mode 100644 index 0000000000000000000000000000000000000000..cdb460a1da7304fcc2d5e326db43e27c6fa9b025 GIT binary patch literal 348 zcmeAS@N?(olHy`uVBq!ia0vp^{2|H(?D8gCb5n0T@z;^_M8K-LV zNdpBhc)B=-RNPAba`NT>^A2hWNr{PR3em>=;?_TBi7s_Hc|B+4`ZEU(9`l-)7A&jU zw*UXXiOVBh8rmIW1DhHR$*SJK%G8XnD!U=Fb1;@b0XlLnh)q2r=G4T4?@%xY8I4J~G88*bRV z@j)-^8Y2b$lol(aFVkF%GBiAm42+EveLZx3%wg?nJ=YY_W-h?yH literal 0 HcmV?d00001 diff --git a/docs/skin/images/rc-b-r-15-1body-2menu-3menu.png b/docs/skin/images/rc-b-r-15-1body-2menu-3menu.png new file mode 100644 index 0000000000000000000000000000000000000000..3eff254fd179852394e8bd960eb1f610f05f2d4f GIT binary patch literal 319 zcmeAS@N?(olHy`uVBq!ia0vp^{2|H(?D8gCb5n0T@z;^_M8K-LV zNdpBpd%8G=RNPAba`NT>^A2hWO5w`f+{Qm=?YwdG#C08QO_zCTW@ch+#j>hKxom73 zTjv>7&YHT!RZ_*3)#Lh^W2X*H5PRiN6|!;D27?YTi6X6M9-jv*7;6_w9) zZgF9{q@i@+@P#?TM-Ci3*X5yc#3IzEqkW;KHHXLNh0Bbb8ks*SpICXq?9mk-FNPk6 z6&k9CCJ5ymU$9Q0)4KMskfp|2uWoLm2qtCuDGUxDJvbN`4z&r&mdK II;Vst0FZQVxBvhE literal 0 HcmV?d00001 diff --git a/docs/skin/images/rc-b-r-5-1header-2tab-selected-3tab-selected.png b/docs/skin/images/rc-b-r-5-1header-2tab-selected-3tab-selected.png new file mode 100644 index 0000000000000000000000000000000000000000..b175f27b16e19464241853fd16c8030d649b6d4a GIT binary patch literal 200 zcmeAS@N?(olHy`uVBq!ia0vp^tRT$61|)m))t&+=g=CK)Uj~LMH3o);76yi2K%s^g z3=E|P3=FRl7#OT(FffQ0%-I!a1C(G(@^*J&_z!{$_AZ|c6yYrJh%9Dc;5!1sj8nDw zq=AAqo-U3d6}OVVoP7EJd;{Bz3#=?Zb_B4_oH;{c&DT)DCIv=EySz4*dTBPX4PtS6 mY}~b?ZBH1Y+4#!B*chy;Ss!r=G{ytXVeoYIb6Mw<&;$T7sy6BX literal 0 HcmV?d00001 diff --git a/docs/skin/images/rc-t-l-5-1header-2searchbox-3searchbox.png b/docs/skin/images/rc-t-l-5-1header-2searchbox-3searchbox.png new file mode 100644 index 0000000000000000000000000000000000000000..e9f4440d1f58d53fa16a2ea141bd04cb69f0a595 GIT binary patch literal 199 zcmeAS@N?(olHy`uVBq!ia0vp^tRT$61|)m))t&+=g=CK)Uj~LMH3o);76yi2K%s^g z3=E|P3=FRl7#OT(FffQ0%-I!a1C(G(@^*J&_z!{$_AZ|c6yYrJh%9Dc;5!1sj8nDw zq=ACgo-U3d6}OWA@U#7wu&b{+{^9NK^tSr?dgBcZEcf=*o%!(mygu6k9cB)L#t;SW l23E(Y39JX26pSx0GKAXcJpW&R>>bb;22WQ%mvv4FO#q7bJP`l@ literal 0 HcmV?d00001 diff --git a/docs/skin/images/rc-t-l-5-1header-2tab-selected-3tab-selected.png b/docs/skin/images/rc-t-l-5-1header-2tab-selected-3tab-selected.png new file mode 100644 index 0000000000000000000000000000000000000000..f1e015b36c399a2d3a5879d69c3f31a82ee9f7bc GIT binary patch literal 209 zcmeAS@N?(olHy`uVBq!ia0vp^tRT$61|)m))t&+=g=CK)Uj~LMH3o);76yi2K%s^g z3=E|P3=FRl7#OT(FffQ0%-I!a1C(G(@^*J&_z!{$_AZ|c6yYrJh%9Dc;5!1sj8nDw zq=AC2o-U3d6}OWA@Uz(0{Y#73_gCfc!(wyExc&dn9AFaCcpHE6!;`1hZT9v53>z4P wJ&s(UHx3vIVCg!0D03wUjP6A literal 0 HcmV?d00001 diff --git a/docs/skin/images/rc-t-l-5-1header-2tab-unselected-3tab-unselected.png b/docs/skin/images/rc-t-l-5-1header-2tab-unselected-3tab-unselected.png new file mode 100644 index 0000000000000000000000000000000000000000..e9f4440d1f58d53fa16a2ea141bd04cb69f0a595 GIT binary patch literal 199 zcmeAS@N?(olHy`uVBq!ia0vp^tRT$61|)m))t&+=g=CK)Uj~LMH3o);76yi2K%s^g z3=E|P3=FRl7#OT(FffQ0%-I!a1C(G(@^*J&_z!{$_AZ|c6yYrJh%9Dc;5!1sj8nDw zq=ACgo-U3d6}OWA@U#7wu&b{+{^9NK^tSr?dgBcZEcf=*o%!(mygu6k9cB)L#t;SW l23E(Y39JX26pSx0GKAXcJpW&R>>bb;22WQ%mvv4FO#q7bJP`l@ literal 0 HcmV?d00001 diff --git a/docs/skin/images/rc-t-r-15-1body-2menu-3menu.png b/docs/skin/images/rc-t-r-15-1body-2menu-3menu.png new file mode 100644 index 0000000000000000000000000000000000000000..29388b5efc9155a12ec75c7ea12940bf45d5b3fc GIT binary patch literal 390 zcmeAS@N?(olHy`uVBq!ia0vp^{2|H(?D8gCb5n0T@z;^_M8K-LV zNdpCcdAc};RNPAba`NT>^M?+dIdJscF$HbSBMB>)A4*uZ_=JL{)&U2O4GkUk_5X}& zetn+%@YUSqJlo~>r9|v_$Osmj3zsmE%8e hpTGaab)Hi`4ELR~XEsLn)B!_*!PC{xWt~$(69Dz9se1qb literal 0 HcmV?d00001 diff --git a/docs/skin/images/rc-t-r-5-1header-2searchbox-3searchbox.png b/docs/skin/images/rc-t-r-5-1header-2searchbox-3searchbox.png new file mode 100644 index 0000000000000000000000000000000000000000..944ed73333d834f3509955d65fecc604393bf626 GIT binary patch literal 214 zcmeAS@N?(olHy`uVBq!ia0vp^tRT$61|)m))t&+=g=CK)Uj~LMH3o);76yi2K%s^g z3=E|P3=FRl7#OT(FffQ0%-I!a1C(G(@^*J&_z!{$_AZ|c6yYrJh%9Dc;5!1sj8nDw zq=AB7o-U3d6}OUWem!|spO%)!#^)EuW@jhJ=H{lxrpBi5bP0l+XkK DqZdXo literal 0 HcmV?d00001 diff --git a/docs/skin/images/rc-t-r-5-1header-2tab-unselected-3tab-unselected.png b/docs/skin/images/rc-t-r-5-1header-2tab-unselected-3tab-unselected.png new file mode 100644 index 0000000000000000000000000000000000000000..944ed73333d834f3509955d65fecc604393bf626 GIT binary patch literal 214 zcmeAS@N?(olHy`uVBq!ia0vp^tRT$61|)m))t&+=g=CK)Uj~LMH3o);76yi2K%s^g z3=E|P3=FRl7#OT(FffQ0%-I!a1C(G(@^*J&_z!{$_AZ|c6yYrJh%9Dc;5!1sj8nDw zq=AB7o-U3d6}OUWem!|spO%)!#^)EuW@jhJ=H{lxrpBi5TL z>B-E7X2&P~a4`6jwh^=64%N$KvYWpfx`zxWxwdqUOnSC!Nz1SzY(ekLziD#x^ zN5c#+_UIeyY-pcs;P~|OA~k0Xi4!{~wTsAVnY=KnKKB0f`iUPuesXv@{Yci~8^Yz; ze$Gr6yrcD=n6CQspW#+>&)4KPoVTPS*P1y_xgl9G>4Qerv-iJzj6I!?I`hUW=Uv;# zHL>yT)$${4S$`XkoKG^9y{xuxQw?uJf!VPYKQ*7-)s9v(dui5j;p*Lw-?h_ZE}fNP znwi!fr^&uU)A`}8>{ko!=Ix#T_|WcYS)p$px382xAu?rN%}Uqp&Q)t>SDty!{&wjU zF$1}Yb2`GEzRw9aTyRJxLO(N-d%~h~3;r!CocN-C`qZPZEBp0d?V0X;_S@7qkG}EW zu$cJqO5oK~FE(#jvTvWQ_qU8sn~sKLX5RGeejKvAxN5rQtVLh$3bizMgenJ$X;1#o zkZV6ctbo!DryG5`U%cNA- z37SIO>Jn2uPEOf&tRRquW%=UskTnw*lL4j4_oQFx5`5PDln65ExUE?CQL56{W=O6>4%t1lHGeC6k3=o{392#=l uSM0X)>rLCYt$Mw3&7xT=7q(o#=zPoVy6suxF44RH-vj{rcK4+K literal 0 HcmV?d00001 diff --git a/docs/skin/images/rss.png b/docs/skin/images/rss.png new file mode 100644 index 0000000000000000000000000000000000000000..f0796ac886201eb43b7a15113e2deb1b32fa9a09 GIT binary patch literal 360 zcmV-u0hj)XP)1pTfh($;sL0vc}u{{{FPIw4gub**+Xunj;hMg-Rk@N{o&!^ z{r&#_{{B{et%#+@{r~@)vdh1}zle=^0GR*(m;g35HkdZcHkixXHq)$8FWQhbW?9;ba!ELWdKKV zVQ^?^V?%Flc4cyOWpXuLNbUdt06|GaK~#90Vz9#p80;8u1CXpOE?Whx%fLW2AK{k88_xIu00030{{sMfLr(Xb|5zme0000&bhz z5bnJPc@Iw>rR$Xk0NnAP0=%b=G`t?HCJ;1;sS0GUaR^Poy(d)4L1!Z`B|uSw*8!8D z1>h1*q8RGKdru$=?;A%ZB_OKlg75{_YH&hNW(a$3KZtet`*CCTW|RqnCt6&9fL-$C zDR`VAOJA7@%7*R5r%~t_!pzTQ{PyECD&+v42uz$ZeUl8ZOTM%Yg!+h+nIH~LchAyC zG1xhRv*%9Z$h&VKs1PWGgNRZBQXUX%?&{cdP2ocD!(ST!+#jwNkiW-tkatpx$iKuDWS zjlmkan~AW!xEI~IUYz>&BtH857{(?B(L3A$QGsv>7uHrX&|ttObr0cOZ8RGP9>iGh zW?Z>CgO?8P$BOj@EL+Aj1LI!1pvMp{xF|nlMi(MNrlpRA51c)0HD~J1>JbH7( z*fz2os)`p6?T2-jQQXvrT;4%gtC0&SgfvxylmLTh?0CT8?*3i4Z}>^vxCq=Vl_457 z8uA{>z{6wDAe+hI*zu$IVd@*KzOx_Q16hbz2<5t&szK8dNK^(d^O(B&9kQ7m9^1SR zf1R5}xjbKue%s33Sk|=)znq`Kn@3;8=%zjl6!U;Xl=3)o3uh}POm;hk;QLFTVS4T& zio@gBw(1E?U$};#5}??<0e3CmiTO$ylP^Du!bld&*B6kIP)Q#b9id!3)r>hIrOymP`xd*0hyA5F0Rtdmn&^ z(AIAF^ryEm`_E;F2oAh533QiH+|Y+yzAY7X^0y||7ta8M)C4T?H$3d~#Ec+Y!r@Q$ z;qn>6)bFP;zI6~?{q0bRQyfmEhD^j|AWeM?nw22KO4S2}k3K(J8&|GC zzL0}Mv$`ud-Gm^L?u5<0hT@~sizf;X5;RL-Q6**~3r$2Rwa|#lH|K-! zJXbqLQ6z+jtJ|p&kODTAfegZ0Su_KGoV_;b1KLAGIq$uZC+9sG5jkNsC3UKnRklpk za8aLUQc+eDGAE)?GAFDiY)(aeP~zi_yj$be_!rlyryjz7fr004R> z004l5008;`004mK004C`008P>0026e000+ooVrmw00004XF*Lt006O$eEU(800001 zb5ch_0Itp)=>Px#24YJ`L;(K){{a7>y{D4^000SaNLh0L01m_e01m_fl`9S#0007K zNklQ>j$aI!>~6BuS6Q;~j%&nubQBVJyz=J&@KuRzjD; zcW(vZmNxJrKpeyxg%ynaLZD)?XsFw9aUiSZ8VZG+fzrUYH*7w2ey^>)m&eCl6R*)C z%=R)sowX&(lcM0`^0IqGG2rt<`VS6F^(fg`42{LbhhyyM=(-V3aWNTYXHDf22mq(2 z!0IZnumH@>0oT`${)-DBowfmq$k1#2*6To_01OTSmzTiN5im0YjEwi0pxkefcYS?`FcOI) za+39RU|;~)-#0-7IU)dleBQ_~Gz2yi2!}nB!COS^Uf}Q$n3@725l=O*b0CUlauQfs zG1<4Y;LWU?LD?PHl9k7t-wA_?`Mj}fOG*Fq!Zx#ulu6&o$RJ{P>DS%_VhWrCUF3V*)!aYF% O0000`WXCjGV$EqLPXcGp+%Z zNis4pF{2v5&dkcj0+dn`WB}@CL6QbCSy&m^1clgvCWsmRzs0}<)XOBuEXZKbu&nmZ zUEkd+zBN|q$1Ixqrz7BO-I}$>PfA|TKK6C0m9FK+cPkQQjN+DUeXu4u@MF*FfGpz| z8`AsaC+fJb;VhfwY3f*Z%PzR)$hD1?A!ldYs+8Y+P^~-c^*$2O#Z#!G>X}ouT=R2Pc+d@(I!`-o_U*_tEEUB#I-?h1ST9V+k zI{VU>v(|fR-Q8VoVYScfxqV08!yC;RNj^=v(@svZJL)?1=<1$Hzg3pkD(!u`W^Jmq zq~WGkfvK;05)NDre`1gmxMs`dZA!UZ7oHRysABC~;c?pY)vx`JQzm!&aUF{m4Rhs5 zdK>CJP0VJAle6=@^)ogG9&Fz#nj>qy%3IC8JJ*rb?aa5nealbC$aFi_cy83=n6g=U z_lkGjUv!q|+;`>nIhuN9+BOx>^4qS5`wNVpC^$^b3Q2I~6Fng)S{-w=EHJ+_>pw&4 z>sqT;#+&Tg{b{Q$r0 zcjPwoN^N?+#M#1Z;pwWy3EJV(Ic&E?RC2Z^U(MN|Em16H;~rq;EcQAajAv$N9{om-s!5r##+I#Y}qkqPB1#0`7CuktZhxU=!4ohn_gbm zlDj{ppYNW{A@7V3(=UI13-HQKP`M&)Y;@vdl5X=hrHIwv9t##XtHe!Kcxhr7`+BO# gv;PeKu`GXNFaKw_))oI_o&UPMIeaoE+5c|>0A~eb6#xJL literal 0 HcmV?d00001 diff --git a/docs/skin/images/valid-html401.png b/docs/skin/images/valid-html401.png new file mode 100644 index 0000000000000000000000000000000000000000..3855210c6c3c85c56f90221b3247fa664374b6bf GIT binary patch literal 2948 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 IbxsLQ074N#oB#j- literal 0 HcmV?d00001 diff --git a/docs/skin/images/warning.png b/docs/skin/images/warning.png new file mode 100644 index 0000000000000000000000000000000000000000..b81b2ce8a12f88ec3a4c64a910809e667cc20480 GIT binary patch literal 1215 zcmV;w1VH7dsKvk!Vn>-EJ6yV zwCFYvz63#Z5fw@Zda#RSA<;vFP*!L?BpDNvInA8C*8kSS-e=CJT~KEP!3B%8_kLL4 z@Bgjuzu3U_ajgzJvSY3teW9oSl{HhZWS{V|#1F14p?K^260|%Xb}o4LqmAX@ssdp0 zUE9>h(~J_78VifNmT%d7)c|bY(i;$zA5)*e$RT8h=H})-Up#tG+f@O;v?Wi93nmyj zfE~aIijlQ-%YLasU~${N`TCPAP68# zVDBJ4fl`8UjAi|~DI3QG0G;=3m#WP$%7iI_v4gR%0|-ONfyqJ0A>ahf1-x`%!=%a; z0odD%TTRM4)9Ojsg*+1b7c;cXY7<=ZmtPi&3{?$$ME(^f+FT2Hjew!v$jJCga`&kyke7*t94E7%E69^?x z@(}XKsSlfSw)ed?rQD@E5KerChbTW{IoGdV@d=F65Qb3%;nV>omx((Fd#DN;W1Hi} zwqFu}?OVD~eY8P+Qn#G4{-^Y;-RbWD04Glz2TU#yC#WjK()}9aVAq=~iyi-@6<;LY z+XkTJIUaN&*r)9#lwLeS=^1;Eb6>uNBZoi4p<^d7qYM;4P!fnLQ~^;y&7cYtB9!6~ zuL4-}{|-!=vrdMw$f%zBTKJ68lnXh;>e1nU!rD&5qNzYB5SVuaeL1(%za=ta?rF|O9j)JzSq8m0RY&`2UZo! z|L#EhoUJmbGnEn;*AowR&`emeUJobVhPbr@;jDY{`7eyKiH(Tss5u&@AqqPBtF~*j z>)%D@1aZ(Q3PtBuiino zSCl44DCYwxF1B9H>X|Sg3K0M4^eF)A&I360;~#y0X?{qUOU48h593svYn8J=)WDi< zN&*yOz$c}9Eu7Nlo*Mi9!MkxNQ@AS0uq@dhKq^O!~}xz;K@Xd7Y-~+5Tgkg z4;n8VKqrH)>yRyD!_v`xTg$fo_}cDk={CBt?%=_L7Y}CQKjF!DdgqtC!5i1Rxzm5QpK z2~!*=8j6+^RFjFz5M@|438BhMFucKv>1;3p-TwHTham%D8D%61LJ^iMt7uu;wz&}% zK~fJ;qBoRUaQh&XWhh(LZlSnqH_b3b)m(6g zK+=dNG@3;&+^-;m=LJ!M4B%C*Af?S^ax==QAzA<_v`7S4HpL}He-Nm8UeOD#i~wLVu%rwe1afI z+(Y0VFOHKq?)B^mK}2Y#{GWePpygL(#X+o$wPAbweFC$Gv2yh($4v7Cwy&zTbtKo@ zS6N-()=14cpC71f8JKBz_S+7fXusd+8r?r-Yq~s+)%9=Mo#%$$cR9~YzG`T@8>qGK z*j_hwKHy!W`Klw%?kC@KLIfOb?t4*F=a_#vd)D!`^$tBheQa@fZeX@^a;V|_ZNk1q z_HxHB+zX9YjJ3S(?HG%_>v&vs^W?>+HoR}+)0>Z%9+|NZ*9J$LdY=6#2)?P|(^nss We^=By_~!n}n&~UIh@aF1*7FC9)cB|X literal 0 HcmV?d00001 diff --git a/docs/skin/menu.js b/docs/skin/menu.js new file mode 100644 index 0000000..06ea471 --- /dev/null +++ b/docs/skin/menu.js @@ -0,0 +1,48 @@ +/* +* Licensed to the Apache Software Foundation (ASF) under one or more +* contributor license agreements. See the NOTICE file distributed with +* this work for additional information regarding copyright ownership. +* The ASF licenses this file to You under the Apache License, Version 2.0 +* (the "License"); you may not use this file except in compliance with +* the License. You may obtain a copy of the License at +* +* http://www.apache.org/licenses/LICENSE-2.0 +* +* Unless required by applicable law or agreed to in writing, software +* distributed under the License is distributed on an "AS IS" BASIS, +* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +* See the License for the specific language governing permissions and +* limitations under the License. +*/ +/** + * This script, when included in a html file, can be used to make collapsible menus + * + * Typical usage: + * + */ + +if (document.getElementById){ + document.write('') +} + +function SwitchMenu(obj) +{ + if(document.getElementById) { + var el = document.getElementById(obj); + var title = document.getElementById(obj+'Title'); + + if(obj.indexOf("_selected_")==0&&el.style.display == ""){ + el.style.display = "block"; + title.className = "pagegroupselected"; + } + + if(el.style.display != "block"){ + el.style.display = "block"; + title.className = "pagegroupopen"; + } + else{ + el.style.display = "none"; + title.className = "pagegroup"; + } + }// end - if(document.getElementById) +}//end - function SwitchMenu(obj) diff --git a/docs/skin/note.txt b/docs/skin/note.txt new file mode 100644 index 0000000..d34c8db --- /dev/null +++ b/docs/skin/note.txt @@ -0,0 +1,50 @@ +Notes for developer: + +--Legend------------------- +TODO -> blocker +DONE -> blocker +ToDo -> enhancement bug +done -> enhancement bug + +--Issues------------------- +- the corner images should be rendered through svg with the header color. +-> DONE +-> ToDo: get rid of the images and use only divs! + +- the menu points should be displayed "better". +-> DONE +-- Use the krysalis-site menu approach for the overall menu display. +-> DONE +-- Use the old lenya innermenu approch to further enhance the menu . +-> DONE + +- the content area needs some attention. +-> DONE +-- introduce the heading scheme from krysalis () +-> DONE +-> ToDo: make box with round corners +-> done: make underlined with variable border height +-> ToDo: make underline with bottom round corner +-- introduce the toc for each html-page +-> DONE +-- introduce the external-link-images. +-> DONE + +- the publish note should be where now only a border is. +Like
+-> DONE +, but make it configurable. +-> DONE +- footer needs some attention +-> DONE +-- the footer do not have the color profile! Enable it! +-> DONE +-- the footer should as well contain a feedback link. +See http://issues.apache.org/eyebrowse/ReadMsg?listName=forrest-user@xml.apache.org&msgNo=71 +-> DONE + +- introduce credits alternativ location +-> DONE + +- border for published / breadtrail / menu /tab divs +-> ToDo \ No newline at end of file diff --git a/docs/skin/print.css b/docs/skin/print.css new file mode 100644 index 0000000..aaa9931 --- /dev/null +++ b/docs/skin/print.css @@ -0,0 +1,54 @@ +/* +* Licensed to the Apache Software Foundation (ASF) under one or more +* contributor license agreements. See the NOTICE file distributed with +* this work for additional information regarding copyright ownership. +* The ASF licenses this file to You under the Apache License, Version 2.0 +* (the "License"); you may not use this file except in compliance with +* the License. You may obtain a copy of the License at +* +* http://www.apache.org/licenses/LICENSE-2.0 +* +* Unless required by applicable law or agreed to in writing, software +* distributed under the License is distributed on an "AS IS" BASIS, +* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +* See the License for the specific language governing permissions and +* limitations under the License. +*/ +body { + font-family: Georgia, Palatino, serif; + font-size: 12pt; + background: white; +} + +#tabs, +#menu, +#content .toc { + display: none; +} + +#content { + width: auto; + padding: 0; + float: none !important; + color: black; + background: inherit; +} + +a:link, a:visited { + color: #336699; + background: inherit; + text-decoration: underline; +} + +#top .logo { + padding: 0; + margin: 0 0 2em 0; +} + +#footer { + margin-top: 4em; +} + +acronym { + border: 0; +} \ No newline at end of file diff --git a/docs/skin/profile.css b/docs/skin/profile.css new file mode 100644 index 0000000..eefaa88 --- /dev/null +++ b/docs/skin/profile.css @@ -0,0 +1,168 @@ + + +/* ==================== aural ============================ */ + +@media aural { + h1, h2, h3, h4, h5, h6 { voice-family: paul, male; stress: 20; richness: 90 } + h1 { pitch: x-low; pitch-range: 90 } + h2 { pitch: x-low; pitch-range: 80 } + h3 { pitch: low; pitch-range: 70 } + h4 { pitch: medium; pitch-range: 60 } + h5 { pitch: medium; pitch-range: 50 } + h6 { pitch: medium; pitch-range: 40 } + li, dt, dd { pitch: medium; richness: 60 } + dt { stress: 80 } + pre, code, tt { pitch: medium; pitch-range: 0; stress: 0; richness: 80 } + em { pitch: medium; pitch-range: 60; stress: 60; richness: 50 } + strong { pitch: medium; pitch-range: 60; stress: 90; richness: 90 } + dfn { pitch: high; pitch-range: 60; stress: 60 } + s, strike { richness: 0 } + i { pitch: medium; pitch-range: 60; stress: 60; richness: 50 } + b { pitch: medium; pitch-range: 60; stress: 90; richness: 90 } + u { richness: 0 } + + :link { voice-family: harry, male } + :visited { voice-family: betty, female } + :active { voice-family: betty, female; pitch-range: 80; pitch: x-high } +} + +a.external { + padding: 0 20px 0px 0px; + display:inline; + background-repeat: no-repeat; + background-position: center right; + background-image: url(images/external-link.gif); +} + +#top { background-color: #FFFFFF;} + +#top .header .current { background-color: #4C6C8F;} +#top .header .current a:link { color: #ffffff; } +#top .header .current a:visited { color: #ffffff; } +#top .header .current a:hover { color: #ffffff; } + +#tabs li { background-color: #E5E4D9 ;} +#tabs li a:link { color: #000000; } +#tabs li a:visited { color: #000000; } +#tabs li a:hover { color: #000000; } + +#level2tabs a.selected { background-color: #4C6C8F ;} +#level2tabs a:link { color: #ffffff; } +#level2tabs a:visited { color: #ffffff; } +#level2tabs a:hover { color: #ffffff; } + +#level2tabs { background-color: #E5E4D9;} +#level2tabs a.unselected:link { color: #000000; } +#level2tabs a.unselected:visited { color: #000000; } +#level2tabs a.unselected:hover { color: #000000; } + +.heading { background-color: #E5E4D9;} + +.boxed { background-color: #E5E4D9;} +.underlined_5 {border-bottom: solid 5px #E5E4D9;} +.underlined_10 {border-bottom: solid 10px #E5E4D9;} +table caption { +background-color: #E5E4D9; +color: #000000; +} + +#feedback { +color: #FFFFFF; +background: #4C6C8F; +text-align: center; +} +#feedback #feedbackto { +color: #FFFFFF; +} + +#publishedStrip { +color: #FFFFFF; +background: #4C6C8F; +} + +#publishedStrip { +color: #000000; +background: #E5E4D9; +} + +#menu .menupagetitle { background-color: #CFDCED; + color: #000000;} + +#menu { border-color: #999999;} +#menu .menupagetitle { border-color: #999999;} +#menu .menupageitemgroup { border-color: #999999;} + +#menu { background-color: #4C6C8F;} +#menu { color: #ffffff;} +#menu a:link { color: #ffffff;} +#menu a:visited { color: #ffffff;} +#menu a:hover { +background-color: #4C6C8F; +color: #ffffff;} + +#menu h1 { +color: #000000; +background-color: #cfdced; +} + +#top .searchbox { +background-color: #E5E4D9 ; +color: #000000; +} + +#menu .menupageitemgroup { +background-color: #E5E4D9; +} +#menu .menupageitem { +color: #000000; +} +#menu .menupageitem a:link { color: #000000;} +#menu .menupageitem a:visited { color: #000000;} +#menu .menupageitem a:hover { +background-color: #E5E4D9; +color: #000000; +} + +body{ +background-color: #ffffff; +color: #000000; +} +a:link { color:#0000ff} +a:visited { color:#009999} +a:hover { color:#6587ff} + + +.ForrestTable { background-color: #ccc;} + +.ForrestTable td { background-color: #ffffff;} + +.highlight { background-color: #ffff00;} + +.fixme { border-color: #c60;} + +.note { border-color: #069;} + +.warning { border-color: #900;} + +.code { border-color: #a5b6c6;} + +#footer { background-color: #E5E4D9;} +/* extra-css */ + + p.quote { + margin-left: 2em; + padding: .5em; + background-color: #f0f0f0; + font-family: monospace; + } + + pre.code { + margin-left: 0em; + padding: 0.5em; + background-color: #f0f0f0; + font-family: monospace; + } + + + + \ No newline at end of file diff --git a/docs/skin/prototype.js b/docs/skin/prototype.js new file mode 100644 index 0000000..ed7d920 --- /dev/null +++ b/docs/skin/prototype.js @@ -0,0 +1,1257 @@ +/* Prototype JavaScript framework, version 1.4.0_pre4 + * (c) 2005 Sam Stephenson + * + * THIS FILE IS AUTOMATICALLY GENERATED. When sending patches, please diff + * against the source tree, available from the Prototype darcs repository. + * + * Prototype is freely distributable under the terms of an MIT-style license. + * + * For details, see the Prototype web site: http://prototype.conio.net/ + * +/*--------------------------------------------------------------------------*/ + +var Prototype = { + Version: '1.4.0_pre4', + + emptyFunction: function() {}, + K: function(x) {return x} +} + +var Class = { + create: function() { + return function() { + this.initialize.apply(this, arguments); + } + } +} + +var Abstract = new Object(); + +Object.extend = function(destination, source) { + for (property in source) { + destination[property] = source[property]; + } + return destination; +} + +Function.prototype.bind = function(object) { + var __method = this; + return function() { + return __method.apply(object, arguments); + } +} + +Function.prototype.bindAsEventListener = function(object) { + var __method = this; + return function(event) { + return __method.call(object, event || window.event); + } +} + +Number.prototype.toColorPart = function() { + var digits = this.toString(16); + if (this < 16) return '0' + digits; + return digits; +} + +var Try = { + these: function() { + var returnValue; + + for (var i = 0; i < arguments.length; i++) { + var lambda = arguments[i]; + try { + returnValue = lambda(); + break; + } catch (e) {} + } + + return returnValue; + } +} + +/*--------------------------------------------------------------------------*/ + +var PeriodicalExecuter = Class.create(); +PeriodicalExecuter.prototype = { + initialize: function(callback, frequency) { + this.callback = callback; + this.frequency = frequency; + this.currentlyExecuting = false; + + this.registerCallback(); + }, + + registerCallback: function() { + setInterval(this.onTimerEvent.bind(this), this.frequency * 1000); + }, + + onTimerEvent: function() { + if (!this.currentlyExecuting) { + try { + this.currentlyExecuting = true; + this.callback(); + } finally { + this.currentlyExecuting = false; + } + } + } +} + +/*--------------------------------------------------------------------------*/ + +function $() { + var elements = new Array(); + + for (var i = 0; i < arguments.length; i++) { + var element = arguments[i]; + if (typeof element == 'string') + element = document.getElementById(element); + + if (arguments.length == 1) + return element; + + elements.push(element); + } + + return elements; +} + +if (!Array.prototype.push) { + Array.prototype.push = function() { + var startLength = this.length; + for (var i = 0; i < arguments.length; i++) + this[startLength + i] = arguments[i]; + return this.length; + } +} + +if (!Function.prototype.apply) { + // Based on code from http://www.youngpup.net/ + Function.prototype.apply = function(object, parameters) { + var parameterStrings = new Array(); + if (!object) object = window; + if (!parameters) parameters = new Array(); + + for (var i = 0; i < parameters.length; i++) + parameterStrings[i] = 'parameters[' + i + ']'; + + object.__apply__ = this; + var result = eval('object.__apply__(' + + parameterStrings.join(', ') + ')'); + object.__apply__ = null; + + return result; + } +} + +Object.extend(String.prototype, { + stripTags: function() { + return this.replace(/<\/?[^>]+>/gi, ''); + }, + + escapeHTML: function() { + var div = document.createElement('div'); + var text = document.createTextNode(this); + div.appendChild(text); + return div.innerHTML; + }, + + unescapeHTML: function() { + var div = document.createElement('div'); + div.innerHTML = this.stripTags(); + return div.childNodes[0].nodeValue; + }, + + parseQuery: function() { + var str = this; + if (str.substring(0,1) == '?') { + str = this.substring(1); + } + var result = {}; + var pairs = str.split('&'); + for (var i = 0; i < pairs.length; i++) { + var pair = pairs[i].split('='); + result[pair[0]] = pair[1]; + } + return result; + } +}); + + +var _break = new Object(); +var _continue = new Object(); + +var Enumerable = { + each: function(iterator) { + var index = 0; + try { + this._each(function(value) { + try { + iterator(value, index++); + } catch (e) { + if (e != _continue) throw e; + } + }); + } catch (e) { + if (e != _break) throw e; + } + }, + + all: function(iterator) { + var result = true; + this.each(function(value, index) { + if (!(result &= (iterator || Prototype.K)(value, index))) + throw _break; + }); + return result; + }, + + any: function(iterator) { + var result = true; + this.each(function(value, index) { + if (result &= (iterator || Prototype.K)(value, index)) + throw _break; + }); + return result; + }, + + collect: function(iterator) { + var results = []; + this.each(function(value, index) { + results.push(iterator(value, index)); + }); + return results; + }, + + detect: function (iterator) { + var result; + this.each(function(value, index) { + if (iterator(value, index)) { + result = value; + throw _break; + } + }); + return result; + }, + + findAll: function(iterator) { + var results = []; + this.each(function(value, index) { + if (iterator(value, index)) + results.push(value); + }); + return results; + }, + + grep: function(pattern, iterator) { + var results = []; + this.each(function(value, index) { + var stringValue = value.toString(); + if (stringValue.match(pattern)) + results.push((iterator || Prototype.K)(value, index)); + }) + return results; + }, + + include: function(object) { + var found = false; + this.each(function(value) { + if (value == object) { + found = true; + throw _break; + } + }); + return found; + }, + + inject: function(memo, iterator) { + this.each(function(value, index) { + memo = iterator(memo, value, index); + }); + return memo; + }, + + invoke: function(method) { + var args = $A(arguments).slice(1); + return this.collect(function(value) { + return value[method].apply(value, args); + }); + }, + + max: function(iterator) { + var result; + this.each(function(value, index) { + value = (iterator || Prototype.K)(value, index); + if (value >= (result || value)) + result = value; + }); + return result; + }, + + min: function(iterator) { + var result; + this.each(function(value, index) { + value = (iterator || Prototype.K)(value, index); + if (value <= (result || value)) + result = value; + }); + return result; + }, + + partition: function(iterator) { + var trues = [], falses = []; + this.each(function(value, index) { + ((iterator || Prototype.K)(value, index) ? + trues : falses).push(value); + }); + return [trues, falses]; + }, + + pluck: function(property) { + var results = []; + this.each(function(value, index) { + results.push(value[property]); + }); + return results; + }, + + reject: function(iterator) { + var results = []; + this.each(function(value, index) { + if (!iterator(value, index)) + results.push(value); + }); + return results; + }, + + sortBy: function(iterator) { + return this.collect(function(value, index) { + return {value: value, criteria: iterator(value, index)}; + }).sort(function(left, right) { + var a = left.criteria, b = right.criteria; + return a < b ? -1 : a > b ? 1 : 0; + }).pluck('value'); + }, + + toArray: function() { + return this.collect(Prototype.K); + }, + + zip: function() { + var iterator = Prototype.K, args = $A(arguments); + if (typeof args.last() == 'function') + iterator = args.pop(); + + var collections = [this].concat(args).map($A); + return this.map(function(value, index) { + iterator(value = collections.pluck(index)); + return value; + }); + } +} + +Object.extend(Enumerable, { + map: Enumerable.collect, + find: Enumerable.detect, + select: Enumerable.findAll, + member: Enumerable.include, + entries: Enumerable.toArray +}); + +$A = Array.from = function(iterable) { + var results = []; + for (var i = 0; i < iterable.length; i++) + results.push(iterable[i]); + return results; +} + +Object.extend(Array.prototype, { + _each: function(iterator) { + for (var i = 0; i < this.length; i++) + iterator(this[i]); + }, + + first: function() { + return this[0]; + }, + + last: function() { + return this[this.length - 1]; + } +}); + +Object.extend(Array.prototype, Enumerable); + + +var Ajax = { + getTransport: function() { + return Try.these( + function() {return new ActiveXObject('Msxml2.XMLHTTP')}, + function() {return new ActiveXObject('Microsoft.XMLHTTP')}, + function() {return new XMLHttpRequest()} + ) || false; + } +} + +Ajax.Base = function() {}; +Ajax.Base.prototype = { + setOptions: function(options) { + this.options = { + method: 'post', + asynchronous: true, + parameters: '' + } + Object.extend(this.options, options || {}); + }, + + responseIsSuccess: function() { + return this.transport.status == undefined + || this.transport.status == 0 + || (this.transport.status >= 200 && this.transport.status < 300); + }, + + responseIsFailure: function() { + return !this.responseIsSuccess(); + } +} + +Ajax.Request = Class.create(); +Ajax.Request.Events = + ['Uninitialized', 'Loading', 'Loaded', 'Interactive', 'Complete']; + +Ajax.Request.prototype = Object.extend(new Ajax.Base(), { + initialize: function(url, options) { + this.transport = Ajax.getTransport(); + this.setOptions(options); + this.request(url); + }, + + request: function(url) { + var parameters = this.options.parameters || ''; + if (parameters.length > 0) parameters += '&_='; + + try { + if (this.options.method == 'get') + url += '?' + parameters; + + this.transport.open(this.options.method, url, + this.options.asynchronous); + + if (this.options.asynchronous) { + this.transport.onreadystatechange = this.onStateChange.bind(this); + setTimeout((function() {this.respondToReadyState(1)}).bind(this), 10); + } + + this.setRequestHeaders(); + + var body = this.options.postBody ? this.options.postBody : parameters; + this.transport.send(this.options.method == 'post' ? body : null); + + } catch (e) { + } + }, + + setRequestHeaders: function() { + var requestHeaders = + ['X-Requested-With', 'XMLHttpRequest', + 'X-Prototype-Version', Prototype.Version]; + + if (this.options.method == 'post') { + requestHeaders.push('Content-type', + 'application/x-www-form-urlencoded'); + + /* Force "Connection: close" for Mozilla browsers to work around + * a bug where XMLHttpReqeuest sends an incorrect Content-length + * header. See Mozilla Bugzilla #246651. + */ + if (this.transport.overrideMimeType) + requestHeaders.push('Connection', 'close'); + } + + if (this.options.requestHeaders) + requestHeaders.push.apply(requestHeaders, this.options.requestHeaders); + + for (var i = 0; i < requestHeaders.length; i += 2) + this.transport.setRequestHeader(requestHeaders[i], requestHeaders[i+1]); + }, + + onStateChange: function() { + var readyState = this.transport.readyState; + if (readyState != 1) + this.respondToReadyState(this.transport.readyState); + }, + + respondToReadyState: function(readyState) { + var event = Ajax.Request.Events[readyState]; + + if (event == 'Complete') + (this.options['on' + this.transport.status] + || this.options['on' + (this.responseIsSuccess() ? 'Success' : 'Failure')] + || Prototype.emptyFunction)(this.transport); + + (this.options['on' + event] || Prototype.emptyFunction)(this.transport); + + /* Avoid memory leak in MSIE: clean up the oncomplete event handler */ + if (event == 'Complete') + this.transport.onreadystatechange = Prototype.emptyFunction; + } +}); + +Ajax.Updater = Class.create(); +Ajax.Updater.ScriptFragment = '(?:)((\n|.)*?)(?:<\/script>)'; + +Object.extend(Object.extend(Ajax.Updater.prototype, Ajax.Request.prototype), { + initialize: function(container, url, options) { + this.containers = { + success: container.success ? $(container.success) : $(container), + failure: container.failure ? $(container.failure) : + (container.success ? null : $(container)) + } + + this.transport = Ajax.getTransport(); + this.setOptions(options); + + var onComplete = this.options.onComplete || Prototype.emptyFunction; + this.options.onComplete = (function() { + this.updateContent(); + onComplete(this.transport); + }).bind(this); + + this.request(url); + }, + + updateContent: function() { + var receiver = this.responseIsSuccess() ? + this.containers.success : this.containers.failure; + + var match = new RegExp(Ajax.Updater.ScriptFragment, 'img'); + var response = this.transport.responseText.replace(match, ''); + var scripts = this.transport.responseText.match(match); + + if (receiver) { + if (this.options.insertion) { + new this.options.insertion(receiver, response); + } else { + receiver.innerHTML = response; + } + } + + if (this.responseIsSuccess()) { + if (this.onComplete) + setTimeout((function() {this.onComplete( + this.transport)}).bind(this), 10); + } + + if (this.options.evalScripts && scripts) { + match = new RegExp(Ajax.Updater.ScriptFragment, 'im'); + setTimeout((function() { + for (var i = 0; i < scripts.length; i++) + eval(scripts[i].match(match)[1]); + }).bind(this), 10); + } + } +}); + +Ajax.PeriodicalUpdater = Class.create(); +Ajax.PeriodicalUpdater.prototype = Object.extend(new Ajax.Base(), { + initialize: function(container, url, options) { + this.setOptions(options); + this.onComplete = this.options.onComplete; + + this.frequency = (this.options.frequency || 2); + this.decay = 1; + + this.updater = {}; + this.container = container; + this.url = url; + + this.start(); + }, + + start: function() { + this.options.onComplete = this.updateComplete.bind(this); + this.onTimerEvent(); + }, + + stop: function() { + this.updater.onComplete = undefined; + clearTimeout(this.timer); + (this.onComplete || Ajax.emptyFunction).apply(this, arguments); + }, + + updateComplete: function(request) { + if (this.options.decay) { + this.decay = (request.responseText == this.lastText ? + this.decay * this.options.decay : 1); + + this.lastText = request.responseText; + } + this.timer = setTimeout(this.onTimerEvent.bind(this), + this.decay * this.frequency * 1000); + }, + + onTimerEvent: function() { + this.updater = new Ajax.Updater(this.container, this.url, this.options); + } +}); + +document.getElementsByClassName = function(className) { + var children = document.getElementsByTagName('*') || document.all; + var elements = new Array(); + + for (var i = 0; i < children.length; i++) { + var child = children[i]; + var classNames = child.className.split(' '); + for (var j = 0; j < classNames.length; j++) { + if (classNames[j] == className) { + elements.push(child); + break; + } + } + } + + return elements; +} + +/*--------------------------------------------------------------------------*/ + +if (!window.Element) { + var Element = new Object(); +} + +Object.extend(Element, { + toggle: function() { + for (var i = 0; i < arguments.length; i++) { + var element = $(arguments[i]); + element.style.display = + (element.style.display == 'none' ? '' : 'none'); + } + }, + + hide: function() { + for (var i = 0; i < arguments.length; i++) { + var element = $(arguments[i]); + element.style.display = 'none'; + } + }, + + show: function() { + for (var i = 0; i < arguments.length; i++) { + var element = $(arguments[i]); + element.style.display = ''; + } + }, + + remove: function(element) { + element = $(element); + element.parentNode.removeChild(element); + }, + + getHeight: function(element) { + element = $(element); + return element.offsetHeight; + }, + + hasClassName: function(element, className) { + element = $(element); + if (!element) + return; + var a = element.className.split(' '); + for (var i = 0; i < a.length; i++) { + if (a[i] == className) + return true; + } + return false; + }, + + addClassName: function(element, className) { + element = $(element); + Element.removeClassName(element, className); + element.className += ' ' + className; + }, + + removeClassName: function(element, className) { + element = $(element); + if (!element) + return; + var newClassName = ''; + var a = element.className.split(' '); + for (var i = 0; i < a.length; i++) { + if (a[i] != className) { + if (i > 0) + newClassName += ' '; + newClassName += a[i]; + } + } + element.className = newClassName; + }, + + // removes whitespace-only text node children + cleanWhitespace: function(element) { + var element = $(element); + for (var i = 0; i < element.childNodes.length; i++) { + var node = element.childNodes[i]; + if (node.nodeType == 3 && !/\S/.test(node.nodeValue)) + Element.remove(node); + } + } +}); + +var Toggle = new Object(); +Toggle.display = Element.toggle; + +/*--------------------------------------------------------------------------*/ + +Abstract.Insertion = function(adjacency) { + this.adjacency = adjacency; +} + +Abstract.Insertion.prototype = { + initialize: function(element, content) { + this.element = $(element); + this.content = content; + + if (this.adjacency && this.element.insertAdjacentHTML) { + this.element.insertAdjacentHTML(this.adjacency, this.content); + } else { + this.range = this.element.ownerDocument.createRange(); + if (this.initializeRange) this.initializeRange(); + this.fragment = this.range.createContextualFragment(this.content); + this.insertContent(); + } + } +} + +var Insertion = new Object(); + +Insertion.Before = Class.create(); +Insertion.Before.prototype = Object.extend(new Abstract.Insertion('beforeBegin'), { + initializeRange: function() { + this.range.setStartBefore(this.element); + }, + + insertContent: function() { + this.element.parentNode.insertBefore(this.fragment, this.element); + } +}); + +Insertion.Top = Class.create(); +Insertion.Top.prototype = Object.extend(new Abstract.Insertion('afterBegin'), { + initializeRange: function() { + this.range.selectNodeContents(this.element); + this.range.collapse(true); + }, + + insertContent: function() { + this.element.insertBefore(this.fragment, this.element.firstChild); + } +}); + +Insertion.Bottom = Class.create(); +Insertion.Bottom.prototype = Object.extend(new Abstract.Insertion('beforeEnd'), { + initializeRange: function() { + this.range.selectNodeContents(this.element); + this.range.collapse(this.element); + }, + + insertContent: function() { + this.element.appendChild(this.fragment); + } +}); + +Insertion.After = Class.create(); +Insertion.After.prototype = Object.extend(new Abstract.Insertion('afterEnd'), { + initializeRange: function() { + this.range.setStartAfter(this.element); + }, + + insertContent: function() { + this.element.parentNode.insertBefore(this.fragment, + this.element.nextSibling); + } +}); + +var Field = { + clear: function() { + for (var i = 0; i < arguments.length; i++) + $(arguments[i]).value = ''; + }, + + focus: function(element) { + $(element).focus(); + }, + + present: function() { + for (var i = 0; i < arguments.length; i++) + if ($(arguments[i]).value == '') return false; + return true; + }, + + select: function(element) { + $(element).select(); + }, + + activate: function(element) { + $(element).focus(); + $(element).select(); + } +} + +/*--------------------------------------------------------------------------*/ + +var Form = { + serialize: function(form) { + var elements = Form.getElements($(form)); + var queryComponents = new Array(); + + for (var i = 0; i < elements.length; i++) { + var queryComponent = Form.Element.serialize(elements[i]); + if (queryComponent) + queryComponents.push(queryComponent); + } + + return queryComponents.join('&'); + }, + + getElements: function(form) { + var form = $(form); + var elements = new Array(); + + for (tagName in Form.Element.Serializers) { + var tagElements = form.getElementsByTagName(tagName); + for (var j = 0; j < tagElements.length; j++) + elements.push(tagElements[j]); + } + return elements; + }, + + getInputs: function(form, typeName, name) { + var form = $(form); + var inputs = form.getElementsByTagName('input'); + + if (!typeName && !name) + return inputs; + + var matchingInputs = new Array(); + for (var i = 0; i < inputs.length; i++) { + var input = inputs[i]; + if ((typeName && input.type != typeName) || + (name && input.name != name)) + continue; + matchingInputs.push(input); + } + + return matchingInputs; + }, + + disable: function(form) { + var elements = Form.getElements(form); + for (var i = 0; i < elements.length; i++) { + var element = elements[i]; + element.blur(); + element.disabled = 'true'; + } + }, + + enable: function(form) { + var elements = Form.getElements(form); + for (var i = 0; i < elements.length; i++) { + var element = elements[i]; + element.disabled = ''; + } + }, + + focusFirstElement: function(form) { + var form = $(form); + var elements = Form.getElements(form); + for (var i = 0; i < elements.length; i++) { + var element = elements[i]; + if (element.type != 'hidden' && !element.disabled) { + Field.activate(element); + break; + } + } + }, + + reset: function(form) { + $(form).reset(); + } +} + +Form.Element = { + serialize: function(element) { + var element = $(element); + var method = element.tagName.toLowerCase(); + var parameter = Form.Element.Serializers[method](element); + + if (parameter) + return encodeURIComponent(parameter[0]) + '=' + + encodeURIComponent(parameter[1]); + }, + + getValue: function(element) { + var element = $(element); + var method = element.tagName.toLowerCase(); + var parameter = Form.Element.Serializers[method](element); + + if (parameter) + return parameter[1]; + } +} + +Form.Element.Serializers = { + input: function(element) { + switch (element.type.toLowerCase()) { + case 'submit': + case 'hidden': + case 'password': + case 'text': + return Form.Element.Serializers.textarea(element); + case 'checkbox': + case 'radio': + return Form.Element.Serializers.inputSelector(element); + } + return false; + }, + + inputSelector: function(element) { + if (element.checked) + return [element.name, element.value]; + }, + + textarea: function(element) { + return [element.name, element.value]; + }, + + select: function(element) { + var value = ''; + if (element.type == 'select-one') { + var index = element.selectedIndex; + if (index >= 0) + value = element.options[index].value || element.options[index].text; + } else { + value = new Array(); + for (var i = 0; i < element.length; i++) { + var opt = element.options[i]; + if (opt.selected) + value.push(opt.value || opt.text); + } + } + return [element.name, value]; + } +} + +/*--------------------------------------------------------------------------*/ + +var $F = Form.Element.getValue; + +/*--------------------------------------------------------------------------*/ + +Abstract.TimedObserver = function() {} +Abstract.TimedObserver.prototype = { + initialize: function(element, frequency, callback) { + this.frequency = frequency; + this.element = $(element); + this.callback = callback; + + this.lastValue = this.getValue(); + this.registerCallback(); + }, + + registerCallback: function() { + setInterval(this.onTimerEvent.bind(this), this.frequency * 1000); + }, + + onTimerEvent: function() { + var value = this.getValue(); + if (this.lastValue != value) { + this.callback(this.element, value); + this.lastValue = value; + } + } +} + +Form.Element.Observer = Class.create(); +Form.Element.Observer.prototype = Object.extend(new Abstract.TimedObserver(), { + getValue: function() { + return Form.Element.getValue(this.element); + } +}); + +Form.Observer = Class.create(); +Form.Observer.prototype = Object.extend(new Abstract.TimedObserver(), { + getValue: function() { + return Form.serialize(this.element); + } +}); + +/*--------------------------------------------------------------------------*/ + +Abstract.EventObserver = function() {} +Abstract.EventObserver.prototype = { + initialize: function(element, callback) { + this.element = $(element); + this.callback = callback; + + this.lastValue = this.getValue(); + if (this.element.tagName.toLowerCase() == 'form') + this.registerFormCallbacks(); + else + this.registerCallback(this.element); + }, + + onElementEvent: function() { + var value = this.getValue(); + if (this.lastValue != value) { + this.callback(this.element, value); + this.lastValue = value; + } + }, + + registerFormCallbacks: function() { + var elements = Form.getElements(this.element); + for (var i = 0; i < elements.length; i++) + this.registerCallback(elements[i]); + }, + + registerCallback: function(element) { + if (element.type) { + switch (element.type.toLowerCase()) { + case 'checkbox': + case 'radio': + element.target = this; + element.prev_onclick = element.onclick || Prototype.emptyFunction; + element.onclick = function() { + this.prev_onclick(); + this.target.onElementEvent(); + } + break; + case 'password': + case 'text': + case 'textarea': + case 'select-one': + case 'select-multiple': + element.target = this; + element.prev_onchange = element.onchange || Prototype.emptyFunction; + element.onchange = function() { + this.prev_onchange(); + this.target.onElementEvent(); + } + break; + } + } + } +} + +Form.Element.EventObserver = Class.create(); +Form.Element.EventObserver.prototype = Object.extend(new Abstract.EventObserver(), { + getValue: function() { + return Form.Element.getValue(this.element); + } +}); + +Form.EventObserver = Class.create(); +Form.EventObserver.prototype = Object.extend(new Abstract.EventObserver(), { + getValue: function() { + return Form.serialize(this.element); + } +}); + + +if (!window.Event) { + var Event = new Object(); +} + +Object.extend(Event, { + KEY_BACKSPACE: 8, + KEY_TAB: 9, + KEY_RETURN: 13, + KEY_ESC: 27, + KEY_LEFT: 37, + KEY_UP: 38, + KEY_RIGHT: 39, + KEY_DOWN: 40, + KEY_DELETE: 46, + + element: function(event) { + return event.target || event.srcElement; + }, + + isLeftClick: function(event) { + return (((event.which) && (event.which == 1)) || + ((event.button) && (event.button == 1))); + }, + + pointerX: function(event) { + return event.pageX || (event.clientX + + (document.documentElement.scrollLeft || document.body.scrollLeft)); + }, + + pointerY: function(event) { + return event.pageY || (event.clientY + + (document.documentElement.scrollTop || document.body.scrollTop)); + }, + + stop: function(event) { + if (event.preventDefault) { + event.preventDefault(); + event.stopPropagation(); + } else { + event.returnValue = false; + } + }, + + // find the first node with the given tagName, starting from the + // node the event was triggered on; traverses the DOM upwards + findElement: function(event, tagName) { + var element = Event.element(event); + while (element.parentNode && (!element.tagName || + (element.tagName.toUpperCase() != tagName.toUpperCase()))) + element = element.parentNode; + return element; + }, + + observers: false, + + _observeAndCache: function(element, name, observer, useCapture) { + if (!this.observers) this.observers = []; + if (element.addEventListener) { + this.observers.push([element, name, observer, useCapture]); + element.addEventListener(name, observer, useCapture); + } else if (element.attachEvent) { + this.observers.push([element, name, observer, useCapture]); + element.attachEvent('on' + name, observer); + } + }, + + unloadCache: function() { + if (!Event.observers) return; + for (var i = 0; i < Event.observers.length; i++) { + Event.stopObserving.apply(this, Event.observers[i]); + Event.observers[i][0] = null; + } + Event.observers = false; + }, + + observe: function(element, name, observer, useCapture) { + var element = $(element); + useCapture = useCapture || false; + + if (name == 'keypress' && + ((/Konqueror|Safari|KHTML/.test(navigator.userAgent)) + || element.attachEvent)) + name = 'keydown'; + + this._observeAndCache(element, name, observer, useCapture); + }, + + stopObserving: function(element, name, observer, useCapture) { + var element = $(element); + useCapture = useCapture || false; + + if (name == 'keypress' && + ((/Konqueror|Safari|KHTML/.test(navigator.userAgent)) + || element.detachEvent)) + name = 'keydown'; + + if (element.removeEventListener) { + element.removeEventListener(name, observer, useCapture); + } else if (element.detachEvent) { + element.detachEvent('on' + name, observer); + } + } +}); + +/* prevent memory leaks in IE */ +Event.observe(window, 'unload', Event.unloadCache, false); + +var Position = { + + // set to true if needed, warning: firefox performance problems + // NOT neeeded for page scrolling, only if draggable contained in + // scrollable elements + includeScrollOffsets: false, + + // must be called before calling withinIncludingScrolloffset, every time the + // page is scrolled + prepare: function() { + this.deltaX = window.pageXOffset + || document.documentElement.scrollLeft + || document.body.scrollLeft + || 0; + this.deltaY = window.pageYOffset + || document.documentElement.scrollTop + || document.body.scrollTop + || 0; + }, + + realOffset: function(element) { + var valueT = 0, valueL = 0; + do { + valueT += element.scrollTop || 0; + valueL += element.scrollLeft || 0; + element = element.parentNode; + } while (element); + return [valueL, valueT]; + }, + + cumulativeOffset: function(element) { + var valueT = 0, valueL = 0; + do { + valueT += element.offsetTop || 0; + valueL += element.offsetLeft || 0; + element = element.offsetParent; + } while (element); + return [valueL, valueT]; + }, + + // caches x/y coordinate pair to use with overlap + within: function(element, x, y) { + if (this.includeScrollOffsets) + return this.withinIncludingScrolloffsets(element, x, y); + this.xcomp = x; + this.ycomp = y; + this.offset = this.cumulativeOffset(element); + + return (y >= this.offset[1] && + y < this.offset[1] + element.offsetHeight && + x >= this.offset[0] && + x < this.offset[0] + element.offsetWidth); + }, + + withinIncludingScrolloffsets: function(element, x, y) { + var offsetcache = this.realOffset(element); + + this.xcomp = x + offsetcache[0] - this.deltaX; + this.ycomp = y + offsetcache[1] - this.deltaY; + this.offset = this.cumulativeOffset(element); + + return (this.ycomp >= this.offset[1] && + this.ycomp < this.offset[1] + element.offsetHeight && + this.xcomp >= this.offset[0] && + this.xcomp < this.offset[0] + element.offsetWidth); + }, + + // within must be called directly before + overlap: function(mode, element) { + if (!mode) return 0; + if (mode == 'vertical') + return ((this.offset[1] + element.offsetHeight) - this.ycomp) / + element.offsetHeight; + if (mode == 'horizontal') + return ((this.offset[0] + element.offsetWidth) - this.xcomp) / + element.offsetWidth; + }, + + clone: function(source, target) { + source = $(source); + target = $(target); + target.style.position = 'absolute'; + var offsets = this.cumulativeOffset(source); + target.style.top = offsets[1] + 'px'; + target.style.left = offsets[0] + 'px'; + target.style.width = source.offsetWidth + 'px'; + target.style.height = source.offsetHeight + 'px'; + } +} diff --git a/docs/skin/screen.css b/docs/skin/screen.css new file mode 100644 index 0000000..221cbe5 --- /dev/null +++ b/docs/skin/screen.css @@ -0,0 +1,587 @@ +/* +* Licensed to the Apache Software Foundation (ASF) under one or more +* contributor license agreements. See the NOTICE file distributed with +* this work for additional information regarding copyright ownership. +* The ASF licenses this file to You under the Apache License, Version 2.0 +* (the "License"); you may not use this file except in compliance with +* the License. You may obtain a copy of the License at +* +* http://www.apache.org/licenses/LICENSE-2.0 +* +* Unless required by applicable law or agreed to in writing, software +* distributed under the License is distributed on an "AS IS" BASIS, +* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +* See the License for the specific language governing permissions and +* limitations under the License. +*/ +body { margin: 0px 0px 0px 0px; font-family: Verdana, Helvetica, sans-serif; } + +h1 { font-size : 160%; margin: 0px 0px 0px 0px; padding: 0px; } +h2 { font-size : 140%; margin: 1em 0px 0.8em 0px; padding: 0px; font-weight : bold;} +h3 { font-size : 130%; margin: 0.8em 0px 0px 0px; padding: 0px; font-weight : bold; } +.h3 { margin: 22px 0px 3px 0px; } +h4 { font-size : 120%; margin: 0.7em 0px 0px 0px; padding: 0px; font-weight : normal; text-align: left; } +.h4 { margin: 18px 0px 0px 0px; } +h4.faq { font-size : 120%; margin: 18px 0px 0px 0px; padding: 0px; font-weight : bold; text-align: left; } +h5 { font-size : 100%; margin: 14px 0px 0px 0px; padding: 0px; font-weight : normal; text-align: left; } + +/** +* table +*/ +table .title { background-color: #000000; } +.ForrestTable { + color: #ffffff; + background-color: #7099C5; + width: 100%; + font-size : 100%; + empty-cells: show; +} +table caption { + padding-left: 5px; + color: white; + text-align: left; + font-weight: bold; + background-color: #000000; +} +.ForrestTable td { + color: black; + background-color: #f0f0ff; +} +.ForrestTable th { text-align: center; } +/** + * Page Header + */ + +#top { + position: relative; + float: left; + width: 100%; + background: #294563; /* if you want a background in the header, put it here */ +} + +#top .breadtrail { + background: #CFDCED; + color: black; + border-bottom: solid 1px white; + padding: 3px 10px; + font-size: 75%; +} +#top .breadtrail a { color: black; } + +#top .header { + float: left; + width: 100%; + background: url("images/header_white_line.gif") repeat-x bottom; +} + +#top .grouplogo { + padding: 7px 0 10px 10px; + float: left; + text-align: left; +} +#top .projectlogo { + padding: 7px 0 10px 10px; + float: left; + width: 33%; + text-align: right; +} +#top .projectlogoA1 { + padding: 7px 0 10px 10px; + float: right; +} +html>body #top .searchbox { + bottom: 0px; +} +#top .searchbox { + position: absolute; + right: 10px; + height: 42px; + font-size: 70%; + white-space: nowrap; + text-align: right; + color: white; + background-color: #000000; + z-index:0; + background-image: url(images/rc-t-l-5-1header-2searchbox-3searchbox.png); + background-repeat: no-repeat; + background-position: top left; + bottom: -1px; /* compensate for IE rendering issue */ +} + +#top .searchbox form { + padding: 5px 10px; + margin: 0; +} +#top .searchbox p { + padding: 0 0 2px 0; + margin: 0; +} +#top .searchbox input { + font-size: 100%; +} + +#tabs { + clear: both; + padding-left: 10px; + margin: 0; + list-style: none; +} +/* background: #CFDCED url("images/tab-right.gif") no-repeat right top;*/ +#tabs li { + float: left; + background-image: url(images/rc-t-r-5-1header-2tab-unselected-3tab-unselected.png); + background-repeat: no-repeat; + background-position: top right; + background-color: #000000; + margin: 0 3px 0 0; + padding: 0; +} + +/*background: url("images/tab-left.gif") no-repeat left top;*/ +#tabs li a { + float: left; + display: block; + font-family: verdana, arial, sans-serif; + text-decoration: none; + color: black; + white-space: nowrap; + background-image: url(images/rc-t-l-5-1header-2tab-unselected-3tab-unselected.png); + background-repeat: no-repeat; + background-position: top left; + padding: 5px 15px 4px; + width: .1em; /* IE/Win fix */ +} + +#tabs li a:hover { + + cursor: pointer; + text-decoration:underline; +} + +#tabs > li a { width: auto; } /* Rest of IE/Win fix */ + +/* Commented Backslash Hack hides rule from IE5-Mac \*/ +#tabs a { float: none; } +/* End IE5-Mac hack */ + +#top .header .current { + background-color: #4C6C8F; + background-image: url(images/rc-t-r-5-1header-2tab-selected-3tab-selected.png); + background-repeat: no-repeat; + background-position: top right; +} +#top .header .current a { + font-weight: bold; + padding-bottom: 5px; + color: white; + background-image: url(images/rc-t-l-5-1header-2tab-selected-3tab-selected.png); + background-repeat: no-repeat; + background-position: top left; +} +#publishedStrip { + padding-right: 10px; + padding-left: 20px; + padding-top: 3px; + padding-bottom:3px; + color: #ffffff; + font-size : 60%; + font-weight: bold; + background-color: #4C6C8F; + text-align:right; +} + +#level2tabs { +margin: 0; +float:left; +position:relative; + +} + + + +#level2tabs a:hover { + + cursor: pointer; + text-decoration:underline; + +} + +#level2tabs a{ + + cursor: pointer; + text-decoration:none; + background-image: url('images/chapter.gif'); + background-repeat: no-repeat; + background-position: center left; + padding-left: 6px; + margin-left: 6px; +} + +/* +* border-top: solid #4C6C8F 15px; +*/ +#main { + position: relative; + background: white; + clear:both; +} +#main .breadtrail { + clear:both; + position: relative; + background: #CFDCED; + color: black; + border-bottom: solid 1px black; + border-top: solid 1px black; + padding: 0px 180px; + font-size: 75%; + z-index:10; +} +/** +* Round corner +*/ +#roundtop { + background-image: url(images/rc-t-r-15-1body-2menu-3menu.png); + background-repeat: no-repeat; + background-position: top right; +} + +#roundbottom { + background-image: url(images/rc-b-r-15-1body-2menu-3menu.png); + background-repeat: no-repeat; + background-position: top right; +} + +img.corner { + width: 15px; + height: 15px; + border: none; + display: block !important; +} + +.roundtopsmall { + background-image: url(images/rc-t-r-5-1header-2searchbox-3searchbox.png); + background-repeat: no-repeat; + background-position: top right; +} + +#roundbottomsmall { + background-image: url(images/rc-b-r-5-1header-2tab-selected-3tab-selected.png); + background-repeat: no-repeat; + background-position: top right; +} + +img.cornersmall { + width: 5px; + height: 5px; + border: none; + display: block !important; +} +/** + * Side menu + */ +#menu a { font-weight: normal; text-decoration: none;} +#menu a:visited { font-weight: normal; } +#menu a:active { font-weight: normal; } +#menu a:hover { font-weight: normal; text-decoration:underline;} + +#menuarea { width:10em;} +#menu { + position: relative; + float: left; + width: 160px; + padding-top: 0px; + top:-18px; + left:10px; + z-index: 20; + background-color: #f90; + font-size : 70%; + +} + +.menutitle { + cursor:pointer; + padding: 3px 12px; + margin-left: 10px; + background-image: url('images/chapter.gif'); + background-repeat: no-repeat; + background-position: center left; + font-weight : bold; + + +} + +.menutitle:hover{text-decoration:underline;cursor: pointer;} + +#menu .menuitemgroup { + margin: 0px 0px 6px 8px; + padding: 0px; + font-weight : bold; } + +#menu .selectedmenuitemgroup{ + margin: 0px 0px 0px 8px; + padding: 0px; + font-weight : normal; + + } + +#menu .menuitem { + padding: 2px 0px 1px 13px; + background-image: url('images/page.gif'); + background-repeat: no-repeat; + background-position: center left; + font-weight : normal; + margin-left: 10px; +} + +#menu .menupage { + margin: 2px 0px 1px 10px; + padding: 0px 3px 0px 12px; + background-image: url('images/page.gif'); + background-repeat: no-repeat; + background-position: center left; + font-style : normal; +} +#menu .menupagetitle { + padding: 0px 0px 0px 1px; + font-style : normal; + border-style: solid; + border-width: 1px; + margin-right: 10px; + +} +#menu .menupageitemgroup { + padding: 3px 0px 4px 6px; + font-style : normal; + border-bottom: 1px solid ; + border-left: 1px solid ; + border-right: 1px solid ; + margin-right: 10px; +} +#menu .menupageitem { + font-style : normal; + font-weight : normal; + border-width: 0px; + font-size : 90%; +} +#menu #credit { + text-align: center; +} +#menu #credit2 { + text-align: center; + padding: 3px 3px 3px 3px; + background-color: #ffffff; +} +#menu .searchbox { + text-align: center; +} +#menu .searchbox form { + padding: 3px 3px; + margin: 0; +} +#menu .searchbox input { + font-size: 100%; +} + +#content { + padding: 20px 20px 20px 180px; + margin: 0; + font : small Verdana, Helvetica, sans-serif; + font-size : 80%; +} + +#content ul { + margin: 0; + padding: 0 25px; +} +#content li { + padding: 0 5px; +} +#feedback { + color: black; + background: #CFDCED; + text-align:center; + margin-top: 5px; +} +#feedback #feedbackto { + font-size: 90%; + color: black; +} +#footer { + clear: both; + position: relative; /* IE bugfix (http://www.dracos.co.uk/web/css/ie6floatbug/) */ + width: 100%; + background: #CFDCED; + border-top: solid 1px #4C6C8F; + color: black; +} +#footer .copyright { + position: relative; /* IE bugfix cont'd */ + padding: 5px; + margin: 0; + width: 60%; +} +#footer .lastmodified { + position: relative; /* IE bugfix cont'd */ + float: right; + width: 30%; + padding: 5px; + margin: 0; + text-align: right; +} +#footer a { color: white; } + +#footer #logos { + text-align: left; +} + + +/** + * Misc Styles + */ + +acronym { cursor: help; } +.boxed { background-color: #a5b6c6;} +.underlined_5 {border-bottom: solid 5px #4C6C8F;} +.underlined_10 {border-bottom: solid 10px #4C6C8F;} +/* ==================== snail trail ============================ */ + +.trail { + position: relative; /* IE bugfix cont'd */ + font-size: 70%; + text-align: right; + float: right; + margin: -10px 5px 0px 5px; + padding: 0; +} + +#motd-area { + position:relative; + float:right; + width: 35%; + background-color: #f0f0ff; + border: solid 1px #4C6C8F; + margin: 0px 0px 10px 10px; + padding: 5px; +} + +#minitoc-area { + border-top: solid 1px #4C6C8F; + border-bottom: solid 1px #4C6C8F; + margin: 15px 10% 5px 15px; + /* margin-bottom: 15px; + margin-left: 15px; + margin-right: 10%;*/ + padding-bottom: 7px; + padding-top: 5px; +} +.minitoc { + list-style-image: url('images/current.gif'); + font-weight: normal; +} + +.abstract{ + text-align:justify; + } + +li p { + margin: 0; + padding: 0; +} + +.pdflink { + position: relative; /* IE bugfix cont'd */ + float: right; + margin: 0px 5px; + padding: 0; +} +.pdflink br { + margin-top: -10px; + padding-left: 1px; +} +.pdflink a { + display: block; + font-size: 70%; + text-align: center; + margin: 0; + padding: 0; +} + +.pdflink img { + display: block; + height: 16px; + width: 16px; +} +.xmllink { + position: relative; /* IE bugfix cont'd */ + float: right; + margin: 0px 5px; + padding: 0; +} +.xmllink br { + margin-top: -10px; + padding-left: 1px; +} +.xmllink a { + display: block; + font-size: 70%; + text-align: center; + margin: 0; + padding: 0; +} + +.xmllink img { + display: block; + height: 16px; + width: 16px; +} +.podlink { + position: relative; /* IE bugfix cont'd */ + float: right; + margin: 0px 5px; + padding: 0; +} +.podlink br { + margin-top: -10px; + padding-left: 1px; +} +.podlink a { + display: block; + font-size: 70%; + text-align: center; + margin: 0; + padding: 0; +} + +.podlink img { + display: block; + height: 16px; + width: 16px; +} + +.printlink { + position: relative; /* IE bugfix cont'd */ + float: right; +} +.printlink br { + margin-top: -10px; + padding-left: 1px; +} +.printlink a { + display: block; + font-size: 70%; + text-align: center; + margin: 0; + padding: 0; +} +.printlink img { + display: block; + height: 16px; + width: 16px; +} + +p.instruction { + display: list-item; + list-style-image: url('../images/instruction_arrow.png'); + list-style-position: outside; + margin-left: 2em; +} \ No newline at end of file diff --git a/docs/zookeeperAdmin.html b/docs/zookeeperAdmin.html new file mode 100644 index 0000000..d02522d --- /dev/null +++ b/docs/zookeeperAdmin.html @@ -0,0 +1,2231 @@ + + + + + + + +ZooKeeper Administrator's Guide + + + + + + + + + +
+ +
+Apache > ZooKeeper > ZooKeeper +
+ +
+ + + + + + + +
+
+  + +
+
+ + + + +
+
+
+
+ +
+ + +
+ +
+ +   +
+ + + + + +
+
+PDF -icon
+ PDF +
+

ZooKeeper Administrator's Guide

+

A Guide to Deployment and Administration

+ + + + + + + + + +

Deployment

+
+

This section contains information about deploying Zookeeper and + covers these topics:

+ +

The first two sections assume you are interested in installing + ZooKeeper in a production environment such as a datacenter. The final + section covers situations in which you are setting up ZooKeeper on a + limited basis - for evaluation, testing, or development - but not in a + production environment.

+ +

System Requirements

+ +

Supported Platforms

+

ZooKeeper consists of multiple components. Some components are + supported broadly, and other components are supported only on a smaller + set of platforms.

+
    + +
  • + +

    +Client is the Java client + library, used by applications to connect to a ZooKeeper ensemble. +

    + +
    • + +
  • + +

    +Server is the Java server + that runs on the ZooKeeper ensemble nodes.

    + +
    • + +
  • + +

    +Native Client is a client + implemented in C, similar to the Java client, used by applications + to connect to a ZooKeeper ensemble.

    + +
    • + +
  • + +

    +Contrib refers to multiple + optional add-on components.

    + +
    • + +
+

The following matrix describes the level of support committed for + running each component on different operating system platforms.

+ + + +Support Matrix + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Support Matrix
Operating SystemClientServerNative ClientContrib
GNU/LinuxDevelopment and ProductionDevelopment and ProductionDevelopment and ProductionDevelopment and Production
SolarisDevelopment and ProductionDevelopment and ProductionNot SupportedNot Supported
FreeBSDDevelopment and ProductionDevelopment and ProductionNot SupportedNot Supported
WindowsDevelopment and ProductionDevelopment and ProductionNot SupportedNot Supported
Mac OS XDevelopment OnlyDevelopment OnlyNot SupportedNot Supported
+

For any operating system not explicitly mentioned as supported in + the matrix, components may or may not work. The ZooKeeper community + will fix obvious bugs that are reported for other platforms, but there + is no full support.

+ +

Required Software

+

ZooKeeper runs in Java, release 1.6 or greater (JDK 6 or + greater). It runs as an ensemble of + ZooKeeper servers. Three ZooKeeper servers is the minimum + recommended size for an ensemble, and we also recommend that + they run on separate machines. At Yahoo!, ZooKeeper is + usually deployed on dedicated RHEL boxes, with dual-core + processors, 2GB of RAM, and 80GB IDE hard drives.

+ +

Clustered (Multi-Server) Setup

+

For reliable ZooKeeper service, you should deploy ZooKeeper in a + cluster known as an ensemble. As long as a majority + of the ensemble are up, the service will be available. Because Zookeeper + requires a majority, it is best to use an + odd number of machines. For example, with four machines ZooKeeper can + only handle the failure of a single machine; if two machines fail, the + remaining two machines do not constitute a majority. However, with five + machines ZooKeeper can handle the failure of two machines.

+
+
Note
+
+ +

+ As mentioned in the + ZooKeeper Getting Started Guide + , a minimum of three servers are required for a fault tolerant + clustered setup, and it is strongly recommended that you have an + odd number of servers. +

+ +

Usually three servers is more than enough for a production + install, but for maximum reliability during maintenance, you may + wish to install five servers. With three servers, if you perform + maintenance on one of them, you are vulnerable to a failure on one + of the other two servers during that maintenance. If you have five + of them running, you can take one down for maintenance, and know + that you're still OK if one of the other four suddenly fails. +

+ +

Your redundancy considerations should include all aspects of + your environment. If you have three ZooKeeper servers, but their + network cables are all plugged into the same network switch, then + the failure of that switch will take down your entire ensemble. +

+ +
+
+

Here are the steps to setting a server that will be part of an + ensemble. These steps should be performed on every host in the + ensemble:

+
    + +
  1. + +

    Install the Java JDK. You can use the native packaging system + for your system, or download the JDK from:

    + + +

    +http://java.sun.com/javase/downloads/index.jsp +

    + +
    2. + + +
  2. + +

    Set the Java heap size. This is very important to avoid + swapping, which will seriously degrade ZooKeeper performance. To + determine the correct value, use load tests, and make sure you are + well below the usage limit that would cause you to swap. Be + conservative - use a maximum heap size of 3GB for a 4GB + machine.

    + +
    3. + + +
  3. + +

    Install the ZooKeeper Server Package. It can be downloaded + from: +

    + +

    + + + http://zookeeper.apache.org/releases.html + + +

    + +
    4. + + +
  4. + +

    Create a configuration file. This file can be called anything. + Use the following settings as a starting point:

    + + +
    +tickTime=2000
+dataDir=/var/lib/zookeeper/
+clientPort=2181
+initLimit=5
+syncLimit=2
+server.1=zoo1:2888:3888
+server.2=zoo2:2888:3888
+server.3=zoo3:2888:3888
    + + +

    You can find the meanings of these and other configuration + settings in the section Configuration Parameters. A word + though about a few here:

    + + +

    Every machine that is part of the ZooKeeper ensemble should know + about every other machine in the ensemble. You accomplish this with + the series of lines of the form server.id=host:port:port. The parameters host and port are straightforward. You attribute the + server id to each machine by creating a file named + myid, one for each server, which resides in + that server's data directory, as specified by the configuration file + parameter dataDir.

    +
    5. + + +
  5. +

    The myid file + consists of a single line containing only the text of that machine's + id. So myid of server 1 would contain the text + "1" and nothing else. The id must be unique within the + ensemble and should have a value between 1 and 255.

    + +
    6. + + +
  6. + +

    If your configuration file is set up, you can start a + ZooKeeper server:

    + + +

    +$ java -cp zookeeper.jar:lib/slf4j-api-1.6.1.jar:lib/slf4j-log4j12-1.6.1.jar:lib/log4j-1.2.15.jar:conf \ + org.apache.zookeeper.server.quorum.QuorumPeerMain zoo.cfg + +

    + + +

    QuorumPeerMain starts a ZooKeeper server, + JMX + management beans are also registered which allows + management through a JMX management console. + The ZooKeeper JMX + document contains details on managing ZooKeeper with JMX. +

    + + +

    See the script bin/zkServer.sh, + which is included in the release, for an example + of starting server instances.

    + + +
    7. + + +
  7. + +

    Test your deployment by connecting to the hosts:

    + + +

    In Java, you can run the following command to execute + simple operations:

    + + +

    +$ bin/zkCli.sh -server 127.0.0.1:2181 +

    + +
    8. + +
+ +

Single Server and Developer Setup

+

If you want to setup ZooKeeper for development purposes, you will + probably want to setup a single server instance of ZooKeeper, and then + install either the Java or C client-side libraries and bindings on your + development machine.

+

The steps to setting up a single server instance are the similar + to the above, except the configuration file is simpler. You can find the + complete instructions in the Installing and + Running ZooKeeper in Single Server Mode section of the ZooKeeper Getting Started + Guide.

+

For information on installing the client side libraries, refer to + the Bindings + section of the ZooKeeper + Programmer's Guide.

+
+ + + +

Administration

+
+

This section contains information about running and maintaining + ZooKeeper and covers these topics:

+ + +

Designing a ZooKeeper Deployment

+

The reliablity of ZooKeeper rests on two basic assumptions.

+
    + +
  1. +

    Only a minority of servers in a deployment + will fail. Failure in this context + means a machine crash, or some error in the network that + partitions a server off from the majority.

    + +
    2. + +
  2. +

    Deployed machines operate correctly. To + operate correctly means to execute code correctly, to have + clocks that work properly, and to have storage and network + components that perform consistently.

    + +
    3. + +
+

The sections below contain considerations for ZooKeeper + administrators to maximize the probability for these assumptions + to hold true. Some of these are cross-machines considerations, + and others are things you should consider for each and every + machine in your deployment.

+ +

Cross Machine Requirements

+

For the ZooKeeper service to be active, there must be a + majority of non-failing machines that can communicate with + each other. To create a deployment that can tolerate the + failure of F machines, you should count on deploying 2xF+1 + machines. Thus, a deployment that consists of three machines + can handle one failure, and a deployment of five machines can + handle two failures. Note that a deployment of six machines + can only handle two failures since three machines is not a + majority. For this reason, ZooKeeper deployments are usually + made up of an odd number of machines.

+

To achieve the highest probability of tolerating a failure + you should try to make machine failures independent. For + example, if most of the machines share the same switch, + failure of that switch could cause a correlated failure and + bring down the service. The same holds true of shared power + circuits, cooling systems, etc.

+ +

Single Machine Requirements

+

If ZooKeeper has to contend with other applications for + access to resourses like storage media, CPU, network, or + memory, its performance will suffer markedly. ZooKeeper has + strong durability guarantees, which means it uses storage + media to log changes before the operation responsible for the + change is allowed to complete. You should be aware of this + dependency then, and take great care if you want to ensure + that ZooKeeper operations aren’t held up by your media. Here + are some things you can do to minimize that sort of + degradation: +

+
    + +
  • + +

    ZooKeeper's transaction log must be on a dedicated + device. (A dedicated partition is not enough.) ZooKeeper + writes the log sequentially, without seeking Sharing your + log device with other processes can cause seeks and + contention, which in turn can cause multi-second + delays.

    + +
    • + + +
  • + +

    Do not put ZooKeeper in a situation that can cause a + swap. In order for ZooKeeper to function with any sort of + timeliness, it simply cannot be allowed to swap. + Therefore, make certain that the maximum heap size given + to ZooKeeper is not bigger than the amount of real memory + available to ZooKeeper. For more on this, see + Things to Avoid + below.

    + +
    • + +
+ +

Provisioning

+

+ +

Things to Consider: ZooKeeper Strengths and Limitations

+

+ +

Administering

+

+ +

Maintenance

+

Little long term maintenance is required for a ZooKeeper + cluster however you must be aware of the following:

+ +

Ongoing Data Directory Cleanup

+

The ZooKeeper Data + Directory contains files which are a persistent copy + of the znodes stored by a particular serving ensemble. These + are the snapshot and transactional log files. As changes are + made to the znodes these changes are appended to a + transaction log. Occasionally, when a log grows large, a + snapshot of the current state of all znodes will be written + to the filesystem and a new transaction log file is created + for future transactions. During snapshotting, ZooKeeper may + continue appending incoming transactions to the old log file. + Therefore, some transactions which are newer than a snapshot + may be found in the last transaction log preceding the + snapshot. +

+

A ZooKeeper server will not remove + old snapshots and log files when using the default + configuration (see autopurge below), this is the + responsibility of the operator. Every serving environment is + different and therefore the requirements of managing these + files may differ from install to install (backup for example). +

+

The PurgeTxnLog utility implements a simple retention + policy that administrators can use. The API docs contains details on + calling conventions (arguments, etc...). +

+

In the following example the last count snapshots and + their corresponding logs are retained and the others are + deleted. The value of <count> should typically be + greater than 3 (although not required, this provides 3 backups + in the unlikely event a recent log has become corrupted). This + can be run as a cron job on the ZooKeeper server machines to + clean up the logs daily.

+
 java -cp zookeeper.jar:lib/slf4j-api-1.6.1.jar:lib/slf4j-log4j12-1.6.1.jar:lib/log4j-1.2.15.jar:conf org.apache.zookeeper.server.PurgeTxnLog <dataDir> <snapDir> -n <count>
+

Automatic purging of the snapshots and corresponding + transaction logs was introduced in version 3.4.0 and can be + enabled via the following configuration parameters autopurge.snapRetainCount and autopurge.purgeInterval. For more on + this, see Advanced Configuration + below.

+ +

Debug Log Cleanup (log4j)

+

See the section on logging in this document. It is + expected that you will setup a rolling file appender using the + in-built log4j feature. The sample configuration file in the + release tar's conf/log4j.properties provides an example of + this. +

+ +

Supervision

+

You will want to have a supervisory process that manages + each of your ZooKeeper server processes (JVM). The ZK server is + designed to be "fail fast" meaning that it will shutdown + (process exit) if an error occurs that it cannot recover + from. As a ZooKeeper serving cluster is highly reliable, this + means that while the server may go down the cluster as a whole + is still active and serving requests. Additionally, as the + cluster is "self healing" the failed server once restarted will + automatically rejoin the ensemble w/o any manual + interaction.

+

Having a supervisory process such as daemontools or + SMF + (other options for supervisory process are also available, it's + up to you which one you would like to use, these are just two + examples) managing your ZooKeeper server ensures that if the + process does exit abnormally it will automatically be restarted + and will quickly rejoin the cluster.

+ +

Monitoring

+

The ZooKeeper service can be monitored in one of two + primary ways; 1) the command port through the use of 4 letter words and 2) JMX. See the appropriate section for + your environment/requirements.

+ +

Logging

+

ZooKeeper uses log4j version 1.2 as + its logging infrastructure. The ZooKeeper default log4j.properties + file resides in the conf directory. Log4j requires that + log4j.properties either be in the working directory + (the directory from which ZooKeeper is run) or be accessible from the classpath.

+

For more information, see + Log4j Default Initialization Procedure + of the log4j manual.

+ +

Troubleshooting

+
+ +
+ Server not coming up because of file corruption +
+
+

A server might not be able to read its database and fail to come up because of + some file corruption in the transaction logs of the ZooKeeper server. You will + see some IOException on loading ZooKeeper database. In such a case, + make sure all the other servers in your ensemble are up and working. Use "stat" + command on the command port to see if they are in good health. After you have verified that + all the other servers of the ensemble are up, you can go ahead and clean the database + of the corrupt server. Delete all the files in datadir/version-2 and datalogdir/version-2/. + Restart the server. +

+
+ +
+ +

Configuration Parameters

+

ZooKeeper's behavior is governed by the ZooKeeper configuration + file. This file is designed so that the exact same file can be used by + all the servers that make up a ZooKeeper server assuming the disk + layouts are the same. If servers use different configuration files, care + must be taken to ensure that the list of servers in all of the different + configuration files match.

+ +

Minimum Configuration

+

Here are the minimum configuration keywords that must be defined + in the configuration file:

+
+ +
+clientPort +
+
+

the port to listen for client connections; that is, the + port that clients attempt to connect to.

+
+ + +
+dataDir +
+
+

the location where ZooKeeper will store the in-memory + database snapshots and, unless specified otherwise, the + transaction log of updates to the database.

+
+
Note
+
+ +

Be careful where you put the transaction log. A + dedicated transaction log device is key to consistent good + performance. Putting the log on a busy device will adversely + effect performance.

+ +
+
+
+ + +
+tickTime +
+
+

the length of a single tick, which is the basic time unit + used by ZooKeeper, as measured in milliseconds. It is used to + regulate heartbeats, and timeouts. For example, the minimum + session timeout will be two ticks.

+
+ +
+ +

Advanced Configuration

+

The configuration settings in the section are optional. You can + use them to further fine tune the behaviour of your ZooKeeper servers. + Some can also be set using Java system properties, generally of the + form zookeeper.keyword. The exact system + property, when available, is noted below.

+
+ +
+dataLogDir +
+
+

(No Java system property)

+

This option will direct the machine to write the + transaction log to the dataLogDir rather than the dataDir. This allows a dedicated log + device to be used, and helps avoid competition between logging + and snaphots.

+
+
Note
+
+ +

Having a dedicated log device has a large impact on + throughput and stable latencies. It is highly recommened to + dedicate a log device and set dataLogDir to point to a directory on + that device, and then make sure to point dataDir to a directory + not residing on that device.

+ +
+
+
+ + +
+globalOutstandingLimit +
+
+

(Java system property: zookeeper.globalOutstandingLimit.)

+

Clients can submit requests faster than ZooKeeper can + process them, especially if there are a lot of clients. To + prevent ZooKeeper from running out of memory due to queued + requests, ZooKeeper will throttle clients so that there is no + more than globalOutstandingLimit outstanding requests in the + system. The default limit is 1,000.

+
+ + +
+preAllocSize +
+
+

(Java system property: zookeeper.preAllocSize)

+

To avoid seeks ZooKeeper allocates space in the + transaction log file in blocks of preAllocSize kilobytes. The + default block size is 64M. One reason for changing the size of + the blocks is to reduce the block size if snapshots are taken + more often. (Also, see snapCount).

+
+ + +
+snapCount +
+
+

(Java system property: zookeeper.snapCount)

+

ZooKeeper records its transactions using snapshots and + a transaction log (think write-ahead log).The number of + transactions recorded in the transaction log before a snapshot + can be taken (and the transaction log rolled) is determined + by snapCount. In order to prevent all of the machines in the quorum + from taking a snapshot at the same time, each ZooKeeper server + will take a snapshot when the number of transactions in the transaction log + reaches a runtime generated random value in the [snapCount/2+1, snapCount] + range.The default snapCount is 100,000.

+
+ + +
+maxClientCnxns +
+
+

(No Java system property)

+

Limits the number of concurrent connections (at the socket + level) that a single client, identified by IP address, may make + to a single member of the ZooKeeper ensemble. This is used to + prevent certain classes of DoS attacks, including file + descriptor exhaustion. The default is 60. Setting this to 0 + entirely removes the limit on concurrent connections.

+
+ + +
+clientPortAddress +
+
+

+New in 3.3.0: the + address (ipv4, ipv6 or hostname) to listen for client + connections; that is, the address that clients attempt + to connect to. This is optional, by default we bind in + such a way that any connection to the clientPort for any + address/interface/nic on the server will be + accepted.

+
+ + +
+minSessionTimeout +
+
+

(No Java system property)

+

+New in 3.3.0: the + minimum session timeout in milliseconds that the server + will allow the client to negotiate. Defaults to 2 times + the tickTime.

+
+ + +
+maxSessionTimeout +
+
+

(No Java system property)

+

+New in 3.3.0: the + maximum session timeout in milliseconds that the server + will allow the client to negotiate. Defaults to 20 times + the tickTime.

+
+ + +
+fsync.warningthresholdms +
+
+

(Java system property: zookeeper.fsync.warningthresholdms)

+

+New in 3.3.4: A + warning message will be output to the log whenever an + fsync in the Transactional Log (WAL) takes longer than + this value. The values is specified in milliseconds and + defaults to 1000. This value can only be set as a + system property.

+
+ + +
+autopurge.snapRetainCount +
+
+

(No Java system property)

+

+New in 3.4.0: + When enabled, ZooKeeper auto purge feature retains + the autopurge.snapRetainCount most + recent snapshots and the corresponding transaction logs in the + dataDir and dataLogDir respectively and deletes the rest. + Defaults to 3. Minimum value is 3.

+
+ + +
+autopurge.purgeInterval +
+
+

(No Java system property)

+

+New in 3.4.0: The + time interval in hours for which the purge task has to + be triggered. Set to a positive integer (1 and above) + to enable the auto purging. Defaults to 0.

+
+ + +
+syncEnabled +
+
+

(Java system property: zookeeper.observer.syncEnabled)

+

+New in 3.4.6, 3.5.0: + The observers now log transaction and write snapshot to disk + by default like the participants. This reduces the recovery time + of the observers on restart. Set to "false" to disable this + feature. Default is "true"

+
+ +
+ +

Cluster Options

+

The options in this section are designed for use with an ensemble + of servers -- that is, when deploying clusters of servers.

+
+ +
+electionAlg +
+
+

(No Java system property)

+

Election implementation to use. A value of "0" corresponds + to the original UDP-based version, "1" corresponds to the + non-authenticated UDP-based version of fast leader election, "2" + corresponds to the authenticated UDP-based version of fast + leader election, and "3" corresponds to TCP-based version of + fast leader election. Currently, algorithm 3 is the default

+
+
Note
+
+ +

The implementations of leader election 0, 1, and 2 are now + deprecated . We have the intention + of removing them in the next release, at which point only the + FastLeaderElection will be available. +

+ +
+
+
+ + +
+initLimit +
+
+

(No Java system property)

+

Amount of time, in ticks (see tickTime), to allow followers to + connect and sync to a leader. Increased this value as needed, if + the amount of data managed by ZooKeeper is large.

+
+ + +
+leaderServes +
+
+

(Java system property: zookeeper.leaderServes)

+

Leader accepts client connections. Default value is "yes". + The leader machine coordinates updates. For higher update + throughput at thes slight expense of read throughput the leader + can be configured to not accept clients and focus on + coordination. The default to this option is yes, which means + that a leader will accept client connections.

+
+
Note
+
+ +

Turning on leader selection is highly recommended when + you have more than three ZooKeeper servers in an ensemble.

+ +
+
+
+ + +
+server.x=[hostname]:nnnnn[:nnnnn], etc +
+
+

(No Java system property)

+

servers making up the ZooKeeper ensemble. When the server + starts up, it determines which server it is by looking for the + file myid in the data directory. That file + contains the server number, in ASCII, and it should match + x in server.x in the left hand side of this + setting.

+

The list of servers that make up ZooKeeper servers that is + used by the clients must match the list of ZooKeeper servers + that each ZooKeeper server has.

+

There are two port numbers nnnnn. + The first followers use to connect to the leader, and the second is for + leader election. The leader election port is only necessary if electionAlg + is 1, 2, or 3 (default). If electionAlg is 0, then the second port is not + necessary. If you want to test multiple servers on a single machine, then + different ports can be used for each server.

+
+ + +
+syncLimit +
+
+

(No Java system property)

+

Amount of time, in ticks (see tickTime), to allow followers to sync + with ZooKeeper. If followers fall too far behind a leader, they + will be dropped.

+
+ + +
+group.x=nnnnn[:nnnnn] +
+
+

(No Java system property)

+

Enables a hierarchical quorum construction."x" is a group identifier + and the numbers following the "=" sign correspond to server identifiers. + The left-hand side of the assignment is a colon-separated list of server + identifiers. Note that groups must be disjoint and the union of all groups + must be the ZooKeeper ensemble.

+

You will find an example here + +

+
+ + +
+weight.x=nnnnn +
+
+

(No Java system property)

+

Used along with "group", it assigns a weight to a server when + forming quorums. Such a value corresponds to the weight of a server + when voting. There are a few parts of ZooKeeper that require voting + such as leader election and the atomic broadcast protocol. By default + the weight of server is 1. If the configuration defines groups, but not + weights, then a value of 1 will be assigned to all servers. +

+

You will find an example here + +

+
+ + +
+cnxTimeout +
+
+

(Java system property: zookeeper.cnxTimeout)

+

Sets the timeout value for opening connections for leader election notifications. + Only applicable if you are using electionAlg 3. +

+
+
Note
+
+ +

Default value is 5 seconds.

+ +
+
+
+ + +
+4lw.commands.whitelist +
+
+

(Java system property: zookeeper.4lw.commands.whitelist)

+

+New in 3.4.10: + This property contains a list of comma separated + Four Letter Words commands. It is introduced + to provide fine grained control over the set of commands ZooKeeper can execute, + so users can turn off certain commands if necessary. + By default it contains all supported four letter word commands except "wchp" and "wchc", + if the property is not specified. If the property is specified, then only commands listed + in the whitelist are enabled. +

+

Here's an example of the configuration that enables stat, ruok, conf, and isro + command while disabling the rest of Four Letter Words command:

+
+                4lw.commands.whitelist=stat, ruok, conf, isro
+
+

Users can also use asterisk option so they don't have to include every command one by one in the list. + As an example, this will enable all four letter word commands: +

+
+                4lw.commands.whitelist=*
+
+
+ + +
+ipReachableTimeout +
+
+

(Java system property: zookeeper.ipReachableTimeout)

+

+New in 3.4.11: + Set this timeout value for IP addresses reachable checking when hostname is resolved, as mesured in + milliseconds. + By default, ZooKeeper will use the first IP address of the hostname(without any reachable checking). + When zookeeper.ipReachableTimeout is set(larger than 0), ZooKeeper will will try to pick up the first + IP address which is reachable. This is done by calling Java API InetAddress.isReachable(long timeout) + function, in which this timeout value is used. If none of such reachable IP address can be found, the + first IP address of the hostname will be used anyway. +

+
+ + +
+tcpKeepAlive +
+
+

(Java system property: zookeeper.tcpKeepAlive)

+

+New in 3.4.11: + Setting this to true sets the TCP keepAlive flag on the + sockets used by quorum members to perform elections. + This will allow for connections between quorum members to + remain up when there is network infrastructure that may + otherwise break them. Some NATs and firewalls may terminate + or lose state for long running or idle connections.

+

Enabling this option relies on OS level settings to work + properly, check your operating system's options regarding TCP + keepalive for more information. Defaults to + false. +

+
+ + +
+

+ +

Authentication & Authorization Options

+

The options in this section allow control over + authentication/authorization performed by the service.

+
+ +
+zookeeper.DigestAuthenticationProvider.superDigest +
+
+

(Java system property only: zookeeper.DigestAuthenticationProvider.superDigest)

+

By default this feature is disabled +

+

+New in 3.2: + Enables a ZooKeeper ensemble administrator to access the + znode hierarchy as a "super" user. In particular no ACL + checking occurs for a user authenticated as + super.

+

org.apache.zookeeper.server.auth.DigestAuthenticationProvider + can be used to generate the superDigest, call it with + one parameter of "super:<password>". Provide the + generated "super:<data>" as the system property value + when starting each server of the ensemble.

+

When authenticating to a ZooKeeper server (from a + ZooKeeper client) pass a scheme of "digest" and authdata + of "super:<password>". Note that digest auth passes + the authdata in plaintext to the server, it would be + prudent to use this authentication method only on + localhost (not over the network) or over an encrypted + connection.

+
+ + +
+isro +
+
+

+New in 3.4.0: Tests if + server is running in read-only mode. The server will respond with + "ro" if in read-only mode or "rw" if not in read-only mode.

+
+ + +
+gtmk +
+
+

Gets the current trace mask as a 64-bit signed long value in + decimal format. See stmk for an explanation of + the possible values.

+
+ + +
+stmk +
+
+

Sets the current trace mask. The trace mask is 64 bits, + where each bit enables or disables a specific category of trace + logging on the server. Log4J must be configured to enable + TRACE level first in order to see trace logging + messages. The bits of the trace mask correspond to the following + trace logging categories.

+ + + +Trace Mask Bit Values + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Trace Mask Bit Values
0b0000000000Unused, reserved for future use.
0b0000000010Logs client requests, excluding ping + requests.
0b0000000100Unused, reserved for future use.
0b0000001000Logs client ping requests.
0b0000010000Logs packets received from the quorum peer that is + the current leader, excluding ping requests.
0b0000100000Logs addition, removal and validation of client + sessions.
0b0001000000Logs delivery of watch events to client + sessions.
0b0010000000Logs ping packets received from the quorum peer + that is the current leader.
0b0100000000Unused, reserved for future use.
0b1000000000Unused, reserved for future use.
+

All remaining bits in the 64-bit value are unused and + reserved for future use. Multiple trace logging categories are + specified by calculating the bitwise OR of the documented values. + The default trace mask is 0b0100110010. Thus, by default, trace + logging includes client requests, packets received from the + leader and sessions.

+

To set a different trace mask, send a request containing the + stmk four-letter word followed by the trace + mask represented as a 64-bit signed long value. This example uses + the Perl pack function to construct a trace + mask that enables all trace logging categories described above and + convert it to a 64-bit signed long value with big-endian byte + order. The result is appended to stmk and sent + to the server using netcat. The server responds with the new + trace mask in decimal format.

+
$ perl -e "print 'stmk', pack('q>', 0b0011111010)" | nc localhost 2181
+250
+
+
+ +
+ +

Experimental Options/Features

+

New features that are currently considered experimental.

+
+ +
+Read Only Mode Server +
+
+

(Java system property: readonlymode.enabled)

+

+New in 3.4.0: + Setting this value to true enables Read Only Mode server + support (disabled by default). ROM allows clients + sessions which requested ROM support to connect to the + server even when the server might be partitioned from + the quorum. In this mode ROM clients can still read + values from the ZK service, but will be unable to write + values and see changes from other clients. See + ZOOKEEPER-784 for more details. +

+
+ + +
+ +

Unsafe Options

+

The following options can be useful, but be careful when you use + them. The risk of each is explained along with the explanation of what + the variable does.

+
+ +
+forceSync +
+
+

(Java system property: zookeeper.forceSync)

+

Requires updates to be synced to media of the transaction + log before finishing processing the update. If this option is + set to no, ZooKeeper will not require updates to be synced to + the media.

+
+ + +
+jute.maxbuffer: +
+
+

(Java system property: + jute.maxbuffer)

+

This option can only be set as a Java system property. + There is no zookeeper prefix on it. It specifies the maximum + size of the data that can be stored in a znode. The default is + 0xfffff, or just under 1M. If this option is changed, the system + property must be set on all servers and clients otherwise + problems will arise. This is really a sanity check. ZooKeeper is + designed to store data on the order of kilobytes in size.

+
+ + +
+skipACL +
+
+

(Java system property: zookeeper.skipACL)

+

Skips ACL checks. This results in a boost in throughput, + but opens up full access to the data tree to everyone.

+
+ + +
+quorumListenOnAllIPs +
+
+

When set to true the ZooKeeper server will listen + for connections from its peers on all available IP addresses, + and not only the address configured in the server list of the + configuration file. It affects the connections handling the + ZAB protocol and the Fast Leader Election protocol. Default + value is false.

+
+ + +
+ +

Communication using the Netty framework

+

+New in + 3.4: Netty + is an NIO based client/server communication framework, it + simplifies (over NIO being used directly) many of the + complexities of network level communication for java + applications. Additionally the Netty framework has built + in support for encryption (SSL) and authentication + (certificates). These are optional features and can be + turned on or off individually. +

+

Prior to version 3.4 ZooKeeper has always used NIO + directly, however in versions 3.4 and later Netty is + supported as an option to NIO (replaces). NIO continues to + be the default, however Netty based communication can be + used in place of NIO by setting the environment variable + "zookeeper.serverCnxnFactory" to + "org.apache.zookeeper.server.NettyServerCnxnFactory". You + have the option of setting this on either the client(s) or + server(s), typically you would want to set this on both, + however that is at your discretion. +

+

+ TBD - tuning options for netty - currently there are none that are netty specific but we should add some. Esp around max bound on the number of reader worker threads netty creates. +

+

+ TBD - how to manage encryption +

+

+ TBD - how to manage certificates +

+ +

ZooKeeper Commands: The Four Letter Words

+

ZooKeeper responds to a small set of commands. Each command is + composed of four letters. You issue the commands to ZooKeeper via telnet + or nc, at the client port.

+

Three of the more interesting commands: "stat" gives some + general information about the server and connected clients, + while "srvr" and "cons" give extended details on server and + connections respectively.

+
+ +
+conf +
+
+

+New in 3.3.0: Print + details about serving configuration.

+
+ + +
+cons +
+
+

+New in 3.3.0: List + full connection/session details for all clients connected + to this server. Includes information on numbers of packets + received/sent, session id, operation latencies, last + operation performed, etc...

+
+ + +
+crst +
+
+

+New in 3.3.0: Reset + connection/session statistics for all connections.

+
+ + +
+dump +
+
+

Lists the outstanding sessions and ephemeral nodes. This + only works on the leader.

+
+ + +
+envi +
+
+

Print details about serving environment

+
+ + +
+ruok +
+
+

Tests if server is running in a non-error state. The server + will respond with imok if it is running. Otherwise it will not + respond at all.

+

A response of "imok" does not necessarily indicate that the + server has joined the quorum, just that the server process is active + and bound to the specified client port. Use "stat" for details on + state wrt quorum and client connection information.

+
+ + +
+srst +
+
+

Reset server statistics.

+
+ + +
+srvr +
+
+

+New in 3.3.0: Lists + full details for the server.

+
+ + +
+stat +
+
+

Lists brief details for the server and connected + clients.

+
+ + +
+wchs +
+
+

+New in 3.3.0: Lists + brief information on watches for the server.

+
+ + +
+wchc +
+
+

+New in 3.3.0: Lists + detailed information on watches for the server, by + session. This outputs a list of sessions(connections) + with associated watches (paths). Note, depending on the + number of watches this operation may be expensive (ie + impact server performance), use it carefully.

+
+ + +
+wchp +
+
+

+New in 3.3.0: Lists + detailed information on watches for the server, by path. + This outputs a list of paths (znodes) with associated + sessions. Note, depending on the number of watches this + operation may be expensive (ie impact server performance), + use it carefully.

+
+ + + +
+mntr +
+
+

+New in 3.4.0: Outputs a list + of variables that could be used for monitoring the health of the cluster.

+
$ echo mntr | nc localhost 2185
+
+zk_version  3.4.0
+zk_avg_latency  0
+zk_max_latency  0
+zk_min_latency  0
+zk_packets_received 70
+zk_packets_sent 69
+zk_outstanding_requests 0
+zk_server_state leader
+zk_znode_count   4
+zk_watch_count  0
+zk_ephemerals_count 0
+zk_approximate_data_size    27
+zk_followers    4                   - only exposed by the Leader
+zk_synced_followers 4               - only exposed by the Leader
+zk_pending_syncs    0               - only exposed by the Leader
+zk_open_file_descriptor_count 23    - only available on Unix platforms
+zk_max_file_descriptor_count 1024   - only available on Unix platforms
+zk_fsync_threshold_exceed_count	0
+
+

The output is compatible with java properties format and the content + may change over time (new keys added). Your scripts should expect changes.

+

ATTENTION: Some of the keys are platform specific and some of the keys are only exported by the Leader.

+

The output contains multiple lines with the following format:

+
key \t value
+
+ +
+

Here's an example of the ruok + command:

+
$ echo ruok | nc 127.0.0.1 5111
+imok
+
+ +

Data File Management

+

ZooKeeper stores its data in a data directory and its transaction + log in a transaction log directory. By default these two directories are + the same. The server can (and should) be configured to store the + transaction log files in a separate directory than the data files. + Throughput increases and latency decreases when transaction logs reside + on a dedicated log devices.

+ +

The Data Directory

+

This directory has two files in it:

+
    + +
  • + +

    +myid - contains a single integer in + human readable ASCII text that represents the server id.

    + +
    • + + +
  • + +

    +snapshot.<zxid> - holds the fuzzy + snapshot of a data tree.

    + +
    • + +
+

Each ZooKeeper server has a unique id. This id is used in two + places: the myid file and the configuration file. + The myid file identifies the server that + corresponds to the given data directory. The configuration file lists + the contact information for each server identified by its server id. + When a ZooKeeper server instance starts, it reads its id from the + myid file and then, using that id, reads from the + configuration file, looking up the port on which it should + listen.

+

The snapshot files stored in the data + directory are fuzzy snapshots in the sense that during the time the + ZooKeeper server is taking the snapshot, updates are occurring to the + data tree. The suffix of the snapshot file names + is the zxid, the ZooKeeper transaction id, of the + last committed transaction at the start of the snapshot. Thus, the + snapshot includes a subset of the updates to the data tree that + occurred while the snapshot was in process. The snapshot, then, may + not correspond to any data tree that actually existed, and for this + reason we refer to it as a fuzzy snapshot. Still, ZooKeeper can + recover using this snapshot because it takes advantage of the + idempotent nature of its updates. By replaying the transaction log + against fuzzy snapshots ZooKeeper gets the state of the system at the + end of the log.

+ +

The Log Directory

+

The Log Directory contains the ZooKeeper transaction logs. + Before any update takes place, ZooKeeper ensures that the transaction + that represents the update is written to non-volatile storage. A new + log file is started when the number of transactions written to the + current log file reaches a (variable) threshold. The threshold is + computed using the same parameter which influences the frequency of + snapshotting (see snapCount above). The log file's suffix is the first + zxid written to that log.

+ +

File Management

+

The format of snapshot and log files does not change between + standalone ZooKeeper servers and different configurations of + replicated ZooKeeper servers. Therefore, you can pull these files from + a running replicated ZooKeeper server to a development machine with a + stand-alone ZooKeeper server for trouble shooting.

+

Using older log and snapshot files, you can look at the previous + state of ZooKeeper servers and even restore that state. The + LogFormatter class allows an administrator to look at the transactions + in a log.

+

The ZooKeeper server creates snapshot and log files, but + never deletes them. The retention policy of the data and log + files is implemented outside of the ZooKeeper server. The + server itself only needs the latest complete fuzzy snapshot, all log + files following it, and the last log file preceding it. The latter + requirement is necessary to include updates which happened after this + snapshot was started but went into the existing log file at that time. + This is possible because snapshotting and rolling over of logs + proceed somewhat independently in ZooKeeper. See the + maintenance section in + this document for more details on setting a retention policy + and maintenance of ZooKeeper storage. +

+
+
Note
+
+ +

The data stored in these files is not encrypted. In the case of + storing sensitive data in ZooKeeper, necessary measures need to be + taken to prevent unauthorized access. Such measures are external to + ZooKeeper (e.g., control access to the files) and depend on the + individual settings in which it is being deployed.

+ +
+
+ +

Recovery - TxnLogToolkit

+

TxnLogToolkit is a command line tool shipped with ZooKeeper which + is capable of recovering transaction log entries with broken CRC.

+

Running it without any command line parameters or with the "-h,--help" + argument, it outputs the following help page:

+
+          $ bin/zkTxnLogToolkit.sh
+
+          usage: TxnLogToolkit [-dhrv] txn_log_file_name
+          -d,--dump      Dump mode. Dump all entries of the log file. (this is the default)
+          -h,--help      Print help message
+          -r,--recover   Recovery mode. Re-calculate CRC for broken entries.
+          -v,--verbose   Be verbose in recovery mode: print all entries, not just fixed ones.
+          -y,--yes       Non-interactive mode: repair all CRC errors without asking
+
+

The default behaviour is safe: it dumps the entries of the given + transaction log file to the screen: (same as using '-d,--dump' parameter)

+
+          $ bin/zkTxnLogToolkit.sh log.100000001
+          ZooKeeper Transactional Log File with dbid 0 txnlog format version 2
+          4/5/18 2:15:58 PM CEST session 0x16295bafcc40000 cxid 0x0 zxid 0x100000001 createSession 30000
+          CRC ERROR - 4/5/18 2:16:05 PM CEST session 0x16295bafcc40000 cxid 0x1 zxid 0x100000002 closeSession null
+          4/5/18 2:16:05 PM CEST session 0x16295bafcc40000 cxid 0x1 zxid 0x100000002 closeSession null
+          4/5/18 2:16:12 PM CEST session 0x26295bafcc90000 cxid 0x0 zxid 0x100000003 createSession 30000
+          4/5/18 2:17:34 PM CEST session 0x26295bafcc90000 cxid 0x0 zxid 0x200000001 closeSession null
+          4/5/18 2:17:34 PM CEST session 0x16295bd23720000 cxid 0x0 zxid 0x200000002 createSession 30000
+          4/5/18 2:18:02 PM CEST session 0x16295bd23720000 cxid 0x2 zxid 0x200000003 create '/andor,#626262,v{s{31,s{'world,'anyone}}},F,1
+          EOF reached after 6 txns.
+
+

There's a CRC error in the 2nd entry of the above transaction log file. In dump + mode, the toolkit only prints this information to the screen without touching the original file. In + recovery mode (-r,--recover flag) the original file still remains + untouched and all transactions will be copied over to a new txn log file with ".fixed" suffix. It recalculates + CRC values and copies the calculated value, if it doesn't match the original txn entry. + By default, the tool works interactively: it asks for confirmation whenever CRC error encountered.

+
+          $ bin/zkTxnLogToolkit.sh -r log.100000001
+          ZooKeeper Transactional Log File with dbid 0 txnlog format version 2
+          CRC ERROR - 4/5/18 2:16:05 PM CEST session 0x16295bafcc40000 cxid 0x1 zxid 0x100000002 closeSession null
+          Would you like to fix it (Yes/No/Abort) ?
+
+

Answering Yes means the newly calculated CRC value will be outputted + to the new file. No means that the original CRC value will be copied over. + Abort will abort the entire operation and exits. + (In this case the ".fixed" will not be deleted and left in a half-complete state: contains only entries which + have already been processed or only the header if the operation was aborted at the first entry.)

+
+          $ bin/zkTxnLogToolkit.sh -r log.100000001
+          ZooKeeper Transactional Log File with dbid 0 txnlog format version 2
+          CRC ERROR - 4/5/18 2:16:05 PM CEST session 0x16295bafcc40000 cxid 0x1 zxid 0x100000002 closeSession null
+          Would you like to fix it (Yes/No/Abort) ? y
+          EOF reached after 6 txns.
+          Recovery file log.100000001.fixed has been written with 1 fixed CRC error(s)
+
+

The default behaviour of recovery is to be silent: only entries with CRC error get printed to the screen. + One can turn on verbose mode with the -v,--verbose parameter to see all records. + Interactive mode can be turned off with the -y,--yes parameter. In this case all CRC errors will be fixed + in the new transaction file.

+ +

Things to Avoid

+

Here are some common problems you can avoid by configuring + ZooKeeper correctly:

+
+ +
+inconsistent lists of servers +
+
+

The list of ZooKeeper servers used by the clients must match + the list of ZooKeeper servers that each ZooKeeper server has. + Things work okay if the client list is a subset of the real list, + but things will really act strange if clients have a list of + ZooKeeper servers that are in different ZooKeeper clusters. Also, + the server lists in each Zookeeper server configuration file + should be consistent with one another.

+
+ + +
+incorrect placement of transaction log +
+
+

The most performance critical part of ZooKeeper is the + transaction log. ZooKeeper syncs transactions to media before it + returns a response. A dedicated transaction log device is key to + consistent good performance. Putting the log on a busy device will + adversely effect performance. If you only have one storage device, + put trace files on NFS and increase the snapshotCount; it doesn't + eliminate the problem, but it should mitigate it.

+
+ + +
+incorrect Java heap size +
+
+

You should take special care to set your Java max heap size + correctly. In particular, you should not create a situation in + which ZooKeeper swaps to disk. The disk is death to ZooKeeper. + Everything is ordered, so if processing one request swaps the + disk, all other queued requests will probably do the same. the + disk. DON'T SWAP.

+

Be conservative in your estimates: if you have 4G of RAM, do + not set the Java max heap size to 6G or even 4G. For example, it + is more likely you would use a 3G heap for a 4G machine, as the + operating system and the cache also need memory. The best and only + recommend practice for estimating the heap size your system needs + is to run load tests, and then make sure you are well below the + usage limit that would cause the system to swap.

+
+ + +
+Publicly accessible deployment +
+
+

+ A ZooKeeper ensemble is expected to operate in a trusted computing environment. + It is thus recommended to deploy ZooKeeper behind a firewall. +

+
+ +
+ +

Best Practices

+

For best results, take note of the following list of good + Zookeeper practices:

+

For multi-tennant installations see the section + detailing ZooKeeper "chroot" support, this can be very useful + when deploying many applications/services interfacing to a + single ZooKeeper cluster.

+
+ +

+ +

+
+ +
 
+
+ + + diff --git a/docs/zookeeperAdmin.pdf b/docs/zookeeperAdmin.pdf new file mode 100644 index 0000000000000000000000000000000000000000..8d0028ede0d835057a143e3d2c2baae913591a7a GIT binary patch literal 86044 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

3*DR@Z=@Uef@On6D^kKntKuLR5;KAIt_)ldeb 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 TH8QCKOcIQH_H-TYX8ivELra5< literal 0 HcmV?d00001 diff --git a/docs/zookeeperHierarchicalQuorums.html b/docs/zookeeperHierarchicalQuorums.html new file mode 100644 index 0000000..5ebde0a --- /dev/null +++ b/docs/zookeeperHierarchicalQuorums.html @@ -0,0 +1,276 @@ + + + + + + + +Introduction to hierarchical quorums + + + + + + + + + +

+ +
+Apache > ZooKeeper > ZooKeeper +
+ +
+ + + + + + + +
+
+  + +
+
+ + + + +
+
+
+
+ +
+ + +
+ +
+ +   +
+ + + + + +
+
+PDF -icon
+ PDF +
+

Introduction to hierarchical quorums

+
+ + + + + +

+ This document gives an example of how to use hierarchical quorums. The basic idea is + very simple. First, we split servers into groups, and add a line for each group listing + the servers that form this group. Next we have to assign a weight to each server. +

+ + +

+ The following example shows how to configure a system with three groups of three servers + each, and we assign a weight of 1 to each server: +

+ + +
+    group.1=1:2:3
+    group.2=4:5:6
+    group.3=7:8:9
+   
+    weight.1=1
+    weight.2=1
+    weight.3=1
+    weight.4=1
+    weight.5=1
+    weight.6=1
+    weight.7=1
+    weight.8=1
+    weight.9=1
+
+ + +

+ When running the system, we are able to form a quorum once we have a majority of votes from + a majority of non-zero-weight groups. Groups that have zero weight are discarded and not + considered when forming quorums. Looking at the example, we are able to form a quorum once + we have votes from at least two servers from each of two different groups. +

+ +

+ +

+
+ +
 
+
+ + + diff --git a/docs/zookeeperHierarchicalQuorums.pdf b/docs/zookeeperHierarchicalQuorums.pdf new file mode 100644 index 0000000000000000000000000000000000000000..fd20251ec0b7aa8da7e2241c7630e266e175163e GIT binary patch literal 6650 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 SE}S?Pt%OBLNg0{r5dQ&-Lww8t literal 0 HcmV?d00001 diff --git a/docs/zookeeperInternals.html b/docs/zookeeperInternals.html new file mode 100644 index 0000000..00e907d --- /dev/null +++ b/docs/zookeeperInternals.html @@ -0,0 +1,805 @@ + + + + + + + +ZooKeeper Internals + + + + + + + + + +
+ +
+Apache > ZooKeeper > ZooKeeper +
+ +
+ + + + + + + +
+
+  + +
+
+ + + + +
+
+
+
+ +
+ + +
+ +
+ +   +
+ + + + + +
+
+PDF -icon
+ PDF +
+

ZooKeeper Internals

+ + + + + + + +

Introduction

+
+

This document contains information on the inner workings of ZooKeeper. + So far, it discusses these topics: +

+ +
+ + + +

Atomic Broadcast

+
+

+At the heart of ZooKeeper is an atomic messaging system that keeps all of the servers in sync.

+ +

Guarantees, Properties, and Definitions

+

+The specific guarantees provided by the messaging system used by ZooKeeper are the following:

+
+ + +
+ +Reliable delivery + +
+
+

If a message, m, is delivered +by one server, it will be eventually delivered by all servers.

+
+ + +
+ +Total order + +
+
+

If a message is +delivered before message b by one server, a will be delivered before b by all +servers. If a and b are delivered messages, either a will be delivered before b +or b will be delivered before a.

+
+ + +
+ +Causal order + +
+
+

+If a message b is sent after a message a has been delivered by the sender of b, +a must be ordered before b. If a sender sends c after sending b, c must be ordered after b. +

+
+ + +
+

+The ZooKeeper messaging system also needs to be efficient, reliable, and easy to +implement and maintain. We make heavy use of messaging, so we need the system to +be able to handle thousands of requests per second. Although we can require at +least k+1 correct servers to send new messages, we must be able to recover from +correlated failures such as power outages. When we implemented the system we had +little time and few engineering resources, so we needed a protocol that is +accessible to engineers and is easy to implement. We found that our protocol +satisfied all of these goals. + +

+

+Our protocol assumes that we can construct point-to-point FIFO channels between +the servers. While similar services usually assume message delivery that can +lose or reorder messages, our assumption of FIFO channels is very practical +given that we use TCP for communication. Specifically we rely on the following property of TCP:

+
+ + +
+ +Ordered delivery + +
+
+

Data is delivered in the same order it is sent and a message m is +delivered only after all messages sent before m have been delivered. +(The corollary to this is that if message m is lost all messages after m will be lost.)

+
+ + +
+ +No message after close + +
+
+

Once a FIFO channel is closed, no messages will be received from it.

+
+ + +
+

+FLP proved that consensus cannot be achieved in asynchronous distributed systems +if failures are possible. To ensure we achieve consensus in the presence of failures +we use timeouts. However, we rely on times for liveness not for correctness. So, +if timeouts stop working (clocks malfunction for example) the messaging system may +hang, but it will not violate its guarantees.

+

When describing the ZooKeeper messaging protocol we will talk of packets, +proposals, and messages:

+
+ +
+ +Packet + +
+
+

a sequence of bytes sent through a FIFO channel

+
+
+ +Proposal + +
+
+

a unit of agreement. Proposals are agreed upon by exchanging packets +with a quorum of ZooKeeper servers. Most proposals contain messages, however the +NEW_LEADER proposal is an example of a proposal that does not correspond to a message.

+
+
+ +Message + +
+
+

a sequence of bytes to be atomically broadcast to all ZooKeeper +servers. A message put into a proposal and agreed upon before it is delivered.

+
+ + +
+

+As stated above, ZooKeeper guarantees a total order of messages, and it also +guarantees a total order of proposals. ZooKeeper exposes the total ordering using +a ZooKeeper transaction id (zxid). All proposals will be stamped with a zxid when +it is proposed and exactly reflects the total ordering. Proposals are sent to all +ZooKeeper servers and committed when a quorum of them acknowledge the proposal. +If a proposal contains a message, the message will be delivered when the proposal +is committed. Acknowledgement means the server has recorded the proposal to persistent storage. +Our quorums have the requirement that any pair of quorum must have at least one server +in common. We ensure this by requiring that all quorums have size (n/2+1) where +n is the number of servers that make up a ZooKeeper service. +

+

+The zxid has two parts: the epoch and a counter. In our implementation the zxid +is a 64-bit number. We use the high order 32-bits for the epoch and the low order +32-bits for the counter. Because it has two parts represent the zxid both as a +number and as a pair of integers, (epoch, count). The epoch number represents a +change in leadership. Each time a new leader comes into power it will have its +own epoch number. We have a simple algorithm to assign a unique zxid to a proposal: +the leader simply increments the zxid to obtain a unique zxid for each proposal. +Leadership activation will ensure that only one leader uses a given epoch, so our +simple algorithm guarantees that every proposal will have a unique id. + +

+

+ZooKeeper messaging consists of two phases:

+
+ +
+ +Leader activation + +
+
+

In this phase a leader establishes the correct state of the system +and gets ready to start making proposals.

+
+ + +
+ +Active messaging + +
+
+

In this phase a leader accepts messages to propose and coordinates message delivery.

+
+ +
+

+ZooKeeper is a holistic protocol. We do not focus on individual proposals, rather +look at the stream of proposals as a whole. Our strict ordering allows us to do this +efficiently and greatly simplifies our protocol. Leadership activation embodies +this holistic concept. A leader becomes active only when a quorum of followers +(The leader counts as a follower as well. You can always vote for yourself ) has synced +up with the leader, they have the same state. This state consists of all of the +proposals that the leader believes have been committed and the proposal to follow +the leader, the NEW_LEADER proposal. (Hopefully you are thinking to +yourself, Does the set of proposals that the leader believes has been committed +included all the proposals that really have been committed? The answer is yes. +Below, we make clear why.) +

+ +

Leader Activation

+

+Leader activation includes leader election. We currently have two leader election +algorithms in ZooKeeper: LeaderElection and FastLeaderElection (AuthFastLeaderElection +is a variant of FastLeaderElection that uses UDP and allows servers to perform a simple +form of authentication to avoid IP spoofing). ZooKeeper messaging doesn't care about the +exact method of electing a leader has long as the following holds: +

+
    + + +
  • +

    The leader has seen the highest zxid of all the followers.

    +
    • + +
  • +

    A quorum of servers have committed to following the leader.

    +
    • + + +
+

+Of these two requirements only the first, the highest zxid amoung the followers +needs to hold for correct operation. The second requirement, a quorum of followers, +just needs to hold with high probability. We are going to recheck the second requirement, +so if a failure happens during or after the leader election and quorum is lost, +we will recover by abandoning leader activation and running another election. +

+

+After leader election a single server will be designated as a leader and start +waiting for followers to connect. The rest of the servers will try to connect to +the leader. The leader will sync up with followers by sending any proposals they +are missing, or if a follower is missing too many proposals, it will send a full +snapshot of the state to the follower. +

+

+There is a corner case in which a follower that has proposals, U, not seen +by a leader arrives. Proposals are seen in order, so the proposals of U will have a zxids +higher than zxids seen by the leader. The follower must have arrived after the +leader election, otherwise the follower would have been elected leader given that +it has seen a higher zxid. Since committed proposals must be seen by a quorum of +servers, and a quorum of servers that elected the leader did not see U, the proposals +of you have not been committed, so they can be discarded. When the follower connects +to the leader, the leader will tell the follower to discard U. +

+

+A new leader establishes a zxid to start using for new proposals by getting the +epoch, e, of the highest zxid it has seen and setting the next zxid to use to be +(e+1, 0), fter the leader syncs with a follower, it will propose a NEW_LEADER +proposal. Once the NEW_LEADER proposal has been committed, the leader will activate +and start receiving and issuing proposals. +

+

+It all sounds complicated but here are the basic rules of operation during leader +activation: +

+
    + +
  • +

    A follower will ACK the NEW_LEADER proposal after it has synced with the leader.

    +
    • + +
  • +

    A follower will only ACK a NEW_LEADER proposal with a given zxid from a single server.

    +
    • + +
  • +

    A new leader will COMMIT the NEW_LEADER proposal when a quorum of followers have ACKed it.

    +
    • + +
  • +

    A follower will commit any state it received from the leader when the NEW_LEADER proposal is COMMIT.

    +
    • + +
  • +

    A new leader will not accept new proposals until the NEW_LEADER proposal has been COMMITED.

    +
    • + +
+

+If leader election terminates erroneously, we don't have a problem since the +NEW_LEADER proposal will not be committed since the leader will not have quorum. +When this happens, the leader and any remaining followers will timeout and go back +to leader election. +

+ +

Active Messaging

+

+Leader Activation does all the heavy lifting. Once the leader is coronated he can +start blasting out proposals. As long as he remains the leader no other leader can +emerge since no other leader will be able to get a quorum of followers. If a new +leader does emerge, +it means that the leader has lost quorum, and the new leader will clean up any +mess left over during her leadership activation. +

+

ZooKeeper messaging operates similar to a classic two-phase commit.

+

+All communication channels are FIFO, so everything is done in order. Specifically +the following operating constraints are observed:

+
    + + +
  • +

    The leader sends proposals to all followers using +the same order. Moreover, this order follows the order in which requests have been +received. Because we use FIFO channels this means that followers also receive proposals in order. +

    +
    • + + +
  • +

    Followers process messages in the order they are received. This +means that messages will be ACKed in order and the leader will receive ACKs from +followers in order, due to the FIFO channels. It also means that if message $m$ +has been written to non-volatile storage, all messages that were proposed before +$m$ have been written to non-volatile storage.

    +
    • + + +
  • +

    The leader will issue a COMMIT to all followers as soon as a +quorum of followers have ACKed a message. Since messages are ACKed in order, +COMMITs will be sent by the leader as received by the followers in order.

    +
    • + + +
  • +

    COMMITs are processed in order. Followers deliver a proposals +message when that proposal is committed.

    +
    • + + +
+ +

Summary

+

So there you go. Why does it work? Specifically, why does is set of proposals +believed by a new leader always contain any proposal that has actually been committed? +First, all proposals have a unique zxid, so unlike other protocols, we never have +to worry about two different values being proposed for the same zxid; followers +(a leader is also a follower) see and record proposals in order; proposals are +committed in order; there is only one active leader at a time since followers only +follow a single leader at a time; a new leader has seen all committed proposals +from the previous epoch since it has seen the highest zxid from a quorum of servers; +any uncommited proposals from a previous epoch seen by a new leader will be committed +by that leader before it becomes active.

+ +

Comparisons

+

+Isn't this just Multi-Paxos? No, Multi-Paxos requires some way of assuring that +there is only a single coordinator. We do not count on such assurances. Instead +we use the leader activation to recover from leadership change or old leaders +believing they are still active. +

+

+Isn't this just Paxos? Your active messaging phase looks just like phase 2 of Paxos? +Actually, to us active messaging looks just like 2 phase commit without the need to +handle aborts. Active messaging is different from both in the sense that it has +cross proposal ordering requirements. If we do not maintain strict FIFO ordering of +all packets, it all falls apart. Also, our leader activation phase is different from +both of them. In particular, our use of epochs allows us to skip blocks of uncommitted +proposals and to not worry about duplicate proposals for a given zxid. +

+
+ + + +

Quorums

+
+

+Atomic broadcast and leader election use the notion of quorum to guarantee a consistent +view of the system. By default, ZooKeeper uses majority quorums, which means that every +voting that happens in one of these protocols requires a majority to vote on. One example is +acknowledging a leader proposal: the leader can only commit once it receives an +acknowledgement from a quorum of servers. +

+

+If we extract the properties that we really need from our use of majorities, we have that we only +need to guarantee that groups of processes used to validate an operation by voting (e.g., acknowledging +a leader proposal) pairwise intersect in at least one server. Using majorities guarantees such a property. +However, there are other ways of constructing quorums different from majorities. For example, we can assign +weights to the votes of servers, and say that the votes of some servers are more important. To obtain a quorum, +we get enough votes so that the sum of weights of all votes is larger than half of the total sum of all weights. +

+

+A different construction that uses weights and is useful in wide-area deployments (co-locations) is a hierarchical +one. With this construction, we split the servers into disjoint groups and assign weights to processes. To form +a quorum, we have to get a hold of enough servers from a majority of groups G, such that for each group g in G, +the sum of votes from g is larger than half of the sum of weights in g. Interestingly, this construction enables +smaller quorums. If we have, for example, 9 servers, we split them into 3 groups, and assign a weight of 1 to each +server, then we are able to form quorums of size 4. Note that two subsets of processes composed each of a majority +of servers from each of a majority of groups necessarily have a non-empty intersection. It is reasonable to expect +that a majority of co-locations will have a majority of servers available with high probability. +

+

+With ZooKeeper, we provide a user with the ability of configuring servers to use majority quorums, weights, or a +hierarchy of groups. +

+
+ + + +

Logging

+
+

+Zookeeper uses +slf4j as an abstraction layer for logging. +log4j in version 1.2 is chosen as the final logging implementation for now. +For better embedding support, it is planned in the future to leave the decision of choosing the final logging implementation to the end user. +Therefore, always use the slf4j api to write log statements in the code, but configure log4j for how to log at runtime. +Note that slf4j has no FATAL level, former messages at FATAL level have been moved to ERROR level. +For information on configuring log4j for +ZooKeeper, see the Logging section +of the ZooKeeper Administrator's Guide. + + +

+ +

Developer Guidelines

+

Please follow the +slf4j manual when creating log statements within code. +Also read the +FAQ on performance +, when creating log statements. Patch reviewers will look for the following:

+ +

Logging at the Right Level

+

+There are several levels of logging in slf4j. +It's important to pick the right one. In order of higher to lower severity:

+
    + +
  1. +

    ERROR level designates error events that might still allow the application to continue running.

    +
    2. + +
  2. +

    WARN level designates potentially harmful situations.

    +
    3. + +
  3. +

    INFO level designates informational messages that highlight the progress of the application at coarse-grained level.

    +
    4. + +
  4. +

    DEBUG Level designates fine-grained informational events that are most useful to debug an application.

    +
    5. + +
  5. +

    TRACE Level designates finer-grained informational events than the DEBUG.

    +
    6. + +
+

+ZooKeeper is typically run in production such that log messages of INFO level +severity and higher (more severe) are output to the log.

+ +

Use of Standard slf4j Idioms

+

+Static Message Logging +

+
+LOG.debug("process completed successfully!");
+
+

+However when creating parameterized messages are required, use formatting anchors. +

+
+LOG.debug("got {} messages in {} minutes",new Object[]{count,time});    
+
+

+Naming +

+

+Loggers should be named after the class in which they are used. +

+
+public class Foo {
+    private static final Logger LOG = LoggerFactory.getLogger(Foo.class);
+    ....
+    public Foo() {
+       LOG.info("constructing Foo");
+
+

+Exception handling +

+
+try {
+  // code
+} catch (XYZException e) {
+  // do this
+  LOG.error("Something bad happened", e);
+  // don't do this (generally)
+  // LOG.error(e);
+  // why? because "don't do" case hides the stack trace
+ 
+  // continue process here as you need... recover or (re)throw
+}
+
+
+ + +

+ +

+
+ +
 
+
+ + + diff --git a/docs/zookeeperInternals.pdf b/docs/zookeeperInternals.pdf new file mode 100644 index 0000000000000000000000000000000000000000..69cadc4391892a4d3015db65c4de3429601f97dc GIT binary patch literal 48806 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 R$!b_@AgtL)xQ>RA- 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 literal 0 HcmV?d00001 diff --git a/docs/zookeeperJMX.html b/docs/zookeeperJMX.html new file mode 100644 index 0000000..c82f5f8 --- /dev/null +++ b/docs/zookeeperJMX.html @@ -0,0 +1,479 @@ + + + + + + + +ZooKeeper JMX + + + + + + + + + +
+ +
+Apache > ZooKeeper > ZooKeeper +
+ +
+ + + + + + + +
+
+  + +
+
+ + + + +
+
+
+
+ +
+ + +
+ +
+ +   +
+ + + + + +
+
+PDF -icon
+ PDF +
+

ZooKeeper JMX

+ + + + + + + +

JMX

+
+

Apache ZooKeeper has extensive support for JMX, allowing you + to view and manage a ZooKeeper serving ensemble.

+

This document assumes that you have basic knowledge of + JMX. See + Sun JMX Technology page to get started with JMX. +

+

See the + JMX Management Guide for details on setting up local and + remote management of VM instances. By default the included + zkServer.sh supports only local management - + review the linked document to enable support for remote management + (beyond the scope of this document). +

+
+ + + +

Starting ZooKeeper with JMX enabled

+
+

The class + org.apache.zookeeper.server.quorum.QuorumPeerMain + will start a JMX manageable ZooKeeper server. This class + registers the proper MBeans during initalization to support JMX + monitoring and management of the + instance. See bin/zkServer.sh for one + example of starting ZooKeeper using QuorumPeerMain.

+
+ + + +

Run a JMX console

+
+

There are a number of JMX consoles available which can connect + to the running server. For this example we will use Sun's + jconsole.

+

The Java JDK ships with a simple JMX console + named jconsole + which can be used to connect to ZooKeeper and inspect a running + server. Once you've started ZooKeeper using QuorumPeerMain + start jconsole, which typically resides in + JDK_HOME/bin/jconsole +

+

When the "new connection" window is displayed either connect + to local process (if jconsole started on same host as Server) or + use the remote process connection.

+

By default the "overview" tab for the VM is displayed (this + is a great way to get insight into the VM btw). Select + the "MBeans" tab.

+

You should now see org.apache.ZooKeeperService + on the left hand side. Expand this item and depending on how you've + started the server you will be able to monitor and manage various + service related features.

+

Also note that ZooKeeper will register log4j MBeans as + well. In the same section along the left hand side you will see + "log4j". Expand that to manage log4j through JMX. Of particular + interest is the ability to dynamically change the logging levels + used by editing the appender and root thresholds. Log4j MBean + registration can be disabled by passing + -Dzookeeper.jmx.log4j.disable=true to the JVM + when starting ZooKeeper. +

+
+ + + +

ZooKeeper MBean Reference

+
+

This table details JMX for a server participating in a + replicated ZooKeeper ensemble (ie not standalone). This is the + typical case for a production environment.

+ + + +MBeans, their names and description + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
MBeans, their names and description
MBeanMBean Object NameDescription
QuorumReplicatedServer_id<#>Represents the Quorum, or Ensemble - parent of all + cluster members. Note that the object name includes the + "myid" of the server (name suffix) that your JMX agent has + connected to.
LocalPeer|RemotePeerreplica.<#>Represents a local or remote peer (ie server + participating in the ensemble). Note that the object name + includes the "myid" of the server (name suffix).
LeaderElectionLeaderElectionRepresents a ZooKeeper cluster leader election which is + in progress. Provides information about the election, such as + when it started.
LeaderLeaderIndicates that the parent replica is the leader and + provides attributes/operations for that server. Note that + Leader is a subclass of ZooKeeperServer, so it provides + all of the information normally associated with a + ZooKeeperServer node.
FollowerFollowerIndicates that the parent replica is a follower and + provides attributes/operations for that server. Note that + Follower is a subclass of ZooKeeperServer, so it provides + all of the information normally associated with a + ZooKeeperServer node.
DataTreeInMemoryDataTreeStatistics on the in memory znode database, also + operations to access finer (and more computationally + intensive) statistics on the data (such as ephemeral + count). InMemoryDataTrees are children of ZooKeeperServer + nodes.
ServerCnxn<session_id>Statistics on each client connection, also + operations on those connections (such as + termination). Note the object name is the session id of + the connection in hex form.
+

This table details JMX for a standalone server. Typically + standalone is only used in development situations.

+ + + +MBeans, their names and description + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
MBeans, their names and description
MBeanMBean Object NameDescription
ZooKeeperServerStandaloneServer_port<#>Statistics on the running server, also operations + to reset these attributes. Note that the object name + includes the client port of the server (name + suffix).
DataTreeInMemoryDataTreeStatistics on the in memory znode database, also + operations to access finer (and more computationally + intensive) statistics on the data (such as ephemeral + count).
ServerCnxn<session_id>Statistics on each client connection, also + operations on those connections (such as + termination). Note the object name is the session id of + the connection in hex form.
+
+ + +

+ +

+
+ +
 
+
+ + + diff --git a/docs/zookeeperJMX.pdf b/docs/zookeeperJMX.pdf new file mode 100644 index 0000000000000000000000000000000000000000..316bd66237b995b37735705c1b9becf95b5721df GIT binary patch literal 16471 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 YXuIL8XZ%S5$W{bN%FTUFLy`1<0PdO!LI3~& literal 0 HcmV?d00001 diff --git a/docs/zookeeperObservers.html b/docs/zookeeperObservers.html new file mode 100644 index 0000000..42f9d16 --- /dev/null +++ b/docs/zookeeperObservers.html @@ -0,0 +1,366 @@ + + + + + + + +ZooKeeper Observers + + + + + + + + + +
+ +
+Apache > ZooKeeper > ZooKeeper +
+ +
+ + + + + + + +
+
+  + +
+
+ + + + +
+
+
+
+ +
+ + +
+ +
+ +   +
+ + + + + +
+
+PDF -icon
+ PDF +
+

ZooKeeper Observers

+ + + + + + + +

Observers: Scaling ZooKeeper Without Hurting Write Performance +

+
+

+ Although ZooKeeper performs very well by having clients connect directly + to voting members of the ensemble, this architecture makes it hard to + scale out to huge numbers of clients. The problem is that as we add more + voting members, the write performance drops. This is due to the fact that + a write operation requires the agreement of (in general) at least half the + nodes in an ensemble and therefore the cost of a vote can increase + significantly as more voters are added. +

+

+ We have introduced a new type of ZooKeeper node called + an Observer which helps address this problem and + further improves ZooKeeper's scalability. Observers are non-voting members + of an ensemble which only hear the results of votes, not the agreement + protocol that leads up to them. Other than this simple distinction, + Observers function exactly the same as Followers - clients may connect to + them and send read and write requests to them. Observers forward these + requests to the Leader like Followers do, but they then simply wait to + hear the result of the vote. Because of this, we can increase the number + of Observers as much as we like without harming the performance of votes. +

+

+ Observers have other advantages. Because they do not vote, they are not a + critical part of the ZooKeeper ensemble. Therefore they can fail, or be + disconnected from the cluster, without harming the availability of the + ZooKeeper service. The benefit to the user is that Observers may connect + over less reliable network links than Followers. In fact, Observers may be + used to talk to a ZooKeeper server from another data center. Clients of + the Observer will see fast reads, as all reads are served locally, and + writes result in minimal network traffic as the number of messages + required in the absence of the vote protocol is smaller. +

+
+ + +

How to use Observers

+
+

Setting up a ZooKeeper ensemble that uses Observers is very simple, + and requires just two changes to your config files. Firstly, in the config + file of every node that is to be an Observer, you must place this line: +

+
+      peerType=observer
+
+

+ This line tells ZooKeeper that the server is to be an Observer. Secondly, + in every server config file, you must add :observer to the server + definition line of each Observer. For example: +

+
+      server.1:localhost:2181:3181:observer
+
+

+ This tells every other server that server.1 is an Observer, and that they + should not expect it to vote. This is all the configuration you need to do + to add an Observer to your ZooKeeper cluster. Now you can connect to it as + though it were an ordinary Follower. Try it out, by running:

+
+      $ bin/zkCli.sh -server localhost:2181
+
+

+ where localhost:2181 is the hostname and port number of the Observer as + specified in every config file. You should see a command line prompt + through which you can issue commands like ls to query + the ZooKeeper service. +

+
+ + + +

Example use cases

+
+

+ Two example use cases for Observers are listed below. In fact, wherever + you wish to scale the numbe of clients of your ZooKeeper ensemble, or + where you wish to insulate the critical part of an ensemble from the load + of dealing with client requests, Observers are a good architectural + choice. +

+
    + +
  • + +

    As a datacenter bridge: Forming a ZK ensemble between two + datacenters is a problematic endeavour as the high variance in latency + between the datacenters could lead to false positive failure detection + and partitioning. However if the ensemble runs entirely in one + datacenter, and the second datacenter runs only Observers, partitions + aren't problematic as the ensemble remains connected. Clients of the + Observers may still see and issue proposals.

    + +
    • + +
  • + +

    As a link to a message bus: Some companies have expressed an + interest in using ZK as a component of a persistent reliable message + bus. Observers would give a natural integration point for this work: a + plug-in mechanism could be used to attach the stream of proposals an + Observer sees to a publish-subscribe system, again without loading the + core ensemble. +

    + +
    • + +
+
+ +

+ +

+
+ +
 
+
+ + + diff --git a/docs/zookeeperObservers.pdf b/docs/zookeeperObservers.pdf new file mode 100644 index 0000000000000000000000000000000000000000..843e860b82c7986e32531d0583dae270843d5503 GIT binary patch literal 12867 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 + + + + + + +ZooKeeper + + + + + + + + + +
+ +
+Apache > Hadoop > ZooKeeper +
+ +
+ + + + + + + +
+
+  + +
+
+ + + + +
+
+
+
+ +
+ + +
+ +
+ +   +
+ + + + + +
+
+PDF -icon
+ PDF +
+

ZooKeeper

+
+ +
+ + + + + + +

Other Info

+
+

currently empty

+
+ +

+ +

+
+ +
 
+
+ + + diff --git a/docs/zookeeperOtherInfo.pdf b/docs/zookeeperOtherInfo.pdf new file mode 100644 index 0000000000000000000000000000000000000000..bbefa1339805374eec7313fb2e387d9c10e82bca GIT binary patch literal 2947 zcmb_e=~C)Q6#k#5Xar<6k3awV8)E?poY^y$%>ttT>x&MEy1jHTqU$<~-CTD;yxQpk z5~oR=OMqMs)9nSi&mDc&(rv?E0Y=~fQ8g_eex(9JR!a4{$d&cEvw&=?mgejG%@jkN zJm1x|4OY{3PwiRm(k0Gi!FqnVYUOo(x24_KO_*>mYS|k-I-Jq7u3yWNq4fE6o+WCk zR_l;%^(C7jw`}-UuBOtlXp(IB2{TK~xHuyu5(-YJTq8UwUf*3uhxO!mT(hilWA-#4 z&O+N^`e8#2JCh!JW*hY>o>t}d*|t4waj{rYzU@B6+gmf%zPO~x(A>EqOWTy87B-7S z3Sv`<E}w#EdUjo6B){+9V^(hpf^r zzVub5zO;Ge){p!i1acpNeMtGEkiJ5ps~I|kg68VB4=8xt!-%%NFtwud1BRG{Kc1q2 zAkkoo5k1{=cJ5sF0P}ja&M-8+=f9zjaQ#NcFlz!=(o#Ad(& zBb43D53t%Y?KKiS_n|rzN#i8oXbI<73Q#+(iIXWJN%c zffUFmu3-{j@A^^b{Gi7H>mv8xui3?J=&sGV#5@kwQg7IWI1`|cl~ih?0Q*llozA1^+k3Q9*Xh8qrGtp3F!=fFzCwE;^iu7nTfd~v7uSN9>Kcb8L>T*Q~`wPZ}m zWU5f{Xy2yzw$u}so4m`m8Zmz<$1k3Yb?jbBXC7x$E5+8jcyp`VTs(x>2P!O2mo8iK z+D$gZr|Vs(!yB_GE418py~CYlLl1Lhu(}ZR%h6*=wNlf5TVBl~Jv`~$B`* zaWq*?la*2K<$Tn6d3u}{#mljo3}(xf4>` z<l_7u;el?x~=7f@)p?ysQR6vv~L4OUJ_K)#1` zr2{a-I=qK4HcXWFvunQw%n3_9)>uTK6}Aa^XVZ*Fui)pItQ{gcv83)#2QprK!w_mi>? z#p}I)ek+UqQdX)nv&`)d*4j7cedo>7y7;Y3;aKLYH~&TG-XMFJ4^UI^U@>)e5Dw6u zrn&HdihSM!K{oZk^k`5(F#MQbCC%3?$3Tq*a@zM5Ky-G#W!i{vKrT9O2gAd_(+|hN z=&%R!dp-e-Kt2E{3{?gM2=BpH4p2e!fv>0~1WFQB8c;zKf>Z%eLDzvALmqJInJYSK zCIlRlU>n##6-v-@{f8e|1rEIlwTgWz6AB<|P9F|UWuWdoK#cCkK;&RQ;yDSf_Rg}V z$ED!iEih%Prt855``R`E(bC>`?^*l9)t49vC|?zIIskJ8cj;jT=W3@jRrg6 z3618U0w3>@By!bfngHwLCmP2 + + + + + + +ZooKeeper + + + + + + + + + +
+ +
+Apache > ZooKeeper > ZooKeeper +
+ +
+ + + + + + + +
+
+  + +
+
+ + + + +
+
+
+
+ +
+ + +
+ +
+ +   +
+ + + + + +
+
+PDF -icon
+ PDF +
+

ZooKeeper

+ + + + + + + +

ZooKeeper: A Distributed Coordination Service for Distributed + Applications

+
+

ZooKeeper is a distributed, open-source coordination service for + distributed applications. It exposes a simple set of primitives that + distributed applications can build upon to implement higher level services + for synchronization, configuration maintenance, and groups and naming. It + is designed to be easy to program to, and uses a data model styled after + the familiar directory tree structure of file systems. It runs in Java and + has bindings for both Java and C.

+

Coordination services are notoriously hard to get right. They are + especially prone to errors such as race conditions and deadlock. The + motivation behind ZooKeeper is to relieve distributed applications the + responsibility of implementing coordination services from scratch.

+ +

Design Goals

+

+ZooKeeper is simple. ZooKeeper + allows distributed processes to coordinate with each other through a + shared hierarchal namespace which is organized similarly to a standard + file system. The name space consists of data registers - called znodes, + in ZooKeeper parlance - and these are similar to files and directories. + Unlike a typical file system, which is designed for storage, ZooKeeper + data is kept in-memory, which means ZooKeeper can acheive high + throughput and low latency numbers.

+

The ZooKeeper implementation puts a premium on high performance, + highly available, strictly ordered access. The performance aspects of + ZooKeeper means it can be used in large, distributed systems. The + reliability aspects keep it from being a single point of failure. The + strict ordering means that sophisticated synchronization primitives can + be implemented at the client.

+

+ZooKeeper is replicated. Like the + distributed processes it coordinates, ZooKeeper itself is intended to be + replicated over a sets of hosts called an ensemble.

+ + + + + + + +
ZooKeeper Service
+ + + +
+

The servers that make up the ZooKeeper service must all know about + each other. They maintain an in-memory image of state, along with a + transaction logs and snapshots in a persistent store. As long as a + majority of the servers are available, the ZooKeeper service will be + available.

+

Clients connect to a single ZooKeeper server. The client maintains + a TCP connection through which it sends requests, gets responses, gets + watch events, and sends heart beats. If the TCP connection to the server + breaks, the client will connect to a different server.

+

+ZooKeeper is ordered. ZooKeeper + stamps each update with a number that reflects the order of all + ZooKeeper transactions. Subsequent operations can use the order to + implement higher-level abstractions, such as synchronization + primitives.

+

+ZooKeeper is fast. It is + especially fast in "read-dominant" workloads. ZooKeeper applications run + on thousands of machines, and it performs best where reads are more + common than writes, at ratios of around 10:1.

+ +

Data model and the hierarchical namespace

+

The name space provided by ZooKeeper is much like that of a + standard file system. A name is a sequence of path elements separated by + a slash (/). Every node in ZooKeeper's name space is identified by a + path.

+ + + + + + + +
ZooKeeper's Hierarchical Namespace
+ + + +
+ +

Nodes and ephemeral nodes

+

Unlike is standard file systems, each node in a ZooKeeper + namespace can have data associated with it as well as children. It is + like having a file-system that allows a file to also be a directory. + (ZooKeeper was designed to store coordination data: status information, + configuration, location information, etc., so the data stored at each + node is usually small, in the byte to kilobyte range.) We use the term + znode to make it clear that we are talking about + ZooKeeper data nodes.

+

Znodes maintain a stat structure that includes version numbers for + data changes, ACL changes, and timestamps, to allow cache validations + and coordinated updates. Each time a znode's data changes, the version + number increases. For instance, whenever a client retrieves data it also + receives the version of the data.

+

The data stored at each znode in a namespace is read and written + atomically. Reads get all the data bytes associated with a znode and a + write replaces all the data. Each node has an Access Control List (ACL) + that restricts who can do what.

+

ZooKeeper also has the notion of ephemeral nodes. These znodes + exists as long as the session that created the znode is active. When the + session ends the znode is deleted. Ephemeral nodes are useful when you + want to implement [tbd].

+ +

Conditional updates and watches

+

ZooKeeper supports the concept of watches. + Clients can set a watch on a znodes. A watch will be triggered and + removed when the znode changes. When a watch is triggered the client + receives a packet saying that the znode has changed. And if the + connection between the client and one of the Zoo Keeper servers is + broken, the client will receive a local notification. These can be used + to [tbd].

+ +

Guarantees

+

ZooKeeper is very fast and very simple. Since its goal, though, is + to be a basis for the construction of more complicated services, such as + synchronization, it provides a set of guarantees. These are:

+
    + +
  • + +

    Sequential Consistency - Updates from a client will be applied + in the order that they were sent.

    + +
    • + + +
  • + +

    Atomicity - Updates either succeed or fail. No partial + results.

    + +
    • + + +
  • + +

    Single System Image - A client will see the same view of the + service regardless of the server that it connects to.

    + +
    • + +
+
    + +
  • + +

    Reliability - Once an update has been applied, it will persist + from that time forward until a client overwrites the update.

    + +
    • + +
+
    + +
  • + +

    Timeliness - The clients view of the system is guaranteed to + be up-to-date within a certain time bound.

    + +
    • + +
+

For more information on these, and how they can be used, see + [tbd] +

+ +

Simple API

+

One of the design goals of ZooKeeper is provide a very simple + programming interface. As a result, it supports only these + operations:

+
+ +
+create +
+
+

creates a node at a location in the tree

+
+ + +
+delete +
+
+

deletes a node

+
+ + +
+exists +
+
+

tests if a node exists at a location

+
+ + +
+get data +
+
+

reads the data from a node

+
+ + +
+set data +
+
+

writes data to a node

+
+ + +
+get children +
+
+

retrieves a list of children of a node

+
+ + +
+sync +
+
+

waits for data to be propagated

+
+ +
+

For a more in-depth discussion on these, and how they can be used + to implement higher level operations, please refer to + [tbd] +

+ +

Implementation

+

+ZooKeeper Components shows the high-level components + of the ZooKeeper service. With the exception of the request processor, + each of + the servers that make up the ZooKeeper service replicates its own copy + of each of components.

+ + + + + + + +
ZooKeeper Components
+ + + +
+

The replicated database is an in-memory database containing the + entire data tree. Updates are logged to disk for recoverability, and + writes are serialized to disk before they are applied to the in-memory + database.

+

Every ZooKeeper server services clients. Clients connect to + exactly one server to submit irequests. Read requests are serviced from + the local replica of each server database. Requests that change the + state of the service, write requests, are processed by an agreement + protocol.

+

As part of the agreement protocol all write requests from clients + are forwarded to a single server, called the + leader. The rest of the ZooKeeper servers, called + followers, receive message proposals from the + leader and agree upon message delivery. The messaging layer takes care + of replacing leaders on failures and syncing followers with + leaders.

+

ZooKeeper uses a custom atomic messaging protocol. Since the + messaging layer is atomic, ZooKeeper can guarantee that the local + replicas never diverge. When the leader receives a write request, it + calculates what the state of the system is when the write is to be + applied and transforms this into a transaction that captures this new + state.

+ +

Uses

+

The programming interface to ZooKeeper is deliberately simple. + With it, however, you can implement higher order operations, such as + synchronizations primitives, group membership, ownership, etc. Some + distributed applications have used it to: [tbd: add uses from + white paper and video presentation.] For more information, see + [tbd] +

+ +

Performance

+

ZooKeeper is designed to be highly performant. But is it? The + results of the ZooKeeper's development team at Yahoo! Research indicate + that it is. (See ZooKeeper Throughput as the Read-Write Ratio Varies.) It is especially high + performance in applications where reads outnumber writes, since writes + involve synchronizing the state of all servers. (Reads outnumbering + writes is typically the case for a coordination service.)

+ + + + + + + +
ZooKeeper Throughput as the Read-Write Ratio Varies
+ + + +
+

The figure ZooKeeper Throughput as the Read-Write Ratio Varies is a throughput + graph of ZooKeeper release 3.2 running on servers with dual 2Ghz + Xeon and two SATA 15K RPM drives. One drive was used as a + dedicated ZooKeeper log device. The snapshots were written to + the OS drive. Write requests were 1K writes and the reads were + 1K reads. "Servers" indicate the size of the ZooKeeper + ensemble, the number of servers that make up the + service. Approximately 30 other servers were used to simulate + the clients. The ZooKeeper ensemble was configured such that + leaders do not allow connections from clients.

+
+
Note
+
+

In version 3.2 r/w performance improved by ~2x + compared to the previous + 3.1 release.

+
+
+

Benchmarks also indicate that it is reliable, too. Reliability in the Presence of Errors shows how a deployment responds to + various failures. The events marked in the figure are the + following:

+
    + +
  1. + +

    Failure and recovery of a follower

    + +
    2. + + +
  2. + +

    Failure and recovery of a different follower

    + +
    3. + + +
  3. + +

    Failure of the leader

    + +
    4. + + +
  4. + +

    Failure and recovery of two followers

    + +
    5. + + +
  5. + +

    Failure of another leader

    + +
    6. + +
+ +

Reliability

+

To show the behavior of the system over time as + failures are injected we ran a ZooKeeper service made up of + 7 machines. We ran the same saturation benchmark as before, + but this time we kept the write percentage at a constant + 30%, which is a conservative ratio of our expected + workloads. +

+ + + + + + + +
Reliability in the Presence of Errors
+ + + +
+

The are a few important observations from this graph. First, if + followers fail and recover quickly, then ZooKeeper is able to sustain a + high throughput despite the failure. But maybe more importantly, the + leader election algorithm allows for the system to recover fast enough + to prevent throughput from dropping substantially. In our observations, + ZooKeeper takes less than 200ms to elect a new leader. Third, as + followers recover, ZooKeeper is able to raise throughput again once they + start processing requests.

+ +

The ZooKeeper Project

+

ZooKeeper has been + + successfully used + + in many industrial applications. It is used at Yahoo! as the + coordination and failure recovery service for Yahoo! Message + Broker, which is a highly scalable publish-subscribe system + managing thousands of topics for replication and data + delivery. It is used by the Fetching Service for Yahoo! + crawler, where it also manages failure recovery. A number of + Yahoo! advertising systems also use ZooKeeper to implement + reliable services. +

+

All users and developers are encouraged to join the + community and contribute their expertise. See the + + Zookeeper Project on Apache + + for more information. +

+
+ +

+ +

+
+ +
 
+
+ + + diff --git a/docs/zookeeperOver.pdf b/docs/zookeeperOver.pdf new file mode 100644 index 0000000000000000000000000000000000000000..7ce6705f76e022a800aa09bbf49a84d10e4dc0da GIT binary patch literal 302479 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

_uWN@=>qJ^7KfZ6wU^1O|B+7^R$-%M&^j`s{H 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%0DJL-$xRv}!$mBNCIbqYe_oaFtzWK)G}UI3qj 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

sxK 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 z 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%0D-E|MNvzXN7Gv(XjpFtWrDd|4~(~6{`)1LTw)*L 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 m9(m+S%ZF3OAs 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 literal 0 HcmV?d00001 diff --git a/docs/zookeeperProgrammers.html b/docs/zookeeperProgrammers.html new file mode 100644 index 0000000..b134409 --- /dev/null +++ b/docs/zookeeperProgrammers.html @@ -0,0 +1,2285 @@ + + + + + + + +ZooKeeper Programmer's Guide + + + + + + + + + +

+ +
+Apache > ZooKeeper > ZooKeeper +
+ +
+ + + + + + + +
+
+  + +
+
+ + + + +
+
+
+
+ +
+ + +
+ +
+ +   +
+ + + + + +
+
+PDF -icon
+ PDF +
+

ZooKeeper Programmer's Guide

+

Developing Distributed Applications that use ZooKeeper

+ + + + + + + + + +

Introduction

+
+

This document is a guide for developers wishing to create + distributed applications that take advantage of ZooKeeper's coordination + services. It contains conceptual and practical information.

+

The first four sections of this guide present higher level + discussions of various ZooKeeper concepts. These are necessary both for an + understanding of how ZooKeeper works as well how to work with it. It does + not contain source code, but it does assume a familiarity with the + problems associated with distributed computing. The sections in this first + group are:

+ +

The next four sections provide practical programming + information. These are:

+ +

The book concludes with an appendix containing links to other + useful, ZooKeeper-related information.

+

Most of information in this document is written to be accessible as + stand-alone reference material. However, before starting your first + ZooKeeper application, you should probably at least read the chaptes on + the ZooKeeper Data Model and ZooKeeper Basic Operations. Also, + the Simple Programmming + Example [tbd] is helpful for understanding the basic + structure of a ZooKeeper client application.

+
+ + + +

The ZooKeeper Data Model

+
+

ZooKeeper has a hierarchal name space, much like a distributed file + system. The only difference is that each node in the namespace can have + data associated with it as well as children. It is like having a file + system that allows a file to also be a directory. Paths to nodes are + always expressed as canonical, absolute, slash-separated paths; there are + no relative reference. Any unicode character can be used in a path subject + to the following constraints:

+
    + +
  • + +

    The null character (\u0000) cannot be part of a path name. (This + causes problems with the C binding.)

    + +
    • + + +
  • + +

    The following characters can't be used because they don't + display well, or render in confusing ways: \u0001 - \u0019 and \u007F + - \u009F.

    + +
    • + + +
  • + +

    The following characters are not allowed: \ud800 -uF8FFF, + \uFFF0 - uFFFF.

    + +
    • + + +
  • + +

    The "." character can be used as part of another name, but "." + and ".." cannot alone be used to indicate a node along a path, + because ZooKeeper doesn't use relative paths. The following would be + invalid: "/a/b/./c" or "/a/b/../c".

    + +
    • + + +
  • + +

    The token "zookeeper" is reserved.

    + +
    • + +
+ +

ZNodes

+

Every node in a ZooKeeper tree is referred to as a + znode. Znodes maintain a stat structure that + includes version numbers for data changes, acl changes. The stat + structure also has timestamps. The version number, together with the + timestamp, allows ZooKeeper to validate the cache and to coordinate + updates. Each time a znode's data changes, the version number increases. + For instance, whenever a client retrieves data, it also receives the + version of the data. And when a client performs an update or a delete, + it must supply the version of the data of the znode it is changing. If + the version it supplies doesn't match the actual version of the data, + the update will fail. (This behavior can be overridden. For more + information see... )[tbd...] +

+
+
Note
+
+ +

In distributed application engineering, the word + node can refer to a generic host machine, a + server, a member of an ensemble, a client process, etc. In the ZooKeeper + documentation, znodes refer to the data nodes. + Servers refer to machines that make up the + ZooKeeper service; quorum peers refer to the + servers that make up an ensemble; client refers to any host or process + which uses a ZooKeeper service.

+ +
+
+

A znode is the main abstraction a programmer needs to be aware of. Znodes have + several characteristics that are worth mentioning here.

+ +

Watches

+

Clients can set watches on znodes. Changes to that znode trigger + the watch and then clear the watch. When a watch triggers, ZooKeeper + sends the client a notification. More information about watches can be + found in the section + ZooKeeper Watches.

+ +

Data Access

+

The data stored at each znode in a namespace is read and written + atomically. Reads get all the data bytes associated with a znode and a + write replaces all the data. Each node has an Access Control List + (ACL) that restricts who can do what.

+

ZooKeeper was not designed to be a general database or large + object store. Instead, it manages coordination data. This data can + come in the form of configuration, status information, rendezvous, etc. + A common property of the various forms of coordination data is that + they are relatively small: measured in kilobytes. + The ZooKeeper client and the server implementations have sanity checks + to ensure that znodes have less than 1M of data, but the data should + be much less than that on average. Operating on relatively large data + sizes will cause some operations to take much more time than others and + will affect the latencies of some operations because of the extra time + needed to move more data over the network and onto storage media. If + large data storage is needed, the usually pattern of dealing with such + data is to store it on a bulk storage system, such as NFS or HDFS, and + store pointers to the storage locations in ZooKeeper.

+ +

Ephemeral Nodes

+

ZooKeeper also has the notion of ephemeral nodes. These znodes + exists as long as the session that created the znode is active. When + the session ends the znode is deleted. Because of this behavior + ephemeral znodes are not allowed to have children.

+ +

Sequence Nodes -- Unique Naming

+

When creating a znode you can also request that + ZooKeeper append a monotonically increasing counter to the end + of path. This counter is unique to the parent znode. The + counter has a format of %010d -- that is 10 digits with 0 + (zero) padding (the counter is formatted in this way to + simplify sorting), i.e. "<path>0000000001". See + Queue + Recipe for an example use of this feature. Note: the + counter used to store the next sequence number is a signed int + (4bytes) maintained by the parent node, the counter will + overflow when incremented beyond 2147483647 (resulting in a + name "<path>-2147483648").

+ +

Time in ZooKeeper

+

ZooKeeper tracks time multiple ways:

+
    + +
  • + +

    +Zxid +

    + + +

    Every change to the ZooKeeper state receives a stamp in the + form of a zxid (ZooKeeper Transaction Id). + This exposes the total ordering of all changes to ZooKeeper. Each + change will have a unique zxid and if zxid1 is smaller than zxid2 + then zxid1 happened before zxid2.

    + +
    • + + +
  • + +

    +Version numbers +

    + + +

    Every change to a node will cause an increase to one of the + version numbers of that node. The three version numbers are version + (number of changes to the data of a znode), cversion (number of + changes to the children of a znode), and aversion (number of changes + to the ACL of a znode).

    + +
    • + + +
  • + +

    +Ticks +

    + + +

    When using multi-server ZooKeeper, servers use ticks to define + timing of events such as status uploads, session timeouts, + connection timeouts between peers, etc. The tick time is only + indirectly exposed through the minimum session timeout (2 times the + tick time); if a client requests a session timeout less than the + minimum session timeout, the server will tell the client that the + session timeout is actually the minimum session timeout.

    + +
    • + + +
  • + +

    +Real time +

    + + +

    ZooKeeper doesn't use real time, or clock time, at all except + to put timestamps into the stat structure on znode creation and + znode modification.

    + +
    • + +
+ +

ZooKeeper Stat Structure

+

The Stat structure for each znode in ZooKeeper is made up of the + following fields:

+
    + +
  • + +

    +czxid +

    + + +

    The zxid of the change that caused this znode to be + created.

    + +
    • + + +
  • + +

    +mzxid +

    + + +

    The zxid of the change that last modified this znode.

    + +
    • + + +
  • + +

    +pzxid +

    + + +

    The zxid of the change that last modified children of this znode.

    + +
    • + + +
  • + +

    +ctime +

    + + +

    The time in milliseconds from epoch when this znode was + created.

    + +
    • + + +
  • + +

    +mtime +

    + + +

    The time in milliseconds from epoch when this znode was last + modified.

    + +
    • + + +
  • + +

    +version +

    + + +

    The number of changes to the data of this znode.

    + +
    • + + +
  • + +

    +cversion +

    + + +

    The number of changes to the children of this znode.

    + +
    • + + +
  • + +

    +aversion +

    + + +

    The number of changes to the ACL of this znode.

    + +
    • + + +
  • + +

    +ephemeralOwner +

    + + +

    The session id of the owner of this znode if the znode is an + ephemeral node. If it is not an ephemeral node, it will be + zero.

    + +
    • + + +
  • + +

    +dataLength +

    + + +

    The length of the data field of this znode.

    + +
    • + + +
  • + +

    +numChildren +

    + + +

    The number of children of this znode.

    + +
    • + + +
+
+ + + +

ZooKeeper Sessions

+
+

A ZooKeeper client establishes a session with the ZooKeeper + service by creating a handle to the service using a language + binding. Once created, the handle starts of in the CONNECTING state + and the client library tries to connect to one of the servers that + make up the ZooKeeper service at which point it switches to the + CONNECTED state. During normal operation will be in one of these + two states. If an unrecoverable error occurs, such as session + expiration or authentication failure, or if the application explicitly + closes the handle, the handle will move to the CLOSED state. + The following figure shows the possible state transitions of a + ZooKeeper client:

+

To create a client session the application code must provide + a connection string containing a comma separated list of host:port pairs, + each corresponding to a ZooKeeper server (e.g. "127.0.0.1:4545" or + "127.0.0.1:3000,127.0.0.1:3001,127.0.0.1:3002"). The ZooKeeper + client library will pick an arbitrary server and try to connect to + it. If this connection fails, or if the client becomes + disconnected from the server for any reason, the client will + automatically try the next server in the list, until a connection + is (re-)established.

+

+Added in 3.2.0: An + optional "chroot" suffix may also be appended to the connection + string. This will run the client commands while interpreting all + paths relative to this root (similar to the unix chroot + command). If used the example would look like: + "127.0.0.1:4545/app/a" or + "127.0.0.1:3000,127.0.0.1:3001,127.0.0.1:3002/app/a" where the + client would be rooted at "/app/a" and all paths would be relative + to this root - ie getting/setting/etc... "/foo/bar" would result + in operations being run on "/app/a/foo/bar" (from the server + perspective). This feature is particularly useful in multi-tenant + environments where each user of a particular ZooKeeper service + could be rooted differently. This makes re-use much simpler as + each user can code his/her application as if it were rooted at + "/", while actual location (say /app/a) could be determined at + deployment time.

+

When a client gets a handle to the ZooKeeper service, + ZooKeeper creates a ZooKeeper session, represented as a 64-bit + number, that it assigns to the client. If the client connects to a + different ZooKeeper server, it will send the session id as a part + of the connection handshake. As a security measure, the server + creates a password for the session id that any ZooKeeper server + can validate.The password is sent to the client with the session + id when the client establishes the session. The client sends this + password with the session id whenever it reestablishes the session + with a new server.

+

One of the parameters to the ZooKeeper client library call + to create a ZooKeeper session is the session timeout in + milliseconds. The client sends a requested timeout, the server + responds with the timeout that it can give the client. The current + implementation requires that the timeout be a minimum of 2 times + the tickTime (as set in the server configuration) and a maximum of + 20 times the tickTime. The ZooKeeper client API allows access to + the negotiated timeout.

+

When a client (session) becomes partitioned from the ZK + serving cluster it will begin searching the list of servers that + were specified during session creation. Eventually, when + connectivity between the client and at least one of the servers is + re-established, the session will either again transition to the + "connected" state (if reconnected within the session timeout + value) or it will transition to the "expired" state (if + reconnected after the session timeout). It is not advisable to + create a new session object (a new ZooKeeper.class or zookeeper + handle in the c binding) for disconnection. The ZK client library + will handle reconnect for you. In particular we have heuristics + built into the client library to handle things like "herd effect", + etc... Only create a new session when you are notified of session + expiration (mandatory).

+

Session expiration is managed by the ZooKeeper cluster + itself, not by the client. When the ZK client establishes a + session with the cluster it provides a "timeout" value detailed + above. This value is used by the cluster to determine when the + client's session expires. Expirations happens when the cluster + does not hear from the client within the specified session timeout + period (i.e. no heartbeat). At session expiration the cluster will + delete any/all ephemeral nodes owned by that session and + immediately notify any/all connected clients of the change (anyone + watching those znodes). At this point the client of the expired + session is still disconnected from the cluster, it will not be + notified of the session expiration until/unless it is able to + re-establish a connection to the cluster. The client will stay in + disconnected state until the TCP connection is re-established with + the cluster, at which point the watcher of the expired session + will receive the "session expired" notification.

+

Example state transitions for an expired session as seen by + the expired session's watcher:

+
    + +
  1. +

    'connected' : session is established and client + is communicating with cluster (client/server communication is + operating properly)

    +
    2. + +
  2. +

    .... client is partitioned from the + cluster

    +
    3. + +
  3. +

    'disconnected' : client has lost connectivity + with the cluster

    +
    4. + +
  4. +

    .... time elapses, after 'timeout' period the + cluster expires the session, nothing is seen by client as it is + disconnected from cluster

    +
    5. + +
  5. +

    .... time elapses, the client regains network + level connectivity with the cluster

    +
    6. + +
  6. +

    'expired' : eventually the client reconnects to + the cluster, it is then notified of the + expiration

    +
    7. + +
+

Another parameter to the ZooKeeper session establishment + call is the default watcher. Watchers are notified when any state + change occurs in the client. For example if the client loses + connectivity to the server the client will be notified, or if the + client's session expires, etc... This watcher should consider the + initial state to be disconnected (i.e. before any state changes + events are sent to the watcher by the client lib). In the case of + a new connection, the first event sent to the watcher is typically + the session connection event.

+

The session is kept alive by requests sent by the client. If + the session is idle for a period of time that would timeout the + session, the client will send a PING request to keep the session + alive. This PING request not only allows the ZooKeeper server to + know that the client is still active, but it also allows the + client to verify that its connection to the ZooKeeper server is + still active. The timing of the PING is conservative enough to + ensure reasonable time to detect a dead connection and reconnect + to a new server.

+

+ Once a connection to the server is successfully established + (connected) there are basically two cases where the client lib generates + connectionloss (the result code in c binding, exception in Java -- see + the API documentation for binding specific details) when either a synchronous or + asynchronous operation is performed and one of the following holds: +

+
    + +
  1. +

    The application calls an operation on a session that is no + longer alive/valid

    +
    2. + +
  2. +

    The ZooKeeper client disconnects from a server when there + are pending operations to that server, i.e., there is a pending asynchronous call. +

    +
    3. + +
+

+Added in 3.2.0 -- SessionMovedException. There is an internal + exception that is generally not seen by clients called the SessionMovedException. + This exception occurs because a request was received on a connection for a session + which has been reestablished on a different server. The normal cause of this error is + a client that sends a request to a server, but the network packet gets delayed, so + the client times out and connects to a new server. When the delayed packet arrives at + the first server, the old server detects that the session has moved, and closes the + client connection. Clients normally do not see this error since they do not read + from those old connections. (Old connections are usually closed.) One situation in which this + condition can be seen is when two clients try to reestablish the same connection using + a saved session id and password. One of the clients will reestablish the connection + and the second client will be disconnected (causing the pair to attempt to re-establish + its connection/session indefinitely).

+
+ + + +

ZooKeeper Watches

+
+

All of the read operations in ZooKeeper - getData(), getChildren(), and exists() - have the option of setting a watch as a + side effect. Here is ZooKeeper's definition of a watch: a watch event is + one-time trigger, sent to the client that set the watch, which occurs when + the data for which the watch was set changes. There are three key points + to consider in this definition of a watch:

+
    + +
  • + +

    +One-time trigger +

    + + +

    One watch event will be sent to the client when the data has changed. + For example, if a client does a getData("/znode1", true) and later the + data for /znode1 is changed or deleted, the client will get a watch + event for /znode1. If /znode1 changes again, no watch event will be + sent unless the client has done another read that sets a new + watch.

    + +
    • + + +
  • + +

    +Sent to the client +

    + + +

    This implies that an event is on the way to the client, but may + not reach the client before the successful return code to the change + operation reaches the client that initiated the change. Watches are + sent asynchronously to watchers. ZooKeeper provides an ordering + guarantee: a client will never see a change for which it has set a + watch until it first sees the watch event. Network delays or other + factors may cause different clients to see watches and return codes + from updates at different times. The key point is that everything seen + by the different clients will have a consistent order.

    + +
    • + + +
  • + +

    +The data for which the watch was + set +

    + + +

    This refers to the different ways a node can change. It + helps to think of ZooKeeper as maintaining two lists of + watches: data watches and child watches. getData() and + exists() set data watches. getChildren() sets child + watches. Alternatively, it may help to think of watches being + set according to the kind of data returned. getData() and + exists() return information about the data of the node, + whereas getChildren() returns a list of children. Thus, + setData() will trigger data watches for the znode being set + (assuming the set is successful). A successful create() will + trigger a data watch for the znode being created and a child + watch for the parent znode. A successful delete() will trigger + both a data watch and a child watch (since there can be no + more children) for a znode being deleted as well as a child + watch for the parent znode.

    + +
    • + +
+

Watches are maintained locally at the ZooKeeper server to which the + client is connected. This allows watches to be lightweight to set, + maintain, and dispatch. When a client connects to a new server, the watch + will be triggered for any session events. Watches will not be received + while disconnected from a server. When a client reconnects, any previously + registered watches will be reregistered and triggered if needed. In + general this all occurs transparently. There is one case where a watch + may be missed: a watch for the existence of a znode not yet created will + be missed if the znode is created and deleted while disconnected.

+ +

Semantics of Watches

+

We can set watches with the three calls that read the state of + ZooKeeper: exists, getData, and getChildren. The following list details + the events that a watch can trigger and the calls that enable them: +

+
    + +
  • + +

    +Created event: +

    + +

    Enabled with a call to exists.

    + +
    • + + +
  • + +

    +Deleted event: +

    + +

    Enabled with a call to exists, getData, and getChildren.

    + +
    • + + +
  • + +

    +Changed event: +

    + +

    Enabled with a call to exists and getData.

    + +
    • + + +
  • + +

    +Child event: +

    + +

    Enabled with a call to getChildren.

    + +
    • + +
+ +

What ZooKeeper Guarantees about Watches

+

With regard to watches, ZooKeeper maintains these + guarantees:

+
    + +
  • + +

    Watches are ordered with respect to other events, other + watches, and asynchronous replies. The ZooKeeper client libraries + ensures that everything is dispatched in order.

    + +
    • + +
+
    + +
  • + +

    A client will see a watch event for a znode it is watching + before seeing the new data that corresponds to that znode.

    + +
    • + +
+
    + +
  • + +

    The order of watch events from ZooKeeper corresponds to the + order of the updates as seen by the ZooKeeper service.

    + +
    • + +
+ +

Things to Remember about Watches

+
    + +
  • + +

    Watches are one time triggers; if you get a watch event and + you want to get notified of future changes, you must set another + watch.

    + +
    • + +
+
    + +
  • + +

    Because watches are one time triggers and there is latency + between getting the event and sending a new request to get a watch + you cannot reliably see every change that happens to a node in + ZooKeeper. Be prepared to handle the case where the znode changes + multiple times between getting the event and setting the watch + again. (You may not care, but at least realize it may + happen.)

    + +
    • + +
+
    + +
  • + +

    A watch object, or function/context pair, will only be + triggered once for a given notification. For example, if the same + watch object is registered for an exists and a getData call for the + same file and that file is then deleted, the watch object would + only be invoked once with the deletion notification for the file. +

    + +
    • + +
+
    + +
  • + +

    When you disconnect from a server (for example, when the + server fails), you will not get any watches until the connection + is reestablished. For this reason session events are sent to all + outstanding watch handlers. Use session events to go into a safe + mode: you will not be receiving events while disconnected, so your + process should act conservatively in that mode.

    + +
    • + +
+
+ + + +

ZooKeeper access control using ACLs

+
+

ZooKeeper uses ACLs to control access to its znodes (the + data nodes of a ZooKeeper data tree). The ACL implementation is + quite similar to UNIX file access permissions: it employs + permission bits to allow/disallow various operations against a + node and the scope to which the bits apply. Unlike standard UNIX + permissions, a ZooKeeper node is not limited by the three standard + scopes for user (owner of the file), group, and world + (other). ZooKeeper does not have a notion of an owner of a + znode. Instead, an ACL specifies sets of ids and permissions that + are associated with those ids.

+

Note also that an ACL pertains only to a specific znode. In + particular it does not apply to children. For example, if + /app is only readable by ip:172.16.16.1 and + /app/status is world readable, anyone will + be able to read /app/status; ACLs are not + recursive.

+

ZooKeeper supports pluggable authentication schemes. Ids are + specified using the form scheme:id, + where scheme is a the authentication scheme + that the id corresponds to. For + example, ip:172.16.16.1 is an id for a + host with the address 172.16.16.1.

+

When a client connects to ZooKeeper and authenticates + itself, ZooKeeper associates all the ids that correspond to a + client with the clients connection. These ids are checked against + the ACLs of znodes when a clients tries to access a node. ACLs are + made up of pairs of (scheme:expression, + perms). The format of + the expression is specific to the scheme. For + example, the pair (ip:19.22.0.0/16, READ) + gives the READ permission to any clients with + an IP address that starts with 19.22.

+ +

ACL Permissions

+

ZooKeeper supports the following permissions:

+
    + +
  • +

    +CREATE: you can create a child node

    +
    • + +
  • +

    +READ: you can get data from a node and list its children.

    +
    • + +
  • +

    +WRITE: you can set data for a node

    +
    • + +
  • +

    +DELETE: you can delete a child node

    +
    • + +
  • +

    +ADMIN: you can set permissions

    +
    • + +
+

The CREATE + and DELETE permissions have been broken out + of the WRITE permission for finer grained + access controls. The cases for CREATE + and DELETE are the following:

+

You want A to be able to do a set on a ZooKeeper node, but + not be able to CREATE + or DELETE children.

+

+CREATE + without DELETE: clients create requests by + creating ZooKeeper nodes in a parent directory. You want all + clients to be able to add, but only request processor can + delete. (This is kind of like the APPEND permission for + files.)

+

Also, the ADMIN permission is there + since ZooKeeper doesn’t have a notion of file owner. In some + sense the ADMIN permission designates the + entity as the owner. ZooKeeper doesn’t support the LOOKUP + permission (execute permission bit on directories to allow you + to LOOKUP even though you can't list the directory). Everyone + implicitly has LOOKUP permission. This allows you to stat a + node, but nothing more. (The problem is, if you want to call + zoo_exists() on a node that doesn't exist, there is no + permission to check.)

+ +

Builtin ACL Schemes

+

ZooKeeeper has the following built in schemes:

+
    + +
  • +

    +world has a + single id, anyone, that represents + anyone.

    +
    • + + +
  • +

    +auth doesn't + use any id, represents any authenticated + user.

    +
    • + + +
  • +

    +digest uses + a username:password string to generate + MD5 hash which is then used as an ACL ID + identity. Authentication is done by sending + the username:password in clear text. When + used in the ACL the expression will be + the username:base64 + encoded SHA1 + password digest.

    + +
    • + + +
  • +

    +ip uses the + client host IP as an ACL ID identity. The ACL expression is of + the form addr/bits where the most + significant bits + of addr are matched against the most + significant bits of the client host + IP.

    +
    • + + +
+ +

ZooKeeper C client API

+

The following constants are provided by the ZooKeeper C + library:

+
    + +
  • +

    +const int ZOO_PERM_READ; //can read node’s value and list its children

    +
    • + +
  • +

    +const int ZOO_PERM_WRITE;// can set the node’s value

    +
    • + +
  • +

    +const int ZOO_PERM_CREATE; //can create children

    +
    • + +
  • +

    +const int ZOO_PERM_DELETE;// can delete children

    +
    • + +
  • +

    +const int ZOO_PERM_ADMIN; //can execute set_acl()

    +
    • + +
  • +

    +const int ZOO_PERM_ALL;// all of the above flags OR’d together

    +
    • + +
+

The following are the standard ACL IDs:

+
    + +
  • +

    +struct Id ZOO_ANYONE_ID_UNSAFE; //(‘world’,’anyone’)

    +
    • + +
  • +

    +struct Id ZOO_AUTH_IDS;// (‘auth’,’’)

    +
    • + +
+

ZOO_AUTH_IDS empty identity string should be interpreted as “the identity of the creator”.

+

ZooKeeper client comes with three standard ACLs:

+
    + +
  • +

    +struct ACL_vector ZOO_OPEN_ACL_UNSAFE; //(ZOO_PERM_ALL,ZOO_ANYONE_ID_UNSAFE)

    +
    • + +
  • +

    +struct ACL_vector ZOO_READ_ACL_UNSAFE;// (ZOO_PERM_READ, ZOO_ANYONE_ID_UNSAFE)

    +
    • + +
  • +

    +struct ACL_vector ZOO_CREATOR_ALL_ACL; //(ZOO_PERM_ALL,ZOO_AUTH_IDS)

    +
    • + +
+

The ZOO_OPEN_ACL_UNSAFE is completely open free for all + ACL: any application can execute any operation on the node and + can create, list and delete its children. The + ZOO_READ_ACL_UNSAFE is read-only access for any + application. CREATE_ALL_ACL grants all permissions to the + creator of the node. The creator must have been authenticated by + the server (for example, using “digest” + scheme) before it can create nodes with this ACL.

+

The following ZooKeeper operations deal with ACLs:

+
    +
  • + +

    +int zoo_add_auth + (zhandle_t *zh,const char* + scheme,const char* + cert, int certLen, void_completion_t + completion, const void + *data);

    + +
    • +
+

The application uses the zoo_add_auth function to + authenticate itself to the server. The function can be called + multiple times if the application wants to authenticate using + different schemes and/or identities.

+
    +
  • + +

    +int zoo_create + (zhandle_t *zh, const char + *path, const char + *value,int + valuelen, const struct + ACL_vector *acl, int + flags,char + *realpath, int + max_realpath_len);

    + +
    • +
+

zoo_create(...) operation creates a new node. The acl + parameter is a list of ACLs associated with the node. The parent + node must have the CREATE permission bit set.

+
    +
  • + +

    +int zoo_get_acl + (zhandle_t *zh, const char + *path,struct ACL_vector + *acl, struct Stat *stat);

    + +
    • +
+

This operation returns a node’s ACL info.

+
    +
  • + +

    +int zoo_set_acl + (zhandle_t *zh, const char + *path, int + version,const struct + ACL_vector *acl);

    + +
    • +
+

This function replaces node’s ACL list with a new one. The + node must have the ADMIN permission set.

+

Here is a sample code that makes use of the above APIs to + authenticate itself using the “foo” scheme + and create an ephemeral node “/xyz” with create-only + permissions.

+
+
Note
+
+

This is a very simple example which is intended to show + how to interact with ZooKeeper ACLs + specifically. See .../trunk/src/c/src/cli.c + for an example of a C client implementation

+ +
+
+
+#include <string.h>
+#include <errno.h>
+
+#include "zookeeper.h"
+
+static zhandle_t *zh;
+
+/**
+ * In this example this method gets the cert for your
+ *   environment -- you must provide
+ */
+char *foo_get_cert_once(char* id) { return 0; }
+
+/** Watcher function -- empty for this example, not something you should
+ * do in real code */
+void watcher(zhandle_t *zzh, int type, int state, const char *path,
+             void *watcherCtx) {}
+
+int main(int argc, char argv) {
+  char buffer[512];
+  char p[2048];
+  char *cert=0;
+  char appId[64];
+
+  strcpy(appId, "example.foo_test");
+  cert = foo_get_cert_once(appId);
+  if(cert!=0) {
+    fprintf(stderr,
+            "Certificate for appid [%s] is [%s]\n",appId,cert);
+    strncpy(p,cert, sizeof(p)-1);
+    free(cert);
+  } else {
+    fprintf(stderr, "Certificate for appid [%s] not found\n",appId);
+    strcpy(p, "dummy");
+  }
+
+  zoo_set_debug_level(ZOO_LOG_LEVEL_DEBUG);
+
+  zh = zookeeper_init("localhost:3181", watcher, 10000, 0, 0, 0);
+  if (!zh) {
+    return errno;
+  }
+  if(zoo_add_auth(zh,"foo",p,strlen(p),0,0)!=ZOK)
+    return 2;
+
+  struct ACL CREATE_ONLY_ACL[] = {{ZOO_PERM_CREATE, ZOO_AUTH_IDS}};
+  struct ACL_vector CREATE_ONLY = {1, CREATE_ONLY_ACL};
+  int rc = zoo_create(zh,"/xyz","value", 5, &CREATE_ONLY, ZOO_EPHEMERAL,
+                      buffer, sizeof(buffer)-1);
+
+  /** this operation will fail with a ZNOAUTH error */
+  int buflen= sizeof(buffer);
+  struct Stat stat;
+  rc = zoo_get(zh, "/xyz", 0, buffer, &buflen, &stat);
+  if (rc) {
+    fprintf(stderr, "Error %d for %s\n", rc, __LINE__);
+  }
+
+  zookeeper_close(zh);
+  return 0;
+}
+
+
+ + + +

Pluggable ZooKeeper authentication

+
+

ZooKeeper runs in a variety of different environments with + various different authentication schemes, so it has a completely + pluggable authentication framework. Even the builtin authentication + schemes use the pluggable authentication framework.

+

To understand how the authentication framework works, first you must + understand the two main authentication operations. The framework + first must authenticate the client. This is usually done as soon as + the client connects to a server and consists of validating information + sent from or gathered about a client and associating it with the connection. + The second operation handled by the framework is finding the entries in an + ACL that correspond to client. ACL entries are <idspec, + permissions> pairs. The idspec may be + a simple string match against the authentication information associated + with the connection or it may be a expression that is evaluated against that + information. It is up to the implementation of the authentication plugin + to do the match. Here is the interface that an authentication plugin must + implement:

+
+public interface AuthenticationProvider {
+    String getScheme();
+    KeeperException.Code handleAuthentication(ServerCnxn cnxn, byte authData[]);
+    boolean isValid(String id);
+    boolean matches(String id, String aclExpr);
+    boolean isAuthenticated();
+}
+
+

The first method getScheme returns the string + that identifies the plugin. Because we support multiple methods of authentication, + an authentication credential or an idspec will always be + prefixed with scheme:. The ZooKeeper server uses the scheme + returned by the authentication plugin to determine which ids the scheme + applies to.

+

+handleAuthentication is called when a client + sends authentication information to be associated with a connection. The + client specifies the scheme to which the information corresponds. The + ZooKeeper server passes the information to the authentication plugin whose + getScheme matches the scheme passed by the client. The + implementor of handleAuthentication will usually return + an error if it determines that the information is bad, or it will associate information + with the connection using cnxn.getAuthInfo().add(new Id(getScheme(), data)). +

+

The authentication plugin is involved in both setting and using ACLs. When an + ACL is set for a znode, the ZooKeeper server will pass the id part of the entry to + the isValid(String id) method. It is up to the plugin to verify + that the id has a correct form. For example, ip:172.16.0.0/16 + is a valid id, but ip:host.com is not. If the new ACL includes + an "auth" entry, isAuthenticated is used to see if the + authentication information for this scheme that is assocatied with the connection + should be added to the ACL. Some schemes + should not be included in auth. For example, the IP address of the client is not + considered as an id that should be added to the ACL if auth is specified.

+

ZooKeeper invokes + matches(String id, String aclExpr) when checking an ACL. It + needs to match authentication information of the client against the relevant ACL + entries. To find the entries which apply to the client, the ZooKeeper server will + find the scheme of each entry and if there is authentication information + from that client for that scheme, matches(String id, String aclExpr) + will be called with id set to the authentication information + that was previously added to the connection by handleAuthentication and + aclExpr set to the id of the ACL entry. The authentication plugin + uses its own logic and matching scheme to determine if id is included + in aclExpr. +

+

There are two built in authentication plugins: ip and + digest. Additional plugins can adding using system properties. At + startup the ZooKeeper server will look for system properties that start with + "zookeeper.authProvider." and interpret the value of those properties as the class name + of an authentication plugin. These properties can be set using the + -Dzookeeeper.authProvider.X=com.f.MyAuth or adding entries such as + the following in the server configuration file:

+
+authProvider.1=com.f.MyAuth
+authProvider.2=com.f.MyAuth2
+
+

Care should be taking to ensure that the suffix on the property is unique. If there are + duplicates such as -Dzookeeeper.authProvider.X=com.f.MyAuth -Dzookeeper.authProvider.X=com.f.MyAuth2, + only one will be used. Also all servers must have the same plugins defined, otherwise clients using + the authentication schemes provided by the plugins will have problems connecting to some servers. +

+
+ + + +

Consistency Guarantees

+
+

ZooKeeper is a high performance, scalable service. Both reads and + write operations are designed to be fast, though reads are faster than + writes. The reason for this is that in the case of reads, ZooKeeper can + serve older data, which in turn is due to ZooKeeper's consistency + guarantees:

+
+ +
+Sequential Consistency +
+
+

Updates from a client will be applied in the order that they + were sent.

+
+ + +
+Atomicity +
+
+

Updates either succeed or fail -- there are no partial + results.

+
+ + +
+Single System Image +
+
+

A client will see the same view of the service regardless of + the server that it connects to.

+
+ + +
+Reliability +
+
+

Once an update has been applied, it will persist from that + time forward until a client overwrites the update. This guarantee + has two corollaries:

+
    + +
  1. + +

    If a client gets a successful return code, the update will + have been applied. On some failures (communication errors, + timeouts, etc) the client will not know if the update has + applied or not. We take steps to minimize the failures, but the + guarantee is only present with successful return codes. + (This is called the monotonicity condition in Paxos.)

    + +
    2. + + +
  2. + +

    Any updates that are seen by the client, through a read + request or successful update, will never be rolled back when + recovering from server failures.

    + +
    3. + +
+
+ + +
+Timeliness +
+
+

The clients view of the system is guaranteed to be up-to-date + within a certain time bound (on the order of tens of seconds). + Either system changes will be seen by a client within this bound, or + the client will detect a service outage.

+
+ +
+

Using these consistency guarantees it is easy to build higher level + functions such as leader election, barriers, queues, and read/write + revocable locks solely at the ZooKeeper client (no additions needed to + ZooKeeper). See Recipes and Solutions + for more details.

+
+
Note
+
+ +

Sometimes developers mistakenly assume one other guarantee that + ZooKeeper does not in fact make. This is:

+ + +
+ +
+Simultaneously Consistent Cross-Client Views +
+
+

ZooKeeper does not guarantee that at every instance in + time, two different clients will have identical views of + ZooKeeper data. Due to factors like network delays, one client + may perform an update before another client gets notified of the + change. Consider the scenario of two clients, A and B. If client + A sets the value of a znode /a from 0 to 1, then tells client B + to read /a, client B may read the old value of 0, depending on + which server it is connected to. If it + is important that Client A and Client B read the same value, + Client B should should call the sync() method from the ZooKeeper API + method before it performs its read.

+

So, ZooKeeper by itself doesn't guarantee that changes occur + synchronously across all servers, but ZooKeeper + primitives can be used to construct higher level functions that + provide useful client synchronization. (For more information, + see the ZooKeeper Recipes. + [tbd:..]).

+
+ +
+ +
+
+
+ + + +

Bindings

+
+

The ZooKeeper client libraries come in two languages: Java and C. + The following sections describe these.

+ +

Java Binding

+

There are two packages that make up the ZooKeeper Java binding: + org.apache.zookeeper and org.apache.zookeeper.data. The rest of the + packages that make up ZooKeeper are used internally or are part of the + server implementation. The org.apache.zookeeper.data package is made up of + generated classes that are used simply as containers.

+

The main class used by a ZooKeeper Java client is the ZooKeeper class. Its two constructors differ only + by an optional session id and password. ZooKeeper supports session + recovery accross instances of a process. A Java program may save its + session id and password to stable storage, restart, and recover the + session that was used by the earlier instance of the program.

+

When a ZooKeeper object is created, two threads are created as + well: an IO thread and an event thread. All IO happens on the IO thread + (using Java NIO). All event callbacks happen on the event thread. + Session maintenance such as reconnecting to ZooKeeper servers and + maintaining heartbeat is done on the IO thread. Responses for + synchronous methods are also processed in the IO thread. All responses + to asynchronous methods and watch events are processed on the event + thread. There are a few things to notice that result from this + design:

+
    + +
  • + +

    All completions for asynchronous calls and watcher callbacks + will be made in order, one at a time. The caller can do any + processing they wish, but no other callbacks will be processed + during that time.

    + +
    • + + +
  • + +

    Callbacks do not block the processing of the IO thread or the + processing of the synchronous calls.

    + +
    • + + +
  • + +

    Synchronous calls may not return in the correct order. For + example, assume a client does the following processing: issues an + asynchronous read of node /a with + watch set to true, and then in the completion + callback of the read it does a synchronous read of /a. (Maybe not good practice, but not illegal + either, and it makes for a simple example.)

    + + +

    Note that if there is a change to /a between the asynchronous read and the + synchronous read, the client library will receive the watch event + saying /a changed before the + response for the synchronous read, but because the completion + callback is blocking the event queue, the synchronous read will + return with the new value of /a + before the watch event is processed.

    + +
    • + +
+

Finally, the rules associated with shutdown are straightforward: + once a ZooKeeper object is closed or receives a fatal event + (SESSION_EXPIRED and AUTH_FAILED), the ZooKeeper object becomes invalid. + On a close, the two threads shut down and any further access on zookeeper + handle is undefined behavior and should be avoided.

+ +

C Binding

+

The C binding has a single-threaded and multi-threaded library. + The multi-threaded library is easiest to use and is most similar to the + Java API. This library will create an IO thread and an event dispatch + thread for handling connection maintenance and callbacks. The + single-threaded library allows ZooKeeper to be used in event driven + applications by exposing the event loop used in the multi-threaded + library.

+

The package includes two shared libraries: zookeeper_st and + zookeeper_mt. The former only provides the asynchronous APIs and + callbacks for integrating into the application's event loop. The only + reason this library exists is to support the platforms were a + pthread library is not available or is unstable + (i.e. FreeBSD 4.x). In all other cases, application developers should + link with zookeeper_mt, as it includes support for both Sync and Async + API.

+ +

Installation

+

If you're building the client from a check-out from the Apache + repository, follow the steps outlined below. If you're building from a + project source package downloaded from apache, skip to step 3.

+
    + +
  1. + +

    Run ant compile_jute from the ZooKeeper + top level directory (.../trunk). + This will create a directory named "generated" under + .../trunk/src/c.

    + +
    2. + + +
  2. + +

    Change directory to the.../trunk/src/c + and run autoreconf -if to bootstrap autoconf, automake and libtool. Make sure you have autoconf version 2.59 or greater installed. + Skip to step 4.

    + +
    3. + + +
  3. + +

    If you are building from a project source package, + unzip/untar the source tarball and cd to the + zookeeper-x.x.x/src/c directory.

    + +
    4. + + +
  4. + +

    Run ./configure <your-options> to + generate the makefile. Here are some of options the configure utility supports that can be + useful in this step:

    + + +
      + +
    • + +

      +--enable-debug +

      + + +

      Enables optimization and enables debug info compiler + options. (Disabled by default.)

      + +
      • + + +
    • + +

      +--without-syncapi +

      + + +

      Disables Sync API support; zookeeper_mt library won't be + built. (Enabled by default.)

      + +
      • + + +
    • + +

      +--disable-static +

      + + +

      Do not build static libraries. (Enabled by + default.)

      + +
      • + + +
    • + +

      +--disable-shared +

      + + +

      Do not build shared libraries. (Enabled by + default.)

      + +
      • + +
    + + +
    +
    Note
    +
    + +

    See INSTALL for general information about running + configure.

    + +
    +
    + +
    5. + + +
  5. + +

    Run make or make + install to build the libraries and install them.

    + +
    6. + + +
  6. + +

    To generate doxygen documentation for the ZooKeeper API, run + make doxygen-doc. All documentation will be + placed in a new subfolder named docs. By default, this command + only generates HTML. For information on other document formats, + run ./configure --help +

    + +
    7. + +
+ +

Building Your Own C Client

+

In order to be able to use the ZooKeeper API in your application + you have to remember to

+
    + +
  1. + +

    Include ZooKeeper header: #include + <zookeeper/zookeeper.h>

    + +
    2. + + +
  2. + +

    If you are building a multithreaded client, compile with + -DTHREADED compiler flag to enable the multi-threaded version of + the library, and then link against against the + zookeeper_mt library. If you are building a + single-threaded client, do not compile with -DTHREADED, and be + sure to link against the zookeeper_st + library.

    + +
    3. + +
+
+
Note
+
+

+ See .../trunk/src/c/src/cli.c + for an example of a C client implementation

+ +
+
+
+ + + +

Building Blocks: A Guide to ZooKeeper Operations

+
+

This section surveys all the operations a developer can perform + against a ZooKeeper server. It is lower level information than the earlier + concepts chapters in this manual, but higher level than the ZooKeeper API + Reference. It covers these topics:

+ + +

Handling Errors

+

Both the Java and C client bindings may report errors. The Java client binding does so by throwing KeeperException, calling code() on the exception will return the specific error code. The C client binding returns an error code as defined in the enum ZOO_ERRORS. API callbacks indicate result code for both language bindings. See the API documentation (javadoc for Java, doxygen for C) for full details on the possible errors and their meaning.

+ +

Connecting to ZooKeeper

+

+ +

Read Operations

+

+ +

Write Operations

+

+ +

Handling Watches

+

+ +

Miscelleaneous ZooKeeper Operations

+

+
+ + + +

Program Structure, with Simple Example

+
+

+[tbd] +

+
+ + + +

Gotchas: Common Problems and Troubleshooting

+
+

So now you know ZooKeeper. It's fast, simple, your application + works, but wait ... something's wrong. Here are some pitfalls that + ZooKeeper users fall into:

+
    + +
  1. + +

    If you are using watches, you must look for the connected watch + event. When a ZooKeeper client disconnects from a server, you will + not receive notification of changes until reconnected. If you are + watching for a znode to come into existence, you will miss the event + if the znode is created and deleted while you are disconnected.

    + +
    2. + + +
  2. + +

    You must test ZooKeeper server failures. The ZooKeeper service + can survive failures as long as a majority of servers are active. The + question to ask is: can your application handle it? In the real world + a client's connection to ZooKeeper can break. (ZooKeeper server + failures and network partitions are common reasons for connection + loss.) The ZooKeeper client library takes care of recovering your + connection and letting you know what happened, but you must make sure + that you recover your state and any outstanding requests that failed. + Find out if you got it right in the test lab, not in production - test + with a ZooKeeper service made up of a several of servers and subject + them to reboots.

    + +
    3. + + +
  3. + +

    The list of ZooKeeper servers used by the client must match the + list of ZooKeeper servers that each ZooKeeper server has. Things can + work, although not optimally, if the client list is a subset of the + real list of ZooKeeper servers, but not if the client lists ZooKeeper + servers not in the ZooKeeper cluster.

    + +
    4. + + +
  4. + +

    Be careful where you put that transaction log. The most + performance-critical part of ZooKeeper is the transaction log. + ZooKeeper must sync transactions to media before it returns a + response. A dedicated transaction log device is key to consistent good + performance. Putting the log on a busy device will adversely effect + performance. If you only have one storage device, put trace files on + NFS and increase the snapshotCount; it doesn't eliminate the problem, + but it can mitigate it.

    + +
    5. + + +
  5. + +

    Set your Java max heap size correctly. It is very important to + avoid swapping. Going to disk unnecessarily will + almost certainly degrade your performance unacceptably. Remember, in + ZooKeeper, everything is ordered, so if one request hits the disk, all + other queued requests hit the disk.

    + + +

    To avoid swapping, try to set the heapsize to the amount of + physical memory you have, minus the amount needed by the OS and cache. + The best way to determine an optimal heap size for your configurations + is to run load tests. If for some reason you + can't, be conservative in your estimates and choose a number well + below the limit that would cause your machine to swap. For example, on + a 4G machine, a 3G heap is a conservative estimate to start + with.

    + +
    6. + +
+
+ + + + + +Links to Other Information + + +

Outside the formal documentation, there're several other sources of + information for ZooKeeper developers.

+ + +
+ +
+ZooKeeper Whitepaper [tbd: find url] + +
+
+

The definitive discussion of ZooKeeper design and performance, + by Yahoo! Research

+
+ + +
+API Reference [tbd: find url] + +
+
+

The complete reference to the ZooKeeper API

+
+ + +
+ +ZooKeeper + Talk at the Hadoup Summit 2008 + +
+
+

A video introduction to ZooKeeper, by Benjamin Reed of Yahoo! + Research

+
+ + +
+ +Barrier and + Queue Tutorial + +
+
+

The excellent Java tutorial by Flavio Junqueira, implementing + simple barriers and producer-consumer queues using ZooKeeper.

+
+ + +
+ +ZooKeeper + - A Reliable, Scalable Distributed Coordination System + +
+
+

An article by Todd Hoff (07/15/2008)

+
+ + +
+ +ZooKeeper Recipes + +
+
+

Pseudo-level discussion of the implementation of various + synchronization solutions with ZooKeeper: Event Handles, Queues, + Locks, and Two-phase Commits.

+
+ + +
+ +[tbd] + +
+
+

Any other good sources anyone can think of...

+
+ +
+ + + +

+ +

+
+ +
 
+
+ + + diff --git a/docs/zookeeperProgrammers.pdf b/docs/zookeeperProgrammers.pdf new file mode 100644 index 0000000000000000000000000000000000000000..cb1db8cd79e50a6769e233f843124727f15f5dde GIT binary patch literal 134096 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 m_C=C;fdB2l*4Px`m1# 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

t=Lk7VR(FCx+G0-fqu3tsDR`kd4h}}`l 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�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 literal 0 HcmV?d00001 diff --git a/docs/zookeeperQuotas.html b/docs/zookeeperQuotas.html new file mode 100644 index 0000000..597e9e1 --- /dev/null +++ b/docs/zookeeperQuotas.html @@ -0,0 +1,290 @@ + + + + + + + +ZooKeeper Quota's Guide + + + + + + + + + +
+ +
+Apache > ZooKeeper > ZooKeeper +
+ +
+ + + + + + + +
+
+  + +
+
+ + + + +
+
+
+
+ +
+ + +
+ +
+ +   +
+ + + + + +
+
+PDF -icon
+ PDF +
+

ZooKeeper Quota's Guide

+

A Guide to Deployment and Administration

+
+
+ +
+
+ + + + + +

Quotas

+
+

ZooKeeper has both namespace and bytes quotas. You can use the ZooKeeperMain class to setup quotas. + ZooKeeper prints WARN messages if users exceed the quota assigned to them. The messages + are printed in the log of the ZooKeeper. +

+

+$ bin/zkCli.sh -server host:port +

+

The above command gives you a command line option of using quotas.

+ +

Setting Quotas

+

You can use + setquota to set a quota on a ZooKeeper node. It has an option of setting quota with + -n (for namespace) + and -b (for bytes).

+

The ZooKeeper quota are stored in ZooKeeper itself in /zookeeper/quota. To disable other people from + changing the quota's set the ACL for /zookeeper/quota such that only admins are able to read and write to it. +

+ +

Listing Quotas

+

You can use + listquota to list a quota on a ZooKeeper node. +

+ +

Deleting Quotas

+

You can use + delquota to delete quota on a ZooKeeper node. +

+
+ +

+ +

+
+ +
 
+
+ + + diff --git a/docs/zookeeperQuotas.pdf b/docs/zookeeperQuotas.pdf new file mode 100644 index 0000000000000000000000000000000000000000..1455fb9967db33be6bc37771f044a6ef2e372324 GIT binary patch literal 11180 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 T3ir$KBw*b98#gLzsqp_lf{9pE literal 0 HcmV?d00001 diff --git a/docs/zookeeperStarted.html b/docs/zookeeperStarted.html new file mode 100644 index 0000000..361b334 --- /dev/null +++ b/docs/zookeeperStarted.html @@ -0,0 +1,629 @@ + + + + + + + +ZooKeeper Getting Started Guide + + + + + + + + + + +
+
+ +
+ + +
+ +
+ +   +
+ + + + + +
+
+PDF -icon
+ PDF +
+

ZooKeeper Getting Started Guide

+ + + + + + + +

Getting Started: Coordinating Distributed Applications with + ZooKeeper

+
+

This document contains information to get you started quickly with + ZooKeeper. It is aimed primarily at developers hoping to try it out, and + contains simple installation instructions for a single ZooKeeper server, a + few commands to verify that it is running, and a simple programming + example. Finally, as a convenience, there are a few sections regarding + more complicated installations, for example running replicated + deployments, and optimizing the transaction log. However for the complete + instructions for commercial deployments, please refer to the ZooKeeper + Administrator's Guide.

+ +

Pre-requisites

+

See + System Requirements in the Admin guide.

+ +

Download

+

To get a ZooKeeper distribution, download a recent + + stable release from one of the Apache Download + Mirrors.

+ +

Standalone Operation

+

Setting up a ZooKeeper server in standalone mode is + straightforward. The server is contained in a single JAR file, + so installation consists of creating a configuration.

+

Once you've downloaded a stable ZooKeeper release unpack + it and cd to the root

+

To start ZooKeeper you need a configuration file. Here is a sample, + create it in conf/zoo.cfg:

+
+tickTime=2000
+dataDir=/var/lib/zookeeper
+clientPort=2181
+
+

This file can be called anything, but for the sake of this + discussion call + it conf/zoo.cfg. Change the + value of dataDir to specify an + existing (empty to start with) directory. Here are the meanings + for each of the fields:

+
+ +
+ +tickTime + +
+
+

the basic time unit in milliseconds used by ZooKeeper. It is + used to do heartbeats and the minimum session timeout will be + twice the tickTime.

+
+ +
+
+ +
+ +dataDir + +
+
+

the location to store the in-memory database snapshots and, + unless specified otherwise, the transaction log of updates to the + database.

+
+ + +
+ +clientPort + +
+
+

the port to listen for client connections

+
+ +
+

Now that you created the configuration file, you can start + ZooKeeper:

+
bin/zkServer.sh start
+

ZooKeeper logs messages using log4j -- more detail + available in the + Logging + section of the Programmer's Guide. You will see log messages + coming to the console (default) and/or a log file depending on + the log4j configuration.

+

The steps outlined here run ZooKeeper in standalone mode. There is + no replication, so if ZooKeeper process fails, the service will go down. + This is fine for most development situations, but to run ZooKeeper in + replicated mode, please see Running Replicated + ZooKeeper.

+ +

Managing ZooKeeper Storage

+

For long running production systems ZooKeeper storage must + be managed externally (dataDir and logs). See the section on + maintenance for + more details.

+ +

Connecting to ZooKeeper

+
$ bin/zkCli.sh -server 127.0.0.1:2181
+

This lets you perform simple, file-like operations.

+

Once you have connected, you should see something like: +

+
+
+Connecting to localhost:2181
+log4j:WARN No appenders could be found for logger (org.apache.zookeeper.ZooKeeper).
+log4j:WARN Please initialize the log4j system properly.
+Welcome to ZooKeeper!
+JLine support is enabled
+[zkshell: 0]
+
+

+ From the shell, type help to get a listing of commands that can be executed from the client, as in: +

+
+
+[zkshell: 0] help
+ZooKeeper host:port cmd args
+        get path [watch]
+        ls path [watch]
+        set path data [version]
+        delquota [-n|-b] path
+        quit
+        printwatches on|off
+        createpath data acl
+        stat path [watch]
+        listquota path
+        history
+        setAcl path acl
+        getAcl path
+        sync path
+        redo cmdno
+        addauth scheme auth
+        delete path [version]
+        setquota -n|-b val path
+
+
+

From here, you can try a few simple commands to get a feel for this simple command line interface. First, start by issuing the list command, as + in ls, yielding: +

+
+
+[zkshell: 8] ls /
+[zookeeper]
+
+

Next, create a new znode by running create /zk_test my_data. This creates a new znode and associates the string "my_data" with the node. + You should see:

+
+
+[zkshell: 9] create /zk_test my_data
+Created /zk_test
+
+

Issue another ls / command to see what the directory looks like: +

+
+
+[zkshell: 11] ls /
+[zookeeper, zk_test]
+
+
+

+ Notice that the zk_test directory has now been created. +

+

Next, verify that the data was associated with the znode by running the get command, as in: +

+
+
+[zkshell: 12] get /zk_test
+my_data
+cZxid = 5
+ctime = Fri Jun 05 13:57:06 PDT 2009
+mZxid = 5
+mtime = Fri Jun 05 13:57:06 PDT 2009
+pZxid = 5
+cversion = 0
+dataVersion = 0
+aclVersion = 0
+ephemeralOwner = 0
+dataLength = 7
+numChildren = 0
+
+

We can change the data associated with zk_test by issuing the set command, as in: +

+
+
+[zkshell: 14] set /zk_test junk
+cZxid = 5
+ctime = Fri Jun 05 13:57:06 PDT 2009
+mZxid = 6
+mtime = Fri Jun 05 14:01:52 PDT 2009
+pZxid = 5
+cversion = 0
+dataVersion = 1
+aclVersion = 0
+ephemeralOwner = 0
+dataLength = 4
+numChildren = 0
+[zkshell: 15] get /zk_test
+junk
+cZxid = 5
+ctime = Fri Jun 05 13:57:06 PDT 2009
+mZxid = 6
+mtime = Fri Jun 05 14:01:52 PDT 2009
+pZxid = 5
+cversion = 0
+dataVersion = 1
+aclVersion = 0
+ephemeralOwner = 0
+dataLength = 4
+numChildren = 0
+
+

+ (Notice we did a get after setting the data and it did, indeed, change.

+

Finally, let's delete the node by issuing: +

+
+
+[zkshell: 16] delete /zk_test
+[zkshell: 17] ls /
+[zookeeper]
+[zkshell: 18]
+
+

That's it for now. To explore more, continue with the rest of this document and see the Programmer's Guide.

+ +

Programming to ZooKeeper

+

ZooKeeper has a Java bindings and C bindings. They are + functionally equivalent. The C bindings exist in two variants: single + threaded and multi-threaded. These differ only in how the messaging loop + is done. For more information, see the Programming + Examples in the ZooKeeper Programmer's Guide for + sample code using of the different APIs.

+ +

Running Replicated ZooKeeper

+

Running ZooKeeper in standalone mode is convenient for evaluation, + some development, and testing. But in production, you should run + ZooKeeper in replicated mode. A replicated group of servers in the same + application is called a quorum, and in replicated + mode, all servers in the quorum have copies of the same configuration + file.

+
+
Note
+
+ +

+ For replicated mode, a minimum of three servers are required, + and it is strongly recommended that you have an odd number of + servers. If you only have two servers, then you are in a + situation where if one of them fails, there are not enough + machines to form a majority quorum. Two servers is inherently + less + stable than a single server, because there are two single + points of failure. +

+ +
+
+

+ The required + conf/zoo.cfg + file for replicated mode is similar to the one used in standalone + mode, but with a few differences. Here is an example: +

+
+tickTime=2000
+dataDir=/var/lib/zookeeper
+clientPort=2181
+initLimit=5
+syncLimit=2
+server.1=zoo1:2888:3888
+server.2=zoo2:2888:3888
+server.3=zoo3:2888:3888
+
+

The new entry, initLimit is + timeouts ZooKeeper uses to limit the length of time the ZooKeeper + servers in quorum have to connect to a leader. The entry syncLimit limits how far out of date a server can + be from a leader.

+

With both of these timeouts, you specify the unit of time using + tickTime. In this example, the timeout + for initLimit is 5 ticks at 2000 milleseconds a tick, or 10 + seconds.

+

The entries of the form server.X list the + servers that make up the ZooKeeper service. When the server starts up, + it knows which server it is by looking for the file + myid in the data directory. That file has the + contains the server number, in ASCII.

+

Finally, note the two port numbers after each server + name: " 2888" and "3888". Peers use the former port to connect + to other peers. Such a connection is necessary so that peers + can communicate, for example, to agree upon the order of + updates. More specifically, a ZooKeeper server uses this port + to connect followers to the leader. When a new leader arises, a + follower opens a TCP connection to the leader using this + port. Because the default leader election also uses TCP, we + currently require another port for leader election. This is the + second port in the server entry. +

+
+
Note
+
+ +

If you want to test multiple servers on a single + machine, specify the servername + as localhost with unique quorum & + leader election ports (i.e. 2888:3888, 2889:3889, 2890:3890 in + the example above) for each server.X in that server's config + file. Of course separate dataDirs and + distinct clientPorts are also necessary + (in the above replicated example, running on a + single localhost, you would still have + three config files).

+ +

Please be aware that setting up multiple servers on a single + machine will not create any redundancy. If something were to + happen which caused the machine to die, all of the zookeeper + servers would be offline. Full redundancy requires that each + server have its own machine. It must be a completely separate + physical server. Multiple virtual machines on the same physical + host are still vulnerable to the complete failure of that host.

+ +
+
+ +

Other Optimizations

+

There are a couple of other configuration parameters that can + greatly increase performance:

+
    + +
  • + +

    To get low latencies on updates it is important to + have a dedicated transaction log directory. By default + transaction logs are put in the same directory as the data + snapshots and myid file. The dataLogDir + parameters indicates a different directory to use for the + transaction logs.

    + +
    • + + +
  • + +

    +[tbd: what is the other config param?] +

    + +
    • + +
+
+ +

+ +

+
+ +
 
+
+ + + diff --git a/docs/zookeeperStarted.pdf b/docs/zookeeperStarted.pdf new file mode 100644 index 0000000000000000000000000000000000000000..95d7fcfd5e5ac781f6281d82e3ba231fb8b5ef13 GIT binary patch literal 28069 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 literal 0 HcmV?d00001 diff --git a/docs/zookeeperTutorial.html b/docs/zookeeperTutorial.html new file mode 100644 index 0000000..e9c0646 --- /dev/null +++ b/docs/zookeeperTutorial.html @@ -0,0 +1,937 @@ + + + + + + + +Programming with ZooKeeper - A basic tutorial + + + + + + + + + +
+ +
+Apache > ZooKeeper > ZooKeeper +
+ +
+ + + + + + + +
+
+  + +
+
+ + + + +
+
+
+
+ +
+ + +
+ +
+ +   +
+ + + + + +
+
+PDF -icon
+ PDF +
+

Programming with ZooKeeper - A basic tutorial

+ + + + + + + +

Introduction

+
+

In this tutorial, we show simple implementations of barriers and + producer-consumer queues using ZooKeeper. We call the respective classes Barrier and Queue. + These examples assume that you have at least one ZooKeeper server running.

+

Both primitives use the following common excerpt of code:

+
+    static ZooKeeper zk = null;
+    static Integer mutex;
+
+    String root;
+
+    SyncPrimitive(String address) {
+        if(zk == null){
+            try {
+                System.out.println("Starting ZK:");
+                zk = new ZooKeeper(address, 3000, this);
+                mutex = new Integer(-1);
+                System.out.println("Finished starting ZK: " + zk);
+            } catch (IOException e) {
+                System.out.println(e.toString());
+                zk = null;
+            }
+        }
+    }
+
+    synchronized public void process(WatchedEvent event) {
+        synchronized (mutex) {
+            mutex.notify();
+        }
+    }
+
+

Both classes extend SyncPrimitive. In this way, we execute steps that are +common to all primitives in the constructor of SyncPrimitive. To keep the examples +simple, we create a ZooKeeper object the first time we instantiate either a barrier +object or a queue object, and we declare a static variable that is a reference +to this object. The subsequent instances of Barrier and Queue check whether a +ZooKeeper object exists. Alternatively, we could have the application creating a +ZooKeeper object and passing it to the constructor of Barrier and Queue.

+

+We use the process() method to process notifications triggered due to watches. +In the following discussion, we present code that sets watches. A watch is internal +structure that enables ZooKeeper to notify a client of a change to a node. For example, +if a client is waiting for other clients to leave a barrier, then it can set a watch and +wait for modifications to a particular node, which can indicate that it is the end of the wait. +This point becomes clear once we go over the examples. +

+
+ + + +

Barriers

+
+

+ A barrier is a primitive that enables a group of processes to synchronize the + beginning and the end of a computation. The general idea of this implementation + is to have a barrier node that serves the purpose of being a parent for individual + process nodes. Suppose that we call the barrier node "/b1". Each process "p" then + creates a node "/b1/p". Once enough processes have created their corresponding + nodes, joined processes can start the computation. +

+

In this example, each process instantiates a Barrier object, and its constructor takes as parameters:

+
    +
  • +

    the address of a ZooKeeper server (e.g., "zoo1.foo.com:2181")

    +
    • + +
  • +

    the path of the barrier node on ZooKeeper (e.g., "/b1")

    +
    • + +
  • +

    the size of the group of processes

    +
    • + +
+

The constructor of Barrier passes the address of the Zookeeper server to the +constructor of the parent class. The parent class creates a ZooKeeper instance if +one does not exist. The constructor of Barrier then creates a +barrier node on ZooKeeper, which is the parent node of all process nodes, and +we call root (Note: This is not the ZooKeeper root "/").

+
+        /**
+         * Barrier constructor
+         *
+         * @param address
+         * @param root
+         * @param size
+         */
+        Barrier(String address, String root, int size) {
+            super(address);
+            this.root = root;
+            this.size = size;
+
+            // Create barrier node
+            if (zk != null) {
+                try {
+                    Stat s = zk.exists(root, false);
+                    if (s == null) {
+                        zk.create(root, new byte[0], Ids.OPEN_ACL_UNSAFE,
+                                CreateMode.PERSISTENT);
+                    }
+                } catch (KeeperException e) {
+                    System.out
+                            .println("Keeper exception when instantiating queue: "
+                                    + e.toString());
+                } catch (InterruptedException e) {
+                    System.out.println("Interrupted exception");
+                }
+            }
+
+            // My node name
+            try {
+                name = new String(InetAddress.getLocalHost().getCanonicalHostName().toString());
+            } catch (UnknownHostException e) {
+                System.out.println(e.toString());
+            }
+
+        }
+
+

+To enter the barrier, a process calls enter(). The process creates a node under +the root to represent it, using its host name to form the node name. It then wait +until enough processes have entered the barrier. A process does it by checking +the number of children the root node has with "getChildren()", and waiting for +notifications in the case it does not have enough. To receive a notification when +there is a change to the root node, a process has to set a watch, and does it +through the call to "getChildren()". In the code, we have that "getChildren()" +has two parameters. The first one states the node to read from, and the second is +a boolean flag that enables the process to set a watch. In the code the flag is true. +

+
+        /**
+         * Join barrier
+         *
+         * @return
+         * @throws KeeperException
+         * @throws InterruptedException
+         */
+
+        boolean enter() throws KeeperException, InterruptedException{
+            zk.create(root + "/" + name, new byte[0], Ids.OPEN_ACL_UNSAFE,
+                    CreateMode.EPHEMERAL_SEQUENTIAL);
+            while (true) {
+                synchronized (mutex) {
+                    List<String> list = zk.getChildren(root, true);
+
+                    if (list.size() < size) {
+                        mutex.wait();
+                    } else {
+                        return true;
+                    }
+                }
+            }
+        }
+
+

+Note that enter() throws both KeeperException and InterruptedException, so it is +the reponsability of the application to catch and handle such exceptions.

+

+Once the computation is finished, a process calls leave() to leave the barrier. +First it deletes its corresponding node, and then it gets the children of the root +node. If there is at least one child, then it waits for a notification (obs: note +that the second parameter of the call to getChildren() is true, meaning that +ZooKeeper has to set a watch on the the root node). Upon reception of a notification, +it checks once more whether the root node has any child.

+
+        /**
+         * Wait until all reach barrier
+         *
+         * @return
+         * @throws KeeperException
+         * @throws InterruptedException
+         */
+
+        boolean leave() throws KeeperException, InterruptedException{
+            zk.delete(root + "/" + name, 0);
+            while (true) {
+                synchronized (mutex) {
+                    List<String> list = zk.getChildren(root, true);
+                        if (list.size() > 0) {
+                            mutex.wait();
+                        } else {
+                            return true;
+                        }
+                    }
+                }
+        }
+    }
+
+
+ + +

Producer-Consumer Queues

+
+

+A producer-consumer queue is a distributed data estructure thata group of processes +use to generate and consume items. Producer processes create new elements and add +them to the queue. Consumer processes remove elements from the list, and process them. +In this implementation, the elements are simple integers. The queue is represented +by a root node, and to add an element to the queue, a producer process creates a new node, +a child of the root node. +

+

+The following excerpt of code corresponds to the constructor of the object. As +with Barrier objects, it first calls the constructor of the parent class, SyncPrimitive, +that creates a ZooKeeper object if one doesn't exist. It then verifies if the root +node of the queue exists, and creates if it doesn't. +

+
+        /**
+         * Constructor of producer-consumer queue
+         *
+         * @param address
+         * @param name
+         */
+        Queue(String address, String name) {
+            super(address);
+            this.root = name;
+            // Create ZK node name
+            if (zk != null) {
+                try {
+                    Stat s = zk.exists(root, false);
+                    if (s == null) {
+                        zk.create(root, new byte[0], Ids.OPEN_ACL_UNSAFE,
+                                CreateMode.PERSISTENT);
+                    }
+                } catch (KeeperException e) {
+                    System.out
+                            .println("Keeper exception when instantiating queue: "
+                                    + e.toString());
+                } catch (InterruptedException e) {
+                    System.out.println("Interrupted exception");
+                }
+            }
+        }
+
+

+A producer process calls "produce()" to add an element to the queue, and passes +an integer as an argument. To add an element to the queue, the method creates a +new node using "create()", and uses the SEQUENCE flag to instruct ZooKeeper to +append the value of the sequencer counter associated to the root node. In this way, +we impose a total order on the elements of the queue, thus guaranteeing that the +oldest element of the queue is the next one consumed. +

+
+        /**
+         * Add element to the queue.
+         *
+         * @param i
+         * @return
+         */
+
+        boolean produce(int i) throws KeeperException, InterruptedException{
+            ByteBuffer b = ByteBuffer.allocate(4);
+            byte[] value;
+
+            // Add child with value i
+            b.putInt(i);
+            value = b.array();
+            zk.create(root + "/element", value, Ids.OPEN_ACL_UNSAFE,
+                        CreateMode.PERSISTENT_SEQUENTIAL);
+
+            return true;
+        }
+
+

+To consume an element, a consumer process obtains the children of the root node, +reads the node with smallest counter value, and returns the element. Note that +if there is a conflict, then one of the two contending processes won't be able to +delete the node and the delete operation will throw an exception.

+

+A call to getChildren() returns the list of children in lexicographic order. +As lexicographic order does not necessary follow the numerical order of the counter +values, we need to decide which element is the smallest. To decide which one has +the smallest counter value, we traverse the list, and remove the prefix "element" +from each one.

+
+        /**
+         * Remove first element from the queue.
+         *
+         * @return
+         * @throws KeeperException
+         * @throws InterruptedException
+         */
+        int consume() throws KeeperException, InterruptedException{
+            int retvalue = -1;
+            Stat stat = null;
+
+            // Get the first element available
+            while (true) {
+                synchronized (mutex) {
+                    List<String> list = zk.getChildren(root, true);
+                    if (list.size() == 0) {
+                        System.out.println("Going to wait");
+                        mutex.wait();
+                    } else {
+                        Integer min = new Integer(list.get(0).substring(7));
+                        for(String s : list){
+                            Integer tempValue = new Integer(s.substring(7));
+                            //System.out.println("Temporary value: " + tempValue);
+                            if(tempValue < min) min = tempValue;
+                        }
+                        System.out.println("Temporary value: " + root + "/element" + min);
+                        byte[] b = zk.getData(root + "/element" + min,
+                                    false, stat);
+                        zk.delete(root + "/element" + min, 0);
+                        ByteBuffer buffer = ByteBuffer.wrap(b);
+                        retvalue = buffer.getInt();
+
+                        return retvalue;
+                    }
+                }
+            }
+        }
+    }
+
+
+ + + +

Complete example

+
+

+In the following section you can find a complete command line application to demonstrate the above mentioned +recipes. Use the following command to run it. +

+
+ZOOBINDIR="[path_to_distro]/bin"
+. "$ZOOBINDIR"/zkEnv.sh
+java SyncPrimitive [Test Type] [ZK server] [No of elements] [Client type]
+
+ +

Queue test

+

Start a producer to create 100 elements

+
+java SyncPrimitive qTest localhost 100 p
+
+

Start a consumer to consume 100 elements

+
+java SyncPrimitive qTest localhost 100 c
+
+ +

Barrier test

+

Start a barrier with 2 participants (start as many times as many participants you'd like to enter)

+
+java SyncPrimitive bTest localhost 2
+
+ +

Source Listing

+
+
SyncPrimitive.Java
+
+ +SyncPrimitive.Java + +
+import java.io.IOException;
+import java.net.InetAddress;
+import java.net.UnknownHostException;
+import java.nio.ByteBuffer;
+import java.util.List;
+import java.util.Random;
+
+import org.apache.zookeeper.CreateMode;
+import org.apache.zookeeper.KeeperException;
+import org.apache.zookeeper.WatchedEvent;
+import org.apache.zookeeper.Watcher;
+import org.apache.zookeeper.ZooKeeper;
+import org.apache.zookeeper.ZooDefs.Ids;
+import org.apache.zookeeper.data.Stat;
+
+public class SyncPrimitive implements Watcher {
+
+    static ZooKeeper zk = null;
+    static Integer mutex;
+
+    String root;
+
+    SyncPrimitive(String address) {
+        if(zk == null){
+            try {
+                System.out.println("Starting ZK:");
+                zk = new ZooKeeper(address, 3000, this);
+                mutex = new Integer(-1);
+                System.out.println("Finished starting ZK: " + zk);
+            } catch (IOException e) {
+                System.out.println(e.toString());
+                zk = null;
+            }
+        }
+        //else mutex = new Integer(-1);
+    }
+
+    synchronized public void process(WatchedEvent event) {
+        synchronized (mutex) {
+            //System.out.println("Process: " + event.getType());
+            mutex.notify();
+        }
+    }
+
+    /**
+     * Barrier
+     */
+    static public class Barrier extends SyncPrimitive {
+        int size;
+        String name;
+
+        /**
+         * Barrier constructor
+         *
+         * @param address
+         * @param root
+         * @param size
+         */
+        Barrier(String address, String root, int size) {
+            super(address);
+            this.root = root;
+            this.size = size;
+
+            // Create barrier node
+            if (zk != null) {
+                try {
+                    Stat s = zk.exists(root, false);
+                    if (s == null) {
+                        zk.create(root, new byte[0], Ids.OPEN_ACL_UNSAFE,
+                                CreateMode.PERSISTENT);
+                    }
+                } catch (KeeperException e) {
+                    System.out
+                            .println("Keeper exception when instantiating queue: "
+                                    + e.toString());
+                } catch (InterruptedException e) {
+                    System.out.println("Interrupted exception");
+                }
+            }
+
+            // My node name
+            try {
+                name = new String(InetAddress.getLocalHost().getCanonicalHostName().toString());
+            } catch (UnknownHostException e) {
+                System.out.println(e.toString());
+            }
+
+        }
+
+        /**
+         * Join barrier
+         *
+         * @return
+         * @throws KeeperException
+         * @throws InterruptedException
+         */
+
+        boolean enter() throws KeeperException, InterruptedException{
+            zk.create(root + "/" + name, new byte[0], Ids.OPEN_ACL_UNSAFE,
+                    CreateMode.EPHEMERAL_SEQUENTIAL);
+            while (true) {
+                synchronized (mutex) {
+                    List<String> list = zk.getChildren(root, true);
+
+                    if (list.size() < size) {
+                        mutex.wait();
+                    } else {
+                        return true;
+                    }
+                }
+            }
+        }
+
+        /**
+         * Wait until all reach barrier
+         *
+         * @return
+         * @throws KeeperException
+         * @throws InterruptedException
+         */
+
+        boolean leave() throws KeeperException, InterruptedException{
+            zk.delete(root + "/" + name, 0);
+            while (true) {
+                synchronized (mutex) {
+                    List<String> list = zk.getChildren(root, true);
+                        if (list.size() > 0) {
+                            mutex.wait();
+                        } else {
+                            return true;
+                        }
+                    }
+                }
+        }
+    }
+
+    /**
+     * Producer-Consumer queue
+     */
+    static public class Queue extends SyncPrimitive {
+
+        /**
+         * Constructor of producer-consumer queue
+         *
+         * @param address
+         * @param name
+         */
+        Queue(String address, String name) {
+            super(address);
+            this.root = name;
+            // Create ZK node name
+            if (zk != null) {
+                try {
+                    Stat s = zk.exists(root, false);
+                    if (s == null) {
+                        zk.create(root, new byte[0], Ids.OPEN_ACL_UNSAFE,
+                                CreateMode.PERSISTENT);
+                    }
+                } catch (KeeperException e) {
+                    System.out
+                            .println("Keeper exception when instantiating queue: "
+                                    + e.toString());
+                } catch (InterruptedException e) {
+                    System.out.println("Interrupted exception");
+                }
+            }
+        }
+
+        /**
+         * Add element to the queue.
+         *
+         * @param i
+         * @return
+         */
+
+        boolean produce(int i) throws KeeperException, InterruptedException{
+            ByteBuffer b = ByteBuffer.allocate(4);
+            byte[] value;
+
+            // Add child with value i
+            b.putInt(i);
+            value = b.array();
+            zk.create(root + "/element", value, Ids.OPEN_ACL_UNSAFE,
+                        CreateMode.PERSISTENT_SEQUENTIAL);
+
+            return true;
+        }
+
+
+        /**
+         * Remove first element from the queue.
+         *
+         * @return
+         * @throws KeeperException
+         * @throws InterruptedException
+         */
+        int consume() throws KeeperException, InterruptedException{
+            int retvalue = -1;
+            Stat stat = null;
+
+            // Get the first element available
+            while (true) {
+                synchronized (mutex) {
+                    List<String> list = zk.getChildren(root, true);
+                    if (list.size() == 0) {
+                        System.out.println("Going to wait");
+                        mutex.wait();
+                    } else {
+                        Integer min = new Integer(list.get(0).substring(7));
+                        String minNode = list.get(0);
+                        for(String s : list){
+                            Integer tempValue = new Integer(s.substring(7));
+                            //System.out.println("Temporary value: " + tempValue);
+                            if(tempValue < min) {
+                                min = tempValue;
+                                minNode = s;
+                            }
+                        }
+                        System.out.println("Temporary value: " + root + "/" + minNode);
+                        byte[] b = zk.getData(root + "/" + minNode,
+                        false, stat);
+                        zk.delete(root + "/" + minNode, 0);
+                        ByteBuffer buffer = ByteBuffer.wrap(b);
+                        retvalue = buffer.getInt();
+
+                        return retvalue;
+                    }
+                }
+            }
+        }
+    }
+
+    public static void main(String args[]) {
+        if (args[0].equals("qTest"))
+            queueTest(args);
+        else
+            barrierTest(args);
+
+    }
+
+    public static void queueTest(String args[]) {
+        Queue q = new Queue(args[1], "/app1");
+
+        System.out.println("Input: " + args[1]);
+        int i;
+        Integer max = new Integer(args[2]);
+
+        if (args[3].equals("p")) {
+            System.out.println("Producer");
+            for (i = 0; i < max; i++)
+                try{
+                    q.produce(10 + i);
+                } catch (KeeperException e){
+
+                } catch (InterruptedException e){
+
+                }
+        } else {
+            System.out.println("Consumer");
+
+            for (i = 0; i < max; i++) {
+                try{
+                    int r = q.consume();
+                    System.out.println("Item: " + r);
+                } catch (KeeperException e){
+                    i--;
+                } catch (InterruptedException e){
+
+                }
+            }
+        }
+    }
+
+    public static void barrierTest(String args[]) {
+        Barrier b = new Barrier(args[1], "/b1", new Integer(args[2]));
+        try{
+            boolean flag = b.enter();
+            System.out.println("Entered barrier: " + args[2]);
+            if(!flag) System.out.println("Error when entering the barrier");
+        } catch (KeeperException e){
+
+        } catch (InterruptedException e){
+
+        }
+
+        // Generate random integer
+        Random rand = new Random();
+        int r = rand.nextInt(100);
+        // Loop for rand iterations
+        for (int i = 0; i < r; i++) {
+            try {
+                Thread.sleep(100);
+            } catch (InterruptedException e) {
+
+            }
+        }
+        try{
+            b.leave();
+        } catch (KeeperException e){
+
+        } catch (InterruptedException e){
+
+        }
+        System.out.println("Left barrier");
+    }
+}
+
+
+
+
+ + +

+ +

+
+ +
 
+
+ + + diff --git a/docs/zookeeperTutorial.pdf b/docs/zookeeperTutorial.pdf new file mode 100644 index 0000000000000000000000000000000000000000..5b3faf688c1b4adcedfa7f68c8cac9a163044d8e GIT binary patch literal 34208 zcmd43WmFx@)-H?$4GzJAOK^7&?(VJ&cNXrRpuru2ySqbh2o~JkEx3~l**n?$yyv{% z-S_)-20aG7s;g$tSv9Ml`OK8IV%F4{zguvMhXiA`AVkV zbATa`fc$s8=fY1S$Y~2QwRM0(x2wmghQx_5gk0^KT)2 z;PY*TI2q{~*y&jr8J_=G=-FxL*~sYW$tYlXd0_$8MlVXT{G}`b0i6s16YTRpDS)-f zvyu#q&leS53Pj8-fzLOl6R~`jD+DmKF#^2EZ~#8v&I;BgH7(v*O>qaWZ^c38N{@ul z652f|_dQ4ya-I*|TozI^2q+2x3EcI2rHZVAeuY;QA!-#GL6aZJ5kl6N;T2xRYLu*h z85c^=zr4CyURXH6-|UAT8Q!g$WWkhcbw+<(|ME=+zyQGg1^|%;1zxWYVvt=e zD4*UXKFeNr5V`p4(v35W+p#z2(eI*+n&;=YcXk$_Z?xVD^Lx+y0N%X4TX$y-Ir5@I z>g)FgZx(&oCE0$n;QBt01YqZ@<54 z)5C*?h$29shSd558SozNtdp?<8_i##0^$&4>N5hfpYa$hg1?L{Tq@*F2dOQ@BFME5 zT$oS39!d+?1kx*gLPnuLW(Q}8M+9JW7TO}TyrT7E>x#1l z_dq)Kk?l%YeOm$N1uIJkLP!Mc2GJ*?4hRn*Iu(N@5>X)_6@&QZQ$w^QhHnoaMTpw3 zi3TYw%pfNf`<4>qP2hT#y&RQXiriGeV*!E^-9ENCG|R`k5AU)a$5c#JfdriBX(1z` z7}-=~(z{L<>KE`A(06Yj{WA@}(vKv9Na4K0twyVcseU~X#1V+q4QH5Fp;q#48ulOp zzQ?`-#gd^8)*Zy!qhr%0#V zb{}ryg$UK7XLDXf$JQj(L;^#A!54l~?^2?922PD&T$vh^Jc1rRJ&1fPGRj6P=vLGy zRLY*r1S;<(G3v|-%}Kgeo}p~PZV?YA#E~g|r_7_Yd=oJU8;2d2Oz{yZa55GOfo<2TU#dl z*t;om^XjRrDcDK#$%x{CUFfA)Jh9Q7gmJ_Pn{O+H2Sx6M=TmG&^+meM-ldtPYlWRN zbt$Z>%|iDTSK7F0eF|g( zCWRw9XT1h z2%X`#_k9E%@6F|G==JEWOpP%C4ZRh^-+hrgKLBD4YL*K6OuwnEuy?y8*@d2Jqqe{d zkqjHh8)^{B|Ge5YuO`7LT{Lu>n+I`7b9x-Sg288j0GS%E2fDJ-mMtfQ9URvT9J z^H+0TH4ZgHH5N6^CbE?oChfg#3s0(0l2B!W;a!*No9bTGDkJ;JmmYOfmQROE)izuT zxPmw{TvzN~w)RdaT(z9xTyMF^IA%Ck493;;OQcKAX-zR~65?q4w3eGV8zr<5o1fNu zfkU=jtE{YjmI&T58>#xvg3b}{t<9FShSuK}c^m+Eka#$ekddP4BI(?t??&b6UY7&Q z{dGoLj#_$_kCw~l$_}><6?s2Iw#$AT^`Yxw8?2wd&dkWvEz%8L$!X92q3}Zybl2yz zPbp|Um?LL#>`tGSPdj4+zawqMm3y8T(ID;ujkP1z1s#n#vexHkgzeE zXfF5@)zxHXuh$a4SA0+Y-iLgJJVbPdE{8!v%U-dnoa1byzS&BCPHv_oTVoFt06JV8 zU}hwqVXBu{9iGif+G*JNHI%tndH_8XA0`D>0=dv5NZ8+@ku7Q&)fMQC2li-$GGXA$ zD#>h;;E4;6^^o9-xsAeXG27-vgU49JkTqH!%N#4Fli6_Dq@Ik>?L_7^J8 zOXA9&ixrEdAXPw2`R(k1?m6z2GYK$V0Xzo71}st61H`{%6NQiqPNw80D1Tx}w2ISC zr5Umto{M6lKtN&J5@-yyZzf^B9aUGEn*x*P_s#^Y^?n&A z^^$DU3DFqTp0EC@H@6QE9BPf9Dfdw!Dc@B$tEn>G>Zkmne6NbCVp8&?AHI})#zHsK zTXIDEjYdP6xn;y#Te4E2vf*aht^U&St=!vJZy{Mn=GAIX4PnYR4GOi*g!k^H7o{=U zt9}%n70ae5vLeQE#2qdB%@NJpI~4a#KW-ImNe%|r2U;G?j?C&*J#IyG<6=-6t4{NU%O@^RWn9*0)8 z7UxyVvAOe|hmo|s^L;MY<;RE0*JT(HI!4-uEt|l??3K#)N2oshd8kxKPFgPAFOd!)F|za|!r9EhY6xfD(5!|9C(zYo`S zt@=LDKXI5pf!f1Y{G@gN^U9~KwKnbyO@M0tviY1{0z{nb!Gll9N2 zQUWib9s)HEdW3Q1AvK{H4o8Ab2|}%nGp|>DvLC|w5=e()J)9H9-!zZqh#o2 zVaQ=b#K+6+!s%jVYxR6P0v9VwYX?pj9wPncXc@ryeEw2QN5l)uZEs}EsURfsXO-t) zJVd5Ipe-jIowKtutuqs?jlBsS0|y5O9X%r*BO}do4H^emYoNXhjkN>uF9|{b2Sa-^ z+n1RAPf13GzXjPk+FSkyhyN$$^S^8H>!vRXJyVcBZ?6cj`)wfa3)P{aXQg3eP-0}@WMtv|$#*#E>HnwH zKU)2??GI5uE&kg;{3-KqC4UZ$?cWC3+JW|`PtY3LSkXOScpev~e;=3U3!FbWnTVEzn?~bapM=3 zukat4F~MJtAD7fxHOZ)ga|6~{rrmmBo*uL-jlMXDUJ1}o(O;cI?haR&n7^+3!5D-PL2eh*M}Xe>&)cL>9X%2Xo-G7w7+4?wV}6Wh#5^d zdlFc#cNK-@*yhO(+nfqKA8))pKb#t#YvypU!;XLpO`3-xwkz*#J`km!^!Go1D)Dvn zPW8NjuHItzM&r_cMcn9)sXD@v%G@7Dog~O->pwYKHOue&7E)r@BT}>uN@w_t-X2^n z?OpX&ThxHqE3oi&a>r1A9=6LEdV!H;Bw?MyUb|>O5^A#DYxub1(2+&-C>zPv3PX_7^$iGi^feWKKA)=2IUryj5w(Ee_uk z$RzGf$LtD6f+a9xKB^i@Z6K7JlAuC;Trz$yi}lTCGU1?O<^U|>#KPMaimd|N%`b;l zKH8q8o~tW(*A1FPeGXqRjly^k!&|P?PRWl%1|?43I0%;=_0&dns?k7(FYhZWFFUGL z-q>%>8r-DmNu`0@>`gj(B)rBoMdl)mpm`sr6)Oyu=MVDmiOO<$LMH;D(O9Cr)ONX$ z!D{jVu#5RUA5U$C`7_>(G10)HX;x2yQeRelR5ElfIfom~XZfWFl{Y-t!x%MXX4#h@ z+mtqxe7_-Yt2D0H8U(7=D{P ze~`!CTHN1%^)3_&?dmoL=ixan)KzY$WqF4%u!xp;cL%dt>{7lr!_((%apCv%Qo(k{ zC~cF)M5H}Tp-qHXg5UNtGVlA1Hi~6Rck6AE^Qu=+yQ~;zx9xAv?9M9she8ioQMF~_ z8XMKJ(@3nzEw6lTbeq|m`8r*aQzwrU%Mb1&Hs*7AoI822by!l)O=h@FJWxEAxxMQe z)tD3@UB$)je4^6b=6rf62`nsaVqKMQ5V%Jb4UxB0IW7tP)BPqC%R%oD8L5_x9K1eG zH}a2fj9*Kmw-CYaA*exIjW8DA@Wfna)IdyQU1gv6U0}G<+3OUTws3eq&QN{GKT5m_ z=I|Iac_g@78|$OZH>93RwV|DML=NJ^yf~1bkNk4t_dVfFwB2_XoU$WXznBWOh3MPQ ztt9UBOYgP#=;uF;Vz*eemjWT1a*Y&p-VlAwXvZk{vQ?}}K92UO`vxr$Y}7lNRrO{* zOn!Bf0@|}V8*y?e$iAu>!&IwNXf>Pcb}NM655!kB7Y|luVJvoGLV*i*Q3_47P1$mo zO2(tFl9tJ&Q8O;ZBJPf%y*>o!5&T*%jPZ3}Y1x5vquE`G`fcxXJgn@rhS^QQj3A%q z234#@5+p3xw#V+j9axklh7nk-uuP7?%g^ro!@ zcJB(`6uzX|IbaVvH3pkbmXyGB+14PUcWf)=-SbnTdfLDVUAqkT?(>`k>A_gEnmquf z2BR`KXUKe70#47+h2K-9VR?J()QU>+*rLF+qRHC$x@ir-*Y%_x<9E{y^X$2Rk<_tZxf&hFdcO$4xo374<0WB@{jYGDm_ zUNt1J(zW`P&%Pcu1YE&cUEo-nEaL;nvUuSWrZpKZOE+3|l4%PzD$f@N)e8%8G`DKG z&)9|*xIhY2)d}fa4a35TI2lZq+3Z6gG{Q)vrZfSf0ORVga9LhQN$8Ox6L!X%!=X(5 zio9I-gO4aQ^77oH!&w;=ZqWCrffhi#58GYeC6g6!8sfpI<75@8;suF2TF|nRNIpB) z$C^@EGbj;Y`#_kcm5O1wbS3cVdR1q=yEm0xpgNK}NB&xdW2|fP1IhsCzW*PPj{Y~& zy+qXt00$dKdqaQ&!5?w;bI~86xSYNT;H82zz{pHrz{Z6@^Q9r{bHbR7gHikCihv~m zVDulaDA}7?{l^P(`u5KOF2M`f{!BUx+E@c$B3^=@_^a@eaQ;OPerBd$($|bE9E`sU zUzB_)WT0nb`Ca%c8_&SX!Th`M7ysbq{tM7wD91kl^kH=?n^aaD?+n?_r%{o>qXEte#@**#@XHneD5DnWMlMm?Ixcd zcY@=Qtq^%}JIoQW2^Wg%bf^)G^W%|0`qZ>SW)4w@ocWPB-_^k3cXTkJYi=xENXtxf z%v)~&Jx!(HS)CY`KJ4iRJOtSVIaGSROBY>t^$lT1anMkR?jz@5UVa;@iztH*Wz+n{ z)mQQLSLeE*jWZJkKHsgX!eq-ZK12nl;~jtJley!f<&{%9P$Q;OM;6&Ijt!+fICoC2 zc=*E(Siw;rR$I$LW{nMvLy76_h7GWkG=zr{yXNu2@edSA#l*wISSbV*9({qmO@y%0 zh%V{)L78j59d_o)eI(5z8<#<_=QK1JAr$zb@bPscayjS@_TtXu2}6nsc~nA%(O|Be z;@u@gI{gr|woh2)?-#gi91;1M_0bS6dNGRM6-J``P=KhE%EbD4>$0tK-=iVtdEueSS+K{ZSDZrT6IX zC^IPabs#rOfJh5%pPtk}K`Vd!9hsTO1pTM#*DVnfH87a5Wk7h=wHXZ$(n9R3;T$dD5m(YpiL~Fs^El7%cadYkJe51ho zCRe16u`M6;CW;AFaz)G7L-iz+oQ|drj0S*^YiuT0+$QbEGw-GlzP@4wtoJTuq$Y$` ztaR1r_3=QiMvP37z2cs;Y_8oZ!W5;6fkQAEk_A-seE%=fRpN%odtu~#AFkdPji&=b z?hcsEk%R_odtos=J^hdZwD60k^S2I@Z;PTR;|GOFOd5%Zzb+24#Mxzp^oXM5?@RJ{ z5Rpt#kq?>)dLykiwNO8PXVyz55>C$z@$sX5@?)>bWxioe>7$4t$UXH5*9EqS)AFu= zkZ==&Fe$M&5yC8O2`d027FLCy0__rvfAqj3;4g*lVxBh`{I+@S+a<%693Q{6pRYH@ zHI4bERK+#hg|2Xyr3F^LQB8(H4ZQGiGYAQq76$aI{3s1($H1BGdxHchSk#_2O@kvf zDqMmo{hH{RWmCnEQmWz;eo$MV7j@VOtYb8}ro~j4r}W+*dqU)q$(S-WG-pzKgsLR& zeo(wbxVI)}e&JPc z3t%DbyU+k`ZfypBt%ioQL)KwaDr`ixqV5SvCL(C?$Gz(Sb}}?RRo$jmIzja068~ww z;itXHN`13Y-3%^(n<&fhRu zc^EU{r9>d-H*y~fi&9Wr8T0pWEGNM5s&_pP$JgY*Gez+ZKZkt>#`ZaBHs7%0x zEZGND!61kBQnyPHTIwp`E=Rbm-`*0bU z*lfBzOae-^4MS#2MQI)%ZKv;~r_+@CP8YrD#I|Q3dNkh;`l@uEF8yGJz5r!ZsWgkG z&5w}@4rMtwN)8o2w}{T0_NKHONcnEgfF;Ld`$JVeEAk|F-Y2^0qq*GFy4>?Rv zgJXC_rEaA6A=BDi!VA7$gO0Z>MD#S*>ERpNG+_tfEkcVd=C{R#MNcgySBZBOI~Z8j zCKP$1jxz|;iESjv5?+K5TfY5l5%Ln>)GX7Pf~G>(Y)hY%E)gTG>HJ@y?_YCp4F9_H z``?1~FVOt2SpO>*$iT+P@EgH7{>1vfAvohp4Dt^Uy!IKv7g&*=(scWyB@o=aA^j?{K(Mw zPWHi)SRMD#(-|Sjx zvhx9{d|gKeZF!zXirA`nOb2_vxj4smHLOG~d;2V_Pql9`MM0FhIn9lPY0egQTVB#P z*ZHT8MG&o2;B0b&0b4raW^+r1ZD#}#!VvtYZR!ZAb@DCkxX| zh_>Mi$s65}1DDK)C9B%<_Y4Ni@7~p!Oi4e5C8*i9MxfrV#ebb+&0F7iGq+itm`fsR z0F0k1wLcZ`=zz$}IE5>mcU_qJ1PH=GNl3r8i{RmVUuR~YojJP-;>kwe3f+%LO;+K# z4E=eOv4C-?R3u?ih=qlcj8|?gSYJ3WbCq}Vw%&`3K{6m$M&|fTmSb*vRJ>C}7o}yp zWKws1z-;L*zu2zgHU8WRrTBGYD;=f|VU@nA^h7G)cJmdnh&7gnhLp^^{FsT1JEB=z zdVGEnXAXJ;COCeR;8JoG_VzP4xoS6$j$ZIr!F|j}=A{hCvD;E^5buT^uoaUH+*G{7 z4z81M$q!^uv6f22FbJh6t2@>@NG%_W7io+6(j6Lq$F#H49u)>yt z4yxJpBFPZD?!}=a+2j4FgJ7#xVMhrQV94__39=fs7Dp-@D=n>(RM}Ej*}vr~2aacJ zC_7I+8_Ygb)}7LDDDg-`1&|p$;?UXY!u>!#URnCd8dq>Ea19gPbCgZC@Pdj2qZL9C z=ks(%MX!!Q=Xz?i^2&b79)!$?!{fPu*iUeMe&w#{bj+BKNDpwPW5o=tT5H_t#@I;< zSLdImxIfqHn2;L3Maq6#(#?w~%%B2-%y<(|PTqyJuyy_F!JWOtSG|8L!NzuW%l&Ed z<2$_Pwe3#uw#QC}&X~K$XfZbBW{2TBmHuox*Av_ZFB>ebfH8{I8aVWG)sVTM?PTFJ zJvDj~)y)xoDm0y38VQ2gg+6#l3iE3fx*IDAHj5yW`>S(5M#}0`(EButX_yE8ochR$ zu=>ryx#77vJdb4dc?5jq9H68-#?tUn&s2dkxbI>V+bmKLcLHgd>T2QG?(q3|@puNt48D!1&4~!x1_s8= zd_V_7YiDm3uV%yN0It;75gT2|O*PsEe}X$5bve5XGCft-JLTTQn3$=cH9Gg)ilxqF zqke}p^h5Qy5047YfWj6NZ)>y-bhw^u^Aug^8Az`q3DjeOTuTEOr z@w?K`$&0b?Vkt$rzifZmcR4>gF?U%KMT50{mkq?F@qKK^*11Mz%c!BiWy-uf8o2<` zaJv_tcCOXaR{m0h2k>knrE&Q5cvuQ-h)@LRUK+3kn0@)tim@BpKUt089os7Xs;pTl zFoQzqJ@t8d%^N{yV%r%j3^Q^a!Ee~I6Vw1Ah6D;{RI~2 zsuE{YIT!3*QmTe_g4L8&N~_7=c)PCC-fnbx`MXYDNUBcmw}C#ZilkR8Oh;jPeI3&!NeU*yx3g4uocF=4{@8>7 zWX!2U+C`pVNoavXd=LnWBA07DB%w>#6C3O%ob%BtAyIQt(EhsN<9S{xG%V()diRKM zEmWLL&F!Oz(3??OTTXn51s)qU=o0A#o($27Of&Z`#X;vg4I9I%Pr_owres%JHXJ`d zVN6IC{zDMJ{u@XCn+X34y8lZM@DtmAa(gy*_Fq8&iSP8h+1tf7S!&ax_PYCwBKhI_T*EEYA%VtvRCjVT}7 zeeSs|&|?3I!_{O+V_RcoaTv^q+v8rMnspxByoOgSy?>Y60@+AGcD20Gi0r%hjXAKGo* zVp+D9LTo*C+^5<~qiHLJf7QJIo0ViVLPA5(a3yQ`LWFhaLfee%k{LTon2(&aXi*9b zD{$q)63T4ISiz{F>A;O2$+YZv!HH+btg?-Cz+O1;ZadFkD4})^R#LmXOKeFh6k;hr zXgM82884Wb!d|;AEibE&jBX2_mZ7n?a=C7#xh?S18j}PZ&s#%I5#Ms;5(eY4BPA;~J;?JM~Dr5Q_K2!i0w3 zq3k^E&vMwJgR$bjhuxk=3Np9VR$DDtRZA#fO`Q`T!J?mf2a zt97P%#AnxIM$u&~Wx~p7`uT8v(<{5hPRb$Tv_PLZt8vW>_V$h91TjD68!ViWl)mk2 zzqAKCOIW_yeeScE7>Cz>)iF-k$!2~M+B5V*ux1}436>&?p<{OPg>_Vt21{0y8@>Qy z(xx~P&61iR++i_;0IKm;{R{5~>;t~b#6x7vA1Vd|+HicN=4MddPeObT1VwrjvL4HP z-oj)WwF!$3+Q|2QngZXzMMZdZ_spTm9FJC9zErqfjTw_jD_$+6Pz}y`3h@<=>NTb> zHXqGq7<(T{j)GdEq?q5Q&G&XHgC%O_j|jKOox=ef%VGu;BerGsyCMpheIb-1M)jC$ ztAw}^Wxhgs@^SqRj*>1sy1QM(>{Ml^>;(`MRgj^(l|0*XAhn5gfm(y@a*~sj6ryT3 z5yv2}1p_RiOD&M}xhyQYuP^g(vNv@l!1?3ryM^XVr>CS>-oWTo3ra0FtWH^tN@^x) z>2y=;zNLo&}RH&;FCEmj7O#V);z3- zQkMnRo-KQQA0J2Fu_|t&b|1A|Kma9g9Tb1z;FS)KGKF%o7+7dPK^PA z$~wfuyCEeaf!b2#i?7mZ8_dwaL{w4W@DO@4K>h5-+pQkM%TN&i^KAAsL!v(hqm$&7 zG9kDDX{;tXbzJ~m2sliZlWz%>gdWs&<=}_b7@pe;;#}mE8IfZfh4iiA$bCU8RVedL zQ$EAp`ZSoM;K}!cuqsiFv3zbt)vn5hKNN9?$S$V+PP2L}q;SeD4vjBmX4Cp@&B%Z! zx{`&%_AJNf2<4`S+vrEroZH@y)J-cCBg)Cv)w#sxD0vQvg2<%xngKk<4EhpNSML%| zRBH2k&&kU1Lb$m50z3?JVb{DCa>2WY+I1o^)sFXLZ}%Kt^k`x8?C z6?uPW)mfQ2ek1Q+xr5&cbjF{|{r`@1BzCe+r3f)dVB&}Ml#5pPjHj%v`Sn{MeqFJIAKkfbX-$bh z6l9sj^u~Kbf0B@WjlXI&-?nlZmj_Q=*@U&zi{oTYzkqE#YA4NRzs^o?Idh=}gI#Lp zez;w-1RQ14PQ(rL-{TK16ny2Q!LG36VK@|)I(BYlxCB#M+5zWBA7MyLPdsV?NRK*; zH$H$z-Ph!7qX~M@u&kJL{D^W%PexTIsKlEd(2{l`swpACGsR?{8B8>ae|7a&zcJ`zrObPpnRbbf4t&>hI>ouw0(6%Qm zJ;@CdJ-VJw5Z`}M$K6JbnO8%LC1c{Q(lLa}aHq4(G z4^?XbE$K6N!p6tMfiwrAWdTYD@8b7}$%x;dfObym}GqLj*ti{AyC zeJ0Sowfk&f_ASIxsobLE_+l!}l-K>-+R2p_HL@6|^jiK@Na8>!Yl)0C&29*#c(@6- zOkQV*LH*LZwA0RzY1>vvO$l>S4JecFe!zGi=1>-;|ClmI^y_<=sJ`v_*t}Nq$*)pH zM#0v(gHHCYbu{9n_@Cy32*uH$rKeoQPK7N$$!i^Z`(eN!MmHnAVcHg`O>HVe4r~gt zQ=OiLWU%5HP}CZj5e#m%V1vm~uFjRhVP_*EWX2*O9tMZy=56E-YE|@e5eiX(mG$JH!Yy3eL0WzYSuTozJp9&&6 z3yVc4qpQYIDh3UqIq1KYaAHK756Cx-2peR8W&YxlO3yya`gpKK(?xeMC6SvxP~_(Z)r!%3M6%WvUJ>5X_|>`N87sy#^UgTSDy;~28mIQEu!d3# zcPNhFplNCg$agyS<(T06E|H8DKW_L6d608=<5j;`;x2)!Ek9k3uH@xFwN{ZghYTng z(F@}wZ&1j}Qk_T6R1Zbwo0RjmHK%5zkETbajyfPB9Q0|Kz^AXc0=#+Lx!M!yj1xj5 zX>!%IQroaq4OY1aX^dnns$bzo`i^n*v$Xa1`?9{*hojbnR_so>hq4e!t-8EHAgL}Es^wtQZ*|l2aVwRJtgBzA$B;@RVO8wBVui7E97W6WUNy{A)=}D z>Ewe#yjVEIDWYE15sp(@OXVU|ZSSF!3#n|(H73s}W%%VWhvPdaj&IV;?pGTFUx zeWC%S+&Zo@a9y(99JhhL{JQ1H!ZL20OJgEE`uHTxgO0a>Vch7(?!1y2F1@1t)c-~g zp(Mbo@O<|N{5qfB%!K8CfbC!F$(pD|O>xj_r28}g^10;A$74U*1V83j zsW-BoBGI=b61AVFy&mwVdHa-ZaPy4XEa}d?jt8mFye?MuPwf7?(}?iXo9Ex(1KlolcbqWcTiInwIMjcY&^Y^2Djb1pQ_ujn}er2 zNQWF0f7fK5KaF*$G!W)&bcKV_7=_yB8>qe6s9|a^ZZZ32`Vu%QO8Yh9OX=R4MqaHD zfgDXlo~E^Bc0UXczGlLKa3$_%0_Y9)IxsX>oz`uJAyw|iR2bovvC~TPLB>S+VMm$X zJcr&q1M!CAHX{HlA(1}Tx9SO{+M=G5J_XwNEvZy^aNGct2{IDcD1Bh3mpk>i3ce+-3}xCb^6O z$#sWVE(+dtM~gP2Ub-wg@~xTl5iHU!nWAPAJChXx=p^C;H(~)U)|w#(HSi8{m|f+=D*USx4LzX5}6U&Xa_VPHLnCQu%hotDtjX zW<0d=T>8q>1Yhfo-v}}l#Go%Q3M^$w)zT9gNos*oT&O-x4Qgct;#h+cTo@&6vkpEy zv{TxrQ?zQVyeQ8sQ@dU|630?#%+cFy3K!rnRp2aIyo{R1MO}?6{6$rzz>~ZQwC8bxvC& zH<=&Y3FTr8`nc`Q4+y`M!PpL%LL0!D-%1%S*iYTswUPVV6v2d0+1f z``Fj!aBPV+6=`$G`!(K5vl~xM7;`1zD4tY%p;?jIS`$q7e0BQ#o=)2(-Vy+6H57Ln zLNK-mE9>d-b-NJ`x=4}_bxwDue_tx`Ah^HMDv3RAfCfqnkT!KTWvppNbMp=wIYM8M z^ynjNZg?!Xq+;D-!`e5ywE7}9DwU$?#NFpb*}WakaXxEFkR=X=m~SK#e4n^wV;JUU zJ6ew40Y?}coKY%c)8nPYRg2aS!q=s1)yk}1eKD>?C|%dL zKFQtvdU1-L&)aB!%wwYJ%31fWnDQo#C>3;-(JMww7^PjHTxMAWe}NA^14EjQr_kAw z7c(iBl{C+4F3_`fkHKgn|HKJH2`@}It6Dn}&buXi98Z%D^F=ydW{Sfk#=gbN%dD|4 z6=j2Tw(c$U;&N3>Lj>4odMs3etVJVr-m>%f2ydz-ulX^n!CsOyh6!Ep(Qx~RCDWZ| z#+w_vO>OB|3GovY`3eBA#d5n|u-RKq<23{~b=2JS#4Ya^aQaM=$SF><-2jI~y0$w5qNxI%ISE-ASAk$0&|g{fG)} z=my00=TDQ|8A&_JS|kpF#ih}%DEVX~WF}YUX9ldU3oH?K8dxP97QuISNh-3NckidW zYtOx+JKI*s@cBTUPGO9Cl!%3 zcWPyswgfn5bFGq5vbW%Q;zkV&q>ejhZ;ij?>YSBx*x24{+(G&_0Db5J`UNvfA5CF1 zS<%EUoy@VUSRqQd_)CC&&IWYUWEsP}{a5GDWmi1l4;L^&427}UMeOz48f@j9=9*I` zNAn#?M(LL8B@rgfH1pBa?zkpg7G728J^j}_0?zjLU0)1R7S;OW7U@t;nem7+%YDh0 zP?Atwf!{hV<*aS}F3djoLVhFe?@{x=kjp|kB=piN(hAQB;fg2d_D}UO`r4zJ%ooan(nGsW8*)+fAk6zboCPy~9e&=WothZVoPbxH z3Gn=uVsD9oM*49u@Hrn(@OG8afHtLL)&<0$8lW1(1xQPSblX)L>H#O&2q#mGf~zNx zHQDwpXO3`*x`u&RB^CZtdZ*2+AUn_wyB&G-F_$9K(sIt=v0}i}nNT{1%JGDCy8Cd+ zA!u;VIX$UhBO`&#*EcS8Y8|!e7ch2qK3Z1&1)tihQ>2ywbeTtC$(tzC%(Zy(tCMpw zAFGe-Db932X$6(;nLiAvkWzeuFTQT*!}F=-exe;gw_l>_xDH8H>dYme99Q3_gpfd43dp9VqNP+6^y&9tkLOK+?}A~i{q>}pWs?}woRr<3*ej9XWw^+S}&ktDx1$p--oQsO+<8WZI1>_ zeyN5x1%9K#v5t2d<|Xm=F7#kCZWpFcbxO7)J3AFyYj`&Ssz8rMQkb9xwr!t-^VN$a*E&^j3I& zKqyr0Q;ainV!ijjU*R~1;$($?6x}+l$4lbP3nnux2g%xrC4igNXOxi@)|eeSjf&fB z1~L=79p$=xTb;dxvgU2jD|1L9)jhb|TfDAkEWB+@J-9cXPj9iLv~Xii^IYMXcdy`UT))uhO z^!528Bbo#Z^o+Fh1kCJAw9Eu73{12f94rLP9L%(g1lrG^6nU=j(i!wGKLl*-jh;UQ z^0yLx0;WGUhtr7>(22voaL_+r@?`oeKKOspf|dDMm)}~jG1IdDGcEquIQH*a{6hbi zMdCkpum6+2U}mOe{YwiLmgk=NM}6@}^zm<6F#kQ=_~%+MvOJH$@4jGSeeRimq6PEM zop7-KuEnoh{{LHF(6i98)6>)c(uA3SnSu4Wcm9zke|$pb-!=LB0>VG;4<>e2TIRoL z!a~5r!S)Zml=)>&DEx;$`TymmOss5w^HL@@wtwiQ%>Rp*GXICn4D&zC%)~88+Gx&T z1+F!EK?IL<94_DAUs=s!ijNNwh`d5GP4=~9ssj-RQWTm!d5-etq#7z9&xCd`khXKS za92sueebt>llMcXZ_m3nf9ifA^oLgWt*6~oR}u3{yG_fE)0XSQ^Gn{YX=lLGp+MPU zZ=FTyC0$ytJ6E@p;KzG!T>Qp}iQF#H(F7Y6KAjeAtqGv;eevzp*}CjXzOttFlRfe@ zjq<47<>{DoJ!4Q6ZSK{wDqv|*HKD#ZL#K7l>&eRb@pPh#tyr~qudiJ(A~qn)PMI72;sCI8RLx=XcN9S|>K`$Nc zr=#`ep}n@2$NeX%NG&+4#oSwjIm+7x(bH?F1)P5IH)Ny_lf@bUMngZu^Oo7<(S$IJV!aCI%=+FF{j^|e#|=H|90j(`o79$R3s zfy_aoCwI$vU(3Cfdj3Y!v?EpHbyGQA`SKDsPx68;0>-k<2_CESMkf~zdAY&E{`(0# z!}5b=NoX_goQ9J2wt2Og+nkKDT}L>(qsrLzVpZ=}_gO1G?l%17K18X|gVhObOEOXQ zjGVH3Wf}J|#fgcmd~F#+vCqSwt=!%^R$@9 zTZh$nUrk7BtOmfUijO9!HAI8*s*0~Bgf)Bv%j&d`Cb%_jgX8M7V?7%1*YSM*>xc!` zza0N6aJz#BydG}x%yx({c`P1U1IlV@0sFnhXPVDPZVM=;Os2k?P%l!KhW(C>`JJmj zH>-~=QSV!$JFtr~X>`=o%gL0Ka#GTIKkhy`1OwWaDP1*wN! zq_i#Wc>ab5=AGZdL$-Mb>KC_IWkAeL%2<)dp7XM;US@TO< z$9e{)A*;!ypW+u@#P39+h)P0RSi=;9@Q~aJrnMGsS zR+GwfZB<#EV`-Mf8|~s<4dI!hCY7n$qOvJqX`Tg(cJZIKC)9HHYv38tAXdeTst;wC zY{^fbkyyA!*K!YNqyuRtYNcivwGXayZyIU^@1Z15FUSOOo9(^wysRmB_xlvMdEUO| zI>ij}PSiDOo@@20Zf*8%@pSV&V|2Z5a9vEL9voqieGZMt6t_m%rf-OP zbNapJ`-MxVmahWVe>oKm#L{1f@Dj}*2k8>c%kitzz@I(pcc;Pq@+q)Cdg|Zza{>Qm;Nd7KY6L>|Mb%B4lBNp3l*99 zhcj|U&+#xtTtt(Y`$qZA0{qavi~B>fQ z4iN~RcL^)Es4`Z~%Oe@K<|+L5_hgH6PNy)=ZOtGW#4+p_t>MjnFgxqy!5yZ=l?W!-SJp|?LQ$RR6?0|R@1nr z`<4+x_6S)S$=>6(5@j}wgoKRj5y{LRiEPTs9@#5NR``AH`zGQ0Jm2s0{PTNy^?GqG zpU-u!>zwPl-shapIp>;a%9C)=Ah#R;ZHWI_o9;3-qeJJ9UUevK?|Y8lx2m$2DaQ5b zf!MSiq^NK~iV7E`@OOd~E}WR7S|R~=0eI#475>3L!Vb%y&_ajHIx`g6B}G5O1}Kx9 zo>bKO%Z@YP#2XHSygW`H@a#0tmQjDi=1OGg55nYj6(d?om5|GdBQBjOh38WU0e?`KQ*gAn>S) zVT4@uOV_(g%sC_ak8C1@dVbiy^u3Tz-kq91a!0!0A4G!2b9!~@bBJi)lsp9ofLpLe zpE*#Qc@TznAs-VbF)vr_CN)O zDc^(zqa6=LVFX~?I*J}P7RTjb#~vlusS*KWI)8`FdV{)@e_7XXl} ziA~8rlOto9H1NuKIwl?1fx|qJo`Im2DIo*^?tt8Y8DSu9zuaUyjZqD-E9_B)0WsV{ zueA+mA#H<%k4h46|l&;ZIl>{yX8RlB(Z;&lXF^;pXdz>pwIr0 z4~lKq2n=FkFb;sWZH(Ik3A|SLrjH&JRF!KD|6#@CKTi_fedJM6Rk4r!Y&4B8p!;V- zEK0Um)pe`TNjztP%ZH1zG}DxQ`drP6erMgbmlj&4Bkhq~no9vaHGS(`T(iAp^Guz~ z6pMn*_log;qNB*aH{eBonZn_gY_s5x4k3*td*{tp`G6g%|3kT_F>y4bC?RI&e{xYm za*>~9*TsAZ2PxeD-)R2;i}sko2-e~Ev@Lcpf*qCM+ID-~FtI&u5bbM>oimVd$c`^k zJG`gw_qT0YdHTM#1!SDwHdvy*#{G@CuZ=Gw%13@0{%+9Qrwe@de#s8H%^Sh|Cyw^2R5wMm3K(eh(*jehA(;HAspj9?M zIB;DRyio9fBUr>@^gX>DDX09{;jirCEd>77w{$2_-(09O*(iiYO|KN-u>yBX$`Z?l z9r?l%t=xF#WG#|q%w<)2CLA$NsA*Jiy=$`2<#P7PqaK-)4e1TV{9!l4E6Jhz~P*B4_j+8$+Iqb>1@d(cs?3!=JAGo;w3}QWw()D`e zm&U=5{B+qSle-xf=z6Q}oktogG)%x#G>K`=SRJ@=t(8VB?tycsliymX1UI?rHyP2U zGFnkh(x)=kB+OLrjK7JwwOg^Mu#t>*=+^QPif^jcQ-)tR%QPNtd@=RP`?&Jlidfe; zag{>dGvjDO*GPH-o&os_cS4Q^I9v`!PhVPJuNoJRm|5|_Yj#hOCGhTDMk)0?zCQe7 za;3+BqpjmRO-5oP#V^NGYn?-Ho?M%7jKF8-f0aK|U=vD#*5b$$FH!Z6?spYc74A%% z#gjUEhxdeuWTW$XcR90`IgP5B*{OJtkKpuHo=%oZl(R$A(if>@s!y!tFZAq*sO-E0a5WHP%S3O0DzIDTp2^X8gfI{q0!^@@I6C zoupe}B!6V!$2Dy)$%2j7Ge<5rk%nt!=f4SHsL!&ez2Yn=;CEW)*`#Nykc?rqQIc+6 ze;Cb6L!q85qS^E>qI9#cv7G!nNn^8LZ+R0~5Z+TTh)lc4!j)?CY=9UI;kUiSmv)KP ztfNd-DYy5b?`0D_>jo2oP)_EHGqNmo>P}}Vyn`b@+!OqDGD(^s{xtGu9FpYgAR$d? ziKCzyxOdL~6~*U>i3^Vn16vZbUfljV3wttAX%l4T&5;#yce0Y82cE&Kek4P~)V9NA zo>|uXb6dhMQ~LAtOdYPI@3l5aG?J3dJ1%=aks~^)|C#mEThCP*;m*}VHxZJJSwlBA z7ns()Og9gL8~lHAwHpgCdvFK~FSyliZl0ZWX8510-8(phMYX^Gl)JMT8FLIM*e+dI zv5m~s2Q37#o6XAkDIbHDKaZd!4Pgt7onn2zxlYce_?$t^-^ExVlaDvCDUvVxwAtB} zW%~DSuGe3;<}By>NHOLK4~D!RAS#Kwahnj4d*tSnp`+JI27~7*-P@}Oaz0b;Tmgoc zi!NFjL&Hc48 z%NAddTrnXP&!D-o*ME>e=mjz-tNhXaAkwgJkIAg?%ZV*e#psDV>HxO$@VSzyLgR;iJ1LWm#N#+ z&S$AuDB{<2Ppd~U$g3aaZ!*Z|D~%$iDm!camU;BF^b7KzmucH6HfAInSTdO8vY8pg znVS?f-pHO54XL!+5u#{ct+UiLprwlH-Wh8~ zDQWZo0S%fwvz3bCP>@|h#7mn^8Jc%OCSB$c?aYKZfd$^oRIz*oXWoVpaI%ZKc3p_3 zn0AgNsdfTWn)Rk~6Bi|Ier#KpZ@KU-RPA}@^=S61uBJad^D_BO7h1YP-j=PNIZB3Z zILWTsE=9F$2p2>-XH`nXUHE*2*>(g}HUDyCY~taQha>Yp9D7gEDOjda+Vypv6JXBh zT$TS~@ET9LTdWq9|tCku{20$jfUed)0?vPT}+u&yz>jhnDLy zjyfS9&Y|T_qlXz{Z^a!Rw!0`9cdW)Z9W-)<)0iyrOdg8Sg2G4a$T%Mz4NG-2lcBMe z^t4p^8^TL3Br?kwm1%|UQx2*O*q(T_)@`Pu$-ead{3Dyb`2l4E<(?(6OuN@^lOpq| z@dX(5LVn&YX$78BM*du)bg=?w47!R~0w=Eq3Vyv> zRa}bm!|E24e(GGBm3vdtGX<|IdG^&Dx=NQ!$&?RASc$w++dC&KeH0hT%4W(~B| zFOCuCix`nrp_fGi1>3b~BtE%8oi#U_zXQ=IT$pw8~+sQ>@z z(C^s~7Ebn}&d$^i3`PDv0t5f^yU`BnV88zT6V#ct{fs!h6;)Q*DMyAc`fQX3VSlNl z^6gvl>s@o+s3w`?T$L7f-!^&(Xc>8+J(R=>pVKu>T` zTk}q9)KL2>Yc|k*pTE5Bx5!4*xEy34U_AEZd_WD^tzc31;q#LkOzEv}O0pH^XA`Y5 znoS;z)>Yp2e;MQ~)`pkGHrAnCa_VQv3~(=GT9ETSHn&H_@{MmU@xJx8QcQq;X$?EU zhFpzPXVSNHf`|z$y%2f*CHzta zr`3`>C{yz*R0Yc4`1~ewRO6Fs*R$yBB6Z+!Tm2b*n1!JCmmF15;d`YY>+DWaSwCma zy&^%IdOIqOBFfgf_FVFGRDKU9b64m^iOJD$Sk_3v^T7_K?E8nsh+T3C-V!7;eDph% zWj`{`m~A|3Tcma5O;5bYkbg7y-SJ|b64OYz^2JP26d8p?dl^Fq$x8cpzI*7( z#ZU%!mFJCPrlZygP;;dJ`F=Bimj66!ZPBNZG6P2O52^`m-&T~>tBDr=MAF3(X+M+0X)q+S$Fe3<8{^vc)ntZzzA z+G|(#@%is(+df9!;&)XOYw?3Iz4b@28Q^u>P#2#UP1QR}&uV+^v}wb~UXPepSsIZXo&qP6M`$ZVZcZj^(>T6UWRRaS z0-3&}>17Wp8+kIL_{xsm%-#~IXZ*^05r~b(pDT=a~a*;8M^OdX->Ahl4_EB z$k}AxTpTy)uX`fJb`hS^Bwf$i8bzz4chlkyiL#;g_q=d(u@KJlF9WLe2n zF(gE5NgP)(M$ZH54*20=vw_+PdgZ#bZszk^LkqE&S3)-+PY1Q?`=*gxuBn!-f;>_Z zFD>;5NY;I6lCoq@@};L0J$~8k+g-#$=9?X$fRxb?kqlEH&ztq!fU@!TTk7@*5|3B6 zCKtUZYv>4o&azojefWUxw6Rw;G~&G&!+fCy?Z;wEZbV-OZ~IItXG2w{ezTCGhpsLb zY&tLVL=|pkZZewI7)d67_POvQ$>2~Lr$zVCTg#pw_~y0ZjEJH`u9`+Ry;|z~WGZqr zy`gkH1`Ka3&!KZqv)RgFvFYk`XXl=dou|3>l=ius2`@fb@OQe3nhJ*%0u$aN_~v^;g>F&(HhV;pB%M*PsulF$p5qJRDLUPlOwWi<~w>okH;f7 z+*rmkVqk4f%|#}wE;lxNE${{JfVkc4m3MlMoyE3zn(IO$lizw{?&(jNbt|{_lpN>D zR7(n-a=Wobl(oTa@fYZa*$RM}%luDmpT)x3Ui8~pv;@N;zpqt9>`oYeZ=XeA)&u{+ z{Yxch%q@ozD_6=YM<|uwWXvKhi~4+)Il7~^9ETiu@Dd}u1t zoJ34HC_ICT5yTHD5p;x%4w+FmCeg$YeN`15mhf;pS8M5;;5)q(66Myh$gL^HLiR+O zm5*eEl>5+z_LcmNrVZ0E`T*)?~d#%t>|XF6^Ta;W*RDcR?# zD!gV-UNb19Sf^jD0l6_FM595haY*B-dP2)kFqPSOaYn!m0tTY9*R&aG?r^lJvtCd* zE0~ zjIJf=biFd6PI*FCDew8n*Szm0o>Royz&$E4vli-u1kBvq))>PvEpG+$1Jeg}n~N8P$PH>!A&?YL-@ zdR;H6%Pe8U*tsZJ(TJ1RmkMvc0lj0|1b69!N%`GAEtYMSU!W}WWIpE1Cn4Ec)MmR} zsL>N>JhXhLL7)v^w9b>^dJ|h4t8eJzM=ozqy&~ompjBmtR75^uOQ{1t3DZf3hj9g} z9j^CotA~D2^L!WBWD_LAuI$ca!6{%K>3)eZQOMHBAgcSg6Ql47UxO`s)O(~J+=BE( zaP&ZauI-zh> zIb^cLiq={u>oXy69%%B_l&r^PV}x&->-B^blZBVp^vIejjTnD05@YBC7Dx z+B9UAvAzTsqa-6Bw1?d{3#^6F{wRDRpz+wk>J_mCWtPIFzK$AZy)!omNGiv^z4tep z2!`D~sSDYlYhCg2sptO6cl(!&3cp*@u#Btl)BGF7CBN>71e!;B={UHR^j_j+li?37 zuxnC@NXp?F5>oq6*r^*nY#{>A>s8@g|CV*i>`0Jwxl-Mw+h^GOik!k9F-h4tbDE}( zB|hLotD~~wRfWg;D~(69vQ{#Ul_d>_^2OSxg47G*CFnc*!|wJ=9_kP~d>#Fb=gQNY z!8WUAyyx?L6N9-Ltr542Yj3$+oE=^Bsa|9q3aL_%`7)uGLdCz8lP9&5R4=6`oO9e< zeJ=VcA5^gn?o+PgH&yRSDz)eO z;l)`{^t7q;tYsns+0%bKV3&2TVnbi&3J2~DIL7|KGciUbWP0TNkjwb@)#Hzee=*!x z8DBjnb8@;r*2|xn$R9J>ID!*V= z;AM)%b6+|=O3Jd?n5C`AnE)Br%XWjW-+K3$U973oDKVCtF;)Y%X&mX7o@QW`F{odz z9t4`3;OBH`pg+!2d3fWkVrEgMg@w=+j-`M#8EGMiC5?@**nOq1(#tkuN;(1Ep4|_- zU-T${8q$2OOY_#E5mk{PMLa}iYhoGHok(ydWL0UY<0Ap-n6*#rYR4ruPRAve0dY?1 zm!Yy{hV_P2jWh)*+U4{n*Gj5M)u`^Ckwy3@AnKV!lo^_{(Y$1f=cTOm8EV8XzI>DF zp((KhN_y8HmDWeCz-%YU>zw{s)F3M0j1qxr9BX(!;otpV?wo$2WtPSS#c6%cBnEJS$D`x&eodKoIW_&m>?;ZjkSK7amvjQj;*@I|ccj51 z)U~G{HJgX|Va;<|@zaG;vjY#c8=~rJy!E+>y^}az96l0%-dp{gDsgFLFJ2pXP)T64 zC0Xa{QRA9Lb0d;LC;m&$Vfs=mO%Ql*{gpa&#RJMTYI(^Q21T17JK;WNf?VIYNZ;DY zCXZ%i)d(VS@rss@=Eo9(mxep%>e?62&imSrf7UQ9mWR9?Rz8-$dG+pv2D1$4RM$Yj zyLBJQ!KYe&^AO5pQb9eK*OfK1fp{=qmYU(yfspUP=3nU<}?aRgyxc#_5=1YA?I}if9egphf2!z0W78eiz?Qq^124nY5 z5RKY2RvpFnV zT+M&5{S(P{6a)66Z+F(eWQ?_l-+JJx+0g@#9{1}X)$ADgA7%&Rgo18hFXjhH8{66e zNoD^^16)OaXmG$5c9u196HwePd@;aBFkb&V!4`%L#!xV6x-fsmG@`k_Er+nB*&PgB z)B;Eci%D$Db<@~F$imimhw$fh1U!2uyZ^i{pldO<|IaJh4FH&T{&_{$_08<{?Tq!X z>BV+b`1d;PMuh*eDh|2ZX2#ZNY$}C+R^@Jd_;0KHkGc)HJI(*k>cg3cqNTa61?I(n zq}-lJflcm)Ni$&!oIt|5HyBF7C1rfa7NmiVF~FfE>~aJ48f!%m7)Qk3s-*~mVBH7= z!EV0-Vb5|Yg0LUCfgf0x0Ku{D0D@y983>DcilAGV+)dj7e>ZIGsxAVgpEI*G#1OEu z?Ix?(NpuCmR=M+lwC-(vGh5Jhv;=XhJvhPuJOv zGbCJC|HHYf7!QaChf#nqVki*S!?1ZX#K0h)-%^MHDLHU48S@wv$j^b@k%lS2LD=ra z4%#uvrS)zAY4S7xiGZYbToUF$+Y4|16agFwgO8XKKbB^eHaCDwW%?kT9M^EUmp}V1T zC!YN!H>@#${+8Qr(E4}Ww*6?A8w@yzcThGg*#5ny+kUvq4GKd6P`O`I*sja{TiI}4 zy~_;(1p~*?4shFpod2>Hwu8eiHv}9wWOk6-KkJ19+~DxP(iA(o{QGvp#k5_~;J~@N zgQ8($$qqBzIO+F@6E{x64Qh4=6^=Ig1|-}dB$xy^Ot<|H81ce^y`Tml91RNQ#%x~2 z`~zA1rh!pF(A`IaVy+t6Ljww!sJxE`Mgr>Wr9qGw+4s{>K+xDjgMi_fb8~xWP%!*p z9dIOOYwn)sxMAFwdBR>A0&|%001W~}+WpUA#$$VFJV*>y?4=>NF&(;>hUCWB!d@B* zbx>v`H)fmDp69^a+{pd1fWb(}{&oR#1D&-0T_EG={(b{KTOWK5lP+`ryTED6{knnS z2=0UYP^bg)!Fe!nv{w%v=z+Ee!+B8q`x49p#~fqc^DY$3gIQAALj#_}fcG961PsG~ z-5wegjKs`C_Rs)!$b-+Jzz1bPVq)K(ccDO=9%yGC6nwwFPzd+I_Csj1ad$RB=mr-fswGk@EM*1_6LDN4)_NIXw?1s0#62*Kw!oodued)1N{a80Pw)ONC;*Qxc6NI5)ElpFPD+uPab8k+%AHeh_nb;HVo zik6mkAi&8nN3bO<3@kx_Lt%dh210yDA*6^fL`(>I4FD7FYhYmr3@i#@2oxd)*r$+~ f0O;=@!48>h?R0JIu;>Pbz@ShPHa1Z?F_QlSbo4u4 literal 0 HcmV?d00001 diff --git a/ivy.xml b/ivy.xml new file mode 100644 index 0000000..8e5f198 --- /dev/null +++ b/ivy.xml @@ -0,0 +1,155 @@ + + + + + + + + ZooKeeper + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/ivysettings.xml b/ivysettings.xml new file mode 100644 index 0000000..1d06c40 --- /dev/null +++ b/ivysettings.xml @@ -0,0 +1,41 @@ + + + + + + + + + + + + + + + + + + + + + diff --git a/src/LICENSE.txt b/src/LICENSE.txt new file mode 100644 index 0000000..867ac6d --- /dev/null +++ b/src/LICENSE.txt @@ -0,0 +1,216 @@ + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. + + +This distribution bundles jline 0.9.94, which is available under the +2-clause BSD License. For details, see a copy of the license in +lib/jline-0.9.94.LICENSE.txt + +This distribution bundles SLF4J 1.6.1, which is available under the MIT +License. For details, see a copy of the license in +lib/slf4j-1.6.1.LICENSE.txt + +This distribution bundles a modified version of 'JZLib' as part of +Netty-3.7.0, which is available under the 3-clause BSD licence. For +details, see a copy of the licence in META-INF/license/LICENSE-jzlib.txt +as part of the Netty jar in lib/netty-3.7.0.Final.jar. diff --git a/src/NOTICE.txt b/src/NOTICE.txt new file mode 100644 index 0000000..08388e8 --- /dev/null +++ b/src/NOTICE.txt @@ -0,0 +1,100 @@ +Apache ZooKeeper +Copyright 2009-2018 The Apache Software Foundation + +This product includes software developed at +The Apache Software Foundation (http://www.apache.org/). + +This product includes software developed by +The Netty Project (http://netty.io/) +Copyright 2011 The Netty Project + +The Netty NOTICE file contains the following items: +This product contains the extensions to Java Collections Framework which has +been derived from the works by JSR-166 EG, Doug Lea, and Jason T. Greene: + + * LICENSE: + * license/LICENSE.jsr166y.txt (Public Domain) + * HOMEPAGE: + * http://gee.cs.oswego.edu/cgi-bin/viewcvs.cgi/jsr166/ + * http://viewvc.jboss.org/cgi-bin/viewvc.cgi/jbosscache/experimental/jsr166/ + +This product contains a modified version of Robert Harder's Public Domain +Base64 Encoder and Decoder, which can be obtained at: + + * LICENSE: + * license/LICENSE.base64.txt (Public Domain) + * HOMEPAGE: + * http://iharder.sourceforge.net/current/java/base64/ + +This product contains a modified version of 'JZlib', a re-implementation of +zlib in pure Java, which can be obtained at: + + * LICENSE: + * license/LICENSE.jzlib.txt (BSD Style License) + * HOMEPAGE: + * http://www.jcraft.com/jzlib/ + +This product contains a modified version of 'Webbit', a Java event based +WebSocket and HTTP server: + + * LICENSE: + * license/LICENSE.webbit.txt (BSD License) + * HOMEPAGE: + * https://github.com/joewalnes/webbit + +This product optionally depends on 'Protocol Buffers', Google's data +interchange format, which can be obtained at: + + * LICENSE: + * license/LICENSE.protobuf.txt (New BSD License) + * HOMEPAGE: + * http://code.google.com/p/protobuf/ + +This product optionally depends on 'Bouncy Castle Crypto APIs' to generate +a temporary self-signed X.509 certificate when the JVM does not provide the +equivalent functionality. It can be obtained at: + + * LICENSE: + * license/LICENSE.bouncycastle.txt (MIT License) + * HOMEPAGE: + * http://www.bouncycastle.org/ + +This product optionally depends on 'SLF4J', a simple logging facade for Java, +which can be obtained at: + + * LICENSE: + * license/LICENSE.slf4j.txt (MIT License) + * HOMEPAGE: + * http://www.slf4j.org/ + +This product optionally depends on 'Apache Commons Logging', a logging +framework, which can be obtained at: + + * LICENSE: + * license/LICENSE.commons-logging.txt (Apache License 2.0) + * HOMEPAGE: + * http://commons.apache.org/logging/ + +This product optionally depends on 'Apache Log4J', a logging framework, +which can be obtained at: + + * LICENSE: + * license/LICENSE.log4j.txt (Apache License 2.0) + * HOMEPAGE: + * http://logging.apache.org/log4j/ + +This product optionally depends on 'JBoss Logging', a logging framework, +which can be obtained at: + + * LICENSE: + * license/LICENSE.jboss-logging.txt (GNU LGPL 2.1) + * HOMEPAGE: + * http://anonsvn.jboss.org/repos/common/common-logging-spi/ + +This product optionally depends on 'Apache Felix', an open source OSGi +framework implementation, which can be obtained at: + + * LICENSE: + * license/LICENSE.felix.txt (Apache License 2.0) + * HOMEPAGE: + * http://felix.apache.org/ diff --git a/src/c/CMakeLists.txt b/src/c/CMakeLists.txt new file mode 100644 index 0000000..e7dfbeb --- /dev/null +++ b/src/c/CMakeLists.txt @@ -0,0 +1,237 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +cmake_minimum_required(VERSION 3.6) + +project(zookeeper VERSION 3.4.13) +set(email user@zookeeper.apache.org) +set(description "zookeeper C client") + +# general options +include_directories(include tests generated ${CMAKE_SOURCE_DIR} ${CMAKE_BINARY_DIR}) +if(UNIX) + add_compile_options(-Wall -fPIC) +elseif(WIN32) + add_compile_options(/W3) +endif() +add_definitions(-DUSE_STATIC_LIB) + +# TODO: Enable /WX and /W4 on Windows. Currently there are ~1000 warnings. +# TODO: Add Solaris support. +# TODO: Add a shared library option. +# TODO: Specify symbols to export. +# TODO: Generate doxygen documentation. + +# Sync API option +option(WANT_SYNCAPI "Enables Sync API support" ON) +if(WANT_SYNCAPI) + add_definitions(-DTHREADED) + if(WIN32) + # Note that the generator expression ensures that `/MTd` is used when Debug + # configurations are built. + add_compile_options(/MT$<$:d>) + endif() +endif() + +# CppUnit option +if(WIN32 OR APPLE) + # The tests do not yet compile on Windows or macOS, + # so we set this to off by default. + # + # Note that CMake does not have expressions except in conditionals, + # so we're left with this if/else/endif pattern. + set(DEFAULT_WANT_CPPUNIT OFF) +else() + set(DEFAULT_WANT_CPPUNIT ON) +endif() +option(WANT_CPPUNIT "Enables CppUnit and tests" ${DEFAULT_WANT_CPPUNIT}) + +# The function `to_have(in out)` converts a header name like `arpa/inet.h` +# into an Autotools style preprocessor definition `HAVE_ARPA_INET_H`. +# This is then set or unset in `configure_file()` step. +# +# Note that CMake functions do not have return values; instead an "out" +# variable must be passed, and explicitly set with parent scope. +function(to_have in out) + string(TOUPPER ${in} str) + string(REGEX REPLACE "/|\\." "_" str ${str}) + set(${out} "HAVE_${str}" PARENT_SCOPE) +endfunction() + +# include file checks +foreach(f generated/zookeeper.jute.h generated/zookeeper.jute.c) + if(EXISTS "${CMAKE_SOURCE_DIR}/${f}") + to_have(${f} name) + set(${name} 1) + else() + message(FATAL_ERROR + "jute files are missing!\n" + "Please run 'ant compile_jute' while in the ZooKeeper top level directory.") + endif() +endforeach() + +# header checks +include(CheckIncludeFile) +set(check_headers + arpa/inet.h + dlfcn.h + fcntl.h + inttypes.h + memory.h + netdb.h + netinet/in.h + stdint.h + stdlib.h + string.h + strings.h + sys/socket.h + sys/stat.h + sys/time.h + sys/types.h + unistd.h + sys/utsname.h) + +foreach(f ${check_headers}) + to_have(${f} name) + check_include_file(${f} ${name}) +endforeach() + +# function checks +include(CheckFunctionExists) +set(check_functions + getcwd + gethostbyname + gethostname + getlogin + getpwuid_r + gettimeofday + getuid + memmove + memset + poll + socket + strchr + strdup + strerror + strtol) + +foreach(fn ${check_functions}) + to_have(${fn} name) + check_function_exists(${fn} ${name}) +endforeach() + +# library checks +set(check_libraries rt m pthread) +foreach(lib ${check_libraries}) + to_have("lib${lib}" name) + find_library(${name} ${lib}) +endforeach() + +# IPv6 check +include(CheckStructHasMember) +check_struct_has_member("struct sockaddr_in6" sin6_addr "netinet/in.h" ZOO_IPV6_ENABLED) + +# configure +configure_file(cmake_config.h.in ${CMAKE_SOURCE_DIR}/include/config.h) + +# hashtable library +set(hashtable_sources src/hashtable/hashtable_itr.c src/hashtable/hashtable.c) +add_library(hashtable STATIC ${hashtable_sources}) +target_link_libraries(hashtable PUBLIC $<$:m>) + +# zookeeper library +set(zookeeper_sources + src/zookeeper.c + src/recordio.c + generated/zookeeper.jute.c + src/zk_log.c + src/zk_hashtable.c) + +if(WANT_SYNCAPI) + list(APPEND zookeeper_sources src/mt_adaptor.c) +else() + list(APPEND zookeeper_sources src/st_adaptor.c) +endif() + +if(WIN32) + list(APPEND zookeeper_sources src/winport.c) +endif() + +add_library(zookeeper STATIC ${zookeeper_sources}) +target_link_libraries(zookeeper PUBLIC + hashtable + $<$:rt> # clock_gettime + $<$:ws2_32>) # Winsock 2.0 + +if(WANT_SYNCAPI AND NOT WIN32) + find_package(Threads REQUIRED) + target_link_libraries(zookeeper PUBLIC Threads::Threads) +endif() + +# cli executable +add_executable(cli src/cli.c) +target_link_libraries(cli zookeeper) + +# load_gen executable +if(WANT_SYNCAPI AND NOT WIN32) + add_executable(load_gen src/load_gen.c) + target_link_libraries(load_gen zookeeper) +endif() + +# tests +set(test_sources + tests/TestDriver.cc + tests/LibCMocks.cc + tests/LibCSymTable.cc + tests/MocksBase.cc + tests/ZKMocks.cc + tests/Util.cc + tests/ThreadingUtil.cc + tests/TestZookeeperInit.cc + tests/TestZookeeperClose.cc + tests/TestClientRetry.cc + tests/TestOperations.cc + tests/TestMulti.cc + tests/TestWatchers.cc + tests/TestClient.cc) + +if(WANT_SYNCAPI) + list(APPEND test_sources tests/PthreadMocks.cc) +endif() + +if(WANT_CPPUNIT) + add_executable(zktest ${test_sources}) + target_compile_definitions(zktest + PRIVATE -DZKSERVER_CMD="${CMAKE_SOURCE_DIR}/tests/zkServer.sh") + # TODO: Use `find_library()` for `cppunit`. + target_link_libraries(zktest zookeeper cppunit dl) + + # This reads the link flags from the file `tests/wrappers.opt` into + # the variable `symbol_wrappers` for use in `target_link_libraries`. + # It is a holdover from the original build system. + file(STRINGS tests/wrappers.opt symbol_wrappers) + if(WANT_SYNCAPI) + file(STRINGS tests/wrappers-mt.opt symbol_wrappers_mt) + endif() + + target_link_libraries(zktest ${symbol_wrappers} ${symbol_wrappers_mt}) + + enable_testing() + add_test(NAME zktest_runner COMMAND zktest) + set_property(TEST zktest_runner PROPERTY ENVIRONMENT + "ZKROOT=${CMAKE_SOURCE_DIR}/../.." + "CLASSPATH=$CLASSPATH:$CLOVER_HOME/lib/clover.jar") +endif() diff --git a/src/c/ChangeLog b/src/c/ChangeLog new file mode 100644 index 0000000..c85a6c0 --- /dev/null +++ b/src/c/ChangeLog @@ -0,0 +1,116 @@ +Release 2.1.1 +2008-04-30 Andrew Kornev + + * changed the distributino package name to "c-client-src" + +Release 2.1.0 +2008-04-30 Andrew Kornev + + * added the client latency diagnostics; the client prints a warning when the + reponse latency exceeds 20ms + + * modified logging format to report the znode path for which the zookeeper + operation is called + + * fixed a minor bug where error messages were missing for some of the newer + zookeeper error codes (ZCLOSING and ZNOTHING). + + * improved logging by adding the XID to the message to make it easy to match + requests to responses + + * fixed the bug causing sporadic session termination and timeouts + + * added a new return code to zookeeper_process() -- ZNOTHING -- + that indicates that the socket has no more data to read + + * more unit tests added + +Release 1.1.3 +2008-02-07 Andrew Kornev + + * get_xid() is not thread-safe (xid initialization race condition + in the multi-threaded mode). + + * the I/O thread doesn’t automatically terminate on AUTH_FAILURE and + SESSION_EXPIRED events. + + * all session events should be processed on the completion thread. + + * PING operation doesn’t atomically enqueue the completion and + send buffers like other operations do. + + * corrected zookeeper_init() doxygen docs. + + * new unit tests added. + + +Release 1.1.2 +2008-01-24 Andrew Kornev + + * fixed a race condition caused by the code in zookeeper_process() + and free_completions() setting sc->complete to 1 without proper + synchronization; + + * fixed zoo_get() not updating buffer_len value with the actual + buffer length on return; added missing enter_critical/leave_critical + calls to the async ZK operations. + + * Replaced select() with poll() to fix the problem with the FD_SET + macro causing stack corruption for FDs higher than 1024 + + * Added zoo_set_log_stream() to the public API. The function allows + applications to specify a different log file. + + * Removed unused declarations from zookeeper.h (ACL related) + + * changed zoo_get() signature to take a pointer to buffer length. + The function sets the parameter to the actual data length upon return. + + * the watcher callback now takes the zhandle as its first parameter. This + is to avoid a race condition in the multi-threaded client when a watcher + is called before zookeeper_init() has returned. + + * fixed zookeeper_close() resource leaks and race conditions, + fixed the race condition causing xid mismatch. + + * added support for cppunit, added new targets: "check" and "run-check" + to build and run unit tests. + + * Changed the signature of zookeeper_init(): it now takes a context pointer + as a parameter. This is to avoid a race condition in the multi-threaded client. + + * Using a self-pipe rather than SIGUSR1 to wake up select() in the I/O thread + + * Added the doxygen target to the autoconf scripts + + * Pulled out the logging functionality from zookeeper.c to zk_log.c/.h. + Fixed a minor issue with PING responses being unnecessarily put on + the completion queue rather than simply dropped. Make use of DLL_EXPORT + symbol for building shared lib on cygwin. + + * Implemented new Zookeeper operation sync() to flush the leader channel + to ensure that all updates have reached the followers. + + * Synchronous methods not being handled properly on disconnect + + * breed: fixed an incorrect parameter passed to zookeeper API by + the Sync API wrapper functions + + * breed: the set and delete commands now support both Sync and Async API. + Prefix the command name with an 'a' to call the Async API: aset, adelete + + * Make sure mutexes and condition variables are properly initialized + and destroyed + + * Fixed zookeeper_close() causing core dumps with mt_adaptor + + +Release 1.0.0 +2007-11-27 Andrew Kornev + + * configure.ac and Makefile.am added support for GNU autotools + + * recordio.c/.h updated jute IO routines to use bit-explicit integer types + (int32_t vs. int, and int64_t vs. long long) + + * README rough draft \ No newline at end of file diff --git a/src/c/INSTALL b/src/c/INSTALL new file mode 100644 index 0000000..5458714 --- /dev/null +++ b/src/c/INSTALL @@ -0,0 +1,234 @@ +Installation Instructions +************************* + +Copyright (C) 1994, 1995, 1996, 1999, 2000, 2001, 2002, 2004, 2005, +2006 Free Software Foundation, Inc. + +This file is free documentation; the Free Software Foundation gives +unlimited permission to copy, distribute and modify it. + +Basic Installation +================== + +Briefly, the shell commands `./configure; make; make install' should +configure, build, and install this package. The following +more-detailed instructions are generic; see the `README' file for +instructions specific to this package. + + The `configure' shell script attempts to guess correct values for +various system-dependent variables used during compilation. It uses +those values to create a `Makefile' in each directory of the package. +It may also create one or more `.h' files containing system-dependent +definitions. Finally, it creates a shell script `config.status' that +you can run in the future to recreate the current configuration, and a +file `config.log' containing compiler output (useful mainly for +debugging `configure'). + + It can also use an optional file (typically called `config.cache' +and enabled with `--cache-file=config.cache' or simply `-C') that saves +the results of its tests to speed up reconfiguring. Caching is +disabled by default to prevent problems with accidental use of stale +cache files. + + If you need to do unusual things to compile the package, please try +to figure out how `configure' could check whether to do them, and mail +diffs or instructions to the address given in the `README' so they can +be considered for the next release. If you are using the cache, and at +some point `config.cache' contains results you don't want to keep, you +may remove or edit it. + + The file `configure.ac' (or `configure.in') is used to create +`configure' by a program called `autoconf'. You need `configure.ac' if +you want to change it or regenerate `configure' using a newer version +of `autoconf'. + +The simplest way to compile this package is: + + 1. `cd' to the directory containing the package's source code and type + `./configure' to configure the package for your system. + + Running `configure' might take a while. While running, it prints + some messages telling which features it is checking for. + + 2. Type `make' to compile the package. + + 3. Optionally, type `make check' to run any self-tests that come with + the package. + + 4. Type `make install' to install the programs and any data files and + documentation. + + 5. You can remove the program binaries and object files from the + source code directory by typing `make clean'. To also remove the + files that `configure' created (so you can compile the package for + a different kind of computer), type `make distclean'. There is + also a `make maintainer-clean' target, but that is intended mainly + for the package's developers. If you use it, you may have to get + all sorts of other programs in order to regenerate files that came + with the distribution. + +Compilers and Options +===================== + +Some systems require unusual options for compilation or linking that the +`configure' script does not know about. Run `./configure --help' for +details on some of the pertinent environment variables. + + You can give `configure' initial values for configuration parameters +by setting variables in the command line or in the environment. Here +is an example: + + ./configure CC=c99 CFLAGS=-g LIBS=-lposix + + *Note Defining Variables::, for more details. + +Compiling For Multiple Architectures +==================================== + +You can compile the package for more than one kind of computer at the +same time, by placing the object files for each architecture in their +own directory. To do this, you can use GNU `make'. `cd' to the +directory where you want the object files and executables to go and run +the `configure' script. `configure' automatically checks for the +source code in the directory that `configure' is in and in `..'. + + With a non-GNU `make', it is safer to compile the package for one +architecture at a time in the source code directory. After you have +installed the package for one architecture, use `make distclean' before +reconfiguring for another architecture. + +Installation Names +================== + +By default, `make install' installs the package's commands under +`/usr/local/bin', include files under `/usr/local/include', etc. You +can specify an installation prefix other than `/usr/local' by giving +`configure' the option `--prefix=PREFIX'. + + You can specify separate installation prefixes for +architecture-specific files and architecture-independent files. If you +pass the option `--exec-prefix=PREFIX' to `configure', the package uses +PREFIX as the prefix for installing programs and libraries. +Documentation and other data files still use the regular prefix. + + In addition, if you use an unusual directory layout you can give +options like `--bindir=DIR' to specify different values for particular +kinds of files. Run `configure --help' for a list of the directories +you can set and what kinds of files go in them. + + If the package supports it, you can cause programs to be installed +with an extra prefix or suffix on their names by giving `configure' the +option `--program-prefix=PREFIX' or `--program-suffix=SUFFIX'. + +Optional Features +================= + +Some packages pay attention to `--enable-FEATURE' options to +`configure', where FEATURE indicates an optional part of the package. +They may also pay attention to `--with-PACKAGE' options, where PACKAGE +is something like `gnu-as' or `x' (for the X Window System). The +`README' should mention any `--enable-' and `--with-' options that the +package recognizes. + + For packages that use the X Window System, `configure' can usually +find the X include and library files automatically, but if it doesn't, +you can use the `configure' options `--x-includes=DIR' and +`--x-libraries=DIR' to specify their locations. + +Specifying the System Type +========================== + +There may be some features `configure' cannot figure out automatically, +but needs to determine by the type of machine the package will run on. +Usually, assuming the package is built to be run on the _same_ +architectures, `configure' can figure that out, but if it prints a +message saying it cannot guess the machine type, give it the +`--build=TYPE' option. TYPE can either be a short name for the system +type, such as `sun4', or a canonical name which has the form: + + CPU-COMPANY-SYSTEM + +where SYSTEM can have one of these forms: + + OS KERNEL-OS + + See the file `config.sub' for the possible values of each field. If +`config.sub' isn't included in this package, then this package doesn't +need to know the machine type. + + If you are _building_ compiler tools for cross-compiling, you should +use the option `--target=TYPE' to select the type of system they will +produce code for. + + If you want to _use_ a cross compiler, that generates code for a +platform different from the build platform, you should specify the +"host" platform (i.e., that on which the generated programs will +eventually be run) with `--host=TYPE'. + +Sharing Defaults +================ + +If you want to set default values for `configure' scripts to share, you +can create a site shell script called `config.site' that gives default +values for variables like `CC', `cache_file', and `prefix'. +`configure' looks for `PREFIX/share/config.site' if it exists, then +`PREFIX/etc/config.site' if it exists. Or, you can set the +`CONFIG_SITE' environment variable to the location of the site script. +A warning: not all `configure' scripts look for a site script. + +Defining Variables +================== + +Variables not defined in a site shell script can be set in the +environment passed to `configure'. However, some packages may run +configure again during the build, and the customized values of these +variables may be lost. In order to avoid this problem, you should set +them in the `configure' command line, using `VAR=value'. For example: + + ./configure CC=/usr/local2/bin/gcc + +causes the specified `gcc' to be used as the C compiler (unless it is +overridden in the site shell script). + +Unfortunately, this technique does not work for `CONFIG_SHELL' due to +an Autoconf bug. Until the bug is fixed you can use this workaround: + + CONFIG_SHELL=/bin/bash /bin/bash ./configure CONFIG_SHELL=/bin/bash + +`configure' Invocation +====================== + +`configure' recognizes the following options to control how it operates. + +`--help' +`-h' + Print a summary of the options to `configure', and exit. + +`--version' +`-V' + Print the version of Autoconf used to generate the `configure' + script, and exit. + +`--cache-file=FILE' + Enable the cache: use and save the results of the tests in FILE, + traditionally `config.cache'. FILE defaults to `/dev/null' to + disable caching. + +`--config-cache' +`-C' + Alias for `--cache-file=config.cache'. + +`--quiet' +`--silent' +`-q' + Do not print messages saying which checks are being made. To + suppress all normal output, redirect it to `/dev/null' (any error + messages will still be shown). + +`--srcdir=DIR' + Look for the package's source code in directory DIR. Usually + `configure' can determine that directory automatically. + +`configure' also accepts some other, not widely useful, options. Run +`configure --help' for more details. + diff --git a/src/c/LICENSE b/src/c/LICENSE new file mode 100644 index 0000000..d645695 --- /dev/null +++ b/src/c/LICENSE @@ -0,0 +1,202 @@ + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. diff --git a/src/c/Makefile.am b/src/c/Makefile.am new file mode 100644 index 0000000..5993098 --- /dev/null +++ b/src/c/Makefile.am @@ -0,0 +1,128 @@ +# need this for Doxygen integration +include $(top_srcdir)/aminclude.am + +if SOLARIS + SOLARIS_CPPFLAGS = -D_POSIX_PTHREAD_SEMANTICS + SOLARIS_LIB_LDFLAGS = -lnsl -lsocket +endif +AM_CPPFLAGS = -I${srcdir}/include -I${srcdir}/tests -I${srcdir}/generated $(SOLARIS_CPPFLAGS) +AM_CFLAGS = -Wall -Werror +AM_CXXFLAGS = -Wall $(USEIPV6) + +# Additional flags for coverage testing (if enabled) +if ENABLEGCOV + AM_CFLAGS += -fprofile-arcs -ftest-coverage + AM_LDFLAGS = -lgcov +endif + +LIB_LDFLAGS = -no-undefined -version-info 2 $(SOLARIS_LIB_LDFLAGS) + +pkginclude_HEADERS = include/zookeeper.h include/zookeeper_version.h include/zookeeper_log.h include/proto.h include/recordio.h generated/zookeeper.jute.h +EXTRA_DIST=LICENSE + +HASHTABLE_SRC = src/hashtable/hashtable_itr.h src/hashtable/hashtable_itr.c \ + src/hashtable/hashtable_private.h src/hashtable/hashtable.h src/hashtable/hashtable.c + +noinst_LTLIBRARIES = libhashtable.la +libhashtable_la_SOURCES = $(HASHTABLE_SRC) + +COMMON_SRC = src/zookeeper.c include/zookeeper.h include/zookeeper_version.h include/zookeeper_log.h\ + src/recordio.c include/recordio.h include/proto.h \ + src/zk_adaptor.h generated/zookeeper.jute.c \ + src/zookeeper_log.h src/zk_log.c src/zk_hashtable.h src/zk_hashtable.c + +# These are the symbols (classes, mostly) we want to export from our library. +EXPORT_SYMBOLS = '(zoo_|zookeeper_|zhandle|Z|format_log_message|log_message|logLevel|deallocate_|allocate_|zerror|is_unrecoverable)' +noinst_LTLIBRARIES += libzkst.la +libzkst_la_SOURCES =$(COMMON_SRC) src/st_adaptor.c +libzkst_la_LIBADD = -lm + +lib_LTLIBRARIES = libzookeeper_st.la +libzookeeper_st_la_SOURCES = +libzookeeper_st_la_LIBADD=libzkst.la libhashtable.la +libzookeeper_st_la_DEPENDENCIES=libzkst.la libhashtable.la +libzookeeper_st_la_LDFLAGS = $(LIB_LDFLAGS) -export-symbols-regex $(EXPORT_SYMBOLS) + +if WANT_SYNCAPI +noinst_LTLIBRARIES += libzkmt.la +libzkmt_la_SOURCES =$(COMMON_SRC) src/mt_adaptor.c +libzkmt_la_CFLAGS = -DTHREADED +libzkmt_la_LIBADD = -lm + +lib_LTLIBRARIES += libzookeeper_mt.la +libzookeeper_mt_la_SOURCES = +libzookeeper_mt_la_LIBADD=libzkmt.la libhashtable.la -lpthread +libzookeeper_mt_la_DEPENDENCIES=libzkmt.la libhashtable.la +libzookeeper_mt_la_LDFLAGS = $(LIB_LDFLAGS) -export-symbols-regex $(EXPORT_SYMBOLS) +endif + +bin_PROGRAMS = cli_st + +cli_st_SOURCES = src/cli.c +cli_st_LDADD = libzookeeper_st.la + +if WANT_SYNCAPI +bin_PROGRAMS += cli_mt load_gen + +cli_mt_SOURCES = src/cli.c +cli_mt_LDADD = libzookeeper_mt.la +cli_mt_CFLAGS = -DTHREADED + +load_gen_SOURCES = src/load_gen.c +load_gen_LDADD = libzookeeper_mt.la +load_gen_CFLAGS = -DTHREADED + +endif + +######################################################################### +# build and run unit tests + +EXTRA_DIST+=$(wildcard ${srcdir}/tests/*.cc) $(wildcard ${srcdir}/tests/*.h) \ + ${srcdir}/tests/wrappers.opt ${srcdir}/tests/wrappers-mt.opt + +TEST_SOURCES = tests/TestDriver.cc tests/LibCMocks.cc tests/LibCSymTable.cc \ + tests/MocksBase.cc tests/ZKMocks.cc tests/Util.cc tests/ThreadingUtil.cc \ + tests/TestClientRetry.cc \ + tests/TestOperations.cc tests/TestZookeeperInit.cc \ + tests/TestZookeeperClose.cc tests/TestClient.cc \ + tests/TestMulti.cc tests/TestWatchers.cc + + +if SOLARIS + SHELL_SYMBOL_WRAPPERS = cat ${srcdir}/tests/wrappers.opt + SYMBOL_WRAPPERS=$(SHELL_SYMBOL_WRAPPERS:sh) +else + SYMBOL_WRAPPERS=$(shell cat ${srcdir}/tests/wrappers.opt) +endif + +check_PROGRAMS = zktest-st +nodist_zktest_st_SOURCES = $(TEST_SOURCES) +zktest_st_LDADD = libzkst.la libhashtable.la $(CPPUNIT_LIBS) +zktest_st_CXXFLAGS = -DUSE_STATIC_LIB $(CPPUNIT_CFLAGS) $(USEIPV6) $(SOLARIS_CPPFLAGS) +zktest_st_LDFLAGS = -static-libtool-libs $(SYMBOL_WRAPPERS) $(SOLARIS_LIB_LDFLAGS) + +if WANT_SYNCAPI + check_PROGRAMS += zktest-mt + nodist_zktest_mt_SOURCES = $(TEST_SOURCES) tests/PthreadMocks.cc + zktest_mt_LDADD = libzkmt.la libhashtable.la -lpthread $(CPPUNIT_LIBS) + zktest_mt_CXXFLAGS = -DUSE_STATIC_LIB -DTHREADED $(CPPUNIT_CFLAGS) $(USEIPV6) +if SOLARIS + SHELL_SYMBOL_WRAPPERS_MT = cat ${srcdir}/tests/wrappers-mt.opt + SYMBOL_WRAPPERS_MT=$(SYMBOL_WRAPPERS) $(SHELL_SYMBOL_WRAPPERS_MT:sh) +else + SYMBOL_WRAPPERS_MT=$(SYMBOL_WRAPPERS) $(shell cat ${srcdir}/tests/wrappers-mt.opt) +endif + zktest_mt_LDFLAGS = -static-libtool-libs $(SYMBOL_WRAPPERS_MT) $(SOLARIS_LIB_LDFLAGS) +endif + +run-check: check + ./zktest-st $(TEST_OPTIONS) +if WANT_SYNCAPI + ./zktest-mt $(TEST_OPTIONS) +endif + +clean-local: clean-check + $(RM) $(DX_CLEANFILES) + +clean-check: + $(RM) $(nodist_zktest_st_OBJECTS) $(nodist_zktest_mt_OBJECTS) diff --git a/src/c/NOTICE.txt b/src/c/NOTICE.txt new file mode 100644 index 0000000..dcd9d53 --- /dev/null +++ b/src/c/NOTICE.txt @@ -0,0 +1,41 @@ +Apache ZooKeeper +Copyright 2009-2018 The Apache Software Foundation + +This product includes software developed at +The Apache Software Foundation (http://www.apache.org/). + +---------- +include/winstdint.h is included only for Windows Client support, as follows: + +// ISO C9x compliant stdint.h for Microsoft Visual Studio +// Based on ISO/IEC 9899:TC2 Committee draft (May 6, 2005) WG14/N1124 +// +// Copyright (c) 2006-2008 Alexander Chemeris +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are met: +// +// 1. Redistributions of source code must retain the above copyright notice, +// this list of conditions and the following disclaimer. +// +// 2. Redistributions in binary form must reproduce the above copyright +// notice, this list of conditions and the following disclaimer in the +// documentation and/or other materials provided with the distribution. +// +// 3. The name of the author may be used to endorse or promote products +// derived from this software without specific prior written permission. +// +// THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED +// WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF +// MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO +// EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, +// PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; +// OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, +// WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR +// OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF +// ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +// +/////////////////////////////////////////////////////////////////////////////// + +---------- diff --git a/src/c/README b/src/c/README new file mode 100644 index 0000000..5115845 --- /dev/null +++ b/src/c/README @@ -0,0 +1,156 @@ + Zookeeper C client library + + +This package provides a C client interface to Zookeeper server. + +For the latest information about ZooKeeper, please visit our website at: + http://zookeeper.apache.org/ +and our wiki, at: + https://cwiki.apache.org/confluence/display/ZOOKEEPER + +Full documentation for this release can also be found in ../../docs/index.html + + +OVERVIEW + +The client supports two types of APIs -- synchronous and asynchronous. + +Asynchronous API provides non-blocking operations with completion callbacks and +relies on the application to implement event multiplexing on its behalf. + +On the other hand, Synchronous API provides a blocking flavor of +zookeeper operations and runs its own event loop in a separate thread. + +Sync and Async APIs can be mixed and matched within the same application. + +The package includes two shared libraries: zookeeper_st and +zookeeper_mt. The former only provides the Async API and is not +thread-safe. The only reason this library exists is to support the +platforms were pthread library is not available or unstable +(i.e. FreeBSD 4.x). In all other cases the application developers are +advised to link against zookeeper_mt as it includes support for both +Sync and Async API. + + +INSTALLATION + +If you're building the client from a source checkout you need to +follow the steps outlined below. If you're building from a release +tar downloaded from Apache please skip to step 2. + +1) do a "ant compile_jute" from the zookeeper top level directory (.../trunk). + This will create a directory named "generated" under src/c. Skip to step 3. +2) unzip/untar the source tarball and cd to the zookeeper-x.x.x/src/c directory +3) change directory to src/c and do a "autoreconf -if" to bootstrap + autoconf, automake and libtool. Please make sure you have autoconf + version 2.59 or greater installed. If cppunit is installed in a non-standard + directory, you need to specify where to find cppunit.m4. For example, if + cppunit is installed under /usr/local, run: + + ACLOCAL="aclocal -I /usr/local/share/aclocal" autoreconf -if + +4) do a "./configure [OPTIONS]" to generate the makefile. See INSTALL + for general information about running configure. Additionally, the + configure supports the following options: + --enable-debug enables optimization and enables debug info compiler + options, disabled by default + --without-syncapi disables Sync API support; zookeeper_mt library won't + be built, enabled by default + --disable-static do not build static libraries, enabled by default + --disable-shared do not build shared libraries, enabled by default + --without-cppunit do not build the test library, enabled by default. + +5) do a "make" or "make install" to build the libraries and install them. + Alternatively, you can also build and run a unit test suite (and + you probably should). Please make sure you have cppunit-1.10.x or + higher installed before you execute step 4. Once ./configure has + finished, do a "make run-check". It will build the libraries, build + the tests and run them. +6) to generate doxygen documentation do a "make doxygen-doc". All + documentations will be placed to a new subfolder named docs. By + default only HTML documentation is generated. For information on + other document formats please use "./configure --help" + +Alternatively you can use the CMake build system. On Windows, this is required. +Follow steps 1 and 2 above, and then continue here. + +1) do a "cmake [OPTIONS]" to generate the makefile or msbuild files (the correct + build system will be generated based on your platform). Some options from above + are supported: + -DCMAKE_BUILD_TYPE Debug by default, Release enables optimzation etc. + -DWANT_SYNCAPI ON by default, OFF disables the Sync API support + -DWANT_CPPUNIT ON except on Windows, OFF disables the tests + -DBUILD_SHARED_LIBS not yet supported, only static libraries are built + other CMake options see "cmake --help" for generic options, such as generator + +2) do a "cmake --build ." to build the default targets. Alternatively you can + invoke "make" or "msbuild" manually. If the tests were enabled, use "ctest -V" + to run them. + +Current limitations of the CMake build system include lack of Solaris support, +no shared library option, no explicitly exported symbols (all are exported by +default), no versions on the libraries, and no documentation generation. +Features of CMake include a single, easily consumed cross-platform build system +to generate the ZooKeeper C Client libraries for any project, with little to no +configuration. + +EXAMPLE/SAMPLE C CLIENT SHELL + +NOTE: the ZooKeeper C client shell (cli_st and cli_mt) is meant as a +example/sample of ZooKeeper C client API usage. It is not a full +fledged client and not meant for production usage - see the Java +client shell for a fully featured shell. + +You can test your client by running a zookeeper server (see +instructions on the project wiki page on how to run it) and connecting +to it using the zookeeper shell application cli that is built as part +of the installation procedure. + +cli_mt (multithreaded, built against zookeeper_mt library) is shown in +this example, but you could also use cli_st (singlethreaded, built +against zookeeper_st library): + +$ cli_mt zookeeper_host:9876 + +This is a client application that gives you a shell for executing +simple zookeeper commands. Once successfully started and connected to +the server it displays a shell prompt. + +You can now enter zookeeper commands. For example, to create a node: + +> create /my_new_node + +To verify that the node's been created: + +> ls / + +You should see a list of nodes who are the children of the root node "/". + +Here's a list of command supported by the cli shell: + +ls -- list children of a znode identified by . The + command set a children watch on the znode. +get -- get the value of a znode at +set -- set the value of a znode at to +create [+e|+s] -- create a znode as a child of znode ; + use +e option to create an ephemeral znode, + use +s option to create a znode with a sequence number + appended to the name. The operation will fail if + the parent znode (the one identified by ) doesn't + exist. +delete -- delete the znode at . The command will fail if the znode + has children. +sync -- make sure all pending updates have been applied to znode at +exists -- returns a result code indicating whether the znode at + exists. The command also sets a znode watch. +myid -- prints out the current zookeeper session id. +quit -- exit the shell. + +In order to be able to use the zookeeper API in your application you have to +1) remember to include the zookeeper header + #include +2) use -DTHREADED compiler option to enable Sync API; in this case you should + be linking your code against zookeeper_mt library + +Please take a look at cli.c to understand how to use the two API types. +(TODO: some kind of short tutorial would be helpful, I guess) diff --git a/src/c/acinclude.m4 b/src/c/acinclude.m4 new file mode 100644 index 0000000..d0041d8 --- /dev/null +++ b/src/c/acinclude.m4 @@ -0,0 +1,312 @@ +# This file is part of Autoconf. -*- Autoconf -*- + +# Copyright (C) 2004 Oren Ben-Kiki +# This file is distributed under the same terms as the Autoconf macro files. + +# Generate automatic documentation using Doxygen. Works in concert with the +# aminclude.m4 file and a compatible doxygen configuration file. Defines the +# following public macros: +# +# DX_???_FEATURE(ON|OFF) - control the default setting fo a Doxygen feature. +# Supported features are 'DOXYGEN' itself, 'DOT' for generating graphics, +# 'HTML' for plain HTML, 'CHM' for compressed HTML help (for MS users), 'CHI' +# for generating a seperate .chi file by the .chm file, and 'MAN', 'RTF', +# 'XML', 'PDF' and 'PS' for the appropriate output formats. The environment +# variable DOXYGEN_PAPER_SIZE may be specified to override the default 'a4wide' +# paper size. +# +# By default, HTML, PDF and PS documentation is generated as this seems to be +# the most popular and portable combination. MAN pages created by Doxygen are +# usually problematic, though by picking an appropriate subset and doing some +# massaging they might be better than nothing. CHM and RTF are specific for MS +# (note that you can't generate both HTML and CHM at the same time). The XML is +# rather useless unless you apply specialized post-processing to it. +# +# The macro mainly controls the default state of the feature. The use can +# override the default by specifying --enable or --disable. The macros ensure +# that contradictory flags are not given (e.g., --enable-doxygen-html and +# --enable-doxygen-chm, --enable-doxygen-anything with --disable-doxygen, etc.) +# Finally, each feature will be automatically disabled (with a warning) if the +# required programs are missing. +# +# Once all the feature defaults have been specified, call DX_INIT_DOXYGEN with +# the following parameters: a one-word name for the project for use as a +# filename base etc., an optional configuration file name (the default is +# 'Doxyfile', the same as Doxygen's default), and an optional output directory +# name (the default is 'doxygen-doc'). + +## ----------## +## Defaults. ## +## ----------## + +DX_ENV="" +AC_DEFUN([DX_FEATURE_doc], ON) +AC_DEFUN([DX_FEATURE_dot], ON) +AC_DEFUN([DX_FEATURE_man], OFF) +AC_DEFUN([DX_FEATURE_html], ON) +AC_DEFUN([DX_FEATURE_chm], OFF) +AC_DEFUN([DX_FEATURE_chi], OFF) +AC_DEFUN([DX_FEATURE_rtf], OFF) +AC_DEFUN([DX_FEATURE_xml], OFF) +AC_DEFUN([DX_FEATURE_pdf], ON) +AC_DEFUN([DX_FEATURE_ps], ON) + +## --------------- ## +## Private macros. ## +## --------------- ## + +# DX_ENV_APPEND(VARIABLE, VALUE) +# ------------------------------ +# Append VARIABLE="VALUE" to DX_ENV for invoking doxygen. +AC_DEFUN([DX_ENV_APPEND], [AC_SUBST([DX_ENV], ["$DX_ENV $1='$2'"])]) + +# DX_DIRNAME_EXPR +# --------------- +# Expand into a shell expression prints the directory part of a path. +AC_DEFUN([DX_DIRNAME_EXPR], + [[expr ".$1" : '\(\.\)[^/]*$' \| "x$1" : 'x\(.*\)/[^/]*$']]) + +# DX_IF_FEATURE(FEATURE, IF-ON, IF-OFF) +# ------------------------------------- +# Expands according to the M4 (static) status of the feature. +AC_DEFUN([DX_IF_FEATURE], [ifelse(DX_FEATURE_$1, ON, [$2], [$3])]) + +# DX_REQUIRE_PROG(VARIABLE, PROGRAM) +# ---------------------------------- +# Require the specified program to be found for the DX_CURRENT_FEATURE to work. +AC_DEFUN([DX_REQUIRE_PROG], [ +AC_PATH_TOOL([$1], [$2]) +if test "$DX_FLAG_$[DX_CURRENT_FEATURE$$1]" = 1; then + AC_MSG_WARN([$2 not found - will not DX_CURRENT_DESCRIPTION]) + AC_SUBST([DX_FLAG_]DX_CURRENT_FEATURE, 0) +fi +]) + +# DX_TEST_FEATURE(FEATURE) +# ------------------------ +# Expand to a shell expression testing whether the feature is active. +AC_DEFUN([DX_TEST_FEATURE], [test "$DX_FLAG_$1" = 1]) + +# DX_CHECK_DEPEND(REQUIRED_FEATURE, REQUIRED_STATE) +# ------------------------------------------------- +# Verify that a required features has the right state before trying to turn on +# the DX_CURRENT_FEATURE. +AC_DEFUN([DX_CHECK_DEPEND], [ +test "$DX_FLAG_$1" = "$2" \ +|| AC_MSG_ERROR([doxygen-DX_CURRENT_FEATURE ifelse([$2], 1, + requires, contradicts) doxygen-DX_CURRENT_FEATURE]) +]) + +# DX_CLEAR_DEPEND(FEATURE, REQUIRED_FEATURE, REQUIRED_STATE) +# ---------------------------------------------------------- +# Turn off the DX_CURRENT_FEATURE if the required feature is off. +AC_DEFUN([DX_CLEAR_DEPEND], [ +test "$DX_FLAG_$1" = "$2" || AC_SUBST([DX_FLAG_]DX_CURRENT_FEATURE, 0) +]) + +# DX_FEATURE_ARG(FEATURE, DESCRIPTION, +# CHECK_DEPEND, CLEAR_DEPEND, +# REQUIRE, DO-IF-ON, DO-IF-OFF) +# -------------------------------------------- +# Parse the command-line option controlling a feature. CHECK_DEPEND is called +# if the user explicitly turns the feature on (and invokes DX_CHECK_DEPEND), +# otherwise CLEAR_DEPEND is called to turn off the default state if a required +# feature is disabled (using DX_CLEAR_DEPEND). REQUIRE performs additional +# requirement tests (DX_REQUIRE_PROG). Finally, an automake flag is set and +# DO-IF-ON or DO-IF-OFF are called according to the final state of the feature. +AC_DEFUN([DX_ARG_ABLE], [ + AC_DEFUN([DX_CURRENT_FEATURE], [$1]) + AC_DEFUN([DX_CURRENT_DESCRIPTION], [$2]) + AC_ARG_ENABLE(doxygen-$1, + [AS_HELP_STRING(DX_IF_FEATURE([$1], [--disable-doxygen-$1], + [--enable-doxygen-$1]), + DX_IF_FEATURE([$1], [don't $2], [$2]))], + [ +case "$enableval" in +#( +y|Y|yes|Yes|YES) + AC_SUBST([DX_FLAG_$1], 1) + $3 +;; #( +n|N|no|No|NO) + AC_SUBST([DX_FLAG_$1], 0) +;; #( +*) + AC_MSG_ERROR([invalid value '$enableval' given to doxygen-$1]) +;; +esac +], [ +AC_SUBST([DX_FLAG_$1], [DX_IF_FEATURE([$1], 1, 0)]) +$4 +]) +if DX_TEST_FEATURE([$1]); then + $5 + : +fi +if DX_TEST_FEATURE([$1]); then + AM_CONDITIONAL(DX_COND_$1, :) + $6 + : +else + AM_CONDITIONAL(DX_COND_$1, false) + $7 + : +fi +]) + +## -------------- ## +## Public macros. ## +## -------------- ## + +# DX_XXX_FEATURE(DEFAULT_STATE) +# ----------------------------- +AC_DEFUN([DX_DOXYGEN_FEATURE], [AC_DEFUN([DX_FEATURE_doc], [$1])]) +AC_DEFUN([DX_MAN_FEATURE], [AC_DEFUN([DX_FEATURE_man], [$1])]) +AC_DEFUN([DX_HTML_FEATURE], [AC_DEFUN([DX_FEATURE_html], [$1])]) +AC_DEFUN([DX_CHM_FEATURE], [AC_DEFUN([DX_FEATURE_chm], [$1])]) +AC_DEFUN([DX_CHI_FEATURE], [AC_DEFUN([DX_FEATURE_chi], [$1])]) +AC_DEFUN([DX_RTF_FEATURE], [AC_DEFUN([DX_FEATURE_rtf], [$1])]) +AC_DEFUN([DX_XML_FEATURE], [AC_DEFUN([DX_FEATURE_xml], [$1])]) +AC_DEFUN([DX_XML_FEATURE], [AC_DEFUN([DX_FEATURE_xml], [$1])]) +AC_DEFUN([DX_PDF_FEATURE], [AC_DEFUN([DX_FEATURE_pdf], [$1])]) +AC_DEFUN([DX_PS_FEATURE], [AC_DEFUN([DX_FEATURE_ps], [$1])]) + +# DX_INIT_DOXYGEN(PROJECT, [CONFIG-FILE], [OUTPUT-DOC-DIR]) +# --------------------------------------------------------- +# PROJECT also serves as the base name for the documentation files. +# The default CONFIG-FILE is "Doxyfile" and OUTPUT-DOC-DIR is "doxygen-doc". +AC_DEFUN([DX_INIT_DOXYGEN], [ + +# Files: +AC_SUBST([DX_PROJECT], [$1]) +AC_SUBST([DX_CONFIG], [ifelse([$2], [], Doxyfile, [$2])]) +AC_SUBST([DX_DOCDIR], [ifelse([$3], [], doxygen-doc, [$3])]) + +# Environment variables used inside doxygen.cfg: +DX_ENV_APPEND(SRCDIR, $srcdir) +DX_ENV_APPEND(PROJECT, $DX_PROJECT) +DX_ENV_APPEND(DOCDIR, $DX_DOCDIR) +DX_ENV_APPEND(VERSION, $PACKAGE_VERSION) + +# Doxygen itself: +DX_ARG_ABLE(doc, [generate any doxygen documentation], + [], + [], + [DX_REQUIRE_PROG([DX_DOXYGEN], doxygen) + DX_REQUIRE_PROG([DX_PERL], perl)], + [DX_ENV_APPEND(PERL_PATH, $DX_PERL)]) + +# Dot for graphics: +DX_ARG_ABLE(dot, [generate graphics for doxygen documentation], + [DX_CHECK_DEPEND(doc, 1)], + [DX_CLEAR_DEPEND(doc, 1)], + [DX_REQUIRE_PROG([DX_DOT], dot)], + [DX_ENV_APPEND(HAVE_DOT, YES) + DX_ENV_APPEND(DOT_PATH, [`DX_DIRNAME_EXPR($DX_DOT)`])], + [DX_ENV_APPEND(HAVE_DOT, NO)]) + +# Man pages generation: +DX_ARG_ABLE(man, [generate doxygen manual pages], + [DX_CHECK_DEPEND(doc, 1)], + [DX_CLEAR_DEPEND(doc, 1)], + [], + [DX_ENV_APPEND(GENERATE_MAN, YES)], + [DX_ENV_APPEND(GENERATE_MAN, NO)]) + +# RTF file generation: +DX_ARG_ABLE(rtf, [generate doxygen RTF documentation], + [DX_CHECK_DEPEND(doc, 1)], + [DX_CLEAR_DEPEND(doc, 1)], + [], + [DX_ENV_APPEND(GENERATE_RTF, YES)], + [DX_ENV_APPEND(GENERATE_RTF, NO)]) + +# XML file generation: +DX_ARG_ABLE(xml, [generate doxygen XML documentation], + [DX_CHECK_DEPEND(doc, 1)], + [DX_CLEAR_DEPEND(doc, 1)], + [], + [DX_ENV_APPEND(GENERATE_XML, YES)], + [DX_ENV_APPEND(GENERATE_XML, NO)]) + +# (Compressed) HTML help generation: +DX_ARG_ABLE(chm, [generate doxygen compressed HTML help documentation], + [DX_CHECK_DEPEND(doc, 1)], + [DX_CLEAR_DEPEND(doc, 1)], + [DX_REQUIRE_PROG([DX_HHC], hhc)], + [DX_ENV_APPEND(HHC_PATH, $DX_HHC) + DX_ENV_APPEND(GENERATE_HTML, YES) + DX_ENV_APPEND(GENERATE_HTMLHELP, YES)], + [DX_ENV_APPEND(GENERATE_HTMLHELP, NO)]) + +# Seperate CHI file generation. +DX_ARG_ABLE(chi, [generate doxygen seperate compressed HTML help index file], + [DX_CHECK_DEPEND(chm, 1)], + [DX_CLEAR_DEPEND(chm, 1)], + [], + [DX_ENV_APPEND(GENERATE_CHI, YES)], + [DX_ENV_APPEND(GENERATE_CHI, NO)]) + +# Plain HTML pages generation: +DX_ARG_ABLE(html, [generate doxygen plain HTML documentation], + [DX_CHECK_DEPEND(doc, 1) DX_CHECK_DEPEND(chm, 0)], + [DX_CLEAR_DEPEND(doc, 1) DX_CLEAR_DEPEND(chm, 0)], + [], + [DX_ENV_APPEND(GENERATE_HTML, YES)], + [DX_TEST_FEATURE(chm) || DX_ENV_APPEND(GENERATE_HTML, NO)]) + +# PostScript file generation: +DX_ARG_ABLE(ps, [generate doxygen PostScript documentation], + [DX_CHECK_DEPEND(doc, 1)], + [DX_CLEAR_DEPEND(doc, 1)], + [DX_REQUIRE_PROG([DX_LATEX], latex) + DX_REQUIRE_PROG([DX_MAKEINDEX], makeindex) + DX_REQUIRE_PROG([DX_DVIPS], dvips) + DX_REQUIRE_PROG([DX_EGREP], egrep)]) + +# PDF file generation: +DX_ARG_ABLE(pdf, [generate doxygen PDF documentation], + [DX_CHECK_DEPEND(doc, 1)], + [DX_CLEAR_DEPEND(doc, 1)], + [DX_REQUIRE_PROG([DX_PDFLATEX], pdflatex) + DX_REQUIRE_PROG([DX_MAKEINDEX], makeindex) + DX_REQUIRE_PROG([DX_EGREP], egrep)]) + +# LaTeX generation for PS and/or PDF: +if DX_TEST_FEATURE(ps) || DX_TEST_FEATURE(pdf); then + AM_CONDITIONAL(DX_COND_latex, :) + DX_ENV_APPEND(GENERATE_LATEX, YES) +else + AM_CONDITIONAL(DX_COND_latex, false) + DX_ENV_APPEND(GENERATE_LATEX, NO) +fi + +# Paper size for PS and/or PDF: +AC_ARG_VAR(DOXYGEN_PAPER_SIZE, + [a4wide (default), a4, letter, legal or executive]) +case "$DOXYGEN_PAPER_SIZE" in +#( +"") + AC_SUBST(DOXYGEN_PAPER_SIZE, "") +;; #( +a4wide|a4|letter|legal|executive) + DX_ENV_APPEND(PAPER_SIZE, $DOXYGEN_PAPER_SIZE) +;; #( +*) + AC_MSG_ERROR([unknown DOXYGEN_PAPER_SIZE='$DOXYGEN_PAPER_SIZE']) +;; +esac + +#For debugging: +#echo DX_FLAG_doc=$DX_FLAG_doc +#echo DX_FLAG_dot=$DX_FLAG_dot +#echo DX_FLAG_man=$DX_FLAG_man +#echo DX_FLAG_html=$DX_FLAG_html +#echo DX_FLAG_chm=$DX_FLAG_chm +#echo DX_FLAG_chi=$DX_FLAG_chi +#echo DX_FLAG_rtf=$DX_FLAG_rtf +#echo DX_FLAG_xml=$DX_FLAG_xml +#echo DX_FLAG_pdf=$DX_FLAG_pdf +#echo DX_FLAG_ps=$DX_FLAG_ps +#echo DX_ENV=$DX_ENV +]) diff --git a/src/c/aminclude.am b/src/c/aminclude.am new file mode 100644 index 0000000..420049e --- /dev/null +++ b/src/c/aminclude.am @@ -0,0 +1,186 @@ +# Copyright (C) 2004 Oren Ben-Kiki +# This file is distributed under the same terms as the Automake macro files. + +# Generate automatic documentation using Doxygen. Goals and variables values +# are controlled by the various DX_COND_??? conditionals set by autoconf. +# +# The provided goals are: +# doxygen-doc: Generate all doxygen documentation. +# doxygen-run: Run doxygen, which will generate some of the documentation +# (HTML, CHM, CHI, MAN, RTF, XML) but will not do the post +# processing required for the rest of it (PS, PDF, and some MAN). +# doxygen-man: Rename some doxygen generated man pages. +# doxygen-ps: Generate doxygen PostScript documentation. +# doxygen-pdf: Generate doxygen PDF documentation. +# +# Note that by default these are not integrated into the automake goals. If +# doxygen is used to generate man pages, you can achieve this integration by +# setting man3_MANS to the list of man pages generated and then adding the +# dependency: +# +# $(man3_MANS): doxygen-doc +# +# This will cause make to run doxygen and generate all the documentation. +# +# The following variable is intended for use in Makefile.am: +# +# DX_CLEANFILES = everything to clean. +# +# This is usually added to MOSTLYCLEANFILES. + +## --------------------------------- ## +## Format-independent Doxygen rules. ## +## --------------------------------- ## + +if DX_COND_doc + +## ------------------------------- ## +## Rules specific for HTML output. ## +## ------------------------------- ## + +if DX_COND_html + +DX_CLEAN_HTML = @DX_DOCDIR@/html + +endif DX_COND_html + +## ------------------------------ ## +## Rules specific for CHM output. ## +## ------------------------------ ## + +if DX_COND_chm + +DX_CLEAN_CHM = @DX_DOCDIR@/chm + +if DX_COND_chi + +DX_CLEAN_CHI = @DX_DOCDIR@/@PACKAGE@.chi + +endif DX_COND_chi + +endif DX_COND_chm + +## ------------------------------ ## +## Rules specific for MAN output. ## +## ------------------------------ ## + +if DX_COND_man + +DX_CLEAN_MAN = @DX_DOCDIR@/man + +endif DX_COND_man + +## ------------------------------ ## +## Rules specific for RTF output. ## +## ------------------------------ ## + +if DX_COND_rtf + +DX_CLEAN_RTF = @DX_DOCDIR@/rtf + +endif DX_COND_rtf + +## ------------------------------ ## +## Rules specific for XML output. ## +## ------------------------------ ## + +if DX_COND_xml + +DX_CLEAN_XML = @DX_DOCDIR@/xml + +endif DX_COND_xml + +## ----------------------------- ## +## Rules specific for PS output. ## +## ----------------------------- ## + +if DX_COND_ps + +DX_CLEAN_PS = @DX_DOCDIR@/@PACKAGE@.ps + +DX_PS_GOAL = doxygen-ps + +doxygen-ps: @DX_DOCDIR@/@PACKAGE@.ps + +@DX_DOCDIR@/@PACKAGE@.ps: @DX_DOCDIR@/@PACKAGE@.tag + cd @DX_DOCDIR@/latex; \ + rm -f *.aux *.toc *.idx *.ind *.ilg *.log *.out; \ + $(DX_LATEX) refman.tex; \ + $(MAKEINDEX_PATH) refman.idx; \ + $(DX_LATEX) refman.tex; \ + countdown=5; \ + while $(DX_EGREP) 'Rerun (LaTeX|to get cross-references right)' \ + refman.log > /dev/null 2>&1 \ + && test $$countdown -gt 0; do \ + $(DX_LATEX) refman.tex; \ + countdown=`expr $$countdown - 1`; \ + done; \ + $(DX_DVIPS) -o ../@PACKAGE@.ps refman.dvi + +endif DX_COND_ps + +## ------------------------------ ## +## Rules specific for PDF output. ## +## ------------------------------ ## + +if DX_COND_pdf + +DX_CLEAN_PDF = @DX_DOCDIR@/@PACKAGE@.pdf + +DX_PDF_GOAL = doxygen-pdf + +doxygen-pdf: @DX_DOCDIR@/@PACKAGE@.pdf + +@DX_DOCDIR@/@PACKAGE@.pdf: @DX_DOCDIR@/@PACKAGE@.tag + cd @DX_DOCDIR@/latex; \ + rm -f *.aux *.toc *.idx *.ind *.ilg *.log *.out; \ + $(DX_PDFLATEX) refman.tex; \ + $(DX_MAKEINDEX) refman.idx; \ + $(DX_PDFLATEX) refman.tex; \ + countdown=5; \ + while $(DX_EGREP) 'Rerun (LaTeX|to get cross-references right)' \ + refman.log > /dev/null 2>&1 \ + && test $$countdown -gt 0; do \ + $(DX_PDFLATEX) refman.tex; \ + countdown=`expr $$countdown - 1`; \ + done; \ + mv refman.pdf ../@PACKAGE@.pdf + +endif DX_COND_pdf + +## ------------------------------------------------- ## +## Rules specific for LaTeX (shared for PS and PDF). ## +## ------------------------------------------------- ## + +if DX_COND_latex + +DX_CLEAN_LATEX = @DX_DOCDIR@/latex + +endif DX_COND_latex + +.PHONY: doxygen-run doxygen-doc $(DX_PS_GOAL) $(DX_PDF_GOAL) + +.INTERMEDIATE: doxygen-run $(DX_PS_GOAL) $(DX_PDF_GOAL) + +doxygen-run: @DX_DOCDIR@/@PACKAGE@.tag + +doxygen-doc: doxygen-run $(DX_PS_GOAL) $(DX_PDF_GOAL) + +@DX_DOCDIR@/@PACKAGE@.tag: $(DX_CONFIG) $(pkginclude_HEADERS) + rm -rf @DX_DOCDIR@ + $(DX_ENV) $(DX_DOXYGEN) $(srcdir)/$(DX_CONFIG) + +DX_CLEANFILES = \ + @DX_DOCDIR@/@PACKAGE@.tag \ + -r \ + $(DX_CLEAN_HTML) \ + $(DX_CLEAN_CHM) \ + $(DX_CLEAN_CHI) \ + $(DX_CLEAN_MAN) \ + $(DX_CLEAN_RTF) \ + $(DX_CLEAN_XML) \ + $(DX_CLEAN_PS) \ + $(DX_CLEAN_PDF) \ + $(DX_CLEAN_LATEX) + +endif DX_COND_doc diff --git a/src/c/c-doc.Doxyfile b/src/c/c-doc.Doxyfile new file mode 100644 index 0000000..e9029cb --- /dev/null +++ b/src/c/c-doc.Doxyfile @@ -0,0 +1,1252 @@ +# Doxyfile 1.4.7 + +# This file describes the settings to be used by the documentation system +# doxygen (www.doxygen.org) for a project +# +# All text after a hash (#) is considered a comment and will be ignored +# The format is: +# TAG = value [value, ...] +# For lists items can also be appended using: +# TAG += value [value, ...] +# Values that contain spaces should be placed between quotes (" ") + +#--------------------------------------------------------------------------- +# Project related configuration options +#--------------------------------------------------------------------------- + +# The PROJECT_NAME tag is a single word (or a sequence of words surrounded +# by quotes) that should identify the project. + +PROJECT_NAME = $(PROJECT)-$(VERSION) + +# The PROJECT_NUMBER tag can be used to enter a project or revision number. +# This could be handy for archiving the generated documentation or +# if some version control system is used. + +PROJECT_NUMBER = + +# The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute) +# base path where the generated documentation will be put. +# If a relative path is entered, it will be relative to the location +# where doxygen was started. If left blank the current directory will be used. + +OUTPUT_DIRECTORY = $(DOCDIR) + +# If the CREATE_SUBDIRS tag is set to YES, then doxygen will create +# 4096 sub-directories (in 2 levels) under the output directory of each output +# format and will distribute the generated files over these directories. +# Enabling this option can be useful when feeding doxygen a huge amount of +# source files, where putting all generated files in the same directory would +# otherwise cause performance problems for the file system. + +CREATE_SUBDIRS = NO + +# The OUTPUT_LANGUAGE tag is used to specify the language in which all +# documentation generated by doxygen is written. Doxygen will use this +# information to generate all constant output in the proper language. +# The default language is English, other supported languages are: +# Brazilian, Catalan, Chinese, Chinese-Traditional, Croatian, Czech, Danish, +# Dutch, Finnish, French, German, Greek, Hungarian, Italian, Japanese, +# Japanese-en (Japanese with English messages), Korean, Korean-en, Norwegian, +# Polish, Portuguese, Romanian, Russian, Serbian, Slovak, Slovene, Spanish, +# Swedish, and Ukrainian. + +OUTPUT_LANGUAGE = English + +# This tag can be used to specify the encoding used in the generated output. +# The encoding is not always determined by the language that is chosen, +# but also whether or not the output is meant for Windows or non-Windows users. +# In case there is a difference, setting the USE_WINDOWS_ENCODING tag to YES +# forces the Windows encoding (this is the default for the Windows binary), +# whereas setting the tag to NO uses a Unix-style encoding (the default for +# all platforms other than Windows). + +USE_WINDOWS_ENCODING = NO + +# If the BRIEF_MEMBER_DESC tag is set to YES (the default) Doxygen will +# include brief member descriptions after the members that are listed in +# the file and class documentation (similar to JavaDoc). +# Set to NO to disable this. + +BRIEF_MEMBER_DESC = YES + +# If the REPEAT_BRIEF tag is set to YES (the default) Doxygen will prepend +# the brief description of a member or function before the detailed description. +# Note: if both HIDE_UNDOC_MEMBERS and BRIEF_MEMBER_DESC are set to NO, the +# brief descriptions will be completely suppressed. + +REPEAT_BRIEF = YES + +# This tag implements a quasi-intelligent brief description abbreviator +# that is used to form the text in various listings. Each string +# in this list, if found as the leading text of the brief description, will be +# stripped from the text and the result after processing the whole list, is +# used as the annotated text. Otherwise, the brief description is used as-is. +# If left blank, the following values are used ("$name" is automatically +# replaced with the name of the entity): "The $name class" "The $name widget" +# "The $name file" "is" "provides" "specifies" "contains" +# "represents" "a" "an" "the" + +ABBREVIATE_BRIEF = + +# If the ALWAYS_DETAILED_SEC and REPEAT_BRIEF tags are both set to YES then +# Doxygen will generate a detailed section even if there is only a brief +# description. + +ALWAYS_DETAILED_SEC = NO + +# If the INLINE_INHERITED_MEMB tag is set to YES, doxygen will show all +# inherited members of a class in the documentation of that class as if those +# members were ordinary class members. Constructors, destructors and assignment +# operators of the base classes will not be shown. + +INLINE_INHERITED_MEMB = NO + +# If the FULL_PATH_NAMES tag is set to YES then Doxygen will prepend the full +# path before files name in the file list and in the header files. If set +# to NO the shortest path that makes the file name unique will be used. + +FULL_PATH_NAMES = YES + +# If the FULL_PATH_NAMES tag is set to YES then the STRIP_FROM_PATH tag +# can be used to strip a user-defined part of the path. Stripping is +# only done if one of the specified strings matches the left-hand part of +# the path. The tag can be used to show relative paths in the file list. +# If left blank the directory from which doxygen is run is used as the +# path to strip. + +STRIP_FROM_PATH = + +# The STRIP_FROM_INC_PATH tag can be used to strip a user-defined part of +# the path mentioned in the documentation of a class, which tells +# the reader which header file to include in order to use a class. +# If left blank only the name of the header file containing the class +# definition is used. Otherwise one should specify the include paths that +# are normally passed to the compiler using the -I flag. + +STRIP_FROM_INC_PATH = + +# If the SHORT_NAMES tag is set to YES, doxygen will generate much shorter +# (but less readable) file names. This can be useful is your file systems +# doesn't support long names like on DOS, Mac, or CD-ROM. + +SHORT_NAMES = NO + +# If the JAVADOC_AUTOBRIEF tag is set to YES then Doxygen +# will interpret the first line (until the first dot) of a JavaDoc-style +# comment as the brief description. If set to NO, the JavaDoc +# comments will behave just like the Qt-style comments (thus requiring an +# explicit @brief command for a brief description. + +JAVADOC_AUTOBRIEF = NO + +# The MULTILINE_CPP_IS_BRIEF tag can be set to YES to make Doxygen +# treat a multi-line C++ special comment block (i.e. a block of //! or /// +# comments) as a brief description. This used to be the default behaviour. +# The new default is to treat a multi-line C++ comment block as a detailed +# description. Set this tag to YES if you prefer the old behaviour instead. + +MULTILINE_CPP_IS_BRIEF = NO + +# If the DETAILS_AT_TOP tag is set to YES then Doxygen +# will output the detailed description near the top, like JavaDoc. +# If set to NO, the detailed description appears after the member +# documentation. + +DETAILS_AT_TOP = NO + +# If the INHERIT_DOCS tag is set to YES (the default) then an undocumented +# member inherits the documentation from any documented member that it +# re-implements. + +INHERIT_DOCS = YES + +# If the SEPARATE_MEMBER_PAGES tag is set to YES, then doxygen will produce +# a new page for each member. If set to NO, the documentation of a member will +# be part of the file/class/namespace that contains it. + +SEPARATE_MEMBER_PAGES = NO + +# The TAB_SIZE tag can be used to set the number of spaces in a tab. +# Doxygen uses this value to replace tabs by spaces in code fragments. + +TAB_SIZE = 8 + +# This tag can be used to specify a number of aliases that acts +# as commands in the documentation. An alias has the form "name=value". +# For example adding "sideeffect=\par Side Effects:\n" will allow you to +# put the command \sideeffect (or @sideeffect) in the documentation, which +# will result in a user-defined paragraph with heading "Side Effects:". +# You can put \n's in the value part of an alias to insert newlines. + +ALIASES = + +# Set the OPTIMIZE_OUTPUT_FOR_C tag to YES if your project consists of C +# sources only. Doxygen will then generate output that is more tailored for C. +# For instance, some of the names that are used will be different. The list +# of all members will be omitted, etc. + +OPTIMIZE_OUTPUT_FOR_C = YES + +# Set the OPTIMIZE_OUTPUT_JAVA tag to YES if your project consists of Java +# sources only. Doxygen will then generate output that is more tailored for Java. +# For instance, namespaces will be presented as packages, qualified scopes +# will look different, etc. + +OPTIMIZE_OUTPUT_JAVA = NO + +# If you use STL classes (i.e. std::string, std::vector, etc.) but do not want to +# include (a tag file for) the STL sources as input, then you should +# set this tag to YES in order to let doxygen match functions declarations and +# definitions whose arguments contain STL classes (e.g. func(std::string); v.s. +# func(std::string) {}). This also make the inheritance and collaboration +# diagrams that involve STL classes more complete and accurate. + +BUILTIN_STL_SUPPORT = NO + +# If member grouping is used in the documentation and the DISTRIBUTE_GROUP_DOC +# tag is set to YES, then doxygen will reuse the documentation of the first +# member in the group (if any) for the other members of the group. By default +# all members of a group must be documented explicitly. + +DISTRIBUTE_GROUP_DOC = NO + +# Set the SUBGROUPING tag to YES (the default) to allow class member groups of +# the same type (for instance a group of public functions) to be put as a +# subgroup of that type (e.g. under the Public Functions section). Set it to +# NO to prevent subgrouping. Alternatively, this can be done per class using +# the \nosubgrouping command. + +SUBGROUPING = YES + +#--------------------------------------------------------------------------- +# Build related configuration options +#--------------------------------------------------------------------------- + +# If the EXTRACT_ALL tag is set to YES doxygen will assume all entities in +# documentation are documented, even if no documentation was available. +# Private class members and static file members will be hidden unless +# the EXTRACT_PRIVATE and EXTRACT_STATIC tags are set to YES + +EXTRACT_ALL = NO + +# If the EXTRACT_PRIVATE tag is set to YES all private members of a class +# will be included in the documentation. + +EXTRACT_PRIVATE = NO + +# If the EXTRACT_STATIC tag is set to YES all static members of a file +# will be included in the documentation. + +EXTRACT_STATIC = YES + +# If the EXTRACT_LOCAL_CLASSES tag is set to YES classes (and structs) +# defined locally in source files will be included in the documentation. +# If set to NO only classes defined in header files are included. + +EXTRACT_LOCAL_CLASSES = YES + +# This flag is only useful for Objective-C code. When set to YES local +# methods, which are defined in the implementation section but not in +# the interface are included in the documentation. +# If set to NO (the default) only methods in the interface are included. + +EXTRACT_LOCAL_METHODS = NO + +# If the HIDE_UNDOC_MEMBERS tag is set to YES, Doxygen will hide all +# undocumented members of documented classes, files or namespaces. +# If set to NO (the default) these members will be included in the +# various overviews, but no documentation section is generated. +# This option has no effect if EXTRACT_ALL is enabled. + +HIDE_UNDOC_MEMBERS = NO + +# If the HIDE_UNDOC_CLASSES tag is set to YES, Doxygen will hide all +# undocumented classes that are normally visible in the class hierarchy. +# If set to NO (the default) these classes will be included in the various +# overviews. This option has no effect if EXTRACT_ALL is enabled. + +HIDE_UNDOC_CLASSES = NO + +# If the HIDE_FRIEND_COMPOUNDS tag is set to YES, Doxygen will hide all +# friend (class|struct|union) declarations. +# If set to NO (the default) these declarations will be included in the +# documentation. + +HIDE_FRIEND_COMPOUNDS = NO + +# If the HIDE_IN_BODY_DOCS tag is set to YES, Doxygen will hide any +# documentation blocks found inside the body of a function. +# If set to NO (the default) these blocks will be appended to the +# function's detailed documentation block. + +HIDE_IN_BODY_DOCS = NO + +# The INTERNAL_DOCS tag determines if documentation +# that is typed after a \internal command is included. If the tag is set +# to NO (the default) then the documentation will be excluded. +# Set it to YES to include the internal documentation. + +INTERNAL_DOCS = NO + +# If the CASE_SENSE_NAMES tag is set to NO then Doxygen will only generate +# file names in lower-case letters. If set to YES upper-case letters are also +# allowed. This is useful if you have classes or files whose names only differ +# in case and if your file system supports case sensitive file names. Windows +# and Mac users are advised to set this option to NO. + +CASE_SENSE_NAMES = YES + +# If the HIDE_SCOPE_NAMES tag is set to NO (the default) then Doxygen +# will show members with their full class and namespace scopes in the +# documentation. If set to YES the scope will be hidden. + +HIDE_SCOPE_NAMES = NO + +# If the SHOW_INCLUDE_FILES tag is set to YES (the default) then Doxygen +# will put a list of the files that are included by a file in the documentation +# of that file. + +SHOW_INCLUDE_FILES = NO + +# If the INLINE_INFO tag is set to YES (the default) then a tag [inline] +# is inserted in the documentation for inline members. + +INLINE_INFO = YES + +# If the SORT_MEMBER_DOCS tag is set to YES (the default) then doxygen +# will sort the (detailed) documentation of file and class members +# alphabetically by member name. If set to NO the members will appear in +# declaration order. + +SORT_MEMBER_DOCS = YES + +# If the SORT_BRIEF_DOCS tag is set to YES then doxygen will sort the +# brief documentation of file, namespace and class members alphabetically +# by member name. If set to NO (the default) the members will appear in +# declaration order. + +SORT_BRIEF_DOCS = NO + +# If the SORT_BY_SCOPE_NAME tag is set to YES, the class list will be +# sorted by fully-qualified names, including namespaces. If set to +# NO (the default), the class list will be sorted only by class name, +# not including the namespace part. +# Note: This option is not very useful if HIDE_SCOPE_NAMES is set to YES. +# Note: This option applies only to the class list, not to the +# alphabetical list. + +SORT_BY_SCOPE_NAME = NO + +# The GENERATE_TODOLIST tag can be used to enable (YES) or +# disable (NO) the todo list. This list is created by putting \todo +# commands in the documentation. + +GENERATE_TODOLIST = YES + +# The GENERATE_TESTLIST tag can be used to enable (YES) or +# disable (NO) the test list. This list is created by putting \test +# commands in the documentation. + +GENERATE_TESTLIST = YES + +# The GENERATE_BUGLIST tag can be used to enable (YES) or +# disable (NO) the bug list. This list is created by putting \bug +# commands in the documentation. + +GENERATE_BUGLIST = YES + +# The GENERATE_DEPRECATEDLIST tag can be used to enable (YES) or +# disable (NO) the deprecated list. This list is created by putting +# \deprecated commands in the documentation. + +GENERATE_DEPRECATEDLIST = YES + +# The ENABLED_SECTIONS tag can be used to enable conditional +# documentation sections, marked by \if sectionname ... \endif. + +ENABLED_SECTIONS = + +# The MAX_INITIALIZER_LINES tag determines the maximum number of lines +# the initial value of a variable or define consists of for it to appear in +# the documentation. If the initializer consists of more lines than specified +# here it will be hidden. Use a value of 0 to hide initializers completely. +# The appearance of the initializer of individual variables and defines in the +# documentation can be controlled using \showinitializer or \hideinitializer +# command in the documentation regardless of this setting. + +MAX_INITIALIZER_LINES = 30 + +# Set the SHOW_USED_FILES tag to NO to disable the list of files generated +# at the bottom of the documentation of classes and structs. If set to YES the +# list will mention the files that were used to generate the documentation. + +SHOW_USED_FILES = YES + +# If the sources in your project are distributed over multiple directories +# then setting the SHOW_DIRECTORIES tag to YES will show the directory hierarchy +# in the documentation. The default is NO. + +SHOW_DIRECTORIES = NO + +# The FILE_VERSION_FILTER tag can be used to specify a program or script that +# doxygen should invoke to get the current version for each file (typically from the +# version control system). Doxygen will invoke the program by executing (via +# popen()) the command , where is the value of +# the FILE_VERSION_FILTER tag, and is the name of an input file +# provided by doxygen. Whatever the program writes to standard output +# is used as the file version. See the manual for examples. + +FILE_VERSION_FILTER = + +#--------------------------------------------------------------------------- +# configuration options related to warning and progress messages +#--------------------------------------------------------------------------- + +# The QUIET tag can be used to turn on/off the messages that are generated +# by doxygen. Possible values are YES and NO. If left blank NO is used. + +QUIET = NO + +# The WARNINGS tag can be used to turn on/off the warning messages that are +# generated by doxygen. Possible values are YES and NO. If left blank +# NO is used. + +WARNINGS = YES + +# If WARN_IF_UNDOCUMENTED is set to YES, then doxygen will generate warnings +# for undocumented members. If EXTRACT_ALL is set to YES then this flag will +# automatically be disabled. + +WARN_IF_UNDOCUMENTED = YES + +# If WARN_IF_DOC_ERROR is set to YES, doxygen will generate warnings for +# potential errors in the documentation, such as not documenting some +# parameters in a documented function, or documenting parameters that +# don't exist or using markup commands wrongly. + +WARN_IF_DOC_ERROR = YES + +# This WARN_NO_PARAMDOC option can be abled to get warnings for +# functions that are documented, but have no documentation for their parameters +# or return value. If set to NO (the default) doxygen will only warn about +# wrong or incomplete parameter documentation, but not about the absence of +# documentation. + +WARN_NO_PARAMDOC = NO + +# The WARN_FORMAT tag determines the format of the warning messages that +# doxygen can produce. The string should contain the $file, $line, and $text +# tags, which will be replaced by the file and line number from which the +# warning originated and the warning text. Optionally the format may contain +# $version, which will be replaced by the version of the file (if it could +# be obtained via FILE_VERSION_FILTER) + +WARN_FORMAT = "$file:$line: $text" + +# The WARN_LOGFILE tag can be used to specify a file to which warning +# and error messages should be written. If left blank the output is written +# to stderr. + +WARN_LOGFILE = + +#--------------------------------------------------------------------------- +# configuration options related to the input files +#--------------------------------------------------------------------------- + +# The INPUT tag can be used to specify the files and/or directories that contain +# documented source files. You may enter file names like "myfile.cpp" or +# directories like "/usr/src/myproject". Separate the files or directories +# with spaces. + +INPUT = include/zookeeper.h + +# If the value of the INPUT tag contains directories, you can use the +# FILE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp +# and *.h) to filter out the source-files in the directories. If left +# blank the following patterns are tested: +# *.c *.cc *.cxx *.cpp *.c++ *.java *.ii *.ixx *.ipp *.i++ *.inl *.h *.hh *.hxx +# *.hpp *.h++ *.idl *.odl *.cs *.php *.php3 *.inc *.m *.mm *.py + +FILE_PATTERNS = + +# The RECURSIVE tag can be used to turn specify whether or not subdirectories +# should be searched for input files as well. Possible values are YES and NO. +# If left blank NO is used. + +RECURSIVE = NO + +# The EXCLUDE tag can be used to specify files and/or directories that should +# excluded from the INPUT source files. This way you can easily exclude a +# subdirectory from a directory tree whose root is specified with the INPUT tag. + +EXCLUDE = + +# The EXCLUDE_SYMLINKS tag can be used select whether or not files or +# directories that are symbolic links (a Unix filesystem feature) are excluded +# from the input. + +EXCLUDE_SYMLINKS = NO + +# If the value of the INPUT tag contains directories, you can use the +# EXCLUDE_PATTERNS tag to specify one or more wildcard patterns to exclude +# certain files from those directories. Note that the wildcards are matched +# against the file with absolute path, so to exclude all test directories +# for example use the pattern */test/* + +EXCLUDE_PATTERNS = + +# The EXAMPLE_PATH tag can be used to specify one or more files or +# directories that contain example code fragments that are included (see +# the \include command). + +EXAMPLE_PATH = + +# If the value of the EXAMPLE_PATH tag contains directories, you can use the +# EXAMPLE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp +# and *.h) to filter out the source-files in the directories. If left +# blank all files are included. + +EXAMPLE_PATTERNS = + +# If the EXAMPLE_RECURSIVE tag is set to YES then subdirectories will be +# searched for input files to be used with the \include or \dontinclude +# commands irrespective of the value of the RECURSIVE tag. +# Possible values are YES and NO. If left blank NO is used. + +EXAMPLE_RECURSIVE = NO + +# The IMAGE_PATH tag can be used to specify one or more files or +# directories that contain image that are included in the documentation (see +# the \image command). + +IMAGE_PATH = + +# The INPUT_FILTER tag can be used to specify a program that doxygen should +# invoke to filter for each input file. Doxygen will invoke the filter program +# by executing (via popen()) the command , where +# is the value of the INPUT_FILTER tag, and is the name of an +# input file. Doxygen will then use the output that the filter program writes +# to standard output. If FILTER_PATTERNS is specified, this tag will be +# ignored. + +INPUT_FILTER = + +# The FILTER_PATTERNS tag can be used to specify filters on a per file pattern +# basis. Doxygen will compare the file name with each pattern and apply the +# filter if there is a match. The filters are a list of the form: +# pattern=filter (like *.cpp=my_cpp_filter). See INPUT_FILTER for further +# info on how filters are used. If FILTER_PATTERNS is empty, INPUT_FILTER +# is applied to all files. + +FILTER_PATTERNS = + +# If the FILTER_SOURCE_FILES tag is set to YES, the input filter (if set using +# INPUT_FILTER) will be used to filter the input files when producing source +# files to browse (i.e. when SOURCE_BROWSER is set to YES). + +FILTER_SOURCE_FILES = NO + +#--------------------------------------------------------------------------- +# configuration options related to source browsing +#--------------------------------------------------------------------------- + +# If the SOURCE_BROWSER tag is set to YES then a list of source files will +# be generated. Documented entities will be cross-referenced with these sources. +# Note: To get rid of all source code in the generated output, make sure also +# VERBATIM_HEADERS is set to NO. + +SOURCE_BROWSER = NO + +# Setting the INLINE_SOURCES tag to YES will include the body +# of functions and classes directly in the documentation. + +INLINE_SOURCES = NO + +# Setting the STRIP_CODE_COMMENTS tag to YES (the default) will instruct +# doxygen to hide any special comment blocks from generated source code +# fragments. Normal C and C++ comments will always remain visible. + +STRIP_CODE_COMMENTS = YES + +# If the REFERENCED_BY_RELATION tag is set to YES (the default) +# then for each documented function all documented +# functions referencing it will be listed. + +REFERENCED_BY_RELATION = YES + +# If the REFERENCES_RELATION tag is set to YES (the default) +# then for each documented function all documented entities +# called/used by that function will be listed. + +REFERENCES_RELATION = YES + +# If the REFERENCES_LINK_SOURCE tag is set to YES (the default) +# and SOURCE_BROWSER tag is set to YES, then the hyperlinks from +# functions in REFERENCES_RELATION and REFERENCED_BY_RELATION lists will +# link to the source code. Otherwise they will link to the documentstion. + +REFERENCES_LINK_SOURCE = YES + +# If the USE_HTAGS tag is set to YES then the references to source code +# will point to the HTML generated by the htags(1) tool instead of doxygen +# built-in source browser. The htags tool is part of GNU's global source +# tagging system (see http://www.gnu.org/software/global/global.html). You +# will need version 4.8.6 or higher. + +USE_HTAGS = NO + +# If the VERBATIM_HEADERS tag is set to YES (the default) then Doxygen +# will generate a verbatim copy of the header file for each class for +# which an include is specified. Set to NO to disable this. + +VERBATIM_HEADERS = YES + +#--------------------------------------------------------------------------- +# configuration options related to the alphabetical class index +#--------------------------------------------------------------------------- + +# If the ALPHABETICAL_INDEX tag is set to YES, an alphabetical index +# of all compounds will be generated. Enable this if the project +# contains a lot of classes, structs, unions or interfaces. + +ALPHABETICAL_INDEX = NO + +# If the alphabetical index is enabled (see ALPHABETICAL_INDEX) then +# the COLS_IN_ALPHA_INDEX tag can be used to specify the number of columns +# in which this list will be split (can be a number in the range [1..20]) + +COLS_IN_ALPHA_INDEX = 5 + +# In case all classes in a project start with a common prefix, all +# classes will be put under the same header in the alphabetical index. +# The IGNORE_PREFIX tag can be used to specify one or more prefixes that +# should be ignored while generating the index headers. + +IGNORE_PREFIX = + +#--------------------------------------------------------------------------- +# configuration options related to the HTML output +#--------------------------------------------------------------------------- + +# If the GENERATE_HTML tag is set to YES (the default) Doxygen will +# generate HTML output. + +GENERATE_HTML = $(GENERATE_HTML) + +# The HTML_OUTPUT tag is used to specify where the HTML docs will be put. +# If a relative path is entered the value of OUTPUT_DIRECTORY will be +# put in front of it. If left blank `html' will be used as the default path. + +HTML_OUTPUT = html + +# The HTML_FILE_EXTENSION tag can be used to specify the file extension for +# each generated HTML page (for example: .htm,.php,.asp). If it is left blank +# doxygen will generate files with .html extension. + +HTML_FILE_EXTENSION = .html + +# The HTML_HEADER tag can be used to specify a personal HTML header for +# each generated HTML page. If it is left blank doxygen will generate a +# standard header. + +HTML_HEADER = + +# The HTML_FOOTER tag can be used to specify a personal HTML footer for +# each generated HTML page. If it is left blank doxygen will generate a +# standard footer. + +HTML_FOOTER = + +# The HTML_STYLESHEET tag can be used to specify a user-defined cascading +# style sheet that is used by each HTML page. It can be used to +# fine-tune the look of the HTML output. If the tag is left blank doxygen +# will generate a default style sheet. Note that doxygen will try to copy +# the style sheet file to the HTML output directory, so don't put your own +# stylesheet in the HTML output directory as well, or it will be erased! + +HTML_STYLESHEET = + +# If the HTML_ALIGN_MEMBERS tag is set to YES, the members of classes, +# files or namespaces will be aligned in HTML using tables. If set to +# NO a bullet list will be used. + +HTML_ALIGN_MEMBERS = YES + +# If the GENERATE_HTMLHELP tag is set to YES, additional index files +# will be generated that can be used as input for tools like the +# Microsoft HTML help workshop to generate a compressed HTML help file (.chm) +# of the generated HTML documentation. + +GENERATE_HTMLHELP = $(GENERATE_HTMLHELP) + +# If the GENERATE_HTMLHELP tag is set to YES, the CHM_FILE tag can +# be used to specify the file name of the resulting .chm file. You +# can add a path in front of the file if the result should not be +# written to the html output directory. + +CHM_FILE = ../$(PROJECT).chm + +# If the GENERATE_HTMLHELP tag is set to YES, the HHC_LOCATION tag can +# be used to specify the location (absolute path including file name) of +# the HTML help compiler (hhc.exe). If non-empty doxygen will try to run +# the HTML help compiler on the generated index.hhp. + +HHC_LOCATION = $(HHC_PATH) + +# If the GENERATE_HTMLHELP tag is set to YES, the GENERATE_CHI flag +# controls if a separate .chi index file is generated (YES) or that +# it should be included in the master .chm file (NO). + +GENERATE_CHI = $(GENERATE_CHI) + +# If the GENERATE_HTMLHELP tag is set to YES, the BINARY_TOC flag +# controls whether a binary table of contents is generated (YES) or a +# normal table of contents (NO) in the .chm file. + +BINARY_TOC = NO + +# The TOC_EXPAND flag can be set to YES to add extra items for group members +# to the contents of the HTML help documentation and to the tree view. + +TOC_EXPAND = NO + +# The DISABLE_INDEX tag can be used to turn on/off the condensed index at +# top of each HTML page. The value NO (the default) enables the index and +# the value YES disables it. + +DISABLE_INDEX = NO + +# This tag can be used to set the number of enum values (range [1..20]) +# that doxygen will group on one line in the generated HTML documentation. + +ENUM_VALUES_PER_LINE = 4 + +# If the GENERATE_TREEVIEW tag is set to YES, a side panel will be +# generated containing a tree-like index structure (just like the one that +# is generated for HTML Help). For this to work a browser that supports +# JavaScript, DHTML, CSS and frames is required (for instance Mozilla 1.0+, +# Netscape 6.0+, Internet explorer 5.0+, or Konqueror). Windows users are +# probably better off using the HTML help feature. + +GENERATE_TREEVIEW = NO + +# If the treeview is enabled (see GENERATE_TREEVIEW) then this tag can be +# used to set the initial width (in pixels) of the frame in which the tree +# is shown. + +TREEVIEW_WIDTH = 250 + +#--------------------------------------------------------------------------- +# configuration options related to the LaTeX output +#--------------------------------------------------------------------------- + +# If the GENERATE_LATEX tag is set to YES (the default) Doxygen will +# generate Latex output. + +GENERATE_LATEX = $(GENERATE_LATEX) + +# The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put. +# If a relative path is entered the value of OUTPUT_DIRECTORY will be +# put in front of it. If left blank `latex' will be used as the default path. + +LATEX_OUTPUT = latex + +# The LATEX_CMD_NAME tag can be used to specify the LaTeX command name to be +# invoked. If left blank `latex' will be used as the default command name. + +LATEX_CMD_NAME = latex + +# The MAKEINDEX_CMD_NAME tag can be used to specify the command name to +# generate index for LaTeX. If left blank `makeindex' will be used as the +# default command name. + +MAKEINDEX_CMD_NAME = makeindex + +# If the COMPACT_LATEX tag is set to YES Doxygen generates more compact +# LaTeX documents. This may be useful for small projects and may help to +# save some trees in general. + +COMPACT_LATEX = NO + +# The PAPER_TYPE tag can be used to set the paper type that is used +# by the printer. Possible values are: a4, a4wide, letter, legal and +# executive. If left blank a4wide will be used. + +PAPER_TYPE = $(PAPER_SIZE) + +# The EXTRA_PACKAGES tag can be to specify one or more names of LaTeX +# packages that should be included in the LaTeX output. + +EXTRA_PACKAGES = + +# The LATEX_HEADER tag can be used to specify a personal LaTeX header for +# the generated latex document. The header should contain everything until +# the first chapter. If it is left blank doxygen will generate a +# standard header. Notice: only use this tag if you know what you are doing! + +LATEX_HEADER = + +# If the PDF_HYPERLINKS tag is set to YES, the LaTeX that is generated +# is prepared for conversion to pdf (using ps2pdf). The pdf file will +# contain links (just like the HTML output) instead of page references +# This makes the output suitable for online browsing using a pdf viewer. + +PDF_HYPERLINKS = NO + +# If the USE_PDFLATEX tag is set to YES, pdflatex will be used instead of +# plain latex in the generated Makefile. Set this option to YES to get a +# higher quality PDF documentation. + +USE_PDFLATEX = $(GENERATE_PDF) + +# If the LATEX_BATCHMODE tag is set to YES, doxygen will add the \\batchmode. +# command to the generated LaTeX files. This will instruct LaTeX to keep +# running if errors occur, instead of asking the user for help. +# This option is also used when generating formulas in HTML. + +LATEX_BATCHMODE = NO + +# If LATEX_HIDE_INDICES is set to YES then doxygen will not +# include the index chapters (such as File Index, Compound Index, etc.) +# in the output. + +LATEX_HIDE_INDICES = NO + +#--------------------------------------------------------------------------- +# configuration options related to the RTF output +#--------------------------------------------------------------------------- + +# If the GENERATE_RTF tag is set to YES Doxygen will generate RTF output +# The RTF output is optimized for Word 97 and may not look very pretty with +# other RTF readers or editors. + +GENERATE_RTF = $(GENERATE_RTF) + +# The RTF_OUTPUT tag is used to specify where the RTF docs will be put. +# If a relative path is entered the value of OUTPUT_DIRECTORY will be +# put in front of it. If left blank `rtf' will be used as the default path. + +RTF_OUTPUT = rtf + +# If the COMPACT_RTF tag is set to YES Doxygen generates more compact +# RTF documents. This may be useful for small projects and may help to +# save some trees in general. + +COMPACT_RTF = NO + +# If the RTF_HYPERLINKS tag is set to YES, the RTF that is generated +# will contain hyperlink fields. The RTF file will +# contain links (just like the HTML output) instead of page references. +# This makes the output suitable for online browsing using WORD or other +# programs which support those fields. +# Note: wordpad (write) and others do not support links. + +RTF_HYPERLINKS = NO + +# Load stylesheet definitions from file. Syntax is similar to doxygen's +# config file, i.e. a series of assignments. You only have to provide +# replacements, missing definitions are set to their default value. + +RTF_STYLESHEET_FILE = + +# Set optional variables used in the generation of an rtf document. +# Syntax is similar to doxygen's config file. + +RTF_EXTENSIONS_FILE = + +#--------------------------------------------------------------------------- +# configuration options related to the man page output +#--------------------------------------------------------------------------- + +# If the GENERATE_MAN tag is set to YES (the default) Doxygen will +# generate man pages + +GENERATE_MAN = $(GENERATE_MAN) + +# The MAN_OUTPUT tag is used to specify where the man pages will be put. +# If a relative path is entered the value of OUTPUT_DIRECTORY will be +# put in front of it. If left blank `man' will be used as the default path. + +MAN_OUTPUT = man + +# The MAN_EXTENSION tag determines the extension that is added to +# the generated man pages (default is the subroutine's section .3) + +MAN_EXTENSION = .3 + +# If the MAN_LINKS tag is set to YES and Doxygen generates man output, +# then it will generate one additional man file for each entity +# documented in the real man page(s). These additional files +# only source the real man page, but without them the man command +# would be unable to find the correct page. The default is NO. + +MAN_LINKS = NO + +#--------------------------------------------------------------------------- +# configuration options related to the XML output +#--------------------------------------------------------------------------- + +# If the GENERATE_XML tag is set to YES Doxygen will +# generate an XML file that captures the structure of +# the code including all documentation. + +GENERATE_XML = $(GENERATE_XML) + +# The XML_OUTPUT tag is used to specify where the XML pages will be put. +# If a relative path is entered the value of OUTPUT_DIRECTORY will be +# put in front of it. If left blank `xml' will be used as the default path. + +XML_OUTPUT = xml + +# The XML_SCHEMA tag can be used to specify an XML schema, +# which can be used by a validating XML parser to check the +# syntax of the XML files. + +XML_SCHEMA = + +# The XML_DTD tag can be used to specify an XML DTD, +# which can be used by a validating XML parser to check the +# syntax of the XML files. + +XML_DTD = + +# If the XML_PROGRAMLISTING tag is set to YES Doxygen will +# dump the program listings (including syntax highlighting +# and cross-referencing information) to the XML output. Note that +# enabling this will significantly increase the size of the XML output. + +XML_PROGRAMLISTING = YES + +#--------------------------------------------------------------------------- +# configuration options for the AutoGen Definitions output +#--------------------------------------------------------------------------- + +# If the GENERATE_AUTOGEN_DEF tag is set to YES Doxygen will +# generate an AutoGen Definitions (see autogen.sf.net) file +# that captures the structure of the code including all +# documentation. Note that this feature is still experimental +# and incomplete at the moment. + +GENERATE_AUTOGEN_DEF = NO + +#--------------------------------------------------------------------------- +# configuration options related to the Perl module output +#--------------------------------------------------------------------------- + +# If the GENERATE_PERLMOD tag is set to YES Doxygen will +# generate a Perl module file that captures the structure of +# the code including all documentation. Note that this +# feature is still experimental and incomplete at the +# moment. + +GENERATE_PERLMOD = NO + +# If the PERLMOD_LATEX tag is set to YES Doxygen will generate +# the necessary Makefile rules, Perl scripts and LaTeX code to be able +# to generate PDF and DVI output from the Perl module output. + +PERLMOD_LATEX = NO + +# If the PERLMOD_PRETTY tag is set to YES the Perl module output will be +# nicely formatted so it can be parsed by a human reader. This is useful +# if you want to understand what is going on. On the other hand, if this +# tag is set to NO the size of the Perl module output will be much smaller +# and Perl will parse it just the same. + +PERLMOD_PRETTY = YES + +# The names of the make variables in the generated doxyrules.make file +# are prefixed with the string contained in PERLMOD_MAKEVAR_PREFIX. +# This is useful so different doxyrules.make files included by the same +# Makefile don't overwrite each other's variables. + +PERLMOD_MAKEVAR_PREFIX = + +#--------------------------------------------------------------------------- +# Configuration options related to the preprocessor +#--------------------------------------------------------------------------- + +# If the ENABLE_PREPROCESSING tag is set to YES (the default) Doxygen will +# evaluate all C-preprocessor directives found in the sources and include +# files. + +ENABLE_PREPROCESSING = YES + +# If the MACRO_EXPANSION tag is set to YES Doxygen will expand all macro +# names in the source code. If set to NO (the default) only conditional +# compilation will be performed. Macro expansion can be done in a controlled +# way by setting EXPAND_ONLY_PREDEF to YES. + +MACRO_EXPANSION = NO + +# If the EXPAND_ONLY_PREDEF and MACRO_EXPANSION tags are both set to YES +# then the macro expansion is limited to the macros specified with the +# PREDEFINED and EXPAND_AS_DEFINED tags. + +EXPAND_ONLY_PREDEF = NO + +# If the SEARCH_INCLUDES tag is set to YES (the default) the includes files +# in the INCLUDE_PATH (see below) will be search if a #include is found. + +SEARCH_INCLUDES = YES + +# The INCLUDE_PATH tag can be used to specify one or more directories that +# contain include files that are not input files but should be processed by +# the preprocessor. + +INCLUDE_PATH = + +# You can use the INCLUDE_FILE_PATTERNS tag to specify one or more wildcard +# patterns (like *.h and *.hpp) to filter out the header-files in the +# directories. If left blank, the patterns specified with FILE_PATTERNS will +# be used. + +INCLUDE_FILE_PATTERNS = + +# The PREDEFINED tag can be used to specify one or more macro names that +# are defined before the preprocessor is started (similar to the -D option of +# gcc). The argument of the tag is a list of macros of the form: name +# or name=definition (no spaces). If the definition and the = are +# omitted =1 is assumed. To prevent a macro definition from being +# undefined via #undef or recursively expanded use the := operator +# instead of the = operator. + +PREDEFINED = + +# If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then +# this tag can be used to specify a list of macro names that should be expanded. +# The macro definition that is found in the sources will be used. +# Use the PREDEFINED tag if you want to use a different macro definition. + +EXPAND_AS_DEFINED = + +# If the SKIP_FUNCTION_MACROS tag is set to YES (the default) then +# doxygen's preprocessor will remove all function-like macros that are alone +# on a line, have an all uppercase name, and do not end with a semicolon. Such +# function macros are typically used for boiler-plate code, and will confuse +# the parser if not removed. + +SKIP_FUNCTION_MACROS = YES + +#--------------------------------------------------------------------------- +# Configuration::additions related to external references +#--------------------------------------------------------------------------- + +# The TAGFILES option can be used to specify one or more tagfiles. +# Optionally an initial location of the external documentation +# can be added for each tagfile. The format of a tag file without +# this location is as follows: +# TAGFILES = file1 file2 ... +# Adding location for the tag files is done as follows: +# TAGFILES = file1=loc1 "file2 = loc2" ... +# where "loc1" and "loc2" can be relative or absolute paths or +# URLs. If a location is present for each tag, the installdox tool +# does not have to be run to correct the links. +# Note that each tag file must have a unique name +# (where the name does NOT include the path) +# If a tag file is not located in the directory in which doxygen +# is run, you must also specify the path to the tagfile here. + +TAGFILES = + +# When a file name is specified after GENERATE_TAGFILE, doxygen will create +# a tag file that is based on the input files it reads. + +GENERATE_TAGFILE = $(DOCDIR)/$(PROJECT).tag + +# If the ALLEXTERNALS tag is set to YES all external classes will be listed +# in the class index. If set to NO only the inherited external classes +# will be listed. + +ALLEXTERNALS = NO + +# If the EXTERNAL_GROUPS tag is set to YES all external groups will be listed +# in the modules index. If set to NO, only the current project's groups will +# be listed. + +EXTERNAL_GROUPS = YES + +# The PERL_PATH should be the absolute path and name of the perl script +# interpreter (i.e. the result of `which perl'). + +PERL_PATH = /usr/bin/perl + +#--------------------------------------------------------------------------- +# Configuration options related to the dot tool +#--------------------------------------------------------------------------- + +# If the CLASS_DIAGRAMS tag is set to YES (the default) Doxygen will +# generate a inheritance diagram (in HTML, RTF and LaTeX) for classes with base +# or super classes. Setting the tag to NO turns the diagrams off. Note that +# this option is superseded by the HAVE_DOT option below. This is only a +# fallback. It is recommended to install and use dot, since it yields more +# powerful graphs. + +CLASS_DIAGRAMS = YES + +# If set to YES, the inheritance and collaboration graphs will hide +# inheritance and usage relations if the target is undocumented +# or is not a class. + +HIDE_UNDOC_RELATIONS = YES + +# If you set the HAVE_DOT tag to YES then doxygen will assume the dot tool is +# available from the path. This tool is part of Graphviz, a graph visualization +# toolkit from AT&T and Lucent Bell Labs. The other options in this section +# have no effect if this option is set to NO (the default) + +HAVE_DOT = $(HAVE_DOT) + +# If the CLASS_GRAPH and HAVE_DOT tags are set to YES then doxygen +# will generate a graph for each documented class showing the direct and +# indirect inheritance relations. Setting this tag to YES will force the +# the CLASS_DIAGRAMS tag to NO. + +CLASS_GRAPH = YES + +# If the COLLABORATION_GRAPH and HAVE_DOT tags are set to YES then doxygen +# will generate a graph for each documented class showing the direct and +# indirect implementation dependencies (inheritance, containment, and +# class references variables) of the class with other documented classes. + +COLLABORATION_GRAPH = YES + +# If the GROUP_GRAPHS and HAVE_DOT tags are set to YES then doxygen +# will generate a graph for groups, showing the direct groups dependencies + +GROUP_GRAPHS = YES + +# If the UML_LOOK tag is set to YES doxygen will generate inheritance and +# collaboration diagrams in a style similar to the OMG's Unified Modeling +# Language. + +UML_LOOK = NO + +# If set to YES, the inheritance and collaboration graphs will show the +# relations between templates and their instances. + +TEMPLATE_RELATIONS = NO + +# If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDE_GRAPH, and HAVE_DOT +# tags are set to YES then doxygen will generate a graph for each documented +# file showing the direct and indirect include dependencies of the file with +# other documented files. + +INCLUDE_GRAPH = YES + +# If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDED_BY_GRAPH, and +# HAVE_DOT tags are set to YES then doxygen will generate a graph for each +# documented header file showing the documented files that directly or +# indirectly include this file. + +INCLUDED_BY_GRAPH = YES + +# If the CALL_GRAPH and HAVE_DOT tags are set to YES then doxygen will +# generate a call dependency graph for every global function or class method. +# Note that enabling this option will significantly increase the time of a run. +# So in most cases it will be better to enable call graphs for selected +# functions only using the \callgraph command. + +CALL_GRAPH = NO + +# If the CALLER_GRAPH and HAVE_DOT tags are set to YES then doxygen will +# generate a caller dependency graph for every global function or class method. +# Note that enabling this option will significantly increase the time of a run. +# So in most cases it will be better to enable caller graphs for selected +# functions only using the \callergraph command. + +CALLER_GRAPH = NO + +# If the GRAPHICAL_HIERARCHY and HAVE_DOT tags are set to YES then doxygen +# will graphical hierarchy of all classes instead of a textual one. + +GRAPHICAL_HIERARCHY = YES + +# If the DIRECTORY_GRAPH, SHOW_DIRECTORIES and HAVE_DOT tags are set to YES +# then doxygen will show the dependencies a directory has on other directories +# in a graphical way. The dependency relations are determined by the #include +# relations between the files in the directories. + +DIRECTORY_GRAPH = YES + +# The DOT_IMAGE_FORMAT tag can be used to set the image format of the images +# generated by dot. Possible values are png, jpg, or gif +# If left blank png will be used. + +DOT_IMAGE_FORMAT = png + +# The tag DOT_PATH can be used to specify the path where the dot tool can be +# found. If left blank, it is assumed the dot tool can be found in the path. + +DOT_PATH = $(DOT_PATH) + +# The DOTFILE_DIRS tag can be used to specify one or more directories that +# contain dot files that are included in the documentation (see the +# \dotfile command). + +DOTFILE_DIRS = + +# The MAX_DOT_GRAPH_WIDTH tag can be used to set the maximum allowed width +# (in pixels) of the graphs generated by dot. If a graph becomes larger than +# this value, doxygen will try to truncate the graph, so that it fits within +# the specified constraint. Beware that most browsers cannot cope with very +# large images. + +MAX_DOT_GRAPH_WIDTH = 1024 + +# The MAX_DOT_GRAPH_HEIGHT tag can be used to set the maximum allows height +# (in pixels) of the graphs generated by dot. If a graph becomes larger than +# this value, doxygen will try to truncate the graph, so that it fits within +# the specified constraint. Beware that most browsers cannot cope with very +# large images. + +MAX_DOT_GRAPH_HEIGHT = 1024 + +# The MAX_DOT_GRAPH_DEPTH tag can be used to set the maximum depth of the +# graphs generated by dot. A depth value of 3 means that only nodes reachable +# from the root by following a path via at most 3 edges will be shown. Nodes +# that lay further from the root node will be omitted. Note that setting this +# option to 1 or 2 may greatly reduce the computation time needed for large +# code bases. Also note that a graph may be further truncated if the graph's +# image dimensions are not sufficient to fit the graph (see MAX_DOT_GRAPH_WIDTH +# and MAX_DOT_GRAPH_HEIGHT). If 0 is used for the depth value (the default), +# the graph is not depth-constrained. + +MAX_DOT_GRAPH_DEPTH = 0 + +# Set the DOT_TRANSPARENT tag to YES to generate images with a transparent +# background. This is disabled by default, which results in a white background. +# Warning: Depending on the platform used, enabling this option may lead to +# badly anti-aliased labels on the edges of a graph (i.e. they become hard to +# read). + +DOT_TRANSPARENT = NO + +# Set the DOT_MULTI_TARGETS tag to YES allow dot to generate multiple output +# files in one run (i.e. multiple -o and -T options on the command line). This +# makes dot run faster, but since only newer versions of dot (>1.8.10) +# support this, this feature is disabled by default. + +DOT_MULTI_TARGETS = NO + +# If the GENERATE_LEGEND tag is set to YES (the default) Doxygen will +# generate a legend page explaining the meaning of the various boxes and +# arrows in the dot generated graphs. + +GENERATE_LEGEND = YES + +# If the DOT_CLEANUP tag is set to YES (the default) Doxygen will +# remove the intermediate dot files that are used to generate +# the various graphs. + +DOT_CLEANUP = YES + +#--------------------------------------------------------------------------- +# Configuration::additions related to the search engine +#--------------------------------------------------------------------------- + +# The SEARCHENGINE tag specifies whether or not a search engine should be +# used. If set to NO the values of all tags below this one will be ignored. + +SEARCHENGINE = NO diff --git a/src/c/cmake_config.h.in b/src/c/cmake_config.h.in new file mode 100644 index 0000000..55efd8a --- /dev/null +++ b/src/c/cmake_config.h.in @@ -0,0 +1,154 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifndef CONFIG_H_ +#define CONFIG_H_ + +/* Define to 1 if you have the header file. */ +#cmakedefine HAVE_ARPA_INET_H 1 + +/* Define to 1 if you have the header file. */ +#cmakedefine HAVE_DLFCN_H 1 + +/* Define to 1 if you have the header file. */ +#cmakedefine HAVE_FCNTL_H 1 + +/* Define to 1 if you have the file `generated/zookeeper.jute.c'. */ +#cmakedefine HAVE_GENERATED_ZOOKEEPER_JUTE_C 1 + +/* Define to 1 if you have the file `generated/zookeeper.jute.h'. */ +#cmakedefine HAVE_GENERATED_ZOOKEEPER_JUTE_H 1 + +/* Define to 1 if you have the `getcwd' function. */ +#cmakedefine HAVE_GETCWD 1 + +/* Define to 1 if you have the `gethostbyname' function. */ +#cmakedefine HAVE_GETHOSTBYNAME 1 + +/* Define to 1 if you have the `gethostname' function. */ +#cmakedefine HAVE_GETHOSTNAME 1 + +/* Define to 1 if you have the `getlogin' function. */ +#cmakedefine HAVE_GETLOGIN 1 + +/* Define to 1 if you have the `getpwuid_r' function. */ +#cmakedefine HAVE_GETPWUID_R 1 + +/* Define to 1 if you have the `gettimeofday' function. */ +#cmakedefine HAVE_GETTIMEOFDAY 1 + +/* Define to 1 if you have the `getuid' function. */ +#cmakedefine HAVE_GETUID 1 + +/* Define to 1 if you have the header file. */ +#cmakedefine HAVE_INTTYPES_H 1 + +/* Define to 1 if you have the `rt' library (-lrt). */ +#cmakedefine HAVE_LIBRT 1 + +/* Define to 1 if you have the `memmove' function. */ +#cmakedefine HAVE_MEMMOVE 1 + +/* Define to 1 if you have the header file. */ +#cmakedefine HAVE_MEMORY_H 1 + +/* Define to 1 if you have the `memset' function. */ +#cmakedefine HAVE_MEMSET 1 + +/* Define to 1 if you have the header file. */ +#cmakedefine HAVE_NETDB_H 1 + +/* Define to 1 if you have the header file. */ +#cmakedefine HAVE_NETINET_IN_H 1 + +/* Define to 1 if you have the `poll' function. */ +#cmakedefine HAVE_POLL 1 + +/* Define to 1 if you have the `socket' function. */ +#cmakedefine HAVE_SOCKET 1 + +/* Define to 1 if you have the header file. */ +#cmakedefine HAVE_STDINT_H 1 + +/* Define to 1 if you have the header file. */ +#cmakedefine HAVE_STDLIB_H 1 + +/* Define to 1 if you have the `strchr' function. */ +#cmakedefine HAVE_STRCHR 1 + +/* Define to 1 if you have the `strdup' function. */ +#cmakedefine HAVE_STRDUP 1 + +/* Define to 1 if you have the `strerror' function. */ +#cmakedefine HAVE_STRERROR 1 + +/* Define to 1 if you have the header file. */ +#cmakedefine HAVE_STRINGS_H 1 + +/* Define to 1 if you have the header file. */ +#cmakedefine HAVE_STRING_H 1 + +/* Define to 1 if you have the `strtol' function. */ +#cmakedefine HAVE_STRTOL 1 + +/* Define to 1 if you have the header file. */ +#cmakedefine HAVE_SYS_SOCKET_H 1 + +/* Define to 1 if you have the header file. */ +#cmakedefine HAVE_SYS_STAT_H 1 + +/* Define to 1 if you have the header file. */ +#cmakedefine HAVE_SYS_TIME_H 1 + +/* Define to 1 if you have the header file. */ +#cmakedefine HAVE_SYS_TYPES_H 1 + +/* Define to 1 if you have the header file. */ +#cmakedefine HAVE_SYS_UTSNAME_H 1 + +/* Define to 1 if you have the header file. */ +#cmakedefine HAVE_UNISTD_H 1 + +/* Define to 1 if IPv6 support is available. */ +#cmakedefine ZOO_IPV6_ENABLED 1 + +/* poll() second argument type */ +#define POLL_NFDS_TYPE nfds_t + +/* Name of package */ +#define PACKAGE "${PROJECT_NAME}" + +/* Define to the address where bug reports for this package should be sent. */ +#define PACKAGE_BUGREPORT "${email}" + +/* Define to the full name of this package. */ +#define PACKAGE_NAME "${description}" + +/* Define to the full name and version of this package. */ +#define PACKAGE_STRING "${description} ${PROJECT_VERSION}" + +/* Define to the one symbol short name of this package. */ +#define PACKAGE_TARNAME "${PROJECT_NAME}" + +/* Define to the version of this package. */ +#define PACKAGE_VERSION "${PROJECT_VERSION}" + +/* Version number of package */ +#define VERSION "${PROJECT_VERSION}" + +#endif diff --git a/src/c/configure.ac b/src/c/configure.ac new file mode 100644 index 0000000..2483d38 --- /dev/null +++ b/src/c/configure.ac @@ -0,0 +1,165 @@ +# -*- Autoconf -*- +# Process this file with autoconf to produce a configure script. + +AC_PREREQ(2.59) + +AC_INIT([zookeeper C client],3.4.13,[user@zookeeper.apache.org],[zookeeper]) +AC_CONFIG_SRCDIR([src/zookeeper.c]) + +# Save initial CFLAGS and CXXFLAGS values before AC_PROG_CC and AC_PROG_CXX +init_cflags="$CFLAGS" +init_cxxflags="$CXXFLAGS" + +# initialize Doxygen support +DX_HTML_FEATURE(ON) +DX_CHM_FEATURE(OFF) +DX_CHI_FEATURE(OFF) +DX_MAN_FEATURE(OFF) +DX_RTF_FEATURE(OFF) +DX_XML_FEATURE(OFF) +DX_PDF_FEATURE(OFF) +DX_PS_FEATURE(OFF) +DX_INIT_DOXYGEN([zookeeper],[c-doc.Doxyfile],[docs]) + +# initialize automake +AM_INIT_AUTOMAKE([-Wall foreign]) +AC_CONFIG_HEADER([config.h]) + +# Checks for programs. +AC_ARG_WITH(cppunit, + [ --without-cppunit do not use CPPUNIT]) + +if test "$with_cppunit" = "no" ; then + CPPUNIT_PATH="No_CPPUNIT" + CPPUNIT_INCLUDE= + CPPUNIT_LIBS= +else + AM_PATH_CPPUNIT(1.10.2) +fi + +if test "$CALLER" = "ANT" ; then +CPPUNIT_CFLAGS="$CPPUNIT_CFLAGS -DZKSERVER_CMD=\"\\\"${base_dir}/src/c/tests/zkServer.sh\\\"\"" +else +CPPUNIT_CFLAGS="$CPPUNIT_CFLAGS -DZKSERVER_CMD=\"\\\"./tests/zkServer.sh\\\"\"" +AC_CHECK_FILES([generated/zookeeper.jute.c generated/zookeeper.jute.h],[], + [AC_MSG_ERROR([jute files are missing! Please run "ant compile_jute" while in the zookeeper top level directory.]) +]) +fi +AC_SUBST(CPPUNIT_CFLAGS) + +AC_PROG_CC +AM_PROG_CC_C_O +AC_PROG_CXX +AC_PROG_INSTALL +AC_PROG_LN_S + +# AC_DISABLE_SHARED +AC_PROG_LIBTOOL + +#enable -D_GNU_SOURCE since the return code value of getaddrinfo +#ifdefed with __USE_GNU +#features.h header undef's __USE_GNU and defines it only if _GNU_SOURCE is defined +#hence this define for gcc +AC_ARG_ENABLE([debug], + [AS_HELP_STRING([--enable-debug],[enable debug build [default=no]])], + [],[enable_debug=no]) + +if test "x$enable_debug" = xyes; then + if test "x$init_cflags" = x; then + CFLAGS="" + fi + CFLAGS="$CFLAGS -g -O0 -D_GNU_SOURCE" +else + if test "x$init_cflags" = x; then + CFLAGS="-g -O2 -D_GNU_SOURCE" + fi +fi + +if test "x$enable_debug" = xyes; then + if test "x$init_cxxflags" = x; then + CXXFLAGS="" + fi + CXXFLAGS="$CXXFLAGS -g -O0" +else + if test "x$init_cxxflags" = x; then + CXXFLAGS="-g -O2" + fi +fi + +# Check whether to enable gcov (coverage test) +AC_ARG_ENABLE(gcov, [AS_HELP_STRING([--enable-gcov],[enable coverage test])]) +AC_MSG_CHECKING([whether to enable gcov]) +AS_IF([test "x${enable_gcov}" = "xyes"],AC_MSG_RESULT([yes]),AC_MSG_RESULT([no])) +AM_CONDITIONAL([ENABLEGCOV],[test "x${enable_gcov}" = "xyes"]) + +AC_ARG_WITH([syncapi], + [AS_HELP_STRING([--with-syncapi],[build with support for SyncAPI [default=yes]])], + [],[with_syncapi=yes]) + +# Checks for libraries. +AC_CHECK_LIB([pthread], [pthread_mutex_lock],[have_pthread=yes],[have_pthread=no]) + +if test "x$with_syncapi" != xno && test "x$have_pthread" = xno; then + AC_MSG_WARN([cannot build SyncAPI -- pthread not found]) + with_syncapi=no +fi +if test "x$with_syncapi" != xno; then + AC_MSG_NOTICE([building with SyncAPI support]) +else + AC_MSG_NOTICE([building without SyncAPI support]) +fi + +AM_CONDITIONAL([WANT_SYNCAPI],[test "x$with_syncapi" != xno]) + +# Checks for header files. +AC_HEADER_STDC +AC_CHECK_HEADERS([arpa/inet.h fcntl.h netdb.h netinet/in.h stdlib.h string.h sys/socket.h sys/time.h unistd.h sys/utsname.h]) + +# Checks for typedefs, structures, and compiler characteristics. +AC_C_CONST +AC_C_INLINE +AC_HEADER_TIME +AC_CHECK_TYPE([nfds_t], + [AC_DEFINE([POLL_NFDS_TYPE],[nfds_t],[poll() second argument type])], + [AC_DEFINE([POLL_NFDS_TYPE],[unsigned int],[poll() second argument type])], + [#include ]) + +AC_MSG_CHECKING([whether to enable ipv6]) + +AC_TRY_RUN([ /* is AF_INET6 available? */ +#include +#include +main() +{ + if (socket(AF_INET6, SOCK_STREAM, 0) < 0) + exit(1); + else + exit(0); +} +], AC_MSG_RESULT(yes) + ipv6=yes, + AC_MSG_RESULT(no) + ipv6=no, + AC_MSG_RESULT(no) + ipv6=no) + +if test x"$ipv6" = xyes; then + USEIPV6="-DZOO_IPV6_ENABLED" + AC_SUBST(USEIPV6) +fi + +# Checks for library functions. +AC_CHECK_FUNCS([getcwd gethostbyname gethostname getlogin getpwuid_r gettimeofday getuid memmove memset poll socket strchr strdup strerror strtol]) + +AC_CONFIG_FILES([Makefile]) +AC_CANONICAL_HOST +AM_CONDITIONAL([SOLARIS],[ + case "$host_os" in + *solaris*) + true + ;; + *) + false + ;; + esac ]) +AC_OUTPUT diff --git a/src/c/include/proto.h b/src/c/include/proto.h new file mode 100644 index 0000000..bce408e --- /dev/null +++ b/src/c/include/proto.h @@ -0,0 +1,47 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +#ifndef PROTO_H_ +#define PROTO_H_ + +#ifdef __cplusplus +extern "C" { +#endif + +#define ZOO_NOTIFY_OP 0 +#define ZOO_CREATE_OP 1 +#define ZOO_DELETE_OP 2 +#define ZOO_EXISTS_OP 3 +#define ZOO_GETDATA_OP 4 +#define ZOO_SETDATA_OP 5 +#define ZOO_GETACL_OP 6 +#define ZOO_SETACL_OP 7 +#define ZOO_GETCHILDREN_OP 8 +#define ZOO_SYNC_OP 9 +#define ZOO_PING_OP 11 +#define ZOO_GETCHILDREN2_OP 12 +#define ZOO_CHECK_OP 13 +#define ZOO_MULTI_OP 14 +#define ZOO_CLOSE_OP -11 +#define ZOO_SETAUTH_OP 100 +#define ZOO_SETWATCHES_OP 101 + +#ifdef __cplusplus +} +#endif + +#endif /*PROTO_H_*/ diff --git a/src/c/include/recordio.h b/src/c/include/recordio.h new file mode 100644 index 0000000..eed5f99 --- /dev/null +++ b/src/c/include/recordio.h @@ -0,0 +1,83 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +#ifndef __RECORDIO_H__ +#define __RECORDIO_H__ + +#include +#include /* for int64_t */ +#ifdef WIN32 +#include "winconfig.h" +#define STRUCT_INITIALIZER(l,r) r +#else +#define STRUCT_INITIALIZER(l,r) .l = r +#endif + +#ifdef __cplusplus +extern "C" { +#endif + +struct buffer { + int32_t len; + char *buff; +}; + +void deallocate_String(char **s); +void deallocate_Buffer(struct buffer *b); +void deallocate_vector(void *d); +struct iarchive { + int (*start_record)(struct iarchive *ia, const char *tag); + int (*end_record)(struct iarchive *ia, const char *tag); + int (*start_vector)(struct iarchive *ia, const char *tag, int32_t *count); + int (*end_vector)(struct iarchive *ia, const char *tag); + int (*deserialize_Bool)(struct iarchive *ia, const char *name, int32_t *); + int (*deserialize_Int)(struct iarchive *ia, const char *name, int32_t *); + int (*deserialize_Long)(struct iarchive *ia, const char *name, int64_t *); + int (*deserialize_Buffer)(struct iarchive *ia, const char *name, + struct buffer *); + int (*deserialize_String)(struct iarchive *ia, const char *name, char **); + void *priv; +}; +struct oarchive { + int (*start_record)(struct oarchive *oa, const char *tag); + int (*end_record)(struct oarchive *oa, const char *tag); + int (*start_vector)(struct oarchive *oa, const char *tag, const int32_t *count); + int (*end_vector)(struct oarchive *oa, const char *tag); + int (*serialize_Bool)(struct oarchive *oa, const char *name, const int32_t *); + int (*serialize_Int)(struct oarchive *oa, const char *name, const int32_t *); + int (*serialize_Long)(struct oarchive *oa, const char *name, + const int64_t *); + int (*serialize_Buffer)(struct oarchive *oa, const char *name, + const struct buffer *); + int (*serialize_String)(struct oarchive *oa, const char *name, char **); + void *priv; +}; + +struct oarchive *create_buffer_oarchive(void); +void close_buffer_oarchive(struct oarchive **oa, int free_buffer); +struct iarchive *create_buffer_iarchive(char *buffer, int len); +void close_buffer_iarchive(struct iarchive **ia); +char *get_buffer(struct oarchive *); +int get_buffer_len(struct oarchive *); + +int64_t zoo_htonll(int64_t v); + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/src/c/include/winconfig.h b/src/c/include/winconfig.h new file mode 100644 index 0000000..c273a93 --- /dev/null +++ b/src/c/include/winconfig.h @@ -0,0 +1,15 @@ +#ifndef WINCONFIG_H_ +#define WINCONFIG_H_ + +/* Define to `__inline__' or `__inline' if that's what the C compiler + calls it, or to nothing if 'inline' is not supported under any name. */ +#ifndef __cplusplus +#define inline __inline +#endif + +#define __attribute__(x) +#define __func__ __FUNCTION__ + +#define ACL ZKACL /* Conflict with windows API */ + +#endif diff --git a/src/c/include/zookeeper.h b/src/c/include/zookeeper.h new file mode 100644 index 0000000..aee865b --- /dev/null +++ b/src/c/include/zookeeper.h @@ -0,0 +1,1589 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifndef ZOOKEEPER_H_ +#define ZOOKEEPER_H_ + +#include + +/* we must not include config.h as a public header */ +#ifndef WIN32 +#include +#include +#endif + +#ifdef WIN32 +#include /* must always be included before ws2tcpip.h */ +#include /* for struct sock_addr and socklen_t */ +#endif + +#include +#include + +#include "proto.h" +#include "zookeeper_version.h" +#include "recordio.h" +#include "zookeeper.jute.h" + +/** + * \file zookeeper.h + * \brief ZooKeeper functions and definitions. + * + * ZooKeeper is a network service that may be backed by a cluster of + * synchronized servers. The data in the service is represented as a tree + * of data nodes. Each node has data, children, an ACL, and status information. + * The data for a node is read and write in its entirety. + * + * ZooKeeper clients can leave watches when they queries the data or children + * of a node. If a watch is left, that client will be notified of the change. + * The notification is a one time trigger. Subsequent chances to the node will + * not trigger a notification unless the client issues a query with the watch + * flag set. If the client is ever disconnected from the service, the watches do + * not need to be reset. The client automatically resets the watches. + * + * When a node is created, it may be flagged as an ephemeral node. Ephemeral + * nodes are automatically removed when a client session is closed or when + * a session times out due to inactivity (the ZooKeeper runtime fills in + * periods of inactivity with pings). Ephemeral nodes cannot have children. + * + * ZooKeeper clients are identified by a server assigned session id. For + * security reasons The server + * also generates a corresponding password for a session. A client may save its + * id and corresponding password to persistent storage in order to use the + * session across program invocation boundaries. + */ + +/* Support for building on various platforms */ + +// on cygwin we should take care of exporting/importing symbols properly +#ifdef DLL_EXPORT +# define ZOOAPI __declspec(dllexport) +#else +# if (defined(__CYGWIN__) || defined(WIN32)) && !defined(USE_STATIC_LIB) +# define ZOOAPI __declspec(dllimport) +# else +# define ZOOAPI +# endif +#endif + +/** zookeeper return constants **/ + +enum ZOO_ERRORS { + ZOK = 0, /*!< Everything is OK */ + + /** System and server-side errors. + * This is never thrown by the server, it shouldn't be used other than + * to indicate a range. Specifically error codes greater than this + * value, but lesser than {@link #ZAPIERROR}, are system errors. */ + ZSYSTEMERROR = -1, + ZRUNTIMEINCONSISTENCY = -2, /*!< A runtime inconsistency was found */ + ZDATAINCONSISTENCY = -3, /*!< A data inconsistency was found */ + ZCONNECTIONLOSS = -4, /*!< Connection to the server has been lost */ + ZMARSHALLINGERROR = -5, /*!< Error while marshalling or unmarshalling data */ + ZUNIMPLEMENTED = -6, /*!< Operation is unimplemented */ + ZOPERATIONTIMEOUT = -7, /*!< Operation timeout */ + ZBADARGUMENTS = -8, /*!< Invalid arguments */ + ZINVALIDSTATE = -9, /*!< Invliad zhandle state */ + + /** API errors. + * This is never thrown by the server, it shouldn't be used other than + * to indicate a range. Specifically error codes greater than this + * value are API errors (while values less than this indicate a + * {@link #ZSYSTEMERROR}). + */ + ZAPIERROR = -100, + ZNONODE = -101, /*!< Node does not exist */ + ZNOAUTH = -102, /*!< Not authenticated */ + ZBADVERSION = -103, /*!< Version conflict */ + ZNOCHILDRENFOREPHEMERALS = -108, /*!< Ephemeral nodes may not have children */ + ZNODEEXISTS = -110, /*!< The node already exists */ + ZNOTEMPTY = -111, /*!< The node has children */ + ZSESSIONEXPIRED = -112, /*!< The session has been expired by the server */ + ZINVALIDCALLBACK = -113, /*!< Invalid callback specified */ + ZINVALIDACL = -114, /*!< Invalid ACL specified */ + ZAUTHFAILED = -115, /*!< Client authentication failed */ + ZCLOSING = -116, /*!< ZooKeeper is closing */ + ZNOTHING = -117, /*!< (not error) no server responses to process */ + ZSESSIONMOVED = -118 /*! + * The legacy style, an application wishing to receive events from ZooKeeper must + * first implement a function with this signature and pass a pointer to the function + * to \ref zookeeper_init. Next, the application sets a watch by calling one of + * the getter API that accept the watch integer flag (for example, \ref zoo_aexists, + * \ref zoo_get, etc). + *

+ * The watcher object style uses an instance of a "watcher object" which in + * the C world is represented by a pair: a pointer to a function implementing this + * signature and a pointer to watcher context -- handback user-specific data. + * When a watch is triggered this function will be called along with + * the watcher context. An application wishing to use this style must use + * the getter API functions with the "w" prefix in their names (for example, \ref + * zoo_awexists, \ref zoo_wget, etc). + * + * \param zh zookeeper handle + * \param type event type. This is one of the *_EVENT constants. + * \param state connection state. The state value will be one of the *_STATE constants. + * \param path znode path for which the watcher is triggered. NULL if the event + * type is ZOO_SESSION_EVENT + * \param watcherCtx watcher context. + */ +typedef void (*watcher_fn)(zhandle_t *zh, int type, + int state, const char *path,void *watcherCtx); + +/** + * \brief create a handle to used communicate with zookeeper. + * + * This method creates a new handle and a zookeeper session that corresponds + * to that handle. Session establishment is asynchronous, meaning that the + * session should not be considered established until (and unless) an + * event of state ZOO_CONNECTED_STATE is received. + * \param host comma separated host:port pairs, each corresponding to a zk + * server. e.g. "127.0.0.1:3000,127.0.0.1:3001,127.0.0.1:3002" + * \param fn the global watcher callback function. When notifications are + * triggered this function will be invoked. + * \param clientid the id of a previously established session that this + * client will be reconnecting to. Pass 0 if not reconnecting to a previous + * session. Clients can access the session id of an established, valid, + * connection by calling \ref zoo_client_id. If the session corresponding to + * the specified clientid has expired, or if the clientid is invalid for + * any reason, the returned zhandle_t will be invalid -- the zhandle_t + * state will indicate the reason for failure (typically + * ZOO_EXPIRED_SESSION_STATE). + * \param context the handback object that will be associated with this instance + * of zhandle_t. Application can access it (for example, in the watcher + * callback) using \ref zoo_get_context. The object is not used by zookeeper + * internally and can be null. + * \param flags reserved for future use. Should be set to zero. + * \return a pointer to the opaque zhandle structure. If it fails to create + * a new zhandle the function returns NULL and the errno variable + * indicates the reason. + */ +ZOOAPI zhandle_t *zookeeper_init(const char *host, watcher_fn fn, + int recv_timeout, const clientid_t *clientid, void *context, int flags); + +/** + * \brief close the zookeeper handle and free up any resources. + * + * After this call, the client session will no longer be valid. The function + * will flush any outstanding send requests before return. As a result it may + * block. + * + * This method should only be called only once on a zookeeper handle. Calling + * twice will cause undefined (and probably undesirable behavior). Calling any other + * zookeeper method after calling close is undefined behaviour and should be avoided. + * + * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init + * \return a result code. Regardless of the error code returned, the zhandle + * will be destroyed and all resources freed. + * + * ZOK - success + * ZBADARGUMENTS - invalid input parameters + * ZMARSHALLINGERROR - failed to marshall a request; possibly, out of memory + * ZOPERATIONTIMEOUT - failed to flush the buffers within the specified timeout. + * ZCONNECTIONLOSS - a network error occurred while attempting to send request to server + * ZSYSTEMERROR -- a system (OS) error occurred; it's worth checking errno to get details + */ +ZOOAPI int zookeeper_close(zhandle_t *zh); + +/** + * \brief return the client session id, only valid if the connections + * is currently connected (ie. last watcher state is ZOO_CONNECTED_STATE) + */ +ZOOAPI const clientid_t *zoo_client_id(zhandle_t *zh); + +/** + * \brief return the timeout for this session, only valid if the connections + * is currently connected (ie. last watcher state is ZOO_CONNECTED_STATE). This + * value may change after a server re-connect. + */ +ZOOAPI int zoo_recv_timeout(zhandle_t *zh); + +/** + * \brief return the context for this handle. + */ +ZOOAPI const void *zoo_get_context(zhandle_t *zh); + +/** + * \brief set the context for this handle. + */ +ZOOAPI void zoo_set_context(zhandle_t *zh, void *context); + +/** + * \brief set a watcher function + * \return previous watcher function + */ +ZOOAPI watcher_fn zoo_set_watcher(zhandle_t *zh,watcher_fn newFn); + +/** + * \brief returns the socket address for the current connection + * \return socket address of the connected host or NULL on failure, only valid if the + * connection is current connected + */ +ZOOAPI struct sockaddr* zookeeper_get_connected_host(zhandle_t *zh, + struct sockaddr *addr, socklen_t *addr_len); + +#ifndef THREADED +/** + * \brief Returns the events that zookeeper is interested in. + * + * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init + * \param fd is the file descriptor of interest + * \param interest is an or of the ZOOKEEPER_WRITE and ZOOKEEPER_READ flags to + * indicate the I/O of interest on fd. + * \param tv a timeout value to be used with select/poll system call + * \return a result code. + * ZOK - success + * ZBADARGUMENTS - invalid input parameters + * ZINVALIDSTATE - zhandle state is either ZOO_SESSION_EXPIRED_STATE or ZOO_AUTH_FAILED_STATE + * ZCONNECTIONLOSS - a network error occurred while attempting to establish + * a connection to the server + * ZMARSHALLINGERROR - failed to marshall a request; possibly, out of memory + * ZOPERATIONTIMEOUT - hasn't received anything from the server for 2/3 of the + * timeout value specified in zookeeper_init() + * ZSYSTEMERROR -- a system (OS) error occurred; it's worth checking errno to get details + */ +#ifdef WIN32 +ZOOAPI int zookeeper_interest(zhandle_t *zh, SOCKET *fd, int *interest, + struct timeval *tv); +#else +ZOOAPI int zookeeper_interest(zhandle_t *zh, int *fd, int *interest, + struct timeval *tv); +#endif + +/** + * \brief Notifies zookeeper that an event of interest has happened. + * + * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init + * \param events will be an OR of the ZOOKEEPER_WRITE and ZOOKEEPER_READ flags. + * \return a result code. + * ZOK - success + * ZBADARGUMENTS - invalid input parameters + * ZINVALIDSTATE - zhandle state is either ZOO_SESSION_EXPIRED_STATE or ZOO_AUTH_FAILED_STATE + * ZCONNECTIONLOSS - a network error occurred while attempting to send request to server + * ZSESSIONEXPIRED - connection attempt failed -- the session's expired + * ZAUTHFAILED - authentication request failed, e.i. invalid credentials + * ZRUNTIMEINCONSISTENCY - a server response came out of order + * ZSYSTEMERROR -- a system (OS) error occurred; it's worth checking errno to get details + * ZNOTHING -- not an error; simply indicates that there no more data from the server + * to be processed (when called with ZOOKEEPER_READ flag). + */ +ZOOAPI int zookeeper_process(zhandle_t *zh, int events); +#endif + +/** + * \brief signature of a completion function for a call that returns void. + * + * This method will be invoked at the end of a asynchronous call and also as + * a result of connection loss or timeout. + * \param rc the error code of the call. Connection loss/timeout triggers + * the completion with one of the following error codes: + * ZCONNECTIONLOSS -- lost connection to the server + * ZOPERATIONTIMEOUT -- connection timed out + * Data related events trigger the completion with error codes listed the + * Exceptions section of the documentation of the function that initiated the + * call. (Zero indicates call was successful.) + * \param data the pointer that was passed by the caller when the function + * that this completion corresponds to was invoked. The programmer + * is responsible for any memory freeing associated with the data + * pointer. + */ +typedef void (*void_completion_t)(int rc, const void *data); + +/** + * \brief signature of a completion function that returns a Stat structure. + * + * This method will be invoked at the end of a asynchronous call and also as + * a result of connection loss or timeout. + * \param rc the error code of the call. Connection loss/timeout triggers + * the completion with one of the following error codes: + * ZCONNECTIONLOSS -- lost connection to the server + * ZOPERATIONTIMEOUT -- connection timed out + * Data related events trigger the completion with error codes listed the + * Exceptions section of the documentation of the function that initiated the + * call. (Zero indicates call was successful.) + * \param stat a pointer to the stat information for the node involved in + * this function. If a non zero error code is returned, the content of + * stat is undefined. The programmer is NOT responsible for freeing stat. + * \param data the pointer that was passed by the caller when the function + * that this completion corresponds to was invoked. The programmer + * is responsible for any memory freeing associated with the data + * pointer. + */ +typedef void (*stat_completion_t)(int rc, const struct Stat *stat, + const void *data); + +/** + * \brief signature of a completion function that returns data. + * + * This method will be invoked at the end of a asynchronous call and also as + * a result of connection loss or timeout. + * \param rc the error code of the call. Connection loss/timeout triggers + * the completion with one of the following error codes: + * ZCONNECTIONLOSS -- lost connection to the server + * ZOPERATIONTIMEOUT -- connection timed out + * Data related events trigger the completion with error codes listed the + * Exceptions section of the documentation of the function that initiated the + * call. (Zero indicates call was successful.) + * \param value the value of the information returned by the asynchronous call. + * If a non zero error code is returned, the content of value is undefined. + * The programmer is NOT responsible for freeing value. + * \param value_len the number of bytes in value. + * \param stat a pointer to the stat information for the node involved in + * this function. If a non zero error code is returned, the content of + * stat is undefined. The programmer is NOT responsible for freeing stat. + * \param data the pointer that was passed by the caller when the function + * that this completion corresponds to was invoked. The programmer + * is responsible for any memory freeing associated with the data + * pointer. + */ +typedef void (*data_completion_t)(int rc, const char *value, int value_len, + const struct Stat *stat, const void *data); + +/** + * \brief signature of a completion function that returns a list of strings. + * + * This method will be invoked at the end of a asynchronous call and also as + * a result of connection loss or timeout. + * \param rc the error code of the call. Connection loss/timeout triggers + * the completion with one of the following error codes: + * ZCONNECTIONLOSS -- lost connection to the server + * ZOPERATIONTIMEOUT -- connection timed out + * Data related events trigger the completion with error codes listed the + * Exceptions section of the documentation of the function that initiated the + * call. (Zero indicates call was successful.) + * \param strings a pointer to the structure containng the list of strings of the + * names of the children of a node. If a non zero error code is returned, + * the content of strings is undefined. The programmer is NOT responsible + * for freeing strings. + * \param data the pointer that was passed by the caller when the function + * that this completion corresponds to was invoked. The programmer + * is responsible for any memory freeing associated with the data + * pointer. + */ +typedef void (*strings_completion_t)(int rc, + const struct String_vector *strings, const void *data); + +/** + * \brief signature of a completion function that returns a list of strings and stat. + * . + * + * This method will be invoked at the end of a asynchronous call and also as + * a result of connection loss or timeout. + * \param rc the error code of the call. Connection loss/timeout triggers + * the completion with one of the following error codes: + * ZCONNECTIONLOSS -- lost connection to the server + * ZOPERATIONTIMEOUT -- connection timed out + * Data related events trigger the completion with error codes listed the + * Exceptions section of the documentation of the function that initiated the + * call. (Zero indicates call was successful.) + * \param strings a pointer to the structure containng the list of strings of the + * names of the children of a node. If a non zero error code is returned, + * the content of strings is undefined. The programmer is NOT responsible + * for freeing strings. + * \param stat a pointer to the stat information for the node involved in + * this function. If a non zero error code is returned, the content of + * stat is undefined. The programmer is NOT responsible for freeing stat. + * \param data the pointer that was passed by the caller when the function + * that this completion corresponds to was invoked. The programmer + * is responsible for any memory freeing associated with the data + * pointer. + */ +typedef void (*strings_stat_completion_t)(int rc, + const struct String_vector *strings, const struct Stat *stat, + const void *data); + +/** + * \brief signature of a completion function that returns a list of strings. + * + * This method will be invoked at the end of a asynchronous call and also as + * a result of connection loss or timeout. + * \param rc the error code of the call. Connection loss/timeout triggers + * the completion with one of the following error codes: + * ZCONNECTIONLOSS -- lost connection to the server + * ZOPERATIONTIMEOUT -- connection timed out + * Data related events trigger the completion with error codes listed the + * Exceptions section of the documentation of the function that initiated the + * call. (Zero indicates call was successful.) + * \param value the value of the string returned. + * \param data the pointer that was passed by the caller when the function + * that this completion corresponds to was invoked. The programmer + * is responsible for any memory freeing associated with the data + * pointer. + */ +typedef void + (*string_completion_t)(int rc, const char *value, const void *data); + +/** + * \brief signature of a completion function that returns an ACL. + * + * This method will be invoked at the end of a asynchronous call and also as + * a result of connection loss or timeout. + * \param rc the error code of the call. Connection loss/timeout triggers + * the completion with one of the following error codes: + * ZCONNECTIONLOSS -- lost connection to the server + * ZOPERATIONTIMEOUT -- connection timed out + * Data related events trigger the completion with error codes listed the + * Exceptions section of the documentation of the function that initiated the + * call. (Zero indicates call was successful.) + * \param acl a pointer to the structure containng the ACL of a node. If a non + * zero error code is returned, the content of strings is undefined. The + * programmer is NOT responsible for freeing acl. + * \param stat a pointer to the stat information for the node involved in + * this function. If a non zero error code is returned, the content of + * stat is undefined. The programmer is NOT responsible for freeing stat. + * \param data the pointer that was passed by the caller when the function + * that this completion corresponds to was invoked. The programmer + * is responsible for any memory freeing associated with the data + * pointer. + */ +typedef void (*acl_completion_t)(int rc, struct ACL_vector *acl, + struct Stat *stat, const void *data); + +/** + * \brief get the state of the zookeeper connection. + * + * The return value will be one of the \ref State Consts. + */ +ZOOAPI int zoo_state(zhandle_t *zh); + +/** + * \brief create a node. + * + * This method will create a node in ZooKeeper. A node can only be created if + * it does not already exists. The Create Flags affect the creation of nodes. + * If ZOO_EPHEMERAL flag is set, the node will automatically get removed if the + * client session goes away. If the ZOO_SEQUENCE flag is set, a unique + * monotonically increasing sequence number is appended to the path name. The + * sequence number is always fixed length of 10 digits, 0 padded. + * + * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init + * \param path The name of the node. Expressed as a file name with slashes + * separating ancestors of the node. + * \param value The data to be stored in the node. + * \param valuelen The number of bytes in data. + * \param acl The initial ACL of the node. The ACL must not be null or empty. + * \param flags this parameter can be set to 0 for normal create or an OR + * of the Create Flags + * \param completion the routine to invoke when the request completes. The completion + * will be triggered with one of the following codes passed in as the rc argument: + * ZOK operation completed successfully + * ZNONODE the parent node does not exist. + * ZNODEEXISTS the node already exists + * ZNOAUTH the client does not have permission. + * ZNOCHILDRENFOREPHEMERALS cannot create children of ephemeral nodes. + * \param data The data that will be passed to the completion routine when the + * function completes. + * \return ZOK on success or one of the following errcodes on failure: + * ZBADARGUMENTS - invalid input parameters + * ZINVALIDSTATE - zhandle state is either ZOO_SESSION_EXPIRED_STATE or ZOO_AUTH_FAILED_STATE + * ZMARSHALLINGERROR - failed to marshall a request; possibly, out of memory + */ +ZOOAPI int zoo_acreate(zhandle_t *zh, const char *path, const char *value, + int valuelen, const struct ACL_vector *acl, int flags, + string_completion_t completion, const void *data); + +/** + * \brief delete a node in zookeeper. + * + * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init + * \param path the name of the node. Expressed as a file name with slashes + * separating ancestors of the node. + * \param version the expected version of the node. The function will fail if the + * actual version of the node does not match the expected version. + * If -1 is used the version check will not take place. + * \param completion the routine to invoke when the request completes. The completion + * will be triggered with one of the following codes passed in as the rc argument: + * ZOK operation completed successfully + * ZNONODE the node does not exist. + * ZNOAUTH the client does not have permission. + * ZBADVERSION expected version does not match actual version. + * ZNOTEMPTY children are present; node cannot be deleted. + * \param data the data that will be passed to the completion routine when + * the function completes. + * \return ZOK on success or one of the following errcodes on failure: + * ZBADARGUMENTS - invalid input parameters + * ZINVALIDSTATE - zhandle state is either ZOO_SESSION_EXPIRED_STATE or ZOO_AUTH_FAILED_STATE + * ZMARSHALLINGERROR - failed to marshall a request; possibly, out of memory + */ +ZOOAPI int zoo_adelete(zhandle_t *zh, const char *path, int version, + void_completion_t completion, const void *data); + +/** + * \brief checks the existence of a node in zookeeper. + * + * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init + * \param path the name of the node. Expressed as a file name with slashes + * separating ancestors of the node. + * \param watch if nonzero, a watch will be set at the server to notify the + * client if the node changes. The watch will be set even if the node does not + * exist. This allows clients to watch for nodes to appear. + * \param completion the routine to invoke when the request completes. The completion + * will be triggered with one of the following codes passed in as the rc argument: + * ZOK operation completed successfully + * ZNONODE the node does not exist. + * ZNOAUTH the client does not have permission. + * \param data the data that will be passed to the completion routine when the + * function completes. + * \return ZOK on success or one of the following errcodes on failure: + * ZBADARGUMENTS - invalid input parameters + * ZINVALIDSTATE - zhandle state is either ZOO_SESSION_EXPIRED_STATE or ZOO_AUTH_FAILED_STATE + * ZMARSHALLINGERROR - failed to marshall a request; possibly, out of memory + */ +ZOOAPI int zoo_aexists(zhandle_t *zh, const char *path, int watch, + stat_completion_t completion, const void *data); + +/** + * \brief checks the existence of a node in zookeeper. + * + * This function is similar to \ref zoo_axists except it allows one specify + * a watcher object - a function pointer and associated context. The function + * will be called once the watch has fired. The associated context data will be + * passed to the function as the watcher context parameter. + * + * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init + * \param path the name of the node. Expressed as a file name with slashes + * separating ancestors of the node. + * \param watcher if non-null a watch will set on the specified znode on the server. + * The watch will be set even if the node does not exist. This allows clients + * to watch for nodes to appear. + * \param watcherCtx user specific data, will be passed to the watcher callback. + * Unlike the global context set by \ref zookeeper_init, this watcher context + * is associated with the given instance of the watcher only. + * \param completion the routine to invoke when the request completes. The completion + * will be triggered with one of the following codes passed in as the rc argument: + * ZOK operation completed successfully + * ZNONODE the node does not exist. + * ZNOAUTH the client does not have permission. + * \param data the data that will be passed to the completion routine when the + * function completes. + * \return ZOK on success or one of the following errcodes on failure: + * ZBADARGUMENTS - invalid input parameters + * ZINVALIDSTATE - zhandle state is either ZOO_SESSION_EXPIRED_STATE or ZOO_AUTH_FAILED_STATE + * ZMARSHALLINGERROR - failed to marshall a request; possibly, out of memory + */ +ZOOAPI int zoo_awexists(zhandle_t *zh, const char *path, + watcher_fn watcher, void* watcherCtx, + stat_completion_t completion, const void *data); + +/** + * \brief gets the data associated with a node. + * + * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init + * \param path the name of the node. Expressed as a file name with slashes + * separating ancestors of the node. + * \param watch if nonzero, a watch will be set at the server to notify + * the client if the node changes. + * \param completion the routine to invoke when the request completes. The completion + * will be triggered with one of the following codes passed in as the rc argument: + * ZOK operation completed successfully + * ZNONODE the node does not exist. + * ZNOAUTH the client does not have permission. + * \param data the data that will be passed to the completion routine when + * the function completes. + * \return ZOK on success or one of the following errcodes on failure: + * ZBADARGUMENTS - invalid input parameters + * ZINVALIDSTATE - zhandle state is either in ZOO_SESSION_EXPIRED_STATE or ZOO_AUTH_FAILED_STATE + * ZMARSHALLINGERROR - failed to marshall a request; possibly, out of memory + */ +ZOOAPI int zoo_aget(zhandle_t *zh, const char *path, int watch, + data_completion_t completion, const void *data); + +/** + * \brief gets the data associated with a node. + * + * This function is similar to \ref zoo_aget except it allows one specify + * a watcher object rather than a boolean watch flag. + * + * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init + * \param path the name of the node. Expressed as a file name with slashes + * separating ancestors of the node. + * \param watcher if non-null, a watch will be set at the server to notify + * the client if the node changes. + * \param watcherCtx user specific data, will be passed to the watcher callback. + * Unlike the global context set by \ref zookeeper_init, this watcher context + * is associated with the given instance of the watcher only. + * \param completion the routine to invoke when the request completes. The completion + * will be triggered with one of the following codes passed in as the rc argument: + * ZOK operation completed successfully + * ZNONODE the node does not exist. + * ZNOAUTH the client does not have permission. + * \param data the data that will be passed to the completion routine when + * the function completes. + * \return ZOK on success or one of the following errcodes on failure: + * ZBADARGUMENTS - invalid input parameters + * ZINVALIDSTATE - zhandle state is either in ZOO_SESSION_EXPIRED_STATE or ZOO_AUTH_FAILED_STATE + * ZMARSHALLINGERROR - failed to marshall a request; possibly, out of memory + */ +ZOOAPI int zoo_awget(zhandle_t *zh, const char *path, + watcher_fn watcher, void* watcherCtx, + data_completion_t completion, const void *data); + +/** + * \brief sets the data associated with a node. + * + * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init + * \param path the name of the node. Expressed as a file name with slashes + * separating ancestors of the node. + * \param buffer the buffer holding data to be written to the node. + * \param buflen the number of bytes from buffer to write. + * \param version the expected version of the node. The function will fail if + * the actual version of the node does not match the expected version. If -1 is + * used the version check will not take place. * completion: If null, + * the function will execute synchronously. Otherwise, the function will return + * immediately and invoke the completion routine when the request completes. + * \param completion the routine to invoke when the request completes. The completion + * will be triggered with one of the following codes passed in as the rc argument: + * ZOK operation completed successfully + * ZNONODE the node does not exist. + * ZNOAUTH the client does not have permission. + * ZBADVERSION expected version does not match actual version. + * \param data the data that will be passed to the completion routine when + * the function completes. + * \return ZOK on success or one of the following errcodes on failure: + * ZBADARGUMENTS - invalid input parameters + * ZINVALIDSTATE - zhandle state is either ZOO_SESSION_EXPIRED_STATE or ZOO_AUTH_FAILED_STATE + * ZMARSHALLINGERROR - failed to marshall a request; possibly, out of memory + */ +ZOOAPI int zoo_aset(zhandle_t *zh, const char *path, const char *buffer, int buflen, + int version, stat_completion_t completion, const void *data); + +/** + * \brief lists the children of a node. + * + * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init + * \param path the name of the node. Expressed as a file name with slashes + * separating ancestors of the node. + * \param watch if nonzero, a watch will be set at the server to notify + * the client if the node changes. + * \param completion the routine to invoke when the request completes. The completion + * will be triggered with one of the following codes passed in as the rc argument: + * ZOK operation completed successfully + * ZNONODE the node does not exist. + * ZNOAUTH the client does not have permission. + * \param data the data that will be passed to the completion routine when + * the function completes. + * \return ZOK on success or one of the following errcodes on failure: + * ZBADARGUMENTS - invalid input parameters + * ZINVALIDSTATE - zhandle state is either ZOO_SESSION_EXPIRED_STATE or ZOO_AUTH_FAILED_STATE + * ZMARSHALLINGERROR - failed to marshall a request; possibly, out of memory + */ +ZOOAPI int zoo_aget_children(zhandle_t *zh, const char *path, int watch, + strings_completion_t completion, const void *data); + +/** + * \brief lists the children of a node. + * + * This function is similar to \ref zoo_aget_children except it allows one specify + * a watcher object rather than a boolean watch flag. + * + * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init + * \param path the name of the node. Expressed as a file name with slashes + * separating ancestors of the node. + * \param watcher if non-null, a watch will be set at the server to notify + * the client if the node changes. + * \param watcherCtx user specific data, will be passed to the watcher callback. + * Unlike the global context set by \ref zookeeper_init, this watcher context + * is associated with the given instance of the watcher only. + * \param completion the routine to invoke when the request completes. The completion + * will be triggered with one of the following codes passed in as the rc argument: + * ZOK operation completed successfully + * ZNONODE the node does not exist. + * ZNOAUTH the client does not have permission. + * \param data the data that will be passed to the completion routine when + * the function completes. + * \return ZOK on success or one of the following errcodes on failure: + * ZBADARGUMENTS - invalid input parameters + * ZINVALIDSTATE - zhandle state is either ZOO_SESSION_EXPIRED_STATE or ZOO_AUTH_FAILED_STATE + * ZMARSHALLINGERROR - failed to marshall a request; possibly, out of memory + */ +ZOOAPI int zoo_awget_children(zhandle_t *zh, const char *path, + watcher_fn watcher, void* watcherCtx, + strings_completion_t completion, const void *data); + +/** + * \brief lists the children of a node, and get the parent stat. + * + * This function is new in version 3.3.0 + * + * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init + * \param path the name of the node. Expressed as a file name with slashes + * separating ancestors of the node. + * \param watch if nonzero, a watch will be set at the server to notify + * the client if the node changes. + * \param completion the routine to invoke when the request completes. The completion + * will be triggered with one of the following codes passed in as the rc argument: + * ZOK operation completed successfully + * ZNONODE the node does not exist. + * ZNOAUTH the client does not have permission. + * \param data the data that will be passed to the completion routine when + * the function completes. + * \return ZOK on success or one of the following errcodes on failure: + * ZBADARGUMENTS - invalid input parameters + * ZINVALIDSTATE - zhandle state is either ZOO_SESSION_EXPIRED_STATE or ZOO_AUTH_FAILED_STATE + * ZMARSHALLINGERROR - failed to marshall a request; possibly, out of memory + */ +ZOOAPI int zoo_aget_children2(zhandle_t *zh, const char *path, int watch, + strings_stat_completion_t completion, const void *data); + +/** + * \brief lists the children of a node, and get the parent stat. + * + * This function is similar to \ref zoo_aget_children2 except it allows one specify + * a watcher object rather than a boolean watch flag. + * + * This function is new in version 3.3.0 + * + * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init + * \param path the name of the node. Expressed as a file name with slashes + * separating ancestors of the node. + * \param watcher if non-null, a watch will be set at the server to notify + * the client if the node changes. + * \param watcherCtx user specific data, will be passed to the watcher callback. + * Unlike the global context set by \ref zookeeper_init, this watcher context + * is associated with the given instance of the watcher only. + * \param completion the routine to invoke when the request completes. The completion + * will be triggered with one of the following codes passed in as the rc argument: + * ZOK operation completed successfully + * ZNONODE the node does not exist. + * ZNOAUTH the client does not have permission. + * \param data the data that will be passed to the completion routine when + * the function completes. + * \return ZOK on success or one of the following errcodes on failure: + * ZBADARGUMENTS - invalid input parameters + * ZINVALIDSTATE - zhandle state is either ZOO_SESSION_EXPIRED_STATE or ZOO_AUTH_FAILED_STATE + * ZMARSHALLINGERROR - failed to marshall a request; possibly, out of memory + */ +ZOOAPI int zoo_awget_children2(zhandle_t *zh, const char *path, + watcher_fn watcher, void* watcherCtx, + strings_stat_completion_t completion, const void *data); + +/** + * \brief Flush leader channel. + * + * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init + * \param path the name of the node. Expressed as a file name with slashes + * separating ancestors of the node. + * \param completion the routine to invoke when the request completes. The completion + * will be triggered with one of the following codes passed in as the rc argument: + * ZOK operation completed successfully + * ZNONODE the node does not exist. + * ZNOAUTH the client does not have permission. + * \param data the data that will be passed to the completion routine when + * the function completes. + * \return ZOK on success or one of the following errcodes on failure: + * ZBADARGUMENTS - invalid input parameters + * ZINVALIDSTATE - zhandle state is either ZOO_SESSION_EXPIRED_STATE or ZOO_AUTH_FAILED_STATE + * ZMARSHALLINGERROR - failed to marshall a request; possibly, out of memory + */ + +ZOOAPI int zoo_async(zhandle_t *zh, const char *path, + string_completion_t completion, const void *data); + + +/** + * \brief gets the acl associated with a node. + * + * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init + * \param path the name of the node. Expressed as a file name with slashes + * separating ancestors of the node. + * \param completion the routine to invoke when the request completes. The completion + * will be triggered with one of the following codes passed in as the rc argument: + * ZOK operation completed successfully + * ZNONODE the node does not exist. + * ZNOAUTH the client does not have permission. + * \param data the data that will be passed to the completion routine when + * the function completes. + * \return ZOK on success or one of the following errcodes on failure: + * ZBADARGUMENTS - invalid input parameters + * ZINVALIDSTATE - zhandle state is either ZOO_SESSION_EXPIRED_STATE or ZOO_AUTH_FAILED_STATE + * ZMARSHALLINGERROR - failed to marshall a request; possibly, out of memory + */ +ZOOAPI int zoo_aget_acl(zhandle_t *zh, const char *path, acl_completion_t completion, + const void *data); + +/** + * \brief sets the acl associated with a node. + * + * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init + * \param path the name of the node. Expressed as a file name with slashes + * separating ancestors of the node. + * \param buffer the buffer holding the acls to be written to the node. + * \param buflen the number of bytes from buffer to write. + * \param completion the routine to invoke when the request completes. The completion + * will be triggered with one of the following codes passed in as the rc argument: + * ZOK operation completed successfully + * ZNONODE the node does not exist. + * ZNOAUTH the client does not have permission. + * ZINVALIDACL invalid ACL specified + * ZBADVERSION expected version does not match actual version. + * \param data the data that will be passed to the completion routine when + * the function completes. + * \return ZOK on success or one of the following errcodes on failure: + * ZBADARGUMENTS - invalid input parameters + * ZINVALIDSTATE - zhandle state is either ZOO_SESSION_EXPIRED_STATE or ZOO_AUTH_FAILED_STATE + * ZMARSHALLINGERROR - failed to marshall a request; possibly, out of memory + */ +ZOOAPI int zoo_aset_acl(zhandle_t *zh, const char *path, int version, + struct ACL_vector *acl, void_completion_t, const void *data); + +/** + * \brief atomically commits multiple zookeeper operations. + * + * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init + * \param count the number of operations + * \param ops an array of operations to commit + * \param results an array to hold the results of the operations + * \param completion the routine to invoke when the request completes. The completion + * will be triggered with any of the error codes that can that can be returned by the + * ops supported by a multi op (see \ref zoo_acreate, \ref zoo_adelete, \ref zoo_aset). + * \param data the data that will be passed to the completion routine when + * the function completes. + * \return the return code for the function call. This can be any of the + * values that can be returned by the ops supported by a multi op (see + * \ref zoo_acreate, \ref zoo_adelete, \ref zoo_aset). + */ +ZOOAPI int zoo_amulti(zhandle_t *zh, int count, const zoo_op_t *ops, + zoo_op_result_t *results, void_completion_t, const void *data); + +/** + * \brief return an error string. + * + * \param return code + * \return string corresponding to the return code + */ +ZOOAPI const char* zerror(int c); + +/** + * \brief specify application credentials. + * + * The application calls this function to specify its credentials for purposes + * of authentication. The server will use the security provider specified by + * the scheme parameter to authenticate the client connection. If the + * authentication request has failed: + * - the server connection is dropped + * - the watcher is called with the ZOO_AUTH_FAILED_STATE value as the state + * parameter. + * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init + * \param scheme the id of authentication scheme. Natively supported: + * "digest" password-based authentication + * \param cert application credentials. The actual value depends on the scheme. + * \param certLen the length of the data parameter + * \param completion the routine to invoke when the request completes. One of + * the following result codes may be passed into the completion callback: + * ZOK operation completed successfully + * ZAUTHFAILED authentication failed + * \param data the data that will be passed to the completion routine when the + * function completes. + * \return ZOK on success or one of the following errcodes on failure: + * ZBADARGUMENTS - invalid input parameters + * ZINVALIDSTATE - zhandle state is either ZOO_SESSION_EXPIRED_STATE or ZOO_AUTH_FAILED_STATE + * ZMARSHALLINGERROR - failed to marshall a request; possibly, out of memory + * ZSYSTEMERROR - a system error occurred + */ +ZOOAPI int zoo_add_auth(zhandle_t *zh,const char* scheme,const char* cert, + int certLen, void_completion_t completion, const void *data); + +/** + * \brief checks if the current zookeeper connection state can't be recovered. + * + * The application must close the zhandle and try to reconnect. + * + * \param zh the zookeeper handle (see \ref zookeeper_init) + * \return ZINVALIDSTATE if connection is unrecoverable + */ +ZOOAPI int is_unrecoverable(zhandle_t *zh); + +/** + * \brief sets the debugging level for the library + */ +ZOOAPI void zoo_set_debug_level(ZooLogLevel logLevel); + +/** + * \brief sets the stream to be used by the library for logging + * + * The zookeeper library uses stderr as its default log stream. Application + * must make sure the stream is writable. Passing in NULL resets the stream + * to its default value (stderr). + */ +ZOOAPI void zoo_set_log_stream(FILE* logStream); + +/** + * \brief enable/disable quorum endpoint order randomization + * + * Note: typically this method should NOT be used outside of testing. + * + * If passed a non-zero value, will make the client connect to quorum peers + * in the order as specified in the zookeeper_init() call. + * A zero value causes zookeeper_init() to permute the peer endpoints + * which is good for more even client connection distribution among the + * quorum peers. + */ +ZOOAPI void zoo_deterministic_conn_order(int yesOrNo); + +/** + * \brief create a node synchronously. + * + * This method will create a node in ZooKeeper. A node can only be created if + * it does not already exists. The Create Flags affect the creation of nodes. + * If ZOO_EPHEMERAL flag is set, the node will automatically get removed if the + * client session goes away. If the ZOO_SEQUENCE flag is set, a unique + * monotonically increasing sequence number is appended to the path name. + * + * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init + * \param path The name of the node. Expressed as a file name with slashes + * separating ancestors of the node. + * \param value The data to be stored in the node. + * \param valuelen The number of bytes in data. To set the data to be NULL use + * value as NULL and valuelen as -1. + * \param acl The initial ACL of the node. The ACL must not be null or empty. + * \param flags this parameter can be set to 0 for normal create or an OR + * of the Create Flags + * \param path_buffer Buffer which will be filled with the path of the + * new node (this might be different than the supplied path + * because of the ZOO_SEQUENCE flag). The path string will always be + * null-terminated. This parameter may be NULL if path_buffer_len = 0. + * \param path_buffer_len Size of path buffer; if the path of the new + * node (including space for the null terminator) exceeds the buffer size, + * the path string will be truncated to fit. The actual path of the + * new node in the server will not be affected by the truncation. + * The path string will always be null-terminated. + * \return one of the following codes are returned: + * ZOK operation completed successfully + * ZNONODE the parent node does not exist. + * ZNODEEXISTS the node already exists + * ZNOAUTH the client does not have permission. + * ZNOCHILDRENFOREPHEMERALS cannot create children of ephemeral nodes. + * ZBADARGUMENTS - invalid input parameters + * ZINVALIDSTATE - zhandle state is either ZOO_SESSION_EXPIRED_STATE or ZOO_AUTH_FAILED_STATE + * ZMARSHALLINGERROR - failed to marshall a request; possibly, out of memory + */ +ZOOAPI int zoo_create(zhandle_t *zh, const char *path, const char *value, + int valuelen, const struct ACL_vector *acl, int flags, + char *path_buffer, int path_buffer_len); + +/** + * \brief delete a node in zookeeper synchronously. + * + * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init + * \param path the name of the node. Expressed as a file name with slashes + * separating ancestors of the node. + * \param version the expected version of the node. The function will fail if the + * actual version of the node does not match the expected version. + * If -1 is used the version check will not take place. + * \return one of the following values is returned. + * ZOK operation completed successfully + * ZNONODE the node does not exist. + * ZNOAUTH the client does not have permission. + * ZBADVERSION expected version does not match actual version. + * ZNOTEMPTY children are present; node cannot be deleted. + * ZBADARGUMENTS - invalid input parameters + * ZINVALIDSTATE - zhandle state is either ZOO_SESSION_EXPIRED_STATE or ZOO_AUTH_FAILED_STATE + * ZMARSHALLINGERROR - failed to marshall a request; possibly, out of memory + */ +ZOOAPI int zoo_delete(zhandle_t *zh, const char *path, int version); + + +/** + * \brief checks the existence of a node in zookeeper synchronously. + * + * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init + * \param path the name of the node. Expressed as a file name with slashes + * separating ancestors of the node. + * \param watch if nonzero, a watch will be set at the server to notify the + * client if the node changes. The watch will be set even if the node does not + * exist. This allows clients to watch for nodes to appear. + * \param the return stat value of the node. + * \return return code of the function call. + * ZOK operation completed successfully + * ZNONODE the node does not exist. + * ZNOAUTH the client does not have permission. + * ZBADARGUMENTS - invalid input parameters + * ZINVALIDSTATE - zhandle state is either ZOO_SESSION_EXPIRED_STATE or ZOO_AUTH_FAILED_STATE + * ZMARSHALLINGERROR - failed to marshall a request; possibly, out of memory + */ +ZOOAPI int zoo_exists(zhandle_t *zh, const char *path, int watch, struct Stat *stat); + +/** + * \brief checks the existence of a node in zookeeper synchronously. + * + * This function is similar to \ref zoo_exists except it allows one specify + * a watcher object rather than a boolean watch flag. + * + * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init + * \param path the name of the node. Expressed as a file name with slashes + * separating ancestors of the node. + * \param watcher if non-null a watch will set on the specified znode on the server. + * The watch will be set even if the node does not exist. This allows clients + * to watch for nodes to appear. + * \param watcherCtx user specific data, will be passed to the watcher callback. + * Unlike the global context set by \ref zookeeper_init, this watcher context + * is associated with the given instance of the watcher only. + * \param the return stat value of the node. + * \return return code of the function call. + * ZOK operation completed successfully + * ZNONODE the node does not exist. + * ZNOAUTH the client does not have permission. + * ZBADARGUMENTS - invalid input parameters + * ZINVALIDSTATE - zhandle state is either ZOO_SESSION_EXPIRED_STATE or ZOO_AUTH_FAILED_STATE + * ZMARSHALLINGERROR - failed to marshall a request; possibly, out of memory + */ +ZOOAPI int zoo_wexists(zhandle_t *zh, const char *path, + watcher_fn watcher, void* watcherCtx, struct Stat *stat); + +/** + * \brief gets the data associated with a node synchronously. + * + * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init + * \param path the name of the node. Expressed as a file name with slashes + * separating ancestors of the node. + * \param watch if nonzero, a watch will be set at the server to notify + * the client if the node changes. + * \param buffer the buffer holding the node data returned by the server + * \param buffer_len is the size of the buffer pointed to by the buffer parameter. + * It'll be set to the actual data length upon return. If the data is NULL, length is -1. + * \param stat if not NULL, will hold the value of stat for the path on return. + * \return return value of the function call. + * ZOK operation completed successfully + * ZNONODE the node does not exist. + * ZNOAUTH the client does not have permission. + * ZBADARGUMENTS - invalid input parameters + * ZINVALIDSTATE - zhandle state is either in ZOO_SESSION_EXPIRED_STATE or ZOO_AUTH_FAILED_STATE + * ZMARSHALLINGERROR - failed to marshall a request; possibly, out of memory + */ +ZOOAPI int zoo_get(zhandle_t *zh, const char *path, int watch, char *buffer, + int* buffer_len, struct Stat *stat); + +/** + * \brief gets the data associated with a node synchronously. + * + * This function is similar to \ref zoo_get except it allows one specify + * a watcher object rather than a boolean watch flag. + * + * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init + * \param path the name of the node. Expressed as a file name with slashes + * separating ancestors of the node. + * \param watcher if non-null, a watch will be set at the server to notify + * the client if the node changes. + * \param watcherCtx user specific data, will be passed to the watcher callback. + * Unlike the global context set by \ref zookeeper_init, this watcher context + * is associated with the given instance of the watcher only. + * \param buffer the buffer holding the node data returned by the server + * \param buffer_len is the size of the buffer pointed to by the buffer parameter. + * It'll be set to the actual data length upon return. If the data is NULL, length is -1. + * \param stat if not NULL, will hold the value of stat for the path on return. + * \return return value of the function call. + * ZOK operation completed successfully + * ZNONODE the node does not exist. + * ZNOAUTH the client does not have permission. + * ZBADARGUMENTS - invalid input parameters + * ZINVALIDSTATE - zhandle state is either in ZOO_SESSION_EXPIRED_STATE or ZOO_AUTH_FAILED_STATE + * ZMARSHALLINGERROR - failed to marshall a request; possibly, out of memory + */ +ZOOAPI int zoo_wget(zhandle_t *zh, const char *path, + watcher_fn watcher, void* watcherCtx, + char *buffer, int* buffer_len, struct Stat *stat); + +/** + * \brief sets the data associated with a node. See zoo_set2 function if + * you require access to the stat information associated with the znode. + * + * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init + * \param path the name of the node. Expressed as a file name with slashes + * separating ancestors of the node. + * \param buffer the buffer holding data to be written to the node. + * \param buflen the number of bytes from buffer to write. To set NULL as data + * use buffer as NULL and buflen as -1. + * \param version the expected version of the node. The function will fail if + * the actual version of the node does not match the expected version. If -1 is + * used the version check will not take place. + * \return the return code for the function call. + * ZOK operation completed successfully + * ZNONODE the node does not exist. + * ZNOAUTH the client does not have permission. + * ZBADVERSION expected version does not match actual version. + * ZBADARGUMENTS - invalid input parameters + * ZINVALIDSTATE - zhandle state is either ZOO_SESSION_EXPIRED_STATE or ZOO_AUTH_FAILED_STATE + * ZMARSHALLINGERROR - failed to marshall a request; possibly, out of memory + */ +ZOOAPI int zoo_set(zhandle_t *zh, const char *path, const char *buffer, + int buflen, int version); + +/** + * \brief sets the data associated with a node. This function is the same + * as zoo_set except that it also provides access to stat information + * associated with the znode. + * + * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init + * \param path the name of the node. Expressed as a file name with slashes + * separating ancestors of the node. + * \param buffer the buffer holding data to be written to the node. + * \param buflen the number of bytes from buffer to write. To set NULL as data + * use buffer as NULL and buflen as -1. + * \param version the expected version of the node. The function will fail if + * the actual version of the node does not match the expected version. If -1 is + * used the version check will not take place. + * \param stat if not NULL, will hold the value of stat for the path on return. + * \return the return code for the function call. + * ZOK operation completed successfully + * ZNONODE the node does not exist. + * ZNOAUTH the client does not have permission. + * ZBADVERSION expected version does not match actual version. + * ZBADARGUMENTS - invalid input parameters + * ZINVALIDSTATE - zhandle state is either ZOO_SESSION_EXPIRED_STATE or ZOO_AUTH_FAILED_STATE + * ZMARSHALLINGERROR - failed to marshall a request; possibly, out of memory + */ +ZOOAPI int zoo_set2(zhandle_t *zh, const char *path, const char *buffer, + int buflen, int version, struct Stat *stat); + +/** + * \brief lists the children of a node synchronously. + * + * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init + * \param path the name of the node. Expressed as a file name with slashes + * separating ancestors of the node. + * \param watch if nonzero, a watch will be set at the server to notify + * the client if the node changes. + * \param strings return value of children paths. + * \return the return code of the function. + * ZOK operation completed successfully + * ZNONODE the node does not exist. + * ZNOAUTH the client does not have permission. + * ZBADARGUMENTS - invalid input parameters + * ZINVALIDSTATE - zhandle state is either ZOO_SESSION_EXPIRED_STATE or ZOO_AUTH_FAILED_STATE + * ZMARSHALLINGERROR - failed to marshall a request; possibly, out of memory + */ +ZOOAPI int zoo_get_children(zhandle_t *zh, const char *path, int watch, + struct String_vector *strings); + +/** + * \brief lists the children of a node synchronously. + * + * This function is similar to \ref zoo_get_children except it allows one specify + * a watcher object rather than a boolean watch flag. + * + * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init + * \param path the name of the node. Expressed as a file name with slashes + * separating ancestors of the node. + * \param watcher if non-null, a watch will be set at the server to notify + * the client if the node changes. + * \param watcherCtx user specific data, will be passed to the watcher callback. + * Unlike the global context set by \ref zookeeper_init, this watcher context + * is associated with the given instance of the watcher only. + * \param strings return value of children paths. + * \return the return code of the function. + * ZOK operation completed successfully + * ZNONODE the node does not exist. + * ZNOAUTH the client does not have permission. + * ZBADARGUMENTS - invalid input parameters + * ZINVALIDSTATE - zhandle state is either ZOO_SESSION_EXPIRED_STATE or ZOO_AUTH_FAILED_STATE + * ZMARSHALLINGERROR - failed to marshall a request; possibly, out of memory + */ +ZOOAPI int zoo_wget_children(zhandle_t *zh, const char *path, + watcher_fn watcher, void* watcherCtx, + struct String_vector *strings); + +/** + * \brief lists the children of a node and get its stat synchronously. + * + * This function is new in version 3.3.0 + * + * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init + * \param path the name of the node. Expressed as a file name with slashes + * separating ancestors of the node. + * \param watch if nonzero, a watch will be set at the server to notify + * the client if the node changes. + * \param strings return value of children paths. + * \param stat return value of node stat. + * \return the return code of the function. + * ZOK operation completed successfully + * ZNONODE the node does not exist. + * ZNOAUTH the client does not have permission. + * ZBADARGUMENTS - invalid input parameters + * ZINVALIDSTATE - zhandle state is either ZOO_SESSION_EXPIRED_STATE or ZOO_AUTH_FAILED_STATE + * ZMARSHALLINGERROR - failed to marshall a request; possibly, out of memory + */ +ZOOAPI int zoo_get_children2(zhandle_t *zh, const char *path, int watch, + struct String_vector *strings, struct Stat *stat); + +/** + * \brief lists the children of a node and get its stat synchronously. + * + * This function is similar to \ref zoo_get_children except it allows one specify + * a watcher object rather than a boolean watch flag. + * + * This function is new in version 3.3.0 + * + * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init + * \param path the name of the node. Expressed as a file name with slashes + * separating ancestors of the node. + * \param watcher if non-null, a watch will be set at the server to notify + * the client if the node changes. + * \param watcherCtx user specific data, will be passed to the watcher callback. + * Unlike the global context set by \ref zookeeper_init, this watcher context + * is associated with the given instance of the watcher only. + * \param strings return value of children paths. + * \param stat return value of node stat. + * \return the return code of the function. + * ZOK operation completed successfully + * ZNONODE the node does not exist. + * ZNOAUTH the client does not have permission. + * ZBADARGUMENTS - invalid input parameters + * ZINVALIDSTATE - zhandle state is either ZOO_SESSION_EXPIRED_STATE or ZOO_AUTH_FAILED_STATE + * ZMARSHALLINGERROR - failed to marshall a request; possibly, out of memory + */ +ZOOAPI int zoo_wget_children2(zhandle_t *zh, const char *path, + watcher_fn watcher, void* watcherCtx, + struct String_vector *strings, struct Stat *stat); + +/** + * \brief gets the acl associated with a node synchronously. + * + * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init + * \param path the name of the node. Expressed as a file name with slashes + * separating ancestors of the node. + * \param acl the return value of acls on the path. + * \param stat returns the stat of the path specified. + * \return the return code for the function call. + * ZOK operation completed successfully + * ZNONODE the node does not exist. + * ZNOAUTH the client does not have permission. + * ZBADARGUMENTS - invalid input parameters + * ZINVALIDSTATE - zhandle state is either ZOO_SESSION_EXPIRED_STATE or ZOO_AUTH_FAILED_STATE + * ZMARSHALLINGERROR - failed to marshall a request; possibly, out of memory + */ +ZOOAPI int zoo_get_acl(zhandle_t *zh, const char *path, struct ACL_vector *acl, + struct Stat *stat); + +/** + * \brief sets the acl associated with a node synchronously. + * + * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init + * \param path the name of the node. Expressed as a file name with slashes + * separating ancestors of the node. + * \param version the expected version of the path. + * \param acl the acl to be set on the path. + * \return the return code for the function call. + * ZOK operation completed successfully + * ZNONODE the node does not exist. + * ZNOAUTH the client does not have permission. + * ZINVALIDACL invalid ACL specified + * ZBADVERSION expected version does not match actual version. + * ZBADARGUMENTS - invalid input parameters + * ZINVALIDSTATE - zhandle state is either ZOO_SESSION_EXPIRED_STATE or ZOO_AUTH_FAILED_STATE + * ZMARSHALLINGERROR - failed to marshall a request; possibly, out of memory + */ +ZOOAPI int zoo_set_acl(zhandle_t *zh, const char *path, int version, + const struct ACL_vector *acl); + +/** + * \brief atomically commits multiple zookeeper operations synchronously. + * + * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init + * \param count the number of operations + * \param ops an array of operations to commit + * \param results an array to hold the results of the operations + * \return the return code for the function call. This can be any of the + * values that can be returned by the ops supported by a multi op (see + * \ref zoo_acreate, \ref zoo_adelete, \ref zoo_aset). + */ +ZOOAPI int zoo_multi(zhandle_t *zh, int count, const zoo_op_t *ops, zoo_op_result_t *results); + +#ifdef __cplusplus +} +#endif + +#endif /*ZOOKEEPER_H_*/ diff --git a/src/c/include/zookeeper_log.h b/src/c/include/zookeeper_log.h new file mode 100644 index 0000000..e5917cb --- /dev/null +++ b/src/c/include/zookeeper_log.h @@ -0,0 +1,51 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifndef ZK_LOG_H_ +#define ZK_LOG_H_ + +#include + +#ifdef __cplusplus +extern "C" { +#endif + +extern ZOOAPI ZooLogLevel logLevel; +#define LOGSTREAM getLogStream() + +#define LOG_ERROR(x) if(logLevel>=ZOO_LOG_LEVEL_ERROR) \ + log_message(ZOO_LOG_LEVEL_ERROR,__LINE__,__func__,format_log_message x) +#define LOG_WARN(x) if(logLevel>=ZOO_LOG_LEVEL_WARN) \ + log_message(ZOO_LOG_LEVEL_WARN,__LINE__,__func__,format_log_message x) +#define LOG_INFO(x) if(logLevel>=ZOO_LOG_LEVEL_INFO) \ + log_message(ZOO_LOG_LEVEL_INFO,__LINE__,__func__,format_log_message x) +#define LOG_DEBUG(x) if(logLevel==ZOO_LOG_LEVEL_DEBUG) \ + log_message(ZOO_LOG_LEVEL_DEBUG,__LINE__,__func__,format_log_message x) + +ZOOAPI void log_message(ZooLogLevel curLevel, int line,const char* funcName, + const char* message); + +ZOOAPI const char* format_log_message(const char* format,...); + +FILE* getLogStream(); + +#ifdef __cplusplus +} +#endif + +#endif /*ZK_LOG_H_*/ diff --git a/src/c/include/zookeeper_version.h b/src/c/include/zookeeper_version.h new file mode 100644 index 0000000..518f7e6 --- /dev/null +++ b/src/c/include/zookeeper_version.h @@ -0,0 +1,33 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +#ifndef ZOOKEEPER_VERSION_H_ +#define ZOOKEEPER_VERSION_H_ + +#ifdef __cplusplus +extern "C" { +#endif + +#define ZOO_MAJOR_VERSION 3 +#define ZOO_MINOR_VERSION 4 +#define ZOO_PATCH_VERSION 12 + +#ifdef __cplusplus +} +#endif + +#endif /* ZOOKEEPER_VERSION_H_ */ diff --git a/src/c/src/cli.c b/src/c/src/cli.c new file mode 100644 index 0000000..ef32a10 --- /dev/null +++ b/src/c/src/cli.c @@ -0,0 +1,697 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +/** + * cli.c is a example/sample C client shell for ZooKeeper. It contains + * basic shell functionality which exercises some of the features of + * the ZooKeeper C client API. It is not a full fledged client and is + * not meant for production usage - see the Java client shell for a + * fully featured shell. + */ + +#include +#include +#include +#include +#include + +#ifndef WIN32 +#include +#include +#include +#else +#include "winport.h" +//#include <-- can't include, conflicting definitions of close() +int read(int _FileHandle, void * _DstBuf, unsigned int _MaxCharCount); +int write(int _Filehandle, const void * _Buf, unsigned int _MaxCharCount); +#define ctime_r(tctime, buffer) ctime_s (buffer, 40, tctime) +#endif + +#include +#include +#include + +#ifdef YCA +#include +#endif + +#define _LL_CAST_ (long long) + +static zhandle_t *zh; +static clientid_t myid; +static const char *clientIdFile = 0; +struct timeval startTime; +static char cmd[1024]; +static int batchMode=0; + +static int to_send=0; +static int sent=0; +static int recvd=0; + +static int shutdownThisThing=0; + +static __attribute__ ((unused)) void +printProfileInfo(struct timeval start, struct timeval end, int thres, + const char* msg) +{ + int delay=(end.tv_sec*1000+end.tv_usec/1000)- + (start.tv_sec*1000+start.tv_usec/1000); + if(delay>thres) + fprintf(stderr,"%s: execution time=%dms\n",msg,delay); +} + +static const char* state2String(int state){ + if (state == 0) + return "CLOSED_STATE"; + if (state == ZOO_CONNECTING_STATE) + return "CONNECTING_STATE"; + if (state == ZOO_ASSOCIATING_STATE) + return "ASSOCIATING_STATE"; + if (state == ZOO_CONNECTED_STATE) + return "CONNECTED_STATE"; + if (state == ZOO_EXPIRED_SESSION_STATE) + return "EXPIRED_SESSION_STATE"; + if (state == ZOO_AUTH_FAILED_STATE) + return "AUTH_FAILED_STATE"; + + return "INVALID_STATE"; +} + +static const char* type2String(int state){ + if (state == ZOO_CREATED_EVENT) + return "CREATED_EVENT"; + if (state == ZOO_DELETED_EVENT) + return "DELETED_EVENT"; + if (state == ZOO_CHANGED_EVENT) + return "CHANGED_EVENT"; + if (state == ZOO_CHILD_EVENT) + return "CHILD_EVENT"; + if (state == ZOO_SESSION_EVENT) + return "SESSION_EVENT"; + if (state == ZOO_NOTWATCHING_EVENT) + return "NOTWATCHING_EVENT"; + + return "UNKNOWN_EVENT_TYPE"; +} + +void watcher(zhandle_t *zzh, int type, int state, const char *path, + void* context) +{ + /* Be careful using zh here rather than zzh - as this may be mt code + * the client lib may call the watcher before zookeeper_init returns */ + + fprintf(stderr, "Watcher %s state = %s", type2String(type), state2String(state)); + if (path && strlen(path) > 0) { + fprintf(stderr, " for path %s", path); + } + fprintf(stderr, "\n"); + + if (type == ZOO_SESSION_EVENT) { + if (state == ZOO_CONNECTED_STATE) { + const clientid_t *id = zoo_client_id(zzh); + if (myid.client_id == 0 || myid.client_id != id->client_id) { + myid = *id; + fprintf(stderr, "Got a new session id: 0x%llx\n", + _LL_CAST_ myid.client_id); + if (clientIdFile) { + FILE *fh = fopen(clientIdFile, "w"); + if (!fh) { + perror(clientIdFile); + } else { + int rc = fwrite(&myid, sizeof(myid), 1, fh); + if (rc != sizeof(myid)) { + perror("writing client id"); + } + fclose(fh); + } + } + } + } else if (state == ZOO_AUTH_FAILED_STATE) { + fprintf(stderr, "Authentication failure. Shutting down...\n"); + zookeeper_close(zzh); + shutdownThisThing=1; + zh=0; + } else if (state == ZOO_EXPIRED_SESSION_STATE) { + fprintf(stderr, "Session expired. Shutting down...\n"); + zookeeper_close(zzh); + shutdownThisThing=1; + zh=0; + } + } +} + +void dumpStat(const struct Stat *stat) { + char tctimes[40]; + char tmtimes[40]; + time_t tctime; + time_t tmtime; + + if (!stat) { + fprintf(stderr,"null\n"); + return; + } + tctime = stat->ctime/1000; + tmtime = stat->mtime/1000; + + ctime_r(&tmtime, tmtimes); + ctime_r(&tctime, tctimes); + + fprintf(stderr, "\tctime = %s\tczxid=%llx\n" + "\tmtime=%s\tmzxid=%llx\n" + "\tversion=%x\taversion=%x\n" + "\tephemeralOwner = %llx\n", + tctimes, _LL_CAST_ stat->czxid, tmtimes, + _LL_CAST_ stat->mzxid, + (unsigned int)stat->version, (unsigned int)stat->aversion, + _LL_CAST_ stat->ephemeralOwner); +} + +void my_string_completion(int rc, const char *name, const void *data) { + fprintf(stderr, "[%s]: rc = %d\n", (char*)(data==0?"null":data), rc); + if (!rc) { + fprintf(stderr, "\tname = %s\n", name); + } + if(batchMode) + shutdownThisThing=1; +} + +void my_string_completion_free_data(int rc, const char *name, const void *data) { + my_string_completion(rc, name, data); + free((void*)data); +} + +void my_data_completion(int rc, const char *value, int value_len, + const struct Stat *stat, const void *data) { + struct timeval tv; + int sec; + int usec; + gettimeofday(&tv, 0); + sec = tv.tv_sec - startTime.tv_sec; + usec = tv.tv_usec - startTime.tv_usec; + fprintf(stderr, "time = %d msec\n", sec*1000 + usec/1000); + fprintf(stderr, "%s: rc = %d\n", (char*)data, rc); + if (value) { + fprintf(stderr, " value_len = %d\n", value_len); + assert(write(2, value, value_len) == value_len); + } + fprintf(stderr, "\nStat:\n"); + dumpStat(stat); + free((void*)data); + if(batchMode) + shutdownThisThing=1; +} + +void my_silent_data_completion(int rc, const char *value, int value_len, + const struct Stat *stat, const void *data) { + recvd++; + fprintf(stderr, "Data completion %s rc = %d\n",(char*)data,rc); + free((void*)data); + if (recvd==to_send) { + fprintf(stderr,"Recvd %d responses for %d requests sent\n",recvd,to_send); + if(batchMode) + shutdownThisThing=1; + } +} + +void my_strings_completion(int rc, const struct String_vector *strings, + const void *data) { + struct timeval tv; + int sec; + int usec; + int i; + + gettimeofday(&tv, 0); + sec = tv.tv_sec - startTime.tv_sec; + usec = tv.tv_usec - startTime.tv_usec; + fprintf(stderr, "time = %d msec\n", sec*1000 + usec/1000); + fprintf(stderr, "%s: rc = %d\n", (char*)data, rc); + if (strings) + for (i=0; i < strings->count; i++) { + fprintf(stderr, "\t%s\n", strings->data[i]); + } + free((void*)data); + gettimeofday(&tv, 0); + sec = tv.tv_sec - startTime.tv_sec; + usec = tv.tv_usec - startTime.tv_usec; + fprintf(stderr, "time = %d msec\n", sec*1000 + usec/1000); + if(batchMode) + shutdownThisThing=1; +} + +void my_strings_stat_completion(int rc, const struct String_vector *strings, + const struct Stat *stat, const void *data) { + my_strings_completion(rc, strings, data); + dumpStat(stat); + if(batchMode) + shutdownThisThing=1; +} + +void my_void_completion(int rc, const void *data) { + fprintf(stderr, "%s: rc = %d\n", (char*)data, rc); + free((void*)data); + if(batchMode) + shutdownThisThing=1; +} + +void my_stat_completion(int rc, const struct Stat *stat, const void *data) { + fprintf(stderr, "%s: rc = %d Stat:\n", (char*)data, rc); + dumpStat(stat); + free((void*)data); + if(batchMode) + shutdownThisThing=1; +} + +void my_silent_stat_completion(int rc, const struct Stat *stat, + const void *data) { + // fprintf(stderr, "State completion: [%s] rc = %d\n", (char*)data, rc); + sent++; + free((void*)data); +} + +static void sendRequest(const char* data) { + zoo_aset(zh, "/od", data, strlen(data), -1, my_silent_stat_completion, + strdup("/od")); + zoo_aget(zh, "/od", 1, my_silent_data_completion, strdup("/od")); +} + +void od_completion(int rc, const struct Stat *stat, const void *data) { + int i; + fprintf(stderr, "od command response: rc = %d Stat:\n", rc); + dumpStat(stat); + // send a whole bunch of requests + recvd=0; + sent=0; + to_send=200; + for (i=0; i\n"); + fprintf(stderr, " delete \n"); + fprintf(stderr, " set \n"); + fprintf(stderr, " get \n"); + fprintf(stderr, " ls \n"); + fprintf(stderr, " ls2 \n"); + fprintf(stderr, " sync \n"); + fprintf(stderr, " exists \n"); + fprintf(stderr, " wexists \n"); + fprintf(stderr, " myid\n"); + fprintf(stderr, " verbose\n"); + fprintf(stderr, " addauth \n"); + fprintf(stderr, " quit\n"); + fprintf(stderr, "\n"); + fprintf(stderr, " prefix the command with the character 'a' to run the command asynchronously.\n"); + fprintf(stderr, " run the 'verbose' command to toggle verbose logging.\n"); + fprintf(stderr, " i.e. 'aget /foo' to get /foo asynchronously\n"); + } else if (startsWith(line, "verbose")) { + if (verbose) { + verbose = 0; + zoo_set_debug_level(ZOO_LOG_LEVEL_WARN); + fprintf(stderr, "logging level set to WARN\n"); + } else { + verbose = 1; + zoo_set_debug_level(ZOO_LOG_LEVEL_DEBUG); + fprintf(stderr, "logging level set to DEBUG\n"); + } + } else if (startsWith(line, "get ")) { + line += 4; + if (line[0] != '/') { + fprintf(stderr, "Path must start with /, found: %s\n", line); + return; + } + + rc = zoo_aget(zh, line, 1, my_data_completion, strdup(line)); + if (rc) { + fprintf(stderr, "Error %d for %s\n", rc, line); + } + } else if (startsWith(line, "set ")) { + char *ptr; + line += 4; + if (line[0] != '/') { + fprintf(stderr, "Path must start with /, found: %s\n", line); + return; + } + ptr = strchr(line, ' '); + if (!ptr) { + fprintf(stderr, "No data found after path\n"); + return; + } + *ptr = '\0'; + ptr++; + if (async) { + rc = zoo_aset(zh, line, ptr, strlen(ptr), -1, my_stat_completion, + strdup(line)); + } else { + struct Stat stat; + rc = zoo_set2(zh, line, ptr, strlen(ptr), -1, &stat); + } + if (rc) { + fprintf(stderr, "Error %d for %s\n", rc, line); + } + } else if (startsWith(line, "ls ")) { + line += 3; + if (line[0] != '/') { + fprintf(stderr, "Path must start with /, found: %s\n", line); + return; + } + gettimeofday(&startTime, 0); + rc= zoo_aget_children(zh, line, 1, my_strings_completion, strdup(line)); + if (rc) { + fprintf(stderr, "Error %d for %s\n", rc, line); + } + } else if (startsWith(line, "ls2 ")) { + line += 4; + if (line[0] != '/') { + fprintf(stderr, "Path must start with /, found: %s\n", line); + return; + } + gettimeofday(&startTime, 0); + rc= zoo_aget_children2(zh, line, 1, my_strings_stat_completion, strdup(line)); + if (rc) { + fprintf(stderr, "Error %d for %s\n", rc, line); + } + } else if (startsWith(line, "create ")) { + int flags = 0; + line += 7; + if (line[0] == '+') { + line++; + if (line[0] == 'e') { + flags |= ZOO_EPHEMERAL; + line++; + } + if (line[0] == 's') { + flags |= ZOO_SEQUENCE; + line++; + } + line++; + } + if (line[0] != '/') { + fprintf(stderr, "Path must start with /, found: %s\n", line); + return; + } + fprintf(stderr, "Creating [%s] node\n", line); +// { +// struct ACL _CREATE_ONLY_ACL_ACL[] = {{ZOO_PERM_CREATE, ZOO_ANYONE_ID_UNSAFE}}; +// struct ACL_vector CREATE_ONLY_ACL = {1,_CREATE_ONLY_ACL_ACL}; +// rc = zoo_acreate(zh, line, "new", 3, &CREATE_ONLY_ACL, flags, +// my_string_completion, strdup(line)); +// } + rc = zoo_acreate(zh, line, "new", 3, &ZOO_OPEN_ACL_UNSAFE, flags, + my_string_completion_free_data, strdup(line)); + if (rc) { + fprintf(stderr, "Error %d for %s\n", rc, line); + } + } else if (startsWith(line, "delete ")) { + line += 7; + if (line[0] != '/') { + fprintf(stderr, "Path must start with /, found: %s\n", line); + return; + } + if (async) { + rc = zoo_adelete(zh, line, -1, my_void_completion, strdup(line)); + } else { + rc = zoo_delete(zh, line, -1); + } + if (rc) { + fprintf(stderr, "Error %d for %s\n", rc, line); + } + } else if (startsWith(line, "sync ")) { + line += 5; + if (line[0] != '/') { + fprintf(stderr, "Path must start with /, found: %s\n", line); + return; + } + rc = zoo_async(zh, line, my_string_completion_free_data, strdup(line)); + if (rc) { + fprintf(stderr, "Error %d for %s\n", rc, line); + } + } else if (startsWith(line, "wexists ")) { +#ifdef THREADED + struct Stat stat; +#endif + line += 8; + if (line[0] != '/') { + fprintf(stderr, "Path must start with /, found: %s\n", line); + return; + } +#ifndef THREADED + rc = zoo_awexists(zh, line, watcher, (void*) 0, my_stat_completion, strdup(line)); +#else + rc = zoo_wexists(zh, line, watcher, (void*) 0, &stat); +#endif + if (rc) { + fprintf(stderr, "Error %d for %s\n", rc, line); + } + } else if (startsWith(line, "exists ")) { +#ifdef THREADED + struct Stat stat; +#endif + line += 7; + if (line[0] != '/') { + fprintf(stderr, "Path must start with /, found: %s\n", line); + return; + } +#ifndef THREADED + rc = zoo_aexists(zh, line, 1, my_stat_completion, strdup(line)); +#else + rc = zoo_exists(zh, line, 1, &stat); +#endif + if (rc) { + fprintf(stderr, "Error %d for %s\n", rc, line); + } + } else if (strcmp(line, "myid") == 0) { + printf("session Id = %llx\n", _LL_CAST_ zoo_client_id(zh)->client_id); + } else if (strcmp(line, "reinit") == 0) { + zookeeper_close(zh); + // we can't send myid to the server here -- zookeeper_close() removes + // the session on the server. We must start anew. + zh = zookeeper_init(hostPort, watcher, 30000, 0, 0, 0); + } else if (startsWith(line, "quit")) { + fprintf(stderr, "Quitting...\n"); + shutdownThisThing=1; + } else if (startsWith(line, "od")) { + const char val[]="fire off"; + fprintf(stderr, "Overdosing...\n"); + rc = zoo_aset(zh, "/od", val, sizeof(val)-1, -1, od_completion, 0); + if (rc) + fprintf(stderr, "od command failed: %d\n", rc); + } else if (startsWith(line, "addauth ")) { + char *ptr; + line += 8; + ptr = strchr(line, ' '); + if (ptr) { + *ptr = '\0'; + ptr++; + } + zoo_add_auth(zh, line, ptr, ptr ? strlen(ptr) : 0, NULL, NULL); + } +} + +int main(int argc, char **argv) { +#ifndef THREADED + fd_set rfds, wfds, efds; + int processed=0; +#endif + char buffer[4096]; + char p[2048]; +#ifdef YCA + char *cert=0; + char appId[64]; +#endif + int bufoff = 0; + FILE *fh; + + if (argc < 2) { + fprintf(stderr, + "USAGE %s zookeeper_host_list [clientid_file|cmd:(ls|ls2|create|od|...)]\n", + argv[0]); + fprintf(stderr, + "Version: ZooKeeper cli (c client) version %d.%d.%d\n", + ZOO_MAJOR_VERSION, + ZOO_MINOR_VERSION, + ZOO_PATCH_VERSION); + return 2; + } + if (argc > 2) { + if(strncmp("cmd:",argv[2],4)==0){ + size_t cmdlen = strlen(argv[2]); + if (cmdlen > sizeof(cmd)) { + fprintf(stderr, + "Command length %zu exceeds max length of %zu\n", + cmdlen, + sizeof(cmd)); + return 2; + } + strncpy(cmd, argv[2]+4, sizeof(cmd)); + batchMode=1; + fprintf(stderr,"Batch mode: %s\n",cmd); + }else{ + clientIdFile = argv[2]; + fh = fopen(clientIdFile, "r"); + if (fh) { + if (fread(&myid, sizeof(myid), 1, fh) != sizeof(myid)) { + memset(&myid, 0, sizeof(myid)); + } + fclose(fh); + } + } + } +#ifdef YCA + strcpy(appId,"yahoo.example.yca_test"); + cert = yca_get_cert_once(appId); + if(cert!=0) { + fprintf(stderr,"Certificate for appid [%s] is [%s]\n",appId,cert); + strncpy(p,cert,sizeof(p)-1); + free(cert); + } else { + fprintf(stderr,"Certificate for appid [%s] not found\n",appId); + strcpy(p,"dummy"); + } +#else + strcpy(p, "dummy"); +#endif + verbose = 0; + zoo_set_debug_level(ZOO_LOG_LEVEL_WARN); + zoo_deterministic_conn_order(1); // enable deterministic order + hostPort = argv[1]; + zh = zookeeper_init(hostPort, watcher, 30000, &myid, 0, 0); + if (!zh) { + return errno; + } + +#ifdef YCA + if(zoo_add_auth(zh,"yca",p,strlen(p),0,0)!=ZOK) + return 2; +#endif + +#ifdef THREADED + while(!shutdownThisThing) { + int rc; + int len = sizeof(buffer) - bufoff -1; + if (len <= 0) { + fprintf(stderr, "Can't handle lines that long!\n"); + exit(2); + } + rc = read(0, buffer+bufoff, len); + if (rc <= 0) { + fprintf(stderr, "bye\n"); + shutdownThisThing=1; + break; + } + bufoff += rc; + buffer[bufoff] = '\0'; + while (strchr(buffer, '\n')) { + char *ptr = strchr(buffer, '\n'); + *ptr = '\0'; + processline(buffer); + ptr++; + memmove(buffer, ptr, strlen(ptr)+1); + bufoff = 0; + } + } +#else + FD_ZERO(&rfds); + FD_ZERO(&wfds); + FD_ZERO(&efds); + while (!shutdownThisThing) { + int fd; + int interest; + int events; + struct timeval tv; + int rc; + zookeeper_interest(zh, &fd, &interest, &tv); + if (fd != -1) { + if (interest&ZOOKEEPER_READ) { + FD_SET(fd, &rfds); + } else { + FD_CLR(fd, &rfds); + } + if (interest&ZOOKEEPER_WRITE) { + FD_SET(fd, &wfds); + } else { + FD_CLR(fd, &wfds); + } + } else { + fd = 0; + } + FD_SET(0, &rfds); + rc = select(fd+1, &rfds, &wfds, &efds, &tv); + events = 0; + if (rc > 0) { + if (FD_ISSET(fd, &rfds)) { + events |= ZOOKEEPER_READ; + } + if (FD_ISSET(fd, &wfds)) { + events |= ZOOKEEPER_WRITE; + } + } + if(batchMode && processed==0){ + //batch mode + processline(cmd); + processed=1; + } + if (FD_ISSET(0, &rfds)) { + int rc; + int len = sizeof(buffer) - bufoff -1; + if (len <= 0) { + fprintf(stderr, "Can't handle lines that long!\n"); + exit(2); + } + rc = read(0, buffer+bufoff, len); + if (rc <= 0) { + fprintf(stderr, "bye\n"); + break; + } + bufoff += rc; + buffer[bufoff] = '\0'; + while (strchr(buffer, '\n')) { + char *ptr = strchr(buffer, '\n'); + *ptr = '\0'; + processline(buffer); + ptr++; + memmove(buffer, ptr, strlen(ptr)+1); + bufoff = 0; + } + } + zookeeper_process(zh, events); + } +#endif + if (to_send!=0) + fprintf(stderr,"Recvd %d responses for %d requests sent\n",recvd,sent); + zookeeper_close(zh); + return 0; +} diff --git a/src/c/src/hashtable/LICENSE.txt b/src/c/src/hashtable/LICENSE.txt new file mode 100644 index 0000000..674a624 --- /dev/null +++ b/src/c/src/hashtable/LICENSE.txt @@ -0,0 +1,30 @@ +Copyright (c) 2002, 2004, Christopher Clark +All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions +are met: + + * Redistributions of source code must retain the above copyright +notice, this list of conditions and the following disclaimer. + + * Redistributions in binary form must reproduce the above copyright +notice, this list of conditions and the following disclaimer in the +documentation and/or other materials provided with the distribution. + + * Neither the name of the original author; nor the names of any contributors +may be used to endorse or promote products derived from this software +without specific prior written permission. + + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR +CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, +EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, +PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR +PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF +LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING +NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS +SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. diff --git a/src/c/src/hashtable/hashtable.c b/src/c/src/hashtable/hashtable.c new file mode 100644 index 0000000..763357e --- /dev/null +++ b/src/c/src/hashtable/hashtable.c @@ -0,0 +1,274 @@ +/* Copyright (C) 2004 Christopher Clark */ + +#include "hashtable.h" +#include "hashtable_private.h" +#include +#include +#include +#include + +/* +Credit for primes table: Aaron Krowne + http://br.endernet.org/~akrowne/ + http://planetmath.org/encyclopedia/GoodHashTablePrimes.html +*/ +static const unsigned int primes[] = { +53, 97, 193, 389, +769, 1543, 3079, 6151, +12289, 24593, 49157, 98317, +196613, 393241, 786433, 1572869, +3145739, 6291469, 12582917, 25165843, +50331653, 100663319, 201326611, 402653189, +805306457, 1610612741 +}; +const unsigned int prime_table_length = sizeof(primes)/sizeof(primes[0]); +const float max_load_factor = 0.65; + +/*****************************************************************************/ +struct hashtable * +create_hashtable(unsigned int minsize, + unsigned int (*hashf) (void*), + int (*eqf) (void*,void*)) +{ + struct hashtable *h; + unsigned int pindex, size = primes[0]; + /* Check requested hashtable isn't too large */ + if (minsize > (1u << 30)) return NULL; + /* Enforce size as prime */ + for (pindex=0; pindex < prime_table_length; pindex++) { + if (primes[pindex] > minsize) { size = primes[pindex]; break; } + } + h = (struct hashtable *)malloc(sizeof(struct hashtable)); + if (NULL == h) return NULL; /*oom*/ + h->table = (struct entry **)malloc(sizeof(struct entry*) * size); + if (NULL == h->table) { free(h); return NULL; } /*oom*/ + memset(h->table, 0, size * sizeof(struct entry *)); + h->tablelength = size; + h->primeindex = pindex; + h->entrycount = 0; + h->hashfn = hashf; + h->eqfn = eqf; + h->loadlimit = (unsigned int) ceil(size * max_load_factor); + return h; +} + +/*****************************************************************************/ +unsigned int +hash(struct hashtable *h, void *k) +{ + /* Aim to protect against poor hash functions by adding logic here + * - logic taken from java 1.4 hashtable source */ + unsigned int i = h->hashfn(k); + i += ~(i << 9); + i ^= ((i >> 14) | (i << 18)); /* >>> */ + i += (i << 4); + i ^= ((i >> 10) | (i << 22)); /* >>> */ + return i; +} + +/*****************************************************************************/ +static int +hashtable_expand(struct hashtable *h) +{ + /* Double the size of the table to accomodate more entries */ + struct entry **newtable; + struct entry *e; + struct entry **pE; + unsigned int newsize, i, index; + /* Check we're not hitting max capacity */ + if (h->primeindex == (prime_table_length - 1)) return 0; + newsize = primes[++(h->primeindex)]; + + newtable = (struct entry **)malloc(sizeof(struct entry*) * newsize); + if (NULL != newtable) + { + memset(newtable, 0, newsize * sizeof(struct entry *)); + /* This algorithm is not 'stable'. ie. it reverses the list + * when it transfers entries between the tables */ + for (i = 0; i < h->tablelength; i++) { + while (NULL != (e = h->table[i])) { + h->table[i] = e->next; + index = indexFor(newsize,e->h); + e->next = newtable[index]; + newtable[index] = e; + } + } + free(h->table); + h->table = newtable; + } + /* Plan B: realloc instead */ + else + { + newtable = (struct entry **) + realloc(h->table, newsize * sizeof(struct entry *)); + if (NULL == newtable) { (h->primeindex)--; return 0; } + h->table = newtable; + memset(newtable[h->tablelength], 0, newsize - h->tablelength); + for (i = 0; i < h->tablelength; i++) { + for (pE = &(newtable[i]), e = *pE; e != NULL; e = *pE) { + index = indexFor(newsize,e->h); + if (index == i) + { + pE = &(e->next); + } + else + { + *pE = e->next; + e->next = newtable[index]; + newtable[index] = e; + } + } + } + } + h->tablelength = newsize; + h->loadlimit = (unsigned int) ceil(newsize * max_load_factor); + return -1; +} + +/*****************************************************************************/ +unsigned int +hashtable_count(struct hashtable *h) +{ + return h->entrycount; +} + +/*****************************************************************************/ +int +hashtable_insert(struct hashtable *h, void *k, void *v) +{ + /* This method allows duplicate keys - but they shouldn't be used */ + unsigned int index; + struct entry *e; + if (++(h->entrycount) > h->loadlimit) + { + /* Ignore the return value. If expand fails, we should + * still try cramming just this value into the existing table + * -- we may not have memory for a larger table, but one more + * element may be ok. Next time we insert, we'll try expanding again.*/ + hashtable_expand(h); + } + e = (struct entry *)malloc(sizeof(struct entry)); + if (NULL == e) { --(h->entrycount); return 0; } /*oom*/ + e->h = hash(h,k); + index = indexFor(h->tablelength,e->h); + e->k = k; + e->v = v; + e->next = h->table[index]; + h->table[index] = e; + return -1; +} + +/*****************************************************************************/ +void * /* returns value associated with key */ +hashtable_search(struct hashtable *h, void *k) +{ + struct entry *e; + unsigned int hashvalue, index; + hashvalue = hash(h,k); + index = indexFor(h->tablelength,hashvalue); + e = h->table[index]; + while (NULL != e) + { + /* Check hash value to short circuit heavier comparison */ + if ((hashvalue == e->h) && (h->eqfn(k, e->k))) return e->v; + e = e->next; + } + return NULL; +} + +/*****************************************************************************/ +void * /* returns value associated with key */ +hashtable_remove(struct hashtable *h, void *k) +{ + /* TODO: consider compacting the table when the load factor drops enough, + * or provide a 'compact' method. */ + + struct entry *e; + struct entry **pE; + void *v; + unsigned int hashvalue, index; + + hashvalue = hash(h,k); + index = indexFor(h->tablelength,hash(h,k)); + pE = &(h->table[index]); + e = *pE; + while (NULL != e) + { + /* Check hash value to short circuit heavier comparison */ + if ((hashvalue == e->h) && (h->eqfn(k, e->k))) + { + *pE = e->next; + h->entrycount--; + v = e->v; + freekey(e->k); + free(e); + return v; + } + pE = &(e->next); + e = e->next; + } + return NULL; +} + +/*****************************************************************************/ +/* destroy */ +void +hashtable_destroy(struct hashtable *h, int free_values) +{ + unsigned int i; + struct entry *e, *f; + struct entry **table = h->table; + if (free_values) + { + for (i = 0; i < h->tablelength; i++) + { + e = table[i]; + while (NULL != e) + { f = e; e = e->next; freekey(f->k); free(f->v); free(f); } + } + } + else + { + for (i = 0; i < h->tablelength; i++) + { + e = table[i]; + while (NULL != e) + { f = e; e = e->next; freekey(f->k); free(f); } + } + } + free(h->table); + free(h); +} + +/* + * Copyright (c) 2002, Christopher Clark + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of the original author; nor the names of any contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR + * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER + * OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +*/ diff --git a/src/c/src/hashtable/hashtable.h b/src/c/src/hashtable/hashtable.h new file mode 100644 index 0000000..cbead18 --- /dev/null +++ b/src/c/src/hashtable/hashtable.h @@ -0,0 +1,209 @@ +/* Copyright (C) 2002 Christopher Clark */ + +#ifndef __HASHTABLE_CWC22_H__ +#define __HASHTABLE_CWC22_H__ +#ifdef WIN32 +#include "winconfig.h" +#endif +#ifdef __cplusplus +extern "C" { +#endif + +struct hashtable; + +/* Example of use: + * + * struct hashtable *h; + * struct some_key *k; + * struct some_value *v; + * + * static unsigned int hash_from_key_fn( void *k ); + * static int keys_equal_fn ( void *key1, void *key2 ); + * + * h = create_hashtable(16, hash_from_key_fn, keys_equal_fn); + * k = (struct some_key *) malloc(sizeof(struct some_key)); + * v = (struct some_value *) malloc(sizeof(struct some_value)); + * + * (initialise k and v to suitable values) + * + * if (! hashtable_insert(h,k,v) ) + * { exit(-1); } + * + * if (NULL == (found = hashtable_search(h,k) )) + * { printf("not found!"); } + * + * if (NULL == (found = hashtable_remove(h,k) )) + * { printf("Not found\n"); } + * + */ + +/* Macros may be used to define type-safe(r) hashtable access functions, with + * methods specialized to take known key and value types as parameters. + * + * Example: + * + * Insert this at the start of your file: + * + * DEFINE_HASHTABLE_INSERT(insert_some, struct some_key, struct some_value); + * DEFINE_HASHTABLE_SEARCH(search_some, struct some_key, struct some_value); + * DEFINE_HASHTABLE_REMOVE(remove_some, struct some_key, struct some_value); + * + * This defines the functions 'insert_some', 'search_some' and 'remove_some'. + * These operate just like hashtable_insert etc., with the same parameters, + * but their function signatures have 'struct some_key *' rather than + * 'void *', and hence can generate compile time errors if your program is + * supplying incorrect data as a key (and similarly for value). + * + * Note that the hash and key equality functions passed to create_hashtable + * still take 'void *' parameters instead of 'some key *'. This shouldn't be + * a difficult issue as they're only defined and passed once, and the other + * functions will ensure that only valid keys are supplied to them. + * + * The cost for this checking is increased code size and runtime overhead + * - if performance is important, it may be worth switching back to the + * unsafe methods once your program has been debugged with the safe methods. + * This just requires switching to some simple alternative defines - eg: + * #define insert_some hashtable_insert + * + */ + +/***************************************************************************** + * create_hashtable + + * @name create_hashtable + * @param minsize minimum initial size of hashtable + * @param hashfunction function for hashing keys + * @param key_eq_fn function for determining key equality + * @return newly created hashtable or NULL on failure + */ + +struct hashtable * +create_hashtable(unsigned int minsize, + unsigned int (*hashfunction) (void*), + int (*key_eq_fn) (void*,void*)); + +/***************************************************************************** + * hashtable_insert + + * @name hashtable_insert + * @param h the hashtable to insert into + * @param k the key - hashtable claims ownership and will free on removal + * @param v the value - does not claim ownership + * @return non-zero for successful insertion + * + * This function will cause the table to expand if the insertion would take + * the ratio of entries to table size over the maximum load factor. + * + * This function does not check for repeated insertions with a duplicate key. + * The value returned when using a duplicate key is undefined -- when + * the hashtable changes size, the order of retrieval of duplicate key + * entries is reversed. + * If in doubt, remove before insert. + */ + +int +hashtable_insert(struct hashtable *h, void *k, void *v); + +#define DEFINE_HASHTABLE_INSERT(fnname, keytype, valuetype) \ +int fnname (struct hashtable *h, keytype *k, valuetype *v) \ +{ \ + return hashtable_insert(h,k,v); \ +} + +/***************************************************************************** + * hashtable_search + + * @name hashtable_search + * @param h the hashtable to search + * @param k the key to search for - does not claim ownership + * @return the value associated with the key, or NULL if none found + */ + +void * +hashtable_search(struct hashtable *h, void *k); + +#define DEFINE_HASHTABLE_SEARCH(fnname, keytype, valuetype) \ +valuetype * fnname (struct hashtable *h, keytype *k) \ +{ \ + return (valuetype *) (hashtable_search(h,k)); \ +} + +/***************************************************************************** + * hashtable_remove + + * @name hashtable_remove + * @param h the hashtable to remove the item from + * @param k the key to search for - does not claim ownership + * @return the value associated with the key, or NULL if none found + */ + +void * /* returns value */ +hashtable_remove(struct hashtable *h, void *k); + +#define DEFINE_HASHTABLE_REMOVE(fnname, keytype, valuetype) \ +valuetype * fnname (struct hashtable *h, keytype *k) \ +{ \ + return (valuetype *) (hashtable_remove(h,k)); \ +} + + +/***************************************************************************** + * hashtable_count + + * @name hashtable_count + * @param h the hashtable + * @return the number of items stored in the hashtable + */ +unsigned int +hashtable_count(struct hashtable *h); + + +/***************************************************************************** + * hashtable_destroy + + * @name hashtable_destroy + * @param h the hashtable + * @param free_values whether to call 'free' on the remaining values + */ + +void +hashtable_destroy(struct hashtable *h, int free_values); + +#ifdef __cplusplus +} +#endif + +#endif /* __HASHTABLE_CWC22_H__ */ + +/* + * Copyright (c) 2002, Christopher Clark + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of the original author; nor the names of any contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR + * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER + * OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +*/ diff --git a/src/c/src/hashtable/hashtable_itr.c b/src/c/src/hashtable/hashtable_itr.c new file mode 100644 index 0000000..defac69 --- /dev/null +++ b/src/c/src/hashtable/hashtable_itr.c @@ -0,0 +1,176 @@ +/* Copyright (C) 2002, 2004 Christopher Clark */ + +#include "hashtable.h" +#include "hashtable_private.h" +#include "hashtable_itr.h" +#include /* defines NULL */ + +/*****************************************************************************/ +/* hashtable_iterator - iterator constructor */ + +struct hashtable_itr * +hashtable_iterator(struct hashtable *h) +{ + unsigned int i, tablelength; + struct hashtable_itr *itr = (struct hashtable_itr *) + malloc(sizeof(struct hashtable_itr)); + if (NULL == itr) return NULL; + itr->h = h; + itr->e = NULL; + itr->parent = NULL; + tablelength = h->tablelength; + itr->index = tablelength; + if (0 == h->entrycount) return itr; + + for (i = 0; i < tablelength; i++) + { + if (NULL != h->table[i]) + { + itr->e = h->table[i]; + itr->index = i; + break; + } + } + return itr; +} + +/*****************************************************************************/ +/* advance - advance the iterator to the next element + * returns zero if advanced to end of table */ + +int +hashtable_iterator_advance(struct hashtable_itr *itr) +{ + unsigned int j,tablelength; + struct entry **table; + struct entry *next; + if (NULL == itr->e) return 0; /* stupidity check */ + + next = itr->e->next; + if (NULL != next) + { + itr->parent = itr->e; + itr->e = next; + return -1; + } + tablelength = itr->h->tablelength; + itr->parent = NULL; + if (tablelength <= (j = ++(itr->index))) + { + itr->e = NULL; + return 0; + } + table = itr->h->table; + while (NULL == (next = table[j])) + { + if (++j >= tablelength) + { + itr->index = tablelength; + itr->e = NULL; + return 0; + } + } + itr->index = j; + itr->e = next; + return -1; +} + +/*****************************************************************************/ +/* remove - remove the entry at the current iterator position + * and advance the iterator, if there is a successive + * element. + * If you want the value, read it before you remove: + * beware memory leaks if you don't. + * Returns zero if end of iteration. */ + +int +hashtable_iterator_remove(struct hashtable_itr *itr) +{ + struct entry *remember_e, *remember_parent; + int ret; + + /* Do the removal */ + if (NULL == (itr->parent)) + { + /* element is head of a chain */ + itr->h->table[itr->index] = itr->e->next; + } else { + /* element is mid-chain */ + itr->parent->next = itr->e->next; + } + /* itr->e is now outside the hashtable */ + remember_e = itr->e; + itr->h->entrycount--; + freekey(remember_e->k); + + /* Advance the iterator, correcting the parent */ + remember_parent = itr->parent; + ret = hashtable_iterator_advance(itr); + if (itr->parent == remember_e) { itr->parent = remember_parent; } + free(remember_e); + return ret; +} + +/*****************************************************************************/ +int /* returns zero if not found */ +hashtable_iterator_search(struct hashtable_itr *itr, + struct hashtable *h, void *k) +{ + struct entry *e, *parent; + unsigned int hashvalue, index; + + hashvalue = hash(h,k); + index = indexFor(h->tablelength,hashvalue); + + e = h->table[index]; + parent = NULL; + while (NULL != e) + { + /* Check hash value to short circuit heavier comparison */ + if ((hashvalue == e->h) && (h->eqfn(k, e->k))) + { + itr->index = index; + itr->e = e; + itr->parent = parent; + itr->h = h; + return -1; + } + parent = e; + e = e->next; + } + return 0; +} + + +/* + * Copyright (c) 2002, 2004, Christopher Clark + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of the original author; nor the names of any contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR + * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER + * OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +*/ diff --git a/src/c/src/hashtable/hashtable_itr.h b/src/c/src/hashtable/hashtable_itr.h new file mode 100644 index 0000000..30379c7 --- /dev/null +++ b/src/c/src/hashtable/hashtable_itr.h @@ -0,0 +1,119 @@ +/* Copyright (C) 2002, 2004 Christopher Clark */ + +#ifndef __HASHTABLE_ITR_CWC22__ +#define __HASHTABLE_ITR_CWC22__ +#include "hashtable.h" +#include "hashtable_private.h" /* needed to enable inlining */ + +#ifdef __cplusplus +extern "C" { +#endif + +/*****************************************************************************/ +/* This struct is only concrete here to allow the inlining of two of the + * accessor functions. */ +struct hashtable_itr +{ + struct hashtable *h; + struct entry *e; + struct entry *parent; + unsigned int index; +}; + + +/*****************************************************************************/ +/* hashtable_iterator + */ + +struct hashtable_itr * +hashtable_iterator(struct hashtable *h); + +/*****************************************************************************/ +/* hashtable_iterator_key + * - return the value of the (key,value) pair at the current position */ + +static inline void * +hashtable_iterator_key(struct hashtable_itr *i) +{ + return i->e->k; +} + +/*****************************************************************************/ +/* value - return the value of the (key,value) pair at the current position */ + +static inline void * +hashtable_iterator_value(struct hashtable_itr *i) +{ + return i->e->v; +} + +/*****************************************************************************/ +/* advance - advance the iterator to the next element + * returns zero if advanced to end of table */ + +int +hashtable_iterator_advance(struct hashtable_itr *itr); + +/*****************************************************************************/ +/* remove - remove current element and advance the iterator to the next element + * NB: if you need the value to free it, read it before + * removing. ie: beware memory leaks! + * returns zero if advanced to end of table */ + +int +hashtable_iterator_remove(struct hashtable_itr *itr); + +/*****************************************************************************/ +/* search - overwrite the supplied iterator, to point to the entry + * matching the supplied key. + h points to the hashtable to be searched. + * returns zero if not found. */ +int +hashtable_iterator_search(struct hashtable_itr *itr, + struct hashtable *h, void *k); + +#define DEFINE_HASHTABLE_ITERATOR_SEARCH(fnname, keytype) \ +int fnname (struct hashtable_itr *i, struct hashtable *h, keytype *k) \ +{ \ + return (hashtable_iterator_search(i,h,k)); \ +} + + +#ifdef __cplusplus +} +#endif + +#endif /* __HASHTABLE_ITR_CWC22__*/ + +/* + * Copyright (c) 2002, 2004, Christopher Clark + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of the original author; nor the names of any contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR + * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER + * OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +*/ diff --git a/src/c/src/hashtable/hashtable_private.h b/src/c/src/hashtable/hashtable_private.h new file mode 100644 index 0000000..3e95f60 --- /dev/null +++ b/src/c/src/hashtable/hashtable_private.h @@ -0,0 +1,85 @@ +/* Copyright (C) 2002, 2004 Christopher Clark */ + +#ifndef __HASHTABLE_PRIVATE_CWC22_H__ +#define __HASHTABLE_PRIVATE_CWC22_H__ + +#include "hashtable.h" + +/*****************************************************************************/ +struct entry +{ + void *k, *v; + unsigned int h; + struct entry *next; +}; + +struct hashtable { + unsigned int tablelength; + struct entry **table; + unsigned int entrycount; + unsigned int loadlimit; + unsigned int primeindex; + unsigned int (*hashfn) (void *k); + int (*eqfn) (void *k1, void *k2); +}; + +/*****************************************************************************/ +unsigned int +hash(struct hashtable *h, void *k); + +/*****************************************************************************/ +/* indexFor */ +static inline unsigned int +indexFor(unsigned int tablelength, unsigned int hashvalue) { + return (hashvalue % tablelength); +}; + +/* Only works if tablelength == 2^N */ +/*static inline unsigned int +indexFor(unsigned int tablelength, unsigned int hashvalue) +{ + return (hashvalue & (tablelength - 1u)); +} +*/ + +/*****************************************************************************/ +#define freekey(X) free(X) +/*define freekey(X) ; */ + + +/*****************************************************************************/ + +#endif /* __HASHTABLE_PRIVATE_CWC22_H__*/ + +/* + * Copyright (c) 2002, Christopher Clark + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * * Neither the name of the original author; nor the names of any contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR + * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER + * OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +*/ diff --git a/src/c/src/load_gen.c b/src/c/src/load_gen.c new file mode 100644 index 0000000..546d5d1 --- /dev/null +++ b/src/c/src/load_gen.c @@ -0,0 +1,282 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#include +#include "zookeeper_log.h" +#include +#ifdef THREADED +#include +#endif +#include +#include + +static zhandle_t *zh; + +static int shutdownThisThing=0; + +// ***************************************************************************** +// +static pthread_cond_t cond=PTHREAD_COND_INITIALIZER; +static pthread_mutex_t lock=PTHREAD_MUTEX_INITIALIZER; + +static pthread_cond_t counterCond=PTHREAD_COND_INITIALIZER; +static pthread_mutex_t counterLock=PTHREAD_MUTEX_INITIALIZER; +static int counter; + + + +void ensureConnected(){ + pthread_mutex_lock(&lock); + while (zoo_state(zh)!=ZOO_CONNECTED_STATE) { + pthread_cond_wait(&cond,&lock); + } + pthread_mutex_unlock(&lock); +} + +void incCounter(int delta){ + pthread_mutex_lock(&counterLock); + counter+=delta; + pthread_cond_broadcast(&counterCond); + pthread_mutex_unlock(&counterLock); + +} +void setCounter(int cnt){ + pthread_mutex_lock(&counterLock); + counter=cnt; + pthread_cond_broadcast(&counterCond); + pthread_mutex_unlock(&counterLock); + +} +void waitCounter(){ + pthread_mutex_lock(&counterLock); + while (counter>0) { + pthread_cond_wait(&counterCond,&counterLock); + } + pthread_mutex_unlock(&counterLock); +} + +void listener(zhandle_t *zzh, int type, int state, const char *path,void* ctx) { + if(type == ZOO_SESSION_EVENT){ + if(state == ZOO_CONNECTED_STATE){ + pthread_mutex_lock(&lock); + pthread_cond_broadcast(&cond); + pthread_mutex_unlock(&lock); + } + setCounter(0); + } +} + +void create_completion(int rc, const char *name, const void *data) { + incCounter(-1); + if(rc!=ZOK){ + LOG_ERROR(("Failed to create a node rc=%d",rc)); + } +} + +int doCreateNodes(const char* root, int count){ + char nodeName[1024]; + int i; + for(i=0; idata) { + int32_t i; + for(i=0;icount; i++) { + free(v->data[i]); + } + free(v->data); + v->data = 0; + } + return 0; +} + +static int deletedCounter; + +int recursiveDelete(const char* root){ + struct String_vector children; + int i; + int rc=zoo_get_children(zh,root,0,&children); + if(rc!=ZNONODE){ + if(rc!=ZOK){ + LOG_ERROR(("Failed to get children of %s, rc=%d",root,rc)); + return rc; + } + for(i=0;i +#include +#include +#include +#include +#include + +#ifndef WIN32 +#include +#include +#include +#include +#endif + +int zoo_lock_auth(zhandle_t *zh) +{ + return pthread_mutex_lock(&zh->auth_h.lock); +} +int zoo_unlock_auth(zhandle_t *zh) +{ + return pthread_mutex_unlock(&zh->auth_h.lock); +} +int lock_buffer_list(buffer_head_t *l) +{ + return pthread_mutex_lock(&l->lock); +} +int unlock_buffer_list(buffer_head_t *l) +{ + return pthread_mutex_unlock(&l->lock); +} +int lock_completion_list(completion_head_t *l) +{ + return pthread_mutex_lock(&l->lock); +} +int unlock_completion_list(completion_head_t *l) +{ + pthread_cond_broadcast(&l->cond); + return pthread_mutex_unlock(&l->lock); +} +struct sync_completion *alloc_sync_completion(void) +{ + struct sync_completion *sc = (struct sync_completion*)calloc(1, sizeof(struct sync_completion)); + if (sc) { + pthread_cond_init(&sc->cond, 0); + pthread_mutex_init(&sc->lock, 0); + } + return sc; +} +int wait_sync_completion(struct sync_completion *sc) +{ + pthread_mutex_lock(&sc->lock); + while (!sc->complete) { + pthread_cond_wait(&sc->cond, &sc->lock); + } + pthread_mutex_unlock(&sc->lock); + return 0; +} + +void free_sync_completion(struct sync_completion *sc) +{ + if (sc) { + pthread_mutex_destroy(&sc->lock); + pthread_cond_destroy(&sc->cond); + free(sc); + } +} + +void notify_sync_completion(struct sync_completion *sc) +{ + pthread_mutex_lock(&sc->lock); + sc->complete = 1; + pthread_cond_broadcast(&sc->cond); + pthread_mutex_unlock(&sc->lock); +} + +int process_async(int outstanding_sync) +{ + return 0; +} + +#ifdef WIN32 +unsigned __stdcall do_io( void * ); +unsigned __stdcall do_completion( void * ); + +int handle_error(SOCKET sock, char* message) +{ + LOG_ERROR(("%s. %d",message, WSAGetLastError())); + closesocket (sock); + return -1; +} + +//--create socket pair for interupting selects. +int create_socket_pair(SOCKET fds[2]) +{ + struct sockaddr_in inaddr; + struct sockaddr addr; + int yes=1; + int len=0; + + SOCKET lst=socket(AF_INET, SOCK_STREAM,IPPROTO_TCP); + if (lst == INVALID_SOCKET ){ + LOG_ERROR(("Error creating socket. %d",WSAGetLastError())); + return -1; + } + memset(&inaddr, 0, sizeof(inaddr)); + memset(&addr, 0, sizeof(addr)); + inaddr.sin_family = AF_INET; + inaddr.sin_addr.s_addr = htonl(INADDR_LOOPBACK); + inaddr.sin_port = 0; //--system assigns the port + + if ( setsockopt(lst,SOL_SOCKET,SO_REUSEADDR,(char*)&yes,sizeof(yes)) == SOCKET_ERROR ) { + return handle_error(lst,"Error trying to set socket option."); + } + if (bind(lst,(struct sockaddr *)&inaddr,sizeof(inaddr)) == SOCKET_ERROR){ + return handle_error(lst,"Error trying to bind socket."); + } + if (listen(lst,1) == SOCKET_ERROR){ + return handle_error(lst,"Error trying to listen on socket."); + } + len=sizeof(inaddr); + getsockname(lst, &addr,&len); + fds[0]=socket(AF_INET, SOCK_STREAM,0); + if (connect(fds[0],&addr,len) == SOCKET_ERROR){ + return handle_error(lst, "Error while connecting to socket."); + } + if ((fds[1]=accept(lst,0,0)) == INVALID_SOCKET){ + closesocket(fds[0]); + return handle_error(lst, "Error while accepting socket connection."); + } + closesocket(lst); + return 0; +} +#else +void *do_io(void *); +void *do_completion(void *); +#endif + + +int wakeup_io_thread(zhandle_t *zh); + +#ifdef WIN32 +static int set_nonblock(SOCKET fd){ + ULONG nonblocking_flag = 1; + if (ioctlsocket(fd, FIONBIO, &nonblocking_flag) == 0) + return 1; + else + return -1; +} +#else +static int set_nonblock(int fd){ + long l = fcntl(fd, F_GETFL); + if(l & O_NONBLOCK) return 0; + return fcntl(fd, F_SETFL, l | O_NONBLOCK); +} +#endif + +void wait_for_others(zhandle_t* zh) +{ + struct adaptor_threads* adaptor=zh->adaptor_priv; + pthread_mutex_lock(&adaptor->lock); + while(adaptor->threadsToWait>0) + pthread_cond_wait(&adaptor->cond,&adaptor->lock); + pthread_mutex_unlock(&adaptor->lock); +} + +void notify_thread_ready(zhandle_t* zh) +{ + struct adaptor_threads* adaptor=zh->adaptor_priv; + pthread_mutex_lock(&adaptor->lock); + adaptor->threadsToWait--; + pthread_cond_broadcast(&adaptor->cond); + while(adaptor->threadsToWait>0) + pthread_cond_wait(&adaptor->cond,&adaptor->lock); + pthread_mutex_unlock(&adaptor->lock); +} + + +void start_threads(zhandle_t* zh) +{ + int rc = 0; + struct adaptor_threads* adaptor=zh->adaptor_priv; + pthread_cond_init(&adaptor->cond,0); + pthread_mutex_init(&adaptor->lock,0); + adaptor->threadsToWait=2; // wait for 2 threads before opening the barrier + + // use api_prolog() to make sure zhandle doesn't get destroyed + // while initialization is in progress + api_prolog(zh); + LOG_DEBUG(("starting threads...")); + rc=pthread_create(&adaptor->io, 0, do_io, zh); + assert("pthread_create() failed for the IO thread"&&!rc); + rc=pthread_create(&adaptor->completion, 0, do_completion, zh); + assert("pthread_create() failed for the completion thread"&&!rc); + wait_for_others(zh); + api_epilog(zh, 0); +} + +int adaptor_init(zhandle_t *zh) +{ + pthread_mutexattr_t recursive_mx_attr; + struct adaptor_threads *adaptor_threads = calloc(1, sizeof(*adaptor_threads)); + if (!adaptor_threads) { + LOG_ERROR(("Out of memory")); + return -1; + } + + /* We use a pipe for interrupting select() in unix/sol and socketpair in windows. */ +#ifdef WIN32 + if (create_socket_pair(adaptor_threads->self_pipe) == -1){ + LOG_ERROR(("Can't make a socket.")); +#else + if(pipe(adaptor_threads->self_pipe)==-1) { + LOG_ERROR(("Can't make a pipe %d",errno)); +#endif + free(adaptor_threads); + return -1; + } + set_nonblock(adaptor_threads->self_pipe[1]); + set_nonblock(adaptor_threads->self_pipe[0]); + + pthread_mutex_init(&zh->auth_h.lock,0); + + zh->adaptor_priv = adaptor_threads; + pthread_mutex_init(&zh->to_process.lock,0); + pthread_mutex_init(&adaptor_threads->zh_lock,0); + // to_send must be recursive mutex + pthread_mutexattr_init(&recursive_mx_attr); + pthread_mutexattr_settype(&recursive_mx_attr, PTHREAD_MUTEX_RECURSIVE); + pthread_mutex_init(&zh->to_send.lock,&recursive_mx_attr); + pthread_mutexattr_destroy(&recursive_mx_attr); + + pthread_mutex_init(&zh->sent_requests.lock,0); + pthread_cond_init(&zh->sent_requests.cond,0); + pthread_mutex_init(&zh->completions_to_process.lock,0); + pthread_cond_init(&zh->completions_to_process.cond,0); + start_threads(zh); + return 0; +} + +void adaptor_finish(zhandle_t *zh) +{ + struct adaptor_threads *adaptor_threads; + // make sure zh doesn't get destroyed until after we're done here + api_prolog(zh); + adaptor_threads = zh->adaptor_priv; + if(adaptor_threads==0) { + api_epilog(zh,0); + return; + } + + if(!pthread_equal(adaptor_threads->io,pthread_self())){ + wakeup_io_thread(zh); + pthread_join(adaptor_threads->io, 0); + }else + pthread_detach(adaptor_threads->io); + + if(!pthread_equal(adaptor_threads->completion,pthread_self())){ + pthread_mutex_lock(&zh->completions_to_process.lock); + pthread_cond_broadcast(&zh->completions_to_process.cond); + pthread_mutex_unlock(&zh->completions_to_process.lock); + pthread_join(adaptor_threads->completion, 0); + }else + pthread_detach(adaptor_threads->completion); + + api_epilog(zh,0); +} + +void adaptor_destroy(zhandle_t *zh) +{ + struct adaptor_threads *adaptor = zh->adaptor_priv; + if(adaptor==0) return; + + pthread_cond_destroy(&adaptor->cond); + pthread_mutex_destroy(&adaptor->lock); + pthread_mutex_destroy(&zh->to_process.lock); + pthread_mutex_destroy(&zh->to_send.lock); + pthread_mutex_destroy(&zh->sent_requests.lock); + pthread_cond_destroy(&zh->sent_requests.cond); + pthread_mutex_destroy(&zh->completions_to_process.lock); + pthread_cond_destroy(&zh->completions_to_process.cond); + pthread_mutex_destroy(&adaptor->zh_lock); + + pthread_mutex_destroy(&zh->auth_h.lock); + + close(adaptor->self_pipe[0]); + close(adaptor->self_pipe[1]); + free(adaptor); + zh->adaptor_priv=0; +} + +int wakeup_io_thread(zhandle_t *zh) +{ + struct adaptor_threads *adaptor_threads = zh->adaptor_priv; + char c=0; +#ifndef WIN32 + return write(adaptor_threads->self_pipe[1],&c,1)==1? ZOK: ZSYSTEMERROR; +#else + return send(adaptor_threads->self_pipe[1], &c, 1, 0)==1? ZOK: ZSYSTEMERROR; +#endif +} + +int adaptor_send_queue(zhandle_t *zh, int timeout) +{ + if(!zh->close_requested) + return wakeup_io_thread(zh); + // don't rely on the IO thread to send the messages if the app has + // requested to close + return flush_send_queue(zh, timeout); +} + +/* These two are declared here because we will run the event loop + * and not the client */ +#ifdef WIN32 +int zookeeper_interest(zhandle_t *zh, SOCKET *fd, int *interest, + struct timeval *tv); +#else +int zookeeper_interest(zhandle_t *zh, int *fd, int *interest, + struct timeval *tv); +#endif +int zookeeper_process(zhandle_t *zh, int events); + +#ifdef WIN32 +unsigned __stdcall do_io( void * v) +#else +void *do_io(void *v) +#endif +{ + zhandle_t *zh = (zhandle_t*)v; +#ifndef WIN32 + struct pollfd fds[2]; + struct adaptor_threads *adaptor_threads = zh->adaptor_priv; + + api_prolog(zh); + notify_thread_ready(zh); + LOG_DEBUG(("started IO thread")); + fds[0].fd=adaptor_threads->self_pipe[0]; + fds[0].events=POLLIN; + while(!zh->close_requested) { + struct timeval tv; + int fd; + int interest; + int timeout; + int maxfd=1; + + zookeeper_interest(zh, &fd, &interest, &tv); + if (fd != -1) { + fds[1].fd=fd; + fds[1].events=(interest&ZOOKEEPER_READ)?POLLIN:0; + fds[1].events|=(interest&ZOOKEEPER_WRITE)?POLLOUT:0; + maxfd=2; + } + timeout=tv.tv_sec * 1000 + (tv.tv_usec/1000); + + poll(fds,maxfd,timeout); + if (fd != -1) { + interest=(fds[1].revents&POLLIN)?ZOOKEEPER_READ:0; + interest|=((fds[1].revents&POLLOUT)||(fds[1].revents&POLLHUP))?ZOOKEEPER_WRITE:0; + } + if(fds[0].revents&POLLIN){ + // flush the pipe + char b[128]; + while(read(adaptor_threads->self_pipe[0],b,sizeof(b))==sizeof(b)){} + } +#else + fd_set rfds, wfds, efds; + struct adaptor_threads *adaptor_threads = zh->adaptor_priv; + api_prolog(zh); + notify_thread_ready(zh); + LOG_DEBUG(("started IO thread")); + FD_ZERO(&rfds); FD_ZERO(&wfds); FD_ZERO(&efds); + while(!zh->close_requested) { + struct timeval tv; + SOCKET fd; + SOCKET maxfd=adaptor_threads->self_pipe[0]; + int interest; + int rc; + + zookeeper_interest(zh, &fd, &interest, &tv); + if (fd != -1) { + if (interest&ZOOKEEPER_READ) { + FD_SET(fd, &rfds); + } else { + FD_CLR(fd, &rfds); + } + if (interest&ZOOKEEPER_WRITE) { + FD_SET(fd, &wfds); + } else { + FD_CLR(fd, &wfds); + } + } + FD_SET( adaptor_threads->self_pipe[0] ,&rfds ); + rc = select((int)maxfd, &rfds, &wfds, &efds, &tv); + if (fd != -1) + { + interest = (FD_ISSET(fd, &rfds))? ZOOKEEPER_READ:0; + interest|= (FD_ISSET(fd, &wfds))? ZOOKEEPER_WRITE:0; + } + + if (FD_ISSET(adaptor_threads->self_pipe[0], &rfds)){ + // flush the pipe/socket + char b[128]; + while(recv(adaptor_threads->self_pipe[0],b,sizeof(b), 0)==sizeof(b)){} + } +#endif + // dispatch zookeeper events + zookeeper_process(zh, interest); + // check the current state of the zhandle and terminate + // if it is_unrecoverable() + if(is_unrecoverable(zh)) + break; + } + api_epilog(zh, 0); + LOG_DEBUG(("IO thread terminated")); + return 0; +} + +#ifdef WIN32 +unsigned __stdcall do_completion( void * v) +#else +void *do_completion(void *v) +#endif +{ + zhandle_t *zh = v; + api_prolog(zh); + notify_thread_ready(zh); + LOG_DEBUG(("started completion thread")); + while(!zh->close_requested) { + pthread_mutex_lock(&zh->completions_to_process.lock); + while(!zh->completions_to_process.head && !zh->close_requested) { + pthread_cond_wait(&zh->completions_to_process.cond, &zh->completions_to_process.lock); + } + pthread_mutex_unlock(&zh->completions_to_process.lock); + process_completions(zh); + } + api_epilog(zh, 0); + LOG_DEBUG(("completion thread terminated")); + return 0; +} + +int32_t inc_ref_counter(zhandle_t* zh,int i) +{ + int incr=(i<0?-1:(i>0?1:0)); + // fetch_and_add implements atomic post-increment + int v=fetch_and_add(&zh->ref_counter,incr); + // inc_ref_counter wants pre-increment + v+=incr; // simulate pre-increment + return v; +} + +int32_t fetch_and_add(volatile int32_t* operand, int incr) +{ +#ifndef WIN32 + return __sync_fetch_and_add(operand, incr); +#else + return InterlockedExchangeAdd(operand, incr); +#endif +} + +// make sure the static xid is initialized before any threads started +__attribute__((constructor)) int32_t get_xid() +{ + static int32_t xid = -1; + if (xid == -1) { + xid = time(0); + } + return fetch_and_add(&xid,1); +} + +int enter_critical(zhandle_t* zh) +{ + struct adaptor_threads *adaptor = zh->adaptor_priv; + if (adaptor) { + return pthread_mutex_lock(&adaptor->zh_lock); + } else { + return 0; + } +} + +int leave_critical(zhandle_t* zh) +{ + struct adaptor_threads *adaptor = zh->adaptor_priv; + if (adaptor) { + return pthread_mutex_unlock(&adaptor->zh_lock); + } else { + return 0; + } +} diff --git a/src/c/src/recordio.c b/src/c/src/recordio.c new file mode 100644 index 0000000..0fcf48e --- /dev/null +++ b/src/c/src/recordio.c @@ -0,0 +1,366 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#include +#include +#include +#include +#include +#ifndef WIN32 +#include +#else +#include /* for _htonl and _ntohl */ +#endif + +void deallocate_String(char **s) +{ + if (*s) + free(*s); + *s = 0; +} + +void deallocate_Buffer(struct buffer *b) +{ + if (b->buff) + free(b->buff); + b->buff = 0; +} + +struct buff_struct { + int32_t len; + int32_t off; + char *buffer; +}; + +static int resize_buffer(struct buff_struct *s, int newlen) +{ + char *buffer= NULL; + while (s->len < newlen) { + s->len *= 2; + } + buffer = (char*)realloc(s->buffer, s->len); + if (!buffer) { + s->buffer = 0; + return -ENOMEM; + } + s->buffer = buffer; + return 0; +} + +int oa_start_record(struct oarchive *oa, const char *tag) +{ + return 0; +} +int oa_end_record(struct oarchive *oa, const char *tag) +{ + return 0; +} +int oa_serialize_int(struct oarchive *oa, const char *tag, const int32_t *d) +{ + struct buff_struct *priv = oa->priv; + int32_t i = htonl(*d); + if ((priv->len - priv->off) < sizeof(i)) { + int rc = resize_buffer(priv, priv->len + sizeof(i)); + if (rc < 0) return rc; + } + memcpy(priv->buffer+priv->off, &i, sizeof(i)); + priv->off+=sizeof(i); + return 0; +} +int64_t zoo_htonll(int64_t v) +{ + int i = 0; + char *s = (char *)&v; + if (htonl(1) == 1) { + return v; + } + for (i = 0; i < 4; i++) { + int tmp = s[i]; + s[i] = s[8-i-1]; + s[8-i-1] = tmp; + } + + return v; +} + +int oa_serialize_long(struct oarchive *oa, const char *tag, const int64_t *d) +{ + const int64_t i = zoo_htonll(*d); + struct buff_struct *priv = oa->priv; + if ((priv->len - priv->off) < sizeof(i)) { + int rc = resize_buffer(priv, priv->len + sizeof(i)); + if (rc < 0) return rc; + } + memcpy(priv->buffer+priv->off, &i, sizeof(i)); + priv->off+=sizeof(i); + return 0; +} +int oa_start_vector(struct oarchive *oa, const char *tag, const int32_t *count) +{ + return oa_serialize_int(oa, tag, count); +} +int oa_end_vector(struct oarchive *oa, const char *tag) +{ + return 0; +} +int oa_serialize_bool(struct oarchive *oa, const char *name, const int32_t *i) +{ + //return oa_serialize_int(oa, name, i); + struct buff_struct *priv = oa->priv; + if ((priv->len - priv->off) < 1) { + int rc = resize_buffer(priv, priv->len + 1); + if (rc < 0) + return rc; + } + priv->buffer[priv->off] = (*i == 0 ? '\0' : '\1'); + priv->off++; + return 0; +} +static const int32_t negone = -1; +int oa_serialize_buffer(struct oarchive *oa, const char *name, + const struct buffer *b) +{ + struct buff_struct *priv = oa->priv; + int rc; + if (!b) { + return oa_serialize_int(oa, "len", &negone); + } + rc = oa_serialize_int(oa, "len", &b->len); + if (rc < 0) + return rc; + // this means a buffer of NUll + // with size of -1. This is + // waht we use in java serialization for NULL + if (b->len == -1) { + return rc; + } + if ((priv->len - priv->off) < b->len) { + rc = resize_buffer(priv, priv->len + b->len); + if (rc < 0) + return rc; + } + memcpy(priv->buffer+priv->off, b->buff, b->len); + priv->off += b->len; + return 0; +} +int oa_serialize_string(struct oarchive *oa, const char *name, char **s) +{ + struct buff_struct *priv = oa->priv; + int32_t len; + int rc; + if (!*s) { + oa_serialize_int(oa, "len", &negone); + return 0; + } + len = strlen(*s); + rc = oa_serialize_int(oa, "len", &len); + if (rc < 0) + return rc; + if ((priv->len - priv->off) < len) { + rc = resize_buffer(priv, priv->len + len); + if (rc < 0) + return rc; + } + memcpy(priv->buffer+priv->off, *s, len); + priv->off += len; + return 0; +} +int ia_start_record(struct iarchive *ia, const char *tag) +{ + return 0; +} +int ia_end_record(struct iarchive *ia, const char *tag) +{ + return 0; +} +int ia_deserialize_int(struct iarchive *ia, const char *tag, int32_t *count) +{ + struct buff_struct *priv = ia->priv; + if ((priv->len - priv->off) < sizeof(*count)) { + return -E2BIG; + } + memcpy(count, priv->buffer+priv->off, sizeof(*count)); + priv->off+=sizeof(*count); + *count = ntohl(*count); + return 0; +} + +int ia_deserialize_long(struct iarchive *ia, const char *tag, int64_t *count) +{ + struct buff_struct *priv = ia->priv; + int64_t v = 0; + if ((priv->len - priv->off) < sizeof(*count)) { + return -E2BIG; + } + memcpy(count, priv->buffer+priv->off, sizeof(*count)); + priv->off+=sizeof(*count); + v = zoo_htonll(*count); // htonll and ntohll do the same + *count = v; + return 0; +} +int ia_start_vector(struct iarchive *ia, const char *tag, int32_t *count) +{ + return ia_deserialize_int(ia, tag, count); +} +int ia_end_vector(struct iarchive *ia, const char *tag) +{ + return 0; +} +int ia_deserialize_bool(struct iarchive *ia, const char *name, int32_t *v) +{ + struct buff_struct *priv = ia->priv; + //fprintf(stderr, "Deserializing bool %d\n", priv->off); + //return ia_deserialize_int(ia, name, v); + if ((priv->len - priv->off) < 1) { + return -E2BIG; + } + *v = priv->buffer[priv->off]; + priv->off+=1; + //fprintf(stderr, "Deserializing bool end %d\n", priv->off); + return 0; +} +int ia_deserialize_buffer(struct iarchive *ia, const char *name, + struct buffer *b) +{ + struct buff_struct *priv = ia->priv; + int rc = ia_deserialize_int(ia, "len", &b->len); + if (rc < 0) + return rc; + if ((priv->len - priv->off) < b->len) { + return -E2BIG; + } + // set the buffer to null + if (b->len == -1) { + b->buff = NULL; + return rc; + } + b->buff = malloc(b->len); + if (!b->buff) { + return -ENOMEM; + } + memcpy(b->buff, priv->buffer+priv->off, b->len); + priv->off += b->len; + return 0; +} +int ia_deserialize_string(struct iarchive *ia, const char *name, char **s) +{ + struct buff_struct *priv = ia->priv; + int32_t len; + int rc = ia_deserialize_int(ia, "len", &len); + if (rc < 0) + return rc; + if ((priv->len - priv->off) < len) { + return -E2BIG; + } + if (len < 0) { + return -EINVAL; + } + *s = malloc(len+1); + if (!*s) { + return -ENOMEM; + } + memcpy(*s, priv->buffer+priv->off, len); + (*s)[len] = '\0'; + priv->off += len; + return 0; +} + +static struct iarchive ia_default = { STRUCT_INITIALIZER (start_record ,ia_start_record), + STRUCT_INITIALIZER (end_record ,ia_end_record), STRUCT_INITIALIZER (start_vector , ia_start_vector), + STRUCT_INITIALIZER (end_vector ,ia_end_vector), STRUCT_INITIALIZER (deserialize_Bool , ia_deserialize_bool), + STRUCT_INITIALIZER (deserialize_Int ,ia_deserialize_int), + STRUCT_INITIALIZER (deserialize_Long , ia_deserialize_long) , + STRUCT_INITIALIZER (deserialize_Buffer, ia_deserialize_buffer), + STRUCT_INITIALIZER (deserialize_String, ia_deserialize_string) }; + +static struct oarchive oa_default = { STRUCT_INITIALIZER (start_record , oa_start_record), + STRUCT_INITIALIZER (end_record , oa_end_record), STRUCT_INITIALIZER (start_vector , oa_start_vector), + STRUCT_INITIALIZER (end_vector , oa_end_vector), STRUCT_INITIALIZER (serialize_Bool , oa_serialize_bool), + STRUCT_INITIALIZER (serialize_Int , oa_serialize_int), + STRUCT_INITIALIZER (serialize_Long , oa_serialize_long) , + STRUCT_INITIALIZER (serialize_Buffer , oa_serialize_buffer), + STRUCT_INITIALIZER (serialize_String , oa_serialize_string) }; + +struct iarchive *create_buffer_iarchive(char *buffer, int len) +{ + struct iarchive *ia; + struct buff_struct *buff; + ia = malloc(sizeof(*ia)); + if (!ia) return 0; + buff = malloc(sizeof(struct buff_struct)); + if (!buff) { + free(ia); + return 0; + } + *ia = ia_default; + buff->off = 0; + buff->buffer = buffer; + buff->len = len; + ia->priv = buff; + return ia; +} + +struct oarchive *create_buffer_oarchive() +{ + struct oarchive *oa; + struct buff_struct *buff; + oa = malloc(sizeof(*oa)); + if (!oa) return 0; + buff = malloc(sizeof(struct buff_struct)); + if (!buff) { + free(oa); + return 0; + } + *oa = oa_default; + buff->off = 0; + buff->buffer = malloc(128); + buff->len = 128; + oa->priv = buff; + return oa; +} + +void close_buffer_iarchive(struct iarchive **ia) +{ + free((*ia)->priv); + free(*ia); + *ia = 0; +} + +void close_buffer_oarchive(struct oarchive **oa, int free_buffer) +{ + if (free_buffer) { + struct buff_struct *buff = (struct buff_struct *)(*oa)->priv; + if (buff->buffer) { + free(buff->buffer); + } + } + free((*oa)->priv); + free(*oa); + *oa = 0; +} + +char *get_buffer(struct oarchive *oa) +{ + struct buff_struct *buff = oa->priv; + return buff->buffer; +} +int get_buffer_len(struct oarchive *oa) +{ + struct buff_struct *buff = oa->priv; + return buff->off; +} diff --git a/src/c/src/st_adaptor.c b/src/c/src/st_adaptor.c new file mode 100644 index 0000000..23573b3 --- /dev/null +++ b/src/c/src/st_adaptor.c @@ -0,0 +1,113 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifndef DLL_EXPORT +# define USE_STATIC_LIB +#endif + +#include "zk_adaptor.h" +#include +#include + +int zoo_lock_auth(zhandle_t *zh) +{ + return 0; +} +int zoo_unlock_auth(zhandle_t *zh) +{ + return 0; +} +int lock_buffer_list(buffer_head_t *l) +{ + return 0; +} +int unlock_buffer_list(buffer_head_t *l) +{ + return 0; +} +int lock_completion_list(completion_head_t *l) +{ + return 0; +} +int unlock_completion_list(completion_head_t *l) +{ + return 0; +} +struct sync_completion *alloc_sync_completion(void) +{ + return (struct sync_completion*)calloc(1, sizeof(struct sync_completion)); +} +int wait_sync_completion(struct sync_completion *sc) +{ + return 0; +} + +void free_sync_completion(struct sync_completion *sc) +{ + free(sc); +} + +void notify_sync_completion(struct sync_completion *sc) +{ +} + +int process_async(int outstanding_sync) +{ + return outstanding_sync == 0; +} + +int adaptor_init(zhandle_t *zh) +{ + return 0; +} + +void adaptor_finish(zhandle_t *zh){} + +void adaptor_destroy(zhandle_t *zh){} + +int flush_send_queue(zhandle_t *, int); + +int adaptor_send_queue(zhandle_t *zh, int timeout) +{ + return flush_send_queue(zh, timeout); +} + +int32_t inc_ref_counter(zhandle_t* zh,int i) +{ + zh->ref_counter+=(i<0?-1:(i>0?1:0)); + return zh->ref_counter; +} + +int32_t get_xid() +{ + static int32_t xid = -1; + if (xid == -1) { + xid = time(0); + } + return xid++; +} + +int enter_critical(zhandle_t* zh) +{ + return 0; +} + +int leave_critical(zhandle_t* zh) +{ + return 0; +} diff --git a/src/c/src/winport.c b/src/c/src/winport.c new file mode 100644 index 0000000..3592ea1 --- /dev/null +++ b/src/c/src/winport.c @@ -0,0 +1,302 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifdef WIN32 +#include "winport.h" +#include +#include /* for int64_t */ +#include /* must always be included before ws2tcpip.h */ +#include /* for SOCKET */ + +int pthread_mutex_lock(pthread_mutex_t* _mutex ){ + int rc = WaitForSingleObject( *_mutex, // handle to mutex + INFINITE); // no time-out interval + return ((rc == WAIT_OBJECT_0) ? 0: rc); +} + +int pthread_mutex_unlock( pthread_mutex_t* _mutex ){ + int rc = ReleaseMutex(*_mutex); + return ((rc != 0)? 0: GetLastError()); +} + +int pthread_mutex_init(pthread_mutex_t* _mutex, void* ignoredAttr){ + //use CreateMutex as we are using the HANDLES in pthread_cond + *_mutex = CreateMutex( + NULL, // default security attributes + FALSE, // initially not owned + NULL); // unnamed mutex + return ((*_mutex == NULL) ? GetLastError() : 0); +} + +int pthread_mutex_destroy(pthread_mutex_t* _mutex) +{ + int rc = CloseHandle(*_mutex); + return ((rc != 0)? 0: GetLastError()); +} + +int pthread_create(pthread_t *thread, const pthread_attr_t *attr, unsigned (__stdcall* start_routine)(void* a), void *arg) +{ + int _intThreadId; + (*thread).thread_handle = (HANDLE)_beginthreadex( NULL, 0, start_routine , arg, 0, (unsigned int*)&_intThreadId ); + (*thread).thread_id = _intThreadId; + return (((*thread).thread_handle == 0 ) ? errno : 0 ); +} + + +int pthread_equal(pthread_t t1, pthread_t t2){ +//Is there a better way to do this? GetThreadId(handle) is only supported Windows 2003 n above. + return ((t1.thread_id == t2.thread_id) ? 1:0); +} + +pthread_t pthread_self(){ + pthread_t thread_self; + thread_self.thread_handle = GetCurrentThread(); + thread_self.thread_id = GetCurrentThreadId(); + return thread_self; +} + +int pthread_join(pthread_t _thread, void** ignore) +{ + int rc = WaitForSingleObject( _thread.thread_handle, INFINITE ); + return ((rc == WAIT_OBJECT_0) ? 0: rc); +} + +int pthread_detach(pthread_t _thread) +{ + int rc = CloseHandle(_thread.thread_handle) ; + return (rc != 0) ? 0: GetLastError(); +} + +void pthread_mutexattr_init(pthread_mutexattr_t* ignore){} +void pthread_mutexattr_settype(pthread_mutexattr_t* ingore_attr, int ignore){} +void pthread_mutexattr_destroy(pthread_mutexattr_t* ignore_attr){} + +int +pthread_cond_init (pthread_cond_t *cv, + const pthread_condattr_t * ignore) +{ + cv->waiters_count_ = 0; + cv->was_broadcast_ = 0; + cv->sema_ = CreateSemaphore (NULL, // no security + 0, // initially 0 + 0x7fffffff, // max count + NULL); // unnamed + if (cv->sema_ == NULL ) + return GetLastError(); + InitializeCriticalSection (&cv->waiters_count_lock_); + cv->waiters_done_ = CreateEvent (NULL, // no security + FALSE, // auto-reset + FALSE, // non-signaled initially + NULL); // unnamed + return (cv->waiters_done_ == NULL) ? GetLastError() : 0; + +} + + +int pthread_cond_destroy(pthread_cond_t *cond) +{ + CloseHandle( cond->sema_); + DeleteCriticalSection(&cond->waiters_count_lock_); + return (CloseHandle( cond->waiters_done_ ) == 0)? GetLastError(): 0 ; +} + + +int +pthread_cond_signal (pthread_cond_t *cv) +{ + int have_waiters; + EnterCriticalSection (& (cv->waiters_count_lock_)); + have_waiters = cv->waiters_count_ > 0; + LeaveCriticalSection (&cv->waiters_count_lock_); + + // If there aren't any waiters, then this is a no-op. + if (have_waiters){ + return (ReleaseSemaphore (cv->sema_, 1, 0) == 0 ) ? GetLastError() : 0 ; + }else + return 0; +} + + +int +pthread_cond_broadcast (pthread_cond_t *cv) +{ + // This is needed to ensure that and are + // consistent relative to each other. + int have_waiters = 0; + EnterCriticalSection (&cv->waiters_count_lock_); + + if (cv->waiters_count_ > 0) { + // We are broadcasting, even if there is just one waiter... + // Record that we are broadcasting, which helps optimize + // for the non-broadcast case. + cv->was_broadcast_ = 1; + have_waiters = 1; + } + + if (have_waiters) { + // Wake up all the waiters atomically. + ReleaseSemaphore (cv->sema_, cv->waiters_count_, 0); + + LeaveCriticalSection (&cv->waiters_count_lock_); + + // Wait for all the awakened threads to acquire the counting + // semaphore. + WaitForSingleObject (cv->waiters_done_, INFINITE); + // This assignment is okay, even without the held + // because no other waiter threads can wake up to access it. + cv->was_broadcast_ = 0; + } + else + LeaveCriticalSection (&cv->waiters_count_lock_); +} + + +int +pthread_cond_wait (pthread_cond_t *cv, + pthread_mutex_t *external_mutex) +{ + int last_waiter; + // Avoid race conditions. + EnterCriticalSection (&cv->waiters_count_lock_); + cv->waiters_count_++; + LeaveCriticalSection (&cv->waiters_count_lock_); + + // This call atomically releases the mutex and waits on the + // semaphore until or + // are called by another thread. + SignalObjectAndWait (*external_mutex, cv->sema_, INFINITE, FALSE); + + // Reacquire lock to avoid race conditions. + EnterCriticalSection (&cv->waiters_count_lock_); + + // We're no longer waiting... + cv->waiters_count_--; + + // Check to see if we're the last waiter after . + last_waiter = cv->was_broadcast_ && cv->waiters_count_ == 0; + + LeaveCriticalSection (&cv->waiters_count_lock_); + + // If we're the last waiter thread during this particular broadcast + // then let all the other threads proceed. + if (last_waiter) + // This call atomically signals the event and waits until + // it can acquire the . This is required to ensure fairness. + SignalObjectAndWait (cv->waiters_done_, *external_mutex, INFINITE, FALSE); + else + // Always regain the external mutex since that's the guarantee we + // give to our callers. + WaitForSingleObject (*external_mutex, INFINITE); +} + +int pthread_key_create(pthread_key_t *key, void (*destructor)(void *) ) +{ + int result = 0; + pthread_key_t* newkey; + + if ((newkey = (pthread_key_t*) calloc (1, sizeof (pthread_key_t))) == NULL) + { + result = ENOMEM; + } + else if ((newkey->key = TlsAlloc ()) == TLS_OUT_OF_INDEXES) + { + result = EAGAIN; + free (newkey); + newkey = NULL; + } + else if (destructor != NULL) + { + //--we have to store the function pointer for destructor, so that we can call it + //--to free up the user allocated storage-- + newkey->destructor = destructor; + } + key = newkey; + return (result); +} + +int pthread_key_delete(pthread_key_t key) +{ + int rc = 0; + LPVOID lpvData = TlsGetValue(key.key); + rc = TlsFree (key.key); + rc = (rc != 0 ) ? 0 : GetLastError(); + if (key.destructor != NULL && lpvData != 0){ + key.destructor(lpvData); //we take control of calling destructor, instead of calling it on thread exit. + } + free (&key); + return (rc); +} + +void *pthread_getspecific(pthread_key_t key) +{ + LPVOID lpvData = TlsGetValue(key.key); + if ((lpvData == 0) && (GetLastError() != ERROR_SUCCESS)) + return NULL; + else + return lpvData; +} + +int pthread_setspecific(pthread_key_t key, const void *value) +{ + int rc = TlsSetValue (key.key, value); + return ((rc != 0 ) ? 0 : GetLastError()); +} + +int gettimeofday(struct timeval *tp, void *tzp) { + int64_t now = 0; + if (tzp != 0) { errno = EINVAL; return -1; } + GetSystemTimeAsFileTime( (LPFILETIME)&now ); + tp->tv_sec = (long)(now / 10000000 - 11644473600LL); + tp->tv_usec = (now / 10) % 1000000; + return 0; +} + +int close(SOCKET fd) { + return closesocket(fd); +} + +int Win32WSAStartup() +{ + WORD wVersionRq; + WSADATA wsaData; + int err; + + wVersionRq = MAKEWORD(2,0); + err = WSAStartup(wVersionRq, &wsaData); + if (err != 0) + return 1; + + // confirm the version information + if ((LOBYTE(wsaData.wVersion) != 2) || + (HIBYTE(wsaData.wVersion) != 0)) + { + Win32WSACleanup(); + return 1; + } + return 0; +} + +void Win32WSACleanup() +{ + WSACleanup(); +} + +#endif //WIN32 + + + diff --git a/src/c/src/winport.h b/src/c/src/winport.h new file mode 100644 index 0000000..da6028c --- /dev/null +++ b/src/c/src/winport.h @@ -0,0 +1,138 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +/** + * This header file is to port pthread lib , sockets and other utility methods on windows. + * Specifically the threads function, mutexes, keys, and socket initialization. + */ + +#ifndef WINPORT_H_ +#define WINPORT_H_ + +#ifdef WIN32 +#include "winconfig.h" + +#define _WINSOCK_DEPRECATED_NO_WARNINGS +#include /* must always be included before ws2tcpip.h */ +#include /* for struct sock_addr used in zookeeper.h */ + +/* POSIX names are deprecated, use ISO conformant names instead. */ +#define strdup _strdup +#define getcwd _getcwd +#define getpid _getpid + +/* Windows "secure" versions of POSIX reentrant functions */ +#define strtok_r strtok_s +#define localtime_r(a,b) localtime_s(b,a) + +/* After this version of MSVC, snprintf became a defined function, + and so cannot be redefined, nor can #ifndef be used to guard it. */ +#if ((defined(_MSC_VER) && _MSC_VER < 1900) || !defined(_MSC_VER)) +#define snprintf _snprintf +#endif + + +#include +#include +#include /* for int64_t */ +#include +#include + + +typedef int ssize_t; +typedef HANDLE pthread_mutex_t; + +struct pthread_t_ +{ + HANDLE thread_handle; + DWORD thread_id; +}; + +typedef struct pthread_t_ pthread_t; +typedef int pthread_mutexattr_t; +typedef int pthread_condattr_t; +typedef int pthread_attr_t; +#define PTHREAD_MUTEX_RECURSIVE 0 + +int pthread_mutex_lock(pthread_mutex_t* _mutex ); +int pthread_mutex_unlock( pthread_mutex_t* _mutex ); +int pthread_mutex_init(pthread_mutex_t* _mutex, void* ignoredAttr); +int pthread_mutex_destroy(pthread_mutex_t* _mutex); +int pthread_create(pthread_t *thread, const pthread_attr_t *attr, unsigned (__stdcall* start_routine)(void* a), void *arg); +int pthread_equal(pthread_t t1, pthread_t t2); +pthread_t pthread_self(); +int pthread_join(pthread_t _thread, void** ignore); +int pthread_detach(pthread_t _thread); + +void pthread_mutexattr_init(pthread_mutexattr_t* ignore); +void pthread_mutexattr_settype(pthread_mutexattr_t* ingore_attr, int ignore); +void pthread_mutexattr_destroy(pthread_mutexattr_t* ignore_attr); + + +// http://www.cs.wustl.edu/~schmidt/win32-cv-1.html + +typedef struct +{ + int waiters_count_; + // Number of waiting threads. + + CRITICAL_SECTION waiters_count_lock_; + // Serialize access to . + + HANDLE sema_; + // Semaphore used to queue up threads waiting for the condition to + // become signaled. + + HANDLE waiters_done_; + // An auto-reset event used by the broadcast/signal thread to wait + // for all the waiting thread(s) to wake up and be released from the + // semaphore. + + size_t was_broadcast_; + // Keeps track of whether we were broadcasting or signaling. This + // allows us to optimize the code if we're just signaling. +}pthread_cond_t; + +int pthread_cond_init (pthread_cond_t *cv,const pthread_condattr_t * ignore); +int pthread_cond_destroy(pthread_cond_t *cond); +int pthread_cond_signal (pthread_cond_t *cv); +int pthread_cond_broadcast (pthread_cond_t *cv); +int pthread_cond_wait (pthread_cond_t *cv, pthread_mutex_t *external_mutex); + + +struct pthread_key_t_ +{ + DWORD key; + void (*destructor) (void *); +}; + +typedef struct pthread_key_t_ pthread_key_t; +int pthread_key_create(pthread_key_t *key, void (*destructor)(void *) ); +int pthread_key_delete(pthread_key_t key); +void *pthread_getspecific(pthread_key_t key); +int pthread_setspecific(pthread_key_t key, const void *value); + +int gettimeofday(struct timeval *tp, void *tzp); +int close(SOCKET fd); +int Win32WSAStartup(); +void Win32WSACleanup(); +#endif //WIN32 + + + +#endif //WINPORT_H_ diff --git a/src/c/src/zk_adaptor.h b/src/c/src/zk_adaptor.h new file mode 100644 index 0000000..b990779 --- /dev/null +++ b/src/c/src/zk_adaptor.h @@ -0,0 +1,276 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifndef ZK_ADAPTOR_H_ +#define ZK_ADAPTOR_H_ +#include +#ifdef THREADED +#ifndef WIN32 +#include +#else +#include "winport.h" +#endif +#endif +#include "zookeeper.h" +#include "zk_hashtable.h" + +/* predefined xid's values recognized as special by the server */ +#define WATCHER_EVENT_XID -1 +#define PING_XID -2 +#define AUTH_XID -4 +#define SET_WATCHES_XID -8 + +/* zookeeper state constants */ +#define EXPIRED_SESSION_STATE_DEF -112 +#define AUTH_FAILED_STATE_DEF -113 +#define CONNECTING_STATE_DEF 1 +#define ASSOCIATING_STATE_DEF 2 +#define CONNECTED_STATE_DEF 3 +#define NOTCONNECTED_STATE_DEF 999 + +/* zookeeper event type constants */ +#define CREATED_EVENT_DEF 1 +#define DELETED_EVENT_DEF 2 +#define CHANGED_EVENT_DEF 3 +#define CHILD_EVENT_DEF 4 +#define SESSION_EVENT_DEF -1 +#define NOTWATCHING_EVENT_DEF -2 + +#ifdef __cplusplus +extern "C" { +#endif + +struct _buffer_list; +struct _completion_list; + +typedef struct _buffer_head { + struct _buffer_list *volatile head; + struct _buffer_list *last; +#ifdef THREADED + pthread_mutex_t lock; +#endif +} buffer_head_t; + +typedef struct _completion_head { + struct _completion_list *volatile head; + struct _completion_list *last; +#ifdef THREADED + pthread_cond_t cond; + pthread_mutex_t lock; +#endif +} completion_head_t; + +int lock_buffer_list(buffer_head_t *l); +int unlock_buffer_list(buffer_head_t *l); +int lock_completion_list(completion_head_t *l); +int unlock_completion_list(completion_head_t *l); + +struct sync_completion { + int rc; + union { + struct { + char *str; + int str_len; + } str; + struct Stat stat; + struct { + char *buffer; + int buff_len; + struct Stat stat; + } data; + struct { + struct ACL_vector acl; + struct Stat stat; + } acl; + struct String_vector strs2; + struct { + struct String_vector strs2; + struct Stat stat2; + } strs_stat; + } u; + int complete; +#ifdef THREADED + pthread_cond_t cond; + pthread_mutex_t lock; +#endif +}; + +typedef struct _auth_info { + int state; /* 0=>inactive, >0 => active */ + char* scheme; + struct buffer auth; + void_completion_t completion; + const char* data; + struct _auth_info *next; +} auth_info; + +/** + * This structure represents a packet being read or written. + */ +typedef struct _buffer_list { + char *buffer; + int len; /* This represents the length of sizeof(header) + length of buffer */ + int curr_offset; /* This is the offset into the header followed by offset into the buffer */ + struct _buffer_list *next; +} buffer_list_t; + +/* the size of connect request */ +#define HANDSHAKE_REQ_SIZE 44 +/* connect request */ +struct connect_req { + int32_t protocolVersion; + int64_t lastZxidSeen; + int32_t timeOut; + int64_t sessionId; + int32_t passwd_len; + char passwd[16]; +}; + +/* the connect response */ +struct prime_struct { + int32_t len; + int32_t protocolVersion; + int32_t timeOut; + int64_t sessionId; + int32_t passwd_len; + char passwd[16]; +}; + +#ifdef THREADED +/* this is used by mt_adaptor internally for thread management */ +struct adaptor_threads { + pthread_t io; + pthread_t completion; + int threadsToWait; // barrier + pthread_cond_t cond; // barrier's conditional + pthread_mutex_t lock; // ... and a lock + pthread_mutex_t zh_lock; // critical section lock +#ifdef WIN32 + SOCKET self_pipe[2]; +#else + int self_pipe[2]; +#endif +}; +#endif + +/** the auth list for adding auth */ +typedef struct _auth_list_head { + auth_info *auth; +#ifdef THREADED + pthread_mutex_t lock; +#endif +} auth_list_head_t; + +/** + * This structure represents the connection to zookeeper. + */ + +struct _zhandle { +#ifdef WIN32 + SOCKET fd; /* the descriptor used to talk to zookeeper */ +#else + int fd; /* the descriptor used to talk to zookeeper */ +#endif + char *hostname; /* the hostname of zookeeper */ + struct sockaddr_storage *addrs; /* the addresses that correspond to the hostname */ + int addrs_count; /* The number of addresses in the addrs array */ + watcher_fn watcher; /* the registered watcher */ + struct timeval last_recv; /* The time that the last message was received */ + struct timeval last_send; /* The time that the last message was sent */ + struct timeval last_ping; /* The time that the last PING was sent */ + struct timeval next_deadline; /* The time of the next deadline */ + int recv_timeout; /* The maximum amount of time that can go by without + receiving anything from the zookeeper server */ + buffer_list_t *input_buffer; /* the current buffer being read in */ + buffer_head_t to_process; /* The buffers that have been read and are ready to be processed. */ + buffer_head_t to_send; /* The packets queued to send */ + completion_head_t sent_requests; /* The outstanding requests */ + completion_head_t completions_to_process; /* completions that are ready to run */ + int connect_index; /* The index of the address to connect to */ + clientid_t client_id; + long long last_zxid; + int outstanding_sync; /* Number of outstanding synchronous requests */ + struct _buffer_list primer_buffer; /* The buffer used for the handshake at the start of a connection */ + struct prime_struct primer_storage; /* the connect response */ + char primer_storage_buffer[40]; /* the true size of primer_storage */ + volatile int state; + void *context; + auth_list_head_t auth_h; /* authentication data list */ + /* zookeeper_close is not reentrant because it de-allocates the zhandler. + * This guard variable is used to defer the destruction of zhandle till + * right before top-level API call returns to the caller */ + int32_t ref_counter; + volatile int close_requested; + void *adaptor_priv; + /* Used for debugging only: non-zero value indicates the time when the zookeeper_process + * call returned while there was at least one unprocessed server response + * available in the socket recv buffer */ + struct timeval socket_readable; + + zk_hashtable* active_node_watchers; + zk_hashtable* active_exist_watchers; + zk_hashtable* active_child_watchers; + /** used for chroot path at the client side **/ + char *chroot; +}; + + +int adaptor_init(zhandle_t *zh); +void adaptor_finish(zhandle_t *zh); +void adaptor_destroy(zhandle_t *zh); +struct sync_completion *alloc_sync_completion(void); +int wait_sync_completion(struct sync_completion *sc); +void free_sync_completion(struct sync_completion *sc); +void notify_sync_completion(struct sync_completion *sc); +int adaptor_send_queue(zhandle_t *zh, int timeout); +int process_async(int outstanding_sync); +void process_completions(zhandle_t *zh); +int flush_send_queue(zhandle_t*zh, int timeout); +char* sub_string(zhandle_t *zh, const char* server_path); +void free_duplicate_path(const char* free_path, const char* path); +int zoo_lock_auth(zhandle_t *zh); +int zoo_unlock_auth(zhandle_t *zh); + +// critical section guards +int enter_critical(zhandle_t* zh); +int leave_critical(zhandle_t* zh); +// zhandle object reference counting +void api_prolog(zhandle_t* zh); +int api_epilog(zhandle_t *zh, int rc); +int32_t get_xid(); +// returns the new value of the ref counter +int32_t inc_ref_counter(zhandle_t* zh,int i); + +#ifdef THREADED +// atomic post-increment +int32_t fetch_and_add(volatile int32_t* operand, int incr); +// in mt mode process session event asynchronously by the completion thread +#define PROCESS_SESSION_EVENT(zh,newstate) queue_session_event(zh,newstate) +#else +// in single-threaded mode process session event immediately +//#define PROCESS_SESSION_EVENT(zh,newstate) deliverWatchers(zh,ZOO_SESSION_EVENT,newstate,0) +#define PROCESS_SESSION_EVENT(zh,newstate) queue_session_event(zh,newstate) +#endif + +#ifdef __cplusplus +} +#endif + +#endif /*ZK_ADAPTOR_H_*/ + + diff --git a/src/c/src/zk_hashtable.c b/src/c/src/zk_hashtable.c new file mode 100644 index 0000000..0efc5aa --- /dev/null +++ b/src/c/src/zk_hashtable.c @@ -0,0 +1,337 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#include "zk_hashtable.h" +#include "zk_adaptor.h" +#include "hashtable/hashtable.h" +#include "hashtable/hashtable_itr.h" +#include +#include +#include + +typedef struct _watcher_object { + watcher_fn watcher; + void* context; + struct _watcher_object* next; +} watcher_object_t; + + +struct _zk_hashtable { + struct hashtable* ht; +}; + +struct watcher_object_list { + watcher_object_t* head; +}; + +/* the following functions are for testing only */ +typedef struct hashtable hashtable_impl; + +hashtable_impl* getImpl(zk_hashtable* ht){ + return ht->ht; +} + +watcher_object_t* getFirstWatcher(zk_hashtable* ht,const char* path) +{ + watcher_object_list_t* wl=hashtable_search(ht->ht,(void*)path); + if(wl!=0) + return wl->head; + return 0; +} +/* end of testing functions */ + +watcher_object_t* clone_watcher_object(watcher_object_t* wo) +{ + watcher_object_t* res=calloc(1,sizeof(watcher_object_t)); + assert(res); + res->watcher=wo->watcher; + res->context=wo->context; + return res; +} + +static unsigned int string_hash_djb2(void *str) +{ + unsigned int hash = 5381; + int c; + const char* cstr = (const char*)str; + while ((c = *cstr++)) + hash = ((hash << 5) + hash) + c; /* hash * 33 + c */ + + return hash; +} + +static int string_equal(void *key1,void *key2) +{ + return strcmp((const char*)key1,(const char*)key2)==0; +} + +static watcher_object_t* create_watcher_object(watcher_fn watcher,void* ctx) +{ + watcher_object_t* wo=calloc(1,sizeof(watcher_object_t)); + assert(wo); + wo->watcher=watcher; + wo->context=ctx; + return wo; +} + +static watcher_object_list_t* create_watcher_object_list(watcher_object_t* head) +{ + watcher_object_list_t* wl=calloc(1,sizeof(watcher_object_list_t)); + assert(wl); + wl->head=head; + return wl; +} + +static void destroy_watcher_object_list(watcher_object_list_t* list) +{ + watcher_object_t* e = NULL; + + if(list==0) + return; + e=list->head; + while(e!=0){ + watcher_object_t* this=e; + e=e->next; + free(this); + } + free(list); +} + +zk_hashtable* create_zk_hashtable() +{ + struct _zk_hashtable *ht=calloc(1,sizeof(struct _zk_hashtable)); + assert(ht); + ht->ht=create_hashtable(32,string_hash_djb2,string_equal); + return ht; +} + +static void do_clean_hashtable(zk_hashtable* ht) +{ + struct hashtable_itr *it; + int hasMore; + if(hashtable_count(ht->ht)==0) + return; + it=hashtable_iterator(ht->ht); + do { + watcher_object_list_t* w=hashtable_iterator_value(it); + destroy_watcher_object_list(w); + hasMore=hashtable_iterator_remove(it); + } while(hasMore); + free(it); +} + +void destroy_zk_hashtable(zk_hashtable* ht) +{ + if(ht!=0){ + do_clean_hashtable(ht); + hashtable_destroy(ht->ht,0); + free(ht); + } +} + +// searches for a watcher object instance in a watcher object list; +// two watcher objects are equal if their watcher function and context pointers +// are equal +static watcher_object_t* search_watcher(watcher_object_list_t** wl,watcher_object_t* wo) +{ + watcher_object_t* wobj=(*wl)->head; + while(wobj!=0){ + if(wobj->watcher==wo->watcher && wobj->context==wo->context) + return wobj; + wobj=wobj->next; + } + return 0; +} + +static int add_to_list(watcher_object_list_t **wl, watcher_object_t *wo, + int clone) +{ + if (search_watcher(wl, wo)==0) { + watcher_object_t* cloned=wo; + if (clone) { + cloned = clone_watcher_object(wo); + assert(cloned); + } + cloned->next = (*wl)->head; + (*wl)->head = cloned; + return 1; + } else if (!clone) { + // If it's here and we aren't supposed to clone, we must destroy + free(wo); + } + return 0; +} + +static int do_insert_watcher_object(zk_hashtable *ht, const char *path, watcher_object_t* wo) +{ + int res=1; + watcher_object_list_t* wl; + + wl=hashtable_search(ht->ht,(void*)path); + if(wl==0){ + int res; + /* inserting a new path element */ + res=hashtable_insert(ht->ht,strdup(path),create_watcher_object_list(wo)); + assert(res); + }else{ + /* + * Path already exists; check if the watcher already exists. + * Don't clone the watcher since it's allocated on the heap --- avoids + * a memory leak and saves a clone operation (calloc + copy). + */ + res = add_to_list(&wl, wo, 0); + } + return res; +} + + +char **collect_keys(zk_hashtable *ht, int *count) +{ + char **list; + struct hashtable_itr *it; + int i; + + *count = hashtable_count(ht->ht); + list = calloc(*count, sizeof(char*)); + it=hashtable_iterator(ht->ht); + for(i = 0; i < *count; i++) { + list[i] = strdup(hashtable_iterator_key(it)); + hashtable_iterator_advance(it); + } + free(it); + return list; +} + +static int insert_watcher_object(zk_hashtable *ht, const char *path, + watcher_object_t* wo) +{ + int res; + res=do_insert_watcher_object(ht,path,wo); + return res; +} + +static void copy_watchers(watcher_object_list_t *from, watcher_object_list_t *to, int clone) +{ + watcher_object_t* wo=from->head; + while(wo){ + watcher_object_t *next = wo->next; + add_to_list(&to, wo, clone); + wo=next; + } +} + +static void copy_table(zk_hashtable *from, watcher_object_list_t *to) { + struct hashtable_itr *it; + int hasMore; + if(hashtable_count(from->ht)==0) + return; + it=hashtable_iterator(from->ht); + do { + watcher_object_list_t *w = hashtable_iterator_value(it); + copy_watchers(w, to, 1); + hasMore=hashtable_iterator_advance(it); + } while(hasMore); + free(it); +} + +static void collect_session_watchers(zhandle_t *zh, + watcher_object_list_t **list) +{ + copy_table(zh->active_node_watchers, *list); + copy_table(zh->active_exist_watchers, *list); + copy_table(zh->active_child_watchers, *list); +} + +static void add_for_event(zk_hashtable *ht, char *path, watcher_object_list_t **list) +{ + watcher_object_list_t* wl; + wl = (watcher_object_list_t*)hashtable_remove(ht->ht, path); + if (wl) { + copy_watchers(wl, *list, 0); + // Since we move, not clone the watch_objects, we just need to free the + // head pointer + free(wl); + } +} + +static void do_foreach_watcher(watcher_object_t* wo,zhandle_t* zh, + const char* path,int type,int state) +{ + // session event's don't have paths + const char *client_path = + (type != ZOO_SESSION_EVENT ? sub_string(zh, path) : path); + while(wo!=0){ + wo->watcher(zh,type,state,client_path,wo->context); + wo=wo->next; + } + free_duplicate_path(client_path, path); +} + +watcher_object_list_t *collectWatchers(zhandle_t *zh,int type, char *path) +{ + struct watcher_object_list *list = create_watcher_object_list(0); + + if(type==ZOO_SESSION_EVENT){ + watcher_object_t defWatcher; + defWatcher.watcher=zh->watcher; + defWatcher.context=zh->context; + add_to_list(&list, &defWatcher, 1); + collect_session_watchers(zh, &list); + return list; + } + switch(type){ + case CREATED_EVENT_DEF: + case CHANGED_EVENT_DEF: + // look up the watchers for the path and move them to a delivery list + add_for_event(zh->active_node_watchers,path,&list); + add_for_event(zh->active_exist_watchers,path,&list); + break; + case CHILD_EVENT_DEF: + // look up the watchers for the path and move them to a delivery list + add_for_event(zh->active_child_watchers,path,&list); + break; + case DELETED_EVENT_DEF: + // look up the watchers for the path and move them to a delivery list + add_for_event(zh->active_node_watchers,path,&list); + add_for_event(zh->active_exist_watchers,path,&list); + add_for_event(zh->active_child_watchers,path,&list); + break; + } + return list; +} + +void deliverWatchers(zhandle_t *zh, int type,int state, char *path, watcher_object_list_t **list) +{ + if (!list || !(*list)) return; + do_foreach_watcher((*list)->head, zh, path, type, state); + destroy_watcher_object_list(*list); + *list = 0; +} + +void activateWatcher(zhandle_t *zh, watcher_registration_t* reg, int rc) +{ + if(reg){ + /* in multithreaded lib, this code is executed + * by the IO thread */ + zk_hashtable *ht = reg->checker(zh, rc); + if(ht){ + insert_watcher_object(ht,reg->path, + create_watcher_object(reg->watcher, reg->context)); + } + } +} diff --git a/src/c/src/zk_hashtable.h b/src/c/src/zk_hashtable.h new file mode 100644 index 0000000..31109c1 --- /dev/null +++ b/src/c/src/zk_hashtable.h @@ -0,0 +1,69 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifndef ZK_HASHTABLE_H_ +#define ZK_HASHTABLE_H_ + +#include + +#ifdef __cplusplus +extern "C" { +#endif + + typedef struct watcher_object_list watcher_object_list_t; +typedef struct _zk_hashtable zk_hashtable; + +/** + * The function must return a non-zero value if the watcher object can be activated + * as a result of the server response. Normally, a watch can only be activated + * if the server returns a success code (ZOK). However in the case when zoo_exists() + * returns a ZNONODE code the watcher should be activated nevertheless. + */ +typedef zk_hashtable *(*result_checker_fn)(zhandle_t *, int rc); + +/** + * A watcher object gets temporarily stored with the completion entry until + * the server response comes back at which moment the watcher object is moved + * to the active watchers map. + */ +typedef struct _watcher_registration { + watcher_fn watcher; + void* context; + result_checker_fn checker; + const char* path; +} watcher_registration_t; + +zk_hashtable* create_zk_hashtable(); +void destroy_zk_hashtable(zk_hashtable* ht); + +char **collect_keys(zk_hashtable *ht, int *count); + +/** + * check if the completion has a watcher object associated + * with it. If it does, move the watcher object to the map of + * active watchers (only if the checker allows to do so) + */ + void activateWatcher(zhandle_t *zh, watcher_registration_t* reg, int rc); + watcher_object_list_t *collectWatchers(zhandle_t *zh,int type, char *path); + void deliverWatchers(zhandle_t *zh, int type, int state, char *path, struct watcher_object_list **list); + +#ifdef __cplusplus +} +#endif + +#endif /*ZK_HASHTABLE_H_*/ diff --git a/src/c/src/zk_log.c b/src/c/src/zk_log.c new file mode 100644 index 0000000..6b4fdfa --- /dev/null +++ b/src/c/src/zk_log.c @@ -0,0 +1,180 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#if !defined(DLL_EXPORT) && !defined(USE_STATIC_LIB) +# define USE_STATIC_LIB +#endif + +#include "zookeeper_log.h" +#ifndef WIN32 +#include +#else +typedef DWORD pid_t; +#include /* for getpid */ +#endif + +#include +#include + +#define TIME_NOW_BUF_SIZE 1024 +#define FORMAT_LOG_BUF_SIZE 4096 + +#ifdef THREADED +#ifndef WIN32 +#include +#else +#include "winport.h" +#endif + +static pthread_key_t time_now_buffer; +static pthread_key_t format_log_msg_buffer; + +void freeBuffer(void* p){ + if(p) free(p); +} + +__attribute__((constructor)) void prepareTSDKeys() { + pthread_key_create (&time_now_buffer, freeBuffer); + pthread_key_create (&format_log_msg_buffer, freeBuffer); +} + +char* getTSData(pthread_key_t key,int size){ + char* p=pthread_getspecific(key); + if(p==0){ + int res; + p=calloc(1,size); + res=pthread_setspecific(key,p); + if(res!=0){ + fprintf(stderr,"Failed to set TSD key: %d",res); + } + } + return p; +} + +char* get_time_buffer(){ + return getTSData(time_now_buffer,TIME_NOW_BUF_SIZE); +} + +char* get_format_log_buffer(){ + return getTSData(format_log_msg_buffer,FORMAT_LOG_BUF_SIZE); +} +#else +char* get_time_buffer(){ + static char buf[TIME_NOW_BUF_SIZE]; + return buf; +} + +char* get_format_log_buffer(){ + static char buf[FORMAT_LOG_BUF_SIZE]; + return buf; +} + +#endif + +ZooLogLevel logLevel=ZOO_LOG_LEVEL_INFO; + +static FILE* logStream=0; +FILE* getLogStream(){ + if(logStream==0) + logStream=stderr; + return logStream; +} + +void zoo_set_log_stream(FILE* stream){ + logStream=stream; +} + +static const char* time_now(char* now_str){ + struct timeval tv; + struct tm lt; + time_t now = 0; + size_t len = 0; + + gettimeofday(&tv,0); + + now = tv.tv_sec; + localtime_r(&now, <); + + // clone the format used by log4j ISO8601DateFormat + // specifically: "yyyy-MM-dd HH:mm:ss,SSS" + + len = strftime(now_str, TIME_NOW_BUF_SIZE, + "%Y-%m-%d %H:%M:%S", + <); + + len += snprintf(now_str + len, + TIME_NOW_BUF_SIZE - len, + ",%03d", + (int)(tv.tv_usec/1000)); + + return now_str; +} + +void log_message(ZooLogLevel curLevel,int line,const char* funcName, + const char* message) +{ + static const char* dbgLevelStr[]={"ZOO_INVALID","ZOO_ERROR","ZOO_WARN", + "ZOO_INFO","ZOO_DEBUG"}; + static pid_t pid=0; +#ifdef WIN32 + char timebuf [TIME_NOW_BUF_SIZE]; +#endif + if(pid==0)pid=getpid(); +#ifndef THREADED + // pid_t is long on Solaris + fprintf(LOGSTREAM, "%s:%ld:%s@%s@%d: %s\n", time_now(get_time_buffer()),(long)pid, + dbgLevelStr[curLevel],funcName,line,message); +#else +#ifdef WIN32 + fprintf(LOGSTREAM, "%s:%d(0x%lx):%s@%s@%d: %s\n", time_now(timebuf),pid, + (unsigned long int)(pthread_self().thread_id), + dbgLevelStr[curLevel],funcName,line,message); +#else + fprintf(LOGSTREAM, "%s:%ld(0x%lx):%s@%s@%d: %s\n", time_now(get_time_buffer()),(long)pid, + (unsigned long int)pthread_self(), + dbgLevelStr[curLevel],funcName,line,message); +#endif +#endif + fflush(LOGSTREAM); +} + +const char* format_log_message(const char* format,...) +{ + va_list va; + char* buf=get_format_log_buffer(); + if(!buf) + return "format_log_message: Unable to allocate memory buffer"; + + va_start(va,format); + vsnprintf(buf, FORMAT_LOG_BUF_SIZE-1,format,va); + va_end(va); + return buf; +} + +void zoo_set_debug_level(ZooLogLevel level) +{ + if(level==0){ + // disable logging (unit tests do this) + logLevel=(ZooLogLevel)0; + return; + } + if(levelZOO_LOG_LEVEL_DEBUG)level=ZOO_LOG_LEVEL_DEBUG; + logLevel=level; +} + diff --git a/src/c/src/zookeeper.c b/src/c/src/zookeeper.c new file mode 100644 index 0000000..c087864 --- /dev/null +++ b/src/c/src/zookeeper.c @@ -0,0 +1,3767 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#if !defined(DLL_EXPORT) && !defined(USE_STATIC_LIB) +# define USE_STATIC_LIB +#endif + +#if defined(__CYGWIN__) +#define USE_IPV6 +#endif + +#include "config.h" +#include +#include +#include +#include "zk_adaptor.h" +#include "zookeeper_log.h" +#include "zk_hashtable.h" + +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#ifdef HAVE_SYS_TIME_H +#include +#endif + +#ifdef HAVE_SYS_SOCKET_H +#include +#endif + +#ifdef HAVE_POLL +#include +#endif + +#ifdef HAVE_NETINET_IN_H +#include +#include +#endif + +#ifdef HAVE_ARPA_INET_H +#include +#endif + +#ifdef HAVE_NETDB_H +#include +#endif + +#ifdef HAVE_UNISTD_H +#include // needed for _POSIX_MONOTONIC_CLOCK +#endif + +#ifdef HAVE_SYS_UTSNAME_H +#include +#endif + +#ifdef HAVE_GETPWUID_R +#include +#endif + +#ifdef WIN32 +#define random rand /* replace POSIX random with Windows rand */ +#include /* for getpid */ +#include /* for getcwd */ +#define EAI_ADDRFAMILY WSAEINVAL /* is this still needed? */ +#define EHOSTDOWN EPIPE +#define ESTALE ENODEV +#endif + +#define IF_DEBUG(x) if(logLevel==ZOO_LOG_LEVEL_DEBUG) {x;} + +const int ZOOKEEPER_WRITE = 1 << 0; +const int ZOOKEEPER_READ = 1 << 1; + +const int ZOO_EPHEMERAL = 1 << 0; +const int ZOO_SEQUENCE = 1 << 1; + +const int ZOO_EXPIRED_SESSION_STATE = EXPIRED_SESSION_STATE_DEF; +const int ZOO_AUTH_FAILED_STATE = AUTH_FAILED_STATE_DEF; +const int ZOO_CONNECTING_STATE = CONNECTING_STATE_DEF; +const int ZOO_ASSOCIATING_STATE = ASSOCIATING_STATE_DEF; +const int ZOO_CONNECTED_STATE = CONNECTED_STATE_DEF; +static __attribute__ ((unused)) const char* state2String(int state){ + switch(state){ + case 0: + return "ZOO_CLOSED_STATE"; + case CONNECTING_STATE_DEF: + return "ZOO_CONNECTING_STATE"; + case ASSOCIATING_STATE_DEF: + return "ZOO_ASSOCIATING_STATE"; + case CONNECTED_STATE_DEF: + return "ZOO_CONNECTED_STATE"; + case EXPIRED_SESSION_STATE_DEF: + return "ZOO_EXPIRED_SESSION_STATE"; + case AUTH_FAILED_STATE_DEF: + return "ZOO_AUTH_FAILED_STATE"; + } + return "INVALID_STATE"; +} + +const int ZOO_CREATED_EVENT = CREATED_EVENT_DEF; +const int ZOO_DELETED_EVENT = DELETED_EVENT_DEF; +const int ZOO_CHANGED_EVENT = CHANGED_EVENT_DEF; +const int ZOO_CHILD_EVENT = CHILD_EVENT_DEF; +const int ZOO_SESSION_EVENT = SESSION_EVENT_DEF; +const int ZOO_NOTWATCHING_EVENT = NOTWATCHING_EVENT_DEF; +static __attribute__ ((unused)) const char* watcherEvent2String(int ev){ + switch(ev){ + case 0: + return "ZOO_ERROR_EVENT"; + case CREATED_EVENT_DEF: + return "ZOO_CREATED_EVENT"; + case DELETED_EVENT_DEF: + return "ZOO_DELETED_EVENT"; + case CHANGED_EVENT_DEF: + return "ZOO_CHANGED_EVENT"; + case CHILD_EVENT_DEF: + return "ZOO_CHILD_EVENT"; + case SESSION_EVENT_DEF: + return "ZOO_SESSION_EVENT"; + case NOTWATCHING_EVENT_DEF: + return "ZOO_NOTWATCHING_EVENT"; + } + return "INVALID_EVENT"; +} + +const int ZOO_PERM_READ = 1 << 0; +const int ZOO_PERM_WRITE = 1 << 1; +const int ZOO_PERM_CREATE = 1 << 2; +const int ZOO_PERM_DELETE = 1 << 3; +const int ZOO_PERM_ADMIN = 1 << 4; +const int ZOO_PERM_ALL = 0x1f; +struct Id ZOO_ANYONE_ID_UNSAFE = {"world", "anyone"}; +struct Id ZOO_AUTH_IDS = {"auth", ""}; +static struct ACL _OPEN_ACL_UNSAFE_ACL[] = {{0x1f, {"world", "anyone"}}}; +static struct ACL _READ_ACL_UNSAFE_ACL[] = {{0x01, {"world", "anyone"}}}; +static struct ACL _CREATOR_ALL_ACL_ACL[] = {{0x1f, {"auth", ""}}}; +struct ACL_vector ZOO_OPEN_ACL_UNSAFE = { 1, _OPEN_ACL_UNSAFE_ACL}; +struct ACL_vector ZOO_READ_ACL_UNSAFE = { 1, _READ_ACL_UNSAFE_ACL}; +struct ACL_vector ZOO_CREATOR_ALL_ACL = { 1, _CREATOR_ALL_ACL_ACL}; + +#define COMPLETION_WATCH -1 +#define COMPLETION_VOID 0 +#define COMPLETION_STAT 1 +#define COMPLETION_DATA 2 +#define COMPLETION_STRINGLIST 3 +#define COMPLETION_STRINGLIST_STAT 4 +#define COMPLETION_ACLLIST 5 +#define COMPLETION_STRING 6 +#define COMPLETION_MULTI 7 + +typedef struct _auth_completion_list { + void_completion_t completion; + const char *auth_data; + struct _auth_completion_list *next; +} auth_completion_list_t; + +typedef struct completion { + int type; /* one of COMPLETION_* values above */ + union { + void_completion_t void_result; + stat_completion_t stat_result; + data_completion_t data_result; + strings_completion_t strings_result; + strings_stat_completion_t strings_stat_result; + acl_completion_t acl_result; + string_completion_t string_result; + struct watcher_object_list *watcher_result; + }; + completion_head_t clist; /* For multi-op */ +} completion_t; + +typedef struct _completion_list { + int xid; + completion_t c; + const void *data; + buffer_list_t *buffer; + struct _completion_list *next; + watcher_registration_t* watcher; +} completion_list_t; + +const char*err2string(int err); +static int queue_session_event(zhandle_t *zh, int state); +static const char* format_endpoint_info(const struct sockaddr_storage* ep); +static const char* format_current_endpoint_info(zhandle_t* zh); + +/* deserialize forward declarations */ +static void deserialize_response(int type, int xid, int failed, int rc, completion_list_t *cptr, struct iarchive *ia); +static int deserialize_multi(int xid, completion_list_t *cptr, struct iarchive *ia); + +/* completion routine forward declarations */ +static int add_completion(zhandle_t *zh, int xid, int completion_type, + const void *dc, const void *data, int add_to_front, + watcher_registration_t* wo, completion_head_t *clist); +static completion_list_t* create_completion_entry(int xid, int completion_type, + const void *dc, const void *data, watcher_registration_t* wo, + completion_head_t *clist); +static void destroy_completion_entry(completion_list_t* c); +static void queue_completion_nolock(completion_head_t *list, completion_list_t *c, + int add_to_front); +static void queue_completion(completion_head_t *list, completion_list_t *c, + int add_to_front); +static int handle_socket_error_msg(zhandle_t *zh, int line, int rc, + const char* format,...); +static void cleanup_bufs(zhandle_t *zh,int callCompletion,int rc); + +static int disable_conn_permute=0; // permute enabled by default + +static __attribute__((unused)) void print_completion_queue(zhandle_t *zh); + +static void *SYNCHRONOUS_MARKER = (void*)&SYNCHRONOUS_MARKER; +static int isValidPath(const char* path, const int flags); + +#ifdef _WINDOWS +static int zookeeper_send(SOCKET s, const char* buf, int len) +#else +static ssize_t zookeeper_send(int s, const void* buf, size_t len) +#endif +{ +#ifdef __linux__ + return send(s, buf, len, MSG_NOSIGNAL); +#else + return send(s, buf, len, 0); +#endif +} + +const void *zoo_get_context(zhandle_t *zh) +{ + return zh->context; +} + +void zoo_set_context(zhandle_t *zh, void *context) +{ + if (zh != NULL) { + zh->context = context; + } +} + +int zoo_recv_timeout(zhandle_t *zh) +{ + return zh->recv_timeout; +} + +/** these functions are thread unsafe, so make sure that + zoo_lock_auth is called before you access them **/ +static auth_info* get_last_auth(auth_list_head_t *auth_list) { + auth_info *element; + element = auth_list->auth; + if (element == NULL) { + return NULL; + } + while (element->next != NULL) { + element = element->next; + } + return element; +} + +static void free_auth_completion(auth_completion_list_t *a_list) { + auth_completion_list_t *tmp, *ftmp; + if (a_list == NULL) { + return; + } + tmp = a_list->next; + while (tmp != NULL) { + ftmp = tmp; + tmp = tmp->next; + ftmp->completion = NULL; + ftmp->auth_data = NULL; + free(ftmp); + } + a_list->completion = NULL; + a_list->auth_data = NULL; + a_list->next = NULL; + return; +} + +static void add_auth_completion(auth_completion_list_t* a_list, void_completion_t* completion, + const char *data) { + auth_completion_list_t *element; + auth_completion_list_t *n_element; + element = a_list; + if (a_list->completion == NULL) { + //this is the first element + a_list->completion = *completion; + a_list->next = NULL; + a_list->auth_data = data; + return; + } + while (element->next != NULL) { + element = element->next; + } + n_element = (auth_completion_list_t*) malloc(sizeof(auth_completion_list_t)); + n_element->next = NULL; + n_element->completion = *completion; + n_element->auth_data = data; + element->next = n_element; + return; +} + +static void get_auth_completions(auth_list_head_t *auth_list, auth_completion_list_t *a_list) { + auth_info *element; + element = auth_list->auth; + if (element == NULL) { + return; + } + while (element) { + if (element->completion) { + add_auth_completion(a_list, &element->completion, element->data); + } + element->completion = NULL; + element = element->next; + } + return; +} + +static void add_last_auth(auth_list_head_t *auth_list, auth_info *add_el) { + auth_info *element; + element = auth_list->auth; + if (element == NULL) { + //first element in the list + auth_list->auth = add_el; + return; + } + while (element->next != NULL) { + element = element->next; + } + element->next = add_el; + return; +} + +static void init_auth_info(auth_list_head_t *auth_list) +{ + auth_list->auth = NULL; +} + +static void mark_active_auth(zhandle_t *zh) { + auth_list_head_t auth_h = zh->auth_h; + auth_info *element; + if (auth_h.auth == NULL) { + return; + } + element = auth_h.auth; + while (element != NULL) { + element->state = 1; + element = element->next; + } +} + +static void free_auth_info(auth_list_head_t *auth_list) +{ + auth_info *auth = auth_list->auth; + while (auth != NULL) { + auth_info* old_auth = NULL; + if(auth->scheme!=NULL) + free(auth->scheme); + deallocate_Buffer(&auth->auth); + old_auth = auth; + auth = auth->next; + free(old_auth); + } + init_auth_info(auth_list); +} + +int is_unrecoverable(zhandle_t *zh) +{ + return (zh->state<0)? ZINVALIDSTATE: ZOK; +} + +zk_hashtable *exists_result_checker(zhandle_t *zh, int rc) +{ + if (rc == ZOK) { + return zh->active_node_watchers; + } else if (rc == ZNONODE) { + return zh->active_exist_watchers; + } + return 0; +} + +zk_hashtable *data_result_checker(zhandle_t *zh, int rc) +{ + return rc==ZOK ? zh->active_node_watchers : 0; +} + +zk_hashtable *child_result_checker(zhandle_t *zh, int rc) +{ + return rc==ZOK ? zh->active_child_watchers : 0; +} + +/** + * Frees and closes everything associated with a handle, + * including the handle itself. + */ +static void destroy(zhandle_t *zh) +{ + if (zh == NULL) { + return; + } + /* call any outstanding completions with a special error code */ + cleanup_bufs(zh,1,ZCLOSING); + if (zh->hostname != 0) { + free(zh->hostname); + zh->hostname = NULL; + } + if (zh->fd != -1) { + close(zh->fd); + zh->fd = -1; + zh->state = 0; + } + if (zh->addrs != 0) { + free(zh->addrs); + zh->addrs = NULL; + } + + if (zh->chroot != 0) { + free(zh->chroot); + zh->chroot = NULL; + } + + free_auth_info(&zh->auth_h); + destroy_zk_hashtable(zh->active_node_watchers); + destroy_zk_hashtable(zh->active_exist_watchers); + destroy_zk_hashtable(zh->active_child_watchers); +} + +static void setup_random() +{ +#ifndef WIN32 // TODO: better seed + int seed; + int fd = open("/dev/urandom", O_RDONLY); + if (fd == -1) { + seed = getpid(); + } else { + int seed_len = 0; + + /* Enter a loop to fill in seed with random data from /dev/urandom. + * This is done in a loop so that we can safely handle short reads + * which can happen due to signal interruptions. + */ + while (seed_len < sizeof(seed)) { + /* Assert we either read something or we were interrupted due to a + * signal (errno == EINTR) in which case we need to retry. + */ + int rc = read(fd, &seed + seed_len, sizeof(seed) - seed_len); + assert(rc > 0 || errno == EINTR); + if (rc > 0) { + seed_len += rc; + } + } + close(fd); + } + srandom(seed); +#endif +} + +#ifndef __CYGWIN__ +/** + * get the errno from the return code + * of get addrinfo. Errno is not set + * with the call to getaddrinfo, so thats + * why we have to do this. + */ +static int getaddrinfo_errno(int rc) { + switch(rc) { + case EAI_NONAME: +// ZOOKEEPER-1323 EAI_NODATA and EAI_ADDRFAMILY are deprecated in FreeBSD. +#if defined EAI_NODATA && EAI_NODATA != EAI_NONAME + case EAI_NODATA: +#endif + return ENOENT; + case EAI_MEMORY: + return ENOMEM; + default: + return EINVAL; + } +} +#endif + +/** + * fill in the addrs array of the zookeeper servers in the zhandle. after filling + * them in, we will permute them for load balancing. + */ +int getaddrs(zhandle_t *zh) +{ + char *hosts = strdup(zh->hostname); + char *host; + char *strtok_last; + struct sockaddr_storage *addr; + int i; + int rc; + int alen = 0; /* the allocated length of the addrs array */ + + zh->addrs_count = 0; + if (zh->addrs) { + free(zh->addrs); + zh->addrs = 0; + } + if (!hosts) { + LOG_ERROR(("out of memory")); + errno=ENOMEM; + return ZSYSTEMERROR; + } + zh->addrs = 0; + host=strtok_r(hosts, ",", &strtok_last); + while(host) { + char *port_spec = strrchr(host, ':'); + char *end_port_spec; + int port; + if (!port_spec) { + LOG_ERROR(("no port in %s", host)); + errno=EINVAL; + rc=ZBADARGUMENTS; + goto fail; + } + *port_spec = '\0'; + port_spec++; + port = strtol(port_spec, &end_port_spec, 0); + if (!*port_spec || *end_port_spec || port == 0) { + LOG_ERROR(("invalid port in %s", host)); + errno=EINVAL; + rc=ZBADARGUMENTS; + goto fail; + } +#if defined(__CYGWIN__) + // sadly CYGWIN doesn't have getaddrinfo + // but happily gethostbyname is threadsafe in windows + { + struct hostent *he; + char **ptr; + struct sockaddr_in *addr4; + + he = gethostbyname(host); + if (!he) { + LOG_ERROR(("could not resolve %s", host)); + errno=ENOENT; + rc=ZBADARGUMENTS; + goto fail; + } + + /* Setup the address array */ + for(ptr = he->h_addr_list;*ptr != 0; ptr++) { + if (zh->addrs_count == alen) { + alen += 16; + zh->addrs = realloc(zh->addrs, sizeof(*zh->addrs)*alen); + if (zh->addrs == 0) { + LOG_ERROR(("out of memory")); + errno=ENOMEM; + rc=ZSYSTEMERROR; + goto fail; + } + } + addr = &zh->addrs[zh->addrs_count]; + addr4 = (struct sockaddr_in*)addr; + addr->ss_family = he->h_addrtype; + if (addr->ss_family == AF_INET) { + addr4->sin_port = htons(port); + memset(&addr4->sin_zero, 0, sizeof(addr4->sin_zero)); + memcpy(&addr4->sin_addr, *ptr, he->h_length); + zh->addrs_count++; + } +#if defined(AF_INET6) + else if (addr->ss_family == AF_INET6) { + struct sockaddr_in6 *addr6; + + addr6 = (struct sockaddr_in6*)addr; + addr6->sin6_port = htons(port); + addr6->sin6_scope_id = 0; + addr6->sin6_flowinfo = 0; + memcpy(&addr6->sin6_addr, *ptr, he->h_length); + zh->addrs_count++; + } +#endif + else { + LOG_WARN(("skipping unknown address family %x for %s", + addr->ss_family, zh->hostname)); + } + } + host = strtok_r(0, ",", &strtok_last); + } +#else + { + struct addrinfo hints, *res, *res0; + + memset(&hints, 0, sizeof(hints)); +#ifdef AI_ADDRCONFIG + hints.ai_flags = AI_ADDRCONFIG; +#else + hints.ai_flags = 0; +#endif + hints.ai_family = AF_UNSPEC; + hints.ai_socktype = SOCK_STREAM; + hints.ai_protocol = IPPROTO_TCP; + + while(isspace(*host) && host != strtok_last) + host++; + + if ((rc = getaddrinfo(host, port_spec, &hints, &res0)) != 0) { + //bug in getaddrinfo implementation when it returns + //EAI_BADFLAGS or EAI_ADDRFAMILY with AF_UNSPEC and + // ai_flags as AI_ADDRCONFIG +#ifdef AI_ADDRCONFIG + if ((hints.ai_flags == AI_ADDRCONFIG) && +// ZOOKEEPER-1323 EAI_NODATA and EAI_ADDRFAMILY are deprecated in FreeBSD. +#ifdef EAI_ADDRFAMILY + ((rc ==EAI_BADFLAGS) || (rc == EAI_ADDRFAMILY))) { +#else + (rc == EAI_BADFLAGS)) { +#endif + //reset ai_flags to null + hints.ai_flags = 0; + //retry getaddrinfo + rc = getaddrinfo(host, port_spec, &hints, &res0); + } +#endif + if (rc != 0) { + errno = getaddrinfo_errno(rc); +#ifdef WIN32 + LOG_ERROR(("Win32 message: %s\n", gai_strerror(rc))); +#else + LOG_ERROR(("getaddrinfo: %s\n", strerror(errno))); +#endif + rc=ZSYSTEMERROR; + goto fail; + } + } + + for (res = res0; res; res = res->ai_next) { + // Expand address list if needed + if (zh->addrs_count == alen) { + void *tmpaddr; + alen += 16; + tmpaddr = realloc(zh->addrs, sizeof(*zh->addrs)*alen); + if (tmpaddr == 0) { + LOG_ERROR(("out of memory")); + errno=ENOMEM; + rc=ZSYSTEMERROR; + goto fail; + } + zh->addrs=tmpaddr; + } + + // Copy addrinfo into address list + addr = &zh->addrs[zh->addrs_count]; + switch (res->ai_family) { + case AF_INET: +#if defined(AF_INET6) + case AF_INET6: +#endif + memcpy(addr, res->ai_addr, res->ai_addrlen); + ++zh->addrs_count; + break; + default: + LOG_WARN(("skipping unknown address family %x for %s", + res->ai_family, zh->hostname)); + break; + } + } + + freeaddrinfo(res0); + + host = strtok_r(0, ",", &strtok_last); + } +#endif + } + free(hosts); + + if(!disable_conn_permute){ + setup_random(); + /* Permute */ + for (i = zh->addrs_count - 1; i > 0; --i) { + long int j = random()%(i+1); + if (i != j) { + struct sockaddr_storage t = zh->addrs[i]; + zh->addrs[i] = zh->addrs[j]; + zh->addrs[j] = t; + } + } + } + return ZOK; +fail: + if (zh->addrs) { + free(zh->addrs); + zh->addrs=0; + } + if (hosts) { + free(hosts); + } + return rc; +} + +const clientid_t *zoo_client_id(zhandle_t *zh) +{ + return &zh->client_id; +} + +static void null_watcher_fn(zhandle_t* p1, int p2, int p3,const char* p4,void*p5){} + +watcher_fn zoo_set_watcher(zhandle_t *zh,watcher_fn newFn) +{ + watcher_fn oldWatcher=zh->watcher; + if (newFn) { + zh->watcher = newFn; + } else { + zh->watcher = null_watcher_fn; + } + return oldWatcher; +} + +struct sockaddr* zookeeper_get_connected_host(zhandle_t *zh, + struct sockaddr *addr, socklen_t *addr_len) +{ + if (zh->state!=ZOO_CONNECTED_STATE) { + return NULL; + } + if (getpeername(zh->fd, addr, addr_len)==-1) { + return NULL; + } + return addr; +} + +static void log_env() { + char buf[2048]; +#ifdef HAVE_SYS_UTSNAME_H + struct utsname utsname; +#endif + +#if defined(HAVE_GETUID) && defined(HAVE_GETPWUID_R) + struct passwd pw; + struct passwd *pwp = NULL; + uid_t uid = 0; +#endif + + LOG_INFO(("Client environment:zookeeper.version=%s", PACKAGE_STRING)); + +#ifdef HAVE_GETHOSTNAME + gethostname(buf, sizeof(buf)); + LOG_INFO(("Client environment:host.name=%s", buf)); +#else + LOG_INFO(("Client environment:host.name=")); +#endif + +#ifdef HAVE_SYS_UTSNAME_H + uname(&utsname); + LOG_INFO(("Client environment:os.name=%s", utsname.sysname)); + LOG_INFO(("Client environment:os.arch=%s", utsname.release)); + LOG_INFO(("Client environment:os.version=%s", utsname.version)); +#else + LOG_INFO(("Client environment:os.name=")); + LOG_INFO(("Client environment:os.arch=")); + LOG_INFO(("Client environment:os.version=")); +#endif + +#ifdef HAVE_GETLOGIN + LOG_INFO(("Client environment:user.name=%s", getlogin())); +#else + LOG_INFO(("Client environment:user.name=")); +#endif + +#if defined(HAVE_GETUID) && defined(HAVE_GETPWUID_R) + uid = getuid(); + if (!getpwuid_r(uid, &pw, buf, sizeof(buf), &pwp)) { + LOG_INFO(("Client environment:user.home=%s", pw.pw_dir)); + } else { + LOG_INFO(("Client environment:user.home=")); + } +#else + LOG_INFO(("Client environment:user.home=")); +#endif + +#ifdef HAVE_GETCWD + if (!getcwd(buf, sizeof(buf))) { + LOG_INFO(("Client environment:user.dir=")); + } else { + LOG_INFO(("Client environment:user.dir=%s", buf)); + } +#else + LOG_INFO(("Client environment:user.dir=")); +#endif +} + +/** + * Create a zookeeper handle associated with the given host and port. + */ +zhandle_t *zookeeper_init(const char *host, watcher_fn watcher, + int recv_timeout, const clientid_t *clientid, void *context, int flags) +{ + int errnosave = 0; + zhandle_t *zh = NULL; + char *index_chroot = NULL; + + log_env(); +#ifdef WIN32 + if (Win32WSAStartup()){ + LOG_ERROR(("Error initializing ws2_32.dll")); + return 0; + } +#endif + LOG_INFO(("Initiating client connection, host=%s sessionTimeout=%d watcher=%p" + " sessionId=%#llx sessionPasswd=%s context=%p flags=%d", + host, + recv_timeout, + watcher, + (clientid == 0 ? 0 : clientid->client_id), + ((clientid == 0) || (clientid->passwd[0] == 0) ? + "" : ""), + context, + flags)); + + zh = calloc(1, sizeof(*zh)); + if (!zh) { + return 0; + } + zh->fd = -1; + zh->state = NOTCONNECTED_STATE_DEF; + zh->context = context; + zh->recv_timeout = recv_timeout; + init_auth_info(&zh->auth_h); + if (watcher) { + zh->watcher = watcher; + } else { + zh->watcher = null_watcher_fn; + } + if (host == 0 || *host == 0) { // what we shouldn't dup + errno=EINVAL; + goto abort; + } + //parse the host to get the chroot if + //available + index_chroot = strchr(host, '/'); + if (index_chroot) { + zh->chroot = strdup(index_chroot); + if (zh->chroot == NULL) { + goto abort; + } + // if chroot is just / set it to null + if (strlen(zh->chroot) == 1) { + free(zh->chroot); + zh->chroot = NULL; + } + // cannot use strndup so allocate and strcpy + zh->hostname = (char *) malloc(index_chroot - host + 1); + zh->hostname = strncpy(zh->hostname, host, (index_chroot - host)); + //strncpy does not null terminate + *(zh->hostname + (index_chroot - host)) = '\0'; + + } else { + zh->chroot = NULL; + zh->hostname = strdup(host); + } + if (zh->chroot && !isValidPath(zh->chroot, 0)) { + errno = EINVAL; + goto abort; + } + if (zh->hostname == 0) { + goto abort; + } + if(getaddrs(zh)!=0) { + goto abort; + } + zh->connect_index = 0; + if (clientid) { + memcpy(&zh->client_id, clientid, sizeof(zh->client_id)); + } else { + memset(&zh->client_id, 0, sizeof(zh->client_id)); + } + zh->primer_buffer.buffer = zh->primer_storage_buffer; + zh->primer_buffer.curr_offset = 0; + zh->primer_buffer.len = sizeof(zh->primer_storage_buffer); + zh->primer_buffer.next = 0; + zh->last_zxid = 0; + zh->next_deadline.tv_sec=zh->next_deadline.tv_usec=0; + zh->socket_readable.tv_sec=zh->socket_readable.tv_usec=0; + zh->active_node_watchers=create_zk_hashtable(); + zh->active_exist_watchers=create_zk_hashtable(); + zh->active_child_watchers=create_zk_hashtable(); + + if (adaptor_init(zh) == -1) { + goto abort; + } + + return zh; +abort: + errnosave=errno; + destroy(zh); + free(zh); + errno=errnosave; + return 0; +} + +/** + * deallocated the free_path only its beeen allocated + * and not equal to path + */ +void free_duplicate_path(const char *free_path, const char* path) { + if (free_path != path) { + free((void*)free_path); + } +} + +/** + prepend the chroot path if available else return the path +*/ +static char* prepend_string(zhandle_t *zh, const char* client_path) { + char *ret_str; + if (zh == NULL || zh->chroot == NULL) + return (char *) client_path; + // handle the chroot itself, client_path = "/" + if (strlen(client_path) == 1) { + return strdup(zh->chroot); + } + ret_str = (char *) malloc(strlen(zh->chroot) + strlen(client_path) + 1); + strcpy(ret_str, zh->chroot); + return strcat(ret_str, client_path); +} + +/** + strip off the chroot string from the server path + if there is one else return the exact path + */ +char* sub_string(zhandle_t *zh, const char* server_path) { + char *ret_str; + if (zh->chroot == NULL) + return (char *) server_path; + //ZOOKEEPER-1027 + if (strncmp(server_path, zh->chroot, strlen(zh->chroot)) != 0) { + LOG_ERROR(("server path %s does not include chroot path %s", + server_path, zh->chroot)); + return (char *) server_path; + } + if (strlen(server_path) == strlen(zh->chroot)) { + //return "/" + ret_str = strdup("/"); + return ret_str; + } + ret_str = strdup(server_path + strlen(zh->chroot)); + return ret_str; +} + +static buffer_list_t *allocate_buffer(char *buff, int len) +{ + buffer_list_t *buffer = calloc(1, sizeof(*buffer)); + if (buffer == 0) + return 0; + + buffer->len = len==0?sizeof(*buffer):len; + buffer->curr_offset = 0; + buffer->buffer = buff; + buffer->next = 0; + return buffer; +} + +static void free_buffer(buffer_list_t *b) +{ + if (!b) { + return; + } + if (b->buffer) { + free(b->buffer); + } + free(b); +} + +static buffer_list_t *dequeue_buffer(buffer_head_t *list) +{ + buffer_list_t *b; + lock_buffer_list(list); + b = list->head; + if (b) { + list->head = b->next; + if (!list->head) { + assert(b == list->last); + list->last = 0; + } + } + unlock_buffer_list(list); + return b; +} + +static int remove_buffer(buffer_head_t *list) +{ + buffer_list_t *b = dequeue_buffer(list); + if (!b) { + return 0; + } + free_buffer(b); + return 1; +} + +static void queue_buffer(buffer_head_t *list, buffer_list_t *b, int add_to_front) +{ + b->next = 0; + lock_buffer_list(list); + if (list->head) { + assert(list->last); + // The list is not empty + if (add_to_front) { + b->next = list->head; + list->head = b; + } else { + list->last->next = b; + list->last = b; + } + }else{ + // The list is empty + assert(!list->head); + list->head = b; + list->last = b; + } + unlock_buffer_list(list); +} + +static int queue_buffer_bytes(buffer_head_t *list, char *buff, int len) +{ + buffer_list_t *b = allocate_buffer(buff,len); + if (!b) + return ZSYSTEMERROR; + queue_buffer(list, b, 0); + return ZOK; +} + +static int queue_front_buffer_bytes(buffer_head_t *list, char *buff, int len) +{ + buffer_list_t *b = allocate_buffer(buff,len); + if (!b) + return ZSYSTEMERROR; + queue_buffer(list, b, 1); + return ZOK; +} + +static __attribute__ ((unused)) int get_queue_len(buffer_head_t *list) +{ + int i; + buffer_list_t *ptr; + lock_buffer_list(list); + ptr = list->head; + for (i=0; ptr!=0; ptr=ptr->next, i++) + ; + unlock_buffer_list(list); + return i; +} +/* returns: + * -1 if send failed, + * 0 if send would block while sending the buffer (or a send was incomplete), + * 1 if success + */ +#ifdef WIN32 +static int send_buffer(SOCKET fd, buffer_list_t *buff) +#else +static int send_buffer(int fd, buffer_list_t *buff) +#endif +{ + int len = buff->len; + int off = buff->curr_offset; + int rc = -1; + + if (off < 4) { + /* we need to send the length at the beginning */ + int nlen = htonl(len); + char *b = (char*)&nlen; + rc = zookeeper_send(fd, b + off, sizeof(nlen) - off); + if (rc == -1) { +#ifndef _WINDOWS + if (errno != EAGAIN) { +#else + if (WSAGetLastError() != WSAEWOULDBLOCK) { +#endif + return -1; + } else { + return 0; + } + } else { + buff->curr_offset += rc; + } + off = buff->curr_offset; + } + if (off >= 4) { + /* want off to now represent the offset into the buffer */ + off -= sizeof(buff->len); + rc = zookeeper_send(fd, buff->buffer + off, len - off); + if (rc == -1) { +#ifndef _WINDOWS + if (errno != EAGAIN) { +#else + if (WSAGetLastError() != WSAEWOULDBLOCK) { +#endif + return -1; + } + } else { + buff->curr_offset += rc; + } + } + return buff->curr_offset == len + sizeof(buff->len); +} + +/* returns: + * -1 if recv call failed, + * 0 if recv would block, + * 1 if success + */ +#ifdef WIN32 +static int recv_buffer(SOCKET fd, buffer_list_t *buff) +#else +static int recv_buffer(int fd, buffer_list_t *buff) +#endif +{ + int off = buff->curr_offset; + int rc = 0; + //fprintf(LOGSTREAM, "rc = %d, off = %d, line %d\n", rc, off, __LINE__); + + /* if buffer is less than 4, we are reading in the length */ + if (off < 4) { + char *buffer = (char*)&(buff->len); + rc = recv(fd, buffer+off, sizeof(int)-off, 0); + //fprintf(LOGSTREAM, "rc = %d, off = %d, line %d\n", rc, off, __LINE__); + switch(rc) { + case 0: + errno = EHOSTDOWN; + case -1: +#ifndef _WINDOWS + if (errno == EAGAIN) { +#else + if (WSAGetLastError() == WSAEWOULDBLOCK) { +#endif + return 0; + } + return -1; + default: + buff->curr_offset += rc; + } + off = buff->curr_offset; + if (buff->curr_offset == sizeof(buff->len)) { + buff->len = ntohl(buff->len); + buff->buffer = calloc(1, buff->len); + } + } + if (buff->buffer) { + /* want off to now represent the offset into the buffer */ + off -= sizeof(buff->len); + + rc = recv(fd, buff->buffer+off, buff->len-off, 0); + switch(rc) { + case 0: + errno = EHOSTDOWN; + case -1: +#ifndef _WINDOWS + if (errno == EAGAIN) { +#else + if (WSAGetLastError() == WSAEWOULDBLOCK) { +#endif + break; + } + return -1; + default: + buff->curr_offset += rc; + } + } + return buff->curr_offset == buff->len + sizeof(buff->len); +} + +void free_buffers(buffer_head_t *list) +{ + while (remove_buffer(list)) + ; +} + +void free_completions(zhandle_t *zh,int callCompletion,int reason) +{ + completion_head_t tmp_list; + struct oarchive *oa; + struct ReplyHeader h; + void_completion_t auth_completion = NULL; + auth_completion_list_t a_list, *a_tmp; + + if (lock_completion_list(&zh->sent_requests) == 0) { + tmp_list = zh->sent_requests; + zh->sent_requests.head = 0; + zh->sent_requests.last = 0; + unlock_completion_list(&zh->sent_requests); + + while (tmp_list.head) { + completion_list_t *cptr = tmp_list.head; + + tmp_list.head = cptr->next; + if (cptr->c.data_result == SYNCHRONOUS_MARKER) { + struct sync_completion + *sc = (struct sync_completion*)cptr->data; + sc->rc = reason; + notify_sync_completion(sc); + zh->outstanding_sync--; + destroy_completion_entry(cptr); + } else if (callCompletion) { + // Fake the response + buffer_list_t *bptr; + h.xid = cptr->xid; + h.zxid = -1; + h.err = reason; + oa = create_buffer_oarchive(); + serialize_ReplyHeader(oa, "header", &h); + bptr = calloc(sizeof(*bptr), 1); + assert(bptr); + bptr->len = get_buffer_len(oa); + bptr->buffer = get_buffer(oa); + close_buffer_oarchive(&oa, 0); + cptr->buffer = bptr; + queue_completion(&zh->completions_to_process, cptr, 0); + } + } + } + if (zoo_lock_auth(zh) == 0) { + a_list.completion = NULL; + a_list.next = NULL; + + get_auth_completions(&zh->auth_h, &a_list); + zoo_unlock_auth(zh); + + a_tmp = &a_list; + // chain call user's completion function + while (a_tmp->completion != NULL) { + auth_completion = a_tmp->completion; + auth_completion(reason, a_tmp->auth_data); + a_tmp = a_tmp->next; + if (a_tmp == NULL) + break; + } + } + free_auth_completion(&a_list); +} + +static void cleanup_bufs(zhandle_t *zh,int callCompletion,int rc) +{ + enter_critical(zh); + free_buffers(&zh->to_send); + free_buffers(&zh->to_process); + free_completions(zh,callCompletion,rc); + leave_critical(zh); + if (zh->input_buffer && zh->input_buffer != &zh->primer_buffer) { + free_buffer(zh->input_buffer); + zh->input_buffer = 0; + } +} + +static void handle_error(zhandle_t *zh,int rc) +{ + close(zh->fd); + if (is_unrecoverable(zh)) { + LOG_DEBUG(("Calling a watcher for a ZOO_SESSION_EVENT and the state=%s", + state2String(zh->state))); + PROCESS_SESSION_EVENT(zh, zh->state); + } else if (zh->state == ZOO_CONNECTED_STATE) { + LOG_DEBUG(("Calling a watcher for a ZOO_SESSION_EVENT and the state=CONNECTING_STATE")); + PROCESS_SESSION_EVENT(zh, ZOO_CONNECTING_STATE); + } + cleanup_bufs(zh,1,rc); + zh->fd = -1; + zh->connect_index++; + if (!is_unrecoverable(zh)) { + zh->state = 0; + } + if (process_async(zh->outstanding_sync)) { + process_completions(zh); + } +} + +static int handle_socket_error_msg(zhandle_t *zh, int line, int rc, + const char* format, ...) +{ + if(logLevel>=ZOO_LOG_LEVEL_ERROR){ + va_list va; + char buf[1024]; + va_start(va,format); + vsnprintf(buf, sizeof(buf)-1,format,va); + log_message(ZOO_LOG_LEVEL_ERROR,line,__func__, + format_log_message("Socket [%s] zk retcode=%d, errno=%d(%s): %s", + format_current_endpoint_info(zh),rc,errno,strerror(errno),buf)); + va_end(va); + } + handle_error(zh,rc); + return rc; +} + +static void auth_completion_func(int rc, zhandle_t* zh) +{ + void_completion_t auth_completion = NULL; + auth_completion_list_t a_list; + auth_completion_list_t *a_tmp; + + if(zh==NULL) + return; + + zoo_lock_auth(zh); + + if(rc!=0){ + zh->state=ZOO_AUTH_FAILED_STATE; + }else{ + //change state for all auths + mark_active_auth(zh); + } + a_list.completion = NULL; + a_list.next = NULL; + get_auth_completions(&zh->auth_h, &a_list); + zoo_unlock_auth(zh); + if (rc) { + LOG_ERROR(("Authentication scheme %s failed. Connection closed.", + zh->auth_h.auth->scheme)); + } + else { + LOG_INFO(("Authentication scheme %s succeeded", zh->auth_h.auth->scheme)); + } + a_tmp = &a_list; + // chain call user's completion function + while (a_tmp->completion != NULL) { + auth_completion = a_tmp->completion; + auth_completion(rc, a_tmp->auth_data); + a_tmp = a_tmp->next; + if (a_tmp == NULL) + break; + } + free_auth_completion(&a_list); +} + +static int send_info_packet(zhandle_t *zh, auth_info* auth) { + struct oarchive *oa; + struct RequestHeader h = { STRUCT_INITIALIZER(xid , AUTH_XID), STRUCT_INITIALIZER(type , ZOO_SETAUTH_OP)}; + struct AuthPacket req; + int rc; + oa = create_buffer_oarchive(); + rc = serialize_RequestHeader(oa, "header", &h); + req.type=0; // ignored by the server + req.scheme = auth->scheme; + req.auth = auth->auth; + rc = rc < 0 ? rc : serialize_AuthPacket(oa, "req", &req); + /* add this buffer to the head of the send queue */ + rc = rc < 0 ? rc : queue_front_buffer_bytes(&zh->to_send, get_buffer(oa), + get_buffer_len(oa)); + /* We queued the buffer, so don't free it */ + close_buffer_oarchive(&oa, 0); + + return rc; +} + +/** send all auths, not just the last one **/ +static int send_auth_info(zhandle_t *zh) { + int rc = 0; + auth_info *auth = NULL; + + zoo_lock_auth(zh); + auth = zh->auth_h.auth; + if (auth == NULL) { + zoo_unlock_auth(zh); + return ZOK; + } + while (auth != NULL) { + rc = send_info_packet(zh, auth); + auth = auth->next; + } + zoo_unlock_auth(zh); + LOG_DEBUG(("Sending all auth info request to %s", format_current_endpoint_info(zh))); + return (rc <0) ? ZMARSHALLINGERROR:ZOK; +} + +static int send_last_auth_info(zhandle_t *zh) +{ + int rc = 0; + auth_info *auth = NULL; + + zoo_lock_auth(zh); + auth = get_last_auth(&zh->auth_h); + if(auth==NULL) { + zoo_unlock_auth(zh); + return ZOK; // there is nothing to send + } + rc = send_info_packet(zh, auth); + zoo_unlock_auth(zh); + LOG_DEBUG(("Sending auth info request to %s",format_current_endpoint_info(zh))); + return (rc < 0)?ZMARSHALLINGERROR:ZOK; +} + +static void free_key_list(char **list, int count) +{ + int i; + + for(i = 0; i < count; i++) { + free(list[i]); + } + free(list); +} + +static int send_set_watches(zhandle_t *zh) +{ + struct oarchive *oa; + struct RequestHeader h = { STRUCT_INITIALIZER(xid , SET_WATCHES_XID), STRUCT_INITIALIZER(type , ZOO_SETWATCHES_OP)}; + struct SetWatches req; + int rc; + + req.relativeZxid = zh->last_zxid; + req.dataWatches.data = collect_keys(zh->active_node_watchers, (int*)&req.dataWatches.count); + req.existWatches.data = collect_keys(zh->active_exist_watchers, (int*)&req.existWatches.count); + req.childWatches.data = collect_keys(zh->active_child_watchers, (int*)&req.childWatches.count); + + // return if there are no pending watches + if (!req.dataWatches.count && !req.existWatches.count && + !req.childWatches.count) { + free_key_list(req.dataWatches.data, req.dataWatches.count); + free_key_list(req.existWatches.data, req.existWatches.count); + free_key_list(req.childWatches.data, req.childWatches.count); + return ZOK; + } + + + oa = create_buffer_oarchive(); + rc = serialize_RequestHeader(oa, "header", &h); + rc = rc < 0 ? rc : serialize_SetWatches(oa, "req", &req); + /* add this buffer to the head of the send queue */ + rc = rc < 0 ? rc : queue_front_buffer_bytes(&zh->to_send, get_buffer(oa), + get_buffer_len(oa)); + /* We queued the buffer, so don't free it */ + close_buffer_oarchive(&oa, 0); + free_key_list(req.dataWatches.data, req.dataWatches.count); + free_key_list(req.existWatches.data, req.existWatches.count); + free_key_list(req.childWatches.data, req.childWatches.count); + LOG_DEBUG(("Sending set watches request to %s",format_current_endpoint_info(zh))); + return (rc < 0)?ZMARSHALLINGERROR:ZOK; +} + +static int serialize_prime_connect(struct connect_req *req, char* buffer){ + //this should be the order of serialization + int offset = 0; + req->protocolVersion = htonl(req->protocolVersion); + memcpy(buffer + offset, &req->protocolVersion, sizeof(req->protocolVersion)); + offset = offset + sizeof(req->protocolVersion); + + req->lastZxidSeen = zoo_htonll(req->lastZxidSeen); + memcpy(buffer + offset, &req->lastZxidSeen, sizeof(req->lastZxidSeen)); + offset = offset + sizeof(req->lastZxidSeen); + + req->timeOut = htonl(req->timeOut); + memcpy(buffer + offset, &req->timeOut, sizeof(req->timeOut)); + offset = offset + sizeof(req->timeOut); + + req->sessionId = zoo_htonll(req->sessionId); + memcpy(buffer + offset, &req->sessionId, sizeof(req->sessionId)); + offset = offset + sizeof(req->sessionId); + + req->passwd_len = htonl(req->passwd_len); + memcpy(buffer + offset, &req->passwd_len, sizeof(req->passwd_len)); + offset = offset + sizeof(req->passwd_len); + + memcpy(buffer + offset, req->passwd, sizeof(req->passwd)); + + return 0; +} + + static int deserialize_prime_response(struct prime_struct *req, char* buffer){ + //this should be the order of deserialization + int offset = 0; + memcpy(&req->len, buffer + offset, sizeof(req->len)); + offset = offset + sizeof(req->len); + + req->len = ntohl(req->len); + memcpy(&req->protocolVersion, buffer + offset, sizeof(req->protocolVersion)); + offset = offset + sizeof(req->protocolVersion); + + req->protocolVersion = ntohl(req->protocolVersion); + memcpy(&req->timeOut, buffer + offset, sizeof(req->timeOut)); + offset = offset + sizeof(req->timeOut); + + req->timeOut = ntohl(req->timeOut); + memcpy(&req->sessionId, buffer + offset, sizeof(req->sessionId)); + offset = offset + sizeof(req->sessionId); + + req->sessionId = zoo_htonll(req->sessionId); + memcpy(&req->passwd_len, buffer + offset, sizeof(req->passwd_len)); + offset = offset + sizeof(req->passwd_len); + + req->passwd_len = ntohl(req->passwd_len); + memcpy(req->passwd, buffer + offset, sizeof(req->passwd)); + return 0; + } + +static int prime_connection(zhandle_t *zh) +{ + int rc; + /*this is the size of buffer to serialize req into*/ + char buffer_req[HANDSHAKE_REQ_SIZE]; + int len = sizeof(buffer_req); + int hlen = 0; + struct connect_req req; + req.protocolVersion = 0; + req.sessionId = zh->client_id.client_id; + req.passwd_len = sizeof(req.passwd); + memcpy(req.passwd, zh->client_id.passwd, sizeof(zh->client_id.passwd)); + req.timeOut = zh->recv_timeout; + req.lastZxidSeen = zh->last_zxid; + hlen = htonl(len); + /* We are running fast and loose here, but this string should fit in the initial buffer! */ + rc=zookeeper_send(zh->fd, &hlen, sizeof(len)); + serialize_prime_connect(&req, buffer_req); + rc=rc<0 ? rc : zookeeper_send(zh->fd, buffer_req, len); + if (rc<0) { + return handle_socket_error_msg(zh, __LINE__, ZCONNECTIONLOSS, + "failed to send a handshake packet: %s", strerror(errno)); + } + zh->state = ZOO_ASSOCIATING_STATE; + + zh->input_buffer = &zh->primer_buffer; + /* This seems a bit weird to to set the offset to 4, but we already have a + * length, so we skip reading the length (and allocating the buffer) by + * saying that we are already at offset 4 */ + zh->input_buffer->curr_offset = 4; + + return ZOK; +} + +static inline int calculate_interval(const struct timeval *start, + const struct timeval *end) +{ + int interval; + struct timeval i = *end; + i.tv_sec -= start->tv_sec; + i.tv_usec -= start->tv_usec; + interval = i.tv_sec * 1000 + (i.tv_usec/1000); + return interval; +} + +static struct timeval get_timeval(int interval) +{ + struct timeval tv; + if (interval < 0) { + interval = 0; + } + tv.tv_sec = interval/1000; + tv.tv_usec = (interval%1000)*1000; + return tv; +} + + static int add_void_completion(zhandle_t *zh, int xid, void_completion_t dc, + const void *data); + static int add_string_completion(zhandle_t *zh, int xid, + string_completion_t dc, const void *data); + + int send_ping(zhandle_t* zh) + { + int rc; + struct oarchive *oa = create_buffer_oarchive(); + struct RequestHeader h = { STRUCT_INITIALIZER(xid ,PING_XID), STRUCT_INITIALIZER (type , ZOO_PING_OP) }; + + rc = serialize_RequestHeader(oa, "header", &h); + enter_critical(zh); + gettimeofday(&zh->last_ping, 0); + rc = rc < 0 ? rc : queue_buffer_bytes(&zh->to_send, get_buffer(oa), + get_buffer_len(oa)); + leave_critical(zh); + close_buffer_oarchive(&oa, 0); + return rc<0 ? rc : adaptor_send_queue(zh, 0); +} + +#ifdef WIN32 +int zookeeper_interest(zhandle_t *zh, SOCKET *fd, int *interest, + struct timeval *tv) +{ + + ULONG nonblocking_flag = 1; +#else +int zookeeper_interest(zhandle_t *zh, int *fd, int *interest, + struct timeval *tv) +{ +#endif + struct timeval now; + if(zh==0 || fd==0 ||interest==0 || tv==0) + return ZBADARGUMENTS; + if (is_unrecoverable(zh)) + return ZINVALIDSTATE; + gettimeofday(&now, 0); + if(zh->next_deadline.tv_sec!=0 || zh->next_deadline.tv_usec!=0){ + int time_left = calculate_interval(&zh->next_deadline, &now); + if (time_left > 10) + LOG_WARN(("Exceeded deadline by %dms", time_left)); + } + api_prolog(zh); + *fd = zh->fd; + *interest = 0; + tv->tv_sec = 0; + tv->tv_usec = 0; + if (*fd == -1) { + if (zh->connect_index == zh->addrs_count) { + /* Wait a bit before trying again so that we don't spin */ + zh->connect_index = 0; + }else { + int rc; +#ifdef WIN32 + char enable_tcp_nodelay = 1; +#else + int enable_tcp_nodelay = 1; +#endif + int ssoresult; + + zh->fd = socket(zh->addrs[zh->connect_index].ss_family, SOCK_STREAM, 0); + if (zh->fd < 0) { + return api_epilog(zh,handle_socket_error_msg(zh,__LINE__, + ZSYSTEMERROR, "socket() call failed")); + } + ssoresult = setsockopt(zh->fd, IPPROTO_TCP, TCP_NODELAY, &enable_tcp_nodelay, sizeof(enable_tcp_nodelay)); + if (ssoresult != 0) { + LOG_WARN(("Unable to set TCP_NODELAY, operation latency may be effected")); + } +#ifdef WIN32 + ioctlsocket(zh->fd, FIONBIO, &nonblocking_flag); +#else + fcntl(zh->fd, F_SETFL, O_NONBLOCK|fcntl(zh->fd, F_GETFL, 0)); +#endif +#if defined(AF_INET6) + if (zh->addrs[zh->connect_index].ss_family == AF_INET6) { + rc = connect(zh->fd, (struct sockaddr*) &zh->addrs[zh->connect_index], sizeof(struct sockaddr_in6)); + } else { +#else + LOG_DEBUG(("[zk] connect()\n")); + { +#endif + rc = connect(zh->fd, (struct sockaddr*) &zh->addrs[zh->connect_index], sizeof(struct sockaddr_in)); +#ifdef WIN32 + errno = GetLastError(); + +#ifndef EWOULDBLOCK +#define EWOULDBLOCK WSAEWOULDBLOCK +#endif + +#ifndef EINPROGRESS +#define EINPROGRESS WSAEINPROGRESS +#endif + +#if _MSC_VER >= 1600 + switch (errno) { + case WSAEWOULDBLOCK: + errno = EWOULDBLOCK; + break; + case WSAEINPROGRESS: + errno = EINPROGRESS; + break; + } +#endif +#endif + } + if (rc == -1) { + /* we are handling the non-blocking connect according to + * the description in section 16.3 "Non-blocking connect" + * in UNIX Network Programming vol 1, 3rd edition */ + if (errno == EWOULDBLOCK || errno == EINPROGRESS) + zh->state = ZOO_CONNECTING_STATE; + else + return api_epilog(zh,handle_socket_error_msg(zh,__LINE__, + ZCONNECTIONLOSS,"connect() call failed")); + } else { + if((rc=prime_connection(zh))!=0) + return api_epilog(zh,rc); + + LOG_INFO(("Initiated connection to server [%s]", + format_endpoint_info(&zh->addrs[zh->connect_index]))); + } + } + *fd = zh->fd; + *tv = get_timeval(zh->recv_timeout/3); + zh->last_recv = now; + zh->last_send = now; + zh->last_ping = now; + } + if (zh->fd != -1) { + int idle_recv = calculate_interval(&zh->last_recv, &now); + int idle_send = calculate_interval(&zh->last_send, &now); + int recv_to = zh->recv_timeout*2/3 - idle_recv; + int send_to = zh->recv_timeout/3; + // have we exceeded the receive timeout threshold? + if (recv_to <= 0) { + // We gotta cut our losses and connect to someone else +#ifdef WIN32 + errno = WSAETIMEDOUT; +#else + errno = ETIMEDOUT; +#endif + *interest=0; + *tv = get_timeval(0); + return api_epilog(zh,handle_socket_error_msg(zh, + __LINE__,ZOPERATIONTIMEOUT, + "connection to %s timed out (exceeded timeout by %dms)", + format_endpoint_info(&zh->addrs[zh->connect_index]), + -recv_to)); + + } + // We only allow 1/3 of our timeout time to expire before sending + // a PING + if (zh->state==ZOO_CONNECTED_STATE) { + send_to = zh->recv_timeout/3 - idle_send; + if (send_to <= 0) { + if (zh->sent_requests.head==0) { +// LOG_DEBUG(("Sending PING to %s (exceeded idle by %dms)", +// format_current_endpoint_info(zh),-send_to)); + int rc=send_ping(zh); + if (rc < 0){ + LOG_ERROR(("failed to send PING request (zk retcode=%d)",rc)); + return api_epilog(zh,rc); + } + } + send_to = zh->recv_timeout/3; + } + } + // choose the lesser value as the timeout + *tv = get_timeval(recv_to < send_to? recv_to:send_to); + zh->next_deadline.tv_sec = now.tv_sec + tv->tv_sec; + zh->next_deadline.tv_usec = now.tv_usec + tv->tv_usec; + if (zh->next_deadline.tv_usec > 1000000) { + zh->next_deadline.tv_sec += zh->next_deadline.tv_usec / 1000000; + zh->next_deadline.tv_usec = zh->next_deadline.tv_usec % 1000000; + } + *interest = ZOOKEEPER_READ; + /* we are interested in a write if we are connected and have something + * to send, or we are waiting for a connect to finish. */ + if ((zh->to_send.head && (zh->state == ZOO_CONNECTED_STATE)) + || zh->state == ZOO_CONNECTING_STATE) { + *interest |= ZOOKEEPER_WRITE; + } + } + return api_epilog(zh,ZOK); +} + +static int check_events(zhandle_t *zh, int events) +{ + if (zh->fd == -1) + return ZINVALIDSTATE; + if ((events&ZOOKEEPER_WRITE)&&(zh->state == ZOO_CONNECTING_STATE)) { + int rc, error; + socklen_t len = sizeof(error); + rc = getsockopt(zh->fd, SOL_SOCKET, SO_ERROR, &error, &len); + /* the description in section 16.4 "Non-blocking connect" + * in UNIX Network Programming vol 1, 3rd edition, points out + * that sometimes the error is in errno and sometimes in error */ + if (rc < 0 || error) { + if (rc == 0) + errno = error; + return handle_socket_error_msg(zh, __LINE__,ZCONNECTIONLOSS, + "server refused to accept the client"); + } + if((rc=prime_connection(zh))!=0) + return rc; + LOG_INFO(("initiated connection to server [%s]", + format_endpoint_info(&zh->addrs[zh->connect_index]))); + return ZOK; + } + if (zh->to_send.head && (events&ZOOKEEPER_WRITE)) { + /* make the flush call non-blocking by specifying a 0 timeout */ + int rc=flush_send_queue(zh,0); + if (rc < 0) + return handle_socket_error_msg(zh,__LINE__,ZCONNECTIONLOSS, + "failed while flushing send queue"); + } + if (events&ZOOKEEPER_READ) { + int rc; + if (zh->input_buffer == 0) { + zh->input_buffer = allocate_buffer(0,0); + } + + rc = recv_buffer(zh->fd, zh->input_buffer); + if (rc < 0) { + return handle_socket_error_msg(zh, __LINE__,ZCONNECTIONLOSS, + "failed while receiving a server response"); + } + if (rc > 0) { + gettimeofday(&zh->last_recv, 0); + if (zh->input_buffer != &zh->primer_buffer) { + queue_buffer(&zh->to_process, zh->input_buffer, 0); + } else { + int64_t oldid,newid; + //deserialize + deserialize_prime_response(&zh->primer_storage, zh->primer_buffer.buffer); + /* We are processing the primer_buffer, so we need to finish + * the connection handshake */ + oldid = zh->client_id.client_id; + newid = zh->primer_storage.sessionId; + if (oldid != 0 && oldid != newid) { + zh->state = ZOO_EXPIRED_SESSION_STATE; + errno = ESTALE; + return handle_socket_error_msg(zh,__LINE__,ZSESSIONEXPIRED, + "sessionId=%#llx has expired.",oldid); + } else { + zh->recv_timeout = zh->primer_storage.timeOut; + zh->client_id.client_id = newid; + + memcpy(zh->client_id.passwd, &zh->primer_storage.passwd, + sizeof(zh->client_id.passwd)); + zh->state = ZOO_CONNECTED_STATE; + LOG_INFO(("session establishment complete on server [%s], sessionId=%#llx, negotiated timeout=%d", + format_endpoint_info(&zh->addrs[zh->connect_index]), + newid, zh->recv_timeout)); + /* we want the auth to be sent for, but since both call push to front + we need to call send_watch_set first */ + send_set_watches(zh); + /* send the authentication packet now */ + send_auth_info(zh); + LOG_DEBUG(("Calling a watcher for a ZOO_SESSION_EVENT and the state=ZOO_CONNECTED_STATE")); + zh->input_buffer = 0; // just in case the watcher calls zookeeper_process() again + PROCESS_SESSION_EVENT(zh, ZOO_CONNECTED_STATE); + } + } + zh->input_buffer = 0; + } else { + // zookeeper_process was called but there was nothing to read + // from the socket + return ZNOTHING; + } + } + return ZOK; +} + +void api_prolog(zhandle_t* zh) +{ + inc_ref_counter(zh,1); +} + +int api_epilog(zhandle_t *zh,int rc) +{ + if(inc_ref_counter(zh,-1)==0 && zh->close_requested!=0) + zookeeper_close(zh); + return rc; +} + +static __attribute__((unused)) void print_completion_queue(zhandle_t *zh) +{ + completion_list_t* cptr; + + if(logLevelsent_requests.head==0) { + fprintf(LOGSTREAM,"empty\n"); + return; + } + + cptr=zh->sent_requests.head; + while(cptr){ + fprintf(LOGSTREAM,"%d,",cptr->xid); + cptr=cptr->next; + } + fprintf(LOGSTREAM,"end\n"); +} + +//#ifdef THREADED +// IO thread queues session events to be processed by the completion thread +static int queue_session_event(zhandle_t *zh, int state) +{ + int rc; + struct WatcherEvent evt = { ZOO_SESSION_EVENT, state, "" }; + struct ReplyHeader hdr = { WATCHER_EVENT_XID, 0, 0 }; + struct oarchive *oa; + completion_list_t *cptr; + + if ((oa=create_buffer_oarchive())==NULL) { + LOG_ERROR(("out of memory")); + goto error; + } + rc = serialize_ReplyHeader(oa, "hdr", &hdr); + rc = rc<0?rc: serialize_WatcherEvent(oa, "event", &evt); + if(rc<0){ + close_buffer_oarchive(&oa, 1); + goto error; + } + cptr = create_completion_entry(WATCHER_EVENT_XID,-1,0,0,0,0); + cptr->buffer = allocate_buffer(get_buffer(oa), get_buffer_len(oa)); + cptr->buffer->curr_offset = get_buffer_len(oa); + if (!cptr->buffer) { + free(cptr); + close_buffer_oarchive(&oa, 1); + goto error; + } + /* We queued the buffer, so don't free it */ + close_buffer_oarchive(&oa, 0); + cptr->c.watcher_result = collectWatchers(zh, ZOO_SESSION_EVENT, ""); + queue_completion(&zh->completions_to_process, cptr, 0); + if (process_async(zh->outstanding_sync)) { + process_completions(zh); + } + return ZOK; +error: + errno=ENOMEM; + return ZSYSTEMERROR; +} +//#endif + +completion_list_t *dequeue_completion(completion_head_t *list) +{ + completion_list_t *cptr; + lock_completion_list(list); + cptr = list->head; + if (cptr) { + list->head = cptr->next; + if (!list->head) { + assert(list->last == cptr); + list->last = 0; + } + } + unlock_completion_list(list); + return cptr; +} + +static void process_sync_completion( + completion_list_t *cptr, + struct sync_completion *sc, + struct iarchive *ia, + zhandle_t *zh) +{ + LOG_DEBUG(("Processing sync_completion with type=%d xid=%#x rc=%d", + cptr->c.type, cptr->xid, sc->rc)); + + switch(cptr->c.type) { + case COMPLETION_DATA: + if (sc->rc==0) { + struct GetDataResponse res; + int len; + deserialize_GetDataResponse(ia, "reply", &res); + if (res.data.len <= sc->u.data.buff_len) { + len = res.data.len; + } else { + len = sc->u.data.buff_len; + } + sc->u.data.buff_len = len; + // check if len is negative + // just of NULL which is -1 int + if (len == -1) { + sc->u.data.buffer = NULL; + } else { + memcpy(sc->u.data.buffer, res.data.buff, len); + } + sc->u.data.stat = res.stat; + deallocate_GetDataResponse(&res); + } + break; + case COMPLETION_STAT: + if (sc->rc==0) { + struct SetDataResponse res; + deserialize_SetDataResponse(ia, "reply", &res); + sc->u.stat = res.stat; + deallocate_SetDataResponse(&res); + } + break; + case COMPLETION_STRINGLIST: + if (sc->rc==0) { + struct GetChildrenResponse res; + deserialize_GetChildrenResponse(ia, "reply", &res); + sc->u.strs2 = res.children; + /* We don't deallocate since we are passing it back */ + // deallocate_GetChildrenResponse(&res); + } + break; + case COMPLETION_STRINGLIST_STAT: + if (sc->rc==0) { + struct GetChildren2Response res; + deserialize_GetChildren2Response(ia, "reply", &res); + sc->u.strs_stat.strs2 = res.children; + sc->u.strs_stat.stat2 = res.stat; + /* We don't deallocate since we are passing it back */ + // deallocate_GetChildren2Response(&res); + } + break; + case COMPLETION_STRING: + if (sc->rc==0) { + struct CreateResponse res; + int len; + const char * client_path; + deserialize_CreateResponse(ia, "reply", &res); + //ZOOKEEPER-1027 + client_path = sub_string(zh, res.path); + len = strlen(client_path) + 1;if (len > sc->u.str.str_len) { + len = sc->u.str.str_len; + } + if (len > 0) { + memcpy(sc->u.str.str, client_path, len - 1); + sc->u.str.str[len - 1] = '\0'; + } + free_duplicate_path(client_path, res.path); + deallocate_CreateResponse(&res); + } + break; + case COMPLETION_ACLLIST: + if (sc->rc==0) { + struct GetACLResponse res; + deserialize_GetACLResponse(ia, "reply", &res); + sc->u.acl.acl = res.acl; + sc->u.acl.stat = res.stat; + /* We don't deallocate since we are passing it back */ + //deallocate_GetACLResponse(&res); + } + break; + case COMPLETION_VOID: + break; + case COMPLETION_MULTI: + sc->rc = deserialize_multi(cptr->xid, cptr, ia); + break; + default: + LOG_DEBUG(("Unsupported completion type=%d", cptr->c.type)); + break; + } +} + +static int deserialize_multi(int xid, completion_list_t *cptr, struct iarchive *ia) +{ + int rc = 0; + completion_head_t *clist = &cptr->c.clist; + struct MultiHeader mhdr = { STRUCT_INITIALIZER(type , 0), STRUCT_INITIALIZER(done , 0), STRUCT_INITIALIZER(err , 0) }; + assert(clist); + deserialize_MultiHeader(ia, "multiheader", &mhdr); + while (!mhdr.done) { + completion_list_t *entry = dequeue_completion(clist); + assert(entry); + + if (mhdr.type == -1) { + struct ErrorResponse er; + deserialize_ErrorResponse(ia, "error", &er); + mhdr.err = er.err ; + if (rc == 0 && er.err != 0 && er.err != ZRUNTIMEINCONSISTENCY) { + rc = er.err; + } + } + + deserialize_response(entry->c.type, xid, mhdr.type == -1, mhdr.err, entry, ia); + deserialize_MultiHeader(ia, "multiheader", &mhdr); + //While deserializing the response we must destroy completion entry for each operation in + //the zoo_multi transaction. Otherwise this results in memory leak when client invokes zoo_multi + //operation. + destroy_completion_entry(entry); + } + + return rc; +} + +static void deserialize_response(int type, int xid, int failed, int rc, completion_list_t *cptr, struct iarchive *ia) +{ + switch (type) { + case COMPLETION_DATA: + LOG_DEBUG(("Calling COMPLETION_DATA for xid=%#x failed=%d rc=%d", + cptr->xid, failed, rc)); + if (failed) { + cptr->c.data_result(rc, 0, 0, 0, cptr->data); + } else { + struct GetDataResponse res; + deserialize_GetDataResponse(ia, "reply", &res); + cptr->c.data_result(rc, res.data.buff, res.data.len, + &res.stat, cptr->data); + deallocate_GetDataResponse(&res); + } + break; + case COMPLETION_STAT: + LOG_DEBUG(("Calling COMPLETION_STAT for xid=%#x failed=%d rc=%d", + cptr->xid, failed, rc)); + if (failed) { + cptr->c.stat_result(rc, 0, cptr->data); + } else { + struct SetDataResponse res; + deserialize_SetDataResponse(ia, "reply", &res); + cptr->c.stat_result(rc, &res.stat, cptr->data); + deallocate_SetDataResponse(&res); + } + break; + case COMPLETION_STRINGLIST: + LOG_DEBUG(("Calling COMPLETION_STRINGLIST for xid=%#x failed=%d rc=%d", + cptr->xid, failed, rc)); + if (failed) { + cptr->c.strings_result(rc, 0, cptr->data); + } else { + struct GetChildrenResponse res; + deserialize_GetChildrenResponse(ia, "reply", &res); + cptr->c.strings_result(rc, &res.children, cptr->data); + deallocate_GetChildrenResponse(&res); + } + break; + case COMPLETION_STRINGLIST_STAT: + LOG_DEBUG(("Calling COMPLETION_STRINGLIST_STAT for xid=%#x failed=%d rc=%d", + cptr->xid, failed, rc)); + if (failed) { + cptr->c.strings_stat_result(rc, 0, 0, cptr->data); + } else { + struct GetChildren2Response res; + deserialize_GetChildren2Response(ia, "reply", &res); + cptr->c.strings_stat_result(rc, &res.children, &res.stat, cptr->data); + deallocate_GetChildren2Response(&res); + } + break; + case COMPLETION_STRING: + LOG_DEBUG(("Calling COMPLETION_STRING for xid=%#x failed=%d, rc=%d", + cptr->xid, failed, rc)); + if (failed) { + cptr->c.string_result(rc, 0, cptr->data); + } else { + struct CreateResponse res; + memset(&res, 0, sizeof(res)); + deserialize_CreateResponse(ia, "reply", &res); + cptr->c.string_result(rc, res.path, cptr->data); + deallocate_CreateResponse(&res); + } + break; + case COMPLETION_ACLLIST: + LOG_DEBUG(("Calling COMPLETION_ACLLIST for xid=%#x failed=%d rc=%d", + cptr->xid, failed, rc)); + if (failed) { + cptr->c.acl_result(rc, 0, 0, cptr->data); + } else { + struct GetACLResponse res; + deserialize_GetACLResponse(ia, "reply", &res); + cptr->c.acl_result(rc, &res.acl, &res.stat, cptr->data); + deallocate_GetACLResponse(&res); + } + break; + case COMPLETION_VOID: + LOG_DEBUG(("Calling COMPLETION_VOID for xid=%#x failed=%d rc=%d", + cptr->xid, failed, rc)); + assert(cptr->c.void_result); + cptr->c.void_result(rc, cptr->data); + break; + case COMPLETION_MULTI: + LOG_DEBUG(("Calling COMPLETION_MULTI for xid=%#x failed=%d rc=%d", + cptr->xid, failed, rc)); + rc = deserialize_multi(xid, cptr, ia); + assert(cptr->c.void_result); + cptr->c.void_result(rc, cptr->data); + break; + default: + LOG_DEBUG(("Unsupported completion type=%d", cptr->c.type)); + } +} + + +/* handles async completion (both single- and multithreaded) */ +void process_completions(zhandle_t *zh) +{ + completion_list_t *cptr; + while ((cptr = dequeue_completion(&zh->completions_to_process)) != 0) { + struct ReplyHeader hdr; + buffer_list_t *bptr = cptr->buffer; + struct iarchive *ia = create_buffer_iarchive(bptr->buffer, + bptr->len); + deserialize_ReplyHeader(ia, "hdr", &hdr); + + if (hdr.xid == WATCHER_EVENT_XID) { + int type, state; + struct WatcherEvent evt; + deserialize_WatcherEvent(ia, "event", &evt); + /* We are doing a notification, so there is no pending request */ + type = evt.type; + state = evt.state; + /* This is a notification so there aren't any pending requests */ + LOG_DEBUG(("Calling a watcher for node [%s], type = %d event=%s", + (evt.path==NULL?"NULL":evt.path), cptr->c.type, + watcherEvent2String(type))); + deliverWatchers(zh,type,state,evt.path, &cptr->c.watcher_result); + deallocate_WatcherEvent(&evt); + } else { + deserialize_response(cptr->c.type, hdr.xid, hdr.err != 0, hdr.err, cptr, ia); + } + destroy_completion_entry(cptr); + close_buffer_iarchive(&ia); + } +} + +static void isSocketReadable(zhandle_t* zh) +{ +#ifndef WIN32 + struct pollfd fds; + fds.fd = zh->fd; + fds.events = POLLIN; + if (poll(&fds,1,0)<=0) { + // socket not readable -- no more responses to process + zh->socket_readable.tv_sec=zh->socket_readable.tv_usec=0; + } +#else + fd_set rfds; + struct timeval waittime = {0, 0}; + FD_ZERO(&rfds); + FD_SET( zh->fd , &rfds); + if (select(0, &rfds, NULL, NULL, &waittime) <= 0){ + // socket not readable -- no more responses to process + zh->socket_readable.tv_sec=zh->socket_readable.tv_usec=0; + } +#endif + else{ + gettimeofday(&zh->socket_readable,0); + } +} + +static void checkResponseLatency(zhandle_t* zh) +{ + int delay; + struct timeval now; + + if(zh->socket_readable.tv_sec==0) + return; + + gettimeofday(&now,0); + delay=calculate_interval(&zh->socket_readable, &now); + if(delay>20) + LOG_DEBUG(("The following server response has spent at least %dms sitting in the client socket recv buffer",delay)); + + zh->socket_readable.tv_sec=zh->socket_readable.tv_usec=0; +} + +int zookeeper_process(zhandle_t *zh, int events) +{ + buffer_list_t *bptr; + int rc; + + if (zh==NULL) + return ZBADARGUMENTS; + if (is_unrecoverable(zh)) + return ZINVALIDSTATE; + api_prolog(zh); + IF_DEBUG(checkResponseLatency(zh)); + rc = check_events(zh, events); + if (rc!=ZOK) + return api_epilog(zh, rc); + + IF_DEBUG(isSocketReadable(zh)); + + while (rc >= 0 && (bptr=dequeue_buffer(&zh->to_process))) { + struct ReplyHeader hdr; + struct iarchive *ia = create_buffer_iarchive( + bptr->buffer, bptr->curr_offset); + deserialize_ReplyHeader(ia, "hdr", &hdr); + if (hdr.zxid > 0) { + zh->last_zxid = hdr.zxid; + } else { + // fprintf(stderr, "Got %#x for %#x\n", hdr.zxid, hdr.xid); + } + + if (hdr.xid == PING_XID) { + // Ping replies can arrive out-of-order + int elapsed = 0; + struct timeval now; + gettimeofday(&now, 0); + elapsed = calculate_interval(&zh->last_ping, &now); + LOG_DEBUG(("Got ping response in %d ms", elapsed)); + free_buffer(bptr); + } else if (hdr.xid == WATCHER_EVENT_XID) { + struct WatcherEvent evt; + int type = 0; + char *path = NULL; + completion_list_t *c = NULL; + + LOG_DEBUG(("Processing WATCHER_EVENT")); + + deserialize_WatcherEvent(ia, "event", &evt); + type = evt.type; + path = evt.path; + /* We are doing a notification, so there is no pending request */ + c = create_completion_entry(WATCHER_EVENT_XID,-1,0,0,0,0); + c->buffer = bptr; + c->c.watcher_result = collectWatchers(zh, type, path); + + // We cannot free until now, otherwise path will become invalid + deallocate_WatcherEvent(&evt); + queue_completion(&zh->completions_to_process, c, 0); + } else if (hdr.xid == SET_WATCHES_XID) { + LOG_DEBUG(("Processing SET_WATCHES")); + free_buffer(bptr); + } else if (hdr.xid == AUTH_XID){ + LOG_DEBUG(("Processing AUTH_XID")); + + /* special handling for the AUTH response as it may come back + * out-of-band */ + auth_completion_func(hdr.err,zh); + free_buffer(bptr); + /* authentication completion may change the connection state to + * unrecoverable */ + if(is_unrecoverable(zh)){ + handle_error(zh, ZAUTHFAILED); + close_buffer_iarchive(&ia); + return api_epilog(zh, ZAUTHFAILED); + } + } else { + int rc = hdr.err; + /* Find the request corresponding to the response */ + completion_list_t *cptr = dequeue_completion(&zh->sent_requests); + + /* [ZOOKEEPER-804] Don't assert if zookeeper_close has been called. */ + if (zh->close_requested == 1 && cptr == NULL) { + LOG_DEBUG(("Completion queue has been cleared by zookeeper_close()")); + close_buffer_iarchive(&ia); + free_buffer(bptr); + return api_epilog(zh,ZINVALIDSTATE); + } + assert(cptr); + /* The requests are going to come back in order */ + if (cptr->xid != hdr.xid) { + LOG_DEBUG(("Processing unexpected or out-of-order response!")); + + // received unexpected (or out-of-order) response + close_buffer_iarchive(&ia); + free_buffer(bptr); + // put the completion back on the queue (so it gets properly + // signaled and deallocated) and disconnect from the server + queue_completion(&zh->sent_requests,cptr,1); + return api_epilog(zh, + handle_socket_error_msg(zh, __LINE__,ZRUNTIMEINCONSISTENCY, + "unexpected server response: expected %#x, but received %#x", + hdr.xid,cptr->xid)); + } + + activateWatcher(zh, cptr->watcher, rc); + + if (cptr->c.void_result != SYNCHRONOUS_MARKER) { + LOG_DEBUG(("Queueing asynchronous response")); + cptr->buffer = bptr; + queue_completion(&zh->completions_to_process, cptr, 0); + } else { + struct sync_completion + *sc = (struct sync_completion*)cptr->data; + sc->rc = rc; + + process_sync_completion(cptr, sc, ia, zh); + + notify_sync_completion(sc); + free_buffer(bptr); + zh->outstanding_sync--; + destroy_completion_entry(cptr); + } + } + + close_buffer_iarchive(&ia); + + } + if (process_async(zh->outstanding_sync)) { + process_completions(zh); + } + return api_epilog(zh,ZOK);} + +int zoo_state(zhandle_t *zh) +{ + if(zh!=0) + return zh->state; + return 0; +} + +static watcher_registration_t* create_watcher_registration(const char* path, + result_checker_fn checker,watcher_fn watcher,void* ctx){ + watcher_registration_t* wo; + if(watcher==0) + return 0; + wo=calloc(1,sizeof(watcher_registration_t)); + wo->path=strdup(path); + wo->watcher=watcher; + wo->context=ctx; + wo->checker=checker; + return wo; +} + +static void destroy_watcher_registration(watcher_registration_t* wo){ + if(wo!=0){ + free((void*)wo->path); + free(wo); + } +} + +static completion_list_t* create_completion_entry(int xid, int completion_type, + const void *dc, const void *data,watcher_registration_t* wo, completion_head_t *clist) +{ + completion_list_t *c = calloc(1,sizeof(completion_list_t)); + if (!c) { + LOG_ERROR(("out of memory")); + return 0; + } + c->c.type = completion_type; + c->data = data; + switch(c->c.type) { + case COMPLETION_VOID: + c->c.void_result = (void_completion_t)dc; + break; + case COMPLETION_STRING: + c->c.string_result = (string_completion_t)dc; + break; + case COMPLETION_DATA: + c->c.data_result = (data_completion_t)dc; + break; + case COMPLETION_STAT: + c->c.stat_result = (stat_completion_t)dc; + break; + case COMPLETION_STRINGLIST: + c->c.strings_result = (strings_completion_t)dc; + break; + case COMPLETION_STRINGLIST_STAT: + c->c.strings_stat_result = (strings_stat_completion_t)dc; + break; + case COMPLETION_ACLLIST: + c->c.acl_result = (acl_completion_t)dc; + break; + case COMPLETION_MULTI: + assert(clist); + c->c.void_result = (void_completion_t)dc; + c->c.clist = *clist; + break; + } + c->xid = xid; + c->watcher = wo; + + return c; +} + +static void destroy_completion_entry(completion_list_t* c){ + if(c!=0){ + destroy_watcher_registration(c->watcher); + if(c->buffer!=0) + free_buffer(c->buffer); + free(c); + } +} + +static void queue_completion_nolock(completion_head_t *list, + completion_list_t *c, + int add_to_front) +{ + c->next = 0; + /* appending a new entry to the back of the list */ + if (list->last) { + assert(list->head); + // List is not empty + if (!add_to_front) { + list->last->next = c; + list->last = c; + } else { + c->next = list->head; + list->head = c; + } + } else { + // List is empty + assert(!list->head); + list->head = c; + list->last = c; + } +} + +static void queue_completion(completion_head_t *list, completion_list_t *c, + int add_to_front) +{ + + lock_completion_list(list); + queue_completion_nolock(list, c, add_to_front); + unlock_completion_list(list); +} + +static int add_completion(zhandle_t *zh, int xid, int completion_type, + const void *dc, const void *data, int add_to_front, + watcher_registration_t* wo, completion_head_t *clist) +{ + completion_list_t *c =create_completion_entry(xid, completion_type, dc, + data, wo, clist); + int rc = 0; + if (!c) + return ZSYSTEMERROR; + lock_completion_list(&zh->sent_requests); + if (zh->close_requested != 1) { + queue_completion_nolock(&zh->sent_requests, c, add_to_front); + if (dc == SYNCHRONOUS_MARKER) { + zh->outstanding_sync++; + } + rc = ZOK; + } else { + free(c); + rc = ZINVALIDSTATE; + } + unlock_completion_list(&zh->sent_requests); + return rc; +} + +static int add_data_completion(zhandle_t *zh, int xid, data_completion_t dc, + const void *data,watcher_registration_t* wo) +{ + return add_completion(zh, xid, COMPLETION_DATA, dc, data, 0, wo, 0); +} + +static int add_stat_completion(zhandle_t *zh, int xid, stat_completion_t dc, + const void *data,watcher_registration_t* wo) +{ + return add_completion(zh, xid, COMPLETION_STAT, dc, data, 0, wo, 0); +} + +static int add_strings_completion(zhandle_t *zh, int xid, + strings_completion_t dc, const void *data,watcher_registration_t* wo) +{ + return add_completion(zh, xid, COMPLETION_STRINGLIST, dc, data, 0, wo, 0); +} + +static int add_strings_stat_completion(zhandle_t *zh, int xid, + strings_stat_completion_t dc, const void *data,watcher_registration_t* wo) +{ + return add_completion(zh, xid, COMPLETION_STRINGLIST_STAT, dc, data, 0, wo, 0); +} + +static int add_acl_completion(zhandle_t *zh, int xid, acl_completion_t dc, + const void *data) +{ + return add_completion(zh, xid, COMPLETION_ACLLIST, dc, data, 0, 0, 0); +} + +static int add_void_completion(zhandle_t *zh, int xid, void_completion_t dc, + const void *data) +{ + return add_completion(zh, xid, COMPLETION_VOID, dc, data, 0, 0, 0); +} + +static int add_string_completion(zhandle_t *zh, int xid, + string_completion_t dc, const void *data) +{ + return add_completion(zh, xid, COMPLETION_STRING, dc, data, 0, 0, 0); +} + +static int add_multi_completion(zhandle_t *zh, int xid, void_completion_t dc, + const void *data, completion_head_t *clist) +{ + return add_completion(zh, xid, COMPLETION_MULTI, dc, data, 0,0, clist); +} + +int zookeeper_close(zhandle_t *zh) +{ + int rc=ZOK; + if (zh==0) + return ZBADARGUMENTS; + + zh->close_requested=1; + if (inc_ref_counter(zh,1)>1) { + /* We have incremented the ref counter to prevent the + * completions from calling zookeeper_close before we have + * completed the adaptor_finish call below. */ + + /* Signal any syncronous completions before joining the threads */ + enter_critical(zh); + free_completions(zh,1,ZCLOSING); + leave_critical(zh); + + adaptor_finish(zh); + /* Now we can allow the handle to be cleaned up, if the completion + * threads finished during the adaptor_finish call. */ + api_epilog(zh, 0); + return ZOK; + } + /* No need to decrement the counter since we're just going to + * destroy the handle later. */ + if(zh->state==ZOO_CONNECTED_STATE){ + struct oarchive *oa; + struct RequestHeader h = { STRUCT_INITIALIZER (xid , get_xid()), STRUCT_INITIALIZER (type , ZOO_CLOSE_OP)}; + LOG_INFO(("Closing zookeeper sessionId=%#llx to [%s]\n", + zh->client_id.client_id,format_current_endpoint_info(zh))); + oa = create_buffer_oarchive(); + rc = serialize_RequestHeader(oa, "header", &h); + rc = rc < 0 ? rc : queue_buffer_bytes(&zh->to_send, get_buffer(oa), + get_buffer_len(oa)); + /* We queued the buffer, so don't free it */ + close_buffer_oarchive(&oa, 0); + if (rc < 0) { + rc = ZMARSHALLINGERROR; + goto finish; + } + + /* make sure the close request is sent; we set timeout to an arbitrary + * (but reasonable) number of milliseconds since we want the call to block*/ + rc=adaptor_send_queue(zh, 3000); + }else{ + LOG_INFO(("Freeing zookeeper resources for sessionId=%#llx\n", + zh->client_id.client_id)); + rc = ZOK; + } + +finish: + destroy(zh); + adaptor_destroy(zh); + free(zh); +#ifdef WIN32 + Win32WSACleanup(); +#endif + return rc; +} + +static int isValidPath(const char* path, const int flags) { + int len = 0; + char lastc = '/'; + char c; + int i = 0; + + if (path == 0) + return 0; + len = strlen(path); + if (len == 0) + return 0; + if (path[0] != '/') + return 0; + if (len == 1) // done checking - it's the root + return 1; + if (path[len - 1] == '/' && !(flags & ZOO_SEQUENCE)) + return 0; + + i = 1; + for (; i < len; lastc = path[i], i++) { + c = path[i]; + + if (c == 0) { + return 0; + } else if (c == '/' && lastc == '/') { + return 0; + } else if (c == '.' && lastc == '.') { + if (path[i-2] == '/' && (((i + 1 == len) && !(flags & ZOO_SEQUENCE)) + || path[i+1] == '/')) { + return 0; + } + } else if (c == '.') { + if ((path[i-1] == '/') && (((i + 1 == len) && !(flags & ZOO_SEQUENCE)) + || path[i+1] == '/')) { + return 0; + } + } else if (c > 0x00 && c < 0x1f) { + return 0; + } + } + + return 1; +} + +/*---------------------------------------------------------------------------* + * REQUEST INIT HELPERS + *---------------------------------------------------------------------------*/ +/* Common Request init helper functions to reduce code duplication */ +static int Request_path_init(zhandle_t *zh, int flags, + char **path_out, const char *path) +{ + assert(path_out); + + *path_out = prepend_string(zh, path); + if (zh == NULL || !isValidPath(*path_out, flags)) { + free_duplicate_path(*path_out, path); + return ZBADARGUMENTS; + } + if (is_unrecoverable(zh)) { + free_duplicate_path(*path_out, path); + return ZINVALIDSTATE; + } + + return ZOK; +} + +static int Request_path_watch_init(zhandle_t *zh, int flags, + char **path_out, const char *path, + int32_t *watch_out, uint32_t watch) +{ + int rc = Request_path_init(zh, flags, path_out, path); + if (rc != ZOK) { + return rc; + } + *watch_out = watch; + return ZOK; +} + +/*---------------------------------------------------------------------------* + * ASYNC API + *---------------------------------------------------------------------------*/ +int zoo_aget(zhandle_t *zh, const char *path, int watch, data_completion_t dc, + const void *data) +{ + return zoo_awget(zh,path,watch?zh->watcher:0,zh->context,dc,data); +} + +int zoo_awget(zhandle_t *zh, const char *path, + watcher_fn watcher, void* watcherCtx, + data_completion_t dc, const void *data) +{ + struct oarchive *oa; + char *server_path = prepend_string(zh, path); + struct RequestHeader h = { STRUCT_INITIALIZER (xid , get_xid()), STRUCT_INITIALIZER (type ,ZOO_GETDATA_OP)}; + struct GetDataRequest req = { (char*)server_path, watcher!=0 }; + int rc; + + if (zh==0 || !isValidPath(server_path, 0)) { + free_duplicate_path(server_path, path); + return ZBADARGUMENTS; + } + if (is_unrecoverable(zh)) { + free_duplicate_path(server_path, path); + return ZINVALIDSTATE; + } + oa=create_buffer_oarchive(); + rc = serialize_RequestHeader(oa, "header", &h); + rc = rc < 0 ? rc : serialize_GetDataRequest(oa, "req", &req); + enter_critical(zh); + rc = rc < 0 ? rc : add_data_completion(zh, h.xid, dc, data, + create_watcher_registration(server_path,data_result_checker,watcher,watcherCtx)); + rc = rc < 0 ? rc : queue_buffer_bytes(&zh->to_send, get_buffer(oa), + get_buffer_len(oa)); + leave_critical(zh); + free_duplicate_path(server_path, path); + /* We queued the buffer, so don't free it */ + close_buffer_oarchive(&oa, 0); + + LOG_DEBUG(("Sending request xid=%#x for path [%s] to %s",h.xid,path, + format_current_endpoint_info(zh))); + /* make a best (non-blocking) effort to send the requests asap */ + adaptor_send_queue(zh, 0); + return (rc < 0)?ZMARSHALLINGERROR:ZOK; +} + +static int SetDataRequest_init(zhandle_t *zh, struct SetDataRequest *req, + const char *path, const char *buffer, int buflen, int version) +{ + int rc; + assert(req); + rc = Request_path_init(zh, 0, &req->path, path); + if (rc != ZOK) { + return rc; + } + req->data.buff = (char*)buffer; + req->data.len = buflen; + req->version = version; + + return ZOK; +} + +int zoo_aset(zhandle_t *zh, const char *path, const char *buffer, int buflen, + int version, stat_completion_t dc, const void *data) +{ + struct oarchive *oa; + struct RequestHeader h = { STRUCT_INITIALIZER(xid , get_xid()), STRUCT_INITIALIZER (type , ZOO_SETDATA_OP)}; + struct SetDataRequest req; + int rc = SetDataRequest_init(zh, &req, path, buffer, buflen, version); + if (rc != ZOK) { + return rc; + } + oa = create_buffer_oarchive(); + rc = serialize_RequestHeader(oa, "header", &h); + rc = rc < 0 ? rc : serialize_SetDataRequest(oa, "req", &req); + enter_critical(zh); + rc = rc < 0 ? rc : add_stat_completion(zh, h.xid, dc, data,0); + rc = rc < 0 ? rc : queue_buffer_bytes(&zh->to_send, get_buffer(oa), + get_buffer_len(oa)); + leave_critical(zh); + free_duplicate_path(req.path, path); + /* We queued the buffer, so don't free it */ + close_buffer_oarchive(&oa, 0); + + LOG_DEBUG(("Sending request xid=%#x for path [%s] to %s",h.xid,path, + format_current_endpoint_info(zh))); + /* make a best (non-blocking) effort to send the requests asap */ + adaptor_send_queue(zh, 0); + return (rc < 0)?ZMARSHALLINGERROR:ZOK; +} + +static int CreateRequest_init(zhandle_t *zh, struct CreateRequest *req, + const char *path, const char *value, + int valuelen, const struct ACL_vector *acl_entries, int flags) +{ + int rc; + assert(req); + rc = Request_path_init(zh, flags, &req->path, path); + assert(req); + if (rc != ZOK) { + return rc; + } + req->flags = flags; + req->data.buff = (char*)value; + req->data.len = valuelen; + if (acl_entries == 0) { + req->acl.count = 0; + req->acl.data = 0; + } else { + req->acl = *acl_entries; + } + + return ZOK; +} + +int zoo_acreate(zhandle_t *zh, const char *path, const char *value, + int valuelen, const struct ACL_vector *acl_entries, int flags, + string_completion_t completion, const void *data) +{ + struct oarchive *oa; + struct RequestHeader h = { STRUCT_INITIALIZER (xid , get_xid()), STRUCT_INITIALIZER (type ,ZOO_CREATE_OP) }; + struct CreateRequest req; + + int rc = CreateRequest_init(zh, &req, + path, value, valuelen, acl_entries, flags); + if (rc != ZOK) { + return rc; + } + oa = create_buffer_oarchive(); + rc = serialize_RequestHeader(oa, "header", &h); + rc = rc < 0 ? rc : serialize_CreateRequest(oa, "req", &req); + enter_critical(zh); + rc = rc < 0 ? rc : add_string_completion(zh, h.xid, completion, data); + rc = rc < 0 ? rc : queue_buffer_bytes(&zh->to_send, get_buffer(oa), + get_buffer_len(oa)); + leave_critical(zh); + free_duplicate_path(req.path, path); + /* We queued the buffer, so don't free it */ + close_buffer_oarchive(&oa, 0); + + LOG_DEBUG(("Sending request xid=%#x for path [%s] to %s",h.xid,path, + format_current_endpoint_info(zh))); + /* make a best (non-blocking) effort to send the requests asap */ + adaptor_send_queue(zh, 0); + return (rc < 0)?ZMARSHALLINGERROR:ZOK; +} + +int DeleteRequest_init(zhandle_t *zh, struct DeleteRequest *req, + const char *path, int version) +{ + int rc = Request_path_init(zh, 0, &req->path, path); + if (rc != ZOK) { + return rc; + } + req->version = version; + return ZOK; +} + +int zoo_adelete(zhandle_t *zh, const char *path, int version, + void_completion_t completion, const void *data) +{ + struct oarchive *oa; + struct RequestHeader h = { STRUCT_INITIALIZER (xid , get_xid()), STRUCT_INITIALIZER (type , ZOO_DELETE_OP)}; + struct DeleteRequest req; + int rc = DeleteRequest_init(zh, &req, path, version); + if (rc != ZOK) { + return rc; + } + oa = create_buffer_oarchive(); + rc = serialize_RequestHeader(oa, "header", &h); + rc = rc < 0 ? rc : serialize_DeleteRequest(oa, "req", &req); + enter_critical(zh); + rc = rc < 0 ? rc : add_void_completion(zh, h.xid, completion, data); + rc = rc < 0 ? rc : queue_buffer_bytes(&zh->to_send, get_buffer(oa), + get_buffer_len(oa)); + leave_critical(zh); + free_duplicate_path(req.path, path); + /* We queued the buffer, so don't free it */ + close_buffer_oarchive(&oa, 0); + + LOG_DEBUG(("Sending request xid=%#x for path [%s] to %s",h.xid,path, + format_current_endpoint_info(zh))); + /* make a best (non-blocking) effort to send the requests asap */ + adaptor_send_queue(zh, 0); + return (rc < 0)?ZMARSHALLINGERROR:ZOK; +} + +int zoo_aexists(zhandle_t *zh, const char *path, int watch, + stat_completion_t sc, const void *data) +{ + return zoo_awexists(zh,path,watch?zh->watcher:0,zh->context,sc,data); +} + +int zoo_awexists(zhandle_t *zh, const char *path, + watcher_fn watcher, void* watcherCtx, + stat_completion_t completion, const void *data) +{ + struct oarchive *oa; + struct RequestHeader h = { STRUCT_INITIALIZER (xid ,get_xid()), STRUCT_INITIALIZER (type , ZOO_EXISTS_OP) }; + struct ExistsRequest req; + int rc = Request_path_watch_init(zh, 0, &req.path, path, + &req.watch, watcher != NULL); + if (rc != ZOK) { + return rc; + } + oa = create_buffer_oarchive(); + rc = serialize_RequestHeader(oa, "header", &h); + rc = rc < 0 ? rc : serialize_ExistsRequest(oa, "req", &req); + enter_critical(zh); + rc = rc < 0 ? rc : add_stat_completion(zh, h.xid, completion, data, + create_watcher_registration(req.path,exists_result_checker, + watcher,watcherCtx)); + rc = rc < 0 ? rc : queue_buffer_bytes(&zh->to_send, get_buffer(oa), + get_buffer_len(oa)); + leave_critical(zh); + free_duplicate_path(req.path, path); + /* We queued the buffer, so don't free it */ + close_buffer_oarchive(&oa, 0); + + LOG_DEBUG(("Sending request xid=%#x for path [%s] to %s",h.xid,path, + format_current_endpoint_info(zh))); + /* make a best (non-blocking) effort to send the requests asap */ + adaptor_send_queue(zh, 0); + return (rc < 0)?ZMARSHALLINGERROR:ZOK; +} + +static int zoo_awget_children_(zhandle_t *zh, const char *path, + watcher_fn watcher, void* watcherCtx, + strings_completion_t sc, + const void *data) +{ + struct oarchive *oa; + struct RequestHeader h = { STRUCT_INITIALIZER (xid , get_xid()), STRUCT_INITIALIZER (type , ZOO_GETCHILDREN_OP)}; + struct GetChildrenRequest req ; + int rc = Request_path_watch_init(zh, 0, &req.path, path, + &req.watch, watcher != NULL); + if (rc != ZOK) { + return rc; + } + oa = create_buffer_oarchive(); + rc = serialize_RequestHeader(oa, "header", &h); + rc = rc < 0 ? rc : serialize_GetChildrenRequest(oa, "req", &req); + enter_critical(zh); + rc = rc < 0 ? rc : add_strings_completion(zh, h.xid, sc, data, + create_watcher_registration(req.path,child_result_checker,watcher,watcherCtx)); + rc = rc < 0 ? rc : queue_buffer_bytes(&zh->to_send, get_buffer(oa), + get_buffer_len(oa)); + leave_critical(zh); + free_duplicate_path(req.path, path); + /* We queued the buffer, so don't free it */ + close_buffer_oarchive(&oa, 0); + + LOG_DEBUG(("Sending request xid=%#x for path [%s] to %s",h.xid,path, + format_current_endpoint_info(zh))); + /* make a best (non-blocking) effort to send the requests asap */ + adaptor_send_queue(zh, 0); + return (rc < 0)?ZMARSHALLINGERROR:ZOK; +} + +int zoo_aget_children(zhandle_t *zh, const char *path, int watch, + strings_completion_t dc, const void *data) +{ + return zoo_awget_children_(zh,path,watch?zh->watcher:0,zh->context,dc,data); +} + +int zoo_awget_children(zhandle_t *zh, const char *path, + watcher_fn watcher, void* watcherCtx, + strings_completion_t dc, + const void *data) +{ + return zoo_awget_children_(zh,path,watcher,watcherCtx,dc,data); +} + +static int zoo_awget_children2_(zhandle_t *zh, const char *path, + watcher_fn watcher, void* watcherCtx, + strings_stat_completion_t ssc, + const void *data) +{ + /* invariant: (sc == NULL) != (sc == NULL) */ + struct oarchive *oa; + struct RequestHeader h = { STRUCT_INITIALIZER( xid, get_xid()), STRUCT_INITIALIZER (type ,ZOO_GETCHILDREN2_OP)}; + struct GetChildren2Request req ; + int rc = Request_path_watch_init(zh, 0, &req.path, path, + &req.watch, watcher != NULL); + if (rc != ZOK) { + return rc; + } + oa = create_buffer_oarchive(); + rc = serialize_RequestHeader(oa, "header", &h); + rc = rc < 0 ? rc : serialize_GetChildren2Request(oa, "req", &req); + enter_critical(zh); + rc = rc < 0 ? rc : add_strings_stat_completion(zh, h.xid, ssc, data, + create_watcher_registration(req.path,child_result_checker,watcher,watcherCtx)); + rc = rc < 0 ? rc : queue_buffer_bytes(&zh->to_send, get_buffer(oa), + get_buffer_len(oa)); + leave_critical(zh); + free_duplicate_path(req.path, path); + /* We queued the buffer, so don't free it */ + close_buffer_oarchive(&oa, 0); + + LOG_DEBUG(("Sending request xid=%#x for path [%s] to %s",h.xid,path, + format_current_endpoint_info(zh))); + /* make a best (non-blocking) effort to send the requests asap */ + adaptor_send_queue(zh, 0); + return (rc < 0)?ZMARSHALLINGERROR:ZOK; +} + +int zoo_aget_children2(zhandle_t *zh, const char *path, int watch, + strings_stat_completion_t dc, const void *data) +{ + return zoo_awget_children2_(zh,path,watch?zh->watcher:0,zh->context,dc,data); +} + +int zoo_awget_children2(zhandle_t *zh, const char *path, + watcher_fn watcher, void* watcherCtx, + strings_stat_completion_t dc, + const void *data) +{ + return zoo_awget_children2_(zh,path,watcher,watcherCtx,dc,data); +} + +int zoo_async(zhandle_t *zh, const char *path, + string_completion_t completion, const void *data) +{ + struct oarchive *oa; + struct RequestHeader h = { STRUCT_INITIALIZER (xid , get_xid()), STRUCT_INITIALIZER (type , ZOO_SYNC_OP)}; + struct SyncRequest req; + int rc = Request_path_init(zh, 0, &req.path, path); + if (rc != ZOK) { + return rc; + } + oa = create_buffer_oarchive(); + rc = serialize_RequestHeader(oa, "header", &h); + rc = rc < 0 ? rc : serialize_SyncRequest(oa, "req", &req); + enter_critical(zh); + rc = rc < 0 ? rc : add_string_completion(zh, h.xid, completion, data); + rc = rc < 0 ? rc : queue_buffer_bytes(&zh->to_send, get_buffer(oa), + get_buffer_len(oa)); + leave_critical(zh); + free_duplicate_path(req.path, path); + /* We queued the buffer, so don't free it */ + close_buffer_oarchive(&oa, 0); + + LOG_DEBUG(("Sending request xid=%#x for path [%s] to %s",h.xid,path, + format_current_endpoint_info(zh))); + /* make a best (non-blocking) effort to send the requests asap */ + adaptor_send_queue(zh, 0); + return (rc < 0)?ZMARSHALLINGERROR:ZOK; +} + + +int zoo_aget_acl(zhandle_t *zh, const char *path, acl_completion_t completion, + const void *data) +{ + struct oarchive *oa; + struct RequestHeader h = { STRUCT_INITIALIZER (xid , get_xid()), STRUCT_INITIALIZER(type ,ZOO_GETACL_OP)}; + struct GetACLRequest req; + int rc = Request_path_init(zh, 0, &req.path, path) ; + if (rc != ZOK) { + return rc; + } + oa = create_buffer_oarchive(); + rc = serialize_RequestHeader(oa, "header", &h); + rc = rc < 0 ? rc : serialize_GetACLRequest(oa, "req", &req); + enter_critical(zh); + rc = rc < 0 ? rc : add_acl_completion(zh, h.xid, completion, data); + rc = rc < 0 ? rc : queue_buffer_bytes(&zh->to_send, get_buffer(oa), + get_buffer_len(oa)); + leave_critical(zh); + free_duplicate_path(req.path, path); + /* We queued the buffer, so don't free it */ + close_buffer_oarchive(&oa, 0); + + LOG_DEBUG(("Sending request xid=%#x for path [%s] to %s",h.xid,path, + format_current_endpoint_info(zh))); + /* make a best (non-blocking) effort to send the requests asap */ + adaptor_send_queue(zh, 0); + return (rc < 0)?ZMARSHALLINGERROR:ZOK; +} + +int zoo_aset_acl(zhandle_t *zh, const char *path, int version, + struct ACL_vector *acl, void_completion_t completion, const void *data) +{ + struct oarchive *oa; + struct RequestHeader h = { STRUCT_INITIALIZER(xid ,get_xid()), STRUCT_INITIALIZER (type , ZOO_SETACL_OP)}; + struct SetACLRequest req; + int rc = Request_path_init(zh, 0, &req.path, path); + if (rc != ZOK) { + return rc; + } + oa = create_buffer_oarchive(); + req.acl = *acl; + req.version = version; + rc = serialize_RequestHeader(oa, "header", &h); + rc = rc < 0 ? rc : serialize_SetACLRequest(oa, "req", &req); + enter_critical(zh); + rc = rc < 0 ? rc : add_void_completion(zh, h.xid, completion, data); + rc = rc < 0 ? rc : queue_buffer_bytes(&zh->to_send, get_buffer(oa), + get_buffer_len(oa)); + leave_critical(zh); + free_duplicate_path(req.path, path); + /* We queued the buffer, so don't free it */ + close_buffer_oarchive(&oa, 0); + + LOG_DEBUG(("Sending request xid=%#x for path [%s] to %s",h.xid,path, + format_current_endpoint_info(zh))); + /* make a best (non-blocking) effort to send the requests asap */ + adaptor_send_queue(zh, 0); + return (rc < 0)?ZMARSHALLINGERROR:ZOK; +} + +/* Completions for multi-op results */ +static void op_result_string_completion(int err, const char *value, const void *data) +{ + struct zoo_op_result *result = (struct zoo_op_result *)data; + assert(result); + result->err = err; + + if (result->value && value) { + int len = strlen(value) + 1; + if (len > result->valuelen) { + len = result->valuelen; + } + if (len > 0) { + memcpy(result->value, value, len - 1); + result->value[len - 1] = '\0'; + } + } else { + result->value = NULL; + } +} + +static void op_result_void_completion(int err, const void *data) +{ + struct zoo_op_result *result = (struct zoo_op_result *)data; + assert(result); + result->err = err; +} + +static void op_result_stat_completion(int err, const struct Stat *stat, const void *data) +{ + struct zoo_op_result *result = (struct zoo_op_result *)data; + assert(result); + result->err = err; + + if (result->stat && err == 0 && stat) { + *result->stat = *stat; + } else { + result->stat = NULL ; + } +} + +static int CheckVersionRequest_init(zhandle_t *zh, struct CheckVersionRequest *req, + const char *path, int version) +{ + int rc ; + assert(req); + rc = Request_path_init(zh, 0, &req->path, path); + if (rc != ZOK) { + return rc; + } + req->version = version; + + return ZOK; +} + +int zoo_amulti(zhandle_t *zh, int count, const zoo_op_t *ops, + zoo_op_result_t *results, void_completion_t completion, const void *data) +{ + struct RequestHeader h = { STRUCT_INITIALIZER(xid, get_xid()), STRUCT_INITIALIZER(type, ZOO_MULTI_OP) }; + struct MultiHeader mh = { STRUCT_INITIALIZER(type, -1), STRUCT_INITIALIZER(done, 1), STRUCT_INITIALIZER(err, -1) }; + struct oarchive *oa = create_buffer_oarchive(); + completion_head_t clist = { 0 }; + + int rc = serialize_RequestHeader(oa, "header", &h); + + int index = 0; + for (index=0; index < count; index++) { + const zoo_op_t *op = ops+index; + zoo_op_result_t *result = results+index; + completion_list_t *entry = NULL; + + struct MultiHeader mh = { STRUCT_INITIALIZER(type, op->type), STRUCT_INITIALIZER(done, 0), STRUCT_INITIALIZER(err, -1) }; + rc = rc < 0 ? rc : serialize_MultiHeader(oa, "multiheader", &mh); + + switch(op->type) { + case ZOO_CREATE_OP: { + struct CreateRequest req; + + rc = rc < 0 ? rc : CreateRequest_init(zh, &req, + op->create_op.path, op->create_op.data, + op->create_op.datalen, op->create_op.acl, + op->create_op.flags); + rc = rc < 0 ? rc : serialize_CreateRequest(oa, "req", &req); + result->value = op->create_op.buf; + result->valuelen = op->create_op.buflen; + + enter_critical(zh); + entry = create_completion_entry(h.xid, COMPLETION_STRING, op_result_string_completion, result, 0, 0); + leave_critical(zh); + free_duplicate_path(req.path, op->create_op.path); + break; + } + + case ZOO_DELETE_OP: { + struct DeleteRequest req; + rc = rc < 0 ? rc : DeleteRequest_init(zh, &req, op->delete_op.path, op->delete_op.version); + rc = rc < 0 ? rc : serialize_DeleteRequest(oa, "req", &req); + + enter_critical(zh); + entry = create_completion_entry(h.xid, COMPLETION_VOID, op_result_void_completion, result, 0, 0); + leave_critical(zh); + free_duplicate_path(req.path, op->delete_op.path); + break; + } + + case ZOO_SETDATA_OP: { + struct SetDataRequest req; + rc = rc < 0 ? rc : SetDataRequest_init(zh, &req, + op->set_op.path, op->set_op.data, + op->set_op.datalen, op->set_op.version); + rc = rc < 0 ? rc : serialize_SetDataRequest(oa, "req", &req); + result->stat = op->set_op.stat; + + enter_critical(zh); + entry = create_completion_entry(h.xid, COMPLETION_STAT, op_result_stat_completion, result, 0, 0); + leave_critical(zh); + free_duplicate_path(req.path, op->set_op.path); + break; + } + + case ZOO_CHECK_OP: { + struct CheckVersionRequest req; + rc = rc < 0 ? rc : CheckVersionRequest_init(zh, &req, + op->check_op.path, op->check_op.version); + rc = rc < 0 ? rc : serialize_CheckVersionRequest(oa, "req", &req); + + enter_critical(zh); + entry = create_completion_entry(h.xid, COMPLETION_VOID, op_result_void_completion, result, 0, 0); + leave_critical(zh); + free_duplicate_path(req.path, op->check_op.path); + break; + } + + default: + LOG_ERROR(("Unimplemented sub-op type=%d in multi-op", op->type)); + return ZUNIMPLEMENTED; + } + + queue_completion(&clist, entry, 0); + } + + rc = rc < 0 ? rc : serialize_MultiHeader(oa, "multiheader", &mh); + + /* BEGIN: CRTICIAL SECTION */ + enter_critical(zh); + rc = rc < 0 ? rc : add_multi_completion(zh, h.xid, completion, data, &clist); + rc = rc < 0 ? rc : queue_buffer_bytes(&zh->to_send, get_buffer(oa), + get_buffer_len(oa)); + leave_critical(zh); + + /* We queued the buffer, so don't free it */ + close_buffer_oarchive(&oa, 0); + + LOG_DEBUG(("Sending multi request xid=%#x with %d subrequests to %s", + h.xid, index, format_current_endpoint_info(zh))); + /* make a best (non-blocking) effort to send the requests asap */ + adaptor_send_queue(zh, 0); + + return (rc < 0) ? ZMARSHALLINGERROR : ZOK; +} + +void zoo_create_op_init(zoo_op_t *op, const char *path, const char *value, + int valuelen, const struct ACL_vector *acl, int flags, + char *path_buffer, int path_buffer_len) +{ + assert(op); + op->type = ZOO_CREATE_OP; + op->create_op.path = path; + op->create_op.data = value; + op->create_op.datalen = valuelen; + op->create_op.acl = acl; + op->create_op.flags = flags; + op->create_op.buf = path_buffer; + op->create_op.buflen = path_buffer_len; +} + +void zoo_delete_op_init(zoo_op_t *op, const char *path, int version) +{ + assert(op); + op->type = ZOO_DELETE_OP; + op->delete_op.path = path; + op->delete_op.version = version; +} + +void zoo_set_op_init(zoo_op_t *op, const char *path, const char *buffer, + int buflen, int version, struct Stat *stat) +{ + assert(op); + op->type = ZOO_SETDATA_OP; + op->set_op.path = path; + op->set_op.data = buffer; + op->set_op.datalen = buflen; + op->set_op.version = version; + op->set_op.stat = stat; +} + +void zoo_check_op_init(zoo_op_t *op, const char *path, int version) +{ + assert(op); + op->type = ZOO_CHECK_OP; + op->check_op.path = path; + op->check_op.version = version; +} + +int zoo_multi(zhandle_t *zh, int count, const zoo_op_t *ops, zoo_op_result_t *results) +{ + int rc; + + struct sync_completion *sc = alloc_sync_completion(); + if (!sc) { + return ZSYSTEMERROR; + } + + rc = zoo_amulti(zh, count, ops, results, SYNCHRONOUS_MARKER, sc); + if (rc == ZOK) { + wait_sync_completion(sc); + rc = sc->rc; + } + free_sync_completion(sc); + + return rc; +} + +/* specify timeout of 0 to make the function non-blocking */ +/* timeout is in milliseconds */ +int flush_send_queue(zhandle_t*zh, int timeout) +{ + int rc= ZOK; + struct timeval started; +#ifdef WIN32 + fd_set pollSet; + struct timeval wait; +#endif + gettimeofday(&started,0); + // we can't use dequeue_buffer() here because if (non-blocking) send_buffer() + // returns EWOULDBLOCK we'd have to put the buffer back on the queue. + // we use a recursive lock instead and only dequeue the buffer if a send was + // successful + lock_buffer_list(&zh->to_send); + while (zh->to_send.head != 0&& zh->state == ZOO_CONNECTED_STATE) { + if(timeout!=0){ + int elapsed; + struct timeval now; + gettimeofday(&now,0); + elapsed=calculate_interval(&started,&now); + if (elapsed>timeout) { + rc = ZOPERATIONTIMEOUT; + break; + } + +#ifdef WIN32 + wait = get_timeval(timeout-elapsed); + FD_ZERO(&pollSet); + FD_SET(zh->fd, &pollSet); + // Poll the socket + rc = select((int)(zh->fd)+1, NULL, &pollSet, NULL, &wait); +#else + struct pollfd fds; + fds.fd = zh->fd; + fds.events = POLLOUT; + fds.revents = 0; + rc = poll(&fds, 1, timeout-elapsed); +#endif + if (rc<=0) { + /* timed out or an error or POLLERR */ + rc = rc==0 ? ZOPERATIONTIMEOUT : ZSYSTEMERROR; + break; + } + } + + rc = send_buffer(zh->fd, zh->to_send.head); + if(rc==0 && timeout==0){ + /* send_buffer would block while sending this buffer */ + rc = ZOK; + break; + } + if (rc < 0) { + rc = ZCONNECTIONLOSS; + break; + } + // if the buffer has been sent successfully, remove it from the queue + if (rc > 0) + remove_buffer(&zh->to_send); + gettimeofday(&zh->last_send, 0); + rc = ZOK; + } + unlock_buffer_list(&zh->to_send); + return rc; +} + +const char* zerror(int c) +{ + switch (c){ + case ZOK: + return "ok"; + case ZSYSTEMERROR: + return "system error"; + case ZRUNTIMEINCONSISTENCY: + return "run time inconsistency"; + case ZDATAINCONSISTENCY: + return "data inconsistency"; + case ZCONNECTIONLOSS: + return "connection loss"; + case ZMARSHALLINGERROR: + return "marshalling error"; + case ZUNIMPLEMENTED: + return "unimplemented"; + case ZOPERATIONTIMEOUT: + return "operation timeout"; + case ZBADARGUMENTS: + return "bad arguments"; + case ZINVALIDSTATE: + return "invalid zhandle state"; + case ZAPIERROR: + return "api error"; + case ZNONODE: + return "no node"; + case ZNOAUTH: + return "not authenticated"; + case ZBADVERSION: + return "bad version"; + case ZNOCHILDRENFOREPHEMERALS: + return "no children for ephemerals"; + case ZNODEEXISTS: + return "node exists"; + case ZNOTEMPTY: + return "not empty"; + case ZSESSIONEXPIRED: + return "session expired"; + case ZINVALIDCALLBACK: + return "invalid callback"; + case ZINVALIDACL: + return "invalid acl"; + case ZAUTHFAILED: + return "authentication failed"; + case ZCLOSING: + return "zookeeper is closing"; + case ZNOTHING: + return "(not error) no server responses to process"; + case ZSESSIONMOVED: + return "session moved to another server, so operation is ignored"; + } + if (c > 0) { + return strerror(c); + } + return "unknown error"; +} + +int zoo_add_auth(zhandle_t *zh,const char* scheme,const char* cert, + int certLen,void_completion_t completion, const void *data) +{ + struct buffer auth; + auth_info *authinfo; + if(scheme==NULL || zh==NULL) + return ZBADARGUMENTS; + + if (is_unrecoverable(zh)) + return ZINVALIDSTATE; + + // [ZOOKEEPER-800] zoo_add_auth should return ZINVALIDSTATE if + // the connection is closed. + if (zoo_state(zh) == 0) { + return ZINVALIDSTATE; + } + + if(cert!=NULL && certLen!=0){ + auth.buff=calloc(1,certLen); + if(auth.buff==0) { + return ZSYSTEMERROR; + } + memcpy(auth.buff,cert,certLen); + auth.len=certLen; + } else { + auth.buff = 0; + auth.len = 0; + } + + zoo_lock_auth(zh); + authinfo = (auth_info*) malloc(sizeof(auth_info)); + authinfo->scheme=strdup(scheme); + authinfo->auth=auth; + authinfo->completion=completion; + authinfo->data=data; + authinfo->next = NULL; + add_last_auth(&zh->auth_h, authinfo); + zoo_unlock_auth(zh); + + if(zh->state == ZOO_CONNECTED_STATE || zh->state == ZOO_ASSOCIATING_STATE) + return send_last_auth_info(zh); + + return ZOK; +} + +static const char* format_endpoint_info(const struct sockaddr_storage* ep) +{ + static char buf[128]; + char addrstr[128]; + void *inaddr; +#ifdef WIN32 + char * addrstring; +#endif + int port; + if(ep==0) + return "null"; + +#if defined(AF_INET6) + if(ep->ss_family==AF_INET6){ + inaddr=&((struct sockaddr_in6*)ep)->sin6_addr; + port=((struct sockaddr_in6*)ep)->sin6_port; + } else { +#endif + inaddr=&((struct sockaddr_in*)ep)->sin_addr; + port=((struct sockaddr_in*)ep)->sin_port; +#if defined(AF_INET6) + } +#endif +#ifdef WIN32 + addrstring = inet_ntoa (*(struct in_addr*)inaddr); + sprintf(buf,"%s:%d",addrstring,ntohs(port)); +#else + inet_ntop(ep->ss_family,inaddr,addrstr,sizeof(addrstr)-1); + sprintf(buf,"%s:%d",addrstr,ntohs(port)); +#endif + return buf; +} + +static const char* format_current_endpoint_info(zhandle_t* zh) +{ + return format_endpoint_info(&zh->addrs[zh->connect_index]); +} + +void zoo_deterministic_conn_order(int yesOrNo) +{ + disable_conn_permute=yesOrNo; +} + +/*---------------------------------------------------------------------------* + * SYNC API + *---------------------------------------------------------------------------*/ +int zoo_create(zhandle_t *zh, const char *path, const char *value, + int valuelen, const struct ACL_vector *acl, int flags, + char *path_buffer, int path_buffer_len) +{ + struct sync_completion *sc = alloc_sync_completion(); + int rc; + if (!sc) { + return ZSYSTEMERROR; + } + sc->u.str.str = path_buffer; + sc->u.str.str_len = path_buffer_len; + rc=zoo_acreate(zh, path, value, valuelen, acl, flags, SYNCHRONOUS_MARKER, sc); + if(rc==ZOK){ + wait_sync_completion(sc); + rc = sc->rc; + } + free_sync_completion(sc); + return rc; +} + +int zoo_delete(zhandle_t *zh, const char *path, int version) +{ + struct sync_completion *sc = alloc_sync_completion(); + int rc; + if (!sc) { + return ZSYSTEMERROR; + } + rc=zoo_adelete(zh, path, version, SYNCHRONOUS_MARKER, sc); + if(rc==ZOK){ + wait_sync_completion(sc); + rc = sc->rc; + } + free_sync_completion(sc); + return rc; +} + +int zoo_exists(zhandle_t *zh, const char *path, int watch, struct Stat *stat) +{ + return zoo_wexists(zh,path,watch?zh->watcher:0,zh->context,stat); +} + +int zoo_wexists(zhandle_t *zh, const char *path, + watcher_fn watcher, void* watcherCtx, struct Stat *stat) +{ + struct sync_completion *sc = alloc_sync_completion(); + int rc; + if (!sc) { + return ZSYSTEMERROR; + } + rc=zoo_awexists(zh,path,watcher,watcherCtx,SYNCHRONOUS_MARKER, sc); + if(rc==ZOK){ + wait_sync_completion(sc); + rc = sc->rc; + if (rc == 0&& stat) { + *stat = sc->u.stat; + } + } + free_sync_completion(sc); + return rc; +} + +int zoo_get(zhandle_t *zh, const char *path, int watch, char *buffer, + int* buffer_len, struct Stat *stat) +{ + return zoo_wget(zh,path,watch?zh->watcher:0,zh->context, + buffer,buffer_len,stat); +} + +int zoo_wget(zhandle_t *zh, const char *path, + watcher_fn watcher, void* watcherCtx, + char *buffer, int* buffer_len, struct Stat *stat) +{ + struct sync_completion *sc; + int rc=0; + + if(buffer_len==NULL) + return ZBADARGUMENTS; + if((sc=alloc_sync_completion())==NULL) + return ZSYSTEMERROR; + + sc->u.data.buffer = buffer; + sc->u.data.buff_len = *buffer_len; + rc=zoo_awget(zh, path, watcher, watcherCtx, SYNCHRONOUS_MARKER, sc); + if(rc==ZOK){ + wait_sync_completion(sc); + rc = sc->rc; + if (rc == 0) { + if(stat) + *stat = sc->u.data.stat; + *buffer_len = sc->u.data.buff_len; + } + } + free_sync_completion(sc); + return rc; +} + +int zoo_set(zhandle_t *zh, const char *path, const char *buffer, int buflen, + int version) +{ + return zoo_set2(zh, path, buffer, buflen, version, 0); +} + +int zoo_set2(zhandle_t *zh, const char *path, const char *buffer, int buflen, + int version, struct Stat *stat) +{ + struct sync_completion *sc = alloc_sync_completion(); + int rc; + if (!sc) { + return ZSYSTEMERROR; + } + rc=zoo_aset(zh, path, buffer, buflen, version, SYNCHRONOUS_MARKER, sc); + if(rc==ZOK){ + wait_sync_completion(sc); + rc = sc->rc; + if (rc == 0 && stat) { + *stat = sc->u.stat; + } + } + free_sync_completion(sc); + return rc; +} + +static int zoo_wget_children_(zhandle_t *zh, const char *path, + watcher_fn watcher, void* watcherCtx, + struct String_vector *strings) +{ + struct sync_completion *sc = alloc_sync_completion(); + int rc; + if (!sc) { + return ZSYSTEMERROR; + } + rc= zoo_awget_children (zh, path, watcher, watcherCtx, SYNCHRONOUS_MARKER, sc); + if(rc==ZOK){ + wait_sync_completion(sc); + rc = sc->rc; + if (rc == 0) { + if (strings) { + *strings = sc->u.strs2; + } else { + deallocate_String_vector(&sc->u.strs2); + } + } + } + free_sync_completion(sc); + return rc; +} + +static int zoo_wget_children2_(zhandle_t *zh, const char *path, + watcher_fn watcher, void* watcherCtx, + struct String_vector *strings, struct Stat *stat) +{ + struct sync_completion *sc = alloc_sync_completion(); + int rc; + if (!sc) { + return ZSYSTEMERROR; + } + rc= zoo_awget_children2(zh, path, watcher, watcherCtx, SYNCHRONOUS_MARKER, sc); + + if(rc==ZOK){ + wait_sync_completion(sc); + rc = sc->rc; + if (rc == 0) { + *stat = sc->u.strs_stat.stat2; + if (strings) { + *strings = sc->u.strs_stat.strs2; + } else { + deallocate_String_vector(&sc->u.strs_stat.strs2); + } + } + } + free_sync_completion(sc); + return rc; +} + +int zoo_get_children(zhandle_t *zh, const char *path, int watch, + struct String_vector *strings) +{ + return zoo_wget_children_(zh,path,watch?zh->watcher:0,zh->context,strings); +} + +int zoo_wget_children(zhandle_t *zh, const char *path, + watcher_fn watcher, void* watcherCtx, + struct String_vector *strings) +{ + return zoo_wget_children_(zh,path,watcher,watcherCtx,strings); +} + +int zoo_get_children2(zhandle_t *zh, const char *path, int watch, + struct String_vector *strings, struct Stat *stat) +{ + return zoo_wget_children2_(zh,path,watch?zh->watcher:0,zh->context,strings,stat); +} + +int zoo_wget_children2(zhandle_t *zh, const char *path, + watcher_fn watcher, void* watcherCtx, + struct String_vector *strings, struct Stat *stat) +{ + return zoo_wget_children2_(zh,path,watcher,watcherCtx,strings,stat); +} + +int zoo_get_acl(zhandle_t *zh, const char *path, struct ACL_vector *acl, + struct Stat *stat) +{ + struct sync_completion *sc = alloc_sync_completion(); + int rc; + if (!sc) { + return ZSYSTEMERROR; + } + rc=zoo_aget_acl(zh, path, SYNCHRONOUS_MARKER, sc); + if(rc==ZOK){ + wait_sync_completion(sc); + rc = sc->rc; + if (rc == 0&& stat) { + *stat = sc->u.acl.stat; + } + if (rc == 0) { + if (acl) { + *acl = sc->u.acl.acl; + } else { + deallocate_ACL_vector(&sc->u.acl.acl); + } + } + } + free_sync_completion(sc); + return rc; +} + +int zoo_set_acl(zhandle_t *zh, const char *path, int version, + const struct ACL_vector *acl) +{ + struct sync_completion *sc = alloc_sync_completion(); + int rc; + if (!sc) { + return ZSYSTEMERROR; + } + rc=zoo_aset_acl(zh, path, version, (struct ACL_vector*)acl, + SYNCHRONOUS_MARKER, sc); + if(rc==ZOK){ + wait_sync_completion(sc); + rc = sc->rc; + } + free_sync_completion(sc); + return rc; +} diff --git a/src/c/tests/CollectionUtil.h b/src/c/tests/CollectionUtil.h new file mode 100644 index 0000000..dd34811 --- /dev/null +++ b/src/c/tests/CollectionUtil.h @@ -0,0 +1,195 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +#ifndef _COLLECTION_UTIL_H_ +#define _COLLECTION_UTIL_H_ + +/** + * \file + * CollectionBuilder and DictionaryBuilder classes and collection utility functions + */ + +namespace Util +{ + +// ********************************************************* +/** A shortcut to use for building collections. + * This class is a wrapper around standard STL collection containers such as vector. + * It allows one to conveniently build collections at the variable initialization time: + * \code + * #include "CollectionUtil.h" + * #include "Vector.h" // for ostream << operator overload for STL vector + * using Util; + * + * int main() + * { + * typedef vector MyVector; + * MyVector myVector=CollectionBuilder()("str1")("str2")("str3"); + * cout< +class CollectionBuilder +{ +public: + /// Type of the collection container. + typedef CONT CollectionType; + /// Container's value type. + typedef typename CollectionType::value_type value_type; + /// Container's constant iterator type. + typedef typename CollectionType::const_iterator const_iterator; + /// Container's size type. + typedef typename CollectionType::size_type size_type; + + /** Operator function call overload to allow call chaining. + * \param value the value to be inserted into the container + */ + CollectionBuilder& operator()(const value_type& value){ + return push_back(value); + } + /** Same as regular STL push_back() but allows call chaining. + * \param value the value to be inserted into the container + */ + CollectionBuilder& push_back(const value_type& value){ + collection_.push_back(value); + return *this; + } + /// \name Standard STL container interface + /// @{ + const_iterator begin() const{return collection_.begin();} + const_iterator end() const{return collection_.end();} + size_type size() const{return collection_.size();} + void clear() {collection_.clear();} + ///@} + /// Explicit typecast operator. + operator const CollectionType&() const {return collection_;} +private: + /// \cond PRIVATE + CollectionType collection_; + /// \endcond +}; + + +// ********************************************************* +/** A shortcut to use for building dictionaries. + * This class is a wrapper around standard STL associative containers such as map. + * It allows one to conveniently build dictionaries at the variable initialization time: + * \code + * #include "CollectionUtil.h" + * #include "Map.h" // for ostream << operator overload for STL map + * using Util; + * + * int main() + * { + * typedef map MyMap; + * MyMap myMap=DictionaryBuilder()("str1",1)("str2",2)("str3",3); + * cout< +class DictionaryBuilder +{ +public: + /// The type of the associative container + typedef CONT DictionaryType; + /// Container's element type (usually a pair) + typedef typename DictionaryType::value_type value_type; + /// Container's key type + typedef typename DictionaryType::key_type key_type; + /// Container's value type + typedef typename DictionaryType::mapped_type mapped_type; + /// Container's constant iterator type + typedef typename DictionaryType::const_iterator const_iterator; + /// Container's writable iterator type + typedef typename DictionaryType::iterator iterator; + /// Container's size type + typedef typename DictionaryType::size_type size_type; + + /** Operator function call overload to allow call chaining. + * \param key the value key to be inserted + * \param value the value to be inserted into the container + * \return a non-const reference to self + */ + DictionaryBuilder& operator()(const key_type& key,const mapped_type& value){ + dict_.insert(value_type(key,value)); + return *this; + } + /** Lookup value by key. + * \param key the key associated with the value. + * \return a non-const iterator pointing to the element whose key matched the \a key parameter + */ + iterator find(const key_type& key){ + return dict_.find(key); + } + /** Lookup value by key. + * \param key the key associated with the value. + * \return a const iterator pointing to the element whose key matched the \a key parameter + */ + const_iterator find(const key_type& key) const{ + return dict_.find(key); + } + + /// \name Standard STL container interface + /// @{ + const_iterator begin() const{return dict_.begin();} + const_iterator end() const{return dict_.end();} + size_type size() const{return dict_.size();} + void clear() {dict_.clear();} + ///@} + /// Explicit typecast operator. + operator const DictionaryType&() const {return dict_;} +private: + DictionaryType dict_; +}; + + +// *********************************************************** +/** Deletes all dynamically allocated elements of a collection. + * C::value_type is expected to be a pointer to a dynamically allocated object, or it won't compile. + * The function will iterate over all container elements and call delete for each of them. + * \param c a collection (vector,set) whose elements are being deleted. + */ +template +void clearCollection(C& c){ + for(typename C::const_iterator it=c.begin();it!=c.end();++it) + delete *it; + c.clear(); +} + +/** Deletes all dynamically allocated values of the assotiative container. + * The function expects the M::value_type to be a pair<..., ptr_to_type>, or it won't compile. + * It first deletes the objects pointed to by ptr_to_type + * and then clears (calls m.clear()) the container. + * \param m an associative container (map,hash_map) whose elements are being deleted. + */ +template +void clearMap(M& m){ + for(typename M::const_iterator it=m.begin();it!=m.end();++it) + delete it->second; + m.clear(); +} + +} // namespace Util + + +#endif // _COLLECTION_UTIL_H_ diff --git a/src/c/tests/CppAssertHelper.h b/src/c/tests/CppAssertHelper.h new file mode 100644 index 0000000..3926f51 --- /dev/null +++ b/src/c/tests/CppAssertHelper.h @@ -0,0 +1,37 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifndef CPPASSERTHELPER_H_ +#define CPPASSERTHELPER_H_ + +#include + +// make it possible to specify location of the ASSERT call +#define CPPUNIT_ASSERT_EQUAL_LOC(expected,actual,file,line) \ + ( CPPUNIT_NS::assertEquals( (expected), \ + (actual), \ + CPPUNIT_NS::SourceLine(file,line), \ + "" ) ) + +#define CPPUNIT_ASSERT_EQUAL_MESSAGE_LOC(message,expected,actual,file,line) \ + ( CPPUNIT_NS::assertEquals( (expected), \ + (actual), \ + CPPUNIT_NS::SourceLine(file,line), \ + (message) ) ) + +#endif /*CPPASSERTHELPER_H_*/ diff --git a/src/c/tests/LibCMocks.cc b/src/c/tests/LibCMocks.cc new file mode 100644 index 0000000..5db4553 --- /dev/null +++ b/src/c/tests/LibCMocks.cc @@ -0,0 +1,333 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#include +#include +#include +#include + +#include "Util.h" +#include "LibCMocks.h" + +#undef USING_DUMA + +using namespace std; + +// ***************************************************************************** +// gethostbyname + +struct hostent* gethostbyname(const char *name) { + if(!Mock_gethostbyname::mock_) + return LIBC_SYMBOLS.gethostbyname(name); + return Mock_gethostbyname::mock_->call(name); +} + +Mock_gethostbyname* Mock_gethostbyname::mock_=0; + +Mock_gethostbyname::~Mock_gethostbyname(){ + mock_=0; + for(unsigned int i=0;icall(p1,p2); +} +#endif + +void* Mock_calloc::call(size_t p1, size_t p2){ +#ifndef USING_DUMA + if(counter++ ==callsBeforeFailure){ + counter=0; + errno=errnoOnFailure; + return 0; + } + return CALL_REAL(calloc,(p1,p2)); +#else + return 0; +#endif +} + +Mock_calloc* Mock_calloc::mock_=0; + +// ***************************************************************************** +// realloc + +#ifndef USING_DUMA +DECLARE_WRAPPER(void*,realloc,(void* p, size_t s)){ + if(!Mock_realloc::mock_) + return LIBC_SYMBOLS.realloc(p,s); + return Mock_realloc::mock_->call(p,s); +} +#endif + +Mock_realloc* Mock_realloc::mock_=0; + +void* Mock_realloc::call(void* p, size_t s){ + if(counter++ ==callsBeforeFailure){ + counter=0; + errno=errnoOnFailure; + return 0; + } + return LIBC_SYMBOLS.realloc(p,s); +} + +// ***************************************************************************** +// random +RANDOM_RET_TYPE random(){ + if(!Mock_random::mock_) + return LIBC_SYMBOLS.random(); + return Mock_random::mock_->call(); +} + +void srandom(unsigned long seed){ + if (!Mock_random::mock_) + LIBC_SYMBOLS.srandom(seed); + else + Mock_random::mock_->setSeed(seed); +} + +Mock_random* Mock_random::mock_=0; + +int Mock_random::call(){ + assert("Must specify one or more random integers"&&(randomReturns.size()!=0)); + return randomReturns[currentIdx++ % randomReturns.size()]; +} + +// ***************************************************************************** +// free +#ifndef USING_DUMA +DECLARE_WRAPPER(void,free,(void* p)){ + if(Mock_free_noop::mock_ && !Mock_free_noop::mock_->nested) + Mock_free_noop::mock_->call(p); + else + CALL_REAL(free,(p)); +} +#endif + +void Mock_free_noop::call(void* p){ + // on cygwin libc++ is linked statically + // push_back() may call free(), hence the nesting guards + synchronized(mx); + nested++; + callCounter++; + requested.push_back(p); + nested--; +} +void Mock_free_noop::freeRequested(){ +#ifndef USING_DUMA + synchronized(mx); + for(unsigned i=0; icallSocket(domain,type,protocol); +} + +int close(int fd){ + if (!Mock_socket::mock_) + return LIBC_SYMBOLS.close(fd); + return Mock_socket::mock_->callClose(fd); +} + +int getsockopt(int s,int level,int optname,void *optval,socklen_t *optlen){ + if (!Mock_socket::mock_) + return LIBC_SYMBOLS.getsockopt(s,level,optname,optval,optlen); + return Mock_socket::mock_->callGet(s,level,optname,optval,optlen); +} + +int setsockopt(int s,int level,int optname,const void *optval,socklen_t optlen){ + if (!Mock_socket::mock_) + return LIBC_SYMBOLS.setsockopt(s,level,optname,optval,optlen); + return Mock_socket::mock_->callSet(s,level,optname,optval,optlen); +} +int connect(int s,const struct sockaddr *addr,socklen_t len){ + if (!Mock_socket::mock_) + return LIBC_SYMBOLS.connect(s,addr,len); + return Mock_socket::mock_->callConnect(s,addr,len); +} +ssize_t send(int s,const void *buf,size_t len,int flags){ + if (!Mock_socket::mock_) + return LIBC_SYMBOLS.send(s,buf,len,flags); + return Mock_socket::mock_->callSend(s,buf,len,flags); +} + +ssize_t recv(int s,void *buf,size_t len,int flags){ + if (!Mock_socket::mock_) + return LIBC_SYMBOLS.recv(s,buf,len,flags); + return Mock_socket::mock_->callRecv(s,buf,len,flags); +} + +Mock_socket* Mock_socket::mock_=0; + +// ***************************************************************************** +// fcntl +extern "C" int fcntl(int fd,int cmd,...){ + va_list va; + va_start(va,cmd); + void* arg = va_arg(va, void *); + va_end (va); + if (!Mock_fcntl::mock_) + return LIBC_SYMBOLS.fcntl(fd,cmd,arg); + return Mock_fcntl::mock_->call(fd,cmd,arg); +} + +Mock_fcntl* Mock_fcntl::mock_=0; + +// ***************************************************************************** +// select +int select(int nfds,fd_set *rfds,fd_set *wfds,fd_set *efds,struct timeval *timeout){ + if (!Mock_select::mock_) + return LIBC_SYMBOLS.select(nfds,rfds,wfds,efds,timeout); + return Mock_select::mock_->call(nfds,rfds,wfds,efds,timeout); +} + +Mock_select* Mock_select::mock_=0; + +// ***************************************************************************** +// poll +Mock_poll* Mock_poll::mock_=0; +int poll(struct pollfd *fds, POLL_NFDS_TYPE nfds, int timeout){ + if (!Mock_poll::mock_) + return LIBC_SYMBOLS.poll(fds,nfds,timeout); + return Mock_poll::mock_->call(fds,nfds,timeout); + +} + +/* + * Recent gcc with -O2 and glibc FORTIFY feature may cause our poll + * mock to be ignored. + */ +#if __USE_FORTIFY_LEVEL > 0 +int __poll_chk (struct pollfd *__fds, nfds_t __nfds, int __timeout, + __SIZE_TYPE__ __fdslen) { + return poll(__fds, __nfds, __timeout); +} +#endif + +// ***************************************************************************** +// gettimeofday +int gettimeofday(struct timeval *tp, GETTIMEOFDAY_ARG2_TYPE tzp){ + if (!Mock_gettimeofday::mock_) + return LIBC_SYMBOLS.gettimeofday(tp,tzp); + return Mock_gettimeofday::mock_->call(tp,tzp); +} + +Mock_gettimeofday* Mock_gettimeofday::mock_=0; + diff --git a/src/c/tests/LibCMocks.h b/src/c/tests/LibCMocks.h new file mode 100644 index 0000000..5b07cda --- /dev/null +++ b/src/c/tests/LibCMocks.h @@ -0,0 +1,408 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifndef LIBCMOCKS_H_ +#define LIBCMOCKS_H_ + +#include +#include +#include + +#include +#include + +#include "MocksBase.h" +#include "LibCSymTable.h" +#include "ThreadingUtil.h" + +// ***************************************************************************** +// gethostbyname + +class Mock_gethostbyname: public Mock +{ +public: + struct HostEntry: public hostent { + HostEntry(const char* hostName,short addrtype); + ~HostEntry(); + HostEntry& addAlias(const char* alias); + HostEntry& addAddress(const char* addr4); + }; + + Mock_gethostbyname():current(0){mock_=this;} + virtual ~Mock_gethostbyname(); + HostEntry& addHostEntry(const char* hostName,short addrtype=AF_INET); + virtual hostent* call(const char* name); + + typedef std::vector HostEntryCollection; + HostEntryCollection gethostbynameReturns; + int current; + static Mock_gethostbyname* mock_; +}; + +class MockFailed_gethostbyname: public Mock_gethostbyname +{ +public: + MockFailed_gethostbyname():h_errnoReturn(HOST_NOT_FOUND) {} + + int h_errnoReturn; + virtual hostent* call(const char* name) { + h_errno=h_errnoReturn; + return 0; + } +}; + +// ***************************************************************************** +// calloc + +class Mock_calloc: public Mock +{ +public: + Mock_calloc():errnoOnFailure(ENOMEM),callsBeforeFailure(-1),counter(0) { + mock_=this; + } + virtual ~Mock_calloc() {mock_=0;} + + int errnoOnFailure; + int callsBeforeFailure; + int counter; + virtual void* call(size_t p1, size_t p2); + + static Mock_calloc* mock_; +}; + +// ***************************************************************************** +// realloc + +class Mock_realloc: public Mock +{ +public: + Mock_realloc():errnoOnFailure(ENOMEM),callsBeforeFailure(-1),counter(0) { + mock_=this; + } + virtual ~Mock_realloc() {mock_=0;} + + int errnoOnFailure; + int callsBeforeFailure; + int counter; + virtual void* call(void* p, size_t s); + + static Mock_realloc* mock_; +}; + +// ***************************************************************************** +// random + +class Mock_random: public Mock +{ +public: + Mock_random():currentIdx(0) {mock_=this;} + virtual ~Mock_random() {mock_=0;} + + int currentIdx; + std::vector randomReturns; + virtual int call(); + void setSeed(unsigned long){currentIdx=0;} + + static Mock_random* mock_; +}; + +// ***************************************************************************** +// no-op free; keeps track of all deallocation requests +class Mock_free_noop: public Mock +{ + Mutex mx; + std::vector requested; +public: + Mock_free_noop():nested(0),callCounter(0){mock_=this;} + virtual ~Mock_free_noop(){ + mock_=0; + freeRequested(); + } + + int nested; + int callCounter; + virtual void call(void* p); + void freeRequested(); + void disable(){mock_=0;} + // returns number of times the pointer was freed + int getFreeCount(void*); + bool isFreed(void*); + + static Mock_free_noop* mock_; +}; + +// ***************************************************************************** +// socket and related system calls + +class Mock_socket: public Mock +{ +public: + static const int FD=63; + Mock_socket():socketReturns(FD),closeReturns(0),getsocketoptReturns(0), + optvalSO_ERROR(0), + setsockoptReturns(0),connectReturns(0),connectErrno(0), + sendErrno(0),recvErrno(0) + { + mock_=this; + } + virtual ~Mock_socket(){mock_=0;} + + int socketReturns; + virtual int callSocket(int domain, int type, int protocol){ + return socketReturns; + } + int closeReturns; + virtual int callClose(int fd){ + return closeReturns; + } + int getsocketoptReturns; + int optvalSO_ERROR; + virtual int callGet(int s,int level,int optname,void *optval,socklen_t *len){ + if(level==SOL_SOCKET && optname==SO_ERROR){ + setSO_ERROR(optval,*len); + } + return getsocketoptReturns; + } + virtual void setSO_ERROR(void *optval,socklen_t len){ + memcpy(optval,&optvalSO_ERROR,len); + } + + int setsockoptReturns; + virtual int callSet(int s,int level,int optname,const void *optval,socklen_t len){ + return setsockoptReturns; + } + int connectReturns; + int connectErrno; + virtual int callConnect(int s,const struct sockaddr *addr,socklen_t len){ + errno=connectErrno; + return connectReturns; + } + + virtual void notifyBufferSent(const std::string& buffer){} + + int sendErrno; + std::string sendBuffer; + virtual ssize_t callSend(int s,const void *buf,size_t len,int flags){ + if(sendErrno!=0){ + errno=sendErrno; + return -1; + } + // first call to send() is always the length of the buffer to follow + bool sendingLength=sendBuffer.size()==0; + // overwrite the length bytes + sendBuffer.assign((const char*)buf,len); + if(!sendingLength){ + notifyBufferSent(sendBuffer); + sendBuffer.erase(); + } + return len; + } + + int recvErrno; + std::string recvReturnBuffer; + virtual ssize_t callRecv(int s,void *buf,size_t len,int flags){ + if(recvErrno!=0){ + errno=recvErrno; + return -1; + } + int k=std::min(len,recvReturnBuffer.length()); + if(k==0) + return 0; + memcpy(buf,recvReturnBuffer.data(),k); + recvReturnBuffer.erase(0,k); + return k; + } + virtual bool hasMoreRecv() const{ + return recvReturnBuffer.size()!=0; + } + static Mock_socket* mock_; +}; + +// ***************************************************************************** +// fcntl +class Mock_fcntl: public Mock +{ +public: + Mock_fcntl():callReturns(0),trapFD(-1){mock_=this;} + ~Mock_fcntl(){mock_=0;} + + int callReturns; + int trapFD; + virtual int call(int fd, int cmd, void* arg){ + if(trapFD==-1) + return LIBC_SYMBOLS.fcntl(fd,cmd,arg); + return callReturns; + } + + static Mock_fcntl* mock_; +}; + +// ***************************************************************************** +// select +class Mock_select: public Mock +{ +public: + Mock_select(Mock_socket* s,int fd):sock(s), + callReturns(0),myFD(fd),timeout(50) + { + mock_=this; + } + ~Mock_select(){mock_=0;} + + Mock_socket* sock; + int callReturns; + int myFD; + int timeout; //in millis + virtual int call(int nfds,fd_set *rfds,fd_set *wfds,fd_set *efds,struct timeval *tv){ + bool isWritableRequested=(wfds && FD_ISSET(myFD,wfds)); + if(rfds) FD_CLR(myFD,rfds); + if(wfds) FD_CLR(myFD,wfds); + // this timeout is only to prevent a tight loop + timeval myTimeout={0,0}; + if(!isWritableRequested && !isFDReadable()){ + myTimeout.tv_sec=timeout/1000; + myTimeout.tv_usec=(timeout%1000)*1000; + } + LIBC_SYMBOLS.select(nfds,rfds,wfds,efds,&myTimeout); + // myFD is always writable + if(isWritableRequested) FD_SET(myFD,wfds); + // myFD is only readable if the socket has anything to read + if(isFDReadable() && rfds) FD_SET(myFD,rfds); + return callReturns; + } + + virtual bool isFDReadable() const { + return sock->hasMoreRecv(); + } + + static Mock_select* mock_; +}; + +// ***************************************************************************** +// poll +// the last element of the pollfd array is expected to be test FD +class Mock_poll: public Mock +{ +public: + Mock_poll(Mock_socket* s,int fd):sock(s), + callReturns(1),myFD(fd),timeout(50) + { + mock_=this; + } + ~Mock_poll(){mock_=0;} + + Mock_socket* sock; + int callReturns; + int myFD; + int timeout; //in millis + virtual int call(struct pollfd *fds, POLL_NFDS_TYPE nfds, int to) { + pollfd* myPoll=0; + if(fds[nfds-1].fd==myFD) + myPoll=&fds[nfds-1]; + bool isWritableRequested=false; + if(myPoll!=0){ + isWritableRequested=myPoll->events&POLLOUT; + nfds--; + } + LIBC_SYMBOLS.poll(fds,nfds,(!isWritableRequested&&!isFDReadable())?timeout:0); + if(myPoll!=0){ + // myFD is always writable if requested + myPoll->revents=isWritableRequested?POLLOUT:0; + // myFD is only readable if the socket has anything to read + myPoll->revents|=isFDReadable()?POLLIN:0; + } + return callReturns; + } + + virtual bool isFDReadable() const { + return sock->hasMoreRecv(); + } + + static Mock_poll* mock_; +}; + +// ***************************************************************************** +// gettimeofday +class Mock_gettimeofday: public Mock +{ +public: + Mock_gettimeofday(){ + LIBC_SYMBOLS.gettimeofday(&tv,0); + mock_=this; + } + Mock_gettimeofday(const Mock_gettimeofday& other):tv(other.tv){} + Mock_gettimeofday(int32_t sec,int32_t usec){ + tv.tv_sec=sec; + tv.tv_usec=usec; + } + ~Mock_gettimeofday(){mock_=0;} + + timeval tv; + virtual int call(struct timeval *tp, GETTIMEOFDAY_ARG2_TYPE tzp){ + *tp=tv; + return 0; + } + operator timeval() const{ + return tv; + } + // advance secs + virtual void tick(int howmuch=1){tv.tv_sec+=howmuch;} + // advance milliseconds + // can move the clock forward as well as backward by providing a negative + // number + virtual void millitick(int howmuch=1){ + int ms=tv.tv_usec/1000+howmuch; + tv.tv_sec+=ms/1000; + // going backward? + if(ms<0){ + ms=1000-(-ms%1000); //wrap millis around + } + tv.tv_usec=(ms%1000)*1000; + } + virtual void tick(const timeval& howmuch){ + // add milliseconds (discarding microsecond portion) + long ms=tv.tv_usec/1000+howmuch.tv_usec/1000; + tv.tv_sec+=howmuch.tv_sec+ms/1000; + tv.tv_usec=(ms%1000)*1000; + } + static Mock_gettimeofday* mock_; +}; + +// discard microseconds! +inline bool operator==(const timeval& lhs, const timeval& rhs){ + return rhs.tv_sec==lhs.tv_sec && rhs.tv_usec/1000==lhs.tv_usec/1000; +} + +// simplistic implementation: no normalization, assume lhs >= rhs, +// discarding microseconds +inline timeval operator-(const timeval& lhs, const timeval& rhs){ + timeval res; + res.tv_sec=lhs.tv_sec-rhs.tv_sec; + res.tv_usec=(lhs.tv_usec/1000-rhs.tv_usec/1000)*1000; + if(res.tv_usec<0){ + res.tv_sec--; + res.tv_usec=1000000+res.tv_usec%1000000; // wrap the millis around + } + return res; +} + +inline int32_t toMilliseconds(const timeval& tv){ + return tv.tv_sec*1000+tv.tv_usec/1000; +} + +#endif /*LIBCMOCKS_H_*/ diff --git a/src/c/tests/LibCSymTable.cc b/src/c/tests/LibCSymTable.cc new file mode 100644 index 0000000..5378579 --- /dev/null +++ b/src/c/tests/LibCSymTable.cc @@ -0,0 +1,83 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#include "LibCSymTable.h" + +#define LOAD_SYM(sym) \ + sym=(sym##_sig)dlsym(handle,#sym); \ + assert("Unable to load "#sym" from libc"&&sym) + + +LibCSymTable& LibCSymTable::instance(){ + static LibCSymTable tbl; + return tbl; +} + +//****************************************************************************** +// preload original libc symbols +LibCSymTable::LibCSymTable() +{ + void* handle=getHandle(); + LOAD_SYM(gethostbyname); + LOAD_SYM(calloc); + LOAD_SYM(realloc); + LOAD_SYM(free); + LOAD_SYM(random); + LOAD_SYM(srandom); + LOAD_SYM(printf); + LOAD_SYM(socket); + LOAD_SYM(close); + LOAD_SYM(getsockopt); + LOAD_SYM(setsockopt); + LOAD_SYM(fcntl); + LOAD_SYM(connect); + LOAD_SYM(send); + LOAD_SYM(recv); + LOAD_SYM(select); + LOAD_SYM(poll); + LOAD_SYM(gettimeofday); +#ifdef THREADED + LOAD_SYM(pthread_create); + LOAD_SYM(pthread_detach); + LOAD_SYM(pthread_cond_broadcast); + LOAD_SYM(pthread_cond_destroy); + LOAD_SYM(pthread_cond_init); + LOAD_SYM(pthread_cond_signal); + LOAD_SYM(pthread_cond_timedwait); + LOAD_SYM(pthread_cond_wait); + LOAD_SYM(pthread_join); + LOAD_SYM(pthread_mutex_destroy); + LOAD_SYM(pthread_mutex_init); + LOAD_SYM(pthread_mutex_lock); + LOAD_SYM(pthread_mutex_trylock); + LOAD_SYM(pthread_mutex_unlock); +#endif +} + +void* LibCSymTable::getHandle(){ + static void* handle=0; + if(!handle){ +#ifdef __CYGWIN__ + handle=dlopen("cygwin1.dll",RTLD_LAZY); + assert("Unable to dlopen global sym table"&&handle); +#else + handle=RTLD_NEXT; +#endif + } + return handle; +} diff --git a/src/c/tests/LibCSymTable.h b/src/c/tests/LibCSymTable.h new file mode 100644 index 0000000..2f7e0c2 --- /dev/null +++ b/src/c/tests/LibCSymTable.h @@ -0,0 +1,107 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifndef LIBCSYMTABLE_H_ +#define LIBCSYMTABLE_H_ + +#include +#include +#include +#include +#include +#include +#include + +#ifdef THREADED +#include +#endif + +#include "config.h" + +// TODO: move all these macros to config.h (generated by autoconf) +#ifdef __CYGWIN__ +#if (CYGWIN_VERSION_DLL_MAJOR < 1007) +#define RANDOM_RET_TYPE int +#else +#define RANDOM_RET_TYPE long int +#endif +#define GETTIMEOFDAY_ARG2_TYPE void* +#else +#define RANDOM_RET_TYPE long int +#define GETTIMEOFDAY_ARG2_TYPE struct timezone* +#endif + +#define DECLARE_SYM(ret,sym,sig) \ + typedef ret (*sym##_sig)sig; \ + static sym##_sig preload_##sym () { \ + static sym##_sig ptr=0;\ + if(!ptr){ void* h=getHandle(); ptr=(sym##_sig)dlsym(h,#sym); } \ + assert("Unable to load "#sym" from libc"&&ptr); \ + return ptr; \ + } \ + sym##_sig sym + +#define LIBC_SYMBOLS LibCSymTable::instance() + +//****************************************************************************** +// preload original libc symbols +struct LibCSymTable +{ + DECLARE_SYM(hostent*,gethostbyname,(const char*)); + DECLARE_SYM(void*,calloc,(size_t, size_t)); + DECLARE_SYM(void*,realloc,(void*, size_t)); + DECLARE_SYM(void,free,(void*)); + DECLARE_SYM(RANDOM_RET_TYPE,random,(void)); + DECLARE_SYM(void,srandom,(unsigned long)); + DECLARE_SYM(int,printf,(const char*, ...)); + DECLARE_SYM(int,socket,(int,int,int)); + DECLARE_SYM(int,close,(int)); + DECLARE_SYM(int,getsockopt,(int,int,int,void*,socklen_t*)); + DECLARE_SYM(int,setsockopt,(int,int,int,const void*,socklen_t)); + DECLARE_SYM(int,fcntl,(int,int,...)); + DECLARE_SYM(int,connect,(int,const struct sockaddr*,socklen_t)); + DECLARE_SYM(ssize_t,send,(int,const void*,size_t,int)); + DECLARE_SYM(ssize_t,recv,(int,const void*,size_t,int)); + DECLARE_SYM(int,select,(int,fd_set*,fd_set*,fd_set*,struct timeval*)); + DECLARE_SYM(int,poll,(struct pollfd*,POLL_NFDS_TYPE,int)); + DECLARE_SYM(int,gettimeofday,(struct timeval*,GETTIMEOFDAY_ARG2_TYPE)); +#ifdef THREADED + DECLARE_SYM(int,pthread_create,(pthread_t *, const pthread_attr_t *, + void *(*)(void *), void *)); + DECLARE_SYM(int,pthread_detach,(pthread_t)); + DECLARE_SYM(int,pthread_cond_broadcast,(pthread_cond_t *)); + DECLARE_SYM(int,pthread_cond_destroy,(pthread_cond_t *)); + DECLARE_SYM(int,pthread_cond_init,(pthread_cond_t *, const pthread_condattr_t *)); + DECLARE_SYM(int,pthread_cond_signal,(pthread_cond_t *)); + DECLARE_SYM(int,pthread_cond_timedwait,(pthread_cond_t *, + pthread_mutex_t *, const struct timespec *)); + DECLARE_SYM(int,pthread_cond_wait,(pthread_cond_t *, pthread_mutex_t *)); + DECLARE_SYM(int,pthread_join,(pthread_t, void **)); + DECLARE_SYM(int,pthread_mutex_destroy,(pthread_mutex_t *)); + DECLARE_SYM(int,pthread_mutex_init,(pthread_mutex_t *, const pthread_mutexattr_t *)); + DECLARE_SYM(int,pthread_mutex_lock,(pthread_mutex_t *)); + DECLARE_SYM(int,pthread_mutex_trylock,(pthread_mutex_t *)); + DECLARE_SYM(int,pthread_mutex_unlock,(pthread_mutex_t *)); +#endif + LibCSymTable(); + + static void* getHandle(); + static LibCSymTable& instance(); +}; + +#endif /*LIBCSYMTABLE_H_*/ diff --git a/src/c/tests/MocksBase.cc b/src/c/tests/MocksBase.cc new file mode 100644 index 0000000..60b2c75 --- /dev/null +++ b/src/c/tests/MocksBase.cc @@ -0,0 +1,36 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#include +#include + +#include "MocksBase.h" +#include "LibCSymTable.h" + +// ***************************************************************************** +// Mock base +void* Mock::operator new(std::size_t s){ + void* p=malloc(s); + if(!p) + throw std::bad_alloc(); + return p; +} + +void Mock::operator delete(void* p){ + LIBC_SYMBOLS.free(p); +} diff --git a/src/c/tests/MocksBase.h b/src/c/tests/MocksBase.h new file mode 100644 index 0000000..5b54251 --- /dev/null +++ b/src/c/tests/MocksBase.h @@ -0,0 +1,36 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifndef MOCKSBASE_H_ +#define MOCKSBASE_H_ + +#include + +// ***************************************************************************** +// Mock base + +class Mock +{ +public: + virtual ~Mock(){} + + static void* operator new(std::size_t s); + static void operator delete(void* p); +}; + +#endif /*MOCKSBASE_H_*/ diff --git a/src/c/tests/PthreadMocks.cc b/src/c/tests/PthreadMocks.cc new file mode 100644 index 0000000..490cebf --- /dev/null +++ b/src/c/tests/PthreadMocks.cc @@ -0,0 +1,106 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#include "PthreadMocks.h" + +MockPthreadsBase* MockPthreadsBase::mock_=0; + +#undef USING_DUMA + +#ifndef USING_DUMA +int pthread_cond_broadcast (pthread_cond_t *c){ + if(!MockPthreadsBase::mock_) + return LIBC_SYMBOLS.pthread_cond_broadcast(c); + return MockPthreadsBase::mock_->pthread_cond_broadcast(c); +} +int pthread_cond_destroy (pthread_cond_t *c){ + if(!MockPthreadsBase::mock_) + return LIBC_SYMBOLS.pthread_cond_destroy(c); + return MockPthreadsBase::mock_->pthread_cond_destroy(c); +} +int pthread_cond_init (pthread_cond_t *c, const pthread_condattr_t *a){ + if(!MockPthreadsBase::mock_) + return LIBC_SYMBOLS.pthread_cond_init(c,a); + return MockPthreadsBase::mock_->pthread_cond_init(c,a); +} +int pthread_cond_signal (pthread_cond_t *c){ + if(!MockPthreadsBase::mock_) + return LIBC_SYMBOLS.pthread_cond_signal(c); + return MockPthreadsBase::mock_->pthread_cond_signal(c); +} +int pthread_cond_timedwait (pthread_cond_t *c, + pthread_mutex_t *m, const struct timespec *t){ + if(!MockPthreadsBase::mock_) + return LIBC_SYMBOLS.pthread_cond_timedwait(c,m,t); + return MockPthreadsBase::mock_->pthread_cond_timedwait(c,m,t); +} +int pthread_cond_wait (pthread_cond_t *c, pthread_mutex_t *m){ + if(!MockPthreadsBase::mock_) + return LIBC_SYMBOLS.pthread_cond_wait(c,m); + return MockPthreadsBase::mock_->pthread_cond_wait(c,m); +} +int pthread_create (pthread_t *t, const pthread_attr_t *a, + void *(*f)(void *), void *d){ + if(!MockPthreadsBase::mock_) + return LIBC_SYMBOLS.pthread_create(t,a,f,d); + return MockPthreadsBase::mock_->pthread_create(t,a,f,d); +} +int pthread_detach(pthread_t t){ + if(!MockPthreadsBase::mock_) + return LIBC_SYMBOLS.pthread_detach(t); + return MockPthreadsBase::mock_->pthread_detach(t); +} +int pthread_join (pthread_t t, void **r){ + if(!MockPthreadsBase::mock_) + return LIBC_SYMBOLS.pthread_join(t,r); + return MockPthreadsBase::mock_->pthread_join(t,r); +} +int pthread_mutex_destroy (pthread_mutex_t *m){ + if(!MockPthreadsBase::mock_) + return LIBC_SYMBOLS.pthread_mutex_destroy(m); + return MockPthreadsBase::mock_->pthread_mutex_destroy(m); +} +int pthread_mutex_init (pthread_mutex_t *m, const pthread_mutexattr_t *a){ + if(!MockPthreadsBase::mock_) + return LIBC_SYMBOLS.pthread_mutex_init(m,a); + return MockPthreadsBase::mock_->pthread_mutex_init(m,a); +} + +DECLARE_WRAPPER(int,pthread_mutex_lock,(pthread_mutex_t *m)){ + if(!MockPthreadsBase::mock_) + return CALL_REAL(pthread_mutex_lock,(m)); + return MockPthreadsBase::mock_->pthread_mutex_lock(m); +} + +int pthread_mutex_trylock (pthread_mutex_t *m){ + if(!MockPthreadsBase::mock_) + return LIBC_SYMBOLS.pthread_mutex_trylock(m); + return MockPthreadsBase::mock_->pthread_mutex_trylock(m); +} + +DECLARE_WRAPPER(int,pthread_mutex_unlock,(pthread_mutex_t *m)){ + if(!MockPthreadsBase::mock_) + return CALL_REAL(pthread_mutex_unlock,(m)); + return MockPthreadsBase::mock_->pthread_mutex_unlock(m); +} +#endif + +CheckedPthread::ThreadMap CheckedPthread::tmap_; +CheckedPthread::MutexMap CheckedPthread::mmap_; +CheckedPthread::CVMap CheckedPthread::cvmap_; +Mutex CheckedPthread::mx; diff --git a/src/c/tests/PthreadMocks.h b/src/c/tests/PthreadMocks.h new file mode 100644 index 0000000..8db8815 --- /dev/null +++ b/src/c/tests/PthreadMocks.h @@ -0,0 +1,449 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifndef PTHREADMOCKS_H_ +#define PTHREADMOCKS_H_ + +#include +#include +#include + +#include "src/zk_adaptor.h" + +#include "Util.h" +#include "MocksBase.h" +#include "LibCSymTable.h" +#include "ThreadingUtil.h" + +// an ABC for pthreads +class MockPthreadsBase: public Mock +{ +public: + MockPthreadsBase(){mock_=this;} + virtual ~MockPthreadsBase(){mock_=0;} + + virtual int pthread_create(pthread_t * t, const pthread_attr_t *a, + void *(*f)(void *), void *d) =0; + virtual int pthread_join(pthread_t t, void ** r) =0; + virtual int pthread_detach(pthread_t t) =0; + virtual int pthread_cond_broadcast(pthread_cond_t *c) =0; + virtual int pthread_cond_destroy(pthread_cond_t *c) =0; + virtual int pthread_cond_init(pthread_cond_t *c, const pthread_condattr_t *a) =0; + virtual int pthread_cond_signal(pthread_cond_t *c) =0; + virtual int pthread_cond_timedwait(pthread_cond_t *c, + pthread_mutex_t *m, const struct timespec *t) =0; + virtual int pthread_cond_wait(pthread_cond_t *c, pthread_mutex_t *m) =0; + virtual int pthread_mutex_destroy(pthread_mutex_t *m) =0; + virtual int pthread_mutex_init(pthread_mutex_t *m, const pthread_mutexattr_t *a) =0; + virtual int pthread_mutex_lock(pthread_mutex_t *m) =0; + virtual int pthread_mutex_trylock(pthread_mutex_t *m) =0; + virtual int pthread_mutex_unlock(pthread_mutex_t *m) =0; + + static MockPthreadsBase* mock_; +}; + +// all pthread functions simply return an error code +// and increment their invocation counter. No actual threads are spawned. +class MockPthreadsNull: public MockPthreadsBase +{ +public: + MockPthreadsNull(): + pthread_createReturns(0),pthread_createCounter(0), + pthread_joinReturns(0),pthread_joinCounter(0),pthread_joinResultReturn(0), + pthread_detachReturns(0),pthread_detachCounter(0), + pthread_cond_broadcastReturns(0),pthread_cond_broadcastCounter(0), + pthread_cond_destroyReturns(0),pthread_cond_destroyCounter(0), + pthread_cond_initReturns(0),pthread_cond_initCounter(0), + pthread_cond_signalReturns(0),pthread_cond_signalCounter(0), + pthread_cond_timedwaitReturns(0),pthread_cond_timedwaitCounter(0), + pthread_cond_waitReturns(0),pthread_cond_waitCounter(0), + pthread_mutex_destroyReturns(0),pthread_mutex_destroyCounter(0), + pthread_mutex_initReturns(0),pthread_mutex_initCounter(0), + pthread_mutex_lockReturns(0),pthread_mutex_lockCounter(0), + pthread_mutex_trylockReturns(0),pthread_mutex_trylockCounter(0), + pthread_mutex_unlockReturns(0),pthread_mutex_unlockCounter(0) + { + memset(threads,0,sizeof(threads)); + } + + short threads[512]; + + int pthread_createReturns; + int pthread_createCounter; + virtual int pthread_create(pthread_t * t, const pthread_attr_t *a, + void *(*f)(void *), void *d){ + char* p=(char*)&threads[pthread_createCounter++]; + p[0]='i'; // mark as created + *t=(pthread_t)p; + return pthread_createReturns; + } + int pthread_joinReturns; + int pthread_joinCounter; + void* pthread_joinResultReturn; + virtual int pthread_join(pthread_t t, void ** r){ + pthread_joinCounter++; + if(r!=0) + *r=pthread_joinResultReturn; + char* p=(char*)t; + p[0]='x';p[1]+=1; + return pthread_joinReturns; + } + int pthread_detachReturns; + int pthread_detachCounter; + virtual int pthread_detach(pthread_t t){ + pthread_detachCounter++; + char* p=(char*)t; + p[0]='x';p[1]+=1; + return pthread_detachReturns; + } + + template + static bool isInitialized(const T& t){ + return ((char*)t)[0]=='i'; + } + template + static bool isDestroyed(const T& t){ + return ((char*)t)[0]=='x'; + } + template + static int getDestroyCounter(const T& t){ + return ((char*)t)[1]; + } + template + static int getInvalidAccessCounter(const T& t){ + return ((char*)t)[2]; + } + int pthread_cond_broadcastReturns; + int pthread_cond_broadcastCounter; + virtual int pthread_cond_broadcast(pthread_cond_t *c){ + pthread_cond_broadcastCounter++; + if(isDestroyed(c))((char*)c)[2]++; + return pthread_cond_broadcastReturns; + } + int pthread_cond_destroyReturns; + int pthread_cond_destroyCounter; + virtual int pthread_cond_destroy(pthread_cond_t *c){ + pthread_cond_destroyCounter++; + char* p=(char*)c; + p[0]='x';p[1]+=1; + return pthread_cond_destroyReturns; + } + int pthread_cond_initReturns; + int pthread_cond_initCounter; + virtual int pthread_cond_init(pthread_cond_t *c, const pthread_condattr_t *a){ + pthread_cond_initCounter++; + char* p=(char*)c; + p[0]='i'; // mark as created + p[1]=0; // destruction counter + p[2]=0; // access after destruction counter + return pthread_cond_initReturns; + } + int pthread_cond_signalReturns; + int pthread_cond_signalCounter; + virtual int pthread_cond_signal(pthread_cond_t *c){ + pthread_cond_signalCounter++; + if(isDestroyed(c))((char*)c)[2]++; + return pthread_cond_signalReturns; + } + int pthread_cond_timedwaitReturns; + int pthread_cond_timedwaitCounter; + virtual int pthread_cond_timedwait(pthread_cond_t *c, + pthread_mutex_t *m, const struct timespec *t){ + pthread_cond_timedwaitCounter++; + if(isDestroyed(c))((char*)c)[2]++; + return pthread_cond_timedwaitReturns; + } + int pthread_cond_waitReturns; + int pthread_cond_waitCounter; + virtual int pthread_cond_wait(pthread_cond_t *c, pthread_mutex_t *m){ + pthread_cond_waitCounter++; + if(isDestroyed(c))((char*)c)[2]++; + return pthread_cond_waitReturns; + } + int pthread_mutex_destroyReturns; + int pthread_mutex_destroyCounter; + virtual int pthread_mutex_destroy(pthread_mutex_t *m){ + pthread_mutex_destroyCounter++; + char* p=(char*)m; + p[0]='x';p[1]+=1; + return pthread_mutex_destroyReturns; + } + int pthread_mutex_initReturns; + int pthread_mutex_initCounter; + virtual int pthread_mutex_init(pthread_mutex_t *m, const pthread_mutexattr_t *a){ + pthread_mutex_initCounter++; + char* p=(char*)m; + p[0]='i'; // mark as created + p[1]=0; // destruction counter + p[2]=0; // access after destruction counter + return pthread_mutex_initReturns; + } + int pthread_mutex_lockReturns; + int pthread_mutex_lockCounter; + virtual int pthread_mutex_lock(pthread_mutex_t *m){ + pthread_mutex_lockCounter++; + if(isDestroyed(m))((char*)m)[2]++; + return pthread_mutex_lockReturns; + } + int pthread_mutex_trylockReturns; + int pthread_mutex_trylockCounter; + virtual int pthread_mutex_trylock(pthread_mutex_t *m){ + pthread_mutex_trylockCounter++; + if(isDestroyed(m))((char*)m)[2]++; + return pthread_mutex_trylockReturns; + } + int pthread_mutex_unlockReturns; + int pthread_mutex_unlockCounter; + virtual int pthread_mutex_unlock(pthread_mutex_t *m){ + pthread_mutex_unlockCounter++; + if(isDestroyed(m))((char*)m)[2]++; + return pthread_mutex_unlockReturns; + } +}; + +// simulates the way zookeeper threads make use of api_prolog/epilog and +// +class MockPthreadZKNull: public MockPthreadsNull +{ + typedef std::map Map; + Map map_; +public: + virtual int pthread_create(pthread_t * t, const pthread_attr_t *a, + void *(*f)(void *), void *d){ + int ret=MockPthreadsNull::pthread_create(t,a,f,d); + zhandle_t* zh=(zhandle_t*)d; + adaptor_threads* ad=(adaptor_threads*)zh->adaptor_priv; + api_prolog(zh); + ad->threadsToWait--; + putValue(map_,*t,zh); + return ret; + } + virtual int pthread_join(pthread_t t, void ** r){ + zhandle_t* zh=0; + if(getValue(map_,t,zh)) + api_epilog(zh,0); + return MockPthreadsNull::pthread_join(t,r); + } +}; + +struct ThreadInfo{ + typedef enum {RUNNING,TERMINATED} ThreadState; + + ThreadInfo(): + destructionCounter_(0),invalidAccessCounter_(0),state_(RUNNING) + { + } + + ThreadInfo& incDestroyed() { + destructionCounter_++; + return *this; + } + ThreadInfo& incInvalidAccess(){ + invalidAccessCounter_++; + return *this; + } + ThreadInfo& setTerminated(){ + state_=TERMINATED; + return *this; + } + int destructionCounter_; + int invalidAccessCounter_; + ThreadState state_; +}; + +class CheckedPthread: public MockPthreadsBase +{ + // first => destruction counter + // second => invalid access counter + //typedef std::pair Entry; + typedef ThreadInfo Entry; + typedef std::map ThreadMap; + static ThreadMap tmap_; + static ThreadMap& getMap(const TypeOp::BareT&){return tmap_;} + typedef std::map MutexMap; + static MutexMap mmap_; + static MutexMap& getMap(const TypeOp::BareT&){return mmap_;} + typedef std::map CVMap; + static CVMap cvmap_; + static CVMap& getMap(const TypeOp::BareT&){return cvmap_;} + + static Mutex mx; + + template + static void markDestroyed(T& t){ + typedef typename TypeOp::BareT Type; + Entry e; + synchronized(mx); + if(getValue(getMap(Type()),t,e)){ + putValue(getMap(Type()),t,Entry(e).incDestroyed()); + }else{ + putValue(getMap(Type()),t,Entry().incDestroyed()); + } + } + template + static void markCreated(T& t){ + typedef typename TypeOp::BareT Type; + Entry e; + synchronized(mx); + if(!getValue(getMap(Type()),t,e)) + putValue(getMap(Type()),t,Entry()); + } + template + static void checkAccessed(T& t){ + typedef typename TypeOp::BareT Type; + Entry e; + synchronized(mx); + if(getValue(getMap(Type()),t,e) && e.destructionCounter_>0) + putValue(getMap(Type()),t,Entry(e).incInvalidAccess()); + } + static void setTerminated(pthread_t t){ + Entry e; + synchronized(mx); + if(getValue(tmap_,t,e)) + putValue(tmap_,t,Entry(e).setTerminated()); + } +public: + bool verbose; + CheckedPthread():verbose(false){ + tmap_.clear(); + mmap_.clear(); + cvmap_.clear(); + mx.release(); + } + template + static bool isInitialized(const T& t){ + typedef typename TypeOp::BareT Type; + Entry e; + synchronized(mx); + return getValue(getMap(Type()),t,e) && e.destructionCounter_==0; + } + template + static bool isDestroyed(const T& t){ + typedef typename TypeOp::BareT Type; + Entry e; + synchronized(mx); + return getValue(getMap(Type()),t,e) && e.destructionCounter_>0; + } + static bool isTerminated(pthread_t t){ + Entry e; + synchronized(mx); + return getValue(tmap_,t,e) && e.state_==ThreadInfo::TERMINATED; + } + template + static int getDestroyCounter(const T& t){ + typedef typename TypeOp::BareT Type; + Entry e; + synchronized(mx); + return getValue(getMap(Type()),t,e)?e.destructionCounter_:-1; + } + template + static int getInvalidAccessCounter(const T& t){ + typedef typename TypeOp::BareT Type; + Entry e; + synchronized(mx); + return getValue(getMap(Type()),t,e)?e.invalidAccessCounter_:-1; + } + + struct ThreadContext{ + typedef void *(*ThreadFunc)(void *); + + ThreadContext(ThreadFunc func,void* param):func_(func),param_(param){} + ThreadFunc func_; + void* param_; + }; + static void* threadFuncWrapper(void* v){ + ThreadContext* ctx=(ThreadContext*)v; + pthread_t t=pthread_self(); + markCreated(t); + void* res=ctx->func_(ctx->param_); + setTerminated(pthread_self()); + delete ctx; + return res; + } + virtual int pthread_create(pthread_t * t, const pthread_attr_t *a, + void *(*f)(void *), void *d) + { + int ret=LIBC_SYMBOLS.pthread_create(t,a,threadFuncWrapper, + new ThreadContext(f,d)); + if(verbose) + TEST_TRACE(("thread created %p",*t)); + return ret; + } + virtual int pthread_join(pthread_t t, void ** r){ + if(verbose) TEST_TRACE(("thread joined %p",t)); + int ret=LIBC_SYMBOLS.pthread_join(t,r); + if(ret==0) + markDestroyed(t); + return ret; + } + virtual int pthread_detach(pthread_t t){ + if(verbose) TEST_TRACE(("thread detached %p",t)); + int ret=LIBC_SYMBOLS.pthread_detach(t); + if(ret==0) + markDestroyed(t); + return ret; + } + virtual int pthread_cond_broadcast(pthread_cond_t *c){ + checkAccessed(c); + return LIBC_SYMBOLS.pthread_cond_broadcast(c); + } + virtual int pthread_cond_destroy(pthread_cond_t *c){ + markDestroyed(c); + return LIBC_SYMBOLS.pthread_cond_destroy(c); + } + virtual int pthread_cond_init(pthread_cond_t *c, const pthread_condattr_t *a){ + markCreated(c); + return LIBC_SYMBOLS.pthread_cond_init(c,a); + } + virtual int pthread_cond_signal(pthread_cond_t *c){ + checkAccessed(c); + return LIBC_SYMBOLS.pthread_cond_signal(c); + } + virtual int pthread_cond_timedwait(pthread_cond_t *c, + pthread_mutex_t *m, const struct timespec *t){ + checkAccessed(c); + return LIBC_SYMBOLS.pthread_cond_timedwait(c,m,t); + } + virtual int pthread_cond_wait(pthread_cond_t *c, pthread_mutex_t *m){ + checkAccessed(c); + return LIBC_SYMBOLS.pthread_cond_wait(c,m); + } + virtual int pthread_mutex_destroy(pthread_mutex_t *m){ + markDestroyed(m); + return LIBC_SYMBOLS.pthread_mutex_destroy(m); + } + virtual int pthread_mutex_init(pthread_mutex_t *m, const pthread_mutexattr_t *a){ + markCreated(m); + return LIBC_SYMBOLS.pthread_mutex_init(m,a); + } + virtual int pthread_mutex_lock(pthread_mutex_t *m){ + checkAccessed(m); + return LIBC_SYMBOLS.pthread_mutex_lock(m); + } + virtual int pthread_mutex_trylock(pthread_mutex_t *m){ + checkAccessed(m); + return LIBC_SYMBOLS.pthread_mutex_trylock(m); + } + virtual int pthread_mutex_unlock(pthread_mutex_t *m){ + checkAccessed(m); + return LIBC_SYMBOLS.pthread_mutex_unlock(m); + } +}; + +#endif /*PTHREADMOCKS_H_*/ + diff --git a/src/c/tests/TestClient.cc b/src/c/tests/TestClient.cc new file mode 100644 index 0000000..154fbed --- /dev/null +++ b/src/c/tests/TestClient.cc @@ -0,0 +1,1135 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#include +#include "CppAssertHelper.h" + +#include +#include +#include +#include + +#include "CollectionUtil.h" +#include "ThreadingUtil.h" + +using namespace Util; + +#include "Vector.h" +using namespace std; + +#include +#include + +#include +#include +#include +#include "Util.h" + +struct buff_struct_2 { + int32_t len; + int32_t off; + char *buffer; +}; + +static int Stat_eq(struct Stat* a, struct Stat* b) +{ + if (a->czxid != b->czxid) return 0; + if (a->mzxid != b->mzxid) return 0; + if (a->ctime != b->ctime) return 0; + if (a->mtime != b->mtime) return 0; + if (a->version != b->version) return 0; + if (a->cversion != b->cversion) return 0; + if (a->aversion != b->aversion) return 0; + if (a->ephemeralOwner != b->ephemeralOwner) return 0; + if (a->dataLength != b->dataLength) return 0; + if (a->numChildren != b->numChildren) return 0; + if (a->pzxid != b->pzxid) return 0; + return 1; +} +#ifdef THREADED + static void yield(zhandle_t *zh, int i) + { + sleep(i); + } +#else + static void yield(zhandle_t *zh, int seconds) + { + int fd; + int interest; + int events; + struct timeval tv; + int rc; + time_t expires = time(0) + seconds; + time_t timeLeft = seconds; + fd_set rfds, wfds, efds; + FD_ZERO(&rfds); + FD_ZERO(&wfds); + FD_ZERO(&efds); + + while(timeLeft >= 0) { + zookeeper_interest(zh, &fd, &interest, &tv); + if (fd != -1) { + if (interest&ZOOKEEPER_READ) { + FD_SET(fd, &rfds); + } else { + FD_CLR(fd, &rfds); + } + if (interest&ZOOKEEPER_WRITE) { + FD_SET(fd, &wfds); + } else { + FD_CLR(fd, &wfds); + } + } else { + fd = 0; + } + FD_SET(0, &rfds); + if (tv.tv_sec > timeLeft) { + tv.tv_sec = timeLeft; + } + rc = select(fd+1, &rfds, &wfds, &efds, &tv); + timeLeft = expires - time(0); + events = 0; + if (FD_ISSET(fd, &rfds)) { + events |= ZOOKEEPER_READ; + } + if (FD_ISSET(fd, &wfds)) { + events |= ZOOKEEPER_WRITE; + } + zookeeper_process(zh, events); + } + } +#endif + +typedef struct evt { + string path; + int type; +} evt_t; + +typedef struct watchCtx { +private: + list events; + watchCtx(const watchCtx&); + watchCtx& operator=(const watchCtx&); +public: + bool connected; + zhandle_t *zh; + Mutex mutex; + + watchCtx() { + connected = false; + zh = 0; + } + ~watchCtx() { + if (zh) { + zookeeper_close(zh); + zh = 0; + } + } + + evt_t getEvent() { + evt_t evt; + mutex.acquire(); + CPPUNIT_ASSERT( events.size() > 0); + evt = events.front(); + events.pop_front(); + mutex.release(); + return evt; + } + + int countEvents() { + int count; + mutex.acquire(); + count = events.size(); + mutex.release(); + return count; + } + + void putEvent(evt_t evt) { + mutex.acquire(); + events.push_back(evt); + mutex.release(); + } + + bool waitForConnected(zhandle_t *zh) { + time_t expires = time(0) + 10; + while(!connected && time(0) < expires) { + yield(zh, 1); + } + return connected; + } + bool waitForDisconnected(zhandle_t *zh) { + time_t expires = time(0) + 15; + while(connected && time(0) < expires) { + yield(zh, 1); + } + return !connected; + } +} watchctx_t; + +class Zookeeper_simpleSystem : public CPPUNIT_NS::TestFixture +{ + CPPUNIT_TEST_SUITE(Zookeeper_simpleSystem); + CPPUNIT_TEST(testAsyncWatcherAutoReset); + CPPUNIT_TEST(testDeserializeString); + CPPUNIT_TEST(testFirstServerDown); +#ifdef THREADED + CPPUNIT_TEST(testNullData); +#ifdef ZOO_IPV6_ENABLED + CPPUNIT_TEST(testIPV6); +#endif + CPPUNIT_TEST(testPath); + CPPUNIT_TEST(testPathValidation); + CPPUNIT_TEST(testPing); + CPPUNIT_TEST(testAcl); + CPPUNIT_TEST(testChroot); + CPPUNIT_TEST(testAuth); + CPPUNIT_TEST(testHangingClient); + CPPUNIT_TEST(testWatcherAutoResetWithGlobal); + CPPUNIT_TEST(testWatcherAutoResetWithLocal); + CPPUNIT_TEST(testGetChildren2); +#endif + CPPUNIT_TEST_SUITE_END(); + + static void watcher(zhandle_t *, int type, int state, const char *path,void*v){ + watchctx_t *ctx = (watchctx_t*)v; + + if (state == ZOO_CONNECTED_STATE) { + ctx->connected = true; + } else { + ctx->connected = false; + } + if (type != ZOO_SESSION_EVENT) { + evt_t evt; + evt.path = path; + evt.type = type; + ctx->putEvent(evt); + } + } + + static const char hostPorts[]; + + const char *getHostPorts() { + return hostPorts; + } + + zhandle_t *createClient(watchctx_t *ctx) { + return createClient(hostPorts, ctx); + } + + zhandle_t *createClient(const char *hp, watchctx_t *ctx) { + zhandle_t *zk = zookeeper_init(hp, watcher, 10000, 0, ctx, 0); + ctx->zh = zk; + sleep(1); + return zk; + } + + zhandle_t *createchClient(watchctx_t *ctx, const char* chroot) { + zhandle_t *zk = zookeeper_init(chroot, watcher, 10000, 0, ctx, 0); + ctx->zh = zk; + sleep(1); + return zk; + } + + FILE *logfile; +public: + + Zookeeper_simpleSystem() { + logfile = openlogfile("Zookeeper_simpleSystem"); + } + + ~Zookeeper_simpleSystem() { + if (logfile) { + fflush(logfile); + fclose(logfile); + logfile = 0; + } + } + + void setUp() + { + zoo_set_log_stream(logfile); + } + + + void startServer() { + char cmd[1024]; + sprintf(cmd, "%s start %s", ZKSERVER_CMD, getHostPorts()); + CPPUNIT_ASSERT(system(cmd) == 0); + } + + void stopServer() { + char cmd[1024]; + sprintf(cmd, "%s stop %s", ZKSERVER_CMD, getHostPorts()); + CPPUNIT_ASSERT(system(cmd) == 0); + } + + void tearDown() + { + } + + /** have a callback in the default watcher **/ + static void default_zoo_watcher(zhandle_t *zzh, int type, int state, const char *path, void *context){ + int zrc = 0; + struct String_vector str_vec = {0, NULL}; + zrc = zoo_wget_children(zzh, "/mytest", default_zoo_watcher, NULL, &str_vec); + } + + /** ZOOKEEPER-1057 This checks that the client connects to the second server when the first is not reachable **/ + void testFirstServerDown() { + watchctx_t ctx; + + zoo_deterministic_conn_order(true); + + zhandle_t* zk = createClient("127.0.0.1:22182,127.0.0.1:22181", &ctx); + CPPUNIT_ASSERT(zk != 0); + CPPUNIT_ASSERT(ctx.waitForConnected(zk)); + } + + /** this checks for a deadlock in calling zookeeper_close and calls from a default watcher that might get triggered just when zookeeper_close() is in progress **/ + void testHangingClient() { + int zrc = 0; + char buff[10] = "testall"; + char path[512]; + watchctx_t *ctx; + struct String_vector str_vec = {0, NULL}; + zhandle_t *zh = zookeeper_init(hostPorts, NULL, 10000, 0, ctx, 0); + sleep(1); + zrc = zoo_create(zh, "/mytest", buff, 10, &ZOO_OPEN_ACL_UNSAFE, 0, path, 512); + zrc = zoo_wget_children(zh, "/mytest", default_zoo_watcher, NULL, &str_vec); + zrc = zoo_create(zh, "/mytest/test1", buff, 10, &ZOO_OPEN_ACL_UNSAFE, 0, path, 512); + zrc = zoo_wget_children(zh, "/mytest", default_zoo_watcher, NULL, &str_vec); + zrc = zoo_delete(zh, "/mytest/test1", -1); + zookeeper_close(zh); + } + + + void testPing() + { + watchctx_t ctxIdle; + watchctx_t ctxWC; + zhandle_t *zkIdle = createClient(&ctxIdle); + zhandle_t *zkWatchCreator = createClient(&ctxWC); + + CPPUNIT_ASSERT(zkIdle); + CPPUNIT_ASSERT(zkWatchCreator); + + char path[80]; + sprintf(path, "/testping"); + int rc = zoo_create(zkWatchCreator, path, "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, 0, 0); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + + for(int i = 0; i < 30; i++) { + sprintf(path, "/testping/%i", i); + rc = zoo_create(zkWatchCreator, path, "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, 0, 0); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + } + + for(int i = 0; i < 30; i++) { + sprintf(path, "/testping/%i", i); + struct Stat stat; + rc = zoo_exists(zkIdle, path, 1, &stat); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + } + + for(int i = 0; i < 30; i++) { + sprintf(path, "/testping/%i", i); + usleep(500000); + rc = zoo_delete(zkWatchCreator, path, -1); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + } + struct Stat stat; + CPPUNIT_ASSERT_EQUAL((int)ZNONODE, zoo_exists(zkIdle, "/testping/0", 0, &stat)); + } + + bool waitForEvent(zhandle_t *zh, watchctx_t *ctx, int seconds) { + time_t expires = time(0) + seconds; + while(ctx->countEvents() == 0 && time(0) < expires) { + yield(zh, 1); + } + return ctx->countEvents() > 0; + } + +#define COUNT 100 + + static zhandle_t *async_zk; + static volatile int count; + static const char* hp_chroot; + + static void statCompletion(int rc, const struct Stat *stat, const void *data) { + int tmp = (int) (long) data; + CPPUNIT_ASSERT_EQUAL(tmp, rc); + } + + static void stringCompletion(int rc, const char *value, const void *data) { + char *path = (char*)data; + + if (rc == ZCONNECTIONLOSS && path) { + // Try again + rc = zoo_acreate(async_zk, path, "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, stringCompletion, 0); + } else if (rc != ZOK) { + // fprintf(stderr, "rc = %d with path = %s\n", rc, (path ? path : "null")); + } + if (path) { + free(path); + } + } + + static void create_completion_fn(int rc, const char* value, const void *data) { + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + count++; + } + + static void waitForCreateCompletion(int seconds) { + time_t expires = time(0) + seconds; + while(count == 0 && time(0) < expires) { + sleep(1); + } + count--; + } + + static void watcher_chroot_fn(zhandle_t *zh, int type, + int state, const char *path,void *watcherCtx) { + // check for path + char *client_path = (char *) watcherCtx; + CPPUNIT_ASSERT(strcmp(client_path, path) == 0); + count ++; + } + + static void waitForChrootWatch(int seconds) { + time_t expires = time(0) + seconds; + while (count == 0 && time(0) < expires) { + sleep(1); + } + count--; + } + + static void waitForVoidCompletion(int seconds) { + time_t expires = time(0) + seconds; + while(count == 0 && time(0) < expires) { + sleep(1); + } + count--; + } + + static void voidCompletion(int rc, const void *data) { + int tmp = (int) (long) data; + CPPUNIT_ASSERT_EQUAL(tmp, rc); + count++; + } + + static void verifyCreateFails(const char *path, zhandle_t *zk) { + CPPUNIT_ASSERT_EQUAL((int)ZBADARGUMENTS, zoo_create(zk, + path, "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, 0, 0)); + } + + static void verifyCreateOk(const char *path, zhandle_t *zk) { + CPPUNIT_ASSERT_EQUAL((int)ZOK, zoo_create(zk, + path, "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, 0, 0)); + } + + static void verifyCreateFailsSeq(const char *path, zhandle_t *zk) { + CPPUNIT_ASSERT_EQUAL((int)ZBADARGUMENTS, zoo_create(zk, + path, "", 0, &ZOO_OPEN_ACL_UNSAFE, ZOO_SEQUENCE, 0, 0)); + } + + static void verifyCreateOkSeq(const char *path, zhandle_t *zk) { + CPPUNIT_ASSERT_EQUAL((int)ZOK, zoo_create(zk, + path, "", 0, &ZOO_OPEN_ACL_UNSAFE, ZOO_SEQUENCE, 0, 0)); + } + + + /** + returns false if the vectors dont match + **/ + bool compareAcl(struct ACL_vector acl1, struct ACL_vector acl2) { + if (acl1.count != acl2.count) { + return false; + } + struct ACL *aclval1 = acl1.data; + struct ACL *aclval2 = acl2.data; + if (aclval1->perms != aclval2->perms) { + return false; + } + struct Id id1 = aclval1->id; + struct Id id2 = aclval2->id; + if (strcmp(id1.scheme, id2.scheme) != 0) { + return false; + } + if (strcmp(id1.id, id2.id) != 0) { + return false; + } + return true; + } + + void testDeserializeString() { + char *val_str; + int rc = 0; + int val = -1; + struct iarchive *ia; + struct buff_struct_2 *b; + struct oarchive *oa = create_buffer_oarchive(); + oa->serialize_Int(oa, "int", &val); + b = (struct buff_struct_2 *) oa->priv; + ia = create_buffer_iarchive(b->buffer, b->len); + rc = ia->deserialize_String(ia, "string", &val_str); + CPPUNIT_ASSERT_EQUAL(-EINVAL, rc); + } + + void testAcl() { + int rc; + struct ACL_vector aclvec; + struct Stat stat; + watchctx_t ctx; + zhandle_t *zk = createClient(&ctx); + rc = zoo_create(zk, "/acl", "", 0, + &ZOO_OPEN_ACL_UNSAFE, 0, 0, 0); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + rc = zoo_get_acl(zk, "/acl", &aclvec, &stat ); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + bool cmp = compareAcl(ZOO_OPEN_ACL_UNSAFE, aclvec); + CPPUNIT_ASSERT_EQUAL(true, cmp); + rc = zoo_set_acl(zk, "/acl", -1, &ZOO_READ_ACL_UNSAFE); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + rc = zoo_get_acl(zk, "/acl", &aclvec, &stat); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + cmp = compareAcl(ZOO_READ_ACL_UNSAFE, aclvec); + CPPUNIT_ASSERT_EQUAL(true, cmp); + } + + + void testAuth() { + int rc; + count = 0; + watchctx_t ctx1, ctx2, ctx3, ctx4, ctx5; + zhandle_t *zk = createClient(&ctx1); + struct ACL_vector nodeAcl; + struct ACL acl_val; + rc = zoo_add_auth(0, "", 0, 0, voidCompletion, (void*)-1); + CPPUNIT_ASSERT_EQUAL((int) ZBADARGUMENTS, rc); + + rc = zoo_add_auth(zk, 0, 0, 0, voidCompletion, (void*)-1); + CPPUNIT_ASSERT_EQUAL((int) ZBADARGUMENTS, rc); + + // auth as pat, create /tauth1, close session + rc = zoo_add_auth(zk, "digest", "pat:passwd", 10, voidCompletion, + (void*)ZOK); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + waitForVoidCompletion(3); + CPPUNIT_ASSERT(count == 0); + + rc = zoo_create(zk, "/tauth1", "", 0, &ZOO_CREATOR_ALL_ACL, 0, 0, 0); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + + { + //create a new client + zk = createClient(&ctx4); + rc = zoo_add_auth(zk, "digest", "", 0, voidCompletion, (void*)ZOK); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + waitForVoidCompletion(3); + CPPUNIT_ASSERT(count == 0); + + rc = zoo_add_auth(zk, "digest", "", 0, voidCompletion, (void*)ZOK); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + waitForVoidCompletion(3); + CPPUNIT_ASSERT(count == 0); + } + + //create a new client + zk = createClient(&ctx2); + + rc = zoo_add_auth(zk, "digest", "pat:passwd2", 11, voidCompletion, + (void*)ZOK); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + waitForVoidCompletion(3); + CPPUNIT_ASSERT(count == 0); + + char buf[1024]; + int blen = sizeof(buf); + struct Stat stat; + rc = zoo_get(zk, "/tauth1", 0, buf, &blen, &stat); + CPPUNIT_ASSERT_EQUAL((int)ZNOAUTH, rc); + // add auth pat w/correct pass verify success + rc = zoo_add_auth(zk, "digest", "pat:passwd", 10, voidCompletion, + (void*)ZOK); + + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + rc = zoo_get(zk, "/tauth1", 0, buf, &blen, &stat); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + waitForVoidCompletion(3); + CPPUNIT_ASSERT(count == 0); + //create a new client + zk = createClient(&ctx3); + rc = zoo_add_auth(zk, "digest", "pat:passwd", 10, voidCompletion, (void*) ZOK); + waitForVoidCompletion(3); + CPPUNIT_ASSERT(count == 0); + rc = zoo_add_auth(zk, "ip", "none", 4, voidCompletion, (void*)ZOK); + //make the server forget the auths + waitForVoidCompletion(3); + CPPUNIT_ASSERT(count == 0); + + stopServer(); + CPPUNIT_ASSERT(ctx3.waitForDisconnected(zk)); + startServer(); + CPPUNIT_ASSERT(ctx3.waitForConnected(zk)); + // now try getting the data + rc = zoo_get(zk, "/tauth1", 0, buf, &blen, &stat); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + // also check for get + rc = zoo_get_acl(zk, "/", &nodeAcl, &stat); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + // check if the acl has all the perms + CPPUNIT_ASSERT_EQUAL((int)1, (int)nodeAcl.count); + acl_val = *(nodeAcl.data); + CPPUNIT_ASSERT_EQUAL((int) acl_val.perms, ZOO_PERM_ALL); + // verify on root node + rc = zoo_set_acl(zk, "/", -1, &ZOO_CREATOR_ALL_ACL); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + + rc = zoo_set_acl(zk, "/", -1, &ZOO_OPEN_ACL_UNSAFE); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + + //[ZOOKEEPER-1108], test that auth info is sent to server, if client is not + //connected to server when zoo_add_auth was called. + zhandle_t *zk_auth = zookeeper_init(hostPorts, NULL, 10000, 0, NULL, 0); + rc = zoo_add_auth(zk_auth, "digest", "pat:passwd", 10, voidCompletion, (void*)ZOK); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + sleep(2); + CPPUNIT_ASSERT(count == 1); + count = 0; + CPPUNIT_ASSERT_EQUAL((int) ZOK, zookeeper_close(zk_auth)); + + // [ZOOKEEPER-800] zoo_add_auth should return ZINVALIDSTATE if + // the connection is closed. + zhandle_t *zk2 = zookeeper_init(hostPorts, NULL, 10000, 0, NULL, 0); + sleep(1); + CPPUNIT_ASSERT_EQUAL((int) ZOK, zookeeper_close(zk2)); + CPPUNIT_ASSERT_EQUAL(0, zoo_state(zk2)); // 0 ==> ZOO_CLOSED_STATE + rc = zoo_add_auth(zk2, "digest", "pat:passwd", 10, voidCompletion, (void*)ZOK); + CPPUNIT_ASSERT_EQUAL((int) ZINVALIDSTATE, rc); + + struct sockaddr addr; + socklen_t addr_len = sizeof(addr); + zk = createClient(&ctx5); + stopServer(); + CPPUNIT_ASSERT(ctx5.waitForDisconnected(zk)); + CPPUNIT_ASSERT(zookeeper_get_connected_host(zk, &addr, &addr_len) == NULL); + addr_len = sizeof(addr); + startServer(); + CPPUNIT_ASSERT(ctx5.waitForConnected(zk)); + CPPUNIT_ASSERT(zookeeper_get_connected_host(zk, &addr, &addr_len) != NULL); + } + + void testGetChildren2() { + int rc; + watchctx_t ctx; + zhandle_t *zk = createClient(&ctx); + + rc = zoo_create(zk, "/parent", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, 0, 0); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + + rc = zoo_create(zk, "/parent/child_a", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, 0, 0); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + + rc = zoo_create(zk, "/parent/child_b", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, 0, 0); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + + rc = zoo_create(zk, "/parent/child_c", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, 0, 0); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + + rc = zoo_create(zk, "/parent/child_d", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, 0, 0); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + + struct String_vector strings; + struct Stat stat_a, stat_b; + + rc = zoo_get_children2(zk, "/parent", 0, &strings, &stat_a); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + + rc = zoo_exists(zk, "/parent", 0, &stat_b); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + + CPPUNIT_ASSERT(Stat_eq(&stat_a, &stat_b)); + CPPUNIT_ASSERT(stat_a.numChildren == 4); + } + + void testIPV6() { + watchctx_t ctx; + zhandle_t *zk = createClient("::1:22181", &ctx); + CPPUNIT_ASSERT(zk); + int rc = 0; + rc = zoo_create(zk, "/ipv6", NULL, -1, + &ZOO_OPEN_ACL_UNSAFE, 0, 0, 0); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + } + + void testNullData() { + watchctx_t ctx; + zhandle_t *zk = createClient(&ctx); + CPPUNIT_ASSERT(zk); + int rc = 0; + rc = zoo_create(zk, "/mahadev", NULL, -1, + &ZOO_OPEN_ACL_UNSAFE, 0, 0, 0); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + char buffer[512]; + struct Stat stat; + int len = 512; + rc = zoo_wget(zk, "/mahadev", NULL, NULL, buffer, &len, &stat); + CPPUNIT_ASSERT_EQUAL( -1, len); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + rc = zoo_set(zk, "/mahadev", NULL, -1, -1); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + rc = zoo_wget(zk, "/mahadev", NULL, NULL, buffer, &len, &stat); + CPPUNIT_ASSERT_EQUAL( -1, len); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + } + + void testPath() { + watchctx_t ctx; + char pathbuf[20]; + zhandle_t *zk = createClient(&ctx); + CPPUNIT_ASSERT(zk); + int rc = 0; + + memset(pathbuf, 'X', 20); + rc = zoo_create(zk, "/testpathpath0", "", 0, + &ZOO_OPEN_ACL_UNSAFE, 0, pathbuf, 0); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + CPPUNIT_ASSERT_EQUAL('X', pathbuf[0]); + + rc = zoo_create(zk, "/testpathpath1", "", 0, + &ZOO_OPEN_ACL_UNSAFE, 0, pathbuf, 1); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + CPPUNIT_ASSERT(strlen(pathbuf) == 0); + + rc = zoo_create(zk, "/testpathpath2", "", 0, + &ZOO_OPEN_ACL_UNSAFE, 0, pathbuf, 2); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + CPPUNIT_ASSERT(strcmp(pathbuf, "/") == 0); + + rc = zoo_create(zk, "/testpathpath3", "", 0, + &ZOO_OPEN_ACL_UNSAFE, 0, pathbuf, 3); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + CPPUNIT_ASSERT(strcmp(pathbuf, "/t") == 0); + + rc = zoo_create(zk, "/testpathpath7", "", 0, + &ZOO_OPEN_ACL_UNSAFE, 0, pathbuf, 15); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + CPPUNIT_ASSERT(strcmp(pathbuf, "/testpathpath7") == 0); + + rc = zoo_create(zk, "/testpathpath8", "", 0, + &ZOO_OPEN_ACL_UNSAFE, 0, pathbuf, 16); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + CPPUNIT_ASSERT(strcmp(pathbuf, "/testpathpath8") == 0); + } + + void testPathValidation() { + watchctx_t ctx; + zhandle_t *zk = createClient(&ctx); + CPPUNIT_ASSERT(zk); + + verifyCreateFails(0, zk); + verifyCreateFails("", zk); + verifyCreateFails("//", zk); + verifyCreateFails("///", zk); + verifyCreateFails("////", zk); + verifyCreateFails("/.", zk); + verifyCreateFails("/..", zk); + verifyCreateFails("/./", zk); + verifyCreateFails("/../", zk); + verifyCreateFails("/foo/./", zk); + verifyCreateFails("/foo/../", zk); + verifyCreateFails("/foo/.", zk); + verifyCreateFails("/foo/..", zk); + verifyCreateFails("/./.", zk); + verifyCreateFails("/../..", zk); + verifyCreateFails("/foo/bar/", zk); + verifyCreateFails("/foo//bar", zk); + verifyCreateFails("/foo/bar//", zk); + + verifyCreateFails("foo", zk); + verifyCreateFails("a", zk); + + // verify that trailing fails, except for seq which adds suffix + verifyCreateOk("/createseq", zk); + verifyCreateFails("/createseq/", zk); + verifyCreateOkSeq("/createseq/", zk); + verifyCreateOkSeq("/createseq/.", zk); + verifyCreateOkSeq("/createseq/..", zk); + verifyCreateFailsSeq("/createseq//", zk); + verifyCreateFailsSeq("/createseq/./", zk); + verifyCreateFailsSeq("/createseq/../", zk); + + verifyCreateOk("/.foo", zk); + verifyCreateOk("/.f.", zk); + verifyCreateOk("/..f", zk); + verifyCreateOk("/..f..", zk); + verifyCreateOk("/f.c", zk); + verifyCreateOk("/f", zk); + verifyCreateOk("/f/.f", zk); + verifyCreateOk("/f/f.", zk); + verifyCreateOk("/f/..f", zk); + verifyCreateOk("/f/f..", zk); + verifyCreateOk("/f/.f/f", zk); + verifyCreateOk("/f/f./f", zk); + } + + void testChroot() { + // the c client async callbacks do + // not callback with the path, so + // we dont need to test taht for now + // we should fix that though soon! + watchctx_t ctx, ctx_ch; + zhandle_t *zk, *zk_ch; + char buf[60]; + int rc, len; + struct Stat stat; + const char* data = "garbage"; + const char* retStr = "/chroot"; + const char* root= "/"; + zk_ch = createchClient(&ctx_ch, "127.0.0.1:22181/testch1/mahadev"); + CPPUNIT_ASSERT(zk_ch != NULL); + zk = createClient(&ctx); + // first test with a NULL zk handle, make sure client library does not + // dereference a null pointer, but instead returns ZBADARGUMENTS + rc = zoo_create(NULL, "/testch1", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, 0, 0); + CPPUNIT_ASSERT_EQUAL((int) ZBADARGUMENTS, rc); + rc = zoo_create(zk, "/testch1", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, 0, 0); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + rc = zoo_create(zk, "/testch1/mahadev", data, 7, &ZOO_OPEN_ACL_UNSAFE, 0, 0, 0); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + // try an exists with / + len = 60; + rc = zoo_get(zk_ch, "/", 0, buf, &len, &stat); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + //check if the data is the same + CPPUNIT_ASSERT(strncmp(buf, data, 7) == 0); + //check for watches + rc = zoo_wexists(zk_ch, "/chroot", watcher_chroot_fn, (void *) retStr, &stat); + //now check if we can do create/delete/get/sets/acls/getChildren and others + //check create + rc = zoo_create(zk_ch, "/chroot", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, 0,0); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + waitForChrootWatch(3); + CPPUNIT_ASSERT(count == 0); + rc = zoo_create(zk_ch, "/chroot/child", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, 0, 0); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + rc = zoo_exists(zk, "/testch1/mahadev/chroot/child", 0, &stat); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + + rc = zoo_delete(zk_ch, "/chroot/child", -1); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + rc = zoo_exists(zk, "/testch1/mahadev/chroot/child", 0, &stat); + CPPUNIT_ASSERT_EQUAL((int) ZNONODE, rc); + rc = zoo_wget(zk_ch, "/chroot", watcher_chroot_fn, (char*) retStr, + buf, &len, &stat); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + rc = zoo_set(zk_ch, "/chroot",buf, 3, -1); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + waitForChrootWatch(3); + CPPUNIT_ASSERT(count == 0); + // check for getchildren + struct String_vector children; + rc = zoo_get_children(zk_ch, "/", 0, &children); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + CPPUNIT_ASSERT_EQUAL((int)1, (int)children.count); + //check if te child if chroot + CPPUNIT_ASSERT(strcmp((retStr+1), children.data[0]) == 0); + // check for get/set acl + struct ACL_vector acl; + rc = zoo_get_acl(zk_ch, "/", &acl, &stat); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + CPPUNIT_ASSERT_EQUAL((int)1, (int)acl.count); + CPPUNIT_ASSERT_EQUAL((int)ZOO_PERM_ALL, (int)acl.data->perms); + // set acl + rc = zoo_set_acl(zk_ch, "/chroot", -1, &ZOO_READ_ACL_UNSAFE); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + // see if you add children + rc = zoo_create(zk_ch, "/chroot/child1", "",0, &ZOO_OPEN_ACL_UNSAFE, 0, 0, 0); + CPPUNIT_ASSERT_EQUAL((int)ZNOAUTH, rc); + //add wget children test + rc = zoo_wget_children(zk_ch, "/", watcher_chroot_fn, (char*) root, &children); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + + //now create a node + rc = zoo_create(zk_ch, "/child2", "",0, &ZOO_OPEN_ACL_UNSAFE, 0, 0, 0); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + waitForChrootWatch(3); + CPPUNIT_ASSERT(count == 0); + //check for one async call just to make sure + rc = zoo_acreate(zk_ch, "/child3", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, + create_completion_fn, 0); + waitForCreateCompletion(3); + CPPUNIT_ASSERT(count == 0); + + //ZOOKEEPER-1027 correctly return path_buffer without prefixed chroot + const char* path = "/zookeeper1027"; + char path_buffer[1024]; + int path_buffer_len=sizeof(path_buffer); + rc = zoo_create(zk_ch, path, "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, path_buffer, path_buffer_len); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + CPPUNIT_ASSERT_EQUAL(string(path), string(path_buffer)); + } + + void testAsyncWatcherAutoReset() + { + watchctx_t ctx; + zhandle_t *zk = createClient(&ctx); + watchctx_t lctx[COUNT]; + int i; + char path[80]; + int rc; + evt_t evt; + + async_zk = zk; + for(i = 0; i < COUNT; i++) { + sprintf(path, "/awar%d", i); + rc = zoo_awexists(zk, path, watcher, &lctx[i], statCompletion, (void*)ZNONODE); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + } + + yield(zk, 0); + + for(i = 0; i < COUNT/2; i++) { + sprintf(path, "/awar%d", i); + rc = zoo_acreate(zk, path, "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, stringCompletion, strdup(path)); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + } + + yield(zk, 3); + for(i = 0; i < COUNT/2; i++) { + sprintf(path, "/awar%d", i); + CPPUNIT_ASSERT_MESSAGE(path, waitForEvent(zk, &lctx[i], 5)); + evt = lctx[i].getEvent(); + CPPUNIT_ASSERT_EQUAL_MESSAGE(evt.path.c_str(), ZOO_CREATED_EVENT, evt.type); + CPPUNIT_ASSERT_EQUAL(string(path), evt.path); + } + + for(i = COUNT/2 + 1; i < COUNT*10; i++) { + sprintf(path, "/awar%d", i); + rc = zoo_acreate(zk, path, "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, stringCompletion, strdup(path)); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + } + + yield(zk, 1); + stopServer(); + CPPUNIT_ASSERT(ctx.waitForDisconnected(zk)); + startServer(); + CPPUNIT_ASSERT(ctx.waitForConnected(zk)); + yield(zk, 3); + for(i = COUNT/2+1; i < COUNT; i++) { + sprintf(path, "/awar%d", i); + CPPUNIT_ASSERT_MESSAGE(path, waitForEvent(zk, &lctx[i], 5)); + evt = lctx[i].getEvent(); + CPPUNIT_ASSERT_EQUAL_MESSAGE(evt.path, ZOO_CREATED_EVENT, evt.type); + CPPUNIT_ASSERT_EQUAL(string(path), evt.path); + } + } + + void testWatcherAutoReset(zhandle_t *zk, watchctx_t *ctxGlobal, + watchctx_t *ctxLocal) + { + bool isGlobal = (ctxGlobal == ctxLocal); + int rc; + struct Stat stat; + char buf[1024]; + int blen; + struct String_vector strings; + const char *testName; + + rc = zoo_create(zk, "/watchtest", "", 0, + &ZOO_OPEN_ACL_UNSAFE, 0, 0, 0); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + rc = zoo_create(zk, "/watchtest/child", "", 0, + &ZOO_OPEN_ACL_UNSAFE, ZOO_EPHEMERAL, 0, 0); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + + if (isGlobal) { + testName = "GlobalTest"; + rc = zoo_get_children(zk, "/watchtest", 1, &strings); + deallocate_String_vector(&strings); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + blen = sizeof(buf); + rc = zoo_get(zk, "/watchtest/child", 1, buf, &blen, &stat); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + rc = zoo_exists(zk, "/watchtest/child2", 1, &stat); + CPPUNIT_ASSERT_EQUAL((int)ZNONODE, rc); + } else { + testName = "LocalTest"; + rc = zoo_wget_children(zk, "/watchtest", watcher, ctxLocal, + &strings); + deallocate_String_vector(&strings); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + blen = sizeof(buf); + rc = zoo_wget(zk, "/watchtest/child", watcher, ctxLocal, + buf, &blen, &stat); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + rc = zoo_wexists(zk, "/watchtest/child2", watcher, ctxLocal, + &stat); + CPPUNIT_ASSERT_EQUAL((int)ZNONODE, rc); + } + + CPPUNIT_ASSERT(ctxLocal->countEvents() == 0); + + stopServer(); + CPPUNIT_ASSERT_MESSAGE(testName, ctxGlobal->waitForDisconnected(zk)); + startServer(); + CPPUNIT_ASSERT_MESSAGE(testName, ctxLocal->waitForConnected(zk)); + + CPPUNIT_ASSERT(ctxLocal->countEvents() == 0); + + rc = zoo_set(zk, "/watchtest/child", "1", 1, -1); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + struct Stat stat1, stat2; + rc = zoo_set2(zk, "/watchtest/child", "1", 1, -1, &stat1); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + CPPUNIT_ASSERT(stat1.version >= 0); + rc = zoo_set2(zk, "/watchtest/child", "1", 1, stat1.version, &stat2); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + rc = zoo_set(zk, "/watchtest/child", "1", 1, stat2.version); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + rc = zoo_create(zk, "/watchtest/child2", "", 0, + &ZOO_OPEN_ACL_UNSAFE, 0, 0, 0); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + + CPPUNIT_ASSERT_MESSAGE(testName, waitForEvent(zk, ctxLocal, 5)); + + evt_t evt = ctxLocal->getEvent(); + CPPUNIT_ASSERT_EQUAL_MESSAGE(evt.path, ZOO_CHANGED_EVENT, evt.type); + CPPUNIT_ASSERT_EQUAL(string("/watchtest/child"), evt.path); + + CPPUNIT_ASSERT_MESSAGE(testName, waitForEvent(zk, ctxLocal, 5)); + // The create will trigget the get children and the + // exists watches + evt = ctxLocal->getEvent(); + CPPUNIT_ASSERT_EQUAL_MESSAGE(evt.path, ZOO_CREATED_EVENT, evt.type); + CPPUNIT_ASSERT_EQUAL(string("/watchtest/child2"), evt.path); + CPPUNIT_ASSERT_MESSAGE(testName, waitForEvent(zk, ctxLocal, 5)); + evt = ctxLocal->getEvent(); + CPPUNIT_ASSERT_EQUAL_MESSAGE(evt.path, ZOO_CHILD_EVENT, evt.type); + CPPUNIT_ASSERT_EQUAL(string("/watchtest"), evt.path); + + // Make sure Pings are giving us problems + sleep(5); + + CPPUNIT_ASSERT(ctxLocal->countEvents() == 0); + + stopServer(); + CPPUNIT_ASSERT_MESSAGE(testName, ctxGlobal->waitForDisconnected(zk)); + startServer(); + CPPUNIT_ASSERT_MESSAGE(testName, ctxGlobal->waitForConnected(zk)); + + if (isGlobal) { + testName = "GlobalTest"; + rc = zoo_get_children(zk, "/watchtest", 1, &strings); + deallocate_String_vector(&strings); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + blen = sizeof(buf); + rc = zoo_get(zk, "/watchtest/child", 1, buf, &blen, &stat); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + rc = zoo_exists(zk, "/watchtest/child2", 1, &stat); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + } else { + testName = "LocalTest"; + rc = zoo_wget_children(zk, "/watchtest", watcher, ctxLocal, + &strings); + deallocate_String_vector(&strings); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + blen = sizeof(buf); + rc = zoo_wget(zk, "/watchtest/child", watcher, ctxLocal, + buf, &blen, &stat); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + rc = zoo_wexists(zk, "/watchtest/child2", watcher, ctxLocal, + &stat); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + } + + zoo_delete(zk, "/watchtest/child2", -1); + + CPPUNIT_ASSERT_MESSAGE(testName, waitForEvent(zk, ctxLocal, 5)); + + evt = ctxLocal->getEvent(); + CPPUNIT_ASSERT_EQUAL_MESSAGE(evt.path, ZOO_DELETED_EVENT, evt.type); + CPPUNIT_ASSERT_EQUAL(string("/watchtest/child2"), evt.path); + + CPPUNIT_ASSERT_MESSAGE(testName, waitForEvent(zk, ctxLocal, 5)); + evt = ctxLocal->getEvent(); + CPPUNIT_ASSERT_EQUAL_MESSAGE(evt.path, ZOO_CHILD_EVENT, evt.type); + CPPUNIT_ASSERT_EQUAL(string("/watchtest"), evt.path); + + stopServer(); + CPPUNIT_ASSERT_MESSAGE(testName, ctxGlobal->waitForDisconnected(zk)); + startServer(); + CPPUNIT_ASSERT_MESSAGE(testName, ctxLocal->waitForConnected(zk)); + + zoo_delete(zk, "/watchtest/child", -1); + zoo_delete(zk, "/watchtest", -1); + + CPPUNIT_ASSERT_MESSAGE(testName, waitForEvent(zk, ctxLocal, 5)); + + evt = ctxLocal->getEvent(); + CPPUNIT_ASSERT_EQUAL_MESSAGE(evt.path, ZOO_DELETED_EVENT, evt.type); + CPPUNIT_ASSERT_EQUAL(string("/watchtest/child"), evt.path); + + // Make sure nothing is straggling + sleep(1); + CPPUNIT_ASSERT(ctxLocal->countEvents() == 0); + } + + void testWatcherAutoResetWithGlobal() + { + { + watchctx_t ctx; + zhandle_t *zk = createClient(&ctx); + int rc = zoo_create(zk, "/testarwg", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, 0, 0); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + rc = zoo_create(zk, "/testarwg/arwg", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, 0, 0); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + } + + { + watchctx_t ctx; + zhandle_t *zk = createchClient(&ctx, "127.0.0.1:22181/testarwg/arwg"); + + testWatcherAutoReset(zk, &ctx, &ctx); + } + } + + void testWatcherAutoResetWithLocal() + { + { + watchctx_t ctx; + zhandle_t *zk = createClient(&ctx); + int rc = zoo_create(zk, "/testarwl", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, 0, 0); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + rc = zoo_create(zk, "/testarwl/arwl", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, 0, 0); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + } + + { + watchctx_t ctx; + watchctx_t lctx; + zhandle_t *zk = createchClient(&ctx, "127.0.0.1:22181/testarwl/arwl"); + testWatcherAutoReset(zk, &ctx, &lctx); + } + } +}; + +volatile int Zookeeper_simpleSystem::count; +zhandle_t *Zookeeper_simpleSystem::async_zk; +const char Zookeeper_simpleSystem::hostPorts[] = "127.0.0.1:22181"; +CPPUNIT_TEST_SUITE_REGISTRATION(Zookeeper_simpleSystem); diff --git a/src/c/tests/TestClientRetry.cc b/src/c/tests/TestClientRetry.cc new file mode 100644 index 0000000..41d5179 --- /dev/null +++ b/src/c/tests/TestClientRetry.cc @@ -0,0 +1,273 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#include +#include "CppAssertHelper.h" + +#include +#include +#include +#include + +#include "CollectionUtil.h" +#include "ThreadingUtil.h" + +using namespace Util; + +#include "Vector.h" +using namespace std; + +#include +#include + +#include + +#include "Util.h" + +#ifdef THREADED + static void yield(zhandle_t *zh, int i) + { + sleep(i); + } +#else + static void yield(zhandle_t *zh, int seconds) + { + int fd; + int interest; + int events; + struct timeval tv; + int rc; + time_t expires = time(0) + seconds; + time_t timeLeft = seconds; + fd_set rfds, wfds, efds; + FD_ZERO(&rfds); + FD_ZERO(&wfds); + FD_ZERO(&efds); + + while(timeLeft >= 0) { + zookeeper_interest(zh, &fd, &interest, &tv); + if (fd != -1) { + if (interest&ZOOKEEPER_READ) { + FD_SET(fd, &rfds); + } else { + FD_CLR(fd, &rfds); + } + if (interest&ZOOKEEPER_WRITE) { + FD_SET(fd, &wfds); + } else { + FD_CLR(fd, &wfds); + } + } else { + fd = 0; + } + FD_SET(0, &rfds); + if (tv.tv_sec > timeLeft) { + tv.tv_sec = timeLeft; + } + rc = select(fd+1, &rfds, &wfds, &efds, &tv); + timeLeft = expires - time(0); + events = 0; + if (FD_ISSET(fd, &rfds)) { + events |= ZOOKEEPER_READ; + } + if (FD_ISSET(fd, &wfds)) { + events |= ZOOKEEPER_WRITE; + } + zookeeper_process(zh, events); + } + } +#endif + +typedef struct evt { + string path; + int type; +} evt_t; + +typedef struct watchCtx { +private: + list events; +public: + bool connected; + zhandle_t *zh; + Mutex mutex; + + watchCtx() { + connected = false; + zh = 0; + } + ~watchCtx() { + if (zh) { + zookeeper_close(zh); + zh = 0; + } + } + + evt_t getEvent() { + evt_t evt; + mutex.acquire(); + CPPUNIT_ASSERT( events.size() > 0); + evt = events.front(); + events.pop_front(); + mutex.release(); + return evt; + } + + int countEvents() { + int count; + mutex.acquire(); + count = events.size(); + mutex.release(); + return count; + } + + void putEvent(evt_t evt) { + mutex.acquire(); + events.push_back(evt); + mutex.release(); + } + + bool waitForConnected(zhandle_t *zh) { + time_t expires = time(0) + 10; + while(!connected && time(0) < expires) { + yield(zh, 1); + } + return connected; + } + bool waitForDisconnected(zhandle_t *zh) { + time_t expires = time(0) + 15; + while(connected && time(0) < expires) { + yield(zh, 1); + } + return !connected; + } +} watchctx_t; + +class Zookeeper_clientretry : public CPPUNIT_NS::TestFixture +{ + CPPUNIT_TEST_SUITE(Zookeeper_clientretry); +#ifdef THREADED + CPPUNIT_TEST(testRetry); +#endif + CPPUNIT_TEST_SUITE_END(); + + static void watcher(zhandle_t *, int type, int state, const char *path,void*v){ + watchctx_t *ctx = (watchctx_t*)v; + + if (state == ZOO_CONNECTED_STATE) { + ctx->connected = true; + } else { + ctx->connected = false; + } + if (type != ZOO_SESSION_EVENT) { + evt_t evt; + evt.path = path; + evt.type = type; + ctx->putEvent(evt); + } + } + + static const char hostPorts[]; + + const char *getHostPorts() { + return hostPorts; + } + + zhandle_t *createClient(watchctx_t *ctx) { + zhandle_t *zk = zookeeper_init(hostPorts, watcher, 10000, 0, + ctx, 0); + ctx->zh = zk; + sleep(1); + return zk; + } + + FILE *logfile; +public: + + Zookeeper_clientretry() { + logfile = openlogfile("Zookeeper_clientretry"); + } + + ~Zookeeper_clientretry() { + if (logfile) { + fflush(logfile); + fclose(logfile); + logfile = 0; + } + } + + void setUp() + { + zoo_set_log_stream(logfile); + + char cmd[1024]; + sprintf(cmd, "%s stop %s", ZKSERVER_CMD, getHostPorts()); + CPPUNIT_ASSERT(system(cmd) == 0); + + /* we are testing that if max cnxns is exceeded the server does the right thing */ + sprintf(cmd, "export ZKMAXCNXNS=1;%s startClean %s", ZKSERVER_CMD, getHostPorts()); + CPPUNIT_ASSERT(system(cmd) == 0); + + struct sigaction act; + act.sa_handler = SIG_IGN; + sigemptyset(&act.sa_mask); + act.sa_flags = 0; + CPPUNIT_ASSERT(sigaction(SIGPIPE, &act, NULL) == 0); + } + + void tearDown() + { + char cmd[1024]; + sprintf(cmd, "%s stop %s", ZKSERVER_CMD, getHostPorts()); + CPPUNIT_ASSERT(system(cmd) == 0); + + /* restart the server in "normal" mode */ + sprintf(cmd, "%s startClean %s", ZKSERVER_CMD, getHostPorts()); + CPPUNIT_ASSERT(system(cmd) == 0); + + struct sigaction act; + act.sa_handler = SIG_IGN; + sigemptyset(&act.sa_mask); + act.sa_flags = 0; + CPPUNIT_ASSERT(sigaction(SIGPIPE, &act, NULL) == 0); + } + + bool waitForEvent(zhandle_t *zh, watchctx_t *ctx, int seconds) { + time_t expires = time(0) + seconds; + while(ctx->countEvents() == 0 && time(0) < expires) { + yield(zh, 1); + } + return ctx->countEvents() > 0; + } + + static zhandle_t *async_zk; + + void testRetry() + { + watchctx_t ctx1, ctx2; + zhandle_t *zk1 = createClient(&ctx1); + CPPUNIT_ASSERT_EQUAL(true, ctx1.waitForConnected(zk1)); + zhandle_t *zk2 = createClient(&ctx2); + zookeeper_close(zk1); + CPPUNIT_ASSERT_EQUAL(true, ctx2.waitForConnected(zk2)); + ctx1.zh = 0; + } +}; + +zhandle_t *Zookeeper_clientretry::async_zk; +const char Zookeeper_clientretry::hostPorts[] = "127.0.0.1:22181"; +CPPUNIT_TEST_SUITE_REGISTRATION(Zookeeper_clientretry); diff --git a/src/c/tests/TestDriver.cc b/src/c/tests/TestDriver.cc new file mode 100644 index 0000000..d60db69 --- /dev/null +++ b/src/c/tests/TestDriver.cc @@ -0,0 +1,173 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include "Util.h" +#include "zookeeper_log.h" + +using namespace std; + +CPPUNIT_NS_BEGIN + +class EclipseOutputter: public CompilerOutputter +{ +public: + EclipseOutputter(TestResultCollector *result,ostream &stream): + CompilerOutputter(result,stream,"%p:%l: "),stream_(stream) + { + } + virtual void printFailedTestName( TestFailure *failure ){} + virtual void printFailureMessage( TestFailure *failure ) + { + stream_<<": "; + Message msg = failure->thrownException()->message(); + stream_<< msg.shortDescription(); + + string text; + for(int i=0; i the output must be in the compiler error format. + //bool selfTest = (argc > 1) && (std::string("-ide") == argv[1]); + globalTestConfig.addConfigFromCmdLine(argc,argv); + + ZKServer zkserver; + + // Create the event manager and test controller + CPPUNIT_NS::TestResult controller; + // Add a listener that colllects test result + CPPUNIT_NS::TestResultCollector result; + controller.addListener( &result ); + + // A listener that print dots as tests run. + // CPPUNIT_NS::TextTestProgressListener progress; + // CPPUNIT_NS::BriefTestProgressListener progress; + + // brief + elapsed time + TimingListener progress; + controller.addListener( &progress ); + + CPPUNIT_NS::TestRunner runner; + runner.addTest( CPPUNIT_NS::TestFactoryRegistry::getRegistry().makeTest() ); + + try { + CPPUNIT_NS::stdCOut() << endl << "Running " << endl; + + zoo_set_debug_level(ZOO_LOG_LEVEL_INFO); + //zoo_set_debug_level(ZOO_LOG_LEVEL_DEBUG); + + runner.run( controller, globalTestConfig.getTestName()); + + // Print test in a compiler compatible format. + CPPUNIT_NS::EclipseOutputter outputter( &result,cout); + outputter.write(); + + // Uncomment this for XML output +#ifdef ENABLE_XML_OUTPUT + std::ofstream file( "tests.xml" ); + CPPUNIT_NS::XmlOutputter xml( &result, file ); + xml.setStyleSheet( "report.xsl" ); + xml.write(); + file.close(); +#endif + } catch ( std::invalid_argument &e ) { + // Test path not resolved + cout<<"\nERROR: "< +#include "CppAssertHelper.h" + +#include +#include +#include +#include + +#include "CollectionUtil.h" +#include "ThreadingUtil.h" + +using namespace Util; + +#include "Vector.h" +using namespace std; + +#include +#include + +#include +#include +#include +#include "Util.h" + +#ifdef THREADED + static void yield(zhandle_t *zh, int i) + { + sleep(i); + } +#else + static void yield(zhandle_t *zh, int seconds) + { + int fd; + int interest; + int events; + struct timeval tv; + int rc; + time_t expires = time(0) + seconds; + time_t timeLeft = seconds; + fd_set rfds, wfds, efds; + FD_ZERO(&rfds); + FD_ZERO(&wfds); + FD_ZERO(&efds); + + while(timeLeft >= 0) { + zookeeper_interest(zh, &fd, &interest, &tv); + if (fd != -1) { + if (interest&ZOOKEEPER_READ) { + FD_SET(fd, &rfds); + } else { + FD_CLR(fd, &rfds); + } + if (interest&ZOOKEEPER_WRITE) { + FD_SET(fd, &wfds); + } else { + FD_CLR(fd, &wfds); + } + } else { + fd = 0; + } + FD_SET(0, &rfds); + if (tv.tv_sec > timeLeft) { + tv.tv_sec = timeLeft; + } + rc = select(fd+1, &rfds, &wfds, &efds, &tv); + timeLeft = expires - time(0); + events = 0; + if (FD_ISSET(fd, &rfds)) { + events |= ZOOKEEPER_READ; + } + if (FD_ISSET(fd, &wfds)) { + events |= ZOOKEEPER_WRITE; + } + zookeeper_process(zh, events); + } + } +#endif + +typedef struct evt { + string path; + int type; +} evt_t; + +typedef struct watchCtx { +private: + list events; + watchCtx(const watchCtx&); + watchCtx& operator=(const watchCtx&); +public: + bool connected; + zhandle_t *zh; + Mutex mutex; + + watchCtx() { + connected = false; + zh = 0; + } + ~watchCtx() { + if (zh) { + zookeeper_close(zh); + zh = 0; + } + } + + evt_t getEvent() { + evt_t evt; + mutex.acquire(); + CPPUNIT_ASSERT( events.size() > 0); + evt = events.front(); + events.pop_front(); + mutex.release(); + return evt; + } + + int countEvents() { + int count; + mutex.acquire(); + count = events.size(); + mutex.release(); + return count; + } + + void putEvent(evt_t evt) { + mutex.acquire(); + events.push_back(evt); + mutex.release(); + } + + bool waitForConnected(zhandle_t *zh) { + time_t expires = time(0) + 10; + while(!connected && time(0) < expires) { + yield(zh, 1); + } + return connected; + } + bool waitForDisconnected(zhandle_t *zh) { + time_t expires = time(0) + 15; + while(connected && time(0) < expires) { + yield(zh, 1); + } + return !connected; + } +} watchctx_t; + +class Zookeeper_multi : public CPPUNIT_NS::TestFixture +{ + CPPUNIT_TEST_SUITE(Zookeeper_multi); +//FIXME: None of these tests pass in single-threaded mode. It seems to be a +//flaw in the test suite setup. +#ifdef THREADED + CPPUNIT_TEST(testCreate); + CPPUNIT_TEST(testCreateDelete); + CPPUNIT_TEST(testInvalidVersion); + CPPUNIT_TEST(testNestedCreate); + CPPUNIT_TEST(testSetData); + CPPUNIT_TEST(testUpdateConflict); + CPPUNIT_TEST(testDeleteUpdateConflict); + CPPUNIT_TEST(testAsyncMulti); + CPPUNIT_TEST(testMultiFail); + CPPUNIT_TEST(testCheck); + CPPUNIT_TEST(testWatch); + CPPUNIT_TEST(testSequentialNodeCreateInAsyncMulti); +#endif + CPPUNIT_TEST_SUITE_END(); + + static void watcher(zhandle_t *, int type, int state, const char *path,void*v){ + watchctx_t *ctx = (watchctx_t*)v; + + if (state == ZOO_CONNECTED_STATE) { + ctx->connected = true; + } else { + ctx->connected = false; + } + if (type != ZOO_SESSION_EVENT) { + evt_t evt; + evt.path = path; + evt.type = type; + ctx->putEvent(evt); + } + } + + static const char hostPorts[]; + + const char *getHostPorts() { + return hostPorts; + } + + zhandle_t *createClient(watchctx_t *ctx) { + return createClient(hostPorts, ctx); + } + + zhandle_t *createClient(const char *hp, watchctx_t *ctx) { + zhandle_t *zk = zookeeper_init(hp, watcher, 10000, 0, ctx, 0); + ctx->zh = zk; + CPPUNIT_ASSERT_EQUAL(true, ctx->waitForConnected(zk)); + return zk; + } + + FILE *logfile; +public: + + Zookeeper_multi() { + logfile = openlogfile("Zookeeper_multi"); + } + + ~Zookeeper_multi() { + if (logfile) { + fflush(logfile); + fclose(logfile); + logfile = 0; + } + } + + void setUp() + { + zoo_set_log_stream(logfile); + } + + void tearDown() + { + } + + static volatile int count; + + static void multi_completion_fn(int rc, const void *data) { + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + count++; + } + + static void multi_completion_fn_no_assert(int rc, const void *data) { + count++; + } + + static void waitForMultiCompletion(int seconds) { + time_t expires = time(0) + seconds; + while(count == 0 && time(0) < expires) { + sleep(1); + } + count--; + } + + static void resetCounter() { + count = 0; + } + + /** + * Test basic multi-op create functionality + */ + void testCreate() { + int rc; + watchctx_t ctx; + zhandle_t *zk = createClient(&ctx); + + int sz = 512; + char p1[sz]; + char p2[sz]; + char p3[sz]; + p1[0] = p2[0] = p3[0] = '\0'; + + int nops = 3 ; + zoo_op_t ops[nops]; + zoo_op_result_t results[nops]; + + zoo_create_op_init(&ops[0], "/multi1", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, p1, sz); + zoo_create_op_init(&ops[1], "/multi1/a", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, p2, sz); + zoo_create_op_init(&ops[2], "/multi1/b", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, p3, sz); + + rc = zoo_multi(zk, nops, ops, results); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + + CPPUNIT_ASSERT(strcmp(p1, "/multi1") == 0); + CPPUNIT_ASSERT(strcmp(p2, "/multi1/a") == 0); + CPPUNIT_ASSERT(strcmp(p3, "/multi1/b") == 0); + + CPPUNIT_ASSERT_EQUAL((int)ZOK, results[0].err); + CPPUNIT_ASSERT_EQUAL((int)ZOK, results[1].err); + CPPUNIT_ASSERT_EQUAL((int)ZOK, results[2].err); + } + + /** + * Test create followed by delete + */ + void testCreateDelete() { + int rc; + watchctx_t ctx; + zhandle_t *zk = createClient(&ctx); + int sz = 512; + char p1[sz]; + p1[0] = '\0'; + int nops = 2 ; + zoo_op_t ops[nops]; + zoo_op_result_t results[nops]; + + zoo_create_op_init(&ops[0], "/multi2", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, p1, sz); + zoo_delete_op_init(&ops[1], "/multi2", 0); + + rc = zoo_multi(zk, nops, ops, results); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + + // '/multi2' should have been deleted + rc = zoo_exists(zk, "/multi2", 0, NULL); + CPPUNIT_ASSERT_EQUAL((int)ZNONODE, rc); + } + + /** + * Test invalid versions + */ + void testInvalidVersion() { + int rc; + watchctx_t ctx; + zhandle_t *zk = createClient(&ctx); + int nops = 4; + zoo_op_t ops[nops]; + zoo_op_result_t results[nops]; + + zoo_create_op_init(&ops[0], "/multi3", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, NULL, 0); + zoo_delete_op_init(&ops[1], "/multi3", 1); + zoo_create_op_init(&ops[2], "/multi3", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, NULL, 0); + zoo_create_op_init(&ops[3], "/multi3/a", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, NULL, 0); + + rc = zoo_multi(zk, nops, ops, results); + CPPUNIT_ASSERT_EQUAL((int)ZBADVERSION, rc); + CPPUNIT_ASSERT_EQUAL((int)ZOK, results[0].err); + CPPUNIT_ASSERT_EQUAL((int)ZBADVERSION, results[1].err); + CPPUNIT_ASSERT_EQUAL((int)ZRUNTIMEINCONSISTENCY, results[2].err); + CPPUNIT_ASSERT_EQUAL((int)ZRUNTIMEINCONSISTENCY, results[3].err); + } + + /** + * Test nested creates that rely on state in earlier op in multi + */ + void testNestedCreate() { + int rc; + watchctx_t ctx; + zhandle_t *zk = createClient(&ctx); + int sz = 512; + char p1[sz]; + p1[0] = '\0'; + int nops = 6; + zoo_op_t ops[nops]; + zoo_op_result_t results[nops]; + + /* Create */ + zoo_create_op_init(&ops[0], "/multi4", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, p1, sz); + zoo_create_op_init(&ops[1], "/multi4/a", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, p1, sz); + zoo_create_op_init(&ops[2], "/multi4/a/1", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, p1, sz); + + /* Delete */ + zoo_delete_op_init(&ops[3], "/multi4/a/1", 0); + zoo_delete_op_init(&ops[4], "/multi4/a", 0); + zoo_delete_op_init(&ops[5], "/multi4", 0); + + rc = zoo_multi(zk, nops, ops, results); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + + // Verify tree deleted + rc = zoo_exists(zk, "/multi4/a/1", 0, NULL); + CPPUNIT_ASSERT_EQUAL((int)ZNONODE, rc); + + rc = zoo_exists(zk, "/multi4/a", 0, NULL); + CPPUNIT_ASSERT_EQUAL((int)ZNONODE, rc); + + rc = zoo_exists(zk, "/multi4", 0, NULL); + CPPUNIT_ASSERT_EQUAL((int)ZNONODE, rc); + } + + /** + * Test setdata functionality + */ + void testSetData() { + int rc; + watchctx_t ctx; + zhandle_t *zk = createClient(&ctx); + int sz = 512; + struct Stat s1; + + char buf[sz]; + int blen = sz ; + + char p1[sz], p2[sz]; + + int nops = 2; + zoo_op_t ops[nops]; + zoo_op_result_t results[nops]; + + zoo_create_op_init(&ops[0], "/multi5", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, p1, sz); + zoo_create_op_init(&ops[1], "/multi5/a", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, p2, sz); + + rc = zoo_multi(zk, nops, ops, results); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + + yield(zk, 5); + + zoo_op_t setdata_ops[nops]; + zoo_op_result_t setdata_results[nops]; + + zoo_set_op_init(&setdata_ops[0], "/multi5", "1", 1, 0, &s1); + zoo_set_op_init(&setdata_ops[1], "/multi5/a", "2", 1, 0, &s1); + + rc = zoo_multi(zk, nops, setdata_ops, setdata_results); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + CPPUNIT_ASSERT_EQUAL((int)ZOK, results[0].err); + CPPUNIT_ASSERT_EQUAL((int)ZOK, results[1].err); + + memset(buf, '\0', blen); + rc = zoo_get(zk, "/multi5", 0, buf, &blen, &s1); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + CPPUNIT_ASSERT_EQUAL(1, blen); + CPPUNIT_ASSERT(strcmp("1", buf) == 0); + + memset(buf, '\0', blen); + rc = zoo_get(zk, "/multi5/a", 0, buf, &blen, &s1); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + CPPUNIT_ASSERT_EQUAL(1, blen); + CPPUNIT_ASSERT(strcmp("2", buf) == 0); + } + + /** + * Test update conflicts + */ + void testUpdateConflict() { + int rc; + watchctx_t ctx; + zhandle_t *zk = createClient(&ctx); + int sz = 512; + char buf[sz]; + int blen = sz; + char p1[sz]; + p1[0] = '\0'; + struct Stat s1; + int nops = 3; + zoo_op_t ops[nops]; + zoo_op_result_t results[nops]; + + zoo_create_op_init(&ops[0], "/multi6", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, p1, sz); + zoo_set_op_init(&ops[1], "/multi6", "X", 1, 0, &s1); + zoo_set_op_init(&ops[2], "/multi6", "Y", 1, 0, &s1); + + rc = zoo_multi(zk, nops, ops, results); + CPPUNIT_ASSERT_EQUAL((int)ZBADVERSION, rc); + + //Updating version solves conflict -- order matters + ops[2].set_op.version = 1; + rc = zoo_multi(zk, nops, ops, results); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + + memset(buf, 0, sz); + rc = zoo_get(zk, "/multi6", 0, buf, &blen, &s1); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + CPPUNIT_ASSERT_EQUAL(blen, 1); + CPPUNIT_ASSERT(strncmp(buf, "Y", 1) == 0); + } + + /** + * Test delete-update conflicts + */ + void testDeleteUpdateConflict() { + int rc; + watchctx_t ctx; + zhandle_t *zk = createClient(&ctx); + int sz = 512; + char buf[sz]; + int blen; + char p1[sz]; + p1[0] = '\0'; + struct Stat stat; + int nops = 3; + zoo_op_t ops[nops]; + zoo_op_result_t results[nops]; + + zoo_create_op_init(&ops[0], "/multi7", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, p1, sz); + zoo_delete_op_init(&ops[1], "/multi7", 0); + zoo_set_op_init(&ops[2], "/multi7", "Y", 1, 0, &stat); + + rc = zoo_multi(zk, nops, ops, results); + CPPUNIT_ASSERT_EQUAL((int)ZNONODE, rc); + + // '/multi' should never have been created as entire op should fail + rc = zoo_exists(zk, "/multi7", 0, NULL); + CPPUNIT_ASSERT_EQUAL((int)ZNONODE, rc); + } + + void testAsyncMulti() { + int rc; + watchctx_t ctx; + zhandle_t *zk = createClient(&ctx); + + int sz = 512; + char p1[sz], p2[sz], p3[sz]; + p1[0] = '\0'; + p2[0] = '\0'; + p3[0] = '\0'; + + int nops = 3; + zoo_op_t ops[nops]; + zoo_op_result_t results[nops]; + + zoo_create_op_init(&ops[0], "/multi8", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, p1, sz); + zoo_create_op_init(&ops[1], "/multi8/a", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, p2, sz); + zoo_create_op_init(&ops[2], "/multi8/b", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, p3, sz); + + rc = zoo_amulti(zk, nops, ops, results, multi_completion_fn, 0); + waitForMultiCompletion(10); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + + CPPUNIT_ASSERT(strcmp(p1, "/multi8") == 0); + CPPUNIT_ASSERT(strcmp(p2, "/multi8/a") == 0); + CPPUNIT_ASSERT(strcmp(p3, "/multi8/b") == 0); + + CPPUNIT_ASSERT_EQUAL((int)ZOK, results[0].err); + CPPUNIT_ASSERT_EQUAL((int)ZOK, results[1].err); + CPPUNIT_ASSERT_EQUAL((int)ZOK, results[2].err); + } + + void testMultiFail() { + int rc; + watchctx_t ctx; + zhandle_t *zk = createClient(&ctx); + + int sz = 512; + char p1[sz], p2[sz], p3[sz]; + + p1[0] = '\0'; + p2[0] = '\0'; + p3[0] = '\0'; + + int nops = 3; + zoo_op_t ops[nops]; + zoo_op_result_t results[nops]; + + zoo_create_op_init(&ops[0], "/multi9", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, p1, sz); + zoo_create_op_init(&ops[1], "/multi9", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, p2, sz); + zoo_create_op_init(&ops[2], "/multi9/b", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, p3, sz); + + rc = zoo_multi(zk, nops, ops, results); + CPPUNIT_ASSERT_EQUAL((int)ZNODEEXISTS, rc); + } + + /** + * Test basic multi-op check functionality + */ + void testCheck() { + int rc; + watchctx_t ctx; + zhandle_t *zk = createClient(&ctx); + int sz = 512; + char p1[sz]; + p1[0] = '\0'; + struct Stat s1; + + rc = zoo_create(zk, "/multi0", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, p1, sz); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + + // Conditionally create /multi0/a' only if '/multi0' at version 0 + int nops = 2; + zoo_op_t ops[nops]; + zoo_op_result_t results[nops]; + + zoo_check_op_init(&ops[0], "/multi0", 0); + zoo_create_op_init(&ops[1], "/multi0/a", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, p1, sz); + + rc = zoo_multi(zk, nops, ops, results); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + + CPPUNIT_ASSERT_EQUAL((int)ZOK, results[0].err); + CPPUNIT_ASSERT_EQUAL((int)ZOK, results[1].err); + + // '/multi0/a' should have been created as it passed version check + rc = zoo_exists(zk, "/multi0/a", 0, NULL); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + + // Only create '/multi0/b' if '/multi0' at version 10 (which it's not) + zoo_op_t ops2[nops]; + zoo_check_op_init(&ops2[0], "/multi0", 10); + zoo_create_op_init(&ops2[1], "/multi0/b", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, p1, sz); + + rc = zoo_multi(zk, nops, ops2, results); + CPPUNIT_ASSERT_EQUAL((int)ZBADVERSION, rc); + + CPPUNIT_ASSERT_EQUAL((int)ZBADVERSION, results[0].err); + CPPUNIT_ASSERT_EQUAL((int)ZRUNTIMEINCONSISTENCY, results[1].err); + + // '/multi0/b' should NOT have been created + rc = zoo_exists(zk, "/multi0/b", 0, NULL); + CPPUNIT_ASSERT_EQUAL((int)ZNONODE, rc); + } + + /** + * Do a multi op inside a watch callback context. + */ + static void doMultiInWatch(zhandle_t *zk, int type, int state, const char *path, void *ctx) { + int rc; + int sz = 512; + char p1[sz]; + p1[0] = '\0'; + struct Stat s1; + + int nops = 1; + zoo_op_t ops[nops]; + zoo_op_result_t results[nops]; + + zoo_set_op_init(&ops[0], "/multiwatch", "1", 1, -1, NULL); + + rc = zoo_multi(zk, nops, ops, results); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + CPPUNIT_ASSERT_EQUAL((int)ZOK, results[0].err); + + memset(p1, '\0', sz); + rc = zoo_get(zk, "/multiwatch", 0, p1, &sz, &s1); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + CPPUNIT_ASSERT_EQUAL(1, sz); + CPPUNIT_ASSERT(strcmp("1", p1) == 0); + count++; + } + + /** + * Test multi-op called from a watch + */ + void testWatch() { + int rc; + watchctx_t ctx; + zhandle_t *zk = createClient(&ctx); + int sz = 512; + char p1[sz]; + p1[0] = '\0'; + + rc = zoo_create(zk, "/multiwatch", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, NULL, 0); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + + // create a watch on node '/multiwatch' + rc = zoo_wget(zk, "/multiwatch", doMultiInWatch, &ctx, p1, &sz, NULL); + + // setdata on node '/multiwatch' this should trip the watch + rc = zoo_set(zk, "/multiwatch", NULL, -1, -1); + CPPUNIT_ASSERT_EQUAL((int) ZOK, rc); + + // wait for multi completion in doMultiInWatch + waitForMultiCompletion(5); + } + + /** + * ZOOKEEPER-1624: PendingChanges of create sequential node request didn't + * get rollbacked correctly when multi-op failed. This caused + * create sequential node request in subsequent multi-op to failed because + * sequential node name generation is incorrect. + * + * The check is to make sure that each request in multi-op failed with + * the correct reason. + */ + void testSequentialNodeCreateInAsyncMulti() { + int rc; + watchctx_t ctx; + zhandle_t *zk = createClient(&ctx); + + int iteration = 4; + int nops = 2; + + zoo_op_result_t results[iteration][nops]; + zoo_op_t ops[nops]; + zoo_create_op_init(&ops[0], "/node-", "", 0, &ZOO_OPEN_ACL_UNSAFE, ZOO_SEQUENCE, NULL, 0); + zoo_create_op_init(&ops[1], "/dup", "", 0, &ZOO_OPEN_ACL_UNSAFE, 0, NULL, 0); + for (int i = 0; i < iteration ; ++i) { + rc = zoo_amulti(zk, nops, ops, results[i], multi_completion_fn_no_assert, 0); + CPPUNIT_ASSERT_EQUAL((int)ZOK, rc); + } + + waitForMultiCompletion(10); + + CPPUNIT_ASSERT_EQUAL((int)ZOK, results[0][0].err); + CPPUNIT_ASSERT_EQUAL((int)ZOK, results[1][0].err); + CPPUNIT_ASSERT_EQUAL((int)ZOK, results[2][0].err); + CPPUNIT_ASSERT_EQUAL((int)ZOK, results[3][0].err); + + CPPUNIT_ASSERT_EQUAL((int)ZOK, results[0][1].err); + CPPUNIT_ASSERT_EQUAL((int)ZNODEEXISTS, results[1][1].err); + CPPUNIT_ASSERT_EQUAL((int)ZNODEEXISTS, results[2][1].err); + CPPUNIT_ASSERT_EQUAL((int)ZNODEEXISTS, results[3][1].err); + + resetCounter(); + } +}; + +volatile int Zookeeper_multi::count; +const char Zookeeper_multi::hostPorts[] = "127.0.0.1:22181"; +CPPUNIT_TEST_SUITE_REGISTRATION(Zookeeper_multi); diff --git a/src/c/tests/TestOperations.cc b/src/c/tests/TestOperations.cc new file mode 100644 index 0000000..27d9270 --- /dev/null +++ b/src/c/tests/TestOperations.cc @@ -0,0 +1,710 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#include +#include "CppAssertHelper.h" + +#include "ZKMocks.h" +#include + +using namespace std; + +class Zookeeper_operations : public CPPUNIT_NS::TestFixture +{ + CPPUNIT_TEST_SUITE(Zookeeper_operations); +#ifndef THREADED + CPPUNIT_TEST(testPing); + CPPUNIT_TEST(testUnsolicitedPing); + CPPUNIT_TEST(testTimeoutCausedByWatches1); + CPPUNIT_TEST(testTimeoutCausedByWatches2); +#else + CPPUNIT_TEST(testAsyncWatcher1); + CPPUNIT_TEST(testAsyncGetOperation); +#endif + CPPUNIT_TEST(testOperationsAndDisconnectConcurrently1); + CPPUNIT_TEST(testOperationsAndDisconnectConcurrently2); + CPPUNIT_TEST(testConcurrentOperations1); + CPPUNIT_TEST_SUITE_END(); + zhandle_t *zh; + FILE *logfile; + + static void watcher(zhandle_t *, int, int, const char *,void*){} +public: + Zookeeper_operations() { + logfile = openlogfile("Zookeeper_operations"); + } + + ~Zookeeper_operations() { + if (logfile) { + fflush(logfile); + fclose(logfile); + logfile = 0; + } + } + + void setUp() + { + zoo_set_log_stream(logfile); + + zoo_deterministic_conn_order(0); + zh=0; + } + + void tearDown() + { + zookeeper_close(zh); + } + + class AsyncGetOperationCompletion: public AsyncCompletion{ + public: + AsyncGetOperationCompletion():called_(false),rc_(ZAPIERROR){} + virtual void dataCompl(int rc, const char *value, int len, const Stat *stat){ + synchronized(mx_); + called_=true; + rc_=rc; + value_.erase(); + if(rc!=ZOK) return; + value_.assign(value,len); + if(stat) + stat_=*stat; + } + bool operator()()const{ + synchronized(mx_); + return called_; + } + mutable Mutex mx_; + bool called_; + int rc_; + string value_; + NodeStat stat_; + }; +#ifndef THREADED + // send two get data requests; verify that the corresponding completions called + void testConcurrentOperations1() + { + Mock_gettimeofday timeMock; + ZookeeperServer zkServer; + // must call zookeeper_close() while all the mocks are in scope + CloseFinally guard(&zh); + + zh=zookeeper_init("localhost:2121",watcher,10000,TEST_CLIENT_ID,0,0); + CPPUNIT_ASSERT(zh!=0); + // simulate connected state + forceConnected(zh); + + int fd=0; + int interest=0; + timeval tv; + // first operation + AsyncGetOperationCompletion res1; + zkServer.addOperationResponse(new ZooGetResponse("1",1)); + int rc=zoo_aget(zh,"/x/y/1",0,asyncCompletion,&res1); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + // second operation + AsyncGetOperationCompletion res2; + zkServer.addOperationResponse(new ZooGetResponse("2",1)); + rc=zoo_aget(zh,"/x/y/2",0,asyncCompletion,&res2); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + // process the send queue + rc=zookeeper_interest(zh,&fd,&interest,&tv); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + while((rc=zookeeper_process(zh,interest))==ZOK) { + millisleep(100); + //printf("%d\n", rc); + } + //printf("RC = %d", rc); + CPPUNIT_ASSERT_EQUAL((int)ZNOTHING,rc); + + CPPUNIT_ASSERT_EQUAL((int)ZOK,res1.rc_); + CPPUNIT_ASSERT_EQUAL(string("1"),res1.value_); + CPPUNIT_ASSERT_EQUAL((int)ZOK,res2.rc_); + CPPUNIT_ASSERT_EQUAL(string("2"),res2.value_); + } + // send two getData requests and disconnect while the second request is + // outstanding; + // verify the completions are called + void testOperationsAndDisconnectConcurrently1() + { + Mock_gettimeofday timeMock; + ZookeeperServer zkServer; + // must call zookeeper_close() while all the mocks are in scope + CloseFinally guard(&zh); + + zh=zookeeper_init("localhost:2121",watcher,10000,TEST_CLIENT_ID,0,0); + CPPUNIT_ASSERT(zh!=0); + // simulate connected state + forceConnected(zh); + + int fd=0; + int interest=0; + timeval tv; + // first operation + AsyncGetOperationCompletion res1; + zkServer.addOperationResponse(new ZooGetResponse("1",1)); + int rc=zoo_aget(zh,"/x/y/1",0,asyncCompletion,&res1); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + // second operation + AsyncGetOperationCompletion res2; + zkServer.addOperationResponse(new ZooGetResponse("2",1)); + rc=zoo_aget(zh,"/x/y/2",0,asyncCompletion,&res2); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + // process the send queue + rc=zookeeper_interest(zh,&fd,&interest,&tv); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + rc=zookeeper_process(zh,interest); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + // simulate a disconnect + zkServer.setConnectionLost(); + rc=zookeeper_interest(zh,&fd,&interest,&tv); + rc=zookeeper_process(zh,interest); + CPPUNIT_ASSERT_EQUAL((int)ZCONNECTIONLOSS,rc); + CPPUNIT_ASSERT_EQUAL((int)ZOK,res1.rc_); + CPPUNIT_ASSERT_EQUAL(string("1"),res1.value_); + CPPUNIT_ASSERT_EQUAL((int)ZCONNECTIONLOSS,res2.rc_); + CPPUNIT_ASSERT_EQUAL(string(""),res2.value_); + } + // send two getData requests and simulate timeout while the both request + // are pending; + // verify the completions are called + void testOperationsAndDisconnectConcurrently2() + { + Mock_gettimeofday timeMock; + ZookeeperServer zkServer; + // must call zookeeper_close() while all the mocks are in scope + CloseFinally guard(&zh); + + zh=zookeeper_init("localhost:2121",watcher,10000,TEST_CLIENT_ID,0,0); + CPPUNIT_ASSERT(zh!=0); + // simulate connected state + forceConnected(zh); + + int fd=0; + int interest=0; + timeval tv; + // first operation + AsyncGetOperationCompletion res1; + zkServer.addOperationResponse(new ZooGetResponse("1",1)); + int rc=zoo_aget(zh,"/x/y/1",0,asyncCompletion,&res1); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + // second operation + AsyncGetOperationCompletion res2; + zkServer.addOperationResponse(new ZooGetResponse("2",1)); + rc=zoo_aget(zh,"/x/y/2",0,asyncCompletion,&res2); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + // simulate timeout + timeMock.tick(+10); // advance system time by 10 secs + // the next call to zookeeper_interest should return ZOPERATIONTIMEOUT + rc=zookeeper_interest(zh,&fd,&interest,&tv); + CPPUNIT_ASSERT_EQUAL((int)ZOPERATIONTIMEOUT,rc); + // make sure the completions have been called + CPPUNIT_ASSERT_EQUAL((int)ZOPERATIONTIMEOUT,res1.rc_); + CPPUNIT_ASSERT_EQUAL((int)ZOPERATIONTIMEOUT,res2.rc_); + } + + class PingCountingServer: public ZookeeperServer{ + public: + PingCountingServer():pingCount_(0){} + // called when a client request is received + virtual void onMessageReceived(const RequestHeader& rh, iarchive* ia){ + if(rh.type==ZOO_PING_OP){ + pingCount_++; + } + } + int pingCount_; + }; + + // establish a connection; idle for a while + // verify ping was sent at least once + void testPing() + { + const int TIMEOUT=9; // timeout in secs + Mock_gettimeofday timeMock; + PingCountingServer zkServer; + // must call zookeeper_close() while all the mocks are in scope + CloseFinally guard(&zh); + + // receive timeout is in milliseconds + zh=zookeeper_init("localhost:1234",watcher,TIMEOUT*1000,TEST_CLIENT_ID,0,0); + CPPUNIT_ASSERT(zh!=0); + // simulate connected state + forceConnected(zh); + + int fd=0; + int interest=0; + timeval tv; + // Round 1. + int rc=zookeeper_interest(zh,&fd,&interest,&tv); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + // simulate waiting for the select() call to timeout; + // advance the system clock accordingly + timeMock.tick(tv); + rc=zookeeper_process(zh,interest); + CPPUNIT_ASSERT_EQUAL((int)ZNOTHING,rc); + // verify no ping sent + CPPUNIT_ASSERT(zkServer.pingCount_==0); + + // Round 2. + // the client should have the idle threshold exceeded, by now + rc=zookeeper_interest(zh,&fd,&interest,&tv); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + // assume the socket is writable, so no idling here; move on to + // zookeeper_process immediately + rc=zookeeper_process(zh,interest); + // ZNOTHING means the client hasn't received a ping response yet + CPPUNIT_ASSERT_EQUAL((int)ZNOTHING,rc); + // verify a ping is sent + CPPUNIT_ASSERT_EQUAL(1,zkServer.pingCount_); + + // Round 3. + // we're going to receive a server PING response and make sure + // that the client has updated its last_recv timestamp + zkServer.addRecvResponse(new PingResponse); + rc=zookeeper_interest(zh,&fd,&interest,&tv); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + // pseudo-sleep for a short while (10 ms) + timeMock.millitick(10); + rc=zookeeper_process(zh,interest); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + // only one ping so far? + CPPUNIT_ASSERT_EQUAL(1,zkServer.pingCount_); + CPPUNIT_ASSERT(timeMock==zh->last_recv); + + // Round 4 + // make sure that a ping is not sent if something is outstanding + AsyncGetOperationCompletion res1; + rc=zoo_aget(zh,"/x/y/1",0,asyncCompletion,&res1); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + rc=zookeeper_interest(zh,&fd,&interest,&tv); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + timeMock.tick(tv); + rc=zookeeper_interest(zh,&fd,&interest,&tv); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + rc=zookeeper_process(zh,interest); + CPPUNIT_ASSERT_EQUAL((int)ZNOTHING,rc); + rc=zookeeper_interest(zh,&fd,&interest,&tv); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + // pseudo-sleep for a short while (10 ms) + timeMock.millitick(10); + rc=zookeeper_process(zh,interest); + CPPUNIT_ASSERT_EQUAL((int)ZNOTHING,rc); + // only one ping so far? + CPPUNIT_ASSERT_EQUAL(1,zkServer.pingCount_); + } + + // ZOOKEEPER-2253: Permit unsolicited pings + void testUnsolicitedPing() + { + const int TIMEOUT=9; // timeout in secs + Mock_gettimeofday timeMock; + PingCountingServer zkServer; + // must call zookeeper_close() while all the mocks are in scope + CloseFinally guard(&zh); + + // receive timeout is in milliseconds + zh=zookeeper_init("localhost:1234",watcher,TIMEOUT*1000,TEST_CLIENT_ID,0,0); + CPPUNIT_ASSERT(zh!=0); + // simulate connected state + forceConnected(zh); + + int fd=0; + int interest=0; + timeval tv; + + int rc=zookeeper_interest(zh,&fd,&interest,&tv); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + + // verify no ping sent + CPPUNIT_ASSERT(zkServer.pingCount_==0); + + // we're going to receive a unsolicited PING response; ensure + // that the client has updated its last_recv timestamp + timeMock.tick(tv); + zkServer.addRecvResponse(new PingResponse); + rc=zookeeper_process(zh,interest); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + CPPUNIT_ASSERT(timeMock==zh->last_recv); + } + + // simulate a watch arriving right before a ping is due + // assert the ping is sent nevertheless + void testTimeoutCausedByWatches1() + { + const int TIMEOUT=9; // timeout in secs + Mock_gettimeofday timeMock; + PingCountingServer zkServer; + // must call zookeeper_close() while all the mocks are in scope + CloseFinally guard(&zh); + + // receive timeout is in milliseconds + zh=zookeeper_init("localhost:1234",watcher,TIMEOUT*1000,TEST_CLIENT_ID,0,0); + CPPUNIT_ASSERT(zh!=0); + // simulate connected state + forceConnected(zh); + + int fd=0; + int interest=0; + timeval tv; + // Round 1. + int rc=zookeeper_interest(zh,&fd,&interest,&tv); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + // simulate waiting for the select() call to timeout; + // advance the system clock accordingly + timeMock.tick(tv); + timeMock.tick(-1); // set the clock to a millisecond before a ping is due + // trigger a watch now + zkServer.addRecvResponse(new ZNodeEvent(ZOO_CHANGED_EVENT,"/x/y/z")); + rc=zookeeper_process(zh,interest); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + // arrival of a watch sets the last_recv to the current time + CPPUNIT_ASSERT(timeMock==zh->last_recv); + // spend 1 millisecond by processing the watch + timeMock.tick(1); + + // Round 2. + // a ping is due; zookeeper_interest() must send it now + rc=zookeeper_interest(zh,&fd,&interest,&tv); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + // no delay here -- as if the socket is immediately writable + rc=zookeeper_process(zh,interest); + CPPUNIT_ASSERT_EQUAL((int)ZNOTHING,rc); + // verify a ping is sent + CPPUNIT_ASSERT_EQUAL(1,zkServer.pingCount_); + } + + // similar to testTimeoutCausedByWatches1, but this time the watch is + // triggered while the client has an outstanding request + // assert the ping is sent on time + void testTimeoutCausedByWatches2() + { + const int TIMEOUT=9; // timeout in secs + Mock_gettimeofday now; + PingCountingServer zkServer; + // must call zookeeper_close() while all the mocks are in scope + CloseFinally guard(&zh); + + // receive timeout is in milliseconds + zh=zookeeper_init("localhost:1234",watcher,TIMEOUT*1000,TEST_CLIENT_ID,0,0); + CPPUNIT_ASSERT(zh!=0); + // simulate connected state + forceConnected(zh); + + // queue up a request; keep it pending (as if the server is busy or has died) + AsyncGetOperationCompletion res1; + zkServer.addOperationResponse(new ZooGetResponse("2",1)); + int rc=zoo_aget(zh,"/x/y/1",0,asyncCompletion,&res1); + + int fd=0; + int interest=0; + timeval tv; + // Round 1. + // send the queued up zoo_aget() request + Mock_gettimeofday beginningOfTimes(now); // remember when we started + rc=zookeeper_interest(zh,&fd,&interest,&tv); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + // no delay -- the socket is writable + rc=zookeeper_process(zh,interest); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + + // Round 2. + // what's next? + rc=zookeeper_interest(zh,&fd,&interest,&tv); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + // no response from the server yet -- waiting in the select() call + now.tick(tv); + // a watch has arrived, thus preventing the connection from timing out + zkServer.addRecvResponse(new ZNodeEvent(ZOO_CHANGED_EVENT,"/x/y/z")); + rc=zookeeper_process(zh,interest); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); // read the watch message + CPPUNIT_ASSERT_EQUAL(0,zkServer.pingCount_); // not yet! + + //Round 3. + // now is the time to send a ping; make sure it's actually sent + rc=zookeeper_interest(zh,&fd,&interest,&tv); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + rc=zookeeper_process(zh,interest); + CPPUNIT_ASSERT_EQUAL((int)ZNOTHING,rc); + // verify a ping is sent + CPPUNIT_ASSERT_EQUAL(1,zkServer.pingCount_); + // make sure only 1/3 of the timeout has passed + CPPUNIT_ASSERT_EQUAL((int32_t)TIMEOUT/3*1000,toMilliseconds(now-beginningOfTimes)); + } + +#else + class TestGetDataJob: public TestJob{ + public: + TestGetDataJob(ZookeeperServer* svr,zhandle_t* zh, int reps=500) + :svr_(svr),zh_(zh),rc_(ZAPIERROR),reps_(reps){} + virtual void run(){ + int i; + for(i=0;iaddOperationResponse(new ZooGetResponse("1",1)); + rc_=zoo_get(zh_,"/x/y/z",0,&buf,&size,0); + if(rc_!=ZOK){ + break; + } + } + } + ZookeeperServer* svr_; + zhandle_t* zh_; + int rc_; + int reps_; + }; + class TestConcurrentOpJob: public TestGetDataJob{ + public: + static const int REPS=500; + TestConcurrentOpJob(ZookeeperServer* svr,zhandle_t* zh): + TestGetDataJob(svr,zh,REPS){} + virtual TestJob* clone() const { + return new TestConcurrentOpJob(svr_,zh_); + } + virtual void validate(const char* file, int line) const{ + CPPUNIT_ASSERT_EQUAL_MESSAGE_LOC("ZOK != rc",(int)ZOK,rc_,file,line); + } + }; + void testConcurrentOperations1() + { + for(int counter=0; counter<50; counter++){ + // frozen time -- no timeouts and no pings + Mock_gettimeofday timeMock; + + ZookeeperServer zkServer; + Mock_poll pollMock(&zkServer,ZookeeperServer::FD); + // must call zookeeper_close() while all the mocks are in the scope! + CloseFinally guard(&zh); + + zh=zookeeper_init("localhost:2121",watcher,10000,TEST_CLIENT_ID,0,0); + CPPUNIT_ASSERT(zh!=0); + // make sure the client has connected + CPPUNIT_ASSERT(ensureCondition(ClientConnected(zh),1000)<1000); + + TestJobManager jmgr(TestConcurrentOpJob(&zkServer,zh),10); + jmgr.startAllJobs(); + jmgr.wait(); + // validate test results + VALIDATE_JOBS(jmgr); + } + } + class ZKGetJob: public TestJob{ + public: + static const int REPS=1000; + ZKGetJob(zhandle_t* zh) + :zh_(zh),rc_(ZAPIERROR){} + virtual TestJob* clone() const { + return new ZKGetJob(zh_); + } + virtual void run(){ + int i; + for(i=0;i +#include "CppAssertHelper.h" + +#include "ZKMocks.h" +#include "CollectionUtil.h" +#include "Util.h" + +class Zookeeper_watchers : public CPPUNIT_NS::TestFixture +{ + CPPUNIT_TEST_SUITE(Zookeeper_watchers); + CPPUNIT_TEST(testDefaultSessionWatcher1); + CPPUNIT_TEST(testDefaultSessionWatcher2); + CPPUNIT_TEST(testObjectSessionWatcher1); + CPPUNIT_TEST(testObjectSessionWatcher2); + CPPUNIT_TEST(testNodeWatcher1); + CPPUNIT_TEST(testChildWatcher1); + CPPUNIT_TEST(testChildWatcher2); + CPPUNIT_TEST_SUITE_END(); + + static void watcher(zhandle_t *, int, int, const char *,void*){} + zhandle_t *zh; + FILE *logfile; + +public: + + Zookeeper_watchers() { + logfile = openlogfile("Zookeeper_watchers"); + } + + ~Zookeeper_watchers() { + if (logfile) { + fflush(logfile); + fclose(logfile); + logfile = 0; + } + } + + void setUp() + { + zoo_set_log_stream(logfile); + + zoo_deterministic_conn_order(0); + zh=0; + } + + void tearDown() + { + zookeeper_close(zh); + } + + class ConnectionWatcher: public WatcherAction{ + public: + ConnectionWatcher():connected_(false),counter_(0){} + virtual void onConnectionEstablished(zhandle_t*){ + synchronized(mx_); + counter_++; + connected_=true; + } + SyncedBoolCondition isConnectionEstablished() const{ + return SyncedBoolCondition(connected_,mx_); + } + bool connected_; + int counter_; + }; + + class DisconnectWatcher: public WatcherAction{ + public: + DisconnectWatcher():disconnected_(false),counter_(0){} + virtual void onConnectionLost(zhandle_t*){ + synchronized(mx_); + counter_++; + disconnected_=true; + } + SyncedBoolCondition isDisconnected() const{ + return SyncedBoolCondition(disconnected_,mx_); + } + bool disconnected_; + int counter_; + }; + + class CountingDataWatcher: public WatcherAction{ + public: + CountingDataWatcher():disconnected_(false),counter_(0){} + virtual void onNodeValueChanged(zhandle_t*,const char* path){ + synchronized(mx_); + counter_++; + } + virtual void onConnectionLost(zhandle_t*){ + synchronized(mx_); + counter_++; + disconnected_=true; + } + bool disconnected_; + int counter_; + }; + + class DeletionCountingDataWatcher: public WatcherAction{ + public: + DeletionCountingDataWatcher():counter_(0){} + virtual void onNodeDeleted(zhandle_t*,const char* path){ + synchronized(mx_); + counter_++; + } + int counter_; + }; + + class ChildEventCountingWatcher: public WatcherAction{ + public: + ChildEventCountingWatcher():counter_(0){} + virtual void onChildChanged(zhandle_t*,const char* path){ + synchronized(mx_); + counter_++; + } + int counter_; + }; + +#ifndef THREADED + + // verify: the default watcher is called once for a session event + void testDefaultSessionWatcher1(){ + Mock_gettimeofday timeMock; + ZookeeperServer zkServer; + // must call zookeeper_close() while all the mocks are in scope + CloseFinally guard(&zh); + + ConnectionWatcher watcher; + zh=zookeeper_init("localhost:2121",activeWatcher,10000,TEST_CLIENT_ID, + &watcher,0); + CPPUNIT_ASSERT(zh!=0); + + int fd=0; + int interest=0; + timeval tv; + // open the socket + int rc=zookeeper_interest(zh,&fd,&interest,&tv); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + CPPUNIT_ASSERT_EQUAL(ZOO_CONNECTING_STATE,zoo_state(zh)); + // send the handshake packet to the server + rc=zookeeper_process(zh,interest); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + CPPUNIT_ASSERT_EQUAL(ZOO_ASSOCIATING_STATE,zoo_state(zh)); + // receive the server handshake response + rc=zookeeper_process(zh,interest); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + // verify connected + CPPUNIT_ASSERT_EQUAL(ZOO_CONNECTED_STATE,zoo_state(zh)); + CPPUNIT_ASSERT(watcher.connected_); + CPPUNIT_ASSERT_EQUAL(1,watcher.counter_); + } + + // test case: connect to server, set a default watcher, disconnect from the server + // verify: the default watcher is called once + void testDefaultSessionWatcher2(){ + Mock_gettimeofday timeMock; + ZookeeperServer zkServer; + // must call zookeeper_close() while all the mocks are in scope + CloseFinally guard(&zh); + + DisconnectWatcher watcher; + zh=zookeeper_init("localhost:2121",activeWatcher,10000,TEST_CLIENT_ID, + &watcher,0); + CPPUNIT_ASSERT(zh!=0); + // simulate connected state + forceConnected(zh); + + // first operation + AsyncCompletion ignored; + zkServer.addOperationResponse(new ZooGetResponse("1",1)); + int rc=zoo_aget(zh,"/x/y/1",0,asyncCompletion,&ignored); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + // this will process the response and activate the watcher + rc=zookeeper_process(zh,ZOOKEEPER_READ); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + + // now, disconnect + zkServer.setConnectionLost(); + rc=zookeeper_process(zh,ZOOKEEPER_READ); + CPPUNIT_ASSERT_EQUAL((int)ZCONNECTIONLOSS,rc); + // verify disconnected + CPPUNIT_ASSERT(watcher.disconnected_); + CPPUNIT_ASSERT_EQUAL(1,watcher.counter_); + } + + // testcase: connect to the server, set a watcher object on a node, + // disconnect from the server + // verify: the watcher object as well as the default watcher are called + void testObjectSessionWatcher1(){ + Mock_gettimeofday timeMock; + ZookeeperServer zkServer; + // must call zookeeper_close() while all the mocks are in scope + CloseFinally guard(&zh); + + DisconnectWatcher defWatcher; + zh=zookeeper_init("localhost:2121",activeWatcher,10000,TEST_CLIENT_ID, + &defWatcher,0); + CPPUNIT_ASSERT(zh!=0); + // simulate connected state + forceConnected(zh); + + AsyncCompletion ignored; + CountingDataWatcher wobject; + zkServer.addOperationResponse(new ZooStatResponse); + int rc=zoo_awexists(zh,"/x/y/1",activeWatcher,&wobject, + asyncCompletion,&ignored); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + // this will process the response and activate the watcher + rc=zookeeper_process(zh,ZOOKEEPER_READ); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + + // now, disconnect + zkServer.setConnectionLost(); + rc=zookeeper_process(zh,ZOOKEEPER_READ); + CPPUNIT_ASSERT_EQUAL((int)ZCONNECTIONLOSS,rc); + + // verify the default watcher has been triggered + CPPUNIT_ASSERT(defWatcher.disconnected_); + // and triggered only once + CPPUNIT_ASSERT_EQUAL(1,defWatcher.counter_); + + // the path-specific watcher has been triggered as well + CPPUNIT_ASSERT(wobject.disconnected_); + // only once! + CPPUNIT_ASSERT_EQUAL(1,wobject.counter_); + } + + // testcase: connect to the server, set a watcher object on a node, + // set a def watcher on another node,disconnect from the server + // verify: the watcher object as well as the default watcher are called + void testObjectSessionWatcher2(){ + Mock_gettimeofday timeMock; + ZookeeperServer zkServer; + // must call zookeeper_close() while all the mocks are in scope + CloseFinally guard(&zh); + + DisconnectWatcher defWatcher; + zh=zookeeper_init("localhost:2121",activeWatcher,10000,TEST_CLIENT_ID, + &defWatcher,0); + CPPUNIT_ASSERT(zh!=0); + // simulate connected state + forceConnected(zh); + + // set the default watcher + AsyncCompletion ignored; + zkServer.addOperationResponse(new ZooStatResponse); + int rc=zoo_aexists(zh,"/a/b/c",1,asyncCompletion,&ignored); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + + CountingDataWatcher wobject; + zkServer.addOperationResponse(new ZooStatResponse); + rc=zoo_awexists(zh,"/x/y/z",activeWatcher,&wobject, + asyncCompletion,&ignored); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + + // this will process the response and activate the watcher + while((rc=zookeeper_process(zh,ZOOKEEPER_READ))==ZOK) { + millisleep(100); + } + CPPUNIT_ASSERT_EQUAL((int)ZNOTHING,rc); + + // disconnect now + zkServer.setConnectionLost(); + rc=zookeeper_process(zh,ZOOKEEPER_READ); + CPPUNIT_ASSERT_EQUAL((int)ZCONNECTIONLOSS,rc); + + // verify the default watcher has been triggered + CPPUNIT_ASSERT(defWatcher.disconnected_); + // and triggered only once + CPPUNIT_ASSERT_EQUAL(1,defWatcher.counter_); + + // the path-specific watcher has been triggered as well + CPPUNIT_ASSERT(wobject.disconnected_); + // only once! + CPPUNIT_ASSERT_EQUAL(1,wobject.counter_); + } + + // testcase: register 2 node watches for different paths, trigger the watches + // verify: the data watchers are processed, the default watcher is not called + void testNodeWatcher1(){ + Mock_gettimeofday timeMock; + ZookeeperServer zkServer; + // must call zookeeper_close() while all the mocks are in scope + CloseFinally guard(&zh); + + DisconnectWatcher defWatcher; + zh=zookeeper_init("localhost:2121",activeWatcher,10000,TEST_CLIENT_ID, + &defWatcher,0); + CPPUNIT_ASSERT(zh!=0); + // simulate connected state + forceConnected(zh); + + AsyncCompletion ignored; + CountingDataWatcher wobject1; + zkServer.addOperationResponse(new ZooStatResponse); + int rc=zoo_awexists(zh,"/a/b/c",activeWatcher,&wobject1, + asyncCompletion,&ignored); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + + CountingDataWatcher wobject2; + zkServer.addOperationResponse(new ZooStatResponse); + rc=zoo_awexists(zh,"/x/y/z",activeWatcher,&wobject2, + asyncCompletion,&ignored); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + + // this will process the response and activate the watcher + while((rc=zookeeper_process(zh,ZOOKEEPER_READ))==ZOK) { + millisleep(100); + } + CPPUNIT_ASSERT_EQUAL((int)ZNOTHING,rc); + + // we are all set now; let's trigger the watches + zkServer.addRecvResponse(new ZNodeEvent(ZOO_CHANGED_EVENT,"/a/b/c")); + zkServer.addRecvResponse(new ZNodeEvent(ZOO_CHANGED_EVENT,"/x/y/z")); + // make sure all watchers have been processed + while((rc=zookeeper_process(zh,ZOOKEEPER_READ))==ZOK) { + millisleep(100); + } + CPPUNIT_ASSERT_EQUAL((int)ZNOTHING,rc); + + CPPUNIT_ASSERT_EQUAL(1,wobject1.counter_); + CPPUNIT_ASSERT_EQUAL(1,wobject2.counter_); + CPPUNIT_ASSERT_EQUAL(0,defWatcher.counter_); + } + + // testcase: set up both a children and a data watchers on the node /a, then + // delete the node by sending a DELETE_EVENT event + // verify: both watchers are triggered + void testChildWatcher1(){ + Mock_gettimeofday timeMock; + ZookeeperServer zkServer; + // must call zookeeper_close() while all the mocks are in scope + CloseFinally guard(&zh); + + DeletionCountingDataWatcher defWatcher; + zh=zookeeper_init("localhost:2121",activeWatcher,10000,TEST_CLIENT_ID, + &defWatcher,0); + CPPUNIT_ASSERT(zh!=0); + // simulate connected state + forceConnected(zh); + + AsyncCompletion ignored; + DeletionCountingDataWatcher wobject1; + zkServer.addOperationResponse(new ZooStatResponse); + int rc=zoo_awexists(zh,"/a",activeWatcher,&wobject1, + asyncCompletion,&ignored); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + + typedef ZooGetChildrenResponse::StringVector ZooVector; + zkServer.addOperationResponse(new ZooGetChildrenResponse( + Util::CollectionBuilder()("/a/1")("/a/2") + )); + DeletionCountingDataWatcher wobject2; + rc=zoo_awget_children(zh,"/a",activeWatcher, + &wobject2,asyncCompletion,&ignored); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + + // this will process the response and activate the watcher + while((rc=zookeeper_process(zh,ZOOKEEPER_READ))==ZOK) { + millisleep(100); + } + CPPUNIT_ASSERT_EQUAL((int)ZNOTHING,rc); + + // we are all set now; let's trigger the watches + zkServer.addRecvResponse(new ZNodeEvent(ZOO_DELETED_EVENT,"/a")); + // make sure the watchers have been processed + while((rc=zookeeper_process(zh,ZOOKEEPER_READ))==ZOK) { + millisleep(100); + } + CPPUNIT_ASSERT_EQUAL((int)ZNOTHING,rc); + + CPPUNIT_ASSERT_EQUAL(1,wobject1.counter_); + CPPUNIT_ASSERT_EQUAL(1,wobject2.counter_); + CPPUNIT_ASSERT_EQUAL(0,defWatcher.counter_); + } + + // testcase: create both a child and data watch on the node /a, send a ZOO_CHILD_EVENT + // verify: only the child watch triggered + void testChildWatcher2(){ + Mock_gettimeofday timeMock; + ZookeeperServer zkServer; + // must call zookeeper_close() while all the mocks are in scope + CloseFinally guard(&zh); + + ChildEventCountingWatcher defWatcher; + zh=zookeeper_init("localhost:2121",activeWatcher,10000,TEST_CLIENT_ID, + &defWatcher,0); + CPPUNIT_ASSERT(zh!=0); + // simulate connected state + forceConnected(zh); + + AsyncCompletion ignored; + ChildEventCountingWatcher wobject1; + zkServer.addOperationResponse(new ZooStatResponse); + int rc=zoo_awexists(zh,"/a",activeWatcher,&wobject1, + asyncCompletion,&ignored); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + + typedef ZooGetChildrenResponse::StringVector ZooVector; + zkServer.addOperationResponse(new ZooGetChildrenResponse( + Util::CollectionBuilder()("/a/1")("/a/2") + )); + ChildEventCountingWatcher wobject2; + rc=zoo_awget_children(zh,"/a",activeWatcher, + &wobject2,asyncCompletion,&ignored); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + + // this will process the response and activate the watcher + while((rc=zookeeper_process(zh,ZOOKEEPER_READ))==ZOK) { + millisleep(100); + } + CPPUNIT_ASSERT_EQUAL((int)ZNOTHING,rc); + + // we are all set now; let's trigger the watches + zkServer.addRecvResponse(new ZNodeEvent(ZOO_CHILD_EVENT,"/a")); + // make sure the watchers have been processed + while((rc=zookeeper_process(zh,ZOOKEEPER_READ))==ZOK) { + millisleep(100); + } + CPPUNIT_ASSERT_EQUAL((int)ZNOTHING,rc); + + CPPUNIT_ASSERT_EQUAL(0,wobject1.counter_); + CPPUNIT_ASSERT_EQUAL(1,wobject2.counter_); + CPPUNIT_ASSERT_EQUAL(0,defWatcher.counter_); + } + +#else + // verify: the default watcher is called once for a session event + void testDefaultSessionWatcher1(){ + Mock_gettimeofday timeMock; + // zookeeper simulator + ZookeeperServer zkServer; + // detects when all watchers have been delivered + WatcherDeliveryTracker deliveryTracker(ZOO_SESSION_EVENT,ZOO_CONNECTED_STATE); + Mock_poll pollMock(&zkServer,ZookeeperServer::FD); + // must call zookeeper_close() while all the mocks are in the scope! + CloseFinally guard(&zh); + + ConnectionWatcher watcher; + zh=zookeeper_init("localhost:2121",activeWatcher,10000,TEST_CLIENT_ID, + &watcher,0); + CPPUNIT_ASSERT(zh!=0); + // wait till watcher proccessing has completed (the connection + // established event) + CPPUNIT_ASSERT(ensureCondition( + deliveryTracker.isWatcherProcessingCompleted(),1000)<1000); + + // verify the watcher has been triggered + CPPUNIT_ASSERT(ensureCondition(watcher.isConnectionEstablished(),1000)<1000); + // triggered only once + CPPUNIT_ASSERT_EQUAL(1,watcher.counter_); + } + + // test case: connect to server, set a default watcher, disconnect from the server + // verify: the default watcher is called once + void testDefaultSessionWatcher2(){ + Mock_gettimeofday timeMock; + // zookeeper simulator + ZookeeperServer zkServer; + Mock_poll pollMock(&zkServer,ZookeeperServer::FD); + // must call zookeeper_close() while all the mocks are in the scope! + CloseFinally guard(&zh); + + // detects when all watchers have been delivered + WatcherDeliveryTracker deliveryTracker(ZOO_SESSION_EVENT,ZOO_CONNECTING_STATE); + DisconnectWatcher watcher; + zh=zookeeper_init("localhost:2121",activeWatcher,10000,TEST_CLIENT_ID, + &watcher,0); + CPPUNIT_ASSERT(zh!=0); + // make sure the client has connected + CPPUNIT_ASSERT(ensureCondition(ClientConnected(zh),1000)<1000); + // set a default watch + AsyncCompletion ignored; + // a successful server response will activate the watcher + zkServer.addOperationResponse(new ZooStatResponse); + int rc=zoo_aexists(zh,"/x/y/z",1,asyncCompletion,&ignored); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + + // now, initiate a disconnect + zkServer.setConnectionLost(); + CPPUNIT_ASSERT(ensureCondition( + deliveryTracker.isWatcherProcessingCompleted(),1000)<1000); + + // verify the watcher has been triggered + CPPUNIT_ASSERT(watcher.disconnected_); + // triggered only once + CPPUNIT_ASSERT_EQUAL(1,watcher.counter_); + } + + // testcase: connect to the server, set a watcher object on a node, + // disconnect from the server + // verify: the watcher object as well as the default watcher are called + void testObjectSessionWatcher1(){ + Mock_gettimeofday timeMock; + // zookeeper simulator + ZookeeperServer zkServer; + Mock_poll pollMock(&zkServer,ZookeeperServer::FD); + // must call zookeeper_close() while all the mocks are in the scope! + CloseFinally guard(&zh); + + // detects when all watchers have been delivered + WatcherDeliveryTracker deliveryTracker(ZOO_SESSION_EVENT,ZOO_CONNECTING_STATE); + DisconnectWatcher defWatcher; + // use the tracker to find out when the watcher has been activated + WatcherActivationTracker activationTracker; + zh=zookeeper_init("localhost:2121",activeWatcher,10000,TEST_CLIENT_ID, + &defWatcher,0); + CPPUNIT_ASSERT(zh!=0); + // make sure the client has connected + CPPUNIT_ASSERT(ensureCondition(ClientConnected(zh),1000)<1000); + + AsyncCompletion ignored; + // this successful server response will activate the watcher + zkServer.addOperationResponse(new ZooStatResponse); + CountingDataWatcher wobject; + activationTracker.track(&wobject); + // set a path-specific watcher + int rc=zoo_awexists(zh,"/x/y/z",activeWatcher,&wobject, + asyncCompletion,&ignored); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + // make sure the watcher gets activated before we continue + CPPUNIT_ASSERT(ensureCondition(activationTracker.isWatcherActivated(),1000)<1000); + + // now, initiate a disconnect + zkServer.setConnectionLost(); + // make sure all watchers have been processed + CPPUNIT_ASSERT(ensureCondition( + deliveryTracker.isWatcherProcessingCompleted(),1000)<1000); + + // verify the default watcher has been triggered + CPPUNIT_ASSERT(defWatcher.disconnected_); + // and triggered only once + CPPUNIT_ASSERT_EQUAL(1,defWatcher.counter_); + + // the path-specific watcher has been triggered as well + CPPUNIT_ASSERT(wobject.disconnected_); + // only once! + CPPUNIT_ASSERT_EQUAL(1,wobject.counter_); + } + + // testcase: connect to the server, set a watcher object on a node, + // set a def watcher on another node,disconnect from the server + // verify: the watcher object as well as the default watcher are called + void testObjectSessionWatcher2(){ + Mock_gettimeofday timeMock; + // zookeeper simulator + ZookeeperServer zkServer; + Mock_poll pollMock(&zkServer,ZookeeperServer::FD); + // must call zookeeper_close() while all the mocks are in the scope! + CloseFinally guard(&zh); + + // detects when all watchers have been delivered + WatcherDeliveryTracker deliveryTracker(ZOO_SESSION_EVENT,ZOO_CONNECTING_STATE); + DisconnectWatcher defWatcher; + // use the tracker to find out when the watcher has been activated + WatcherActivationTracker activationTracker; + zh=zookeeper_init("localhost:2121",activeWatcher,10000,TEST_CLIENT_ID, + &defWatcher,0); + CPPUNIT_ASSERT(zh!=0); + // make sure the client has connected + CPPUNIT_ASSERT(ensureCondition(ClientConnected(zh),1000)<1000); + + // set a default watch + AsyncCompletion ignored; + // a successful server response will activate the watcher + zkServer.addOperationResponse(new ZooStatResponse); + activationTracker.track(&defWatcher); + int rc=zoo_aexists(zh,"/a/b/c",1,asyncCompletion,&ignored); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + // make sure the watcher gets activated before we continue + CPPUNIT_ASSERT(ensureCondition(activationTracker.isWatcherActivated(),1000)<1000); + + // this successful server response will activate the watcher + zkServer.addOperationResponse(new ZooStatResponse); + CountingDataWatcher wobject; + activationTracker.track(&wobject); + // set a path-specific watcher + rc=zoo_awexists(zh,"/x/y/z",activeWatcher,&wobject, + asyncCompletion,&ignored); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + // make sure the watcher gets activated before we continue + CPPUNIT_ASSERT(ensureCondition(activationTracker.isWatcherActivated(),1000)<1000); + + // now, initiate a disconnect + zkServer.setConnectionLost(); + // make sure all watchers have been processed + CPPUNIT_ASSERT(ensureCondition( + deliveryTracker.isWatcherProcessingCompleted(),1000)<1000); + + // verify the default watcher has been triggered + CPPUNIT_ASSERT(defWatcher.disconnected_); + // and triggered only once + CPPUNIT_ASSERT_EQUAL(1,defWatcher.counter_); + + // the path-specific watcher has been triggered as well + CPPUNIT_ASSERT(wobject.disconnected_); + // only once! + CPPUNIT_ASSERT_EQUAL(1,wobject.counter_); + } + + // testcase: register 2 node watches for different paths, trigger the watches + // verify: the data watchers are processed, the default watcher is not called + void testNodeWatcher1(){ + Mock_gettimeofday timeMock; + // zookeeper simulator + ZookeeperServer zkServer; + Mock_poll pollMock(&zkServer,ZookeeperServer::FD); + // must call zookeeper_close() while all the mocks are in the scope! + CloseFinally guard(&zh); + + // detects when all watchers have been delivered + WatcherDeliveryTracker deliveryTracker(ZOO_CHANGED_EVENT,0,false); + CountingDataWatcher defWatcher; + // use the tracker to find out when the watcher has been activated + WatcherActivationTracker activationTracker; + zh=zookeeper_init("localhost:2121",activeWatcher,10000,TEST_CLIENT_ID, + &defWatcher,0); + CPPUNIT_ASSERT(zh!=0); + // make sure the client has connected + CPPUNIT_ASSERT(ensureCondition(ClientConnected(zh),1000)<1000); + + // don't care about completions + AsyncCompletion ignored; + // set a one-shot watch + // a successful server response will activate the watcher + zkServer.addOperationResponse(new ZooStatResponse); + CountingDataWatcher wobject1; + activationTracker.track(&wobject1); + int rc=zoo_awexists(zh,"/a/b/c",activeWatcher,&wobject1, + asyncCompletion,&ignored); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + // make sure the watcher gets activated before we continue + CPPUNIT_ASSERT(ensureCondition(activationTracker.isWatcherActivated(),1000)<1000); + + // this successful server response will activate the watcher + zkServer.addOperationResponse(new ZooStatResponse); + CountingDataWatcher wobject2; + activationTracker.track(&wobject2); + // set a path-specific watcher + rc=zoo_awexists(zh,"/x/y/z",activeWatcher,&wobject2, + asyncCompletion,&ignored); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + // make sure the watcher gets activated before we continue + CPPUNIT_ASSERT(ensureCondition(activationTracker.isWatcherActivated(),1000)<1000); + + // we are all set now; let's trigger the watches + zkServer.addRecvResponse(new ZNodeEvent(ZOO_CHANGED_EVENT,"/a/b/c")); + zkServer.addRecvResponse(new ZNodeEvent(ZOO_CHANGED_EVENT,"/x/y/z")); + // make sure all watchers have been processed + CPPUNIT_ASSERT(ensureCondition( + deliveryTracker.deliveryCounterEquals(2),1000)<1000); + + CPPUNIT_ASSERT_EQUAL(1,wobject1.counter_); + CPPUNIT_ASSERT_EQUAL(1,wobject2.counter_); + CPPUNIT_ASSERT_EQUAL(0,defWatcher.counter_); + } + + // testcase: set up both a children and a data watchers on the node /a, then + // delete the node (that is, send a DELETE_EVENT) + // verify: both watchers are triggered + void testChildWatcher1(){ + Mock_gettimeofday timeMock; + // zookeeper simulator + ZookeeperServer zkServer; + Mock_poll pollMock(&zkServer,ZookeeperServer::FD); + // must call zookeeper_close() while all the mocks are in the scope! + CloseFinally guard(&zh); + + // detects when all watchers have been delivered + WatcherDeliveryTracker deliveryTracker(ZOO_DELETED_EVENT,0); + DeletionCountingDataWatcher defWatcher; + zh=zookeeper_init("localhost:2121",activeWatcher,10000,TEST_CLIENT_ID, + &defWatcher,0); + CPPUNIT_ASSERT(zh!=0); + // make sure the client has connected + CPPUNIT_ASSERT(ensureCondition(ClientConnected(zh),1000)<1000); + + // a successful server response will activate the watcher + zkServer.addOperationResponse(new ZooStatResponse); + DeletionCountingDataWatcher wobject1; + Stat stat; + // add a node watch + int rc=zoo_wexists(zh,"/a",activeWatcher,&wobject1,&stat); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + + typedef ZooGetChildrenResponse::StringVector ZooVector; + zkServer.addOperationResponse(new ZooGetChildrenResponse( + Util::CollectionBuilder()("/a/1")("/a/2") + )); + DeletionCountingDataWatcher wobject2; + String_vector children; + rc=zoo_wget_children(zh,"/a",activeWatcher,&wobject2,&children); + deallocate_String_vector(&children); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + + // we are all set now; let's trigger the watches + zkServer.addRecvResponse(new ZNodeEvent(ZOO_DELETED_EVENT,"/a")); + // make sure the watchers have been processed + CPPUNIT_ASSERT(ensureCondition( + deliveryTracker.isWatcherProcessingCompleted(),1000)<1000); + + CPPUNIT_ASSERT_EQUAL(1,wobject1.counter_); + CPPUNIT_ASSERT_EQUAL(1,wobject2.counter_); + CPPUNIT_ASSERT_EQUAL(0,defWatcher.counter_); + } + + // testcase: create both a child and data watch on the node /a, send a ZOO_CHILD_EVENT + // verify: only the child watch triggered + void testChildWatcher2(){ + Mock_gettimeofday timeMock; + // zookeeper simulator + ZookeeperServer zkServer; + Mock_poll pollMock(&zkServer,ZookeeperServer::FD); + // must call zookeeper_close() while all the mocks are in the scope! + CloseFinally guard(&zh); + + // detects when all watchers have been delivered + WatcherDeliveryTracker deliveryTracker(ZOO_CHILD_EVENT,0); + ChildEventCountingWatcher defWatcher; + zh=zookeeper_init("localhost:2121",activeWatcher,10000,TEST_CLIENT_ID, + &defWatcher,0); + CPPUNIT_ASSERT(zh!=0); + // make sure the client has connected + CPPUNIT_ASSERT(ensureCondition(ClientConnected(zh),1000)<1000); + // a successful server response will activate the watcher + zkServer.addOperationResponse(new ZooStatResponse); + ChildEventCountingWatcher wobject1; + Stat stat; + // add a node watch + int rc=zoo_wexists(zh,"/a",activeWatcher,&wobject1,&stat); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + + typedef ZooGetChildrenResponse::StringVector ZooVector; + zkServer.addOperationResponse(new ZooGetChildrenResponse( + Util::CollectionBuilder()("/a/1")("/a/2") + )); + ChildEventCountingWatcher wobject2; + String_vector children; + rc=zoo_wget_children(zh,"/a",activeWatcher,&wobject2,&children); + deallocate_String_vector(&children); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + + // we are all set now; let's trigger the watches + zkServer.addRecvResponse(new ZNodeEvent(ZOO_CHILD_EVENT,"/a")); + // make sure the watchers have been processed + CPPUNIT_ASSERT(ensureCondition( + deliveryTracker.isWatcherProcessingCompleted(),1000)<1000); + + CPPUNIT_ASSERT_EQUAL(0,wobject1.counter_); + CPPUNIT_ASSERT_EQUAL(1,wobject2.counter_); + CPPUNIT_ASSERT_EQUAL(0,defWatcher.counter_); + } + +#endif //THREADED +}; + +CPPUNIT_TEST_SUITE_REGISTRATION(Zookeeper_watchers); diff --git a/src/c/tests/TestZookeeperClose.cc b/src/c/tests/TestZookeeperClose.cc new file mode 100644 index 0000000..edefa66 --- /dev/null +++ b/src/c/tests/TestZookeeperClose.cc @@ -0,0 +1,472 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#include + +#include "ZKMocks.h" + +#ifdef THREADED +#include "PthreadMocks.h" +#endif + +using namespace std; + +class Zookeeper_close : public CPPUNIT_NS::TestFixture +{ + CPPUNIT_TEST_SUITE(Zookeeper_close); +#ifdef THREADED + CPPUNIT_TEST(testIOThreadStoppedOnExpire); +#endif + CPPUNIT_TEST(testCloseUnconnected); + CPPUNIT_TEST(testCloseUnconnected1); + CPPUNIT_TEST(testCloseConnected1); + CPPUNIT_TEST(testCloseFromWatcher1); + CPPUNIT_TEST_SUITE_END(); + zhandle_t *zh; + static void watcher(zhandle_t *, int, int, const char *,void*){} + FILE *logfile; +public: + + Zookeeper_close() { + logfile = openlogfile("Zookeeper_close"); + } + + ~Zookeeper_close() { + if (logfile) { + fflush(logfile); + fclose(logfile); + logfile = 0; + } + } + + void setUp() + { + zoo_set_log_stream(logfile); + + zoo_deterministic_conn_order(0); + zh=0; + } + + void tearDown() + { + zookeeper_close(zh); + } + + class CloseOnSessionExpired: public WatcherAction{ + public: + CloseOnSessionExpired(bool callClose=true): + callClose_(callClose),rc(ZOK){} + virtual void onSessionExpired(zhandle_t* zh){ + memcpy(&lzh,zh,sizeof(lzh)); + if(callClose_) + rc=zookeeper_close(zh); + } + zhandle_t lzh; + bool callClose_; + int rc; + }; + +#ifndef THREADED + void testCloseUnconnected() + { + zh=zookeeper_init("localhost:2121",watcher,10000,0,0,0); + CPPUNIT_ASSERT(zh!=0); + + // do not actually free the memory while in zookeeper_close() + Mock_free_noop freeMock; + // make a copy of zhandle before close() overwrites some of + // it members with NULLs + zhandle_t lzh; + memcpy(&lzh,zh,sizeof(lzh)); + int rc=zookeeper_close(zh); + zhandle_t* savezh=zh; zh=0; + freeMock.disable(); // disable mock's fake free()- use libc's free() instead + + // verify that zookeeper_close has done its job + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + // memory + CPPUNIT_ASSERT_EQUAL(1,freeMock.getFreeCount(savezh)); + CPPUNIT_ASSERT_EQUAL(1,freeMock.getFreeCount(lzh.hostname)); + CPPUNIT_ASSERT_EQUAL(1,freeMock.getFreeCount(lzh.addrs)); + // This cannot be maintained properly CPPUNIT_ASSERT_EQUAL(9,freeMock.callCounter); + } + void testCloseUnconnected1() + { + zh=zookeeper_init("localhost:2121",watcher,10000,0,0,0); + CPPUNIT_ASSERT(zh!=0); + // simulate connected state + zh->fd=ZookeeperServer::FD; + zh->state=ZOO_CONNECTED_STATE; + Mock_flush_send_queue zkMock; + // do not actually free the memory while in zookeeper_close() + Mock_free_noop freeMock; + // make a copy of zhandle before close() overwrites some of + // it members with NULLs + zhandle_t lzh; + memcpy(&lzh,zh,sizeof(lzh)); + int rc=zookeeper_close(zh); + zhandle_t* savezh=zh; zh=0; + freeMock.disable(); // disable mock's fake free()- use libc's free() instead + + // verify that zookeeper_close has done its job + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + // memory + CPPUNIT_ASSERT_EQUAL(1,freeMock.getFreeCount(savezh)); + CPPUNIT_ASSERT_EQUAL(1,freeMock.getFreeCount(lzh.hostname)); + CPPUNIT_ASSERT_EQUAL(1,freeMock.getFreeCount(lzh.addrs)); + // the close request sent? + CPPUNIT_ASSERT_EQUAL(1,zkMock.counter); + } + void testCloseConnected1() + { + ZookeeperServer zkServer; + // poll() will called from zookeeper_close() + Mock_poll pollMock(&zkServer,ZookeeperServer::FD); + + zh=zookeeper_init("localhost:2121",watcher,10000,TEST_CLIENT_ID,0,0); + CPPUNIT_ASSERT(zh!=0); + + Mock_gettimeofday timeMock; + + int fd=0; + int interest=0; + timeval tv; + int rc=zookeeper_interest(zh,&fd,&interest,&tv); + + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + CPPUNIT_ASSERT_EQUAL(ZOO_CONNECTING_STATE,zoo_state(zh)); + CPPUNIT_ASSERT_EQUAL(ZOOKEEPER_READ|ZOOKEEPER_WRITE,interest); + + rc=zookeeper_process(zh,interest); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + CPPUNIT_ASSERT_EQUAL(ZOO_ASSOCIATING_STATE,zoo_state(zh)); + + rc=zookeeper_interest(zh,&fd,&interest,&tv); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + rc=zookeeper_process(zh,interest); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + CPPUNIT_ASSERT_EQUAL(ZOO_CONNECTED_STATE,zoo_state(zh)); + // do not actually free the memory while in zookeeper_close() + Mock_free_noop freeMock; + // make a copy of zhandle before close() overwrites some of + // it members with NULLs + zhandle_t lzh; + memcpy(&lzh,zh,sizeof(lzh)); + zookeeper_close(zh); + zhandle_t* savezh=zh; zh=0; + freeMock.disable(); // disable mock's fake free()- use libc's free() instead + // memory + CPPUNIT_ASSERT_EQUAL(1,freeMock.getFreeCount(savezh)); + CPPUNIT_ASSERT_EQUAL(1,freeMock.getFreeCount(lzh.hostname)); + CPPUNIT_ASSERT_EQUAL(1,freeMock.getFreeCount(lzh.addrs)); + // the close request sent? + CPPUNIT_ASSERT_EQUAL(1,(int)zkServer.closeSent); + } + void testCloseFromWatcher1() + { + Mock_gettimeofday timeMock; + + ZookeeperServer zkServer; + // make the server return a non-matching session id + zkServer.returnSessionExpired(); + // poll() will called from zookeeper_close() + Mock_poll pollMock(&zkServer,ZookeeperServer::FD); + + CloseOnSessionExpired closeAction; + zh=zookeeper_init("localhost:2121",activeWatcher,10000, + TEST_CLIENT_ID,&closeAction,0); + CPPUNIT_ASSERT(zh!=0); + + int fd=0; + int interest=0; + timeval tv; + // initiate connection + int rc=zookeeper_interest(zh,&fd,&interest,&tv); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + CPPUNIT_ASSERT_EQUAL(ZOO_CONNECTING_STATE,zoo_state(zh)); + CPPUNIT_ASSERT_EQUAL(ZOOKEEPER_READ|ZOOKEEPER_WRITE,interest); + rc=zookeeper_process(zh,interest); + // make sure the handshake in progress + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + CPPUNIT_ASSERT_EQUAL(ZOO_ASSOCIATING_STATE,zoo_state(zh)); + rc=zookeeper_interest(zh,&fd,&interest,&tv); + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + + // do not actually free the memory while in zookeeper_close() + Mock_free_noop freeMock; + // should call the watcher with ZOO_EXPIRED_SESSION_STATE state + rc=zookeeper_process(zh,interest); + zhandle_t* savezh=zh; zh=0; + freeMock.disable(); // disable mock's fake free()- use libc's free() instead + + CPPUNIT_ASSERT_EQUAL(ZOO_EXPIRED_SESSION_STATE,zoo_state(savezh)); + // memory + CPPUNIT_ASSERT_EQUAL(1,freeMock.getFreeCount(savezh)); + CPPUNIT_ASSERT_EQUAL(1,freeMock.getFreeCount(closeAction.lzh.hostname)); + CPPUNIT_ASSERT_EQUAL(1,freeMock.getFreeCount(closeAction.lzh.addrs)); + // make sure the close request NOT sent + CPPUNIT_ASSERT_EQUAL(0,(int)zkServer.closeSent); + } +#else + void testCloseUnconnected() + { + // disable threading + MockPthreadZKNull pthreadMock; + zh=zookeeper_init("localhost:2121",watcher,10000,0,0,0); + + CPPUNIT_ASSERT(zh!=0); + adaptor_threads* adaptor=(adaptor_threads*)zh->adaptor_priv; + CPPUNIT_ASSERT(adaptor!=0); + + // do not actually free the memory while in zookeeper_close() + Mock_free_noop freeMock; + // make a copy of zhandle before close() overwrites some of + // it members with NULLs + zhandle_t lzh; + memcpy(&lzh,zh,sizeof(lzh)); + int rc=zookeeper_close(zh); + zhandle_t* savezh=zh; zh=0; + // we're done, disable mock's fake free(), use libc's free() instead + freeMock.disable(); + + // verify that zookeeper_close has done its job + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + // memory + CPPUNIT_ASSERT_EQUAL(1,freeMock.getFreeCount(savezh)); + CPPUNIT_ASSERT_EQUAL(1,freeMock.getFreeCount(lzh.hostname)); + CPPUNIT_ASSERT_EQUAL(1,freeMock.getFreeCount(lzh.addrs)); + CPPUNIT_ASSERT_EQUAL(1,freeMock.getFreeCount(adaptor)); + // Cannot be maintained accurately: CPPUNIT_ASSERT_EQUAL(10,freeMock.callCounter); + // threads + CPPUNIT_ASSERT_EQUAL(1,MockPthreadsNull::getDestroyCounter(adaptor->io)); + CPPUNIT_ASSERT_EQUAL(1,MockPthreadsNull::getDestroyCounter(adaptor->completion)); + // mutexes + CPPUNIT_ASSERT_EQUAL(1,MockPthreadsNull::getDestroyCounter(&savezh->to_process.lock)); + CPPUNIT_ASSERT_EQUAL(0,MockPthreadsNull::getInvalidAccessCounter(&savezh->to_process.lock)); + CPPUNIT_ASSERT_EQUAL(1,MockPthreadsNull::getDestroyCounter(&savezh->to_send.lock)); + CPPUNIT_ASSERT_EQUAL(0,MockPthreadsNull::getInvalidAccessCounter(&savezh->to_send.lock)); + CPPUNIT_ASSERT_EQUAL(1,MockPthreadsNull::getDestroyCounter(&savezh->sent_requests.lock)); + CPPUNIT_ASSERT_EQUAL(0,MockPthreadsNull::getInvalidAccessCounter(&savezh->sent_requests.lock)); + CPPUNIT_ASSERT_EQUAL(1,MockPthreadsNull::getDestroyCounter(&savezh->completions_to_process.lock)); + CPPUNIT_ASSERT_EQUAL(0,MockPthreadsNull::getInvalidAccessCounter(&savezh->completions_to_process.lock)); + // conditionals + CPPUNIT_ASSERT_EQUAL(1,MockPthreadsNull::getDestroyCounter(&savezh->sent_requests.cond)); + CPPUNIT_ASSERT_EQUAL(0,MockPthreadsNull::getInvalidAccessCounter(&savezh->sent_requests.cond)); + CPPUNIT_ASSERT_EQUAL(1,MockPthreadsNull::getDestroyCounter(&savezh->completions_to_process.cond)); + CPPUNIT_ASSERT_EQUAL(0,MockPthreadsNull::getInvalidAccessCounter(&savezh->completions_to_process.cond)); + } + void testCloseUnconnected1() + { + for(int i=0; i<100;i++){ + zh=zookeeper_init("localhost:2121",watcher,10000,0,0,0); + CPPUNIT_ASSERT(zh!=0); + adaptor_threads* adaptor=(adaptor_threads*)zh->adaptor_priv; + CPPUNIT_ASSERT(adaptor!=0); + int rc=zookeeper_close(zh); + zh=0; + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + } + } + void testCloseConnected1() + { + // frozen time -- no timeouts and no pings + Mock_gettimeofday timeMock; + + for(int i=0;i<100;i++){ + ZookeeperServer zkServer; + Mock_poll pollMock(&zkServer,ZookeeperServer::FD); + // use a checked version of pthread calls + CheckedPthread threadMock; + // do not actually free the memory while in zookeeper_close() + Mock_free_noop freeMock; + + zh=zookeeper_init("localhost:2121",watcher,10000,TEST_CLIENT_ID,0,0); + CPPUNIT_ASSERT(zh!=0); + // make sure the client has connected + CPPUNIT_ASSERT(ensureCondition(ClientConnected(zh),1000)<1000); + // make a copy of zhandle before close() overwrites some of + // its members with NULLs + zhandle_t lzh; + memcpy(&lzh,zh,sizeof(lzh)); + int rc=zookeeper_close(zh); + zhandle_t* savezh=zh; zh=0; + // we're done, disable mock's fake free(), use libc's free() instead + freeMock.disable(); + + CPPUNIT_ASSERT_EQUAL((int)ZOK,rc); + adaptor_threads* adaptor=(adaptor_threads*)lzh.adaptor_priv; + // memory + CPPUNIT_ASSERT_EQUAL(1,freeMock.getFreeCount(savezh)); + CPPUNIT_ASSERT_EQUAL(1,freeMock.getFreeCount(lzh.hostname)); + CPPUNIT_ASSERT_EQUAL(1,freeMock.getFreeCount(lzh.addrs)); + CPPUNIT_ASSERT_EQUAL(1,freeMock.getFreeCount(adaptor)); + // threads + CPPUNIT_ASSERT_EQUAL(1,CheckedPthread::getDestroyCounter(adaptor->io)); + CPPUNIT_ASSERT_EQUAL(1,CheckedPthread::getDestroyCounter(adaptor->completion)); + // mutexes + CPPUNIT_ASSERT_EQUAL(1,CheckedPthread::getDestroyCounter(&savezh->to_process.lock)); + CPPUNIT_ASSERT_EQUAL(0,CheckedPthread::getInvalidAccessCounter(&savezh->to_process.lock)); + CPPUNIT_ASSERT_EQUAL(1,CheckedPthread::getDestroyCounter(&savezh->to_send.lock)); + CPPUNIT_ASSERT_EQUAL(0,CheckedPthread::getInvalidAccessCounter(&savezh->to_send.lock)); + CPPUNIT_ASSERT_EQUAL(1,CheckedPthread::getDestroyCounter(&savezh->sent_requests.lock)); + CPPUNIT_ASSERT_EQUAL(0,CheckedPthread::getInvalidAccessCounter(&savezh->sent_requests.lock)); + CPPUNIT_ASSERT_EQUAL(1,CheckedPthread::getDestroyCounter(&savezh->completions_to_process.lock)); + CPPUNIT_ASSERT_EQUAL(0,CheckedPthread::getInvalidAccessCounter(&savezh->completions_to_process.lock)); + // conditionals + CPPUNIT_ASSERT_EQUAL(1,CheckedPthread::getDestroyCounter(&savezh->sent_requests.cond)); + CPPUNIT_ASSERT_EQUAL(0,CheckedPthread::getInvalidAccessCounter(&savezh->sent_requests.cond)); + CPPUNIT_ASSERT_EQUAL(1,CheckedPthread::getDestroyCounter(&savezh->completions_to_process.cond)); + CPPUNIT_ASSERT_EQUAL(0,CheckedPthread::getInvalidAccessCounter(&savezh->completions_to_process.cond)); + } + } + + struct PointerFreed{ + PointerFreed(Mock_free_noop& freeMock,void* ptr): + freeMock_(freeMock),ptr_(ptr){} + bool operator()() const{return freeMock_.isFreed(ptr_); } + Mock_free_noop& freeMock_; + void* ptr_; + }; + // test if zookeeper_close may be called from a watcher callback on + // SESSION_EXPIRED event + void testCloseFromWatcher1() + { + // frozen time -- no timeouts and no pings + Mock_gettimeofday timeMock; + + for(int i=0;i<100;i++){ + ZookeeperServer zkServer; + // make the server return a non-matching session id + zkServer.returnSessionExpired(); + + Mock_poll pollMock(&zkServer,ZookeeperServer::FD); + // use a checked version of pthread calls + CheckedPthread threadMock; + // do not actually free the memory while in zookeeper_close() + Mock_free_noop freeMock; + + CloseOnSessionExpired closeAction; + zh=zookeeper_init("localhost:2121",activeWatcher,10000, + TEST_CLIENT_ID,&closeAction,0); + + CPPUNIT_ASSERT(zh!=0); + // we rely on the fact that zh is freed the last right before + // zookeeper_close() returns... + CPPUNIT_ASSERT(ensureCondition(PointerFreed(freeMock,zh),1000)<1000); + zhandle_t* lzh=zh; + zh=0; + // we're done, disable mock's fake free(), use libc's free() instead + freeMock.disable(); + + CPPUNIT_ASSERT_EQUAL((int)ZOK,closeAction.rc); + adaptor_threads* adaptor=(adaptor_threads*)closeAction.lzh.adaptor_priv; + // memory + CPPUNIT_ASSERT_EQUAL(1,freeMock.getFreeCount(lzh)); + CPPUNIT_ASSERT_EQUAL(1,freeMock.getFreeCount(closeAction.lzh.hostname)); + CPPUNIT_ASSERT_EQUAL(1,freeMock.getFreeCount(closeAction.lzh.addrs)); + CPPUNIT_ASSERT_EQUAL(1,freeMock.getFreeCount(adaptor)); + // threads + CPPUNIT_ASSERT_EQUAL(1,CheckedPthread::getDestroyCounter(adaptor->io)); + CPPUNIT_ASSERT_EQUAL(1,CheckedPthread::getDestroyCounter(adaptor->completion)); + // mutexes + CPPUNIT_ASSERT_EQUAL(1,CheckedPthread::getDestroyCounter(&lzh->to_process.lock)); + CPPUNIT_ASSERT_EQUAL(0,CheckedPthread::getInvalidAccessCounter(&lzh->to_process.lock)); + CPPUNIT_ASSERT_EQUAL(1,CheckedPthread::getDestroyCounter(&lzh->to_send.lock)); + CPPUNIT_ASSERT_EQUAL(0,CheckedPthread::getInvalidAccessCounter(&lzh->to_send.lock)); + CPPUNIT_ASSERT_EQUAL(1,CheckedPthread::getDestroyCounter(&lzh->sent_requests.lock)); + CPPUNIT_ASSERT_EQUAL(0,CheckedPthread::getInvalidAccessCounter(&lzh->sent_requests.lock)); + CPPUNIT_ASSERT_EQUAL(1,CheckedPthread::getDestroyCounter(&lzh->completions_to_process.lock)); + CPPUNIT_ASSERT_EQUAL(0,CheckedPthread::getInvalidAccessCounter(&lzh->completions_to_process.lock)); + // conditionals + CPPUNIT_ASSERT_EQUAL(1,CheckedPthread::getDestroyCounter(&lzh->sent_requests.cond)); + CPPUNIT_ASSERT_EQUAL(0,CheckedPthread::getInvalidAccessCounter(&lzh->sent_requests.cond)); + CPPUNIT_ASSERT_EQUAL(1,CheckedPthread::getDestroyCounter(&lzh->completions_to_process.cond)); + CPPUNIT_ASSERT_EQUAL(0,CheckedPthread::getInvalidAccessCounter(&lzh->completions_to_process.cond)); + } + } + + void testIOThreadStoppedOnExpire() + { + // frozen time -- no timeouts and no pings + Mock_gettimeofday timeMock; + + for(int i=0;i<100;i++){ + ZookeeperServer zkServer; + // make the server return a non-matching session id + zkServer.returnSessionExpired(); + + Mock_poll pollMock(&zkServer,ZookeeperServer::FD); + // use a checked version of pthread calls + CheckedPthread threadMock; + // do not call zookeeper_close() from the watcher + CloseOnSessionExpired closeAction(false); + zh=zookeeper_init("localhost:2121",activeWatcher,10000, + &testClientId,&closeAction,0); + + // this is to ensure that if any assert fires, zookeeper_close() + // will still be called while all the mocks are in the scope! + CloseFinally guard(&zh); + + CPPUNIT_ASSERT(zh!=0); + CPPUNIT_ASSERT(ensureCondition(SessionExpired(zh),1000)<1000); + CPPUNIT_ASSERT(ensureCondition(IOThreadStopped(zh),1000)<1000); + // make sure the watcher has been processed + CPPUNIT_ASSERT(ensureCondition(closeAction.isWatcherTriggered(),1000)<1000); + // make sure the threads have not been destroyed yet + adaptor_threads* adaptor=(adaptor_threads*)zh->adaptor_priv; + CPPUNIT_ASSERT_EQUAL(0,CheckedPthread::getDestroyCounter(adaptor->io)); + CPPUNIT_ASSERT_EQUAL(0,CheckedPthread::getDestroyCounter(adaptor->completion)); + // about to call zookeeper_close() -- no longer need the guard + guard.disarm(); + + // do not actually free the memory while in zookeeper_close() + Mock_free_noop freeMock; + zookeeper_close(zh); + zhandle_t* lzh=zh; zh=0; + // we're done, disable mock's fake free(), use libc's free() instead + freeMock.disable(); + + // memory + CPPUNIT_ASSERT_EQUAL(1,freeMock.getFreeCount(lzh)); + CPPUNIT_ASSERT_EQUAL(1,freeMock.getFreeCount(closeAction.lzh.hostname)); + CPPUNIT_ASSERT_EQUAL(1,freeMock.getFreeCount(closeAction.lzh.addrs)); + CPPUNIT_ASSERT_EQUAL(1,freeMock.getFreeCount(adaptor)); + // threads + CPPUNIT_ASSERT_EQUAL(1,CheckedPthread::getDestroyCounter(adaptor->io)); + CPPUNIT_ASSERT_EQUAL(1,CheckedPthread::getDestroyCounter(adaptor->completion)); + // mutexes + CPPUNIT_ASSERT_EQUAL(1,CheckedPthread::getDestroyCounter(&lzh->to_process.lock)); + CPPUNIT_ASSERT_EQUAL(0,CheckedPthread::getInvalidAccessCounter(&lzh->to_process.lock)); + CPPUNIT_ASSERT_EQUAL(1,CheckedPthread::getDestroyCounter(&lzh->to_send.lock)); + CPPUNIT_ASSERT_EQUAL(0,CheckedPthread::getInvalidAccessCounter(&lzh->to_send.lock)); + CPPUNIT_ASSERT_EQUAL(1,CheckedPthread::getDestroyCounter(&lzh->sent_requests.lock)); + CPPUNIT_ASSERT_EQUAL(0,CheckedPthread::getInvalidAccessCounter(&lzh->sent_requests.lock)); + CPPUNIT_ASSERT_EQUAL(1,CheckedPthread::getDestroyCounter(&lzh->completions_to_process.lock)); + CPPUNIT_ASSERT_EQUAL(0,CheckedPthread::getInvalidAccessCounter(&lzh->completions_to_process.lock)); + // conditionals + CPPUNIT_ASSERT_EQUAL(1,CheckedPthread::getDestroyCounter(&lzh->sent_requests.cond)); + CPPUNIT_ASSERT_EQUAL(0,CheckedPthread::getInvalidAccessCounter(&lzh->sent_requests.cond)); + CPPUNIT_ASSERT_EQUAL(1,CheckedPthread::getDestroyCounter(&lzh->completions_to_process.cond)); + CPPUNIT_ASSERT_EQUAL(0,CheckedPthread::getInvalidAccessCounter(&lzh->completions_to_process.cond)); + } + } + +#endif +}; + +CPPUNIT_TEST_SUITE_REGISTRATION(Zookeeper_close); diff --git a/src/c/tests/TestZookeeperInit.cc b/src/c/tests/TestZookeeperInit.cc new file mode 100644 index 0000000..eadf41d --- /dev/null +++ b/src/c/tests/TestZookeeperInit.cc @@ -0,0 +1,301 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#include +#include +#include +#include + +#include "Util.h" +#include "LibCMocks.h" +#include "ZKMocks.h" + +#ifdef THREADED +#include "PthreadMocks.h" +#else +class MockPthreadsNull; +#endif + +using namespace std; + +class Zookeeper_init : public CPPUNIT_NS::TestFixture +{ + CPPUNIT_TEST_SUITE(Zookeeper_init); + CPPUNIT_TEST(testBasic); + CPPUNIT_TEST(testAddressResolution); + CPPUNIT_TEST(testMultipleAddressResolution); + CPPUNIT_TEST(testNullAddressString); + CPPUNIT_TEST(testEmptyAddressString); + CPPUNIT_TEST(testOneSpaceAddressString); + CPPUNIT_TEST(testTwoSpacesAddressString); + CPPUNIT_TEST(testInvalidAddressString1); + CPPUNIT_TEST(testInvalidAddressString2); + CPPUNIT_TEST(testNonexistentHost); + CPPUNIT_TEST(testOutOfMemory_init); + CPPUNIT_TEST(testOutOfMemory_getaddrs1); +#if !defined(__CYGWIN__) // not valid for cygwin + CPPUNIT_TEST(testOutOfMemory_getaddrs2); +#endif + CPPUNIT_TEST(testPermuteAddrsList); + CPPUNIT_TEST_SUITE_END(); + zhandle_t *zh; + MockPthreadsNull* pthreadMock; + static void watcher(zhandle_t *, int , int , const char *,void*){} + FILE *logfile; +public: + Zookeeper_init():zh(0),pthreadMock(0){ + logfile = openlogfile("Zookeeper_init"); + } + + ~Zookeeper_init() { + if (logfile) { + fflush(logfile); + fclose(logfile); + logfile = 0; + } + } + + void setUp() + { + zoo_set_log_stream(logfile); + + zoo_deterministic_conn_order(0); +#ifdef THREADED + // disable threading + pthreadMock=new MockPthreadZKNull; +#endif + zh=0; + } + + void tearDown() + { + zookeeper_close(zh); +#ifdef THREADED + delete pthreadMock; +#endif + } + + void testBasic() + { + const string EXPECTED_HOST("127.0.0.1:2121"); + const int EXPECTED_ADDRS_COUNT =1; + const int EXPECTED_RECV_TIMEOUT=10000; + clientid_t cid; + memset(&cid,0xFE,sizeof(cid)); + + zh=zookeeper_init(EXPECTED_HOST.c_str(),watcher,EXPECTED_RECV_TIMEOUT, + &cid,(void*)1,0); + + CPPUNIT_ASSERT(zh!=0); + CPPUNIT_ASSERT(zh->fd == -1); + CPPUNIT_ASSERT(zh->hostname!=0); + CPPUNIT_ASSERT_EQUAL(EXPECTED_ADDRS_COUNT,zh->addrs_count); + CPPUNIT_ASSERT_EQUAL(EXPECTED_HOST,string(zh->hostname)); + CPPUNIT_ASSERT(zh->state == NOTCONNECTED_STATE_DEF); + CPPUNIT_ASSERT(zh->context == (void*)1); + CPPUNIT_ASSERT_EQUAL(EXPECTED_RECV_TIMEOUT,zh->recv_timeout); + CPPUNIT_ASSERT(zh->watcher == watcher); + CPPUNIT_ASSERT(zh->connect_index==0); + CPPUNIT_ASSERT(zh->primer_buffer.buffer==zh->primer_storage_buffer); + CPPUNIT_ASSERT(zh->primer_buffer.curr_offset ==0); + CPPUNIT_ASSERT(zh->primer_buffer.len == sizeof(zh->primer_storage_buffer)); + CPPUNIT_ASSERT(zh->primer_buffer.next == 0); + CPPUNIT_ASSERT(zh->last_zxid ==0); + CPPUNIT_ASSERT(memcmp(&zh->client_id,&cid,sizeof(cid))==0); + +#ifdef THREADED + // thread specific checks + adaptor_threads* adaptor=(adaptor_threads*)zh->adaptor_priv; + CPPUNIT_ASSERT(adaptor!=0); + CPPUNIT_ASSERT(pthreadMock->pthread_createCounter==2); + CPPUNIT_ASSERT(MockPthreadsNull::isInitialized(adaptor->io)); + CPPUNIT_ASSERT(MockPthreadsNull::isInitialized(adaptor->completion)); + CPPUNIT_ASSERT(MockPthreadsNull::isInitialized(&zh->to_process.lock)); + CPPUNIT_ASSERT(MockPthreadsNull::isInitialized(&zh->to_send.lock)); + CPPUNIT_ASSERT(MockPthreadsNull::isInitialized(&zh->sent_requests.lock)); + CPPUNIT_ASSERT(MockPthreadsNull::isInitialized(&zh->completions_to_process.lock)); + CPPUNIT_ASSERT(MockPthreadsNull::isInitialized(&zh->sent_requests.cond)); + CPPUNIT_ASSERT(MockPthreadsNull::isInitialized(&zh->completions_to_process.cond)); +#endif + } + void testAddressResolution() + { + const char EXPECTED_IPS[][4]={{127,0,0,1}}; + const int EXPECTED_ADDRS_COUNT =COUNTOF(EXPECTED_IPS); + + zoo_deterministic_conn_order(1); + zh=zookeeper_init("127.0.0.1:2121",0,10000,0,0,0); + + CPPUNIT_ASSERT(zh!=0); + CPPUNIT_ASSERT_EQUAL(EXPECTED_ADDRS_COUNT,zh->addrs_count); + for(int i=0;iaddrs_count;i++){ + sockaddr_in* addr=(struct sockaddr_in*)&zh->addrs[i]; + CPPUNIT_ASSERT(memcmp(EXPECTED_IPS[i],&addr->sin_addr,sizeof(addr->sin_addr))==0); + CPPUNIT_ASSERT_EQUAL(2121,(int)ntohs(addr->sin_port)); + } + } + void testMultipleAddressResolution() + { + const string EXPECTED_HOST("127.0.0.1:2121,127.0.0.2:3434"); + const char EXPECTED_IPS[][4]={{127,0,0,1},{127,0,0,2}}; + const int EXPECTED_ADDRS_COUNT =COUNTOF(EXPECTED_IPS); + + zoo_deterministic_conn_order(1); + zh=zookeeper_init(EXPECTED_HOST.c_str(),0,1000,0,0,0); + + CPPUNIT_ASSERT(zh!=0); + CPPUNIT_ASSERT_EQUAL(EXPECTED_ADDRS_COUNT,zh->addrs_count); + + for(int i=0;iaddrs_count;i++){ + sockaddr_in* addr=(struct sockaddr_in*)&zh->addrs[i]; + CPPUNIT_ASSERT(memcmp(EXPECTED_IPS[i],&addr->sin_addr,sizeof(addr->sin_addr))==0); + if(i<1) + CPPUNIT_ASSERT_EQUAL(2121,(int)ntohs(addr->sin_port)); + else + CPPUNIT_ASSERT_EQUAL(3434,(int)ntohs(addr->sin_port)); + } + } + void testMultipleAddressWithSpace() + { + const string EXPECTED_HOST("127.0.0.1:2121, 127.0.0.2:3434"); + const char EXPECTED_IPS[][4]={{127,0,0,1},{127,0,0,2}}; + const int EXPECTED_ADDRS_COUNT =COUNTOF(EXPECTED_IPS); + + zoo_deterministic_conn_order(1); + zh=zookeeper_init(EXPECTED_HOST.c_str(),0,1000,0,0,0); + + CPPUNIT_ASSERT(zh!=0); + CPPUNIT_ASSERT_EQUAL(EXPECTED_ADDRS_COUNT,zh->addrs_count); + + for(int i=0;iaddrs_count;i++){ + sockaddr_in* addr=(struct sockaddr_in*)&zh->addrs[i]; + CPPUNIT_ASSERT(memcmp(EXPECTED_IPS[i],&addr->sin_addr,sizeof(addr->sin_addr))==0); + if(i<1) + CPPUNIT_ASSERT_EQUAL(2121,(int)ntohs(addr->sin_port)); + else + CPPUNIT_ASSERT_EQUAL(3434,(int)ntohs(addr->sin_port)); + } + } + void testNullAddressString() + { + zh=zookeeper_init(NULL,0,0,0,0,0); + CPPUNIT_ASSERT(zh==0); + CPPUNIT_ASSERT_EQUAL(EINVAL,errno); + } + void testEmptyAddressString() + { + const string INVALID_HOST(""); + zh=zookeeper_init(INVALID_HOST.c_str(),0,0,0,0,0); + CPPUNIT_ASSERT(zh==0); + CPPUNIT_ASSERT_EQUAL(EINVAL,errno); + } + void testOneSpaceAddressString() + { + const string INVALID_HOST(" "); + zh=zookeeper_init(INVALID_HOST.c_str(),0,0,0,0,0); + CPPUNIT_ASSERT(zh==0); + CPPUNIT_ASSERT_EQUAL(EINVAL,errno); + } + void testTwoSpacesAddressString() + { + const string INVALID_HOST(" "); + zh=zookeeper_init(INVALID_HOST.c_str(),0,0,0,0,0); + CPPUNIT_ASSERT(zh==0); + CPPUNIT_ASSERT_EQUAL(EINVAL,errno); + } + void testInvalidAddressString1() + { + const string INVALID_HOST("host1"); + zh=zookeeper_init(INVALID_HOST.c_str(),0,0,0,0,0); + CPPUNIT_ASSERT(zh==0); + CPPUNIT_ASSERT_EQUAL(EINVAL,errno); + } + void testInvalidAddressString2() + { + const string INVALID_HOST("host1:1111+host:123"); + zh=zookeeper_init(INVALID_HOST.c_str(),0,0,0,0,0); + CPPUNIT_ASSERT(zh==0); + CPPUNIT_ASSERT((ENOENT|EINVAL) & errno); + } + void testNonexistentHost() + { + const string EXPECTED_HOST("host1.blabadibla.bla.:1111"); + + zh=zookeeper_init(EXPECTED_HOST.c_str(),0,0,0,0,0); + + CPPUNIT_ASSERT(zh==0); + //With the switch to thread safe getaddrinfo, we don't get + //these global variables + //CPPUNIT_ASSERT_EQUAL(EINVAL,errno); + //CPPUNIT_ASSERT_EQUAL(HOST_NOT_FOUND,h_errno); + } + void testOutOfMemory_init() + { + Mock_calloc mock; + mock.callsBeforeFailure=0; // fail first calloc in init() + + zh=zookeeper_init("ahost:123",watcher,10000,0,0,0); + + CPPUNIT_ASSERT(zh==0); + CPPUNIT_ASSERT_EQUAL(ENOMEM,errno); + } + void testOutOfMemory_getaddrs1() + { + Mock_realloc reallocMock; + reallocMock.callsBeforeFailure=0; // fail on first call to realloc + + zh=zookeeper_init("127.0.0.1:123",0,0,0,0,0); + + CPPUNIT_ASSERT(zh==0); + CPPUNIT_ASSERT_EQUAL(ENOMEM,errno); + } + void testOutOfMemory_getaddrs2() + { + Mock_realloc reallocMock; + reallocMock.callsBeforeFailure=1; // fail on the second call to realloc + + zh=zookeeper_init("127.0.0.1:123,127.0.0.2:123,127.0.0.3:123,127.0.0.4:123,127.0.0.5:123,127.0.0.6:123,127.0.0.7:123,127.0.0.8:123,127.0.0.9:123,127.0.0.10:123,127.0.0.11:123,127.0.0.12:123,127.0.0.13:123,127.0.0.14:123,127.0.0.15:123,127.0.0.16:123,127.0.0.17:123",0,0,0,0,0); + + CPPUNIT_ASSERT(zh==0); + CPPUNIT_ASSERT_EQUAL(ENOMEM,errno); + } + void testPermuteAddrsList() + { + const char EXPECTED[][5]={"\0\0\0\0","\1\1\1\1","\2\2\2\2","\3\3\3\3"}; + const int EXPECTED_ADDR_COUNT=COUNTOF(EXPECTED); + + const int RAND_SEQ[]={0,1,1,-1}; + const int RAND_SIZE=COUNTOF(RAND_SEQ); + Mock_random randomMock; + randomMock.randomReturns.assign(RAND_SEQ,RAND_SEQ+RAND_SIZE-1); + zh=zookeeper_init("0.0.0.0:123,1.1.1.1:123,2.2.2.2:123,3.3.3.3:123",0,1000,0,0,0); + + CPPUNIT_ASSERT(zh!=0); + CPPUNIT_ASSERT_EQUAL(EXPECTED_ADDR_COUNT,zh->addrs_count); + const string EXPECTED_SEQ("3210"); + char ACTUAL_SEQ[EXPECTED_ADDR_COUNT+1]; ACTUAL_SEQ[EXPECTED_ADDR_COUNT]=0; + for(int i=0;iaddrs_count;i++){ + sockaddr_in* addr=(struct sockaddr_in*)&zh->addrs[i]; + // match the first byte of the EXPECTED and of the actual address + ACTUAL_SEQ[i]=((char*)&addr->sin_addr)[0]+'0'; + } + CPPUNIT_ASSERT_EQUAL(EXPECTED_SEQ,string(ACTUAL_SEQ)); + } +}; + +CPPUNIT_TEST_SUITE_REGISTRATION(Zookeeper_init); diff --git a/src/c/tests/ThreadingUtil.cc b/src/c/tests/ThreadingUtil.cc new file mode 100644 index 0000000..3b5170a --- /dev/null +++ b/src/c/tests/ThreadingUtil.cc @@ -0,0 +1,87 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#include +#include "ThreadingUtil.h" +#include "LibCSymTable.h" + +#ifdef THREADED + +// **************************************************************************** +// Mutex wrapper +struct Mutex::Impl{ + Impl(){ + LIBC_SYMBOLS.pthread_mutex_init(&mut_, 0); + } + ~Impl(){ + LIBC_SYMBOLS.pthread_mutex_destroy(&mut_); + } + pthread_mutex_t mut_; +}; + +Mutex::Mutex():impl_(new Impl) {} +Mutex::~Mutex() { delete impl_;} +void Mutex::acquire() { + LIBC_SYMBOLS.pthread_mutex_lock(&impl_->mut_); +} +void Mutex::release() { + LIBC_SYMBOLS.pthread_mutex_unlock(&impl_->mut_); +} + +// **************************************************************************** +// Atomics +int32_t atomic_post_incr(volatile int32_t* operand, int32_t incr) +{ +#if defined(__GNUC__) + return __sync_fetch_and_add(operand,incr); +#else + int32_t result; + __asm__ __volatile__( + "lock xaddl %0,%1\n" + : "=r"(result), "=m"(*operand) + : "0"(incr) + : "memory"); + return result; +#endif +} +int32_t atomic_fetch_store(volatile int32_t *ptr, int32_t value) +{ +#if defined(__GNUC__) + return __sync_lock_test_and_set(ptr,value); +#else + int32_t result; + __asm__ __volatile__("lock xchgl %0,%1\n" + : "=r"(result), "=m"(*ptr) + : "0"(value) + : "memory"); + return result; +#endif +} +#else +int32_t atomic_post_incr(volatile int32_t* operand, int32_t incr){ + int32_t v=*operand; + *operand+=incr; + return v; +} +int32_t atomic_fetch_store(volatile int32_t *ptr, int32_t value) +{ + int32_t result=*ptr; + *ptr=value; + return result; +} +#endif // THREADED diff --git a/src/c/tests/ThreadingUtil.h b/src/c/tests/ThreadingUtil.h new file mode 100644 index 0000000..9165412 --- /dev/null +++ b/src/c/tests/ThreadingUtil.h @@ -0,0 +1,261 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifndef THREADINGUTIL_H_ +#define THREADINGUTIL_H_ + +#include + +#ifdef THREADED +#include "pthread.h" +#endif + +// ***************************************************************************** +// Threading primitives + +// atomic post-increment; returns the previous value of the operand +int32_t atomic_post_incr(volatile int32_t* operand, int32_t incr); +// atomic fetch&store; returns the previous value of the operand +int32_t atomic_fetch_store(volatile int32_t *operand, int32_t value); + +// a partial implementation of an atomic integer type +class AtomicInt{ +public: + explicit AtomicInt(int32_t init=0):v_(init){} + AtomicInt(const AtomicInt& other):v_(other){} + // assigment + AtomicInt& operator=(const AtomicInt& lhs){ + atomic_fetch_store(&v_,lhs); + return *this; + } + AtomicInt& operator=(int32_t i){ + atomic_fetch_store(&v_,i); + return *this; + } + // pre-increment + AtomicInt& operator++() { + atomic_post_incr(&v_,1); + return *this; + } + // pre-decrement + AtomicInt& operator--() { + atomic_post_incr(&v_,-1); + return *this; + } + // post-increment + AtomicInt operator++(int){ + return AtomicInt(atomic_post_incr(&v_,1)); + } + // post-decrement + AtomicInt operator--(int){ + return AtomicInt(atomic_post_incr(&v_,-1)); + } + + operator int() const{ + return atomic_post_incr(&v_,0); + } + int get() const{ + return atomic_post_incr(&v_,0); + } +private: + mutable int32_t v_; +}; + +#ifdef THREADED +// **************************************************************************** +#define VALIDATE_JOBS(jm) jm.validateJobs(__FILE__,__LINE__) +#define VALIDATE_JOB(j) j.validate(__FILE__,__LINE__) + +class Mutex{ +public: + Mutex(); + ~Mutex(); + void acquire(); + void release(); +private: + Mutex(const Mutex&); + Mutex& operator=(const Mutex&); + struct Impl; + Impl* impl_; +}; + +class MTLock{ +public: + MTLock(Mutex& m):m_(m){m.acquire();} + ~MTLock(){m_.release();} + Mutex& m_; +}; + +#define synchronized(m) MTLock __lock(m) + +// **************************************************************************** +class Latch { +public: + virtual ~Latch() {} + virtual void await() const =0; + virtual void signalAndWait() =0; + virtual void signal() =0; +}; + +class CountDownLatch: public Latch { +public: + CountDownLatch(int count):count_(count) { + pthread_cond_init(&cond_,0); + pthread_mutex_init(&mut_,0); + } + virtual ~CountDownLatch() { + pthread_mutex_lock(&mut_); + if(count_!=0) { + count_=0; + pthread_cond_broadcast(&cond_); + } + pthread_mutex_unlock(&mut_); + + pthread_cond_destroy(&cond_); + pthread_mutex_destroy(&mut_); + } + + virtual void await() const { + pthread_mutex_lock(&mut_); + awaitImpl(); + pthread_mutex_unlock(&mut_); + } + virtual void signalAndWait() { + pthread_mutex_lock(&mut_); + signalImpl(); + awaitImpl(); + pthread_mutex_unlock(&mut_); + } + virtual void signal() { + pthread_mutex_lock(&mut_); + signalImpl(); + pthread_mutex_unlock(&mut_); + } +private: + void awaitImpl() const{ + while(count_!=0) + pthread_cond_wait(&cond_,&mut_); + } + void signalImpl() { + if(count_>0) { + count_--; + pthread_cond_broadcast(&cond_); + } + } + int count_; + mutable pthread_mutex_t mut_; + mutable pthread_cond_t cond_; +}; + +class TestJob { +public: + typedef long JobId; + TestJob():hasRun_(false),startLatch_(0),endLatch_(0) {} + virtual ~TestJob() { + join(); + } + virtual TestJob* clone() const =0; + + virtual void run() =0; + virtual void validate(const char* file, int line) const =0; + + virtual void start(Latch* startLatch=0,Latch* endLatch=0) { + startLatch_=startLatch;endLatch_=endLatch; + hasRun_=true; + pthread_create(&thread_, 0, thread, this); + } + virtual JobId getJobId() const { + return (JobId)thread_; + } + virtual void join() { + if(!hasRun_) + return; + if(!pthread_equal(thread_,pthread_self())) + pthread_join(thread_,0); + else + pthread_detach(thread_); + } +private: + void awaitStart() { + if(startLatch_==0) return; + startLatch_->signalAndWait(); + } + void signalFinished() { + if(endLatch_==0) return; + endLatch_->signal(); + } + static void* thread(void* p) { + TestJob* j=(TestJob*)p; + j->awaitStart(); // wait for the start command + j->run(); + j->signalFinished(); + return 0; + } + bool hasRun_; + Latch* startLatch_; + Latch* endLatch_; + pthread_t thread_; +}; + +class TestJobManager { + typedef std::vector JobList; +public: + TestJobManager(const TestJob& tj,int threadCount=1): + startLatch_(threadCount),endLatch_(threadCount) + { + for(int i=0;istart(&startLatch_,&endLatch_); + } + virtual void startJobsImmediately() { + for(unsigned i=0;istart(0,&endLatch_); + } + virtual void wait() const { + endLatch_.await(); + } + virtual void validateJobs(const char* file, int line) const{ + for(unsigned i=0;ivalidate(file,line); + } +private: + JobList jobs_; + CountDownLatch startLatch_; + CountDownLatch endLatch_; +}; + +#else // THREADED +// single THREADED +class Mutex{ +public: + void acquire(){} + void release(){} +}; +#define synchronized(m) + +#endif // THREADED + +#endif /*THREADINGUTIL_H_*/ diff --git a/src/c/tests/Util.cc b/src/c/tests/Util.cc new file mode 100644 index 0000000..2b9da84 --- /dev/null +++ b/src/c/tests/Util.cc @@ -0,0 +1,51 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#include "Util.h" +#include "string.h" + +const std::string EMPTY_STRING; + +TestConfig globalTestConfig; + +void millisleep(int ms){ + timespec ts; + ts.tv_sec=ms/1000; + ts.tv_nsec=(ms%1000)*1000000; // to nanoseconds + nanosleep(&ts,0); +} + +FILE *openlogfile(const char* testname) { + char name[1024]; + strcpy(name, "TEST-"); + strncpy(name + 5, testname, sizeof(name) - 5); +#ifdef THREADED + strcpy(name + strlen(name), "-mt.txt"); +#else + strcpy(name + strlen(name), "-st.txt"); +#endif + + FILE *logfile = fopen(name, "a"); + + if (logfile == 0) { + fprintf(stderr, "Can't open log file %s!\n", name); + return 0; + } + + return logfile; +} diff --git a/src/c/tests/Util.h b/src/c/tests/Util.h new file mode 100644 index 0000000..01e21ce --- /dev/null +++ b/src/c/tests/Util.h @@ -0,0 +1,137 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifndef UTIL_H_ +#define UTIL_H_ + +#include +#include +#include + +#include "zookeeper_log.h" + +// number of elements in array +#define COUNTOF(array) sizeof(array)/sizeof(array[0]) + +#define DECLARE_WRAPPER(ret,sym,sig) \ + extern "C" ret __real_##sym sig; \ + extern "C" ret __wrap_##sym sig + +#define CALL_REAL(sym,params) \ + __real_##sym params + +// must include "src/zookeeper_log.h" to be able to use this macro +#define TEST_TRACE(x) \ + log_message(ZOO_LOG_LEVEL_DEBUG,__LINE__,__func__,format_log_message x) + +extern const std::string EMPTY_STRING; + +// ***************************************************************************** +// A bit of wizardry to get to the bare type from a reference or a pointer +// to the type +template +struct TypeOp { + typedef T BareT; + typedef T ArgT; +}; + +// partial specialization for reference types +template +struct TypeOp{ + typedef T& ArgT; + typedef typename TypeOp::BareT BareT; +}; + +// partial specialization for pointers +template +struct TypeOp{ + typedef T* ArgT; + typedef typename TypeOp::BareT BareT; +}; + +// ***************************************************************************** +// Container utilities + +template +void putValue(std::map& map,const K& k, const V& v){ + typedef std::map Map; + typename Map::const_iterator it=map.find(k); + if(it==map.end()) + map.insert(typename Map::value_type(k,v)); + else + map[k]=v; +} + +template +bool getValue(const std::map& map,const K& k,V& v){ + typedef std::map Map; + typename Map::const_iterator it=map.find(k); + if(it==map.end()) + return false; + v=it->second; + return true; +} + +// ***************************************************************************** +// misc utils + +// millisecond sleep +void millisleep(int ms); +FILE *openlogfile(const char* name); +// evaluate given predicate until it returns true or the timeout +// (in millis) has expired +template +int ensureCondition(const Predicate& p,int timeout){ + int elapsed=0; + while(!p() && elapsed CmdLineOptList; +public: + typedef CmdLineOptList::const_iterator const_iterator; + TestConfig(){} + ~TestConfig(){} + void addConfigFromCmdLine(int argc, char* argv[]){ + if(argc>=2) + testName_=argv[1]; + for(int i=2; i + +// function to conveniently stream vectors +template +std::ostream& operator<<(std::ostream& os,const std::vector& c){ + typedef std::vector V; + os<<"["; + if(c.size()>0){ + for(typename V::const_iterator it=c.begin();it!=c.end();++it) + os<<*it<<","; + os.seekp(-1,std::ios::cur); + } + os<<"]"; + return os; +} + +#endif // _VECTOR_UTIL_H diff --git a/src/c/tests/ZKMocks.cc b/src/c/tests/ZKMocks.cc new file mode 100644 index 0000000..69bea16 --- /dev/null +++ b/src/c/tests/ZKMocks.cc @@ -0,0 +1,519 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#include // for htonl +#include + +#include +#include + +#ifdef THREADED +#include "PthreadMocks.h" +#endif +#include "ZKMocks.h" + +using namespace std; + +TestClientId testClientId; +const char* TestClientId::PASSWD="1234567890123456"; + +HandshakeRequest* HandshakeRequest::parse(const std::string& buf){ + auto_ptr req(new HandshakeRequest); + + memcpy(&req->protocolVersion,buf.data(), sizeof(req->protocolVersion)); + req->protocolVersion = htonl(req->protocolVersion); + + int offset=sizeof(req->protocolVersion); + + memcpy(&req->lastZxidSeen,buf.data()+offset,sizeof(req->lastZxidSeen)); + req->lastZxidSeen = zoo_htonll(req->lastZxidSeen); + offset+=sizeof(req->lastZxidSeen); + + memcpy(&req->timeOut,buf.data()+offset,sizeof(req->timeOut)); + req->timeOut = htonl(req->timeOut); + offset+=sizeof(req->timeOut); + + memcpy(&req->sessionId,buf.data()+offset,sizeof(req->sessionId)); + req->sessionId = zoo_htonll(req->sessionId); + offset+=sizeof(req->sessionId); + + memcpy(&req->passwd_len,buf.data()+offset,sizeof(req->passwd_len)); + req->passwd_len = htonl(req->passwd_len); + offset+=sizeof(req->passwd_len); + + memcpy(req->passwd,buf.data()+offset,sizeof(req->passwd)); + if(testClientId.client_id==req->sessionId && + !memcmp(testClientId.passwd,req->passwd,sizeof(req->passwd))) + return req.release(); + // the request didn't match -- may not be a handshake request after all + return 0; +} + +// ***************************************************************************** +// watcher action implementation +void activeWatcher(zhandle_t *zh, int type, int state, const char *path,void* ctx){ + if(zh==0 || ctx==0) return; + WatcherAction* action=(WatcherAction*)ctx; + + if(type==ZOO_SESSION_EVENT){ + if(state==ZOO_EXPIRED_SESSION_STATE) + action->onSessionExpired(zh); + else if(state==ZOO_CONNECTING_STATE) + action->onConnectionLost(zh); + else if(state==ZOO_CONNECTED_STATE) + action->onConnectionEstablished(zh); + }else if(type==ZOO_CHANGED_EVENT) + action->onNodeValueChanged(zh,path); + else if(type==ZOO_DELETED_EVENT) + action->onNodeDeleted(zh,path); + else if(type==ZOO_CHILD_EVENT) + action->onChildChanged(zh,path); + // TODO: implement for the rest of the event types + // ... + action->setWatcherTriggered(); +} +SyncedBoolCondition WatcherAction::isWatcherTriggered() const{ + return SyncedBoolCondition(triggered_,mx_); +} + +// ***************************************************************************** +// a set of async completion signatures +void asyncCompletion(int rc, ACL_vector *acl,Stat *stat, const void *data){ + assert("Completion data is NULL"&&data); + static_cast((void*)data)->aclCompl(rc,acl,stat); +} +void asyncCompletion(int rc, const char *value, int len, const Stat *stat, + const void *data){ + assert("Completion data is NULL"&&data); + static_cast((void*)data)->dataCompl(rc,value,len,stat); +} +void asyncCompletion(int rc, const Stat *stat, const void *data){ + assert("Completion data is NULL"&&data); + static_cast((void*)data)->statCompl(rc,stat); +} +void asyncCompletion(int rc, const char *value, const void *data){ + assert("Completion data is NULL"&&data); + static_cast((void*)data)->stringCompl(rc,value); +} +void asyncCompletion(int rc,const String_vector *strings, const void *data){ + assert("Completion data is NULL"&&data); + static_cast((void*)data)->stringsCompl(rc,strings); +} +void asyncCompletion(int rc, const void *data){ + assert("Completion data is NULL"&&data); + static_cast((void*)data)->voidCompl(rc); +} + +// ***************************************************************************** +// a predicate implementation +bool IOThreadStopped::operator()() const{ +#ifdef THREADED + adaptor_threads* adaptor=(adaptor_threads*)zh_->adaptor_priv; + return CheckedPthread::isTerminated(adaptor->io); +#else + assert("IOThreadStopped predicate is only for use with THREADED client"&& false); + return false; +#endif +} + +//****************************************************************************** +// +DECLARE_WRAPPER(int,flush_send_queue,(zhandle_t*zh, int timeout)) +{ + if(!Mock_flush_send_queue::mock_) + return CALL_REAL(flush_send_queue,(zh,timeout)); + return Mock_flush_send_queue::mock_->call(zh,timeout); +} + +Mock_flush_send_queue* Mock_flush_send_queue::mock_=0; + +//****************************************************************************** +// +DECLARE_WRAPPER(int32_t,get_xid,()) +{ + if(!Mock_get_xid::mock_) + return CALL_REAL(get_xid,()); + return Mock_get_xid::mock_->call(); +} + +Mock_get_xid* Mock_get_xid::mock_=0; + +//****************************************************************************** +// activateWatcher mock + +DECLARE_WRAPPER(void,activateWatcher,(zhandle_t *zh, watcher_registration_t* reg, int rc)) +{ + if(!Mock_activateWatcher::mock_){ + CALL_REAL(activateWatcher,(zh, reg,rc)); + }else{ + Mock_activateWatcher::mock_->call(zh, reg,rc); + } +} +Mock_activateWatcher* Mock_activateWatcher::mock_=0; + +class ActivateWatcherWrapper: public Mock_activateWatcher{ +public: + ActivateWatcherWrapper():ctx_(0),activated_(false){} + + virtual void call(zhandle_t *zh, watcher_registration_t* reg, int rc){ + CALL_REAL(activateWatcher,(zh, reg,rc)); + synchronized(mx_); + if(reg->context==ctx_){ + activated_=true; + ctx_=0; + } + } + + void setContext(void* ctx){ + synchronized(mx_); + ctx_=ctx; + activated_=false; + } + + SyncedBoolCondition isActivated() const{ + return SyncedBoolCondition(activated_,mx_); + } + mutable Mutex mx_; + void* ctx_; + bool activated_; +}; + +WatcherActivationTracker::WatcherActivationTracker(): + wrapper_(new ActivateWatcherWrapper) +{ +} + +WatcherActivationTracker::~WatcherActivationTracker(){ + delete wrapper_; +} + +void WatcherActivationTracker::track(void* ctx){ + wrapper_->setContext(ctx); +} + +SyncedBoolCondition WatcherActivationTracker::isWatcherActivated() const{ + return wrapper_->isActivated(); +} + +//****************************************************************************** +// +DECLARE_WRAPPER(void,deliverWatchers,(zhandle_t* zh,int type,int state, const char* path, watcher_object_list_t **list)) +{ + if(!Mock_deliverWatchers::mock_){ + CALL_REAL(deliverWatchers,(zh,type,state,path, list)); + }else{ + Mock_deliverWatchers::mock_->call(zh,type,state,path, list); + } +} + +Mock_deliverWatchers* Mock_deliverWatchers::mock_=0; + +struct RefCounterValue{ + RefCounterValue(zhandle_t* const& zh,int32_t expectedCounter,Mutex& mx): + zh_(zh),expectedCounter_(expectedCounter),mx_(mx){} + bool operator()() const{ + { + synchronized(mx_); + if(zh_==0) + return false; + } + return inc_ref_counter(zh_,0)==expectedCounter_; + } + zhandle_t* const& zh_; + int32_t expectedCounter_; + Mutex& mx_; +}; + + +class DeliverWatchersWrapper: public Mock_deliverWatchers{ +public: + DeliverWatchersWrapper(int type,int state,bool terminate): + type_(type),state_(state), + allDelivered_(false),terminate_(terminate),zh_(0),deliveryCounter_(0){} + virtual void call(zhandle_t* zh,int type,int state, const char* path, watcher_object_list **list){ + { + synchronized(mx_); + zh_=zh; + allDelivered_=false; + } + CALL_REAL(deliverWatchers,(zh,type,state,path, list)); + if(type_==type && state_==state){ + if(terminate_){ + // prevent zhandle_t from being prematurely distroyed; + // this will also ensure that zookeeper_close() cleanups the thread + // resources by calling finish_adaptor() + inc_ref_counter(zh,1); + terminateZookeeperThreads(zh); + } + synchronized(mx_); + allDelivered_=true; + deliveryCounter_++; + } + } + SyncedBoolCondition isDelivered() const{ + if(terminate_){ + int i=ensureCondition(RefCounterValue(zh_,1,mx_),1000); + assert(i<1000); + } + return SyncedBoolCondition(allDelivered_,mx_); + } + void resetDeliveryCounter(){ + synchronized(mx_); + deliveryCounter_=0; + } + SyncedIntegerEqual deliveryCounterEquals(int expected) const{ + if(terminate_){ + int i=ensureCondition(RefCounterValue(zh_,1,mx_),1000); + assert(i<1000); + } + return SyncedIntegerEqual(deliveryCounter_,expected,mx_); + } + int type_; + int state_; + mutable Mutex mx_; + bool allDelivered_; + bool terminate_; + zhandle_t* zh_; + int deliveryCounter_; +}; + +WatcherDeliveryTracker::WatcherDeliveryTracker( + int type,int state,bool terminateCompletionThread): + deliveryWrapper_(new DeliverWatchersWrapper( + type,state,terminateCompletionThread)){ +} + +WatcherDeliveryTracker::~WatcherDeliveryTracker(){ + delete deliveryWrapper_; +} + +SyncedBoolCondition WatcherDeliveryTracker::isWatcherProcessingCompleted() const{ + return deliveryWrapper_->isDelivered(); +} + +void WatcherDeliveryTracker::resetDeliveryCounter(){ + deliveryWrapper_->resetDeliveryCounter(); +} + +SyncedIntegerEqual WatcherDeliveryTracker::deliveryCounterEquals(int expected) const{ + return deliveryWrapper_->deliveryCounterEquals(expected); +} + +//****************************************************************************** +// +string HandshakeResponse::toString() const { + string buf; + int32_t tmp=htonl(protocolVersion); + buf.append((char*)&tmp,sizeof(tmp)); + tmp=htonl(timeOut); + buf.append((char*)&tmp,sizeof(tmp)); + int64_t tmp64=zoo_htonll(sessionId); + buf.append((char*)&tmp64,sizeof(sessionId)); + tmp=htonl(passwd_len); + buf.append((char*)&tmp,sizeof(tmp)); + buf.append(passwd,sizeof(passwd)); + // finally set the buffer length + tmp=htonl(buf.size()+sizeof(tmp)); + buf.insert(0,(char*)&tmp, sizeof(tmp)); + return buf; +} + +string ZooGetResponse::toString() const{ + oarchive* oa=create_buffer_oarchive(); + + ReplyHeader h = {xid_,1,ZOK}; + serialize_ReplyHeader(oa, "hdr", &h); + + GetDataResponse resp; + char buf[1024]; + assert("GetDataResponse is too long"&&data_.size()<=sizeof(buf)); + resp.data.len=data_.size(); + resp.data.buff=buf; + data_.copy(resp.data.buff, data_.size()); + resp.stat=stat_; + serialize_GetDataResponse(oa, "reply", &resp); + int32_t len=htonl(get_buffer_len(oa)); + string res((char*)&len,sizeof(len)); + res.append(get_buffer(oa),get_buffer_len(oa)); + + close_buffer_oarchive(&oa,1); + return res; +} + +string ZooStatResponse::toString() const{ + oarchive* oa=create_buffer_oarchive(); + + ReplyHeader h = {xid_,1,rc_}; + serialize_ReplyHeader(oa, "hdr", &h); + + SetDataResponse resp; + resp.stat=stat_; + serialize_SetDataResponse(oa, "reply", &resp); + int32_t len=htonl(get_buffer_len(oa)); + string res((char*)&len,sizeof(len)); + res.append(get_buffer(oa),get_buffer_len(oa)); + + close_buffer_oarchive(&oa,1); + return res; +} + +string ZooGetChildrenResponse::toString() const{ + oarchive* oa=create_buffer_oarchive(); + + ReplyHeader h = {xid_,1,rc_}; + serialize_ReplyHeader(oa, "hdr", &h); + + GetChildrenResponse resp; + // populate the string vector + allocate_String_vector(&resp.children,strings_.size()); + for(int i=0;i<(int)strings_.size();++i) + resp.children.data[i]=strdup(strings_[i].c_str()); + serialize_GetChildrenResponse(oa, "reply", &resp); + deallocate_GetChildrenResponse(&resp); + + int32_t len=htonl(get_buffer_len(oa)); + string res((char*)&len,sizeof(len)); + res.append(get_buffer(oa),get_buffer_len(oa)); + + close_buffer_oarchive(&oa,1); + return res; +} + +string ZNodeEvent::toString() const{ + oarchive* oa=create_buffer_oarchive(); + struct WatcherEvent evt = {type_,0,(char*)path_.c_str()}; + struct ReplyHeader h = {WATCHER_EVENT_XID,0,ZOK }; + + serialize_ReplyHeader(oa, "hdr", &h); + serialize_WatcherEvent(oa, "event", &evt); + + int32_t len=htonl(get_buffer_len(oa)); + string res((char*)&len,sizeof(len)); + res.append(get_buffer(oa),get_buffer_len(oa)); + + close_buffer_oarchive(&oa,1); + return res; +} + +string PingResponse::toString() const{ + oarchive* oa=create_buffer_oarchive(); + + ReplyHeader h = {PING_XID,1,ZOK}; + serialize_ReplyHeader(oa, "hdr", &h); + + int32_t len=htonl(get_buffer_len(oa)); + string res((char*)&len,sizeof(len)); + res.append(get_buffer(oa),get_buffer_len(oa)); + + close_buffer_oarchive(&oa,1); + return res; +} + +//****************************************************************************** +// Zookeeper server simulator +// +bool ZookeeperServer::hasMoreRecv() const{ + return recvHasMore.get()!=0 || connectionLost; +} + +ssize_t ZookeeperServer::callRecv(int s,void *buf,size_t len,int flags){ + if(connectionLost){ + recvReturnBuffer.erase(); + return 0; + } + // done transmitting the current buffer? + if(recvReturnBuffer.size()==0){ + synchronized(recvQMx); + if(recvQueue.empty()){ + recvErrno=EAGAIN; + return Mock_socket::callRecv(s,buf,len,flags); + } + --recvHasMore; + Element& el=recvQueue.front(); + if(el.first!=0){ + recvReturnBuffer=el.first->toString(); + delete el.first; + } + recvErrno=el.second; + recvQueue.pop_front(); + } + return Mock_socket::callRecv(s,buf,len,flags); +} + +void ZookeeperServer::onMessageReceived(const RequestHeader& rh, iarchive* ia){ + // no-op by default +} + +void ZookeeperServer::notifyBufferSent(const std::string& buffer){ + if(HandshakeRequest::isValid(buffer)){ + // could be a connect request + auto_ptr req(HandshakeRequest::parse(buffer)); + if(req.get()!=0){ + // handle the handshake + int64_t sessId=sessionExpired?req->sessionId+1:req->sessionId; + sessionExpired=false; + addRecvResponse(new HandshakeResponse(sessId)); + return; + } + // not a connect request -- fall thru + } + // parse the buffer to extract the request type and its xid + iarchive *ia=create_buffer_iarchive((char*)buffer.data(), buffer.size()); + RequestHeader rh; + deserialize_RequestHeader(ia,"hdr",&rh); + // notify the "server" a client request has arrived + if (rh.xid == -8) { + Element e = Element(new ZooStatResponse,0); + e.first->setXID(-8); + addRecvResponse(e); + close_buffer_iarchive(&ia); + return; + } else { + onMessageReceived(rh,ia); + } + close_buffer_iarchive(&ia); + if(rh.type==ZOO_CLOSE_OP){ + ++closeSent; + return; // no reply for close requests + } + // get the next response from the response queue and append it to the receive list + Element e; + { + synchronized(respQMx); + if(respQueue.empty()) + return; + e=respQueue.front(); + respQueue.pop_front(); + } + e.first->setXID(rh.xid); + addRecvResponse(e); +} + +void forceConnected(zhandle_t* zh){ + // simulate connected state + zh->state=ZOO_CONNECTED_STATE; + zh->fd=ZookeeperServer::FD; + zh->input_buffer=0; + gettimeofday(&zh->last_recv,0); + gettimeofday(&zh->last_send,0); +} + +void terminateZookeeperThreads(zhandle_t* zh){ + // this will cause the zookeeper threads to terminate + zh->close_requested=1; +} diff --git a/src/c/tests/ZKMocks.h b/src/c/tests/ZKMocks.h new file mode 100644 index 0000000..fbcfc4f --- /dev/null +++ b/src/c/tests/ZKMocks.h @@ -0,0 +1,509 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifndef ZKMOCKS_H_ +#define ZKMOCKS_H_ + +#include +#include "src/zk_adaptor.h" + +#include "Util.h" +#include "LibCMocks.h" +#include "MocksBase.h" + +// ***************************************************************************** +// sets internal zhandle_t members to certain values to simulate the client +// connected state. This function should only be used with the single-threaded +// Async API tests! +void forceConnected(zhandle_t* zh); + +/** + * Gracefully terminates zookeeper I/O and completion threads. + */ +void terminateZookeeperThreads(zhandle_t* zh); + +// ***************************************************************************** +// Abstract watcher action +struct SyncedBoolCondition; + +class WatcherAction{ +public: + WatcherAction():triggered_(false){} + virtual ~WatcherAction(){} + + virtual void onSessionExpired(zhandle_t*){} + virtual void onConnectionEstablished(zhandle_t*){} + virtual void onConnectionLost(zhandle_t*){} + virtual void onNodeValueChanged(zhandle_t*,const char* path){} + virtual void onNodeDeleted(zhandle_t*,const char* path){} + virtual void onChildChanged(zhandle_t*,const char* path){} + + SyncedBoolCondition isWatcherTriggered() const; + void setWatcherTriggered(){ + synchronized(mx_); + triggered_=true; + } + +protected: + mutable Mutex mx_; + bool triggered_; +}; +// zh->context is a pointer to a WatcherAction instance +// based on the event type and state, the watcher calls a specific watcher +// action method +void activeWatcher(zhandle_t *zh, int type, int state, const char *path,void* ctx); + +// ***************************************************************************** +// a set of async completion signatures +class AsyncCompletion{ +public: + virtual ~AsyncCompletion(){} + virtual void aclCompl(int rc, ACL_vector *acl,Stat *stat){} + virtual void dataCompl(int rc, const char *value, int len, const Stat *stat){} + virtual void statCompl(int rc, const Stat *stat){} + virtual void stringCompl(int rc, const char *value){} + virtual void stringsCompl(int rc,const String_vector *strings){} + virtual void voidCompl(int rc){} +}; +void asyncCompletion(int rc, ACL_vector *acl,Stat *stat, const void *data); +void asyncCompletion(int rc, const char *value, int len, const Stat *stat, + const void *data); +void asyncCompletion(int rc, const Stat *stat, const void *data); +void asyncCompletion(int rc, const char *value, const void *data); +void asyncCompletion(int rc,const String_vector *strings, const void *data); +void asyncCompletion(int rc, const void *data); + +// ***************************************************************************** +// some common predicates to use with ensureCondition(): +// checks if the connection is established +struct ClientConnected{ + ClientConnected(zhandle_t* zh):zh_(zh){} + bool operator()() const{ + return zoo_state(zh_)==ZOO_CONNECTED_STATE; + } + zhandle_t* zh_; +}; +// check in the session expired +struct SessionExpired{ + SessionExpired(zhandle_t* zh):zh_(zh){} + bool operator()() const{ + return zoo_state(zh_)==ZOO_EXPIRED_SESSION_STATE; + } + zhandle_t* zh_; +}; +// checks if the IO thread has stopped; CheckedPthread must be active +struct IOThreadStopped{ + IOThreadStopped(zhandle_t* zh):zh_(zh){} + bool operator()() const; + zhandle_t* zh_; +}; + +// a synchronized boolean condition +struct SyncedBoolCondition{ + SyncedBoolCondition(const bool& cond,Mutex& mx):cond_(cond),mx_(mx){} + bool operator()() const{ + synchronized(mx_); + return cond_; + } + const bool& cond_; + Mutex& mx_; +}; + +// a synchronized integer comparison +struct SyncedIntegerEqual{ + SyncedIntegerEqual(const int& cond,int expected,Mutex& mx): + cond_(cond),expected_(expected),mx_(mx){} + bool operator()() const{ + synchronized(mx_); + return cond_==expected_; + } + const int& cond_; + const int expected_; + Mutex& mx_; +}; + +// ***************************************************************************** +// make sure to call zookeeper_close() even in presence of exceptions +struct CloseFinally{ + CloseFinally(zhandle_t** zh):zh_(zh){} + ~CloseFinally(){ + execute(); + } + int execute(){ + if(zh_==0)return ZOK; + zhandle_t* lzh=*zh_; + *zh_=0; + disarm(); + return zookeeper_close(lzh); + } + void disarm(){zh_=0;} + zhandle_t ** zh_; +}; + +struct TestClientId: clientid_t{ + static const int SESSION_ID=123456789; + static const char* PASSWD; + TestClientId(){ + client_id=SESSION_ID; + memcpy(passwd,PASSWD,sizeof(passwd)); + } +}; + +// ***************************************************************************** +// special client id recongnized by the ZK server simulator +extern TestClientId testClientId; +#define TEST_CLIENT_ID &testClientId + +// ***************************************************************************** +// +struct HandshakeRequest: public connect_req +{ + static HandshakeRequest* parse(const std::string& buf); + static bool isValid(const std::string& buf){ + // this is just quick and dirty check before we go and parse the request + return buf.size()==HANDSHAKE_REQ_SIZE; + } +}; + +// ***************************************************************************** +// flush_send_queue +class Mock_flush_send_queue: public Mock +{ +public: + Mock_flush_send_queue():counter(0),callReturns(ZOK){mock_=this;} + ~Mock_flush_send_queue(){mock_=0;} + + int counter; + int callReturns; + virtual int call(zhandle_t* zh, int timeout){ + counter++; + return callReturns; + } + + static Mock_flush_send_queue* mock_; +}; + +// ***************************************************************************** +// get_xid +class Mock_get_xid: public Mock +{ +public: + static const int32_t XID=123456; + Mock_get_xid(int retValue=XID):callReturns(retValue){mock_=this;} + ~Mock_get_xid(){mock_=0;} + + int callReturns; + virtual int call(){ + return callReturns; + } + + static Mock_get_xid* mock_; +}; + +// ***************************************************************************** +// activateWatcher +class Mock_activateWatcher: public Mock{ +public: + Mock_activateWatcher(){mock_=this;} + virtual ~Mock_activateWatcher(){mock_=0;} + + virtual void call(zhandle_t *zh, watcher_registration_t* reg, int rc){} + static Mock_activateWatcher* mock_; +}; + +class ActivateWatcherWrapper; +class WatcherActivationTracker{ +public: + WatcherActivationTracker(); + ~WatcherActivationTracker(); + + void track(void* ctx); + SyncedBoolCondition isWatcherActivated() const; +private: + ActivateWatcherWrapper* wrapper_; +}; + +// ***************************************************************************** +// deliverWatchers +class Mock_deliverWatchers: public Mock{ +public: + Mock_deliverWatchers(){mock_=this;} + virtual ~Mock_deliverWatchers(){mock_=0;} + + virtual void call(zhandle_t* zh,int type,int state, const char* path, watcher_object_list **){} + static Mock_deliverWatchers* mock_; +}; + +class DeliverWatchersWrapper; +class WatcherDeliveryTracker{ +public: + // filters deliveries by state and type + WatcherDeliveryTracker(int type,int state,bool terminateCompletionThread=true); + ~WatcherDeliveryTracker(); + + // if the thread termination requested (see the ctor params) + // this function will wait for the I/O and completion threads to + // terminate before returning a SyncBoolCondition instance + SyncedBoolCondition isWatcherProcessingCompleted() const; + void resetDeliveryCounter(); + SyncedIntegerEqual deliveryCounterEquals(int expected) const; +private: + DeliverWatchersWrapper* deliveryWrapper_; +}; + +// ***************************************************************************** +// a zookeeper Stat wrapper +struct NodeStat: public Stat +{ + NodeStat(){ + czxid=0; + mzxid=0; + ctime=0; + mtime=0; + version=1; + cversion=0; + aversion=0; + ephemeralOwner=0; + } + NodeStat(const Stat& other){ + memcpy(this,&other,sizeof(*this)); + } +}; + +// ***************************************************************************** +// Abstract server Response +class Response +{ +public: + virtual ~Response(){} + + virtual void setXID(int32_t xid){} + // this method is used by the ZookeeperServer class to serialize + // the instance of Response + virtual std::string toString() const =0; +}; + +// ***************************************************************************** +// Handshake response +class HandshakeResponse: public Response +{ +public: + HandshakeResponse(int64_t sessId=1) + :protocolVersion(1),timeOut(10000),sessionId(sessId),passwd_len(sizeof(passwd)) + { + memcpy(passwd,"1234567890123456",sizeof(passwd)); + } + int32_t protocolVersion; + int32_t timeOut; + int64_t sessionId; + int32_t passwd_len; + char passwd[16]; + virtual std::string toString() const ; +}; + +// zoo_get() response +class ZooGetResponse: public Response +{ +public: + ZooGetResponse(const char* data, int len,int32_t xid=0,int rc=ZOK,const Stat& stat=NodeStat()) + :xid_(xid),data_(data,len),rc_(rc),stat_(stat) + { + } + virtual std::string toString() const; + virtual void setXID(int32_t xid) {xid_=xid;} + +private: + int32_t xid_; + std::string data_; + int rc_; + Stat stat_; +}; + +// zoo_exists(), zoo_set() response +class ZooStatResponse: public Response +{ +public: + ZooStatResponse(int32_t xid=0,int rc=ZOK,const Stat& stat=NodeStat()) + :xid_(xid),rc_(rc),stat_(stat) + { + } + virtual std::string toString() const; + virtual void setXID(int32_t xid) {xid_=xid;} + +private: + int32_t xid_; + int rc_; + Stat stat_; +}; + +// zoo_get_children() +class ZooGetChildrenResponse: public Response +{ +public: + typedef std::vector StringVector; + ZooGetChildrenResponse(const StringVector& v,int rc=ZOK): + xid_(0),strings_(v),rc_(rc) + { + } + + virtual std::string toString() const; + virtual void setXID(int32_t xid) {xid_=xid;} + + int32_t xid_; + StringVector strings_; + int rc_; +}; + +// PING response +class PingResponse: public Response +{ +public: + virtual std::string toString() const; +}; + +// watcher znode event +class ZNodeEvent: public Response +{ +public: + ZNodeEvent(int type,const char* path):type_(type),path_(path){} + + virtual std::string toString() const; + +private: + int type_; + std::string path_; +}; + +// **************************************************************************** +// Zookeeper server simulator + +class ZookeeperServer: public Mock_socket +{ +public: + ZookeeperServer(): + serverDownSkipCount_(-1),sessionExpired(false),connectionLost(false) + { + connectReturns=-1; + connectErrno=EWOULDBLOCK; + } + virtual ~ZookeeperServer(){ + clearRecvQueue(); + clearRespQueue(); + } + virtual int callClose(int fd){ + if(fd!=FD) + return LIBC_SYMBOLS.close(fd); + clearRecvQueue(); + clearRespQueue(); + return Mock_socket::callClose(fd); + } + // connection handling + // what to do when the handshake request comes in? + int serverDownSkipCount_; + // this will cause getsockopt(zh->fd,SOL_SOCKET,SO_ERROR,&error,&len) return + // a failure after skipCount dropped to zero, thus simulating a server down + // condition + // passing skipCount==-1 will make every connect attempt succeed + void setServerDown(int skipCount=0){ + serverDownSkipCount_=skipCount; + optvalSO_ERROR=0; + } + virtual void setSO_ERROR(void *optval,socklen_t len){ + if(serverDownSkipCount_!=-1){ + if(serverDownSkipCount_==0) + optvalSO_ERROR=ECONNREFUSED; + else + serverDownSkipCount_--; + } + Mock_socket::setSO_ERROR(optval,len); + } + + // this is a trigger that gets reset back to false + // a connect request will return a non-matching session id thus causing + // the client throw SESSION_EXPIRED + volatile bool sessionExpired; + void returnSessionExpired(){ sessionExpired=true; } + + // this is a one shot trigger that gets reset back to false + // next recv call will return 0 length, thus simulating a connecton loss + volatile bool connectionLost; + void setConnectionLost() {connectionLost=true;} + + // recv + // this queue is used for server responses: client's recv() system call + // returns next available message from this queue + typedef std::pair Element; + typedef std::deque ResponseList; + ResponseList recvQueue; + mutable Mutex recvQMx; + AtomicInt recvHasMore; + ZookeeperServer& addRecvResponse(Response* resp, int errnum=0){ + synchronized(recvQMx); + recvQueue.push_back(Element(resp,errnum)); + ++recvHasMore; + return *this; + } + ZookeeperServer& addRecvResponse(int errnum){ + synchronized(recvQMx); + recvQueue.push_back(Element(0,errnum)); + ++recvHasMore; + return *this; + } + ZookeeperServer& addRecvResponse(const Element& e){ + synchronized(recvQMx); + recvQueue.push_back(e); + ++recvHasMore; + return *this; + } + void clearRecvQueue(){ + synchronized(recvQMx); + recvHasMore=0; + for(unsigned i=0; i /dev/null +if [ $? -eq 0 ] +then + pid=`lsof -i :$ZOOPORT | grep LISTEN | awk '{print $2}'` + if [ -n "$pid" ] + then + $KILL -9 $pid + fi +fi + +if [ "x${base_dir}" == "x" ] +then +zk_base="../../" +else +zk_base="${base_dir}" +fi + +CLASSPATH="$CLASSPATH:${zk_base}/build/classes" +CLASSPATH="$CLASSPATH:${zk_base}/conf" + +for i in "${zk_base}"/build/lib/*.jar +do + CLASSPATH="$CLASSPATH:$i" +done + +for i in "${zk_base}"/src/java/lib/*.jar +do + CLASSPATH="$CLASSPATH:$i" +done + +CLASSPATH="$CLASSPATH:${CLOVER_HOME}/lib/clover.jar" + +if $cygwin +then + CLASSPATH=`cygpath -wp "$CLASSPATH"` +fi + +case $1 in +start|startClean) + if [ "x${base_dir}" == "x" ] + then + mkdir -p /tmp/zkdata + java -cp "$CLASSPATH" org.apache.zookeeper.server.ZooKeeperServerMain $ZOOPORT /tmp/zkdata 3000 $ZKMAXCNXNS &> /tmp/zk.log & + pid=$! + echo -n $! > /tmp/zk.pid + else + mkdir -p "${base_dir}/build/tmp/zkdata" + java -cp "$CLASSPATH" org.apache.zookeeper.server.ZooKeeperServerMain $ZOOPORT "${base_dir}/build/tmp/zkdata" 3000 $ZKMAXCNXNS &> "${base_dir}/build/tmp/zk.log" & + pid=$! + echo -n $pid > "${base_dir}/build/tmp/zk.pid" + fi + + # wait max 120 seconds for server to be ready to server clients + # this handles testing on slow hosts + success=false + for i in {1..120} + do + if ps -p $pid > /dev/null + then + java -cp "$CLASSPATH" org.apache.zookeeper.ZooKeeperMain -server localhost:$ZOOPORT ls / > /dev/null 2>&1 + if [ $? -ne 0 ] + then + # server not up yet - wait + sleep 1 + else + # server is up and serving client connections + success=true + break + fi + else + # server died - exit now + echo -n " ZooKeeper server process failed" + break + fi + done + + if $success + then + ## in case for debug, but generally don't use as it messes up the + ## console test output + echo -n " ZooKeeper server started" + else + echo -n " ZooKeeper server NOT started" + fi + + ;; +stop) + # Already killed above + ;; +*) + echo "Unknown command " + $1 + exit 2 +esac + diff --git a/src/contrib/build-contrib.xml b/src/contrib/build-contrib.xml new file mode 100644 index 0000000..276516e --- /dev/null +++ b/src/contrib/build-contrib.xml @@ -0,0 +1,248 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/contrib/build.xml b/src/contrib/build.xml new file mode 100644 index 0000000..7f7ba4f --- /dev/null +++ b/src/contrib/build.xml @@ -0,0 +1,88 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/contrib/fatjar/README.txt b/src/contrib/fatjar/README.txt new file mode 100644 index 0000000..f8027ae --- /dev/null +++ b/src/contrib/fatjar/README.txt @@ -0,0 +1,2 @@ +This package contains build to create a fat zookeeper jar. You need to run ant to create the fat jar. +To run the fatjar you can use. java -jar zoookeeper-*fatjar.jar diff --git a/src/contrib/fatjar/build.xml b/src/contrib/fatjar/build.xml new file mode 100644 index 0000000..8935f39 --- /dev/null +++ b/src/contrib/fatjar/build.xml @@ -0,0 +1,74 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/contrib/fatjar/conf/mainClasses b/src/contrib/fatjar/conf/mainClasses new file mode 100644 index 0000000..2b0fc83 --- /dev/null +++ b/src/contrib/fatjar/conf/mainClasses @@ -0,0 +1,10 @@ +::Client Commands +client:org.apache.zookeeper.ZooKeeperMain:Client shell to ZooKeeper +::Server Commands +server:org.apache.zookeeper.server.quorum.QuorumPeerMain:Start ZooKeeper server +::Test Commands +generateLoad:org.apache.zookeeper.test.system.GenerateLoad:A distributed load generator for testing +quorumBench:org.apache.zookeeper.server.QuorumBenchmark:A benchmark of just the quorum protocol +abBench:org.apache.zookeeper.server.quorum.AtomicBroadcastBenchmark:A benchmark of just the atomic broadcast +ic:org.apache.zookeeper.test.system.InstanceContainer:A container that will instantiate classes as directed by an instance manager +systest:org.apache.zookeeper.test.system.BaseSysTest:Start system test diff --git a/src/contrib/fatjar/src/java/org/apache/zookeeper/util/FatJarMain.java b/src/contrib/fatjar/src/java/org/apache/zookeeper/util/FatJarMain.java new file mode 100644 index 0000000..bdf0eae --- /dev/null +++ b/src/contrib/fatjar/src/java/org/apache/zookeeper/util/FatJarMain.java @@ -0,0 +1,126 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.zookeeper.util; + +import java.io.BufferedReader; +import java.io.IOException; +import java.io.InputStream; +import java.io.InputStreamReader; +import java.lang.reflect.InvocationTargetException; +import java.lang.reflect.Method; +import java.util.ArrayList; +import java.util.HashMap; + +/** + * This is a generic Main class that is completely driven by the + * /mainClasses resource on the class path. This resource has the + * format: + * 

+ * cmd:mainClass:Description
+ *
+ * Any lines starting with # will be skipped + * + */ +public class FatJarMain { + static class Cmd { + Cmd(String cmd, String clazz, String desc) { + this.cmd = cmd; + this.clazz = clazz; + this.desc = desc; + } + String cmd; + String clazz; + String desc; + } + static HashMap cmds = new HashMap(); + static ArrayList order = new ArrayList(); + + /** + * @param args the first parameter of args will be used as an + * index into the /mainClasses resource. The rest will be passed + * to the mainClass to run. + * @throws IOException + * @throws ClassNotFoundException + * @throws NoSuchMethodException + * @throws SecurityException + * @throws IllegalAccessException + * @throws IllegalArgumentException + */ + public static void main(String[] args) throws IOException, ClassNotFoundException, SecurityException, NoSuchMethodException, IllegalArgumentException, IllegalAccessException { + InputStream is = FatJarMain.class.getResourceAsStream("/mainClasses"); + if (is == null) { + System.err.println("Couldn't find /mainClasses in classpath."); + System.exit(3); + } + BufferedReader br = new BufferedReader(new InputStreamReader(is)); + String line; + while((line = br.readLine()) != null) { + String parts[] = line.split(":", 3); + if (parts.length != 3 || (parts[0].length() > 0 && parts[0].charAt(0) == '#')) { + continue; + } + if (parts[0].length() > 0) { + cmds.put(parts[0], new Cmd(parts[0], parts[1], parts[2])); + // We use the order array to preserve the order of the commands + // for help. The hashmap will not preserver order. (It may be overkill.) + order.add(parts[0]); + } else { + // Just put the description in + order.add(parts[2]); + } + } + if (args.length == 0) { + doHelp(); + return; + } + Cmd cmd = cmds.get(args[0]); + if (cmd == null) { + doHelp(); + return; + } + Class clazz = Class.forName(cmd.clazz); + Method main = clazz.getMethod("main", String[].class); + String newArgs[] = new String[args.length-1]; + System.arraycopy(args, 1, newArgs, 0, newArgs.length); + try { + main.invoke(null, (Object)newArgs); + } catch(InvocationTargetException e) { + if (e.getCause() != null) { + e.getCause().printStackTrace(); + } else { + e.printStackTrace(); + } + } + } + + private static void doHelp() { + System.err.println("USAGE: FatJarMain cmd args"); + System.err.println("Available cmds:"); + for(String c: order) { + Cmd cmd = cmds.get(c); + if (cmd != null) { + System.err.println(" " + c + " " + cmd.desc); + } else { + System.err.println(c); + } + } + System.exit(2); + } + +} diff --git a/src/contrib/huebrowser/README b/src/contrib/huebrowser/README new file mode 100644 index 0000000..c03ea90 --- /dev/null +++ b/src/contrib/huebrowser/README @@ -0,0 +1,62 @@ + +ZooKeeper Browser - Hue Application +=================================== + +The ZooKeeper Browser application allows you to see how the cluster nodes are working and also allows you to do CRUD operations on the znode hierarchy. + +Requirements +------------ + +Hue-1.0: + * http://github.com/downloads/cloudera/hue/hue-1.0.tgz + * http://github.com/downloads/cloudera/hue/release-notes-1.0.html + +ZooKeeper REST gateway: + * available as contrib: contrib/rest + +How to install? +--------------- + +First of all you need to install Hue 1.0 release: + + * http://archive.cloudera.com/cdh/3/hue/sdk/sdk.html + * http://github.com/cloudera/hue/tree/release-1.0 + +After you finish the previous step you should copy the zkui/ folder to apps/ and register the new application: + + * $ ./build/env/bin/python tools/app_reg/app_reg.py --install apps/zkui + * $ ./build/env/bin/python tools/app_reg/app_reg.py --list 2>&1 | grep zkui + zkui 0.1 /Users/philip/src/hue/apps/zkui + + +And restart the Hue application server. + +Configuration +------------- + +Edit zkui/src/zkui/settings.py: + +CLUSTERS = [{ + 'nice_name': 'Default', + 'hostport': 'localhost:2181,localhost:2182,localhost:2183', + 'rest_gateway': 'http://localhost:9998' + }, { + # ... and more clusters + } +] + +What is Hue? +------------ + +Wiki: http://wiki.github.com/cloudera/hue/ +Main Repo: http://github.com/cloudera/hue + +Hue is both a web UI for Hadoop and a framework to create interactive web applications. It features a FileBrowser for accessing HDFS, JobSub and JobBrowser applications for submitting and viewing MapReduce jobs, a Beeswax application for interacting with Hive. On top of that, the web frontend is mostly built from declarative widgets that require no JavaScript and are easy to learn. + +What is ZooKeeper? +------------------ + +http://zookeeper.apache.org/ + +ZooKeeper is a centralized service for maintaining configuration information, naming, providing distributed synchronization, and providing group services. All of these kinds of services are used in some form or another by distributed applications. Each time they are implemented there is a lot of work that goes into fixing the bugs and race conditions that are inevitable. Because of the difficulty of implementing these kinds of services, applications initially usually skimp on them ,which make them brittle in the presence of change and difficult to manage. Even when done correctly, different implementations of these services lead to management complexity when the applications are deployed. + diff --git a/src/contrib/huebrowser/zkui/Makefile b/src/contrib/huebrowser/zkui/Makefile new file mode 100644 index 0000000..9c22d1c --- /dev/null +++ b/src/contrib/huebrowser/zkui/Makefile @@ -0,0 +1,21 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +ifeq ($(ROOT),) + $(error "Error: Expect the environment variable $$ROOT to point to the Desktop installation") +endif + +include $(ROOT)/Makefile.sdk diff --git a/src/contrib/huebrowser/zkui/setup.py b/src/contrib/huebrowser/zkui/setup.py new file mode 100644 index 0000000..68d1352 --- /dev/null +++ b/src/contrib/huebrowser/zkui/setup.py @@ -0,0 +1,46 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +from setuptools import setup, find_packages +import os + +def expand_package_data(src_dirs, strip=""): + ret = [] + for src_dir in src_dirs: + for path, dnames, fnames in os.walk(src_dir): + for fname in fnames: + ret.append(os.path.join(path, fname).replace(strip, "")) + return ret + +os.chdir(os.path.dirname(os.path.abspath(__file__))) +setup( + name = "zkui", + version = "0.1", + url = 'http://zookeeper.apache.org/', + description = 'ZooKeeper Browser', + packages = find_packages('src'), + package_dir = {'': 'src'}, + install_requires = ['setuptools', 'desktop'], + entry_points = { 'desktop.sdk.application': 'zkui=zkui' }, + zip_safe = False, + package_data = { + # Include static resources. Package_data doesn't + # deal well with directory globs, so we enumerate + # the files manually. + 'zkui': expand_package_data( + ["src/zkui/templates", "src/zkui/static"], + "src/zkui/") + } +) diff --git a/src/contrib/huebrowser/zkui/src/zkui/__init__.py b/src/contrib/huebrowser/zkui/src/zkui/__init__.py new file mode 100644 index 0000000..eccc881 --- /dev/null +++ b/src/contrib/huebrowser/zkui/src/zkui/__init__.py @@ -0,0 +1,16 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + diff --git a/src/contrib/huebrowser/zkui/src/zkui/forms.py b/src/contrib/huebrowser/zkui/src/zkui/forms.py new file mode 100644 index 0000000..6b1f178 --- /dev/null +++ b/src/contrib/huebrowser/zkui/src/zkui/forms.py @@ -0,0 +1,29 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +from django import forms +from django.forms.widgets import Textarea, HiddenInput + +class CreateZNodeForm(forms.Form): + name = forms.CharField(max_length=64) + data = forms.CharField(required=False, widget=Textarea) + sequence = forms.BooleanField(required=False) + +class EditZNodeForm(forms.Form): + data = forms.CharField(required=False, widget=Textarea) + version = forms.IntegerField(required=False, widget=HiddenInput) + + diff --git a/src/contrib/huebrowser/zkui/src/zkui/models.py b/src/contrib/huebrowser/zkui/src/zkui/models.py new file mode 100644 index 0000000..a46696b --- /dev/null +++ b/src/contrib/huebrowser/zkui/src/zkui/models.py @@ -0,0 +1,17 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + + diff --git a/src/contrib/huebrowser/zkui/src/zkui/rest.py b/src/contrib/huebrowser/zkui/src/zkui/rest.py new file mode 100644 index 0000000..e4874a1 --- /dev/null +++ b/src/contrib/huebrowser/zkui/src/zkui/rest.py @@ -0,0 +1,230 @@ + +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +import urllib2 +import urllib +import simplejson + +from contextlib import contextmanager + +class RequestWithMethod(urllib2.Request): + """ Request class that know how to set the method name """ + def __init__(self, *args, **kwargs): + urllib2.Request.__init__(self, *args, **kwargs) + self._method = None + + def get_method(self): + return self._method or \ + urllib2.Request.get_method(self) + + def set_method(self, method): + self._method = method + +class ZooKeeper(object): + + class Error(Exception): pass + + class NotFound(Error): pass + + class ZNodeExists(Error): pass + + class InvalidSession(Error): pass + + class WrongVersion(Error): pass + + def __init__(self, uri = 'http://localhost:9998'): + self._base = uri + self._session = None + + def start_session(self, expire=5, id=None): + """ Create a session and return the ID """ + if id is None: + url = "%s/sessions/v1/?op=create&expire=%d" % (self._base, expire) + self._session = self._do_post(url)['id'] + else: + self._session = id + return self._session + + def close_session(self): + """ Close the session on the server """ + if self._session is not None: + url = '%s/sessions/v1/%s' % (self._base, self._session) + self._do_delete(url) + self._session = None + + def heartbeat(self): + """ Send a heartbeat request. This is needed in order to keep a session alive """ + if self._session is not None: + url = '%s/sessions/v1/%s' % (self._base, self._session) + self._do_put(url, '') + + @contextmanager + def session(self, *args, **kwargs): + """ Session handling using a context manager """ + yield self.start_session(*args, **kwargs) + self.close_session() + + def get(self, path): + """ Get a node """ + url = "%s/znodes/v1%s" % (self._base, path) + return self._do_get(url) + + def get_children(self, path): + """ Get all the children for a given path. This function creates a generator """ + for child_path in self.get_children_paths(path, uris=True): + try: + yield self._do_get(child_path) + except ZooKeeper.NotFound: + continue + + def get_children_paths(self, path, uris=False): + """ Get the paths for children nodes """ + url = "%s/znodes/v1%s?view=children" % (self._base, path) + resp = self._do_get(url) + for child in resp.get('children', []): + yield child if not uris else resp['child_uri_template']\ + .replace('{child}', urllib2.quote(child)) + + def create(self, path, data=None, sequence=False, ephemeral=False): + """ Create a new node. By default this call creates a persistent znode. + + You can also create an ephemeral or a sequential znode. + """ + ri = path.rindex('/') + head, name = path[:ri+1], path[ri+1:] + if head != '/': head = head[:-1] + + flags = { + 'null': 'true' if data is None else 'false', + 'ephemeral': 'true' if ephemeral else 'false', + 'sequence': 'true' if sequence else 'false' + } + if ephemeral: + if self._session: + flags['session'] = self._session + else: + raise ZooKeeper.Error, 'You need a session '\ + 'to create an ephemeral node' + flags = urllib.urlencode(flags) + + url = "%s/znodes/v1%s?op=create&name=%s&%s" % \ + (self._base, head, name, flags) + + return self._do_post(url, data) + + def set(self, path, data=None, version=-1, null=False): + """ Set the value of node """ + url = "%s/znodes/v1%s?%s" % (self._base, path, \ + urllib.urlencode({ + 'version': version, + 'null': 'true' if null else 'false' + })) + return self._do_put(url, data) + + def delete(self, path, version=-1): + """ Delete a znode """ + if type(path) is list: + map(lambda el: self.delete(el, version), path) + return + + url = '%s/znodes/v1%s?%s' % (self._base, path, \ + urllib.urlencode({ + 'version':version + })) + try: + return self._do_delete(url) + except urllib2.HTTPError, e: + if e.code == 412: + raise ZooKeeper.WrongVersion(path) + elif e.code == 404: + raise ZooKeeper.NotFound(path) + raise + + def recursive_delete(self, path): + """ Delete all the nodes from the tree """ + for child in self.get_children_paths(path): + fp = ("%s/%s" % (path, child)).replace('//', '/') + self.recursive_delete(fp) + self.delete(path) + + def exists(self, path): + """ Do a znode exists """ + try: + self.get(path) + return True + except ZooKeeper.NotFound: + return False + + def _do_get(self, uri): + """ Send a GET request and convert errors to exceptions """ + try: + req = urllib2.urlopen(uri) + resp = simplejson.load(req) + + if 'Error' in resp: + raise ZooKeeper.Error(resp['Error']) + + return resp + except urllib2.HTTPError, e: + if e.code == 404: + raise ZooKeeper.NotFound(uri) + raise + + def _do_post(self, uri, data=None): + """ Send a POST request and convert errors to exceptions """ + try: + req = urllib2.Request(uri, {}) + req.add_header('Content-Type', 'application/octet-stream') + if data is not None: + req.add_data(data) + + resp = simplejson.load(urllib2.urlopen(req)) + if 'Error' in resp: + raise ZooKeeper.Error(resp['Error']) + return resp + + except urllib2.HTTPError, e: + if e.code == 201: + return True + elif e.code == 409: + raise ZooKeeper.ZNodeExists(uri) + elif e.code == 401: + raise ZooKeeper.InvalidSession(uri) + raise + + def _do_delete(self, uri): + """ Send a DELETE request """ + req = RequestWithMethod(uri) + req.set_method('DELETE') + req.add_header('Content-Type', 'application/octet-stream') + return urllib2.urlopen(req).read() + + def _do_put(self, uri, data): + """ Send a PUT request """ + try: + req = RequestWithMethod(uri) + req.set_method('PUT') + req.add_header('Content-Type', 'application/octet-stream') + if data is not None: + req.add_data(data) + + return urllib2.urlopen(req).read() + except urllib2.HTTPError, e: + if e.code == 412: # precondition failed + raise ZooKeeper.WrongVersion(uri) + raise + diff --git a/src/contrib/huebrowser/zkui/src/zkui/settings.py b/src/contrib/huebrowser/zkui/src/zkui/settings.py new file mode 100644 index 0000000..844c695 --- /dev/null +++ b/src/contrib/huebrowser/zkui/src/zkui/settings.py @@ -0,0 +1,30 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +DJANGO_APPS = [ "zkui" ] +NICE_NAME = "ZooKeeper Browser" +REQUIRES_HADOOP = False + +CLUSTERS = [{ + 'nice_name': 'Default', + 'hostport': 'localhost:2181,localhost:2182,localhost:2183', + 'rest_gateway': 'http://localhost:9998' + } +] + +DEPENDER_PACKAGE_YMLS = [ + "src/zkui/static/js/package.yml", +] diff --git a/src/contrib/huebrowser/zkui/src/zkui/static/art/line_icons.png b/src/contrib/huebrowser/zkui/src/zkui/static/art/line_icons.png new file mode 100644 index 0000000000000000000000000000000000000000..1da4a294b34c5bcfe27ce676c85a2f363bab95c7 GIT binary patch literal 7499 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 UeFd$x$^ZZW07*qoM6N<$f+d!kO#lD@ literal 0 HcmV?d00001 diff --git a/src/contrib/huebrowser/zkui/src/zkui/static/bootstrap.js b/src/contrib/huebrowser/zkui/src/zkui/static/bootstrap.js new file mode 100644 index 0000000..8e3fbfb --- /dev/null +++ b/src/contrib/huebrowser/zkui/src/zkui/static/bootstrap.js @@ -0,0 +1,32 @@ +// Licensed to the Apache Software Foundation (ASF) under one +// or more contributor license agreements. See the NOTICE file +// distributed with this work for additional information +// regarding copyright ownership. The ASF licenses this file +// to you under the Apache License, Version 2.0 (the +// "License"); you may not use this file except in compliance +// with the License. You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +CCS.Desktop.register({ + Zkui : { + name : 'ZooKeeper Browser', + css : '/zkui/static/css/zkui.css', + require: [ 'Zkui' ], + launch: function(path, options){ + return new Zkui(path || '/zkui/', options); + }, + menu: { + id: 'ccs-zkui-menu', + img: { + src: '/zkui/static/art/zkui.png' + } + }, + help: '/help/zkui/' + } +}); diff --git a/src/contrib/huebrowser/zkui/src/zkui/static/css/zkui.css b/src/contrib/huebrowser/zkui/src/zkui/static/css/zkui.css new file mode 100644 index 0000000..c49f392 --- /dev/null +++ b/src/contrib/huebrowser/zkui/src/zkui/static/css/zkui.css @@ -0,0 +1,56 @@ +/* + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +*/ + +.zkui img.zkui_icon { + width: 55px; + height: 55px; + position: absolute; + top: 27px; + left: 3px; +} + +div.zkui .left_col li { + margin: 5px 0px; + font-size: 16px; + background-color: white; + color: black; + padding: 2px 1px 1px 5px; + -moz-border-radius: 3px; + -webkit-border-radius: 3px; + border: solid black 1px; +} + +div.zkui .left_col li:hover { + background-color: lightBlue; + color: white; +} + +div.zkui .left_col li a { + color: black; + display: block; +} + +div.zkui .left_col li a:hover { + text-decoration: none; +} + +div.zkui .createZnodeForm td, +div.zkui .editZnodeForm td { + padding: 5px; +} + diff --git a/src/contrib/huebrowser/zkui/src/zkui/static/help/index.html b/src/contrib/huebrowser/zkui/src/zkui/static/help/index.html new file mode 100644 index 0000000..355c8cd --- /dev/null +++ b/src/contrib/huebrowser/zkui/src/zkui/static/help/index.html @@ -0,0 +1,26 @@ + + +

ZooKeeper Browser

+ + +

ZooKeeper is a centralized service for maintaining configuration information, naming, providing distributed synchronization, and providing group services

+ +

About

+ +

The ZooKeeper Browser application allows you to see how the cluster nodes are working and also allows you to do CRUD operations on the znode hierarchy.

+ diff --git a/src/contrib/huebrowser/zkui/src/zkui/static/js/Source/Zkui/Zkui.js b/src/contrib/huebrowser/zkui/src/zkui/static/js/Source/Zkui/Zkui.js new file mode 100644 index 0000000..c8bf383 --- /dev/null +++ b/src/contrib/huebrowser/zkui/src/zkui/static/js/Source/Zkui/Zkui.js @@ -0,0 +1,50 @@ +// Licensed to the Apache Software Foundation (ASF) under one +// or more contributor license agreements. See the NOTICE file +// distributed with this work for additional information +// regarding copyright ownership. The ASF licenses this file +// to you under the Apache License, Version 2.0 (the +// "License"); you may not use this file except in compliance +// with the License. You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +/* +--- + +script: Zkui.js + +description: Defines Zkui; a Hue application that extends CCS.JBrowser. + +authors: +- Unknown + +requires: +- ccs-shared/CCS.JBrowser + +provides: [Zkui] + +... +*/ +ART.Sheet.define('window.art.browser.zkui', { + 'min-width': 620 +}); + +var Zkui = new Class({ + + Extends: CCS.JBrowser, + + options: { + className: 'art browser logo_header zkui' + }, + + initialize: function(path, options){ + this.parent(path || '/zkui/', options); + } + +}); diff --git a/src/contrib/huebrowser/zkui/src/zkui/static/js/package.yml b/src/contrib/huebrowser/zkui/src/zkui/static/js/package.yml new file mode 100644 index 0000000..c2c07ad --- /dev/null +++ b/src/contrib/huebrowser/zkui/src/zkui/static/js/package.yml @@ -0,0 +1,19 @@ +# Licensed to the Apache Software Foundation (ASF) under one or more +# contributor license agreements. See the NOTICE file distributed with +# this work for additional information regarding copyright ownership. +# The ASF licenses this file to You under the Apache License, Version 2.0 +# (the "License"); you may not use this file except in compliance with +# the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +copyright: Apache License v2.0 +version: 0.1 +description: ZooKeeper Browser +name: ZooKeeper Browser +sources: [Source/Zkui/Zkui.js] diff --git a/src/contrib/huebrowser/zkui/src/zkui/stats.py b/src/contrib/huebrowser/zkui/src/zkui/stats.py new file mode 100644 index 0000000..48f35dd --- /dev/null +++ b/src/contrib/huebrowser/zkui/src/zkui/stats.py @@ -0,0 +1,170 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +import socket +import re + +from StringIO import StringIO + +class Session(object): + + class BrokenLine(Exception): pass + + def __init__(self, session): + m = re.search('/(\d+\.\d+\.\d+\.\d+):(\d+)\[(\d+)\]\((.*)\)', session) + if m: + self.host = m.group(1) + self.port = m.group(2) + self.interest_ops = m.group(3) + for d in m.group(4).split(","): + k,v = d.split("=") + self.__dict__[k] = v + else: + raise Session.BrokenLine() + +class ZooKeeperStats(object): + + def __init__(self, host='localhost', port='2181', timeout=1): + self._address = (host, int(port)) + self._timeout = timeout + + def get_stats(self): + """ Get ZooKeeper server stats as a map """ + data = self._send_cmd('mntr') + if data: + return self._parse(data) + else: + data = self._send_cmd('stat') + return self._parse_stat(data) + + def get_clients(self): + """ Get ZooKeeper server clients """ + clients = [] + + stat = self._send_cmd('stat') + if not stat: + return clients + + sio = StringIO(stat) + + #skip two lines + sio.readline() + sio.readline() + + for line in sio: + if not line.strip(): + break + try: + clients.append(Session(line.strip())) + except Session.BrokenLine: + continue + + return clients + + def _create_socket(self): + return socket.socket() + + def _send_cmd(self, cmd): + """ Send a 4letter word command to the server """ + s = self._create_socket() + s.settimeout(self._timeout) + + s.connect(self._address) + s.send(cmd) + + data = s.recv(2048) + s.close() + + return data + + def _parse(self, data): + """ Parse the output from the 'mntr' 4letter word command """ + h = StringIO(data) + + result = {} + for line in h.readlines(): + try: + key, value = self._parse_line(line) + result[key] = value + except ValueError: + pass # ignore broken lines + + return result + + def _parse_stat(self, data): + """ Parse the output from the 'stat' 4letter word command """ + h = StringIO(data) + + result = {} + + version = h.readline() + if version: + result['zk_version'] = version[version.index(':')+1:].strip() + + # skip all lines until we find the empty one + while h.readline().strip(): pass + + for line in h.readlines(): + m = re.match('Latency min/avg/max: (\d+)/(\d+)/(\d+)', line) + if m is not None: + result['zk_min_latency'] = int(m.group(1)) + result['zk_avg_latency'] = int(m.group(2)) + result['zk_max_latency'] = int(m.group(3)) + continue + + m = re.match('Received: (\d+)', line) + if m is not None: + result['zk_packets_received'] = int(m.group(1)) + continue + + m = re.match('Sent: (\d+)', line) + if m is not None: + result['zk_packets_sent'] = int(m.group(1)) + continue + + m = re.match('Outstanding: (\d+)', line) + if m is not None: + result['zk_outstanding_requests'] = int(m.group(1)) + continue + + m = re.match('Mode: (.*)', line) + if m is not None: + result['zk_server_state'] = m.group(1) + continue + + m = re.match('Node count: (\d+)', line) + if m is not None: + result['zk_znode_count'] = int(m.group(1)) + continue + + return result + + def _parse_line(self, line): + try: + key, value = map(str.strip, line.split('\t')) + except ValueError: + raise ValueError('Found invalid line: %s' % line) + + if not key: + raise ValueError('The key is mandatory and should not be empty') + + try: + value = int(value) + except (TypeError, ValueError): + pass + + return key, value + diff --git a/src/contrib/huebrowser/zkui/src/zkui/templates/clients.mako b/src/contrib/huebrowser/zkui/src/zkui/templates/clients.mako new file mode 100644 index 0000000..2bee9a7 --- /dev/null +++ b/src/contrib/huebrowser/zkui/src/zkui/templates/clients.mako @@ -0,0 +1,51 @@ +<%! +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +%> + +<%namespace name="shared" file="shared_components.mako" /> + +${shared.header("ZooKeeper Browser > Clients > %s:%s" % (host, port))} + +

${host}:${port} :: client connections

+
+ +% if clients: + + + + + + + + + + + % for client in clients: + + + + + + + + + % endfor +
HostPortInterest OpsQueuedReceivedSent
${client.host}${client.port}${client.interest_ops}${client.queued}${client.recved}${client.sent}
+% endif + +${shared.footer()} + diff --git a/src/contrib/huebrowser/zkui/src/zkui/templates/create.mako b/src/contrib/huebrowser/zkui/src/zkui/templates/create.mako new file mode 100644 index 0000000..2a8b8cc --- /dev/null +++ b/src/contrib/huebrowser/zkui/src/zkui/templates/create.mako @@ -0,0 +1,34 @@ +<%! +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +%> +<%namespace name="shared" file="shared_components.mako" /> + +${shared.header("ZooKeeper Browser > Create Znode")} + +

Create New Znode :: ${path}

+

+ +
+ + ${form.as_table()|n} + +
+ +
+
+ +${shared.footer()} diff --git a/src/contrib/huebrowser/zkui/src/zkui/templates/edit.mako b/src/contrib/huebrowser/zkui/src/zkui/templates/edit.mako new file mode 100644 index 0000000..997bd07 --- /dev/null +++ b/src/contrib/huebrowser/zkui/src/zkui/templates/edit.mako @@ -0,0 +1,34 @@ +<%! +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +%> +<%namespace name="shared" file="shared_components.mako" /> + +${shared.header("ZooKeeper Browser > Edit Znode > %s" % path)} + +

Edit Znode Data :: ${path}

+

+ +
+ + ${form.as_table()|n} + +
+ +
+
+ +${shared.footer()} diff --git a/src/contrib/huebrowser/zkui/src/zkui/templates/index.mako b/src/contrib/huebrowser/zkui/src/zkui/templates/index.mako new file mode 100644 index 0000000..567919d --- /dev/null +++ b/src/contrib/huebrowser/zkui/src/zkui/templates/index.mako @@ -0,0 +1,54 @@ +<%! +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +%> +<%namespace name="shared" file="shared_components.mako" /> + +${shared.header("ZooKeeper Browser")} + +

Overview

+ +
+ +% for i, c in enumerate(overview): +

${i+1}. ${c['nice_name']} Cluster Overview


+ + + + + + + + + + + + % for host, stats in c['stats'].items(): + + + + + + + + % endfor +
NodeRoleAvg LatencyWatch CountVersion
${host}${stats.get('zk_server_state', '')}${stats.get('zk_avg_latency', '')}${stats.get('zk_watch_count', '')}${stats.get('zk_version', '')}
+ +

+% endfor + +${shared.footer()} + diff --git a/src/contrib/huebrowser/zkui/src/zkui/templates/shared_components.mako b/src/contrib/huebrowser/zkui/src/zkui/templates/shared_components.mako new file mode 100644 index 0000000..f9a4589 --- /dev/null +++ b/src/contrib/huebrowser/zkui/src/zkui/templates/shared_components.mako @@ -0,0 +1,66 @@ +<%! +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +%> + +<%! +import datetime +from django.template.defaultfilters import urlencode, escape +from zkui import settings +%> + +<%def name="header(title='ZooKeeper Browser', toolbar=True)"> + + + + ${title} + + + % if toolbar: +
+ +
+ % endif + +
+
+ +
+ +

Clusters

+ +
+ +
+ + +<%def name="info_button(url, text)"> + ${text} + + +<%def name="footer()"> +
+
+ + + diff --git a/src/contrib/huebrowser/zkui/src/zkui/templates/tree.mako b/src/contrib/huebrowser/zkui/src/zkui/templates/tree.mako new file mode 100644 index 0000000..c74c202 --- /dev/null +++ b/src/contrib/huebrowser/zkui/src/zkui/templates/tree.mako @@ -0,0 +1,75 @@ +<%! +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +%> +<%namespace name="shared" file="shared_components.mako" /> + +${shared.header("ZooKeeper Browser > Tree > %s > %s" % (cluster['nice_name'], path))} + +

${cluster['nice_name'].lower()} :: ${path}

+
+ + + + + + % for child in children: + + % endfor +
Children
+ + ${child} + + Delete +
+
+ + ${shared.info_button(url('zkui.views.create', id=cluster['id'], path=path), 'Create New')} + + +
+ +

data :: base64 :: length :: ${znode.get('dataLength', 0)}

+
+ + +
+ + ${shared.info_button(url('zkui.views.edit_as_base64', id=cluster['id'], path=path), 'Edit as Base64')} + ${shared.info_button(url('zkui.views.edit_as_text', id=cluster['id'], path=path), 'Edit as Text')} + +
+
+ +

stat information

+
+ + + + + % for key in ('pzxid', 'ctime', 'aversion', 'mzxid', \ + 'ephemeralOwner', 'version', 'mtime', 'cversion', 'czxid'): + + % endfor +
KeyValue
${key}${znode[key]}
+ +
+Details on stat information. + +${shared.footer()} + diff --git a/src/contrib/huebrowser/zkui/src/zkui/templates/view.mako b/src/contrib/huebrowser/zkui/src/zkui/templates/view.mako new file mode 100644 index 0000000..e046afc --- /dev/null +++ b/src/contrib/huebrowser/zkui/src/zkui/templates/view.mako @@ -0,0 +1,128 @@ +<%! +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +%> +<%namespace name="shared" file="shared_components.mako" /> + +${shared.header("ZooKeeper Browser > %s" % cluster['nice_name'])} + +<%def name="show_stats(stats)"> + + Key + Value + + + Version + ${stats.get('zk_version')} + + + Latency + Min: ${stats.get('zk_min_latency', '')} + Avg: ${stats.get('zk_avg_latency', '')} + Max: ${stats.get('zk_max_latency', '')} + + + Packets + Sent: ${stats.get('zk_packets_sent', '')} + Received: ${stats.get('zk_packets_received', '')} + + + + Outstanding Requests + ${stats.get('zk_outstanding_requests', '')} + + + Watch Count + ${stats.get('zk_watch_count', '')} + + + Open FD Count + ${stats.get('zk_open_file_descriptor_count', '')} + + + Max FD Count + ${stats.get('zk_max_file_descriptor_count', '')} + + + + +

${cluster['nice_name']} Cluster Overview

+ +${shared.info_button(url('zkui.views.tree', id=cluster['id'], path='/'), 'View Znode Hierarchy')} + +

+ +% if leader: +

General

+ + + + + + + + + + + + + + + +
KeyValue
ZNode Count${leader.get('zk_znode_count', '')}
Ephemerals Count${leader.get('zk_ephemerals_count', '')}
Approximate Data Size${leader.get('zk_approximate_data_size', '')} bytes
+

+% endif + +% if leader: +

node :: ${leader['host']} :: leader

+ + ${shared.info_button(url('zkui.views.clients', host=leader['host']), 'View Client Connections')} + +

+ + ${show_stats(leader)} + + + + + + + + + + + + + +
Followers${leader.get('zk_followers', '')}
Synced Followers${leader.get('zk_synced_followers', '')}
Pending Syncs${leader.get('zk_pending_syncs', '')}
+

+% endif + +% for stats in followers: +

node :: ${stats['host']} :: follower

+
+ + ${shared.info_button(url('zkui.views.clients', host=stats['host']), 'View Client Connections')} + +

+ + ${show_stats(stats)} +
+

+% endfor + +${shared.footer()} + diff --git a/src/contrib/huebrowser/zkui/src/zkui/urls.py b/src/contrib/huebrowser/zkui/src/zkui/urls.py new file mode 100644 index 0000000..f795f7e --- /dev/null +++ b/src/contrib/huebrowser/zkui/src/zkui/urls.py @@ -0,0 +1,28 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +from django.conf.urls.defaults import patterns, url + +urlpatterns = patterns('zkui', + url(r'^$', 'views.index'), + url(r'view/(?P\d+)$', 'views.view'), + url(r'clients/(?P.+)$', 'views.clients'), + url(r'tree/(?P\d+)(?P.+)$', 'views.tree'), + url(r'create/(?P\d+)(?P.*)$', 'views.create'), + url(r'delete/(?P\d+)(?P.*)$', 'views.delete'), + url(r'edit/base64/(?P\d+)(?P.*)$', 'views.edit_as_base64'), + url(r'edit/text/(?P\d+)(?P.*)$', 'views.edit_as_text') +) diff --git a/src/contrib/huebrowser/zkui/src/zkui/utils.py b/src/contrib/huebrowser/zkui/src/zkui/utils.py new file mode 100644 index 0000000..fb01317 --- /dev/null +++ b/src/contrib/huebrowser/zkui/src/zkui/utils.py @@ -0,0 +1,33 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +from zkui import settings + +from django.http import Http404 + +def get_cluster_or_404(id): + try: + id = int(id) + if not (0 <= id < len(settings.CLUSTERS)): + raise ValueError, 'Undefined cluster id.' + except (TypeError, ValueError): + raise Http404() + + cluster = settings.CLUSTERS[id] + cluster['id'] = id + + return cluster + diff --git a/src/contrib/huebrowser/zkui/src/zkui/views.py b/src/contrib/huebrowser/zkui/src/zkui/views.py new file mode 100644 index 0000000..64d926b --- /dev/null +++ b/src/contrib/huebrowser/zkui/src/zkui/views.py @@ -0,0 +1,165 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +from desktop.lib.django_util import render +from django.http import Http404 + +from zkui import settings +from zkui.stats import ZooKeeperStats +from zkui.rest import ZooKeeper +from zkui.utils import get_cluster_or_404 +from zkui.forms import CreateZNodeForm, EditZNodeForm + +def _get_global_overview(): + overview = [] + for c in settings.CLUSTERS: + overview.append(_get_overview(c)) + return overview + +def _get_overview(cluster): + stats = {} + for s in cluster['hostport'].split(','): + host, port = map(str.strip, s.split(':')) + + zks = ZooKeeperStats(host, port) + stats[s] = zks.get_stats() or {} + + cluster['stats'] = stats + return cluster + +def _group_stats_by_role(cluster): + leader, followers = None, [] + for host, stats in cluster['stats'].items(): + stats['host'] = host + + if stats.get('zk_server_state') == 'leader': + leader = stats + + elif stats.get('zk_server_state') == 'follower': + followers.append(stats) + + return leader, followers + +def index(request): + overview = _get_global_overview() + return render('index.mako', request, + dict(overview=overview)) + +def view(request, id): + cluster = get_cluster_or_404(id) + + cluster = _get_overview(cluster) + leader, followers = _group_stats_by_role(cluster) + + return render('view.mako', request, + dict(cluster=cluster, leader=leader, followers=followers)) + +def clients(request, host): + parts = host.split(':') + if len(parts) != 2: + raise Http404 + + host, port = parts + zks = ZooKeeperStats(host, port) + clients = zks.get_clients() + + return render('clients.mako', request, + dict(host=host, port=port, clients=clients)) + +def tree(request, id, path): + cluster = get_cluster_or_404(id) + zk = ZooKeeper(cluster['rest_gateway']) + + znode = zk.get(path) + children = sorted(zk.get_children_paths(path)) + + return render('tree.mako', request, + dict(cluster=cluster, path=path, \ + znode=znode, children=children)) + +def delete(request, id, path): + cluster = get_cluster_or_404(id) + if request.method == 'POST': + zk = ZooKeeper(cluster['rest_gateway']) + try: + zk.recursive_delete(path) + except ZooKeeper.NotFound: + pass + + return tree(request, id, path[:path.rindex('/')] or '/') + +def create(request, id, path): + cluster = get_cluster_or_404(id) + + if request.method == 'POST': + form = CreateZNodeForm(request.POST) + if form.is_valid(): + zk = ZooKeeper(cluster['rest_gateway']) + + full_path = ("%s/%s" % (path, form.cleaned_data['name']))\ + .replace('//', '/') + + zk.create(full_path, \ + form.cleaned_data['data'], \ + sequence = form.cleaned_data['sequence']) + return tree(request, id, path) + else: + form = CreateZNodeForm() + + return render('create.mako', request, + dict(path=path, form=form)) + +def edit_as_base64(request, id, path): + cluster = get_cluster_or_404(id) + zk = ZooKeeper(cluster['rest_gateway']) + node = zk.get(path) + + if request.method == 'POST': + form = EditZNodeForm(request.POST) + if form.is_valid(): + # TODO is valid base64 string? + data = form.cleaned_data['data'].decode('base64') + zk.set(path, data, form.cleaned_data['version']) + + return tree(request, id, path) + else: + form = EditZNodeForm(dict(\ + data=node.get('data64', ''), + version=node.get('version', '-1'))) + + return render('edit.mako', request, + dict(path=path, form=form)) + +def edit_as_text(request, id, path): + cluster = get_cluster_or_404(id) + zk = ZooKeeper(cluster['rest_gateway']) + node = zk.get(path) + + if request.method == 'POST': + form = EditZNodeForm(request.POST) + if form.is_valid(): + zk.set(path, form.cleaned_data['data']) + + return tree(request, id, path) + else: + form = EditZNodeForm(dict(data=node.get('data64', '')\ + .decode('base64').strip(), + version=node.get('version', '-1'))) + + return render('edit.mako', request, + dict(path=path, form=form)) + + diff --git a/src/contrib/huebrowser/zkui/src/zkui/windmilltests.py b/src/contrib/huebrowser/zkui/src/zkui/windmilltests.py new file mode 100644 index 0000000..ba44e26 --- /dev/null +++ b/src/contrib/huebrowser/zkui/src/zkui/windmilltests.py @@ -0,0 +1,23 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +from desktop.lib.windmill_util import logged_in_client + +def test_zkui(): + """ launches the default view for zkui """ + client = logged_in_client() + client.click(id='ccs-zkui-menu') + client.waits.forElement(classname='CCS-ZKUI', timeout='2000') diff --git a/src/contrib/loggraph/README.txt b/src/contrib/loggraph/README.txt new file mode 100644 index 0000000..1865fa5 --- /dev/null +++ b/src/contrib/loggraph/README.txt @@ -0,0 +1,69 @@ +LogGraph README + +1 - About +LogGraph is an application for viewing and filtering zookeeper logs. It can handle transaction logs and message logs. + +2 - Compiling + +Run "ant jar" in src/contrib/loggraph/. This will download all dependencies and compile all the loggraph code. + +Once compilation has finished, you can run it the the loggraph.sh script in src/contrib/loggraph/bin. This will start and embedded web server on your machine. +Navigate to http://localhost:8182/graph/main.html + +3 - Usage +LogGraph presents the user with 4 views, + + a) Simple log view + This view simply displays the log text. This isn't very useful without filters (see "Filtering the logs"). + + b) Server view + The server view shows the interactions between the different servers in an ensemble. The X axis represents time. + * Exceptions show up as red dots. Hovering your mouse over them will give you more details of the exception + * The colour of the line represents the election state of the server. + - orange means LOOKING for leader + - dark green means the server is the leader + - light green means the server is following a leader + - yellow means there isn't enough information to determine the state of the server. + * The gray arrows denote election messages between servers. Pink dashed arrows are messages that were sent but never delivered. + + c) Session view + The session view shows the lifetime of sessions on a server. Use the time filter to narrow down the view. Any more than about 2000 events will take a long time to view in your browser. + The X axis represents time. Each line is a session. The black dots represent events on the session. You can click on the black dots for more details of the event. + + d) Stats view + There is currently only one statistics view, Transactions/minute. Suggestions for other statistic views are very welcome. + +4 - Filtering the logs +The logs can be filtered in 2 ways, by time and by content. + +To filter by time simply move the slider to the desired start time. The time window specifies how many milliseconds after and including the start time will be displayed. + +Content filtering uses a adhoc filtering language, using prefix notation. The language looks somewhat similar to lisp. A statement in the language takes the form (op arg arg ....). A statement resolves to a boolean value. Statements can be nested. + +4.1 - Filter arguments +An argument can be a number, a string or a symbol. A number is any argument which starts with -, + or 0 to 9. If the number starts with 0x it is interpretted as hexidecimal. Otherwise it is interpretted as decimal. If the argument begins with a double-quote, (") it is interpretted as a string. Anything else is interpretted as a symbol. + +4.2 - Filter symbols +The possible filter symbols are: + +client-id : number, the session id of the client who initiated a transaction. +cxid : number, the cxid of a transaction +zxid : number, the zxid of a transaction +operation : string, the operation being performed, for example "setData", "createSession", "closeSession", "error", "create" + +4.3 - Filter operations +The possible filter operations are: + +or : logical or, takes 1 or more arguments which must be other statements. +and : logical and, takes 1 or more arguments which must be other statements. +not : logical not, takes 1 argument which must be another statement. +xor : exclusive or, takes 1 or more arguments which must be other statements. += : equals, takes 1 or more arguments, which must all be equal to each other to return true. +> : greater than, takes 1 or more arguments, to return true the 1st argument must be greater than the 2nd argument which must be greater than the 3rd argument and so on... +< : less than, takes 1 or more arguments, to return true the 1st argument must be less than the 2nd argument which must be less than the 3rd argument and so on... + +4.3 - Filter examples +Give me all the setData operations with session id 0xdeadbeef or 0xcafeb33r but not with zxid 0x12341234 -> + +(and (= operation "setData") (or (= client-id 0xdeadbeef) (= client-id 0xcafeb33r)) (not (= zxid 0x12341234))) + diff --git a/src/contrib/loggraph/bin/loggraph-dev.sh b/src/contrib/loggraph/bin/loggraph-dev.sh new file mode 100644 index 0000000..0b82efa --- /dev/null +++ b/src/contrib/loggraph/bin/loggraph-dev.sh @@ -0,0 +1,43 @@ +#!/bin/sh + +# Licensed to the Apache Software Foundation (ASF) under one or more +# contributor license agreements. See the NOTICE file distributed with +# this work for additional information regarding copyright ownership. +# The ASF licenses this file to You under the Apache License, Version 2.0 +# (the "License"); you may not use this file except in compliance with +# the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +make_canonical () { + cd $1; pwd; +} + +SCRIPTDIR=`dirname $0` +BUILDDIR=`make_canonical $SCRIPTDIR/../../../../build/contrib/loggraph` +LIBDIR=`make_canonical $BUILDDIR/lib` +WEBDIR=`make_canonical $SCRIPTDIR/../web` +ZKDIR=`make_canonical $SCRIPTDIR/../../../../build/` + +if [ ! -x $BUILDDIR ]; then + echo "\n\n*** You need to build loggraph before running it ***\n\n"; + exit; +fi + +for i in `ls $LIBDIR`; do + CLASSPATH=$LIBDIR/$i:$CLASSPATH +done + +for i in $ZKDIR/zookeeper-*.jar; do + CLASSPATH="$i:$CLASSPATH" +done + +CLASSPATH=$BUILDDIR/classes:$WEBDIR:$CLASSPATH +echo $CLASSPATH +java -Dlog4j.configuration=org/apache/zookeeper/graph/log4j.properties -Xdebug -Xrunjdwp:transport=dt_socket,address=4444,server=y,suspend=n -cp $CLASSPATH org.apache.zookeeper.graph.LogServer $* diff --git a/src/contrib/loggraph/bin/loggraph.sh b/src/contrib/loggraph/bin/loggraph.sh new file mode 100644 index 0000000..381e5ad --- /dev/null +++ b/src/contrib/loggraph/bin/loggraph.sh @@ -0,0 +1,48 @@ +#!/bin/sh + +# Licensed to the Apache Software Foundation (ASF) under one or more +# contributor license agreements. See the NOTICE file distributed with +# this work for additional information regarding copyright ownership. +# The ASF licenses this file to You under the Apache License, Version 2.0 +# (the "License"); you may not use this file except in compliance with +# the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +make_canonical () { + cd $1; pwd; +} + +SCRIPTDIR=`dirname $0` +BUILDDIR=`make_canonical $SCRIPTDIR/../../../../build/contrib/loggraph` +LIBDIR=`make_canonical $BUILDDIR/lib` +ZKDIR=`make_canonical $SCRIPTDIR/../../../../build/` + +if [ ! -x $BUILDDIR ]; then + echo "\n\n*** You need to build loggraph before running it ***\n\n"; + exit; +fi + +for i in `ls $LIBDIR`; do + CLASSPATH=$LIBDIR/$i:$CLASSPATH +done + +for i in `ls $BUILDDIR/*.jar`; do + CLASSPATH=$i:$CLASSPATH +done + +for i in $ZKDIR/zookeeper-*.jar; do + CLASSPATH="$i:$CLASSPATH" +done + +java -cp $CLASSPATH org.apache.zookeeper.graph.LogServer $* + + + + diff --git a/src/contrib/loggraph/build.xml b/src/contrib/loggraph/build.xml new file mode 100644 index 0000000..5be6970 --- /dev/null +++ b/src/contrib/loggraph/build.xml @@ -0,0 +1,70 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/contrib/loggraph/ivy.xml b/src/contrib/loggraph/ivy.xml new file mode 100644 index 0000000..d6fa9d6 --- /dev/null +++ b/src/contrib/loggraph/ivy.xml @@ -0,0 +1,44 @@ + + + + + + + + ZooKeeper Graphing + + + + + + + + + + + + + + + + + + + diff --git a/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/FilterException.java b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/FilterException.java new file mode 100644 index 0000000..c0912fa --- /dev/null +++ b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/FilterException.java @@ -0,0 +1,22 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.graph; + +public class FilterException extends Exception { + public FilterException(String s) { super(s); } +}; diff --git a/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/FilterOp.java b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/FilterOp.java new file mode 100644 index 0000000..ee73283 --- /dev/null +++ b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/FilterOp.java @@ -0,0 +1,75 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.graph; + +import java.util.ArrayList; +import org.apache.zookeeper.graph.filterops.*; + +public abstract class FilterOp { + protected ArrayList subOps; + protected ArrayList args; + + public enum ArgType { + STRING, NUMBER, SYMBOL + } + + public FilterOp() { + subOps = new ArrayList(); + args = new ArrayList(); + } + + public static FilterOp newOp(String op) throws FilterException { + if (op.equals("or")) + return new OrOp(); + if (op.equals("and")) + return new AndOp(); + if (op.equals("not")) + return new NotOp(); + if (op.equals("xor")) + return new XorOp(); + if (op.equals("=")) + return new EqualsOp(); + if (op.equals("<")) + return new LessThanOp(); + if (op.equals(">")) + return new GreaterThanOp(); + + throw new FilterException("Invalid operation '"+op+"'"); + } + + public void addSubOp(FilterOp op) { + subOps.add(op); + } + + public void addArg(Arg arg) { + args.add(arg); + } + + public abstract boolean matches(LogEntry entry) throws FilterException; + + public String toString() { + String op = "(" + getClass().getName(); + for (FilterOp f : subOps) { + op += " " + f; + } + for (Arg a : args) { + op += " " + a; + } + return op + ")"; + } +} diff --git a/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/FilterParser.java b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/FilterParser.java new file mode 100644 index 0000000..cf12e3a --- /dev/null +++ b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/FilterParser.java @@ -0,0 +1,131 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.graph; + +import java.io.PushbackReader; +import java.io.StringReader; +import java.io.IOException; +import java.util.ArrayList; + +import org.apache.zookeeper.graph.filterops.*; + +public class FilterParser { + private PushbackReader reader; + + public FilterParser(String s) { + reader = new PushbackReader(new StringReader(s)); + } + + private String readUntilSpace() throws IOException { + StringBuffer buffer = new StringBuffer(); + + int c = reader.read(); + while (!Character.isWhitespace(c) && c != ')' && c != '(') { + buffer.append((char)c); + c = reader.read(); + if (c == -1) { + break; + } + } + reader.unread(c); + + return buffer.toString().trim(); + } + + private StringArg readStringArg() throws IOException, FilterException { + int c = reader.read(); + int last = 0; + if (c != '"') { + throw new FilterException("Check the parser, trying to read a string that doesn't begin with quotes"); + } + StringBuffer buffer = new StringBuffer(); + while (reader.ready()) { + last = c; + c = reader.read(); + if (c == -1) { + break; + } + + if (c == '"' && last != '\\') { + return new StringArg(buffer.toString()); + } else { + buffer.append((char)c); + } + } + throw new FilterException("Unterminated string"); + } + + private NumberArg readNumberArg() throws IOException, FilterException { + String strval = readUntilSpace(); + + try { + if (strval.startsWith("0x")) { + return new NumberArg(Long.valueOf(strval.substring(2), 16)); + } else { + return new NumberArg(Long.valueOf(strval)); + } + } catch (NumberFormatException e) { + throw new FilterException("Not a number [" + strval + "]\n" + e); + } + } + + private SymbolArg readSymbolArg() throws IOException, FilterException { + return new SymbolArg(readUntilSpace()); + } + + public FilterOp parse() throws IOException, FilterException { + int c = reader.read(); + if (c != '(') { + throw new FilterException("Invalid format"); + } + + String opstr = readUntilSpace(); + FilterOp op = FilterOp.newOp(opstr); + + while (reader.ready()) { + c = reader.read(); + if (c == -1) { + break; + } + if (c == '(') { + reader.unread(c); + op.addSubOp(parse()); + } else if (c == ')') { + return op; + } else if (c == '"') { + reader.unread(c); + op.addArg(readStringArg()); + } else if (Character.isDigit(c) || c == '-' || c == '+') { + reader.unread(c); + op.addArg(readNumberArg()); + } else if (Character.isJavaIdentifierStart(c)) { + reader.unread(c); + op.addArg(readSymbolArg()); + } + } + throw new FilterException("Incomplete filter"); + } + + public static void main(String[] args) throws IOException, FilterException { + if (args.length == 1) { + System.out.println(new FilterParser(args[0]).parse()); + } else { + System.out.println(new FilterParser("(or (and (= session foobar) (= session barfoo)) (= session sdfs))").parse()); + } + } +}; diff --git a/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/JsonGenerator.java b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/JsonGenerator.java new file mode 100644 index 0000000..afaf3a1 --- /dev/null +++ b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/JsonGenerator.java @@ -0,0 +1,223 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.graph; + + +import org.json.simple.JSONArray; +import org.json.simple.JSONObject; +import org.json.simple.JSONValue; + +import java.io.Writer; +import java.io.OutputStreamWriter; +import java.io.IOException; +import java.util.regex.Pattern; +import java.util.regex.Matcher; +import java.util.HashSet; +import java.util.Iterator; +import java.util.LinkedList; +import java.util.ListIterator; + +public class JsonGenerator { + private JSONObject root; + private HashSet servers; + + private class Message { + private int from; + private int to; + private long zxid; + + public Message(int from, int to, long zxid) { + this.from = from; + this.to = to; + this.zxid = zxid; + } + + public boolean equals(Message m) { + return (m.from == this.from + && m.to == this.to + && m.zxid == this.zxid); + } + }; + + public JSONObject txnEntry(TransactionEntry e) { + JSONObject event = new JSONObject(); + + event.put("time", Long.toString(e.getTimestamp())); + event.put("client", Long.toHexString(e.getClientId())); + event.put("cxid", Long.toHexString(e.getCxid())); + event.put("zxid", Long.toHexString(e.getZxid())); + event.put("op", e.getOp()); + event.put("extra", e.getExtra()); + event.put("type", "transaction"); + + return event; + } + + /** + Assumes entries are sorted by timestamp. + */ + public JsonGenerator(LogIterator iter) { + servers = new HashSet(); + + Pattern stateChangeP = Pattern.compile("- (LOOKING|FOLLOWING|LEADING)"); + Pattern newElectionP = Pattern.compile("New election. My id = (\\d+), Proposed zxid = (\\d+)"); + Pattern receivedProposalP = Pattern.compile("Notification: (\\d+) \\(n.leader\\), (\\d+) \\(n.zxid\\), (\\d+) \\(n.round\\), .+ \\(n.state\\), (\\d+) \\(n.sid\\), .+ \\(my state\\)"); + Pattern exceptionP = Pattern.compile("xception"); + + root = new JSONObject(); + Matcher m = null; + JSONArray events = new JSONArray(); + root.put("events", events); + + long starttime = Long.MAX_VALUE; + long endtime = 0; + + int leader = 0; + long curEpoch = 0; + boolean newEpoch = false; + + while (iter.hasNext()) { + LogEntry ent = iter.next(); + + if (ent.getTimestamp() < starttime) { + starttime = ent.getTimestamp(); + } + if (ent.getTimestamp() > endtime) { + endtime = ent.getTimestamp(); + } + + if (ent.getType() == LogEntry.Type.TXN) { + events.add(txnEntry((TransactionEntry)ent)); + } else { + Log4JEntry e = (Log4JEntry)ent; + servers.add(e.getNode()); + + if ((m = stateChangeP.matcher(e.getEntry())).find()) { + JSONObject stateChange = new JSONObject(); + stateChange.put("type", "stateChange"); + stateChange.put("time", e.getTimestamp()); + stateChange.put("server", e.getNode()); + stateChange.put("state", m.group(1)); + events.add(stateChange); + + if (m.group(1).equals("LEADING")) { + leader = e.getNode(); + } + } else if ((m = newElectionP.matcher(e.getEntry())).find()) { + Iterator iterator = servers.iterator(); + long zxid = Long.valueOf(m.group(2)); + int count = (int)zxid;// & 0xFFFFFFFFL; + int epoch = (int)Long.rotateRight(zxid, 32);// >> 32; + + if (leader != 0 && epoch > curEpoch) { + JSONObject stateChange = new JSONObject(); + stateChange.put("type", "stateChange"); + stateChange.put("time", e.getTimestamp()); + stateChange.put("server", leader); + stateChange.put("state", "INIT"); + events.add(stateChange); + leader = 0; + } + + while (iterator.hasNext()) { + int dst = iterator.next(); + if (dst != e.getNode()) { + JSONObject msg = new JSONObject(); + msg.put("type", "postmessage"); + msg.put("src", e.getNode()); + msg.put("dst", dst); + msg.put("time", e.getTimestamp()); + msg.put("zxid", m.group(2)); + msg.put("count", count); + msg.put("epoch", epoch); + + events.add(msg); + } + } + } else if ((m = receivedProposalP.matcher(e.getEntry())).find()) { + // Pattern.compile("Notification: \\d+, (\\d+), (\\d+), \\d+, [^,]*, [^,]*, (\\d+)");//, LOOKING, LOOKING, 2 + int src = Integer.valueOf(m.group(4)); + long zxid = Long.valueOf(m.group(2)); + int dst = e.getNode(); + long epoch2 = Long.valueOf(m.group(3)); + + int count = (int)zxid;// & 0xFFFFFFFFL; + int epoch = (int)Long.rotateRight(zxid, 32);// >> 32; + + if (leader != 0 && epoch > curEpoch) { + JSONObject stateChange = new JSONObject(); + stateChange.put("type", "stateChange"); + stateChange.put("time", e.getTimestamp()); + stateChange.put("server", leader); + stateChange.put("state", "INIT"); + events.add(stateChange); + leader = 0; + } + + if (src != dst) { + JSONObject msg = new JSONObject(); + msg.put("type", "delivermessage"); + msg.put("src", src); + msg.put("dst", dst); + msg.put("time", e.getTimestamp()); + msg.put("zxid", zxid); + msg.put("epoch", epoch); + msg.put("count", count); + msg.put("epoch2", epoch2); + + events.add(msg); + } + } else if ((m = exceptionP.matcher(e.getEntry())).find()) { + JSONObject ex = new JSONObject(); + ex.put("type", "exception"); + ex.put("server", e.getNode()); + ex.put("time", e.getTimestamp()); + ex.put("text", e.getEntry()); + events.add(ex); + } + } + JSONObject ex = new JSONObject(); + ex.put("type", "text"); + ex.put("time", ent.getTimestamp()); + String txt = ent.toString(); + ex.put("text", txt); + events.add(ex); + } + // System.out.println("pending messages: "+pendingMessages.size()); + root.put("starttime", starttime); + root.put("endtime", endtime); + + JSONArray serversarray = new JSONArray(); + root.put("servers", serversarray); + + Iterator iterator = servers.iterator(); + while (iterator.hasNext()) { + serversarray.add(iterator.next()); + } + } + + public String toString() { + return JSONValue.toJSONString(root); + } + + public static void main(String[] args) throws Exception { + MergedLogSource src = new MergedLogSource(args); + LogIterator iter = src.iterator(); + System.out.println(new JsonGenerator(iter)); + } +} diff --git a/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/Log4JEntry.java b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/Log4JEntry.java new file mode 100644 index 0000000..0edc146 --- /dev/null +++ b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/Log4JEntry.java @@ -0,0 +1,40 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.graph; + +public class Log4JEntry extends LogEntry { + public Log4JEntry(long timestamp, int node, String entry) { + super(timestamp); + setAttribute("log-text", entry); + setAttribute("node", new Integer(node)); + } + + public String getEntry() { + return (String) getAttribute("log-text"); + } + + public String toString() { + return "" + getTimestamp() + "::::" + getNode() + "::::" + getEntry(); + } + + public int getNode() { + return (Integer) getAttribute("node"); + } + + public Type getType() { return LogEntry.Type.LOG4J; } +} diff --git a/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/Log4JSource.java b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/Log4JSource.java new file mode 100644 index 0000000..84a9d98 --- /dev/null +++ b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/Log4JSource.java @@ -0,0 +1,391 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.graph; + +import java.io.File; +import java.io.InputStreamReader; +import java.io.BufferedReader; +import java.io.FileReader; +import java.io.IOException; +import java.util.regex.Pattern; +import java.util.regex.Matcher; +import java.util.ArrayList; +import java.util.Date; +import java.text.SimpleDateFormat; +import java.text.ParseException; +import java.util.Calendar; +import java.util.GregorianCalendar; + +import java.io.EOFException; +import java.io.Closeable; +import java.io.FileNotFoundException; +import java.util.Iterator; +import java.util.NoSuchElementException; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +public class Log4JSource implements LogSource { + private static final Logger LOG = LoggerFactory.getLogger(Log4JSource.class); + + private static final int skipN = 10000; + private static final String DATE_FORMAT = "yyyy-MM-dd HH:mm:ss,SSS"; + + private LogSkipList skiplist = null; + + private String file = null; + private long starttime = 0; + private long endtime = 0; + private int serverid = 0; + private long size = 0; + + private Pattern timep; + + public boolean overlapsRange(long starttime, long endtime) { + return (starttime <= this.endtime && endtime >= this.starttime); + } + + public long size() { return size; } + public long getStartTime() { return starttime; } + public long getEndTime() { return endtime; } + public LogSkipList getSkipList() { return skiplist; } + + private class Log4JSourceIterator implements LogIterator { + private RandomAccessFileReader in; + private LogEntry next = null; + private long starttime = 0; + private long endtime = 0; + private String buf = ""; + private Log4JSource src = null; + private long skippedAtStart = 0; + private SimpleDateFormat dateformat = null; + private FilterOp filter = null; + + public Log4JSourceIterator(Log4JSource src, long starttime, long endtime) throws IllegalArgumentException, FilterException { + this(src, starttime, endtime, null); + } + + public Log4JSourceIterator(Log4JSource src, long starttime, long endtime, FilterOp filter) throws IllegalArgumentException, FilterException { + + this.dateformat = new SimpleDateFormat(DATE_FORMAT); + this.src = src; + this.starttime = starttime; + this.endtime = endtime; + + File f = new File(src.file); + try { + in = new RandomAccessFileReader(f); + } catch (FileNotFoundException e) { + throw new IllegalArgumentException("Bad file passed in (" + src.file +") cannot open:" + e); + } + + // skip to the offset of latest skip point before starttime + LogSkipList.Mark start = src.getSkipList().findMarkBefore(starttime); + try { + in.seek(start.getBytes()); + skippedAtStart = start.getEntriesSkipped(); + } catch (IOException ioe) { + // if we can't skip, we should just read from the start + } + + LogEntry e; + while ((e = readNextEntry()) != null && e.getTimestamp() < endtime) { + if (e.getTimestamp() >= starttime && (filter == null || filter.matches(e))) { + next = e; + return; + } + skippedAtStart++; + } + this.filter = filter; + } + + synchronized public long size() throws IOException { + if (LOG.isTraceEnabled()) { + LOG.trace("size() called"); + } + + if (this.endtime >= src.getEndTime()) { + return src.size() - skippedAtStart; + } + + long pos = in.getPosition(); + + if (LOG.isTraceEnabled()) { + LOG.trace("saved pos () = " + pos); + } + + LogEntry e; + + LogSkipList.Mark lastseg = src.getSkipList().findMarkBefore(this.endtime); + in.seek(lastseg.getBytes()); + buf = ""; // clear the buf so we don't get something we read before we sought + // number of entries skipped to get to the end of the iterator, less the number skipped to get to the start + long count = lastseg.getEntriesSkipped() - skippedAtStart; + + while ((e = readNextEntry()) != null) { + if (LOG.isTraceEnabled()) { + //LOG.trace(e); + } + if (e.getTimestamp() > this.endtime) { + break; + } + count++; + } + in.seek(pos); + buf = ""; + + if (LOG.isTraceEnabled()) { + LOG.trace("size() = " + count); + } + + return count; + } + + synchronized private LogEntry readNextEntry() { + try { + try { + while (true) { + String line = in.readLine(); + if (line == null) { + break; + } + + Matcher m = src.timep.matcher(line); + if (m.lookingAt()) { + if (buf.length() > 0) { + LogEntry e = new Log4JEntry(src.timestampFromText(dateformat, buf), src.getServerId(), buf); + buf = line; + return e; + } + buf = line; + } else if (buf.length() > 0) { + buf += line + "\n"; + } + } + } catch (EOFException eof) { + // ignore, we've simply come to the end of the file + } + if (buf.length() > 0) { + LogEntry e = new Log4JEntry(src.timestampFromText(dateformat, buf), src.getServerId(), buf); + buf = ""; + return e; + } + } catch (Exception e) { + LOG.error("Error reading next entry in file (" + src.file + "): " + e); + return null; + } + return null; + } + + public boolean hasNext() { + return next != null; + } + + public LogEntry next() throws NoSuchElementException { + LogEntry ret = next; + LogEntry e = readNextEntry(); + + if (filter != null) { + try { + while (e != null && !filter.matches(e)) { + e = readNextEntry(); + } + } catch (FilterException fe) { + throw new NoSuchElementException(e.toString()); + } + } + + if (e != null && e.getTimestamp() < endtime) { + next = e; + } else { + next = null; + } + return ret; + } + + public void remove() throws UnsupportedOperationException { + throw new UnsupportedOperationException("remove not supported for L4J logs"); + } + + public void close() throws IOException { + in.close(); + } + + public String toString() { + String size; + try { + size = new Long(size()).toString(); + } catch (IOException ioe) { + size = "Unable to read"; + } + return "Log4JSourceIterator(start=" + starttime + ", end=" + endtime + ", size=" + size + ")"; + } + } + + public LogIterator iterator(long starttime, long endtime) throws IllegalArgumentException { + try { + return iterator(starttime, endtime, null); + } catch (FilterException fe) { + assert(false); //"This should never happen, you can't have a filter exception without a filter"); + return null; + } + } + + public LogIterator iterator(long starttime, long endtime, FilterOp filter) throws IllegalArgumentException, FilterException{ + // sanitise start and end times + if (endtime < starttime) { + throw new IllegalArgumentException("End time (" + endtime + ") must be greater or equal to starttime (" + starttime + ")"); + } + + return new Log4JSourceIterator(this, starttime, endtime, filter); + } + + public LogIterator iterator() throws IllegalArgumentException { + return iterator(starttime, endtime+1); + } + + public Log4JSource(String file) throws IOException { + this.file=file; + + timep = Pattern.compile("^(\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2},\\d{3})"); + skiplist = new LogSkipList(); + init(); + } + + private static long timestampFromText(SimpleDateFormat format, String s) { + Date d = null; + try { + d = format.parse(s); + } catch (ParseException e) { + return 0; + } + Calendar c = new GregorianCalendar(); + c.setTime(d); + return c.getTimeInMillis(); + } + + private void init() throws IOException { + File f = new File(file); + RandomAccessFileReader in = new RandomAccessFileReader(f); + SimpleDateFormat dateformat = new SimpleDateFormat(DATE_FORMAT); + Pattern idp = Pattern.compile("\\[myid:(\\d+)\\]"); + + long lastFp = in.getPosition(); + String line = in.readLine(); + Matcher m = null; + + // if we have read data from the file, and it matchs the timep pattern + if ((line != null) && (m = timep.matcher(line)).lookingAt()) { + starttime = timestampFromText(dateformat, m.group(1)); + } else { + throw new IOException("Invalid log4j format. First line doesn't start with time"); + } + + /* + Count number of log entries. Any line starting with a timestamp counts as an entry + */ + String lastentry = line; + try { + while (line != null) { + m = timep.matcher(line); + if (m.lookingAt()) { + if (size % skipN == 0) { + long time = timestampFromText(dateformat, m.group(1)); + skiplist.addMark(time, lastFp, size); + } + size++; + lastentry = line; + } + if (serverid == 0 && (m = idp.matcher(line)).find()) { + serverid = Integer.valueOf(m.group(1)); + } + + lastFp = in.getPosition(); + line = in.readLine(); + } + } catch (EOFException eof) { + // ignore, simply end of file, though really (line!=null) should have caught this + } finally { + in.close(); + } + + m = timep.matcher(lastentry); + if (m.lookingAt()) { + endtime = timestampFromText(dateformat, m.group(1)); + } else { + throw new IOException("Invalid log4j format. Last line doesn't start with time"); + } + } + + public String toString() { + return "Log4JSource(file=" + file + ", size=" + size + ", start=" + starttime + ", end=" + endtime +", id=" + serverid +")"; + } + + public static void main(String[] args) throws IOException { + final Log4JSource s = new Log4JSource(args[0]); + System.out.println(s); + + LogIterator iter; + + if (args.length == 3) { + final long starttime = Long.valueOf(args[1]); + final long endtime = Long.valueOf(args[2]); + iter = s.iterator(starttime, endtime); + + Thread t1 = new Thread() { public void run () { + + LogIterator iter = s.iterator(starttime, endtime); + System.out.println(iter); + try { + iter.close(); + } catch (IOException ioe) { + System.out.println(ioe.getMessage()); + } + }; }; + Thread t2 = new Thread() { public void run () { + + LogIterator iter = s.iterator(starttime, endtime); + System.out.println(iter); + try { + iter.close(); + } catch (IOException ioe) { + System.out.println(ioe.getMessage()); + } + }; }; + Thread t3 = new Thread() { public void run () { + + LogIterator iter = s.iterator(starttime, endtime); + System.out.println(iter); + }; }; + t1.start(); + t2.start(); + // t3.start(); + } else { + iter = s.iterator(); + } + + /*while (iter.hasNext()) { + System.out.println(iter.next()); + }*/ + iter.close(); + } + + public int getServerId() { + return serverid; + } +} diff --git a/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/LogEntry.java b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/LogEntry.java new file mode 100644 index 0000000..a8252eb --- /dev/null +++ b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/LogEntry.java @@ -0,0 +1,46 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.graph; + +import java.io.Serializable; +import java.util.HashMap; + +public abstract class LogEntry implements Serializable { + private HashMap attributes; + + public enum Type { UNKNOWN, LOG4J, TXN }; + + public LogEntry(long timestamp) { + attributes = new HashMap(); + setAttribute("timestamp", new Long(timestamp)); + } + + public long getTimestamp() { + return (Long)getAttribute("timestamp"); + } + + public abstract Type getType(); + + public void setAttribute(String key, Object v) { + attributes.put(key, v); + } + + public Object getAttribute(String key) { + return attributes.get(key); + } +} diff --git a/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/LogIterator.java b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/LogIterator.java new file mode 100644 index 0000000..9af440b --- /dev/null +++ b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/LogIterator.java @@ -0,0 +1,26 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.graph; + +import java.io.Closeable; +import java.util.Iterator; +import java.io.IOException; + +public interface LogIterator extends Iterator, Closeable { + long size() throws IOException;; +}; diff --git a/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/LogServer.java b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/LogServer.java new file mode 100644 index 0000000..5cffcdd --- /dev/null +++ b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/LogServer.java @@ -0,0 +1,66 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.graph; + +import java.io.IOException; + +import javax.servlet.http.HttpServletRequest; +import javax.servlet.http.HttpServletResponse; +import javax.servlet.ServletException; + +import java.io.IOException; + +import org.eclipse.jetty.server.Server; +import org.eclipse.jetty.server.Request; +import org.eclipse.jetty.server.handler.AbstractHandler; +import org.eclipse.jetty.servlet.ServletContextHandler; +import org.eclipse.jetty.servlet.ServletHolder; + +import org.apache.zookeeper.graph.servlets.*; + +public class LogServer extends ServletContextHandler { + public LogServer(MergedLogSource src) throws Exception { + super(ServletContextHandler.SESSIONS); + setContextPath("/"); + + addServlet(new ServletHolder(new StaticContent()),"/graph/*"); + + addServlet(new ServletHolder(new Fs()),"/fs"); + addServlet(new ServletHolder(new GraphData(src)), "/data"); + addServlet(new ServletHolder(new FileLoader(src)), "/loadfile"); + addServlet(new ServletHolder(new NumEvents(src)), "/info"); + addServlet(new ServletHolder(new Throughput(src)), "/throughput"); + } + + public static void main(String[] args) { + try { + MergedLogSource src = new MergedLogSource(args); + System.out.println(src); + + Server server = new Server(8182); + server.setHandler(new LogServer(src)); + + server.start(); + server.join(); + + } catch (Exception e) { + // Something is wrong. + e.printStackTrace(); + } + } +} diff --git a/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/LogSkipList.java b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/LogSkipList.java new file mode 100644 index 0000000..e744442 --- /dev/null +++ b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/LogSkipList.java @@ -0,0 +1,95 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.graph; + +import java.util.List; +import java.util.LinkedList; +import java.util.NoSuchElementException; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +/** +Generic skip list for holding a rough index of a log file. When the log file is loaded, this +index is built by adding a mark every n entries. Then when a specific time position is requested +from the file, a point at most n-1 entries before the time position can be jumped to. + +*/ +public class LogSkipList { + private static final Logger LOG = LoggerFactory.getLogger(LogSkipList.class); + + private LinkedList marks; + + public class Mark { + private long time; + private long bytes; + private long skipped; + + public Mark(long time, long bytes, long skipped) { + this.time = time; + this.bytes = bytes; + this.skipped = skipped; + } + + public long getTime() { return this.time; } + public long getBytes() { return this.bytes; } + public long getEntriesSkipped() { return this.skipped; } + + public String toString() { + return "Mark(time=" + time + ", bytes=" + bytes + ", skipped=" + skipped + ")"; + } + }; + + public LogSkipList() { + if (LOG.isTraceEnabled()) { + LOG.trace("New skip list"); + } + marks = new LinkedList(); + } + + public void addMark(long time, long bytes, long skipped) { + if (LOG.isTraceEnabled()) { + LOG.trace("addMark (time:" + time + ", bytes: " + bytes + ", skipped: " + skipped + ")"); + } + marks.add(new Mark(time, bytes, skipped)); + } + + /** + Find the last mark in the skip list before time. + */ + public Mark findMarkBefore(long time) throws NoSuchElementException { + if (LOG.isTraceEnabled()) { + LOG.trace("findMarkBefore(" + time + ")"); + } + + Mark last = marks.getFirst(); + for (Mark m: marks) { + if (m.getTime() > time) { + break; + } + last = m; + } + + if (LOG.isTraceEnabled()) { + LOG.trace("return " + last ); + } + + return last; + } + +}; diff --git a/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/LogSource.java b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/LogSource.java new file mode 100644 index 0000000..9845c7f --- /dev/null +++ b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/LogSource.java @@ -0,0 +1,33 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.graph; +import java.util.Iterator; + +public interface LogSource extends Iterable { + public LogIterator iterator(long starttime, long endtime, FilterOp filter) throws IllegalArgumentException, FilterException; + + public LogIterator iterator(long starttime, long endtime) throws IllegalArgumentException; + + public LogIterator iterator() throws IllegalArgumentException; + + public boolean overlapsRange(long starttime, long endtime); + + public long size(); + public long getStartTime(); + public long getEndTime(); +} diff --git a/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/MeasureThroughput.java b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/MeasureThroughput.java new file mode 100644 index 0000000..1c83da7 --- /dev/null +++ b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/MeasureThroughput.java @@ -0,0 +1,103 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.graph; + +import java.io.IOException; +import java.io.BufferedOutputStream; +import java.io.FileOutputStream; +import java.io.DataOutputStream; +import java.io.PrintStream; + +import java.util.HashSet; + +public class MeasureThroughput { + private static final int MS_PER_SEC = 1000; + private static final int MS_PER_MIN = MS_PER_SEC*60; + private static final int MS_PER_HOUR = MS_PER_MIN*60; + + public static void main(String[] args) throws IOException { + MergedLogSource source = new MergedLogSource(args); + + PrintStream ps_ms = new PrintStream(new BufferedOutputStream(new FileOutputStream("throughput-ms.out"))); + PrintStream ps_sec = new PrintStream(new BufferedOutputStream(new FileOutputStream("throughput-sec.out"))); + PrintStream ps_min = new PrintStream(new BufferedOutputStream(new FileOutputStream("throughput-min.out"))); + PrintStream ps_hour = new PrintStream(new BufferedOutputStream(new FileOutputStream("throughput-hour.out"))); + LogIterator iter; + + System.out.println(source); + iter = source.iterator(); + long currentms = 0; + long currentsec = 0; + long currentmin = 0; + long currenthour = 0; + HashSet zxids_ms = new HashSet(); + long zxid_sec = 0; + long zxid_min = 0; + long zxid_hour = 0; + + while (iter.hasNext()) { + LogEntry e = iter.next(); + TransactionEntry cxn = (TransactionEntry)e; + + long ms = cxn.getTimestamp(); + long sec = ms/MS_PER_SEC; + long min = ms/MS_PER_MIN; + long hour = ms/MS_PER_HOUR; + + if (currentms != ms && currentms != 0) { + ps_ms.println("" + currentms + " " + zxids_ms.size()); + + zxid_sec += zxids_ms.size(); + zxid_min += zxids_ms.size(); + zxid_hour += zxids_ms.size(); + zxids_ms.clear(); + } + + if (currentsec != sec && currentsec != 0) { + ps_sec.println("" + currentsec*MS_PER_SEC + " " + zxid_sec); + + zxid_sec = 0; + } + + if (currentmin != min && currentmin != 0) { + ps_min.println("" + currentmin*MS_PER_MIN + " " + zxid_min); + + zxid_min = 0; + } + + if (currenthour != hour && currenthour != 0) { + ps_hour.println("" + currenthour*MS_PER_HOUR + " " + zxid_hour); + + zxid_hour = 0; + } + + currentms = ms; + currentsec = sec; + currentmin = min; + currenthour = hour; + + zxids_ms.add(cxn.getZxid()); + } + + iter.close(); + ps_ms.close(); + ps_sec.close(); + ps_min.close(); + ps_hour.close(); + } +}; diff --git a/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/MergedLogSource.java b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/MergedLogSource.java new file mode 100644 index 0000000..bb789d3 --- /dev/null +++ b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/MergedLogSource.java @@ -0,0 +1,219 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.graph; + +import java.io.ByteArrayInputStream; +import java.io.EOFException; +import java.io.FileInputStream; +import java.io.IOException; +import java.text.DateFormat; +import java.util.Date; +import java.util.zip.Adler32; +import java.util.zip.Checksum; +import java.util.HashMap; + +import org.apache.jute.BinaryInputArchive; +import org.apache.jute.InputArchive; +import org.apache.jute.Record; +import org.apache.zookeeper.server.TraceFormatter; +import org.apache.zookeeper.server.persistence.FileHeader; +import org.apache.zookeeper.server.persistence.FileTxnLog; +import org.apache.zookeeper.server.util.SerializeUtils; +import org.apache.zookeeper.txn.TxnHeader; + +import org.apache.zookeeper.ZooDefs.OpCode; + +import org.apache.zookeeper.txn.CreateSessionTxn; +import org.apache.zookeeper.txn.CreateTxn; +import org.apache.zookeeper.txn.DeleteTxn; +import org.apache.zookeeper.txn.ErrorTxn; +import org.apache.zookeeper.txn.SetACLTxn; +import org.apache.zookeeper.txn.SetDataTxn; +import org.apache.zookeeper.txn.TxnHeader; + +import java.io.Closeable; +import java.io.FileNotFoundException; +import java.util.Vector; +import java.util.Iterator; +import java.util.Collections; +import java.util.NoSuchElementException; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +public class MergedLogSource implements LogSource { + private static final Logger LOG = LoggerFactory.getLogger(MergedLogSource.class); + private Vector sources = null; + private long starttime = 0; + private long endtime = 0; + private long size = 0; + + public boolean overlapsRange(long starttime, long endtime) { + return (starttime <= this.endtime && endtime >= this.starttime); + } + + public long size() { return size; } + public long getStartTime() { return starttime; } + public long getEndTime() { return endtime; } + + private class MergedLogSourceIterator implements LogIterator { + private LogEntry next = null; + private long start = 0; + private long end = 0; + private MergedLogSource src = null; + private LogIterator[] sources = null; + private LogEntry[] nexts = null; + private FilterOp filter = null; + + public MergedLogSourceIterator(MergedLogSource src, long starttime, long endtime, FilterOp filter) throws IllegalArgumentException, FilterException { + Vector iters = new Vector(); + for (LogSource s : src.sources) { + if (s.overlapsRange(starttime, endtime)) { + iters.add(s.iterator(starttime, endtime, filter)); + } + } + + sources = new LogIterator[iters.size()]; + sources = iters.toArray(sources); + nexts = new LogEntry[iters.size()]; + for (int i = 0; i < sources.length; i++) { + if (sources[i].hasNext()) + nexts[i] = sources[i].next(); + } + this.filter = filter; + } + + public MergedLogSourceIterator(MergedLogSource src, long starttime, long endtime) throws IllegalArgumentException, FilterException { + this(src, starttime, endtime, null); + } + + public long size() throws IOException { + long size = 0; + for (LogIterator i : sources) { + size += i.size(); + } + return size; + } + + public boolean hasNext() { + for (LogEntry n : nexts) { + if (n != null) return true; + } + return false; + } + + public LogEntry next() { + int min = -1; + for (int i = 0; i < nexts.length; i++) { + if (nexts[i] != null) { + if (min == -1) { + min = i; + } else if (nexts[i].getTimestamp() < nexts[min].getTimestamp()) { + min = i; + } + } + } + if (min == -1) { + return null; + } else { + LogEntry e = nexts[min]; + nexts[min] = sources[min].next(); + return e; + } + } + + public void remove() throws UnsupportedOperationException { + throw new UnsupportedOperationException("remove not supported for Merged logs"); + } + + public void close() throws IOException { + for (LogIterator i : sources) { + i.close(); + } + } + } + + public LogIterator iterator(long starttime, long endtime) throws IllegalArgumentException { + try { + return iterator(starttime, endtime, null); + } catch (FilterException fe) { + assert(false); // shouldn't happen without filter + return null; + } + } + + public LogIterator iterator(long starttime, long endtime, FilterOp filter) throws IllegalArgumentException, FilterException { + // sanitise start and end times + if (endtime < starttime) { + throw new IllegalArgumentException("End time (" + endtime + ") must be greater or equal to starttime (" + starttime + ")"); + } + + return new MergedLogSourceIterator(this, starttime, endtime, filter); + } + + public LogIterator iterator() throws IllegalArgumentException { + return iterator(starttime, endtime+1); + } + + public MergedLogSource(String[] files) throws IOException { + sources = new Vector(); + for (String f : files) { + addSource(f); + } + } + + public void addSource(String f) throws IOException { + LogSource s = null; + if (TxnLogSource.isTransactionFile(f)) { + s = new TxnLogSource(f); + } else { + s = new Log4JSource(f); + } + + size += s.size(); + endtime = s.getEndTime() > endtime ? s.getEndTime() : endtime; + starttime = s.getStartTime() < starttime || starttime == 0 ? s.getStartTime() : starttime; + sources.add(s); + } + + public String toString() { + String s = "MergedLogSource(size=" + size + ", start=" + starttime + ", end=" + endtime +")"; + for (LogSource src : sources) { + s += "\n\t- " +src; + } + return s; + } + + public static void main(String[] args) throws IOException { + System.out.println("Time: " + System.currentTimeMillis()); + MergedLogSource s = new MergedLogSource(args); + System.out.println(s); + + LogIterator iter; + + iter = s.iterator(); + System.out.println("Time: " + System.currentTimeMillis()); + System.out.println("Iterator Size: " + iter.size()); + System.out.println("Time: " + System.currentTimeMillis()); + /* while (iter.hasNext()) { + System.out.println(iter.next()); + }*/ + iter.close(); + System.out.println("Time: " + System.currentTimeMillis()); + } +} diff --git a/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/RandomAccessFileReader.java b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/RandomAccessFileReader.java new file mode 100644 index 0000000..13a41a5 --- /dev/null +++ b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/RandomAccessFileReader.java @@ -0,0 +1,329 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.graph; + +import java.io.File; +import java.io.Reader; +import java.io.IOException; +import java.io.EOFException; +import java.io.RandomAccessFile; +import java.io.FileNotFoundException; + +import java.io.DataInputStream; +import java.io.ByteArrayInputStream; +import java.io.DataInput; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +public class RandomAccessFileReader extends Reader implements DataInput { + private static final Logger LOG = LoggerFactory.getLogger(RandomAccessFileReader.class); + private RandomAccessFile file; + private byte[] buffer; + private int buffersize; + private int bufferoffset; + private long fileoffset; + private long fp; + + private static final int DEFAULT_BUFFER_SIZE = 512*1024; // 512k + private int point = 0; + + public RandomAccessFileReader(File f) throws FileNotFoundException { + file = new RandomAccessFile(f, "r"); + if (LOG.isDebugEnabled()) { + try { + LOG.debug("Opened file(" + f + ") with FD (" + file.getFD() + ")"); + } catch (IOException ioe) { + LOG.debug("Opened file(" + f + ") coulds get FD"); + } + } + + buffer = new byte[DEFAULT_BUFFER_SIZE]; + buffersize = 0; + bufferoffset = 0; + fileoffset = 0; + fp = 0; + } + + /** + fill the buffer from the file. + fp keeps track of the file pointer. + fileoffset is the offset into the file to where the buffer came from. + */ + private int fill() throws IOException { + fileoffset = fp; + int read = file.read(buffer, 0, buffer.length); + + if (LOG.isDebugEnabled()) { + String buf = new String(buffer, 0, 40, "UTF-8"); + LOG.debug("fill(buffer=" + buf + ")"); + } + + if (read == -1) { // eof reached + buffersize = 0; + } else { + buffersize = read; + } + fp += buffersize; + bufferoffset = 0; + + return buffersize; + } + + /** + * Reader interface + */ + public boolean markSupported() { return false; } + + /** + copy what we can from buffer. if it's not enough, fill buffer again and copy again + */ + synchronized public int read(char[] cbuf, int off, int len) throws IOException { + // This could be faster, but probably wont be used + byte[] b = new byte[2]; + int bytesread = 0; + while (len > 0) { + int read = read(b, 0, 2); + bytesread += read; + if (read < 2) { + return bytesread; + } + cbuf[off] = (char)((b[0] << 8) | (b[1] & 0xff)); + off += read; + len -= read; + } + + return bytesread; + } + + synchronized public int read(byte[] buf, int off, int len) throws IOException { + if (LOG.isTraceEnabled()) { + LOG.trace("read(buf, off=" + off + ", len=" + len); + } + + int read = 0; + while (len > 0) { + if (buffersize == 0) { + fill(); + if (buffersize == 0) { + break; + } + } + + int tocopy = Math.min(len, buffersize); + if (LOG.isTraceEnabled()) { + LOG.trace("tocopy=" + tocopy); + } + + System.arraycopy(buffer, bufferoffset, buf, off, tocopy); + buffersize -= tocopy; + bufferoffset += tocopy; + + len -= tocopy; + read += tocopy; + off += tocopy; + } + if (LOG.isTraceEnabled()) { + LOG.trace("read=" + read); + } + + return read; + } + + public void close() throws IOException { + file.close(); + } + + /** + * Seek interface + */ + public long getPosition() { + return bufferoffset + fileoffset; + } + + synchronized public void seek(long pos) throws IOException { + if (LOG.isDebugEnabled()) { + LOG.debug("seek(" + pos + ")"); + } + file.seek(pos); + fp = pos; + buffersize = 0; // force a buffer fill on next read + } + + /** + works like the usual readLine but disregards \r to make things easier + */ + synchronized public String readLine() throws IOException { + StringBuffer s = null; + + // go through buffer until i find a \n, if i reach end of buffer first, put whats in buffer into string buffer, + // repeat + buffering: + for (;;) { + if (buffersize == 0) { + fill(); + if (buffersize == 0) { + break; + } + } + + for (int i = 0; i < buffersize; i++) { + if (buffer[bufferoffset + i] == '\n') { + if (i > 0) { // if \n is first char in buffer, leave the string buffer empty + if (s == null) { s = new StringBuffer(); } + s.append(new String(buffer, bufferoffset, i, "UTF-8")); + } + bufferoffset += i+1; + buffersize -= i+1; + break buffering; + } + } + + // We didn't find \n, read the whole buffer into string buffer + if (s == null) { s = new StringBuffer(); } + s.append(new String(buffer, bufferoffset, buffersize, "UTF-8")); + buffersize = 0; + } + + if (s == null) { + return null; + } else { + return s.toString(); + } + } + + /** + DataInput interface + */ + public void readFully(byte[] b) throws IOException { + readFully(b, 0, b.length); + } + + public void readFully(byte[] b, int off, int len) throws IOException + { + while (len > 0) { + int read = read(b, off, len); + len -= read; + off += read; + + if (read == 0) { + throw new EOFException("End of file reached"); + } + } + } + + public int skipBytes(int n) throws IOException { + seek(getPosition() + n); + return n; + } + + public boolean readBoolean() throws IOException { + return (readByte() != 0); + } + + public byte readByte() throws IOException { + byte[] b = new byte[1]; + readFully(b, 0, 1); + return b[0]; + } + + public int readUnsignedByte() throws IOException { + return (int)readByte(); + } + + public short readShort() throws IOException { + byte[] b = new byte[2]; + readFully(b, 0, 2); + return (short)((b[0] << 8) | (b[1] & 0xff)); + } + + public int readUnsignedShort() throws IOException { + byte[] b = new byte[2]; + readFully(b, 0, 2); + return (((b[0] & 0xff) << 8) | (b[1] & 0xff)); + } + + public char readChar() throws IOException { + return (char)readShort(); + } + + public int readInt() throws IOException { + byte[] b = new byte[4]; + readFully(b, 0, 4); + return (((b[0] & 0xff) << 24) | ((b[1] & 0xff) << 16) | ((b[2] & 0xff) << 8) | (b[3] & 0xff)); + } + + public long readLong() throws IOException { + byte[] b = new byte[8]; + readFully(b, 0, 8); + + return (((long)(b[0] & 0xff) << 56) | ((long)(b[1] & 0xff) << 48) | + ((long)(b[2] & 0xff) << 40) | ((long)(b[3] & 0xff) << 32) | + ((long)(b[4] & 0xff) << 24) | ((long)(b[5] & 0xff) << 16) | + ((long)(b[6] & 0xff) << 8) | ((long)(b[7] & 0xff))); + } + + public float readFloat() throws IOException { + return Float.intBitsToFloat(readInt()); + } + + public double readDouble() throws IOException { + return Double.longBitsToDouble(readLong()); + } + + public String readUTF() throws IOException { + int len = readUnsignedShort(); + byte[] bytes = new byte[len+2]; + bytes[0] = (byte)((len >> 8) & 0xFF); + bytes[1] = (byte)(len & 0xFF); + readFully(bytes, 2, len); + DataInputStream dis = new DataInputStream(new ByteArrayInputStream(bytes)); + return dis.readUTF(); + } + + public static void main(String[] args) throws IOException { + RandomAccessFileReader f = new RandomAccessFileReader(new File(args[0])); + + long pos0 = f.getPosition(); + for (int i = 0; i < 5; i++) { + System.out.println(f.readLine()); + } + System.out.println("============="); + long pos1 = f.getPosition(); + System.out.println("pos: " + pos1); + for (int i = 0; i < 5; i++) { + System.out.println(f.readLine()); + } + System.out.println("============="); + f.seek(pos1); + for (int i = 0; i < 5; i++) { + System.out.println(f.readLine()); + } + System.out.println("============="); + f.seek(pos0); + for (int i = 0; i < 5; i++) { + System.out.println(f.readLine()); + } + long pos2 = f.getPosition(); + System.out.println("============="); + System.out.println(f.readLine()); + f.seek(pos2); + System.out.println(f.readLine()); + f.close(); + } +}; diff --git a/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/TransactionEntry.java b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/TransactionEntry.java new file mode 100644 index 0000000..33c7189 --- /dev/null +++ b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/TransactionEntry.java @@ -0,0 +1,59 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.graph; + +public class TransactionEntry extends LogEntry { + public TransactionEntry(long timestamp, long clientId, long Cxid, long Zxid, String op) { + this(timestamp, clientId, Cxid, Zxid, op, ""); + } + + public TransactionEntry(long timestamp, long clientId, long Cxid, long Zxid, String op, String extra) { + super(timestamp); + setAttribute("client-id", new Long(clientId)); + setAttribute("cxid", new Long(Cxid)); + setAttribute("zxid", new Long(Zxid)); + setAttribute("operation", op); + setAttribute("extra", extra); + } + + public long getClientId() { + return (Long)getAttribute("client-id"); + } + + public long getCxid() { + return (Long)getAttribute("cxid"); + } + + public long getZxid() { + return (Long)getAttribute("zxid"); + } + + public String getOp() { + return (String)getAttribute("operation"); + } + + public String getExtra() { + return (String)getAttribute("extra"); + } + + public String toString() { + return getTimestamp() + ":::session(0x" + Long.toHexString(getClientId()) + ") cxid(0x" + Long.toHexString(getCxid()) + ") zxid(0x" + Long.toHexString(getZxid()) + ") op(" + getOp() + ") extra(" + getExtra() +")"; + } + + public Type getType() { return LogEntry.Type.TXN; } +} diff --git a/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/TxnLogSource.java b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/TxnLogSource.java new file mode 100644 index 0000000..809c455 --- /dev/null +++ b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/TxnLogSource.java @@ -0,0 +1,376 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.graph; + +import java.io.ByteArrayInputStream; +import java.io.EOFException; +import java.io.FileInputStream; +import java.io.IOException; +import java.text.DateFormat; +import java.util.Date; +import java.util.zip.Adler32; +import java.util.zip.Checksum; +import java.util.HashMap; + +import org.apache.jute.BinaryInputArchive; +import org.apache.jute.InputArchive; +import org.apache.jute.Record; +import org.apache.zookeeper.server.TraceFormatter; +import org.apache.zookeeper.server.persistence.FileHeader; +import org.apache.zookeeper.server.persistence.FileTxnLog; +import org.apache.zookeeper.server.util.SerializeUtils; +import org.apache.zookeeper.txn.TxnHeader; + +import org.apache.zookeeper.ZooDefs.OpCode; + +import org.apache.zookeeper.txn.CreateSessionTxn; +import org.apache.zookeeper.txn.CreateTxn; +import org.apache.zookeeper.txn.DeleteTxn; +import org.apache.zookeeper.txn.ErrorTxn; +import org.apache.zookeeper.txn.SetACLTxn; +import org.apache.zookeeper.txn.SetDataTxn; +import org.apache.zookeeper.txn.TxnHeader; + +import java.io.File; +import java.io.Closeable; +import java.io.FileNotFoundException; +import java.util.Iterator; +import java.util.NoSuchElementException; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +public class TxnLogSource implements LogSource { + private static final Logger LOG = LoggerFactory.getLogger(TxnLogSource.class); + + private LogSkipList skiplist = null; + private static final int skipN = 10000; + + private String file = null; + private long starttime = 0; + private long endtime = 0; + private long size = 0; + + public boolean overlapsRange(long starttime, long endtime) { + return (starttime <= this.endtime && endtime >= this.starttime); + } + + public long size() { return size; } + public long getStartTime() { return starttime; } + public long getEndTime() { return endtime; } + public LogSkipList getSkipList() { return skiplist; } + + public static boolean isTransactionFile(String file) throws IOException { + RandomAccessFileReader reader = new RandomAccessFileReader(new File(file)); + BinaryInputArchive logStream = new BinaryInputArchive(reader); + FileHeader fhdr = new FileHeader(); + fhdr.deserialize(logStream, "fileheader"); + reader.close(); + + return fhdr.getMagic() == FileTxnLog.TXNLOG_MAGIC; + } + + private class TxnLogSourceIterator implements LogIterator { + private LogEntry next = null; + private long starttime = 0; + private long endtime = 0; + private TxnLogSource src = null; + private RandomAccessFileReader reader = null; + private BinaryInputArchive logStream = null; + private long skippedAtStart = 0; + private FilterOp filter = null; + + public TxnLogSourceIterator(TxnLogSource src, long starttime, long endtime) throws IllegalArgumentException, FilterException { + this(src,starttime,endtime,null); + } + + public TxnLogSourceIterator(TxnLogSource src, long starttime, long endtime, FilterOp filter) throws IllegalArgumentException, FilterException { + try { + this.src = src; + this.starttime = starttime; + this.endtime = endtime; + reader = new RandomAccessFileReader(new File(src.file)); + logStream = new BinaryInputArchive(reader); + FileHeader fhdr = new FileHeader(); + fhdr.deserialize(logStream, "fileheader"); + } catch (Exception e) { + throw new IllegalArgumentException("Cannot open transaction log ("+src.file+") :" + e); + } + + LogSkipList.Mark start = src.getSkipList().findMarkBefore(starttime); + try { + reader.seek(start.getBytes()); + skippedAtStart = start.getEntriesSkipped(); + } catch (IOException ioe) { + // if we can't skip, we should just read from the start + } + + this.filter = filter; + + LogEntry e; + while ((e = readNextEntry()) != null && e.getTimestamp() < endtime) { + if (e.getTimestamp() >= starttime && (filter == null || filter.matches(e)) ) { + next = e; + return; + } + skippedAtStart++; + } + + + } + + public long size() throws IOException { + if (this.endtime >= src.getEndTime()) { + return src.size() - skippedAtStart; + } + + long pos = reader.getPosition(); + LogEntry e; + + LogSkipList.Mark lastseg = src.getSkipList().findMarkBefore(this.endtime); + reader.seek(lastseg.getBytes()); + // number of entries skipped to get to the end of the iterator, less the number skipped to get to the start + long count = lastseg.getEntriesSkipped() - skippedAtStart; + + while ((e = readNextEntry()) != null) { + if (e.getTimestamp() > this.endtime) { + break; + } + count++; + } + reader.seek(pos);; + + return count; + } + + private LogEntry readNextEntry() { + LogEntry e = null; + try { + long crcValue; + byte[] bytes; + try { + crcValue = logStream.readLong("crcvalue"); + + bytes = logStream.readBuffer("txnEntry"); + } catch (EOFException ex) { + return null; + } + + if (bytes.length == 0) { + return null; + } + Checksum crc = new Adler32(); + crc.update(bytes, 0, bytes.length); + if (crcValue != crc.getValue()) { + throw new IOException("CRC doesn't match " + crcValue + + " vs " + crc.getValue()); + } + TxnHeader hdr = new TxnHeader(); + Record r = SerializeUtils.deserializeTxn(bytes, hdr); + + switch (hdr.getType()) { + case OpCode.createSession: { + e = new TransactionEntry(hdr.getTime(), hdr.getClientId(), hdr.getCxid(), hdr.getZxid(), "createSession"); + } + break; + case OpCode.closeSession: { + e = new TransactionEntry(hdr.getTime(), hdr.getClientId(), hdr.getCxid(), hdr.getZxid(), "closeSession"); + } + break; + case OpCode.create: + if (r != null) { + CreateTxn create = (CreateTxn)r; + String path = create.getPath(); + e = new TransactionEntry(hdr.getTime(), hdr.getClientId(), hdr.getCxid(), hdr.getZxid(), "create", path); + } + break; + case OpCode.setData: + if (r != null) { + SetDataTxn set = (SetDataTxn)r; + String path = set.getPath(); + e = new TransactionEntry(hdr.getTime(), hdr.getClientId(), hdr.getCxid(), hdr.getZxid(), "setData", path); + } + break; + case OpCode.setACL: + if (r != null) { + SetACLTxn setacl = (SetACLTxn)r; + String path = setacl.getPath(); + e = new TransactionEntry(hdr.getTime(), hdr.getClientId(), hdr.getCxid(), hdr.getZxid(), "setACL", path); + } + break; + case OpCode.error: + if (r != null) { + ErrorTxn error = (ErrorTxn)r; + + e = new TransactionEntry(hdr.getTime(), hdr.getClientId(), hdr.getCxid(), hdr.getZxid(), "error", "Error: " + error.getErr()); + } + break; + default: + LOG.info("Unknown op: " + hdr.getType()); + break; + } + + if (logStream.readByte("EOR") != 'B') { + throw new EOFException("Last transaction was partial."); + } + } catch (Exception ex) { + LOG.error("Error reading transaction from (" + src.file + ") :" + e); + return null; + } + return e; + } + + public boolean hasNext() { + return next != null; + } + + public LogEntry next() throws NoSuchElementException { + LogEntry ret = next; + LogEntry e = readNextEntry(); + + if (filter != null) { + try { + while (e != null && !filter.matches(e)) { + e = readNextEntry(); + } + } catch (FilterException fe) { + throw new NoSuchElementException(fe.toString()); + } + } + if (e != null && e.getTimestamp() < endtime) { + next = e; + } else { + next = null; + } + return ret; + } + + public void remove() throws UnsupportedOperationException { + throw new UnsupportedOperationException("remove not supported for Txn logs"); + } + + public void close() throws IOException { + reader.close(); + } + } + + public LogIterator iterator(long starttime, long endtime) throws IllegalArgumentException { + try { + return iterator(starttime, endtime, null); + } catch (FilterException fe) { + assert(false); // should never ever happen + return null; + } + } + + public LogIterator iterator(long starttime, long endtime, FilterOp filter) throws IllegalArgumentException, FilterException { + // sanitise start and end times + if (endtime < starttime) { + throw new IllegalArgumentException("End time (" + endtime + ") must be greater or equal to starttime (" + starttime + ")"); + } + + return new TxnLogSourceIterator(this, starttime, endtime, filter); + } + + public LogIterator iterator() throws IllegalArgumentException { + return iterator(starttime, endtime+1); + } + + public TxnLogSource(String file) throws IOException { + this.file = file; + + skiplist = new LogSkipList(); + + RandomAccessFileReader reader = new RandomAccessFileReader(new File(file)); + try { + BinaryInputArchive logStream = new BinaryInputArchive(reader); + FileHeader fhdr = new FileHeader(); + fhdr.deserialize(logStream, "fileheader"); + + byte[] bytes = null; + while (true) { + long lastFp = reader.getPosition(); + + long crcValue; + + try { + crcValue = logStream.readLong("crcvalue"); + bytes = logStream.readBuffer("txnEntry"); + } catch (EOFException e) { + break; + } + + if (bytes.length == 0) { + break; + } + Checksum crc = new Adler32(); + crc.update(bytes, 0, bytes.length); + if (crcValue != crc.getValue()) { + throw new IOException("CRC doesn't match " + crcValue + + " vs " + crc.getValue()); + } + if (logStream.readByte("EOR") != 'B') { + throw new EOFException("Last transaction was partial."); + } + TxnHeader hdr = new TxnHeader(); + Record r = SerializeUtils.deserializeTxn(bytes, hdr); + + if (starttime == 0) { + starttime = hdr.getTime(); + } + endtime = hdr.getTime(); + + if (size % skipN == 0) { + skiplist.addMark(hdr.getTime(), lastFp, size); + } + size++; + } + if (bytes == null) { + throw new IOException("Nothing read from ("+file+")"); + } + } finally { + reader.close(); + } + } + + public String toString() { + return "TxnLogSource(file=" + file + ", size=" + size + ", start=" + starttime + ", end=" + endtime +")"; + } + + public static void main(String[] args) throws IOException, FilterException { + TxnLogSource s = new TxnLogSource(args[0]); + System.out.println(s); + + LogIterator iter; + + if (args.length == 3) { + long starttime = Long.valueOf(args[1]); + long endtime = Long.valueOf(args[2]); + FilterOp fo = new FilterParser("(or (and (> zxid 0x2f0bd6f5e0) (< zxid 0x2f0bd6f5e9)) (= operation \"error\"))").parse(); + System.out.println("fo: " + fo); + iter = s.iterator(starttime, endtime, fo); + } else { + iter = s.iterator(); + } + System.out.println(iter); + while (iter.hasNext()) { + System.out.println(iter.next()); + } + iter.close(); + } +} diff --git a/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/AndOp.java b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/AndOp.java new file mode 100644 index 0000000..581bdaa --- /dev/null +++ b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/AndOp.java @@ -0,0 +1,33 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.graph.filterops; + +import org.apache.zookeeper.graph.LogEntry; +import org.apache.zookeeper.graph.FilterOp; +import org.apache.zookeeper.graph.FilterException; + +public class AndOp extends FilterOp { + public boolean matches(LogEntry entry) throws FilterException { + for (FilterOp f : subOps) { + if (!f.matches(entry)) { + return false; + } + } + return true; + } +} diff --git a/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/Arg.java b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/Arg.java new file mode 100644 index 0000000..4fda3cf --- /dev/null +++ b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/Arg.java @@ -0,0 +1,36 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.graph.filterops; + +import org.apache.zookeeper.graph.FilterOp.*; + +public class Arg { + private ArgType type; + protected T value; + + protected Arg(ArgType type) { + this.type = type; + } + + public ArgType getType() { return type; } + public T getValue() { return value; } + + public String toString() { + return "[" + type + ":" + value + "]"; + } +} diff --git a/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/EqualsOp.java b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/EqualsOp.java new file mode 100644 index 0000000..409815a --- /dev/null +++ b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/EqualsOp.java @@ -0,0 +1,44 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.graph.filterops; + +import org.apache.zookeeper.graph.LogEntry; +import org.apache.zookeeper.graph.FilterOp; +import org.apache.zookeeper.graph.FilterException; + +public class EqualsOp extends FilterOp { + public boolean matches(LogEntry entry) throws FilterException { + + Object last = null; + for (Arg a : args) { + Object v = a.getValue(); + if (a.getType() == FilterOp.ArgType.SYMBOL) { + String key = (String)a.getValue(); + v = entry.getAttribute(key); + } + + if (last != null + && !last.equals(v)) { + return false; + } + last = v; + } + + return true; + } +} diff --git a/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/GreaterThanOp.java b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/GreaterThanOp.java new file mode 100644 index 0000000..244dd3d --- /dev/null +++ b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/GreaterThanOp.java @@ -0,0 +1,70 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.graph.filterops; + +import org.apache.zookeeper.graph.LogEntry; +import org.apache.zookeeper.graph.FilterOp; +import org.apache.zookeeper.graph.FilterException; + +public class GreaterThanOp extends FilterOp { + public boolean matches(LogEntry entry) throws FilterException { + Arg first = args.get(0); + + if (first != null) { + FilterOp.ArgType type = first.getType(); + if (type == FilterOp.ArgType.SYMBOL) { + String key = (String)first.getValue(); + Object v = entry.getAttribute(key); + if (v instanceof String) { + type = FilterOp.ArgType.STRING; + } else if (v instanceof Double || v instanceof Long || v instanceof Integer || v instanceof Short) { + type = FilterOp.ArgType.NUMBER; + } else { + throw new FilterException("LessThanOp: Invalid argument, first argument resolves to neither a String nor a Number"); + } + } + + Object last = null; + for (Arg a : args) { + Object v = a.getValue(); + if (a.getType() == FilterOp.ArgType.SYMBOL) { + String key = (String)a.getValue(); + v = entry.getAttribute(key); + } + + if (last != null) { + if (type == FilterOp.ArgType.STRING) { + if (((String)last).compareTo((String)v) <= 0) { + return false; + } + } else if (type == FilterOp.ArgType.NUMBER) { + // System.out.println("last[" + ((Number)last).longValue() + "] v["+ ((Number)v).longValue() + "]"); + if (((Number)last).longValue() <= ((Number)v).longValue()) { + return false; + } + } + } + last = v; + } + return true; + } else { + return true; + } + } + +} diff --git a/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/LessThanOp.java b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/LessThanOp.java new file mode 100644 index 0000000..b7d9e09 --- /dev/null +++ b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/LessThanOp.java @@ -0,0 +1,69 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.graph.filterops; + +import org.apache.zookeeper.graph.LogEntry; +import org.apache.zookeeper.graph.FilterOp; +import org.apache.zookeeper.graph.FilterException; + +public class LessThanOp extends FilterOp { + public boolean matches(LogEntry entry) throws FilterException { + Arg first = args.get(0); + + if (first != null) { + FilterOp.ArgType type = first.getType(); + if (type == FilterOp.ArgType.SYMBOL) { + String key = (String)first.getValue(); + Object v = entry.getAttribute(key); + if (v instanceof String) { + type = FilterOp.ArgType.STRING; + } else if (v instanceof Double || v instanceof Long || v instanceof Integer || v instanceof Short) { + type = FilterOp.ArgType.NUMBER; + } else { + throw new FilterException("LessThanOp: Invalid argument, first argument resolves to neither a String nor a Number"); + } + } + + Object last = null; + for (Arg a : args) { + Object v = a.getValue(); + if (a.getType() == FilterOp.ArgType.SYMBOL) { + String key = (String)a.getValue(); + v = entry.getAttribute(key); + } + + if (last != null) { + if (type == FilterOp.ArgType.STRING) { + if (((String)last).compareTo((String)v) >= 0) { + return false; + } + } else if (type == FilterOp.ArgType.NUMBER) { + if (((Number)last).doubleValue() >= ((Number)v).doubleValue()) { + return false; + } + } + } + last = v; + } + return true; + } else { + return true; + } + } + +} diff --git a/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/NotOp.java b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/NotOp.java new file mode 100644 index 0000000..d8ed757 --- /dev/null +++ b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/NotOp.java @@ -0,0 +1,31 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.graph.filterops; + +import org.apache.zookeeper.graph.LogEntry; +import org.apache.zookeeper.graph.FilterOp; +import org.apache.zookeeper.graph.FilterException; + +public class NotOp extends FilterOp { + public boolean matches(LogEntry entry) throws FilterException { + if (subOps.size() != 1) { + throw new FilterException("Not operation can only take one argument"); + } + return !subOps.get(0).matches(entry); + } +} diff --git a/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/NumberArg.java b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/NumberArg.java new file mode 100644 index 0000000..d6b584d --- /dev/null +++ b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/NumberArg.java @@ -0,0 +1,28 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.graph.filterops; + +import org.apache.zookeeper.graph.FilterOp.*; + +public class NumberArg extends Arg { + public NumberArg(Long value) { + super(ArgType.NUMBER); + this.value = value; + } +}; + diff --git a/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/OrOp.java b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/OrOp.java new file mode 100644 index 0000000..d681589 --- /dev/null +++ b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/OrOp.java @@ -0,0 +1,33 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.graph.filterops; + +import org.apache.zookeeper.graph.LogEntry; +import org.apache.zookeeper.graph.FilterOp; +import org.apache.zookeeper.graph.FilterException; + +public class OrOp extends FilterOp { + public boolean matches(LogEntry entry) throws FilterException { + for (FilterOp f : subOps) { + if (f.matches(entry)) { + return true; + } + } + return false; + } +} diff --git a/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/StringArg.java b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/StringArg.java new file mode 100644 index 0000000..7345d3c --- /dev/null +++ b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/StringArg.java @@ -0,0 +1,28 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.graph.filterops; + +import org.apache.zookeeper.graph.FilterOp.*; + +public class StringArg extends Arg { + public StringArg(String value) { + super(ArgType.STRING); + this.value = value; + } +}; + diff --git a/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/SymbolArg.java b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/SymbolArg.java new file mode 100644 index 0000000..077553b --- /dev/null +++ b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/SymbolArg.java @@ -0,0 +1,27 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.graph.filterops; + +import org.apache.zookeeper.graph.FilterOp.*; + +public class SymbolArg extends Arg { + public SymbolArg(String value) { + super(ArgType.SYMBOL); + this.value = value; + } +}; diff --git a/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/XorOp.java b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/XorOp.java new file mode 100644 index 0000000..9e778b1 --- /dev/null +++ b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/filterops/XorOp.java @@ -0,0 +1,40 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.graph.filterops; + +import org.apache.zookeeper.graph.LogEntry; +import org.apache.zookeeper.graph.FilterOp; +import org.apache.zookeeper.graph.FilterException; + +public class XorOp extends FilterOp { + public boolean matches(LogEntry entry) throws FilterException { + int count = 0; + for (FilterOp f : subOps) { + if (f.matches(entry)) { + count++; + if (count > 1) { + return false; + } + } + } + if (count == 1) { + return true; + } + return false; + } +} diff --git a/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/servlets/FileLoader.java b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/servlets/FileLoader.java new file mode 100644 index 0000000..67e8945 --- /dev/null +++ b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/servlets/FileLoader.java @@ -0,0 +1,60 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.graph.servlets; + +import java.io.File; +import java.io.IOException; +import java.io.FileNotFoundException; + +import javax.servlet.ServletException; +import javax.servlet.http.HttpServlet; +import javax.servlet.http.HttpServletRequest; +import javax.servlet.http.HttpServletResponse; + +import org.json.simple.JSONArray; +import org.json.simple.JSONObject; +import org.json.simple.JSONValue; + +import org.apache.zookeeper.graph.*; + +public class FileLoader extends JsonServlet +{ + private MergedLogSource source = null; + + public FileLoader(MergedLogSource src) throws Exception { + source = src; + } + + String handleRequest(JsonRequest request) throws Exception + { + String output = ""; + + String file = request.getString("path", "/"); + JSONObject o = new JSONObject(); + try { + this.source.addSource(file); + o.put("status", "OK"); + + } catch (Exception e) { + o.put("status", "ERR"); + o.put("error", e.toString()); + } + + return JSONValue.toJSONString(o); + } +} diff --git a/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/servlets/Fs.java b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/servlets/Fs.java new file mode 100644 index 0000000..e5b1a01 --- /dev/null +++ b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/servlets/Fs.java @@ -0,0 +1,69 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.graph.servlets; + +import java.io.File; +import java.io.IOException; +import java.io.FileNotFoundException; + +import javax.servlet.ServletException; +import javax.servlet.http.HttpServlet; +import javax.servlet.http.HttpServletRequest; +import javax.servlet.http.HttpServletResponse; + +import org.json.simple.JSONArray; +import org.json.simple.JSONObject; +import org.json.simple.JSONValue; +import java.util.Arrays; +import java.util.Comparator; + +public class Fs extends JsonServlet +{ + String handleRequest(JsonRequest request) throws Exception + { + String output = ""; + JSONArray filelist = new JSONArray(); + + File base = new File(request.getString("path", "/")); + if (!base.exists() || !base.isDirectory()) { + throw new FileNotFoundException("Couldn't find [" + request + "]"); + } + File[] files = base.listFiles(); + Arrays.sort(files, new Comparator() { + public int compare(File o1, File o2) { + if (o1.isDirectory() != o2.isDirectory()) { + if (o1.isDirectory()) { + return -1; + } else { + return 1; + } + } + return o1.getName().compareToIgnoreCase(o2.getName()); + } + }); + + for (File f : files) { + JSONObject o = new JSONObject(); + o.put("file", f.getName()); + o.put("type", f.isDirectory() ? "D" : "F"); + o.put("path", f.getCanonicalPath()); + filelist.add(o); + } + return JSONValue.toJSONString(filelist); + } +} diff --git a/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/servlets/GraphData.java b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/servlets/GraphData.java new file mode 100644 index 0000000..fc10eb1 --- /dev/null +++ b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/servlets/GraphData.java @@ -0,0 +1,85 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.graph.servlets; + +import java.io.File; +import java.io.IOException; +import java.io.FileNotFoundException; + +import javax.servlet.ServletException; +import javax.servlet.http.HttpServlet; +import javax.servlet.http.HttpServletRequest; +import javax.servlet.http.HttpServletResponse; + +import java.util.regex.Pattern; +import java.util.regex.Matcher; + +import org.json.simple.JSONArray; +import org.json.simple.JSONObject; +import org.json.simple.JSONValue; + +import org.apache.zookeeper.graph.*; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +public class GraphData extends JsonServlet +{ + private static final Logger LOG = LoggerFactory.getLogger(GraphData.class); + private static final int DEFAULT_PERIOD = 1000; + + private LogSource source = null; + + public GraphData(LogSource src) throws Exception { + this.source = src; + } + + String handleRequest(JsonRequest request) throws Exception { + + + long starttime = 0; + long endtime = 0; + long period = 0; + FilterOp fo = null; + + starttime = request.getNumber("start", 0); + endtime = request.getNumber("end", 0); + period = request.getNumber("period", 0); + String filterstr = request.getString("filter", ""); + + if (filterstr.length() > 0) { + fo = new FilterParser(filterstr).parse(); + } + + if (starttime == 0) { starttime = source.getStartTime(); } + if (endtime == 0) { + if (period > 0) { + endtime = starttime + period; + } else { + endtime = starttime + DEFAULT_PERIOD; + } + } + + if (LOG.isDebugEnabled()) { + LOG.debug("handle(start= " + starttime + ", end=" + endtime + ", period=" + period + ")"); + } + + LogIterator iterator = (fo != null) ? + source.iterator(starttime, endtime, fo) : source.iterator(starttime, endtime); + return new JsonGenerator(iterator).toString(); + } +} diff --git a/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/servlets/JsonServlet.java b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/servlets/JsonServlet.java new file mode 100644 index 0000000..910d44f --- /dev/null +++ b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/servlets/JsonServlet.java @@ -0,0 +1,85 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.graph.servlets; + +import java.io.IOException; + +import javax.servlet.ServletException; +import javax.servlet.ServletRequest; +import javax.servlet.http.HttpServlet; +import javax.servlet.http.HttpServletRequest; +import javax.servlet.http.HttpServletResponse; + +import org.json.simple.JSONObject; +import org.json.simple.JSONValue; + +import java.util.Map; + +abstract public class JsonServlet extends HttpServlet { + abstract String handleRequest(JsonRequest request) throws Exception; + + protected class JsonRequest { + private Map map; + + public JsonRequest(ServletRequest request) { + map = request.getParameterMap(); + } + + public long getNumber(String name, long defaultnum) { + String[] vals = (String[])map.get(name); + if (vals == null || vals.length == 0) { + return defaultnum; + } + + try { + return Long.valueOf(vals[0]); + } catch (NumberFormatException e) { + return defaultnum; + } + } + + public String getString(String name, String defaultstr) { + String[] vals = (String[])map.get(name); + if (vals == null || vals.length == 0) { + return defaultstr; + } else { + return vals[0]; + } + } + } + + protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException + { + response.setContentType("text/plain;charset=utf-8"); + response.setStatus(HttpServletResponse.SC_OK); + + try { + String req = request.getRequestURI().substring(request.getServletPath().length()); + + response.getWriter().println(handleRequest(new JsonRequest(request))); + } catch (Exception e) { + JSONObject o = new JSONObject(); + o.put("error", e.toString()); + response.getWriter().println(JSONValue.toJSONString(o)); + } catch (java.lang.OutOfMemoryError oom) { + JSONObject o = new JSONObject(); + o.put("error", "Out of memory. Perhaps you've requested too many logs. Try narrowing you're filter criteria."); + response.getWriter().println(JSONValue.toJSONString(o)); + } + } +} diff --git a/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/servlets/NumEvents.java b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/servlets/NumEvents.java new file mode 100644 index 0000000..5961a12 --- /dev/null +++ b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/servlets/NumEvents.java @@ -0,0 +1,88 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.graph.servlets; + +import java.io.File; +import java.io.IOException; +import java.io.FileNotFoundException; + +import javax.servlet.ServletException; +import javax.servlet.http.HttpServlet; +import javax.servlet.http.HttpServletRequest; +import javax.servlet.http.HttpServletResponse; + +import org.json.simple.JSONArray; +import org.json.simple.JSONObject; +import org.json.simple.JSONValue; + +import java.util.regex.Pattern; +import java.util.regex.Matcher; + +import org.apache.zookeeper.graph.*; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + + +public class NumEvents extends JsonServlet +{ + private static final Logger LOG = LoggerFactory.getLogger(NumEvents.class); + private static final int DEFAULT_PERIOD = 1000; + + private LogSource source = null; + + public NumEvents(LogSource src) throws Exception { + this.source = src; + } + + String handleRequest(JsonRequest request) throws Exception { + String output = ""; + + long starttime = 0; + long endtime = 0; + long period = 0; + + starttime = request.getNumber("start", 0); + endtime = request.getNumber("end", 0); + period = request.getNumber("period", 0); + + if (starttime == 0) { starttime = source.getStartTime(); } + if (endtime == 0) { + if (period > 0) { + endtime = starttime + period; + } else { + endtime = source.getEndTime(); + } + } + + LogIterator iter = source.iterator(starttime, endtime); + JSONObject data = new JSONObject(); + data.put("startTime", starttime); + data.put("endTime", endtime); + long size = 0; + + size = iter.size(); + + data.put("numEntries", size); + if (LOG.isDebugEnabled()) { + LOG.debug("handle(start= " + starttime + ", end=" + endtime + ", numEntries=" + size +")"); + } + iter.close(); + return JSONValue.toJSONString(data); + } +} + diff --git a/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/servlets/StaticContent.java b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/servlets/StaticContent.java new file mode 100644 index 0000000..d91acb6 --- /dev/null +++ b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/servlets/StaticContent.java @@ -0,0 +1,53 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.graph.servlets; + +import java.io.InputStream; +import java.io.InputStreamReader; +import java.io.BufferedReader; + +import java.io.IOException; + +import javax.servlet.ServletException; +import javax.servlet.http.HttpServlet; +import javax.servlet.http.HttpServletRequest; +import javax.servlet.http.HttpServletResponse; + +public class StaticContent extends HttpServlet { + protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException + { + String path = request.getRequestURI().substring(request.getServletPath().length()); + + InputStream resource = ClassLoader.getSystemResourceAsStream("org/apache/zookeeper/graph/resources" + path); + if (resource == null) { + response.getWriter().println(path + " not found!"); + response.setStatus(HttpServletResponse.SC_NOT_FOUND); + return; + } + try { + while (resource.available() > 0) { + response.getWriter().write(resource.read()); + } + } finally { + resource.close(); + } + // response.setContentType("text/plain;charset=utf-8"); + response.setStatus(HttpServletResponse.SC_OK); + } + +} diff --git a/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/servlets/Throughput.java b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/servlets/Throughput.java new file mode 100644 index 0000000..341bf9e --- /dev/null +++ b/src/contrib/loggraph/src/java/org/apache/zookeeper/graph/servlets/Throughput.java @@ -0,0 +1,125 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.graph.servlets; + +import java.io.IOException; +import java.io.BufferedOutputStream; +import java.io.FileOutputStream; +import java.io.DataOutputStream; +import java.io.PrintStream; + +import java.util.HashSet; +import java.util.LinkedHashMap; + +import org.apache.zookeeper.graph.*; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import org.json.simple.JSONArray; +import org.json.simple.JSONObject; +import org.json.simple.JSONValue; + + +public class Throughput extends JsonServlet +{ + private static final int MS_PER_SEC = 1000; + private static final int MS_PER_MIN = MS_PER_SEC*60; + private static final int MS_PER_HOUR = MS_PER_MIN*60; + + private LogSource source = null; + + public Throughput(LogSource src) throws Exception { + this.source = src; + } + + public String handleRequest(JsonRequest request) throws Exception { + long starttime = 0; + long endtime = 0; + long period = 0; + long scale = 0; + + starttime = request.getNumber("start", 0); + endtime = request.getNumber("end", 0); + period = request.getNumber("period", 0); + + + if (starttime == 0) { starttime = source.getStartTime(); } + if (endtime == 0) { + if (period > 0) { + endtime = starttime + period; + } else { + endtime = source.getEndTime(); + } + } + + String scalestr = request.getString("scale", "minutes"); + if (scalestr.equals("seconds")) { + scale = MS_PER_SEC; + } else if (scalestr.equals("hours")) { + scale = MS_PER_HOUR; + } else { + scale = MS_PER_MIN; + } + + LogIterator iter = source.iterator(starttime, endtime); + + long current = 0; + long currentms = 0; + HashSet zxids_ms = new HashSet(); + long zxidcount = 0; + + JSONArray events = new JSONArray(); + while (iter.hasNext()) { + LogEntry e = iter.next(); + if (e.getType() != LogEntry.Type.TXN) { + continue; + } + + TransactionEntry cxn = (TransactionEntry)e; + + long ms = cxn.getTimestamp(); + long inscale = ms/scale; + + if (currentms != ms && currentms != 0) { + zxidcount += zxids_ms.size(); + zxids_ms.clear(); + } + + if (inscale != current && current != 0) { + JSONObject o = new JSONObject(); + o.put("time", current*scale); + o.put("count", zxidcount); + events.add(o); + zxidcount = 0; + } + current = inscale; + currentms = ms; + + zxids_ms.add(cxn.getZxid()); + } + JSONObject o = new JSONObject(); + o.put("time", current*scale); + o.put("count", zxidcount); + events.add(o); + + iter.close(); + + return JSONValue.toJSONString(events); + } + +}; diff --git a/src/contrib/loggraph/web/org/apache/zookeeper/graph/log4j.properties b/src/contrib/loggraph/web/org/apache/zookeeper/graph/log4j.properties new file mode 100644 index 0000000..ab8960b --- /dev/null +++ b/src/contrib/loggraph/web/org/apache/zookeeper/graph/log4j.properties @@ -0,0 +1,11 @@ +log4j.rootLogger=TRACE, CONSOLE + +# Print the date in ISO 8601 format +log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender +log4j.appender.CONSOLE.Threshold=TRACE +log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout +log4j.appender.CONSOLE.layout.ConversionPattern=%d{ISO8601} - %-5p [%t:%C{1}@%L] - %m%n + +log4j.logger.org.apache.zookeeper.graph.LogSkipList=off +log4j.logger.org.apache.zookeeper.graph.RandomAccessFileReader=off +#log4j.logger.org.apache.zookeeper.graph.Log4JSource=off \ No newline at end of file diff --git a/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/date.format.js b/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/date.format.js new file mode 100644 index 0000000..5515009 --- /dev/null +++ b/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/date.format.js @@ -0,0 +1,126 @@ +/* + * Date Format 1.2.3 + * (c) 2007-2009 Steven Levithan + * MIT license + * + * Includes enhancements by Scott Trenda + * and Kris Kowal + * + * Accepts a date, a mask, or a date and a mask. + * Returns a formatted version of the given date. + * The date defaults to the current date/time. + * The mask defaults to dateFormat.masks.default. + */ + +var dateFormat = function () { + var token = /d{1,4}|m{1,4}|yy(?:yy)?|([HhMsTt])\1?|[LloSZ]|"[^"]*"|'[^']*'/g, + timezone = /\b(?:[PMCEA][SDP]T|(?:Pacific|Mountain|Central|Eastern|Atlantic) (?:Standard|Daylight|Prevailing) Time|(?:GMT|UTC)(?:[-+]\d{4})?)\b/g, + timezoneClip = /[^-+\dA-Z]/g, + pad = function (val, len) { + val = String(val); + len = len || 2; + while (val.length < len) val = "0" + val; + return val; + }; + + // Regexes and supporting functions are cached through closure + return function (date, mask, utc) { + var dF = dateFormat; + + // You can't provide utc if you skip other args (use the "UTC:" mask prefix) + if (arguments.length == 1 && Object.prototype.toString.call(date) == "[object String]" && !/\d/.test(date)) { + mask = date; + date = undefined; + } + + // Passing date through Date applies Date.parse, if necessary + date = date ? new Date(date) : new Date; + if (isNaN(date)) throw SyntaxError("invalid date"); + + mask = String(dF.masks[mask] || mask || dF.masks["default"]); + + // Allow setting the utc argument via the mask + if (mask.slice(0, 4) == "UTC:") { + mask = mask.slice(4); + utc = true; + } + + var _ = utc ? "getUTC" : "get", + d = date[_ + "Date"](), + D = date[_ + "Day"](), + m = date[_ + "Month"](), + y = date[_ + "FullYear"](), + H = date[_ + "Hours"](), + M = date[_ + "Minutes"](), + s = date[_ + "Seconds"](), + L = date[_ + "Milliseconds"](), + o = utc ? 0 : date.getTimezoneOffset(), + flags = { + d: d, + dd: pad(d), + ddd: dF.i18n.dayNames[D], + dddd: dF.i18n.dayNames[D + 7], + m: m + 1, + mm: pad(m + 1), + mmm: dF.i18n.monthNames[m], + mmmm: dF.i18n.monthNames[m + 12], + yy: String(y).slice(2), + yyyy: y, + h: H % 12 || 12, + hh: pad(H % 12 || 12), + H: H, + HH: pad(H), + M: M, + MM: pad(M), + s: s, + ss: pad(s), + l: pad(L, 3), + L: pad(L > 99 ? Math.round(L / 10) : L), + t: H < 12 ? "a" : "p", + tt: H < 12 ? "am" : "pm", + T: H < 12 ? "A" : "P", + TT: H < 12 ? "AM" : "PM", + Z: utc ? "UTC" : (String(date).match(timezone) || [""]).pop().replace(timezoneClip, ""), + o: (o > 0 ? "-" : "+") + pad(Math.floor(Math.abs(o) / 60) * 100 + Math.abs(o) % 60, 4), + S: ["th", "st", "nd", "rd"][d % 10 > 3 ? 0 : (d % 100 - d % 10 != 10) * d % 10] + }; + + return mask.replace(token, function ($0) { + return $0 in flags ? flags[$0] : $0.slice(1, $0.length - 1); + }); + }; +}(); + +// Some common format strings +dateFormat.masks = { + "default": "ddd mmm dd yyyy HH:MM:ss", + shortDate: "m/d/yy", + mediumDate: "mmm d, yyyy", + longDate: "mmmm d, yyyy", + fullDate: "dddd, mmmm d, yyyy", + shortTime: "h:MM TT", + mediumTime: "h:MM:ss TT", + longTime: "h:MM:ss TT Z", + isoDate: "yyyy-mm-dd", + isoTime: "HH:MM:ss", + isoDateTime: "yyyy-mm-dd'T'HH:MM:ss", + isoUtcDateTime: "UTC:yyyy-mm-dd'T'HH:MM:ss'Z'" +}; + +// Internationalization strings +dateFormat.i18n = { + dayNames: [ + "Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat", + "Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday" + ], + monthNames: [ + "Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec", + "January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December" + ] +}; + +// For convenience... +Date.prototype.format = function (mask, utc) { + return dateFormat(this, mask, utc); +}; + diff --git a/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/g.bar.js b/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/g.bar.js new file mode 100644 index 0000000..2f7212a --- /dev/null +++ b/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/g.bar.js @@ -0,0 +1,385 @@ +/* + * g.Raphael 0.4 - Charting library, based on Raphaël + * + * Copyright (c) 2009 Dmitry Baranovskiy (http://g.raphaeljs.com) + * Licensed under the MIT (http://www.opensource.org/licenses/mit-license.php) license. + */ +Raphael.fn.g.barchart = function (x, y, width, height, values, opts) { + opts = opts || {}; + var type = {round: "round", sharp: "sharp", soft: "soft"}[opts.type] || "square", + gutter = parseFloat(opts.gutter || "20%"), + chart = this.set(), + bars = this.set(), + covers = this.set(), + covers2 = this.set(), + total = Math.max.apply(Math, values), + stacktotal = [], + paper = this, + multi = 0, + colors = opts.colors || this.g.colors, + len = values.length; + if (this.raphael.is(values[0], "array")) { + total = []; + multi = len; + len = 0; + for (var i = values.length; i--;) { + bars.push(this.set()); + total.push(Math.max.apply(Math, values[i])); + len = Math.max(len, values[i].length); + } + if (opts.stacked) { + for (var i = len; i--;) { + var tot = 0; + for (var j = values.length; j--;) { + tot +=+ values[j][i] || 0; + } + stacktotal.push(tot); + } + } + for (var i = values.length; i--;) { + if (values[i].length < len) { + for (var j = len; j--;) { + values[i].push(0); + } + } + } + total = Math.max.apply(Math, opts.stacked ? stacktotal : total); + } + + total = (opts.to) || total; + var barwidth = width / (len * (100 + gutter) + gutter) * 100, + barhgutter = barwidth * gutter / 100, + barvgutter = opts.vgutter == null ? 20 : opts.vgutter, + stack = [], + X = x + barhgutter, + Y = (height - 2 * barvgutter) / total; + if (!opts.stretch) { + barhgutter = Math.round(barhgutter); + barwidth = Math.floor(barwidth); + } + !opts.stacked && (barwidth /= multi || 1); + for (var i = 0; i < len; i++) { + stack = []; + for (var j = 0; j < (multi || 1); j++) { + var h = Math.round((multi ? values[j][i] : values[i]) * Y), + top = y + height - barvgutter - h, + bar = this.g.finger(Math.round(X + barwidth / 2), top + h, barwidth, h, true, type).attr({stroke: colors[multi ? j : i], fill: colors[multi ? j : i]}); + if (multi) { + bars[j].push(bar); + } else { + bars.push(bar); + } + bar.y = top; + bar.x = Math.round(X + barwidth / 2); + bar.w = barwidth; + bar.h = h; + bar.value = multi ? values[j][i] : values[i]; + if (!opts.stacked) { + X += barwidth; + } else { + stack.push(bar); + } + } + if (opts.stacked) { + var cvr; + covers2.push(cvr = this.rect(stack[0].x - stack[0].w / 2, y, barwidth, height).attr(this.g.shim)); + cvr.bars = this.set(); + var size = 0; + for (var s = stack.length; s--;) { + stack[s].toFront(); + } + for (var s = 0, ss = stack.length; s < ss; s++) { + var bar = stack[s], + cover, + h = (size + bar.value) * Y, + path = this.g.finger(bar.x, y + height - barvgutter - !!size * .5, barwidth, h, true, type, 1); + cvr.bars.push(bar); + size && bar.attr({path: path}); + bar.h = h; + bar.y = y + height - barvgutter - !!size * .5 - h; + covers.push(cover = this.rect(bar.x - bar.w / 2, bar.y, barwidth, bar.value * Y).attr(this.g.shim)); + cover.bar = bar; + cover.value = bar.value; + size += bar.value; + } + X += barwidth; + } + X += barhgutter; + } + covers2.toFront(); + X = x + barhgutter; + if (!opts.stacked) { + for (var i = 0; i < len; i++) { + for (var j = 0; j < (multi || 1); j++) { + var cover; + covers.push(cover = this.rect(Math.round(X), y + barvgutter, barwidth, height - barvgutter).attr(this.g.shim)); + cover.bar = multi ? bars[j][i] : bars[i]; + cover.value = cover.bar.value; + X += barwidth; + } + X += barhgutter; + } + } + chart.label = function (labels, isBottom) { + labels = labels || []; + this.labels = paper.set(); + var L, l = -Infinity; + if (opts.stacked) { + for (var i = 0; i < len; i++) { + var tot = 0; + for (var j = 0; j < (multi || 1); j++) { + tot += multi ? values[j][i] : values[i]; + if (j == multi - 1) { + var label = paper.g.labelise(labels[i], tot, total); + L = paper.g.text(bars[i * (multi || 1) + j].x, y + height - barvgutter / 2, label).insertBefore(covers[i * (multi || 1) + j]); + var bb = L.getBBox(); + if (bb.x - 7 < l) { + L.remove(); + } else { + this.labels.push(L); + l = bb.x + bb.width; + } + } + } + } + } else { + for (var i = 0; i < len; i++) { + for (var j = 0; j < (multi || 1); j++) { + var label = paper.g.labelise(multi ? labels[j] && labels[j][i] : labels[i], multi ? values[j][i] : values[i], total); + L = paper.g.text(bars[i * (multi || 1) + j].x, isBottom ? y + height - barvgutter / 2 : bars[i * (multi || 1) + j].y - 10, label).insertBefore(covers[i * (multi || 1) + j]); + var bb = L.getBBox(); + if (bb.x - 7 < l) { + L.remove(); + } else { + this.labels.push(L); + l = bb.x + bb.width; + } + } + } + } + return this; + }; + chart.hover = function (fin, fout) { + covers2.hide(); + covers.show(); + covers.mouseover(fin).mouseout(fout); + return this; + }; + chart.hoverColumn = function (fin, fout) { + covers.hide(); + covers2.show(); + fout = fout || function () {}; + covers2.mouseover(fin).mouseout(fout); + return this; + }; + chart.click = function (f) { + covers2.hide(); + covers.show(); + covers.click(f); + return this; + }; + chart.each = function (f) { + if (!Raphael.is(f, "function")) { + return this; + } + for (var i = covers.length; i--;) { + f.call(covers[i]); + } + return this; + }; + chart.eachColumn = function (f) { + if (!Raphael.is(f, "function")) { + return this; + } + for (var i = covers2.length; i--;) { + f.call(covers2[i]); + } + return this; + }; + chart.clickColumn = function (f) { + covers.hide(); + covers2.show(); + covers2.click(f); + return this; + }; + chart.push(bars, covers, covers2); + chart.bars = bars; + chart.covers = covers; + return chart; +}; +Raphael.fn.g.hbarchart = function (x, y, width, height, values, opts) { + opts = opts || {}; + var type = {round: "round", sharp: "sharp", soft: "soft"}[opts.type] || "square", + gutter = parseFloat(opts.gutter || "20%"), + chart = this.set(), + bars = this.set(), + covers = this.set(), + covers2 = this.set(), + total = Math.max.apply(Math, values), + stacktotal = [], + paper = this, + multi = 0, + colors = opts.colors || this.g.colors, + len = values.length; + if (this.raphael.is(values[0], "array")) { + total = []; + multi = len; + len = 0; + for (var i = values.length; i--;) { + bars.push(this.set()); + total.push(Math.max.apply(Math, values[i])); + len = Math.max(len, values[i].length); + } + if (opts.stacked) { + for (var i = len; i--;) { + var tot = 0; + for (var j = values.length; j--;) { + tot +=+ values[j][i] || 0; + } + stacktotal.push(tot); + } + } + for (var i = values.length; i--;) { + if (values[i].length < len) { + for (var j = len; j--;) { + values[i].push(0); + } + } + } + total = Math.max.apply(Math, opts.stacked ? stacktotal : total); + } + + total = (opts.to) || total; + var barheight = Math.floor(height / (len * (100 + gutter) + gutter) * 100), + bargutter = Math.floor(barheight * gutter / 100), + stack = [], + Y = y + bargutter, + X = (width - 1) / total; + !opts.stacked && (barheight /= multi || 1); + for (var i = 0; i < len; i++) { + stack = []; + for (var j = 0; j < (multi || 1); j++) { + var val = multi ? values[j][i] : values[i], + bar = this.g.finger(x, Y + barheight / 2, Math.round(val * X), barheight - 1, false, type).attr({stroke: colors[multi ? j : i], fill: colors[multi ? j : i]}); + if (multi) { + bars[j].push(bar); + } else { + bars.push(bar); + } + bar.x = x + Math.round(val * X); + bar.y = Y + barheight / 2; + bar.w = Math.round(val * X); + bar.h = barheight; + bar.value = +val; + if (!opts.stacked) { + Y += barheight; + } else { + stack.push(bar); + } + } + if (opts.stacked) { + var cvr = this.rect(x, stack[0].y - stack[0].h / 2, width, barheight).attr(this.g.shim); + covers2.push(cvr); + cvr.bars = this.set(); + var size = 0; + for (var s = stack.length; s--;) { + stack[s].toFront(); + } + for (var s = 0, ss = stack.length; s < ss; s++) { + var bar = stack[s], + cover, + val = Math.round((size + bar.value) * X), + path = this.g.finger(x, bar.y, val, barheight - 1, false, type, 1); + cvr.bars.push(bar); + size && bar.attr({path: path}); + bar.w = val; + bar.x = x + val; + covers.push(cover = this.rect(x + size * X, bar.y - bar.h / 2, bar.value * X, barheight).attr(this.g.shim)); + cover.bar = bar; + size += bar.value; + } + Y += barheight; + } + Y += bargutter; + } + covers2.toFront(); + Y = y + bargutter; + if (!opts.stacked) { + for (var i = 0; i < len; i++) { + for (var j = 0; j < multi; j++) { + var cover = this.rect(x, Y, width, barheight).attr(this.g.shim); + covers.push(cover); + cover.bar = bars[j][i]; + Y += barheight; + } + Y += bargutter; + } + } + chart.label = function (labels, isRight) { + labels = labels || []; + this.labels = paper.set(); + for (var i = 0; i < len; i++) { + for (var j = 0; j < multi; j++) { + var label = paper.g.labelise(multi ? labels[j] && labels[j][i] : labels[i], multi ? values[j][i] : values[i], total); + var X = isRight ? bars[i * (multi || 1) + j].x - barheight / 2 + 3 : x + 5, + A = isRight ? "end" : "start", + L; + this.labels.push(L = paper.g.text(X, bars[i * (multi || 1) + j].y, label).attr({"text-anchor": A}).insertBefore(covers[0])); + if (L.getBBox().x < x + 5) { + L.attr({x: x + 5, "text-anchor": "start"}); + } else { + bars[i * (multi || 1) + j].label = L; + } + } + } + return this; + }; + chart.hover = function (fin, fout) { + covers2.hide(); + covers.show(); + fout = fout || function () {}; + covers.mouseover(fin).mouseout(fout); + return this; + }; + chart.hoverColumn = function (fin, fout) { + covers.hide(); + covers2.show(); + fout = fout || function () {}; + covers2.mouseover(fin).mouseout(fout); + return this; + }; + chart.each = function (f) { + if (!Raphael.is(f, "function")) { + return this; + } + for (var i = covers.length; i--;) { + f.call(covers[i]); + } + return this; + }; + chart.eachColumn = function (f) { + if (!Raphael.is(f, "function")) { + return this; + } + for (var i = covers2.length; i--;) { + f.call(covers2[i]); + } + return this; + }; + chart.click = function (f) { + covers2.hide(); + covers.show(); + covers.click(f); + return this; + }; + chart.clickColumn = function (f) { + covers.hide(); + covers2.show(); + covers2.click(f); + return this; + }; + chart.push(bars, covers, covers2); + chart.bars = bars; + chart.covers = covers; + return chart; +}; diff --git a/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/g.dot.js b/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/g.dot.js new file mode 100644 index 0000000..2821e62 --- /dev/null +++ b/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/g.dot.js @@ -0,0 +1,110 @@ +/* + * g.Raphael 0.4 - Charting library, based on Raphaël + * + * Copyright (c) 2009 Dmitry Baranovskiy (http://g.raphaeljs.com) + * Licensed under the MIT (http://www.opensource.org/licenses/mit-license.php) license. + */ +Raphael.fn.g.dotchart = function (x, y, width, height, valuesx, valuesy, size, opts) { + function drawAxis(ax) { + +ax[0] && (ax[0] = paper.g.axis(x + gutter, y + gutter, width - 2 * gutter, minx, maxx, opts.axisxstep || Math.floor((width - 2 * gutter) / 20), 2, opts.axisxlabels || null, opts.axisxtype || "t")); + +ax[1] && (ax[1] = paper.g.axis(x + width - gutter, y + height - gutter, height - 2 * gutter, miny, maxy, opts.axisystep || Math.floor((height - 2 * gutter) / 20), 3, opts.axisylabels || null, opts.axisytype || "t")); + +ax[2] && (ax[2] = paper.g.axis(x + gutter, y + height - gutter + maxR, width - 2 * gutter, minx, maxx, opts.axisxstep || Math.floor((width - 2 * gutter) / 20), 0, opts.axisxlabels || null, opts.axisxtype || "t")); + +ax[3] && (ax[3] = paper.g.axis(x + gutter - maxR, y + height - gutter, height - 2 * gutter, miny, maxy, opts.axisystep || Math.floor((height - 2 * gutter) / 20), 1, opts.axisylabels || null, opts.axisytype || "t")); + } + opts = opts || {}; + var xdim = this.g.snapEnds(Math.min.apply(Math, valuesx), Math.max.apply(Math, valuesx), valuesx.length - 1), + minx = xdim.from, + maxx = xdim.to, + gutter = opts.gutter || 10, + ydim = this.g.snapEnds(Math.min.apply(Math, valuesy), Math.max.apply(Math, valuesy), valuesy.length - 1), + miny = ydim.from, + maxy = ydim.to, + len = Math.max(valuesx.length, valuesy.length, size.length), + symbol = this.g.markers[opts.symbol] || "disc", + res = this.set(), + series = this.set(), + max = opts.max || 100, + top = Math.max.apply(Math, size), + R = [], + paper = this, + k = Math.sqrt(top / Math.PI) * 2 / max; + + for (var i = 0; i < len; i++) { + R[i] = Math.min(Math.sqrt(size[i] / Math.PI) * 2 / k, max); + } + gutter = Math.max.apply(Math, R.concat(gutter)); + var axis = this.set(), + maxR = Math.max.apply(Math, R); + if (opts.axis) { + var ax = (opts.axis + "").split(/[,\s]+/); + drawAxis(ax); + var g = [], b = []; + for (var i = 0, ii = ax.length; i < ii; i++) { + var bb = ax[i].all ? ax[i].all.getBBox()[["height", "width"][i % 2]] : 0; + g[i] = bb + gutter; + b[i] = bb; + } + gutter = Math.max.apply(Math, g.concat(gutter)); + for (var i = 0, ii = ax.length; i < ii; i++) if (ax[i].all) { + ax[i].remove(); + ax[i] = 1; + } + drawAxis(ax); + for (var i = 0, ii = ax.length; i < ii; i++) if (ax[i].all) { + axis.push(ax[i].all); + } + res.axis = axis; + } + var kx = (width - gutter * 2) / ((maxx - minx) || 1), + ky = (height - gutter * 2) / ((maxy - miny) || 1); + for (var i = 0, ii = valuesy.length; i < ii; i++) { + var sym = this.raphael.is(symbol, "array") ? symbol[i] : symbol, + X = x + gutter + (valuesx[i] - minx) * kx, + Y = y + height - gutter - (valuesy[i] - miny) * ky; + sym && R[i] && series.push(this.g[sym](X, Y, R[i]).attr({fill: opts.heat ? this.g.colorValue(R[i], maxR) : Raphael.fn.g.colors[0], "fill-opacity": opts.opacity ? R[i] / max : 1, stroke: "none"})); + } + var covers = this.set(); + for (var i = 0, ii = valuesy.length; i < ii; i++) { + var X = x + gutter + (valuesx[i] - minx) * kx, + Y = y + height - gutter - (valuesy[i] - miny) * ky; + covers.push(this.circle(X, Y, maxR).attr(this.g.shim)); + opts.href && opts.href[i] && covers[i].attr({href: opts.href[i]}); + covers[i].r = +R[i].toFixed(3); + covers[i].x = +X.toFixed(3); + covers[i].y = +Y.toFixed(3); + covers[i].X = valuesx[i]; + covers[i].Y = valuesy[i]; + covers[i].value = size[i] || 0; + covers[i].dot = series[i]; + } + res.covers = covers; + res.series = series; + res.push(series, axis, covers); + res.hover = function (fin, fout) { + covers.mouseover(fin).mouseout(fout); + return this; + }; + res.click = function (f) { + covers.click(f); + return this; + }; + res.each = function (f) { + if (!Raphael.is(f, "function")) { + return this; + } + for (var i = covers.length; i--;) { + f.call(covers[i]); + } + return this; + }; + res.href = function (map) { + var cover; + for (var i = covers.length; i--;) { + cover = covers[i]; + if (cover.X == map.x && cover.Y == map.y && cover.value == map.value) { + cover.attr({href: map.href}); + } + } + }; + return res; +}; diff --git a/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/g.line.js b/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/g.line.js new file mode 100644 index 0000000..eb56e59 --- /dev/null +++ b/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/g.line.js @@ -0,0 +1,230 @@ +/* + * g.Raphael 0.4 - Charting library, based on Raphaël + * + * Copyright (c) 2009 Dmitry Baranovskiy (http://g.raphaeljs.com) + * Licensed under the MIT (http://www.opensource.org/licenses/mit-license.php) license. + */ +Raphael.fn.g.linechart = function (x, y, width, height, valuesx, valuesy, opts) { + function shrink(values, dim) { + var k = values.length / dim, + j = 0, + l = k, + sum = 0, + res = []; + while (j < values.length) { + l--; + if (l < 0) { + sum += values[j] * (1 + l); + res.push(sum / k); + sum = values[j++] * -l; + l += k; + } else { + sum += values[j++]; + } + } + return res; + } + opts = opts || {}; + if (!this.raphael.is(valuesx[0], "array")) { + valuesx = [valuesx]; + } + if (!this.raphael.is(valuesy[0], "array")) { + valuesy = [valuesy]; + } + var allx = Array.prototype.concat.apply([], valuesx), + ally = Array.prototype.concat.apply([], valuesy), + xdim = this.g.snapEnds(Math.min.apply(Math, allx), Math.max.apply(Math, allx), valuesx[0].length - 1), + minx = xdim.from, + maxx = xdim.to, + gutter = opts.gutter || 10, + kx = (width - gutter * 2) / (maxx - minx), + ydim = this.g.snapEnds(Math.min.apply(Math, ally), Math.max.apply(Math, ally), valuesy[0].length - 1), + miny = ydim.from, + maxy = ydim.to, + ky = (height - gutter * 2) / (maxy - miny), + len = Math.max(valuesx[0].length, valuesy[0].length), + symbol = opts.symbol || "", + colors = opts.colors || Raphael.fn.g.colors, + that = this, + columns = null, + dots = null, + chart = this.set(), + path = []; + + for (var i = 0, ii = valuesy.length; i < ii; i++) { + len = Math.max(len, valuesy[i].length); + } + var shades = this.set(); + for (var i = 0, ii = valuesy.length; i < ii; i++) { + if (opts.shade) { + shades.push(this.path().attr({stroke: "none", fill: colors[i], opacity: opts.nostroke ? 1 : .3})); + } + if (valuesy[i].length > width - 2 * gutter) { + valuesy[i] = shrink(valuesy[i], width - 2 * gutter); + len = width - 2 * gutter; + } + if (valuesx[i] && valuesx[i].length > width - 2 * gutter) { + valuesx[i] = shrink(valuesx[i], width - 2 * gutter); + } + } + var axis = this.set(); + if (opts.axis) { + var ax = (opts.axis + "").split(/[,\s]+/); + +ax[0] && axis.push(this.g.axis(x + gutter, y + gutter, width - 2 * gutter, minx, maxx, opts.axisxstep || Math.floor((width - 2 * gutter) / 20), 2, opts.northlabels)); + +ax[1] && axis.push(this.g.axis(x + width - gutter, y + height - gutter, height - 2 * gutter, miny, maxy, opts.axisystep || Math.floor((height - 2 * gutter) / 20), 3, opts.eastlabels)); + +ax[2] && axis.push(this.g.axis(x + gutter, y + height - gutter, width - 2 * gutter, minx, maxx, opts.axisxstep || Math.floor((width - 2 * gutter) / 20), 0, opts.southlabels)); + +ax[3] && axis.push(this.g.axis(x + gutter, y + height - gutter, height - 2 * gutter, miny, maxy, opts.axisystep || Math.floor((height - 2 * gutter) / 20), 1, opts.westlabels)); + } + if (opts.northAxisLabel) { + this.g.text(x + gutter + width/2, gutter, opts.northAxisLabel); + } + if (opts.southAxisLabel) { + this.g.text(x + gutter + width/2, y + height + 20, opts.southAxisLabel); + } + if (opts.westAxisLabel) { + this.g.text(gutter, y + gutter + height/2, opts.westAxisLabel).attr({rotation: -90}); + } + if (opts.eastAxisLabel) { + this.g.text(x + gutter + width + 20, y + gutter + height/2, opts.eastAxisLabel).attr({rotation: 90}); + } + + var lines = this.set(), + symbols = this.set(), + line; + for (var i = 0, ii = valuesy.length; i < ii; i++) { + if (!opts.nostroke) { + lines.push(line = this.path().attr({ + stroke: colors[i], + "stroke-width": opts.width || 2, + "stroke-linejoin": "round", + "stroke-linecap": "round", + "stroke-dasharray": opts.dash || "" + })); + } + var sym = this.raphael.is(symbol, "array") ? symbol[i] : symbol, + symset = this.set(); + path = []; + for (var j = 0, jj = valuesy[i].length; j < jj; j++) { + var X = x + gutter + ((valuesx[i] || valuesx[0])[j] - minx) * kx; + var Y = y + height - gutter - (valuesy[i][j] - miny) * ky; + (Raphael.is(sym, "array") ? sym[j] : sym) && symset.push(this.g[Raphael.fn.g.markers[this.raphael.is(sym, "array") ? sym[j] : sym]](X, Y, (opts.width || 2) * 3).attr({fill: colors[i], stroke: "none"})); + path = path.concat([j ? "L" : "M", X, Y]); + } + symbols.push(symset); + if (opts.shade) { + shades[i].attr({path: path.concat(["L", X, y + height - gutter, "L", x + gutter + ((valuesx[i] || valuesx[0])[0] - minx) * kx, y + height - gutter, "z"]).join(",")}); + } + !opts.nostroke && line.attr({path: path.join(",")}); + } + function createColumns(f) { + // unite Xs together + var Xs = []; + for (var i = 0, ii = valuesx.length; i < ii; i++) { + Xs = Xs.concat(valuesx[i]); + } + Xs.sort(); + // remove duplicates + var Xs2 = [], + xs = []; + for (var i = 0, ii = Xs.length; i < ii; i++) { + Xs[i] != Xs[i - 1] && Xs2.push(Xs[i]) && xs.push(x + gutter + (Xs[i] - minx) * kx); + } + Xs = Xs2; + ii = Xs.length; + var cvrs = f || that.set(); + for (var i = 0; i < ii; i++) { + var X = xs[i] - (xs[i] - (xs[i - 1] || x)) / 2, + w = ((xs[i + 1] || x + width) - xs[i]) / 2 + (xs[i] - (xs[i - 1] || x)) / 2, + C; + f ? (C = {}) : cvrs.push(C = that.rect(X - 1, y, Math.max(w + 1, 1), height).attr({stroke: "none", fill: "#000", opacity: 0})); + C.values = []; + C.symbols = that.set(); + C.y = []; + C.x = xs[i]; + C.axis = Xs[i]; + for (var j = 0, jj = valuesy.length; j < jj; j++) { + Xs2 = valuesx[j] || valuesx[0]; + for (var k = 0, kk = Xs2.length; k < kk; k++) { + if (Xs2[k] == Xs[i]) { + C.values.push(valuesy[j][k]); + C.y.push(y + height - gutter - (valuesy[j][k] - miny) * ky); + C.symbols.push(chart.symbols[j][k]); + } + } + } + f && f.call(C); + } + !f && (columns = cvrs); + } + function createDots(f) { + var cvrs = f || that.set(), + C; + for (var i = 0, ii = valuesy.length; i < ii; i++) { + for (var j = 0, jj = valuesy[i].length; j < jj; j++) { + var X = x + gutter + ((valuesx[i] || valuesx[0])[j] - minx) * kx, + nearX = x + gutter + ((valuesx[i] || valuesx[0])[j ? j - 1 : 1] - minx) * kx, + Y = y + height - gutter - (valuesy[i][j] - miny) * ky; + f ? (C = {}) : cvrs.push(C = that.circle(X, Y, Math.abs(nearX - X) / 2).attr({stroke: "none", fill: "#000", opacity: 0})); + C.x = X; + C.y = Y; + C.value = valuesy[i][j]; + C.line = chart.lines[i]; + C.shade = chart.shades[i]; + C.symbol = chart.symbols[i][j]; + C.symbols = chart.symbols[i]; + C.axis = (valuesx[i] || valuesx[0])[j]; + f && f.call(C); + } + } + !f && (dots = cvrs); + } + chart.push(lines, shades, symbols, axis, columns, dots); + chart.lines = lines; + chart.shades = shades; + chart.symbols = symbols; + chart.axis = axis; + chart.hoverColumn = function (fin, fout) { + !columns && createColumns(); + columns.mouseover(fin).mouseout(fout); + return this; + }; + chart.clickColumn = function (f) { + !columns && createColumns(); + columns.click(f); + return this; + }; + chart.hrefColumn = function (cols) { + var hrefs = that.raphael.is(arguments[0], "array") ? arguments[0] : arguments; + if (!(arguments.length - 1) && typeof cols == "object") { + for (var x in cols) { + for (var i = 0, ii = columns.length; i < ii; i++) if (columns[i].axis == x) { + columns[i].attr("href", cols[x]); + } + } + } + !columns && createColumns(); + for (var i = 0, ii = hrefs.length; i < ii; i++) { + columns[i] && columns[i].attr("href", hrefs[i]); + } + return this; + }; + chart.hover = function (fin, fout) { + !dots && createDots(); + dots.mouseover(fin).mouseout(fout); + return this; + }; + chart.click = function (f) { + !dots && createDots(); + dots.click(f); + return this; + }; + chart.each = function (f) { + createDots(f); + return this; + }; + chart.eachColumn = function (f) { + createColumns(f); + return this; + }; + return chart; +}; diff --git a/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/g.pie.js b/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/g.pie.js new file mode 100644 index 0000000..8d20374 --- /dev/null +++ b/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/g.pie.js @@ -0,0 +1,205 @@ +/* + * g.Raphael 0.4 - Charting library, based on Raphaël + * + * Copyright (c) 2009 Dmitry Baranovskiy (http://g.raphaeljs.com) + * Licensed under the MIT (http://www.opensource.org/licenses/mit-license.php) license. + */ +Raphael.fn.g.piechart = function (cx, cy, r, values, opts) { + opts = opts || {}; + var paper = this, + sectors = [], + covers = this.set(), + chart = this.set(), + series = this.set(), + order = [], + len = values.length, + angle = 0, + total = 0, + others = 0, + cut = 9, + defcut = true; + chart.covers = covers; + if (len == 1) { + series.push(this.circle(cx, cy, r).attr({fill: this.g.colors[0], stroke: opt.stroke || "#fff", "stroke-width": opts.strokewidth == null ? 1 : opts.strokewidth})); + covers.push(this.circle(cx, cy, r).attr(this.g.shim)); + total = values[0]; + values[0] = {value: values[0], order: 0, valueOf: function () { return this.value; }}; + series[0].middle = {x: cx, y: cy}; + series[0].mangle = 180; + } else { + function sector(cx, cy, r, startAngle, endAngle, fill) { + var rad = Math.PI / 180, + x1 = cx + r * Math.cos(-startAngle * rad), + x2 = cx + r * Math.cos(-endAngle * rad), + xm = cx + r / 2 * Math.cos(-(startAngle + (endAngle - startAngle) / 2) * rad), + y1 = cy + r * Math.sin(-startAngle * rad), + y2 = cy + r * Math.sin(-endAngle * rad), + ym = cy + r / 2 * Math.sin(-(startAngle + (endAngle - startAngle) / 2) * rad), + res = ["M", cx, cy, "L", x1, y1, "A", r, r, 0, +(Math.abs(endAngle - startAngle) > 180), 1, x2, y2, "z"]; + res.middle = {x: xm, y: ym}; + return res; + } + for (var i = 0; i < len; i++) { + total += values[i]; + values[i] = {value: values[i], order: i, valueOf: function () { return this.value; }}; + } + values.sort(function (a, b) { + return b.value - a.value; + }); + for (var i = 0; i < len; i++) { + if (defcut && values[i] * 360 / total <= 1.5) { + cut = i; + defcut = false; + } + if (i > cut) { + defcut = false; + values[cut].value += values[i]; + values[cut].others = true; + others = values[cut].value; + } + } + len = Math.min(cut + 1, values.length); + others && values.splice(len) && (values[cut].others = true); + for (var i = 0; i < len; i++) { + var mangle = angle - 360 * values[i] / total / 2; + if (!i) { + angle = 90 - mangle; + mangle = angle - 360 * values[i] / total / 2; + } + if (opts.init) { + var ipath = sector(cx, cy, 1, angle, angle - 360 * values[i] / total).join(","); + } + var path = sector(cx, cy, r, angle, angle -= 360 * values[i] / total); + var p = this.path(opts.init ? ipath : path).attr({fill: opts.colors && opts.colors[i] || this.g.colors[i] || "#666", stroke: opts.stroke || "#fff", "stroke-width": (opts.strokewidth == null ? 1 : opts.strokewidth), "stroke-linejoin": "round"}); + p.value = values[i]; + p.middle = path.middle; + p.mangle = mangle; + sectors.push(p); + series.push(p); + opts.init && p.animate({path: path.join(",")}, (+opts.init - 1) || 1000, ">"); + } + for (var i = 0; i < len; i++) { + var p = paper.path(sectors[i].attr("path")).attr(this.g.shim); + opts.href && opts.href[i] && p.attr({href: opts.href[i]}); + p.attr = function () {}; + covers.push(p); + series.push(p); + } + } + + chart.hover = function (fin, fout) { + fout = fout || function () {}; + var that = this; + for (var i = 0; i < len; i++) { + (function (sector, cover, j) { + var o = { + sector: sector, + cover: cover, + cx: cx, + cy: cy, + mx: sector.middle.x, + my: sector.middle.y, + mangle: sector.mangle, + r: r, + value: values[j], + total: total, + label: that.labels && that.labels[j] + }; + cover.mouseover(function () { + fin.call(o); + }).mouseout(function () { + fout.call(o); + }); + })(series[i], covers[i], i); + } + return this; + }; + // x: where label could be put + // y: where label could be put + // value: value to show + // total: total number to count % + chart.each = function (f) { + var that = this; + for (var i = 0; i < len; i++) { + (function (sector, cover, j) { + var o = { + sector: sector, + cover: cover, + cx: cx, + cy: cy, + x: sector.middle.x, + y: sector.middle.y, + mangle: sector.mangle, + r: r, + value: values[j], + total: total, + label: that.labels && that.labels[j] + }; + f.call(o); + })(series[i], covers[i], i); + } + return this; + }; + chart.click = function (f) { + var that = this; + for (var i = 0; i < len; i++) { + (function (sector, cover, j) { + var o = { + sector: sector, + cover: cover, + cx: cx, + cy: cy, + mx: sector.middle.x, + my: sector.middle.y, + mangle: sector.mangle, + r: r, + value: values[j], + total: total, + label: that.labels && that.labels[j] + }; + cover.click(function () { f.call(o); }); + })(series[i], covers[i], i); + } + return this; + }; + chart.inject = function (element) { + element.insertBefore(covers[0]); + }; + var legend = function (labels, otherslabel, mark, dir) { + var x = cx + r + r / 5, + y = cy, + h = y + 10; + labels = labels || []; + dir = (dir && dir.toLowerCase && dir.toLowerCase()) || "east"; + mark = paper.g.markers[mark && mark.toLowerCase()] || "disc"; + chart.labels = paper.set(); + for (var i = 0; i < len; i++) { + var clr = series[i].attr("fill"), + j = values[i].order, + txt; + values[i].others && (labels[j] = otherslabel || "Others"); + labels[j] = paper.g.labelise(labels[j], values[i], total); + chart.labels.push(paper.set()); + chart.labels[i].push(paper.g[mark](x + 5, h, 5).attr({fill: clr, stroke: "none"})); + chart.labels[i].push(txt = paper.text(x + 20, h, labels[j] || values[j]).attr(paper.g.txtattr).attr({fill: opts.legendcolor || "#000", "text-anchor": "start"})); + covers[i].label = chart.labels[i]; + h += txt.getBBox().height * 1.2; + } + var bb = chart.labels.getBBox(), + tr = { + east: [0, -bb.height / 2], + west: [-bb.width - 2 * r - 20, -bb.height / 2], + north: [-r - bb.width / 2, -r - bb.height - 10], + south: [-r - bb.width / 2, r + 10] + }[dir]; + chart.labels.translate.apply(chart.labels, tr); + chart.push(chart.labels); + }; + if (opts.legend) { + legend(opts.legend, opts.legendothers, opts.legendmark, opts.legendpos); + } + chart.push(series, covers); + chart.series = series; + chart.covers = covers; + return chart; +}; diff --git a/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/g.raphael.js b/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/g.raphael.js new file mode 100644 index 0000000..8e94c36 --- /dev/null +++ b/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/g.raphael.js @@ -0,0 +1,481 @@ +/* + * g.Raphael 0.4 - Charting library, based on Raphaël + * + * Copyright (c) 2009 Dmitry Baranovskiy (http://g.raphaeljs.com) + * Licensed under the MIT (http://www.opensource.org/licenses/mit-license.php) license. + */ + + +(function () { + Raphael.fn.g = Raphael.fn.g || {}; + Raphael.fn.g.markers = { + disc: "disc", + o: "disc", + flower: "flower", + f: "flower", + diamond: "diamond", + d: "diamond", + square: "square", + s: "square", + triangle: "triangle", + t: "triangle", + star: "star", + "*": "star", + cross: "cross", + x: "cross", + plus: "plus", + "+": "plus", + arrow: "arrow", + "->": "arrow" + }; + Raphael.fn.g.shim = {stroke: "none", fill: "#000", "fill-opacity": 0}; + Raphael.fn.g.txtattr = {font: "12px Arial, sans-serif"}; + Raphael.fn.g.colors = []; + var hues = [.6, .2, .05, .1333, .75, 0]; + for (var i = 0; i < 10; i++) { + if (i < hues.length) { + Raphael.fn.g.colors.push("hsb(" + hues[i] + ", .75, .75)"); + } else { + Raphael.fn.g.colors.push("hsb(" + hues[i - hues.length] + ", 1, .5)"); + } + } + Raphael.fn.g.text = function (x, y, text) { + return this.text(x, y, text).attr(this.g.txtattr); + }; + Raphael.fn.g.labelise = function (label, val, total) { + if (label) { + return (label + "").replace(/(##+(?:\.#+)?)|(%%+(?:\.%+)?)/g, function (all, value, percent) { + if (value) { + return (+val).toFixed(value.replace(/^#+\.?/g, "").length); + } + if (percent) { + return (val * 100 / total).toFixed(percent.replace(/^%+\.?/g, "").length) + "%"; + } + }); + } else { + return (+val).toFixed(0); + } + }; + + Raphael.fn.g.finger = function (x, y, width, height, dir, ending, isPath) { + // dir 0 for horisontal and 1 for vertical + if ((dir && !height) || (!dir && !width)) { + return isPath ? "" : this.path(); + } + ending = {square: "square", sharp: "sharp", soft: "soft"}[ending] || "round"; + var path; + height = Math.round(height); + width = Math.round(width); + x = Math.round(x); + y = Math.round(y); + switch (ending) { + case "round": + if (!dir) { + var r = Math.floor(height / 2); + if (width < r) { + r = width; + path = ["M", x + .5, y + .5 - Math.floor(height / 2), "l", 0, 0, "a", r, Math.floor(height / 2), 0, 0, 1, 0, height, "l", 0, 0, "z"]; + } else { + path = ["M", x + .5, y + .5 - r, "l", width - r, 0, "a", r, r, 0, 1, 1, 0, height, "l", r - width, 0, "z"]; + } + } else { + var r = Math.floor(width / 2); + if (height < r) { + r = height; + path = ["M", x - Math.floor(width / 2), y, "l", 0, 0, "a", Math.floor(width / 2), r, 0, 0, 1, width, 0, "l", 0, 0, "z"]; + } else { + path = ["M", x - r, y, "l", 0, r - height, "a", r, r, 0, 1, 1, width, 0, "l", 0, height - r, "z"]; + } + } + break; + case "sharp": + if (!dir) { + var half = Math.floor(height / 2); + path = ["M", x, y + half, "l", 0, -height, Math.max(width - half, 0), 0, Math.min(half, width), half, -Math.min(half, width), half + (half * 2 < height), "z"]; + } else { + var half = Math.floor(width / 2); + path = ["M", x + half, y, "l", -width, 0, 0, -Math.max(height - half, 0), half, -Math.min(half, height), half, Math.min(half, height), half, "z"]; + } + break; + case "square": + if (!dir) { + path = ["M", x, y + Math.floor(height / 2), "l", 0, -height, width, 0, 0, height, "z"]; + } else { + path = ["M", x + Math.floor(width / 2), y, "l", 1 - width, 0, 0, -height, width - 1, 0, "z"]; + } + break; + case "soft": + var r; + if (!dir) { + r = Math.min(width, Math.round(height / 5)); + path = ["M", x + .5, y + .5 - Math.floor(height / 2), "l", width - r, 0, "a", r, r, 0, 0, 1, r, r, "l", 0, height - r * 2, "a", r, r, 0, 0, 1, -r, r, "l", r - width, 0, "z"]; + } else { + r = Math.min(Math.round(width / 5), height); + path = ["M", x - Math.floor(width / 2), y, "l", 0, r - height, "a", r, r, 0, 0, 1, r, -r, "l", width - 2 * r, 0, "a", r, r, 0, 0, 1, r, r, "l", 0, height - r, "z"]; + } + } + if (isPath) { + return path.join(","); + } else { + return this.path(path); + } + }; + + // Symbols + Raphael.fn.g.disc = function (cx, cy, r) { + return this.circle(cx, cy, r); + }; + Raphael.fn.g.line = function (cx, cy, r) { + return this.rect(cx - r, cy - r / 5, 2 * r, 2 * r / 5); + }; + Raphael.fn.g.square = function (cx, cy, r) { + r = r * .7; + return this.rect(cx - r, cy - r, 2 * r, 2 * r); + }; + Raphael.fn.g.triangle = function (cx, cy, r) { + r *= 1.75; + return this.path("M".concat(cx, ",", cy, "m0-", r * .58, "l", r * .5, ",", r * .87, "-", r, ",0z")); + }; + Raphael.fn.g.diamond = function (cx, cy, r) { + return this.path(["M", cx, cy - r, "l", r, r, -r, r, -r, -r, r, -r, "z"]); + }; + Raphael.fn.g.flower = function (cx, cy, r, n) { + r = r * 1.25; + var rout = r, + rin = rout * .5; + n = +n < 3 || !n ? 5 : n; + var points = ["M", cx, cy + rin, "Q"], + R; + for (var i = 1; i < n * 2 + 1; i++) { + R = i % 2 ? rout : rin; + points = points.concat([+(cx + R * Math.sin(i * Math.PI / n)).toFixed(3), +(cy + R * Math.cos(i * Math.PI / n)).toFixed(3)]); + } + points.push("z"); + return this.path(points.join(",")); + }; + Raphael.fn.g.star = function (cx, cy, r, r2) { + r2 = r2 || r * .5; + var points = ["M", cx, cy + r2, "L"], + R; + for (var i = 1; i < 10; i++) { + R = i % 2 ? r : r2; + points = points.concat([(cx + R * Math.sin(i * Math.PI * .2)).toFixed(3), (cy + R * Math.cos(i * Math.PI * .2)).toFixed(3)]); + } + points.push("z"); + return this.path(points.join(",")); + }; + Raphael.fn.g.cross = function (cx, cy, r) { + r = r / 2.5; + return this.path("M".concat(cx - r, ",", cy, "l", [-r, -r, r, -r, r, r, r, -r, r, r, -r, r, r, r, -r, r, -r, -r, -r, r, -r, -r, "z"])); + }; + Raphael.fn.g.plus = function (cx, cy, r) { + r = r / 2; + return this.path("M".concat(cx - r / 2, ",", cy - r / 2, "l", [0, -r, r, 0, 0, r, r, 0, 0, r, -r, 0, 0, r, -r, 0, 0, -r, -r, 0, 0, -r, "z"])); + }; + Raphael.fn.g.arrow = function (cx, cy, r) { + return this.path("M".concat(cx - r * .7, ",", cy - r * .4, "l", [r * .6, 0, 0, -r * .4, r, r * .8, -r, r * .8, 0, -r * .4, -r * .6, 0], "z")); + }; + + // Tooltips + Raphael.fn.g.tag = function (x, y, text, angle, r) { + angle = angle || 0; + r = r == null ? 5 : r; + text = text == null ? "$9.99" : text; + var R = .5522 * r, + res = this.set(), + d = 3; + res.push(this.path().attr({fill: "#000", stroke: "none"})); + res.push(this.text(x, y, text).attr(this.g.txtattr).attr({fill: "#fff"})); + res.update = function () { + this.rotate(0, x, y); + var bb = this[1].getBBox(); + if (bb.height >= r * 2) { + this[0].attr({path: ["M", x, y + r, "a", r, r, 0, 1, 1, 0, -r * 2, r, r, 0, 1, 1, 0, r * 2, "m", 0, -r * 2 -d, "a", r + d, r + d, 0, 1, 0, 0, (r + d) * 2, "L", x + r + d, y + bb.height / 2 + d, "l", bb.width + 2 * d, 0, 0, -bb.height - 2 * d, -bb.width - 2 * d, 0, "L", x, y - r - d].join(",")}); + } else { + var dx = Math.sqrt(Math.pow(r + d, 2) - Math.pow(bb.height / 2 + d, 2)); + // ["c", -R, 0, -r, R - r, -r, -r, 0, -R, r - R, -r, r, -r, R, 0, r, r - R, r, r, 0, R, R - r, r, -r, r] + // "a", r, r, 0, 1, 1, 0, -r * 2, r, r, 0, 1, 1, 0, r * 2, + this[0].attr({path: ["M", x, y + r, "c", -R, 0, -r, R - r, -r, -r, 0, -R, r - R, -r, r, -r, R, 0, r, r - R, r, r, 0, R, R - r, r, -r, r, "M", x + dx, y - bb.height / 2 - d, "a", r + d, r + d, 0, 1, 0, 0, bb.height + 2 * d, "l", r + d - dx + bb.width + 2 * d, 0, 0, -bb.height - 2 * d, "L", x + dx, y - bb.height / 2 - d].join(",")}); + } + this[1].attr({x: x + r + d + bb.width / 2, y: y}); + angle = (360 - angle) % 360; + this.rotate(angle, x, y); + angle > 90 && angle < 270 && this[1].attr({x: x - r - d - bb.width / 2, y: y, rotation: [180 + angle, x, y]}); + return this; + }; + res.update(); + return res; + }; + Raphael.fn.g.popupit = function (x, y, set, dir, size) { + dir = dir == null ? 2 : dir; + size = size || 5; + x = Math.round(x) + .5; + y = Math.round(y) + .5; + var bb = set.getBBox(), + w = Math.round(bb.width / 2), + h = Math.round(bb.height / 2), + dx = [0, w + size * 2, 0, -w - size * 2], + dy = [-h * 2 - size * 3, -h - size, 0, -h - size], + p = ["M", x - dx[dir], y - dy[dir], "l", -size, (dir == 2) * -size, -Math.max(w - size, 0), 0, "a", size, size, 0, 0, 1, -size, -size, + "l", 0, -Math.max(h - size, 0), (dir == 3) * -size, -size, (dir == 3) * size, -size, 0, -Math.max(h - size, 0), "a", size, size, 0, 0, 1, size, -size, + "l", Math.max(w - size, 0), 0, size, !dir * -size, size, !dir * size, Math.max(w - size, 0), 0, "a", size, size, 0, 0, 1, size, size, + "l", 0, Math.max(h - size, 0), (dir == 1) * size, size, (dir == 1) * -size, size, 0, Math.max(h - size, 0), "a", size, size, 0, 0, 1, -size, size, + "l", -Math.max(w - size, 0), 0, "z"].join(","), + xy = [{x: x, y: y + size * 2 + h}, {x: x - size * 2 - w, y: y}, {x: x, y: y - size * 2 - h}, {x: x + size * 2 + w, y: y}][dir]; + set.translate(xy.x - w - bb.x, xy.y - h - bb.y); + return this.path(p).attr({fill: "#000", stroke: "none"}).insertBefore(set.node ? set : set[0]); + }; + Raphael.fn.g.popup = function (x, y, text, dir, size) { + dir = dir == null ? 2 : dir; + size = size || 5; + text = text || "$9.99"; + var res = this.set(), + d = 3; + res.push(this.path().attr({fill: "#000", stroke: "none"})); + res.push(this.text(x, y, text).attr(this.g.txtattr).attr({fill: "#fff"})); + res.update = function (X, Y, withAnimation) { + X = X || x; + Y = Y || y; + var bb = this[1].getBBox(), + w = bb.width / 2, + h = bb.height / 2, + dx = [0, w + size * 2, 0, -w - size * 2], + dy = [-h * 2 - size * 3, -h - size, 0, -h - size], + p = ["M", X - dx[dir], Y - dy[dir], "l", -size, (dir == 2) * -size, -Math.max(w - size, 0), 0, "a", size, size, 0, 0, 1, -size, -size, + "l", 0, -Math.max(h - size, 0), (dir == 3) * -size, -size, (dir == 3) * size, -size, 0, -Math.max(h - size, 0), "a", size, size, 0, 0, 1, size, -size, + "l", Math.max(w - size, 0), 0, size, !dir * -size, size, !dir * size, Math.max(w - size, 0), 0, "a", size, size, 0, 0, 1, size, size, + "l", 0, Math.max(h - size, 0), (dir == 1) * size, size, (dir == 1) * -size, size, 0, Math.max(h - size, 0), "a", size, size, 0, 0, 1, -size, size, + "l", -Math.max(w - size, 0), 0, "z"].join(","), + xy = [{x: X, y: Y + size * 2 + h}, {x: X - size * 2 - w, y: Y}, {x: X, y: Y - size * 2 - h}, {x: X + size * 2 + w, y: Y}][dir]; + if (withAnimation) { + this[0].animate({path: p}, 500, ">"); + this[1].animate(xy, 500, ">"); + } else { + this[0].attr({path: p}); + this[1].attr(xy); + } + return this; + }; + return res.update(x, y); + }; + Raphael.fn.g.flag = function (x, y, text, angle) { + angle = angle || 0; + text = text || "$9.99"; + var res = this.set(), + d = 3; + res.push(this.path().attr({fill: "#000", stroke: "none"})); + res.push(this.text(x, y, text).attr(this.g.txtattr).attr({fill: "#fff"})); + res.update = function (x, y) { + this.rotate(0, x, y); + var bb = this[1].getBBox(), + h = bb.height / 2; + this[0].attr({path: ["M", x, y, "l", h + d, -h - d, bb.width + 2 * d, 0, 0, bb.height + 2 * d, -bb.width - 2 * d, 0, "z"].join(",")}); + this[1].attr({x: x + h + d + bb.width / 2, y: y}); + angle = 360 - angle; + this.rotate(angle, x, y); + angle > 90 && angle < 270 && this[1].attr({x: x - r - d - bb.width / 2, y: y, rotation: [180 + angle, x, y]}); + return this; + }; + return res.update(x, y); + }; + Raphael.fn.g.label = function (x, y, text) { + var res = this.set(); + res.push(this.rect(x, y, 10, 10).attr({stroke: "none", fill: "#000"})); + res.push(this.text(x, y, text).attr(this.g.txtattr).attr({fill: "#fff"})); + res.update = function () { + var bb = this[1].getBBox(), + r = Math.min(bb.width + 10, bb.height + 10) / 2; + this[0].attr({x: bb.x - r / 2, y: bb.y - r / 2, width: bb.width + r, height: bb.height + r, r: r}); + }; + res.update(); + return res; + }; + Raphael.fn.g.labelit = function (set) { + var bb = set.getBBox(), + r = Math.min(20, bb.width + 10, bb.height + 10) / 2; + return this.rect(bb.x - r / 2, bb.y - r / 2, bb.width + r, bb.height + r, r).attr({stroke: "none", fill: "#000"}).insertBefore(set[0]); + }; + Raphael.fn.g.drop = function (x, y, text, size, angle) { + size = size || 30; + angle = angle || 0; + var res = this.set(); + res.push(this.path(["M", x, y, "l", size, 0, "A", size * .4, size * .4, 0, 1, 0, x + size * .7, y - size * .7, "z"]).attr({fill: "#000", stroke: "none", rotation: [22.5 - angle, x, y]})); + angle = (angle + 90) * Math.PI / 180; + res.push(this.text(x + size * Math.sin(angle), y + size * Math.cos(angle), text).attr(this.g.txtattr).attr({"font-size": size * 12 / 30, fill: "#fff"})); + res.drop = res[0]; + res.text = res[1]; + return res; + }; + Raphael.fn.g.blob = function (x, y, text, angle, size) { + angle = (+angle + 1 ? angle : 45) + 90; + size = size || 12; + var rad = Math.PI / 180, + fontSize = size * 12 / 12; + var res = this.set(); + res.push(this.path().attr({fill: "#000", stroke: "none"})); + res.push(this.text(x + size * Math.sin((angle) * rad), y + size * Math.cos((angle) * rad) - fontSize / 2, text).attr(this.g.txtattr).attr({"font-size": fontSize, fill: "#fff"})); + res.update = function (X, Y, withAnimation) { + X = X || x; + Y = Y || y; + var bb = this[1].getBBox(), + w = Math.max(bb.width + fontSize, size * 25 / 12), + h = Math.max(bb.height + fontSize, size * 25 / 12), + x2 = X + size * Math.sin((angle - 22.5) * rad), + y2 = Y + size * Math.cos((angle - 22.5) * rad), + x1 = X + size * Math.sin((angle + 22.5) * rad), + y1 = Y + size * Math.cos((angle + 22.5) * rad), + dx = (x1 - x2) / 2, + dy = (y1 - y2) / 2, + rx = w / 2, + ry = h / 2, + k = -Math.sqrt(Math.abs(rx * rx * ry * ry - rx * rx * dy * dy - ry * ry * dx * dx) / (rx * rx * dy * dy + ry * ry * dx * dx)), + cx = k * rx * dy / ry + (x1 + x2) / 2, + cy = k * -ry * dx / rx + (y1 + y2) / 2; + if (withAnimation) { + this.animate({x: cx, y: cy, path: ["M", x, y, "L", x1, y1, "A", rx, ry, 0, 1, 1, x2, y2, "z"].join(",")}, 500, ">"); + } else { + this.attr({x: cx, y: cy, path: ["M", x, y, "L", x1, y1, "A", rx, ry, 0, 1, 1, x2, y2, "z"].join(",")}); + } + return this; + }; + res.update(x, y); + return res; + }; + + Raphael.fn.g.colorValue = function (value, total, s, b) { + return "hsb(" + [Math.min((1 - value / total) * .4, 1), s || .75, b || .75] + ")"; + }; + + Raphael.fn.g.snapEnds = function (from, to, steps) { + var f = from, + t = to; + if (f == t) { + return {from: f, to: t, power: 0}; + } + function round(a) { + return Math.abs(a - .5) < .25 ? Math.floor(a) + .5 : Math.round(a); + } + var d = (t - f) / steps, + r = Math.floor(d), + R = r, + i = 0; + if (r) { + while (R) { + i--; + R = Math.floor(d * Math.pow(10, i)) / Math.pow(10, i); + } + i ++; + } else { + while (!r) { + i = i || 1; + r = Math.floor(d * Math.pow(10, i)) / Math.pow(10, i); + i++; + } + i && i--; + } + var t = round(to * Math.pow(10, i)) / Math.pow(10, i); + if (t < to) { + t = round((to + .5) * Math.pow(10, i)) / Math.pow(10, i); + } + var f = round((from - (i > 0 ? 0 : .5)) * Math.pow(10, i)) / Math.pow(10, i); + return {from: f, to: t, power: i}; + }; + Raphael.fn.g.axis = function (x, y, length, from, to, steps, orientation, labels, type, dashsize) { + dashsize = dashsize == null ? 3 : dashsize; + type = type || "t"; + steps = steps || 10; + var path = type == "|" || type == " " ? ["M", x + .5, y, "l", 0, .001] : orientation == 1 || orientation == 3 ? ["M", x + .5, y, "l", 0, -length] : ["M", x, y + .5, "l", length, 0], + ends = this.g.snapEnds(from, to, steps), + f = ends.from, + t = ends.to, + i = ends.power, + j = 0, + text = this.set(); + d = (t - f) / steps; + var label = f, + rnd = i > 0 ? i : 0; + dx = length / steps; + if (+orientation == 1 || +orientation == 3) { + var Y = y, + addon = (orientation - 1 ? 1 : -1) * (dashsize + 3 + !!(orientation - 1)); + while (Y >= y - length) { + type != "-" && type != " " && (path = path.concat(["M", x - (type == "+" || type == "|" ? dashsize : !(orientation - 1) * dashsize * 2), Y + .5, "l", dashsize * 2 + 1, 0])); + text.push(this.text(x + addon, Y, (labels && labels[j++]) || (Math.round(label) == label ? label : +label.toFixed(rnd))).attr(this.g.txtattr).attr({"text-anchor": orientation - 1 ? "start" : "end"})); + label += d; + Y -= dx; + } + if (Math.round(Y + dx - (y - length))) { + type != "-" && type != " " && (path = path.concat(["M", x - (type == "+" || type == "|" ? dashsize : !(orientation - 1) * dashsize * 2), y - length + .5, "l", dashsize * 2 + 1, 0])); + text.push(this.text(x + addon, y - length, (labels && labels[j]) || (Math.round(label) == label ? label : +label.toFixed(rnd))).attr(this.g.txtattr).attr({"text-anchor": orientation - 1 ? "start" : "end"})); + } + } else { + var X = x, + label = f, + rnd = i > 0 ? i : 0, + addon = (orientation ? -1 : 1) * (dashsize + 9 + !orientation), + dx = length / steps, + txt = 0, + prev = 0; + while (X <= x + length) { + + text.push(txt = this.text(X, y + addon, (labels && labels[j++]) || (Math.round(label) == label ? label : +label.toFixed(rnd))).attr(this.g.txtattr)); + var bb = txt.getBBox(); + var ds = dashsize; + if (prev >= bb.x - 5) { + text.pop(text.length - 1).remove(); + ds = 1; + } else { + prev = bb.x + bb.width; + } + + type != "-" && type != " " && (path = path.concat(["M", X + .5, y - (type == "+" ? ds : !!orientation * ds * 2), "l", 0, ds * 2 + 1])); + + label += d; + X += dx; + } + if (Math.round(X - dx - x - length)) { + type != "-" && type != " " && (path = path.concat(["M", x + length + .5, y - (type == "+" ? dashsize : !!orientation * dashsize * 2), "l", 0, dashsize * 2 + 1])); + text.push(this.text(x + length, y + addon, (labels && labels[j]) || (Math.round(label) == label ? label : +label.toFixed(rnd))).attr(this.g.txtattr)); + } + } + var res = this.path(path); + res.text = text; + res.all = this.set([res, text]); + res.remove = function () { + this.text.remove(); + this.constructor.prototype.remove.call(this); + }; + return res; + }; + + Raphael.el.lighter = function (times) { + times = times || 2; + var fs = [this.attrs.fill, this.attrs.stroke]; + this.fs = this.fs || [fs[0], fs[1]]; + fs[0] = Raphael.rgb2hsb(Raphael.getRGB(fs[0]).hex); + fs[1] = Raphael.rgb2hsb(Raphael.getRGB(fs[1]).hex); + fs[0].b = Math.min(fs[0].b * times, 1); + fs[0].s = fs[0].s / times; + fs[1].b = Math.min(fs[1].b * times, 1); + fs[1].s = fs[1].s / times; + this.attr({fill: "hsb(" + [fs[0].h, fs[0].s, fs[0].b] + ")", stroke: "hsb(" + [fs[1].h, fs[1].s, fs[1].b] + ")"}); + }; + Raphael.el.darker = function (times) { + times = times || 2; + var fs = [this.attrs.fill, this.attrs.stroke]; + this.fs = this.fs || [fs[0], fs[1]]; + fs[0] = Raphael.rgb2hsb(Raphael.getRGB(fs[0]).hex); + fs[1] = Raphael.rgb2hsb(Raphael.getRGB(fs[1]).hex); + fs[0].s = Math.min(fs[0].s * times, 1); + fs[0].b = fs[0].b / times; + fs[1].s = Math.min(fs[1].s * times, 1); + fs[1].b = fs[1].b / times; + this.attr({fill: "hsb(" + [fs[0].h, fs[0].s, fs[0].b] + ")", stroke: "hsb(" + [fs[1].h, fs[1].s, fs[1].b] + ")"}); + }; + Raphael.el.original = function () { + if (this.fs) { + this.attr({fill: this.fs[0], stroke: this.fs[1]}); + delete this.fs; + } + }; +})(); \ No newline at end of file diff --git a/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/load-big.gif b/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/load-big.gif new file mode 100644 index 0000000000000000000000000000000000000000..ddb7ff1aac1b2fc825667c157873c2c55bbe8db8 GIT binary patch literal 1924 zcmciDX;70#00!U)Urs41ND>$3-?7cZa-C@o`?~}E+$na_sVK~an51Y7o6Am#OJGNBi-|v-0K)zTz!9cZZmYYj zeiQ^4Hx2}<@9us*(zz1hB8-YDCx|yPvMXzQM{_K$!h*iJ(7x2j*bY>E)v;gG zt15c?^oIWX1BxEuJ?E}-N%%X2$C&X)nYafzWBB27BZK9$hH1k@-(v5=%efcJKAYA8 zj{X%G-GGGnp>xBKmtR{qyXkbXi>i|w&^A+i%*o~apB=fnp1EvhyA8i)zT0!ZJK|=f zGujFu=8Q?f@YHB=vJ&Q(Q2ooMB$CxnsQ@;Cl88SakbL=c9-bR}Cd`4o_e-(kkx-G` z1gxmM5nm)f#c{~lR_t33s5hr)1~uEaw)kjKO}BP*)>VmXx>RQ1;1H?TbtLMnaSW#; zj9+XgO*q{nKEpjQb`O`&-Jk8B)-S0R`xoZlkUo^CY4otNIEG*Z>9xBj^;cd~XE!if z=JK3SR%Kh!+&qgwp0nLox=TA*jYs?se%u2xUeoK&1u^$dFrFz~jrhLs@UeBBdpx|M zY)D3CZeBjWKwtxdli{#JJ47_Xo<)bn10rN1&s7)?M_u%xDH4!1ac=bhs)DA9u4+yx zQz*rfNSWBSxTLdtwZlQ%QWxV{Y9-?#zL7M}ttCzze@xWkN1wM3@#hRCqG74qOeC&J z9C^RRzb6jvbS)W0Nd^=G0Xde#v6Z!xx5H+VUZrNmDp2GD$ZAyrrw%!G2FskYEUNL97Eu}MQR$IyrnBkg(h1rW4yIQEM3J@S3&;1KqjvtHc)u##|B-p#vH)WPhuYi^mQjj0C~N7S!=n7H-h z)-{F0|AmmcM>roo8TLt*J%^c#&ZiY1FVl9S>(#+iza>x4q)s+Z@gD1* z@P^eR(w@FoxHWz6T{O`R|GvS0@PW)Hmm#QRgaoFdRCosCuGa!^PcBA73HQUcl65Dr zO|`ePK2pY_S=Cuk0cLN5NYeIMmj@%E-?ilgU&#f%3S_8AdaDu z`F^)`6_9BI%cf+|5|L?q0A9#NmQZLMl$0#@LkamJueh-M5`ik%{!(^MZk{k*qitzz zdsl7?nA3Imb6iI@->x5 zwXc~EZZLz-aKH4hJ%XN<9U8*$f;BXGrEQ^o=8paJ`*iQfV=)}tj7M$B9-E(t0}WI5 ziiH<<@gb})LXWcd=N1SGi;6?d9SD)&II^XLelX2e#DZKujgFz0`cy~Oo<~(uRW#l% zG_=kVdRXZIt%P()d)_@2TRL5aa4qGGD&I4tJNR+p1a_1(jW-f!2MXqTpXs0WExsHx Pn1F;$An(;T&^-PCGf5vc literal 0 HcmV?d00001 diff --git a/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/load.gif b/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/load.gif new file mode 100644 index 0000000000000000000000000000000000000000..d0bce1542342e912da81a2c260562df172f30d73 GIT binary patch literal 673 zcmZ?wbhEHb6krfw_{6~Q|Nnmm28Kh24mmkF0U1e2Nli^nlO|14{Lk&@8WQa67~pE8 zXTZz|lvDgC+Z`3#dv5h=E26FfcG1 zbL_hF&)}42ws10s6^G;;cE1^EoUR)U5A70}d2pLv!jVIT7j&Z~EblI3x0K*v_sV|m z0kj3v921Z^em#l`(k(o@H$3ZdDRc@9NidXDNbqrumReCGv$gd8+e8WW28HVqkJ_9i zH>s*<31KtHjANIPvi2#*6BEu%3Dak5O_t&NBI)H?V$TxT}#l{vOTn5naXTfF^&~Hhq+NX@#Ccc>y7T?;vjI&jdhsDsPJyAw*m0Qz>i}K7# zL9w50Ng{fT}A5JUe8lRK1h7_Y2;BWJDd=c6f&i?Wv5(5q?6|P zQw{>maxZP<537OA37Uk}7@%_$4o$EWe_Zl>&#id|lE-BpDC#+Fn|msJ%_2h{Hg1vP z#N8WAzfWasG}yq|xqE)DrWaOofX=z|?*pgc%{ig5vl!pqDlC|q&~Z0$&Rvsft&VO- z4MZj+%-+Vx%W}v;V76hyp=;+R;x+~t^Q%*xuFTQAF2})fSfTHDAs>sO!OBw`)&)o$ c0!CNZt))x~rAZP^^P&YOFfdqy5)K#u0POD40{{R3 literal 0 HcmV?d00001 diff --git a/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/loggraph.css b/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/loggraph.css new file mode 100644 index 0000000..a84d90e --- /dev/null +++ b/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/loggraph.css @@ -0,0 +1,54 @@ +/* + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +*/ +body { font-family: sans-serif; } + +div.fileSelector { border: solid 3px black; position: absolute; background: white; + -moz-border-radius: 10px; border-radius: 10px; + padding: 5px; font-family: sans-serif; + right: 10px; top: 10px; + } +div.fileSelector a { cursor: pointer; } +.fileSelector li.selectedFile { background: lightgreen; } + +div.selector { border: solid 3px black; position: absolute; background: white; + -moz-border-radius: 10px; border-radius: 10px; + padding: 5px; + right: 10px; top: 10px; background: #aaaaaa; opacity: 0.7; + } +div.selector a { cursor: pointer; } +.fileSelector li.selectedFile { background: lightgreen; } + +#fileLoader { -moz-border-radius: 10px; border-radius: 10px; background: #aaaaaa; opacity: 0.7; position: absolute; left: 20px; top: 20px; } +#loadingScreen { position: absolute; top: 100px; margin-left: 40%; margin-right: 40%; width: 500px; background: #aaaaaa; opacity: 0.7; -moz-border-radius: 10px; border-radius: 10px; text-align: center } +#filterinput { width: 500px; height: 100px; } +/* main interface */ +#actions { float: right; } +#views { float: left; } + +.closebutton { position: absolute; right: 5px; float: right; display: block; cursor: pointer; } + +.actionbutton { color: blue; text-decoration: none; padding: 3px; cursor: pointer; } +span:hover.actionbutton { background: lightblue; } + +#status { text-align: center; } + +#canvas { width: 100%; height: 1000px; } + +#logtable { width: 100%; } +.popUp { border: 3px solid black; -moz-border-radius: 10px; border-radius: 10px; position: absolute; background: white; padding: 10px; min-width: 300px; } + +.errorpage { position: absolute; top: 100px; margin-left: 40%; margin-right: 40%; width: 500px; background: #aaaaaa; opacity: 0.7; -moz-border-radius: 10px; border-radius: 10px; padding: 10px; } \ No newline at end of file diff --git a/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/loggraph.js b/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/loggraph.js new file mode 100644 index 0000000..87bb7d8 --- /dev/null +++ b/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/loggraph.js @@ -0,0 +1,262 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +LogGraph = function(canvas, status) { + this.canvas = document.getElementById(canvas); + this.status = document.getElementById(status); + this.starttime = 0; + this.endtime = 0; + this.period = 0; + this.numEntries = 0; + this.currentRender = 0; + this.filter = ""; + + this.saveFilters = function () { + localStorage.starttime = this.starttime; + localStorage.endtime = this.endtime; + localStorage.period = this.period; + localStorage.filter = this.filter; + + }; + this.loadFilters = function () { + if (localStorage.starttime) { this.starttime = parseInt(localStorage.starttime); } + if (localStorage.endtime) { this.endtime = parseInt(localStorage.endtime); } + if (localStorage.period) { this.period = parseInt(localStorage.period); } + if (localStorage.filter) { this.filter = localStorage.filter; } + }; + this.loadFilters(); + var self = this; + + var updateStatus = function (starttime, period, filter, numEntries) { + self.starttime = starttime; + self.endtime = starttime + period; + self.period = period; + self.filter = filter; + self.saveFilters(); + + self.status.innerHTML = dateFormat(starttime, "HH:MM:ss,l") + " ⇒ " + dateFormat(self.endtime, "HH:MM:ss,l") + "    |    " + numEntries + " entries    |    " + (filter ? filter : "No filter"); + + if (self.currentRender) { + self.currentRender(); + } + }; + + YUI().use("io-base", function(Y) { + var uri = "/info"; + if (self.starttime) { + var uri = "/info?start=" + self.starttime + "&period=" + self.period + "&filter=" + self.filter; + } + + function complete(id, o, args) { + var data = eval("(" + o.responseText + ")"); // Response data. + var period = data.endTime - data.startTime; + updateStatus(data.startTime, period, self.filter, data.numEntries); + }; + + Y.on('io:complete', complete, Y, []); + var request = Y.io(uri); + }); + + this.addLogs = function() { + new LogGraph.fileSelector(function (files) { new LogGraph.fileLoader(files); }); + }; + + this.editFilters = function() { + new LogGraph.filterSelector(this.starttime, this.period, this.filter, updateStatus); + }; + + this.getCleanCanvas = function () { + this.canvas.innerHTML = ""; + return this.canvas; + }; + + this.showLoadingScreen = function () { + this.loadingScreen = document.createElement("div"); + this.loadingScreen.id = "loadingScreen"; + this.loadingScreen.innerHTML = "

Loading...

"; + document.body.appendChild(this.loadingScreen); + }; + + this.hideLoadingScreen = function () { + document.body.removeChild(this.loadingScreen); + this.loadingScreen.style.visibility = "hidden"; + }; + + + /*** + * TODO: refactor these to load the data first, before handing to a draw funciton. + * We shouldn't pass the async q into the drawing function + */ + this.showLogs = function() { + var self= this; + YUI().use('async-queue', function(Y) { + var q = new Y.AsyncQueue(self.showLoadingScreen, + // The second callback will pause the Queue and send an XHR for data + function () { + q.pause(); + var loggraph = new LogGraph.LogTable(q, self.getCleanCanvas(), self.starttime, self.endtime, self.filter); + self.currentRender = self.showLogs; + }, + self.hideLoadingScreen); + q.run(); + } + ); + }; + + this.serverGraph = function() { + var self= this; + YUI().use('async-queue', function(Y) { + var q = new Y.AsyncQueue(self.showLoadingScreen, + // The second callback will pause the Queue and send an XHR for data + function () { + q.pause(); + var servergraph = new LogGraph.ServerGraph(q, self.getCleanCanvas(), self.starttime, self.endtime, self.filter); + self.currentRender = self.showLogs; + }, + self.hideLoadingScreen); + q.run(); + } + ); + }; + + this.sessionGraph = function() { + var self= this; + YUI().use('async-queue', function(Y) { + var q = new Y.AsyncQueue(self.showLoadingScreen, + // The second callback will pause the Queue and send an XHR for data + function () { + q.pause(); + var sessiongraph = new LogGraph.SessionGraph(q, self.getCleanCanvas(), self.starttime, self.endtime, self.filter); + self.currentRender = self.sessionGraph; + }, + self.hideLoadingScreen); + q.run(); + } + ); + }; + + this.showStats = function() { + var self= this; + YUI().use('async-queue', function(Y) { + var q = new Y.AsyncQueue(self.showLoadingScreen, + // The second callback will pause the Queue and send an XHR for data + function () { + q.pause(); + var statgraph = new LogGraph.StatsGraph(q, self.getCleanCanvas(), self.starttime, self.endtime, self.filter); + self.currentRender = self.showStats; + }, + self.hideLoadingScreen); + q.run(); + } + ); + }; +}; + +LogGraph.error = function(description) { + var errorPage = document.createElement("div"); + errorPage.className = "errorpage"; + var p = document.createElement("p"); + p.innerHTML = description; + errorPage.appendChild(p); + + var span = document.createElement("span"); + p = document.createElement("p"); + span.className = "actionButton"; + span.innerHTML = "OK"; + span.onclick = function (evt) { + document.body.removeChild(errorPage); + delete errorPage; + } + p.appendChild(span); + errorPage.appendChild(p); + + document.body.appendChild(errorPage); +}; + +LogGraph.ticker =function(allow_dups) { + this.ticks = new Array(); + this.current_tick = 0; + this.allow_dups = allow_dups;; + + this.tick = function(time) { + if (time == this.ticks[this.ticks.length - 1] && this.allow_dups == true) + return this.current_tick; + + this.ticks.push(time); + return this.current_tick++; + }; + + this.current = function() { + return this.current_tick; + }; + + this.reset = function() { + while (this.ticks.length) { + this.ticks.pop(); + } + this.current_tick = 0; + }; +}; + + +LogGraph.timescale = function(starttime, endtime) { + this.starttime = starttime; + this.endtime = endtime; + this.millis = endtime - starttime; + + this.draw = function(paper) { + var scale = paper.set(); + scale.push(paper.path("M0 0 L" + paper.width + " 0")); + + for (var i = 0; i < paper.width; i += 100) { + scale.push(paper.path("M" + i + " 0 L" + i + " 5")); + // var time = dateFormat((this.starttime + (i*ms_per_pixel)), "h:MM:ss,l"); + // paper.text(i + 5, 10, time); + } + + scale.attr({"stroke-width": 2}); + }; +}; + +/* + Fetch data from an uri and process it, the process data func returns true if any of the data is useful +*/ +LogGraph.loadData = function (asyncq, uri, processdata) { + YUI().use("io-base", function(Y) { + function success(id, o, args) { + var data = eval("(" + o.responseText + ")"); // Response data. + if (data.error) { + LogGraph.error(data.error); + } else { + if (!processdata(data)) { + LogGraph.error("No data. Perhaps you should loosen your filter criteria."); + } + } + asyncq.run(); + }; + function failure(id, o, args) { + LogGraph.error("Error contacting server: (" + o.status + ") " + o.statusText); + asyncq.run(); + }; + + Y.on('io:success', success, Y, []); + Y.on('io:failure', failure, Y, []); + + var request = Y.io(uri); + }); +} \ No newline at end of file diff --git a/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/loggraph.log.js b/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/loggraph.log.js new file mode 100644 index 0000000..551ea4b --- /dev/null +++ b/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/loggraph.log.js @@ -0,0 +1,57 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +LogGraph.LogTable = function (asyncq, canvas, starttime, endtime, filter) { + this.starttime = starttime; + this.endtime = endtime; + this.filter = filter; + + var table = document.createElement("table"); + table.id = "logtable"; + canvas.appendChild(table); + + this.addLogLine = function(time, text) { + var tr = document.createElement("tr"); + table.appendChild(tr); + + var td = document.createElement("td"); + td.innerHTML = dateFormat(time, "h:MM:ss,l"); + tr.appendChild(td); + + td = document.createElement("td"); + td.innerHTML = text; + tr.appendChild(td); + } + + var self = this; + var processdata = function(data) { + var events = data["events"]; + var count = 0; + for (var i in events) { + var e = events[i]; + if (e.type == "text") { + self.addLogLine(e.time, e.text); + count++; + } + } + return count != 0; + }; + + var uri = "/data?start=" + self.starttime + "&end=" + self.endtime + "&filter=" + self.filter; + LogGraph.loadData(asyncq, uri, processdata); +}; diff --git a/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/loggraph.server.js b/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/loggraph.server.js new file mode 100644 index 0000000..0a74b5c --- /dev/null +++ b/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/loggraph.server.js @@ -0,0 +1,329 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +LogGraph.ServerGraph = function(asyncq, canvas, starttime, endtime, filter) { + this.starttime = starttime; + this.endtime = endtime; + this.millis = endtime - starttime; + this.nextserverid = 0; + this.serveroffset = 100; + this.filter = filter; + + this.pixels_per_tick = 20; + this.ticker = new LogGraph.ticker(); + + + var paper = Raphael(canvas, 1, 1); + + var self = this; + + this.timescale = new LogGraph.timescale(starttime, endtime); + this.objects = new Array(); + + this.add = function(obj) { + this.objects.push(obj); + } + + this.tick_to_x = function (timestamp) { + var x = timestamp * this.pixels_per_tick; + return x; + }; + + this._drawTime = function(paper, x, time) { + var p = paper.path("M" + x + " 0 L" + x + " " + paper.height); + var t = paper.text(x, 10, dateFormat(time, "h:MM:ss,l")); + + t.hide(); + p.mouseover(function(evt) { + t.show(); + p.attr({stroke: "red"}); + }); + p.mouseout(function(evt) { + t.hide(); + p.attr({stroke: "lightgray"}); + }); + + return p; + }; + + this.draw = function(paper) { + var grid = paper.set(); + for (var i = 0; i < paper.height; i += 20) { + grid.push(paper.path("M0 " + i + " L" + paper.width + " " + i)); + } + var lasttick = this.starttime; + var scale = 500; // 500 ms + + var y = 0; + + for (var t = 0, len = this.ticker.ticks.length; t < len; t++) { + var basex = t * this.pixels_per_tick; + var thistick = this.ticker.ticks[t]; + var nexttick = t + 1 == this.ticker.ticks.length ? this.endtime : this.ticker.ticks[t+1]; + if (nexttick == thistick) { + continue; + } + var time = thistick - lasttick; + var first = scale - (lasttick % scale); + + /* for (var i = 0; (first+scale*i) < time; i++) { + + var toffset = first+scale*i; + var x = basex + LogGraph._pixels_per_tick * toffset/time; + grid.push(this._drawTime(paper, x, lasttick + toffset, grid)); + + }*/ + + + //grid.push(paper.path("M" + i + " 0 L" + i + " " + paper.height)); + lasttick = thistick; + } + grid.attr({stroke: "lightgray"}); + this.timescale.draw(paper); + + for (o in this.objects) { + this.objects[o].draw(paper); + } + }; + + + var processdata = function(data) { + var servermap = {}; + var servers = data.servers; + var count = 0; + for (s in servers) { + var server = new LogGraph.ServerGraph.server(self, "Server " + servers[s]); + servermap[servers[s]] = server; + self.add(server); + count++; + } + + var messages = {}; + var events = data.events; + for (var i in events) { + var e = events[i]; + var t = e.time; + if (e.type == "stateChange") { + servermap[e.server].addState(e.state, self.ticker.tick(e.time)); + } + if (e.type == "postmessage") { + src = servermap[e.src]; + dst = servermap[e.dst]; + var key = "key:s" + e.src + ",d" + e.dst + ",z" + e.zxid; + + var m = new LogGraph.ServerGraph.message(self, src, self.ticker.tick(e.time), dst, e.zxid); + messages[key] = m; + } + if (e.type == "delivermessage") { + var key = "key:s" + e.src + ",d" + e.dst + ",z" + e.zxid; + + var m = messages[key]; + if (m) { + m.dsttime = self.ticker.tick(e.time); + m.name = "Propose"; + self.add(m); + delete messages[key]; + } + } + if (e.type == "exception") { + servermap[e.server].addException(self.ticker.tick(e.time), e.text, e.time); + } + count++; + } + + for (var i in messages) { + var m = messages[i]; + m.markIncomplete(); + self.add(m); + count++; + } + + if (count != 0) { + paper.setSize(self.tick_to_x(self.ticker.current()), 1000); + + var line = paper.path("M0 0 L0 1000"); + line.attr({"stroke": "red", "stroke-dasharray": "- "}); + var base = canvas.offsetLeft;// + ((canvas.offsetWidth - paper.width)/2); + canvas.onmousemove = function (evt) { + var x = evt.screenX - base; + + line.attr({"path": "M" + x + " 0 L"+ x +" 1000"}); + + }; + + self.draw(paper); + return true; + } else { + return false; + } + }; + + var uri = "/data?start=" + self.starttime + "&end=" + self.endtime + "&filter=" + filter; + + LogGraph.loadData(asyncq, uri, processdata); +}; + +LogGraph.ServerGraph.server = function (graph, name) { + this.graph = graph; + this.serverid = graph.nextserverid++; + this.name = name; + this.y = (this.serverid * 300 + graph.serveroffset); + this.states = new Array(); + this.exception = new Array(); + + this.addState = function(state, time) { + this.states.push([state, time]); + } + + this.addException = function(tick, exception, time) { + this.exception.push(new LogGraph.ServerGraph.exception(this.graph, tick, exception, time)); + } + + this.draw = function(paper) { + var st = paper.set(); + st.push(paper.path("M0 " + this.y + " L" + paper.width + " " + this.y)); + st.push(paper.text(20, this.y - 10, this.name)); + st.attr({stroke: "gray"}); + + var numstates = this.states.length; + + for (s = 0; s < numstates; s++) { + var style = {}; + switch (this.states[s][0]) { + case "INIT": style = {stroke: "yellow", "stroke-width":3}; break; + case "FOLLOWING": style = {stroke: "lightgreen", "stroke-width":7}; break; + case "LEADING": style = {stroke: "green", "stroke-width":10}; break; + case "LOOKING": style = {stroke: "orange", "stroke-width":5}; break; + } + var startx = this.graph.tick_to_x(this.states[s][1]); + var endx = s + 1 < numstates ? this.graph.tick_to_x(this.states[(s+1)][1]) : paper.width; + var p = paper.path("M" + startx + " " + this.y + " L" + endx + " " + this.y); + p.attr(style); + } + + for (e in this.exception) { + this.exception[e].draw(paper, this); + } + } +}; + +LogGraph.ServerGraph.message = function(graph, src, srctime, dst, zxid) { + this.graph = graph; + this.src = src; + this.srctime = srctime; + this.dst = dst; + this.dsttime = 0; //dsttime; + this.name = "Unknown"; + this.zxid = zxid; + this.moreinfo = "No extra information"; + this.incomplete = false; + + this.markIncomplete = function() { + this.incomplete = true; + this.dsttime = this.srctime; + } + + this.draw = function(paper) { + var srcx = this.graph.tick_to_x(this.srctime); + var dstx = this.graph.tick_to_x(this.dsttime); + + var arrow = paper.set(); + var p = paper.path("M" + srcx + " " + this.src.y + " L" + dstx + " " + this.dst.y); + arrow.push(p); + + var tx = (srcx + dstx)/2; + var ty = (this.src.y + this.dst.y)/2; + var t = paper.text(tx, ty, this.name); + + var gradiant = (this.dst.y - this.src.y)/(dstx - srcx); + var angle = Math.atan(gradiant) * 57.2958; + t.rotate(angle, true); + + var arrowl = paper.path("M" + dstx + " " + this.dst.y + " L" + (dstx - 10) +" " + this.dst.y); + arrowl.rotate(angle + 20, dstx, this.dst.y); + arrow.push(arrowl); + var arrowr = paper.path("M" + dstx + " " + this.dst.y + " L" + (dstx - 10) +" " + this.dst.y); + arrowr.rotate(angle - 20, dstx, this.dst.y); + arrow.push(arrowr); + + arrow.attr({"stroke-width": 2, stroke: "gray"}); + if (this.incomplete) { + arrow.attr({"stroke-dasharray": "- .", stroke: "pink", "stroke-width": 2}); + } + arrow.mouseover(function(evt) { + t.attr({"font-size": 20}); + arrow.attr({stroke: "red", "stroke-width": 3}); + }); + arrow.mouseout(function(evt) { + t.attr({"font-size": 10}); + + if (this.incomplete) { + arrow.attr({stroke: "pink", "stroke-width": 2}); + } else { + arrow.attr({stroke: "gray", "stroke-width": 2}); + } + }); + + + + arrow.click(function(evt) { + var popup = document.createElement("div"); + popup.className = "popUp"; + popup.innerHTML = "zxid: " + parseInt(this.zxid).toString(16); + + popup.style.top = evt.clientY; + popup.style.left = evt.clientX; + document.body.appendChild(popup); + + popup.onclick = function(evt) { + document.body.removeChild(popup); + }; + }); + } +}; + +LogGraph.ServerGraph.exception = function(graph, tick, exceptiontext, time) { + this.graph = graph; + this.time = time; + this.text = exceptiontext; + this.tick = tick; + + var self = this; + + this.draw = function(paper, server) { + var center = this.graph.tick_to_x(this.tick); + var p = paper.circle(center, server.y, 5); + p.attr({stroke: "orange", fill: "red"}); + + p.mouseover(function(evt) { + p.popup = document.createElement("div"); + p.popup.className = "popUp"; + p.popup.innerHTML = self.text.replace("\n", "
");; + p.popup.style.top = server.y + 50; + p.popup.style.left = center + 25; + document.body.appendChild(p.popup); + + p.animate({r: 10}, 500, "elastic"); + }); + p.mouseout(function(evt) { + document.body.removeChild(p.popup); + p.animate({r: 5}, 100); + }); + } +}; + diff --git a/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/loggraph.session.js b/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/loggraph.session.js new file mode 100644 index 0000000..5a314d8 --- /dev/null +++ b/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/loggraph.session.js @@ -0,0 +1,202 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +LogGraph.SessionGraph = function (asyncq, canvas, starttime, endtime, filter) { + this.sessions = new Array(); + this.counter = 0; + this.exceptions = new Array(); + + this.pix_per_ticks = 4; + this.pix_per_session = 7; + + var paper = Raphael(canvas, 1, 1); + this.ticker = new LogGraph.ticker(); + var self = this; + + this.starttime = starttime; + this.endtime = endtime; + this.filter = filter; + + this.findOrCreateSession = function(id) { + if (this.sessions[id] == undefined) { + this.sessions[id] = new LogGraph.SessionGraph.session(this, ++this.counter, id); + } + return this.sessions[id]; + } + + this.height = function () { return this.counter * this.pix_per_session + 10; }; + this.width = function () { return (self.ticker.current() * this.pix_per_ticks); }; + + this.draw = function(paper) { + + + var line = paper.path("M0 0 L0 " + this.height()); + line.attr({"stroke": "red", "stroke-dasharray": "- "}); + var base = canvas.offsetLeft; + var width = this.width(); + canvas.onmousemove = function (evt) { + var x = evt.clientX - base; + + line.attr({"path": "M" + x + " 0 L" + x + " " + self.height() }); + }; + + for (var i in this.sessions) { + var s = this.sessions[i]; + s.draw(paper); + } + }; + + var processdata = function(data) { + var count = 0; + for (var i in data.events) { + var e = data.events[i]; + if (e.type == "transaction") { + e.tick = self.ticker.tick(e.time, true); + var session = self.findOrCreateSession(e.client); + session.addEvent(e); + count++; + } + } + paper.setSize(self.width(), self.height()); + + if (count != 0) { + self.draw(paper); + return true; + } else { + return false; + } + }; + + var uri = "/data?start=" + self.starttime + "&end=" + self.endtime + "&filter=" + filter; + + LogGraph.loadData(asyncq, uri, processdata); +}; + +LogGraph.SessionGraph.sessionevent = function () { + this.time = time; + this.type = type; + this.client = client; + this.cxid = cxid; + this.zxid = zxid; + this.op = op; + this.extra = extra; +}; + +LogGraph.SessionGraph.sessionEventPopup = function (obj, e, x, y) { + obj.click(function(evt) { + var popup = document.createElement("div"); + popup.className = "popUp"; + + var closebutton = document.createElement("div"); + closebutton.className = "closebutton"; + closebutton.title = "Close popup"; + closebutton.innerHTML = "×"; + popup.appendChild(closebutton); + closebutton.onclick= function(evt) { popup.style.visibility = "hidden"; document.body.removeChild(popup) }; + var txt = document.createElement("span"); + txt.innerHTML = "session: " + e.client + "
op: " + e.op + "
zxid: " + e.zxid + "
time: " + e.time + "
extra: " + e.extra; + popup.appendChild(txt); + + popup.style.top = y; + popup.style.left = x; + document.body.appendChild(popup); + + YUI().use('dd-drag', function(Y) { + //Selector of the node to make draggable + var dd = new Y.DD.Drag({ + node: popup + }); + }); + }); +}; + +LogGraph.SessionGraph.session = function (graph, index, id) { + this.index = index; + this.id = id; + this.graph = graph; + + this.events = new Array(); + this.starttick = 0; + this.endtick = undefined; + + this.addEvent = function(e) { + this.events.push(e); + + if (e.op == "createSession") { + // document.write("createSession for " + id.toString(16)); + this.starttick = e.tick; + } else if (e.op == "closeSession") { + this.endtick = e.tick; + } + }, + + this._attach_action = function (sess, label) { + sess.mouseover(function(evt) { + label.show(); + sess.attr({stroke: "gray"}); + }); + + sess.mouseout(function(evt) { + label.hide(); + sess.attr({stroke: "black"}); + }); + }, + + this.drawEvent = function (paper, y, e) { + var x = e.tick * this.graph.pix_per_ticks;; + var s = paper.path("M" + x + " " + (y - 3) + " L" + x + " " + (y + 3)); + s.attr({"stroke-width": 2}); + if (e.op == "error") { + s.attr({"stroke": "red"}); + } + s.mouseover(function(evt) { + s.attr({"stroke-width": 5}); + }); + + s.mouseout(function(evt) { + s.attr({"stroke-width": 2}); + }); + + LogGraph.SessionGraph.sessionEventPopup(s, e, x, y); + }, + + this.draw = function(paper) { + var y = this.index*this.graph.pix_per_session;; + var start = this.starttick * this.graph.pix_per_ticks; + var end = this.endtick * this.graph.pix_per_ticks; + + var sess = paper.set(); + + if (this.endtick == undefined) { + end = this.graph.width(); + } + + sess.push(paper.path("M" + start + " " + y + " L" + end + " " + y)); + for (var i in this.events) { + var e = this.events[i]; + this.drawEvent(paper, y, e); + } + + //sess.attr({"stroke-width": 3}); + label = paper.text(start + 100, y, this.id); + label.attr({"font-size": "14px"}); + label.hide(); + this._attach_action(sess, label); + } +}; + diff --git a/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/loggraph.stats.js b/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/loggraph.stats.js new file mode 100644 index 0000000..0a8ac4f --- /dev/null +++ b/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/loggraph.stats.js @@ -0,0 +1,44 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +LogGraph.StatsGraph = function (asyncq, canvas, starttime, endtime, filter) { + var processdata = function(data) { + var r = Raphael(canvas); + var x = data.map(function (x) { return x.time; }); + var y = data.map(function (x) { return x.count; }); + var xlabels = data.map(function (x) { return dateFormat(x.time, "HH:MM:ss,l"); } ); + var h1 = function () { + this.tags = r.set(); + for (var i = 0, ii = this.y.length; i < ii; i++) { + this.tags.push(r.g.tag(this.x, this.y[i], this.values[i], 160, 10).insertBefore(this).attr([{fill: "#fff"}, {fill: this.symbols[i].attr("fill")}])); + } + }; + var h2 = function () { + this.tags && this.tags.remove(); + }; + r.g.linechart(40, 40, 1000, 500, x, y, {shade: true, axis: "0 0 1 1", symbol: "x", southlabels: xlabels, axisxstep: xlabels.length - 1 , westAxisLabel: "Write requests", southAxisLabel: "Time (min)"}).hoverColumn(h1, h2); + + return true; + //r.g.barchart(0, 0, 1000, 100, y, {shade: true, symbol: "x"}).hoverColumn(h1, h2); + }; + + var uri = "/throughput?scale=minutes"; + LogGraph.loadData(asyncq, uri, processdata); +}; + + diff --git a/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/loggraph.ui.js b/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/loggraph.ui.js new file mode 100644 index 0000000..819765a --- /dev/null +++ b/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/loggraph.ui.js @@ -0,0 +1,377 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +// Opens a window to load files into the engine +LogGraph.fileSelector = function(callback) { + var self = this; + this.callback = callback; + this.selectedFiles = new Array(); + + var divTag = document.createElement("div"); + divTag.id = "fileSelector" + Math.round(Math.random()*100000); + // divTag.className = "popUp"; + divTag.className = "selector fileSelector"; + document.body.appendChild(divTag); + + YUI().use('dd-drag', function(Y) { + //Selector of the node to make draggable + var dd = new Y.DD.Drag({ + node: '#' + divTag.id + }); + }); + + var list = document.createElement("ul"); + divTag.appendChild(list); + var selectedList = document.createElement("selectedlist"); + divTag.appendChild(selectedList); + + var clearanchor = document.createElement("span"); + clearanchor.innerHTML = "Remove All"; + clearanchor.className = "actionbutton"; + clearanchor.style.cssFloat = "right"; + clearanchor.onclick = function () { + self.selectedFiles = new Array(); + self.updateSelectedList(); + }; + divTag.appendChild(clearanchor); + + var doneanchor = document.createElement("span"); + doneanchor.innerHTML = "Process Files"; + doneanchor.className = "actionbutton"; + doneanchor.style.cssFloat = "left"; + doneanchor.onclick = function () { + self.callback(self.selectedFiles); + document.body.removeChild(divTag); + delete divTag; + }; + divTag.appendChild(doneanchor); + + var cancelanchor = document.createElement("span"); + cancelanchor.innerHTML = "Cancel"; + cancelanchor.className = "actionbutton"; + cancelanchor.style.cssFloat = "left"; + cancelanchor.onclick = function () { + document.body.removeChild(divTag); + delete divTag; + }; + divTag.appendChild(cancelanchor); + + this.createFileListItem = function (file) { + var li = document.createElement("li"); + var a = document.createElement("a"); + if (file.type == "D") { + a.innerHTML = file.file + "/"; + a.onclick = function () { self.updateList(file.path); }; + } else { + a.innerHTML = file.file; + a.onclick = function () { self.addSelectedFile(file.path); }; + } + + a.fullpath = file.path;; + li.appendChild(a); + return li; + }; + + this.addSelectedFile = function (file) { + if (this.selectedFiles.indexOf(file) == -1) { + this.selectedFiles.push(file); + this.updateSelectedList(); + } + }; + + this.removeSelectedFile = function (file) { + this.selectedFiles = this.selectedFiles.filter(function(f) { return !(file == f); }); + this.updateSelectedList(); + }; + + this.createSelectedListItem = function (file) { + var li = document.createElement("li"); + var a = document.createElement("a"); + li.className = "selectedFile"; + a.onclick = function () { self.removeSelectedFile(file); }; + a.innerHTML = file; + li.appendChild(a); + return li; + }; + + this.updateSelectedList = function () { + while (selectedList.firstChild) { selectedList.removeChild(selectedList.firstChild); } + + for (var i in this.selectedFiles) { + var f = this.selectedFiles[i]; + selectedList.appendChild(this.createSelectedListItem(f)); + } + }; + + this.updateList = function (base) { + while (list.firstChild) list.removeChild(list.firstChild); + + // Create a YUI instance using io-base module. + YUI().use("io-base", function(Y) { + var uri = "/fs?path=" + base; + + // Define a function to handle the response data. + function complete(id, o, args) { + var id = id; // Transaction ID. + var data = eval("(" + o.responseText + ")"); // Response data. + var parts = base.split("/").slice(0,-1); + var parent = "" + if (parts.length < 2) { + parent = "/"; + } else { + parent = parts.join("/"); + } + if (base != "/") { + var li = self.createFileListItem({"file": "..", type: "D", path: parent}); + list.appendChild(li); + } + for (var i in data) { + var f = data[i]; + if (f.file[0] != '.') { + var li = self.createFileListItem(f); + list.appendChild(li); + } + } + }; + + Y.on('io:complete', complete, Y, []); + var request = Y.io(uri); + }); + }; + + this.updateList("/"); +}; + +// Open a window which loads files into the engine +LogGraph.fileLoader = function(files) { + var div = document.createElement("div"); + div.id = "fileLoader"; + + var imgArray = new Array(); + var pArray = new Array(); + for (var index in files) { + var f = files[index]; + var p = document.createElement("p"); + var i = document.createElement("img"); + i.src = "load.gif"; + i.style.visibility = "hidden"; + imgArray.push(i); + pArray.push(p); + var span = document.createElement("span"); + span.innerHTML = f; + + p.appendChild(span); + p.appendChild(i); + + div.appendChild(p); + } + + var loadFile = function (index) { + // Create a YUI instance using io-base module. + YUI().use("io-base", function(Y) { + var file = files[index]; + var uri = "/loadfile?path=" + file; + imgArray[index].style.visibility = "visible"; + + // Define a function to handle the response data. + function complete(id, o, args) { + var id = id; // Transaction ID. + var data = eval("(" + o.responseText + ")"); // Response data. + if (data.status == "ERR") { + var err = document.createElement("div"); + err.innerHTML = data.error; + pArray[index].appendChild(err); + } else if (data.status == "OK") { + var ok = document.createElement("div"); + ok.innerHTML = "OK"; + pArray[index].appendChild(ok); + } + + imgArray[index].style.visibility = "hidden"; + if (index + 1 < files.length) { + loadFile(index + 1); + } else { + //alert("DONE"); + } + }; + + Y.on('io:complete', complete, Y, []); + var request = Y.io(uri); + }); + }; + + var doneanchor = document.createElement("a"); + doneanchor.className = "actionbutton"; + doneanchor.innerHTML = "Done"; + doneanchor.onclick = function () { + document.body.removeChild(div); + delete div; + }; + + document.body.appendChild(div); + if (files.length > 0) { + loadFile(0); + } else { + div.innerHTML ="No files to load"; + } + div.appendChild(doneanchor); +} + +// select a time period +LogGraph.filterSelector = function(starttime, period, filter, callback) { + var self = this; + this.callback = callback; + + // Container other widgets will be in + var container = document.createElement("div"); + container.id = "filterSelector" + Math.round(Math.random()*100000); + container.className = "selector filterSelector"; + document.body.appendChild(container); + + YUI().use('dd-drag', function(Y) { + //Selector of the node to make draggable + var dd = new Y.DD.Drag({ + node: '#' + container.id + }); + }); + + // Temporary loading screen + var loadingp = document.createElement("p"); + loadingp.innerHTML = "Loading..."; + var loadimg = document.createElement("img"); + loadimg.src = "load.gif"; + loadingp.appendChild(loadimg); + container.appendChild(loadingp); + + var addWithLabel = function (container, labeltxt, object) { + var p = document.createElement("p"); + var label = document.createElement("label"); + label.innerHTML = labeltxt + ":"; + p.appendChild(label); + p.appendChild(object); + container.appendChild(p); + }; + var draw = function(minstart, maxstart, entries) { + container.removeChild(loadingp); + var inittime = minstart > starttime ? minstart : starttime; + + var numEntries = 0; + var startspan = document.createElement("span"); + addWithLabel(container, "Start time", startspan); + var startinput = document.createElement("input"); + startinput.type = "hidden"; + startinput.value = inittime; + container.appendChild(startinput); + var sliderspan = document.createElement("span"); + container.appendChild(sliderspan); + + var countspan = document.createElement("p"); + countspan.innerHTML = entries + " entries";; + container.appendChild(countspan); + + var windowinput = document.createElement("input"); + windowinput.type = "text"; + windowinput.value = period; + addWithLabel(container, "Time window (ms)", windowinput); + + var filterinput = document.createElement("textarea"); + filterinput.id = "filterinput"; + filterinput.value = filter; + addWithLabel(container, "Filter", filterinput); + + /* done link, when clicked time is updated, */ + var doneanchor = document.createElement("a"); + doneanchor.className = "actionbutton"; + doneanchor.innerHTML = "Done"; + doneanchor.onclick = function () { + var start = parseInt(startinput.value); + var period = parseInt(windowinput.value); + var filter = filterinput.value; + document.body.removeChild(container); + delete container; + + update(start, period, filter, function() { + callback(start, period, filter, numEntries); + }); + }; + container.appendChild(doneanchor); + + var update = function(start, period, filter, thenrun) { + startspan.innerHTML = dateFormat(start, "HH:MM:ss,l"); + // get the min and max start time + YUI().use("io-base", function(Y) { + var uri = "/info?start=" + start + "&period=" + period + "&filter=" + filter; + function complete(id, o, args) { + var data = eval("(" + o.responseText + ")"); + countspan.innerHTML = data.numEntries + " entries"; + numEntries = data.numEntries; + if (thenrun) { + thenrun(); + } + }; + + Y.on('io:complete', complete, Y, []); + var request = Y.io(uri); + }); + }; + + var updatewindow = function(evt) { + var start = parseInt(startinput.value); + var period = parseInt(windowinput.value); + var filter = filterinput.value; + update(start, period, filter); + }; + windowinput.onkeyup = updatewindow; + + + YUI().use("slider", function (Y) { + var input, slider; + + function updateInput( e ) { + this.set( "value", e.newVal ); + + update(parseInt(startinput.value), parseInt(windowinput.value), filterinput.value); + } + + xSlider = new Y.Slider({min: minstart, max: maxstart, value: inittime, length: "1000px" }); + + // Link the input value to the Slider + xInput = Y.one( startinput ); + xInput.setData( { slider: xSlider } ); + + // Pass the input as the 'this' object inside updateInput + xSlider.after( "valueChange", updateInput, xInput ); + + // Render the Slider next to the input + xSlider.render(sliderspan); + }); + update(inittime, windowinput.value, filterinput); + }; + + // get the min and max start time + YUI().use("io-base", function(Y) { + var uri = "/info"; + function complete(id, o, args) { + var data = eval("(" + o.responseText + ")"); + draw(data.startTime, data.endTime, data.numEntries); + }; + + Y.on('io:complete', complete, Y, []); + var request = Y.io(uri); + }); +} \ No newline at end of file diff --git a/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/main.html b/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/main.html new file mode 100644 index 0000000..b9affe6 --- /dev/null +++ b/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/main.html @@ -0,0 +1,60 @@ + + + + + + + + + + + + + + + + + + + + + + + + +
+ Edit Filters + Add logs +
+
+ Log view + Servers view + Sessions view + Statistics +
+
+
+
+
+ + diff --git a/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/raphael.js b/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/raphael.js new file mode 100644 index 0000000..3740d0f --- /dev/null +++ b/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/raphael.js @@ -0,0 +1,3296 @@ +/*! + * Raphael 1.3.2 - JavaScript Vector Library + * + * Copyright (c) 2009 Dmitry Baranovskiy (http://raphaeljs.com) + * Licensed under the MIT (http://www.opensource.org/licenses/mit-license.php) license. + */ + +Raphael = (function () { + var separator = /[, ]+/, + elements = /^(circle|rect|path|ellipse|text|image)$/, + proto = "prototype", + has = "hasOwnProperty", + doc = document, + win = window, + oldRaphael = { + was: Object[proto][has].call(win, "Raphael"), + is: win.Raphael + }, + R = function () { + if (R.is(arguments[0], "array")) { + var a = arguments[0], + cnv = create[apply](R, a.splice(0, 3 + R.is(a[0], nu))), + res = cnv.set(); + for (var i = 0, ii = a[length]; i < ii; i++) { + var j = a[i] || {}; + elements.test(j.type) && res[push](cnv[j.type]().attr(j)); + } + return res; + } + return create[apply](R, arguments); + }, + Paper = function () {}, + appendChild = "appendChild", + apply = "apply", + concat = "concat", + E = "", + S = " ", + split = "split", + events = "click dblclick mousedown mousemove mouseout mouseover mouseup"[split](S), + join = "join", + length = "length", + lowerCase = String[proto].toLowerCase, + math = Math, + mmax = math.max, + mmin = math.min, + nu = "number", + toString = "toString", + objectToString = Object[proto][toString], + paper = {}, + pow = math.pow, + push = "push", + rg = /^(?=[\da-f]$)/, + ISURL = /^url\(['"]?([^\)]+?)['"]?\)$/i, //" + colourRegExp = /^\s*((#[a-f\d]{6})|(#[a-f\d]{3})|rgb\(\s*([\d\.]+\s*,\s*[\d\.]+\s*,\s*[\d\.]+)\s*\)|rgb\(\s*([\d\.]+%\s*,\s*[\d\.]+%\s*,\s*[\d\.]+%)\s*\)|hs[bl]\(\s*([\d\.]+\s*,\s*[\d\.]+\s*,\s*[\d\.]+)\s*\)|hs[bl]\(\s*([\d\.]+%\s*,\s*[\d\.]+%\s*,\s*[\d\.]+%)\s*\))\s*$/i, + round = math.round, + setAttribute = "setAttribute", + toFloat = parseFloat, + toInt = parseInt, + upperCase = String[proto].toUpperCase, + availableAttrs = {blur: 0, "clip-rect": "0 0 1e9 1e9", cursor: "default", cx: 0, cy: 0, fill: "#fff", "fill-opacity": 1, font: '10px "Arial"', "font-family": '"Arial"', "font-size": "10", "font-style": "normal", "font-weight": 400, gradient: 0, height: 0, href: "http://raphaeljs.com/", opacity: 1, path: "M0,0", r: 0, rotation: 0, rx: 0, ry: 0, scale: "1 1", src: "", stroke: "#000", "stroke-dasharray": "", "stroke-linecap": "butt", "stroke-linejoin": "butt", "stroke-miterlimit": 0, "stroke-opacity": 1, "stroke-width": 1, target: "_blank", "text-anchor": "middle", title: "Raphael", translation: "0 0", width: 0, x: 0, y: 0}, + availableAnimAttrs = {along: "along", blur: nu, "clip-rect": "csv", cx: nu, cy: nu, fill: "colour", "fill-opacity": nu, "font-size": nu, height: nu, opacity: nu, path: "path", r: nu, rotation: "csv", rx: nu, ry: nu, scale: "csv", stroke: "colour", "stroke-opacity": nu, "stroke-width": nu, translation: "csv", width: nu, x: nu, y: nu}, + rp = "replace"; + R.version = "1.3.2"; + R.type = (win.SVGAngle || doc.implementation.hasFeature("http://www.w3.org/TR/SVG11/feature#BasicStructure", "1.1") ? "SVG" : "VML"); + if (R.type == "VML") { + var d = doc.createElement("div"); + d.innerHTML = ''; + if (d.childNodes[length] != 2) { + return R.type = null; + } + d = null; + } + R.svg = !(R.vml = R.type == "VML"); + Paper[proto] = R[proto]; + R._id = 0; + R._oid = 0; + R.fn = {}; + R.is = function (o, type) { + type = lowerCase.call(type); + return ((type == "object" || type == "undefined") && typeof o == type) || (o == null && type == "null") || lowerCase.call(objectToString.call(o).slice(8, -1)) == type; + }; + R.setWindow = function (newwin) { + win = newwin; + doc = win.document; + }; + // colour utilities + var toHex = function (color) { + if (R.vml) { + // http://dean.edwards.name/weblog/2009/10/convert-any-colour-value-to-hex-in-msie/ + var trim = /^\s+|\s+$/g; + toHex = cacher(function (color) { + var bod; + color = (color + E)[rp](trim, E); + try { + var docum = new win.ActiveXObject("htmlfile"); + docum.write(""); + docum.close(); + bod = docum.body; + } catch(e) { + bod = win.createPopup().document.body; + } + var range = bod.createTextRange(); + try { + bod.style.color = color; + var value = range.queryCommandValue("ForeColor"); + value = ((value & 255) << 16) | (value & 65280) | ((value & 16711680) >>> 16); + return "#" + ("000000" + value[toString](16)).slice(-6); + } catch(e) { + return "none"; + } + }); + } else { + var i = doc.createElement("i"); + i.title = "Rapha\xebl Colour Picker"; + i.style.display = "none"; + doc.body[appendChild](i); + toHex = cacher(function (color) { + i.style.color = color; + return doc.defaultView.getComputedStyle(i, E).getPropertyValue("color"); + }); + } + return toHex(color); + }; + var hsbtoString = function () { + return "hsb(" + [this.h, this.s, this.b] + ")"; + }, + rgbtoString = function () { + return this.hex; + }; + R.hsb2rgb = cacher(function (hue, saturation, brightness) { + if (R.is(hue, "object") && "h" in hue && "s" in hue && "b" in hue) { + brightness = hue.b; + saturation = hue.s; + hue = hue.h; + } + var red, + green, + blue; + if (brightness == 0) { + return {r: 0, g: 0, b: 0, hex: "#000"}; + } + if (hue > 1 || saturation > 1 || brightness > 1) { + hue /= 255; + saturation /= 255; + brightness /= 255; + } + var i = ~~(hue * 6), + f = (hue * 6) - i, + p = brightness * (1 - saturation), + q = brightness * (1 - (saturation * f)), + t = brightness * (1 - (saturation * (1 - f))); + red = [brightness, q, p, p, t, brightness, brightness][i]; + green = [t, brightness, brightness, q, p, p, t][i]; + blue = [p, p, t, brightness, brightness, q, p][i]; + red *= 255; + green *= 255; + blue *= 255; + var rgb = {r: red, g: green, b: blue, toString: rgbtoString}, + r = (~~red)[toString](16), + g = (~~green)[toString](16), + b = (~~blue)[toString](16); + r = r[rp](rg, "0"); + g = g[rp](rg, "0"); + b = b[rp](rg, "0"); + rgb.hex = "#" + r + g + b; + return rgb; + }, R); + R.rgb2hsb = cacher(function (red, green, blue) { + if (R.is(red, "object") && "r" in red && "g" in red && "b" in red) { + blue = red.b; + green = red.g; + red = red.r; + } + if (R.is(red, "string")) { + var clr = R.getRGB(red); + red = clr.r; + green = clr.g; + blue = clr.b; + } + if (red > 1 || green > 1 || blue > 1) { + red /= 255; + green /= 255; + blue /= 255; + } + var max = mmax(red, green, blue), + min = mmin(red, green, blue), + hue, + saturation, + brightness = max; + if (min == max) { + return {h: 0, s: 0, b: max}; + } else { + var delta = (max - min); + saturation = delta / max; + if (red == max) { + hue = (green - blue) / delta; + } else if (green == max) { + hue = 2 + ((blue - red) / delta); + } else { + hue = 4 + ((red - green) / delta); + } + hue /= 6; + hue < 0 && hue++; + hue > 1 && hue--; + } + return {h: hue, s: saturation, b: brightness, toString: hsbtoString}; + }, R); + var p2s = /,?([achlmqrstvxz]),?/gi; + R._path2string = function () { + return this.join(",")[rp](p2s, "$1"); + }; + function cacher(f, scope, postprocessor) { + function newf() { + var arg = Array[proto].slice.call(arguments, 0), + args = arg[join]("\u25ba"), + cache = newf.cache = newf.cache || {}, + count = newf.count = newf.count || []; + if (cache[has](args)) { + return postprocessor ? postprocessor(cache[args]) : cache[args]; + } + count[length] >= 1e3 && delete cache[count.shift()]; + count[push](args); + cache[args] = f[apply](scope, arg); + return postprocessor ? postprocessor(cache[args]) : cache[args]; + } + return newf; + } + + R.getRGB = cacher(function (colour) { + if (!colour || !!((colour = colour + E).indexOf("-") + 1)) { + return {r: -1, g: -1, b: -1, hex: "none", error: 1}; + } + if (colour == "none") { + return {r: -1, g: -1, b: -1, hex: "none"}; + } + !(({hs: 1, rg: 1})[has](colour.substring(0, 2)) || colour.charAt() == "#") && (colour = toHex(colour)); + var res, + red, + green, + blue, + t, + rgb = colour.match(colourRegExp); + if (rgb) { + if (rgb[2]) { + blue = toInt(rgb[2].substring(5), 16); + green = toInt(rgb[2].substring(3, 5), 16); + red = toInt(rgb[2].substring(1, 3), 16); + } + if (rgb[3]) { + blue = toInt((t = rgb[3].charAt(3)) + t, 16); + green = toInt((t = rgb[3].charAt(2)) + t, 16); + red = toInt((t = rgb[3].charAt(1)) + t, 16); + } + if (rgb[4]) { + rgb = rgb[4][split](/\s*,\s*/); + red = toFloat(rgb[0]); + green = toFloat(rgb[1]); + blue = toFloat(rgb[2]); + } + if (rgb[5]) { + rgb = rgb[5][split](/\s*,\s*/); + red = toFloat(rgb[0]) * 2.55; + green = toFloat(rgb[1]) * 2.55; + blue = toFloat(rgb[2]) * 2.55; + } + if (rgb[6]) { + rgb = rgb[6][split](/\s*,\s*/); + red = toFloat(rgb[0]); + green = toFloat(rgb[1]); + blue = toFloat(rgb[2]); + return R.hsb2rgb(red, green, blue); + } + if (rgb[7]) { + rgb = rgb[7][split](/\s*,\s*/); + red = toFloat(rgb[0]) * 2.55; + green = toFloat(rgb[1]) * 2.55; + blue = toFloat(rgb[2]) * 2.55; + return R.hsb2rgb(red, green, blue); + } + rgb = {r: red, g: green, b: blue}; + var r = (~~red)[toString](16), + g = (~~green)[toString](16), + b = (~~blue)[toString](16); + r = r[rp](rg, "0"); + g = g[rp](rg, "0"); + b = b[rp](rg, "0"); + rgb.hex = "#" + r + g + b; + return rgb; + } + return {r: -1, g: -1, b: -1, hex: "none", error: 1}; + }, R); + R.getColor = function (value) { + var start = this.getColor.start = this.getColor.start || {h: 0, s: 1, b: value || .75}, + rgb = this.hsb2rgb(start.h, start.s, start.b); + start.h += .075; + if (start.h > 1) { + start.h = 0; + start.s -= .2; + start.s <= 0 && (this.getColor.start = {h: 0, s: 1, b: start.b}); + } + return rgb.hex; + }; + R.getColor.reset = function () { + delete this.start; + }; + // path utilities + var pathCommand = /([achlmqstvz])[\s,]*((-?\d*\.?\d*(?:e[-+]?\d+)?\s*,?\s*)+)/ig, + pathValues = /(-?\d*\.?\d*(?:e[-+]?\d+)?)\s*,?\s*/ig; + R.parsePathString = cacher(function (pathString) { + if (!pathString) { + return null; + } + var paramCounts = {a: 7, c: 6, h: 1, l: 2, m: 2, q: 4, s: 4, t: 2, v: 1, z: 0}, + data = []; + if (R.is(pathString, "array") && R.is(pathString[0], "array")) { // rough assumption + data = pathClone(pathString); + } + if (!data[length]) { + (pathString + E)[rp](pathCommand, function (a, b, c) { + var params = [], + name = lowerCase.call(b); + c[rp](pathValues, function (a, b) { + b && params[push](+b); + }); + if (name == "m" && params[length] > 2) { + data[push]([b][concat](params.splice(0, 2))); + name = "l"; + b = b == "m" ? "l" : "L"; + } + while (params[length] >= paramCounts[name]) { + data[push]([b][concat](params.splice(0, paramCounts[name]))); + if (!paramCounts[name]) { + break; + } + } + }); + } + data[toString] = R._path2string; + return data; + }); + R.findDotsAtSegment = function (p1x, p1y, c1x, c1y, c2x, c2y, p2x, p2y, t) { + var t1 = 1 - t, + x = pow(t1, 3) * p1x + pow(t1, 2) * 3 * t * c1x + t1 * 3 * t * t * c2x + pow(t, 3) * p2x, + y = pow(t1, 3) * p1y + pow(t1, 2) * 3 * t * c1y + t1 * 3 * t * t * c2y + pow(t, 3) * p2y, + mx = p1x + 2 * t * (c1x - p1x) + t * t * (c2x - 2 * c1x + p1x), + my = p1y + 2 * t * (c1y - p1y) + t * t * (c2y - 2 * c1y + p1y), + nx = c1x + 2 * t * (c2x - c1x) + t * t * (p2x - 2 * c2x + c1x), + ny = c1y + 2 * t * (c2y - c1y) + t * t * (p2y - 2 * c2y + c1y), + ax = (1 - t) * p1x + t * c1x, + ay = (1 - t) * p1y + t * c1y, + cx = (1 - t) * c2x + t * p2x, + cy = (1 - t) * c2y + t * p2y, + alpha = (90 - math.atan((mx - nx) / (my - ny)) * 180 / math.PI); + (mx > nx || my < ny) && (alpha += 180); + return {x: x, y: y, m: {x: mx, y: my}, n: {x: nx, y: ny}, start: {x: ax, y: ay}, end: {x: cx, y: cy}, alpha: alpha}; + }; + var pathDimensions = cacher(function (path) { + if (!path) { + return {x: 0, y: 0, width: 0, height: 0}; + } + path = path2curve(path); + var x = 0, + y = 0, + X = [], + Y = [], + p; + for (var i = 0, ii = path[length]; i < ii; i++) { + p = path[i]; + if (p[0] == "M") { + x = p[1]; + y = p[2]; + X[push](x); + Y[push](y); + } else { + var dim = curveDim(x, y, p[1], p[2], p[3], p[4], p[5], p[6]); + X = X[concat](dim.min.x, dim.max.x); + Y = Y[concat](dim.min.y, dim.max.y); + x = p[5]; + y = p[6]; + } + } + var xmin = mmin[apply](0, X), + ymin = mmin[apply](0, Y); + return { + x: xmin, + y: ymin, + width: mmax[apply](0, X) - xmin, + height: mmax[apply](0, Y) - ymin + }; + }), + pathClone = function (pathArray) { + var res = []; + if (!R.is(pathArray, "array") || !R.is(pathArray && pathArray[0], "array")) { // rough assumption + pathArray = R.parsePathString(pathArray); + } + for (var i = 0, ii = pathArray[length]; i < ii; i++) { + res[i] = []; + for (var j = 0, jj = pathArray[i][length]; j < jj; j++) { + res[i][j] = pathArray[i][j]; + } + } + res[toString] = R._path2string; + return res; + }, + pathToRelative = cacher(function (pathArray) { + if (!R.is(pathArray, "array") || !R.is(pathArray && pathArray[0], "array")) { // rough assumption + pathArray = R.parsePathString(pathArray); + } + var res = [], + x = 0, + y = 0, + mx = 0, + my = 0, + start = 0; + if (pathArray[0][0] == "M") { + x = pathArray[0][1]; + y = pathArray[0][2]; + mx = x; + my = y; + start++; + res[push](["M", x, y]); + } + for (var i = start, ii = pathArray[length]; i < ii; i++) { + var r = res[i] = [], + pa = pathArray[i]; + if (pa[0] != lowerCase.call(pa[0])) { + r[0] = lowerCase.call(pa[0]); + switch (r[0]) { + case "a": + r[1] = pa[1]; + r[2] = pa[2]; + r[3] = pa[3]; + r[4] = pa[4]; + r[5] = pa[5]; + r[6] = +(pa[6] - x).toFixed(3); + r[7] = +(pa[7] - y).toFixed(3); + break; + case "v": + r[1] = +(pa[1] - y).toFixed(3); + break; + case "m": + mx = pa[1]; + my = pa[2]; + default: + for (var j = 1, jj = pa[length]; j < jj; j++) { + r[j] = +(pa[j] - ((j % 2) ? x : y)).toFixed(3); + } + } + } else { + r = res[i] = []; + if (pa[0] == "m") { + mx = pa[1] + x; + my = pa[2] + y; + } + for (var k = 0, kk = pa[length]; k < kk; k++) { + res[i][k] = pa[k]; + } + } + var len = res[i][length]; + switch (res[i][0]) { + case "z": + x = mx; + y = my; + break; + case "h": + x += +res[i][len - 1]; + break; + case "v": + y += +res[i][len - 1]; + break; + default: + x += +res[i][len - 2]; + y += +res[i][len - 1]; + } + } + res[toString] = R._path2string; + return res; + }, 0, pathClone), + pathToAbsolute = cacher(function (pathArray) { + if (!R.is(pathArray, "array") || !R.is(pathArray && pathArray[0], "array")) { // rough assumption + pathArray = R.parsePathString(pathArray); + } + var res = [], + x = 0, + y = 0, + mx = 0, + my = 0, + start = 0; + if (pathArray[0][0] == "M") { + x = +pathArray[0][1]; + y = +pathArray[0][2]; + mx = x; + my = y; + start++; + res[0] = ["M", x, y]; + } + for (var i = start, ii = pathArray[length]; i < ii; i++) { + var r = res[i] = [], + pa = pathArray[i]; + if (pa[0] != upperCase.call(pa[0])) { + r[0] = upperCase.call(pa[0]); + switch (r[0]) { + case "A": + r[1] = pa[1]; + r[2] = pa[2]; + r[3] = pa[3]; + r[4] = pa[4]; + r[5] = pa[5]; + r[6] = +(pa[6] + x); + r[7] = +(pa[7] + y); + break; + case "V": + r[1] = +pa[1] + y; + break; + case "H": + r[1] = +pa[1] + x; + break; + case "M": + mx = +pa[1] + x; + my = +pa[2] + y; + default: + for (var j = 1, jj = pa[length]; j < jj; j++) { + r[j] = +pa[j] + ((j % 2) ? x : y); + } + } + } else { + for (var k = 0, kk = pa[length]; k < kk; k++) { + res[i][k] = pa[k]; + } + } + switch (r[0]) { + case "Z": + x = mx; + y = my; + break; + case "H": + x = r[1]; + break; + case "V": + y = r[1]; + break; + default: + x = res[i][res[i][length] - 2]; + y = res[i][res[i][length] - 1]; + } + } + res[toString] = R._path2string; + return res; + }, null, pathClone), + l2c = function (x1, y1, x2, y2) { + return [x1, y1, x2, y2, x2, y2]; + }, + q2c = function (x1, y1, ax, ay, x2, y2) { + var _13 = 1 / 3, + _23 = 2 / 3; + return [ + _13 * x1 + _23 * ax, + _13 * y1 + _23 * ay, + _13 * x2 + _23 * ax, + _13 * y2 + _23 * ay, + x2, + y2 + ]; + }, + a2c = function (x1, y1, rx, ry, angle, large_arc_flag, sweep_flag, x2, y2, recursive) { + // for more information of where this math came from visit: + // http://www.w3.org/TR/SVG11/implnote.html#ArcImplementationNotes + var PI = math.PI, + _120 = PI * 120 / 180, + rad = PI / 180 * (+angle || 0), + res = [], + xy, + rotate = cacher(function (x, y, rad) { + var X = x * math.cos(rad) - y * math.sin(rad), + Y = x * math.sin(rad) + y * math.cos(rad); + return {x: X, y: Y}; + }); + if (!recursive) { + xy = rotate(x1, y1, -rad); + x1 = xy.x; + y1 = xy.y; + xy = rotate(x2, y2, -rad); + x2 = xy.x; + y2 = xy.y; + var cos = math.cos(PI / 180 * angle), + sin = math.sin(PI / 180 * angle), + x = (x1 - x2) / 2, + y = (y1 - y2) / 2; + // rx = mmax(rx, math.abs(x)); + // ry = mmax(ry, math.abs(y)); + var h = (x * x) / (rx * rx) + (y * y) / (ry * ry); + if (h > 1) { + h = math.sqrt(h); + rx = h * rx; + ry = h * ry; + } + var rx2 = rx * rx, + ry2 = ry * ry, + k = (large_arc_flag == sweep_flag ? -1 : 1) * + math.sqrt(math.abs((rx2 * ry2 - rx2 * y * y - ry2 * x * x) / (rx2 * y * y + ry2 * x * x))), + cx = k * rx * y / ry + (x1 + x2) / 2, + cy = k * -ry * x / rx + (y1 + y2) / 2, + f1 = math.asin(((y1 - cy) / ry).toFixed(7)), + f2 = math.asin(((y2 - cy) / ry).toFixed(7)); + + f1 = x1 < cx ? PI - f1 : f1; + f2 = x2 < cx ? PI - f2 : f2; + f1 < 0 && (f1 = PI * 2 + f1); + f2 < 0 && (f2 = PI * 2 + f2); + if (sweep_flag && f1 > f2) { + f1 = f1 - PI * 2; + } + if (!sweep_flag && f2 > f1) { + f2 = f2 - PI * 2; + } + } else { + f1 = recursive[0]; + f2 = recursive[1]; + cx = recursive[2]; + cy = recursive[3]; + } + var df = f2 - f1; + if (math.abs(df) > _120) { + var f2old = f2, + x2old = x2, + y2old = y2; + f2 = f1 + _120 * (sweep_flag && f2 > f1 ? 1 : -1); + x2 = cx + rx * math.cos(f2); + y2 = cy + ry * math.sin(f2); + res = a2c(x2, y2, rx, ry, angle, 0, sweep_flag, x2old, y2old, [f2, f2old, cx, cy]); + } + df = f2 - f1; + var c1 = math.cos(f1), + s1 = math.sin(f1), + c2 = math.cos(f2), + s2 = math.sin(f2), + t = math.tan(df / 4), + hx = 4 / 3 * rx * t, + hy = 4 / 3 * ry * t, + m1 = [x1, y1], + m2 = [x1 + hx * s1, y1 - hy * c1], + m3 = [x2 + hx * s2, y2 - hy * c2], + m4 = [x2, y2]; + m2[0] = 2 * m1[0] - m2[0]; + m2[1] = 2 * m1[1] - m2[1]; + if (recursive) { + return [m2, m3, m4][concat](res); + } else { + res = [m2, m3, m4][concat](res)[join]()[split](","); + var newres = []; + for (var i = 0, ii = res[length]; i < ii; i++) { + newres[i] = i % 2 ? rotate(res[i - 1], res[i], rad).y : rotate(res[i], res[i + 1], rad).x; + } + // alert(newres); + return newres; + } + }, + findDotAtSegment = function (p1x, p1y, c1x, c1y, c2x, c2y, p2x, p2y, t) { + var t1 = 1 - t; + return { + x: pow(t1, 3) * p1x + pow(t1, 2) * 3 * t * c1x + t1 * 3 * t * t * c2x + pow(t, 3) * p2x, + y: pow(t1, 3) * p1y + pow(t1, 2) * 3 * t * c1y + t1 * 3 * t * t * c2y + pow(t, 3) * p2y + }; + }, + curveDim = cacher(function (p1x, p1y, c1x, c1y, c2x, c2y, p2x, p2y) { + var a = (c2x - 2 * c1x + p1x) - (p2x - 2 * c2x + c1x), + b = 2 * (c1x - p1x) - 2 * (c2x - c1x), + c = p1x - c1x, + t1 = (-b + math.sqrt(b * b - 4 * a * c)) / 2 / a, + t2 = (-b - math.sqrt(b * b - 4 * a * c)) / 2 / a, + y = [p1y, p2y], + x = [p1x, p2x], + dot; + math.abs(t1) > 1e12 && (t1 = .5); + math.abs(t2) > 1e12 && (t2 = .5); + if (t1 > 0 && t1 < 1) { + dot = findDotAtSegment(p1x, p1y, c1x, c1y, c2x, c2y, p2x, p2y, t1); + x[push](dot.x); + y[push](dot.y); + } + if (t2 > 0 && t2 < 1) { + dot = findDotAtSegment(p1x, p1y, c1x, c1y, c2x, c2y, p2x, p2y, t2); + x[push](dot.x); + y[push](dot.y); + } + a = (c2y - 2 * c1y + p1y) - (p2y - 2 * c2y + c1y); + b = 2 * (c1y - p1y) - 2 * (c2y - c1y); + c = p1y - c1y; + t1 = (-b + math.sqrt(b * b - 4 * a * c)) / 2 / a; + t2 = (-b - math.sqrt(b * b - 4 * a * c)) / 2 / a; + math.abs(t1) > 1e12 && (t1 = .5); + math.abs(t2) > 1e12 && (t2 = .5); + if (t1 > 0 && t1 < 1) { + dot = findDotAtSegment(p1x, p1y, c1x, c1y, c2x, c2y, p2x, p2y, t1); + x[push](dot.x); + y[push](dot.y); + } + if (t2 > 0 && t2 < 1) { + dot = findDotAtSegment(p1x, p1y, c1x, c1y, c2x, c2y, p2x, p2y, t2); + x[push](dot.x); + y[push](dot.y); + } + return { + min: {x: mmin[apply](0, x), y: mmin[apply](0, y)}, + max: {x: mmax[apply](0, x), y: mmax[apply](0, y)} + }; + }), + path2curve = cacher(function (path, path2) { + var p = pathToAbsolute(path), + p2 = path2 && pathToAbsolute(path2), + attrs = {x: 0, y: 0, bx: 0, by: 0, X: 0, Y: 0, qx: null, qy: null}, + attrs2 = {x: 0, y: 0, bx: 0, by: 0, X: 0, Y: 0, qx: null, qy: null}, + processPath = function (path, d) { + var nx, ny; + if (!path) { + return ["C", d.x, d.y, d.x, d.y, d.x, d.y]; + } + !(path[0] in {T:1, Q:1}) && (d.qx = d.qy = null); + switch (path[0]) { + case "M": + d.X = path[1]; + d.Y = path[2]; + break; + case "A": + path = ["C"][concat](a2c[apply](0, [d.x, d.y][concat](path.slice(1)))); + break; + case "S": + nx = d.x + (d.x - (d.bx || d.x)); + ny = d.y + (d.y - (d.by || d.y)); + path = ["C", nx, ny][concat](path.slice(1)); + break; + case "T": + d.qx = d.x + (d.x - (d.qx || d.x)); + d.qy = d.y + (d.y - (d.qy || d.y)); + path = ["C"][concat](q2c(d.x, d.y, d.qx, d.qy, path[1], path[2])); + break; + case "Q": + d.qx = path[1]; + d.qy = path[2]; + path = ["C"][concat](q2c(d.x, d.y, path[1], path[2], path[3], path[4])); + break; + case "L": + path = ["C"][concat](l2c(d.x, d.y, path[1], path[2])); + break; + case "H": + path = ["C"][concat](l2c(d.x, d.y, path[1], d.y)); + break; + case "V": + path = ["C"][concat](l2c(d.x, d.y, d.x, path[1])); + break; + case "Z": + path = ["C"][concat](l2c(d.x, d.y, d.X, d.Y)); + break; + } + return path; + }, + fixArc = function (pp, i) { + if (pp[i][length] > 7) { + pp[i].shift(); + var pi = pp[i]; + while (pi[length]) { + pp.splice(i++, 0, ["C"][concat](pi.splice(0, 6))); + } + pp.splice(i, 1); + ii = mmax(p[length], p2 && p2[length] || 0); + } + }, + fixM = function (path1, path2, a1, a2, i) { + if (path1 && path2 && path1[i][0] == "M" && path2[i][0] != "M") { + path2.splice(i, 0, ["M", a2.x, a2.y]); + a1.bx = 0; + a1.by = 0; + a1.x = path1[i][1]; + a1.y = path1[i][2]; + ii = mmax(p[length], p2 && p2[length] || 0); + } + }; + for (var i = 0, ii = mmax(p[length], p2 && p2[length] || 0); i < ii; i++) { + p[i] = processPath(p[i], attrs); + fixArc(p, i); + p2 && (p2[i] = processPath(p2[i], attrs2)); + p2 && fixArc(p2, i); + fixM(p, p2, attrs, attrs2, i); + fixM(p2, p, attrs2, attrs, i); + var seg = p[i], + seg2 = p2 && p2[i], + seglen = seg[length], + seg2len = p2 && seg2[length]; + attrs.x = seg[seglen - 2]; + attrs.y = seg[seglen - 1]; + attrs.bx = toFloat(seg[seglen - 4]) || attrs.x; + attrs.by = toFloat(seg[seglen - 3]) || attrs.y; + attrs2.bx = p2 && (toFloat(seg2[seg2len - 4]) || attrs2.x); + attrs2.by = p2 && (toFloat(seg2[seg2len - 3]) || attrs2.y); + attrs2.x = p2 && seg2[seg2len - 2]; + attrs2.y = p2 && seg2[seg2len - 1]; + } + return p2 ? [p, p2] : p; + }, null, pathClone), + parseDots = cacher(function (gradient) { + var dots = []; + for (var i = 0, ii = gradient[length]; i < ii; i++) { + var dot = {}, + par = gradient[i].match(/^([^:]*):?([\d\.]*)/); + dot.color = R.getRGB(par[1]); + if (dot.color.error) { + return null; + } + dot.color = dot.color.hex; + par[2] && (dot.offset = par[2] + "%"); + dots[push](dot); + } + for (i = 1, ii = dots[length] - 1; i < ii; i++) { + if (!dots[i].offset) { + var start = toFloat(dots[i - 1].offset || 0), + end = 0; + for (var j = i + 1; j < ii; j++) { + if (dots[j].offset) { + end = dots[j].offset; + break; + } + } + if (!end) { + end = 100; + j = ii; + } + end = toFloat(end); + var d = (end - start) / (j - i + 1); + for (; i < j; i++) { + start += d; + dots[i].offset = start + "%"; + } + } + } + return dots; + }), + getContainer = function (x, y, w, h) { + var container; + if (R.is(x, "string") || R.is(x, "object")) { + container = R.is(x, "string") ? doc.getElementById(x) : x; + if (container.tagName) { + if (y == null) { + return { + container: container, + width: container.style.pixelWidth || container.offsetWidth, + height: container.style.pixelHeight || container.offsetHeight + }; + } else { + return {container: container, width: y, height: w}; + } + } + } else if (R.is(x, nu) && h != null) { + return {container: 1, x: x, y: y, width: w, height: h}; + } + }, + plugins = function (con, add) { + var that = this; + for (var prop in add) { + if (add[has](prop) && !(prop in con)) { + switch (typeof add[prop]) { + case "function": + (function (f) { + con[prop] = con === that ? f : function () { return f[apply](that, arguments); }; + })(add[prop]); + break; + case "object": + con[prop] = con[prop] || {}; + plugins.call(this, con[prop], add[prop]); + break; + default: + con[prop] = add[prop]; + break; + } + } + } + }, + tear = function (el, paper) { + el == paper.top && (paper.top = el.prev); + el == paper.bottom && (paper.bottom = el.next); + el.next && (el.next.prev = el.prev); + el.prev && (el.prev.next = el.next); + }, + tofront = function (el, paper) { + if (paper.top === el) { + return; + } + tear(el, paper); + el.next = null; + el.prev = paper.top; + paper.top.next = el; + paper.top = el; + }, + toback = function (el, paper) { + if (paper.bottom === el) { + return; + } + tear(el, paper); + el.next = paper.bottom; + el.prev = null; + paper.bottom.prev = el; + paper.bottom = el; + }, + insertafter = function (el, el2, paper) { + tear(el, paper); + el2 == paper.top && (paper.top = el); + el2.next && (el2.next.prev = el); + el.next = el2.next; + el.prev = el2; + el2.next = el; + }, + insertbefore = function (el, el2, paper) { + tear(el, paper); + el2 == paper.bottom && (paper.bottom = el); + el2.prev && (el2.prev.next = el); + el.prev = el2.prev; + el2.prev = el; + el.next = el2; + }, + removed = function (methodname) { + return function () { + throw new Error("Rapha\xebl: you are calling to method \u201c" + methodname + "\u201d of removed object"); + }; + }, + radial_gradient = /^r(?:\(([^,]+?)\s*,\s*([^\)]+?)\))?/; + + // SVG + if (R.svg) { + Paper[proto].svgns = "http://www.w3.org/2000/svg"; + Paper[proto].xlink = "http://www.w3.org/1999/xlink"; + round = function (num) { + return +num + (~~num === num) * .5; + }; + var roundPath = function (path) { + for (var i = 0, ii = path[length]; i < ii; i++) { + if (lowerCase.call(path[i][0]) != "a") { + for (var j = 1, jj = path[i][length]; j < jj; j++) { + path[i][j] = round(path[i][j]); + } + } else { + path[i][6] = round(path[i][6]); + path[i][7] = round(path[i][7]); + } + } + return path; + }, + $ = function (el, attr) { + if (attr) { + for (var key in attr) { + if (attr[has](key)) { + el[setAttribute](key, attr[key] + E); + } + } + } else { + return doc.createElementNS(Paper[proto].svgns, el); + } + }; + R[toString] = function () { + return "Your browser supports SVG.\nYou are running Rapha\xebl " + this.version; + }; + var thePath = function (pathString, SVG) { + var el = $("path"); + SVG.canvas && SVG.canvas[appendChild](el); + var p = new Element(el, SVG); + p.type = "path"; + setFillAndStroke(p, {fill: "none", stroke: "#000", path: pathString}); + return p; + }; + var addGradientFill = function (o, gradient, SVG) { + var type = "linear", + fx = .5, fy = .5, + s = o.style; + gradient = (gradient + E)[rp](radial_gradient, function (all, _fx, _fy) { + type = "radial"; + if (_fx && _fy) { + fx = toFloat(_fx); + fy = toFloat(_fy); + var dir = ((fy > .5) * 2 - 1); + pow(fx - .5, 2) + pow(fy - .5, 2) > .25 && + (fy = math.sqrt(.25 - pow(fx - .5, 2)) * dir + .5) && + fy != .5 && + (fy = fy.toFixed(5) - 1e-5 * dir); + } + return E; + }); + gradient = gradient[split](/\s*\-\s*/); + if (type == "linear") { + var angle = gradient.shift(); + angle = -toFloat(angle); + if (isNaN(angle)) { + return null; + } + var vector = [0, 0, math.cos(angle * math.PI / 180), math.sin(angle * math.PI / 180)], + max = 1 / (mmax(math.abs(vector[2]), math.abs(vector[3])) || 1); + vector[2] *= max; + vector[3] *= max; + if (vector[2] < 0) { + vector[0] = -vector[2]; + vector[2] = 0; + } + if (vector[3] < 0) { + vector[1] = -vector[3]; + vector[3] = 0; + } + } + var dots = parseDots(gradient); + if (!dots) { + return null; + } + var id = o.getAttribute("fill"); + id = id.match(/^url\(#(.*)\)$/); + id && SVG.defs.removeChild(doc.getElementById(id[1])); + + var el = $(type + "Gradient"); + el.id = "r" + (R._id++)[toString](36); + $(el, type == "radial" ? {fx: fx, fy: fy} : {x1: vector[0], y1: vector[1], x2: vector[2], y2: vector[3]}); + SVG.defs[appendChild](el); + for (var i = 0, ii = dots[length]; i < ii; i++) { + var stop = $("stop"); + $(stop, { + offset: dots[i].offset ? dots[i].offset : !i ? "0%" : "100%", + "stop-color": dots[i].color || "#fff" + }); + el[appendChild](stop); + } + $(o, { + fill: "url(#" + el.id + ")", + opacity: 1, + "fill-opacity": 1 + }); + s.fill = E; + s.opacity = 1; + s.fillOpacity = 1; + return 1; + }; + var updatePosition = function (o) { + var bbox = o.getBBox(); + $(o.pattern, {patternTransform: R.format("translate({0},{1})", bbox.x, bbox.y)}); + }; + var setFillAndStroke = function (o, params) { + var dasharray = { + "": [0], + "none": [0], + "-": [3, 1], + ".": [1, 1], + "-.": [3, 1, 1, 1], + "-..": [3, 1, 1, 1, 1, 1], + ". ": [1, 3], + "- ": [4, 3], + "--": [8, 3], + "- .": [4, 3, 1, 3], + "--.": [8, 3, 1, 3], + "--..": [8, 3, 1, 3, 1, 3] + }, + node = o.node, + attrs = o.attrs, + rot = o.rotate(), + addDashes = function (o, value) { + value = dasharray[lowerCase.call(value)]; + if (value) { + var width = o.attrs["stroke-width"] || "1", + butt = {round: width, square: width, butt: 0}[o.attrs["stroke-linecap"] || params["stroke-linecap"]] || 0, + dashes = []; + var i = value[length]; + while (i--) { + dashes[i] = value[i] * width + ((i % 2) ? 1 : -1) * butt; + } + $(node, {"stroke-dasharray": dashes[join](",")}); + } + }; + params[has]("rotation") && (rot = params.rotation); + var rotxy = (rot + E)[split](separator); + if (!(rotxy.length - 1)) { + rotxy = null; + } else { + rotxy[1] = +rotxy[1]; + rotxy[2] = +rotxy[2]; + } + toFloat(rot) && o.rotate(0, true); + for (var att in params) { + if (params[has](att)) { + if (!availableAttrs[has](att)) { + continue; + } + var value = params[att]; + attrs[att] = value; + switch (att) { + case "blur": + o.blur(value); + break; + case "rotation": + o.rotate(value, true); + break; + // Hyperlink + case "href": + case "title": + case "target": + var pn = node.parentNode; + if (lowerCase.call(pn.tagName) != "a") { + var hl = $("a"); + pn.insertBefore(hl, node); + hl[appendChild](node); + pn = hl; + } + pn.setAttributeNS(o.paper.xlink, att, value); + break; + case "cursor": + node.style.cursor = value; + break; + case "clip-rect": + var rect = (value + E)[split](separator); + if (rect[length] == 4) { + o.clip && o.clip.parentNode.parentNode.removeChild(o.clip.parentNode); + var el = $("clipPath"), + rc = $("rect"); + el.id = "r" + (R._id++)[toString](36); + $(rc, { + x: rect[0], + y: rect[1], + width: rect[2], + height: rect[3] + }); + el[appendChild](rc); + o.paper.defs[appendChild](el); + $(node, {"clip-path": "url(#" + el.id + ")"}); + o.clip = rc; + } + if (!value) { + var clip = doc.getElementById(node.getAttribute("clip-path")[rp](/(^url\(#|\)$)/g, E)); + clip && clip.parentNode.removeChild(clip); + $(node, {"clip-path": E}); + delete o.clip; + } + break; + case "path": + if (o.type == "path") { + $(node, {d: value ? attrs.path = roundPath(pathToAbsolute(value)) : "M0,0"}); + } + break; + case "width": + node[setAttribute](att, value); + if (attrs.fx) { + att = "x"; + value = attrs.x; + } else { + break; + } + case "x": + if (attrs.fx) { + value = -attrs.x - (attrs.width || 0); + } + case "rx": + if (att == "rx" && o.type == "rect") { + break; + } + case "cx": + rotxy && (att == "x" || att == "cx") && (rotxy[1] += value - attrs[att]); + node[setAttribute](att, round(value)); + o.pattern && updatePosition(o); + break; + case "height": + node[setAttribute](att, value); + if (attrs.fy) { + att = "y"; + value = attrs.y; + } else { + break; + } + case "y": + if (attrs.fy) { + value = -attrs.y - (attrs.height || 0); + } + case "ry": + if (att == "ry" && o.type == "rect") { + break; + } + case "cy": + rotxy && (att == "y" || att == "cy") && (rotxy[2] += value - attrs[att]); + node[setAttribute](att, round(value)); + o.pattern && updatePosition(o); + break; + case "r": + if (o.type == "rect") { + $(node, {rx: value, ry: value}); + } else { + node[setAttribute](att, value); + } + break; + case "src": + if (o.type == "image") { + node.setAttributeNS(o.paper.xlink, "href", value); + } + break; + case "stroke-width": + node.style.strokeWidth = value; + // Need following line for Firefox + node[setAttribute](att, value); + if (attrs["stroke-dasharray"]) { + addDashes(o, attrs["stroke-dasharray"]); + } + break; + case "stroke-dasharray": + addDashes(o, value); + break; + case "translation": + var xy = (value + E)[split](separator); + xy[0] = +xy[0] || 0; + xy[1] = +xy[1] || 0; + if (rotxy) { + rotxy[1] += xy[0]; + rotxy[2] += xy[1]; + } + translate.call(o, xy[0], xy[1]); + break; + case "scale": + xy = (value + E)[split](separator); + o.scale(+xy[0] || 1, +xy[1] || +xy[0] || 1, isNaN(toFloat(xy[2])) ? null : +xy[2], isNaN(toFloat(xy[3])) ? null : +xy[3]); + break; + case "fill": + var isURL = (value + E).match(ISURL); + if (isURL) { + el = $("pattern"); + var ig = $("image"); + el.id = "r" + (R._id++)[toString](36); + $(el, {x: 0, y: 0, patternUnits: "userSpaceOnUse", height: 1, width: 1}); + $(ig, {x: 0, y: 0}); + ig.setAttributeNS(o.paper.xlink, "href", isURL[1]); + el[appendChild](ig); + + var img = doc.createElement("img"); + img.style.cssText = "position:absolute;left:-9999em;top-9999em"; + img.onload = function () { + $(el, {width: this.offsetWidth, height: this.offsetHeight}); + $(ig, {width: this.offsetWidth, height: this.offsetHeight}); + doc.body.removeChild(this); + o.paper.safari(); + }; + doc.body[appendChild](img); + img.src = isURL[1]; + o.paper.defs[appendChild](el); + node.style.fill = "url(#" + el.id + ")"; + $(node, {fill: "url(#" + el.id + ")"}); + o.pattern = el; + o.pattern && updatePosition(o); + break; + } + if (!R.getRGB(value).error) { + delete params.gradient; + delete attrs.gradient; + !R.is(attrs.opacity, "undefined") && + R.is(params.opacity, "undefined") && + $(node, {opacity: attrs.opacity}); + !R.is(attrs["fill-opacity"], "undefined") && + R.is(params["fill-opacity"], "undefined") && + $(node, {"fill-opacity": attrs["fill-opacity"]}); + } else if ((({circle: 1, ellipse: 1})[has](o.type) || (value + E).charAt() != "r") && addGradientFill(node, value, o.paper)) { + attrs.gradient = value; + attrs.fill = "none"; + break; + } + case "stroke": + node[setAttribute](att, R.getRGB(value).hex); + break; + case "gradient": + (({circle: 1, ellipse: 1})[has](o.type) || (value + E).charAt() != "r") && addGradientFill(node, value, o.paper); + break; + case "opacity": + case "fill-opacity": + if (attrs.gradient) { + var gradient = doc.getElementById(node.getAttribute("fill")[rp](/^url\(#|\)$/g, E)); + if (gradient) { + var stops = gradient.getElementsByTagName("stop"); + stops[stops[length] - 1][setAttribute]("stop-opacity", value); + } + break; + } + default: + att == "font-size" && (value = toInt(value, 10) + "px"); + var cssrule = att[rp](/(\-.)/g, function (w) { + return upperCase.call(w.substring(1)); + }); + node.style[cssrule] = value; + // Need following line for Firefox + node[setAttribute](att, value); + break; + } + } + } + + tuneText(o, params); + if (rotxy) { + o.rotate(rotxy.join(S)); + } else { + toFloat(rot) && o.rotate(rot, true); + } + }; + var leading = 1.2, + tuneText = function (el, params) { + if (el.type != "text" || !(params[has]("text") || params[has]("font") || params[has]("font-size") || params[has]("x") || params[has]("y"))) { + return; + } + var a = el.attrs, + node = el.node, + fontSize = node.firstChild ? toInt(doc.defaultView.getComputedStyle(node.firstChild, E).getPropertyValue("font-size"), 10) : 10; + + if (params[has]("text")) { + a.text = params.text; + while (node.firstChild) { + node.removeChild(node.firstChild); + } + var texts = (params.text + E)[split]("\n"); + for (var i = 0, ii = texts[length]; i < ii; i++) if (texts[i]) { + var tspan = $("tspan"); + i && $(tspan, {dy: fontSize * leading, x: a.x}); + tspan[appendChild](doc.createTextNode(texts[i])); + node[appendChild](tspan); + } + } else { + texts = node.getElementsByTagName("tspan"); + for (i = 0, ii = texts[length]; i < ii; i++) { + i && $(texts[i], {dy: fontSize * leading, x: a.x}); + } + } + $(node, {y: a.y}); + var bb = el.getBBox(), + dif = a.y - (bb.y + bb.height / 2); + dif && isFinite(dif) && $(node, {y: a.y + dif}); + }, + Element = function (node, svg) { + var X = 0, + Y = 0; + this[0] = node; + this.id = R._oid++; + this.node = node; + node.raphael = this; + this.paper = svg; + this.attrs = this.attrs || {}; + this.transformations = []; // rotate, translate, scale + this._ = { + tx: 0, + ty: 0, + rt: {deg: 0, cx: 0, cy: 0}, + sx: 1, + sy: 1 + }; + !svg.bottom && (svg.bottom = this); + this.prev = svg.top; + svg.top && (svg.top.next = this); + svg.top = this; + this.next = null; + }; + Element[proto].rotate = function (deg, cx, cy) { + if (this.removed) { + return this; + } + if (deg == null) { + if (this._.rt.cx) { + return [this._.rt.deg, this._.rt.cx, this._.rt.cy][join](S); + } + return this._.rt.deg; + } + var bbox = this.getBBox(); + deg = (deg + E)[split](separator); + if (deg[length] - 1) { + cx = toFloat(deg[1]); + cy = toFloat(deg[2]); + } + deg = toFloat(deg[0]); + if (cx != null) { + this._.rt.deg = deg; + } else { + this._.rt.deg += deg; + } + (cy == null) && (cx = null); + this._.rt.cx = cx; + this._.rt.cy = cy; + cx = cx == null ? bbox.x + bbox.width / 2 : cx; + cy = cy == null ? bbox.y + bbox.height / 2 : cy; + if (this._.rt.deg) { + this.transformations[0] = R.format("rotate({0} {1} {2})", this._.rt.deg, cx, cy); + this.clip && $(this.clip, {transform: R.format("rotate({0} {1} {2})", -this._.rt.deg, cx, cy)}); + } else { + this.transformations[0] = E; + this.clip && $(this.clip, {transform: E}); + } + $(this.node, {transform: this.transformations[join](S)}); + return this; + }; + Element[proto].hide = function () { + !this.removed && (this.node.style.display = "none"); + return this; + }; + Element[proto].show = function () { + !this.removed && (this.node.style.display = ""); + return this; + }; + Element[proto].remove = function () { + if (this.removed) { + return; + } + tear(this, this.paper); + this.node.parentNode.removeChild(this.node); + for (var i in this) { + delete this[i]; + } + this.removed = true; + }; + Element[proto].getBBox = function () { + if (this.removed) { + return this; + } + if (this.type == "path") { + return pathDimensions(this.attrs.path); + } + if (this.node.style.display == "none") { + this.show(); + var hide = true; + } + var bbox = {}; + try { + bbox = this.node.getBBox(); + } catch(e) { + // Firefox 3.0.x plays badly here + } finally { + bbox = bbox || {}; + } + if (this.type == "text") { + bbox = {x: bbox.x, y: Infinity, width: 0, height: 0}; + for (var i = 0, ii = this.node.getNumberOfChars(); i < ii; i++) { + var bb = this.node.getExtentOfChar(i); + (bb.y < bbox.y) && (bbox.y = bb.y); + (bb.y + bb.height - bbox.y > bbox.height) && (bbox.height = bb.y + bb.height - bbox.y); + (bb.x + bb.width - bbox.x > bbox.width) && (bbox.width = bb.x + bb.width - bbox.x); + } + } + hide && this.hide(); + return bbox; + }; + Element[proto].attr = function (name, value) { + if (this.removed) { + return this; + } + if (name == null) { + var res = {}; + for (var i in this.attrs) if (this.attrs[has](i)) { + res[i] = this.attrs[i]; + } + this._.rt.deg && (res.rotation = this.rotate()); + (this._.sx != 1 || this._.sy != 1) && (res.scale = this.scale()); + res.gradient && res.fill == "none" && (res.fill = res.gradient) && delete res.gradient; + return res; + } + if (value == null && R.is(name, "string")) { + if (name == "translation") { + return translate.call(this); + } + if (name == "rotation") { + return this.rotate(); + } + if (name == "scale") { + return this.scale(); + } + if (name == "fill" && this.attrs.fill == "none" && this.attrs.gradient) { + return this.attrs.gradient; + } + return this.attrs[name]; + } + if (value == null && R.is(name, "array")) { + var values = {}; + for (var j = 0, jj = name.length; j < jj; j++) { + values[name[j]] = this.attr(name[j]); + } + return values; + } + if (value != null) { + var params = {}; + params[name] = value; + setFillAndStroke(this, params); + } else if (name != null && R.is(name, "object")) { + setFillAndStroke(this, name); + } + return this; + }; + Element[proto].toFront = function () { + if (this.removed) { + return this; + } + this.node.parentNode[appendChild](this.node); + var svg = this.paper; + svg.top != this && tofront(this, svg); + return this; + }; + Element[proto].toBack = function () { + if (this.removed) { + return this; + } + if (this.node.parentNode.firstChild != this.node) { + this.node.parentNode.insertBefore(this.node, this.node.parentNode.firstChild); + toback(this, this.paper); + var svg = this.paper; + } + return this; + }; + Element[proto].insertAfter = function (element) { + if (this.removed) { + return this; + } + var node = element.node; + if (node.nextSibling) { + node.parentNode.insertBefore(this.node, node.nextSibling); + } else { + node.parentNode[appendChild](this.node); + } + insertafter(this, element, this.paper); + return this; + }; + Element[proto].insertBefore = function (element) { + if (this.removed) { + return this; + } + var node = element.node; + node.parentNode.insertBefore(this.node, node); + insertbefore(this, element, this.paper); + return this; + }; + Element[proto].blur = function (size) { + // Experimental. No Safari support. Use it on your own risk. + var t = this; + if (+size !== 0) { + var fltr = $("filter"), + blur = $("feGaussianBlur"); + t.attrs.blur = size; + fltr.id = "r" + (R._id++)[toString](36); + $(blur, {stdDeviation: +size || 1.5}); + fltr.appendChild(blur); + t.paper.defs.appendChild(fltr); + t._blur = fltr; + $(t.node, {filter: "url(#" + fltr.id + ")"}); + } else { + if (t._blur) { + t._blur.parentNode.removeChild(t._blur); + delete t._blur; + delete t.attrs.blur; + } + t.node.removeAttribute("filter"); + } + }; + var theCircle = function (svg, x, y, r) { + x = round(x); + y = round(y); + var el = $("circle"); + svg.canvas && svg.canvas[appendChild](el); + var res = new Element(el, svg); + res.attrs = {cx: x, cy: y, r: r, fill: "none", stroke: "#000"}; + res.type = "circle"; + $(el, res.attrs); + return res; + }; + var theRect = function (svg, x, y, w, h, r) { + x = round(x); + y = round(y); + var el = $("rect"); + svg.canvas && svg.canvas[appendChild](el); + var res = new Element(el, svg); + res.attrs = {x: x, y: y, width: w, height: h, r: r || 0, rx: r || 0, ry: r || 0, fill: "none", stroke: "#000"}; + res.type = "rect"; + $(el, res.attrs); + return res; + }; + var theEllipse = function (svg, x, y, rx, ry) { + x = round(x); + y = round(y); + var el = $("ellipse"); + svg.canvas && svg.canvas[appendChild](el); + var res = new Element(el, svg); + res.attrs = {cx: x, cy: y, rx: rx, ry: ry, fill: "none", stroke: "#000"}; + res.type = "ellipse"; + $(el, res.attrs); + return res; + }; + var theImage = function (svg, src, x, y, w, h) { + var el = $("image"); + $(el, {x: x, y: y, width: w, height: h, preserveAspectRatio: "none"}); + el.setAttributeNS(svg.xlink, "href", src); + svg.canvas && svg.canvas[appendChild](el); + var res = new Element(el, svg); + res.attrs = {x: x, y: y, width: w, height: h, src: src}; + res.type = "image"; + return res; + }; + var theText = function (svg, x, y, text) { + var el = $("text"); + $(el, {x: x, y: y, "text-anchor": "middle"}); + svg.canvas && svg.canvas[appendChild](el); + var res = new Element(el, svg); + res.attrs = {x: x, y: y, "text-anchor": "middle", text: text, font: availableAttrs.font, stroke: "none", fill: "#000"}; + res.type = "text"; + setFillAndStroke(res, res.attrs); + return res; + }; + var setSize = function (width, height) { + this.width = width || this.width; + this.height = height || this.height; + this.canvas[setAttribute]("width", this.width); + this.canvas[setAttribute]("height", this.height); + return this; + }; + var create = function () { + var con = getContainer[apply](0, arguments), + container = con && con.container, + x = con.x, + y = con.y, + width = con.width, + height = con.height; + if (!container) { + throw new Error("SVG container not found."); + } + var cnvs = $("svg"); + width = width || 512; + height = height || 342; + $(cnvs, { + xmlns: "http://www.w3.org/2000/svg", + version: 1.1, + width: width, + height: height + }); + if (container == 1) { + cnvs.style.cssText = "position:absolute;left:" + x + "px;top:" + y + "px"; + doc.body[appendChild](cnvs); + } else { + if (container.firstChild) { + container.insertBefore(cnvs, container.firstChild); + } else { + container[appendChild](cnvs); + } + } + container = new Paper; + container.width = width; + container.height = height; + container.canvas = cnvs; + plugins.call(container, container, R.fn); + container.clear(); + return container; + }; + Paper[proto].clear = function () { + var c = this.canvas; + while (c.firstChild) { + c.removeChild(c.firstChild); + } + this.bottom = this.top = null; + (this.desc = $("desc"))[appendChild](doc.createTextNode("Created with Rapha\xebl")); + c[appendChild](this.desc); + c[appendChild](this.defs = $("defs")); + }; + Paper[proto].remove = function () { + this.canvas.parentNode && this.canvas.parentNode.removeChild(this.canvas); + for (var i in this) { + this[i] = removed(i); + } + }; + } + + // VML + if (R.vml) { + var map = {M: "m", L: "l", C: "c", Z: "x", m: "t", l: "r", c: "v", z: "x"}, + bites = /([clmz]),?([^clmz]*)/gi, + val = /-?[^,\s-]+/g, + coordsize = 1e3 + S + 1e3, + zoom = 10, + path2vml = function (path) { + var total = /[ahqstv]/ig, + command = pathToAbsolute; + (path + E).match(total) && (command = path2curve); + total = /[clmz]/g; + if (command == pathToAbsolute && !(path + E).match(total)) { + var res = (path + E)[rp](bites, function (all, command, args) { + var vals = [], + isMove = lowerCase.call(command) == "m", + res = map[command]; + args[rp](val, function (value) { + if (isMove && vals[length] == 2) { + res += vals + map[command == "m" ? "l" : "L"]; + vals = []; + } + vals[push](round(value * zoom)); + }); + return res + vals; + }); + return res; + } + var pa = command(path), p, r; + res = []; + for (var i = 0, ii = pa[length]; i < ii; i++) { + p = pa[i]; + r = lowerCase.call(pa[i][0]); + r == "z" && (r = "x"); + for (var j = 1, jj = p[length]; j < jj; j++) { + r += round(p[j] * zoom) + (j != jj - 1 ? "," : E); + } + res[push](r); + } + return res[join](S); + }; + + R[toString] = function () { + return "Your browser doesn\u2019t support SVG. Falling down to VML.\nYou are running Rapha\xebl " + this.version; + }; + thePath = function (pathString, vml) { + var g = createNode("group"); + g.style.cssText = "position:absolute;left:0;top:0;width:" + vml.width + "px;height:" + vml.height + "px"; + g.coordsize = vml.coordsize; + g.coordorigin = vml.coordorigin; + var el = createNode("shape"), ol = el.style; + ol.width = vml.width + "px"; + ol.height = vml.height + "px"; + el.coordsize = coordsize; + el.coordorigin = vml.coordorigin; + g[appendChild](el); + var p = new Element(el, g, vml), + attr = {fill: "none", stroke: "#000"}; + pathString && (attr.path = pathString); + p.isAbsolute = true; + p.type = "path"; + p.path = []; + p.Path = E; + setFillAndStroke(p, attr); + vml.canvas[appendChild](g); + return p; + }; + setFillAndStroke = function (o, params) { + o.attrs = o.attrs || {}; + var node = o.node, + a = o.attrs, + s = node.style, + xy, + res = o; + for (var par in params) if (params[has](par)) { + a[par] = params[par]; + } + params.href && (node.href = params.href); + params.title && (node.title = params.title); + params.target && (node.target = params.target); + params.cursor && (s.cursor = params.cursor); + "blur" in params && o.blur(params.blur); + if (params.path && o.type == "path") { + a.path = params.path; + node.path = path2vml(a.path); + } + if (params.rotation != null) { + o.rotate(params.rotation, true); + } + if (params.translation) { + xy = (params.translation + E)[split](separator); + translate.call(o, xy[0], xy[1]); + if (o._.rt.cx != null) { + o._.rt.cx +=+ xy[0]; + o._.rt.cy +=+ xy[1]; + o.setBox(o.attrs, xy[0], xy[1]); + } + } + if (params.scale) { + xy = (params.scale + E)[split](separator); + o.scale(+xy[0] || 1, +xy[1] || +xy[0] || 1, +xy[2] || null, +xy[3] || null); + } + if ("clip-rect" in params) { + var rect = (params["clip-rect"] + E)[split](separator); + if (rect[length] == 4) { + rect[2] = +rect[2] + (+rect[0]); + rect[3] = +rect[3] + (+rect[1]); + var div = node.clipRect || doc.createElement("div"), + dstyle = div.style, + group = node.parentNode; + dstyle.clip = R.format("rect({1}px {2}px {3}px {0}px)", rect); + if (!node.clipRect) { + dstyle.position = "absolute"; + dstyle.top = 0; + dstyle.left = 0; + dstyle.width = o.paper.width + "px"; + dstyle.height = o.paper.height + "px"; + group.parentNode.insertBefore(div, group); + div[appendChild](group); + node.clipRect = div; + } + } + if (!params["clip-rect"]) { + node.clipRect && (node.clipRect.style.clip = E); + } + } + if (o.type == "image" && params.src) { + node.src = params.src; + } + if (o.type == "image" && params.opacity) { + node.filterOpacity = " progid:DXImageTransform.Microsoft.Alpha(opacity=" + (params.opacity * 100) + ")"; + s.filter = (node.filterMatrix || E) + (node.filterOpacity || E); + } + params.font && (s.font = params.font); + params["font-family"] && (s.fontFamily = '"' + params["font-family"][split](",")[0][rp](/^['"]+|['"]+$/g, E) + '"'); //' + params["font-size"] && (s.fontSize = params["font-size"]); + params["font-weight"] && (s.fontWeight = params["font-weight"]); + params["font-style"] && (s.fontStyle = params["font-style"]); + if (params.opacity != null || + params["stroke-width"] != null || + params.fill != null || + params.stroke != null || + params["stroke-width"] != null || + params["stroke-opacity"] != null || + params["fill-opacity"] != null || + params["stroke-dasharray"] != null || + params["stroke-miterlimit"] != null || + params["stroke-linejoin"] != null || + params["stroke-linecap"] != null) { + node = o.shape || node; + var fill = (node.getElementsByTagName("fill") && node.getElementsByTagName("fill")[0]), + newfill = false; + !fill && (newfill = fill = createNode("fill")); + if ("fill-opacity" in params || "opacity" in params) { + var opacity = ((+a["fill-opacity"] + 1 || 2) - 1) * ((+a.opacity + 1 || 2) - 1); + opacity < 0 && (opacity = 0); + opacity > 1 && (opacity = 1); + fill.opacity = opacity; + } + params.fill && (fill.on = true); + if (fill.on == null || params.fill == "none") { + fill.on = false; + } + if (fill.on && params.fill) { + var isURL = params.fill.match(ISURL); + if (isURL) { + fill.src = isURL[1]; + fill.type = "tile"; + } else { + fill.color = R.getRGB(params.fill).hex; + fill.src = E; + fill.type = "solid"; + if (R.getRGB(params.fill).error && (res.type in {circle: 1, ellipse: 1} || (params.fill + E).charAt() != "r") && addGradientFill(res, params.fill)) { + a.fill = "none"; + a.gradient = params.fill; + } + } + } + newfill && node[appendChild](fill); + var stroke = (node.getElementsByTagName("stroke") && node.getElementsByTagName("stroke")[0]), + newstroke = false; + !stroke && (newstroke = stroke = createNode("stroke")); + if ((params.stroke && params.stroke != "none") || + params["stroke-width"] || + params["stroke-opacity"] != null || + params["stroke-dasharray"] || + params["stroke-miterlimit"] || + params["stroke-linejoin"] || + params["stroke-linecap"]) { + stroke.on = true; + } + (params.stroke == "none" || stroke.on == null || params.stroke == 0 || params["stroke-width"] == 0) && (stroke.on = false); + stroke.on && params.stroke && (stroke.color = R.getRGB(params.stroke).hex); + opacity = ((+a["stroke-opacity"] + 1 || 2) - 1) * ((+a.opacity + 1 || 2) - 1); + var width = (toFloat(params["stroke-width"]) || 1) * .75; + opacity < 0 && (opacity = 0); + opacity > 1 && (opacity = 1); + params["stroke-width"] == null && (width = a["stroke-width"]); + params["stroke-width"] && (stroke.weight = width); + width && width < 1 && (opacity *= width) && (stroke.weight = 1); + stroke.opacity = opacity; + + params["stroke-linejoin"] && (stroke.joinstyle = params["stroke-linejoin"] || "miter"); + stroke.miterlimit = params["stroke-miterlimit"] || 8; + params["stroke-linecap"] && (stroke.endcap = params["stroke-linecap"] == "butt" ? "flat" : params["stroke-linecap"] == "square" ? "square" : "round"); + if (params["stroke-dasharray"]) { + var dasharray = { + "-": "shortdash", + ".": "shortdot", + "-.": "shortdashdot", + "-..": "shortdashdotdot", + ". ": "dot", + "- ": "dash", + "--": "longdash", + "- .": "dashdot", + "--.": "longdashdot", + "--..": "longdashdotdot" + }; + stroke.dashstyle = dasharray[has](params["stroke-dasharray"]) ? dasharray[params["stroke-dasharray"]] : E; + } + newstroke && node[appendChild](stroke); + } + if (res.type == "text") { + s = res.paper.span.style; + a.font && (s.font = a.font); + a["font-family"] && (s.fontFamily = a["font-family"]); + a["font-size"] && (s.fontSize = a["font-size"]); + a["font-weight"] && (s.fontWeight = a["font-weight"]); + a["font-style"] && (s.fontStyle = a["font-style"]); + res.node.string && (res.paper.span.innerHTML = (res.node.string + E)[rp](/")); + res.W = a.w = res.paper.span.offsetWidth; + res.H = a.h = res.paper.span.offsetHeight; + res.X = a.x; + res.Y = a.y + round(res.H / 2); + + // text-anchor emulationm + switch (a["text-anchor"]) { + case "start": + res.node.style["v-text-align"] = "left"; + res.bbx = round(res.W / 2); + break; + case "end": + res.node.style["v-text-align"] = "right"; + res.bbx = -round(res.W / 2); + break; + default: + res.node.style["v-text-align"] = "center"; + break; + } + } + }; + addGradientFill = function (o, gradient) { + o.attrs = o.attrs || {}; + var attrs = o.attrs, + fill = o.node.getElementsByTagName("fill"), + type = "linear", + fxfy = ".5 .5"; + o.attrs.gradient = gradient; + gradient = (gradient + E)[rp](radial_gradient, function (all, fx, fy) { + type = "radial"; + if (fx && fy) { + fx = toFloat(fx); + fy = toFloat(fy); + pow(fx - .5, 2) + pow(fy - .5, 2) > .25 && (fy = math.sqrt(.25 - pow(fx - .5, 2)) * ((fy > .5) * 2 - 1) + .5); + fxfy = fx + S + fy; + } + return E; + }); + gradient = gradient[split](/\s*\-\s*/); + if (type == "linear") { + var angle = gradient.shift(); + angle = -toFloat(angle); + if (isNaN(angle)) { + return null; + } + } + var dots = parseDots(gradient); + if (!dots) { + return null; + } + o = o.shape || o.node; + fill = fill[0] || createNode("fill"); + if (dots[length]) { + fill.on = true; + fill.method = "none"; + fill.type = (type == "radial") ? "gradientradial" : "gradient"; + fill.color = dots[0].color; + fill.color2 = dots[dots[length] - 1].color; + var clrs = []; + for (var i = 0, ii = dots[length]; i < ii; i++) { + dots[i].offset && clrs[push](dots[i].offset + S + dots[i].color); + } + fill.colors && (fill.colors.value = clrs[length] ? clrs[join](",") : "0% " + fill.color); + if (type == "radial") { + fill.focus = "100%"; + fill.focussize = fxfy; + fill.focusposition = fxfy; + } else { + fill.angle = (270 - angle) % 360; + } + } + return 1; + }; + Element = function (node, group, vml) { + var Rotation = 0, + RotX = 0, + RotY = 0, + Scale = 1; + this[0] = node; + this.id = R._oid++; + this.node = node; + node.raphael = this; + this.X = 0; + this.Y = 0; + this.attrs = {}; + this.Group = group; + this.paper = vml; + this._ = { + tx: 0, + ty: 0, + rt: {deg:0}, + sx: 1, + sy: 1 + }; + !vml.bottom && (vml.bottom = this); + this.prev = vml.top; + vml.top && (vml.top.next = this); + vml.top = this; + this.next = null; + }; + Element[proto].rotate = function (deg, cx, cy) { + if (this.removed) { + return this; + } + if (deg == null) { + if (this._.rt.cx) { + return [this._.rt.deg, this._.rt.cx, this._.rt.cy][join](S); + } + return this._.rt.deg; + } + deg = (deg + E)[split](separator); + if (deg[length] - 1) { + cx = toFloat(deg[1]); + cy = toFloat(deg[2]); + } + deg = toFloat(deg[0]); + if (cx != null) { + this._.rt.deg = deg; + } else { + this._.rt.deg += deg; + } + cy == null && (cx = null); + this._.rt.cx = cx; + this._.rt.cy = cy; + this.setBox(this.attrs, cx, cy); + this.Group.style.rotation = this._.rt.deg; + // gradient fix for rotation. TODO + // var fill = (this.shape || this.node).getElementsByTagName("fill"); + // fill = fill[0] || {}; + // var b = ((360 - this._.rt.deg) - 270) % 360; + // !R.is(fill.angle, "undefined") && (fill.angle = b); + return this; + }; + Element[proto].setBox = function (params, cx, cy) { + if (this.removed) { + return this; + } + var gs = this.Group.style, + os = (this.shape && this.shape.style) || this.node.style; + params = params || {}; + for (var i in params) if (params[has](i)) { + this.attrs[i] = params[i]; + } + cx = cx || this._.rt.cx; + cy = cy || this._.rt.cy; + var attr = this.attrs, + x, + y, + w, + h; + switch (this.type) { + case "circle": + x = attr.cx - attr.r; + y = attr.cy - attr.r; + w = h = attr.r * 2; + break; + case "ellipse": + x = attr.cx - attr.rx; + y = attr.cy - attr.ry; + w = attr.rx * 2; + h = attr.ry * 2; + break; + case "rect": + case "image": + x = +attr.x; + y = +attr.y; + w = attr.width || 0; + h = attr.height || 0; + break; + case "text": + this.textpath.v = ["m", round(attr.x), ", ", round(attr.y - 2), "l", round(attr.x) + 1, ", ", round(attr.y - 2)][join](E); + x = attr.x - round(this.W / 2); + y = attr.y - this.H / 2; + w = this.W; + h = this.H; + break; + case "path": + if (!this.attrs.path) { + x = 0; + y = 0; + w = this.paper.width; + h = this.paper.height; + } else { + var dim = pathDimensions(this.attrs.path); + x = dim.x; + y = dim.y; + w = dim.width; + h = dim.height; + } + break; + default: + x = 0; + y = 0; + w = this.paper.width; + h = this.paper.height; + break; + } + cx = (cx == null) ? x + w / 2 : cx; + cy = (cy == null) ? y + h / 2 : cy; + var left = cx - this.paper.width / 2, + top = cy - this.paper.height / 2, t; + gs.left != (t = left + "px") && (gs.left = t); + gs.top != (t = top + "px") && (gs.top = t); + this.X = this.type == "path" ? -left : x; + this.Y = this.type == "path" ? -top : y; + this.W = w; + this.H = h; + if (this.type == "path") { + os.left != (t = -left * zoom + "px") && (os.left = t); + os.top != (t = -top * zoom + "px") && (os.top = t); + } else if (this.type == "text") { + os.left != (t = -left + "px") && (os.left = t); + os.top != (t = -top + "px") && (os.top = t); + } else { + gs.width != (t = this.paper.width + "px") && (gs.width = t); + gs.height != (t = this.paper.height + "px") && (gs.height = t); + os.left != (t = x - left + "px") && (os.left = t); + os.top != (t = y - top + "px") && (os.top = t); + os.width != (t = w + "px") && (os.width = t); + os.height != (t = h + "px") && (os.height = t); + var arcsize = (+params.r || 0) / mmin(w, h); + if (this.type == "rect" && this.arcsize.toFixed(4) != arcsize.toFixed(4) && (arcsize || this.arcsize)) { + // We should replace element with the new one + var o = createNode("roundrect"), + a = {}, + ii = this.events && this.events[length]; + i = 0; + o.arcsize = arcsize; + o.raphael = this; + this.Group[appendChild](o); + this.Group.removeChild(this.node); + this[0] = this.node = o; + this.arcsize = arcsize; + for (i in attr) { + a[i] = attr[i]; + } + delete a.scale; + this.attr(a); + if (this.events) for (; i < ii; i++) { + this.events[i].unbind = addEvent(this.node, this.events[i].name, this.events[i].f, this); + } + } + } + }; + Element[proto].hide = function () { + !this.removed && (this.Group.style.display = "none"); + return this; + }; + Element[proto].show = function () { + !this.removed && (this.Group.style.display = "block"); + return this; + }; + Element[proto].getBBox = function () { + if (this.removed) { + return this; + } + if (this.type == "path") { + return pathDimensions(this.attrs.path); + } + return { + x: this.X + (this.bbx || 0), + y: this.Y, + width: this.W, + height: this.H + }; + }; + Element[proto].remove = function () { + if (this.removed) { + return; + } + tear(this, this.paper); + this.node.parentNode.removeChild(this.node); + this.Group.parentNode.removeChild(this.Group); + this.shape && this.shape.parentNode.removeChild(this.shape); + for (var i in this) { + delete this[i]; + } + this.removed = true; + }; + Element[proto].attr = function (name, value) { + if (this.removed) { + return this; + } + if (name == null) { + var res = {}; + for (var i in this.attrs) if (this.attrs[has](i)) { + res[i] = this.attrs[i]; + } + this._.rt.deg && (res.rotation = this.rotate()); + (this._.sx != 1 || this._.sy != 1) && (res.scale = this.scale()); + res.gradient && res.fill == "none" && (res.fill = res.gradient) && delete res.gradient; + return res; + } + if (value == null && R.is(name, "string")) { + if (name == "translation") { + return translate.call(this); + } + if (name == "rotation") { + return this.rotate(); + } + if (name == "scale") { + return this.scale(); + } + if (name == "fill" && this.attrs.fill == "none" && this.attrs.gradient) { + return this.attrs.gradient; + } + return this.attrs[name]; + } + if (this.attrs && value == null && R.is(name, "array")) { + var ii, values = {}; + for (i = 0, ii = name[length]; i < ii; i++) { + values[name[i]] = this.attr(name[i]); + } + return values; + } + var params; + if (value != null) { + params = {}; + params[name] = value; + } + value == null && R.is(name, "object") && (params = name); + if (params) { + if (params.text && this.type == "text") { + this.node.string = params.text; + } + setFillAndStroke(this, params); + if (params.gradient && (({circle: 1, ellipse: 1})[has](this.type) || (params.gradient + E).charAt() != "r")) { + addGradientFill(this, params.gradient); + } + (this.type != "path" || this._.rt.deg) && this.setBox(this.attrs); + } + return this; + }; + Element[proto].toFront = function () { + !this.removed && this.Group.parentNode[appendChild](this.Group); + this.paper.top != this && tofront(this, this.paper); + return this; + }; + Element[proto].toBack = function () { + if (this.removed) { + return this; + } + if (this.Group.parentNode.firstChild != this.Group) { + this.Group.parentNode.insertBefore(this.Group, this.Group.parentNode.firstChild); + toback(this, this.paper); + } + return this; + }; + Element[proto].insertAfter = function (element) { + if (this.removed) { + return this; + } + if (element.Group.nextSibling) { + element.Group.parentNode.insertBefore(this.Group, element.Group.nextSibling); + } else { + element.Group.parentNode[appendChild](this.Group); + } + insertafter(this, element, this.paper); + return this; + }; + Element[proto].insertBefore = function (element) { + if (this.removed) { + return this; + } + element.Group.parentNode.insertBefore(this.Group, element.Group); + insertbefore(this, element, this.paper); + return this; + }; + var blurregexp = / progid:\S+Blur\([^\)]+\)/g; + Element[proto].blur = function (size) { + var s = this.node.style, + f = s.filter; + f = f.replace(blurregexp, ""); + if (+size !== 0) { + this.attrs.blur = size; + s.filter = f + " progid:DXImageTransform.Microsoft.Blur(pixelradius=" + (+size || 1.5) + ")"; + s.margin = Raphael.format("-{0}px 0 0 -{0}px", Math.round(+size || 1.5)); + } else { + s.filter = f; + s.margin = 0; + delete this.attrs.blur; + } + }; + + theCircle = function (vml, x, y, r) { + var g = createNode("group"), + o = createNode("oval"), + ol = o.style; + g.style.cssText = "position:absolute;left:0;top:0;width:" + vml.width + "px;height:" + vml.height + "px"; + g.coordsize = coordsize; + g.coordorigin = vml.coordorigin; + g[appendChild](o); + var res = new Element(o, g, vml); + res.type = "circle"; + setFillAndStroke(res, {stroke: "#000", fill: "none"}); + res.attrs.cx = x; + res.attrs.cy = y; + res.attrs.r = r; + res.setBox({x: x - r, y: y - r, width: r * 2, height: r * 2}); + vml.canvas[appendChild](g); + return res; + }; + theRect = function (vml, x, y, w, h, r) { + var g = createNode("group"), + o = createNode("roundrect"), + arcsize = (+r || 0) / (mmin(w, h)); + g.style.cssText = "position:absolute;left:0;top:0;width:" + vml.width + "px;height:" + vml.height + "px"; + g.coordsize = coordsize; + g.coordorigin = vml.coordorigin; + g[appendChild](o); + o.arcsize = arcsize; + var res = new Element(o, g, vml); + res.type = "rect"; + setFillAndStroke(res, {stroke: "#000"}); + res.arcsize = arcsize; + res.setBox({x: x, y: y, width: w, height: h, r: r}); + vml.canvas[appendChild](g); + return res; + }; + theEllipse = function (vml, x, y, rx, ry) { + var g = createNode("group"), + o = createNode("oval"), + ol = o.style; + g.style.cssText = "position:absolute;left:0;top:0;width:" + vml.width + "px;height:" + vml.height + "px"; + g.coordsize = coordsize; + g.coordorigin = vml.coordorigin; + g[appendChild](o); + var res = new Element(o, g, vml); + res.type = "ellipse"; + setFillAndStroke(res, {stroke: "#000"}); + res.attrs.cx = x; + res.attrs.cy = y; + res.attrs.rx = rx; + res.attrs.ry = ry; + res.setBox({x: x - rx, y: y - ry, width: rx * 2, height: ry * 2}); + vml.canvas[appendChild](g); + return res; + }; + theImage = function (vml, src, x, y, w, h) { + var g = createNode("group"), + o = createNode("image"), + ol = o.style; + g.style.cssText = "position:absolute;left:0;top:0;width:" + vml.width + "px;height:" + vml.height + "px"; + g.coordsize = coordsize; + g.coordorigin = vml.coordorigin; + o.src = src; + g[appendChild](o); + var res = new Element(o, g, vml); + res.type = "image"; + res.attrs.src = src; + res.attrs.x = x; + res.attrs.y = y; + res.attrs.w = w; + res.attrs.h = h; + res.setBox({x: x, y: y, width: w, height: h}); + vml.canvas[appendChild](g); + return res; + }; + theText = function (vml, x, y, text) { + var g = createNode("group"), + el = createNode("shape"), + ol = el.style, + path = createNode("path"), + ps = path.style, + o = createNode("textpath"); + g.style.cssText = "position:absolute;left:0;top:0;width:" + vml.width + "px;height:" + vml.height + "px"; + g.coordsize = coordsize; + g.coordorigin = vml.coordorigin; + path.v = R.format("m{0},{1}l{2},{1}", round(x * 10), round(y * 10), round(x * 10) + 1); + path.textpathok = true; + ol.width = vml.width; + ol.height = vml.height; + o.string = text + E; + o.on = true; + el[appendChild](o); + el[appendChild](path); + g[appendChild](el); + var res = new Element(o, g, vml); + res.shape = el; + res.textpath = path; + res.type = "text"; + res.attrs.text = text; + res.attrs.x = x; + res.attrs.y = y; + res.attrs.w = 1; + res.attrs.h = 1; + setFillAndStroke(res, {font: availableAttrs.font, stroke: "none", fill: "#000"}); + res.setBox(); + vml.canvas[appendChild](g); + return res; + }; + setSize = function (width, height) { + var cs = this.canvas.style; + width == +width && (width += "px"); + height == +height && (height += "px"); + cs.width = width; + cs.height = height; + cs.clip = "rect(0 " + width + " " + height + " 0)"; + return this; + }; + var createNode; + doc.createStyleSheet().addRule(".rvml", "behavior:url(#default#VML)"); + try { + !doc.namespaces.rvml && doc.namespaces.add("rvml", "urn:schemas-microsoft-com:vml"); + createNode = function (tagName) { + return doc.createElement(''); + }; + } catch (e) { + createNode = function (tagName) { + return doc.createElement('<' + tagName + ' xmlns="urn:schemas-microsoft.com:vml" class="rvml">'); + }; + } + create = function () { + var con = getContainer[apply](0, arguments), + container = con.container, + height = con.height, + s, + width = con.width, + x = con.x, + y = con.y; + if (!container) { + throw new Error("VML container not found."); + } + var res = new Paper, + c = res.canvas = doc.createElement("div"), + cs = c.style; + width = width || 512; + height = height || 342; + width == +width && (width += "px"); + height == +height && (height += "px"); + res.width = 1e3; + res.height = 1e3; + res.coordsize = zoom * 1e3 + S + zoom * 1e3; + res.coordorigin = "0 0"; + res.span = doc.createElement("span"); + res.span.style.cssText = "position:absolute;left:-9999em;top:-9999em;padding:0;margin:0;line-height:1;display:inline;"; + c[appendChild](res.span); + cs.cssText = R.format("width:{0};height:{1};position:absolute;clip:rect(0 {0} {1} 0);overflow:hidden", width, height); + if (container == 1) { + doc.body[appendChild](c); + cs.left = x + "px"; + cs.top = y + "px"; + } else { + container.style.width = width; + container.style.height = height; + if (container.firstChild) { + container.insertBefore(c, container.firstChild); + } else { + container[appendChild](c); + } + } + plugins.call(res, res, R.fn); + return res; + }; + Paper[proto].clear = function () { + this.canvas.innerHTML = E; + this.span = doc.createElement("span"); + this.span.style.cssText = "position:absolute;left:-9999em;top:-9999em;padding:0;margin:0;line-height:1;display:inline;"; + this.canvas[appendChild](this.span); + this.bottom = this.top = null; + }; + Paper[proto].remove = function () { + this.canvas.parentNode.removeChild(this.canvas); + for (var i in this) { + this[i] = removed(i); + } + return true; + }; + } + + // rest + // Safari or Chrome (WebKit) rendering bug workaround method + if ((/^Apple|^Google/).test(win.navigator.vendor) && !(win.navigator.userAgent.indexOf("Version/4.0") + 1)) { + Paper[proto].safari = function () { + var rect = this.rect(-99, -99, this.width + 99, this.height + 99); + win.setTimeout(function () {rect.remove();}); + }; + } else { + Paper[proto].safari = function () {}; + } + + // Events + var addEvent = (function () { + if (doc.addEventListener) { + return function (obj, type, fn, element) { + var f = function (e) { + return fn.call(element, e); + }; + obj.addEventListener(type, f, false); + return function () { + obj.removeEventListener(type, f, false); + return true; + }; + }; + } else if (doc.attachEvent) { + return function (obj, type, fn, element) { + var f = function (e) { + return fn.call(element, e || win.event); + }; + obj.attachEvent("on" + type, f); + var detacher = function () { + obj.detachEvent("on" + type, f); + return true; + }; + return detacher; + }; + } + })(); + for (var i = events[length]; i--;) { + (function (eventName) { + Element[proto][eventName] = function (fn) { + if (R.is(fn, "function")) { + this.events = this.events || []; + this.events.push({name: eventName, f: fn, unbind: addEvent(this.shape || this.node, eventName, fn, this)}); + } + return this; + }; + Element[proto]["un" + eventName] = function (fn) { + var events = this.events, + l = events[length]; + while (l--) if (events[l].name == eventName && events[l].f == fn) { + events[l].unbind(); + events.splice(l, 1); + !events.length && delete this.events; + return this; + } + return this; + }; + })(events[i]); + } + Element[proto].hover = function (f_in, f_out) { + return this.mouseover(f_in).mouseout(f_out); + }; + Element[proto].unhover = function (f_in, f_out) { + return this.unmouseover(f_in).unmouseout(f_out); + }; + Paper[proto].circle = function (x, y, r) { + return theCircle(this, x || 0, y || 0, r || 0); + }; + Paper[proto].rect = function (x, y, w, h, r) { + return theRect(this, x || 0, y || 0, w || 0, h || 0, r || 0); + }; + Paper[proto].ellipse = function (x, y, rx, ry) { + return theEllipse(this, x || 0, y || 0, rx || 0, ry || 0); + }; + Paper[proto].path = function (pathString) { + pathString && !R.is(pathString, "string") && !R.is(pathString[0], "array") && (pathString += E); + return thePath(R.format[apply](R, arguments), this); + }; + Paper[proto].image = function (src, x, y, w, h) { + return theImage(this, src || "about:blank", x || 0, y || 0, w || 0, h || 0); + }; + Paper[proto].text = function (x, y, text) { + return theText(this, x || 0, y || 0, text || E); + }; + Paper[proto].set = function (itemsArray) { + arguments[length] > 1 && (itemsArray = Array[proto].splice.call(arguments, 0, arguments[length])); + return new Set(itemsArray); + }; + Paper[proto].setSize = setSize; + Paper[proto].top = Paper[proto].bottom = null; + Paper[proto].raphael = R; + function x_y() { + return this.x + S + this.y; + } + Element[proto].scale = function (x, y, cx, cy) { + if (x == null && y == null) { + return { + x: this._.sx, + y: this._.sy, + toString: x_y + }; + } + y = y || x; + !+y && (y = x); + var dx, + dy, + dcx, + dcy, + a = this.attrs; + if (x != 0) { + var bb = this.getBBox(), + rcx = bb.x + bb.width / 2, + rcy = bb.y + bb.height / 2, + kx = x / this._.sx, + ky = y / this._.sy; + cx = (+cx || cx == 0) ? cx : rcx; + cy = (+cy || cy == 0) ? cy : rcy; + var dirx = ~~(x / math.abs(x)), + diry = ~~(y / math.abs(y)), + s = this.node.style, + ncx = cx + (rcx - cx) * kx, + ncy = cy + (rcy - cy) * ky; + switch (this.type) { + case "rect": + case "image": + var neww = a.width * dirx * kx, + newh = a.height * diry * ky; + this.attr({ + height: newh, + r: a.r * mmin(dirx * kx, diry * ky), + width: neww, + x: ncx - neww / 2, + y: ncy - newh / 2 + }); + break; + case "circle": + case "ellipse": + this.attr({ + rx: a.rx * dirx * kx, + ry: a.ry * diry * ky, + r: a.r * mmin(dirx * kx, diry * ky), + cx: ncx, + cy: ncy + }); + break; + case "path": + var path = pathToRelative(a.path), + skip = true; + for (var i = 0, ii = path[length]; i < ii; i++) { + var p = path[i], + P0 = upperCase.call(p[0]); + if (P0 == "M" && skip) { + continue; + } else { + skip = false; + } + if (P0 == "A") { + p[path[i][length] - 2] *= kx; + p[path[i][length] - 1] *= ky; + p[1] *= dirx * kx; + p[2] *= diry * ky; + p[5] = +!(dirx + diry ? !+p[5] : +p[5]); + } else if (P0 == "H") { + for (var j = 1, jj = p[length]; j < jj; j++) { + p[j] *= kx; + } + } else if (P0 == "V") { + for (j = 1, jj = p[length]; j < jj; j++) { + p[j] *= ky; + } + } else { + for (j = 1, jj = p[length]; j < jj; j++) { + p[j] *= (j % 2) ? kx : ky; + } + } + } + var dim2 = pathDimensions(path); + dx = ncx - dim2.x - dim2.width / 2; + dy = ncy - dim2.y - dim2.height / 2; + path[0][1] += dx; + path[0][2] += dy; + this.attr({path: path}); + break; + } + if (this.type in {text: 1, image:1} && (dirx != 1 || diry != 1)) { + if (this.transformations) { + this.transformations[2] = "scale("[concat](dirx, ",", diry, ")"); + this.node[setAttribute]("transform", this.transformations[join](S)); + dx = (dirx == -1) ? -a.x - (neww || 0) : a.x; + dy = (diry == -1) ? -a.y - (newh || 0) : a.y; + this.attr({x: dx, y: dy}); + a.fx = dirx - 1; + a.fy = diry - 1; + } else { + this.node.filterMatrix = " progid:DXImageTransform.Microsoft.Matrix(M11="[concat](dirx, + ", M12=0, M21=0, M22=", diry, + ", Dx=0, Dy=0, sizingmethod='auto expand', filtertype='bilinear')"); + s.filter = (this.node.filterMatrix || E) + (this.node.filterOpacity || E); + } + } else { + if (this.transformations) { + this.transformations[2] = E; + this.node[setAttribute]("transform", this.transformations[join](S)); + a.fx = 0; + a.fy = 0; + } else { + this.node.filterMatrix = E; + s.filter = (this.node.filterMatrix || E) + (this.node.filterOpacity || E); + } + } + a.scale = [x, y, cx, cy][join](S); + this._.sx = x; + this._.sy = y; + } + return this; + }; + Element[proto].clone = function () { + var attr = this.attr(); + delete attr.scale; + delete attr.translation; + return this.paper[this.type]().attr(attr); + }; + var getPointAtSegmentLength = cacher(function (p1x, p1y, c1x, c1y, c2x, c2y, p2x, p2y, length) { + var len = 0, + old; + for (var i = 0; i < 1.001; i+=.001) { + var dot = R.findDotsAtSegment(p1x, p1y, c1x, c1y, c2x, c2y, p2x, p2y, i); + i && (len += pow(pow(old.x - dot.x, 2) + pow(old.y - dot.y, 2), .5)); + if (len >= length) { + return dot; + } + old = dot; + } + }), + getLengthFactory = function (istotal, subpath) { + return function (path, length, onlystart) { + path = path2curve(path); + var x, y, p, l, sp = "", subpaths = {}, point, + len = 0; + for (var i = 0, ii = path.length; i < ii; i++) { + p = path[i]; + if (p[0] == "M") { + x = +p[1]; + y = +p[2]; + } else { + l = segmentLength(x, y, p[1], p[2], p[3], p[4], p[5], p[6]); + if (len + l > length) { + if (subpath && !subpaths.start) { + point = getPointAtSegmentLength(x, y, p[1], p[2], p[3], p[4], p[5], p[6], length - len); + sp += ["C", point.start.x, point.start.y, point.m.x, point.m.y, point.x, point.y]; + if (onlystart) {return sp;} + subpaths.start = sp; + sp = ["M", point.x, point.y + "C", point.n.x, point.n.y, point.end.x, point.end.y, p[5], p[6]][join](); + len += l; + x = +p[5]; + y = +p[6]; + continue; + } + if (!istotal && !subpath) { + point = getPointAtSegmentLength(x, y, p[1], p[2], p[3], p[4], p[5], p[6], length - len); + return {x: point.x, y: point.y, alpha: point.alpha}; + } + } + len += l; + x = +p[5]; + y = +p[6]; + } + sp += p; + } + subpaths.end = sp; + point = istotal ? len : subpath ? subpaths : R.findDotsAtSegment(x, y, p[1], p[2], p[3], p[4], p[5], p[6], 1); + point.alpha && (point = {x: point.x, y: point.y, alpha: point.alpha}); + return point; + }; + }, + segmentLength = cacher(function (p1x, p1y, c1x, c1y, c2x, c2y, p2x, p2y) { + var old = {x: 0, y: 0}, + len = 0; + for (var i = 0; i < 1.01; i+=.01) { + var dot = findDotAtSegment(p1x, p1y, c1x, c1y, c2x, c2y, p2x, p2y, i); + i && (len += pow(pow(old.x - dot.x, 2) + pow(old.y - dot.y, 2), .5)); + old = dot; + } + return len; + }); + var getTotalLength = getLengthFactory(1), + getPointAtLength = getLengthFactory(), + getSubpathsAtLength = getLengthFactory(0, 1); + Element[proto].getTotalLength = function () { + if (this.type != "path") {return;} + return getTotalLength(this.attrs.path); + }; + Element[proto].getPointAtLength = function (length) { + if (this.type != "path") {return;} + return getPointAtLength(this.attrs.path, length); + }; + Element[proto].getSubpath = function (from, to) { + if (this.type != "path") {return;} + if (math.abs(this.getTotalLength() - to) < 1e-6) { + return getSubpathsAtLength(this.attrs.path, from).end; + } + var a = getSubpathsAtLength(this.attrs.path, to, 1); + return from ? getSubpathsAtLength(a, from).end : a; + }; + + // animation easing formulas + R.easing_formulas = { + linear: function (n) { + return n; + }, + "<": function (n) { + return pow(n, 3); + }, + ">": function (n) { + return pow(n - 1, 3) + 1; + }, + "<>": function (n) { + n = n * 2; + if (n < 1) { + return pow(n, 3) / 2; + } + n -= 2; + return (pow(n, 3) + 2) / 2; + }, + backIn: function (n) { + var s = 1.70158; + return n * n * ((s + 1) * n - s); + }, + backOut: function (n) { + n = n - 1; + var s = 1.70158; + return n * n * ((s + 1) * n + s) + 1; + }, + elastic: function (n) { + if (n == 0 || n == 1) { + return n; + } + var p = .3, + s = p / 4; + return pow(2, -10 * n) * math.sin((n - s) * (2 * math.PI) / p) + 1; + }, + bounce: function (n) { + var s = 7.5625, + p = 2.75, + l; + if (n < (1 / p)) { + l = s * n * n; + } else { + if (n < (2 / p)) { + n -= (1.5 / p); + l = s * n * n + .75; + } else { + if (n < (2.5 / p)) { + n -= (2.25 / p); + l = s * n * n + .9375; + } else { + n -= (2.625 / p); + l = s * n * n + .984375; + } + } + } + return l; + } + }; + + var animationElements = {length : 0}, + animation = function () { + var Now = +new Date; + for (var l in animationElements) if (l != "length" && animationElements[has](l)) { + var e = animationElements[l]; + if (e.stop || e.el.removed) { + delete animationElements[l]; + animationElements[length]--; + continue; + } + var time = Now - e.start, + ms = e.ms, + easing = e.easing, + from = e.from, + diff = e.diff, + to = e.to, + t = e.t, + prev = e.prev || 0, + that = e.el, + callback = e.callback, + set = {}, + now; + if (time < ms) { + var pos = R.easing_formulas[easing] ? R.easing_formulas[easing](time / ms) : time / ms; + for (var attr in from) if (from[has](attr)) { + switch (availableAnimAttrs[attr]) { + case "along": + now = pos * ms * diff[attr]; + to.back && (now = to.len - now); + var point = getPointAtLength(to[attr], now); + that.translate(diff.sx - diff.x || 0, diff.sy - diff.y || 0); + diff.x = point.x; + diff.y = point.y; + that.translate(point.x - diff.sx, point.y - diff.sy); + to.rot && that.rotate(diff.r + point.alpha, point.x, point.y); + break; + case "number": + now = +from[attr] + pos * ms * diff[attr]; + break; + case "colour": + now = "rgb(" + [ + upto255(round(from[attr].r + pos * ms * diff[attr].r)), + upto255(round(from[attr].g + pos * ms * diff[attr].g)), + upto255(round(from[attr].b + pos * ms * diff[attr].b)) + ][join](",") + ")"; + break; + case "path": + now = []; + for (var i = 0, ii = from[attr][length]; i < ii; i++) { + now[i] = [from[attr][i][0]]; + for (var j = 1, jj = from[attr][i][length]; j < jj; j++) { + now[i][j] = +from[attr][i][j] + pos * ms * diff[attr][i][j]; + } + now[i] = now[i][join](S); + } + now = now[join](S); + break; + case "csv": + switch (attr) { + case "translation": + var x = diff[attr][0] * (time - prev), + y = diff[attr][1] * (time - prev); + t.x += x; + t.y += y; + now = x + S + y; + break; + case "rotation": + now = +from[attr][0] + pos * ms * diff[attr][0]; + from[attr][1] && (now += "," + from[attr][1] + "," + from[attr][2]); + break; + case "scale": + now = [+from[attr][0] + pos * ms * diff[attr][0], +from[attr][1] + pos * ms * diff[attr][1], (2 in to[attr] ? to[attr][2] : E), (3 in to[attr] ? to[attr][3] : E)][join](S); + break; + case "clip-rect": + now = []; + i = 4; + while (i--) { + now[i] = +from[attr][i] + pos * ms * diff[attr][i]; + } + break; + } + break; + } + set[attr] = now; + } + that.attr(set); + that._run && that._run.call(that); + } else { + if (to.along) { + point = getPointAtLength(to.along, to.len * !to.back); + that.translate(diff.sx - (diff.x || 0) + point.x - diff.sx, diff.sy - (diff.y || 0) + point.y - diff.sy); + to.rot && that.rotate(diff.r + point.alpha, point.x, point.y); + } + (t.x || t.y) && that.translate(-t.x, -t.y); + to.scale && (to.scale = to.scale + E); + that.attr(to); + delete animationElements[l]; + animationElements[length]--; + that.in_animation = null; + R.is(callback, "function") && callback.call(that); + } + e.prev = time; + } + R.svg && that && that.paper.safari(); + animationElements[length] && win.setTimeout(animation); + }, + upto255 = function (color) { + return color > 255 ? 255 : (color < 0 ? 0 : color); + }, + translate = function (x, y) { + if (x == null) { + return {x: this._.tx, y: this._.ty, toString: x_y}; + } + this._.tx += +x; + this._.ty += +y; + switch (this.type) { + case "circle": + case "ellipse": + this.attr({cx: +x + this.attrs.cx, cy: +y + this.attrs.cy}); + break; + case "rect": + case "image": + case "text": + this.attr({x: +x + this.attrs.x, y: +y + this.attrs.y}); + break; + case "path": + var path = pathToRelative(this.attrs.path); + path[0][1] += +x; + path[0][2] += +y; + this.attr({path: path}); + break; + } + return this; + }; + Element[proto].animateWith = function (element, params, ms, easing, callback) { + animationElements[element.id] && (params.start = animationElements[element.id].start); + return this.animate(params, ms, easing, callback); + }; + Element[proto].animateAlong = along(); + Element[proto].animateAlongBack = along(1); + function along(isBack) { + return function (path, ms, rotate, callback) { + var params = {back: isBack}; + R.is(rotate, "function") ? (callback = rotate) : (params.rot = rotate); + path && path.constructor == Element && (path = path.attrs.path); + path && (params.along = path); + return this.animate(params, ms, callback); + }; + } + Element[proto].onAnimation = function (f) { + this._run = f || 0; + return this; + }; + Element[proto].animate = function (params, ms, easing, callback) { + if (R.is(easing, "function") || !easing) { + callback = easing || null; + } + var from = {}, + to = {}, + diff = {}; + for (var attr in params) if (params[has](attr)) { + if (availableAnimAttrs[has](attr)) { + from[attr] = this.attr(attr); + (from[attr] == null) && (from[attr] = availableAttrs[attr]); + to[attr] = params[attr]; + switch (availableAnimAttrs[attr]) { + case "along": + var len = getTotalLength(params[attr]), + point = getPointAtLength(params[attr], len * !!params.back), + bb = this.getBBox(); + diff[attr] = len / ms; + diff.tx = bb.x; + diff.ty = bb.y; + diff.sx = point.x; + diff.sy = point.y; + to.rot = params.rot; + to.back = params.back; + to.len = len; + params.rot && (diff.r = toFloat(this.rotate()) || 0); + break; + case "number": + diff[attr] = (to[attr] - from[attr]) / ms; + break; + case "colour": + from[attr] = R.getRGB(from[attr]); + var toColour = R.getRGB(to[attr]); + diff[attr] = { + r: (toColour.r - from[attr].r) / ms, + g: (toColour.g - from[attr].g) / ms, + b: (toColour.b - from[attr].b) / ms + }; + break; + case "path": + var pathes = path2curve(from[attr], to[attr]); + from[attr] = pathes[0]; + var toPath = pathes[1]; + diff[attr] = []; + for (var i = 0, ii = from[attr][length]; i < ii; i++) { + diff[attr][i] = [0]; + for (var j = 1, jj = from[attr][i][length]; j < jj; j++) { + diff[attr][i][j] = (toPath[i][j] - from[attr][i][j]) / ms; + } + } + break; + case "csv": + var values = (params[attr] + E)[split](separator), + from2 = (from[attr] + E)[split](separator); + switch (attr) { + case "translation": + from[attr] = [0, 0]; + diff[attr] = [values[0] / ms, values[1] / ms]; + break; + case "rotation": + from[attr] = (from2[1] == values[1] && from2[2] == values[2]) ? from2 : [0, values[1], values[2]]; + diff[attr] = [(values[0] - from[attr][0]) / ms, 0, 0]; + break; + case "scale": + params[attr] = values; + from[attr] = (from[attr] + E)[split](separator); + diff[attr] = [(values[0] - from[attr][0]) / ms, (values[1] - from[attr][1]) / ms, 0, 0]; + break; + case "clip-rect": + from[attr] = (from[attr] + E)[split](separator); + diff[attr] = []; + i = 4; + while (i--) { + diff[attr][i] = (values[i] - from[attr][i]) / ms; + } + break; + } + to[attr] = values; + } + } + } + this.stop(); + this.in_animation = 1; + animationElements[this.id] = { + start: params.start || +new Date, + ms: ms, + easing: easing, + from: from, + diff: diff, + to: to, + el: this, + callback: callback, + t: {x: 0, y: 0} + }; + ++animationElements[length] == 1 && animation(); + return this; + }; + Element[proto].stop = function () { + animationElements[this.id] && animationElements[length]--; + delete animationElements[this.id]; + return this; + }; + Element[proto].translate = function (x, y) { + return this.attr({translation: x + " " + y}); + }; + Element[proto][toString] = function () { + return "Rapha\xebl\u2019s object"; + }; + R.ae = animationElements; + + // Set + var Set = function (items) { + this.items = []; + this[length] = 0; + if (items) { + for (var i = 0, ii = items[length]; i < ii; i++) { + if (items[i] && (items[i].constructor == Element || items[i].constructor == Set)) { + this[this.items[length]] = this.items[this.items[length]] = items[i]; + this[length]++; + } + } + } + }; + Set[proto][push] = function () { + var item, + len; + for (var i = 0, ii = arguments[length]; i < ii; i++) { + item = arguments[i]; + if (item && (item.constructor == Element || item.constructor == Set)) { + len = this.items[length]; + this[len] = this.items[len] = item; + this[length]++; + } + } + return this; + }; + Set[proto].pop = function () { + delete this[this[length]--]; + return this.items.pop(); + }; + for (var method in Element[proto]) if (Element[proto][has](method)) { + Set[proto][method] = (function (methodname) { + return function () { + for (var i = 0, ii = this.items[length]; i < ii; i++) { + this.items[i][methodname][apply](this.items[i], arguments); + } + return this; + }; + })(method); + } + Set[proto].attr = function (name, value) { + if (name && R.is(name, "array") && R.is(name[0], "object")) { + for (var j = 0, jj = name[length]; j < jj; j++) { + this.items[j].attr(name[j]); + } + } else { + for (var i = 0, ii = this.items[length]; i < ii; i++) { + this.items[i].attr(name, value); + } + } + return this; + }; + Set[proto].animate = function (params, ms, easing, callback) { + (R.is(easing, "function") || !easing) && (callback = easing || null); + var len = this.items[length], + i = len, + set = this, + collector; + callback && (collector = function () { + !--len && callback.call(set); + }); + this.items[--i].animate(params, ms, easing || collector, collector); + while (i--) { + this.items[i].animateWith(this.items[len - 1], params, ms, easing || collector, collector); + } + return this; + }; + Set[proto].insertAfter = function (el) { + var i = this.items[length]; + while (i--) { + this.items[i].insertAfter(el); + } + return this; + }; + Set[proto].getBBox = function () { + var x = [], + y = [], + w = [], + h = []; + for (var i = this.items[length]; i--;) { + var box = this.items[i].getBBox(); + x[push](box.x); + y[push](box.y); + w[push](box.x + box.width); + h[push](box.y + box.height); + } + x = mmin[apply](0, x); + y = mmin[apply](0, y); + return { + x: x, + y: y, + width: mmax[apply](0, w) - x, + height: mmax[apply](0, h) - y + }; + }; + Set[proto].clone = function (s) { + s = new Set; + for (var i = 0, ii = this.items[length]; i < ii; i++) { + s[push](this.items[i].clone()); + } + return s; + }; + + R.registerFont = function (font) { + if (!font.face) { + return font; + } + this.fonts = this.fonts || {}; + var fontcopy = { + w: font.w, + face: {}, + glyphs: {} + }, + family = font.face["font-family"]; + for (var prop in font.face) if (font.face[has](prop)) { + fontcopy.face[prop] = font.face[prop]; + } + if (this.fonts[family]) { + this.fonts[family][push](fontcopy); + } else { + this.fonts[family] = [fontcopy]; + } + if (!font.svg) { + fontcopy.face["units-per-em"] = toInt(font.face["units-per-em"], 10); + for (var glyph in font.glyphs) if (font.glyphs[has](glyph)) { + var path = font.glyphs[glyph]; + fontcopy.glyphs[glyph] = { + w: path.w, + k: {}, + d: path.d && "M" + path.d[rp](/[mlcxtrv]/g, function (command) { + return {l: "L", c: "C", x: "z", t: "m", r: "l", v: "c"}[command] || "M"; + }) + "z" + }; + if (path.k) { + for (var k in path.k) if (path[has](k)) { + fontcopy.glyphs[glyph].k[k] = path.k[k]; + } + } + } + } + return font; + }; + Paper[proto].getFont = function (family, weight, style, stretch) { + stretch = stretch || "normal"; + style = style || "normal"; + weight = +weight || {normal: 400, bold: 700, lighter: 300, bolder: 800}[weight] || 400; + var font = R.fonts[family]; + if (!font) { + var name = new RegExp("(^|\\s)" + family[rp](/[^\w\d\s+!~.:_-]/g, E) + "(\\s|$)", "i"); + for (var fontName in R.fonts) if (R.fonts[has](fontName)) { + if (name.test(fontName)) { + font = R.fonts[fontName]; + break; + } + } + } + var thefont; + if (font) { + for (var i = 0, ii = font[length]; i < ii; i++) { + thefont = font[i]; + if (thefont.face["font-weight"] == weight && (thefont.face["font-style"] == style || !thefont.face["font-style"]) && thefont.face["font-stretch"] == stretch) { + break; + } + } + } + return thefont; + }; + Paper[proto].print = function (x, y, string, font, size, origin) { + origin = origin || "middle"; // baseline|middle + var out = this.set(), + letters = (string + E)[split](E), + shift = 0, + path = E, + scale; + R.is(font, "string") && (font = this.getFont(font)); + if (font) { + scale = (size || 16) / font.face["units-per-em"]; + var bb = font.face.bbox.split(separator), + top = +bb[0], + height = +bb[1] + (origin == "baseline" ? bb[3] - bb[1] + (+font.face.descent) : (bb[3] - bb[1]) / 2); + for (var i = 0, ii = letters[length]; i < ii; i++) { + var prev = i && font.glyphs[letters[i - 1]] || {}, + curr = font.glyphs[letters[i]]; + shift += i ? (prev.w || font.w) + (prev.k && prev.k[letters[i]] || 0) : 0; + curr && curr.d && out[push](this.path(curr.d).attr({fill: "#000", stroke: "none", translation: [shift, 0]})); + } + out.scale(scale, scale, top, height).translate(x - top, y - height); + } + return out; + }; + + var formatrg = /\{(\d+)\}/g; + R.format = function (token, array) { + var args = R.is(array, "array") ? [0][concat](array) : arguments; + token && R.is(token, "string") && args[length] - 1 && (token = token[rp](formatrg, function (str, i) { + return args[++i] == null ? E : args[i]; + })); + return token || E; + }; + R.ninja = function () { + oldRaphael.was ? (Raphael = oldRaphael.is) : delete Raphael; + return R; + }; + R.el = Element[proto]; + return R; +})(); \ No newline at end of file diff --git a/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/yui-min.js b/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/yui-min.js new file mode 100644 index 0000000..55f017d --- /dev/null +++ b/src/contrib/loggraph/web/org/apache/zookeeper/graph/resources/yui-min.js @@ -0,0 +1,12 @@ +/* +Copyright (c) 2010, Yahoo! Inc. All rights reserved. +Code licensed under the BSD License: +http://developer.yahoo.com/yui/license.html +version: 3.1.0 +build: 2026 +*/ +if(typeof YUI==="undefined"){var YUI=function(F,E,D,C,A){var B=this,J=arguments,I,G=J.length,H=(typeof YUI_config!=="undefined")&&YUI_config;if(!(B instanceof YUI)){return new YUI(F,E,D,C,A);}else{B._init();if(H){B._config(H);}for(I=0;I-1){M="3.0.0";}YUI.prototype={_config:function(Y){Y=Y||{};var T,V,W,U=this.config,X=U.modules,S=U.groups;for(V in Y){T=Y[V];if(X&&V=="modules"){for(W in T){X[W]=T[W];}}else{if(S&&V=="groups"){for(W in T){S[W]=T[W];}}else{if(V=="win"){U[V]=T.contentWindow||T;U.doc=U[V].document;}else{U[V]=T;}}}}},_init:function(){var U,V=this,S=YUI.Env,T=V.Env;V.version=M;if(!T){V.Env={mods:{},base:K,cdn:K+M+"/build/",bootstrapped:false,_idx:0,_used:{},_attached:{},_yidx:0,_uidx:0,_guidp:"y",_loaded:{},getBase:function(c,a){var W,X,Z,d,Y;X=(R&&R.getElementsByTagName("script"))||[];for(Z=0;ZJ)?H[J]:true;}}return L;};F.indexOf=(D.indexOf)?function(G,H){return D.indexOf.call(G,H);}:function(G,I){for(var H=0;H-1);};E.owns=F;E.each=function(K,J,L,I){var H=L||B,G;for(G in K){if(I||F(K,G)){J.call(H,K[G],G,K);}}return B;};E.some=function(K,J,L,I){var H=L||B,G;for(G in K){if(I||F(K,G)){if(J.call(H,K[G],G,K)){return true;}}}return false;};E.getValue=function(K,J){if(!B.Lang.isObject(K)){return D;}var H,I=B.Array(J),G=I.length;for(H=0;K!==D&&H=0){for(G=0;H!==D&&G0){C=D(I);if(C){return C;}else{E=I.lastIndexOf("-");if(E>=0){I=I.substring(0,E);if(E>=2&&I.charAt(E-2)==="-"){I=I.substring(0,E-2);}}else{break;}}}}return"";}});},"3.1.0",{requires:["yui-base"]});YUI.add("yui-log",function(A){(function(){var E,D=A,F="yui:log",B="undefined",C={debug:1,info:1,warn:1,error:1};D.log=function(I,Q,G,O){var K,N,L,J,M,H=D,P=H.config;if(P.debug){if(G){N=P.logExclude;L=P.logInclude;if(L&&!(G in L)){K=1;}else{if(N&&(G in N)){K=1;}}}if(!K){if(P.useBrowserConsole){J=(G)?G+": "+I:I;if(H.Lang.isFunction(P.logFn)){P.logFn(I,Q,G);}else{if(typeof console!=B&&console.log){M=(Q&&console[Q]&&(Q in C))?Q:"log";console[M](J);}else{if(typeof opera!=B){opera.postError(J);}}}}if(H.fire&&!O){if(!E){H.publish(F,{broadcast:2});E=1;}H.fire(F,{msg:I,cat:Q,src:G});}}}return H;};D.message=function(){return D.log.apply(D,arguments);};})();},"3.1.0",{requires:["yui-base"]});YUI.add("yui-later",function(A){(function(){var B=A.Lang,C=function(K,E,L,G,H){K=K||0;E=E||{};var F=L,J=A.Array(G),I,D;if(B.isString(L)){F=E[L];}if(!F){}I=function(){F.apply(E,J);};D=(H)?setInterval(I,K):setTimeout(I,K);return{id:D,interval:H,cancel:function(){if(this.interval){clearInterval(D);}else{clearTimeout(D);}}};};A.later=C;B.later=C;})();},"3.1.0",{requires:["yui-base"]});YUI.add("yui-throttle",function(Y){ +/* Based on work by Simon Willison: http://gist.github.com/292562 */ +var throttle=function(fn,ms){ms=(ms)?ms:(Y.config.throttleTime||150);if(ms===-1){return(function(){fn.apply(null,arguments);});}var last=(new Date()).getTime();return(function(){var now=(new Date()).getTime();if(now-last>ms){last=now;fn.apply(null,arguments);}});};Y.throttle=throttle;},"3.1.0",{requires:["yui-base"]});YUI.add("yui",function(A){},"3.1.0",{use:["yui-base","get","intl-base","yui-log","yui-later","yui-throttle"]}); \ No newline at end of file diff --git a/src/contrib/monitoring/JMX-RESOURCES b/src/contrib/monitoring/JMX-RESOURCES new file mode 100644 index 0000000..1d1aa98 --- /dev/null +++ b/src/contrib/monitoring/JMX-RESOURCES @@ -0,0 +1,38 @@ + +Resources for monitoring ZooKeeper using JMX +-------------------------------------------- + +JMX/REST Bridge +--------------- + +http://code.google.com/p/polarrose-jmx-rest-bridge/ + +"Simple Java Web Application that exposes JMX servers through HTTP. This was written so that external tools can easily query JMX attributes of Java applications. More specifically, this was written to allow Cacti to generate fancy graphs of ActiveMQ instances." + +JMXetric +-------- + +http://code.google.com/p/jmxetric/ + +"JMXetric is a 100% java, configurable JVM agent that periodically polls MBean attributes and reports their values to Ganglia." + +jmxquery +-------- + +http://code.google.com/p/jmxquery/ + +"a plugin for nagios to check jmx" + +check_jmx +--------- + +http://exchange.nagios.org/directory/Plugins/Java-Applications-and-Servers/check_jmx/details + + +jmx2snmp +-------- + +http://github.com/tcurdt/jmx2snmp + +Expose application JMX properties via SNMP + diff --git a/src/contrib/monitoring/README b/src/contrib/monitoring/README new file mode 100644 index 0000000..a2206e8 --- /dev/null +++ b/src/contrib/monitoring/README @@ -0,0 +1,85 @@ + +Tools and Recipes for ZooKeeper Monitoring +------------------------------------------ + +How To Monitor +-------------- + +A ZooKeeper cluster can be monitored in two ways: + 1. by using the 'mntr' 4letterword command + 2. by using JMX to query the MBeans + +This repo contains tools and recipes for monitoring ZooKeeper using the first method. + +Check the file JMX-RESOURCE for some links to resources that could help you monitor a ZooKeeper cluster using the JMX interface. + +Requirements +------------ + +ZooKeeper 3.4.0 or later or you can apply ZOOKEEPER-744 patch over the latest 3.3.x release. +The server should understand the 'mntr' 4letterword command. + +$ echo 'mntr' | nc localhost 2181 +zk_version 3.4.0--1, built on 06/19/2010 15:07 GMT +zk_avg_latency 141 +zk_max_latency 1788 +zk_min_latency 0 +zk_packets_received 385466 +zk_packets_sent 435364 +zk_outstanding_requests 0 +zk_server_state follower +zk_znode_count 5 +zk_watch_count 0 +zk_ephemerals_count 0 +zk_approximate_data_size 41 +zk_open_file_descriptor_count 20 +zk_max_file_descriptor_count 1024 +zk_fsync_threshold_exceed_count 0 + +Python 2.6 (maybe it works on previous version but it's not tested yet). + +In a nutshell +------------- + +All you need is check_zookeeper.py It has no external dependencies. + + +*** On Nagios call the script like this: + +./check_zookeeper.py -o nagios -s "" -k -w -c + + +*** On Cacti define a custom data input method using the script like this: + +./check_zookeeper.py -o cacti -s "" -k --leader + +-- outputs a single value for the given key fetched from the cluster leader + +OR + +./check_zookeeper.py -o cacti -s "" -k + +-- outputs multiple values on for each cluster node +ex: localhost_2182:0 localhost_2183:0 localhost_2181:0 localhost_2184:0 localhost_2185:0 + +*** On Ganglia: + +install the plugin found in the ganglia/ subfolder OR + +./check_zookeeper.py -o ganglia -s "" + +it will use gmetric to send zookeeper node status data. + + +Check the subfolders for configuration details and samples for each platform. + +License +------- + +Apache License 2.0 or later. + +ZooKeeper 4letterwords Commands +------------------------------- + +http://zookeeper.apache.org/docs/current/zookeeperAdmin.html#sc_zkCommands + diff --git a/src/contrib/monitoring/cacti/README b/src/contrib/monitoring/cacti/README new file mode 100644 index 0000000..8188723 --- /dev/null +++ b/src/contrib/monitoring/cacti/README @@ -0,0 +1,56 @@ +Licensed to the Apache Software Foundation (ASF) under one +or more contributor license agreements. See the NOTICE file +distributed with this work for additional information +regarding copyright ownership. The ASF licenses this file +to you under the Apache License, Version 2.0 (the +"License"); you may not use this file except in compliance +with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. + +Recipes for ZooKeeper monitoring using Cacti +-------------------------------------------- + +Cacti install guide: https://help.ubuntu.com/community/Cacti + +Cacti Manual: http://www.cacti.net/downloads/docs/html/ +PDF version: http://www.cacti.net/downloads/docs/pdf/manual.pdf + +Check Chapter 16: Simplest Method of Going from Script to Graph + http://www.cacti.net/downloads/docs/html/how_to.html#SCRIPT_TO_GRAPH + +WARNING: I have wrote these instructions while installing and configuring the plugin on my desktop computer running Ubuntu 9.10. I've installed Cacti using apt-get. + +WARNING: I'm going to make the assumption that you know how to work with Cacti and how to setup Data Input Methods for custom scripts. I'm also going to assume that you have already installed Cacti and everything works as expected. + +You can extend the Cacti's data gathering functionality through external scripts. Cacti comes with a number of scripts out of the box wich are localted in the scripts/ directory. + + +The check_zookeeper.py script can be used a custom data input method for Cacti. + +Single value (check cluster status by sending queries to the leader): +--------------------------------------------------------------------- + +python scripts/check_zookeeper.py -s "localhost:2181,localhost:2182,localhost:2183,localhost:2184,localhost:2185" -k -o cacti --leader + +When you will call the script this way it will about a single value representing the value attached to this . + + +Multiple values (one for each cluster node): +-------------------------------------------- + +python scripts/check_zookeeper.py -s "localhost:2181,localhost:2182,localhost:2183,localhost:2184,localhost:2185" -k -o cacti + +Output: +localhost_2182:0 localhost_2183:0 localhost_2181:0 localhost_2184:0 localhost_2185:0 + + +TBD: Step by step guide + + diff --git a/src/contrib/monitoring/check_zookeeper.py b/src/contrib/monitoring/check_zookeeper.py new file mode 100644 index 0000000..2c25afb --- /dev/null +++ b/src/contrib/monitoring/check_zookeeper.py @@ -0,0 +1,395 @@ +#! /usr/bin/env python +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +""" Check Zookeeper Cluster + +Generic monitoring script that could be used with multiple platforms (Ganglia, Nagios, Cacti). + +It requires ZooKeeper 3.4.0 or greater. The script needs the 'mntr' 4letter word +command (patch ZOOKEEPER-744) that was now commited to the trunk. +The script also works with ZooKeeper 3.3.x but in a limited way. +""" + +import sys +import socket +import logging +import re +import subprocess + +from StringIO import StringIO +from optparse import OptionParser, OptionGroup + +__version__ = (0, 1, 0) + +log = logging.getLogger() +logging.basicConfig(level=logging.ERROR) + +class NagiosHandler(object): + + @classmethod + def register_options(cls, parser): + group = OptionGroup(parser, 'Nagios specific options') + + group.add_option('-w', '--warning', dest='warning') + group.add_option('-c', '--critical', dest='critical') + + parser.add_option_group(group) + + def analyze(self, opts, cluster_stats): + try: + warning = int(opts.warning) + critical = int(opts.critical) + + except (TypeError, ValueError): + print >>sys.stderr, 'Invalid values for "warning" and "critical".' + return 2 + + if opts.key is None: + print >>sys.stderr, 'You should specify a key name.' + return 2 + + warning_state, critical_state, values = [], [], [] + for host, stats in cluster_stats.items(): + if opts.key in stats: + + value = stats[opts.key] + values.append('%s=%s;%s;%s' % (host, value, warning, critical)) + + if warning >= value > critical or warning <= value < critical: + warning_state.append(host) + + elif (warning < critical and critical <= value) or (warning > critical and critical >= value): + critical_state.append(host) + + if not values: + # Zookeeper may be down, not serving requests or we may have a bad configuration + print 'Critical, %s not found' % opts.key + return 2 + + values = ' '.join(values) + if critical_state: + print 'Critical "%s" %s!|%s' % (opts.key, ', '.join(critical_state), values) + return 2 + + elif warning_state: + print 'Warning "%s" %s!|%s' % (opts.key, ', '.join(warning_state), values) + return 1 + + else: + print 'Ok "%s"!|%s' % (opts.key, values) + return 0 + +class CactiHandler(object): + + @classmethod + def register_options(cls, parser): + group = OptionGroup(parser, 'Cacti specific options') + + group.add_option('-l', '--leader', dest='leader', + action="store_true", help="only query the cluster leader") + + parser.add_option_group(group) + + def analyze(self, opts, cluster_stats): + if opts.key is None: + print >>sys.stderr, 'The key name is mandatory.' + return 1 + + if opts.leader is True: + try: + leader = [x for x in cluster_stats.values() \ + if x.get('zk_server_state', '') == 'leader'][0] + + except IndexError: + print >>sys.stderr, 'No leader found.' + return 3 + + if opts.key in leader: + print leader[opts.key] + return 0 + + else: + print >>sys.stderr, 'Unknown key: "%s"' % opts.key + return 2 + else: + for host, stats in cluster_stats.items(): + if opts.key not in stats: + continue + + host = host.replace(':', '_') + print '%s:%s' % (host, stats[opts.key]), + + +class GangliaHandler(object): + + @classmethod + def register_options(cls, parser): + group = OptionGroup(parser, 'Ganglia specific options') + + group.add_option('-g', '--gmetric', dest='gmetric', + default='/usr/bin/gmetric', help='ganglia gmetric binary '\ + 'location: /usr/bin/gmetric') + + parser.add_option_group(group) + + def call(self, *args, **kwargs): + subprocess.call(*args, **kwargs) + + def analyze(self, opts, cluster_stats): + if len(cluster_stats) != 1: + print >>sys.stderr, 'Only allowed to monitor a single node.' + return 1 + + for host, stats in cluster_stats.items(): + for k, v in stats.items(): + try: + self.call([opts.gmetric, '-n', k, '-v', str(int(v)), '-t', 'uint32']) + except (TypeError, ValueError): + pass + +class ZooKeeperServer(object): + + def __init__(self, host='localhost', port='2181', timeout=1): + self._address = (host, int(port)) + self._timeout = timeout + + def get_stats(self): + """ Get ZooKeeper server stats as a map """ + data = self._send_cmd('mntr') + stat = self._parse_stat(self._send_cmd('stat')) + if data: + mntr = self._parse(data) + missing = ['zk_zxid', 'zk_zxid_counter', 'zk_zxid_epoch'] + for m in missing: + if m in stat: + mntr[m] = stat[m] + return mntr + else: + return stat + + def _create_socket(self): + return socket.socket() + + def _send_cmd(self, cmd): + """ Send a 4letter word command to the server """ + s = self._create_socket() + s.settimeout(self._timeout) + + s.connect(self._address) + s.send(cmd) + + data = s.recv(2048) + s.close() + + return data + + def _parse(self, data): + """ Parse the output from the 'mntr' 4letter word command """ + h = StringIO(data) + + result = {} + for line in h.readlines(): + try: + key, value = self._parse_line(line) + result[key] = value + except ValueError: + pass # ignore broken lines + + return result + + def _parse_stat(self, data): + """ Parse the output from the 'stat' 4letter word command """ + h = StringIO(data) + + result = {} + + version = h.readline() + if version: + result['zk_version'] = version[version.index(':')+1:].strip() + + # skip all lines until we find the empty one + while h.readline().strip(): pass + + for line in h.readlines(): + m = re.match('Latency min/avg/max: (\d+)/(\d+)/(\d+)', line) + if m is not None: + result['zk_min_latency'] = int(m.group(1)) + result['zk_avg_latency'] = int(m.group(2)) + result['zk_max_latency'] = int(m.group(3)) + continue + + m = re.match('Received: (\d+)', line) + if m is not None: + result['zk_packets_received'] = int(m.group(1)) + continue + + m = re.match('Sent: (\d+)', line) + if m is not None: + result['zk_packets_sent'] = int(m.group(1)) + continue + + m = re.match('Outstanding: (\d+)', line) + if m is not None: + result['zk_outstanding_requests'] = int(m.group(1)) + continue + + m = re.match('Mode: (.*)', line) + if m is not None: + result['zk_server_state'] = m.group(1) + continue + + m = re.match('Node count: (\d+)', line) + if m is not None: + result['zk_znode_count'] = int(m.group(1)) + continue + + m = re.match('Watch count: (\d+)', line) + if m is not None: + result['zk_watch_count'] = int(m.group(1)) + continue + + m = re.match('Ephemerals count: (\d+)', line) + if m is not None: + result['zk_ephemerals_count'] = int(m.group(1)) + continue + + m = re.match('Approximate data size: (\d+)', line) + if m is not None: + result['zk_approximate_data_size'] = int(m.group(1)) + continue + + m = re.match('Open file descriptor count: (\d+)', line) + if m is not None: + result['zk_open_file_descriptor_count'] = int(m.group(1)) + continue + + m = re.match('Max file descriptor count: (\d+)', line) + if m is not None: + result['zk_max_file_descriptor_count'] = int(m.group(1)) + continue + + m = re.match('Zxid: (0x[0-9a-fA-F]+)', line) + if m is not None: + result['zk_zxid'] = m.group(1) + result['zk_zxid_counter'] = int(m.group(1), 16) & int('0xffffffff', 16) # lower 32 bits + result['zk_zxid_epoch'] = int(m.group(1), 16) >>32 # high 32 bits + continue + + return result + + def _parse_line(self, line): + try: + key, value = map(str.strip, line.split('\t')) + except ValueError: + raise ValueError('Found invalid line: %s' % line) + + if not key: + raise ValueError('The key is mandatory and should not be empty') + + try: + value = int(value) + except (TypeError, ValueError): + pass + + return key, value + +def main(): + opts, args = parse_cli() + + cluster_stats = get_cluster_stats(opts.servers) + if opts.output is None: + dump_stats(cluster_stats) + return 0 + + handler = create_handler(opts.output) + if handler is None: + log.error('undefined handler: %s' % opts.output) + sys.exit(1) + + return handler.analyze(opts, cluster_stats) + +def create_handler(name): + """ Return an instance of a platform specific analyzer """ + try: + return globals()['%sHandler' % name.capitalize()]() + except KeyError: + return None + +def get_all_handlers(): + """ Get a list containing all the platform specific analyzers """ + return [NagiosHandler, CactiHandler, GangliaHandler] + +def dump_stats(cluster_stats): + """ Dump cluster statistics in an user friendly format """ + for server, stats in cluster_stats.items(): + print 'Server:', server + + for key, value in stats.items(): + print "%30s" % key, ' ', value + print + +def get_cluster_stats(servers): + """ Get stats for all the servers in the cluster """ + stats = {} + for host, port in servers: + try: + zk = ZooKeeperServer(host, port) + stats["%s:%s" % (host, port)] = zk.get_stats() + + except socket.error, e: + # ignore because the cluster can still work even + # if some servers fail completely + + # this error should be also visible in a variable + # exposed by the server in the statistics + + logging.info('unable to connect to server '\ + '"%s" on port "%s"' % (host, port)) + + return stats + + +def get_version(): + return '.'.join(map(str, __version__)) + + +def parse_cli(): + parser = OptionParser(usage='./check_zookeeper.py ', version=get_version()) + + parser.add_option('-s', '--servers', dest='servers', + help='a list of SERVERS', metavar='SERVERS') + + parser.add_option('-o', '--output', dest='output', + help='output HANDLER: nagios, ganglia, cacti', metavar='HANDLER') + + parser.add_option('-k', '--key', dest='key') + + for handler in get_all_handlers(): + handler.register_options(parser) + + opts, args = parser.parse_args() + + if opts.servers is None: + parser.error('The list of servers is mandatory') + + opts.servers = [s.split(':') for s in opts.servers.split(',')] + + return (opts, args) + + +if __name__ == '__main__': + sys.exit(main()) + diff --git a/src/contrib/monitoring/ganglia/README b/src/contrib/monitoring/ganglia/README new file mode 100644 index 0000000..578adfe --- /dev/null +++ b/src/contrib/monitoring/ganglia/README @@ -0,0 +1,48 @@ +Licensed to the Apache Software Foundation (ASF) under one +or more contributor license agreements. See the NOTICE file +distributed with this work for additional information +regarding copyright ownership. The ASF licenses this file +to you under the Apache License, Version 2.0 (the +"License"); you may not use this file except in compliance +with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. + +Recipes for ZooKeeper monitoring using Ganglia +---------------------------------------------- + +Ganglia Install guide: http://sourceforge.net/apps/trac/ganglia/wiki/Ganglia%203.1.x%20Installation%20and%20Configuration + +Gmond configuration: http://sourceforge.net/apps/trac/ganglia/wiki/Gmond%203.1.x%20General%20Configuration + +WARNING: I have wrote these instructions while installing and configuring the plugin on my desktop computer running Ubuntu 9.10. I've installed Ganglia using apt-get. + +WARNING: I'm going to make the assumption that you know how to work with Ganglia. I'm also going to assume that you have already installed Gangli and everything works as expected. + +You can monitoring ZooKeeper using Ganglia in two ways: + +1. Using a python module: + + WARNING! The python module only works with Ganglia 3.1.x + + a. enable python modules: you can find instructions in modpython.confg + b. copy zookeeper.pyconf in /etc/ganglia/conf.d/ + c. copy zookeeper_ganglia.py in /usr/lib/ganglia/python_plugins + d. restart the ganglia-monitor + + This is the recommended way! + +2. OR Using check_zookeeper.py and gmetric: + + Monitoring ZooKeeper using Ganglia is a simple as calling: + + ./check_zookeeper.py -o ganglia -s localhost:2181 + + on each of the ZooKeeper cluster nodes. I'm making the assumption that you have already configured gmond and installed gmetric on each node. + diff --git a/src/contrib/monitoring/ganglia/Screenshot.png b/src/contrib/monitoring/ganglia/Screenshot.png new file mode 100644 index 0000000000000000000000000000000000000000..bc0e41d5f644bdebd680aa8e97e3d3f08039fcdc GIT binary patch literal 111055 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\o(&ieLfwK!DlYCd)QI1| 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 literal 0 HcmV?d00001 diff --git a/src/contrib/monitoring/ganglia/modpython.conf b/src/contrib/monitoring/ganglia/modpython.conf new file mode 100644 index 0000000..5cd051a --- /dev/null +++ b/src/contrib/monitoring/ganglia/modpython.conf @@ -0,0 +1,28 @@ +/* Licensed to the Apache Software Foundation (ASF) under one +or more contributor license agreements. See the NOTICE file +distributed with this work for additional information +regarding copyright ownership. The ASF licenses this file +to you under the Apache License, Version 2.0 (the +"License"); you may not use this file except in compliance +with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. */ + +/* Update gmond.conf */ + +modules { + module { + name = "python_module" + path = "/usr/lib/ganglia/modpython.so" + params = "/usr/lib/ganglia/python_modules" + } +} + +include ('/etc/ganglia/conf.d/*.pyconf') + diff --git a/src/contrib/monitoring/ganglia/zookeeper.pyconf b/src/contrib/monitoring/ganglia/zookeeper.pyconf new file mode 100644 index 0000000..029c146 --- /dev/null +++ b/src/contrib/monitoring/ganglia/zookeeper.pyconf @@ -0,0 +1,50 @@ +/* Licensed to the Apache Software Foundation (ASF) under one +or more contributor license agreements. See the NOTICE file +distributed with this work for additional information +regarding copyright ownership. The ASF licenses this file +to you under the Apache License, Version 2.0 (the +"License"); you may not use this file except in compliance +with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. */ + +/* Update /etc/ganglia/gmond.conf with the content of this file. */ + +/* ATTENTION: Change the host and the port to meet your setup. */ + +modules { + module { + name = "zookeeper_ganglia" + language = "python" + param host { value = "127.0.0.1" } + param port { value = 2181 } + } +} + +collection_group { + collect_every = 20 + time_threshold = 60 + metric { name = "zk_avg_latency" } + metric { name = "zk_max_latency" } + metric { name = "zk_min_latency" } + metric { name = "zk_packets_received" } + metric { name = "zk_packets_sent" } + metric { name = "zk_outstanding_requests" } + metric { name = "zk_znode_count" } + metric { name = "zk_watch_count" } + metric { name = "zk_ephemerals_count" } + metric { name = "zk_approximate_data_size" } + metric { name = "zk_open_file_descriptor_count" } + metric { name = "zk_max_file_descriptor_count" } + metric { name = "zk_followers" } + metric { name = "zk_synced_followers" } + metric { name = "zk_pending_syncs" } + metric { name = "zk_fsync_threshold_exceed_count" } +} + diff --git a/src/contrib/monitoring/ganglia/zookeeper_ganglia.py b/src/contrib/monitoring/ganglia/zookeeper_ganglia.py new file mode 100644 index 0000000..b20f824 --- /dev/null +++ b/src/contrib/monitoring/ganglia/zookeeper_ganglia.py @@ -0,0 +1,210 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +""" Python Ganglia Module for ZooKeeper monitoring + +Inspired by: http://gist.github.com/448007 + +Copy this file to /usr/lib/ganglia/python_plugins + +""" + +import sys +import socket +import time +import re + +from StringIO import StringIO + +TIME_BETWEEN_QUERIES = 20 + +class ZooKeeperServer(object): + + def __init__(self, host='localhost', port='2181', timeout=1): + self._address = (host, int(port)) + self._timeout = timeout + + def get_stats(self): + """ Get ZooKeeper server stats as a map """ + data = self._send_cmd('mntr') + if data: + return self._parse(data) + else: + data = self._send_cmd('stat') + return self._parse_stat(data) + + def _create_socket(self): + return socket.socket() + + def _send_cmd(self, cmd): + """ Send a 4letter word command to the server """ + s = self._create_socket() + s.settimeout(self._timeout) + + s.connect(self._address) + s.send(cmd) + + data = s.recv(2048) + s.close() + + return data + + def _parse(self, data): + """ Parse the output from the 'mntr' 4letter word command """ + h = StringIO(data) + + result = {} + for line in h.readlines(): + try: + key, value = self._parse_line(line) + result[key] = value + except ValueError: + pass # ignore broken lines + + return result + + def _parse_stat(self, data): + """ Parse the output from the 'stat' 4letter word command """ + h = StringIO(data) + + result = {} + + version = h.readline() + if version: + result['zk_version'] = version[version.index(':')+1:].strip() + + # skip all lines until we find the empty one + while h.readline().strip(): pass + + for line in h.readlines(): + m = re.match('Latency min/avg/max: (\d+)/(\d+)/(\d+)', line) + if m is not None: + result['zk_min_latency'] = int(m.group(1)) + result['zk_avg_latency'] = int(m.group(2)) + result['zk_max_latency'] = int(m.group(3)) + continue + + m = re.match('Received: (\d+)', line) + if m is not None: + result['zk_packets_received'] = int(m.group(1)) + continue + + m = re.match('Sent: (\d+)', line) + if m is not None: + result['zk_packets_sent'] = int(m.group(1)) + continue + + m = re.match('Outstanding: (\d+)', line) + if m is not None: + result['zk_outstanding_requests'] = int(m.group(1)) + continue + + m = re.match('Mode: (.*)', line) + if m is not None: + result['zk_server_state'] = m.group(1) + continue + + m = re.match('Node count: (\d+)', line) + if m is not None: + result['zk_znode_count'] = int(m.group(1)) + continue + + return result + + def _parse_line(self, line): + try: + key, value = map(str.strip, line.split('\t')) + except ValueError: + raise ValueError('Found invalid line: %s' % line) + + if not key: + raise ValueError('The key is mandatory and should not be empty') + + try: + value = int(value) + except (TypeError, ValueError): + pass + + return key, value + +def metric_handler(name): + if time.time() - metric_handler.timestamp > TIME_BETWEEN_QUERIES: + zk = ZooKeeperServer(metric_handler.host, metric_handler.port, 5) + try: + metric_handler.info = zk.get_stats() + except Exception, e: + print >>sys.stderr, e + metric_handler.info = {} + + return metric_handler.info.get(name, 0) + +def metric_init(params=None): + params = params or {} + + metric_handler.host = params.get('host', 'localhost') + metric_handler.port = int(params.get('port', 2181)) + metric_handler.timestamp = 0 + + metrics = { + 'zk_avg_latency': {'units': 'ms'}, + 'zk_max_latency': {'units': 'ms'}, + 'zk_min_latency': {'units': 'ms'}, + 'zk_packets_received': { + 'units': 'packets', + 'slope': 'positive' + }, + 'zk_packets_sent': { + 'units': 'packets', + 'slope': 'positive' + }, + 'zk_outstanding_requests': {'units': 'connections'}, + 'zk_znode_count': {'units': 'znodes'}, + 'zk_watch_count': {'units': 'watches'}, + 'zk_ephemerals_count': {'units': 'znodes'}, + 'zk_approximate_data_size': {'units': 'bytes'}, + 'zk_open_file_descriptor_count': {'units': 'descriptors'}, + 'zk_max_file_descriptor_count': {'units': 'descriptors'}, + 'zk_followers': {'units': 'nodes'}, + 'zk_synced_followers': {'units': 'nodes'}, + 'zk_pending_syncs': {'units': 'syncs'}, + 'zk_fsync_threshold_exceed_count': {'units': 'fsyncexceed'} + } + metric_handler.descriptors = {} + for name, updates in metrics.iteritems(): + descriptor = { + 'name': name, + 'call_back': metric_handler, + 'time_max': 90, + 'value_type': 'int', + 'units': '', + 'slope': 'both', + 'format': '%d', + 'groups': 'zookeeper', + } + descriptor.update(updates) + metric_handler.descriptors[name] = descriptor + + return metric_handler.descriptors.values() + +def metric_cleanup(): + pass + + +if __name__ == '__main__': + ds = metric_init({'host':'localhost', 'port': '2181'}) + for d in ds: + print "%s=%s" % (d['name'], metric_handler(d['name'])) + + diff --git a/src/contrib/monitoring/nagios/README.txt b/src/contrib/monitoring/nagios/README.txt new file mode 100644 index 0000000..317ae14 --- /dev/null +++ b/src/contrib/monitoring/nagios/README.txt @@ -0,0 +1,86 @@ +Licensed to the Apache Software Foundation (ASF) under one +or more contributor license agreements. See the NOTICE file +distributed with this work for additional information +regarding copyright ownership. The ASF licenses this file +to you under the Apache License, Version 2.0 (the +"License"); you may not use this file except in compliance +with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. + +Configuration Recipe for monitoring ZooKeeper using Nagios +---------------------------------------------------------- + +I will start by making the assumption that you already have an working Nagios install. + +WARNING: I have wrote these instructions while installing and configuring the plugin on my desktop computer running Ubuntu 9.10. I've installed Nagios using apt-get. + +WARNING: You should customize the config files as suggested in order to match your Nagios and Zookeeper install. + +WARNING: This README assumes you know how to configure Nagios and how it works. + +WARNING: You should customize the warning and critical levels on service checks to meet your own needs. + +1. Install the plugin + +$ cp check_zookeeper.py /usr/lib/nagios/plugins/ + +2. Install the new commands + +$ cp zookeeper.cfg /etc/nagios-plugins/config + +3. Update the list of servers in zookeeper.cfg for the command 'check_zookeeper' and update the port for the command 'check_zk_node' (default: 2181) + +4. Create a virtual host in Nagios used for monitoring the cluster as a whole -OR- Create a hostgroup named 'zookeeper-servers' and add all the zookeeper cluster nodes. + +5. Define service checks like I have ilustrated bellow or just use the provided definitions. + +define service { + use generic-service + host_name zookeeper-cluster + service_description ... + check_command check_zookeeper!!! +} + +define service { + hostgroup_name zookeeper-servers + use generic-service + service_description ZK_Open_File_Descriptors_Count + check_command check_zk_node!!! +} + +Ex: + +a. check the number of open file descriptors + +define service{ + use generic-service + host_name zookeeper-cluster + service_description ZK_Open_File_Descriptor_Count + check_command check_zookeeper!zk_open_file_descriptor_count!500!800 +} + +b. check the number of ephemerals nodes + +define service { + use generic-service + host_name localhost + service_description ZK_Ephemerals_Count + check_command check_zookeeper!zk_ephemerals_count!10000!100000 +} + +c. check the number of open file descriptors for each host in the group + +define service { + hostgroup_name zookeeper-servers + use generic-service + service_description ZK_Open_File_Descriptors_Count + check_command check_zk_node!zk_open_file_descriptor_count!500!800 +} + diff --git a/src/contrib/monitoring/nagios/Screenshot-1.png b/src/contrib/monitoring/nagios/Screenshot-1.png new file mode 100644 index 0000000000000000000000000000000000000000..2dc55c58adcba0adf1407a093eabf3556153cd8b GIT binary patch literal 196668 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
    +xHGrd_zYcH|R~nOS54djq`MaeF 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

    hm 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

    %4Ocm&BH;Uj&U@R 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 UIOjPIG!MF^q;aEA!TiyG0f4c#8UO$Q literal 0 HcmV?d00001 diff --git a/src/contrib/monitoring/nagios/hostgroups.cfg b/src/contrib/monitoring/nagios/hostgroups.cfg new file mode 100644 index 0000000..ea59a66 --- /dev/null +++ b/src/contrib/monitoring/nagios/hostgroups.cfg @@ -0,0 +1,25 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +# A group containing all the ZooKeeper nodes + +define hostgroup { + hostgroup_name zookeeper-servers + alias ZooKeeper Servers + members localhost +} + + diff --git a/src/contrib/monitoring/nagios/services.cfg b/src/contrib/monitoring/nagios/services.cfg new file mode 100644 index 0000000..dde6ab7 --- /dev/null +++ b/src/contrib/monitoring/nagios/services.cfg @@ -0,0 +1,67 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +# ZooKeeper Node specific services + +define service { + hostgroup_name zookeeper-servers + use generic-service + service_description ZK_Open_File_Descriptors_Count + check_command check_zk_node!zk_open_file_descriptor_count!500!800 +} + +define service { + hostgroup_name zookeeper-servers + use generic-service + service_description ZK_Ephemerals_Count + check_command check_zk_node!zk_ephemerals_count!10000!100000 +} + +define service { + hostgroup_name zookeeper-servers + use generic-service + service_description ZK_Avg_Latency + check_command check_zk_node!zk_avg_latency!500!1000 +} + +define service { + hostgroup_name zookeeper-servers + use generic-service + service_description ZK_Max_Latency + check_command check_zk_node!zk_max_latency!1000!2000 +} + +define service { + hostgroup_name zookeeper-servers + use generic-service + service_description ZK_Min_Latency + check_command check_zk_node!zk_min_latency!500!1000 +} + +define service { + hostgroup_name zookeeper-servers + use generic-service + service_description ZK_Outstanding_Requests + check_command check_zk_node!zk_outstanding_requests!20!50 +} + +define service { + hostgroup_name zookeeper-servers + use generic-service + service_description ZK_Watch_Count + check_command check_zk_node!zk_watch_count!100!500 +} + diff --git a/src/contrib/monitoring/nagios/zookeeper.cfg b/src/contrib/monitoring/nagios/zookeeper.cfg new file mode 100644 index 0000000..ed4cfab --- /dev/null +++ b/src/contrib/monitoring/nagios/zookeeper.cfg @@ -0,0 +1,30 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +# 'check_zookeeper' command definition +define command { + command_name check_zookeeper + command_line /usr/lib/nagios/plugins/check_zookeeper.py -s "localhost:2181,localhost:2182,localhost:2183" -o nagios -k '$ARG1$' -w '$ARG2$' -c '$ARG3$' + # ATTENTION: you should update the list of servers defined above +} + +# 'check_zk_node' command definition +define command { + command_name check_zk_node + command_line /usr/lib/nagios/plugins/check_zookeeper.py -s $HOSTADDRESS$:2181 -o nagios -k '$ARG1$' -w '$ARG2$' -c '$ARG3$' + # ATTENTION: you should update the port. default: 2181 +} + diff --git a/src/contrib/monitoring/test.py b/src/contrib/monitoring/test.py new file mode 100644 index 0000000..3941291 --- /dev/null +++ b/src/contrib/monitoring/test.py @@ -0,0 +1,282 @@ +#! /usr/bin/env python +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +import unittest +import socket +import sys + +from StringIO import StringIO + +from check_zookeeper import ZooKeeperServer, NagiosHandler, CactiHandler, GangliaHandler + +ZK_MNTR_OUTPUT = """zk_version\t3.4.0--1, built on 06/19/2010 15:07 GMT +zk_avg_latency\t1 +zk_max_latency\t132 +zk_min_latency\t0 +zk_packets_received\t640 +zk_packets_sent\t639 +zk_outstanding_requests\t0 +zk_server_state\tfollower +zk_znode_count\t4 +zk_watch_count\t0 +zk_ephemerals_count\t0 +zk_approximate_data_size\t27 +zk_open_file_descriptor_count\t22 +zk_max_file_descriptor_count\t1024 +""" + +ZK_MNTR_OUTPUT_WITH_BROKEN_LINES = """zk_version\t3.4.0 +zk_avg_latency\t23 +broken-line + +""" + +ZK_STAT_OUTPUT = """Zookeeper version: 3.3.0-943314, built on 05/11/2010 22:20 GMT +Clients: + /0:0:0:0:0:0:0:1:34564[0](queued=0,recved=1,sent=0) + +Latency min/avg/max: 0/40/121 +Received: 11 +Sent: 10 +Outstanding: 0 +Zxid: 0x700000003 +Mode: follower +Node count: 4 +""" + +class SocketMock(object): + def __init__(self): + self.sent = [] + + def settimeout(self, timeout): + self.timeout = timeout + + def connect(self, address): + self.address = address + + def send(self, data): + self.sent.append(data) + return len(data) + + def recv(self, size): + return ZK_MNTR_OUTPUT[:size] + + def close(self): pass + +class ZK33xSocketMock(SocketMock): + def __init__(self): + SocketMock.__init__(self) + self.got_stat_cmd = False + + def recv(self, size): + if 'stat' in self.sent: + return ZK_STAT_OUTPUT[:size] + else: + return '' + +class UnableToConnectSocketMock(SocketMock): + def connect(self, _): + raise socket.error('[Errno 111] Connection refused') + +def create_server_mock(socket_class): + class ZooKeeperServerMock(ZooKeeperServer): + def _create_socket(self): + return socket_class() + return ZooKeeperServerMock() + +class TestCheckZookeeper(unittest.TestCase): + + def setUp(self): + self.zk = ZooKeeperServer() + + def test_parse_valid_line(self): + key, value = self.zk._parse_line('something\t5') + + self.assertEqual(key, 'something') + self.assertEqual(value, 5) + + def test_parse_line_raises_exception_on_invalid_output(self): + invalid_lines = ['something', '', 'a\tb\tc', '\t1'] + for line in invalid_lines: + self.assertRaises(ValueError, self.zk._parse_line, line) + + def test_parser_on_valid_output(self): + data = self.zk._parse(ZK_MNTR_OUTPUT) + + self.assertEqual(len(data), 14) + self.assertEqual(data['zk_znode_count'], 4) + + def test_parse_should_ignore_invalid_lines(self): + data = self.zk._parse(ZK_MNTR_OUTPUT_WITH_BROKEN_LINES) + + self.assertEqual(len(data), 2) + + def test_parse_stat_valid_output(self): + data = self.zk._parse_stat(ZK_STAT_OUTPUT) + + result = { + 'zk_version' : '3.3.0-943314, built on 05/11/2010 22:20 GMT', + 'zk_min_latency' : 0, + 'zk_avg_latency' : 40, + 'zk_max_latency' : 121, + 'zk_packets_received': 11, + 'zk_packets_sent': 10, + 'zk_server_state': 'follower', + 'zk_znode_count': 4 + } + for k, v in result.iteritems(): + self.assertEqual(v, data[k]) + + def test_recv_valid_output(self): + zk = create_server_mock(SocketMock) + + data = zk.get_stats() + self.assertEqual(len(data), 14) + self.assertEqual(data['zk_znode_count'], 4) + + def test_socket_unable_to_connect(self): + zk = create_server_mock(UnableToConnectSocketMock) + + self.assertRaises(socket.error, zk.get_stats) + + def test_use_stat_cmd_if_mntr_is_not_available(self): + zk = create_server_mock(ZK33xSocketMock) + + data = zk.get_stats() + self.assertEqual(data['zk_version'], '3.3.0-943314, built on 05/11/2010 22:20 GMT') + +class HandlerTestCase(unittest.TestCase): + + def setUp(self): + try: + sys._stdout + except: + sys._stdout = sys.stdout + + sys.stdout = StringIO() + + def tearDown(self): + sys.stdout = sys._stdout + + def output(self): + sys.stdout.seek(0) + return sys.stdout.read() + + +class TestNagiosHandler(HandlerTestCase): + + def _analyze(self, w, c, k, stats): + class Opts(object): + warning = w + critical = c + key = k + + return NagiosHandler().analyze(Opts(), {'localhost:2181':stats}) + + def test_ok_status(self): + r = self._analyze(10, 20, 'a', {'a': 5}) + + self.assertEqual(r, 0) + self.assertEqual(self.output(), 'Ok "a"!|localhost:2181=5;10;20\n') + + r = self._analyze(20, 10, 'a', {'a': 30}) + self.assertEqual(r, 0) + + def test_warning_status(self): + r = self._analyze(10, 20, 'a', {'a': 15}) + self.assertEqual(r, 1) + self.assertEqual(self.output(), + 'Warning "a" localhost:2181!|localhost:2181=15;10;20\n') + + r = self._analyze(20, 10, 'a', {'a': 15}) + self.assertEqual(r, 1) + + def test_critical_status(self): + r = self._analyze(10, 20, 'a', {'a': 30}) + self.assertEqual(r, 2) + self.assertEqual(self.output(), + 'Critical "a" localhost:2181!|localhost:2181=30;10;20\n') + + r = self._analyze(20, 10, 'a', {'a': 5}) + self.assertEqual(r, 2) + + def test_check_a_specific_key_on_all_hosts(self): + class Opts(object): + warning = 10 + critical = 20 + key = 'latency' + + r = NagiosHandler().analyze(Opts(), { + 's1:2181': {'latency': 5}, + 's2:2181': {'latency': 15}, + 's3:2181': {'latency': 35}, + }) + self.assertEqual(r, 2) + self.assertEqual(self.output(), + 'Critical "latency" s3:2181!|s1:2181=5;10;20 '\ + 's3:2181=35;10;20 s2:2181=15;10;20\n') + +class TestCactiHandler(HandlerTestCase): + class Opts(object): + key = 'a' + leader = False + + def __init__(self, leader=False): + self.leader = leader + + def test_output_values_for_all_hosts(self): + r = CactiHandler().analyze(TestCactiHandler.Opts(), { + 's1:2181':{'a':1}, + 's2:2181':{'a':2, 'b':3} + }) + self.assertEqual(r, None) + self.assertEqual(self.output(), 's1_2181:1 s2_2181:2') + + def test_output_single_value_for_leader(self): + r = CactiHandler().analyze(TestCactiHandler.Opts(leader=True), { + 's1:2181': {'a':1, 'zk_server_state': 'leader'}, + 's2:2181': {'a':2} + }) + self.assertEqual(r, 0) + self.assertEqual(self.output(), '1\n') + + +class TestGangliaHandler(unittest.TestCase): + + class TestableGangliaHandler(GangliaHandler): + def __init__(self): + GangliaHandler.__init__(self) + self.cli_calls = [] + + def call(self, cli): + self.cli_calls.append(' '.join(cli)) + + def test_send_single_metric(self): + class Opts(object): + @property + def gmetric(self): return '/usr/bin/gmetric' + opts = Opts() + + h = TestGangliaHandler.TestableGangliaHandler() + h.analyze(opts, {'localhost:2181':{'latency':10}}) + + cmd = "%s -n latency -v 10 -t uint32" % opts.gmetric + assert cmd in h.cli_calls + +if __name__ == '__main__': + unittest.main() + diff --git a/src/contrib/rest/NOTICE.txt b/src/contrib/rest/NOTICE.txt new file mode 100644 index 0000000..2a92254 --- /dev/null +++ b/src/contrib/rest/NOTICE.txt @@ -0,0 +1,7 @@ +This contrib module includes software developed under the +COMMON DEVELOPMENT AND DISTRIBUTION LICENSE (CDDL) Version 1.0 + +This contrib depends on binary only jar libraries developed at: + +https://jersey.dev.java.net/ +https://grizzly.dev.java.net/ diff --git a/src/contrib/rest/README.txt b/src/contrib/rest/README.txt new file mode 100644 index 0000000..30f2e5d --- /dev/null +++ b/src/contrib/rest/README.txt @@ -0,0 +1,72 @@ + +ZooKeeper REST implementation using Jersey JAX-RS. +-------------------------------------------------- + +This is an implementation of version 2 of the ZooKeeper REST spec. + +Note: This interface is currently experimental, may change at any time, +etc... In general you should be using the Java/C client bindings to access +the ZooKeeper server. + +This REST ZooKeeper gateway is useful because most of the languages +have built-in support for working with HTTP based protocols. + +See SPEC.txt for details on the REST binding. + +Quickstart: +----------- + +1) start a zookeeper server on localhost port 2181 + +2) run "ant run" + +3) use a REST client to access the data (see below for more details) + + curl http://localhost:9998/znodes/v1/ + +or use the provided src/python scripts + + zk_dump_tree.py + + +Tests: +---------- + +1) the full testsuite can be run via "ant test" target +2) the python client library also contains a test suite + +Examples Using CURL +------------------- + +First review the spec SPEC.txt in this directory. + +#get the root node data +curl http://localhost:9998/znodes/v1/ + +#get children of the root node +curl http://localhost:9998/znodes/v1/?view=children + +#get "/cluster1/leader" as xml (default is json) +curl -H'Accept: application/xml' http://localhost:9998/znodes/v1/cluster1/leader + +#get the data as text +curl -w "\n%{http_code}\n" "http://localhost:9998/znodes/v1/cluster1/leader?dataformat=utf8" + +#set a node (data.txt contains the ascii text you want to set on the node) +curl -T data.txt -w "\n%{http_code}\n" "http://localhost:9998/znodes/v1/cluster1/leader?dataformat=utf8" + +#create a node +curl -d "data1" -H'Content-Type: application/octet-stream' -w "\n%{http_code}\n" "http://localhost:9998/znodes/v1/?op=create&name=cluster2&dataformat=utf8" + +curl -d "data2" -H'Content-Type: application/octet-stream' -w "\n%{http_code}\n" "http://localhost:9998/znodes/v1/cluster2?op=create&name=leader&dataformat=utf8" + +#create a new session +curl -d "" -H'Content-Type: application/octet-stream' -w "\n%{http_code}\n" "http://localhost:9998/sessions/v1/?op=create&expire=10" + +#session heartbeat +curl -X "PUT" -H'Content-Type: application/octet-stream' -w "\n%{http_code}\n" "http://localhost:9998/sessions/v1/02dfdcc8-8667-4e53-a6f8-ca5c2b495a72" + +#delete a session +curl -X "DELETE" -H'Content-Type: application/octet-stream' -w "\n%{http_code}\n" "http://localhost:9998/sessions/v1/02dfdcc8-8667-4e53-a6f8-ca5c2b495a72" + + diff --git a/src/contrib/rest/SPEC.txt b/src/contrib/rest/SPEC.txt new file mode 100644 index 0000000..8c5f701 --- /dev/null +++ b/src/contrib/rest/SPEC.txt @@ -0,0 +1,355 @@ +# Licensed to the Apache Software Foundation (ASF) under one or more +# contributor license agreements. See the NOTICE file distributed with +# this work for additional information regarding copyright ownership. +# The ASF licenses this file to You under the Apache License, Version 2.0 +# (the "License"); you may not use this file except in compliance with +# the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +A REST HTTP gateway for ZooKeeper +================================= + +Specification Version: 2 + +ZooKeeper is meant to enable distributed coordination and also store +system configuration and other relatively small amounts of information +that must be stored in a persistent and consistent manner. The +information stored in ZooKeeper is meant to be highly available to a +large number of nodes in a distributed-computing cluster. + +ZooKeeper offers a client-side library that supports rich semantics +that include strict ordering guarantees on operations, the creation of +ephemeral znodes, and the ability to watch for changes to state. +However, where clients need simple "CRUD" (create, read, update, +delete) operations, the ZooKeeper libraries can be cumbersome, both to +the programmers who have to use them (who are increasingly used to +REST-style APIs), and to the operators who have to deploy and update +them (for whom deploying and updating client libraries can be very +painful). + +It turns out that most languages comes with client libraries for HTTP +that are easy and familiar to program against, and deployed as part of +the language runtime. Thus, for simple CRUD clients, an HTTP gateway +would be a less cumbersome interface than the ZooKeeper library. + +This document describes a gatway for using HTTP to interact with a +ZooKeeper repository. + +Binding ZooKeeper to HTTP +------------------------- + +Encoding +-------- + +UTF-8 unless otherwise noted + +Paths +----- + +A ZooKeeper paths are mapped to IRIs and URIs as follows. ZK paths +are converted to IRIs by simply percent-encoding any characters in the +ZK path that are not allowed in IRI paths. ZK paths are converted to +URIs by mapping them first to IRIs, then converting to URIs in the +standard way. + +Going from URIs and IRIs is the reverse of the above but for one +difference: any "." and ".." segments in an IRI or URI must be folded +before conversion. (Fortunately, ZK does not allow "." and ".." +segments in its paths.) + +ZK and IRIs recommend the same practices when it comes to Unicode +normalization: ultimately, normalization is left to application +designers, but both recommend that application designers use NFC as a +best practice. + +Root +---- + +The following examples assume that the ZooKeeper znode heirarchy is +bound to the root of the HTTP servers namespace. This may not be the +case in practice however, the gateway may bind to some prefix, for +example the URL for accessing /a/b/c may be: + + http://localhost/zookeeper/znodes/v1/a/b/c + +This is perfectly valid. Users of the REST service should be aware of +this fact and code their clients to support any root (in this case +"/zookeeper" on the server localhost). + + +Basics: GET, PUT, HEAD, and DELETE +---------------------------------- + +HTTP's GET, PUT, HEAD, and DELETE operations map naturally to +ZooKeeper's "get," "set," "exists," and "delete" operations. + +ZooKeeper znodes have a version number that changes each time the +znode's value is updated. This number is returned by "get," "set," and +"exists" operations. The "set" and "delete" operations optionally take +a version number. If one is supplied, then "set" or "delete" will fail +if the current version of the znode doesn't match the version-number +supplied in the call. This mechanism supports atomic read-modify-write +cycles. Set/delete requests may include an optional parameter +"version" which defaults to no version check. + + +Getting ZooKeeper children +-------------------------- + +We overload the GET method to return the children of a ZooKeeper. In +particular, the GET method takes an optional parameter "view" which +could be set to one of type values, either "data" or "children". The +default is "data". Thus, to get the children of a znode named +"/a/b/c", then the GET request should start: + + GET /znodes/v1/a/b/c?view=children HTTP/1.1 + +If the requested view is "data", then the data of a znode is returned +as described in the previous section. If the requested view is +"children", then a list of children is returned in either an XML +document, or in a JSON object. (The default is JSON, but this can be +controlled changed by setting the Accept header.) + + +Creating a ZooKeeper session +---------------------------- + +In order to be able to create ephemeral nodes you first need to start +a new session. + + POST /sessions/v1?op=create&expire= HTTP/1.1 + +If the session creation is successful, then a 201 code will be returned. + +A session is just an UUID that you can pass around as a parameter and +the REST server will foward your request on the attached persistent +connection. + +Keeping a session alive +----------------------- + +To keep a session alive you must send hearbeat requests: + + PUT /sessions/v1/ HTTP/1.1 + +Closing a ZooKeeper session +--------------------------- + +You can close a connection by sending a DELETE request. + + DELETE /sessions/v1/ HTTP/1.1 + +If you don't close a session it will automatically expire after +the amount of time you specified on creation. + +Creating a ZooKeeper znode +-------------------------- + +We use the POST method to create a ZooKeeper znode. For example, to +create a znode named "c" under a parent named "/a/b", then the POST +request should start: + + POST /znodes/v1/a/b?op=create&name=c HTTP/1.1 + +If the creation is successful, then a 201 code will be returned. If +it fails, then a number of different codes might be returned +(documented in a later subsection). + +ZooKeeper's create operation has a flag that tells the server to +append a sequence-number to the client-supplied znode-name in order to +make the znode-name unique. If you set this flag and ask to create a +znode named "/a/b/c", and a znode named "/a/b" already exists, then +"create" will create a znode named "/a/b/c-#" instead, where "#" is and +integer required to generate a unique name in for format %10d. + +To obtain this behavior, an additional "sequence=true" parameter +should be added to the parameters of the POST. (Note that "sequence" +is an optional parameter, that defaults to "false"; this default may +be provided explicitly if desired.) + +On success the actual path of the created znode will be returned. + +If you want to create an ephemeral node you need to specify an +additional "ephemeral=true" parameter. (Note that "ephemeral" is an optional +parameter, that defaults to "false") + +(Note: ZooKeeper also allows the client to set ACLs for the +newly-created znode. This feature is not currently supported by the +HTTP gateway to ZooKeeper.) + + +Content types and negotiation +----------------------------- + +ZooKeeper REST gateway implementations may support three content-types +for request and response messages: + +* application/octet-stream + + HEAD - returns nothing (note below: status = 204) + GET - returns the znode data as an octet-stream + PUT - send binary data, returns nothing + POST - send binary data, returns the name of the znode + DELETE - returns nothing + + For PUT and HEAD some other content-type (i.e. JSON or XML) must be + used to access the Stat information of a znode. + +* application/json, application/javascript & application/xml + + HEAD - returns nothing + GET - returns a STAT or CHILD structure + PUT - send binary data, returns a STAT structure (sans data field) + POST - send binary data, returns a PATH structure + DELETE - returns nothing + + (structures defined below) + + Results returning DATA may include an optional "dataformat" + parameter which has two possible values; base64 (default) or + utf8. This allows the caller to control the format of returned data + and may simplify usage -- for example cat'ing results to the command + line with something like curl, or accessing a url through a browser. + Care should be exercised however, if utf8 is used on non character + data errors may result. + + "application/javascript" requests may include an optional "callback" + parameter. The response is wrapped in a callback method of your + choice. e.g. appending &callback=foo to your request will result in + a response body of: foo(...). Callbacks may only contain + alphanumeric characters and underscores. + +PATH + path : string + uri: string + + path is the full path to the znode as seen by ZooKeeper + + uri is the full URI of the znode as seen by the REST server, does not + include any query parameters (i.e. it's the path to the REST resource) + +SESSION + id : string UUID + uri : string + +CHILD + PATH + child_uri_template: string + children : [ string* ] + + The children list of strings contains only the name of the child + znodes, not the full path. + + child_uri_template is a template for URI of child znodes as seen by the + REST server. e.g. "http://localhost:9998/znodes/v1/foo/{child}", where + foo is the parent node, and {child} can be substituted with the name + of each child in the children array in order to access that resource. + This template is provided to simplify child access. + +STAT + PATH + encoding : value of "base64" or "utf8" + data : base64 or utf8 encoded string + stat : + czxid : number + mzxid : number + ctime : number + mtime : number + version : number + cversion : number + aversion : number + ephemeralOwner : number + datalength : number + numChildren : number + pzxid : number + + +Error Codes +----------- + +The ZooKeeper gateway uses HTTP response codes as follows: + + * 200 (Success) - ZOK for "get" "set" "delete", "yes" case of "exists" (json/xml) + * 201 (Created) - ZOK for "create" + * 204 (No Content) - ZOK for "yes" case of "exists" (octet) + * 400 (Bad Request) - ZINVALIDACL, ZBADARGUMENTS, version param not a number + * 401 (Unauthorized) - ZAUTHFAILED + * 404 (Not Found) - ZOK for "no" case of "exists;" ZNONODE for "get," "set," and "delete" + * 409 (Conflict) - ZNODEEXISTS, ZNONODE for "create," ZNOTEMPTY, + * 412 (Precondition Failed) - ZBADVERSION + * 415 (Unsupported Media Type) - if content-type of PUT or POST is not "application/octet-stream" + * 500 (Internal Server Error) - Failure in gateway code + * 501 (Not Implemented) - HTTP method other than GET, PUT, HEAD, DELETE + * 502 (Bad Gateway) - All other ZooKeeper error codes + * 503 (Service Unavailable) - ZSESSIONEXPIRED, ZCONNECTIONLOSS, (gateway will try to reestablish the connection, but will not hold the request waiting...) + * 504 (Gateway Timeout) - ZOPERATIONTIMEOUT, or ZooKeeper does not return in a timely manner + +Note that these are the codes used by the HTTP-to-Gateway software +itself. Depending on how this software is configured into a Web +server, the resulting Web Server might behave differently, e.g., it +might do redirection, check other headers, etc. + +Error Messages +-------------- + +Error messages are returned to the caller, format is dependent on the +format requested in the call. + +* application/octet-stream + + A string containing the error message. It should include the request + and information detailing the reason for the error. + +* application/json + + { "request":"GET /a/b/c", "message":"Node doesn't exist" } + +* application/xml + + + + GET /a/b/c + Node doesn't exist + + + +Binding ZooKeeper to an HTTP server +----------------------------------- + +It might be sage to assume that everyone is happy to run an Apache +server, and thus write a "mod_zookeeper" for Apache that works only +for the Apache Web Server. However, different operational +environments prefer different Web Servers, and it would be nice to +support more than one Web server. + +Issues: + + * Configuration. + + * Defining a root: Need to provide a URL alias and associate it + with a server. Need to be able to map different aliases to + different servers (implemented via multiple ZK connections). + + * Sharing connection across multiple processes. + + * Asynchronous. + + * Adaptors. + + * Code re-use. + + +Authentication -- TBD, not currently supported + +...the config file should contain authentication material for the gateway + +...the config file should contain an ACL list to be passed along to "create" + +...would we ever want to authenticate each request to ZooKeeper?... diff --git a/src/contrib/rest/build.xml b/src/contrib/rest/build.xml new file mode 100644 index 0000000..fb628bc --- /dev/null +++ b/src/contrib/rest/build.xml @@ -0,0 +1,183 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Tests failed! + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/contrib/rest/conf/keys/README b/src/contrib/rest/conf/keys/README new file mode 100644 index 0000000..085810a --- /dev/null +++ b/src/contrib/rest/conf/keys/README @@ -0,0 +1,8 @@ + +In order to generate .jks (java keystore files) you need to use keytool. + +The password for the existing .jks is "123456" (without quotes). + +Some tutorials: + - http://www.mobilefish.com/tutorials/java/java_quickguide_keytool.html + diff --git a/src/contrib/rest/conf/keys/rest.cer b/src/contrib/rest/conf/keys/rest.cer new file mode 100644 index 0000000000000000000000000000000000000000..13e5aabe562f0d0507d3c6709a3a3527ce258f19 GIT binary patch literal 595 zcmXqLV)8d=V%)KSnTe5!iNz;sF0TPE8>d#AN85K^Mn+av27??!0RuiZ=1>+kVfN6x z?7aN)JeUXvh6p=`2p5J3H--o^T*N?5oY&C6z{0@P(9qDt$S_Kr*Vxp+*vK5prL$`q z=Oc#(BP#=QV=se2V<%H%BSYWbGS>f3PJXvm4%r-kd}HQ?l{*@lYdP% zKXaEoN*khNe+YWI`;11mY-+!bZpKk1GMmr3`n#2w6gv+_ab<1?{)@-|1UO&Uzt2^?V`hx> zo~?GG?UC!1EZ6iZIv5CUjxayK`25YYdr9R_ivm4AKHV<1dRh-#_&ZUf9R~ND9?75o t@hPEFdt$!Tolof%M$N1r7$#`FG}+r_l_j^PQl#fZW6;l-MbVp5Spm(9$n*dJ literal 0 HcmV?d00001 diff --git a/src/contrib/rest/conf/keys/rest.jks b/src/contrib/rest/conf/keys/rest.jks new file mode 100644 index 0000000000000000000000000000000000000000..539e8be7ba44e0dc3cb39deb822280a4fbde67af GIT binary patch literal 1363 zcmezO_TO6u1_mY|W&~r_+{*0KN+3_m@oVinpv*3VCZ=r$d~96WY>X_7T1J%57Nhc{i> zJWVv!CM&G;pKJ1F`Eydn8DX>4x8`(zSaIhqXF2aCF+QER+=YLS?SH#k?)!w(4c&fo zKk7Exu6e?c<~~{0x^8-+)!C|#nx4Hzp%*`A+gLFCy?gR@u13_fpKF5B^E}t?QD%LX z5p!;a2&0!zztzrfJQuE4uuNJz`+_ZBGXGRVy~N3x4_sq@ysP*sD<$b(+QLw~VQJf^ zd%r)51}K^S)hT4q6me+0D9Pv@6J+`QNqwBGgq^QW4wu%!!n^-UrdS<5b^R%C&&%0P z4eY^tdmqbnE^cj!_&3>X`nC5{w^9e zOV{?oh78_@+vR1aT0TYTHiXuHXY6O4zsqcjWq|M#uBH@?gkBxv?ea?9mlr9w-cks; z<5yI3Pe;MtdVc*b<0GF$T{e}uME}mUG`jcx%f88*G<9O4!+j;~a@{pL%g+A(@Jsf@ z=Dq*Q*%@A0*#j|HF%N9H1UsSl@e|w@_=G=0DQ{9(pYLv@+i)F7E zot$-blI}ET?>>)`3LA&Fys;T}5$&;VX zoqQ30pgLpU^H+)C8_%s;vC4ev#pda=)_ZVdtqgBtnY6HBD);ulD=Ujc=gm9guO7C` zI#kts=@Fg01SN4H%hnr74-PjUoAOCKvE6O*RIl|H+AnAQ?t&!f2t88+OJG6{1}0>G zgC@ou3z(T0nV497qUQ1%@Un4gwRyCC=LM!}RtAF{Ljhn?XAWgy6J`(1%g)O$&x46@ zV2H3|h;U(uaASxt!$l0_#CZ)33@i*x4Gj%Vj0~g1d5ujCjE&5pTspg^aXxZr05dsr zV=se2V<%H%BSYWbGS>f3PJXvm4%r-kd}HQ?l{*@lYdP%KXaEoN*khN ze+YWI`; z11mY-+!bZpKk1GMmr3`n#2w6gv+_ab<1?{)@-|1UO&Uzt2^?V`hx>o~?GG?UC!1 zEZ6iZIv5CUjxayK`25YYdr9R_ivm4AKHV<1dRh-#_&ZUf9R~ND9?75o@hPEFdt$!T zolof%M$N1r7$#`FG}+r_l_j^PQl#fZW6;l-MbVp5S#Ql>`)8x9kFnIL9nVyf=6eU7 H+RO<6^fNHf literal 0 HcmV?d00001 diff --git a/src/contrib/rest/conf/log4j.properties b/src/contrib/rest/conf/log4j.properties new file mode 100644 index 0000000..21ba7e4 --- /dev/null +++ b/src/contrib/rest/conf/log4j.properties @@ -0,0 +1,68 @@ +# +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +# +# + +# +# ZooKeeper Logging Configuration +# + +# Format is " (, )+ + +# DEFAULT: console appender only +log4j.rootLogger=INFO, CONSOLE + +# Example with rolling log file +#log4j.rootLogger=DEBUG, CONSOLE, ROLLINGFILE + +# Example with rolling log file and tracing +#log4j.rootLogger=TRACE, CONSOLE, ROLLINGFILE, TRACEFILE + +# +# Log INFO level and above messages to the console +# +log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender +log4j.appender.CONSOLE.Threshold=INFO +log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout +log4j.appender.CONSOLE.layout.ConversionPattern=%d{ISO8601} - %-5p - [%t:%C{1}@%L] - %m%n + +# +# Add ROLLINGFILE to rootLogger to get log file output +# Log DEBUG level and above messages to a log file +log4j.appender.ROLLINGFILE=org.apache.log4j.ConsoleAppender +log4j.appender.ROLLINGFILE.Threshold=DEBUG +log4j.appender.ROLLINGFILE.File=bookkeeper.log +log4j.appender.ROLLINGFILE.layout=org.apache.log4j.PatternLayout +log4j.appender.ROLLINGFILE.layout.ConversionPattern=%d{ISO8601} - %-5p - [%t:%C{1}@%L] - %m%n + +# Max log file size of 10MB +log4j.appender.ROLLINGFILE.MaxFileSize=10MB +# uncomment the next line to limit number of backup files +#log4j.appender.ROLLINGFILE.MaxBackupIndex=10 + +# +# Add TRACEFILE to rootLogger to get log file output +# Log DEBUG level and above messages to a log file +log4j.appender.TRACEFILE=org.apache.log4j.FileAppender +log4j.appender.TRACEFILE.Threshold=TRACE +log4j.appender.TRACEFILE.File=bookkeeper_trace.log + +log4j.appender.TRACEFILE.layout=org.apache.log4j.PatternLayout +### Notice we are including log4j's NDC here (%x) +log4j.appender.TRACEFILE.layout.ConversionPattern=%d{ISO8601} - %-5p [%t:%C{1}@%L][%x] - %m%n diff --git a/src/contrib/rest/conf/rest.properties b/src/contrib/rest/conf/rest.properties new file mode 100644 index 0000000..f0abb45 --- /dev/null +++ b/src/contrib/rest/conf/rest.properties @@ -0,0 +1,70 @@ +# +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +# +# + +# +# ZooKeeper REST Gateway Configuration file +# + +rest.port = 9998 + +# +# Endpoint definition +# + +# plain configuration ; +rest.endpoint.1 = /;localhost:2181,localhost:2182 + +# ... or chrooted to /zookeeper +# rest.endpoint.1 = /;localhost:2181,localhost:2182/zookeeper + +# HTTP Basic authentication for this endpoint +# rest.endpoint.1.http.auth = root:root1 + +# create -e /a data digest:'demo:ojnHEyje6F33LLzGVzg+yatf4Fc=':cdrwa +# any session on this endpoint will use authentication +# rest.endpoint.1.zk.digest = demo:test + +# you can easily generate the ACL using Python: +# import sha; sha.sha('demo:test').digest().encode('base64').strip() + +# +# ... you can define as many endpoints as you wish +# + +# rest.endpoint.2 = /restricted;localhost:2181 +# rest.endpoint.2.http.auth = admin:pass + +# rest.endpoint.3 = /cluster1;localhost:2181,localhost:2182 +# ** you should configure one end-point for each ZooKeeper cluster +# etc. + +# Global HTTP Basic Authentication +# You should also enable HTTPS-only access +# The authentication credentials are sent as plain text + +# rest.http.auth = guest:guest1 + +# Uncomment the lines bellow to allow https-only access + +# rest.ssl = true +# rest.ssl.jks = keys/rest.jks +# rest.ssl.jks.pass = 123456 + \ No newline at end of file diff --git a/src/contrib/rest/ivy.xml b/src/contrib/rest/ivy.xml new file mode 100644 index 0000000..903d390 --- /dev/null +++ b/src/contrib/rest/ivy.xml @@ -0,0 +1,48 @@ + + + + + + + + ZooKeeper REST + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/contrib/rest/rest.sh b/src/contrib/rest/rest.sh new file mode 100644 index 0000000..daa8198 --- /dev/null +++ b/src/contrib/rest/rest.sh @@ -0,0 +1,90 @@ +#!/bin/sh + +# Licensed to the Apache Software Foundation (ASF) under one or more +# contributor license agreements. See the NOTICE file distributed with +# this work for additional information regarding copyright ownership. +# The ASF licenses this file to You under the Apache License, Version 2.0 +# (the "License"); you may not use this file except in compliance with +# the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +# +# If this scripted is run out of /usr/bin or some other system bin directory +# it should be linked to and not copied. Things like java jar files are found +# relative to the canonical path of this script. +# + +# Only follow symlinks if readlink supports it +if readlink -f "$0" > /dev/null 2>&1 +then + ZKREST=`readlink -f "$0"` +else + ZKREST="$0" +fi +ZKREST_HOME=`dirname "$ZKREST"` + +if $cygwin +then + # cygwin has a "kill" in the shell itself, gets confused + KILL=/bin/kill +else + KILL=kill +fi + +if [ -z $ZKREST_PIDFILE ] + then ZKREST_PIDFILE=$ZKREST_HOME/server.pid +fi + +ZKREST_MAIN=org.apache.zookeeper.server.jersey.RestMain + +ZKREST_CONF=$ZKREST_HOME/conf +ZKREST_LOG=$ZKREST_HOME/zkrest.log + +CLASSPATH="$ZKREST_CONF:$CLASSPATH" + +for i in "$ZKREST_HOME"/lib/*.jar +do + CLASSPATH="$i:$CLASSPATH" +done + +for i in "$ZKREST_HOME"/zookeeper-*.jar +do + CLASSPATH="$i:$CLASSPATH" +done + +case $1 in +start) + echo "Starting ZooKeeper REST Gateway ... " + java -cp "$CLASSPATH" $JVMFLAGS $ZKREST_MAIN >$ZKREST_LOG 2>&1 & + /bin/echo -n $! > "$ZKREST_PIDFILE" + echo STARTED + ;; +stop) + echo "Stopping ZooKeeper REST Gateway ... " + if [ ! -f "$ZKREST_PIDFILE" ] + then + echo "error: could not find file $ZKREST_PIDFILE" + exit 1 + else + $KILL -9 $(cat "$ZKREST_PIDFILE") + rm "$ZKREST_PIDFILE" + echo STOPPED + fi + ;; +restart) + shift + "$0" stop ${@} + sleep 3 + "$0" start ${@} + ;; +*) + echo "Usage: $0 {start|stop|restart}" >&2 + +esac diff --git a/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/RestMain.java b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/RestMain.java new file mode 100644 index 0000000..954ad04 --- /dev/null +++ b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/RestMain.java @@ -0,0 +1,151 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.zookeeper.server.jersey; + +import java.io.File; +import java.io.IOException; +import java.net.URISyntaxException; +import java.net.URL; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.apache.zookeeper.server.jersey.cfg.Credentials; +import org.apache.zookeeper.server.jersey.cfg.Endpoint; +import org.apache.zookeeper.server.jersey.cfg.RestCfg; +import org.apache.zookeeper.server.jersey.filters.HTTPBasicAuth; + +import com.sun.grizzly.SSLConfig; +import com.sun.grizzly.http.embed.GrizzlyWebServer; +import com.sun.grizzly.http.servlet.ServletAdapter; +import com.sun.jersey.spi.container.servlet.ServletContainer; + +/** + * Demonstration of how to run the REST service using Grizzly + */ +public class RestMain { + + private static Logger LOG = LoggerFactory.getLogger(RestMain.class); + + private GrizzlyWebServer gws; + private RestCfg cfg; + + public RestMain(RestCfg cfg) { + this.cfg = cfg; + } + + public void start() throws IOException { + System.out.println("Starting grizzly ..."); + + boolean useSSL = cfg.useSSL(); + gws = new GrizzlyWebServer(cfg.getPort(), "/tmp/23cxv45345/2131xc2/", useSSL); + // BUG: Grizzly needs a doc root if you are going to register multiple adapters + + for (Endpoint e : cfg.getEndpoints()) { + ZooKeeperService.mapContext(e.getContext(), e); + gws.addGrizzlyAdapter(createJerseyAdapter(e), new String[] { e + .getContext() }); + } + + if (useSSL) { + System.out.println("Starting SSL ..."); + String jks = cfg.getJKS("keys/rest.jks"); + String jksPassword = cfg.getJKSPassword(); + + SSLConfig sslConfig = new SSLConfig(); + URL resource = getClass().getClassLoader().getResource(jks); + if (resource == null) { + LOG.error("Unable to find the keystore file: " + jks); + System.exit(2); + } + try { + sslConfig.setKeyStoreFile(new File(resource.toURI()) + .getAbsolutePath()); + } catch (URISyntaxException e1) { + LOG.error("Unable to load keystore: " + jks, e1); + System.exit(2); + } + sslConfig.setKeyStorePass(jksPassword); + gws.setSSLConfig(sslConfig); + } + + gws.start(); + } + + public void stop() { + gws.stop(); + ZooKeeperService.closeAll(); + } + + private ServletAdapter createJerseyAdapter(Endpoint e) { + ServletAdapter jersey = new ServletAdapter(); + + jersey.setServletInstance(new ServletContainer()); + jersey.addInitParameter("com.sun.jersey.config.property.packages", + "org.apache.zookeeper.server.jersey.resources"); + jersey.setContextPath(e.getContext()); + + Credentials c = Credentials.join(e.getCredentials(), cfg + .getCredentials()); + if (!c.isEmpty()) { + jersey.addFilter(new HTTPBasicAuth(c), e.getContext() + + "-basic-auth", null); + } + + return jersey; + } + + /** + * The entry point for starting the server + * + */ + public static void main(String[] args) throws Exception { + RestCfg cfg = new RestCfg("rest.properties"); + + final RestMain main = new RestMain(cfg); + main.start(); + + Runtime.getRuntime().addShutdownHook(new Thread() { + @Override + public void run() { + main.stop(); + System.out.println("Got exit request. Bye."); + } + }); + + printEndpoints(cfg); + System.out.println("Server started."); + } + + private static void printEndpoints(RestCfg cfg) { + int port = cfg.getPort(); + + for (Endpoint e : cfg.getEndpoints()) { + + String context = e.getContext(); + if (context.charAt(context.length() - 1) != '/') { + context += "/"; + } + + System.out.println(String.format( + "Started %s - WADL: http://localhost:%d%sapplication.wadl", + context, port, context)); + } + } + +} diff --git a/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/ZooKeeperService.java b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/ZooKeeperService.java new file mode 100644 index 0000000..21d27a9 --- /dev/null +++ b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/ZooKeeperService.java @@ -0,0 +1,242 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.zookeeper.server.jersey; + +import java.io.IOException; +import java.util.HashMap; +import java.util.Map; +import java.util.Set; +import java.util.Timer; +import java.util.TimerTask; +import java.util.TreeSet; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.apache.zookeeper.WatchedEvent; +import org.apache.zookeeper.Watcher; +import org.apache.zookeeper.ZooKeeper; +import org.apache.zookeeper.Watcher.Event.KeeperState; +import org.apache.zookeeper.server.jersey.cfg.Endpoint; + +/** + * Singleton which provides JAX-RS resources access to the ZooKeeper client. + * There's a single session for each base uri (so usually just one). + */ +public class ZooKeeperService { + + private static Logger LOG = LoggerFactory.getLogger(ZooKeeperService.class); + + /** Map base uri to ZooKeeper host:port parameters */ + private static Map contextMap = new HashMap(); + + /** Map base uri to ZooKeeper session */ + private static Map zkMap = new HashMap(); + + /** Session timers */ + private static Map zkSessionTimers = new HashMap(); + private static Timer timer = new Timer(); + + /** Track the status of the ZooKeeper session */ + private static class MyWatcher implements Watcher { + final String contextPath; + + /** Separate watcher for each base uri */ + public MyWatcher(String contextPath) { + this.contextPath = contextPath; + } + + /** + * Track state - in particular watch for expiration. if it happens for + * re-creation of the ZK client session + */ + synchronized public void process(WatchedEvent event) { + if (event.getState() == KeeperState.Expired) { + close(contextPath); + } + } + } + + /** ZooKeeper session timer */ + private static class SessionTimerTask extends TimerTask { + + private int delay; + private String contextPath, session; + private Timer timer; + + public SessionTimerTask(int delayInSeconds, String session, + String contextPath, Timer timer) { + delay = delayInSeconds * 1000; // convert to milliseconds + this.contextPath = contextPath; + this.session = session; + this.timer = timer; + reset(); + } + + public SessionTimerTask(SessionTimerTask t) { + this(t.delay / 1000, t.session, t.contextPath, t.timer); + } + + @Override + public void run() { + if (LOG.isInfoEnabled()) { + LOG.info(String.format("Session '%s' expired after " + + "'%d' milliseconds.", session, delay)); + } + ZooKeeperService.close(contextPath, session); + } + + public void reset() { + timer.schedule(this, delay); + } + + } + + /** + * Specify ZooKeeper host:port for a particular context path. The host:port + * string is passed to the ZK client, so this can be formatted with more + * than a single host:port pair. + */ + synchronized public static void mapContext(String contextPath, Endpoint e) { + contextMap.put(contextPath, e); + } + + /** + * Reset timer for a session + */ + synchronized public static void resetTimer(String contextPath, + String session) { + if (session != null) { + String uri = concat(contextPath, session); + + SessionTimerTask t = zkSessionTimers.remove(uri); + t.cancel(); + + zkSessionTimers.put(uri, new SessionTimerTask(t)); + } + } + + /** + * Close the ZooKeeper session and remove it from the internal maps + */ + public static void close(String contextPath) { + close(contextPath, null); + } + + /** + * Close the ZooKeeper session and remove it + */ + synchronized public static void close(String contextPath, String session) { + String uri = concat(contextPath, session); + + TimerTask t = zkSessionTimers.remove(uri); + if (t != null) { + t.cancel(); + } + + ZooKeeper zk = zkMap.remove(uri); + if (zk == null) { + return; + } + try { + zk.close(); + } catch (InterruptedException e) { + LOG.error("Interrupted while closing ZooKeeper connection.", e); + } + } + + /** + * Close all the ZooKeeper sessions and remove them from the internal maps + */ + synchronized public static void closeAll() { + Set sessions = new TreeSet(zkMap.keySet()); + for (String key : sessions) { + close(key); + } + } + + /** + * Is there an active connection for this session? + */ + synchronized public static boolean isConnected(String contextPath, + String session) { + return zkMap.containsKey(concat(contextPath, session)); + } + + /** + * Return a ZooKeeper client not tied to a specific session. + */ + public static ZooKeeper getClient(String contextPath) throws IOException { + return getClient(contextPath, null); + } + + /** + * Return a ZooKeeper client for a session with a default expire time + * + * @throws IOException + */ + public static ZooKeeper getClient(String contextPath, String session) + throws IOException { + return getClient(contextPath, session, 5); + } + + /** + * Return a ZooKeeper client which may or may not be connected, but it will + * not be expired. This method can be called multiple times, the same object + * will be returned except in the case where the session expires (at which + * point a new session will be returned) + */ + synchronized public static ZooKeeper getClient(String contextPath, + String session, int expireTime) throws IOException { + final String connectionId = concat(contextPath, session); + + ZooKeeper zk = zkMap.get(connectionId); + if (zk == null) { + + if (LOG.isInfoEnabled()) { + LOG.info(String.format("creating new " + + "connection for : '%s'", connectionId)); + } + Endpoint e = contextMap.get(contextPath); + zk = new ZooKeeper(e.getHostPort(), 30000, new MyWatcher( + connectionId)); + + for (Map.Entry p : e.getZooKeeperAuthInfo().entrySet()) { + zk.addAuthInfo("digest", String.format("%s:%s", p.getKey(), + p.getValue()).getBytes()); + } + + zkMap.put(connectionId, zk); + + // a session should automatically expire after an amount of time + if (session != null) { + zkSessionTimers.put(connectionId, new SessionTimerTask( + expireTime, session, contextPath, timer)); + } + } + return zk; + } + + private static String concat(String contextPath, String session) { + if (session != null) { + return String.format("%s@%s", contextPath, session); + } + return contextPath; + } + +} diff --git a/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/cfg/Credentials.java b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/cfg/Credentials.java new file mode 100644 index 0000000..0730be5 --- /dev/null +++ b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/cfg/Credentials.java @@ -0,0 +1,47 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.zookeeper.server.jersey.cfg; + +import java.util.HashMap; + +public class Credentials extends HashMap { + + public static Credentials join(Credentials a, Credentials b) { + Credentials result = new Credentials(); + result.putAll(a); + result.putAll(b); + return result; + } + + public Credentials() { + super(); + } + + public Credentials(String credentials) { + super(); + + if (!credentials.trim().equals("")) { + String[] parts = credentials.split(","); + for(String p : parts) { + String[] userPass = p.split(":"); + put(userPass[0], userPass[1]); + } + } + } +} diff --git a/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/cfg/Endpoint.java b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/cfg/Endpoint.java new file mode 100644 index 0000000..2a62782 --- /dev/null +++ b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/cfg/Endpoint.java @@ -0,0 +1,72 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.zookeeper.server.jersey.cfg; + +public class Endpoint { + + private String context; + private HostPortSet hostPort; + private Credentials credentials; + private Credentials zookeeperAuth; + + public Endpoint(String context, String hostPortList) { + this.context = context; + this.hostPort = new HostPortSet(hostPortList); + } + + public String getContext() { + return context; + } + + public String getHostPort() { + return hostPort.toString(); + } + + public Credentials getCredentials() { + return credentials; + } + + public void setCredentials(String c) { + this.credentials = new Credentials(c); + } + + public void setZooKeeperAuthInfo(String digest) { + zookeeperAuth = new Credentials(digest); + } + + public final Credentials getZooKeeperAuthInfo() { + return zookeeperAuth; + } + + @Override + public boolean equals(Object o) { + Endpoint e = (Endpoint) o; + return context.equals(e.context); + } + + @Override + public int hashCode() { + return context.hashCode(); + } + + @Override + public String toString() { + return String.format("", context, hostPort.toString()); + } +} diff --git a/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/cfg/HostPort.java b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/cfg/HostPort.java new file mode 100644 index 0000000..51a1bdd --- /dev/null +++ b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/cfg/HostPort.java @@ -0,0 +1,51 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.zookeeper.server.jersey.cfg; + +public class HostPort { + + private String host; + private int port; + + public HostPort(String hostPort) { + String[] parts = hostPort.split(":"); + host = parts[0]; + port = Integer.parseInt(parts[1]); + } + + public String getHost() { + return host; + } + + public int getPort() { + return port; + } + + @Override + public boolean equals(Object o) { + HostPort p = (HostPort) o; + return host.equals(p.host) && port == p.port; + } + + @Override + public int hashCode() { + return String.format("%s:%d", host, port).hashCode(); + } + +} diff --git a/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/cfg/HostPortSet.java b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/cfg/HostPortSet.java new file mode 100644 index 0000000..301a565 --- /dev/null +++ b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/cfg/HostPortSet.java @@ -0,0 +1,51 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.zookeeper.server.jersey.cfg; + +import java.util.HashSet; +import java.util.Set; + +public class HostPortSet { + + private Set hostPortSet = new HashSet(); + private String original; + + public HostPortSet(String hostPortList) { + original = hostPortList; + + int chrootStart = hostPortList.indexOf('/'); + String hostPortPairs; + if (chrootStart != -1) { + hostPortPairs = hostPortList.substring(0, chrootStart); + } else { + hostPortPairs = hostPortList; + } + + String[] parts = hostPortPairs.split(","); + for(String p : parts) { + hostPortSet.add(new HostPort(p)); + } + } + + @Override + public String toString() { + return original; + } + +} diff --git a/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/cfg/RestCfg.java b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/cfg/RestCfg.java new file mode 100644 index 0000000..93dd632 --- /dev/null +++ b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/cfg/RestCfg.java @@ -0,0 +1,110 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.zookeeper.server.jersey.cfg; + +import java.io.IOException; +import java.io.InputStream; +import java.util.HashSet; +import java.util.Properties; +import java.util.Set; + +public class RestCfg { + + private Properties cfg = new Properties(); + + private Set endpoints = new HashSet(); + private Credentials credentials = new Credentials(); + + public RestCfg(String resource) throws IOException { + this(RestCfg.class.getClassLoader().getResourceAsStream(resource)); + } + + public RestCfg(InputStream io) throws IOException { + try { + cfg.load(io); + extractEndpoints(); + extractCredentials(); + } finally { + io.close(); + } + } + + private void extractCredentials() { + if (cfg.containsKey("rest.http.auth")) { + credentials = new Credentials(cfg.getProperty("rest.http.auth", "")); + } + } + + private void extractEndpoints() { + int count = 1; + while (true) { + String e = cfg.getProperty( + String.format("rest.endpoint.%d", count), null); + if (e == null) { + break; + } + + String[] parts = e.split(";"); + if (parts.length != 2) { + count++; + continue; + } + Endpoint point = new Endpoint(parts[0], parts[1]); + + String c = cfg.getProperty(String.format( + "rest.endpoint.%d.http.auth", count), ""); + point.setCredentials(c); + + String digest = cfg.getProperty(String.format( + "rest.endpoint.%d.zk.digest", count), ""); + point.setZooKeeperAuthInfo(digest); + + endpoints.add(point); + count++; + } + } + + public int getPort() { + return Integer.parseInt(cfg.getProperty("rest.port", "9998")); + } + + public boolean useSSL() { + return Boolean.valueOf(cfg.getProperty("rest.ssl", "false")); + } + + public final Set getEndpoints() { + return endpoints; + } + + public final Credentials getCredentials() { + return credentials; + } + + public String getJKS() { + return cfg.getProperty("rest.ssl.jks"); + } + + public String getJKS(String def) { + return cfg.getProperty("rest.ssl.jks", def); + } + + public String getJKSPassword() { + return cfg.getProperty("rest.ssl.jks.pass"); + } +} diff --git a/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/filters/HTTPBasicAuth.java b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/filters/HTTPBasicAuth.java new file mode 100644 index 0000000..49640b5 --- /dev/null +++ b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/filters/HTTPBasicAuth.java @@ -0,0 +1,87 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.zookeeper.server.jersey.filters; + +import java.io.IOException; + +import javax.servlet.Filter; +import javax.servlet.FilterChain; +import javax.servlet.FilterConfig; +import javax.servlet.ServletException; +import javax.servlet.ServletRequest; +import javax.servlet.ServletResponse; +import javax.servlet.http.HttpServletRequest; +import javax.servlet.http.HttpServletResponse; + +import org.apache.zookeeper.server.jersey.cfg.Credentials; + +import com.sun.jersey.core.util.Base64; + +public class HTTPBasicAuth implements Filter { + + private Credentials credentials; + + public HTTPBasicAuth(Credentials c) { + credentials = c; + } + + @Override + public void doFilter(ServletRequest req0, ServletResponse resp0, + FilterChain chain) throws IOException, ServletException { + + HttpServletRequest request = (HttpServletRequest) req0; + HttpServletResponse response = (HttpServletResponse) resp0; + + String authorization = request.getHeader("Authorization"); + if (authorization != null) { + String c[] = parseAuthorization(authorization); + if (c != null && credentials.containsKey(c[0]) + && credentials.get(c[0]).equals(c[1])) { + chain.doFilter(request, response); + return; + } + } + + response.setHeader("WWW-Authenticate", "Basic realm=\"Restricted\""); + response.sendError(401); + } + + private String[] parseAuthorization(String authorization) { + String parts[] = authorization.split(" "); + if (parts.length == 2 && parts[0].equalsIgnoreCase("Basic")) { + String userPass = Base64.base64Decode(parts[1]); + + int p = userPass.indexOf(":"); + if (p != -1) { + return new String[] { userPass.substring(0, p), + userPass.substring(p + 1) }; + } + } + return null; + } + + @Override + public void init(FilterConfig arg0) throws ServletException { + } + + @Override + public void destroy() { + } + +} diff --git a/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/jaxb/ZChildren.java b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/jaxb/ZChildren.java new file mode 100644 index 0000000..b3fad55 --- /dev/null +++ b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/jaxb/ZChildren.java @@ -0,0 +1,80 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.zookeeper.server.jersey.jaxb; + +import java.util.ArrayList; +import java.util.List; + +import javax.xml.bind.annotation.XmlElement; +import javax.xml.bind.annotation.XmlElementWrapper; +import javax.xml.bind.annotation.XmlRootElement; + + +/** + * Represents the CHILD using JAXB. + * Special JSON version is required to get proper formatting in both + * JSON and XML output. See details in ZNodeResource. + */ +@XmlRootElement(name="child") +public class ZChildren { + public String path; + public String uri; + + public String child_uri_template; + @XmlElementWrapper(name="children") + @XmlElement(name="child") + public List children; + + public ZChildren() { + // needed by jersey + children = new ArrayList(); + } + + public ZChildren(String path, String uri, String child_uri_template, + List children) + { + this.path = path; + this.uri = uri; + this.child_uri_template = child_uri_template; + if (children != null) { + this.children = children; + } else { + this.children = new ArrayList(); + } + } + + @Override + public int hashCode() { + return path.hashCode(); + } + + @Override + public boolean equals(Object obj) { + if (!(obj instanceof ZChildren)) { + return false; + } + ZChildren o = (ZChildren) obj; + return path.equals(o.path) && children.equals(o.children); + } + + @Override + public String toString() { + return "ZChildren(" + path + "," + children + ")"; + } +} diff --git a/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/jaxb/ZChildrenJSON.java b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/jaxb/ZChildrenJSON.java new file mode 100644 index 0000000..0dcece0 --- /dev/null +++ b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/jaxb/ZChildrenJSON.java @@ -0,0 +1,76 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.zookeeper.server.jersey.jaxb; + +import java.util.ArrayList; +import java.util.List; + +import javax.xml.bind.annotation.XmlRootElement; + + +/** + * Represents the CHILD using JAXB. + * Special JSON version is required to get proper formatting in both + * JSON and XML output. See details in ZNodeResource. + */ +@XmlRootElement(name="child") +public class ZChildrenJSON { + public String path; + public String uri; + + public String child_uri_template; + public List children; + + public ZChildrenJSON() { + // needed by jersey + children = new ArrayList(); + } + + public ZChildrenJSON(String path, String uri, String child_uri_template, + List children) + { + this.path = path; + this.uri = uri; + this.child_uri_template = child_uri_template; + if (children != null) { + this.children = children; + } else { + this.children = new ArrayList(); + } + } + + @Override + public int hashCode() { + return path.hashCode(); + } + + @Override + public boolean equals(Object obj) { + if (!(obj instanceof ZChildrenJSON)) { + return false; + } + ZChildrenJSON o = (ZChildrenJSON) obj; + return path.equals(o.path) && children.equals(o.children); + } + + @Override + public String toString() { + return "ZChildrenJSON(" + path + "," + children + ")"; + } +} diff --git a/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/jaxb/ZError.java b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/jaxb/ZError.java new file mode 100644 index 0000000..e976ee0 --- /dev/null +++ b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/jaxb/ZError.java @@ -0,0 +1,41 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.zookeeper.server.jersey.jaxb; + +import javax.xml.bind.annotation.XmlRootElement; + + +/** + * Represents an ERROR using JAXB. + */ +@XmlRootElement(name="error") +public class ZError { + public String request; + public String message; + + public ZError(){ + // needed by jersey + } + + public ZError(String request, String message) { + this.request = request; + this.message = message; + } + +} diff --git a/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/jaxb/ZPath.java b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/jaxb/ZPath.java new file mode 100644 index 0000000..4d83717 --- /dev/null +++ b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/jaxb/ZPath.java @@ -0,0 +1,63 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.zookeeper.server.jersey.jaxb; + +import javax.xml.bind.annotation.XmlRootElement; + + +/** + * Represents a PATH using JAXB. + */ +@XmlRootElement(name="path") +public class ZPath { + public String path; + public String uri; + + public ZPath(){ + // needed by jersey + } + + public ZPath(String path) { + this(path, null); + } + + public ZPath(String path, String uri) { + this.path = path; + this.uri = uri; + } + + @Override + public int hashCode() { + return path.hashCode(); + } + + @Override + public boolean equals(Object obj) { + if (!(obj instanceof ZPath)) { + return false; + } + ZPath o = (ZPath) obj; + return path.equals(o.path); + } + + @Override + public String toString() { + return "ZPath(" + path + ")"; + } +} diff --git a/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/jaxb/ZSession.java b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/jaxb/ZSession.java new file mode 100644 index 0000000..06ca9e5 --- /dev/null +++ b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/jaxb/ZSession.java @@ -0,0 +1,55 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.zookeeper.server.jersey.jaxb; + +import javax.xml.bind.annotation.XmlRootElement; + +@XmlRootElement(name="session") +public class ZSession { + public String id; + public String uri; + + public ZSession() { + // needed by jersey + } + + public ZSession(String id, String uri) { + this.id = id; + this.uri = uri; + } + + @Override + public int hashCode() { + return id.hashCode(); + } + + @Override + public boolean equals(Object obj) { + if(!(obj instanceof ZSession)) { + return false; + } + ZSession s = (ZSession) obj; + return id.equals(s.id); + } + + @Override + public String toString() { + return "ZSession(" + id +")"; + } +} diff --git a/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/jaxb/ZStat.java b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/jaxb/ZStat.java new file mode 100644 index 0000000..af70d18 --- /dev/null +++ b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/jaxb/ZStat.java @@ -0,0 +1,106 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.zookeeper.server.jersey.jaxb; + +import javax.xml.bind.annotation.XmlRootElement; + + +/** + * Represents a STAT using JAXB. + */ +@XmlRootElement(name="stat") +public class ZStat { + public String path; + public String uri; + public byte[] data64; + public String dataUtf8; + + public long czxid; + public long mzxid; + public long ctime; + public long mtime; + public int version; + public int cversion; + public int aversion; + public long ephemeralOwner; + public int dataLength; + public int numChildren; + public long pzxid; + + + public ZStat(){ + // needed by jersey + } + + public ZStat(String path, byte[] data64, String dataUtf8) + { + this.path = path; + this.data64 = data64; + this.dataUtf8 = dataUtf8; + } + + public ZStat(String path, String uri, byte[] data64, String dataUtf8, + long czxid, long mzxid, long ctime, long mtime, int version, + int cversion, int aversion, long ephemeralOwner, int dataLength, + int numChildren, long pzxid) + { + this.path = path; + this.uri = uri; + this.data64 = data64; + this.dataUtf8 = dataUtf8; + + this.czxid = czxid; + this.mzxid = mzxid; + this.ctime = ctime; + this.mtime = mtime; + this.version = version; + this.cversion = cversion; + this.aversion = aversion; + this.ephemeralOwner = ephemeralOwner; + this.dataLength = dataLength; + this.numChildren = numChildren; + this.pzxid = pzxid; + } + + @Override + public int hashCode() { + return path.hashCode(); + } + + /** + * This method considers two ZStats equal if their path, encoding, and + * data match. It does not compare the ZooKeeper + * org.apache.zookeeper.data.Stat class fields. + */ + @Override + public boolean equals(Object obj) { + if (!(obj instanceof ZStat)) { + return false; + } + ZStat o = (ZStat) obj; + return toString().equals(o.toString()); + } + + @Override + public String toString() { + return "ZStat(" + path + "," + "b64[" + + (data64 == null ? null : new String(data64)) + "]," + + dataUtf8 + ")"; + } +} diff --git a/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/resources/JAXBContextResolver.java b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/resources/JAXBContextResolver.java new file mode 100644 index 0000000..0893586 --- /dev/null +++ b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/resources/JAXBContextResolver.java @@ -0,0 +1,72 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.zookeeper.server.jersey.resources; + +import java.util.Arrays; +import java.util.HashSet; +import java.util.Set; + +import javax.ws.rs.ext.ContextResolver; +import javax.ws.rs.ext.Provider; +import javax.xml.bind.JAXBContext; + +import org.apache.zookeeper.server.jersey.jaxb.ZChildrenJSON; +import org.apache.zookeeper.server.jersey.jaxb.ZPath; +import org.apache.zookeeper.server.jersey.jaxb.ZStat; + +import com.sun.jersey.api.json.JSONConfiguration; +import com.sun.jersey.api.json.JSONJAXBContext; + +/** + * Tell Jersey how to resolve JSON formatting. Specifically detail the + * fields which are arrays and which are numbers (not strings). + */ +@Provider +@SuppressWarnings("unchecked") +public final class JAXBContextResolver implements ContextResolver { + private final JAXBContext context; + + private final Set typesSet; + + public JAXBContextResolver() throws Exception { + Class[] typesArr = + new Class[]{ZPath.class, ZStat.class, ZChildrenJSON.class}; + typesSet = new HashSet(Arrays.asList(typesArr)); + context = new JSONJAXBContext( + JSONConfiguration.mapped() + .arrays("children") + .nonStrings("czxid") + .nonStrings("mzxid") + .nonStrings("ctime") + .nonStrings("mtime") + .nonStrings("version") + .nonStrings("cversion") + .nonStrings("aversion") + .nonStrings("ephemeralOwner") + .nonStrings("dataLength") + .nonStrings("numChildren") + .nonStrings("pzxid") + .build(), + typesArr); + } + + public JAXBContext getContext(Class objectType) { + return (typesSet.contains(objectType)) ? context : null; + } +} diff --git a/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/resources/KeeperExceptionMapper.java b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/resources/KeeperExceptionMapper.java new file mode 100644 index 0000000..fdfc27b --- /dev/null +++ b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/resources/KeeperExceptionMapper.java @@ -0,0 +1,86 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.zookeeper.server.jersey.resources; + +import javax.ws.rs.core.Context; +import javax.ws.rs.core.Response; +import javax.ws.rs.core.UriInfo; +import javax.ws.rs.ext.ExceptionMapper; +import javax.ws.rs.ext.Provider; + +import org.apache.zookeeper.KeeperException; +import org.apache.zookeeper.server.jersey.jaxb.ZError; + + +/** + * Map KeeperException to HTTP status codes + */ +@Provider +public class KeeperExceptionMapper implements ExceptionMapper { + private UriInfo ui; + + public KeeperExceptionMapper(@Context UriInfo ui) { + this.ui = ui; + } + + public Response toResponse(KeeperException e) { + Response.Status status; + String message; + + String path = e.getPath(); + + switch(e.code()) { + case AUTHFAILED: + status = Response.Status.UNAUTHORIZED; + message = path + " not authorized"; + break; + case BADARGUMENTS: + status = Response.Status.BAD_REQUEST; + message = path + " bad arguments"; + break; + case BADVERSION: + status = Response.Status.PRECONDITION_FAILED; + message = path + " bad version"; + break; + case INVALIDACL: + status = Response.Status.BAD_REQUEST; + message = path + " invalid acl"; + break; + case NODEEXISTS: + status = Response.Status.CONFLICT; + message = path + " already exists"; + break; + case NONODE: + status = Response.Status.NOT_FOUND; + message = path + " not found"; + break; + case NOTEMPTY: + status = Response.Status.CONFLICT; + message = path + " not empty"; + break; + default: + status = Response.Status.fromStatusCode(502); // bad gateway + message = "Error processing request for " + path + + " : " + e.getMessage(); + } + + return Response.status(status).entity( + new ZError(ui.getRequestUri().toString(), message)).build(); + } +} diff --git a/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/resources/RuntimeExceptionMapper.java b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/resources/RuntimeExceptionMapper.java new file mode 100644 index 0000000..46f33bb --- /dev/null +++ b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/resources/RuntimeExceptionMapper.java @@ -0,0 +1,55 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.zookeeper.server.jersey.resources; + +import javax.ws.rs.WebApplicationException; +import javax.ws.rs.core.Context; +import javax.ws.rs.core.Response; +import javax.ws.rs.core.UriInfo; +import javax.ws.rs.ext.ExceptionMapper; +import javax.ws.rs.ext.Provider; + +import org.apache.zookeeper.server.jersey.jaxb.ZError; + +/** + * Map RuntimeException to HTTP status codes + */ +@Provider +public class RuntimeExceptionMapper + implements ExceptionMapper +{ + private UriInfo ui; + + public RuntimeExceptionMapper(@Context UriInfo ui) { + this.ui = ui; + } + + public Response toResponse(RuntimeException e) { + // don't try to handle jersey exceptions ourselves + if (e instanceof WebApplicationException) { + WebApplicationException ie =(WebApplicationException) e; + return ie.getResponse(); + } + + return Response.status(Response.Status.INTERNAL_SERVER_ERROR).entity( + new ZError(ui.getRequestUri().toString(), + "Error processing request due to " + e + )).build(); + } +} diff --git a/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/resources/SessionsResource.java b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/resources/SessionsResource.java new file mode 100644 index 0000000..0744604 --- /dev/null +++ b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/resources/SessionsResource.java @@ -0,0 +1,135 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.zookeeper.server.jersey.resources; + +import java.io.IOException; +import java.net.URI; +import java.util.UUID; + +import javax.servlet.http.HttpServletRequest; +import javax.ws.rs.Consumes; +import javax.ws.rs.DELETE; +import javax.ws.rs.DefaultValue; +import javax.ws.rs.POST; +import javax.ws.rs.PUT; +import javax.ws.rs.Path; +import javax.ws.rs.PathParam; +import javax.ws.rs.Produces; +import javax.ws.rs.QueryParam; +import javax.ws.rs.WebApplicationException; +import javax.ws.rs.core.Context; +import javax.ws.rs.core.MediaType; +import javax.ws.rs.core.Response; +import javax.ws.rs.core.UriInfo; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.apache.zookeeper.server.jersey.ZooKeeperService; +import org.apache.zookeeper.server.jersey.jaxb.ZError; +import org.apache.zookeeper.server.jersey.jaxb.ZSession; + +import com.sun.jersey.api.json.JSONWithPadding; + +@Path("sessions/v1/{session: .*}") +public class SessionsResource { + + private static Logger LOG = LoggerFactory.getLogger(SessionsResource.class); + + private String contextPath; + + public SessionsResource(@Context HttpServletRequest request) { + contextPath = request.getContextPath(); + if (contextPath.equals("")) { + contextPath = "/"; + } + } + + @PUT + @Produces( { MediaType.APPLICATION_JSON, "application/javascript", + MediaType.APPLICATION_XML }) + @Consumes(MediaType.APPLICATION_OCTET_STREAM) + public Response keepAliveSession(@PathParam("session") String session, + @Context UriInfo ui, byte[] data) { + + if (!ZooKeeperService.isConnected(contextPath, session)) { + throwNotFound(session, ui); + } + + ZooKeeperService.resetTimer(contextPath, session); + return Response.status(Response.Status.OK).build(); + } + + @POST + @Produces( { MediaType.APPLICATION_JSON, "application/javascript", + MediaType.APPLICATION_XML }) + public Response createSession(@QueryParam("op") String op, + @DefaultValue("5") @QueryParam("expire") String expire, + @Context UriInfo ui) { + if (!op.equals("create")) { + throw new WebApplicationException(Response.status( + Response.Status.BAD_REQUEST).entity( + new ZError(ui.getRequestUri().toString(), "")).build()); + } + + int expireInSeconds; + try { + expireInSeconds = Integer.parseInt(expire); + } catch (NumberFormatException e) { + throw new WebApplicationException(Response.status( + Response.Status.BAD_REQUEST).build()); + } + + String uuid = UUID.randomUUID().toString(); + while (ZooKeeperService.isConnected(contextPath, uuid)) { + uuid = UUID.randomUUID().toString(); + } + + // establish the connection to the ZooKeeper cluster + try { + ZooKeeperService.getClient(contextPath, uuid, expireInSeconds); + } catch (IOException e) { + LOG.error("Failed while trying to create a new session", e); + + throw new WebApplicationException(Response.status( + Response.Status.INTERNAL_SERVER_ERROR).build()); + } + + URI uri = ui.getAbsolutePathBuilder().path(uuid).build(); + return Response.created(uri).entity( + new JSONWithPadding(new ZSession(uuid, uri.toString()))) + .build(); + } + + @DELETE + @Produces( { MediaType.APPLICATION_JSON, "application/javascript", + MediaType.APPLICATION_XML, MediaType.APPLICATION_OCTET_STREAM }) + public void deleteSession(@PathParam("session") String session, + @Context UriInfo ui) { + ZooKeeperService.close(contextPath, session); + } + + private static void throwNotFound(String session, UriInfo ui) + throws WebApplicationException { + throw new WebApplicationException(Response.status( + Response.Status.NOT_FOUND).entity( + new ZError(ui.getRequestUri().toString(), session + + " not found")).build()); + } + +} diff --git a/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/resources/ZErrorWriter.java b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/resources/ZErrorWriter.java new file mode 100644 index 0000000..706ab89 --- /dev/null +++ b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/resources/ZErrorWriter.java @@ -0,0 +1,63 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.zookeeper.server.jersey.resources; + +import java.io.IOException; +import java.io.OutputStream; +import java.io.PrintStream; +import java.lang.annotation.Annotation; +import java.lang.reflect.Type; + +import javax.ws.rs.Produces; +import javax.ws.rs.WebApplicationException; +import javax.ws.rs.core.MediaType; +import javax.ws.rs.core.MultivaluedMap; +import javax.ws.rs.ext.MessageBodyWriter; +import javax.ws.rs.ext.Provider; + +import org.apache.zookeeper.server.jersey.jaxb.ZError; + +/** + * Tell Jersey how to format an octet response error message. + */ +@Produces(MediaType.APPLICATION_OCTET_STREAM) +@Provider +public class ZErrorWriter implements MessageBodyWriter { + + public long getSize(ZError t, Class type, Type genericType, + Annotation[] annotations, MediaType mediaType) { + return -1; + } + + public boolean isWriteable(Class type, Type genericType, + Annotation[] annotations, MediaType mediaType) { + return ZError.class.isAssignableFrom(type); + } + + public void writeTo(ZError t, Class type, Type genericType, + Annotation[] annotations, MediaType mediaType, + MultivaluedMap httpHeaders, + OutputStream os) + throws IOException, WebApplicationException + { + PrintStream p = new PrintStream(os); + p.print("Request " + t.request + " failed due to " + t.message); + p.flush(); + } +} diff --git a/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/resources/ZNodeResource.java b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/resources/ZNodeResource.java new file mode 100644 index 0000000..77371ea --- /dev/null +++ b/src/contrib/rest/src/java/org/apache/zookeeper/server/jersey/resources/ZNodeResource.java @@ -0,0 +1,412 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.zookeeper.server.jersey.resources; + +import java.io.IOException; +import java.net.URI; +import java.util.ArrayList; +import java.util.List; + +import javax.servlet.http.HttpServletRequest; +import javax.ws.rs.Consumes; +import javax.ws.rs.DELETE; +import javax.ws.rs.DefaultValue; +import javax.ws.rs.GET; +import javax.ws.rs.HEAD; +import javax.ws.rs.POST; +import javax.ws.rs.PUT; +import javax.ws.rs.Path; +import javax.ws.rs.PathParam; +import javax.ws.rs.Produces; +import javax.ws.rs.QueryParam; +import javax.ws.rs.WebApplicationException; +import javax.ws.rs.core.Context; +import javax.ws.rs.core.MediaType; +import javax.ws.rs.core.Response; +import javax.ws.rs.core.UriInfo; + +import org.apache.zookeeper.CreateMode; +import org.apache.zookeeper.KeeperException; +import org.apache.zookeeper.ZooKeeper; +import org.apache.zookeeper.ZooDefs.Ids; +import org.apache.zookeeper.data.Stat; +import org.apache.zookeeper.server.jersey.ZooKeeperService; +import org.apache.zookeeper.server.jersey.jaxb.ZChildren; +import org.apache.zookeeper.server.jersey.jaxb.ZChildrenJSON; +import org.apache.zookeeper.server.jersey.jaxb.ZError; +import org.apache.zookeeper.server.jersey.jaxb.ZPath; +import org.apache.zookeeper.server.jersey.jaxb.ZStat; + +import com.sun.jersey.api.json.JSONWithPadding; + +/** + * Version 1 implementation of the ZooKeeper REST specification. + */ +// TODO test octet fully +@Path("znodes/v1{path: /.*}") +public class ZNodeResource { + private final ZooKeeper zk; + + public ZNodeResource(@DefaultValue("") @QueryParam("session") String session, + @Context UriInfo ui, + @Context HttpServletRequest request + ) + throws IOException { + + String contextPath = request.getContextPath(); + if (contextPath.equals("")) { + contextPath = "/"; + } + if (session.equals("")) { + session = null; + } else if (!ZooKeeperService.isConnected(contextPath, session)) { + throw new WebApplicationException(Response.status( + Response.Status.UNAUTHORIZED).build()); + } + zk = ZooKeeperService.getClient(contextPath, session); + } + + private void ensurePathNotNull(String path) { + if (path == null) { + throw new IllegalArgumentException("Invalid path \"" + path + "\""); + } + } + + @HEAD + @Produces( { MediaType.APPLICATION_JSON, "application/javascript", + MediaType.APPLICATION_XML }) + public Response existsZNode(@PathParam("path") String path, + @Context UriInfo ui) throws InterruptedException, KeeperException { + Stat stat = zk.exists(path, false); + if (stat == null) { + throwNotFound(path, ui); + } + return Response.status(Response.Status.OK).build(); + } + + @HEAD + @Produces( { MediaType.APPLICATION_OCTET_STREAM }) + public Response existsZNodeAsOctet(@PathParam("path") String path, + @Context UriInfo ui) throws InterruptedException, KeeperException { + Stat stat = zk.exists(path, false); + if (stat == null) { + throwNotFound(path, ui); + } + return Response.status(Response.Status.NO_CONTENT).build(); + } + + /* + * getZNodeList and getZNodeListJSON are bogus - but necessary. + * Unfortunately Jersey 1.0.3 is unable to render both xml and json properly + * in the case where a object contains a list/array. It's impossible to get + * it to render properly for both. As a result we need to split into two + * jaxb classes. + */ + + @GET + @Produces( { MediaType.APPLICATION_JSON, "application/javascript" }) + public Response getZNodeListJSON( + @PathParam("path") String path, + @QueryParam("callback") String callback, + @DefaultValue("data") @QueryParam("view") String view, + @DefaultValue("base64") @QueryParam("dataformat") String dataformat, + @Context UriInfo ui) throws InterruptedException, KeeperException { + return getZNodeList(true, path, callback, view, dataformat, ui); + } + + @GET + @Produces(MediaType.APPLICATION_XML) + public Response getZNodeList( + @PathParam("path") String path, + @QueryParam("callback") String callback, + @DefaultValue("data") @QueryParam("view") String view, + @DefaultValue("base64") @QueryParam("dataformat") String dataformat, + @Context UriInfo ui) throws InterruptedException, KeeperException { + return getZNodeList(false, path, callback, view, dataformat, ui); + } + + private Response getZNodeList(boolean json, String path, String callback, + String view, String dataformat, UriInfo ui) + throws InterruptedException, KeeperException { + ensurePathNotNull(path); + + if (view.equals("children")) { + List children = new ArrayList(); + for (String child : zk.getChildren(path, false)) { + children.add(child); + } + + Object child; + String childTemplate = ui.getAbsolutePath().toString(); + if (!childTemplate.endsWith("/")) { + childTemplate += "/"; + } + childTemplate += "{child}"; + if (json) { + child = new ZChildrenJSON(path, + ui.getAbsolutePath().toString(), childTemplate, + children); + } else { + child = new ZChildren(path, ui.getAbsolutePath().toString(), + childTemplate, children); + } + return Response.status(Response.Status.OK).entity( + new JSONWithPadding(child, callback)).build(); + } else { + Stat stat = new Stat(); + byte[] data = zk.getData(path, false, stat); + + byte[] data64; + String dataUtf8; + if (data == null) { + data64 = null; + dataUtf8 = null; + } else if (!dataformat.equals("utf8")) { + data64 = data; + dataUtf8 = null; + } else { + data64 = null; + dataUtf8 = new String(data); + } + ZStat zstat = new ZStat(path, ui.getAbsolutePath().toString(), + data64, dataUtf8, stat.getCzxid(), stat.getMzxid(), stat + .getCtime(), stat.getMtime(), stat.getVersion(), + stat.getCversion(), stat.getAversion(), stat + .getEphemeralOwner(), stat.getDataLength(), stat + .getNumChildren(), stat.getPzxid()); + + return Response.status(Response.Status.OK).entity( + new JSONWithPadding(zstat, callback)).build(); + } + } + + @GET + @Produces(MediaType.APPLICATION_OCTET_STREAM) + public Response getZNodeListAsOctet(@PathParam("path") String path) + throws InterruptedException, KeeperException { + ensurePathNotNull(path); + + Stat stat = new Stat(); + byte[] data = zk.getData(path, false, stat); + + if (data == null) { + return Response.status(Response.Status.NO_CONTENT).build(); + } else { + return Response.status(Response.Status.OK).entity(data).build(); + } + } + + @PUT + @Produces( { MediaType.APPLICATION_JSON, "application/javascript", + MediaType.APPLICATION_XML }) + @Consumes(MediaType.APPLICATION_OCTET_STREAM) + public Response setZNode( + @PathParam("path") String path, + @QueryParam("callback") String callback, + @DefaultValue("-1") @QueryParam("version") String versionParam, + @DefaultValue("base64") @QueryParam("dataformat") String dataformat, + @DefaultValue("false") @QueryParam("null") String setNull, + @Context UriInfo ui, byte[] data) throws InterruptedException, + KeeperException { + ensurePathNotNull(path); + + int version; + try { + version = Integer.parseInt(versionParam); + } catch (NumberFormatException e) { + throw new WebApplicationException(Response.status( + Response.Status.BAD_REQUEST).entity( + new ZError(ui.getRequestUri().toString(), path + + " bad version " + versionParam)).build()); + } + + if (setNull.equals("true")) { + data = null; + } + + Stat stat = zk.setData(path, data, version); + + ZStat zstat = new ZStat(path, ui.getAbsolutePath().toString(), null, + null, stat.getCzxid(), stat.getMzxid(), stat.getCtime(), stat + .getMtime(), stat.getVersion(), stat.getCversion(), + stat.getAversion(), stat.getEphemeralOwner(), stat + .getDataLength(), stat.getNumChildren(), stat + .getPzxid()); + + return Response.status(Response.Status.OK).entity( + new JSONWithPadding(zstat, callback)).build(); + } + + @PUT + @Produces(MediaType.APPLICATION_OCTET_STREAM) + @Consumes(MediaType.APPLICATION_OCTET_STREAM) + public void setZNodeAsOctet(@PathParam("path") String path, + @DefaultValue("-1") @QueryParam("version") String versionParam, + @DefaultValue("false") @QueryParam("null") String setNull, + @Context UriInfo ui, byte[] data) throws InterruptedException, + KeeperException { + ensurePathNotNull(path); + + int version; + try { + version = Integer.parseInt(versionParam); + } catch (NumberFormatException e) { + throw new WebApplicationException(Response.status( + Response.Status.BAD_REQUEST).entity( + new ZError(ui.getRequestUri().toString(), path + + " bad version " + versionParam)).build()); + } + + if (setNull.equals("true")) { + data = null; + } + + zk.setData(path, data, version); + } + + @POST + @Produces( { MediaType.APPLICATION_JSON, "application/javascript", + MediaType.APPLICATION_XML }) + @Consumes(MediaType.APPLICATION_OCTET_STREAM) + public Response createZNode( + @PathParam("path") String path, + @QueryParam("callback") String callback, + @DefaultValue("create") @QueryParam("op") String op, + @QueryParam("name") String name, + @DefaultValue("base64") @QueryParam("dataformat") String dataformat, + @DefaultValue("false") @QueryParam("null") String setNull, + @DefaultValue("false") @QueryParam("sequence") String sequence, + @DefaultValue("false") @QueryParam("ephemeral") String ephemeral, + @Context UriInfo ui, byte[] data) throws InterruptedException, + KeeperException { + ensurePathNotNull(path); + + if (path.equals("/")) { + path += name; + } else { + path += "/" + name; + } + + if (!op.equals("create")) { + throw new WebApplicationException(Response.status( + Response.Status.BAD_REQUEST).entity( + new ZError(ui.getRequestUri().toString(), path + + " bad operaton " + op)).build()); + } + + if (setNull.equals("true")) { + data = null; + } + + CreateMode createMode; + if (sequence.equals("true")) { + if (ephemeral.equals("false")) { + createMode = CreateMode.PERSISTENT_SEQUENTIAL; + } else { + createMode = CreateMode.EPHEMERAL_SEQUENTIAL; + } + } else if (ephemeral.equals("false")) { + createMode = CreateMode.PERSISTENT; + } else { + createMode = CreateMode.EPHEMERAL; + } + + String newPath = zk.create(path, data, Ids.OPEN_ACL_UNSAFE, createMode); + + URI uri = ui.getAbsolutePathBuilder().path(newPath).build(); + + return Response.created(uri).entity( + new JSONWithPadding(new ZPath(newPath, ui.getAbsolutePath() + .toString()))).build(); + } + + @POST + @Produces(MediaType.APPLICATION_OCTET_STREAM) + @Consumes(MediaType.APPLICATION_OCTET_STREAM) + public Response createZNodeAsOctet(@PathParam("path") String path, + @DefaultValue("create") @QueryParam("op") String op, + @QueryParam("name") String name, + @DefaultValue("false") @QueryParam("null") String setNull, + @DefaultValue("false") @QueryParam("sequence") String sequence, + @Context UriInfo ui, byte[] data) throws InterruptedException, + KeeperException { + ensurePathNotNull(path); + + if (path.equals("/")) { + path += name; + } else { + path += "/" + name; + } + + if (!op.equals("create")) { + throw new WebApplicationException(Response.status( + Response.Status.BAD_REQUEST).entity( + new ZError(ui.getRequestUri().toString(), path + + " bad operaton " + op)).build()); + } + + if (setNull.equals("true")) { + data = null; + } + + CreateMode createMode; + if (sequence.equals("true")) { + createMode = CreateMode.PERSISTENT_SEQUENTIAL; + } else { + createMode = CreateMode.PERSISTENT; + } + + String newPath = zk.create(path, data, Ids.OPEN_ACL_UNSAFE, createMode); + + URI uri = ui.getAbsolutePathBuilder().path(newPath).build(); + + return Response.created(uri).entity( + new ZPath(newPath, ui.getAbsolutePath().toString())).build(); + } + + @DELETE + @Produces( { MediaType.APPLICATION_JSON, "application/javascript", + MediaType.APPLICATION_XML, MediaType.APPLICATION_OCTET_STREAM }) + public void deleteZNode(@PathParam("path") String path, + @DefaultValue("-1") @QueryParam("version") String versionParam, + @Context UriInfo ui) throws InterruptedException, KeeperException { + ensurePathNotNull(path); + + int version; + try { + version = Integer.parseInt(versionParam); + } catch (NumberFormatException e) { + throw new WebApplicationException(Response.status( + Response.Status.BAD_REQUEST).entity( + new ZError(ui.getRequestUri().toString(), path + + " bad version " + versionParam)).build()); + } + + zk.delete(path, version); + } + + private static void throwNotFound(String path, UriInfo ui) + throws WebApplicationException { + throw new WebApplicationException(Response.status( + Response.Status.NOT_FOUND).entity( + new ZError(ui.getRequestUri().toString(), path + " not found")) + .build()); + } + +} diff --git a/src/contrib/rest/src/python/README.txt b/src/contrib/rest/src/python/README.txt new file mode 100644 index 0000000..acc8ffb --- /dev/null +++ b/src/contrib/rest/src/python/README.txt @@ -0,0 +1,9 @@ +Some basic python scripts which use the REST interface: + +zkrest.py -- basic REST ZooKeeper client +demo_master_election.py -- shows how to implement master election +demo_queue.py -- basic queue +zk_dump_tree.py -- dumps the nodes & data of a znode hierarchy + +Generally these scripts require: + * simplejson diff --git a/src/contrib/rest/src/python/demo_master_election.py b/src/contrib/rest/src/python/demo_master_election.py new file mode 100644 index 0000000..c0317c7 --- /dev/null +++ b/src/contrib/rest/src/python/demo_master_election.py @@ -0,0 +1,90 @@ +#! /usr/bin/env python + +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +import sys +import threading +import time + +from zkrest import ZooKeeper + +class Agent(threading.Thread): + """ A basic agent that wants to become a master and exit """ + + root = '/election' + + def __init__(self, id): + super(Agent, self).__init__() + self.zk = ZooKeeper() + self.id = id + + def run(self): + print 'Starting #%s' % self.id + with self.zk.session(expire=5): + + # signal agent presence + r = self.zk.create("%s/agent-" % self.root, + sequence=True, ephemeral=True) + self.me = r['path'] + + while True: + children = sorted([el['path'] \ + for el in self.zk.get_children(self.root)]) + master, previous = children[0], None + try: + index = children.index(self.me) + if index != 0: + previous = children[index-1] + except ValueError: + break + + if previous is None: + self.do_master_work() + # and don't forget to send heartbeat messages + break + else: + # do slave work in another thread + pass + + # wait for the previous agent or current master to exit / finish + while self.zk.exists(previous) or self.zk.exists(master): + time.sleep(0.5) + self.zk.heartbeat() + + # TODO signal the slave thread to exit and wait for it + # and rerun the election loop + + def do_master_work(self): + print "#%s: I'm the master: %s" % (self.id, self.me) + +def main(): + zk = ZooKeeper() + + # create the root node used for master election + if not zk.exists('/election'): + zk.create('/election') + + print 'Starting 10 agents ...' + agents = [Agent(id) for id in range(0,15)] + + map(Agent.start, agents) + map(Agent.join, agents) + + zk.delete('/election') + +if __name__ == '__main__': + sys.exit(main()) diff --git a/src/contrib/rest/src/python/demo_queue.py b/src/contrib/rest/src/python/demo_queue.py new file mode 100644 index 0000000..9ca4c64 --- /dev/null +++ b/src/contrib/rest/src/python/demo_queue.py @@ -0,0 +1,99 @@ +#! /usr/bin/env python + +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + + +# This is a simple message queue built on top of ZooKeeper. In order +# to be used in production it needs better error handling but it's +# still useful as a proof-of-concept. + +# Why use ZooKeeper as a queue? Highly available by design and has +# great performance. + +import sys +import threading +import time + +from zkrest import ZooKeeper + +class Queue(object): + def __init__(self, root, zk): + self.root = root + + self.zk = zk + + def put(self, data): + self.zk.create("%s/el-" % self.root, str(data), sequence=True, ephemeral=True) + + # creating ephemeral nodes for easy cleanup + # in a real world scenario you should create + # normal sequential znodes + + def fetch(self): + """ Pull an element from the queue + + This function is not blocking if the queue is empty, it will + just return None. + """ + children = sorted(self.zk.get_children(self.root), \ + lambda a, b: cmp(a['path'], b['path'])) + + if not children: + return None + + try: + first = children[0] + self.zk.delete(first['path'], version=first['version']) + if 'data64' not in first: + return '' + else: + return first['data64'].decode('base64') + + except (ZooKeeper.WrongVersion, ZooKeeper.NotFound): + # someone changed the znode between the get and delete + # this should not happen + # in practice you should retry the fetch + raise + + +def main(): + zk = ZooKeeper() + zk.start_session(expire=60) + + if not zk.exists('/queue'): + zk.create('/queue') + q = Queue('/queue', zk) + + print 'Pushing to queue 1 ... 5' + map(q.put, [1,2,3,4,5]) + + print 'Extracting ...' + while True: + el = q.fetch() + if el is None: + break + print el + + zk.close_session() + zk.delete('/queue') + + print 'Done.' + + +if __name__ == '__main__': + sys.exit(main()) + diff --git a/src/contrib/rest/src/python/test.py b/src/contrib/rest/src/python/test.py new file mode 100644 index 0000000..363747a --- /dev/null +++ b/src/contrib/rest/src/python/test.py @@ -0,0 +1,163 @@ +#! /usr/bin/env python + +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +import time +import unittest + +from zkrest import ZooKeeper + +class ZooKeeperREST_TestCase(unittest.TestCase): + + BASE_URI = 'http://localhost:9998' + + def setUp(self): + self.zk = ZooKeeper(self.BASE_URI) + + def tearDown(self): + try: + self.zk.delete('/test') + except ZooKeeper.NotFound: + pass + + def test_get_root_node(self): + assert self.zk.get('/') is not None + + def test_get_node_not_found(self): + self.assertRaises(ZooKeeper.NotFound, \ + self.zk.get, '/dummy-node') + + def test_exists_node(self): + assert self.zk.exists('/zookeeper') is True + + def test_get_children(self): + assert any([child['path'] == '/zookeeper/quota' \ + for child in self.zk.get_children('/zookeeper')]) + + def test_create_znode(self): + try: + self.zk.create('/test') + except ZooKeeper.ZNodeExists: + pass # it's ok if already exists + assert self.zk.exists('/test') is True + + def test_create_hierarchy(self): + try: + self.zk.delete(['/a/b', '/a']) + except ZooKeeper.NotFound: + pass + + self.zk.create('/a') + self.zk.create('/a/b') + + self.zk.delete(['/a/b', '/a']) + + def test_create_with_data(self): + self.zk.create('/test', 'some-data') + + zn = self.zk.get('/test') + self.assertEqual(zn.get('data64', None), \ + 'some-data'.encode('base64').strip()) + + def test_delete_znode(self): + self.zk.create('/test') + + self.zk.delete('/test') + assert not self.zk.exists('/test') + + def test_delete_older_version(self): + self.zk.create('/test') + + zn = self.zk.get('/test') + # do one more modification in order to increase the version number + self.zk.set('/test', 'dummy-data') + + self.assertRaises(ZooKeeper.WrongVersion, \ + self.zk.delete, '/test', version=zn['version']) + + def test_delete_raise_not_found(self): + self.zk.create('/test') + + zn = self.zk.get('/test') + self.zk.delete('/test') + + self.assertRaises(ZooKeeper.NotFound, \ + self.zk.delete, '/test', version=zn['version']) + + def test_set(self): + self.zk.create('/test') + + self.zk.set('/test', 'dummy') + + self.assertEqual(self.zk.get('/test')['data64'], \ + 'dummy'.encode('base64').strip()) + + def test_set_with_older_version(self): + if not self.zk.exists('/test'): + self.zk.create('/test', 'random-data') + + zn = self.zk.get('/test') + self.zk.set('/test', 'new-data') + self.assertRaises(ZooKeeper.WrongVersion, self.zk.set, \ + '/test', 'older-version', version=zn['version']) + + def test_set_null(self): + if not self.zk.exists('/test'): + self.zk.create('/test', 'random-data') + self.zk.set('/test', 'data') + assert 'data64' in self.zk.get('/test') + + self.zk.set('/test', null=True) + assert 'data64' not in self.zk.get('/test') + + def test_create_ephemeral_node(self): + with self.zk.session(): + if self.zk.exists('/ephemeral-test'): + self.zk.delete('/ephemeral-test') + + self.zk.create('/ephemeral-test', ephemeral=True) + zn = self.zk.get('/ephemeral-test') + + assert zn['ephemeralOwner'] != 0 + + def test_create_session(self): + with self.zk.session() as sid: + self.assertEqual(len(sid), 36) # UUID + + def test_session_invalidation(self): + self.zk.start_session(expire=1) + self.zk.create('/ephemeral-test', ephemeral=True) + + # keep the session alive by sending heartbeat requests + for _ in range(1,2): + self.zk.heartbeat() + time.sleep(0.9) + + time.sleep(2) # wait for the session to expire + self.assertRaises(ZooKeeper.InvalidSession, \ + self.zk.create, '/ephemeral-test', ephemeral=True) + + def test_presence_signaling(self): + with self.zk.session(expire=1): + self.zk.create('/i-am-online', ephemeral=True) + assert self.zk.exists('/i-am-online') + assert not self.zk.exists('/i-am-online') + + +if __name__ == '__main__': + unittest.main() + diff --git a/src/contrib/rest/src/python/zk_dump_tree.py b/src/contrib/rest/src/python/zk_dump_tree.py new file mode 100644 index 0000000..517d23b --- /dev/null +++ b/src/contrib/rest/src/python/zk_dump_tree.py @@ -0,0 +1,108 @@ +#!/usr/bin/python + +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +import getopt +import sys +import simplejson +import urllib2 +from base64 import b64decode + +printdata = False +fullpath = False + +def dump_node(url, depth): + """Dump the node, then dump children recursively + + Arguments: + - `url`: + - `depth`: + """ + req = urllib2.urlopen(url) + resp = simplejson.load(req) + if 'Error' in resp: + raise resp['Error'] + + if fullpath: + name = resp['path'] + else: + name = '/' + resp['path'].split('/')[-1] + + data64 = resp.get('data64') + dataUtf8 = resp.get('dataUtf8') + if data64 and printdata: + data = b64decode(data64) + print '%(indent)s%(name)s = b64(%(data64)s) str(%(data)s)' % \ + {'indent':' '*2*depth, 'name':name, 'data64':data64, 'data':data} + elif dataUtf8 and printdata: + print '%(indent)s%(name)s = %(data)s' % \ + {'indent':' '*2*depth, 'name':name, 'data':dataUtf8} + else: + print '%(indent)s%(name)s' % {'indent':' '*2*depth, 'name':name} + + req = urllib2.urlopen(resp['uri'] + '?view=children') + resp = simplejson.load(req) + + for child in resp.get('children', []): + dump_node(resp['child_uri_template'] + .replace("{child}", urllib2.quote(child)), + depth + 1) + +def zk_dump_tree(url, root): + """Dump the tree starting at the roota + + Arguments: + - `root`: + """ + dump_node(url + '/znodes/v1' + root, 0) + +def usage(): + """Usage + """ + print 'Usage: zk_dump_tree.py [-h|--help -u|--url=url -d|--data -f|--fullpath -r|--root=root]' + print ' where url is the url of the rest server, data is whether to' + print ' to include node data on output, root is the znode root' + print ' fullpath prints the full node path (useful for copy/paste)' + +if __name__ == '__main__': + try: + opts, args = getopt.getopt(sys.argv[1:], + "hu:dfr:", ["help", "url=", "data", "fullpath", "root="]) + except getopt.GetoptError, err: + # print help information and exit: + print str(err) # will print something like "option -a not recognized" + usage() + sys.exit(2) + url ='http://localhost:9998' + root = '/' + for o, a in opts: + if o in ("-d", "--data"): + printdata = True + elif o in ("-h", "--help"): + usage() + sys.exit() + elif o in ("-u", "--url"): + url = a + elif o in ("-r", "--root"): + root = a + elif o in ("-f", "--fullpath"): + fullpath = True + else: + assert False, "unhandled option" + + print 'Accessing REST server at ' + url + zk_dump_tree(url, root) diff --git a/src/contrib/rest/src/python/zkrest.py b/src/contrib/rest/src/python/zkrest.py new file mode 100644 index 0000000..c009d5d --- /dev/null +++ b/src/contrib/rest/src/python/zkrest.py @@ -0,0 +1,218 @@ + +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +import urllib2 +import urllib +import simplejson + +from contextlib import contextmanager + +class RequestWithMethod(urllib2.Request): + """ Request class that know how to set the method name """ + def __init__(self, *args, **kwargs): + urllib2.Request.__init__(self, *args, **kwargs) + self._method = None + + def get_method(self): + return self._method or \ + urllib2.Request.get_method(self) + + def set_method(self, method): + self._method = method + +class ZooKeeper(object): + + class Error(Exception): pass + + class NotFound(Error): pass + + class ZNodeExists(Error): pass + + class InvalidSession(Error): pass + + class WrongVersion(Error): pass + + def __init__(self, uri = 'http://localhost:9998'): + self._base = uri + self._session = None + + def start_session(self, expire=5, id=None): + """ Create a session and return the ID """ + if id is None: + url = "%s/sessions/v1/?op=create&expire=%d" % (self._base, expire) + self._session = self._do_post(url)['id'] + else: + self._session = id + return self._session + + def close_session(self): + """ Close the session on the server """ + if self._session is not None: + url = '%s/sessions/v1/%s' % (self._base, self._session) + self._do_delete(url) + self._session = None + + def heartbeat(self): + """ Send a heartbeat request. This is needed in order to keep a session alive """ + if self._session is not None: + url = '%s/sessions/v1/%s' % (self._base, self._session) + self._do_put(url, '') + + @contextmanager + def session(self, *args, **kwargs): + """ Session handling using a context manager """ + yield self.start_session(*args, **kwargs) + self.close_session() + + def get(self, path): + """ Get a node """ + url = "%s/znodes/v1%s" % (self._base, path) + return self._do_get(url) + + def get_children(self, path): + """ Get all the children for a given path. This function creates a generator """ + url = "%s/znodes/v1%s?view=children" % (self._base, path) + resp = self._do_get(url) + for child in resp.get('children', []): + try: + yield self._do_get(resp['child_uri_template']\ + .replace('{child}', urllib2.quote(child))) + except ZooKeeper.NotFound: + continue + + def create(self, path, data=None, sequence=False, ephemeral=False): + """ Create a new node. By default this call creates a persistent znode. + + You can also create an ephemeral or a sequential znode. + """ + ri = path.rindex('/') + head, name = path[:ri+1], path[ri+1:] + if head != '/': head = head[:-1] + + flags = { + 'null': 'true' if data is None else 'false', + 'ephemeral': 'true' if ephemeral else 'false', + 'sequence': 'true' if sequence else 'false' + } + if ephemeral: + if self._session: + flags['session'] = self._session + else: + raise ZooKeeper.Error, 'You need a session '\ + 'to create an ephemeral node' + flags = urllib.urlencode(flags) + + url = "%s/znodes/v1%s?op=create&name=%s&%s" % \ + (self._base, head, name, flags) + + return self._do_post(url, data) + + def set(self, path, data=None, version=-1, null=False): + """ Set the value of node """ + url = "%s/znodes/v1%s?%s" % (self._base, path, \ + urllib.urlencode({ + 'version': version, + 'null': 'true' if null else 'false' + })) + return self._do_put(url, data) + + def delete(self, path, version=-1): + """ Delete a znode """ + if type(path) is list: + map(lambda el: self.delete(el, version), path) + return + + url = '%s/znodes/v1%s?%s' % (self._base, path, \ + urllib.urlencode({ + 'version':version + })) + try: + return self._do_delete(url) + except urllib2.HTTPError, e: + if e.code == 412: + raise ZooKeeper.WrongVersion(path) + elif e.code == 404: + raise ZooKeeper.NotFound(path) + raise + + def exists(self, path): + """ Do a znode exists """ + try: + self.get(path) + return True + except ZooKeeper.NotFound: + return False + + def _do_get(self, uri): + """ Send a GET request and convert errors to exceptions """ + try: + req = urllib2.urlopen(uri) + resp = simplejson.load(req) + + if 'Error' in resp: + raise ZooKeeper.Error(resp['Error']) + + return resp + except urllib2.HTTPError, e: + if e.code == 404: + raise ZooKeeper.NotFound(uri) + raise + + def _do_post(self, uri, data=None): + """ Send a POST request and convert errors to exceptions """ + try: + req = urllib2.Request(uri, {}) + req.add_header('Content-Type', 'application/octet-stream') + if data is not None: + req.add_data(data) + + resp = simplejson.load(urllib2.urlopen(req)) + if 'Error' in resp: + raise ZooKeeper.Error(resp['Error']) + return resp + + except urllib2.HTTPError, e: + if e.code == 201: + return True + elif e.code == 409: + raise ZooKeeper.ZNodeExists(uri) + elif e.code == 401: + raise ZooKeeper.InvalidSession(uri) + raise + + def _do_delete(self, uri): + """ Send a DELETE request """ + req = RequestWithMethod(uri) + req.set_method('DELETE') + req.add_header('Content-Type', 'application/octet-stream') + return urllib2.urlopen(req).read() + + def _do_put(self, uri, data): + """ Send a PUT request """ + try: + req = RequestWithMethod(uri) + req.set_method('PUT') + req.add_header('Content-Type', 'application/octet-stream') + if data is not None: + req.add_data(data) + + return urllib2.urlopen(req).read() + except urllib2.HTTPError, e: + if e.code == 412: # precondition failed + raise ZooKeeper.WrongVersion(uri) + raise + diff --git a/src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/Base.java b/src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/Base.java new file mode 100644 index 0000000..2d5f51a --- /dev/null +++ b/src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/Base.java @@ -0,0 +1,94 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.zookeeper.server.jersey; + +import java.io.ByteArrayInputStream; + +import junit.framework.TestCase; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.apache.zookeeper.CreateMode; +import org.apache.zookeeper.ZooKeeper; +import org.apache.zookeeper.ZooDefs.Ids; +import org.apache.zookeeper.server.jersey.SetTest.MyWatcher; +import org.apache.zookeeper.server.jersey.cfg.RestCfg; +import org.junit.After; +import org.junit.Before; + +import com.sun.jersey.api.client.Client; +import com.sun.jersey.api.client.WebResource; + +/** + * Test stand-alone server. + * + */ +public class Base extends TestCase { + protected static final Logger LOG = LoggerFactory.getLogger(Base.class); + + protected static final String CONTEXT_PATH = "/zk"; + protected static final int GRIZZLY_PORT = 10104; + protected static final String BASEURI = String.format( + "http://localhost:%d%s", GRIZZLY_PORT, CONTEXT_PATH); + protected static final String ZKHOSTPORT = "localhost:22182"; + protected Client client; + protected WebResource znodesr, sessionsr; + + protected ZooKeeper zk; + + private RestMain rest; + + @Before + public void setUp() throws Exception { + super.setUp(); + + RestCfg cfg = new RestCfg(new ByteArrayInputStream(String.format( + "rest.port=%s\n" + + "rest.endpoint.1=%s;%s\n", + GRIZZLY_PORT, CONTEXT_PATH, ZKHOSTPORT).getBytes())); + + rest = new RestMain(cfg); + rest.start(); + + zk = new ZooKeeper(ZKHOSTPORT, 30000, new MyWatcher()); + + client = Client.create(); + znodesr = client.resource(BASEURI).path("znodes/v1"); + sessionsr = client.resource(BASEURI).path("sessions/v1/"); + } + + @After + public void tearDown() throws Exception { + super.tearDown(); + + client.destroy(); + zk.close(); + rest.stop(); + } + + protected static String createBaseZNode() throws Exception { + ZooKeeper zk = new ZooKeeper(ZKHOSTPORT, 30000, new MyWatcher()); + + String baseZnode = zk.create("/test-", null, Ids.OPEN_ACL_UNSAFE, + CreateMode.PERSISTENT_SEQUENTIAL); + zk.close(); + + return baseZnode; + } +} diff --git a/src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/CreateTest.java b/src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/CreateTest.java new file mode 100644 index 0000000..49c3349 --- /dev/null +++ b/src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/CreateTest.java @@ -0,0 +1,163 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.zookeeper.server.jersey; + +import java.util.Arrays; +import java.util.Collection; + +import javax.ws.rs.core.MediaType; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.apache.zookeeper.WatchedEvent; +import org.apache.zookeeper.Watcher; +import org.apache.zookeeper.data.Stat; +import org.apache.zookeeper.server.jersey.jaxb.ZPath; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.junit.runners.Parameterized; +import org.junit.runners.Parameterized.Parameters; + +import com.sun.jersey.api.client.ClientResponse; +import com.sun.jersey.api.client.WebResource; +import com.sun.jersey.api.client.WebResource.Builder; + + +/** + * Test stand-alone server. + * + */ +@RunWith(Parameterized.class) +public class CreateTest extends Base { + protected static final Logger LOG = LoggerFactory.getLogger(CreateTest.class); + + private String accept; + private String path; + private String name; + private String encoding; + private ClientResponse.Status expectedStatus; + private ZPath expectedPath; + private byte[] data; + private boolean sequence; + + public static class MyWatcher implements Watcher { + public void process(WatchedEvent event) { + // FIXME ignore for now + } + } + + @Parameters + public static Collection data() throws Exception { + String baseZnode = Base.createBaseZNode(); + + return Arrays.asList(new Object[][] { + {MediaType.APPLICATION_JSON, + baseZnode, "foo bar", "utf8", + ClientResponse.Status.CREATED, + new ZPath(baseZnode + "/foo bar"), null, + false }, + {MediaType.APPLICATION_JSON, baseZnode, "c-t1", "utf8", + ClientResponse.Status.CREATED, new ZPath(baseZnode + "/c-t1"), + null, false }, + {MediaType.APPLICATION_JSON, baseZnode, "c-t1", "utf8", + ClientResponse.Status.CONFLICT, null, null, false }, + {MediaType.APPLICATION_JSON, baseZnode, "c-t2", "utf8", + ClientResponse.Status.CREATED, new ZPath(baseZnode + "/c-t2"), + "".getBytes(), false }, + {MediaType.APPLICATION_JSON, baseZnode, "c-t2", "utf8", + ClientResponse.Status.CONFLICT, null, null, false }, + {MediaType.APPLICATION_JSON, baseZnode, "c-t3", "utf8", + ClientResponse.Status.CREATED, new ZPath(baseZnode + "/c-t3"), + "foo".getBytes(), false }, + {MediaType.APPLICATION_JSON, baseZnode, "c-t3", "utf8", + ClientResponse.Status.CONFLICT, null, null, false }, + {MediaType.APPLICATION_JSON, baseZnode, "c-t4", "base64", + ClientResponse.Status.CREATED, new ZPath(baseZnode + "/c-t4"), + "foo".getBytes(), false }, + {MediaType.APPLICATION_JSON, baseZnode, "c-", "utf8", + ClientResponse.Status.CREATED, new ZPath(baseZnode + "/c-"), null, + true }, + {MediaType.APPLICATION_JSON, baseZnode, "c-", "utf8", + ClientResponse.Status.CREATED, new ZPath(baseZnode + "/c-"), null, + true } + }); + } + + public CreateTest(String accept, String path, String name, String encoding, + ClientResponse.Status status, ZPath expectedPath, byte[] data, + boolean sequence) + { + this.accept = accept; + this.path = path; + this.name = name; + this.encoding = encoding; + this.expectedStatus = status; + this.expectedPath = expectedPath; + this.data = data; + this.sequence = sequence; + } + + @Test + public void testCreate() throws Exception { + LOG.info("STARTING " + getName()); + + WebResource wr = znodesr.path(path).queryParam("dataformat", encoding) + .queryParam("name", name); + if (data == null) { + wr = wr.queryParam("null", "true"); + } + if (sequence) { + wr = wr.queryParam("sequence", "true"); + } + + Builder builder = wr.accept(accept); + + ClientResponse cr; + if (data == null) { + cr = builder.post(ClientResponse.class); + } else { + cr = builder.post(ClientResponse.class, data); + } + assertEquals(expectedStatus, cr.getClientResponseStatus()); + + if (expectedPath == null) { + return; + } + + ZPath zpath = cr.getEntity(ZPath.class); + if (sequence) { + assertTrue(zpath.path.startsWith(expectedPath.path)); + assertTrue(zpath.uri.startsWith(znodesr.path(path).toString())); + } else { + assertEquals(expectedPath, zpath); + assertEquals(znodesr.path(path).toString(), zpath.uri); + } + + // use out-of-band method to verify + byte[] data = zk.getData(zpath.path, false, new Stat()); + if (data == null && this.data == null) { + return; + } else if (data == null || this.data == null) { + assertEquals(data, this.data); + } else { + assertTrue(new String(data) + " == " + new String(this.data), + Arrays.equals(data, this.data)); + } + } +} diff --git a/src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/DeleteTest.java b/src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/DeleteTest.java new file mode 100644 index 0000000..052239d --- /dev/null +++ b/src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/DeleteTest.java @@ -0,0 +1,95 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.zookeeper.server.jersey; + +import java.util.Arrays; +import java.util.Collection; + +import javax.ws.rs.core.MediaType; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.apache.zookeeper.CreateMode; +import org.apache.zookeeper.WatchedEvent; +import org.apache.zookeeper.Watcher; +import org.apache.zookeeper.ZooDefs.Ids; +import org.apache.zookeeper.data.Stat; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.junit.runners.Parameterized; +import org.junit.runners.Parameterized.Parameters; + +import com.sun.jersey.api.client.ClientResponse; + + +/** + * Test stand-alone server. + * + */ +@RunWith(Parameterized.class) +public class DeleteTest extends Base { + protected static final Logger LOG = LoggerFactory.getLogger(DeleteTest.class); + + private String zpath; + private ClientResponse.Status expectedStatus; + + public static class MyWatcher implements Watcher { + public void process(WatchedEvent event) { + // FIXME ignore for now + } + } + + @Parameters + public static Collection data() throws Exception { + String baseZnode = Base.createBaseZNode(); + + return Arrays.asList(new Object[][] { + {baseZnode, baseZnode, ClientResponse.Status.NO_CONTENT }, + {baseZnode, baseZnode, ClientResponse.Status.NO_CONTENT } + }); + } + + public DeleteTest(String path, String zpath, ClientResponse.Status status) { + this.zpath = zpath; + this.expectedStatus = status; + } + + public void verify(String type) throws Exception { + if (expectedStatus != ClientResponse.Status.NOT_FOUND) { + zpath = zk.create(zpath, null, Ids.OPEN_ACL_UNSAFE, + CreateMode.PERSISTENT_SEQUENTIAL); + } + + ClientResponse cr = znodesr.path(zpath).accept(type).type(type) + .delete(ClientResponse.class); + assertEquals(expectedStatus, cr.getClientResponseStatus()); + + // use out-of-band method to verify + Stat stat = zk.exists(zpath, false); + assertNull(stat); + } + + @Test + public void testDelete() throws Exception { + LOG.info("STARTING " + getName()); + verify(MediaType.APPLICATION_OCTET_STREAM); + verify(MediaType.APPLICATION_JSON); + verify(MediaType.APPLICATION_XML); + } +} diff --git a/src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/ExistsTest.java b/src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/ExistsTest.java new file mode 100644 index 0000000..696ea95 --- /dev/null +++ b/src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/ExistsTest.java @@ -0,0 +1,80 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.zookeeper.server.jersey; + +import java.util.Arrays; +import java.util.Collection; + +import javax.ws.rs.core.MediaType; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.junit.runners.Parameterized; +import org.junit.runners.Parameterized.Parameters; + +import com.sun.jersey.api.client.ClientResponse; + + +/** + * Test stand-alone server. + * + */ +@RunWith(Parameterized.class) +public class ExistsTest extends Base { + protected static final Logger LOG = LoggerFactory.getLogger(ExistsTest.class); + + private String path; + private ClientResponse.Status expectedStatus; + + @Parameters + public static Collection data() throws Exception { + String baseZnode = Base.createBaseZNode(); + + return Arrays.asList(new Object[][] { + {baseZnode, ClientResponse.Status.OK }, + {baseZnode + "dkdk38383", ClientResponse.Status.NOT_FOUND } + }); + } + + public ExistsTest(String path, ClientResponse.Status status) { + this.path = path; + this.expectedStatus = status; + } + + private void verify(String type) { + ClientResponse cr = znodesr.path(path).accept(type).type(type).head(); + if (type.equals(MediaType.APPLICATION_OCTET_STREAM) + && expectedStatus == ClientResponse.Status.OK) { + assertEquals(ClientResponse.Status.NO_CONTENT, + cr.getClientResponseStatus()); + } else { + assertEquals(expectedStatus, cr.getClientResponseStatus()); + } + } + + @Test + public void testExists() throws Exception { + LOG.info("STARTING " + getName()); + verify(MediaType.APPLICATION_OCTET_STREAM); + verify(MediaType.APPLICATION_JSON); + verify(MediaType.APPLICATION_XML); + } +} diff --git a/src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/GetChildrenTest.java b/src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/GetChildrenTest.java new file mode 100644 index 0000000..a046692 --- /dev/null +++ b/src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/GetChildrenTest.java @@ -0,0 +1,139 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.zookeeper.server.jersey; + +import java.util.Arrays; +import java.util.Collection; +import java.util.Collections; +import java.util.List; + +import javax.ws.rs.core.MediaType; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.apache.zookeeper.CreateMode; +import org.apache.zookeeper.ZooDefs.Ids; +import org.apache.zookeeper.server.jersey.jaxb.ZChildren; +import org.apache.zookeeper.server.jersey.jaxb.ZChildrenJSON; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.junit.runners.Parameterized; +import org.junit.runners.Parameterized.Parameters; + +import com.sun.jersey.api.client.ClientResponse; + + +/** + * Test stand-alone server. + * + */ +@RunWith(Parameterized.class) +public class GetChildrenTest extends Base { + protected static final Logger LOG = LoggerFactory.getLogger(GetChildrenTest.class); + + private String accept; + private String path; + private ClientResponse.Status expectedStatus; + private String expectedPath; + private List expectedChildren; + + @Parameters + public static Collection data() throws Exception { + String baseZnode = Base.createBaseZNode(); + String baseZnode2 = Base.createBaseZNode(); + String baseZnode3 = Base.createBaseZNode(); + String baseZnode4 = Base.createBaseZNode(); + String baseZnode5 = Base.createBaseZNode(); + String baseZnode6 = Base.createBaseZNode(); + + return Arrays.asList(new Object[][] { + {MediaType.APPLICATION_JSON, baseZnode + "abddkdkd", + ClientResponse.Status.NOT_FOUND, null, null }, + {MediaType.APPLICATION_XML, baseZnode + "abddkdkd", + ClientResponse.Status.NOT_FOUND, null, null }, + {MediaType.APPLICATION_JSON, baseZnode, ClientResponse.Status.OK, + baseZnode, Arrays.asList(new String[] {}) }, + {MediaType.APPLICATION_XML, baseZnode, ClientResponse.Status.OK, + baseZnode, Arrays.asList(new String[] {}) }, + {MediaType.APPLICATION_JSON, baseZnode, ClientResponse.Status.OK, + baseZnode, Arrays.asList(new String[] {"c1"}) }, + {MediaType.APPLICATION_XML, baseZnode4, ClientResponse.Status.OK, + baseZnode4, Arrays.asList(new String[] {"c1"}) }, + {MediaType.APPLICATION_JSON, baseZnode2, ClientResponse.Status.OK, + baseZnode2, Arrays.asList(new String[] {"c1", "c2"}) }, + {MediaType.APPLICATION_XML, baseZnode5, ClientResponse.Status.OK, + baseZnode5, Arrays.asList(new String[] {"c1", "c2"}) }, + {MediaType.APPLICATION_JSON, baseZnode3, ClientResponse.Status.OK, + baseZnode3, Arrays.asList(new String[] {"c1", "c2", "c3", "c4"}) }, + {MediaType.APPLICATION_XML, baseZnode6, ClientResponse.Status.OK, + baseZnode6, Arrays.asList(new String[] {"c1", "c2", "c3", "c4"}) } + + }); + } + + public GetChildrenTest(String accept, String path, ClientResponse.Status status, + String expectedPath, List expectedChildren) + { + this.accept = accept; + this.path = path; + this.expectedStatus = status; + this.expectedPath = expectedPath; + this.expectedChildren = expectedChildren; + } + + @Test + public void testGetChildren() throws Exception { + LOG.info("STARTING " + getName()); + + if (expectedChildren != null) { + for(String child : expectedChildren) { + zk.create(expectedPath + "/" + child, null, + Ids.OPEN_ACL_UNSAFE, CreateMode.PERSISTENT); + } + } + + ClientResponse cr = znodesr.path(path).queryParam("view", "children") + .accept(accept).get(ClientResponse.class); + assertEquals(expectedStatus, cr.getClientResponseStatus()); + + if (expectedChildren == null) { + return; + } + + if (accept.equals(MediaType.APPLICATION_JSON)) { + ZChildrenJSON zchildren = cr.getEntity(ZChildrenJSON.class); + Collections.sort(expectedChildren); + Collections.sort(zchildren.children); + assertEquals(expectedChildren, zchildren.children); + assertEquals(znodesr.path(path).toString(), zchildren.uri); + assertEquals(znodesr.path(path).toString() + "/{child}", + zchildren.child_uri_template); + } else if (accept.equals(MediaType.APPLICATION_XML)) { + ZChildren zchildren = cr.getEntity(ZChildren.class); + Collections.sort(expectedChildren); + Collections.sort(zchildren.children); + assertEquals(expectedChildren, zchildren.children); + assertEquals(znodesr.path(path).toString(), zchildren.uri); + assertEquals(znodesr.path(path).toString() + "/{child}", + zchildren.child_uri_template); + } else { + fail("unknown accept type"); + } + } +} diff --git a/src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/GetTest.java b/src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/GetTest.java new file mode 100644 index 0000000..f00946e --- /dev/null +++ b/src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/GetTest.java @@ -0,0 +1,123 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.zookeeper.server.jersey; + +import java.util.Arrays; +import java.util.Collection; + +import javax.ws.rs.core.MediaType; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.apache.zookeeper.server.jersey.jaxb.ZStat; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.junit.runners.Parameterized; +import org.junit.runners.Parameterized.Parameters; + +import com.sun.jersey.api.client.ClientResponse; + + +/** + * Test stand-alone server. + * + */ +@RunWith(Parameterized.class) +public class GetTest extends Base { + protected static final Logger LOG = LoggerFactory.getLogger(GetTest.class); + + private String accept; + private String path; + private String encoding; + private ClientResponse.Status expectedStatus; + private ZStat expectedStat; + + @Parameters + public static Collection data() throws Exception { + String baseZnode = Base.createBaseZNode(); + + return Arrays.asList(new Object[][] { + {MediaType.APPLICATION_JSON, baseZnode, "utf8", + ClientResponse.Status.OK, new ZStat(baseZnode, null, null) }, + {MediaType.APPLICATION_JSON, baseZnode, "utf8", + ClientResponse.Status.OK, new ZStat(baseZnode, null, "") }, + {MediaType.APPLICATION_JSON, baseZnode, "utf8", + ClientResponse.Status.OK, new ZStat(baseZnode, null, "foo") }, + {MediaType.APPLICATION_JSON, baseZnode, "base64", + ClientResponse.Status.OK, new ZStat(baseZnode, null, null) }, + {MediaType.APPLICATION_JSON, baseZnode, "base64", + ClientResponse.Status.OK, new ZStat(baseZnode, "".getBytes(), null) }, + {MediaType.APPLICATION_JSON, baseZnode, "base64", + ClientResponse.Status.OK, new ZStat(baseZnode, "".getBytes(), null) }, + {MediaType.APPLICATION_JSON, baseZnode, "base64", + ClientResponse.Status.OK, new ZStat(baseZnode, "foo".getBytes(), null) }, + {MediaType.APPLICATION_JSON, baseZnode + "abaddkdk", "utf8", + ClientResponse.Status.NOT_FOUND, null }, + {MediaType.APPLICATION_JSON, baseZnode + "abaddkdk", "base64", + ClientResponse.Status.NOT_FOUND, null }, + + {MediaType.APPLICATION_XML, baseZnode, "utf8", + ClientResponse.Status.OK, new ZStat(baseZnode, null, "foo") }, + {MediaType.APPLICATION_XML, baseZnode, "base64", + ClientResponse.Status.OK, + new ZStat(baseZnode, "foo".getBytes(), null) }, + {MediaType.APPLICATION_XML, baseZnode + "abaddkdk", "utf8", + ClientResponse.Status.NOT_FOUND, null }, + {MediaType.APPLICATION_XML, baseZnode + "abaddkdk", "base64", + ClientResponse.Status.NOT_FOUND, null } + + }); + } + + public GetTest(String accept, String path, String encoding, + ClientResponse.Status status, ZStat stat) + { + this.accept = accept; + this.path = path; + this.encoding = encoding; + this.expectedStatus = status; + this.expectedStat = stat; + } + + @Test + public void testGet() throws Exception { + LOG.info("STARTING " + getName()); + + if (expectedStat != null) { + if (expectedStat.data64 != null || expectedStat.dataUtf8 == null) { + zk.setData(expectedStat.path, expectedStat.data64, -1); + } else { + zk.setData(expectedStat.path, + expectedStat.dataUtf8.getBytes(), -1); + } + } + + ClientResponse cr = znodesr.path(path).queryParam("dataformat", encoding) + .accept(accept).get(ClientResponse.class); + assertEquals(expectedStatus, cr.getClientResponseStatus()); + + if (expectedStat == null) { + return; + } + + ZStat zstat = cr.getEntity(ZStat.class); + assertEquals(expectedStat, zstat); + assertEquals(znodesr.path(path).toString(), zstat.uri); + } +} diff --git a/src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/RestTestSuite.java b/src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/RestTestSuite.java new file mode 100644 index 0000000..fc69caf --- /dev/null +++ b/src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/RestTestSuite.java @@ -0,0 +1,42 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.zookeeper.server.jersey; + +import org.junit.AfterClass; +import org.junit.BeforeClass; +import org.junit.runner.RunWith; +import org.junit.runners.Suite; +import org.junit.runners.Suite.SuiteClasses; + +@RunWith(Suite.class) +@SuiteClasses({WadlTest.class, GetTest.class, GetChildrenTest.class, + CreateTest.class, SetTest.class, ExistsTest.class, DeleteTest.class }) +public class RestTestSuite { + + @BeforeClass + public static void setUp() { + // suite setup + } + + @AfterClass + public static void tearDown() { + // suite setup + } + +} diff --git a/src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/RootTest.java b/src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/RootTest.java new file mode 100644 index 0000000..a4f9b9e --- /dev/null +++ b/src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/RootTest.java @@ -0,0 +1,68 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.zookeeper.server.jersey; + +import java.util.Arrays; + +import javax.ws.rs.core.MediaType; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.apache.zookeeper.data.Stat; +import org.apache.zookeeper.server.jersey.jaxb.ZPath; +import org.junit.Test; + +import com.sun.jersey.api.client.ClientResponse; +import com.sun.jersey.api.client.WebResource; +import com.sun.jersey.api.client.WebResource.Builder; + + +/** + * Test stand-alone server. + * + */ +public class RootTest extends Base { + protected static final Logger LOG = LoggerFactory.getLogger(RootTest.class); + + @Test + public void testCreate() throws Exception { + LOG.info("STARTING " + getName()); + + String path = "/"; + String name = "roottest-create"; + byte[] data = "foo".getBytes(); + + WebResource wr = znodesr.path(path).queryParam("dataformat", "utf8") + .queryParam("name", name); + Builder builder = wr.accept(MediaType.APPLICATION_JSON); + + ClientResponse cr; + cr = builder.post(ClientResponse.class, data); + assertEquals(ClientResponse.Status.CREATED, cr.getClientResponseStatus()); + + ZPath zpath = cr.getEntity(ZPath.class); + assertEquals(new ZPath(path + name), zpath); + assertEquals(znodesr.path(path).toString(), zpath.uri); + + // use out-of-band method to verify + byte[] rdata = zk.getData(zpath.path, false, new Stat()); + assertTrue(new String(rdata) + " == " + new String(data), + Arrays.equals(rdata, data)); + } +} diff --git a/src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/SessionTest.java b/src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/SessionTest.java new file mode 100644 index 0000000..3e165c0 --- /dev/null +++ b/src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/SessionTest.java @@ -0,0 +1,134 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.zookeeper.server.jersey; + +import java.io.IOException; + +import javax.ws.rs.core.MediaType; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.apache.zookeeper.KeeperException; +import org.apache.zookeeper.ZooKeeper; +import org.apache.zookeeper.data.Stat; +import org.apache.zookeeper.server.jersey.jaxb.ZSession; +import org.codehaus.jettison.json.JSONException; +import org.junit.Test; + +import com.sun.jersey.api.client.Client; +import com.sun.jersey.api.client.ClientResponse; +import com.sun.jersey.api.client.WebResource; +import com.sun.jersey.api.client.WebResource.Builder; + +public class SessionTest extends Base { + protected static final Logger LOG = LoggerFactory.getLogger(SessionTest.class); + + private ZSession createSession() { + return createSession("30"); + } + + private ZSession createSession(String expire) { + WebResource wr = sessionsr.queryParam("op", "create") + .queryParam("expire", expire); + Builder b = wr.accept(MediaType.APPLICATION_JSON); + + ClientResponse cr = b.post(ClientResponse.class, null); + assertEquals(ClientResponse.Status.CREATED, cr + .getClientResponseStatus()); + + return cr.getEntity(ZSession.class); + } + + @Test + public void testCreateNewSession() throws JSONException { + ZSession session = createSession(); + assertEquals(session.id.length(), 36); + + // use out-of-band method to verify + assertTrue(ZooKeeperService.isConnected(CONTEXT_PATH, session.id)); + } + + @Test + public void testSessionExpires() throws InterruptedException { + ZSession session = createSession("1"); + + // use out-of-band method to verify + assertTrue(ZooKeeperService.isConnected(CONTEXT_PATH, session.id)); + + // wait for the session to be closed + Thread.sleep(1500); + assertFalse(ZooKeeperService.isConnected(CONTEXT_PATH, session.id)); + } + + @Test + public void testDeleteSession() { + ZSession session = createSession("30"); + + WebResource wr = sessionsr.path(session.id); + Builder b = wr.accept(MediaType.APPLICATION_JSON); + + assertTrue(ZooKeeperService.isConnected(CONTEXT_PATH, session.id)); + ClientResponse cr = b.delete(ClientResponse.class, null); + assertEquals(ClientResponse.Status.NO_CONTENT, + cr.getClientResponseStatus()); + + assertFalse(ZooKeeperService.isConnected(CONTEXT_PATH, session.id)); + } + + @Test + public void testSendHeartbeat() throws InterruptedException { + ZSession session = createSession("2"); + + Thread.sleep(1000); + WebResource wr = sessionsr.path(session.id); + Builder b = wr.accept(MediaType.APPLICATION_JSON); + + ClientResponse cr = b.put(ClientResponse.class, null); + assertEquals(ClientResponse.Status.OK, cr.getClientResponseStatus()); + + Thread.sleep(1500); + assertTrue(ZooKeeperService.isConnected(CONTEXT_PATH, session.id)); + + Thread.sleep(1000); + assertFalse(ZooKeeperService.isConnected(CONTEXT_PATH, session.id)); + } + + @Test + public void testCreateEphemeralZNode() + throws KeeperException, InterruptedException, IOException { + ZSession session = createSession("30"); + + WebResource wr = znodesr.path("/") + .queryParam("op", "create") + .queryParam("name", "ephemeral-test") + .queryParam("ephemeral", "true") + .queryParam("session", session.id) + .queryParam("null", "true"); + + Builder b = wr.accept(MediaType.APPLICATION_JSON); + ClientResponse cr = b.post(ClientResponse.class); + assertEquals(ClientResponse.Status.CREATED, cr.getClientResponseStatus()); + + Stat stat = new Stat(); + zk.getData("/ephemeral-test", false, stat); + + ZooKeeper sessionZK = ZooKeeperService.getClient(CONTEXT_PATH, session.id); + assertEquals(stat.getEphemeralOwner(), sessionZK.getSessionId()); + } +} diff --git a/src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/SetTest.java b/src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/SetTest.java new file mode 100644 index 0000000..cbcfd21 --- /dev/null +++ b/src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/SetTest.java @@ -0,0 +1,155 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.zookeeper.server.jersey; + +import java.util.Arrays; +import java.util.Collection; + +import javax.ws.rs.core.MediaType; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.apache.zookeeper.CreateMode; +import org.apache.zookeeper.WatchedEvent; +import org.apache.zookeeper.Watcher; +import org.apache.zookeeper.ZooDefs.Ids; +import org.apache.zookeeper.data.Stat; +import org.apache.zookeeper.server.jersey.jaxb.ZStat; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.junit.runners.Parameterized; +import org.junit.runners.Parameterized.Parameters; + +import com.sun.jersey.api.client.ClientResponse; +import com.sun.jersey.api.client.WebResource; +import com.sun.jersey.api.client.WebResource.Builder; + + +/** + * Test stand-alone server. + * + */ +@RunWith(Parameterized.class) +public class SetTest extends Base { + protected static final Logger LOG = LoggerFactory.getLogger(SetTest.class); + + private String accept; + private String path; + private String encoding; + private ClientResponse.Status expectedStatus; + private ZStat expectedStat; + private byte[] data; + + public static class MyWatcher implements Watcher { + public void process(WatchedEvent event) { + // FIXME ignore for now + } + } + + @Parameters + public static Collection data() throws Exception { + String baseZnode = Base.createBaseZNode(); + + return Arrays.asList(new Object[][] { + {MediaType.APPLICATION_JSON, baseZnode + "/s-t1", "utf8", + ClientResponse.Status.OK, + new ZStat(baseZnode + "/s-t1", null, null), null }, + {MediaType.APPLICATION_JSON, baseZnode + "/s-t2", "utf8", + ClientResponse.Status.OK, + new ZStat(baseZnode + "/s-t2", null, null), new byte[0] }, + {MediaType.APPLICATION_JSON, baseZnode + "/s-t3", "utf8", + ClientResponse.Status.OK, + new ZStat(baseZnode + "/s-t3", null, null), "foobar".getBytes() }, + {MediaType.APPLICATION_JSON, baseZnode + "/s-t4", "base64", + ClientResponse.Status.OK, + new ZStat(baseZnode + "/s-t4", null, null), null }, + {MediaType.APPLICATION_JSON, baseZnode + "/s-t5", "base64", + ClientResponse.Status.OK, + new ZStat(baseZnode + "/s-t5", null, null), new byte[0] }, + {MediaType.APPLICATION_JSON, baseZnode + "/s-t6", "base64", + ClientResponse.Status.OK, + new ZStat(baseZnode + "/s-t6", null, null), + "foobar".getBytes() }, + {MediaType.APPLICATION_JSON, baseZnode + "/dkdkdkd", "utf8", + ClientResponse.Status.NOT_FOUND, null, null }, + {MediaType.APPLICATION_JSON, baseZnode + "/dkdkdkd", "base64", + ClientResponse.Status.NOT_FOUND, null, null }, + }); + } + + public SetTest(String accept, String path, String encoding, + ClientResponse.Status status, ZStat expectedStat, byte[] data) + { + this.accept = accept; + this.path = path; + this.encoding = encoding; + this.expectedStatus = status; + this.expectedStat = expectedStat; + this.data = data; + } + + @Test + public void testSet() throws Exception { + LOG.info("STARTING " + getName()); + + if (expectedStat != null) { + zk.create(expectedStat.path, "initial".getBytes(), Ids.OPEN_ACL_UNSAFE, + CreateMode.PERSISTENT); + } + + WebResource wr = znodesr.path(path).queryParam("dataformat", encoding); + if (data == null) { + wr = wr.queryParam("null", "true"); + } + + Builder builder = wr.accept(accept) + .type(MediaType.APPLICATION_OCTET_STREAM); + + ClientResponse cr; + if (data == null) { + cr = builder.put(ClientResponse.class); + } else { + // this shouldn't be necessary (wrapping data with string) + // but without it there are problems on the server - ie it + // hangs for 30 seconds and doesn't get the data. + // TODO investigate + cr = builder.put(ClientResponse.class, new String(data)); + } + assertEquals(expectedStatus, cr.getClientResponseStatus()); + + if (expectedStat == null) { + return; + } + + ZStat zstat = cr.getEntity(ZStat.class); + assertEquals(expectedStat, zstat); + + // use out-of-band method to verify + byte[] data = zk.getData(zstat.path, false, new Stat()); + if (data == null && this.data == null) { + return; + } else if (data == null || this.data == null) { + fail((data == null ? null : new String(data)) + " == " + + (this.data == null ? null : new String(this.data))); + } else { + assertTrue(new String(data) + " == " + new String(this.data), + Arrays.equals(data, this.data)); + } + } +} diff --git a/src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/WadlTest.java b/src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/WadlTest.java new file mode 100644 index 0000000..4009e6d --- /dev/null +++ b/src/contrib/rest/src/test/org/apache/zookeeper/server/jersey/WadlTest.java @@ -0,0 +1,44 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.zookeeper.server.jersey; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.junit.Test; + +import com.sun.jersey.api.client.WebResource; +import com.sun.jersey.core.header.MediaTypes; + + +/** + * Test stand-alone server. + * + */ +public class WadlTest extends Base { + protected static final Logger LOG = LoggerFactory.getLogger(WadlTest.class); + + @Test + public void testApplicationWadl() { + WebResource r = client.resource(BASEURI); + String serviceWadl = r.path("application.wadl"). + accept(MediaTypes.WADL).get(String.class); + assertTrue("Something wrong. Returned wadl length not > 0.", + serviceWadl.length() > 0); + } +} diff --git a/src/contrib/rest/src/test/zkServer.sh b/src/contrib/rest/src/test/zkServer.sh new file mode 100644 index 0000000..bff85f3 --- /dev/null +++ b/src/contrib/rest/src/test/zkServer.sh @@ -0,0 +1,91 @@ +#!/bin/bash +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +if [ "x$1" == "x" ] +then + echo "USAGE: $0 startClean|start|stop hostPorts" + exit 2 +fi + +if [ "x$1" == "xstartClean" ] +then + if [ "x${base_dir}" == "x" ] + then + rm -rf /tmp/zkdata + else + rm -rf ${base_dir}/build/tmp + fi +fi + +# Make sure nothing is left over from before +if [ -r "/tmp/zk.pid" ] +then +pid=`cat /tmp/zk.pid` +kill -9 $pid +rm -f /tmp/zk.pid +fi + +if [ -r "${base_dir}/build/tmp/zk.pid" ] +then +pid=`cat ${base_dir}/build/tmp/zk.pid` +kill -9 $pid +rm -f ${base_dir}/build/tmp/zk.pid +fi + +if [ "x${base_dir}" == "x" ] +then +zk_base="../../../" +else +zk_base="${base_dir}" +fi + +CLASSPATH="$CLASSPATH:${zk_base}/build/classes" +CLASSPATH="$CLASSPATH:${zk_base}/conf" + +for i in "${zk_base}"/build/lib/*.jar +do + CLASSPATH="$CLASSPATH:$i" +done + +for i in "${zk_base}"/src/java/lib/*.jar +do + CLASSPATH="$CLASSPATH:$i" +done + +case $1 in +start|startClean) + if [ "x${base_dir}" == "x" ] + then + mkdir -p /tmp/zkdata + java -cp $CLASSPATH org.apache.zookeeper.server.ZooKeeperServerMain 22182 /tmp/zkdata &> /tmp/zk.log & + echo $! > /tmp/zk.pid + else + mkdir -p ${base_dir}/build/tmp/zkdata + java -cp $CLASSPATH org.apache.zookeeper.server.ZooKeeperServerMain 22182 ${base_dir}/build/tmp/zkdata &> ${base_dir}/build/tmp/zk.log & + echo $! > ${base_dir}/build/tmp/zk.pid + fi + sleep 5 + ;; +stop) + # Already killed above + ;; +*) + echo "Unknown command " + $1 + exit 2 +esac + diff --git a/src/contrib/zkfuse/Makefile.am b/src/contrib/zkfuse/Makefile.am new file mode 100644 index 0000000..36da1a5 --- /dev/null +++ b/src/contrib/zkfuse/Makefile.am @@ -0,0 +1,4 @@ +## Process this file with automake to produce Makefile.in + +SUBDIRS = src + diff --git a/src/contrib/zkfuse/README.txt b/src/contrib/zkfuse/README.txt new file mode 100644 index 0000000..901d363 --- /dev/null +++ b/src/contrib/zkfuse/README.txt @@ -0,0 +1,63 @@ +Original authors of zkfuse are Swee Lim & Bartlomiej M Niechwiej of Yahoo. +' +ZooKeeper FUSE (File System in Userspace) +========================================= + +Pre-requisites +-------------- +1. Linux system with 2.6.X kernel. +2. Fuse (Filesystem in Userspace) must be installed on the build node. +3. Development build libraries: + a. fuse + b. log4cxx + c. pthread + d. boost + +Build instructions +------------------ +1. cd into this directory +2. autoreconf -if +3. ./configure +4. make +5. zkfuse binary is under the src directory + +Testing Zkfuse +-------------- +1. Depending on permission on /dev/fuse, you may need to sudo -u root. + * If /dev/fuse has permissions 0600, then you have to run Zkfuse as root. + * If /dev/fuse has permissions 0666, then you can run Zkfuse as any user. +2. Create or find a mount point that you have "rwx" permission. + * e.g. mkdir -p /tmp/zkfuse +3. Run Zkfuse as follows: + zkfuse -z -m /tmp/zkfuse -d + -z specifies ZooKeeper address(es) : + -m specifies the mount point + -d specifies the debug mode. + For additional command line options, try "zkfuse -h". + +FAQ +--- +Q. How to fix "warning: macro `AM_PATH_CPPUNIT' not found in library"? +A. * install cppunit (src or pkg) on build machine + +Q. Why can't Zkfuse cannot write to current directory? +A. * If Zkfuse is running as root on a NFS mounted file system, it will not + have root permissions because root user is mapped to another user by + NFS admin. + * If you run Zkfuse as root, it is a good idea to run Zkfuse from a + directory that you have write access to. This will allow core files + to be saved. + +Q. Why Zkfuse cannot mount? +A. * Check that the mount point exists and you have "rwx" permissions. + * Check that previous mounts have been umounted. If Zkfuse does not + exit cleanly, its mount point may have to be umounted manually. + If you cannot umount manually, make sure that there no files is open + within the mount point. + +Q. Why does Zkfuse complain about logging at startup? +A. * Zkfuse uses log4cxx for logging. It is looking for log4cxx.properties + file to obtain its logging configuration. + * There is an example log4cxx.properties file in the Zkfuse source + directory. + diff --git a/src/contrib/zkfuse/build.xml b/src/contrib/zkfuse/build.xml new file mode 100644 index 0000000..f589453 --- /dev/null +++ b/src/contrib/zkfuse/build.xml @@ -0,0 +1,61 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/contrib/zkfuse/configure.ac b/src/contrib/zkfuse/configure.ac new file mode 100644 index 0000000..c86e7cd --- /dev/null +++ b/src/contrib/zkfuse/configure.ac @@ -0,0 +1,72 @@ +# -*- Autoconf -*- +# Process this file with autoconf to produce a configure script. + +AC_PREREQ(2.59) + +AC_INIT([zkfuse], [2.2.0]) +AM_INIT_AUTOMAKE(foreign) + +AC_CONFIG_SRCDIR([src/zkadapter.h]) +AM_CONFIG_HEADER([config.h]) + +PACKAGE=zkfuse +VERSION=1.0 + +AC_SUBST(PACKAGE) +AC_SUBST(VERSION) + +BUILD_PATH="`pwd`" + +# Checks for programs. +AC_LANG_CPLUSPLUS +AC_PROG_CXX + +# Checks for libraries. +AC_CHECK_LIB([fuse], [main]) +AC_CHECK_LIB([log4cxx], [main], [], [AC_MSG_ERROR("We need log4cxx to build zkfuse")]) +AC_CHECK_LIB([thread], [thr_create]) +AC_CHECK_LIB([pthread], [pthread_create]) +AC_CHECK_LIB([rt], [clock_gettime]) +AC_CHECK_LIB([socket], [socket]) +AC_CHECK_LIB([nsl], [gethostbyname]) +AC_CHECK_LIB([ulockmgr], [ulockmgr_op]) + +ZOOKEEPER_PATH=${BUILD_PATH}/../../c +ZOOKEEPER_BUILD_PATH=${BUILD_PATH}/../../../build/c +AC_CHECK_LIB(zookeeper_mt, main, [ZOOKEEPER_LD="-L${ZOOKEEPER_BUILD_PATH}/.libs -lzookeeper_mt"],,["-L${ZOOKEEPER_BUILD_PATH}/.libs"]) + +AC_SUBST(ZOOKEEPER_PATH) +AC_SUBST(ZOOKEEPER_LD) + +# Checks for header files. +AC_HEADER_DIRENT +AC_HEADER_STDC +AC_CHECK_HEADERS([fcntl.h stdlib.h string.h sys/time.h unistd.h]) +AC_CHECK_HEADERS([boost/shared_ptr.hpp boost/utility.hpp boost/weak_ptr.hpp],, AC_MSG_ERROR([boost library headers not found. Please install boost library.])) + +# Checks for typedefs, structures, and compiler characteristics. +AC_HEADER_STDBOOL +AC_C_CONST +AC_TYPE_UID_T +AC_C_INLINE +AC_TYPE_INT32_T +AC_TYPE_INT64_T +AC_TYPE_MODE_T +AC_TYPE_OFF_T +AC_TYPE_SIZE_T +AC_CHECK_MEMBERS([struct stat.st_blksize]) +AC_STRUCT_ST_BLOCKS +AC_HEADER_TIME +AC_TYPE_UINT32_T +AC_TYPE_UINT64_T +AC_TYPE_UINT8_T +AC_C_VOLATILE + +# Checks for library functions. +AC_FUNC_UTIME_NULL +AC_CHECK_FUNCS([gettimeofday memset mkdir rmdir strdup strerror strstr strtol strtoul strtoull utime]) + +AC_CONFIG_FILES([Makefile]) +AC_CONFIG_FILES([src/Makefile]) +AC_OUTPUT +AC_C_VOLATILE diff --git a/src/contrib/zkfuse/src/Makefile.am b/src/contrib/zkfuse/src/Makefile.am new file mode 100644 index 0000000..c0d87e3 --- /dev/null +++ b/src/contrib/zkfuse/src/Makefile.am @@ -0,0 +1,7 @@ +AM_CXXFLAGS = -I${ZOOKEEPER_PATH}/include -I${ZOOKEEPER_PATH}/generated \ + -I$(top_srcdir)/include -I/usr/include -D_FILE_OFFSET_BITS=64 -D_REENTRANT + +noinst_PROGRAMS = zkfuse + +zkfuse_SOURCES = zkfuse.cc zkadapter.cc thread.cc log.cc +zkfuse_LDADD = ${ZOOKEEPER_LD} \ No newline at end of file diff --git a/src/contrib/zkfuse/src/blockingqueue.h b/src/contrib/zkfuse/src/blockingqueue.h new file mode 100644 index 0000000..4677290 --- /dev/null +++ b/src/contrib/zkfuse/src/blockingqueue.h @@ -0,0 +1,154 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifndef __BLOCKINGQUEUE_H__ +#define __BLOCKINGQUEUE_H__ + +#include + +#include "mutex.h" + +using namespace std; +USING_ZKFUSE_NAMESPACE + +namespace zk { + +/** + * \brief An unbounded blocking queue of elements of type E. + * + *

    + * This class is thread safe. + */ +template +class BlockingQueue { + public: + + /** + * \brief Adds the specified element to this queue, waiting if necessary + * \brief for space to become available. + * + * @param e the element to be added + */ + void put(E e); + + /** + * \brief Retrieves and removes the head of this queue, waiting if + * \brief no elements are present in this queue. + * + * @param timeout how long to wait until an element becomes availabe, + * in milliseconds; if 0 then wait forever + * @param timedOut if not NULL then set to true whether this function timed out + * @return the element from the queue + */ + E take(int32_t timeout = 0, bool *timedOut = NULL); + + /** + * Returns the current size of this blocking queue. + * + * @return the number of elements in this queue + */ + int size() const; + + /** + * \brief Returns whether this queue is empty or not. + * + * @return true if this queue has no elements; false otherwise + */ + bool empty() const; + + private: + + /** + * The queue of elements. Deque is used to provide O(1) time + * for head elements removal. + */ + deque m_queue; + + /** + * The mutex used for queue synchronization. + */ + mutable zkfuse::Mutex m_mutex; + + /** + * The conditionial variable associated with the mutex above. + */ + mutable Cond m_cond; + +}; + +template +int BlockingQueue::size() const { + int size; + m_mutex.Acquire(); + size = m_queue.size(); + m_mutex.Release(); + return size; +} + +template +bool BlockingQueue::empty() const { + bool isEmpty; + m_mutex.Acquire(); + isEmpty = m_queue.empty(); + m_mutex.Release(); + return isEmpty; +} + +template +void BlockingQueue::put(E e) { + m_mutex.Acquire(); + m_queue.push_back( e ); + m_cond.Signal(); + m_mutex.Release(); +} + +template + E BlockingQueue::take(int32_t timeout, bool *timedOut) { + m_mutex.Acquire(); + bool hasResult = true; + while (m_queue.empty()) { + if (timeout <= 0) { + m_cond.Wait( m_mutex ); + } else { + if (!m_cond.Wait( m_mutex, timeout )) { + hasResult = false; + break; + } + } + } + if (hasResult) { + E e = m_queue.front(); + m_queue.pop_front(); + m_mutex.Release(); + if (timedOut) { + *timedOut = false; + } + return e; + } else { + m_mutex.Release(); + if (timedOut) { + *timedOut = true; + } + return E(); + } +} + +} + +#endif /* __BLOCKINGQUEUE_H__ */ + diff --git a/src/contrib/zkfuse/src/doxygen.cfg b/src/contrib/zkfuse/src/doxygen.cfg new file mode 100644 index 0000000..308b094 --- /dev/null +++ b/src/contrib/zkfuse/src/doxygen.cfg @@ -0,0 +1,1242 @@ +# Doxyfile 1.4.3 + +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +# This file describes the settings to be used by the documentation system +# doxygen (www.doxygen.org) for a project +# +# All text after a hash (#) is considered a comment and will be ignored +# The format is: +# TAG = value [value, ...] +# For lists items can also be appended using: +# TAG += value [value, ...] +# Values that contain spaces should be placed between quotes (" ") + +#--------------------------------------------------------------------------- +# Project related configuration options +#--------------------------------------------------------------------------- + +# The PROJECT_NAME tag is a single word (or a sequence of words surrounded +# by quotes) that should identify the project. + +PROJECT_NAME = ZkFuse + +# The PROJECT_NUMBER tag can be used to enter a project or revision number. +# This could be handy for archiving the generated documentation or +# if some version control system is used. + +PROJECT_NUMBER = + +# The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute) +# base path where the generated documentation will be put. +# If a relative path is entered, it will be relative to the location +# where doxygen was started. If left blank the current directory will be used. + +OUTPUT_DIRECTORY = doc + +# If the CREATE_SUBDIRS tag is set to YES, then doxygen will create +# 4096 sub-directories (in 2 levels) under the output directory of each output +# format and will distribute the generated files over these directories. +# Enabling this option can be useful when feeding doxygen a huge amount of +# source files, where putting all generated files in the same directory would +# otherwise cause performance problems for the file system. + +CREATE_SUBDIRS = NO + +# The OUTPUT_LANGUAGE tag is used to specify the language in which all +# documentation generated by doxygen is written. Doxygen will use this +# information to generate all constant output in the proper language. +# The default language is English, other supported languages are: +# Brazilian, Catalan, Chinese, Chinese-Traditional, Croatian, Czech, Danish, +# Dutch, Finnish, French, German, Greek, Hungarian, Italian, Japanese, +# Japanese-en (Japanese with English messages), Korean, Korean-en, Norwegian, +# Polish, Portuguese, Romanian, Russian, Serbian, Slovak, Slovene, Spanish, +# Swedish, and Ukrainian. + +OUTPUT_LANGUAGE = English + +# This tag can be used to specify the encoding used in the generated output. +# The encoding is not always determined by the language that is chosen, +# but also whether or not the output is meant for Windows or non-Windows users. +# In case there is a difference, setting the USE_WINDOWS_ENCODING tag to YES +# forces the Windows encoding (this is the default for the Windows binary), +# whereas setting the tag to NO uses a Unix-style encoding (the default for +# all platforms other than Windows). + +USE_WINDOWS_ENCODING = NO + +# If the BRIEF_MEMBER_DESC tag is set to YES (the default) Doxygen will +# include brief member descriptions after the members that are listed in +# the file and class documentation (similar to JavaDoc). +# Set to NO to disable this. + +BRIEF_MEMBER_DESC = YES + +# If the REPEAT_BRIEF tag is set to YES (the default) Doxygen will prepend +# the brief description of a member or function before the detailed description. +# Note: if both HIDE_UNDOC_MEMBERS and BRIEF_MEMBER_DESC are set to NO, the +# brief descriptions will be completely suppressed. + +REPEAT_BRIEF = YES + +# This tag implements a quasi-intelligent brief description abbreviator +# that is used to form the text in various listings. Each string +# in this list, if found as the leading text of the brief description, will be +# stripped from the text and the result after processing the whole list, is +# used as the annotated text. Otherwise, the brief description is used as-is. +# If left blank, the following values are used ("$name" is automatically +# replaced with the name of the entity): "The $name class" "The $name widget" +# "The $name file" "is" "provides" "specifies" "contains" +# "represents" "a" "an" "the" + +ABBREVIATE_BRIEF = + +# If the ALWAYS_DETAILED_SEC and REPEAT_BRIEF tags are both set to YES then +# Doxygen will generate a detailed section even if there is only a brief +# description. + +ALWAYS_DETAILED_SEC = NO + +# If the INLINE_INHERITED_MEMB tag is set to YES, doxygen will show all +# inherited members of a class in the documentation of that class as if those +# members were ordinary class members. Constructors, destructors and assignment +# operators of the base classes will not be shown. + +INLINE_INHERITED_MEMB = NO + +# If the FULL_PATH_NAMES tag is set to YES then Doxygen will prepend the full +# path before files name in the file list and in the header files. If set +# to NO the shortest path that makes the file name unique will be used. + +FULL_PATH_NAMES = YES + +# If the FULL_PATH_NAMES tag is set to YES then the STRIP_FROM_PATH tag +# can be used to strip a user-defined part of the path. Stripping is +# only done if one of the specified strings matches the left-hand part of +# the path. The tag can be used to show relative paths in the file list. +# If left blank the directory from which doxygen is run is used as the +# path to strip. + +STRIP_FROM_PATH = + +# The STRIP_FROM_INC_PATH tag can be used to strip a user-defined part of +# the path mentioned in the documentation of a class, which tells +# the reader which header file to include in order to use a class. +# If left blank only the name of the header file containing the class +# definition is used. Otherwise one should specify the include paths that +# are normally passed to the compiler using the -I flag. + +STRIP_FROM_INC_PATH = + +# If the SHORT_NAMES tag is set to YES, doxygen will generate much shorter +# (but less readable) file names. This can be useful is your file systems +# doesn't support long names like on DOS, Mac, or CD-ROM. + +SHORT_NAMES = NO + +# If the JAVADOC_AUTOBRIEF tag is set to YES then Doxygen +# will interpret the first line (until the first dot) of a JavaDoc-style +# comment as the brief description. If set to NO, the JavaDoc +# comments will behave just like the Qt-style comments (thus requiring an +# explicit @brief command for a brief description. + +JAVADOC_AUTOBRIEF = NO + +# The MULTILINE_CPP_IS_BRIEF tag can be set to YES to make Doxygen +# treat a multi-line C++ special comment block (i.e. a block of //! or /// +# comments) as a brief description. This used to be the default behaviour. +# The new default is to treat a multi-line C++ comment block as a detailed +# description. Set this tag to YES if you prefer the old behaviour instead. + +MULTILINE_CPP_IS_BRIEF = NO + +# If the DETAILS_AT_TOP tag is set to YES then Doxygen +# will output the detailed description near the top, like JavaDoc. +# If set to NO, the detailed description appears after the member +# documentation. + +DETAILS_AT_TOP = NO + +# If the INHERIT_DOCS tag is set to YES (the default) then an undocumented +# member inherits the documentation from any documented member that it +# re-implements. + +INHERIT_DOCS = YES + +# If member grouping is used in the documentation and the DISTRIBUTE_GROUP_DOC +# tag is set to YES, then doxygen will reuse the documentation of the first +# member in the group (if any) for the other members of the group. By default +# all members of a group must be documented explicitly. + +DISTRIBUTE_GROUP_DOC = NO + +# If the SEPARATE_MEMBER_PAGES tag is set to YES, then doxygen will produce +# a new page for each member. If set to NO, the documentation of a member will +# be part of the file/class/namespace that contains it. + +SEPARATE_MEMBER_PAGES = NO + +# The TAB_SIZE tag can be used to set the number of spaces in a tab. +# Doxygen uses this value to replace tabs by spaces in code fragments. + +TAB_SIZE = 8 + +# This tag can be used to specify a number of aliases that acts +# as commands in the documentation. An alias has the form "name=value". +# For example adding "sideeffect=\par Side Effects:\n" will allow you to +# put the command \sideeffect (or @sideeffect) in the documentation, which +# will result in a user-defined paragraph with heading "Side Effects:". +# You can put \n's in the value part of an alias to insert newlines. + +ALIASES = + +# Set the OPTIMIZE_OUTPUT_FOR_C tag to YES if your project consists of C +# sources only. Doxygen will then generate output that is more tailored for C. +# For instance, some of the names that are used will be different. The list +# of all members will be omitted, etc. + +OPTIMIZE_OUTPUT_FOR_C = NO + +# Set the OPTIMIZE_OUTPUT_JAVA tag to YES if your project consists of Java sources +# only. Doxygen will then generate output that is more tailored for Java. +# For instance, namespaces will be presented as packages, qualified scopes +# will look different, etc. + +OPTIMIZE_OUTPUT_JAVA = NO + +# Set the SUBGROUPING tag to YES (the default) to allow class member groups of +# the same type (for instance a group of public functions) to be put as a +# subgroup of that type (e.g. under the Public Functions section). Set it to +# NO to prevent subgrouping. Alternatively, this can be done per class using +# the \nosubgrouping command. + +SUBGROUPING = YES + +#--------------------------------------------------------------------------- +# Build related configuration options +#--------------------------------------------------------------------------- + +# If the EXTRACT_ALL tag is set to YES doxygen will assume all entities in +# documentation are documented, even if no documentation was available. +# Private class members and static file members will be hidden unless +# the EXTRACT_PRIVATE and EXTRACT_STATIC tags are set to YES + +EXTRACT_ALL = NO + +# If the EXTRACT_PRIVATE tag is set to YES all private members of a class +# will be included in the documentation. + +EXTRACT_PRIVATE = YES + +# If the EXTRACT_STATIC tag is set to YES all static members of a file +# will be included in the documentation. + +EXTRACT_STATIC = YES + +# If the EXTRACT_LOCAL_CLASSES tag is set to YES classes (and structs) +# defined locally in source files will be included in the documentation. +# If set to NO only classes defined in header files are included. + +EXTRACT_LOCAL_CLASSES = YES + +# This flag is only useful for Objective-C code. When set to YES local +# methods, which are defined in the implementation section but not in +# the interface are included in the documentation. +# If set to NO (the default) only methods in the interface are included. + +EXTRACT_LOCAL_METHODS = NO + +# If the HIDE_UNDOC_MEMBERS tag is set to YES, Doxygen will hide all +# undocumented members of documented classes, files or namespaces. +# If set to NO (the default) these members will be included in the +# various overviews, but no documentation section is generated. +# This option has no effect if EXTRACT_ALL is enabled. + +HIDE_UNDOC_MEMBERS = NO + +# If the HIDE_UNDOC_CLASSES tag is set to YES, Doxygen will hide all +# undocumented classes that are normally visible in the class hierarchy. +# If set to NO (the default) these classes will be included in the various +# overviews. This option has no effect if EXTRACT_ALL is enabled. + +HIDE_UNDOC_CLASSES = NO + +# If the HIDE_FRIEND_COMPOUNDS tag is set to YES, Doxygen will hide all +# friend (class|struct|union) declarations. +# If set to NO (the default) these declarations will be included in the +# documentation. + +HIDE_FRIEND_COMPOUNDS = NO + +# If the HIDE_IN_BODY_DOCS tag is set to YES, Doxygen will hide any +# documentation blocks found inside the body of a function. +# If set to NO (the default) these blocks will be appended to the +# function's detailed documentation block. + +HIDE_IN_BODY_DOCS = NO + +# The INTERNAL_DOCS tag determines if documentation +# that is typed after a \internal command is included. If the tag is set +# to NO (the default) then the documentation will be excluded. +# Set it to YES to include the internal documentation. + +INTERNAL_DOCS = NO + +# If the CASE_SENSE_NAMES tag is set to NO then Doxygen will only generate +# file names in lower-case letters. If set to YES upper-case letters are also +# allowed. This is useful if you have classes or files whose names only differ +# in case and if your file system supports case sensitive file names. Windows +# and Mac users are advised to set this option to NO. + +CASE_SENSE_NAMES = YES + +# If the HIDE_SCOPE_NAMES tag is set to NO (the default) then Doxygen +# will show members with their full class and namespace scopes in the +# documentation. If set to YES the scope will be hidden. + +HIDE_SCOPE_NAMES = NO + +# If the SHOW_INCLUDE_FILES tag is set to YES (the default) then Doxygen +# will put a list of the files that are included by a file in the documentation +# of that file. + +SHOW_INCLUDE_FILES = YES + +# If the INLINE_INFO tag is set to YES (the default) then a tag [inline] +# is inserted in the documentation for inline members. + +INLINE_INFO = YES + +# If the SORT_MEMBER_DOCS tag is set to YES (the default) then doxygen +# will sort the (detailed) documentation of file and class members +# alphabetically by member name. If set to NO the members will appear in +# declaration order. + +SORT_MEMBER_DOCS = YES + +# If the SORT_BRIEF_DOCS tag is set to YES then doxygen will sort the +# brief documentation of file, namespace and class members alphabetically +# by member name. If set to NO (the default) the members will appear in +# declaration order. + +SORT_BRIEF_DOCS = NO + +# If the SORT_BY_SCOPE_NAME tag is set to YES, the class list will be +# sorted by fully-qualified names, including namespaces. If set to +# NO (the default), the class list will be sorted only by class name, +# not including the namespace part. +# Note: This option is not very useful if HIDE_SCOPE_NAMES is set to YES. +# Note: This option applies only to the class list, not to the +# alphabetical list. + +SORT_BY_SCOPE_NAME = NO + +# The GENERATE_TODOLIST tag can be used to enable (YES) or +# disable (NO) the todo list. This list is created by putting \todo +# commands in the documentation. + +GENERATE_TODOLIST = YES + +# The GENERATE_TESTLIST tag can be used to enable (YES) or +# disable (NO) the test list. This list is created by putting \test +# commands in the documentation. + +GENERATE_TESTLIST = YES + +# The GENERATE_BUGLIST tag can be used to enable (YES) or +# disable (NO) the bug list. This list is created by putting \bug +# commands in the documentation. + +GENERATE_BUGLIST = YES + +# The GENERATE_DEPRECATEDLIST tag can be used to enable (YES) or +# disable (NO) the deprecated list. This list is created by putting +# \deprecated commands in the documentation. + +GENERATE_DEPRECATEDLIST= YES + +# The ENABLED_SECTIONS tag can be used to enable conditional +# documentation sections, marked by \if sectionname ... \endif. + +ENABLED_SECTIONS = + +# The MAX_INITIALIZER_LINES tag determines the maximum number of lines +# the initial value of a variable or define consists of for it to appear in +# the documentation. If the initializer consists of more lines than specified +# here it will be hidden. Use a value of 0 to hide initializers completely. +# The appearance of the initializer of individual variables and defines in the +# documentation can be controlled using \showinitializer or \hideinitializer +# command in the documentation regardless of this setting. + +MAX_INITIALIZER_LINES = 30 + +# Set the SHOW_USED_FILES tag to NO to disable the list of files generated +# at the bottom of the documentation of classes and structs. If set to YES the +# list will mention the files that were used to generate the documentation. + +SHOW_USED_FILES = YES + +# If the sources in your project are distributed over multiple directories +# then setting the SHOW_DIRECTORIES tag to YES will show the directory hierarchy +# in the documentation. + +SHOW_DIRECTORIES = YES + +# The FILE_VERSION_FILTER tag can be used to specify a program or script that +# doxygen should invoke to get the current version for each file (typically from the +# version control system). Doxygen will invoke the program by executing (via +# popen()) the command , where is the value of +# the FILE_VERSION_FILTER tag, and is the name of an input file +# provided by doxygen. Whatever the progam writes to standard output +# is used as the file version. See the manual for examples. + +FILE_VERSION_FILTER = + +#--------------------------------------------------------------------------- +# configuration options related to warning and progress messages +#--------------------------------------------------------------------------- + +# The QUIET tag can be used to turn on/off the messages that are generated +# by doxygen. Possible values are YES and NO. If left blank NO is used. + +QUIET = NO + +# The WARNINGS tag can be used to turn on/off the warning messages that are +# generated by doxygen. Possible values are YES and NO. If left blank +# NO is used. + +WARNINGS = YES + +# If WARN_IF_UNDOCUMENTED is set to YES, then doxygen will generate warnings +# for undocumented members. If EXTRACT_ALL is set to YES then this flag will +# automatically be disabled. + +WARN_IF_UNDOCUMENTED = YES + +# If WARN_IF_DOC_ERROR is set to YES, doxygen will generate warnings for +# potential errors in the documentation, such as not documenting some +# parameters in a documented function, or documenting parameters that +# don't exist or using markup commands wrongly. + +WARN_IF_DOC_ERROR = YES + +# This WARN_NO_PARAMDOC option can be abled to get warnings for +# functions that are documented, but have no documentation for their parameters +# or return value. If set to NO (the default) doxygen will only warn about +# wrong or incomplete parameter documentation, but not about the absence of +# documentation. + +WARN_NO_PARAMDOC = NO + +# The WARN_FORMAT tag determines the format of the warning messages that +# doxygen can produce. The string should contain the $file, $line, and $text +# tags, which will be replaced by the file and line number from which the +# warning originated and the warning text. Optionally the format may contain +# $version, which will be replaced by the version of the file (if it could +# be obtained via FILE_VERSION_FILTER) + +WARN_FORMAT = "$file:$line: $text" + +# The WARN_LOGFILE tag can be used to specify a file to which warning +# and error messages should be written. If left blank the output is written +# to stderr. + +WARN_LOGFILE = + +#--------------------------------------------------------------------------- +# configuration options related to the input files +#--------------------------------------------------------------------------- + +# The INPUT tag can be used to specify the files and/or directories that contain +# documented source files. You may enter file names like "myfile.cpp" or +# directories like "/usr/src/myproject". Separate the files or directories +# with spaces. + +INPUT = + +# If the value of the INPUT tag contains directories, you can use the +# FILE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp +# and *.h) to filter out the source-files in the directories. If left +# blank the following patterns are tested: +# *.c *.cc *.cxx *.cpp *.c++ *.java *.ii *.ixx *.ipp *.i++ *.inl *.h *.hh *.hxx +# *.hpp *.h++ *.idl *.odl *.cs *.php *.php3 *.inc *.m *.mm + +FILE_PATTERNS = + +# The RECURSIVE tag can be used to turn specify whether or not subdirectories +# should be searched for input files as well. Possible values are YES and NO. +# If left blank NO is used. + +RECURSIVE = NO + +# The EXCLUDE tag can be used to specify files and/or directories that should +# excluded from the INPUT source files. This way you can easily exclude a +# subdirectory from a directory tree whose root is specified with the INPUT tag. + +EXCLUDE = + +# The EXCLUDE_SYMLINKS tag can be used select whether or not files or +# directories that are symbolic links (a Unix filesystem feature) are excluded +# from the input. + +EXCLUDE_SYMLINKS = NO + +# If the value of the INPUT tag contains directories, you can use the +# EXCLUDE_PATTERNS tag to specify one or more wildcard patterns to exclude +# certain files from those directories. + +EXCLUDE_PATTERNS = + +# The EXAMPLE_PATH tag can be used to specify one or more files or +# directories that contain example code fragments that are included (see +# the \include command). + +EXAMPLE_PATH = + +# If the value of the EXAMPLE_PATH tag contains directories, you can use the +# EXAMPLE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp +# and *.h) to filter out the source-files in the directories. If left +# blank all files are included. + +EXAMPLE_PATTERNS = + +# If the EXAMPLE_RECURSIVE tag is set to YES then subdirectories will be +# searched for input files to be used with the \include or \dontinclude +# commands irrespective of the value of the RECURSIVE tag. +# Possible values are YES and NO. If left blank NO is used. + +EXAMPLE_RECURSIVE = NO + +# The IMAGE_PATH tag can be used to specify one or more files or +# directories that contain image that are included in the documentation (see +# the \image command). + +IMAGE_PATH = + +# The INPUT_FILTER tag can be used to specify a program that doxygen should +# invoke to filter for each input file. Doxygen will invoke the filter program +# by executing (via popen()) the command , where +# is the value of the INPUT_FILTER tag, and is the name of an +# input file. Doxygen will then use the output that the filter program writes +# to standard output. If FILTER_PATTERNS is specified, this tag will be +# ignored. + +INPUT_FILTER = + +# The FILTER_PATTERNS tag can be used to specify filters on a per file pattern +# basis. Doxygen will compare the file name with each pattern and apply the +# filter if there is a match. The filters are a list of the form: +# pattern=filter (like *.cpp=my_cpp_filter). See INPUT_FILTER for further +# info on how filters are used. If FILTER_PATTERNS is empty, INPUT_FILTER +# is applied to all files. + +FILTER_PATTERNS = + +# If the FILTER_SOURCE_FILES tag is set to YES, the input filter (if set using +# INPUT_FILTER) will be used to filter the input files when producing source +# files to browse (i.e. when SOURCE_BROWSER is set to YES). + +FILTER_SOURCE_FILES = NO + +#--------------------------------------------------------------------------- +# configuration options related to source browsing +#--------------------------------------------------------------------------- + +# If the SOURCE_BROWSER tag is set to YES then a list of source files will +# be generated. Documented entities will be cross-referenced with these sources. +# Note: To get rid of all source code in the generated output, make sure also +# VERBATIM_HEADERS is set to NO. + +SOURCE_BROWSER = NO + +# Setting the INLINE_SOURCES tag to YES will include the body +# of functions and classes directly in the documentation. + +INLINE_SOURCES = NO + +# Setting the STRIP_CODE_COMMENTS tag to YES (the default) will instruct +# doxygen to hide any special comment blocks from generated source code +# fragments. Normal C and C++ comments will always remain visible. + +STRIP_CODE_COMMENTS = YES + +# If the REFERENCED_BY_RELATION tag is set to YES (the default) +# then for each documented function all documented +# functions referencing it will be listed. + +REFERENCED_BY_RELATION = YES + +# If the REFERENCES_RELATION tag is set to YES (the default) +# then for each documented function all documented entities +# called/used by that function will be listed. + +REFERENCES_RELATION = YES + +# If the USE_HTAGS tag is set to YES then the references to source code +# will point to the HTML generated by the htags(1) tool instead of doxygen +# built-in source browser. The htags tool is part of GNU's global source +# tagging system (see http://www.gnu.org/software/global/global.html). You +# will need version 4.8.6 or higher. + +USE_HTAGS = NO + +# If the VERBATIM_HEADERS tag is set to YES (the default) then Doxygen +# will generate a verbatim copy of the header file for each class for +# which an include is specified. Set to NO to disable this. + +VERBATIM_HEADERS = YES + +#--------------------------------------------------------------------------- +# configuration options related to the alphabetical class index +#--------------------------------------------------------------------------- + +# If the ALPHABETICAL_INDEX tag is set to YES, an alphabetical index +# of all compounds will be generated. Enable this if the project +# contains a lot of classes, structs, unions or interfaces. + +ALPHABETICAL_INDEX = NO + +# If the alphabetical index is enabled (see ALPHABETICAL_INDEX) then +# the COLS_IN_ALPHA_INDEX tag can be used to specify the number of columns +# in which this list will be split (can be a number in the range [1..20]) + +COLS_IN_ALPHA_INDEX = 5 + +# In case all classes in a project start with a common prefix, all +# classes will be put under the same header in the alphabetical index. +# The IGNORE_PREFIX tag can be used to specify one or more prefixes that +# should be ignored while generating the index headers. + +IGNORE_PREFIX = + +#--------------------------------------------------------------------------- +# configuration options related to the HTML output +#--------------------------------------------------------------------------- + +# If the GENERATE_HTML tag is set to YES (the default) Doxygen will +# generate HTML output. + +GENERATE_HTML = YES + +# The HTML_OUTPUT tag is used to specify where the HTML docs will be put. +# If a relative path is entered the value of OUTPUT_DIRECTORY will be +# put in front of it. If left blank `html' will be used as the default path. + +HTML_OUTPUT = html + +# The HTML_FILE_EXTENSION tag can be used to specify the file extension for +# each generated HTML page (for example: .htm,.php,.asp). If it is left blank +# doxygen will generate files with .html extension. + +HTML_FILE_EXTENSION = .html + +# The HTML_HEADER tag can be used to specify a personal HTML header for +# each generated HTML page. If it is left blank doxygen will generate a +# standard header. + +HTML_HEADER = + +# The HTML_FOOTER tag can be used to specify a personal HTML footer for +# each generated HTML page. If it is left blank doxygen will generate a +# standard footer. + +HTML_FOOTER = + +# The HTML_STYLESHEET tag can be used to specify a user-defined cascading +# style sheet that is used by each HTML page. It can be used to +# fine-tune the look of the HTML output. If the tag is left blank doxygen +# will generate a default style sheet. Note that doxygen will try to copy +# the style sheet file to the HTML output directory, so don't put your own +# stylesheet in the HTML output directory as well, or it will be erased! + +HTML_STYLESHEET = + +# If the HTML_ALIGN_MEMBERS tag is set to YES, the members of classes, +# files or namespaces will be aligned in HTML using tables. If set to +# NO a bullet list will be used. + +HTML_ALIGN_MEMBERS = YES + +# If the GENERATE_HTMLHELP tag is set to YES, additional index files +# will be generated that can be used as input for tools like the +# Microsoft HTML help workshop to generate a compressed HTML help file (.chm) +# of the generated HTML documentation. + +GENERATE_HTMLHELP = NO + +# If the GENERATE_HTMLHELP tag is set to YES, the CHM_FILE tag can +# be used to specify the file name of the resulting .chm file. You +# can add a path in front of the file if the result should not be +# written to the html output directory. + +CHM_FILE = + +# If the GENERATE_HTMLHELP tag is set to YES, the HHC_LOCATION tag can +# be used to specify the location (absolute path including file name) of +# the HTML help compiler (hhc.exe). If non-empty doxygen will try to run +# the HTML help compiler on the generated index.hhp. + +HHC_LOCATION = + +# If the GENERATE_HTMLHELP tag is set to YES, the GENERATE_CHI flag +# controls if a separate .chi index file is generated (YES) or that +# it should be included in the master .chm file (NO). + +GENERATE_CHI = NO + +# If the GENERATE_HTMLHELP tag is set to YES, the BINARY_TOC flag +# controls whether a binary table of contents is generated (YES) or a +# normal table of contents (NO) in the .chm file. + +BINARY_TOC = NO + +# The TOC_EXPAND flag can be set to YES to add extra items for group members +# to the contents of the HTML help documentation and to the tree view. + +TOC_EXPAND = NO + +# The DISABLE_INDEX tag can be used to turn on/off the condensed index at +# top of each HTML page. The value NO (the default) enables the index and +# the value YES disables it. + +DISABLE_INDEX = NO + +# This tag can be used to set the number of enum values (range [1..20]) +# that doxygen will group on one line in the generated HTML documentation. + +ENUM_VALUES_PER_LINE = 4 + +# If the GENERATE_TREEVIEW tag is set to YES, a side panel will be +# generated containing a tree-like index structure (just like the one that +# is generated for HTML Help). For this to work a browser that supports +# JavaScript, DHTML, CSS and frames is required (for instance Mozilla 1.0+, +# Netscape 6.0+, Internet explorer 5.0+, or Konqueror). Windows users are +# probably better off using the HTML help feature. + +GENERATE_TREEVIEW = NO + +# If the treeview is enabled (see GENERATE_TREEVIEW) then this tag can be +# used to set the initial width (in pixels) of the frame in which the tree +# is shown. + +TREEVIEW_WIDTH = 250 + +#--------------------------------------------------------------------------- +# configuration options related to the LaTeX output +#--------------------------------------------------------------------------- + +# If the GENERATE_LATEX tag is set to YES (the default) Doxygen will +# generate Latex output. + +GENERATE_LATEX = YES + +# The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put. +# If a relative path is entered the value of OUTPUT_DIRECTORY will be +# put in front of it. If left blank `latex' will be used as the default path. + +LATEX_OUTPUT = latex + +# The LATEX_CMD_NAME tag can be used to specify the LaTeX command name to be +# invoked. If left blank `latex' will be used as the default command name. + +LATEX_CMD_NAME = latex + +# The MAKEINDEX_CMD_NAME tag can be used to specify the command name to +# generate index for LaTeX. If left blank `makeindex' will be used as the +# default command name. + +MAKEINDEX_CMD_NAME = makeindex + +# If the COMPACT_LATEX tag is set to YES Doxygen generates more compact +# LaTeX documents. This may be useful for small projects and may help to +# save some trees in general. + +COMPACT_LATEX = NO + +# The PAPER_TYPE tag can be used to set the paper type that is used +# by the printer. Possible values are: a4, a4wide, letter, legal and +# executive. If left blank a4wide will be used. + +PAPER_TYPE = a4wide + +# The EXTRA_PACKAGES tag can be to specify one or more names of LaTeX +# packages that should be included in the LaTeX output. + +EXTRA_PACKAGES = + +# The LATEX_HEADER tag can be used to specify a personal LaTeX header for +# the generated latex document. The header should contain everything until +# the first chapter. If it is left blank doxygen will generate a +# standard header. Notice: only use this tag if you know what you are doing! + +LATEX_HEADER = + +# If the PDF_HYPERLINKS tag is set to YES, the LaTeX that is generated +# is prepared for conversion to pdf (using ps2pdf). The pdf file will +# contain links (just like the HTML output) instead of page references +# This makes the output suitable for online browsing using a pdf viewer. + +PDF_HYPERLINKS = NO + +# If the USE_PDFLATEX tag is set to YES, pdflatex will be used instead of +# plain latex in the generated Makefile. Set this option to YES to get a +# higher quality PDF documentation. + +USE_PDFLATEX = NO + +# If the LATEX_BATCHMODE tag is set to YES, doxygen will add the \\batchmode. +# command to the generated LaTeX files. This will instruct LaTeX to keep +# running if errors occur, instead of asking the user for help. +# This option is also used when generating formulas in HTML. + +LATEX_BATCHMODE = NO + +# If LATEX_HIDE_INDICES is set to YES then doxygen will not +# include the index chapters (such as File Index, Compound Index, etc.) +# in the output. + +LATEX_HIDE_INDICES = NO + +#--------------------------------------------------------------------------- +# configuration options related to the RTF output +#--------------------------------------------------------------------------- + +# If the GENERATE_RTF tag is set to YES Doxygen will generate RTF output +# The RTF output is optimized for Word 97 and may not look very pretty with +# other RTF readers or editors. + +GENERATE_RTF = NO + +# The RTF_OUTPUT tag is used to specify where the RTF docs will be put. +# If a relative path is entered the value of OUTPUT_DIRECTORY will be +# put in front of it. If left blank `rtf' will be used as the default path. + +RTF_OUTPUT = rtf + +# If the COMPACT_RTF tag is set to YES Doxygen generates more compact +# RTF documents. This may be useful for small projects and may help to +# save some trees in general. + +COMPACT_RTF = NO + +# If the RTF_HYPERLINKS tag is set to YES, the RTF that is generated +# will contain hyperlink fields. The RTF file will +# contain links (just like the HTML output) instead of page references. +# This makes the output suitable for online browsing using WORD or other +# programs which support those fields. +# Note: wordpad (write) and others do not support links. + +RTF_HYPERLINKS = NO + +# Load stylesheet definitions from file. Syntax is similar to doxygen's +# config file, i.e. a series of assignments. You only have to provide +# replacements, missing definitions are set to their default value. + +RTF_STYLESHEET_FILE = + +# Set optional variables used in the generation of an rtf document. +# Syntax is similar to doxygen's config file. + +RTF_EXTENSIONS_FILE = + +#--------------------------------------------------------------------------- +# configuration options related to the man page output +#--------------------------------------------------------------------------- + +# If the GENERATE_MAN tag is set to YES (the default) Doxygen will +# generate man pages + +GENERATE_MAN = NO + +# The MAN_OUTPUT tag is used to specify where the man pages will be put. +# If a relative path is entered the value of OUTPUT_DIRECTORY will be +# put in front of it. If left blank `man' will be used as the default path. + +MAN_OUTPUT = man + +# The MAN_EXTENSION tag determines the extension that is added to +# the generated man pages (default is the subroutine's section .3) + +MAN_EXTENSION = .3 + +# If the MAN_LINKS tag is set to YES and Doxygen generates man output, +# then it will generate one additional man file for each entity +# documented in the real man page(s). These additional files +# only source the real man page, but without them the man command +# would be unable to find the correct page. The default is NO. + +MAN_LINKS = NO + +#--------------------------------------------------------------------------- +# configuration options related to the XML output +#--------------------------------------------------------------------------- + +# If the GENERATE_XML tag is set to YES Doxygen will +# generate an XML file that captures the structure of +# the code including all documentation. + +GENERATE_XML = NO + +# The XML_OUTPUT tag is used to specify where the XML pages will be put. +# If a relative path is entered the value of OUTPUT_DIRECTORY will be +# put in front of it. If left blank `xml' will be used as the default path. + +XML_OUTPUT = xml + +# The XML_SCHEMA tag can be used to specify an XML schema, +# which can be used by a validating XML parser to check the +# syntax of the XML files. + +XML_SCHEMA = + +# The XML_DTD tag can be used to specify an XML DTD, +# which can be used by a validating XML parser to check the +# syntax of the XML files. + +XML_DTD = + +# If the XML_PROGRAMLISTING tag is set to YES Doxygen will +# dump the program listings (including syntax highlighting +# and cross-referencing information) to the XML output. Note that +# enabling this will significantly increase the size of the XML output. + +XML_PROGRAMLISTING = YES + +#--------------------------------------------------------------------------- +# configuration options for the AutoGen Definitions output +#--------------------------------------------------------------------------- + +# If the GENERATE_AUTOGEN_DEF tag is set to YES Doxygen will +# generate an AutoGen Definitions (see autogen.sf.net) file +# that captures the structure of the code including all +# documentation. Note that this feature is still experimental +# and incomplete at the moment. + +GENERATE_AUTOGEN_DEF = NO + +#--------------------------------------------------------------------------- +# configuration options related to the Perl module output +#--------------------------------------------------------------------------- + +# If the GENERATE_PERLMOD tag is set to YES Doxygen will +# generate a Perl module file that captures the structure of +# the code including all documentation. Note that this +# feature is still experimental and incomplete at the +# moment. + +GENERATE_PERLMOD = NO + +# If the PERLMOD_LATEX tag is set to YES Doxygen will generate +# the necessary Makefile rules, Perl scripts and LaTeX code to be able +# to generate PDF and DVI output from the Perl module output. + +PERLMOD_LATEX = NO + +# If the PERLMOD_PRETTY tag is set to YES the Perl module output will be +# nicely formatted so it can be parsed by a human reader. This is useful +# if you want to understand what is going on. On the other hand, if this +# tag is set to NO the size of the Perl module output will be much smaller +# and Perl will parse it just the same. + +PERLMOD_PRETTY = YES + +# The names of the make variables in the generated doxyrules.make file +# are prefixed with the string contained in PERLMOD_MAKEVAR_PREFIX. +# This is useful so different doxyrules.make files included by the same +# Makefile don't overwrite each other's variables. + +PERLMOD_MAKEVAR_PREFIX = + +#--------------------------------------------------------------------------- +# Configuration options related to the preprocessor +#--------------------------------------------------------------------------- + +# If the ENABLE_PREPROCESSING tag is set to YES (the default) Doxygen will +# evaluate all C-preprocessor directives found in the sources and include +# files. + +ENABLE_PREPROCESSING = YES + +# If the MACRO_EXPANSION tag is set to YES Doxygen will expand all macro +# names in the source code. If set to NO (the default) only conditional +# compilation will be performed. Macro expansion can be done in a controlled +# way by setting EXPAND_ONLY_PREDEF to YES. + +MACRO_EXPANSION = NO + +# If the EXPAND_ONLY_PREDEF and MACRO_EXPANSION tags are both set to YES +# then the macro expansion is limited to the macros specified with the +# PREDEFINED and EXPAND_AS_PREDEFINED tags. + +EXPAND_ONLY_PREDEF = NO + +# If the SEARCH_INCLUDES tag is set to YES (the default) the includes files +# in the INCLUDE_PATH (see below) will be search if a #include is found. + +SEARCH_INCLUDES = YES + +# The INCLUDE_PATH tag can be used to specify one or more directories that +# contain include files that are not input files but should be processed by +# the preprocessor. + +INCLUDE_PATH = + +# You can use the INCLUDE_FILE_PATTERNS tag to specify one or more wildcard +# patterns (like *.h and *.hpp) to filter out the header-files in the +# directories. If left blank, the patterns specified with FILE_PATTERNS will +# be used. + +INCLUDE_FILE_PATTERNS = + +# The PREDEFINED tag can be used to specify one or more macro names that +# are defined before the preprocessor is started (similar to the -D option of +# gcc). The argument of the tag is a list of macros of the form: name +# or name=definition (no spaces). If the definition and the = are +# omitted =1 is assumed. To prevent a macro definition from being +# undefined via #undef or recursively expanded use the := operator +# instead of the = operator. + +PREDEFINED = + +# If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then +# this tag can be used to specify a list of macro names that should be expanded. +# The macro definition that is found in the sources will be used. +# Use the PREDEFINED tag if you want to use a different macro definition. + +EXPAND_AS_DEFINED = + +# If the SKIP_FUNCTION_MACROS tag is set to YES (the default) then +# doxygen's preprocessor will remove all function-like macros that are alone +# on a line, have an all uppercase name, and do not end with a semicolon. Such +# function macros are typically used for boiler-plate code, and will confuse +# the parser if not removed. + +SKIP_FUNCTION_MACROS = YES + +#--------------------------------------------------------------------------- +# Configuration::additions related to external references +#--------------------------------------------------------------------------- + +# The TAGFILES option can be used to specify one or more tagfiles. +# Optionally an initial location of the external documentation +# can be added for each tagfile. The format of a tag file without +# this location is as follows: +# TAGFILES = file1 file2 ... +# Adding location for the tag files is done as follows: +# TAGFILES = file1=loc1 "file2 = loc2" ... +# where "loc1" and "loc2" can be relative or absolute paths or +# URLs. If a location is present for each tag, the installdox tool +# does not have to be run to correct the links. +# Note that each tag file must have a unique name +# (where the name does NOT include the path) +# If a tag file is not located in the directory in which doxygen +# is run, you must also specify the path to the tagfile here. + +TAGFILES = + +# When a file name is specified after GENERATE_TAGFILE, doxygen will create +# a tag file that is based on the input files it reads. + +GENERATE_TAGFILE = + +# If the ALLEXTERNALS tag is set to YES all external classes will be listed +# in the class index. If set to NO only the inherited external classes +# will be listed. + +ALLEXTERNALS = NO + +# If the EXTERNAL_GROUPS tag is set to YES all external groups will be listed +# in the modules index. If set to NO, only the current project's groups will +# be listed. + +EXTERNAL_GROUPS = YES + +# The PERL_PATH should be the absolute path and name of the perl script +# interpreter (i.e. the result of `which perl'). + +PERL_PATH = /usr/bin/perl + +#--------------------------------------------------------------------------- +# Configuration options related to the dot tool +#--------------------------------------------------------------------------- + +# If the CLASS_DIAGRAMS tag is set to YES (the default) Doxygen will +# generate a inheritance diagram (in HTML, RTF and LaTeX) for classes with base +# or super classes. Setting the tag to NO turns the diagrams off. Note that +# this option is superseded by the HAVE_DOT option below. This is only a +# fallback. It is recommended to install and use dot, since it yields more +# powerful graphs. + +CLASS_DIAGRAMS = YES + +# If set to YES, the inheritance and collaboration graphs will hide +# inheritance and usage relations if the target is undocumented +# or is not a class. + +HIDE_UNDOC_RELATIONS = YES + +# If you set the HAVE_DOT tag to YES then doxygen will assume the dot tool is +# available from the path. This tool is part of Graphviz, a graph visualization +# toolkit from AT&T and Lucent Bell Labs. The other options in this section +# have no effect if this option is set to NO (the default) + +HAVE_DOT = NO + +# If the CLASS_GRAPH and HAVE_DOT tags are set to YES then doxygen +# will generate a graph for each documented class showing the direct and +# indirect inheritance relations. Setting this tag to YES will force the +# the CLASS_DIAGRAMS tag to NO. + +CLASS_GRAPH = YES + +# If the COLLABORATION_GRAPH and HAVE_DOT tags are set to YES then doxygen +# will generate a graph for each documented class showing the direct and +# indirect implementation dependencies (inheritance, containment, and +# class references variables) of the class with other documented classes. + +COLLABORATION_GRAPH = YES + +# If the GROUP_GRAPHS and HAVE_DOT tags are set to YES then doxygen +# will generate a graph for groups, showing the direct groups dependencies + +GROUP_GRAPHS = YES + +# If the UML_LOOK tag is set to YES doxygen will generate inheritance and +# collaboration diagrams in a style similar to the OMG's Unified Modeling +# Language. + +UML_LOOK = NO + +# If set to YES, the inheritance and collaboration graphs will show the +# relations between templates and their instances. + +TEMPLATE_RELATIONS = NO + +# If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDE_GRAPH, and HAVE_DOT +# tags are set to YES then doxygen will generate a graph for each documented +# file showing the direct and indirect include dependencies of the file with +# other documented files. + +INCLUDE_GRAPH = YES + +# If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDED_BY_GRAPH, and +# HAVE_DOT tags are set to YES then doxygen will generate a graph for each +# documented header file showing the documented files that directly or +# indirectly include this file. + +INCLUDED_BY_GRAPH = YES + +# If the CALL_GRAPH and HAVE_DOT tags are set to YES then doxygen will +# generate a call dependency graph for every global function or class method. +# Note that enabling this option will significantly increase the time of a run. +# So in most cases it will be better to enable call graphs for selected +# functions only using the \callgraph command. + +CALL_GRAPH = NO + +# If the GRAPHICAL_HIERARCHY and HAVE_DOT tags are set to YES then doxygen +# will graphical hierarchy of all classes instead of a textual one. + +GRAPHICAL_HIERARCHY = YES + +# If the DIRECTORY_GRAPH, SHOW_DIRECTORIES and HAVE_DOT tags are set to YES +# then doxygen will show the dependencies a directory has on other directories +# in a graphical way. The dependency relations are determined by the #include +# relations between the files in the directories. + +DIRECTORY_GRAPH = YES + +# The DOT_IMAGE_FORMAT tag can be used to set the image format of the images +# generated by dot. Possible values are png, jpg, or gif +# If left blank png will be used. + +DOT_IMAGE_FORMAT = png + +# The tag DOT_PATH can be used to specify the path where the dot tool can be +# found. If left blank, it is assumed the dot tool can be found in the path. + +DOT_PATH = + +# The DOTFILE_DIRS tag can be used to specify one or more directories that +# contain dot files that are included in the documentation (see the +# \dotfile command). + +DOTFILE_DIRS = + +# The MAX_DOT_GRAPH_WIDTH tag can be used to set the maximum allowed width +# (in pixels) of the graphs generated by dot. If a graph becomes larger than +# this value, doxygen will try to truncate the graph, so that it fits within +# the specified constraint. Beware that most browsers cannot cope with very +# large images. + +MAX_DOT_GRAPH_WIDTH = 1024 + +# The MAX_DOT_GRAPH_HEIGHT tag can be used to set the maximum allows height +# (in pixels) of the graphs generated by dot. If a graph becomes larger than +# this value, doxygen will try to truncate the graph, so that it fits within +# the specified constraint. Beware that most browsers cannot cope with very +# large images. + +MAX_DOT_GRAPH_HEIGHT = 1024 + +# The MAX_DOT_GRAPH_DEPTH tag can be used to set the maximum depth of the +# graphs generated by dot. A depth value of 3 means that only nodes reachable +# from the root by following a path via at most 3 edges will be shown. Nodes +# that lay further from the root node will be omitted. Note that setting this +# option to 1 or 2 may greatly reduce the computation time needed for large +# code bases. Also note that a graph may be further truncated if the graph's +# image dimensions are not sufficient to fit the graph (see MAX_DOT_GRAPH_WIDTH +# and MAX_DOT_GRAPH_HEIGHT). If 0 is used for the depth value (the default), +# the graph is not depth-constrained. + +MAX_DOT_GRAPH_DEPTH = 0 + +# Set the DOT_TRANSPARENT tag to YES to generate images with a transparent +# background. This is disabled by default, which results in a white background. +# Warning: Depending on the platform used, enabling this option may lead to +# badly anti-aliased labels on the edges of a graph (i.e. they become hard to +# read). + +DOT_TRANSPARENT = NO + +# Set the DOT_MULTI_TARGETS tag to YES allow dot to generate multiple output +# files in one run (i.e. multiple -o and -T options on the command line). This +# makes dot run faster, but since only newer versions of dot (>1.8.10) +# support this, this feature is disabled by default. + +DOT_MULTI_TARGETS = NO + +# If the GENERATE_LEGEND tag is set to YES (the default) Doxygen will +# generate a legend page explaining the meaning of the various boxes and +# arrows in the dot generated graphs. + +GENERATE_LEGEND = YES + +# If the DOT_CLEANUP tag is set to YES (the default) Doxygen will +# remove the intermediate dot files that are used to generate +# the various graphs. + +DOT_CLEANUP = YES + +#--------------------------------------------------------------------------- +# Configuration::additions related to the search engine +#--------------------------------------------------------------------------- + +# The SEARCHENGINE tag specifies whether or not a search engine should be +# used. If set to NO the values of all tags below this one will be ignored. + +SEARCHENGINE = NO diff --git a/src/contrib/zkfuse/src/event.cc b/src/contrib/zkfuse/src/event.cc new file mode 100644 index 0000000..541657e --- /dev/null +++ b/src/contrib/zkfuse/src/event.cc @@ -0,0 +1,29 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#include "event.h" + +#define LOG_LEVEL LOG_FATAL +#define MODULE_NAME "Event" + +using namespace std; + +namespace zkfuse { + +} /* end of 'namespace zkfuse' */ + diff --git a/src/contrib/zkfuse/src/event.h b/src/contrib/zkfuse/src/event.h new file mode 100644 index 0000000..936ecc6 --- /dev/null +++ b/src/contrib/zkfuse/src/event.h @@ -0,0 +1,553 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifndef __EVENT_H__ +#define __EVENT_H__ + +#include +#include +#include +#include +#ifdef GCC4 +# include +using namespace std::tr1; +#else +# include +using namespace boost; +#endif + +#include "log.h" +#include "blockingqueue.h" +#include "mutex.h" +#include "thread.h" + +using namespace std; +using namespace zk; + +namespace zkfuse { + +//forward declaration of EventSource +template +class EventSource; + +/** + * \brief This interface is implemented by an observer + * \brief of a particular {@link EventSource}. + */ +template +class EventListener { + public: + + /** + * \brief This method is invoked whenever an event + * \brief has been received by the event source being observed. + * + * @param source the source the triggered the event + * @param e the actual event being triggered + */ + virtual void eventReceived(const EventSource &source, const E &e) = 0; +}; + +/** + * \brief This class represents a source of events. + * + *

    + * Each source can have many observers (listeners) attached to it + * and in case of an event, this source may propagate the event + * using {@link #fireEvent} method. + */ +template +class EventSource { + public: + + /** + * \brief The type corresponding to the list of registered event listeners. + */ + typedef set *> EventListeners; + + /** + * \brief Registers a new event listener. + * + * @param listener the listener to be added to the set of listeners + */ + void addListener(EventListener *listener) { + m_listeners.insert( listener ); + } + + /** + * \brief Removes an already registered listener. + * + * @param listener the listener to be removed + */ + void removeListener(EventListener *listener) { + m_listeners.erase( listener ); + } + + /** + * \brief Destructor. + */ + virtual ~EventSource() {} + + protected: + + /** + * \brief Fires the given event to all registered listeners. + * + *

    + * This method essentially iterates over all listeners + * and invokes {@link fireEvent(EventListener *listener, const E &event)} + * for each element. All derived classes are free to + * override the method to provide better error handling + * than the default implementation. + * + * @param event the event to be propagated to all listeners + */ + void fireEvent(const E &event); + + /** + * \brief Sends an event to the given listener. + * + * @param listener the listener to whom pass the event + * @param event the event to be handled + */ + virtual void fireEvent(EventListener *listener, const E &event); + + private: + + /** + * The set of registered event listeners. + */ + EventListeners m_listeners; + +}; + +/** + * \brief The interface of a generic event wrapper. + */ +class AbstractEventWrapper { + public: + + /** + * \brief Destructor. + */ + virtual ~AbstractEventWrapper() {} + + /** + * \brief Returns the underlying wrapee's data. + */ + virtual void *getWrapee() = 0; +}; + +/** + * \brief A template based implementation of {@link AbstractEventWrapper}. + */ +template +class EventWrapper : public AbstractEventWrapper { + public: + EventWrapper(const E &e) : m_e(e) { + } + void *getWrapee() { + return &m_e; + } + private: + E m_e; +}; + +/** + * \brief This class represents a generic event. + */ +class GenericEvent { + public: + + /** + * \brief Constructor. + */ + GenericEvent() : m_type(0) {} + + /** + * \brief Constructor. + * + * @param type the type of this event + * @param eventWarpper the wrapper around event's data + */ + GenericEvent(int type, AbstractEventWrapper *eventWrapper) : + m_type(type), m_eventWrapper(eventWrapper) { + } + + /** + * \brief Returns the type of this event. + * + * @return type of this event + */ + int getType() const { return m_type; } + + /** + * \brief Returns the event's data. + * + * @return the event's data + */ + void *getEvent() const { return m_eventWrapper->getWrapee(); } + + private: + + /** + * The event type. + */ + int m_type; + + /** + * The event represented as abstract wrapper. + */ + boost::shared_ptr m_eventWrapper; + +}; + +/** + * \brief This class adapts {@link EventListener} to a generic listener. + * Essentially this class listens on incoming events and fires them + * as {@link GenericEvent}s. + */ +template +class EventListenerAdapter : public virtual EventListener, + public virtual EventSource +{ + public: + + /** + * \brief Constructor. + * + * @param eventSource the source on which register this listener + */ + EventListenerAdapter(EventSource &eventSource) { + eventSource.addListener(this); + } + + void eventReceived(const EventSource &source, const E &e) { + AbstractEventWrapper *wrapper = new EventWrapper(e); + GenericEvent event(type, wrapper); + fireEvent( event ); + } + +}; + +/** + * \brief This class provides an adapter between an asynchronous and synchronous + * \brief event handling. + * + *

    + * This class queues up all received events and exposes them through + * {@link #getNextEvent()} method. + */ +template +class SynchronousEventAdapter : public EventListener { + public: + + void eventReceived(const EventSource &source, const E &e) { + m_queue.put( e ); + } + + /** + * \brief Returns the next available event from the underlying queue, + * \brief possibly blocking, if no data is available. + * + * @return the next available event + */ + E getNextEvent() { + return m_queue.take(); + } + + /** + * \brief Returns whether there are any events in the queue or not. + * + * @return true if there is at least one event and + * the next call to {@link #getNextEvent} won't block + */ + bool hasEvents() const { + return (m_queue.empty() ? false : true); + } + + /** + * \brief Destructor. + */ + virtual ~SynchronousEventAdapter() {} + + private: + + /** + * The blocking queue of all events received so far. + */ + BlockingQueue m_queue; + +}; + +/** + * This typedef defines the type of a timer Id. + */ +typedef int32_t TimerId; + +/** + * This class represents a timer event parametrized by the user's data type. + */ +template +class TimerEvent { + public: + + /** + * \brief Constructor. + * + * @param id the ID of this event + * @param alarmTime when this event is to be triggered + * @param userData the user data associated with this event + */ + TimerEvent(TimerId id, int64_t alarmTime, const T &userData) : + m_id(id), m_alarmTime(alarmTime), m_userData(userData) + {} + + /** + * \brief Constructor. + */ + TimerEvent() : m_id(-1), m_alarmTime(-1) {} + + /** + * \brief Returns the ID. + * + * @return the ID of this event + */ + TimerId getID() const { return m_id; } + + /** + * \brief Returns the alarm time. + * + * @return the alarm time + */ + int64_t getAlarmTime() const { return m_alarmTime; } + + /** + * \brief Returns the user's data. + * + * @return the user's data + */ + T const &getUserData() const { return m_userData; } + + /** + * \brief Returns whether the given alarm time is less than this event's + * \brief time. + */ + bool operator<(const int64_t alarmTime) const { + return m_alarmTime < alarmTime; + } + + private: + + /** + * The ID of ths event. + */ + TimerId m_id; + + /** + * The time at which this event triggers. + */ + int64_t m_alarmTime; + + /** + * The user specific data associated with this event. + */ + T m_userData; + +}; + +template +class Timer : public EventSource > { + public: + + /** + * \brief Constructor. + */ + Timer() : m_currentEventID(0), m_terminating(false) { + m_workerThread.Create( *this, &Timer::sendAlarms ); + } + + /** + * \brief Destructor. + */ + ~Timer() { + m_terminating = true; + m_lock.notify(); + m_workerThread.Join(); + } + + /** + * \brief Schedules the given event timeFromNow milliseconds. + * + * @param timeFromNow time from now, in milliseconds, when the event + * should be triggered + * @param userData the user data associated with the timer event + * + * @return the ID of the newly created timer event + */ + TimerId scheduleAfter(int64_t timeFromNow, const T &userData) { + return scheduleAt( getCurrentTimeMillis() + timeFromNow, userData ); + } + + /** + * \brief Schedules an event at the given time. + * + * @param absTime absolute time, in milliseconds, at which the event + * should be triggered; the time is measured + * from Jan 1st, 1970 + * @param userData the user data associated with the timer event + * + * @return the ID of the newly created timer event + */ + TimerId scheduleAt(int64_t absTime, const T &userData) { + m_lock.lock(); + typename QueueType::iterator pos = + lower_bound( m_queue.begin(), m_queue.end(), absTime ); + TimerId id = m_currentEventID++; + TimerEvent event(id, absTime, userData); + m_queue.insert( pos, event ); + m_lock.notify(); + m_lock.unlock(); + return id; + } + + /** + * \brief Returns the current time since Jan 1, 1970, in milliseconds. + * + * @return the current time in milliseconds + */ + static int64_t getCurrentTimeMillis() { + struct timeval now; + gettimeofday( &now, NULL ); + return now.tv_sec * 1000LL + now.tv_usec / 1000; + } + + /** + * \brief Cancels the given timer event. + * + * + * @param eventID the ID of the event to be canceled + * + * @return whether the event has been canceled + */ + bool cancelAlarm(TimerId eventID) { + bool canceled = false; + m_lock.lock(); + typename QueueType::iterator i; + for (i = m_queue.begin(); i != m_queue.end(); ++i) { + if (eventID == i->getID()) { + m_queue.erase( i ); + canceled = true; + break; + } + } + m_lock.unlock(); + return canceled; + } + + /** + * Executes the main loop of the worker thread. + */ + void sendAlarms() { + //iterate until terminating + while (!m_terminating) { + m_lock.lock(); + //1 step - wait until there is an event in the queue + if (m_queue.empty()) { + //wait up to 100ms to get next event + m_lock.wait( 100 ); + } + bool fire = false; + if (!m_queue.empty()) { + //retrieve the event from the queue and send it + TimerEvent event = m_queue.front(); + //check whether we can send it right away + int64_t timeToWait = + event.getAlarmTime() - getCurrentTimeMillis(); + if (timeToWait <= 0) { + m_queue.pop_front(); + //we fire only if it's still in the queue and alarm + //time has just elapsed (in case the top event + //is canceled) + fire = true; + } else { + m_lock.wait( timeToWait ); + } + m_lock.unlock(); + if (fire) { + fireEvent( event ); + } + } else { + m_lock.unlock(); + } + } + } + + private: + + /** + * The type of timer events queue. + */ + typedef deque > QueueType; + + /** + * The current event ID, auto-incremented each time a new event + * is created. + */ + TimerId m_currentEventID; + + /** + * The queue of timer events sorted by {@link TimerEvent#alarmTime}. + */ + QueueType m_queue; + + /** + * The lock used to guard {@link #m_queue}. + */ + Lock m_lock; + + /** + * The thread that triggers alarms. + */ + CXXThread > m_workerThread; + + /** + * Whether {@link #m_workerThread} is terminating. + */ + volatile bool m_terminating; + +}; + +template +void EventSource::fireEvent(const E &event) { + for (typename EventListeners::iterator i = m_listeners.begin(); + i != m_listeners.end(); + ++i) + { + fireEvent( *i, event ); + } +} + +template +void EventSource::fireEvent(EventListener *listener, const E &event) { + listener->eventReceived( *this, event ); +} + +} /* end of 'namespace zkfuse' */ + +#endif /* __EVENT_H__ */ diff --git a/src/contrib/zkfuse/src/log.cc b/src/contrib/zkfuse/src/log.cc new file mode 100644 index 0000000..e2bfb0d --- /dev/null +++ b/src/contrib/zkfuse/src/log.cc @@ -0,0 +1,36 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#include + +#include "log.h" + +using namespace std; + +/** + * \brief This class encapsulates a log4cxx configuration. + */ +class LogConfiguration { + public: + LogConfiguration(const string &file) { + PropertyConfigurator::configureAndWatch( file, 5000 ); + } +}; + +//enforces the configuration to be initialized +static LogConfiguration logConfig( "log4cxx.properties" ); diff --git a/src/contrib/zkfuse/src/log.h b/src/contrib/zkfuse/src/log.h new file mode 100644 index 0000000..aefce10 --- /dev/null +++ b/src/contrib/zkfuse/src/log.h @@ -0,0 +1,116 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifndef __LOG_H__ +#define __LOG_H__ + +#define ZKFUSE_NAMESPACE zkfuse +#define START_ZKFUSE_NAMESPACE namespace ZKFUSE_NAMESPACE { +#define END_ZKFUSE_NAMESPACE } +#define USING_ZKFUSE_NAMESPACE using namespace ZKFUSE_NAMESPACE; + +#include +#include +#include + +#include +#include +#include +using namespace log4cxx; +using namespace log4cxx::helpers; + +#define PRINTIP(x) ((uint8_t*)&x)[0], ((uint8_t*)&x)[1], \ + ((uint8_t*)&x)[2], ((uint8_t*)&x)[3] + +#define IPFMT "%u.%u.%u.%u" + +#define DECLARE_LOGGER(varName) \ +extern LoggerPtr varName; + +#define DEFINE_LOGGER(varName, logName) \ +static LoggerPtr varName = Logger::getLogger( logName ); + +#define MAX_BUFFER_SIZE 20000 + +#define SPRINTF_LOG_MSG(buffer, fmt, args...) \ + char buffer[MAX_BUFFER_SIZE]; \ + snprintf( buffer, MAX_BUFFER_SIZE, fmt, ##args ); + +// older versions of log4cxx don't support tracing +#ifdef LOG4CXX_TRACE +#define LOG_TRACE(logger, fmt, args...) \ + if (logger->isTraceEnabled()) { \ + SPRINTF_LOG_MSG( __tmp, fmt, ##args ); \ + LOG4CXX_TRACE( logger, __tmp ); \ + } +#else +#define LOG_TRACE(logger, fmt, args...) \ + if (logger->isDebugEnabled()) { \ + SPRINTF_LOG_MSG( __tmp, fmt, ##args ); \ + LOG4CXX_DEBUG( logger, __tmp ); \ + } +#endif + +#define LOG_DEBUG(logger, fmt, args...) \ + if (logger->isDebugEnabled()) { \ + SPRINTF_LOG_MSG( __tmp, fmt, ##args ); \ + LOG4CXX_DEBUG( logger, __tmp ); \ + } + +#define LOG_INFO(logger, fmt, args...) \ + if (logger->isInfoEnabled()) { \ + SPRINTF_LOG_MSG( __tmp, fmt, ##args ); \ + LOG4CXX_INFO( logger, __tmp ); \ + } + +#define LOG_WARN(logger, fmt, args...) \ + if (logger->isWarnEnabled()) { \ + SPRINTF_LOG_MSG( __tmp, fmt, ##args ); \ + LOG4CXX_WARN( logger, __tmp ); \ + } + +#define LOG_ERROR(logger, fmt, args...) \ + if (logger->isErrorEnabled()) { \ + SPRINTF_LOG_MSG( __tmp, fmt, ##args ); \ + LOG4CXX_ERROR( logger, __tmp ); \ + } + +#define LOG_FATAL(logger, fmt, args...) \ + if (logger->isFatalEnabled()) { \ + SPRINTF_LOG_MSG( __tmp, fmt, ##args ); \ + LOG4CXX_FATAL( logger, __tmp ); \ + } + +#ifdef DISABLE_TRACE +# define TRACE(logger, x) +#else +# define TRACE(logger, x) \ +class Trace { \ + public: \ + Trace(const void* p) : _p(p) { \ + LOG_TRACE(logger, "%s %p Enter", __PRETTY_FUNCTION__, p); \ + } \ + ~Trace() { \ + LOG_TRACE(logger, "%s %p Exit", __PRETTY_FUNCTION__, _p); \ + } \ + const void* _p; \ +} traceObj(x); +#endif /* DISABLE_TRACE */ + +#endif /* __LOG_H__ */ + diff --git a/src/contrib/zkfuse/src/log4cxx.properties b/src/contrib/zkfuse/src/log4cxx.properties new file mode 100644 index 0000000..1e373e4 --- /dev/null +++ b/src/contrib/zkfuse/src/log4cxx.properties @@ -0,0 +1,28 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +# Set root logger level to DEBUG and its only appender to A1. +log4j.rootLogger=TRACE, A1 + +# A1 is set to be a ConsoleAppender. +log4j.appender.A1=org.apache.log4cxx.ConsoleAppender + +# A1 uses PatternLayout. +log4j.appender.A1.layout=org.apache.log4cxx.PatternLayout +log4j.appender.A1.layout.ConversionPattern=%-4r [%t] %-5p %c %x - %m%n + +log4j.category.zkfuse=TRACE + diff --git a/src/contrib/zkfuse/src/mutex.h b/src/contrib/zkfuse/src/mutex.h new file mode 100644 index 0000000..86c4604 --- /dev/null +++ b/src/contrib/zkfuse/src/mutex.h @@ -0,0 +1,169 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifndef __MUTEX_H__ +#define __MUTEX_H__ + +#include +#include +#include + +#include "log.h" + +START_ZKFUSE_NAMESPACE + +class Cond; + +class Mutex { + friend class Cond; + public: + Mutex() { + pthread_mutexattr_init( &m_mutexAttr ); + pthread_mutexattr_settype( &m_mutexAttr, PTHREAD_MUTEX_RECURSIVE_NP ); + pthread_mutex_init( &mutex, &m_mutexAttr ); + } + ~Mutex() { + pthread_mutex_destroy(&mutex); + pthread_mutexattr_destroy( &m_mutexAttr ); + } + void Acquire() { Lock(); } + void Release() { Unlock(); } + void Lock() { + pthread_mutex_lock(&mutex); + } + int TryLock() { + return pthread_mutex_trylock(&mutex); + } + void Unlock() { + pthread_mutex_unlock(&mutex); + } + private: + pthread_mutex_t mutex; + pthread_mutexattr_t m_mutexAttr; +}; + +class AutoLock { + public: + AutoLock(Mutex& mutex) : _mutex(mutex) { + mutex.Lock(); + } + ~AutoLock() { + _mutex.Unlock(); + } + private: + friend class AutoUnlockTemp; + Mutex& _mutex; +}; + +class AutoUnlockTemp { + public: + AutoUnlockTemp(AutoLock & autoLock) : _autoLock(autoLock) { + _autoLock._mutex.Unlock(); + } + ~AutoUnlockTemp() { + _autoLock._mutex.Lock(); + } + private: + AutoLock & _autoLock; +}; + +class Cond { + public: + Cond() { + static pthread_condattr_t attr; + static bool inited = false; + if(!inited) { + inited = true; + pthread_condattr_init(&attr); + } + pthread_cond_init(&_cond, &attr); + } + ~Cond() { + pthread_cond_destroy(&_cond); + } + + void Wait(Mutex& mutex) { + pthread_cond_wait(&_cond, &mutex.mutex); + } + + bool Wait(Mutex& mutex, long long int timeout) { + struct timeval now; + gettimeofday( &now, NULL ); + struct timespec abstime; + int64_t microSecs = now.tv_sec * 1000000LL + now.tv_usec; + microSecs += timeout * 1000; + abstime.tv_sec = microSecs / 1000000LL; + abstime.tv_nsec = (microSecs % 1000000LL) * 1000; + if (pthread_cond_timedwait(&_cond, &mutex.mutex, &abstime) == ETIMEDOUT) { + return false; + } else { + return true; + } + } + + void Signal() { + pthread_cond_signal(&_cond); + } + + private: + pthread_cond_t _cond; +}; + +/** + * A wrapper class for {@link Mutex} and {@link Cond}. + */ +class Lock { + public: + + void lock() { + m_mutex.Lock(); + } + + void unlock() { + m_mutex.Unlock(); + } + + void wait() { + m_cond.Wait( m_mutex ); + } + + bool wait(long long int timeout) { + return m_cond.Wait( m_mutex, timeout ); + } + + void notify() { + m_cond.Signal(); + } + + private: + + /** + * The mutex. + */ + Mutex m_mutex; + + /** + * The condition associated with this lock's mutex. + */ + Cond m_cond; +}; + +END_ZKFUSE_NAMESPACE + +#endif /* __MUTEX_H__ */ + diff --git a/src/contrib/zkfuse/src/thread.cc b/src/contrib/zkfuse/src/thread.cc new file mode 100644 index 0000000..f1ed816 --- /dev/null +++ b/src/contrib/zkfuse/src/thread.cc @@ -0,0 +1,41 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#include + +#include "thread.h" + +DEFINE_LOGGER( LOG, "Thread" ) + +START_ZKFUSE_NAMESPACE + +void Thread::Create(void* ctx, ThreadFunc func) +{ + pthread_attr_t attr; + pthread_attr_init(&attr); + pthread_attr_setstacksize(&attr, _stackSize); + int ret = pthread_create(&mThread, &attr, func, ctx); + if(ret != 0) { + LOG_FATAL( LOG, "pthread_create failed: %s", strerror(errno) ); + } + // pthread_attr_destroy(&attr); + _ctx = ctx; + _func = func; +} + +END_ZKFUSE_NAMESPACE diff --git a/src/contrib/zkfuse/src/thread.h b/src/contrib/zkfuse/src/thread.h new file mode 100644 index 0000000..0ed12d7 --- /dev/null +++ b/src/contrib/zkfuse/src/thread.h @@ -0,0 +1,99 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifndef __THREAD_H__ +#define __THREAD_H__ + +#include +#include +#include +#include + +#include "log.h" + +START_ZKFUSE_NAMESPACE + +class Thread { + public: + static const size_t defaultStackSize = 1024 * 1024; + typedef void* (*ThreadFunc) (void*); + Thread(size_t stackSize = defaultStackSize) + : _stackSize(stackSize), _ctx(NULL), _func(NULL) + { + memset( &mThread, 0, sizeof(mThread) ); + } + ~Thread() { } + + void Create(void* ctx, ThreadFunc func); + void Join() { + //avoid SEGFAULT because of unitialized mThread + //in case Create(...) was never called + if (_func != NULL) { + pthread_join(mThread, 0); + } + } + private: + pthread_t mThread; + void *_ctx; + ThreadFunc _func; + size_t _stackSize; +}; + + +template +struct ThreadContext { + typedef void (T::*FuncPtr) (void); + ThreadContext(T& ctx, FuncPtr func) : _ctx(ctx), _func(func) {} + void run(void) { + (_ctx.*_func)(); + } + T& _ctx; + FuncPtr _func; +}; + +template +void* ThreadExec(void *obj) { + ThreadContext* tc = (ThreadContext*)(obj); + assert(tc != 0); + tc->run(); + return 0; +} + +template +class CXXThread : public Thread { + public: + typedef void (T::*FuncPtr) (void); + CXXThread(size_t stackSize = Thread::defaultStackSize) + : Thread(stackSize), ctx(0) {} + ~CXXThread() { if (ctx) delete ctx; } + + void Create(T& obj, FuncPtr func) { + assert(ctx == 0); + ctx = new ThreadContext(obj, func); + Thread::Create(ctx, ThreadExec); + } + + private: + ThreadContext* ctx; +}; + + +END_ZKFUSE_NAMESPACE + +#endif /* __THREAD_H__ */ + diff --git a/src/contrib/zkfuse/src/zkadapter.cc b/src/contrib/zkfuse/src/zkadapter.cc new file mode 100644 index 0000000..7f02fa3 --- /dev/null +++ b/src/contrib/zkfuse/src/zkadapter.cc @@ -0,0 +1,884 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#include +#include + +#include "blockingqueue.h" +#include "thread.h" +#include "zkadapter.h" + +using namespace std; +using namespace zk; + +DEFINE_LOGGER( LOG, "zookeeper.adapter" ) +DEFINE_LOGGER( ZK_LOG, "zookeeper.core" ) + +/** + * \brief A helper class to initialize ZK logging. + */ +class InitZooKeeperLogging +{ + public: + InitZooKeeperLogging() { + if (ZK_LOG->isDebugEnabled() +#ifdef LOG4CXX_TRACE + || ZK_LOG->isTraceEnabled() +#endif + ) + { + zoo_set_debug_level( ZOO_LOG_LEVEL_DEBUG ); + } else if (ZK_LOG->isInfoEnabled()) { + zoo_set_debug_level( ZOO_LOG_LEVEL_INFO ); + } else if (ZK_LOG->isWarnEnabled()) { + zoo_set_debug_level( ZOO_LOG_LEVEL_WARN ); + } else { + zoo_set_debug_level( ZOO_LOG_LEVEL_ERROR ); + } + } +}; + +using namespace std; + +namespace zk +{ + +/** + * \brief This class provides logic for checking if a request can be retried. + */ +class RetryHandler +{ + public: + RetryHandler(const ZooKeeperConfig &zkConfig) + : m_zkConfig(zkConfig) + { + if (zkConfig.getAutoReconnect()) { + retries = 2; + } else { + retries = 0; + } + } + + /** + * \brief Attempts to fix a side effect of the given RC. + * + * @param rc the ZK error code + * @return whether the error code has been handled and the caller should + * retry an operation the caused this error + */ + bool handleRC(int rc) + { + TRACE( LOG, "handleRC" ); + + //check if the given error code is recoverable + if (!retryOnError(rc)) { + return false; + } + LOG_TRACE( LOG, "RC: %d, retries left: %d", rc, retries ); + if (retries-- > 0) { + return true; + } else { + return false; + } + } + + private: + /** + * The ZK config. + */ + const ZooKeeperConfig &m_zkConfig; + + /** + * The number of outstanding retries. + */ + int retries; + + /** + * Checks whether the given error entitles this adapter + * to retry the previous operation. + * + * @param zkErrorCode one of the ZK error code + */ + static bool retryOnError(int zkErrorCode) + { + return (zkErrorCode == ZCONNECTIONLOSS || + zkErrorCode == ZOPERATIONTIMEOUT); + } +}; + + +//the implementation of the global ZK event watcher +void zkWatcher(zhandle_t *zh, int type, int state, const char *path, + void *watcherCtx) +{ + TRACE( LOG, "zkWatcher" ); + + //a workaround for buggy ZK API + string sPath = + (path == NULL || + state == ZOO_SESSION_EVENT || + state == ZOO_NOTWATCHING_EVENT) + ? "" + : string(path); + LOG_INFO( LOG, + "Received a ZK event - type: %d, state: %d, path: '%s'", + type, state, sPath.c_str() ); + ZooKeeperAdapter *zka = (ZooKeeperAdapter *)zoo_get_context(zh); + if (zka != NULL) { + zka->enqueueEvent( type, state, sPath ); + } else { + LOG_ERROR( LOG, + "Skipping ZK event (type: %d, state: %d, path: '%s'), " + "because ZK passed no context", + type, state, sPath.c_str() ); + } +} + + + +// ======================================================================= + +ZooKeeperAdapter::ZooKeeperAdapter(ZooKeeperConfig config, + ZKEventListener *listener, + bool establishConnection) + throw(ZooKeeperException) + : m_zkConfig(config), + mp_zkHandle(NULL), + m_terminating(false), + m_connected(false), + m_state(AS_DISCONNECTED) +{ + TRACE( LOG, "ZooKeeperAdapter" ); + + resetRemainingConnectTimeout(); + + //enforce setting up appropriate ZK log level + static InitZooKeeperLogging INIT_ZK_LOGGING; + + if (listener != NULL) { + addListener(listener); + } + + //start the event dispatcher thread + m_eventDispatcher.Create( *this, &ZooKeeperAdapter::processEvents ); + + //start the user event dispatcher thread + m_userEventDispatcher.Create( *this, &ZooKeeperAdapter::processUserEvents ); + + //optionally establish the connection + if (establishConnection) { + reconnect(); + } +} + +ZooKeeperAdapter::~ZooKeeperAdapter() +{ + TRACE( LOG, "~ZooKeeperAdapter" ); + + try { + disconnect(); + } catch (std::exception &e) { + LOG_ERROR( LOG, + "An exception while disconnecting from ZK: %s", + e.what() ); + } + m_terminating = true; + m_userEventDispatcher.Join(); + m_eventDispatcher.Join(); +} + +void +ZooKeeperAdapter::validatePath(const string &path) throw(ZooKeeperException) +{ + TRACE( LOG, "validatePath" ); + + if (path.find( "/" ) != 0) { + throw ZooKeeperException( string("Node path must start with '/' but" + "it was '") + + path + + "'" ); + } + if (path.length() > 1) { + if (path.rfind( "/" ) == path.length() - 1) { + throw ZooKeeperException( string("Node path must not end with " + "'/' but it was '") + + path + + "'" ); + } + if (path.find( "//" ) != string::npos) { + throw ZooKeeperException( string("Node path must not contain " + "'//' but it was '") + + path + + "'" ); + } + } +} + +void +ZooKeeperAdapter::disconnect() +{ + TRACE( LOG, "disconnect" ); + LOG_TRACE( LOG, "mp_zkHandle: %p, state %d", mp_zkHandle, m_state ); + + m_stateLock.lock(); + if (mp_zkHandle != NULL) { + zookeeper_close( mp_zkHandle ); + mp_zkHandle = NULL; + setState( AS_DISCONNECTED ); + } + m_stateLock.unlock(); +} + +void +ZooKeeperAdapter::reconnect() throw(ZooKeeperException) +{ + TRACE( LOG, "reconnect" ); + + m_stateLock.lock(); + //clear the connection state + disconnect(); + + //establish a new connection to ZooKeeper + mp_zkHandle = zookeeper_init( m_zkConfig.getHosts().c_str(), + zkWatcher, + m_zkConfig.getLeaseTimeout(), + NULL, this, 0); + resetRemainingConnectTimeout(); + if (mp_zkHandle != NULL) { + setState( AS_CONNECTING ); + m_stateLock.unlock(); + } else { + m_stateLock.unlock(); + throw ZooKeeperException( + string("Unable to connect to ZK running at '") + + m_zkConfig.getHosts() + "'" ); + } + + LOG_DEBUG( LOG, "mp_zkHandle: %p, state %d", mp_zkHandle, m_state ); +} + +void +ZooKeeperAdapter::handleEvent(int type, int state, const string &path) +{ + TRACE( LOG, "handleEvent" ); + LOG_TRACE( LOG, + "type: %d, state %d, path: %s", + type, state, path.c_str() ); + Listener2Context context, context2; + //ignore internal ZK events + if (type != ZOO_SESSION_EVENT && type != ZOO_NOTWATCHING_EVENT) { + m_zkContextsMutex.Acquire(); + //check if the user context is available + if (type == ZOO_CHANGED_EVENT || type == ZOO_DELETED_EVENT) { + //we may have two types of interest here, + //in this case lets try to notify twice + context = findAndRemoveListenerContext( GET_NODE_DATA, path ); + context2 = findAndRemoveListenerContext( NODE_EXISTS, path ); + if (context.empty()) { + //make sure that the 2nd context is NULL and + // assign it to the 1st one + context = context2; + context2.clear(); + } + } else if (type == ZOO_CHILD_EVENT) { + context = findAndRemoveListenerContext( GET_NODE_CHILDREN, path ); + } else if (type == ZOO_CREATED_EVENT) { + context = findAndRemoveListenerContext( NODE_EXISTS, path ); + } + m_zkContextsMutex.Release(); + } + + handleEvent( type, state, path, context ); + if (!context2.empty()) { + handleEvent( type, state, path, context2 ); + } +} + +void +ZooKeeperAdapter::handleEvent(int type, + int state, + const string &path, + const Listener2Context &listeners) +{ + TRACE( LOG, "handleEvents" ); + + if (listeners.empty()) { + //propagate with empty context + ZKWatcherEvent event(type, state, path); + fireEvent( event ); + } else { + for (Listener2Context::const_iterator i = listeners.begin(); + i != listeners.end(); + ++i) { + ZKWatcherEvent event(type, state, path, i->second); + if (i->first != NULL) { + fireEvent( i->first, event ); + } else { + fireEvent( event ); + } + } + } +} + +void +ZooKeeperAdapter::enqueueEvent(int type, int state, const string &path) +{ + TRACE( LOG, "enqueueEvents" ); + + m_events.put( ZKWatcherEvent( type, state, path ) ); +} + +void +ZooKeeperAdapter::processEvents() +{ + TRACE( LOG, "processEvents" ); + + while (!m_terminating) { + bool timedOut = false; + ZKWatcherEvent source = m_events.take( 100, &timedOut ); + if (!timedOut) { + if (source.getType() == ZOO_SESSION_EVENT) { + LOG_INFO( LOG, + "Received SESSION event, state: %d. Adapter state: %d", + source.getState(), m_state ); + m_stateLock.lock(); + if (source.getState() == ZOO_CONNECTED_STATE) { + m_connected = true; + resetRemainingConnectTimeout(); + setState( AS_CONNECTED ); + } else if (source.getState() == ZOO_CONNECTING_STATE) { + m_connected = false; + setState( AS_CONNECTING ); + } else if (source.getState() == ZOO_EXPIRED_SESSION_STATE) { + LOG_INFO( LOG, "Received EXPIRED_SESSION event" ); + setState( AS_SESSION_EXPIRED ); + } + m_stateLock.unlock(); + } + m_userEvents.put( source ); + } + } +} + +void +ZooKeeperAdapter::processUserEvents() +{ + TRACE( LOG, "processUserEvents" ); + + while (!m_terminating) { + bool timedOut = false; + ZKWatcherEvent source = m_userEvents.take( 100, &timedOut ); + if (!timedOut) { + try { + handleEvent( source.getType(), + source.getState(), + source.getPath() ); + } catch (std::exception &e) { + LOG_ERROR( LOG, + "Unable to process event (type: %d, state: %d, " + "path: %s), because of exception: %s", + source.getType(), + source.getState(), + source.getPath().c_str(), + e.what() ); + } + } + } +} + +void +ZooKeeperAdapter::registerContext(WatchableMethod method, + const string &path, + ZKEventListener *listener, + ContextType context) +{ + TRACE( LOG, "registerContext" ); + + m_zkContexts[method][path][listener] = context; +} + +ZooKeeperAdapter::Listener2Context +ZooKeeperAdapter::findAndRemoveListenerContext(WatchableMethod method, + const string &path) +{ + TRACE( LOG, "findAndRemoveListenerContext" ); + + Listener2Context listeners; + Path2Listener2Context::iterator elem = m_zkContexts[method].find( path ); + if (elem != m_zkContexts[method].end()) { + listeners = elem->second; + m_zkContexts[method].erase( elem ); + } + return listeners; +} + +void +ZooKeeperAdapter::setState(AdapterState newState) +{ + TRACE( LOG, "setState" ); + if (newState != m_state) { + LOG_INFO( LOG, "Adapter state transition: %d -> %d", m_state, newState ); + m_state = newState; + m_stateLock.notify(); + } else { + LOG_TRACE( LOG, "New state same as the current: %d", newState ); + } +} + + +//TODO move this code to verifyConnection so reconnect() +//is called from one place only +void +ZooKeeperAdapter::waitUntilConnected() + throw(ZooKeeperException) +{ + TRACE( LOG, "waitUntilConnected" ); + long long int timeout = getRemainingConnectTimeout(); + LOG_INFO( LOG, + "Waiting up to %lld ms until a connection to ZK is established", + timeout ); + bool connected; + if (timeout > 0) { + long long int toWait = timeout; + while (m_state != AS_CONNECTED && toWait > 0) { + //check if session expired and reconnect if so + if (m_state == AS_SESSION_EXPIRED) { + LOG_INFO( LOG, + "Reconnecting because the current session has expired" ); + reconnect(); + } + struct timeval now; + gettimeofday( &now, NULL ); + int64_t milliSecs = -(now.tv_sec * 1000LL + now.tv_usec / 1000); + LOG_TRACE( LOG, "About to wait %lld ms", toWait ); + m_stateLock.wait( toWait ); + gettimeofday( &now, NULL ); + milliSecs += now.tv_sec * 1000LL + now.tv_usec / 1000; + toWait -= milliSecs; + } + waitedForConnect( timeout - toWait ); + LOG_INFO( LOG, "Waited %lld ms", timeout - toWait ); + } + connected = (m_state == AS_CONNECTED); + if (!connected) { + if (timeout > 0) { + LOG_WARN( LOG, "Timed out while waiting for connection to ZK" ); + throw ZooKeeperException("Timed out while waiting for " + "connection to ZK"); + } else { + LOG_ERROR( LOG, "Global timeout expired and still not connected to ZK" ); + throw ZooKeeperException("Global timeout expired and still not " + "connected to ZK"); + } + } + LOG_INFO( LOG, "Connected!" ); +} + +void +ZooKeeperAdapter::verifyConnection() throw(ZooKeeperException) +{ + TRACE( LOG, "verifyConnection" ); + + m_stateLock.lock(); + try { + if (m_state == AS_DISCONNECTED) { + throw ZooKeeperException("Disconnected from ZK. " \ + "Please use reconnect() before attempting to use any ZK API"); + } else if (m_state != AS_CONNECTED) { + LOG_TRACE( LOG, "Checking if need to reconnect..." ); + //we are not connected, so check if connection in progress... + if (m_state != AS_CONNECTING) { + LOG_TRACE( LOG, + "yes. Checking if allowed to auto-reconnect..." ); + //...not in progres, so check if we can reconnect + if (!m_zkConfig.getAutoReconnect()) { + //...too bad, disallowed :( + LOG_TRACE( LOG, "no. Sorry." ); + throw ZooKeeperException("ZK connection is down and " + "auto-reconnect is not allowed"); + } else { + LOG_TRACE( LOG, "...yes. About to reconnect" ); + } + //...we are good to retry the connection + reconnect(); + } else { + LOG_TRACE( LOG, "...no, already in CONNECTING state" ); + } + //wait until the connection is established + waitUntilConnected(); + } + } catch (ZooKeeperException &e) { + m_stateLock.unlock(); + throw; + } + m_stateLock.unlock(); +} + +bool +ZooKeeperAdapter::createNode(const string &path, + const string &value, + int flags, + bool createAncestors, + string &returnPath) + throw(ZooKeeperException) +{ + TRACE( LOG, "createNode (internal)" ); + validatePath( path ); + + const int MAX_PATH_LENGTH = 1024; + char realPath[MAX_PATH_LENGTH]; + realPath[0] = 0; + + int rc; + RetryHandler rh(m_zkConfig); + do { + verifyConnection(); + rc = zoo_create( mp_zkHandle, + path.c_str(), + value.c_str(), + value.length(), + &ZOO_OPEN_ACL_UNSAFE, + flags, + realPath, + MAX_PATH_LENGTH ); + } while (rc != ZOK && rh.handleRC(rc)); + if (rc != ZOK) { + if (rc == ZNODEEXISTS) { + //the node already exists + LOG_WARN( LOG, "Error %d for %s", rc, path.c_str() ); + return false; + } else if (rc == ZNONODE && createAncestors) { + LOG_WARN( LOG, "Error %d for %s", rc, path.c_str() ); + //one of the ancestors doesn't exist so lets start from the root + //and make sure the whole path exists, creating missing nodes if + //necessary + for (string::size_type pos = 1; pos != string::npos; ) { + pos = path.find( "/", pos ); + if (pos != string::npos) { + try { + createNode( path.substr( 0, pos ), "", 0, true ); + } catch (ZooKeeperException &e) { + throw ZooKeeperException( string("Unable to create " + "node ") + + path, + rc ); + } + pos++; + } else { + //no more path components + return createNode( path, value, flags, false, returnPath ); + } + } + } + LOG_ERROR( LOG,"Error %d for %s", rc, path.c_str() ); + throw ZooKeeperException( string("Unable to create node ") + + path, + rc ); + } else { + LOG_INFO( LOG, "%s has been created", realPath ); + returnPath = string( realPath ); + return true; + } +} + +bool +ZooKeeperAdapter::createNode(const string &path, + const string &value, + int flags, + bool createAncestors) + throw(ZooKeeperException) +{ + TRACE( LOG, "createNode" ); + + string createdPath; + return createNode( path, value, flags, createAncestors, createdPath ); +} + +int64_t +ZooKeeperAdapter::createSequence(const string &path, + const string &value, + int flags, + bool createAncestors) + throw(ZooKeeperException) +{ + TRACE( LOG, "createSequence" ); + + string createdPath; + bool result = createNode( path, + value, + flags | ZOO_SEQUENCE, + createAncestors, + createdPath ); + if (!result) { + return -1; + } else { + //extract sequence number from the returned path + if (createdPath.find( path ) != 0) { + throw ZooKeeperException( string("Expecting returned path '") + + createdPath + + "' to start with '" + + path + + "'" ); + } + string seqSuffix = + createdPath.substr( path.length(), + createdPath.length() - path.length() ); + char *ptr = NULL; + int64_t seq = strtol( seqSuffix.c_str(), &ptr, 10 ); + if (ptr != NULL && *ptr != '\0') { + throw ZooKeeperException( string("Expecting a number but got ") + + seqSuffix ); + } + return seq; + } +} + +bool +ZooKeeperAdapter::deleteNode(const string &path, + bool recursive, + int version) + throw(ZooKeeperException) +{ + TRACE( LOG, "deleteNode" ); + + validatePath( path ); + + int rc; + RetryHandler rh(m_zkConfig); + do { + verifyConnection(); + rc = zoo_delete( mp_zkHandle, path.c_str(), version ); + } while (rc != ZOK && rh.handleRC(rc)); + if (rc != ZOK) { + if (rc == ZNONODE) { + LOG_WARN( LOG, "Error %d for %s", rc, path.c_str() ); + return false; + } + if (rc == ZNOTEMPTY && recursive) { + LOG_WARN( LOG, "Error %d for %s", rc, path.c_str() ); + //get all children and delete them recursively... + vector nodeList; + getNodeChildren( nodeList, path, NULL ); + for (vector::const_iterator i = nodeList.begin(); + i != nodeList.end(); + ++i) { + deleteNode( *i, true ); + } + //...and finally attempt to delete the node again + return deleteNode( path, false ); + } + LOG_ERROR( LOG, "Error %d for %s", rc, path.c_str() ); + throw ZooKeeperException( string("Unable to delete node ") + path, + rc ); + } else { + LOG_INFO( LOG, "%s has been deleted", path.c_str() ); + return true; + } +} + +bool +ZooKeeperAdapter::nodeExists(const string &path, + ZKEventListener *listener, + void *context, Stat *stat) + throw(ZooKeeperException) +{ + TRACE( LOG, "nodeExists" ); + + validatePath( path ); + + struct Stat tmpStat; + if (stat == NULL) { + stat = &tmpStat; + } + memset( stat, 0, sizeof(Stat) ); + + int rc; + RetryHandler rh(m_zkConfig); + do { + verifyConnection(); + if (context != NULL) { + m_zkContextsMutex.Acquire(); + rc = zoo_exists( mp_zkHandle, + path.c_str(), + (listener != NULL ? 1 : 0), + stat ); + if (rc == ZOK || rc == ZNONODE) { + registerContext( NODE_EXISTS, path, listener, context ); + } + m_zkContextsMutex.Release(); + } else { + rc = zoo_exists( mp_zkHandle, + path.c_str(), + (listener != NULL ? 1 : 0), + stat ); + } + } while (rc != ZOK && rh.handleRC(rc)); + if (rc != ZOK) { + if (rc == ZNONODE) { + LOG_TRACE( LOG, "Node %s does not exist", path.c_str() ); + return false; + } + LOG_ERROR( LOG, "Error %d for %s", rc, path.c_str() ); + throw ZooKeeperException( + string("Unable to check existence of node ") + path, + rc ); + } else { + return true; + } +} + +void +ZooKeeperAdapter::getNodeChildren(vector &nodeList, + const string &path, + ZKEventListener *listener, + void *context) + throw (ZooKeeperException) +{ + TRACE( LOG, "getNodeChildren" ); + + validatePath( path ); + + String_vector children; + memset( &children, 0, sizeof(children) ); + + int rc; + RetryHandler rh(m_zkConfig); + do { + verifyConnection(); + if (context != NULL) { + m_zkContextsMutex.Acquire(); + rc = zoo_get_children( mp_zkHandle, + path.c_str(), + (listener != NULL ? 1 : 0), + &children ); + if (rc == ZOK) { + registerContext( GET_NODE_CHILDREN, path, listener, context ); + } + m_zkContextsMutex.Release(); + } else { + rc = zoo_get_children( mp_zkHandle, + path.c_str(), + (listener != NULL ? 1 : 0), + &children ); + } + } while (rc != ZOK && rh.handleRC(rc)); + if (rc != ZOK) { + LOG_ERROR( LOG, "Error %d for %s", rc, path.c_str() ); + throw ZooKeeperException( string("Unable to get children of node ") + + path, + rc ); + } else { + for (int i = 0; i < children.count; ++i) { + //convert each child's path from relative to absolute + string absPath(path); + if (path != "/") { + absPath.append( "/" ); + } + absPath.append( children.data[i] ); + nodeList.push_back( absPath ); + } + //make sure the order is always deterministic + sort( nodeList.begin(), nodeList.end() ); + } +} + +string +ZooKeeperAdapter::getNodeData(const string &path, + ZKEventListener *listener, + void *context, Stat *stat) + throw(ZooKeeperException) +{ + TRACE( LOG, "getNodeData" ); + + validatePath( path ); + + const int MAX_DATA_LENGTH = 128 * 1024; + char buffer[MAX_DATA_LENGTH]; + memset( buffer, 0, MAX_DATA_LENGTH ); + struct Stat tmpStat; + if (stat == NULL) { + stat = &tmpStat; + } + memset( stat, 0, sizeof(Stat) ); + + int rc; + int len; + RetryHandler rh(m_zkConfig); + do { + verifyConnection(); + len = MAX_DATA_LENGTH - 1; + if (context != NULL) { + m_zkContextsMutex.Acquire(); + rc = zoo_get( mp_zkHandle, + path.c_str(), + (listener != NULL ? 1 : 0), + buffer, &len, stat ); + if (rc == ZOK) { + registerContext( GET_NODE_DATA, path, listener, context ); + } + m_zkContextsMutex.Release(); + } else { + rc = zoo_get( mp_zkHandle, + path.c_str(), + (listener != NULL ? 1 : 0), + buffer, &len, stat ); + } + } while (rc != ZOK && rh.handleRC(rc)); + if (rc != ZOK) { + LOG_ERROR( LOG, "Error %d for %s", rc, path.c_str() ); + throw ZooKeeperException( + string("Unable to get data of node ") + path, rc + ); + } else { + if (len == -1) { + len = 0; + } + return string( buffer, len ); + } +} + +void +ZooKeeperAdapter::setNodeData(const string &path, + const string &value, + int version) + throw(ZooKeeperException) +{ + TRACE( LOG, "setNodeData" ); + + validatePath( path ); + + int rc; + RetryHandler rh(m_zkConfig); + do { + verifyConnection(); + rc = zoo_set( mp_zkHandle, + path.c_str(), + value.c_str(), + value.length(), + version); + } while (rc != ZOK && rh.handleRC(rc)); + if (rc != ZOK) { + LOG_ERROR( LOG, "Error %d for %s", rc, path.c_str() ); + throw ZooKeeperException( string("Unable to set data for node ") + + path, + rc ); + } +} + +} /* end of 'namespace zk' */ + diff --git a/src/contrib/zkfuse/src/zkadapter.h b/src/contrib/zkfuse/src/zkadapter.h new file mode 100644 index 0000000..8d4d1d5 --- /dev/null +++ b/src/contrib/zkfuse/src/zkadapter.h @@ -0,0 +1,718 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifndef __ZKADAPTER_H__ +#define __ZKADAPTER_H__ + +#include +#include +#include + +extern "C" { +#include "zookeeper.h" +} + +#include "log.h" +#include "mutex.h" +#include "thread.h" +#include "blockingqueue.h" +#include "event.h" + +using namespace std; +using namespace zkfuse; + +namespace zk { + +/** + * \brief A cluster related exception. + */ +class ZooKeeperException : + public std::exception +{ + public: + + /** + * \brief Constructor. + * + * @param msg the detailed message associated with this exception + */ + ZooKeeperException(const string &msg) : + m_message(msg), m_zkErrorCode(0) + {} + + /** + * \brief Constructor. + * + * @param msg the detailed message associated with this exception + * @param errorCode the ZK error code associated with this exception + */ + ZooKeeperException(const string &msg, int errorCode) : + m_zkErrorCode(errorCode) + { + char tmp[100]; + sprintf( tmp, " (ZK error code: %d)", errorCode ); + m_message = msg + tmp; + } + + /** + * \brief Destructor. + */ + ~ZooKeeperException() throw() {} + + /** + * \brief Returns detailed description of the exception. + */ + const char *what() const throw() { + return m_message.c_str(); + } + + /** + * \brief Returns the ZK error code. + */ + int getZKErrorCode() const { + return m_zkErrorCode; + } + + private: + + /** + * The detailed message associated with this exception. + */ + string m_message; + + /** + * The optional error code received from ZK. + */ + int m_zkErrorCode; + +}; + +/** + * \brief This class encapsulates configuration of a ZK client. + */ +class ZooKeeperConfig +{ + public: + + /** + * \brief Constructor. + * + * @param hosts the comma separated list of host and port pairs of ZK nodes + * @param leaseTimeout the lease timeout (heartbeat) + * @param autoReconnect whether to allow for auto-reconnect + * @param connectTimeout the connect timeout, in milliseconds; + */ + ZooKeeperConfig(const string &hosts, + int leaseTimeout, + bool autoReconnect = true, + long long int connectTimeout = 15000) : + m_hosts(hosts), m_leaseTimeout(leaseTimeout), + m_autoReconnect(autoReconnect), m_connectTimeout(connectTimeout) {} + + /** + * \brief Returns the list of ZK hosts to connect to. + */ + string getHosts() const { return m_hosts; } + + /** + * \brief Returns the lease timeout. + */ + int getLeaseTimeout() const { return m_leaseTimeout; } + + /** + * \brief Returns whether {@link ZooKeeperAdapter} should attempt + * \brief to automatically reconnect in case of a connection failure. + */ + bool getAutoReconnect() const { return m_autoReconnect; } + + /** + * \brief Gets the connect timeout. + * + * @return the connect timeout + */ + long long int getConnectTimeout() const { return m_connectTimeout; } + + private: + + /** + * The host addresses of ZK nodes. + */ + const string m_hosts; + + /** + * The ZK lease timeout. + */ + const int m_leaseTimeout; + + /** + * True if this adapater should attempt to autoreconnect in case + * the current session has been dropped. + */ + const bool m_autoReconnect; + + /** + * How long to wait, in milliseconds, before a connection + * is established to ZK. + */ + const long long int m_connectTimeout; + +}; + +/** + * \brief A data value object representing a watcher event received from the ZK. + */ +class ZKWatcherEvent +{ + public: + + /** + * \brief The type representing the user's context. + */ + typedef void *ContextType; + + /** + * \brief Constructor. + * + * @param type the type of this event + * @param state the state of this event + * @param path the corresponding path, may be empty for some event types + * @param context the user specified context; possibly NULL + */ + ZKWatcherEvent() : + m_type(-1), m_state(-1), m_path(""), mp_context(NULL) {} + + /** + * \brief Constructor. + * + * @param type the type of this event + * @param state the state of this event + * @param path the corresponding path, may be empty for some event types + * @param context the user specified context; possibly NULL + */ + ZKWatcherEvent(int type, int state, const string &path, + ContextType context = NULL) : + m_type(type), m_state(state), m_path(path), mp_context(context) {} + + int getType() const { return m_type; } + int getState() const { return m_state; } + string const &getPath() const { return m_path; } + ContextType getContext() const { return mp_context; } + + bool operator==(const ZKWatcherEvent &we) const { + return m_type == we.m_type && m_state == we.m_state + && m_path == we.m_path && mp_context == we.mp_context; + } + + private: + + /** + * The type of this event. It can be either ZOO_CREATED_EVENT, ZOO_DELETED_EVENT, + * ZOO_CHANGED_EVENT, ZOO_CHILD_EVENT, ZOO_SESSION_EVENT or ZOO_NOTWATCHING_EVENT. + * See zookeeper.h for more details. + */ + const int m_type; + + /** + * The state of ZK at the time of sending this event. + * It can be either ZOO_CONNECTING_STATE, ZOO_ASSOCIATING_STATE, + * ZOO_CONNECTED_STATE, ZOO_EXPIRED_SESSION_STATE or AUTH_FAILED_STATE. + * See {@file zookeeper.h} for more details. + */ + const int m_state; + + /** + * The corresponding path of the node in subject. It may be empty + * for some event types. + */ + const string m_path; + + /** + * The pointer to the user specified context, possibly NULL. + */ + ContextType mp_context; + +}; + +/** + * \brief The type definition of ZK event source. + */ +typedef EventSource ZKEventSource; + +/** + * \brief The type definition of ZK event listener. + */ +typedef EventListener ZKEventListener; + +/** + * \brief This is a wrapper around ZK C synchrounous API. + */ +class ZooKeeperAdapter + : public ZKEventSource +{ + public: + /** + * \brief The global function that handles all ZK asynchronous notifications. + */ + friend void zkWatcher(zhandle_t *, int, int, const char *, void *watcherCtx); + + /** + * \brief The type representing the user's context. + */ + typedef void *ContextType; + + /** + * \brief The map type of ZK event listener to user specified context mapping. + */ + typedef map Listener2Context; + + /** + * \brief The map type of ZK path's to listener's contexts. + */ + typedef map Path2Listener2Context; + + /** + * \brief All possible states of this client, in respect to + * \brief connection to the ZK server. + */ + enum AdapterState { + //mp_zkHandle is NULL + AS_DISCONNECTED = 0, + //mp_zkHandle is valid but this client is reconnecting + AS_CONNECTING, + //mp_zkHandle is valid and this client is connected + AS_CONNECTED, + //mp_zkHandle is valid, however no more calls can be made to ZK API + AS_SESSION_EXPIRED + }; + + /** + * \brief Constructor. + * Attempts to create a ZK adapter, optionally connecting + * to the ZK. Note, that if the connection is to be established + * and the given listener is NULL, some events may be lost, + * as they may arrive asynchronously before this method finishes. + * + * @param config the ZK configuration + * @param listener the event listener to be used for listening + * on incoming ZK events; + * if NULL not used + * @param establishConnection whether to establish connection to the ZK + * + * @throw ZooKeeperException if cannot establish connection to the given ZK + */ + ZooKeeperAdapter(ZooKeeperConfig config, + ZKEventListener *listener = NULL, + bool establishConnection = false) + throw(ZooKeeperException); + + /** + * \brief Destructor. + */ + ~ZooKeeperAdapter(); + + /** + * \brief Returns the current config. + */ + const ZooKeeperConfig &getZooKeeperConfig() const { + return m_zkConfig; + } + + /** + * \brief Restablishes connection to the ZK. + * If this adapter is already connected, the current connection + * will be dropped and a new connection will be established. + * + * @throw ZooKeeperException if cannot establish connection to the ZK + */ + void reconnect() throw(ZooKeeperException); + + /** + * \brief Disconnects from the ZK and unregisters {@link #mp_zkHandle}. + */ + void disconnect(); + + /** + * \brief Creates a new node identified by the given path. + * This method will optionally attempt to create all missing ancestors. + * + * @param path the absolute path name of the node to be created + * @param value the initial value to be associated with the node + * @param flags the ZK flags of the node to be created + * @param createAncestors if true and there are some missing ancestor nodes, + * this method will attempt to create them + * + * @return true if the node has been successfully created; false otherwise + * @throw ZooKeeperException if the operation has failed + */ + bool createNode(const string &path, + const string &value = "", + int flags = 0, + bool createAncestors = true) + throw(ZooKeeperException); + + /** + * \brief Creates a new sequence node using the give path as the prefix. + * This method will optionally attempt to create all missing ancestors. + * + * @param path the absolute path name of the node to be created; + * @param value the initial value to be associated with the node + * @param flags the ZK flags of the sequence node to be created + * (in addition to SEQUENCE) + * @param createAncestors if true and there are some missing ancestor + * nodes, this method will attempt to create them + * + * @return the sequence number associate with newly created node, + * or -1 if it couldn't be created + * @throw ZooKeeperException if the operation has failed + */ + int64_t createSequence(const string &path, + const string &value = "", + int flags = 0, + bool createAncestors = true) + throw(ZooKeeperException); + + /** + * \brief Deletes a node identified by the given path. + * + * @param path the absolute path name of the node to be deleted + * @param recursive if true this method will attempt to remove + * all children of the given node if any exist + * @param version the expected version of the node. The function will + * fail if the actual version of the node does not match + * the expected version + * + * @return true if the node has been deleted; false otherwise + * @throw ZooKeeperException if the operation has failed + */ + bool deleteNode(const string &path, bool recursive = false, int version = -1) + throw(ZooKeeperException); + + /** + * \brief Checks whether the given node exists or not. + * + * @param path the absolute path name of the node to be checked + * @param listener the listener for ZK watcher events; + * passing non NULL effectively establishes + * a ZK watch on the given node + * @param context the user specified context that is to be passed + * in a corresponding {@link ZKWatcherEvent} at later time; + * not used if listener is NULL + * @param stat the optional node statistics to be filled in by ZK + * + * @return true if the given node exists; false otherwise + * @throw ZooKeeperException if the operation has failed + */ + bool nodeExists(const string &path, + ZKEventListener *listener = NULL, + void *context = NULL, + Stat *stat = NULL) + throw(ZooKeeperException); + + /** + * \brief Retrieves list of all children of the given node. + * + * @param path the absolute path name of the node for which to get children + * @param listener the listener for ZK watcher events; + * passing non NULL effectively establishes + * a ZK watch on the given node + * @param context the user specified context that is to be passed + * in a corresponding {@link ZKWatcherEvent} at later time; + * not used if listener is NULL + * + * @return the list of absolute paths of child nodes, possibly empty + * @throw ZooKeeperException if the operation has failed + */ + void getNodeChildren(vector &children, + const string &path, + ZKEventListener *listener = NULL, + void *context = NULL) + throw(ZooKeeperException); + + /** + * \brief Gets the given node's data. + * + * @param path the absolute path name of the node to get data from + * @param listener the listener for ZK watcher events; + * passing non NULL effectively establishes + * a ZK watch on the given node + * @param context the user specified context that is to be passed + * in a corresponding {@link ZKWatcherEvent} at later time; + * not used if listener is NULL + * @param stat the optional node statistics to be filled in by ZK + * + * @return the node's data + * @throw ZooKeeperException if the operation has failed + */ + string getNodeData(const string &path, + ZKEventListener *listener = NULL, + void *context = NULL, + Stat *stat = NULL) + throw(ZooKeeperException); + + /** + * \brief Sets the given node's data. + * + * @param path the absolute path name of the node to get data from + * @param value the node's data to be set + * @param version the expected version of the node. The function will + * fail if the actual version of the node does not match + * the expected version + * + * @throw ZooKeeperException if the operation has failed + */ + void setNodeData(const string &path, const string &value, int version = -1) + throw(ZooKeeperException); + + /** + * \brief Validates the given path to a node in ZK. + * + * @param the path to be validated + * + * @throw ZooKeeperException if the given path is not valid + * (for instance it doesn't start with "/") + */ + static void validatePath(const string &path) throw(ZooKeeperException); + + /** + * Returns the current state of this adapter. + * + * @return the current state of this adapter + * @see AdapterState + */ + AdapterState getState() const { + return m_state; + } + + private: + + /** + * This enum defines methods from this class than can trigger an event. + */ + enum WatchableMethod { + NODE_EXISTS = 0, + GET_NODE_CHILDREN, + GET_NODE_DATA + }; + + /** + * \brief Creates a new node identified by the given path. + * This method is used internally to implement {@link createNode(...)} + * and {@link createSequence(...)}. On success, this method will set + * createdPath. + * + * @param path the absolute path name of the node to be created + * @param value the initial value to be associated with the node + * @param flags the ZK flags of the node to be created + * @param createAncestors if true and there are some missing ancestor nodes, + * this method will attempt to create them + * @param createdPath the actual path of the node that has been created; + * useful for sequences + * + * @return true if the node has been successfully created; false otherwise + * @throw ZooKeeperException if the operation has failed + */ + bool createNode(const string &path, + const string &value, + int flags, + bool createAncestors, + string &createdPath) + throw(ZooKeeperException); + + /** + * Handles an asynchronous event received from the ZK. + */ + void handleEvent(int type, int state, const string &path); + + /** + * Handles an asynchronous event received from the ZK. + * This method iterates over all listeners and passes the event + * to each of them. + */ + void handleEvent(int type, int state, const string &path, + const Listener2Context &listeners); + + /** + * \brief Enqueues the given event in {@link #m_events} queue. + */ + void enqueueEvent(int type, int state, const string &path); + + /** + * \brief Processes all ZK adapter events in a loop. + */ + void processEvents(); + + /** + * \brief Processes all user events in a loop. + */ + void processUserEvents(); + + /** + * \brief Registers the given context in the {@link #m_zkContexts} + * \brief contexts map. + * + * @param method the method where the given path is being used + * @param path the path of interest + * @param listener the event listener to call back later on + * @param context the user specified context to be passed back to user + */ + void registerContext(WatchableMethod method, const string &path, + ZKEventListener *listener, ContextType context); + + /** + * \brief Attempts to find a listener to context map in the contexts' + * \brief map, based on the specified criteria. + * If the context is found, it will be removed the udnerlying map. + * + * @param method the method type identify Listener2Context map + * @param path the path to be used to search in the Listener2Context map + * + * @return the context map associated with the given method and path, + * or empty map if not found + */ + Listener2Context findAndRemoveListenerContext(WatchableMethod method, + const string &path); + + /** + * Sets the new state in case it's different then the current one. + * This method assumes that {@link #m_stateLock} has been already locked. + * + * @param newState the new state to be set + */ + void setState(AdapterState newState); + + /** + * Waits until this client gets connected. The total wait time + * is given by {@link getRemainingConnectTimeout()}. + * If a timeout elapses, this method will throw an exception. + * + * @throw ZooKeeperException if unable to connect within the given timeout + */ + void waitUntilConnected() + throw(ZooKeeperException); + + /** + * Verifies whether the connection is established, + * optionally auto reconnecting. + * + * @throw ZooKeeperConnection if this client is disconnected + * and auto-reconnect failed or was not allowed + */ + void verifyConnection() throw(ZooKeeperException); + + /** + * Returns the remaining connect timeout. The timeout resets + * to {@link #m_connectTimeout} on a successfull connection to the ZK. + * + * @return the remaining connect timeout, in milliseconds + */ + long long int getRemainingConnectTimeout() { + return m_remainingConnectTimeout; + } + + /** + * Resets the remaining connect timeout to {@link #m_connectTimeout}. + */ + void resetRemainingConnectTimeout() { + m_remainingConnectTimeout = m_zkConfig.getConnectTimeout(); + } + + /** + * Updates the remaining connect timeout to reflect the given wait time. + * + * @param time the time for how long waited so far on connect to succeed + */ + void waitedForConnect(long long time) { + m_remainingConnectTimeout -= time; + } + + private: + + /** + * The mutex use to protect {@link #m_zkContexts}. + */ + zkfuse::Mutex m_zkContextsMutex; + + /** + * The map of registered ZK paths that are being watched. + * Each entry maps a function type to another map of registered contexts. + * + * @see WatchableMethod + */ + map m_zkContexts; + + /** + * The current ZK configuration. + */ + const ZooKeeperConfig m_zkConfig; + + /** + * The current ZK session. + */ + zhandle_t *mp_zkHandle; + + /** + * The blocking queue of all events waiting to be processed by ZK adapter. + */ + BlockingQueue m_events; + + /** + * The blocking queue of all events waiting to be processed by users + * of ZK adapter. + */ + BlockingQueue m_userEvents; + + /** + * The thread that dispatches all events from {@link #m_events} queue. + */ + CXXThread m_eventDispatcher; + + /** + * The thread that dispatches all events from {@link #m_userEvents} queue. + */ + CXXThread m_userEventDispatcher; + + /** + * Whether {@link #m_eventDispatcher} is terminating. + */ + volatile bool m_terminating; + + /** + * Whether this adapter is connected to the ZK. + */ + volatile bool m_connected; + + /** + * The state of this adapter. + */ + AdapterState m_state; + + /** + * The lock used to synchronize access to {@link #m_state}. + */ + Lock m_stateLock; + + /** + * How much time left for the connect to succeed, in milliseconds. + */ + long long int m_remainingConnectTimeout; + +}; + +} /* end of 'namespace zk' */ + +#endif /* __ZKADAPTER_H__ */ diff --git a/src/contrib/zkfuse/src/zkfuse.cc b/src/contrib/zkfuse/src/zkfuse.cc new file mode 100644 index 0000000..6a82168 --- /dev/null +++ b/src/contrib/zkfuse/src/zkfuse.cc @@ -0,0 +1,4492 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#define FUSE_USE_VERSION 26 + +#ifdef HAVE_CONFIG_H +#include +#endif + +#undef _GNU_SOURCE +#define _GNU_SOURCE + +extern "C" { +#include +#include +} +#include +#include +#include +#include +#include +#include +#include +#ifdef HAVE_SETXATTR +#include +#endif + +#include + +#include +#include +#include +#include +#include +#include + +#include "log.h" +#include "mutex.h" +#include "zkadapter.h" + +#define ZOOKEEPER_ROOT_CHILDREN_WATCH_BUG + +/** + Typedef for ZooKeeperAdapter::Data. +*/ +typedef std::string Data; +/** + Typedef for ZooKeeperAdapter::NodeNames. +*/ +typedef vector NodeNames; + +#define MAX_DATA_SIZE 1024; + +DEFINE_LOGGER(LOG, "zkfuse"); + +inline +uint64_t millisecsToSecs(uint64_t millisecs) +{ + return millisecs / 1000; +} +inline +uint64_t secsToMillisecs(uint64_t secs) +{ + return secs * 1000; +} +inline +uint64_t nanosecsToMillisecs(uint64_t nanosecs) +{ + return nanosecs / 1000000; +} +inline +uint64_t timespecToMillisecs(const struct timespec & ts) +{ + return secsToMillisecs(ts.tv_sec) + nanosecsToMillisecs(ts.tv_nsec); +} + +typedef boost::shared_ptr ZooKeeperAdapterSharedPtr; + +/** + * ZkFuseCommon - holds immutable configuration objects. + * + * No locks are required to access these objects. + * A ZkFuseCommon instance is considered to be a data object and may be copied. + */ +class ZkFuseCommon +{ + private: + /** + References the ZooKeeperAdapter instance to be used. + */ + ZooKeeperAdapterSharedPtr _zkAdapter; + /** + Path to the ZooKeeper root node. + */ + std::string _rootPathName; + /** + Name used to access data "file" when the ZK node has + children. + */ + std::string _dataFileName; + /** + Suffix added to path components to force interpretation of + path components as directory. This is usually only required + for the last component. For example, ZkFuse may consider + a leaf node a regular file, e.g. /a/b/c/leaf. The suffix + can be used to create child under this node, e.g. + mkdir /a/b/c/leaf{forceDirSuffix}/new_leaf. + */ + std::string _forceDirSuffix; + /** + Prefix common to all metadata nodes created by ZkFuse. + */ + std::string _metadataNamePrefix; + /** + Path component name that identifies a directory metadata node. + A directory metadata node is currently empty. It is used by ZkFuse + to create a child when mkdir is used. This prevents ZkFuse + from interpreting the new child as a regular file. + */ + std::string _dirMetadataName; + /** + Path component name that identifies a regular file metadata node. + A regular metadata node holds metadata required to implement + Posix regular file semantics, such as setting mtime. + */ + std::string _regMetadataName; + /** + Number of not-in-use nodes to cache. + */ + unsigned _cacheSize; + /** + Assume this userid owns all nodes. + */ + const uid_t _uid; + /** + Assume this groupid owns all nodes. + */ + const gid_t _gid; + /** + Blocksize used to calculate number of blocks used for stat. + */ + const unsigned _blkSize; + + public: + /** + Constructor. + */ + ZkFuseCommon() + : _zkAdapter(), + _rootPathName("/"), + _dataFileName(), + _forceDirSuffix(), + _metadataNamePrefix(".zkfuse."), + _dirMetadataName(_metadataNamePrefix + "dir"), + _regMetadataName(_metadataNamePrefix + "file"), + _cacheSize(256), + _uid(geteuid()), + _gid(getegid()), + _blkSize(8192) + { + } + /** + Get root path name. Always "/". + \see _rootPathName + */ + const std::string & getRootPathName() const + { + return _rootPathName; + } + /** + Get dataFileName - the name for synthesized files to access + ZooKeeper node data. + \see _dataFileName + */ + const std::string & getDataFileName() const + { + return _dataFileName; + } + /** + Set dataFileName. + \see getDataFileName + \see _dataFileName + */ + void setDataFileName(const std::string & dataFileName) + { + _dataFileName = dataFileName; + } + /** + Get metadataNamePrefix - the common prefix for all ZkFuse created + metadata ZooKeeper nodes. + \see _metadataNamePrefix + */ + const std::string & getMetadataNamePrefix() const + { + return _metadataNamePrefix; + } + /** + Get forceDirSuffix - the suffix added to a path component to force + the path component to be treated like a directory. + \see _forceDirSuffix + */ + const std::string & getForceDirSuffix() const + { + return _forceDirSuffix; + } + /** + Set forceDirSuffix. + \see getForceDirSuffix + \see _forceDirSuffix + */ + void setForceDirSuffix(const std::string & forceDirSuffix) + { + _forceDirSuffix = forceDirSuffix; + } + /** + Get dirMetadataName - path component name of all directory + metadata ZooKeeper nodes. + \see _dirMetadataname + */ + const std::string & getDirMetadataName() const + { + return _dirMetadataName; + } + /** + Get regMetadataName - path component name of all regular file + metadata ZooKeeper nodes. + \see _regMetadataname + */ + const std::string & getRegMetadataName() const + { + return _regMetadataName; + } + /** + Get number of not-in-use ZkFuseFile instances to to cache. + \see _cacheSize + */ + unsigned getCacheSize() const + { + return _cacheSize; + } + /** + Set cache size. + \see getCacheSize + \see _cacheSize + */ + void setCacheSize(unsigned v) + { + _cacheSize = v; + } + /** + Get userid. + \see _uid + */ + uid_t getUid() const + { + return _uid; + } + /** + Get groupid. + \see _gid + */ + gid_t getGid() const + { + return _gid; + } + /** + Get block size. + \see _blkSize + */ + unsigned getBlkSize() const + { + return _blkSize; + } + /** + Get ZooKeeperAdapter. + \see _zkAdapter. + */ + const ZooKeeperAdapterSharedPtr & getZkAdapter() const + { + return _zkAdapter; + } + /** + Set ZooKeeperAdapter. + \see _zkAdaptor + */ + void setZkAdapter(const ZooKeeperAdapterSharedPtr & zkAdapter) + { + _zkAdapter = zkAdapter; + } +}; + +/** + ZkFuseNameType - identifies the type of the ZkFuse path. + */ +enum ZkFuseNameType { + /** + ZkFuse path is not syntheiszed. + ZkFuse should use its default rules to determine the Posix representation + of the path. + */ + ZkFuseNameDefaultType = 0, + /** + ZkFuse path is synthesized and identifies the data part of a + ZooKeeper node, i.e. Posix regular file semantics is expected. + */ + ZkFuseNameRegType = 1, + /** + ZkFuse path is synthesized and identifies the chidlren part of a + ZooKeeper node, i.e. Posix directory semantics is expected. + */ + ZkFuseNameDirType = 2 +}; + +class ZkFuseFile; + +typedef ZkFuseFile * ZkFuseFilePtr; + +class ZkFuseHandleManagerFactory; + +/** + ZkFuseHandleManager - keeps track of all the ZkFuseFile instances + allocated by a ZkFuseHandleManager instance and provides them + with a handle that can be used by FUSE. + + It maps a ZooKeeper path to a handle and a handle to a ZkFuse instance. + It also implements the methods that takes path names as arguments, such + as open, mknod, rmdir, and rename. + + Memory management + - References ZkFuseFile instances using regular pointers + Smart pointer is not used because reference counts are needed to + determine how many time a node is opened as a regular file or + directory. This also avoids circular smart pointer references. + - Each ZkFuseFile instance holds a reference to its ZkFuseHandleManager + using a boost::shared_ptr. This ensures that the ZkFuseHandleManager + instance that has the handle for the ZkFuseFile instance does not + get garbage collected while the ZkFuseFile instance exists. + + Concurrency control + - Except for the immutable ZkFuseCommon, all other member variables + are protected by _mutex. + - A method in this class can hold _mutex when it directly or + indirectly invokes ZkFuseFile methods. A ZkFuseFile method that holds + a ZkFuseFile instance _mutex cannot invoke a ZkFuseHandleManager + method that acquires the ZkFuseHandleManager instance's _mutex. + Otherwise, this may cause a dead lock. + - Methods that with names that begin with "_" do not acquire _mutex. + They are usually called by public methods that acquire and hold _mutex. + */ +class ZkFuseHandleManager : boost::noncopyable +{ + private: + /** + Typedef of handle, which is an int. + */ + typedef int Handle; + /** + Typedef of std::map used to map path to handle. + */ + typedef std::map Map; + /** + Typedef of std::vector used to map handle to ZkFuseFile instances. + */ + typedef std::vector Files; + /** + Typedef of std::vector used to hold unused handles. + */ + typedef std::vector FreeList; + /** + Typedef of boost::weak_ptr to the ZkFuseHandleManager instance. + */ + typedef boost::weak_ptr WeakPtr; + + /* Only ZkFuseHandleManagerFactory can create instances of this class */ + friend class ZkFuseHandleManagerFactory; + + /** + Contains common configuration. + Immutable so that it can be accessed without locks. + */ + const ZkFuseCommon _common; + /** + Maps a path name to a Handle. + */ + Map _map; + /** + Maps a handle to a ZkFuseFile instances. + Also holds pointers to all known ZkFuseFile instances. + An element may point to an allocated ZkFuseFile instance or be NULL. + + An allocated ZkFuseFile instance may be in one of the following states: + - in-use + Currently open, i.e. the ZkFuseFile instance's reference count + greater than 0. + - in-cache + Not currently open, i.e. the ZkFuseFile instances's + reference count is 0. + */ + Files _files; + /** + List of free'ed handles. + */ + FreeList _freeList; + /** + Mutex used to protect this instance. + */ + mutable zkfuse::Mutex _mutex; + /** + Count of number of in-use entries. + It used to calculate number of cached nodes. + Number cached nodes is (_files.size() - _numInUse). + */ + unsigned _numInUse; + /** + WeakPtr to myself. + */ + WeakPtr _thisWeakPtr; + + /** + Obtain a handle for the given path. + - If path is not known, then allocate a new handle and increment + _numInUse, and set newFile to true. The allocated + ZkFuseFile instance's reference count should be 1. + - If path is known, increase the corresponding + ZkFuseFile instance's reference count. + + \return the allocated handle. + \param path the path to lookup. + \param newFile indicates whether a new handle has been allocated. + */ + Handle allocate(const std::string & path, bool & newFile); + + /** + Constructor. + + \param common the immutable common configuration. + \param reserve number of elements to pre-allocate for + _files and _freeList. + */ + ZkFuseHandleManager( + const ZkFuseCommon & common, + const unsigned reserve) + : _common(common), + _files(), + _freeList(), + _mutex(), + _numInUse(0) + { + _files.reserve(reserve); + _files[0] = NULL; /* 0 never allocated */ + _files.resize(1); + _freeList.reserve(reserve); + } + + public: + /** + Typedef for boost::shared_ptr for this ZkFuseHandleManager class. + */ + typedef boost::shared_ptr SharedPtr; + + /** + Destructor. + */ + ~ZkFuseHandleManager() + { + } + /** + Get the ZkFuseFile instance for a handle. + + \return the ZkFuseFile instance identified by the handle. + \param handle get ZkFuseFile instance for this handle. + */ + ZkFuseFilePtr getFile(Handle handle) const + { + AutoLock lock(_mutex); + return _files[handle]; + } + /** + Get the immutable common configuration. + + \return the common configuration instance. + */ + const ZkFuseCommon & getCommon() const + { + return _common; + } + /** + Deallocate a previously allocated handle. + This decrements the reference count of the corresponding + ZkFuseFile instance. If the reference count becomes zero, + decrement _numInUse. It may also cause the ZkFuseFile instance + to be reclaimed if there are too many cached ZkFuseFile instances. + + The ZkFuseFile instance should be reclaimed if the number of + unused ZkFuseFile instances exceeds the configured cache size, i.e. + (_files.size() - _numInUse) > _common.getCacheSize() + and the ZkFuseFile instance has a reference count of zero. + + Reclaiming a ZkFuseFile instance involves removing the ZkFuseFile + instance's path to handle mapping from _map and the handle to the + ZkFuseFile instance mapping from _files, adding the handle to + the _freeList, and finally deleting the ZkFuseFile instance. + + \param handle the handle that should be deallocated. + */ + void deallocate(Handle handle); + /** + Handles ZooKeeper session events. + It invokes the known ZkFuseFile instances to let them know + that their watches will no longer be valid. + */ + void eventReceived(const ZKWatcherEvent & event); + /** + Get data from the specified the ZooKeeper path. + + \return 0 if successful, otherwise return negative errno. + \param path the path of the ZooKeeper node. + \param data return data read. + */ + int getData(const std::string & path, Data & data); + /** + Set data into the specified ZooKeeper path. + + \return 0 if successful, otherwise return negative errno. + \param path the path of the ZooKeeper node. + \param data the data to be written. + \param exists set to true if this path exists. + \param doFlush set to true if new data should be flushed to ZooKeeper. + */ + int setData(const std::string & path, + const Data & data, + bool exists, + bool doFlush); + /** + Create a ZooKeeper node to represent a ZkFuse file or directory. + + \return handle if successful, otherwise return negative errno. + \param path to create. + \param mode should be either S_IFDIR for directory or + S_IFREG for regular file. + \param mayExist if set and the ZooKeeper node already exist, return + valid handle instead of -EEXIST. + \param created returns whether a new ZooKeeper node had been created. + */ + int mknod(const std::string & path, + mode_t mode, + bool mayExist, + bool & created); + /** + Open a ZooKeeper node. + + The justCreated argument is used to differentiate if the _deleted flag + of the ZkFuseFile instance is to be trusted (i.e. the path + does not exist in ZooKeeper.) The _deleted flag is trusted + if the ZkFuseFile instance is known to exist in ZooKeeper after + invoking ZooKeeper with the path. + + If justCreated is true, then the ZkFuseFile instance was just created. + The ZkFuseFile constructor sets the _deleted flag to true because + path is not known to exist and hence should not be accessed. + The justCreated flag will force the ZkFuseFile instance to invoke + ZooKeeper to determine if the path exists. + + \return handle if successful, otherwise return negative errno. + \param path the path to open. + \param justCreated indicates if this is newly created ZkFuseFile instance. + */ + int open(const std::string & path, bool justCreated); + /** + Remove a ZkFuse directory. + + If force is not set, then the ZooKeeper node will be removed only + if it has no data and no child nodes except ZkFuse metadata nodes. + + \return 0 if successful, otherwise return negative errno. + \param path the path to remove. + \param force force removal, i.e. bypass checks. + */ + int rmdir(const char * path, bool force = false); + /** + Make a ZkFuse directory. + + ZkFuse represents a ZooKeeper node with no data and no children + as a regular file. In order to differentiate a newly created + directory from an empty regular file, mkdir will create a directory + metadata node as a child of the directory. + + \return 0 if successful, otherwise return negative errno. + \param path the path of the directory to create. + \param mode create directory with this mode + (mode currently not implemented). + */ + int mkdir(const char * path, mode_t mode); + /** + Remove a ZkFuse regular file. + + A file is the abstraction for the data part of a ZooKeeper node. + - If ZkFuse represents a ZooKeeper node as a directory, the data part + of the node is represented by synthesizing a name for this file. This + synthesized name is visible through readdir if the ZooKeeper node's + data is not empty. Removing such a file is done by truncating + the ZooKeeper node's data to 0 length. + - If ZkFuse represents a ZooKeeper node as a file, then removing the + is done by removing the ZooKeeper node (and its metadata). + + \return 0 if successful, otherwise return negative errno. + \param path the path of the file to remove. + */ + int unlink(const char * path); + /** + Get attributes of a ZkFuse regular file or directory. + + \return 0 if successful, otherwise return negative errno. + \param path get attributes for this path + \param stbuf store attributes here. + */ + int getattr(const char * path, struct stat & stbuf); + /** + Rename a ZkFuse regular file. + + It creates a new ZooKeeper node at toPath, copies data and file + metadata from the ZooKeeper node at fromPath to the new node, + and deletes the current ZooKeeper node. If the current ZooKeeper + node is not deleted if the new ZooKeeper node cannot be created + or the data copy fails. + + It cannot be used to rename a directory. + + \return 0 if successful, otherwise return negative errno. + \param fromPath the current path. + \param toPath rename to this path. + */ + int rename(const char * fromPath, const char * toPath); + /** + Add a child ZooKeeper path to the children information cache + of the ZkFuseFile instance that caches the parent ZooKeeper node. + + This is used to add a child path after a new ZooKeeper node has + been created to the children information cache of the parent + ZooKeeper node. This is needed because waiting for the children + changed event to update the cache may result in inconsistent local + views of the changes. + \see removeChildFromParent + + \parama childPath the path of the child ZooKeeper node. + */ + void addChildToParent(const std::string & childPath) const; + /** + Remove a child ZooKeeper path from the children information cache + of the ZkFuseFile instance that caches the parent ZooKeeper node. + + For example, this should happen whenever a path is deleted. + This child information cache of the parent will eventually be + invalidated by watches. However, the delivery of the children + change event may come after the next access and thus provide + the client with an inconsistent view. One example is that + client deletes the last file in a directory, but the children + changed event is not delivered before the client invokes rmdir. + to remove the parent. In this case, the rmdir fails because + the cached children information of the parent indicates the + "directory" is not empty. + + \param childPath the path of the child ZooKeeper node. + */ + void removeChildFromParent(const std::string & childPath) const; + /** + Return the path for the parent of the specified ZooKeeper path. + + \return the parent path. + \param childPath the child path. + */ + std::string getParentPath(const std::string & childPath) const; + /** + Return the ZooKeeper path from a ZkFuse path. + + The ZkFuse path may be a synthesized path. For example, a synthesized + path is required to access the data part of a ZooKeeper node's + data when ZkFuse represents the ZooKeeper node as directory. + A synthesized path is also required to create a child ZooKeeper node + under a ZooKeeper node that is represented by a regular file. + + \return the ZooKeeper path for path. + \param path the ZkFuse path, which may be a synthesized path. + \param nameType indicate whether the ZkFuse path is synthesized and + whether the synthesized ZkFuse path identifies a + directory or a regular file. + */ + std::string getZkPath(const char * path, ZkFuseNameType & nameType) const; +}; + +/** + ZkFuseHandleManagerFactory - factory for ZkFuseHandleManager. + + This is the only way to create a ZkFuseHandleManager instance. + to make sure that _thisWeakPtr of the instance is intialized + after the instance is created. + */ +class ZkFuseHandleManagerFactory +{ + public: + /** + Create an instance of ZkFuseHandleManager. + + \return the created ZkFuseHandleManager instance. + \param common the common configuration. + \param reserve initially reserve space for this number of handles. + */ + static ZkFuseHandleManager::SharedPtr create( + const ZkFuseCommon & common, + unsigned reserve = 1000) + { + ZkFuseHandleManager::SharedPtr manager + (new ZkFuseHandleManager(common, reserve)); + manager->_thisWeakPtr = manager; + return manager; + } +}; + +/** + ZkFuseAutoHandle - automatically closes handle. + + It holds an opened handle and automatically closes this handle + when it is destroyed. This enables code that open a handle + to be exception safe. + */ +class ZkFuseAutoHandle +{ + private: + /** + Typedef for Handle which is an int. + */ + typedef int Handle; + /** + Holds a reference to the ZkFuseHandlerManager instance that + allocated the handle. + */ + ZkFuseHandleManager::SharedPtr _manager; + /** + The handle that should be closed when this instance is destroyed. + A valid handle has value that is equal or greater than 0. + A negative value indicates an error condition, usually the value + is a negative errno. + */ + Handle _handle; + /** + Caches a reference to the ZkFuseFile instance with this handle. + This is a performance optimization so that _manager.getFile(_handle) + is only called once when the handle is initialized. + */ + ZkFuseFilePtr _file; + + /** + Initialize reference to the ZkFuseFile instance with this handle. + */ + void _initFile() + { + if (_handle >= 0) { + _file = _manager->getFile(_handle); + } else { + _file = NULL; + } + } + + public: + /** + Constructor - takes an previously opened handle. + + \param manager the ZkFuseHandleManager instance who allocated the handle. + \param handle the handle. + */ + ZkFuseAutoHandle( + const ZkFuseHandleManager::SharedPtr & manager, + int handle) + : _manager(manager), + _handle(handle), + _file() + { + _initFile(); + } + /** + Constructor - open path and remember handle. + + \param manager the ZkFuseHandleManager instance who allocated the handle. + \param path open this path and remember its handle in this instance. + */ + ZkFuseAutoHandle( + const ZkFuseHandleManager::SharedPtr & manager, + const std::string & path) + : _manager(manager), + _handle(_manager->open(path, false)), + _file() + { + _initFile(); + } + /** + Constructor - create path and remember handle. + + The creation mode indicates whether the path identifies a regular file + or a directory. + + \param manager the ZkFuseHandleManager instance who allocated the handle. + \param path create this path and remember its handle in this instance. + \param mode the creation mode for the path, should be either + S_IFDIR or S_IFDIR. + \param mayExist, if set and the path already exists, + then the ZkFuseAutoHandle will hold the handle + for the path instead of -EEXIST. + If not set and the path does not exist, then the handle + be -EEXIST. + */ + ZkFuseAutoHandle( + const ZkFuseHandleManager::SharedPtr & manager, + const std::string & path, + mode_t mode, + bool mayExist) + : _manager(manager), + _handle(-1), + _file() + { + bool created; + _handle = _manager->mknod(path, mode, mayExist, created); + _initFile(); + } + /** + Destructor - closes the handle. + */ + ~ZkFuseAutoHandle() + { + reset(); + } + /** + Get the handle. + \see _handle + */ + int get() const + { + return _handle; + } + /** + Get the ZkFuseFile instance of the handle. + \see _file + */ + ZkFuseFilePtr getFile() const + { + return _file; + } + /** + Forget the handle, don't close the handle. + */ + void release() + { + _handle = -1; + _file = NULL; + } + /** + Change the remembered handle. + + It will close the current handle (if valid). + */ + void reset(int handle = -1); +}; + +/** + ZkFuseStat - C++ wrapper for ZooKeeper Stat. + + This wrapper provides ZooKeeper Stat will constructors that + initializes the instance variables of Stat. + */ +class ZkFuseStat : public Stat +{ + public: + /** + Constructor - clear instance variables. + */ + ZkFuseStat() + { + clear(); + } + /** + Destructor - do nothing. + */ + ~ZkFuseStat() + { + } + /** + Clear instance variables. + */ + void clear() + { + czxid = 0; + mzxid = 0; + ctime = 0; + mtime = 0; + version = 0; + cversion = 0; + aversion = 0; + } +}; + +/** + ZkFuseFile - an instance encapsulates the runtime state of an allocated + ZooKeeper node. + + Memory management + - Referenced by the ZkFuseHandleManager that created this instance. + - Uses boost::shared_ptr to reference the ZkFuseHandleManager that + created this instance. This makes sure that this ZkFuseHandleManager + instance cannot be deleted when it has allocated ZkFuseFile instances. + - A ZkFuseHandleManager deletes itself if it can be reclaimed. + It can be reclaimed if it has no watches, its reference count is zero, + and the ZkFuseHandleManager instance would have more than the + configured number of cached ZkFuseFile instances. + - A ZkFuseFile instance cannot be deleted if it has active watches on + its ZooKeeper node. When one of its watches fires, the ZkFuseFile + instance must exist because one of its methods will be invoked + to process the event. If the ZkFuseFile instance has been deleted, + the method will access previously freed memory. + + Concurrency control + - _mutex protects the instance variables of an instance. + - Callers should assume that a public method will acquire _mutex. + - Methods of this class may not hold _mutex while invoking an + ZkFuseHandleManager instance. + - Methods that with names that begin with "_" do not acquire _mutex. + They are usually called by public methods that acquire and hold _mutex. +*/ +class ZkFuseFile : boost::noncopyable +{ + public: + /** + Maximum size for the data part of a ZooKeeper node. + */ + static const unsigned maxDataFileSize = MAX_DATA_SIZE; + + private: + /** + Mode returned by getattr for a ZkFuse directory. + */ + static const mode_t dirMode = (S_IFDIR | 0777); + /** + Mode returned by getattr for a ZkFuse regular file. + */ + static const mode_t regMode = (S_IFREG | 0777); + + /** + References the ZkFuseHandleManager that created this instance. + */ + ZkFuseHandleManager::SharedPtr _manager; + /** + Handle for this instance. + */ + const int _handle; + /** + Path of the ZooKeeper node represented by this instance. + */ + const std::string _path; + /** + Mutex that protects the instance variables of this instance. + */ + mutable zkfuse::Mutex _mutex; + /** + Reference count for this instance, i.e. the number of opens + minus the number of closes. + */ + int _refCount; + /** + Indicates whether the ZooKeeper node exist. + This flag allows caching of deleted ZooKeeper node to avoid + repeated ZooKeeper lookups for a non-existent path, and avoid + using cached information. + + Its value is true if + - it is verified to exist (by calling ZooKeeper), or + - it is existence is unknown because ZooKeeper has not been + invoked to verify its path's existence. + */ + bool _deleted; + /** + Count of current number directory opens minus directory closes. + */ + int _openDirCount; + /** + Indicates whether cached children information is valid. + + It is true if the cached children information is valid. + */ + bool _initializedChildren; + /** + Indicates whether there is an outstanding children watch. + + It is true if it has an outstanding children watch. + */ + bool _hasChildrenListener; + /** + Cached children information. + + The cache is valid if _initializedChildren is true. + */ + NodeNames _children; + + /** + Indicates whether the cached data is valid. + + It is true if the cached data and ZooKeeper Stat are valid. + */ + bool _initializedData; + /** + Indicates whether there is an outstanding data watch. + + It is true if it has an outstanding data watch. + */ + bool _hasDataListener; + /** + Indicates whether the cached data (_activeData) has been modified. + + It is true if the cached data has been modified. + */ + bool _dirtyData; + /** + Currently active data. + + To maintain atomicity of updates and emulate Posix semantics, + when a ZkFuse file remains open, the same data will be accessed + by the file's clients. The data will be flushed to ZooKeeper when + the flush method is called. The flush method may be called + explicitly by a client or implicitly when the ZkFuse file is no + longer currently open. + + _activeData and _activeStat stores the data and ZooKeeper Stat + that will be accessed by the file's clients. + + If there are changes when the ZkFuse file is open, new data is + cached as latest data (by _latestData and _latestStat). + */ + Data _activeData; + /** + Currently active ZooKeeper Stat. + \see _activeData + */ + ZkFuseStat _activeStat; + /** + Latest data. + This is either the same as _activeData or it is newer. It is newer + is it has been updated by event triggered by a data watch. + */ + Data _latestData; + /** + Latest ZooKeeper data. + This is either the same as _activeStat or it is newer. It is newer + is it has been updated by event triggered by a data watch. + */ + ZkFuseStat _latestStat; + + /** + Get userid. + + \return the userid. + */ + uid_t _getUid() const + { + return _manager->getCommon().getUid(); + } + /** + Get groupid. + + \return the groupid. + */ + gid_t _getGid() const + { + return _manager->getCommon().getGid(); + } + /** + Get block size. + + \return the block size. + */ + unsigned _getBlkSize() const + { + return _manager->getCommon().getBlkSize(); + } + /** + Get number of children, include metadata children in the count. + + \return the number of children including metadata children. + */ + unsigned _numChildrenIncludeMeta() const + { + unsigned count = _children.size(); + LOG_DEBUG(LOG, "numChildrenIncludeMeta() returns %u", count); + return count; + } + /** + Get number of children, exclude metadata children in the count. + + \return the number of children excluding metadata children. + */ + unsigned _numChildrenExcludeMeta() const + { + unsigned count = 0; + for (NodeNames::const_iterator it = _children.begin(); + it != _children.end(); + it++) { + if (!_isMeta(*it)) { + count++; + } + } + LOG_DEBUG(LOG, "numChildrenExcludeMeta() returns %u", count); + return count; + } + /** + Whether the ZooKeeper node has children, include metadata + children. + + \return true if it has children including metadata children. + */ + bool _hasChildrenIncludeMeta() const + { + return _numChildrenIncludeMeta() != 0; + } + /** + Return true if the ZooKeeper node has children, include metadata + children. + + \return true if it has children excluding metadata children. + */ + bool _hasChildrenExcludeMeta() const + { + return _numChildrenExcludeMeta() != 0; + } + /** + Whether the ZooKeeper node has data. + + \return true if _activeData is not empty. + */ + bool _hasData() const + { + return _activeData.empty() == false; + } + /** + Whether the ZooKeeper node has child with the specified path. + + \return true if the ZooKeeper node has a child with the specified path. + \param childPath the path of the child. + */ + bool _hasChildPath(const std::string & childPath) const + { + bool hasChild = + std::find(_children.begin(), _children.end(), childPath) + != _children.end(); + LOG_DEBUG(LOG, "hasChild(childPath %s) returns %d", + childPath.c_str(), hasChild); + return hasChild; + } + /** + Whether the given path component is a ZkFuse synthesized path + component. + + A ZkFuse synthesized path component will begin with + the metadataNamePrefix obtained from the common configuration. + \see _metadataNamePrefix + + \return true if the path component is a ZkFuse synthesized path + component. + \param childName the path component to check if it is synthesized by + ZkFuse. + */ + bool _isMeta(const std::string & childName) const + { + bool isMeta; + const std::string & prefix = + _manager->getCommon().getMetadataNamePrefix(); + unsigned offset = + (_path.length() > 1 ? + _path.length() + 1 : + 1 /* special case for root dir */ ); + unsigned minLength = offset + prefix.length(); + if (childName.length() < minLength || + childName.compare(offset, prefix.length(), prefix) != 0) { + isMeta = false; + } else { + isMeta = true; + } + LOG_DEBUG(LOG, "isMeta(childName %s) returns %d", + childName.c_str(), isMeta); + return isMeta; + } + /** + Build a path for a specific child of the ZooKeeper node. + + This is done by appending "/" (unless it is the ZooKeeper node + is the root node) and the name of the child. + + \return the path for the specified child of the ZooKeeper node. + \param name the name of the child. + */ + std::string _getChildPath(const std::string & name) const + { + return buildChildPath(_path, name); + } + /** + Whether the ZooKeeper node has a regular file metadata child node. + + \return true if the ZooKeeper node has a regular file metadata child + node. + */ + bool _hasRegMetadata() const + { + bool res = _hasChildPath( + _getChildPath(_manager->getCommon().getRegMetadataName())); + LOG_DEBUG(LOG, "hasRegMetadata() returns %d", res); + return res; + } + /** + Whether the ZooKeeper node has a directory metadata child node. + + \return true if the ZooKeeper node has a directory metadata child + node. + */ + bool _hasDirMetadata() const + { + bool res = _hasChildPath( + _getChildPath(_manager->getCommon().getDirMetadataName())); + LOG_DEBUG(LOG, "hasDirMetadata() returns %d", res); + return res; + } + /** + Whether ZkFuse should present the ZooKeeper node as a ZkFuse regular + file. + + It should be a ZkFuse regular file it has no children or its + only children is its regular file metadata child node. + + \return true if the Zookeeper node should be presented as a ZkFuse + regular file. + */ + bool _isReg() const + { + unsigned numChildrenIncludeMeta = _numChildrenIncludeMeta(); + bool res = + (numChildrenIncludeMeta == 0) || + (numChildrenIncludeMeta == 1 && _hasRegMetadata() == true); + LOG_DEBUG(LOG, "isReg() returns %d", res); + return res; + } + /** + Whether ZkFuse should present the ZooKeeper node as a ZkFuse directory. + + It should be a ZkFuse directory if it should not be presented as + a ZkFuse regular directory. + \see _isReg + + \return true if the Zookeeper node should be presented as a ZkFuse + directory. + */ + bool _isDir() const + { + return !_isReg(); + } + /** + Whether ZkFuse should present the ZooKeeper node as a ZkFuse regular + file by taking into account the specified ZkFuseNameType. + + The ZkFuseNameType may override the default ZkFuse presentation of + a ZooKeeper node. + + \return true if ZkFuse should present the ZooKeeper node as a ZkFuse + regular file. + \param nameType specifies the ZkFuseNameType. + \param doLock whether _mutex should be acquired, it should be true + if the caller did not acquire _mutex. + */ + bool _isRegNameType(ZkFuseNameType nameType, bool doLock = false) const + { + bool res; + switch (nameType) { + case ZkFuseNameRegType: + res = true; + break; + case ZkFuseNameDirType: + res = false; + break; + case ZkFuseNameDefaultType: + default: + if (doLock) { + AutoLock lock(_mutex); + res = _isReg(); + } else { + res = _isReg(); + } + break; + } + LOG_DEBUG(LOG, "isRegNameType(nameType %d) returns %d", + int(nameType), res); + return res; + } + /** + Whether ZkFuse should present the ZooKeeper node as a ZkFuse + directory by taking into account the specified ZkFuseNameType. + + The ZkFuseNameType may override the default ZkFuse presentation of + a ZooKeeper node. + + \return true if ZkFuse should present the ZooKeeper node as a ZkFuse + directory. + \param nameType specifies the ZkFuseNameType. + \param doLock whether _mutex should be acquired, it should be true + if the caller did not acquire _mutex. + */ + bool _isDirNameType(ZkFuseNameType nameType, bool doLock = false) const + { + bool res; + switch (nameType) { + case ZkFuseNameRegType: + res = false; + break; + case ZkFuseNameDirType: + res = true; + break; + case ZkFuseNameDefaultType: + default: + if (doLock) { + AutoLock lock(_mutex); + res = _isDir(); + } else { + res = _isDir(); + } + break; + } + LOG_DEBUG(LOG, "isDirNameType(nameType %d) returns %d", + int(nameType), res); + return res; + } + /** + ZkFuse regular file metadata. + */ + struct Metadata { + /** + Version of the ZooKeeper node data that this metadata is good for. + */ + uint32_t version; + /** + Acces time in milliseconds. + */ + uint64_t atime; + /** + Modified time in milliseconds. + */ + uint64_t mtime; + + /** + Constructor. + */ + Metadata() + : version(0), + atime(0), + mtime(0) + { + } + }; + /** + Encode Metadata into Data so that it can be stored in a metadata + ZooKeeper node. + + Each Metadata attribute is encoded as ": " on single line + terminated by newline. + + \param meta the input Metadata. + \param data the output Data after encoding. + */ + void _encodeMetadata(const Metadata & meta, Data & data) const + { + LOG_DEBUG(LOG, "encodeMetadata()"); + std::ostringstream oss; + oss << "version: " << meta.version << endl + << "atime: " << meta.atime << endl + << "mtime: " << meta.mtime << endl; + data = oss.str(); + } + /** + Decode Data from a metadata child ZooKeeper node into Metadata. + + Data is a stream of ": " records separated by newline. + + \param data the input Data. + \param meta the output Metadata after decoding. + */ + void _decodeMetadata(const Data & data, Metadata & meta) const + { + LOG_DEBUG(LOG, "decodeMetadata(data %s)", data.c_str()); + std::istringstream iss(data); + char key[128]; + char value[1024]; + while (!iss.eof()) { + key[0] = 0; + value[0] = 0; + iss.get(key, sizeof(key), ' '); + if (iss.eof()) { + break; + } + iss.ignore(32, ' '); + iss.getline(value, sizeof(value)); + LOG_DEBUG(LOG, "key %s value %s", key, value); + if (strcmp(key, "version:") == 0) { + unsigned long long v = strtoull(value, NULL, 0); + LOG_DEBUG(LOG, "version: %llu", v); + meta.version = v; + } + else if (strcmp(key, "atime:") == 0) { + unsigned long long v = strtoull(value, NULL, 0); + LOG_DEBUG(LOG, "atime: %llu", v); + meta.atime = v; + } + else if (strcmp(key, "mtime:") == 0) { + unsigned long long v = strtoull(value, NULL, 0); + LOG_DEBUG(LOG, "mtime: %llu", v); + meta.mtime = v; + } + else { + LOG_WARN(LOG, "decodeMetadata: path %s unknown key %s %s\n", + _path.c_str(), key, value); + } + } + LOG_DEBUG(LOG, "decodeMetadata done"); + } + /** + Flush data to the ZooKeeper node. + + If cached active data has been modified, flush it to the ZooKeeper node. + Returns -EIO if the data cannot be written because the cached active + data is not the expected version, i.e. ZooKeeper returns ZBADVERSION. + -EIO may also indicate a more general failure, such as unable to + communicate with ZooKeeper. + + \return 0 if successful, otherwise negative errno. + */ + int _flush() + { + LOG_DEBUG(LOG, "flush() path %s", _path.c_str()); + + int res = 0; + try { + if (_dirtyData) { + LOG_DEBUG(LOG, "is dirty, active version %d", + _activeStat.version); + _manager->getCommon().getZkAdapter()-> + setNodeData(_path, _activeData, _activeStat.version); + /* assumes version always increments by one if successful */ + _deleted = false; + _activeStat.version++; + _dirtyData = false; + res = 0; + } + else { + LOG_DEBUG(LOG, "not dirty"); + res = 0; + } + } catch (const ZooKeeperException & e) { + if (e.getZKErrorCode() == ZBADVERSION) { + LOG_ERROR(LOG, "flush %s bad version, was %d", + _path.c_str(), _activeStat.version); + res = -EIO; + } + else { + LOG_ERROR(LOG, "flush %s exception %s", + _path.c_str(), e.what()); + res = -EIO; + } + } + + LOG_DEBUG(LOG, "flush returns %d", res); + return res; + } + /** + Truncate or expand the size of the cached active data. + + This method only changes the size of the cached active data. + This change is committed to ZooKeeper when the cached data + is written to the ZooKeeper node by flush(). + + Return -EFBIG is the requested size exceeds the maximum. + + \return 0 if successful, otherwise negative errno. + \param size the requested size. + */ + int _truncate(off_t size) + { + LOG_DEBUG(LOG, "truncate(size %zu) path %s", size, _path.c_str()); + + int res = 0; + + if (!_isInitialized()) { + LOG_DEBUG(LOG, "not initialized"); + res = -EIO; + } + else if (size > _activeData.size()) { + if (size > maxDataFileSize) { + LOG_DEBUG(LOG, "size > maxDataFileSize"); + res = -EFBIG; + } else { + LOG_DEBUG(LOG, "increase to size"); + _activeData.insert(_activeData.begin() + + (size - _activeData.size()), 0); + _dirtyData = true; + res = 0; + } + } + else if (size < _activeData.size()) { + LOG_DEBUG(LOG, "decrease to size"); + _activeData.resize(size); + _dirtyData = true; + res = 0; + } + else { + LOG_DEBUG(LOG, "do nothing, same size"); + } + + LOG_DEBUG(LOG, "truncate returns %d", res); + return res; + } + /** + Remove a ZkFuse directory. + + If force is true, then the ZooKeeper node and its decendants + will be deleted. + + If force is false, then this method implements the semantics + of removing a ZkFuse directory. It will delete the ZooKeeper node + only if the ZooKeeper node have no data and no non-metadata + children. + - Return -ENOTDIR if the ZooKeeper node is not considered + to be a directory (after taking into consideration the specified + ZkFuseNameType). + - Return -ENOTEMPTY if the ZooKeeper node has data or it has + non-metadata children. + - Return -ENOENT if the ZooKeeper cannot be deleted, usually this + is because it does not exist. + + \return 0 if successful, otherwise negative errno. + \param nameType the ZkFuseNameType of the path used to specify the + directory to be removed. It influences whether ZkFuse + considers the ZooKeeper node to be a regular file or + directory. \see ZkFuseNameType + \param force set to true to bypass ZkFuse rmdir semantic check. + */ + int _rmdir(ZkFuseNameType nameType, bool force) + { + LOG_DEBUG(LOG, "rmdir(nameType %d, force %d) path %s", + int(nameType), force, _path.c_str()); + + int res = 0; + try { + if (!force && !_isDirNameType(nameType)) { + LOG_DEBUG(LOG, "failed because not directory"); + res = -ENOTDIR; + } + else if (!force && _hasData()) { + /* rmdir cannot occur if there non-empty "data file" */ + LOG_DEBUG(LOG, "failed because node has data"); + res = -ENOTEMPTY; + } + else if (!force && _hasChildrenExcludeMeta()) { + /* rmdir cannot occur if there are "subdirs" */ + LOG_DEBUG(LOG, "failed because node has children"); + res = -ENOTEMPTY; + } + else { + LOG_DEBUG(LOG, "delete node"); + bool deleted = _manager->getCommon().getZkAdapter()-> + deleteNode(_path, true); + if (deleted) { + _deleted = true; + _clearChildren(); + res = 0; + } else { + /* TODO: differentiate delete error conditions, + * e.g. access permission, not exists, ... ? + */ + LOG_DEBUG(LOG, "delete failed"); + res = -ENOENT; + } + } + } catch (const std::exception & e) { + LOG_ERROR(LOG, "rmdir %s exception %s", _path.c_str(), e.what()); + res = -EIO; + } + + LOG_DEBUG(LOG, "rmdir returns %d", res); + return res; + } + /** + Remove a ZkFuse regular file. + + This method implements the semantics of removing a ZkFuse regular file. + - If the ZkFuse regular file represents the data part of the + ZooKeeper node which is presented as a ZkFuse directory, + the regular file is virtually deleted by truncating the + ZooKeeper node's data. Readdir will not synthesize a regular + file entry for the data part of a ZooKeeper node if + the ZooKeeper node has no data. + - If the ZkFuse regular file represents the data part of the + ZooKeeper node which is presented as a ZkFuse regular file, + the ZooKeeper node and its decendants are deleted. + + Returns -EISDIR if the ZkFuse regular file cannot be deleted + because ZkFuse consider it to be a directory. + + \return 0 if successful, otherwise negative errno. + \param nameType the ZkFuseNameType of the path used to specify the + directory to be removed. It influences whether ZkFuse + considers the ZooKeeper node to be a regular file or + directory. \see ZkFuseNameType + */ + int _unlink(ZkFuseNameType nameType) + { + LOG_DEBUG(LOG, "unlink(nameType %d) path %s", + int(nameType), _path.c_str()); + + int res = 0; + switch (nameType) { + case ZkFuseNameRegType: + if (_isDir()) { + res = _truncate(0); + } else { + res = _rmdir(nameType, true); + } + break; + case ZkFuseNameDirType: + res = -EISDIR; + break; + case ZkFuseNameDefaultType: + default: + if (_isReg()) { + res = _rmdir(nameType, true); + } else { + res = -EISDIR; + } + break; + } + + LOG_DEBUG(LOG, "unlink returns %d", res); + return res; + } + /** + Whether cached children and data are valid. + + \return true if cached children and data are valid. + */ + bool _isInitialized() const + { + return _initializedChildren && _initializedData; + } + /** + Clear and invalidate cached children information. + */ + void _clearChildren() + { + _initializedChildren = false; + _children.clear(); + } + /** + Clear and invalidate cached data. + */ + void _clearData() + { + _initializedData = false; + _dirtyData = false; + _activeData.clear(); + _activeStat.clear(); + _latestData.clear(); + _latestStat.clear(); + } + /** + Whether the ZkFuseFile instance is a zombie. + + It is a zombie if it is not currently open, i.e. its reference count + is 0. + */ + bool _isZombie() const + { + return (_refCount == 0); + } + /** + Whether the ZkFuseFile instance is currently opened as a regular file + only once. + + It is used to determine when the cached data can be replaced with + the latest data. \see _activeData. + + \return true if its currently opened as a regular file only once. + */ + bool _isOnlyRegOpen() const + { + return ((_refCount - _openDirCount) == 1); + } + /** + Get attributes without accessing metadata. + + The atime and mtime returned does not take into consideration + overrides present in a matadata file. + + \return 0 if successful, otherwise negative errno. + \param stbuf return attributes here. + \param nameType specifies the ZkFuseNameType of the ZkFuse path used + to get attributes. It influences whether the directory + or regular file attributes are returned. + */ + int _getattrNoMetaAccess(struct stat & stbuf, ZkFuseNameType nameType) const + { + int res = 0; + if (_deleted) { + LOG_DEBUG(LOG, "deleted"); + res = -ENOENT; + } + else if (!_isInitialized()) { + LOG_DEBUG(LOG, "not initialized"); + res = -EIO; + } + else { + assert(_isInitialized()); + bool isRegular = _isRegNameType(nameType); + if (isRegular) { + LOG_DEBUG(LOG, "regular"); + stbuf.st_mode = regMode; + stbuf.st_nlink = 1; + stbuf.st_size = _activeData.size(); + } else { + LOG_DEBUG(LOG, "directory"); + stbuf.st_mode = dirMode; + stbuf.st_nlink = + _children.size() + (_activeData.empty() ? 0 : 1); + stbuf.st_size = stbuf.st_nlink; + } + stbuf.st_uid = _getUid(); + stbuf.st_gid = _getGid(); + /* IMPORTANT: + * Conversion to secs from millisecs must occur before + * assigning to st_atime, st_mtime, and st_ctime. Otherwise + * truncating from 64-bit to 32-bit will cause lost of + * most significant 32-bits before converting to secs. + */ + stbuf.st_atime = millisecsToSecs(_activeStat.mtime); + stbuf.st_mtime = millisecsToSecs(_activeStat.mtime); + stbuf.st_ctime = millisecsToSecs(_activeStat.ctime); + stbuf.st_blksize = _getBlkSize(); + stbuf.st_blocks = + (stbuf.st_size + stbuf.st_blksize - 1) / stbuf.st_blksize; + res = 0; + } + return res; + } + /** + Get the context that should be registered with the data and + children watches. + + The returned context is a pointer to the ZkFuseFile instance + cast to the desired ContextType. + + \return the context. + */ + ZooKeeperAdapter::ContextType _getZkContext() const + { + return (ZooKeeperAdapter::ContextType) NULL; + } + + /** + DataListener - listener that listens for ZooKeeper data events + and calls dataEventReceived on the ZkFuseFile instance + identified by the event context. + \see dataEventReceived + */ + class DataListener : public ZKEventListener { + public: + /** + Received a data event and invoke ZkFuseFile instance obtained from + event context to handle the event. + */ + virtual void eventReceived(const ZKEventSource & source, + const ZKWatcherEvent & event) + { + assert(event.getContext() != 0); + ZkFuseFile * file = static_cast(event.getContext()); + file->dataEventReceived(event); + } + }; + + /** + DataListener - listener that listens for ZooKeeper children events + and calls childrenEventReceived on the ZkFuseFile instance + identified by the event context. + \see childrenEventReceived + */ + class ChildrenListener : public ZKEventListener { + public: + /** + Received a children event and invoke ZkFuseFile instance obtained from + event context to handle the event. + */ + virtual void eventReceived(const ZKEventSource & source, + const ZKWatcherEvent & event) + { + assert(event.getContext() != 0); + ZkFuseFile * file = static_cast(event.getContext()); + file->childrenEventReceived(event); + } + }; + + /** + Globally shared DataListener. + */ + static DataListener _dataListener; + /** + Globally shared ChildrenListener. + */ + static ChildrenListener _childrenListener; + + public: + /** + Constructor. + + Sets reference count to one, i.e. it has been constructed because + a client is trying to open the path. \see _refCount. + Sets deleted to true. \see _deleted. + Sets number of currently directory opens to zero. \see _openDirCount. + Invalidate cach for children information and data. + + \param manager the ZkFuseHandleManager instance who is creating this + ZkFuseFile instance. + \param handle the handle assigned by the ZkFuseHandleManager instance + for this ZkFuseFile instance. + \param path the ZooKeeper path represented by this ZkFuseFile instance. + */ + ZkFuseFile(const ZkFuseHandleManager::SharedPtr & manager, + const int handle, + const std::string & path) + : _manager(manager), + _handle(handle), + _path(path), + _mutex(), + _refCount(1), + _deleted(true), + /* children stuff */ + _openDirCount(0), + _initializedChildren(false), + _hasChildrenListener(false), + _children(), + /* data stuff */ + _initializedData(false), + _hasDataListener(false), + _dirtyData(false), + _activeData(), + _activeStat(), + _latestData(), + _latestStat() + { + LOG_DEBUG(LOG, "constructor() path %s", _path.c_str()); + } + /** + Destructor. + */ + ~ZkFuseFile() + { + LOG_DEBUG(LOG, "destructor() path %s", _path.c_str()); + + assert(_isZombie()); + _clearChildren(); + _clearData(); + } + /** + Whether the ZooKeeper node represented by this ZkFuseFile instance + has been deleted. + \see _deleted + + \return true if it is deleted. + */ + bool isDeleted() const + { + AutoLock lock(_mutex); + return _deleted; + } + /** + Return the path of the ZooKeeper node represented by this ZkFuseFile + instance. + \see _path. + + \return the ZooKeeper node's path. + */ + const string & getPath() const + { + return _path; + } + /** + Add a childPath to the children information cache. + + \return 0 if successful, otherwise return negative errno. + \param childPath the ZooKeeper path of the child. + */ + int addChild(const std::string & childPath) + { + LOG_DEBUG(LOG, "addChild(childPath %s) path %s", + childPath.c_str(), _path.c_str()); + + int res = 0; + { + AutoLock lock(_mutex); + if (_initializedChildren) { + NodeNames::iterator it = + std::find(_children.begin(), _children.end(), childPath); + if (it == _children.end()) { + LOG_DEBUG(LOG, "child not found, adding child path"); + _children.push_back(childPath); + res = 0; + } + else { + LOG_DEBUG(LOG, "child found"); + res = -EEXIST; + } + } + } + + LOG_DEBUG(LOG, "addChild returns %d", res); + return res; + } + /** + Remove a childPath from the children information cache. + + \return 0 if successful, otherwise return negative errno. + \param childPath the ZooKeeper path of the child. + */ + int removeChild(const std::string & childPath) + { + LOG_DEBUG(LOG, "removeChild(childPath %s) path %s", + childPath.c_str(), _path.c_str()); + + int res = 0; + { + AutoLock lock(_mutex); + if (_initializedChildren) { + NodeNames::iterator it = + std::find(_children.begin(), _children.end(), childPath); + if (it != _children.end()) { + LOG_DEBUG(LOG, "child found"); + _children.erase(it); + res = 0; + } + else { + LOG_DEBUG(LOG, "child not found"); + res = -ENOENT; + } + } + } + + LOG_DEBUG(LOG, "removeChild returns %d", res); + return res; + } + /** + Invalidate the cached children information and cached data. + \see _clearChildren + \see _clearData + + \param clearChildren set to true to invalidate children information cache. + \param clearData set to true to invalidate data cache. + */ + void clear(bool clearChildren = true, bool clearData = true) + { + LOG_DEBUG(LOG, "clear(clearChildren %d, clearData %d) path %s", + clearChildren, clearData, _path.c_str()); + + { + AutoLock lock(_mutex); + if (clearChildren) { + _clearChildren(); + } + if (clearData) { + _clearData(); + } + } + } + /** + Whether reference count is zero. + \see _refCount + + \return true if reference count is zero. + */ + bool isZombie() const + { + AutoLock lock(_mutex); + + return (_refCount == 0); + } + /** + Increment the reference count of the ZkFuseFile instance. + + This method may be called by a ZkFuseFileManager instance while + holding the ZkFuseFileManager's _mutex. To avoid deadlocks, + this methods must never invoke a ZkFuseFileManager instance + directly or indirectly while holding the ZkFuseFile instance's + _mutex. + \see _refCount + + \return the post-increment reference count. + \param count value to increment the reference count by. + */ + int incRefCount(int count = 1) + { + LOG_DEBUG(LOG, "incRefCount(count %d) path %s", count, _path.c_str()); + + int res = 0; + { + AutoLock lock(_mutex); + _refCount += count; + assert(_refCount >= 0); + res = _refCount; + } + + LOG_DEBUG(LOG, "incRefCount returns %d", res); + return res; + } + /** + Decrement the reference count of the ZkFuseFile instance. + + This method may be called by a ZkFuseFileManager instance while + holding the ZkFuseFileManager's _mutex. To avoid deadlocks, + this methods must never invoke a ZkFuseFileManager instance + directly or indirectly while holding the ZkFuseFile instance's + _mutex. + \see _refCount + + \return the post-decrement reference count. + \param count value to decrement the reference count by. + */ + int decRefCount(int count = 1) + { + return incRefCount(-count); + } + /** + Increment the count of number times the ZkFuseFile instance has + been opened as a directory. + + This count is incremented by opendir and decremented by releasedir. + \see _openDirCount. + + \return the post-increment count. + \param count the value to increment the count by. + */ + int incOpenDirCount(int count = 1) + { + LOG_DEBUG(LOG, "incOpenDirCount(count %d) path %s", + count, _path.c_str()); + + int res = 0; + { + AutoLock lock(_mutex); + _openDirCount += count; + assert(_openDirCount >= 0); + res = _openDirCount; + assert(_openDirCount <= _refCount); + } + + LOG_DEBUG(LOG, "incOpenDirCount returns %d", res); + return res; + + } + /** + Decrement the count of number times the ZkFuseFile instance has + been opened as a directory. + + This count is incremented by opendir and decremented by releasedir. + \see _openDirCount. + + \return the post-decrement count. + \param count the value to decrement the count by. + */ + int decOpenDirCount(int count = 1) + { + return incOpenDirCount(-count); + } + /** + Whether ZkFuse should present the ZooKeeper node as a ZkFuse + directory by taking into account the specified ZkFuseNameType. + + The ZkFuseNameType may override the default ZkFuse presentation of + a ZooKeeper node. + \see _isDirNameType + + \return true if ZkFuse should present the ZooKeeper node as a ZkFuse + directory. + \param nameType specifies the ZkFuseNameType. + */ + bool isDirNameType(ZkFuseNameType nameType) const + { + return _isDirNameType(nameType, true); + } + /** + Whether ZkFuse should present the ZooKeeper node as a ZkFuse + regular file by taking into account the specified ZkFuseNameType. + + The ZkFuseNameType may override the default ZkFuse presentation of + a ZooKeeper node. + \see _isRegNameType + + \return true if ZkFuse should present the ZooKeeper node as a ZkFuse + regular file. + \param nameType specifies the ZkFuseNameType. + */ + bool isRegNameType(ZkFuseNameType nameType) const + { + return _isRegNameType(nameType, true); + } + /** + Get the active data. + \see _activeData + + \param data return data here. + */ + void getData(Data & data) const + { + AutoLock lock(_mutex); + + data = _activeData; + } + /** + Set the active data. + \see _activeData + + Return -EFBIG is the data to be written is bigger than the maximum + permitted size (and no data is written). + + \return 0 if successful, otherwise return negative errno. + \param data set to this data. + \param doFlush whether to flush the data to the ZooKeeper node. + */ + int setData(const Data & data, bool doFlush) + { + LOG_DEBUG(LOG, "setData(doFlush %d) path %s", doFlush, _path.c_str()); + int res = 0; + + if (data.size() > maxDataFileSize) { + res = -EFBIG; + } + else { + AutoLock lock(_mutex); + _activeData = data; + _dirtyData = true; + if (doFlush) { + res = _flush(); + } + } + + LOG_DEBUG(LOG, "setData() returns %d", res); + return res; + } + /** + Update the children information and the data caches as needed. + + This method is invoked when a ZkFuse regular file or directory + implemented by this ZkFuseFile instance is opened, e.g. + using open or opendir. It attempts to: + - make sure that the cache has valid children information + - register for watches for changes if no previous watches have + been registered. + + The newFile flag indicates if the ZkFuseFile instance has just + been constructed and that ZooKeeper has not been contacted to + determine if the ZooKeeper path for this file really exist. + When a ZkFuseFile instance is created, the _deleted flag is set to + true because it is safer to assume that the ZooKeeper node does + not exist. The newFile flag causes the _deleted flag to be + ignored and ZooKeeper to be contacted to update the caches. + + If the newFile flag is false, then the ZkFuseFile instance is + currently open and have been opened before. Hence, these previous + opens should have contacted ZooKeeper and would like learned from + ZooKeeper whether the ZooKeeper path exists. Therefore, + the _deleted flag should be trustworthy, i.e. it has accurate + information on whether the ZooKeeper path actually exists. + + \return 0 if successful, otherwise return negative errno. + \param newFile set to true if the ZkFuseFile instance is newly created. + */ + int update(bool newFile) + { + LOG_DEBUG(LOG, "update(newFile %d) path %s", newFile, _path.c_str()); + + int res = 0; + { + AutoLock lock(_mutex); + + /* At this point, cannot be zombie. + */ + assert(!_isZombie()); + if (!newFile && _deleted) { + /* Deleted file, don't bother to update caches */ + LOG_DEBUG(LOG, "deleted, not new file"); + res = -ENOENT; + } + else { + try { + LOG_DEBUG(LOG, "initialized children %d, data %d", + _initializedChildren, _initializedData); + LOG_DEBUG(LOG, "has children watch %d, data watch %d", + _hasChildrenListener, _hasDataListener); + /* + * Children handling starts here. + * If don't have children listener, + * then must establish listener. + * If don't have cached children information, + * then must get children information. + * It just happens, that the same ZooKeeper API + * is used for both. + */ + if (_initializedChildren == false || + _hasChildrenListener == false +#ifdef ZOOKEEPER_ROOT_CHILDREN_WATCH_BUG + /* HACK for root node because changes to children + * on a root node does not cause children watches to + * fire. + */ + || _path.length() == 1 +#endif // ZOOKEEPER_ROOT_CHILDREN_WATCH_BUG + ) { + LOG_DEBUG(LOG, "update children"); + NodeNames children; + _manager->getCommon().getZkAdapter()-> + getNodeChildren( children, _path, + &_childrenListener, _getZkContext()); + _hasChildrenListener = true; + LOG_DEBUG(LOG, "update children done"); + _children.swap(children); + _initializedChildren = true; + /* Since getNodeChildren is successful, the + * path must exist */ + _deleted = false; + } + else { + /* Children information is fresh since + * it is initialized and and have been + * updated by listener. + */ + } + /* + * Data handling starts here. + */ + assert(newFile == false || _isOnlyRegOpen()); + if (!_isOnlyRegOpen()) { + /* If is already currently opened by someone, + * then don't update data with latest from ZooKeeper, + * use current active data (which may be initialized + * or not). + * \see _activeData + */ + LOG_DEBUG(LOG, "node currently in-use, no data update"); + } + else { + /* If not opened/reopened by someone else, + * then perform more comprehensive checks of + * to make data and listener is setup correctly. + * If don't have data listener, + * then must establish listener. + * If don't have cached data, + * then must get data. + * It just happens, that the same ZooKeeper API + * is used for both. + */ + LOG_DEBUG(LOG, "node first use or reuse"); + if (_initializedData == false || + _hasDataListener == false) { + /* Don't have any data for now or need to register + * for callback */ + LOG_DEBUG(LOG, "update data"); + _latestData = + _manager->getCommon().getZkAdapter()-> + getNodeData(_path, &_dataListener, + _getZkContext(), + &_latestStat); + _hasDataListener = true; + LOG_DEBUG(LOG, + "update data done, latest version %d", + _latestStat.version); + /* Since getNodeData is successful, the + * path must exist. */ + _deleted = false; + } + else { + /* Data is fresh since it is initialized and + * and have been updated by listener. + */ + } + /* Update active data to the same as the most + * recently acquire data. + */ + _activeData = _latestData; + _activeStat = _latestStat; + _initializedData = true; + _dirtyData = false; + LOG_DEBUG(LOG, "update set active version %d", + _activeStat.version); + } + res = 0; + } catch (const ZooKeeperException & e) { + /* May have ZNONODE exception if path does exist. */ + if (e.getZKErrorCode() == ZNONODE) { + LOG_DEBUG(LOG, "update %s exception %s", + _path.c_str(), e.what()); + /* Path does not exist, set _deleted, + * clear children information cache + */ + _deleted = true; + _clearChildren(); + res = -ENOENT; + } else { + LOG_ERROR(LOG, "update %s exception %s", + _path.c_str(), e.what()); + res = -EIO; + } + } + } + } + + LOG_DEBUG(LOG, "update returns %d", res); + return res; + } + /** + Process a data event. + + This method may: + - Invalidate the data cache. + - Invoke ZooKeeper to update the data cache and register a new + data watch so that the cache can be kept in-sync with the + ZooKeeper node's data. + + This method does not change the active data. Active data will be + changed to a later version by update() at the appropriate time. + \see update. + */ + void dataEventReceived(const ZKWatcherEvent & event) + { + bool reclaim = false; + int eventType = event.getType(); + int eventState = event.getState(); + + /* + IMPORTANT: + + Do not mark ZkFuseFile instance as deleted when a ZOO_DELETED_EVENT + is received without checking with ZooKeeper. An example of + problematic sequence would be: + + 1. Create node. + 2. Set data and watch. + 3. Delete node. + 4. Create node. + 5. Deleted event received. + + It is a bug to mark the ZkFuseFile instance as deleted after + step 5 because the node exists. + + Therefore, this method should always contact ZooKeeper to keep the + data cache (and deleted status) up-to-date if necessary. + */ + LOG_DEBUG(LOG, "dataEventReceived() path %s, type %d, state %d", + _path.c_str(), eventType, eventState); + { + AutoLock lock(_mutex); + + _hasDataListener = false; + /* If zombie, then invalidate cached data. + * This clears _initializedData and eliminate + * the need to get the latest data from ZooKeeper and + * re-register data watch. + */ + if (_isZombie() && _initializedData) { + LOG_DEBUG(LOG, "invalidate data"); + _clearData(); + } + else if ((_refCount - _openDirCount) > 0) { + /* Don't invalidate cached data because clients of currently + * open files don't expect the data to change from under them. + * If data acted upon by these clients have become stale, + * then the clients will get an error when ZkFuse attempts to + * flush dirty data. The clients will not get error + * notification if they don't modify the stale data. + * + * If data cache is cleared here, then the following code + * to update data cache and re-register data watch will not + * be executed and may result in the cached data being + * out-of-sync with ZooKeeper. + */ + LOG_WARN(LOG, + "%s data has changed while in-use, " + "type %d, state %d, refCount %d", + _path.c_str(), eventType, eventState, _refCount); + } + /* If cache was valid and still connected + * then get the latest data from ZooKeeper + * and re-register data watch. This is required to keep + * the data cache in-sync with ZooKeeper. + */ + if (_initializedData && + eventState == ZOO_CONNECTED_STATE + ) { + try { + LOG_DEBUG(LOG, "register data watcher"); + _latestData = + _manager->getCommon().getZkAdapter()-> + getNodeData(_path, &_dataListener, _getZkContext(), + &_latestStat); + _hasDataListener = true; + LOG_DEBUG(LOG, + "get data done, version %u, cversion %u done", + _latestStat.version, _latestStat.cversion); + _deleted = false; + } catch (const ZooKeeperException & e) { + if (e.getZKErrorCode() == ZNONODE) { + _deleted = true; + _clearChildren(); + } + LOG_ERROR(LOG, "dataEventReceived %s exception %s", + _path.c_str(), e.what()); + } + } + } + LOG_DEBUG(LOG, "dataEventReceived return %d", reclaim); + } + /** + Process a children event. + + This method may: + - Invalidate the children information cache. + - Invoke ZooKeeper to update the children cache and register a new + data watch so that the cache can be kept in-sync with the + ZooKeeper node's children information. + */ + void childrenEventReceived(const ZKWatcherEvent & event) + { + bool reclaim = false; + int eventType = event.getType(); + int eventState = event.getState(); + + LOG_DEBUG(LOG, "childrenEventReceived() path %s, type %d, state %d", + _path.c_str(), eventType, eventState); + { + AutoLock lock(_mutex); + + _hasChildrenListener = false; + /* If zombie or disconnected, then invalidate cached children + * information. This clears _initializedChildren and eliminate + * the need to get the latest children information and + * re-register children watch. + */ + if (_initializedChildren && + (_isZombie() || eventState != ZOO_CONNECTED_STATE)) { + LOG_DEBUG(LOG, "invalidate children"); + _clearChildren(); + } + else if (_initializedChildren) { + /* Keep cached children information so that we have some + * children information if get new children information + * fails. If there is failure, then on next open, + * update() will attempt again to get children information + * again because _hasChildrenListener will be false. + * + * If children information cache is cleared here, then + * the following code to update children information cache + * and re-register children watch will not be executed + * and may result in the cached children information being + * out-of-sync with ZooKeeper. + * + * The children cache will be cleared if unable to + * get children and re-establish watch. + */ + LOG_WARN(LOG, + "%s children has changed while in-use, " + "type %d, state %d, refCount %d", + _path.c_str(), eventType, eventState, _refCount); + } + /* If children cache was valid and still connected, + * then get the latest children information from ZooKeeper + * and re-register children watch. This is required to + * keep the children information cache in-sync with ZooKeeper. + */ + if (_initializedChildren && + eventState == ZOO_CONNECTED_STATE + ) { + /* Should try to keep the cache in-sync, register call + * callback again and get current children. + */ + try { + LOG_DEBUG(LOG, "update children"); + NodeNames children; + _manager->getCommon().getZkAdapter()-> + getNodeChildren(children, _path, + &_childrenListener, _getZkContext()); + _hasChildrenListener = true; + LOG_DEBUG(LOG, "update children done"); + _children.swap(children); + _deleted = false; + } catch (const ZooKeeperException & e) { + if (e.getZKErrorCode() == ZNONODE) { + _deleted = true; + _clearChildren(); + } + LOG_ERROR(LOG, "childrenEventReceived %s exception %s", + _path.c_str(), e.what()); + _children.clear(); + } + } + } + LOG_DEBUG(LOG, "childrenEventReceived returns %d", reclaim); + } + /** + Truncate or expand the size of the cached active data. + + This method only changes the size of the cached active data. + This change is committed to ZooKeeper when the cached data + is written to the ZooKeeper node by flush(). + + Return -EFBIG is the requested size exceeds the maximum. + + \return 0 if successful, otherwise negative errno. + \param size the requested size. + */ + int truncate(off_t size) + { + int res = 0; + + { + AutoLock lock(_mutex); + res = _truncate(size); + } + + return res; + } + /** + Copy range of active data into specified output buffer. + + \return if successful, return number of bytes copied, otherwise + return negative errno. + \param buf address of the output buffer. + \param size size of the output buffer and desired number of bytes to copy. + \param offset offset into active data to start copying from. + */ + int read(char *buf, size_t size, off_t offset) const + { + LOG_DEBUG(LOG, "read(size %zu, off_t %zu) path %s", + size, offset, _path.c_str()); + + int res = 0; + + { + AutoLock lock(_mutex); + if (!_initializedData) { + LOG_DEBUG(LOG, "not initialized"); + res = -EIO; + } + else { + off_t fileSize = _activeData.size(); + if (offset > fileSize) { + LOG_DEBUG(LOG, "offset > fileSize %zu", fileSize); + res = 0; + } + else { + if (offset + size > fileSize) { + size = fileSize - offset; + LOG_DEBUG(LOG, + "reducing read size to %zu for fileSize %zu", + size, fileSize); + } + copy(_activeData.begin() + offset, + _activeData.begin() + offset + size, + buf); + res = size; + } + } + } + + LOG_DEBUG(LOG, "read returns %d", res); + return res; + } + /** + Copy buffer content to active data. + + \return if successful, return number of bytes copied, otherwise + return negative errno. + \param buf address of the buffer. + \param size size of the input buffer and desired number of bytes to copy. + \param offset offset into active data to start copying to. + */ + int write(const char *buf, size_t size, off_t offset) + { + LOG_DEBUG(LOG, "write(size %zu, off_t %zu) path %s", + size, offset, _path.c_str()); + + int res = 0; + + { + AutoLock lock(_mutex); + if (!_initializedData) { + LOG_DEBUG(LOG, "not initialized"); + res = -EIO; + } + else if (offset >= maxDataFileSize) { + LOG_DEBUG(LOG, "offset > maxDataFileSize %u", maxDataFileSize); + res = -ENOSPC; + } + else { + if (offset + size > maxDataFileSize) { + LOG_DEBUG(LOG, + "reducing write size to %zu " + "for maxDataFileSize %u", + size, maxDataFileSize); + size = maxDataFileSize - offset; + } + off_t fileSize = _activeData.size(); + if (offset + size > fileSize) { + LOG_DEBUG(LOG, "resizing to %zu", offset + size); + _activeData.resize(offset + size); + } + copy(buf, buf + size, _activeData.begin() + offset); + memcpy(&_activeData[offset], buf, size); + _dirtyData = true; + res = size; + } + } + + LOG_DEBUG(LOG, "write returns %d", res); + return res; + } + /** + Flush data to the ZooKeeper node. + + If cached active data has been modified, flush it to the ZooKeeper node. + Returns -EIO if the data cannot be written because the cached active + data is not the expected version, i.e. ZooKeeper returns ZBADVERSION. + -EIO may also indicate a more general failure, such as unable to + communicate with ZooKeeper. + + \return 0 if successful, otherwise negative errno. + */ + int flush() + { + int res = 0; + { + AutoLock lock(_mutex); + res = _flush(); + } + return res; + } + /** + Close of the ZkFuse regular file represented by the ZkFuseFile instance. + + This may: + - Flush dirty data to the ZooKeeper node, and return the result of the + flush operation. + - Reclaim the ZkFuseFile instance. + \see ZkFuseHandleManaer::reclaimIfNecessary + + \return result of flush operation - 0 if successful, + otherwise negative errno. + */ + int close() + { + LOG_DEBUG(LOG, "close() path %s", _path.c_str()); + int res = 0; + + bool reclaim = false; + { + AutoLock lock(_mutex); + res = _flush(); + if (_deleted) { + _clearData(); + _clearChildren(); + } + } + _manager->deallocate(_handle); + + LOG_DEBUG(LOG, "close returns %d", res); + return res; + } + /** + Get ZkFuse regular file or directory attributes. + + \return 0 if successful, otherwise negative errno. + \param stbuf return attributes here. + \param nameType specifies the ZkFuseNameType of the ZkFuse path used + to get attributes. It influences whether the directory + or regular file attributes are returned. + */ + int getattr(struct stat & stbuf, ZkFuseNameType nameType) const + { + LOG_DEBUG(LOG, "getattr(nameType %d) path %s", + int(nameType), _path.c_str()); + + int res = 0; + int version = 0; + std::string metaPath; + { + AutoLock lock(_mutex); + + res = _getattrNoMetaAccess(stbuf, nameType); + if (res == 0) { + version = _activeStat.version; + metaPath = _getChildPath( + ((stbuf.st_mode & S_IFMT) == S_IFREG) ? + _manager->getCommon().getRegMetadataName() : + _manager->getCommon().getDirMetadataName()); + if (_hasChildPath(metaPath) == false) { + metaPath.clear(); + } + } + } + if (res == 0 && metaPath.empty() == false) { + Data data; + int metaRes = _manager->getData(metaPath, data); + LOG_DEBUG(LOG, "metaRes %d dataSize %zu", + metaRes, data.size()); + if (metaRes == 0 && data.empty() == false) { + Metadata metadata; + _decodeMetadata(data, metadata); + LOG_DEBUG(LOG, "metadata version %u active version %u", + metadata.version, version); + if (metadata.version == version) { + /* IMPORTANT: + * Must convert from millisecs to secs before setting + * st_atime and st_mtime to avoid truncation error + * due to 64-bit to 32-bit conversion. + */ + stbuf.st_atime = millisecsToSecs(metadata.atime); + stbuf.st_mtime = millisecsToSecs(metadata.mtime); + } + } + } + + LOG_DEBUG(LOG, "getattr returns %d", res); + return res; + } + /** + Read directory entries. + This interface is defined by FUSE. + + \return 0 if successful, otherwise negative errno. + \param buf output buffer to store output directory entries. + \param filler function used to fill the output buffer. + \param offset start filling from a specific offset. + */ + int readdir(void *buf, fuse_fill_dir_t filler, off_t offset) const + { + LOG_DEBUG(LOG, "readdir(offset %zu) path %s", offset, _path.c_str()); + int res = 0; + + int dataFileIndex = -1; + unsigned leftTrim = 0; + typedef std::pair DirEntry; + typedef std::vector DirEntries; + DirEntries dirEntries; + + /* Get directory entries in two phase to avoid invoking + * ZkFuseHandleManager while holding _mutex. + * In first phase, get all the names of child nodes starting + * at offset. Also remember their index for use in second phase. + * The first phase hold _mutex. + */ + { + AutoLock lock(_mutex); + if (!_isInitialized()) { + LOG_DEBUG(LOG, "not initialized"); + res = -EIO; + } + else { + leftTrim = (_path.length() == 1 ? 1 : _path.length() + 1); + unsigned start = offset; + unsigned i; + for (i = start; i < _children.size(); i++) { + const std::string & childName = _children[i]; + if (_isMeta(childName)) { + continue; + } + dirEntries.push_back(DirEntry(childName, i)); + } + if (i == _children.size() && !_activeData.empty()) { + dataFileIndex = i + 1; + } + res = 0; + } + } + + /* Second phase starts here. + * DONOT hold _mutex as this phase invokes ZkFuseHandleManager to + * get attributes for the directory entries. + */ + if (res == 0) { + bool full = false; + for (DirEntries::const_iterator it = dirEntries.begin(); + it != dirEntries.end(); + it++) { + + ZkFuseAutoHandle childAutoHandle(_manager, it->first); + int childRes = childAutoHandle.get(); + if (childRes >= 0) { + struct stat stbuf; + int attrRes = childAutoHandle.getFile()-> + getattr(stbuf, ZkFuseNameDefaultType); + if (attrRes == 0) { + if (filler(buf, it->first.c_str() + leftTrim, + &stbuf, it->second + 1)) { + LOG_DEBUG(LOG, "filler full"); + full = true; + break; + } + } + } + } + if (full == false && dataFileIndex != -1) { + LOG_DEBUG(LOG, "include data file name"); + struct stat stbuf; + int attrRes = getattr(stbuf, ZkFuseNameRegType); + if (attrRes == 0) { + filler(buf, + _manager->getCommon().getDataFileName().c_str(), + &stbuf, dataFileIndex + 1); + } + } + } + + LOG_DEBUG(LOG, "readdir returns %d", res); + return res; + } + /** + Set the access time and modified time. + + Set the access and modifieds times on the ZkFuse regular file + or directory represented by this ZkFuseFile instance. + + Since there is no interface to change these times on a + ZooKeeper node, ZkFuse simulates this by writing to a + metadata node which is a child node of the ZooKeeper node. + ZkFuse writes the current version, the specified access + and modified times to the metadata node. + + When get attributes is invoked, get attributes will check + for the presence of this metadata node and if the version + number matches the current data version, then get attributes + will return the access and modified times stored in the + metadata node. + + \return 0 if successful, otherwise negative errno. + \param atime access time in milliseconds. + \param mtime modified time in milliseconds. + \param nameType specifies the ZkFuseNameType of the ZkFuse path used + to set access and modified times. It influences + whether the directory or regular file access and + modified times are set. + */ + int utime(uint64_t atime, uint64_t mtime, ZkFuseNameType nameType) + { + LOG_DEBUG(LOG, + "utime(atime %llu, mtime %llu, nameType %d) path %s", + (unsigned long long) atime, + (unsigned long long) mtime, + (int) nameType, _path.c_str()); + + int res = 0; + std::string metaPath; + bool exists = false; + Data data; + { + AutoLock lock(_mutex); + + if (!_isInitialized()) { + LOG_DEBUG(LOG, "not initialized"); + res = -EIO; + } + else { + bool isRegular = _isRegNameType(nameType); + Metadata metadata; + metadata.version = _activeStat.version; + metadata.atime = atime; + metadata.mtime = mtime; + metaPath = _getChildPath( + isRegular ? + _manager->getCommon().getRegMetadataName() : + _manager->getCommon().getDirMetadataName()); + exists = _hasChildPath(metaPath); + _encodeMetadata(metadata, data); + res = 0; + } + } + if (res == 0 && metaPath.empty() == false) { + res = _manager->setData(metaPath, data, exists, true); + } + + LOG_DEBUG(LOG, "utime returns %d", res); + return res; + } + /** + Remove a ZkFuse directory. + + If force is true, then the ZooKeeper node and its decendants + will be deleted. + + If force is false, then this method implements the semantics + of removing a ZkFuse directory. It will delete the ZooKeeper node + only if the ZooKeeper node have no data and no non-metadata + children. + - Return -ENOTDIR if the ZooKeeper node is not considered + to be a directory (after taking into consideration the specified + ZkFuseNameType). + - Return -ENOTEMPTY if the ZooKeeper node has data or it has + non-metadata children. + - Return -ENOENT if the ZooKeeper cannot be deleted, usually this + is because it does not exist. + + \return 0 if successful, otherwise negative errno. + \param nameType the ZkFuseNameType of the path used to specify the + directory to be removed. It influences whether ZkFuse + considers the ZooKeeper node to be a regular file or + directory. \see ZkFuseNameType + \param force set to true to bypass ZkFuse rmdir semantic check. + */ + int rmdir(ZkFuseNameType nameType, bool force) + { + int res = 0; + + { + AutoLock lock(_mutex); + res = _rmdir(nameType, force); + } + if (res == 0) { + _manager->removeChildFromParent(_path); + } + return res; + } + /** + Remove a ZkFuse regular file. + + This method implements the semantics of removing a ZkFuse regular file. + - If the ZkFuse regular file represents the data part of the + ZooKeeper node which is presented as a ZkFuse directory, + the regular file is virtually deleted by truncating the + ZooKeeper node's data. Readdir will not synthesize a regular + file entry for the data part of a ZooKeeper node if + the ZooKeeper node has no data. + - If the ZkFuse regular file represents the data part of the + ZooKeeper node which is presented as a ZkFuse regular file, + the ZooKeeper node and its decendants are deleted. + + Returns -EISDIR if the ZkFuse regular file cannot be deleted + because ZkFuse consider it to be a directory. + + \return 0 if successful, otherwise negative errno. + \param nameType the ZkFuseNameType of the path used to specify the + directory to be removed. It influences whether ZkFuse + considers the ZooKeeper node to be a regular file or + directory. \see ZkFuseNameType + */ + int unlink(ZkFuseNameType nameType) + { + int res = 0; + { + AutoLock lock(_mutex); + res = _unlink(nameType); + } + if (res == 0) { + _manager->removeChildFromParent(_path); + } + return res; + } + /** + Utility function to construct a ZooKeeper path for a child + of a ZooKeeper node. + + \return the full path of the child. + \param parent the parent's full path. + \param child the child's parent component. + */ + static std::string buildChildPath(const std::string & parent, + const std::string & child) + { + std::string s; + s.reserve(parent.length() + child.length() + 32); + if (parent.length() > 1) { + // special case for root dir + s += parent; + } + s += "/"; + s += child; + return s; + } +}; + +ZkFuseFile::DataListener ZkFuseFile::_dataListener; +ZkFuseFile::ChildrenListener ZkFuseFile::_childrenListener; + +void ZkFuseAutoHandle::reset(int handle) +{ + int old = _handle; + ZkFuseFilePtr oldFile = _file; + _handle = handle; + _initFile(); + if (old >= 0) { + assert(oldFile != NULL); + oldFile->close(); + } +} + +ZkFuseHandleManager::Handle +ZkFuseHandleManager::allocate(const std::string & path, bool & newFile) +{ + LOG_DEBUG(LOG, "allocate(path %s)", path.c_str()); + + Handle handle; + { + AutoLock lock(_mutex); + Map::iterator it = _map.find(path); + if (it == _map.end()) { + LOG_DEBUG(LOG, "not found"); + if (_freeList.empty()) { + handle = _files.size(); + _files.resize(handle + 1); + LOG_DEBUG(LOG, "free list empty, resize handle %d", handle); + } else { + handle = _freeList.back(); + _freeList.pop_back(); + LOG_DEBUG(LOG, "get from free list, handle %d", handle); + } + assert(_files[handle] == NULL); + _files[handle] = + new ZkFuseFile(SharedPtr(_thisWeakPtr), handle, path); + /* Not really supposed to invoke the new ZkFuseFile instance + * because this method is not supposed to invoke ZkFuseFile + * methods that while holding _mutex. However, it is safe + * to do without casuing deadlock because these methods + * are known not to invoke other methods, especially one + * that invoke this ZkFuseHandleManager instance. + */ + assert(_files[handle]->incRefCount(0) == 1); + _map[path] = handle; + _numInUse++; + LOG_DEBUG(LOG, "numInUse %u", _numInUse); + newFile = true; + } else { + LOG_DEBUG(LOG, "found"); + handle = it->second; + assert(_files[handle] != NULL); + int refCount = _files[handle]->incRefCount(); + if (refCount == 1) { + _numInUse++; + LOG_DEBUG(LOG, "resurrecting zombie, numInUse %u", _numInUse); + } + newFile = false; + } + } + + LOG_DEBUG(LOG, "allocate returns %d, newFile %d", handle, newFile); + return handle; +} + +void ZkFuseHandleManager::deallocate(Handle handle) +{ + LOG_DEBUG(LOG, "deallocate(handle %d)", handle); + + if (handle >= 0) { + bool reclaim = false; + ZkFuseFilePtr file; + { + AutoLock lock(_mutex); + file = _files[handle]; + assert(file != NULL); + int refCount = file->decRefCount(); + const std::string & path = file->getPath(); + LOG_DEBUG(LOG, "path %s ref count %d", path.c_str(), refCount); + if (refCount == 0) { + _numInUse--; + unsigned numCached = _files.size() - _numInUse; + if (numCached > _common.getCacheSize()) { + LOG_TRACE(LOG, + "reclaim path %s, cacheSize %u, filesSize %zu, " + "numInUse %u", + path.c_str(), + _common.getCacheSize(), _files.size(), _numInUse); + _map.erase(path); + _files[handle] = NULL; + _freeList.push_back(handle); + reclaim = true; + } + } + } + if (reclaim) { + delete file; + } + } + else { + LOG_DEBUG(LOG, "handle invalid"); + } + + LOG_DEBUG(LOG, "deallocate done"); +} + +void ZkFuseHandleManager::eventReceived(const ZKWatcherEvent & event) +{ + int eventType = event.getType(); + int eventState = event.getState(); + const std::string & path = event.getPath(); + LOG_DEBUG(LOG, "eventReceived() eventType %d, eventState %d, path %s", + eventType, eventState, path.c_str()); + + if (eventType == ZOO_DELETED_EVENT || + eventType == ZOO_CHANGED_EVENT || + eventType == ZOO_CHILD_EVENT) { + { + AutoLock lock(_mutex); + Map::iterator it = _map.find(path); + if (it != _map.end()) { + LOG_DEBUG(LOG, "path found"); + Handle handle = it->second; + ZkFuseFilePtr file = _files[handle]; + assert(file != NULL); + /* Prevent the ZkFuseFile instance from being + * deleted while handling the event. + */ + int refCount = file->incRefCount(); + if (refCount == 1) { + _numInUse++; + } + /* Pretent to be dir open. + */ + int dirCount = file->incOpenDirCount(); + { + /* _mutex is unlocked in this scope */ + AutoUnlockTemp autoUnlockTemp(lock); + if (eventType == ZOO_CHILD_EVENT) { + file->childrenEventReceived(event); + } + else if (eventType == ZOO_CHANGED_EVENT) { + file->dataEventReceived(event); + } + else { + assert(eventType == ZOO_DELETED_EVENT); + file->dataEventReceived(event); + // file->childrenEventReceived(event); + } + file->decOpenDirCount(); + deallocate(handle); + } + } + else { + LOG_WARN(LOG, + "path %s not found for event type %d, event state %d", + path.c_str(), eventType, eventState); + } + } + } + else if (eventType == ZOO_SESSION_EVENT) { + if (eventState == ZOO_CONNECTING_STATE) { + LOG_TRACE(LOG, "*** CONNECTING ***"); + { + AutoLock lock(_mutex); + for (int handle = 0; handle < _files.size(); handle++) { + ZkFuseFilePtr file = _files[handle]; + if (file != NULL) { + /* prevent the ZkFuseFile instance from being + * deleted while handling the event. + */ + int refCount = file->incRefCount(); + if (refCount == 1) { + _numInUse++; + } + /* Pretent to be dir open. + */ + int dirCount = file->incOpenDirCount(); + { + /* _mutex is unlocked in this scope */ + AutoUnlockTemp autoUnlockTemp(lock); + file->dataEventReceived(event); + file->childrenEventReceived(event); + file->decOpenDirCount(); + deallocate(handle); + } + /* this will eventually call decrement ref count */ + } + } + } + } + else if (eventState == ZOO_CONNECTED_STATE) { + LOG_TRACE(LOG, "*** CONNECTED ***"); + } + } + else { + LOG_WARN(LOG, + "eventReceived ignoring event type %d, event state %d, " + "path %s", eventType, eventState, path.c_str()); + } +} + +int ZkFuseHandleManager::getData(const std::string & path, + Data & data) +{ + LOG_DEBUG(LOG, "getData(path %s)", path.c_str()); + + int res = 0; + data.clear(); + ZkFuseAutoHandle autoHandle(SharedPtr(_thisWeakPtr), path); + res = autoHandle.get(); + if (res >= 0) { + autoHandle.getFile()->getData(data); + res = 0; + } + + LOG_DEBUG(LOG, "getData returns %d", res); + return res; +} + +int ZkFuseHandleManager::setData(const std::string & path, + const Data & data, + bool exists, + bool doFlush) +{ + LOG_DEBUG(LOG, "setData(path %s, exists %d)\n%s", + path.c_str(), exists, data.c_str()); + + int res = 0; + if (exists) { + res = open(path, false); + } else { + bool created; + res = mknod(path, S_IFREG, true, created); + } + if (res >= 0) { + ZkFuseAutoHandle autoHandle(SharedPtr(_thisWeakPtr), res); + res = autoHandle.getFile()->setData(data, doFlush); + } + + LOG_DEBUG(LOG, "setData returns %d", res); + return res; +} + +int ZkFuseHandleManager::mknod(const std::string & path, + mode_t mode, + bool mayExist, + bool & created) +{ + LOG_DEBUG(LOG, "mknod(path %s, mode %o, mayExist %d)", + path.c_str(), mode, mayExist); + + int res = 0; + created = false; + try { + if (S_ISREG(mode) == false && S_ISDIR(mode) == false) { + LOG_DEBUG(LOG, "bad mode %o", mode); + res = -EINVAL; + } + else { + Data data; + LOG_DEBUG(LOG, "create %s", path.c_str()); + created = + _common.getZkAdapter()->createNode(path, data, 0, false); + if (created) { + LOG_DEBUG(LOG, "created"); + if (S_ISDIR(mode)) { + /* is mkdir - create directory marker */ + std::string dirMetaPath = ZkFuseFile::buildChildPath + (path, _common.getDirMetadataName()); + LOG_DEBUG(LOG, "create %s", dirMetaPath.c_str()); + bool created; + int metaRes = mknod(dirMetaPath, S_IFREG, true, created); + if (metaRes >= 0) { + getFile(metaRes)->close(); + } + } + addChildToParent(path); + LOG_DEBUG(LOG, "open after create"); + res = open(path, true); + } else { + LOG_DEBUG(LOG, "create failed"); + int openRes = open(path, false); + if (openRes >= 0) { + if (mayExist == false) { + LOG_DEBUG(LOG, "create failed because already exist"); + getFile(openRes)->close(); + res = -EEXIST; + } else { + res = openRes; + } + } else { + LOG_DEBUG(LOG, "create failed but does not exist"); + res = -ENOENT; + } + } + } + } catch (const ZooKeeperException & e) { + LOG_ERROR(LOG, "mknod %s exception %s", path.c_str(), e.what()); + res = -EIO; + } + + LOG_DEBUG(LOG, "mknod returns %d created %d", res, created); + return res; +} + +int ZkFuseHandleManager::mkdir(const char * path, mode_t mode) +{ + LOG_DEBUG(LOG, "mkdir(path %s, mode %o)", path, mode); + + int res = 0; + try { + ZkFuseNameType nameType; + std::string zkPath = getZkPath(path, nameType); + mode = (mode & ~S_IFMT) | S_IFDIR; + ZkFuseAutoHandle autoHandle + (SharedPtr(_thisWeakPtr), zkPath, mode, false); + res = autoHandle.get(); + if (res >= 0) { + res = 0; + } + } catch (const std::exception & e) { + LOG_ERROR(LOG, "mkdir %s exception %s", path, e.what()); + res = -EIO; + } + + LOG_DEBUG(LOG, "mkdir returns %d", res); + return res; +} + +int ZkFuseHandleManager::open(const std::string & path, bool justCreated) +{ + LOG_DEBUG(LOG, "open(path %s, justCreated %d)", + path.c_str(), justCreated); + + int res = 0; + try { + bool newFile; + Handle handle = allocate(path, newFile); + ZkFuseAutoHandle autoHandle(SharedPtr(_thisWeakPtr), handle); + res = getFile(handle)->update(newFile || justCreated); + if (res == 0) { + res = handle; + autoHandle.release(); + } + } catch (const ZooKeeperException & e) { + LOG_ERROR(LOG, "open %s exception %s", path.c_str(), e.what()); + res = -EIO; + } + + LOG_DEBUG(LOG, "open returns %d", res); + return res; +} + +int ZkFuseHandleManager::rmdir(const char * path, bool force) +{ + LOG_DEBUG(LOG, "rmdir(path %s, force %d)", path, force); + + int res = 0; + + try { + ZkFuseNameType nameType; + std::string zkPath = getZkPath(path, nameType); + ZkFuseAutoHandle autoHandle(SharedPtr(_thisWeakPtr), zkPath); + res = autoHandle.get(); + if (res >= 0) { + res = autoHandle.getFile()->rmdir(nameType, force); + } + } catch (const std::exception & e) { + LOG_ERROR(LOG, "rmdir %s exception %s", path, e.what()); + res = -EIO; + } + + LOG_DEBUG(LOG, "rmdir returns %d", res); + return res; +} + + +int +ZkFuseHandleManager::unlink(const char * path) +{ + LOG_DEBUG(LOG, "unlink(path %s)", path); + + ZkFuseNameType nameType; + std::string zkPath = getZkPath(path, nameType); + ZkFuseAutoHandle autoHandle(SharedPtr(_thisWeakPtr), zkPath); + int res = autoHandle.get(); + if (res >= 0) { + res = autoHandle.getFile()->unlink(nameType); + } + + LOG_DEBUG(LOG, "unlink returns %d", res); + return res; +} + +int ZkFuseHandleManager::getattr(const char *path, struct stat &stbuf) +{ + LOG_DEBUG(LOG, "getattr(path %s)", path); + + int res = 0; + try { + ZkFuseNameType nameType; + std::string zkPath = getZkPath(path, nameType); + ZkFuseAutoHandle autoHandle(SharedPtr(_thisWeakPtr), zkPath); + res = autoHandle.get(); + if (res >= 0) { + res = autoHandle.getFile()->getattr(stbuf, nameType); + } + } catch (const std::exception & e) { + LOG_ERROR(LOG, "getattr %s exception %s", path, e.what()); + res = -EIO; + } + + LOG_DEBUG(LOG, "getattr returns %d", res); + return res; +} + +int +ZkFuseHandleManager::rename(const char * fromPath, const char * toPath) +{ + LOG_DEBUG(LOG, "rename(fromPath %s, toPath %s)", fromPath, toPath); + + ZkFuseNameType fromNameType; + std::string fromZkPath = getZkPath(fromPath, fromNameType); + ZkFuseAutoHandle fromAutoHandle(SharedPtr(_thisWeakPtr), fromZkPath); + int res = fromAutoHandle.get(); + if (res >= 0) { + LOG_DEBUG(LOG, "good fromPath"); + if (fromAutoHandle.getFile()->isDirNameType(fromNameType)) { + LOG_DEBUG(LOG, "fromPath is directory"); + res = -EISDIR; + } + } + if (res >= 0) { + ZkFuseNameType toNameType; + std::string toZkPath = getZkPath(toPath, toNameType); + bool created; + res = mknod(toZkPath.c_str(), S_IFREG, true, created); + if (res >= 0) { + ZkFuseAutoHandle toAutoHandle(SharedPtr(_thisWeakPtr), res); + if (toAutoHandle.getFile()->isDirNameType(toNameType)) { + LOG_DEBUG(LOG, "toPath is directory"); + res = -EISDIR; + } + if (res >= 0) { + LOG_DEBUG(LOG, "copy data"); + Data data; + fromAutoHandle.getFile()->getData(data); + toAutoHandle.getFile()->setData(data, true); + LOG_DEBUG(LOG, "copy metadata"); + struct stat stbuf; + int metaRes = + fromAutoHandle.getFile()->getattr(stbuf, fromNameType); + if (metaRes < 0) { + LOG_DEBUG(LOG, "get metadata failed"); + } + else { + metaRes = toAutoHandle.getFile()-> + utime(secsToMillisecs(stbuf.st_atime), + secsToMillisecs(stbuf.st_mtime), + toNameType); + if (metaRes < 0) { + LOG_DEBUG(LOG, "set metadata failed"); + } + } + } + if (created && res < 0) { + LOG_DEBUG(LOG, "undo create because copy data failed"); + int rmRes = toAutoHandle.getFile()->rmdir(toNameType, true); + } + } + } + if (res >= 0) { + LOG_DEBUG(LOG, "copy successful, unlink fromPath"); + res = fromAutoHandle.getFile()->unlink(fromNameType); + } + + LOG_DEBUG(LOG, "rename returns %d", res); + return res; +} + +void +ZkFuseHandleManager::addChildToParent(const std::string & childPath) const +{ + LOG_DEBUG(LOG, "addChildToParent(childPath %s)", childPath.c_str()); + + std::string parentPath = getParentPath(childPath); + if (!parentPath.empty()) { + AutoLock lock(_mutex); + Map::const_iterator it = _map.find(parentPath); + if (it != _map.end()) { + Handle handle = it->second; + assert(_files[handle] != NULL); + _files[handle]->addChild(childPath); + } + } + + LOG_DEBUG(LOG, "addChildToParent done"); +} + +void +ZkFuseHandleManager::removeChildFromParent(const std::string & childPath) const +{ + LOG_DEBUG(LOG, "removeChildFromParent(childPath %s)", childPath.c_str()); + + std::string parentPath = getParentPath(childPath); + if (!parentPath.empty()) { + AutoLock lock(_mutex); + Map::const_iterator it = _map.find(parentPath); + if (it != _map.end()) { + Handle handle = it->second; + assert(_files[handle] != NULL); + _files[handle]->removeChild(childPath); + } + } + + LOG_DEBUG(LOG, "removeChildFromParent done"); +} + +std::string +ZkFuseHandleManager::getParentPath(const std::string & childPath) const +{ + std::string::size_type lastPos = childPath.rfind('/'); + if (lastPos > 0) { + return std::string(childPath, 0, lastPos); + } + else { + assert(childPath[0] == '/'); + return std::string(); + } +} + +std::string +ZkFuseHandleManager::getZkPath(const char * path, ZkFuseNameType & nameType) + const +{ + LOG_DEBUG(LOG, "getZkPath(path %s)", path); + + std::string res; + unsigned pathLen = strlen(path); + const std::string & dataFileName = _common.getDataFileName(); + unsigned dataSuffixLen = dataFileName.length(); + const char * dataSuffix = dataFileName.c_str(); + unsigned dataSuffixIncludeSlashLen = dataSuffixLen + 1; + const std::string & forceDirSuffix = _common.getForceDirSuffix(); + unsigned forceDirSuffixLen = _common.getForceDirSuffix().length(); + /* Check if path is "/". If so, it is always a directory. + */ + if (pathLen == 1) { + assert(path[0] == '/'); + res = _common.getRootPathName(); + nameType = ZkFuseNameDirType; + } + /* Check if path ends of /{dataSuffix}, e.g. /foo/bar/{dataSuffix}. + * If so remove dataSuffix and nameType is ZkFuseNameRegType. + */ + else if ( + (pathLen >= dataSuffixIncludeSlashLen) && + (path[pathLen - dataSuffixIncludeSlashLen] == '/') && + (strncmp(path + (pathLen - dataSuffixLen), + dataSuffix, dataSuffixLen) == 0) + ) { + if ((pathLen - dataSuffixIncludeSlashLen) == 0) { + res = _common.getRootPathName(); + } else { + res.assign(path, pathLen - dataSuffixIncludeSlashLen); + } + nameType = ZkFuseNameRegType; + } + /* If not ZkFuseNameRegType, then check if path ends of + * {forceDirSuffix}, e.g. /foo/bar{forceDirSuffix}. + * If so remove forceDirSuffix and nameType is ZkFuseNameDirType. + */ + else if (forceDirSuffixLen > 0 && + pathLen >= forceDirSuffixLen && + strncmp(path + (pathLen - forceDirSuffixLen), + forceDirSuffix.c_str(), forceDirSuffixLen) == 0) { + res.assign(path, pathLen - forceDirSuffixLen); + nameType = ZkFuseNameDirType; + } + /* If not ZkFuseNameRegType and not ZkFuseNameDirType, then + * it is ZkFuseNameDefaultType. ZkFuse will infer type from + * ZooKeeper node's content. + */ + else { + res = path; + nameType = ZkFuseNameDefaultType; + } + /* Intermediate components of the path name may have + * forceDirSuffix, e.g. /foo/bar{forceDirSuffix}/baz. + * If so, remove the intermediate {forceDirSuffix}es. + */ + if (forceDirSuffixLen > 0) { + /* pos is an optimization to avoid always scanning from + * beginning of path + */ + unsigned pos = 0; + while ((res.length() - pos) > forceDirSuffixLen + 1) { + const char * found = + strstr(res.c_str() + pos, forceDirSuffix.c_str()); + if (found == NULL) { + break; + } + if (found[forceDirSuffixLen] == '/' || + found[forceDirSuffixLen] == '\0') { + pos = found - res.c_str(); + res.erase(pos, forceDirSuffixLen); + } + else { + pos += forceDirSuffixLen; + } + } + } + + LOG_DEBUG(LOG, "getZkPath returns %s, nameType %d", + res.c_str(), int(nameType)); + return res; +} + +static ZkFuseHandleManager::SharedPtr singletonZkFuseHandleManager; + +inline const ZkFuseHandleManager::SharedPtr & zkFuseHandleManager() +{ + return singletonZkFuseHandleManager; +} + +static +int zkfuse_getattr(const char *path, struct stat *stbuf) +{ + LOG_DEBUG(LOG, "zkfuse_getattr(path %s)", path); + + int res = 0; + try { + res = zkFuseHandleManager()->getattr(path, *stbuf); + } catch (const std::exception & e) { + LOG_ERROR(LOG, "zkfuse_getattr %s exception %s", path, e.what()); + res = -EIO; + } + + LOG_DEBUG(LOG, "zkfuse_getattr returns %d", res); + return res; +} + +static +int zkfuse_fgetattr(const char *path, struct stat *stbuf, + struct fuse_file_info *fi) +{ + LOG_DEBUG(LOG, "zkfuse_fgetattr(path %s)", path); + + int res = 0; + int handle = fi->fh; + try { + if (handle <= 0) { + res = -EINVAL; + } + else { + res = zkFuseHandleManager()->getFile(handle)-> + getattr(*stbuf, ZkFuseNameDefaultType); + } + } catch (const std::exception & e) { + LOG_ERROR(LOG, "zkfuse_fgetattr %s exception %s", path, e.what()); + res = -EIO; + } + + LOG_DEBUG(LOG, "zkfuse_fgetattr returns %d", res); + return res; +} + +static +int zkfuse_access(const char *path, int mask) +{ + /* not implemented */ + return -1; +} + +static +int zkfuse_readlink(const char *path, char *buf, size_t size) +{ + /* not implemented */ + return -1; +} + +static +int zkfuse_opendir(const char *path, struct fuse_file_info *fi) +{ + LOG_DEBUG(LOG, "zkfuse_opendir(path %s)", path); + + int res = 0; + try { + ZkFuseNameType nameType; + std::string zkPath = zkFuseHandleManager()->getZkPath(path, nameType); + if (nameType == ZkFuseNameRegType) { + res = -ENOENT; + } + else { + ZkFuseAutoHandle autoHandle(zkFuseHandleManager(), zkPath); + res = autoHandle.get(); + if (res >= 0) { + autoHandle.getFile()->incOpenDirCount(); + autoHandle.release(); + fi->fh = res; + res = 0; + } + } + } catch (const std::exception & e) { + LOG_ERROR(LOG, "zkfuse_opendir %s exception %s", path, e.what()); + res = -EIO; + } + + LOG_DEBUG(LOG, "zkfuse_opendir returns %d", res); + return res; +} + +static int +zkfuse_readdir(const char *path, void *buf, fuse_fill_dir_t filler, + off_t offset, struct fuse_file_info *fi) +{ + LOG_DEBUG(LOG, "zkfuse_readdir(path %s, offset %zu)", path, offset); + + int res = 0; + int handle = fi->fh; + try { + if (handle <= 0) { + res = -EINVAL; + } + else { + res = zkFuseHandleManager()->getFile(handle)-> + readdir(buf, filler, offset); + } + } catch (const std::exception & e) { + LOG_ERROR(LOG, "zkfuse_readdir %s exception %s", path, e.what()); + res = -EIO; + } + + LOG_DEBUG(LOG, "zkfuse_readdir returns %d", res); + return res; +} + +static +int zkfuse_releasedir(const char *path, struct fuse_file_info *fi) +{ + LOG_DEBUG(LOG, "zkfuse_releasedir(path %s)", path); + + int res = 0; + unsigned handle = fi->fh; + try { + if (handle <= 0) { + res = -EINVAL; + } + else { + zkFuseHandleManager()->getFile(handle)->decOpenDirCount(); + zkFuseHandleManager()->getFile(handle)->close(); + } + } catch (const std::exception & e) { + LOG_ERROR(LOG, "zkfuse_releasedir %s exception %s", path, e.what()); + res = -EIO; + } + + LOG_DEBUG(LOG, "zkfuse_releasedir returns %d", res); + return res; +} + +static +int zkfuse_mknod(const char *path, mode_t mode, dev_t rdev) +{ + LOG_DEBUG(LOG, "zkfuse_mknod(path %s, mode %o)", path, mode); + + int res = 0; + try { + ZkFuseNameType nameType; + std::string zkPath = zkFuseHandleManager()->getZkPath(path, nameType); + ZkFuseAutoHandle autoHandle(zkFuseHandleManager(), zkPath, mode, false); + res = autoHandle.get(); + if (res >= 0) { + res = 0; + } + } catch (const std::exception & e) { + LOG_ERROR(LOG, "zkfuse_mknod %s exception %s", path, e.what()); + res = -EIO; + } + + LOG_DEBUG(LOG, "zkfuse_mknod returns %d", res); + return res; +} + +static int zkfuse_mkdir(const char *path, mode_t mode) +{ + LOG_DEBUG(LOG, "zkfuse_mkdir(path %s, mode %o", path, mode); + + int res = 0; + try { + res = zkFuseHandleManager()->mkdir(path, mode); + } catch (const std::exception & e) { + LOG_ERROR(LOG, "zkfuse_mkdir %s exception %s", path, e.what()); + res = -EIO; + } + + LOG_DEBUG(LOG, "zkfuse_mkdir returns %d", res); + return res; +} + +static int zkfuse_unlink(const char *path) +{ + LOG_DEBUG(LOG, "zkfuse_unlink(path %s)", path); + + int res = 0; + try { + res = zkFuseHandleManager()->unlink(path); + } catch (const std::exception & e) { + LOG_ERROR(LOG, "zkfuse_unlink %s exception %s", path, e.what()); + res = -EIO; + } + + LOG_DEBUG(LOG, "zkfuse_unlink returns %d", res); + return res; +} + +static int zkfuse_rmdir(const char *path) +{ + LOG_DEBUG(LOG, "zkfuse_rmdir(path %s)", path); + + int res = 0; + try { + res = zkFuseHandleManager()->rmdir(path); + } catch (const std::exception & e) { + LOG_ERROR(LOG, "zkfuse_rmdir %s exception %s", path, e.what()); + res = -EIO; + } + + LOG_DEBUG(LOG, "zkfuse_rmdir returns %d", res); + + return res; +} + +static int zkfuse_symlink(const char *from, const char *to) +{ + /* not implemented */ + return -1; +} + +static int zkfuse_rename(const char *from, const char *to) +{ + LOG_DEBUG(LOG, "zkfuse_rename(from %s, to %s)", from, to); + + int res = 0; + try { + res = zkFuseHandleManager()->rename(from, to); + } catch (const std::exception & e) { + LOG_ERROR(LOG, "zkfuse_rename %s %s exception %s", from, to, e.what()); + res = -EIO; + } + + LOG_DEBUG(LOG, "zkfuse_rename returns %d", res); + + return res; +} + +static int zkfuse_link(const char *from, const char *to) +{ + /* not implemented */ + return -1; +} + +static int zkfuse_chmod(const char *path, mode_t mode) +{ + LOG_DEBUG(LOG, "zkfuse_chmod(path %s, mode %o)", path, mode); + int res = 0; + + LOG_DEBUG(LOG, "zkfuse_chmod returns %d", res); + return res; +} + +static int zkfuse_chown(const char *path, uid_t uid, gid_t gid) +{ + LOG_DEBUG(LOG, "zkfuse_chown(path %s, uid %d, gid %d)", path, uid, gid); + + int res = 0; + + if (zkFuseHandleManager()->getCommon().getUid() == uid && + zkFuseHandleManager()->getCommon().getGid() == gid) { + res = 0; + } + else { + res = -EPERM; + } + + LOG_DEBUG(LOG, "zkfuse_chown returns %d", res); + return 0; +} + +static int zkfuse_truncate(const char *path, off_t size) +{ + LOG_DEBUG(LOG, "zkfuse_truncate(path %s, size %zu)", path, size); + + int res = 0; + try { + ZkFuseNameType nameType; + std::string zkPath = zkFuseHandleManager()->getZkPath(path, nameType); + ZkFuseAutoHandle autoHandle(zkFuseHandleManager(), zkPath); + res = autoHandle.get(); + if (res >= 0) { + res = autoHandle.getFile()->truncate(size); + } + } catch (const std::exception & e) { + LOG_ERROR(LOG, "zkfuse_truncate %s exception %s", path, e.what()); + res = -EIO; + } + + LOG_DEBUG(LOG, "zkfuse_truncate returns %d", res); + return res; +} + +static +int zkfuse_ftruncate(const char *path, off_t size, struct fuse_file_info *fi) +{ + LOG_DEBUG(LOG, "zkfuse_ftruncate(path %s, size %zu)", path, size); + + int res = 0; + unsigned handle = fi->fh; + try { + if (handle <= 0) { + res = -EINVAL; + } + else { + res = zkFuseHandleManager()->getFile(handle)->truncate(size); + } + } catch (const std::exception & e) { + LOG_ERROR(LOG, "zkfuse_ftruncate %s exception %s", path, e.what()); + res = -EIO; + } + + LOG_DEBUG(LOG, "zkfuse_ftruncate returns %d", res); + return res; +} + +static +int zkfuse_utimens(const char *path, const struct timespec ts[2]) +{ + LOG_DEBUG(LOG, "zkfuse_utimens(path %s)", path); + + int res = 0; + try { + uint64_t atime = timespecToMillisecs(ts[0]); + uint64_t mtime = timespecToMillisecs(ts[1]); + ZkFuseNameType nameType; + std::string zkPath = zkFuseHandleManager()->getZkPath(path, nameType); + ZkFuseAutoHandle autoHandle(zkFuseHandleManager(), zkPath); + res = autoHandle.get(); + if (res >= 0) { + res = autoHandle.getFile()->utime(atime, mtime, nameType); + } + } catch (const std::exception & e) { + LOG_ERROR(LOG, "zkfuse_utimens %s exception %s", path, e.what()); + res = -EIO; + } + + LOG_DEBUG(LOG, "zkfuse_utimens returns %d", res); + return res; +} + +static +int zkfuse_create(const char *path, mode_t mode, struct fuse_file_info *fi) +{ + int fd; + + fd = open(path, fi->flags, mode); + if (fd == -1) + return -errno; + + fi->fh = fd; + return 0; +} + +static +int zkfuse_open(const char *path, struct fuse_file_info *fi) +{ + LOG_DEBUG(LOG, "zkfuse_open(path %s, flags %o)", path, fi->flags); + + int res = 0; + try { + ZkFuseNameType nameType; + std::string zkPath = zkFuseHandleManager()->getZkPath(path, nameType); + ZkFuseAutoHandle autoHandle(zkFuseHandleManager(), zkPath); + res = autoHandle.get(); + if (res >= 0) { + if (autoHandle.getFile()->isDirNameType(nameType)) { + res = -ENOENT; + } + } + if (res >= 0) { + autoHandle.release(); + fi->fh = res; + res = 0; + } + } catch (const std::exception & e) { + LOG_ERROR(LOG, "zkfuse_open %s exception %s", path, e.what()); + res = -EIO; + } + + LOG_DEBUG(LOG, "zkfuse_open returns %d", res); + return res; +} + +static +int zkfuse_read(const char *path, char *buf, size_t size, off_t offset, + struct fuse_file_info *fi) +{ + LOG_DEBUG(LOG, "zkfuse_read(path %s, size %zu, offset %zu)", + path, size, offset); + + int res = 0; + unsigned handle = fi->fh; + try { + if (handle <= 0) { + res = -EINVAL; + } + else { + res = zkFuseHandleManager()->getFile(handle)-> + read(buf, size, offset); + } + } catch (const std::exception & e) { + LOG_ERROR(LOG, "zkfuse_read %s exception %s", path, e.what()); + res = -EIO; + } + + LOG_DEBUG(LOG, "zkfuse_read returns %d", res); + return res; +} + +static +int zkfuse_write(const char *path, const char *buf, size_t size, + off_t offset, struct fuse_file_info *fi) +{ + LOG_DEBUG(LOG, "zkfuse_write(path %s, size %zu, offset %zu)", + path, size, offset); + + int res = 0; + unsigned handle = fi->fh; + try { + if (handle <= 0) { + res = -EINVAL; + } + else { + res = zkFuseHandleManager()->getFile(handle)-> + write(buf, size, offset); + } + } catch (const std::exception & e) { + LOG_ERROR(LOG, "zkfuse_write %s exception %s", path, e.what()); + res = -EIO; + } + + LOG_DEBUG(LOG, "zkfuse_write returns %d", res); + return res; +} + +static int zkfuse_statfs(const char *path, struct statvfs *stbuf) +{ + /* not implemented */ + return -1; +} + +static +int zkfuse_flush(const char *path, struct fuse_file_info *fi) +{ + /* This is called from every close on an open file, so call the + close on the underlying filesystem. But since flush may be + called multiple times for an open file, this must not really + close the file. This is important if used on a network + filesystem like NFS which flush the data/metadata on close() */ + + LOG_DEBUG(LOG, "zkfuse_flush(path %s)", path); + + int res = 0; + unsigned handle = fi->fh; + try { + if (handle <= 0) { + res = -EINVAL; + } + else { + res = zkFuseHandleManager()->getFile(handle)->flush(); + } + } catch (const std::exception & e) { + LOG_ERROR(LOG, "zkfuse_flush %s exception %s", path, e.what()); + res = -EIO; + } + + LOG_DEBUG(LOG, "zkfuse_flush returns %d", res); + return res; +} + +static +int zkfuse_release(const char *path, struct fuse_file_info *fi) +{ + LOG_DEBUG(LOG, "zkfuse_release(path %s)", path); + + int res = 0; + unsigned handle = fi->fh; + try { + if (handle <= 0) { + res = -EINVAL; + } + else { + zkFuseHandleManager()->getFile(handle)->close(); + } + } catch (const std::exception & e) { + LOG_ERROR(LOG, "zkfuse_release %s exception %s", path, e.what()); + res = -EIO; + } + + LOG_DEBUG(LOG, "zkfuse_release returns %d", res); + return res; +} + +static +int zkfuse_fsync(const char *path, int isdatasync, + struct fuse_file_info *fi) +{ + LOG_DEBUG(LOG, "zkfuse_fsync(path %s, isdatasync %d)", path, isdatasync); + + (void) isdatasync; + int res = zkfuse_flush(path, fi); + + LOG_DEBUG(LOG, "zkfuse_fsync returns %d", res); + return res; +} + +#ifdef HAVE_SETXATTR +/* xattr operations are optional and can safely be left unimplemented */ +static int zkfuse_setxattr(const char *path, const char *name, const char *value, + size_t size, int flags) +{ + int res = lsetxattr(path, name, value, size, flags); + if (res == -1) + return -errno; + return 0; +} + +static int zkfuse_getxattr(const char *path, const char *name, char *value, + size_t size) +{ + int res = lgetxattr(path, name, value, size); + if (res == -1) + return -errno; + return res; +} + +static int zkfuse_listxattr(const char *path, char *list, size_t size) +{ + int res = llistxattr(path, list, size); + if (res == -1) + return -errno; + return res; +} + +static int zkfuse_removexattr(const char *path, const char *name) +{ + int res = lremovexattr(path, name); + if (res == -1) + return -errno; + return 0; +} +#endif /* HAVE_SETXATTR */ + +static +int zkfuse_lock(const char *path, struct fuse_file_info *fi, int cmd, + struct flock *lock) +{ + (void) path; + return ulockmgr_op(fi->fh, cmd, lock, &fi->lock_owner, + sizeof(fi->lock_owner)); +} + + +static +void init_zkfuse_oper(fuse_operations & fo) +{ + memset(&fo, 0, sizeof(fuse_operations)); + fo.getattr = zkfuse_getattr; + fo.fgetattr = zkfuse_fgetattr; + // fo.access = zkfuse_access; + // fo.readlink = zkfuse_readlink; + fo.opendir = zkfuse_opendir; + fo.readdir = zkfuse_readdir; + fo.releasedir = zkfuse_releasedir; + fo.mknod = zkfuse_mknod; + fo.mkdir = zkfuse_mkdir; + // fo.symlink = zkfuse_symlink; + fo.unlink = zkfuse_unlink; + fo.rmdir = zkfuse_rmdir; + fo.rename = zkfuse_rename; + // fo.link = zkfuse_link; + fo.chmod = zkfuse_chmod; + fo.chown = zkfuse_chown; + fo.truncate = zkfuse_truncate; + fo.ftruncate = zkfuse_ftruncate; + fo.utimens = zkfuse_utimens; + // fo.create = zkfuse_create; + fo.open = zkfuse_open; + fo.read = zkfuse_read; + fo.write = zkfuse_write; + fo.statfs = zkfuse_statfs; + fo.flush = zkfuse_flush; + fo.release = zkfuse_release; + fo.fsync = zkfuse_fsync; +#ifdef HAVE_SETXATTR + // fo.setxattr = zkfuse_setxattr; + // fo.getxattr = zkfuse_getxattr; + // fo.listxattr = zkfuse_listxattr; + // fo.removexattr = zkfuse_removexattr; +#endif + fo.lock = zkfuse_lock; +}; + + +/** + * The listener of ZK events. + */ +class SessionEventListener : public ZKEventListener +{ + private: + /** + References the ZkFuseHandleManager instance that should be + invoked to service events. + */ + ZkFuseHandleManager::SharedPtr _manager; + + public: + /** + Sets the ZkFuseHandleManager instance that should be invoked + to service events. + */ + void setManager(const ZkFuseHandleManager::SharedPtr & manager) + { + _manager = manager; + } + /** + Received an event and invoke ZkFuseHandleManager instance to handle + received event. + */ + virtual void eventReceived(const ZKEventSource & source, + const ZKWatcherEvent & event) + { + _manager->eventReceived(event); + } +}; + +void +usage(int argc, char *argv[]) +{ + cout + << argv[0] + << " usage: " + << argv[0] + << " [args-and-values]+" << endl + << "nodepath == a complete path to a ZooKeeper node" << endl + << "\t--cachesize= or -c :" << endl + << " number of ZooKeeper nodes to cache." << endl + << "\t--debug or -d: " << endl + << "\t enable fuse debug mode." << endl + << "\t--help or -h: " << endl + << "\t print this message." << endl + << "\t--mount= or -m : " << endl + << "\t specifies where to mount the zkfuse filesystem." << endl + << "\t--name or -n: " << endl + << "\t name of file for accessing node data." << endl + << "\t--zookeeper= or -z : " << endl + << "\t specifies information needed to connect to zeekeeper." << endl; +} + +int +main(int argc, char *argv[]) +{ + /** + * Initialize log4cxx + */ + const std::string file("log4cxx.properties"); + PropertyConfigurator::configureAndWatch( file, 5000 ); + LOG_INFO(LOG, "Starting zkfuse"); + + /** + * Supported operations. + */ + enum ZkOption { + ZkOptionCacheSize = 1000, + ZkOptionDebug = 1001, + ZkOptionForceDirSuffix = 1002, + ZkOptionHelp = 1003, + ZkOptionMount = 1004, + ZkOptionName = 1005, + ZkOptionZookeeper = 1006, + ZkOptionInvalid = -1 + }; + + static const char *shortOptions = "c:df:hm:n:z:"; + static struct option longOptions[] = { + { "cachesize", 1, 0, ZkOptionCacheSize }, + { "debug", 0, 0, ZkOptionDebug }, + { "forcedirsuffix", 1, 0, ZkOptionForceDirSuffix }, + { "help", 0, 0, ZkOptionHelp }, + { "mount", 1, 0, ZkOptionMount }, + { "name", 1, 0, ZkOptionName }, + { "zookeeper", 1, 0, ZkOptionZookeeper }, + { 0, 0, 0, 0 } + }; + + /** + * Parse arguments + */ + bool debugFlag = false; + std::string mountPoint = "/tmp/zkfuse"; + std::string nameOfFile = "_data_"; + std::string forceDirSuffix = "._dir_"; + std::string zkHost; + unsigned cacheSize = 256; + + while (true) { + int c; + + c = getopt_long(argc, argv, shortOptions, longOptions, 0); + if (c == -1) { + break; + } + + switch (c) { + case ZkOptionInvalid: + cerr + << argv[0] + << ": ERROR: Did not specify legal argument!" + << endl; + return 99; + case 'c': + case ZkOptionCacheSize: + cacheSize = strtoul(optarg, NULL, 0); + break; + case 'd': + case ZkOptionDebug: + debugFlag = true; + break; + case 'f': + case ZkOptionForceDirSuffix: + forceDirSuffix = optarg; + break; + case 'h': + case ZkOptionHelp: + usage(argc, argv); + return 0; + case 'm': + case ZkOptionMount: + mountPoint = optarg; + break; + case 'n': + case ZkOptionName: + nameOfFile = optarg; + break; + case 'z': + case ZkOptionZookeeper: + zkHost = optarg; + break; + } + } + + /** + * Check that zkHost has a value, otherwise abort. + */ + if (zkHost.empty()) { + cerr + << argv[0] + << ": ERROR: " + << "required argument \"--zookeeper \" was not given!" + << endl; + return 99; + } + /** + * Check that zkHost has a value, otherwise abort. + */ + if (forceDirSuffix.empty()) { + cerr + << argv[0] + << ": ERROR: " + << "required argument \"--forcedirsuffix \" " + "not cannot be empty!" + << endl; + return 99; + } + /** + * Check nameOfFile has no forward slash + */ + if (nameOfFile.find_first_of('/') != std::string::npos) { + cerr + << argv[0] + << ": ERROR: " + << "'/' present in name which is not allowed" + << endl; + return 99; + } + + if (debugFlag) { + cout + << "cacheSize = " + << cacheSize + << ", debug = " + << debugFlag + << ", forceDirSuffix = \"" + << forceDirSuffix + << "\", mount = \"" + << mountPoint + << "\", name = \"" + << nameOfFile + << "\", zookeeper = \"" + << zkHost + << "\", optind = " + << optind + << ", argc = " + << argc + << ", current arg = \"" + << (optind >= argc ? "NULL" : argv[optind]) + << "\"" + << endl; + } + + SessionEventListener listener; + SynchronousEventAdapter eventAdapter; + LOG_INFO(LOG, "Create ZK adapter"); + try { + /** + * Create an instance of ZK adapter. + */ + std::string h(zkHost); + ZooKeeperConfig config(h, 1000, true, 10000); + ZkFuseCommon zkFuseCommon; + ZooKeeperAdapterSharedPtr zkPtr( + new ZooKeeperAdapter( + config, + &listener, + false + ) + ); + zkFuseCommon.setZkAdapter(zkPtr); + zkFuseCommon.setDataFileName(nameOfFile); + zkFuseCommon.setForceDirSuffix(forceDirSuffix); + zkFuseCommon.setCacheSize(cacheSize); + singletonZkFuseHandleManager = + ZkFuseHandleManagerFactory::create(zkFuseCommon); + listener.setManager(singletonZkFuseHandleManager); + zkPtr->reconnect(); + + } catch (const ZooKeeperException & e) { + cerr + << argv[0] + << ": ERROR: ZookKeeperException caught: " + << e.what() + << endl; + } catch (std::exception & e) { + cerr + << argv[0] + << ": ERROR: std::exception caught: " + << e.what() + << endl; + } + +#ifdef ZOOKEEPER_ROOT_CHILDREN_WATCH_BUG + cerr << "ZOOKEEPER_ROOT_CHILDREN_WATCH_BUG enabled" << endl; +#endif + /** + * Initialize fuse + */ + LOG_INFO(LOG, "Initialize fuse"); + umask(0); + fuse_operations zkfuse_oper; + init_zkfuse_oper(zkfuse_oper); + int fakeArgc = debugFlag ? 3 : 2; + char * fakeArgv[] = { + argv[0], + strdup(mountPoint.c_str()), + debugFlag ? strdup("-d") : NULL, + NULL + }; + int res = fuse_main(fakeArgc, fakeArgv, &zkfuse_oper, NULL); + for (unsigned i = 1; i <= 2; i++) { + if (fakeArgv[i] != NULL) { + free(fakeArgv[i]); + } + } + + return res; +} diff --git a/src/contrib/zkperl/Changes b/src/contrib/zkperl/Changes new file mode 100644 index 0000000..c31420e --- /dev/null +++ b/src/contrib/zkperl/Changes @@ -0,0 +1,65 @@ +Net::ZooKeeper - Perl extension for Apache ZooKeeper + +Revision history +================ + +0.01 Dec 5, 2008 + - initial version + +0.02 Dec 16, 2008 + - support connection to ZooKeeper and get() method + +0.03 Jan 9, 2009 + - implemented watch mechanism for get() + +0.04 Jan 15, 2009 + - all basic ZooKeeper methods supported + +0.05 Jan 21, 2009 + - converted from T_PTROBJ to T_ZK_HASH with PERL_MAGIC_ext, + allows DESTROY() to be called repeatedly + +0.06 Jan 27, 2009 + - converted from attribute accessor methods to inner and outer hashes + with PERL_MAGIC_tied + +0.07 Jan 29, 2009 + - all tied hash methods completed + +0.08 Jan 30, 2009 + - simple thread safety enforced with CLONE_SKIP + +0.09 Feb 12, 2009 + - ACL constants + +0.10 Feb 18, 2009 + - ACL support + +0.11 Feb 21, 2009 + - ZooKeeper version check + +0.20 Feb 25, 2009 + - refactored watches as subclass + +0.30 Feb 27, 2009 + - refactored stats as subclass + +0.31 Mar 6, 2009 + - test suite completed + +0.32 Mar 25, 2009 + - initial documentation completed, first public release + +0.33 Apr 20, 2009 + - copyright donated to ASF + +0.34 Jul 14, 2009 + - support ZooKeeper 3.2.0 release + +0.35 Jul 15, 2009 + - support multiple include and library locations + +0.36 Mar 27, 2011 + - Fix zookeeper version check, but only warn since we haven't been enforcing it in a while + - Look for zookeeper includes in some sane places by default + diff --git a/src/contrib/zkperl/LICENSE b/src/contrib/zkperl/LICENSE new file mode 100644 index 0000000..d645695 --- /dev/null +++ b/src/contrib/zkperl/LICENSE @@ -0,0 +1,202 @@ + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. diff --git a/src/contrib/zkperl/MANIFEST b/src/contrib/zkperl/MANIFEST new file mode 100644 index 0000000..1b57436 --- /dev/null +++ b/src/contrib/zkperl/MANIFEST @@ -0,0 +1,23 @@ +Changes +LICENSE +Makefile.PL +MANIFEST +NOTICE +README +typemap +ZooKeeper.pm +ZooKeeper.xs +build/check_zk_version.c +build/check_zk_version.h +t/10_invalid.t +t/15_thread.t +t/20_tie.t +t/22_stat_tie.t +t/24_watch_tie.t +t/30_connect.t +t/35_log.t +t/40_basic.t +t/45_class.t +t/50_access.t +t/60_watch.t +t/util.pl diff --git a/src/contrib/zkperl/Makefile.PL b/src/contrib/zkperl/Makefile.PL new file mode 100644 index 0000000..9a0996d --- /dev/null +++ b/src/contrib/zkperl/Makefile.PL @@ -0,0 +1,73 @@ +# Net::ZooKeeper - Perl extension for Apache ZooKeeper +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +use 5.008_008; + +use Config; +use ExtUtils::MakeMaker; +use Getopt::Long; + +my $ZOO_MAJOR_VERSION = 3; +my $ZOO_REQUIRED_VERSION = qr{^$ZOO_MAJOR_VERSION\.\d+.\d+$}ismx; + +my @zk_inc_paths; +my @zk_lib_paths; + +GetOptions( + 'zookeeper-include=s' => \@zk_inc_paths, + 'zookeeper-lib=s' => \@zk_lib_paths +); + +my $zk_inc_paths = join(' ', map("-I$_", @zk_inc_paths)); +my $zk_lib_paths = join(' ', map("-L$_", @zk_lib_paths)); + +$zk_inc_paths .= ' ' unless ($zk_inc_paths eq ''); +$zk_lib_paths .= ' ' unless ($zk_lib_paths eq ''); + +my $cc = $Config{'cc'}; +my $check_file = 'build/check_zk_version'; + +my $check_out = qx($cc $zk_inc_paths $zk_lib_paths -I. -o $check_file $check_file.c 2>&1); + +if ($?) { + if ($check_out =~ /zookeeper_version\.h/) { + die("Could not determine ZooKeeper version:\n\n$check_out"); + } + else { + ## keep in sync with build/check_zk_version.h + die("Net::ZooKeeper requires at least ZooKeeper version 3.1.1\n"); + } +} + +chomp(my $zk_ver = qx($check_file)); + +if ($? >> 8 != 0) { + die "Couldn't check zookeeper version: $zk_ver: $r"; +} +elsif ($zk_ver !~ $ZOO_REQUIRED_VERSION) { + warn "Net::ZooKeeper requires ZooKeeper 3.x, found $zk_ver!"; +} + +WriteMakefile( + 'INC' => "$zk_inc_paths-I.", + 'LIBS' => [ "$zk_lib_paths-lzookeeper_mt" ], + 'NAME' => 'Net::ZooKeeper', + 'VERSION_FROM' => 'ZooKeeper.pm', + 'clean' => { 'FILES' => 'build/check_zk_version.o' } +); + diff --git a/src/contrib/zkperl/NOTICE b/src/contrib/zkperl/NOTICE new file mode 100644 index 0000000..b68fdac --- /dev/null +++ b/src/contrib/zkperl/NOTICE @@ -0,0 +1,6 @@ +Net::ZooKeeper - Perl extension for Apache ZooKeeper +Copyright 2009 The Apache Software Foundation + +This product includes software developed at +The Apache Software Foundation (http://www.apache.org/). + diff --git a/src/contrib/zkperl/README b/src/contrib/zkperl/README new file mode 100644 index 0000000..bbe2a0d --- /dev/null +++ b/src/contrib/zkperl/README @@ -0,0 +1,86 @@ +Net::ZooKeeper - Perl extension for Apache ZooKeeper +==================================================== + +Net::ZooKeeper provides a Perl interface to the synchronous C API +of Apache ZooKeeper. ZooKeeper is coordination service for +distributed applications. +For details see the ZooKeeper home page at: + +http://zookeeper.apache.org/ + +INSTALLATION + +To install this module type the following, first install the +zookeeper C client, then: + + perl Makefile.PL + make + ZK_TEST_HOSTS=host:port,... make test + make install + +If the C headers and library are installed in non-standard +locations, specify them as arguments to Makefile.PL: + + perl Makefile.PL \ + --zookeeper-include=/path/to/zookeeper/client/include \ + --zookeeper-lib=/path/to/zookeeper/client/lib + +The path supplied to the --zookeeper-include option should +identify the directory that contains the zookeeper.h and other +ZooKeeper C include files. + +The path supplied to the --zookeeper-lib option should identify +the directory that contains the libzookeeper_mt library. + +When running "make test", if no ZK_TEST_HOSTS environment +variable is set, many tests will be skipped because no connection +to a ZooKeeper server is available. To execute these tests, +the ZK_TEST_HOSTS variable may be assigned a list of one or more +ZooKeeper host:port pairs, e.g., "localhost:7100,otherhost:7200". + +The ZK_TEST_PATH environment variable, if defined, specifies +the ZooKeeper path under which all test nodes should be created. +The tests expect to have full read/write/create/delete/admin +ZooKeeper permissions under this path. If no ZK_TEST_PATH +variable is defined, the root ZooKeeper path ("/") is used. + +DEPENDENCIES + +Version 3.1.1 of ZooKeeper is required at a minimum. + +For version 3.1.1, you may also want to apply some of these +additional patches to the ZooKeeper C API code: + +https://issues.apache.org/jira/browse/ZOOKEEPER-262 +https://issues.apache.org/jira/browse/ZOOKEEPER-318 + +For version 3.1.1, you may also want to apply some of these +additional patches to the ZooKeeper C API code: + +https://issues.apache.org/jira/browse/ZOOKEEPER-262 +https://issues.apache.org/jira/browse/ZOOKEEPER-466 + +This module requires that the multi-threaded version of the +ZooKeeper C API client library be available on your system. + +This in turn implies that the POSIX pthread library is available +as well. + +COPYRIGHT AND LICENCE + +Licensed to the Apache Software Foundation (ASF) under one +or more contributor license agreements. See the NOTICE file +distributed with this work for additional information +regarding copyright ownership. The ASF licenses this file +to you under the Apache License, Version 2.0 (the +"License"); you may not use this file except in compliance +with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. + diff --git a/src/contrib/zkperl/ZooKeeper.pm b/src/contrib/zkperl/ZooKeeper.pm new file mode 100644 index 0000000..507f029 --- /dev/null +++ b/src/contrib/zkperl/ZooKeeper.pm @@ -0,0 +1,1257 @@ +# Net::ZooKeeper - Perl extension for Apache ZooKeeper +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +use 5.008_008; + +use strict; +use warnings; + +package Net::ZooKeeper; + +require Exporter; +require XSLoader; + +our $VERSION = '0.36'; + +our @ISA = qw(Exporter); + +our %EXPORT_TAGS = ( + 'errors' => [qw( + ZOK + ZSYSTEMERROR + ZRUNTIMEINCONSISTENCY + ZDATAINCONSISTENCY + ZCONNECTIONLOSS + ZMARSHALLINGERROR + ZUNIMPLEMENTED + ZOPERATIONTIMEOUT + ZBADARGUMENTS + ZINVALIDSTATE + ZAPIERROR + ZNONODE + ZNOAUTH + ZBADVERSION + ZNOCHILDRENFOREPHEMERALS + ZNODEEXISTS + ZNOTEMPTY + ZSESSIONEXPIRED + ZINVALIDCALLBACK + ZINVALIDACL + ZAUTHFAILED + ZCLOSING + ZNOTHING + )], + 'node_flags' => [qw( + ZOO_EPHEMERAL + ZOO_SEQUENCE + )], + 'acl_perms' => [qw( + ZOO_PERM_READ + ZOO_PERM_WRITE + ZOO_PERM_CREATE + ZOO_PERM_DELETE + ZOO_PERM_ADMIN + ZOO_PERM_ALL + )], + 'acls' => [qw( + ZOO_OPEN_ACL_UNSAFE + ZOO_READ_ACL_UNSAFE + ZOO_CREATOR_ALL_ACL + )], + 'events' => [qw( + ZOO_CREATED_EVENT + ZOO_DELETED_EVENT + ZOO_CHANGED_EVENT + ZOO_CHILD_EVENT + ZOO_SESSION_EVENT + ZOO_NOTWATCHING_EVENT + )], + 'states' => [qw( + ZOO_EXPIRED_SESSION_STATE + ZOO_AUTH_FAILED_STATE + ZOO_CONNECTING_STATE + ZOO_ASSOCIATING_STATE + ZOO_CONNECTED_STATE + )], + 'log_levels' => [qw( + ZOO_LOG_LEVEL_OFF + ZOO_LOG_LEVEL_ERROR + ZOO_LOG_LEVEL_WARN + ZOO_LOG_LEVEL_INFO + ZOO_LOG_LEVEL_DEBUG + )] +); + +{ + my %tags; + + push @{$EXPORT_TAGS{'all'}}, + grep {!$tags{$_}++} @{$EXPORT_TAGS{$_}} foreach (keys(%EXPORT_TAGS)); +} + +our @EXPORT_OK = ( @{$EXPORT_TAGS{'all'}} ); + +XSLoader::load('Net::ZooKeeper', $VERSION); + +1; + +__END__ + +=head1 NAME + +Net::ZooKeeper - Perl extension for Apache ZooKeeper + +=head1 SYNOPSIS + + use Net::ZooKeeper qw(:node_flags :acls); + + my $zkh = Net::ZooKeeper->new('localhost:7000'); + + $zkh->create('/foo', 'bar', + 'flags' => ZOO_EPHEMERAL, + 'acl' => ZOO_OPEN_ACL_UNSAFE) or + die("unable to create node /foo: " . $zkh->get_error() . "\n"); + + print "node /foo has value: " . $zkh->get('/foo') . "\n"; + + $zkh->set('/foo', 'baz'); + + print "node / has child nodes:\n"; + foreach my $path ($zkh->get_children('/')) { + print " /$path\n"; + } + + my $stat = $zkh->stat(); + if ($zkh->exists('/foo', 'stat' => $stat)) { + print "node /foo has stat info:\n"; + while (my($key,$value) = each(%{$stat})) { + print " $key: $value\n"; + } + } + + foreach my $acl_entry ($zkh->get_acl('/foo')) { + print "node /foo has ACL entry:\n"; + print " perms: $acl_entry->{perms}\n"; + print " scheme: $acl_entry->{scheme}\n"; + print " id: $acl_entry->{id}\n"; + } + + my $watch = $zkh->watch('timeout' => 10000); + $zkh->exists('/foo', 'watch' => $watch); + + if ($watch->wait()) { + print "watch triggered on node /foo:\n"; + print " event: $watch->{event}\n"; + print " state: $watch->{state}\n"; + } + else { + print "watch timed out after 10 seconds\n"; + } + + $zkh->delete('/foo'); + +=head1 DESCRIPTION + +Net::ZooKeeper provides a Perl interface to the synchronous C API +of Apache ZooKeeper. ZooKeeper is coordination service for +distributed applications. + +Each connection to ZooKeeper is represented as a handle object +of the class Net::ZooKeeper, similar to the manner in which database +connections are represented in the DBI module. + +To disconnect from ZooKeeper, simply destroy the Net::ZooKeeper +handle object by undefining it or by explicitly calling the +C method. + +The methods which may be invoked on Net::ZooKeeper handles +correspond to the functions of the synchronous ZooKeeper C API; +e.g., the Net::ZooKeeper method C calls the ZooKeeper +C function C, C calls C, +and so forth. + +The synchronous API functions wait for a response from the ZooKeeper +cluster before returning a result to the caller. Using these +functions permits Net::ZooKeeper to provide an interface similar +to that of a DBI driver module. + +=head2 Internal POSIX Threads + +The use of the synchronous ZooKeeper C API still requires that +the ZooKeeper C client code create several POSIX threads which run +concurrently with the main thread containing the Perl interpreter. + +The synchronous API functions are wrappers of the asynchronous +functions in the ZooKeeper C API. When a request is made by the +caller's thread (i.e., the one with the running Perl interpreter), +it is enqueued for delivery at a later time by the ZooKeeper C client +code's IO thread. The caller's thread then waits for notification +before returning from the synchronous API function. + +The IO thread dequeues the request and sends it to the ZooKeeper +cluster, while also ensuring that a regular "heartbeat" is maintained +with the cluster so that the current session does not time out. +When the IO thread receives a response from +the ZooKeeper cluster, it enqueues the response for delivery to the +client by the second thread of the ZooKeeper client code, the +completion thread. + +If the caller is using the asynchronous API, the completion thread +invokes the appropriate callback function provided by the caller +for the given request. In the case of Net::ZooKeeper, it is not +viable for the completion thread to invoke a Perl callback function +at arbitrary times; this could interfere with the state of the +Perl interpreter. + +For this reason Net::ZooKeeper uses the synchronous API only. After +enqueuing requests the synchronous API functions wait for notification +of the corresponding response. The completion thread delivers these +notifications, at which point the synchronous functions return to +their caller. + +Note that the IO and completion threads are POSIX threads, not +Perl ithreads. Net::ZooKeeper defined a C function so +that if Perl ithreads are spawned while a Net::ZooKeeper connection +is active, the Net::ZooKeeper handle objects inherited by the +spawned ithread contain undefined values so that they can not be used. +Thus each ithread will need to create its own private connections to a +ZooKeeper cluster. + +Note also that before invoking C to spawn a new process, +all Net::ZooKeeper handles should be destroyed so that all +connections to ZooKeeper are closed and all internal POSIX threads +have exited. If a child process needs to communicate with +ZooKeeper it should open its own private connections after it is +created by C. + +=head2 Signals + +The ZooKeeper C API uses TCP connections to communicate with +the ZooKeeper cluster. These connections may generate SIGPIPE +signals when they encounter errors, such as when a connection +is terminated by a ZooKeeper server. Therefore most applications +will want to trap or ignore SIGPIPE signals, e.g.: + + local $SIG{'PIPE'} = 'IGNORE'; + +Ignoring SIGPIPE signals (or providing a signal handler that returns +control to the interrupted program after receiving the signal) +will allow the ZooKeeper C client code to detect the connection error +and report it upon return from the next Net::ZooKeeper method. + +=head2 Error Handling + +Net::ZooKeeper methods return different values in the case of an +error depending on their purpose and context. For example, +C returns true if the node exists and false otherwise, +which may indicate either that the node does not exist or that +an error occurred. + +After any method returns a false, empty, or undefined value which +might indicate an error has occurred, the C method +may be called to examine the specific error code, if any. + +If C returns C, no error has occurred. If the +error code is less than C, it indicates a normal error +condition reported by the ZooKeeper server, such as C +(node does not exist) or C (node already exists). + +If the error code is greater than C, then a connection +error or server error has occurred and the client should probably +close the connection by undefining the Net::ZooKeeper handle object +and, if necessary, attempt to create a new connection to the +ZooKeeper cluster. + +=head2 Access Control + +If the ZooKeeper cluster is not configured with C then +it will respect the access controls set for each node in the +ZooKeeper hierarchy. These access controls are defined using ACLs +(Access Control Lists); see the ZooKeeper documentation for compete +details. + +In Net::ZooKeeper, ACLs are represented as arrays of hashes, where +each hash is an ACL entry that must contain three attributes, +C, C, and C. The C attribute's value +should be composed by combining ACL permission flags using the +bitwise OR operator. See C<:acl_perms> for a list of the +available ACL permission flags. + +The ACL for a node may be read using the C method. A +node's ACL may be set when the node is created by passing an ACL +array as the value of the C<'acl'> option to the C method, +and may be updated by passing an ACL array to the C method. + +When a client connects to a ZooKeeper cluster it is automatically +assigned authentication credentials based on its IP address. +Additional authentication credentials may be added using +the C method. Once a credential has been added for +the current session, there is no way to disable it. + +As an example, digest authentication may be enabled for a session +by calling C as follows: + + $zkh->add_auth('digest', "$username:$password"); + +Note that the username and password are transmitted in cleartext +to the ZooKeeper cluster. + +Such authentication credentials would enable access to a node +whose ACL contained an entry with a C attribute of +C<'digest'> and an C attribute containing a Base64-encoded +SHA1 digest of the string C<"$username:$password">. The +Perl modules Digest and MIME::Base64 may be used to create +such ACL ID values as follows: + + use Digest qw(); + use MIME::Base64 qw(); + + my $ctx = Digest->new('SHA-1')->add("$username:$password"); + my $digest = MIME::Base64::encode($ctx->digest()); + +Note that using the C method of the Digest module +will not result in digest strings with the "=" suffix characters +required by ZooKeeper. + +=head2 Logging + +As of ZooKeeper version 3.1.1, logging in the C client code is +implemented with a single, shared file handle to which all +of the internal POSIX threads write log messages; by default, +this file handle is attached to STDERR. + +Moreover, this file handle is shared by all active ZooKeeper +connections (each of which has its own private IO and completion +threads; see L above). + +Net::ZooKeeper therefore does not provide per-connection handle +attributes related to logging. The global function +C may be used to set the current +log level. See C<:log_levels> for a list of the available log +levels. The default log level is C. + +To capture ZooKeeper log messages to a file instead of STDERR, +redirect STDERR to a new file handle in the normal Perl manner: + + open(OLDERR, '>&', fileno(STDERR)) or + die("unable to dup STDERR: $!"); + open(STDERR, '>', $log_file) or + die("unable to redirect STDERR: $!"); + +=head2 Connection Order + +ZooKeeper clusters are typically made up of an odd number of +ZooKeeper servers. When connecting to such a cluster, the +C method should be passed a comma-separated list of +the hostnames and ports for each of the servers in the cluster, +e.g., C<'host1:7000,host2:7000,host2:7100'>. + +The default behaviour of the ZooKeeper client code is to +reorder this list randomly before making any connections. +A connection is then made to the first server in the reordered +list. If that connection fails, the IO thread will +automatically attempt to reconnect to the cluster, this time +to the next server in the list; when the last server in the list +is reached, the IO thread will continue again with the first +server. + +For certain purposes it may be necessary for ZooKeeper clients +to know the exact order in which the IO thread will attempt to +connect to the servers of a cluster. To do so, call +C. Note, +however, that this will affect all Net::ZooKeeper object +handles created by the current process. + +=head1 ATTRIBUTES + +=head2 Net::ZooKeeper + +The Net::ZooKeeper class provides the main interface to the +ZooKeeper client API. The following attributes are available +for each Net::ZooKeeper handle object and are specific to +that handle and the method calls invoked on it. As with DBI +handle objects, attributes may be read and written through +a hash interface, e.g.: + + print sprintf("Session timeout is %.2f seconds.\n", + $zkh->{session_timeout} / 1000); + + $zkh->{watch_timeout} = 10000; + +=over 4 + +=item hosts + +The comma-separated list of ZooKeeper server hostnames and ports +as passed to the C method. Note that by default the +ZooKeeper C client code will reorder this list before attempting +to connect for the first time; see L for details. + +This attribute is B and may not be modified. + +=item session_timeout + +The session timeout value, in milliseconds, as set by the +ZooKeeper server after connection. This value may not be +exactly the same as what was requested in the C<'session_timeout'> +option of the C method; the server will adjust the +requested timeout value so that it is within a certain range +of the server's C setting. See the ZooKeeper +documentation for details. + +Because the actual connection to the ZooKeeper server is +not made during the C method call but shortly +thereafter by the IO thread, note that this value may not +be initialized to its final value until at least one +other method which requires communication with the server +(such as C) has succeeded. + +This attribute is B and may not be modified. + +=item session_id + +The client's session ID value as set by the ZooKeeper server +after connection. This is a binary data string which may +be passed to subsequent C calls as the value of +the C<'session_id'> option, if the user wishes to attempt to +continue a session after a failure. Note that the server +may not honour such an attempt. + +Because the actual connection to the ZooKeeper server is +not made during the C method call but shortly +thereafter by the IO thread, note that this value may not +be initialized to its final value until at least one +other method which requires communication with the server +(such as C) has succeeded. + +This attribute is B and may not be modified. + +=item data_read_len + +The maximum length of node data that will be returned to +the caller by the C method. If a node's data exceeds +this length, the returned value will be shorter than the +actual node data as stored in the ZooKeeper cluster. + +The default maximum length of the node data returned by +C is 1023 bytes. This may be changed by setting +the C attribute to a different value. + +Passing a value for the C<'data_read_len'> option when calling +the C method will temporarily override the per-handle +maximum. + +=item path_read_len + +The maximum length of a newly created node's path that will +be returned to the caller by the C method. If the path +of the newly created node exceeds this length, the returned +value will be shorter than the actual path of the node as stored +in the ZooKeeper cluster. + +The default maximum length of the node path returned by +C is 1023 bytes. This may be changed by setting +the C attribute to a different value. + +Passing a value for the C<'path_read_len'> option when calling +the C method will temporarily override the current +value of this attribute. + +=item watch_timeout + +The C attribute value, in milliseconds, inherited by +all watch objects (of class Net::ZooKeeper::Watch) created by +calls to the C method. When a watch object's +C method is invoked without a C<'timeout'> option, +it waits for an event notification from the ZooKeeper cluster +for no longer than the timeout period specified by the value of +the watch object's C attribute. + +The default C attribute value for all watch objects +created by the C method is 1 minute (60000 +milliseconds). This may be changed for a particular handle +object by setting this attribute to a different value; afterwards, +the new value will be inherited by any watch objects created +by the handle object's C method. Previously +created watch objects will not be affected. + +Passing a value for the C<'timeout'> option when calling +the C method will temporarily override the current +value of this attribute and cause the newly created watch object +to inherit a different value. + +See also the C method, and the C attribute +and C method of the Net::ZooKeeper::Watch class. + +=item pending_watches + +The number of internal ZooKeeper watches created for this handle +object that are still awaiting an event notification from the +ZooKeeper cluster. + +Note that this number may be different than the number of +extant watch objects created by the handle object's C +method, not only because some event notifications may have +occurred, but also if any watch objects have been reassigned +by reusing them in more than one call to any of the C, +C, or C methods. + +This attribute is B and may not be modified. + +=back + +=head2 Net::ZooKeeper::Stat + +The Net::ZooKeeper::Stat class provides a hash interface to +the individual pieces of information which together compose the +state of a given ZooKeeper node. Net::ZooKeeper::Stat objects +are created by calling the C method on a Net::ZooKeeper +handle object, and may then be passed to any methods which accept +a C<'stat'> option value, such as C. + +Net::ZooKeeper::Stat objects may be reused multiple times. +If the Net::ZooKeeper method to which the stat object is +passed succeeds, then the stat object is updated with the newly +retrieved node state information, and any state information +previously stored in the stat object is overwritten. + +All of the attributes of stat objects are B. + +=over 4 + +=item ctime + +The creation time of the node in milliseconds since the epoch. + +=item mtime + +The time of the last modification of the node's data in +milliseconds since the epoch. + +=item data_len + +The length of the node's data in bytes. + +=item num_children + +The number of child nodes beneath of the current node. + +=item ephemeral_owner + +If the node was created with the C flag, +this attribute holds the session ID of the ZooKeeper client +which created the node. If the node was not created with +the C flag, this attribute is set to zero. + +=item version + +The number of revisions of the node's data. The ZooKeeper +cluster will increment this version number whenever the +node's data is changed. When the node is first created this +version number is initialized to zero. + +=item acl_version + +The number of revisions of the node's ACL. The ZooKeeper +cluster will increment this version number whenever the +node's ACL is changed. When the node is first created this +version number is initialized to zero. + +=item children_version + +The number of revisions of the node's list of child nodes. +The ZooKeeper cluster will increment this version number +whenever the list of child nodes is changed. When the node +is first created this version number is initialized to zero. + +=item czxid + +The ZooKeeper transaction ID (ZXID) of the transaction which +created the node. + +=item mzxid + +The ZooKeeper transaction ID (ZXID) of the transaction which +last modified the node's data. This is initially set to +the same transaction ID as the C attribute by the +C method. + +=item children_zxid + +The ZooKeeper transaction ID (ZXID) of the transaction which +last modified the node's list of child nodes. This is +initially set to the same transaction ID as the C +attribute by the C method. + +=back + +=head2 Net::ZooKeeper::Watch + +The Net::ZooKeeper::Watch class provides a hash interface +to the data returned by event notifications from the ZooKeeper +cluster. Net::ZooKeeper::Watch objects are created by calling +the C method on a Net::ZooKeeper handle object, and +may then be passed to any methods which accept a C<'watch'> +option value, such as C. + +Net::ZooKeeper::Watch objects may be reused multiple times. +Regardless of whether the Net::ZooKeeper method to which the +watch object is passed succeeds, the watch object will be +updated to receive an event notification exclusively for the +node referenced in that method call. In the case of an error, +however, the watch object may never receive any event +notification. + +=over 4 + +=item timeout + +The default timeout value, in milliseconds, for all +invocations of the C method made on the watch object. +When the C method is invoked without a +C<'timeout'> option value, it waits for an +event notification from the ZooKeeper cluster for no longer +than the timeout period specified by this attribute. +This default timeout period may be altered by setting this +attribute to a different value. + +Passing a value for the C<'timeout'> option when calling +the C method will temporarily override the current +value of this attribute and cause the C method to +use a different timeout period. + +When a Net::ZooKeeper handle object's C method is +invoked without a C<'timeout'> option, it returns a newly +created watch object whose C attribute value +is initialized to the current value of the handle object's +C attribute. When the C method is invoked +with a C<'timeout'> option, the new watch object's C +attribute value is initialized to the value specified by +the C<'timeout'> option. + +See also the C method, and the C attribute +and C method of the Net::ZooKeeper class. + +=item event + +The type of event which triggered the notification, such +as C if the node's data was changed. +See C<:events> for a list of the possible event types. +If zero, no event notification has occurred yet. + +Note that the events which will trigger a notification +will depend on the Net::ZooKeeper method to which +the watch object was passed. Watches set through the +C and C methods will report events relating +to the node's data, while watches set through the +C method will report events relating to the +creation or deletion of child nodes of the watched node. + +This attribute is B and may not be modified. + +=item state + +The state of the Net::ZooKeeper connection at the time of +the event notification. See C<:states> for a list of +the possible connection states. If zero, no event +notification has occurred yet. + +This attribute is B and may not be modified. + +=back + +=head1 METHODS + +=head2 Net::ZooKeeper + +The following methods are defined for the Net::ZooKeeper class. + +=over 4 + +=item new() + + $zkh = Net::ZooKeeper->new('host1:7000,host2:7000'); + $zkh = Net::ZooKeeper->new('host1:7000,host2:7000', + 'session_timeout' => $session_timeout, + 'session_id' => $session_id); + +Creates a new Net::ZooKeeper handle object and attempts to +connect to the one of the servers of the given ZooKeeper +cluster. As described in the L and +L sections, the ZooKeeper client code will +create an IO thread which maintains the connection with a +regular "heartbeat" request. In the event of a connection error +the IO thread will also attempt to reconnect to another one of +the servers using the same session ID. In general, these actions +should be invisible to the user, although Net::ZooKeeper methods +may return transient errors while the IO thread +reconnects with another server. + +To disconnect, undefine the Net::ZooKeeper handle object +or call the C method. (After calling C +the handle object can not be reused.) + +The ZooKeeper client code will send a "heartbeat" message +if a third of the session timeout period has elapsed without +any communication with the ZooKeeper server. A specific +session timeout period may be requested when creating a +Net::ZooKeeper handle object by supplying a value, in +milliseconds, for the C<'session_timeout'> option. The +ZooKeeper server adjust the requested timeout value so that +it is within a certain range of the server's C setting; +the actual session timeout value will be available as the +value of the handle's C attribute after at +least one method call has succeeded. See the C +attribute for more information. + +If no C<'session_timeout'> option is provided, the default +value of 10 seconds (10000 milliseconds) will be used in the +initial connection request; again, the actual timeout period to +which the server agrees will be available subsequently as the +value of the C attribute. + +Upon successful connection (i.e., after the success of a method +which requires communication with the server), the C +attribute will hold a short binary string which represents the +client's session ID as set by the server. All ephemeral nodes +created by the session are identified by this ID in the +C attribute of any Net::ZooKeeper::Stat objects +used to query their state. + +The ZooKeeper client code will use this session ID internally +whenever it tries to reconnect to another server in the ZooKeeper +cluster after detecting a failed connection. If it successfully +reconnects with the same session ID, the session will continue +and ephemeral nodes belonging to it will not be deleted. + +However, if the server determines that the session has timed +out (for example because no "heartbeat" requests have been +received within the agreed-upon session timeout period), the +session will be terminated by the cluster and all ephemeral nodes +owned by the current session automatically deleted. + +On occasion the ZooKeeper client code may not be able to quickly +reconnect to a live server and the caller may want to destroy +the existing Net::ZooKeeper handle object and attempt a +fresh connection using the same session ID as before with a +new Net::ZooKeeper object. To do so, save the C +attribute value before undefining the old handle object +and then pass that binary string as the value of the +C<'session_id'> option to the C method when creating the +next handle object. After the successful completion of a +method which requires communication with the server, if the +new handle object's C attribute value matches the +old session ID then the session has been successfully maintained; +otherwise, the old session was expired by the cluster. + +=item get_error() + + $code = $zkh->get_error(); + +Returns the ZooKeeper error code, if any, from the most +recent Net::ZooKeeper method invocation. The returned value +will be zero (equivalent to C) if no error occurred, +otherwise non-zero. Non-zero values may be compared to +the error code names exported by the C<:errors> tagset. + +See L for more details. + +=item add_auth() + + $zkh->add_auth('digest', "$username:$password"); + +The C method may be used to add authentication +credentials to a session. Once a credential has been added for +the current session, there is no way to disable it. + +When using the digest authentication scheme, note that the +username and password are transmitted in cleartext +to the ZooKeeper cluster. + +See L for additional details. + +=item create() + + $path = $zkh->create($req_path, $data); + $path = $zkh->create($req_path, $data, + 'flags' => (ZOO_EPHEMERAL | ZOO_SEQUENCE), + 'acl' => ZOO_OPEN_ACL_UNSAFE, + 'path_read_len' => 100); + +Requests that a node be created in the ZooKeeper cluster's +hierarchy with the given path and data. Upon success, +the returns the node's path, otherwise undef. + +The path returned by a successful C method call +may not be the new node's full path as it appears in the +ZooKeeper hierarchy, depending on the length of the actual +path and the value of the handle object's C +attribute. If the length of the actual path exceeds the +current value of the C attribute, the path +returned by the C method will be truncated; note +that the node's path in the ZooKeeper hierarchy is not +affected by this truncation. + +Specifying a value for the C<'path_read_len'> option will +temporarily override the value of the C +attribute for the duration of the C method. + +The flag values available for use with the C<'flags'> option +are C and C; both are +included in the C<:flags> tagset. The flags should be +combined with the bitwise OR operator if more than one +is required. + +The C flag causes the node to be marked as +ephemeral, meaning it will be automatically deleted if it +still exists when the client's session ends. The +C flag causes a unique integer to be appended +to the node's final path component. See the ZooKeeper +documentation for additional advice on how to use these flags. + +When creating a node it may be important to define an ACL +for it; to do this, pass a reference to an ACL array (as +described in L) using the C<'acl'> option. +See also the C<:acl_perms> and C<:acls> tagsets for lists +of the available ACL permission flags and pre-defined ACLs. + +=item delete() + + $ret = $zkh->delete($path); + $ret = $zkh->delete($path, 'version' => $version); + +Requests that a node be deleted from the ZooKeeper hierarchy. +Returns true upon success, false otherwise. + +If a value for the C<'version'> option is supplied, the node +will only be deleted if its version number matches the given +value. See the C attribute of the Net::ZooKeeper::Stat +class for details on node version numbering. + +=item exists() + + $ret = $zkh->exists($path); + $ret = $zkh->exists($path, 'stat' => $stat, 'watch' => $watch); + +Tests whether a given node exists. Returns true if the node +exists, otherwise false. When the C method is successful +but the node does not exist, it returns false, and C +will return C until another method is called on the +handle object. + +The C<'stat'> option may be used to request that a +Net::ZooKeeper::Stat object be updated with the node's +current state information. The stat object will only be +updated if the node exists and the C method +succeeds. The stat object must first have been created +using the C method. + +The C<'watch'> option may be used to request that a +Net::ZooKeeper::Watch object be assigned to receive +notification of an event which alters the node's data. +The watch object must first have been created using the +C method. If the watch object was previously +assigned to receive notifications for another node, it +will be reassigned even if the C method fails. + +=item get_children() + + @child_names = $zkh->get_children($path); + $num_children = $zkh->get_children($path, 'watch' => $watch); + +Queries the names or number of the child nodes stored beneath +a given node in the ZooKeeper hierarchy. In a list context, +returns a list of the child nodes' names upon success, otherwise +an empty list. When the C method is successful +but there are no child nodes, it returns an empty list, and +C will return C until another method is called +on the handle object. + +In a scalar context, C returns the number +of child nodes upon success, otherwise undef. + +The names of the child nodes are simply the final component +of the nodes' paths, i.e., the portion of their path which +follows the path of the given parent node, excluding the +"/" delimiter. + +The C<'watch'> option may be used to request that a +Net::ZooKeeper::Watch object be assigned to receive +notification of an event which alters the node's list of +child nodes. The watch object must first have been created +using the C method. If the watch object was +previously assigned to receive notifications for another node, +it will be reassigned even if the C method fails. + +=item get() + + $data = $zkh->get($path); + $data = $zkh->get($path, 'data_read_len' => 100, + 'stat' => $stat, 'watch' => $watch); + +Queries the data stored in a given node. Returns the +data as a string upon success, otherwise undef. Note +that the data may contain nulls if the node's data is +not a text string. + +If the length of the node's data exceeds the current value +of the handle object's C attribute, the +string returned by the C method will be truncated; +note that the node's data in the ZooKeeper cluster is not +affected by this truncation. + +Specifying a value for the C<'data_read_len'> option will +temporarily override the value of the C +attribute for the duration of the C method. + +The C<'stat'> option may be used to request that a +Net::ZooKeeper::Stat object be updated with the node's +current state information. The stat object will only be +updated if the C method succeeds. The stat object +must first have been created using the C method. + +The C<'watch'> option may be used to request that a +Net::ZooKeeper::Watch object be assigned to receive +notification of an event which alters the node's data. +The watch object must first have been created using the +C method. If the watch object was previously +assigned to receive notifications for another node, it +will be reassigned even if the C method fails. + +=item set() + + $ret = $zkh->set($path, $data); + $ret = $zkh->set($path, $data, 'version' => $version, + 'stat' => $stat); + +Requests that a node's data be updated in the ZooKeeper +hierarchy. Returns true upon success, false otherwise. + +If a value for the C<'version'> option is supplied, the node's +data will only be updated if its version number matches the +given value. See the C attribute of the +Net::ZooKeeper::Stat class for details on node version numbering. + +The C<'stat'> option may be used to request that a +Net::ZooKeeper::Stat object be updated with the node's +current state information. The stat object will only be +updated if the C method succeeds. The stat object +must first have been created using the C method. + +=item get_acl() + + @acl = $zkh->get_acl($path); + $num_acl_entries = $zkh->get_acl($path, 'stat' => $stat); + +Queries the ACL associated with a node in the ZooKeeper +hierarchy, if any. In a list context, returns an array with +the node's ACL entries upon success, otherwise +an empty list. When the C method is successful +but there are no ACL entries, it returns an empty list, and +C will return C until another method is called +on the handle object. + +The elements of the returned array are hashes, each of which +represents one ACL entry. Each hash contains C, +C, and C elements. See the L +section for additional details, and the +C<:acl_perms> and C<:acls> tagsets for lists of the +available ACL permission flags and pre-defined ACLs. + +In a scalar context, C returns the number +of ACL entries upon success, otherwise undef. + +The C<'stat'> option may be used to request that a +Net::ZooKeeper::Stat object be updated with the node's +current state information. The stat object will only be +updated if the C method succeeds. The stat object +must first have been created using the C method. + +=item set_acl() + + $acl = [{ + 'perms' => (ZOO_PERM_READ | ZOO_PERM_WRITE), + 'scheme' => 'digest', + 'id' => "$username:$digest" + }]; + $ret = $zkh->set_acl($path, $acl); + $ret = $zkh->set_acl($path, ZOO_OPEN_ACL_UNSAFE, + 'version' => $version); + +Requests that a node's ACL be updated in the ZooKeeper +hierarchy. Returns true upon success, false otherwise. + +The ACL should be passed as a reference to an array of +hashes, where each hash represents one ACL entry. Each +hash should contain C, C, and C elements +as described in the L section. +See also the C<:acl_perms> and C<:acls> tagsets for lists +of the available ACL permission flags and pre-defined ACLs. + +If a value for the C<'version'> option is supplied, the node's +ACL will only be updated if its version number matches the +given value. See the C attribute of the +Net::ZooKeeper::Stat class for details on node version numbering. + +=item stat() + + $stat = $zkh->stat(); + +Creates a new Net::ZooKeeper::Stat object which may be used +with the C<'stat'> option of the C, C, +C, and C methods. When the stat object +is passed to any of these methods, upon success its attribute +values are updated to reflect the current state of the +node specified in the method call. The stat object is not +updated if the method call does not succeed. + +=item watch() + + $watch = $zkh->watch(); + $watch = $zkh->watch('timeout' => $timeout); + +Creates a new Net::ZooKeeper::Watch object which may be +used to wait for event notifications from the ZooKeeper +cluster. Each time the watch object is passed to any +of the C, C, or C methods, +its attribute values are immediately reset to zero, and will +later be updated upon receipt of an appropriate event +notification for the node specified in the method call. + +The specific types of events which cause notifications to be +sent by the ZooKeeper cluster depend on the method call used. +After use with the C and C methods, the +watch object will be set to receive an event notification +caused by a modification of the node's data or the node itself +(e.g., deletion of the node). After use with the +C method, the watch object will be set to +receive an event notification caused by a modification +of the node's list of child nodes. + +Watch objects receive at most one event notification after +their assignment to a node by one of the C, +C, or C methods. Note that in the +case of an error, the watch object may never receive any +event notification. However, when the parent Net::ZooKeeper +handle object experiences a connection error, the ZooKeeper +client code will notify all pending watches with an event of +type C. See C for more information +regarding the watch object's attribute values after a +connection error. + +A watch object may be reused with another C, +C, or C method call at any time, +in which case the watch object's attribute values +are reset to zero and the watch object will no longer be updated +by any event notification relevant to the previous method call. + +When the C method is invoked without a C<'timeout'> +option, it returns a newly created watch object whose C +attribute value is initialized to the current value of the +Net::ZooKeeper handle object's C attribute. +Otherwise, when the C method is invoked with a +C<'timeout'> option, the new watch object's C attribute +value is initialized to the value specified by the +C<'timeout'> option. + +See also the C attribute, and the C +attribute and C method of the Net::ZooKeeper::Watch +class. + +=back + +=head2 Net::ZooKeeper::Stat + +No methods are defined for the Net::ZooKeeper::Stat class. + +=head2 Net::ZooKeeper::Watch + +Only one method is defined for the Net::ZooKeeper::Watch class. + +=over 4 + +=item wait() + + $ret = $watch->wait(); + $ret = $watch->wait('timeout' => $timeout); + +Waits for an event notification from the ZooKeeper cluster +for the node most recently associated with the watch object. +Nodes are associated with a watch object by passing the +watch object as the value of a C<'watch'> option to a +Net::ZooKeeper method; methods which accept a C<'watch'> option +are C, C, and C. + +When the C method is invoked with a C<'timeout'> +option, it waits for no more than the number of milliseconds +specified by the C<'timeout'> option. +Otherwise, when the C method is invoked without a +C<'timeout'> option, it waits for no more than the timeout +period specified by the value of the watch object's C +attribute. + +The C method returns true if an event notification +was received, otherwise false. When C returns true, +the C and C attributes of the watch object +will be updated with the event's type and the current +connection state. + +When the parent Net::ZooKeeper handle object experiences a +connection error, the ZooKeeper client code will notify all +pending watches with an event of type C. +In this case, the C attribute will report the current +state of the connection to the ZooKeeper cluster. + +See also the C attribute, and the C method +and C attribute of the Net::ZooKeeper class. + +=back + +=head1 FUNCTIONS + +The following functions have global scope and affect all +Net::ZooKeeper handle objects. + +=over 4 + +=item set_log_level() + + Net::ZooKeeper::set_log_level($level); + +The C function may be called to +alter the number and type of messages written to the current log +file handle (if any). The default value is C +which disables all logging. + +See the L section for more details and C<:log_levels> +for a list of the available log levels. + +=item set_deterministic_conn_order() + + Net::ZooKeeper::set_deterministic_conn_order(1); + +The C function +may be called to indicate whether or not the list of ZooKeeper +servers passed to the C method should be randomly permuted. +If set to a true value, the list of servers will not be altered. +The default false value indicates the list of servers will +be randomly reordered prior to connection. + +See the L section for more details. + +=back + +=head1 EXPORTS + +Nothing is exported by default. Various tagsets exist which +group the tags available for export into different categories: + +=over 4 + +=item :errors + +ZooKeeper error codes. These may be compared to the values +returned by the C method. + +=item :node_flags + +The ZooKeeper node flags C and C, +which may be passed in the C<'flags'> option to the C +method. When more than node flag is required they +should be combined using the bitwise OR operator. + +=item :acl_perms + +The ZooKeeper ACL permission flags which may be used in +the value of the C attribute of an ACL entry hash. +When more than one ACL permission flag is required they +should be combined using the bitwise OR operator. + +The available ACL permission flags are C, +C, C, C, +and C. For convenience, C is +defined as the bitwise OR of all of these flags. + +=item :acls + +Common ZooKeeper ACLs which may be useful. C +specifies a node which is entirely open to all users with no +restrictions at all. C specifies +a node which is readable by all users; permissions for other actions +are not defined in this ACL. C specifies a node +for which all actions require the same authentication credentials as +held by the session which created the node; this implies that a +session should authenticate with an appropriate scheme before +creating a node with this ACL. + +=item :events + +The ZooKeeper event types which are returned in value of +the C attribute a Net::ZooKeeper::Watch object after +an event occurs on a watched node. + +=item :states + +The ZooKeeper connection states which are returned in value of +the C attribute of a Net::ZooKeeper::Watch object after +an event occurs on a watched node. + +=item :log_levels + +The ZooKeeper log levels which may be passed to the +C function. The available +log levels are, from least to most verbose, C +(the default), C, C, +C, and C. + +=item :all + +Everything from all of the above tagsets. + +=back + +=head1 SEE ALSO + +The Apache ZooKeeper project's home page at +L provides a wealth of detail +on how to develop applications using ZooKeeper. + +=head1 AUTHOR + +Chris Darroch, Echrisd@apache.orgE + +=head1 COPYRIGHT AND LICENSE + +Licensed to the Apache Software Foundation (ASF) under one +or more contributor license agreements. See the NOTICE file +distributed with this work for additional information +regarding copyright ownership. The ASF licenses this file +to you under the Apache License, Version 2.0 (the +"License"); you may not use this file except in compliance +with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. + +=cut + diff --git a/src/contrib/zkperl/ZooKeeper.xs b/src/contrib/zkperl/ZooKeeper.xs new file mode 100644 index 0000000..4b6067b --- /dev/null +++ b/src/contrib/zkperl/ZooKeeper.xs @@ -0,0 +1,2664 @@ +/* Net::ZooKeeper - Perl extension for Apache ZooKeeper + * + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#define PERL_NO_GET_CONTEXT + +#include "EXTERN.h" +#include "perl.h" +#include "XSUB.h" + +#include /* pthread_mutex_lock(), etc. */ +#include /* memset(), etc. */ +#include /* CHAR_BIT */ +#include /* gettimeofday() */ + +#include + +#include "build/check_zk_version.h" + + +#define PACKAGE_NAME "Net::ZooKeeper" +#define PACKAGE_SIGNATURE 19631123 + +#define STAT_PACKAGE_NAME "Net::ZooKeeper::Stat" +#define STAT_PACKAGE_SIGNATURE 19960512 + +#define WATCH_PACKAGE_NAME "Net::ZooKeeper::Watch" +#define WATCH_PACKAGE_SIGNATURE 20050326 + +#define MAX_KEY_NAME_LEN 16 /* "children_version" */ + +#define NUM_ACL_ENTRY_KEYS 3 +#define NUM_KEYS 7 +#define NUM_STAT_KEYS 11 +#define NUM_WATCH_KEYS 3 + +#define DEFAULT_RECV_TIMEOUT_MSEC 10000 + +#define DEFAULT_DATA_BUF_LEN 1023 +#define DEFAULT_PATH_BUF_LEN 1023 +#define DEFAULT_WATCH_TIMEOUT 60000 + +#define ZOO_LOG_LEVEL_OFF 0 + +#ifndef strcaseEQ +#define strcaseEQ(a,b) (!strcasecmp((a),(b))) +#endif + + +typedef struct Stat zk_stat_t; + +typedef HV* Net__ZooKeeper__Stat; + +typedef struct zk_watch_t zk_watch_t; + +struct zk_watch_t { + pthread_mutex_t mutex; + pthread_cond_t cond; + int done; + int ret; + int event_type; + int event_state; + unsigned int timeout; + zk_watch_t *prev; + zk_watch_t *next; + int ref_count; +}; + +typedef HV* Net__ZooKeeper__Watch; + +typedef struct { + zhandle_t *handle; + zk_watch_t *first_watch; + int data_buf_len; + int path_buf_len; + unsigned int watch_timeout; + const char *hosts; + int hosts_len; + int last_ret; + int last_errno; +} zk_t; + +typedef HV* Net__ZooKeeper; + +typedef struct { + I32 signature; + union { + zk_t *zk; + zk_stat_t *stat; + zk_watch_t *watch; + } handle; +} zk_handle_t; + +typedef struct { + const char name[MAX_KEY_NAME_LEN + 1]; + U32 name_len; + size_t offset; + size_t size; + U32 hash; +} zk_key_t; + + +static zk_key_t zk_acl_entry_keys[NUM_ACL_ENTRY_KEYS] = { + {"perms", 0, 0, 0, 0}, + {"scheme", 0, 0, 0, 0}, + {"id", 0, 0, 0, 0} +}; + +static zk_key_t zk_keys[NUM_KEYS] = { + {"data_read_len", 0, 0, 0, 0}, + {"path_read_len", 0, 0, 0, 0}, + {"watch_timeout", 0, 0, 0, 0}, + {"hosts", 0, 0, 0, 0}, + {"session_timeout", 0, 0, 0, 0}, + {"session_id", 0, 0, 0, 0}, + {"pending_watches", 0, 0, 0, 0} +}; + +static zk_key_t zk_stat_keys[NUM_STAT_KEYS] = { + {"czxid", 0, offsetof(struct Stat, czxid), + sizeof(((struct Stat*) 0)->czxid), 0}, + {"mzxid", 0, offsetof(struct Stat, mzxid), + sizeof(((struct Stat*) 0)->mzxid), 0}, + {"ctime", 0, offsetof(struct Stat, ctime), + sizeof(((struct Stat*) 0)->ctime), 0}, + {"mtime", 0, offsetof(struct Stat, mtime), + sizeof(((struct Stat*) 0)->mtime), 0}, + {"version", 0, offsetof(struct Stat, version), + sizeof(((struct Stat*) 0)->version), 0}, + {"children_version", 0, offsetof(struct Stat, cversion), + sizeof(((struct Stat*) 0)->cversion), 0}, + {"acl_version", 0, offsetof(struct Stat, aversion), + sizeof(((struct Stat*) 0)->aversion), 0}, + {"ephemeral_owner", 0, offsetof(struct Stat, ephemeralOwner), + sizeof(((struct Stat*) 0)->ephemeralOwner), 0}, + {"data_len", 0, offsetof(struct Stat, dataLength), + sizeof(((struct Stat*) 0)->dataLength), 0}, + {"num_children", 0, offsetof(struct Stat, numChildren), + sizeof(((struct Stat*) 0)->numChildren), 0}, + {"children_zxid", 0, offsetof(struct Stat, pzxid), + sizeof(((struct Stat*) 0)->pzxid), 0} +}; + +static zk_key_t zk_watch_keys[NUM_WATCH_KEYS] = { + {"timeout", 0, 0, 0, 0}, + {"event", 0, 0, 0, 0}, + {"state", 0, 0, 0, 0} +}; + + +static void _zk_watcher(zhandle_t *handle, int type, int state, + const char *path, void *context) +{ + zk_watch_t *watch_ctx = context; + + pthread_mutex_lock(&watch_ctx->mutex); + + watch_ctx->event_type = type; + watch_ctx->event_state = state; + + watch_ctx->done = 1; + + pthread_cond_signal(&watch_ctx->cond); + pthread_mutex_unlock(&watch_ctx->mutex); + + return; +} + +static void _zk_auth_completion(int ret, const void *data) +{ + zk_watch_t *watch_ctx = (zk_watch_t*) data; + + pthread_mutex_lock(&watch_ctx->mutex); + + watch_ctx->ret = ret; + + watch_ctx->done = 1; + + pthread_cond_signal(&watch_ctx->cond); + pthread_mutex_unlock(&watch_ctx->mutex); + + return; +} + +static zk_watch_t *_zk_create_watch(pTHX) +{ + zk_watch_t *watch; + + Newxz(watch, 1, zk_watch_t); + + if (pthread_mutex_init(&watch->mutex, NULL)) { + int save_errno = errno; + + Safefree(watch); + + errno = save_errno; + return NULL; + } + + if (pthread_cond_init(&watch->cond, NULL)) { + int save_errno = errno; + + pthread_mutex_destroy(&watch->mutex); + Safefree(watch); + + errno = save_errno; + return NULL; + } + + return watch; +} + +static void _zk_destroy_watch(pTHX_ zk_watch_t *watch) +{ + pthread_cond_destroy(&watch->cond); + pthread_mutex_destroy(&watch->mutex); + + Safefree(watch); + + return; +} + +static zk_watch_t *_zk_acquire_watch(pTHX) +{ + zk_watch_t *watch = _zk_create_watch(aTHX); + + if (watch) { + watch->ref_count = 1; + } + + return watch; +} + +static void _zk_release_watch(pTHX_ zk_watch_t *watch, int list) +{ + if (list) { + if (watch->prev) { + watch->prev->next = watch->next; + } + if (watch->next) { + watch->next->prev = watch->prev; + } + watch->prev = NULL; + watch->next = NULL; + } + + if (--watch->ref_count == 0) { + _zk_destroy_watch(aTHX_ watch); + } + + return; +} + +static unsigned int _zk_release_watches(pTHX_ zk_watch_t *first_watch, + int final) +{ + zk_watch_t *watch = first_watch->next; + unsigned int pending_watches = 0; + + while (watch) { + zk_watch_t *next_watch = watch->next; + int done = final; + + if (!final) { + pthread_mutex_lock(&watch->mutex); + done = watch->done; + pthread_mutex_unlock(&watch->mutex); + } + + if (done) { + _zk_release_watch(aTHX_ watch, 1); + } + else { + ++pending_watches; + } + + watch = next_watch; + } + + return pending_watches; +} + +static void _zk_replace_watch(pTHX_ zk_handle_t *handle, + zk_watch_t *first_watch, + zk_watch_t *old_watch, zk_watch_t *new_watch) +{ + zk_watch_t *next_watch; + + new_watch->timeout = old_watch->timeout; + + _zk_release_watch(aTHX_ old_watch, 0); + + /* cleanup any completed watches not tied to a handle */ + _zk_release_watches(aTHX_ first_watch, 0); + + next_watch = first_watch->next; + + new_watch->prev = first_watch; + new_watch->next = next_watch; + + if (next_watch) { + next_watch->prev = new_watch; + } + + first_watch->next = new_watch; + + ++new_watch->ref_count; + + handle->handle.watch = new_watch; + + return; +} + +static void _zk_free_acl(pTHX_ struct ACL_vector *acl) +{ + if (acl->data) { + Safefree(acl->data); + } + + return; +} + +static const char *_zk_fill_acl(pTHX_ AV *acl_arr, struct ACL_vector *acl) +{ + I32 num_acl_entries = av_len(acl_arr) + 1; + int i; + + Zero(acl, 1, struct ACL_vector); + + if (num_acl_entries <= 0) { + return NULL; + } + else if (num_acl_entries > PERL_INT_MAX) { + num_acl_entries = PERL_INT_MAX; + } + + Newx(acl->data, num_acl_entries, struct ACL); + + for (i = 0; i < num_acl_entries; ++i) { + SV **acl_entry_ptr; + HV *acl_entry_hash; + zk_key_t *key; + SV **val_ptr; + struct ACL acl_entry; + + acl_entry_ptr = av_fetch(acl_arr, i, 0); + + if (!acl_entry_ptr) { + continue; + } + + if (!SvROK(*acl_entry_ptr) || + SvTYPE(SvRV(*acl_entry_ptr)) != SVt_PVHV) { + _zk_free_acl(aTHX_ acl); + + return "invalid ACL entry hash reference"; + } + + acl_entry_hash = (HV*) SvRV(*acl_entry_ptr); + + key = &zk_acl_entry_keys[0]; + val_ptr = hv_fetch(acl_entry_hash, key->name, key->name_len, 0); + + if (!val_ptr) { + _zk_free_acl(aTHX_ acl); + + return "no ACL entry perms element"; + } + + acl_entry.perms = SvIV(*val_ptr); + + if (!acl_entry.perms || (acl_entry.perms & ~ZOO_PERM_ALL)) { + _zk_free_acl(aTHX_ acl); + + return "invalid ACL entry perms"; + } + + key = &zk_acl_entry_keys[1]; + val_ptr = hv_fetch(acl_entry_hash, key->name, key->name_len, 0); + + if (!val_ptr) { + _zk_free_acl(aTHX_ acl); + + return "no ACL entry scheme element"; + } + + acl_entry.id.scheme = SvPV_nolen(*val_ptr); + + key = &zk_acl_entry_keys[2]; + val_ptr = hv_fetch(acl_entry_hash, key->name, key->name_len, 0); + + if (!val_ptr) { + _zk_free_acl(aTHX_ acl); + + return "no ACL entry id element"; + } + + acl_entry.id.id = SvPV_nolen(*val_ptr); + + ++acl->count; + acl->data[i] = acl_entry; + } + + return NULL; +} + +static void _zk_fill_acl_entry_hash(pTHX_ struct ACL *acl_entry, + HV *acl_entry_hash) +{ + zk_key_t *key; + SV *val; + + key = &zk_acl_entry_keys[0]; + val = newSViv(acl_entry->perms); + + if (!hv_store(acl_entry_hash, key->name, key->name_len, val, key->hash)) { + SvREFCNT_dec(val); + } + + key = &zk_acl_entry_keys[1]; + val = newSVpv(acl_entry->id.scheme, 0); + + if (!hv_store(acl_entry_hash, key->name, key->name_len, val, key->hash)) { + SvREFCNT_dec(val); + } + + key = &zk_acl_entry_keys[2]; + val = newSVpv(acl_entry->id.id, 0); + + if (!hv_store(acl_entry_hash, key->name, key->name_len, val, key->hash)) { + SvREFCNT_dec(val); + } + + return; +} + +static zk_handle_t *_zk_check_handle_inner(pTHX_ HV *attr_hash, + I32 package_signature) +{ + zk_handle_t *handle = NULL; + + if (SvRMAGICAL(attr_hash)) { + MAGIC *magic = mg_find((SV*) attr_hash, PERL_MAGIC_ext); + + if (magic) { + handle = (zk_handle_t*) magic->mg_ptr; + + if (handle->signature != package_signature) { + handle = NULL; + } + } + } + + return handle; +} + +static zk_handle_t *_zk_check_handle_outer(pTHX_ HV *hash, HV **attr_hash_ptr, + const char *package_name, + I32 package_signature) +{ + zk_handle_t *handle = NULL; + + if (attr_hash_ptr) { + *attr_hash_ptr = NULL; + } + + if (SvRMAGICAL((SV*) hash)) { + MAGIC *magic = mg_find((SV*) hash, PERL_MAGIC_tied); + + if (magic) { + SV *attr = magic->mg_obj; + + if (SvROK(attr) && SvTYPE(SvRV(attr)) == SVt_PVHV && + sv_derived_from(attr, package_name)) { + HV *attr_hash = (HV*) SvRV(attr); + + handle = _zk_check_handle_inner(aTHX_ attr_hash, + package_signature); + + if (handle && attr_hash_ptr) { + *attr_hash_ptr = attr_hash; + } + } + } + } + + return handle; +} + +static zk_t *_zk_get_handle_inner(pTHX_ Net__ZooKeeper attr_hash) +{ + zk_handle_t *handle; + + handle = _zk_check_handle_inner(aTHX_ attr_hash, PACKAGE_SIGNATURE); + + return handle ? handle->handle.zk : NULL; +} + +static zk_t *_zk_get_handle_outer(pTHX_ Net__ZooKeeper zkh) +{ + zk_handle_t *handle; + + handle = _zk_check_handle_outer(aTHX_ zkh, NULL, PACKAGE_NAME, + PACKAGE_SIGNATURE); + + return handle ? handle->handle.zk : NULL; +} + +static zk_stat_t *_zks_get_handle_inner(pTHX_ Net__ZooKeeper__Stat attr_hash) +{ + zk_handle_t *handle; + + handle = _zk_check_handle_inner(aTHX_ attr_hash, STAT_PACKAGE_SIGNATURE); + + return handle ? handle->handle.stat : NULL; +} + +static zk_stat_t *_zks_get_handle_outer(pTHX_ Net__ZooKeeper__Stat zksh) +{ + zk_handle_t *handle; + + handle = _zk_check_handle_outer(aTHX_ zksh, NULL, STAT_PACKAGE_NAME, + STAT_PACKAGE_SIGNATURE); + + return handle ? handle->handle.stat : NULL; +} + +static zk_watch_t *_zkw_get_handle_inner(pTHX_ Net__ZooKeeper__Watch attr_hash) +{ + zk_handle_t *handle; + + handle = _zk_check_handle_inner(aTHX_ attr_hash, WATCH_PACKAGE_SIGNATURE); + + return handle ? handle->handle.watch : NULL; +} + +static zk_watch_t *_zkw_get_handle_outer(pTHX_ Net__ZooKeeper__Watch zkwh, + zk_handle_t **handle_ptr) +{ + zk_handle_t *handle; + + handle = _zk_check_handle_outer(aTHX_ zkwh, NULL, WATCH_PACKAGE_NAME, + WATCH_PACKAGE_SIGNATURE); + + if (handle_ptr) { + *handle_ptr = handle; + } + + return handle ? handle->handle.watch : NULL; +} + + +MODULE = Net::ZooKeeper PACKAGE = Net::ZooKeeper PREFIX = zk_ + +REQUIRE: 1.9508 + +PROTOTYPES: ENABLE + +BOOT: +{ + int i; + + for (i = 0; i < NUM_ACL_ENTRY_KEYS; ++i) { + zk_key_t *key = &zk_acl_entry_keys[i]; + + key->name_len = strlen(key->name); + PERL_HASH(key->hash, key->name, key->name_len); + } + + for (i = 0; i < NUM_KEYS; ++i) { + zk_keys[i].name_len = strlen(zk_keys[i].name); + } + + for (i = 0; i < NUM_STAT_KEYS; ++i) { + zk_stat_keys[i].name_len = strlen(zk_stat_keys[i].name); + } + + for (i = 0; i < NUM_WATCH_KEYS; ++i) { + zk_watch_keys[i].name_len = strlen(zk_watch_keys[i].name); + } + + zoo_set_log_stream(NULL); + zoo_set_debug_level(0); +} + + +I32 +zk_constant(alias=Nullch) + char *alias + ALIAS: + ZOK = ZOK + ZSYSTEMERROR = ZSYSTEMERROR + ZRUNTIMEINCONSISTENCY = ZRUNTIMEINCONSISTENCY + ZDATAINCONSISTENCY = ZDATAINCONSISTENCY + ZCONNECTIONLOSS = ZCONNECTIONLOSS + ZMARSHALLINGERROR = ZMARSHALLINGERROR + ZUNIMPLEMENTED = ZUNIMPLEMENTED + ZOPERATIONTIMEOUT = ZOPERATIONTIMEOUT + ZBADARGUMENTS = ZBADARGUMENTS + ZINVALIDSTATE = ZINVALIDSTATE + ZAPIERROR = ZAPIERROR + ZNONODE = ZNONODE + ZNOAUTH = ZNOAUTH + ZBADVERSION = ZBADVERSION + ZNOCHILDRENFOREPHEMERALS = ZNOCHILDRENFOREPHEMERALS + ZNODEEXISTS = ZNODEEXISTS + ZNOTEMPTY = ZNOTEMPTY + ZSESSIONEXPIRED = ZSESSIONEXPIRED + ZINVALIDCALLBACK = ZINVALIDCALLBACK + ZINVALIDACL = ZINVALIDACL + ZAUTHFAILED = ZAUTHFAILED + ZCLOSING = ZCLOSING + ZNOTHING = ZNOTHING + + ZOO_EPHEMERAL = ZOO_EPHEMERAL + ZOO_SEQUENCE = ZOO_SEQUENCE + + ZOO_PERM_READ = ZOO_PERM_READ + ZOO_PERM_WRITE = ZOO_PERM_WRITE + ZOO_PERM_CREATE = ZOO_PERM_CREATE + ZOO_PERM_DELETE = ZOO_PERM_DELETE + ZOO_PERM_ADMIN = ZOO_PERM_ADMIN + ZOO_PERM_ALL = ZOO_PERM_ALL + + ZOO_CREATED_EVENT = ZOO_CREATED_EVENT + ZOO_DELETED_EVENT = ZOO_DELETED_EVENT + ZOO_CHANGED_EVENT = ZOO_CHANGED_EVENT + ZOO_CHILD_EVENT = ZOO_CHILD_EVENT + ZOO_SESSION_EVENT = ZOO_SESSION_EVENT + ZOO_NOTWATCHING_EVENT = ZOO_NOTWATCHING_EVENT + + ZOO_EXPIRED_SESSION_STATE = ZOO_EXPIRED_SESSION_STATE + ZOO_AUTH_FAILED_STATE = ZOO_AUTH_FAILED_STATE + ZOO_CONNECTING_STATE = ZOO_CONNECTING_STATE + ZOO_ASSOCIATING_STATE = ZOO_ASSOCIATING_STATE + ZOO_CONNECTED_STATE = ZOO_CONNECTED_STATE + + ZOO_LOG_LEVEL_OFF = ZOO_LOG_LEVEL_OFF + ZOO_LOG_LEVEL_ERROR = ZOO_LOG_LEVEL_ERROR + ZOO_LOG_LEVEL_WARN = ZOO_LOG_LEVEL_WARN + ZOO_LOG_LEVEL_INFO = ZOO_LOG_LEVEL_INFO + ZOO_LOG_LEVEL_DEBUG = ZOO_LOG_LEVEL_DEBUG + CODE: + if (!ix) { + if (!alias) { + alias = GvNAME(CvGV(cv)); + } + + if (strEQ(alias, "ZOK")) { + RETVAL = ZOK; + } + else if (strEQ(alias, "ZOO_LOG_LEVEL_OFF")) { + RETVAL = ZOO_LOG_LEVEL_OFF; + } + else { + Perl_croak(aTHX_ "unknown " PACKAGE_NAME " constant: %s", + alias); + } + } + else { + RETVAL = ix; + } + OUTPUT: + RETVAL + + +AV * +zk_acl_constant(alias=Nullch) + char *alias + ALIAS: + ZOO_OPEN_ACL_UNSAFE = 1 + ZOO_READ_ACL_UNSAFE = 2 + ZOO_CREATOR_ALL_ACL = 3 + PREINIT: + struct ACL_vector acl; + AV *acl_arr; + int i; + PPCODE: + if (!ix && !alias) { + alias = GvNAME(CvGV(cv)); + } + + if (ix == 1 || (alias != NULL && strEQ(alias, "ZOO_OPEN_ACL_UNSAFE"))) { + acl = ZOO_OPEN_ACL_UNSAFE; + } + else if (ix == 2 || (alias != NULL && strEQ(alias, "ZOO_READ_ACL_UNSAFE"))) { + acl = ZOO_READ_ACL_UNSAFE; + } + else if (ix == 3 || (alias != NULL && strEQ(alias, "ZOO_CREATOR_ALL_ACL"))) { + acl = ZOO_CREATOR_ALL_ACL; + } + else { + Perl_croak(aTHX_ "unknown " PACKAGE_NAME " constant: %s", alias); + } + + acl_arr = newAV(); + + av_extend(acl_arr, acl.count); + + for (i = 0; i < acl.count; ++i) { + HV *acl_entry_hash = newHV(); + SV *val; + + _zk_fill_acl_entry_hash(aTHX_ &acl.data[i], acl_entry_hash); + + val = newRV_noinc((SV*) acl_entry_hash); + + if (!av_store(acl_arr, i, val)) { + SvREFCNT_dec(val); + } + } + + ST(0) = sv_2mortal(newRV_noinc((SV*) acl_arr)); + + XSRETURN(1); + + +void +zk_set_log_level(level) + int level + PPCODE: + if (level < ZOO_LOG_LEVEL_OFF || level > ZOO_LOG_LEVEL_DEBUG) { + Perl_croak(aTHX_ "invalid log level: %d", level); + } + + zoo_set_debug_level(level); + + XSRETURN_EMPTY; + + +void +zk_set_deterministic_conn_order(flag) + bool flag + PPCODE: + zoo_deterministic_conn_order(!!flag); + + XSRETURN_EMPTY; + + +void +zk_new(package, hosts, ...) + char *package + char *hosts + PREINIT: + int recv_timeout = DEFAULT_RECV_TIMEOUT_MSEC; + const clientid_t *client_id = NULL; + zk_t *zk; + zk_handle_t *handle; + HV *stash, *zk_hash, *attr_hash; + SV *attr; + int i; + PPCODE: + if (items > 2 && items % 2) { + Perl_croak(aTHX_ "invalid number of arguments"); + } + + for (i = 2; i < items; i += 2) { + char *key = SvPV_nolen(ST(i)); + + if (strcaseEQ(key, "session_timeout")) { + recv_timeout = SvIV(ST(i + 1)); + + /* NOTE: would be nice if requirement in zookeeper_interest() + * that recv_timeout*2 be non-negative was documented + */ + if (recv_timeout < 0 || recv_timeout > (PERL_INT_MAX >> 1)) { + Perl_croak(aTHX_ "invalid session timeout: %d", + recv_timeout); + } + } + else if (strcaseEQ(key, "session_id")) { + STRLEN client_id_len; + + client_id = (const clientid_t*) SvPV(ST(i + 1), client_id_len); + + if (client_id_len != sizeof(clientid_t)) { + Perl_croak(aTHX_ "invalid session ID"); + } + } + } + + Newxz(zk, 1, zk_t); + + zk->handle = zookeeper_init(hosts, NULL, recv_timeout, + client_id, NULL, 0); + + if (!zk->handle) { + Safefree(zk); + + XSRETURN_UNDEF; + } + + Newxz(zk->first_watch, 1, zk_watch_t); + + zk->data_buf_len = DEFAULT_DATA_BUF_LEN; + zk->path_buf_len = DEFAULT_PATH_BUF_LEN; + zk->watch_timeout = DEFAULT_WATCH_TIMEOUT; + + zk->hosts_len = strlen(hosts); + zk->hosts = savepvn(hosts, zk->hosts_len); + + Newx(handle, 1, zk_handle_t); + + handle->signature = PACKAGE_SIGNATURE; + handle->handle.zk = zk; + + /* We use several tricks from DBI here. The attr_hash is our + * empty inner hash; we attach extra magic to it in the form of + * our zk_handle_t structure. Then we tie attr_hash to zk_hash, + * our outer hash. This is what is passed around (by reference) by + * callers. + * + * Most methods use _zk_get_handle_outer() which finds our inner + * handle, then returns the zk_t structure from its extra magic + * pointer. + * + * However, the tied hash methods, FETCH(), STORE(), and so forth, + * receive an already-dereferenced inner handle hash. This is + * because we bless both inner and outer handles into this class, + * so when a caller's code references a hash element in our + * outer handle, Perl detects its tied magic, looks up the + * tied object (our inner handle) and invokes the tied hash methods + * in its class on it. Since we blessed it into the same class + * as the outer handle, these methods simply reside in our package. + */ + + stash = gv_stashpv(package, GV_ADDWARN); + + attr_hash = newHV(); + + sv_magic((SV*) attr_hash, Nullsv, PERL_MAGIC_ext, + (const char*) handle, 0); + + attr = sv_bless(newRV_noinc((SV*) attr_hash), stash); + + zk_hash = newHV(); + + sv_magic((SV*) zk_hash, attr, PERL_MAGIC_tied, Nullch, 0); + SvREFCNT_dec(attr); + + ST(0) = sv_bless(sv_2mortal(newRV_noinc((SV*) zk_hash)), stash); + + XSRETURN(1); + + +void +zk_DESTROY(zkh) + Net::ZooKeeper zkh + PREINIT: + zk_handle_t *handle; + HV *attr_hash; + int ret = ZBADARGUMENTS; + PPCODE: + handle = _zk_check_handle_outer(aTHX_ zkh, &attr_hash, + PACKAGE_NAME, PACKAGE_SIGNATURE); + + if (!handle) { + handle = _zk_check_handle_inner(aTHX_ zkh, PACKAGE_SIGNATURE); + + if (handle) { + attr_hash = zkh; + zkh = NULL; + } + } + + if (handle) { + zk_t *zk = handle->handle.zk; + + ret = zookeeper_close(zk->handle); + + /* detach all now-inactive watches still tied to handles */ + _zk_release_watches(aTHX_ zk->first_watch, 1); + + Safefree(zk->first_watch); + Safefree(zk->hosts); + Safefree(zk); + Safefree(handle); + + sv_unmagic((SV*) attr_hash, PERL_MAGIC_ext); + } + + if (zkh && attr_hash) { + sv_unmagic((SV*) zkh, PERL_MAGIC_tied); + } + + if (GIMME_V == G_VOID) { + XSRETURN_EMPTY; + } + else if (ret == ZOK) { + XSRETURN_YES; + } + else { + XSRETURN_NO; + } + + +void +zk_CLONE(package) + char *package + PPCODE: + XSRETURN_EMPTY; + + +void +zk_CLONE_SKIP(package) + char *package + PPCODE: + XSRETURN_YES; + + +void +zk_TIEHASH(package, ...) + char *package + PPCODE: + Perl_croak(aTHX_ "tying hashes of class " + PACKAGE_NAME " not supported"); + + +void +zk_UNTIE(attr_hash, ref_count) + Net::ZooKeeper attr_hash + IV ref_count + PPCODE: + Perl_croak(aTHX_ "untying hashes of class " + PACKAGE_NAME " not supported"); + + +void +zk_FIRSTKEY(attr_hash) + Net::ZooKeeper attr_hash + PREINIT: + zk_t *zk; + PPCODE: + zk = _zk_get_handle_inner(aTHX_ attr_hash); + + if (!zk) { + Perl_croak(aTHX_ "invalid handle"); + } + + ST(0) = sv_2mortal(newSVpvn(zk_keys[0].name, zk_keys[0].name_len)); + + XSRETURN(1); + + +void +zk_NEXTKEY(attr_hash, attr_key) + Net::ZooKeeper attr_hash + SV *attr_key + PREINIT: + zk_t *zk; + char *key; + int i; + PPCODE: + zk = _zk_get_handle_inner(aTHX_ attr_hash); + + if (!zk) { + Perl_croak(aTHX_ "invalid handle"); + } + + key = SvPV_nolen(attr_key); + + for (i = 0; i < NUM_KEYS; ++i) { + if (strcaseEQ(key, zk_keys[i].name)) { + ++i; + + break; + } + } + + if (i < NUM_KEYS) { + ST(0) = sv_2mortal(newSVpvn(zk_keys[i].name, zk_keys[i].name_len)); + + XSRETURN(1); + } + else { + XSRETURN_EMPTY; + } + + +void +zk_SCALAR(attr_hash) + Net::ZooKeeper attr_hash + PPCODE: + XSRETURN_YES; + + +void +zk_FETCH(attr_hash, attr_key) + Net::ZooKeeper attr_hash + SV *attr_key + PREINIT: + zk_t *zk; + char *key; + SV *val = NULL; + PPCODE: + zk = _zk_get_handle_inner(aTHX_ attr_hash); + + if (!zk) { + Perl_croak(aTHX_ "invalid handle"); + } + + key = SvPV_nolen(attr_key); + + if (strcaseEQ(key, "data_read_len")) { + val = newSViv(zk->data_buf_len); + } + else if (strcaseEQ(key, "path_read_len")) { + val = newSViv(zk->path_buf_len); + } + else if (strcaseEQ(key, "watch_timeout")) { + val = newSVuv(zk->watch_timeout); + } + else if (strcaseEQ(key, "hosts")) { + val = newSVpvn(zk->hosts, zk->hosts_len); + } + else if (strcaseEQ(key, "session_timeout")) { + val = newSViv(zoo_recv_timeout(zk->handle)); + } + else if (strcaseEQ(key, "session_id")) { + const clientid_t *client_id; + clientid_t null_client_id; + + client_id = zoo_client_id(zk->handle); + + memset(&null_client_id, 0, sizeof(clientid_t)); + + if (!memcmp(client_id, &null_client_id, sizeof(clientid_t))) { + val = newSVpv("", 0); + } + else { + val = newSVpvn((const char*) client_id, sizeof(clientid_t)); + } + } + else if (strcaseEQ(key, "pending_watches")) { + /* cleanup any completed watches not tied to a handle */ + val = newSVuv(_zk_release_watches(aTHX_ zk->first_watch, 0)); + } + + if (val) { + ST(0) = sv_2mortal(val); + + XSRETURN(1); + } + + Perl_warn(aTHX_ "invalid element: %s", key); + + XSRETURN_UNDEF; + + +void +zk_STORE(attr_hash, attr_key, attr_val) + Net::ZooKeeper attr_hash + SV *attr_key + SV *attr_val + PREINIT: + zk_t *zk; + char *key; + PPCODE: + zk = _zk_get_handle_inner(aTHX_ attr_hash); + + if (!zk) { + Perl_croak(aTHX_ "invalid handle"); + } + + key = SvPV_nolen(attr_key); + + if (strcaseEQ(key, "data_read_len")) { + int val = SvIV(attr_val); + + if (val < 0) { + Perl_croak(aTHX_ "invalid data read length: %d", val); + } + + zk->data_buf_len = val; + } + else if (strcaseEQ(key, "path_read_len")) { + int val = SvIV(attr_val); + + if (val < 0) { + Perl_croak(aTHX_ "invalid path read length: %d", val); + } + + zk->path_buf_len = val; + } + else if (strcaseEQ(key, "watch_timeout")) { + zk->watch_timeout = SvUV(attr_val); + } + else { + int i; + + for (i = 0; i < NUM_KEYS; ++i) { + if (strcaseEQ(key, zk_keys[i].name)) { + Perl_warn(aTHX_ "read-only element: %s", key); + + XSRETURN_EMPTY; + } + } + + Perl_warn(aTHX_ "invalid element: %s", key); + } + + XSRETURN_EMPTY; + + +void +zk_EXISTS(attr_hash, attr_key) + Net::ZooKeeper attr_hash + SV *attr_key + PREINIT: + zk_t *zk; + char *key; + int i; + PPCODE: + zk = _zk_get_handle_inner(aTHX_ attr_hash); + + if (!zk) { + Perl_croak(aTHX_ "invalid handle"); + } + + key = SvPV_nolen(attr_key); + + for (i = 0; i < NUM_KEYS; ++i) { + if (strcaseEQ(key, zk_keys[i].name)) { + XSRETURN_YES; + } + } + + XSRETURN_NO; + + +void +zk_DELETE(attr_hash, attr_key) + Net::ZooKeeper attr_hash + SV *attr_key + PPCODE: + Perl_warn(aTHX_ "deleting elements from hashes of class " + PACKAGE_NAME " not supported"); + + XSRETURN_EMPTY; + + +void +zk_CLEAR(attr_hash) + Net::ZooKeeper attr_hash + PPCODE: + Perl_warn(aTHX_ "clearing hashes of class " + PACKAGE_NAME " not supported"); + + XSRETURN_EMPTY; + + +SV * +zk_get_error(zkh) + Net::ZooKeeper zkh + PREINIT: + zk_t *zk; + CODE: + zk = _zk_get_handle_outer(aTHX_ zkh); + + if (!zk) { + Perl_croak(aTHX_ "invalid handle"); + } + + RETVAL = newSViv(zk->last_ret); + errno = zk->last_errno; + OUTPUT: + RETVAL + + +void +zk_add_auth(zkh, scheme, cert) + Net::ZooKeeper zkh + char *scheme + char *cert; cert = (char *) SvPV($arg, cert_len); + PREINIT: + zk_t *zk; + STRLEN cert_len; + zk_watch_t *watch; + int ret; + PPCODE: + zk = _zk_get_handle_outer(aTHX_ zkh); + + if (!zk) { + Perl_croak(aTHX_ "invalid handle"); + } + + zk->last_ret = ZOK; + zk->last_errno = 0; + + if (cert_len > PERL_INT_MAX) { + Perl_croak(aTHX_ "invalid certificate length: %u", cert_len); + } + + watch = _zk_create_watch(aTHX); + + if (!watch) { + /* errno will be set */ + zk->last_ret = ZSYSTEMERROR; + zk->last_errno = errno; + + XSRETURN_NO; + } + + errno = 0; + ret = zoo_add_auth(zk->handle, scheme, cert, cert_len, + _zk_auth_completion, watch); + + zk->last_ret = ret; + zk->last_errno = errno; + + if (ret == ZOK) { + pthread_mutex_lock(&watch->mutex); + + while (!watch->done) { + pthread_cond_wait(&watch->cond, &watch->mutex); + } + + pthread_mutex_unlock(&watch->mutex); + + if (watch->done) { + ret = watch->ret; + } + else { + ret = ZINVALIDSTATE; + } + + /* errno may be set while we waited */ + zk->last_ret = ret; + zk->last_errno = errno; + } + + _zk_destroy_watch(aTHX_ watch); + + if (ret == ZOK) { + XSRETURN_YES; + } + else { + XSRETURN_NO; + } + + +void +zk_create(zkh, path, buf, ...) + Net::ZooKeeper zkh + char *path + char *buf; buf = (char *) SvPV($arg, buf_len); + PREINIT: + zk_t *zk; + STRLEN buf_len; + int flags = 0; + char *path_buf; + int path_buf_len; + AV *acl_arr = NULL; + struct ACL_vector acl; + int i, ret; + PPCODE: + zk = _zk_get_handle_outer(aTHX_ zkh); + + if (!zk) { + Perl_croak(aTHX_ "invalid handle"); + } + + zk->last_ret = ZOK; + zk->last_errno = 0; + + if (items > 3 && !(items % 2)) { + Perl_croak(aTHX_ "invalid number of arguments"); + } + + if (buf_len > PERL_INT_MAX) { + Perl_croak(aTHX_ "invalid data length: %u", buf_len); + } + + path_buf_len = zk->path_buf_len; + + for (i = 3; i < items; i += 2) { + char *key = SvPV_nolen(ST(i)); + + if (strcaseEQ(key, "path_read_len")) { + path_buf_len = SvIV(ST(i + 1)); + + if (path_buf_len < 2) { + Perl_croak(aTHX_ "invalid path read length: %d", + path_buf_len); + } + } + else if (strcaseEQ(key, "flags")) { + flags = SvIV(ST(i + 1)); + + if (flags & ~(ZOO_SEQUENCE | ZOO_EPHEMERAL)) { + Perl_croak(aTHX_ "invalid create flags: %d", flags); + } + } + else if (strcaseEQ(key, "acl")) { + const char *err; + + if (!SvROK(ST(i + 1)) || SvTYPE(SvRV(ST(i + 1))) != SVt_PVAV) { + Perl_croak(aTHX_ "invalid ACL array reference"); + } + + acl_arr = (AV*) SvRV(ST(i + 1)); + + err = _zk_fill_acl(aTHX_ acl_arr, &acl); + + if (err) { + Perl_croak(aTHX_ err); + } + } + } + + /* NOTE: would be nice to be able to rely on null-terminated string */ + ++path_buf_len; + Newxz(path_buf, path_buf_len, char); + + errno = 0; + ret = zoo_create(zk->handle, path, buf, buf_len, + (acl_arr ? &acl : NULL), flags, + path_buf, path_buf_len); + + zk->last_ret = ret; + zk->last_errno = errno; + + if (acl_arr) { + _zk_free_acl(aTHX_ &acl); + } + + if (ret == ZOK) { + ST(0) = sv_newmortal(); +#ifdef SV_HAS_TRAILING_NUL + sv_usepvn_flags(ST(0), path_buf, strlen(path_buf), + SV_HAS_TRAILING_NUL); +#else + sv_usepvn(ST(0), path_buf, strlen(path_buf)); +#endif + SvCUR_set(ST(0), strlen(path_buf)); + + XSRETURN(1); + } + + Safefree(path_buf); + + XSRETURN_UNDEF; + + +void +zk_delete(zkh, path, ...) + Net::ZooKeeper zkh + char *path + PREINIT: + zk_t *zk; + int version = -1; + int i, ret; + PPCODE: + zk = _zk_get_handle_outer(aTHX_ zkh); + + if (!zk) { + Perl_croak(aTHX_ "invalid handle"); + } + + zk->last_ret = ZOK; + zk->last_errno = 0; + + if (items > 2 && items % 2) { + Perl_croak(aTHX_ "invalid number of arguments"); + } + + for (i = 2; i < items; i += 2) { + char *key = SvPV_nolen(ST(i)); + + if (strcaseEQ(key, "version")) { + version = SvIV(ST(i + 1)); + + if (version < 0) { + Perl_croak(aTHX_ "invalid version requirement: %d", + version); + } + } + } + + errno = 0; + ret = zoo_delete(zk->handle, path, version); + + zk->last_ret = ret; + zk->last_errno = errno; + + if (ret == ZOK) { + XSRETURN_YES; + } + else { + XSRETURN_NO; + } + + +void +zk_exists(zkh, path, ...) + Net::ZooKeeper zkh + char *path + PREINIT: + zk_t *zk; + zk_stat_t *stat = NULL; + zk_watch_t *old_watch = NULL; + zk_handle_t *watch_handle = NULL; + watcher_fn watcher = NULL; + zk_watch_t *new_watch = NULL; + int i, ret; + PPCODE: + zk = _zk_get_handle_outer(aTHX_ zkh); + + if (!zk) { + Perl_croak(aTHX_ "invalid handle"); + } + + zk->last_ret = ZOK; + zk->last_errno = 0; + + if (items > 2 && items % 2) { + Perl_croak(aTHX_ "invalid number of arguments"); + } + + for (i = 2; i < items; i += 2) { + char *key = SvPV_nolen(ST(i)); + + if (strcaseEQ(key, "stat")) { + if (!SvROK(ST(i + 1)) || SvTYPE(SvRV(ST(i + 1))) != SVt_PVHV || + !sv_derived_from(ST(i + 1), STAT_PACKAGE_NAME)) { + Perl_croak(aTHX_ "stat is not a hash reference of " + "type " STAT_PACKAGE_NAME); + } + + stat = _zks_get_handle_outer(aTHX_ (HV*) SvRV(ST(i + 1))); + + if (!stat) { + Perl_croak(aTHX_ "invalid stat handle"); + } + } + else if (strcaseEQ(key, "watch")) { + if (!SvROK(ST(i + 1)) || SvTYPE(SvRV(ST(i + 1))) != SVt_PVHV || + !sv_derived_from(ST(i + 1), WATCH_PACKAGE_NAME)) { + Perl_croak(aTHX_ "watch is not a hash reference of " + "type " WATCH_PACKAGE_NAME); + } + + old_watch = _zkw_get_handle_outer(aTHX_ (HV*) SvRV(ST(i + 1)), + &watch_handle); + + if (!old_watch) { + Perl_croak(aTHX_ "invalid watch handle"); + } + } + } + + if (watch_handle) { + new_watch = _zk_acquire_watch(aTHX); + + if (!new_watch) { + /* errno will be set */ + zk->last_ret = ZSYSTEMERROR; + zk->last_errno = errno; + + XSRETURN_NO; + } + + watcher = _zk_watcher; + } + + errno = 0; + ret = zoo_wexists(zk->handle, path, watcher, new_watch, stat); + + zk->last_ret = ret; + zk->last_errno = errno; + + if (watch_handle) { + _zk_replace_watch(aTHX_ watch_handle, zk->first_watch, + old_watch, new_watch); + } + + if (ret == ZOK) { + XSRETURN_YES; + } + else { + XSRETURN_NO; + } + + +void +zk_get_children(zkh, path, ...) + Net::ZooKeeper zkh + char *path + PREINIT: + zk_t *zk; + zk_watch_t *old_watch = NULL; + zk_handle_t *watch_handle = NULL; + watcher_fn watcher = NULL; + zk_watch_t *new_watch = NULL; + struct String_vector strings; + int i, ret; + PPCODE: + zk = _zk_get_handle_outer(aTHX_ zkh); + + if (!zk) { + Perl_croak(aTHX_ "invalid handle"); + } + + zk->last_ret = ZOK; + zk->last_errno = 0; + + if (items > 2 && items % 2) { + Perl_croak(aTHX_ "invalid number of arguments"); + } + + for (i = 2; i < items; i += 2) { + char *key = SvPV_nolen(ST(i)); + + if (strcaseEQ(key, "watch")) { + if (!SvROK(ST(i + 1)) || SvTYPE(SvRV(ST(i + 1))) != SVt_PVHV || + !sv_derived_from(ST(i + 1), WATCH_PACKAGE_NAME)) { + Perl_croak(aTHX_ "watch is not a hash reference of " + "type " WATCH_PACKAGE_NAME); + } + + old_watch = _zkw_get_handle_outer(aTHX_ (HV*) SvRV(ST(i + 1)), + &watch_handle); + + if (!old_watch) { + Perl_croak(aTHX_ "invalid watch handle"); + } + } + } + + if (watch_handle) { + new_watch = _zk_acquire_watch(aTHX); + + if (!new_watch) { + /* errno will be set */ + zk->last_ret = ZSYSTEMERROR; + zk->last_errno = errno; + + if (GIMME_V == G_ARRAY) { + XSRETURN_EMPTY; + } + else { + XSRETURN_UNDEF; + } + } + + watcher = _zk_watcher; + } + + Zero(&strings, 1, struct String_vector); + + errno = 0; + ret = zoo_wget_children(zk->handle, path, watcher, new_watch, + &strings); + + zk->last_ret = ret; + zk->last_errno = errno; + + if (watch_handle) { + _zk_replace_watch(aTHX_ watch_handle, zk->first_watch, + old_watch, new_watch); + } + + if (ret == ZOK) { + int num_children; + + num_children = + (strings.count > PERL_INT_MAX) ? PERL_INT_MAX : strings.count; + + if (GIMME_V == G_ARRAY && num_children > 0) { + EXTEND(SP, num_children); + + for (i = 0; i < num_children; ++i) { + ST(i) = sv_2mortal(newSVpv(strings.data[i], 0)); + } + } + + /* NOTE: would be nice if this were documented as required */ + deallocate_String_vector(&strings); + + if (GIMME_V == G_ARRAY) { + if (num_children == 0) { + XSRETURN_EMPTY; + } + + XSRETURN(num_children); + } + else { + ST(0) = sv_2mortal(newSViv(num_children)); + + XSRETURN(1); + } + } + else { + if (GIMME_V == G_ARRAY) { + XSRETURN_EMPTY; + } + else { + XSRETURN_UNDEF; + } + } + + +void +zk_get(zkh, path, ...) + Net::ZooKeeper zkh + char *path + PREINIT: + zk_t *zk; + int buf_len; + zk_stat_t *stat = NULL; + zk_watch_t *old_watch = NULL; + zk_handle_t *watch_handle = NULL; + char *buf; + watcher_fn watcher = NULL; + zk_watch_t *new_watch = NULL; + int i, ret; + PPCODE: + zk = _zk_get_handle_outer(aTHX_ zkh); + + if (!zk) { + Perl_croak(aTHX_ "invalid handle"); + } + + zk->last_ret = ZOK; + zk->last_errno = 0; + + if (items > 2 && items % 2) { + Perl_croak(aTHX_ "invalid number of arguments"); + } + + buf_len = zk->data_buf_len; + + for (i = 2; i < items; i += 2) { + char *key = SvPV_nolen(ST(i)); + + if (strcaseEQ(key, "data_read_len")) { + buf_len = SvIV(ST(i + 1)); + + if (buf_len < 0) { + Perl_croak(aTHX_ "invalid data read length: %d", + buf_len); + } + } + else if (strcaseEQ(key, "stat")) { + if (!SvROK(ST(i + 1)) || SvTYPE(SvRV(ST(i + 1))) != SVt_PVHV || + !sv_derived_from(ST(i + 1), STAT_PACKAGE_NAME)) { + Perl_croak(aTHX_ "stat is not a hash reference of " + "type " STAT_PACKAGE_NAME); + } + + stat = _zks_get_handle_outer(aTHX_ (HV*) SvRV(ST(i + 1))); + + if (!stat) { + Perl_croak(aTHX_ "invalid stat handle"); + } + } + else if (strcaseEQ(key, "watch")) { + if (!SvROK(ST(i + 1)) || SvTYPE(SvRV(ST(i + 1))) != SVt_PVHV || + !sv_derived_from(ST(i + 1), WATCH_PACKAGE_NAME)) { + Perl_croak(aTHX_ "watch is not a hash reference of " + "type " WATCH_PACKAGE_NAME); + } + + old_watch = _zkw_get_handle_outer(aTHX_ (HV*) SvRV(ST(i + 1)), + &watch_handle); + + if (!old_watch) { + Perl_croak(aTHX_ "invalid watch handle"); + } + } + } + + if (watch_handle) { + new_watch = _zk_acquire_watch(aTHX); + + if (!new_watch) { + /* errno will be set */ + zk->last_ret = ZSYSTEMERROR; + zk->last_errno = errno; + + XSRETURN_UNDEF; + } + + watcher = _zk_watcher; + } + + Newx(buf, buf_len + 1, char); + + errno = 0; + ret = zoo_wget(zk->handle, path, watcher, new_watch, + buf, &buf_len, stat); + + zk->last_ret = ret; + zk->last_errno = errno; + + if (watch_handle) { + _zk_replace_watch(aTHX_ watch_handle, zk->first_watch, + old_watch, new_watch); + } + + if (ret == ZOK && buf_len != -1) { + ST(0) = sv_newmortal(); +#ifdef SV_HAS_TRAILING_NUL + buf[buf_len] = '\0'; + sv_usepvn_flags(ST(0), buf, buf_len, SV_HAS_TRAILING_NUL); +#else + sv_usepvn(ST(0), buf, buf_len); +#endif + + XSRETURN(1); + } + else { + Safefree(buf); + + XSRETURN_UNDEF; + } + + +void +zk_set(zkh, path, buf, ...) + Net::ZooKeeper zkh + char *path + char *buf; buf = (char *) SvPV($arg, buf_len); + PREINIT: + zk_t *zk; + int version = -1; + zk_stat_t *stat = NULL; + STRLEN buf_len; + int i, ret; + PPCODE: + zk = _zk_get_handle_outer(aTHX_ zkh); + + if (!zk) { + Perl_croak(aTHX_ "invalid handle"); + } + + zk->last_ret = ZOK; + zk->last_errno = 0; + + if (items > 3 && !(items % 2)) { + Perl_croak(aTHX_ "invalid number of arguments"); + } + + if (buf_len > PERL_INT_MAX) { + Perl_croak(aTHX_ "invalid data length: %u", buf_len); + } + + for (i = 3; i < items; i += 2) { + char *key = SvPV_nolen(ST(i)); + + if (strcaseEQ(key, "version")) { + version = SvIV(ST(i + 1)); + + if (version < 0) { + Perl_croak(aTHX_ "invalid version requirement: %d", + version); + } + } + else if (strcaseEQ(key, "stat")) { + if (!SvROK(ST(i + 1)) || SvTYPE(SvRV(ST(i + 1))) != SVt_PVHV || + !sv_derived_from(ST(i + 1), STAT_PACKAGE_NAME)) { + Perl_croak(aTHX_ "stat is not a hash reference of " + "type " STAT_PACKAGE_NAME); + } + + stat = _zks_get_handle_outer(aTHX_ (HV*) SvRV(ST(i + 1))); + + if (!stat) { + Perl_croak(aTHX_ "invalid stat handle"); + } + } + } + + errno = 0; + ret = zoo_set2(zk->handle, path, buf, buf_len, version, stat); + + zk->last_ret = ret; + zk->last_errno = errno; + + if (ret == ZOK) { + XSRETURN_YES; + } + else { + XSRETURN_NO; + } + + +void +zk_get_acl(zkh, path, ...) + Net::ZooKeeper zkh + char *path + PREINIT: + zk_t *zk; + zk_stat_t *stat = NULL; + struct ACL_vector acl; + int i, ret; + PPCODE: + zk = _zk_get_handle_outer(aTHX_ zkh); + + if (!zk) { + Perl_croak(aTHX_ "invalid handle"); + } + + zk->last_ret = ZOK; + zk->last_errno = 0; + + if (items > 2 && items % 2) { + Perl_croak(aTHX_ "invalid number of arguments"); + } + + for (i = 2; i < items; i += 2) { + char *key = SvPV_nolen(ST(i)); + + if (strcaseEQ(key, "stat")) { + if (!SvROK(ST(i + 1)) || SvTYPE(SvRV(ST(i + 1))) != SVt_PVHV || + !sv_derived_from(ST(i + 1), STAT_PACKAGE_NAME)) { + Perl_croak(aTHX_ "stat is not a hash reference of " + "type " STAT_PACKAGE_NAME); + } + + stat = _zks_get_handle_outer(aTHX_ (HV*) SvRV(ST(i + 1))); + + if (!stat) { + Perl_croak(aTHX_ "invalid stat handle"); + } + } + } + + errno = 0; + ret = zoo_get_acl(zk->handle, path, &acl, stat); + + zk->last_ret = ret; + zk->last_errno = errno; + + if (ret == ZOK) { + int num_acl_entries; + + num_acl_entries = + (acl.count > PERL_INT_MAX) ? PERL_INT_MAX : acl.count; + + if (GIMME_V == G_ARRAY && num_acl_entries > 0) { + EXTEND(SP, num_acl_entries); + + for (i = 0; i < num_acl_entries; ++i) { + HV *acl_entry_hash = newHV(); + + _zk_fill_acl_entry_hash(aTHX_ &acl.data[i], + acl_entry_hash); + + ST(i) = sv_2mortal(newRV_noinc((SV*) acl_entry_hash)); + } + } + + /* NOTE: would be nice if this were documented as required */ + deallocate_ACL_vector(&acl); + + if (GIMME_V == G_ARRAY) { + if (num_acl_entries == 0) { + XSRETURN_EMPTY; + } + + XSRETURN(num_acl_entries); + } + else { + ST(0) = sv_2mortal(newSViv(num_acl_entries)); + + XSRETURN(1); + } + } + else { + if (GIMME_V == G_ARRAY) { + XSRETURN_EMPTY; + } + else { + XSRETURN_UNDEF; + } + } + + +void +zk_set_acl(zkh, path, acl_arr, ...) + Net::ZooKeeper zkh + char *path + AV *acl_arr + PREINIT: + zk_t *zk; + const char *err; + int version = -1; + struct ACL_vector acl; + int i, ret; + PPCODE: + zk = _zk_get_handle_outer(aTHX_ zkh); + + if (!zk) { + Perl_croak(aTHX_ "invalid handle"); + } + + zk->last_ret = ZOK; + zk->last_errno = 0; + + if (items > 3 && !(items % 2)) { + Perl_croak(aTHX_ "invalid number of arguments"); + } + + err = _zk_fill_acl(aTHX_ acl_arr, &acl); + + if (err) { + Perl_croak(aTHX_ err); + } + + for (i = 3; i < items; i += 2) { + char *key = SvPV_nolen(ST(i)); + + if (strcaseEQ(key, "version")) { + version = SvIV(ST(i + 1)); + + if (version < 0) { + Perl_croak(aTHX_ "invalid version requirement: %d", + version); + } + } + } + + errno = 0; + ret = zoo_set_acl(zk->handle, path, version, &acl); + + zk->last_ret = ret; + zk->last_errno = errno; + + _zk_free_acl(aTHX_ &acl); + + if (ret == ZOK) { + XSRETURN_YES; + } + else { + XSRETURN_NO; + } + + +void +zk_stat(zkh) + Net::ZooKeeper zkh + PREINIT: + zk_t *zk; + zk_handle_t *handle; + HV *stash, *stat_hash, *attr_hash; + SV *attr; + PPCODE: + zk = _zk_get_handle_outer(aTHX_ zkh); + + if (!zk) { + Perl_croak(aTHX_ "invalid handle"); + } + + zk->last_ret = ZOK; + zk->last_errno = 0; + + Newx(handle, 1, zk_handle_t); + + handle->signature = STAT_PACKAGE_SIGNATURE; + + Newxz(handle->handle.stat, 1, zk_stat_t); + + /* As in zk_new(), we use two levels of magic here. */ + + stash = gv_stashpv(STAT_PACKAGE_NAME, GV_ADDWARN); + + attr_hash = newHV(); + + sv_magic((SV*) attr_hash, Nullsv, PERL_MAGIC_ext, + (const char*) handle, 0); + + attr = sv_bless(newRV_noinc((SV*) attr_hash), stash); + + stat_hash = newHV(); + + sv_magic((SV*) stat_hash, attr, PERL_MAGIC_tied, Nullch, 0); + SvREFCNT_dec(attr); + + ST(0) = sv_bless(sv_2mortal(newRV_noinc((SV*) stat_hash)), stash); + + XSRETURN(1); + + +void +zk_watch(zkh, ...) + Net::ZooKeeper zkh + PREINIT: + zk_t *zk; + unsigned int timeout; + zk_watch_t *watch; + zk_handle_t *handle; + HV *stash, *watch_hash, *attr_hash; + SV *attr; + int i; + PPCODE: + zk = _zk_get_handle_outer(aTHX_ zkh); + + if (!zk) { + Perl_croak(aTHX_ "invalid handle"); + } + + zk->last_ret = ZOK; + zk->last_errno = 0; + + if (items > 1 && !(items % 2)) { + Perl_croak(aTHX_ "invalid number of arguments"); + } + + timeout = zk->watch_timeout; + + for (i = 1; i < items; i += 2) { + char *key = SvPV_nolen(ST(i)); + + if (strcaseEQ(key, "timeout")) { + timeout = SvUV(ST(i + 1)); + } + } + + watch = _zk_acquire_watch(aTHX); + + if (!watch) { + /* errno will be set */ + zk->last_ret = ZSYSTEMERROR; + zk->last_errno = errno; + + XSRETURN_UNDEF; + } + + Newx(handle, 1, zk_handle_t); + + handle->signature = WATCH_PACKAGE_SIGNATURE; + handle->handle.watch = watch; + + /* As in zk_new(), we use two levels of magic here. */ + + stash = gv_stashpv(WATCH_PACKAGE_NAME, GV_ADDWARN); + + attr_hash = newHV(); + + watch->timeout = timeout; + + sv_magic((SV*) attr_hash, Nullsv, PERL_MAGIC_ext, + (const char*) handle, 0); + + attr = sv_bless(newRV_noinc((SV*) attr_hash), stash); + + watch_hash = newHV(); + + sv_magic((SV*) watch_hash, attr, PERL_MAGIC_tied, Nullch, 0); + SvREFCNT_dec(attr); + + ST(0) = sv_bless(sv_2mortal(newRV_noinc((SV*) watch_hash)), stash); + + XSRETURN(1); + + +MODULE = Net::ZooKeeper PACKAGE = Net::ZooKeeper::Stat PREFIX = zks_ + +void +zks_DESTROY(zksh) + Net::ZooKeeper::Stat zksh + PREINIT: + zk_handle_t *handle; + HV *attr_hash; + int ret = ZBADARGUMENTS; + PPCODE: + handle = _zk_check_handle_outer(aTHX_ zksh, &attr_hash, + STAT_PACKAGE_NAME, + STAT_PACKAGE_SIGNATURE); + + if (!handle) { + handle = _zk_check_handle_inner(aTHX_ zksh, + STAT_PACKAGE_SIGNATURE); + + if (handle) { + attr_hash = zksh; + zksh = NULL; + } + } + + if (handle) { + ret = ZOK; + + Safefree(handle->handle.stat); + Safefree(handle); + + sv_unmagic((SV*) attr_hash, PERL_MAGIC_ext); + } + + if (zksh && attr_hash) { + sv_unmagic((SV*) zksh, PERL_MAGIC_tied); + } + + if (GIMME_V == G_VOID) { + XSRETURN_EMPTY; + } + else if (ret == ZOK) { + XSRETURN_YES; + } + else { + XSRETURN_NO; + } + + +void +zks_CLONE(package) + char *package + PPCODE: + XSRETURN_EMPTY; + + +void +zks_CLONE_SKIP(package) + char *package + PPCODE: + XSRETURN_YES; + + +void +zks_TIEHASH(package, ...) + char *package + PPCODE: + Perl_croak(aTHX_ "tying hashes of class " + STAT_PACKAGE_NAME " not supported"); + + +void +zks_UNTIE(attr_hash, ref_count) + Net::ZooKeeper::Stat attr_hash + IV ref_count + PPCODE: + Perl_croak(aTHX_ "untying hashes of class " + STAT_PACKAGE_NAME " not supported"); + + +void +zks_FIRSTKEY(attr_hash) + Net::ZooKeeper::Stat attr_hash + PREINIT: + zk_stat_t *stat; + PPCODE: + stat = _zks_get_handle_inner(aTHX_ attr_hash); + + if (!stat) { + Perl_croak(aTHX_ "invalid handle"); + } + + ST(0) = sv_2mortal(newSVpvn(zk_stat_keys[0].name, + zk_stat_keys[0].name_len)); + + XSRETURN(1); + + +void +zks_NEXTKEY(attr_hash, attr_key) + Net::ZooKeeper::Stat attr_hash + SV *attr_key + PREINIT: + zk_stat_t *stat; + char *key; + int i; + PPCODE: + stat = _zks_get_handle_inner(aTHX_ attr_hash); + + if (!stat) { + Perl_croak(aTHX_ "invalid handle"); + } + + key = SvPV_nolen(attr_key); + + for (i = 0; i < NUM_STAT_KEYS; ++i) { + if (strcaseEQ(key, zk_stat_keys[i].name)) { + ++i; + + break; + } + } + + if (i < NUM_STAT_KEYS) { + ST(0) = sv_2mortal(newSVpvn(zk_stat_keys[i].name, + zk_stat_keys[i].name_len)); + + XSRETURN(1); + } + else { + XSRETURN_EMPTY; + } + + +void +zks_SCALAR(attr_hash) + Net::ZooKeeper::Stat attr_hash + PPCODE: + XSRETURN_YES; + + +void +zks_FETCH(attr_hash, attr_key) + Net::ZooKeeper::Stat attr_hash + SV *attr_key + PREINIT: + zk_stat_t *stat; + char *key; + SV *val = NULL; + int i; + PPCODE: + stat = _zks_get_handle_inner(aTHX_ attr_hash); + + if (!stat) { + Perl_croak(aTHX_ "invalid handle"); + } + + key = SvPV_nolen(attr_key); + + for (i = 0; i < NUM_STAT_KEYS; ++i) { + if (strcaseEQ(key, zk_stat_keys[i].name)) { + if (zk_stat_keys[i].size * CHAR_BIT == 32) { + val = newSViv(*((int32_t*) (((char*) stat) + + zk_stat_keys[i].offset))); + } + else { + /* NOTE: %lld is inconsistent, so cast to a double */ + val = newSVpvf("%.0f", (double) + *((int64_t*) (((char*) stat) + + zk_stat_keys[i].offset))); + } + + break; + } + } + + if (val) { + ST(0) = sv_2mortal(val); + + XSRETURN(1); + } + + Perl_warn(aTHX_ "invalid element: %s", key); + + XSRETURN_UNDEF; + + +void +zks_STORE(attr_hash, attr_key, attr_val) + Net::ZooKeeper::Stat attr_hash + SV *attr_key + SV *attr_val + PREINIT: + zk_stat_t *stat; + char *key; + int i; + PPCODE: + stat = _zks_get_handle_inner(aTHX_ attr_hash); + + if (!stat) { + Perl_croak(aTHX_ "invalid handle"); + } + + key = SvPV_nolen(attr_key); + + for (i = 0; i < NUM_STAT_KEYS; ++i) { + if (strcaseEQ(key, zk_stat_keys[i].name)) { + Perl_warn(aTHX_ "read-only element: %s", key); + + XSRETURN_EMPTY; + } + } + + Perl_warn(aTHX_ "invalid element: %s", key); + + XSRETURN_EMPTY; + + +void +zks_EXISTS(attr_hash, attr_key) + Net::ZooKeeper::Stat attr_hash + SV *attr_key + PREINIT: + zk_stat_t *stat; + char *key; + int i; + PPCODE: + stat = _zks_get_handle_inner(aTHX_ attr_hash); + + if (!stat) { + Perl_croak(aTHX_ "invalid handle"); + } + + key = SvPV_nolen(attr_key); + + for (i = 0; i < NUM_STAT_KEYS; ++i) { + if (strcaseEQ(key, zk_stat_keys[i].name)) { + XSRETURN_YES; + } + } + + XSRETURN_NO; + + +void +zks_DELETE(attr_hash, attr_key) + Net::ZooKeeper::Stat attr_hash + SV *attr_key + PPCODE: + Perl_warn(aTHX_ "deleting elements from hashes of class " + STAT_PACKAGE_NAME " not supported"); + + XSRETURN_EMPTY; + + +void +zks_CLEAR(attr_hash) + Net::ZooKeeper::Stat attr_hash + PPCODE: + Perl_warn(aTHX_ "clearing hashes of class " + STAT_PACKAGE_NAME " not supported"); + + XSRETURN_EMPTY; + + +MODULE = Net::ZooKeeper PACKAGE = Net::ZooKeeper::Watch PREFIX = zkw_ + +void +zkw_DESTROY(zkwh) + Net::ZooKeeper::Watch zkwh + PREINIT: + zk_handle_t *handle; + HV *attr_hash; + int ret = ZBADARGUMENTS; + PPCODE: + handle = _zk_check_handle_outer(aTHX_ zkwh, &attr_hash, + WATCH_PACKAGE_NAME, + WATCH_PACKAGE_SIGNATURE); + + if (!handle) { + handle = _zk_check_handle_inner(aTHX_ zkwh, + WATCH_PACKAGE_SIGNATURE); + + if (handle) { + attr_hash = zkwh; + zkwh = NULL; + } + } + + if (handle) { + ret = ZOK; + + _zk_release_watch(aTHX_ handle->handle.watch, 0); + Safefree(handle); + + sv_unmagic((SV*) attr_hash, PERL_MAGIC_ext); + } + + if (zkwh && attr_hash) { + sv_unmagic((SV*) zkwh, PERL_MAGIC_tied); + } + + if (GIMME_V == G_VOID) { + XSRETURN_EMPTY; + } + else if (ret == ZOK) { + XSRETURN_YES; + } + else { + XSRETURN_NO; + } + + +void +zkw_CLONE(package) + char *package + PPCODE: + XSRETURN_EMPTY; + + +void +zkw_CLONE_SKIP(package) + char *package + PPCODE: + XSRETURN_YES; + + +void +zkw_TIEHASH(package, ...) + char *package + PPCODE: + Perl_croak(aTHX_ "tying hashes of class " + WATCH_PACKAGE_NAME " not supported"); + + +void +zkw_UNTIE(attr_hash, ref_count) + Net::ZooKeeper::Watch attr_hash + IV ref_count + PPCODE: + Perl_croak(aTHX_ "untying hashes of class " + WATCH_PACKAGE_NAME " not supported"); + + +void +zkw_FIRSTKEY(attr_hash) + Net::ZooKeeper::Watch attr_hash + PREINIT: + zk_watch_t *watch; + PPCODE: + watch = _zkw_get_handle_inner(aTHX_ attr_hash); + + if (!watch) { + Perl_croak(aTHX_ "invalid handle"); + } + + ST(0) = sv_2mortal(newSVpvn(zk_watch_keys[0].name, + zk_watch_keys[0].name_len)); + + XSRETURN(1); + + +void +zkw_NEXTKEY(attr_hash, attr_key) + Net::ZooKeeper::Watch attr_hash + SV *attr_key + PREINIT: + zk_watch_t *watch; + char *key; + int i; + PPCODE: + watch = _zkw_get_handle_inner(aTHX_ attr_hash); + + if (!watch) { + Perl_croak(aTHX_ "invalid handle"); + } + + key = SvPV_nolen(attr_key); + + for (i = 0; i < NUM_WATCH_KEYS; ++i) { + if (strcaseEQ(key, zk_watch_keys[i].name)) { + ++i; + + break; + } + } + + if (i < NUM_WATCH_KEYS) { + ST(0) = sv_2mortal(newSVpvn(zk_watch_keys[i].name, + zk_watch_keys[i].name_len)); + + XSRETURN(1); + } + else { + XSRETURN_EMPTY; + } + + +void +zkw_SCALAR(attr_hash) + Net::ZooKeeper::Watch attr_hash + PPCODE: + XSRETURN_YES; + + +void +zkw_FETCH(attr_hash, attr_key) + Net::ZooKeeper::Watch attr_hash + SV *attr_key + PREINIT: + zk_watch_t *watch; + char *key; + SV *val = NULL; + PPCODE: + watch = _zkw_get_handle_inner(aTHX_ attr_hash); + + if (!watch) { + Perl_croak(aTHX_ "invalid handle"); + } + + key = SvPV_nolen(attr_key); + + if (strcaseEQ(key, "timeout")) { + val = newSVuv(watch->timeout); + } + else if (strcaseEQ(key, "event")) { + val = newSViv(watch->event_type); + } + else if (strcaseEQ(key, "state")) { + val = newSViv(watch->event_state); + } + + if (val) { + ST(0) = sv_2mortal(val); + + XSRETURN(1); + } + + Perl_warn(aTHX_ "invalid element: %s", key); + + XSRETURN_UNDEF; + + +void +zkw_STORE(attr_hash, attr_key, attr_val) + Net::ZooKeeper::Watch attr_hash + SV *attr_key + SV *attr_val + PREINIT: + zk_watch_t *watch; + char *key; + PPCODE: + watch = _zkw_get_handle_inner(aTHX_ attr_hash); + + if (!watch) { + Perl_croak(aTHX_ "invalid handle"); + } + + key = SvPV_nolen(attr_key); + + if (strcaseEQ(key, "timeout")) { + watch->timeout = SvUV(attr_val); + } + else { + int i; + + for (i = 0; i < NUM_WATCH_KEYS; ++i) { + if (strcaseEQ(key, zk_watch_keys[i].name)) { + Perl_warn(aTHX_ "read-only element: %s", key); + + XSRETURN_EMPTY; + } + } + + Perl_warn(aTHX_ "invalid element: %s", key); + } + + XSRETURN_EMPTY; + + +void +zkw_EXISTS(attr_hash, attr_key) + Net::ZooKeeper::Watch attr_hash + SV *attr_key + PREINIT: + zk_watch_t *watch; + char *key; + int i; + PPCODE: + watch = _zkw_get_handle_inner(aTHX_ attr_hash); + + if (!watch) { + Perl_croak(aTHX_ "invalid handle"); + } + + key = SvPV_nolen(attr_key); + + for (i = 0; i < NUM_WATCH_KEYS; ++i) { + if (strcaseEQ(key, zk_watch_keys[i].name)) { + XSRETURN_YES; + } + } + + XSRETURN_NO; + + +void +zkw_DELETE(attr_hash, attr_key) + Net::ZooKeeper::Watch attr_hash + SV *attr_key + PPCODE: + Perl_warn(aTHX_ "deleting elements from hashes of class " + WATCH_PACKAGE_NAME " not supported"); + + XSRETURN_EMPTY; + + +void +zkw_CLEAR(attr_hash) + Net::ZooKeeper::Watch attr_hash + PPCODE: + Perl_warn(aTHX_ "clearing hashes of class " + WATCH_PACKAGE_NAME " not supported"); + + XSRETURN_EMPTY; + + +void +zkw_wait(zkwh, ...) + Net::ZooKeeper::Watch zkwh + PREINIT: + zk_watch_t *watch; + unsigned int timeout; + struct timeval end_timeval; + int i, done; + struct timespec wait_timespec; + PPCODE: + watch = _zkw_get_handle_outer(aTHX_ zkwh, NULL); + + if (!watch) { + Perl_croak(aTHX_ "invalid handle"); + } + + if (items > 1 && !(items % 2)) { + Perl_croak(aTHX_ "invalid number of arguments"); + } + + timeout = watch->timeout; + + for (i = 1; i < items; i += 2) { + char *key = SvPV_nolen(ST(i)); + + if (strcaseEQ(key, "timeout")) { + timeout = SvUV(ST(i + 1)); + } + } + + gettimeofday(&end_timeval, NULL); + + end_timeval.tv_sec += timeout / 1000; + end_timeval.tv_usec += (timeout % 1000) * 1000; + + wait_timespec.tv_sec = end_timeval.tv_sec; + wait_timespec.tv_nsec = end_timeval.tv_usec * 1000; + + pthread_mutex_lock(&watch->mutex); + + while (!watch->done) { + struct timeval curr_timeval; + + gettimeofday(&curr_timeval, NULL); + + if (end_timeval.tv_sec < curr_timeval.tv_sec || + (end_timeval.tv_sec == curr_timeval.tv_sec && + end_timeval.tv_usec <= curr_timeval.tv_usec)) { + break; + } + + pthread_cond_timedwait(&watch->cond, &watch->mutex, + &wait_timespec); + } + + done = watch->done; + + pthread_mutex_unlock(&watch->mutex); + + if (done) { + XSRETURN_YES; + } + else { + XSRETURN_NO; + } + diff --git a/src/contrib/zkperl/build.xml b/src/contrib/zkperl/build.xml new file mode 100644 index 0000000..0c7207d --- /dev/null +++ b/src/contrib/zkperl/build.xml @@ -0,0 +1,61 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/contrib/zkperl/t/10_invalid.t b/src/contrib/zkperl/t/10_invalid.t new file mode 100644 index 0000000..5e080b6 --- /dev/null +++ b/src/contrib/zkperl/t/10_invalid.t @@ -0,0 +1,773 @@ +# Net::ZooKeeper - Perl extension for Apache ZooKeeper +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +use File::Spec; +use Test::More tests => 107; + +BEGIN { use_ok('Net::ZooKeeper', qw(:all)) }; + + +my $test_dir; +(undef, $test_dir, undef) = File::Spec->splitpath($0); +require File::Spec->catfile($test_dir, 'util.pl'); + +my($hosts, $root_path, $node_path) = zk_test_setup(1); + + +## new() + +eval { + Net::ZooKeeper->new(); +}; +like($@, qr/Usage: Net::ZooKeeper::new\(package, hosts, \.\.\.\)/, + 'new(): no hostname specified'); + +eval { + Net::ZooKeeper->new($hosts, 'bar'); +}; +like($@, qr/invalid number of arguments/, + 'new(): invalid number of arguments'); + +eval { + Net::ZooKeeper->new($hosts, 'session_timeout' => -3); +}; +like($@, qr/invalid session timeout/, + 'new(): invalid session timeout'); + +eval { + Net::ZooKeeper->new($hosts, 'session_timeout' => 0x4000_0000); +}; +like($@, qr/invalid session timeout/, + 'new(): invalid session timeout'); + +eval { + Net::ZooKeeper->new($hosts, 'session_id' => 'abcdef'); +}; +like($@, qr/invalid session ID/, + 'new(): invalid session ID'); + +my $zkh = Net::ZooKeeper->new($hosts); +isa_ok($zkh, 'Net::ZooKeeper', + 'new(): created handle'); + + +## DESTROY() + +eval { + $zkh->DESTROY('foo'); +}; +like($@, qr/Usage: Net::ZooKeeper::DESTROY\(zkh\)/, + 'DESTROY(): too many arguments'); + +my $bad_zkh = {}; +$bad_zkh = bless($bad_zkh, 'Net::ZooKeeper'); + +my $ret = $bad_zkh->DESTROY(); +ok(!$ret, + 'DESTROY(): no action on invalid handle'); + + +## add_auth() + +eval { + $zkh->add_auth(); +}; +like($@, qr/Usage: Net::ZooKeeper::add_auth\(zkh, scheme, cert\)/, + 'add_auth(): no scheme specified'); + +eval { + $zkh->add_auth('foo'); +}; +like($@, qr/Usage: Net::ZooKeeper::add_auth\(zkh, scheme, cert\)/, + 'add_auth(): no certificate specified'); + +eval { + $zkh->add_auth('foo', 'foo', 'bar'); +}; +like($@, qr/Usage: Net::ZooKeeper::add_auth\(zkh, scheme, cert\)/, + 'add_auth(): too many arguments'); + +eval { + $bad_zkh->add_auth('foo', 'foo'); +}; +like($@, qr/invalid handle/, + 'add_auth(): invalid handle'); + +eval { + Net::ZooKeeper::add_auth(1, 'foo', 'foo'); +}; +like($@, qr/zkh is not a hash reference of type Net::ZooKeeper/, + 'add_auth(): invalid hash reference'); + + +## create() + +eval { + $zkh->create(); +}; +like($@, qr/Usage: Net::ZooKeeper::create\(zkh, path, buf, \.\.\.\)/, + 'create(): no path specified'); + +eval { + $zkh->create($node_path); +}; +like($@, qr/Usage: Net::ZooKeeper::create\(zkh, path, buf, \.\.\.\)/, + 'create(): no data buffer specified'); + +eval { + $zkh->create($node_path, 'foo', 'bar'); +}; +like($@, qr/invalid number of arguments/, + 'create(): invalid number of arguments'); + +eval { + $zkh->create($node_path, 'foo', 'path_read_len' => -3); +}; +like($@, qr/invalid path read length/, + 'create(): invalid path read length'); + +eval { + $zkh->create($node_path, 'foo', 'path_read_len' => 1); +}; +like($@, qr/invalid path read length/, + 'create(): invalid path read length'); + +eval { + $zkh->create($node_path, 'foo', 'flags' => 15); +}; +like($@, qr/invalid create flags/, + 'create(): invalid create flags'); + +eval { + $zkh->create($node_path, 'foo', 'flags' => ZOO_EPHEMERAL, 'acl', 'foo'); +}; +like($@, qr/invalid ACL array reference/, + 'create(): invalid ACL array reference'); + +eval { + $zkh->create($node_path, 'foo', 'acl', {}); +}; +like($@, qr/invalid ACL array reference/, + 'create(): invalid ACL array reference to hash'); + +eval { + my @acl = ('foo', 'bar'); + $zkh->create($node_path, 'foo', 'acl', \@acl); +}; +like($@, qr/invalid ACL entry hash reference/, + 'create(): invalid ACL entry hash reference'); + +eval { + my @acl = ({ 'foo' => 'bar' }); + $zkh->create($node_path, 'foo', 'acl', \@acl); +}; +like($@, qr/no ACL entry perms element/, + 'create(): no ACL entry perms element'); + +eval { + my @acl = ( + { + 'perms' => -1 + } + ); + $zkh->create($node_path, 'foo', 'acl', \@acl); +}; +like($@, qr/invalid ACL entry perms/, + 'create(): invalid ACL entry perms'); + +eval { + my @acl = ( + { + 'perms' => ZOO_PERM_ALL + } + ); + $zkh->create($node_path, 'foo', 'acl', \@acl); +}; +like($@, qr/no ACL entry scheme element/, + 'create(): no ACL entry scheme element'); + +eval { + my @acl = ( + { + 'perms' => ZOO_PERM_ALL, + 'scheme' => 'foo' + } + ); + $zkh->create($node_path, 'foo', 'acl', \@acl); +}; +like($@, qr/no ACL entry id element/, + 'create(): no ACL entry id element'); + +eval { + my @acl = ( + { + 'perms' => ZOO_PERM_ALL, + 'scheme' => 'foo', + 'id' => 'bar' + }, + 'bar' + ); + $zkh->create($node_path, 'foo', 'acl', \@acl); +}; +like($@, qr/invalid ACL entry hash reference/, + 'create(): invalid second ACL entry hash reference'); + +eval { + $bad_zkh->create($node_path, 'foo'); +}; +like($@, qr/invalid handle/, + 'create(): invalid handle'); + +eval { + Net::ZooKeeper::create(1, $node_path, 'foo'); +}; +like($@, qr/zkh is not a hash reference of type Net::ZooKeeper/, + 'create(): invalid hash reference'); + + +## delete() + +eval { + $zkh->delete(); +}; +like($@, qr/Usage: Net::ZooKeeper::delete\(zkh, path, \.\.\.\)/, + 'delete(): no path specified'); + +eval { + $zkh->delete($node_path, 'bar'); +}; +like($@, qr/invalid number of arguments/, + 'delete(): invalid number of arguments'); + +eval { + $zkh->delete($node_path, 'version' => -3); +}; +like($@, qr/invalid version requirement/, + 'delete(): invalid version requirement'); + +eval { + $bad_zkh->delete($node_path); +}; +like($@, qr/invalid handle/, + 'delete(): invalid handle'); + +eval { + Net::ZooKeeper::delete(1, $node_path); +}; +like($@, qr/zkh is not a hash reference of type Net::ZooKeeper/, + 'delete(): invalid hash reference'); + + +## exists() + +eval { + $zkh->exists(); +}; +like($@, qr/Usage: Net::ZooKeeper::exists\(zkh, path, \.\.\.\)/, + 'exists(): no path specified'); + +eval { + $zkh->exists($node_path, 'bar'); +}; +like($@, qr/invalid number of arguments/, + 'exists(): invalid number of arguments'); + +eval { + $zkh->exists($node_path, 'watch', 'bar'); +}; +like($@, qr/watch is not a hash reference of type Net::ZooKeeper::Watch/, + 'exists(): invalid watch hash reference'); + +eval { + $zkh->exists($node_path, 'watch', []); +}; +like($@, qr/watch is not a hash reference of type Net::ZooKeeper::Watch/, + 'exists(): invalid watch hash reference to array'); + +eval { + $zkh->exists($node_path, 'stat', 'bar'); +}; +like($@, qr/stat is not a hash reference of type Net::ZooKeeper::Stat/, + 'exists(): invalid stat hash reference'); + +eval { + $zkh->exists($node_path, 'stat', []); +}; +like($@, qr/stat is not a hash reference of type Net::ZooKeeper::Stat/, + 'exists(): invalid stat hash reference'); + +eval { + $bad_zkh->exists($node_path); +}; +like($@, qr/invalid handle/, + 'exists(): invalid handle'); + +eval { + Net::ZooKeeper::exists(1, $node_path); +}; +like($@, qr/zkh is not a hash reference of type Net::ZooKeeper/, + 'exists(): invalid hash reference'); + + +## get_children() + +eval { + $zkh->get_children(); +}; +like($@, qr/Usage: Net::ZooKeeper::get_children\(zkh, path, \.\.\.\)/, + 'get_children(): no path specified'); + +eval { + $zkh->get_children($node_path, 'bar'); +}; +like($@, qr/invalid number of arguments/, + 'get_children(): invalid number of arguments'); + +eval { + $zkh->get_children($node_path, 'watch', 'bar'); +}; +like($@, qr/watch is not a hash reference of type Net::ZooKeeper::Watch/, + 'get_children(): invalid watch hash reference'); + +eval { + $zkh->get_children($node_path, 'watch', []); +}; +like($@, qr/watch is not a hash reference of type Net::ZooKeeper::Watch/, + 'get_children(): invalid watch ash reference to array'); + +eval { + $bad_zkh->get_children($node_path); +}; +like($@, qr/invalid handle/, + 'get_children(): invalid handle'); + +eval { + Net::ZooKeeper::get_children(1, $node_path); +}; +like($@, qr/zkh is not a hash reference of type Net::ZooKeeper/, + 'get_children(): invalid hash reference'); + + +## get() + +eval { + $zkh->get(); +}; +like($@, qr/Usage: Net::ZooKeeper::get\(zkh, path, \.\.\.\)/, + 'get(): no path specified'); + +eval { + $zkh->get($node_path, 'bar'); +}; +like($@, qr/invalid number of arguments/, + 'get(): invalid number of arguments'); + +eval { + $zkh->get($node_path, 'data_read_len' => -3); +}; +like($@, qr/invalid data read length/, + 'get(): invalid data read length'); + +eval { + $zkh->get($node_path, 'data_read_len' => 10, 'watch', 'bar'); +}; +like($@, qr/watch is not a hash reference of type Net::ZooKeeper::Watch/, + 'get(): invalid watch hash reference'); + +eval { + $zkh->get($node_path, 'watch', []); +}; +like($@, qr/watch is not a hash reference of type Net::ZooKeeper::Watch/, + 'get(): invalid watch hash reference to array'); + +eval { + $zkh->get($node_path, 'stat', 'bar'); +}; +like($@, qr/stat is not a hash reference of type Net::ZooKeeper::Stat/, + 'get(): invalid stat hash reference'); + +eval { + $zkh->get($node_path, 'stat', []); +}; +like($@, qr/stat is not a hash reference of type Net::ZooKeeper::Stat/, + 'get(): invalid stat hash reference'); + +eval { + $bad_zkh->get($node_path); +}; +like($@, qr/invalid handle/, + 'get(): invalid handle'); + +eval { + Net::ZooKeeper::get(1, $node_path); +}; +like($@, qr/zkh is not a hash reference of type Net::ZooKeeper/, + 'get(): invalid hash reference'); + + +## set() + +eval { + $zkh->set(); +}; +like($@, qr/Usage: Net::ZooKeeper::set\(zkh, path, buf, \.\.\.\)/, + 'set(): no path specified'); + +eval { + $zkh->set($node_path); +}; +like($@, qr/Usage: Net::ZooKeeper::set\(zkh, path, buf, \.\.\.\)/, + 'set(): no data buffer specified'); + +eval { + $zkh->set($node_path, 'foo', 'bar'); +}; +like($@, qr/invalid number of arguments/, + 'set(): invalid number of arguments'); + +eval { + $zkh->set($node_path, 'foo', 'version' => -3); +}; +like($@, qr/invalid version requirement/, + 'set(): invalid version requirement'); + +eval { + $zkh->set($node_path, 'foo', 'version', 0, 'stat', 'bar'); +}; +like($@, qr/stat is not a hash reference of type Net::ZooKeeper::Stat/, + 'set(): invalid stat hash reference'); + +eval { + $zkh->set($node_path, 'foo', 'stat', []); +}; +like($@, qr/stat is not a hash reference of type Net::ZooKeeper::Stat/, + 'set(): invalid stat hash reference'); + +eval { + $bad_zkh->set($node_path, 'foo'); +}; +like($@, qr/invalid handle/, + 'set(): invalid handle'); + +eval { + Net::ZooKeeper::set(1, $node_path, 'foo'); +}; +like($@, qr/zkh is not a hash reference of type Net::ZooKeeper/, + 'set(): invalid hash reference'); + + +## get_acl() + +eval { + $zkh->get_acl(); +}; +like($@, qr/Usage: Net::ZooKeeper::get_acl\(zkh, path, \.\.\.\)/, + 'get_acl(): no path specified'); + +eval { + $zkh->get_acl($node_path, 'bar'); +}; +like($@, qr/invalid number of arguments/, + 'get_acl(): invalid number of arguments'); + +eval { + $zkh->get_acl($node_path, 'stat', 'bar'); +}; +like($@, qr/stat is not a hash reference of type Net::ZooKeeper::Stat/, + 'get_acl(): invalid stat hash reference'); + +eval { + $zkh->get_acl($node_path, 'stat', []); +}; +like($@, qr/stat is not a hash reference of type Net::ZooKeeper::Stat/, + 'get_acl(): invalid stat hash reference'); + +eval { + $bad_zkh->get_acl($node_path); +}; +like($@, qr/invalid handle/, + 'get_acl(): invalid handle'); + +eval { + Net::ZooKeeper::get_acl(1, $node_path); +}; +like($@, qr/zkh is not a hash reference of type Net::ZooKeeper/, + 'get_acl(): invalid hash reference'); + + +## set_acl() + +eval { + $zkh->set_acl(); +}; +like($@, qr/Usage: Net::ZooKeeper::set_acl\(zkh, path, acl_arr, \.\.\.\)/, + 'set_acl(): no path specified'); + +eval { + $zkh->set_acl($node_path); +}; +like($@, qr/Usage: Net::ZooKeeper::set_acl\(zkh, path, acl_arr, \.\.\.\)/, + 'set_acl(): no data buffer specified'); + +eval { + $zkh->set_acl($node_path, 'foo'); +}; +like($@, qr/acl_arr is not an array reference/, + 'set_acl(): invalid ACL array reference'); + +eval { + $zkh->set_acl($node_path, {}); +}; +like($@, qr/acl_arr is not an array reference/, + 'set_acl(): invalid ACL array reference to hash'); + +eval { + my @acl = ('foo', 'bar'); + $zkh->set_acl($node_path, \@acl); +}; +like($@, qr/invalid ACL entry hash reference/, + 'set_acl(): invalid ACL entry hash reference'); + +eval { + my @acl = ({ 'foo' => 'bar' }); + $zkh->set_acl($node_path, \@acl); +}; +like($@, qr/no ACL entry perms element/, + 'set_acl(): no ACL entry perms element'); + +eval { + my @acl = ( + { + 'perms' => -1 + } + ); + $zkh->set_acl($node_path, \@acl); +}; +like($@, qr/invalid ACL entry perms/, + 'set_acl(): invalid ACL entry perms'); + +eval { + my @acl = ( + { + 'perms' => ZOO_PERM_ALL + } + ); + $zkh->set_acl($node_path, \@acl); +}; +like($@, qr/no ACL entry scheme element/, + 'set_acl(): no ACL entry scheme element'); + +eval { + my @acl = ( + { + 'perms' => ZOO_PERM_ALL, + 'scheme' => 'foo' + } + ); + $zkh->set_acl($node_path, \@acl); +}; +like($@, qr/no ACL entry id element/, + 'set_acl(): no ACL entry id element'); + +eval { + my @acl = ( + { + 'perms' => ZOO_PERM_ALL, + 'scheme' => 'foo', + 'id' => 'bar' + }, + 'bar' + ); + $zkh->set_acl($node_path, \@acl); +}; +like($@, qr/invalid ACL entry hash reference/, + 'set_acl(): invalid second ACL entry hash reference'); + +eval { + $zkh->set_acl($node_path, [], 'bar'); +}; +like($@, qr/invalid number of arguments/, + 'set_acl(): invalid number of arguments'); + +eval { + $zkh->set_acl($node_path, [], 'version' => -3); +}; +like($@, qr/invalid version requirement/, + 'set_acl(): invalid version requirement'); + +eval { + $bad_zkh->set_acl($node_path, []); +}; +like($@, qr/invalid handle/, + 'set_acl(): invalid handle'); + +eval { + Net::ZooKeeper::set_acl(1, $node_path, []); +}; +like($@, qr/zkh is not a hash reference of type Net::ZooKeeper/, + 'set_acl(): invalid hash reference'); + + +## stat() + +eval { + $zkh->stat('bar'); +}; +like($@, qr/Usage: Net::ZooKeeper::stat\(zkh\)/, + 'stat(): too many arguments'); + +eval { + $bad_zkh->stat(); +}; +like($@, qr/invalid handle/, + 'stat(): invalid handle'); + +eval { + Net::ZooKeeper::stat(1); +}; +like($@, qr/zkh is not a hash reference of type Net::ZooKeeper/, + 'stat(): invalid hash reference'); + +my $stat = $zkh->stat(); +isa_ok($stat, 'Net::ZooKeeper::Stat', + 'stat(): created stat handle'); + + +## stat DESTROY() + +eval { + $stat->DESTROY('foo'); +}; +like($@, qr/Usage: Net::ZooKeeper::Stat::DESTROY\(zksh\)/, + 'stat DESTROY(): too many arguments'); + +my $bad_stat = {}; +$bad_stat = bless($bad_stat, 'Net::ZooKeeper::Stat'); + +$ret = $bad_stat->DESTROY(); +ok(!$ret, + 'stat DESTROY(): no action on invalid handle'); + + +## watch() + +eval { + $zkh->watch('bar'); +}; +like($@, qr/invalid number of arguments/, + 'watch(): invalid number of arguments'); + +eval { + $bad_zkh->watch(); +}; +like($@, qr/invalid handle/, + 'watch(): invalid handle'); + +eval { + Net::ZooKeeper::watch(1); +}; +like($@, qr/zkh is not a hash reference of type Net::ZooKeeper/, + 'watch(): invalid hash reference'); + +my $watch = $zkh->watch(); +isa_ok($watch, 'Net::ZooKeeper::Watch', + 'watch(): created watch handle'); + + +## watch DESTROY() + +eval { + $watch->DESTROY('foo'); +}; +like($@, qr/Usage: Net::ZooKeeper::Watch::DESTROY\(zkwh\)/, + 'watch DESTROY(): too many arguments'); + +my $bad_watch = {}; +$bad_watch = bless($bad_watch, 'Net::ZooKeeper::Watch'); + +$ret = $bad_watch->DESTROY(); +ok(!$ret, + 'watch DESTROY(): no action on invalid handle'); + + +## wait() + +eval { + $watch->wait('bar'); +}; +like($@, qr/invalid number of arguments/, + 'wait(): invalid number of arguments'); + +eval { + $bad_watch->wait(); +}; +like($@, qr/invalid handle/, + 'wait(): invalid watch handle'); + +eval { + Net::ZooKeeper::Watch::wait(1); +}; +like($@, qr/zkwh is not a hash reference of type Net::ZooKeeper::Watch/, + 'wait(): invalid watch hash reference'); + + +## set_log_level() + +eval { + my $f = \&Net::ZooKeeper::set_log_level; + &$f(); +}; +like($@, qr/Usage: Net::ZooKeeper::set_log_level\(level\)/, + 'set_log_level(): no level specified'); + +eval { + my $f = \&Net::ZooKeeper::set_log_level; + &$f(ZOO_LOG_LEVEL_OFF, 'foo'); +}; +like($@, qr/Usage: Net::ZooKeeper::set_log_level\(level\)/, + 'set_log_level(): too many arguments'); + +eval { + Net::ZooKeeper::set_log_level((ZOO_LOG_LEVEL_OFF) - 1); +}; +like($@, qr/invalid log level/, + 'set_log_level(): invalid low log level'); + +eval { + Net::ZooKeeper::set_log_level((ZOO_LOG_LEVEL_DEBUG) + 1); +}; +like($@, qr/invalid log level/, + 'set_log_level(): invalid high log level'); + + +## set_deterministic_conn_order() + +eval { + my $f = \&Net::ZooKeeper::set_deterministic_conn_order; + &$f(); +}; +like($@, qr/Usage: Net::ZooKeeper::set_deterministic_conn_order\(flag\)/, + 'set_deterministic_conn_order(): no flag specified'); + +eval { + my $f = \&Net::ZooKeeper::set_deterministic_conn_order; + &$f(1, 'foo'); +}; +like($@, qr/Usage: Net::ZooKeeper::set_deterministic_conn_order\(flag\)/, + 'set_deterministic_conn_order(): too many arguments'); + diff --git a/src/contrib/zkperl/t/15_thread.t b/src/contrib/zkperl/t/15_thread.t new file mode 100644 index 0000000..1ef56d0 --- /dev/null +++ b/src/contrib/zkperl/t/15_thread.t @@ -0,0 +1,121 @@ +# Net::ZooKeeper - Perl extension for Apache ZooKeeper +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +use Config; +use File::Spec; +use Test::More; + +BEGIN { + if ($Config{'useithreads'}) { + plan tests => 10; + } + else { + plan skip_all => 'no thread support'; + } +} + +use threads; + +BEGIN { use_ok('Net::ZooKeeper', qw(:all)) }; + + +my $test_dir; +(undef, $test_dir, undef) = File::Spec->splitpath($0); +require File::Spec->catfile($test_dir, 'util.pl'); + +my($hosts, $root_path, $node_path) = zk_test_setup(0); + + +my $zkh = Net::ZooKeeper->new($hosts); + +SKIP: { + skip 'no valid handle', 9 unless (defined($zkh)); + + my($thread) = threads->new(\&thread_test, $zkh); + + SKIP: { + skip 'no valid thread', 3 unless (defined($thread)); + + my(@ret) = $thread->join; + + ok((@ret == 3 and $ret[0]), + 'CLONE_SKIP(): handle reference after spawning thread'); + + ok((@ret == 3 and $ret[1]), + 'CLONE_SKIP(): scalar handle reference after spawning thread'); + + ok((@ret == 3 and $ret[2]), + 'CLONE_SKIP(): undef handle reference after spawning thread'); + } + + my $stat = $zkh->stat(); + + ($thread) = threads->new(\&thread_test, $stat); + + SKIP: { + skip 'no valid thread', 3 unless (defined($thread)); + + my(@ret) = $thread->join; + + ok((@ret == 3 and $ret[0]), + 'stat CLONE_SKIP(): stat handle reference after spawning thread'); + + ok((@ret == 3 and $ret[1]), + 'stat CLONE_SKIP(): scalar stat handle reference after ' . + 'spawning thread'); + + ok((@ret == 3 and $ret[2]), + 'stat CLONE_SKIP(): undef stat handle reference after ' . + 'spawning thread'); + } + + my $watch = $zkh->watch(); + + ($thread) = threads->new(\&thread_test, $watch); + + SKIP: { + skip 'no valid thread', 3 unless (defined($thread)); + + my(@ret) = $thread->join; + + ok((@ret == 3 and $ret[0]), + 'watch CLONE_SKIP(): watch handle reference after spawning thread'); + + ok((@ret == 3 and $ret[1]), + 'watch CLONE_SKIP(): scalar watch handle reference after ' . + 'spawning thread'); + + ok((@ret == 3 and $ret[2]), + 'watch CLONE_SKIP(): undef watch handle reference after ' . + 'spawning thread'); + } +} + +sub thread_test +{ + my $zkh = shift; + + my @ret; + + $ret[0] = ref($zkh) ? 1 : 0; + $ret[1] = ($ret[0] and ref($zkh) eq 'SCALAR') ? 1 : 0; + $ret[2] = ($ret[1] and !defined(${$zkh})) ? 1 : 0; + + return @ret; +} + diff --git a/src/contrib/zkperl/t/20_tie.t b/src/contrib/zkperl/t/20_tie.t new file mode 100644 index 0000000..37e9a4f --- /dev/null +++ b/src/contrib/zkperl/t/20_tie.t @@ -0,0 +1,353 @@ +# Net::ZooKeeper - Perl extension for Apache ZooKeeper +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +use File::Spec; +use Test::More tests => 54; + +BEGIN { use_ok('Net::ZooKeeper', qw(:all)) }; + + +my $test_dir; +(undef, $test_dir, undef) = File::Spec->splitpath($0); +require File::Spec->catfile($test_dir, 'util.pl'); + +my($hosts, $root_path, $node_path) = zk_test_setup(0); + + +SKIP: { + my $zkh = Net::ZooKeeper->new($hosts); + + skip 'no valid handle', 4 unless (defined($zkh)); + + + ## DESTROY() + + my $attr = tied(%{$zkh}); + + my $ret = $attr->DESTROY(); + ok($ret, + 'DESTROY(): destroyed inner hash'); + + $ret = $attr->DESTROY(); + ok(!$ret, + 'DESTROY(): no action on destroyed inner hash'); + + $ret = $zkh->DESTROY(); + ok(!$ret, + 'DESTROY(): no action on handle with destroyed inner hash'); + + undef $zkh; + ok(!defined($zkh), + 'undef: released handle with destroyed inner hash'); +} + +SKIP: { + my $zkh = Net::ZooKeeper->new($hosts); + + skip 'no valid handle', 49 unless (defined($zkh)); + + + ## TIEHASH(), UNTIE() + + eval { + tie(%{$zkh}, 'Net::ZooKeeper'); + }; + like($@, qr/tying hashes of class Net::ZooKeeper not supported/, + 'tie(): tying hashes not supported'); + + eval { + Net::ZooKeeper::TIEHASH('Net::ZooKeeper'); + }; + like($@, qr/tying hashes of class Net::ZooKeeper not supported/, + 'TIEHASH(): tying hashes not supported'); + + eval { + untie(%{$zkh}); + }; + like($@, qr/untying hashes of class Net::ZooKeeper not supported/, + 'untie(): untying hashes not supported'); + + my $attr = tied(%{$zkh}); + + eval { + $attr->UNTIE(0); + }; + like($@, qr/untying hashes of class Net::ZooKeeper not supported/, + 'UNTIE(): untying hashes not supported'); + + + ## FIRSTKEY(), NEXTKEY(), SCALAR() + + my $copy_zkh; + { + my %copy_zkh = %{$zkh}; + $copy_zkh = \%copy_zkh; + } + bless($copy_zkh, 'Net::ZooKeeper'); + is(ref($copy_zkh), 'Net::ZooKeeper', + 'FIRSTKEY(), NEXTKEY(): copied dereferenced handle'); + + eval { + my $val = $copy_zkh->FIRSTKEY(); + }; + like($@, qr/invalid handle/, + 'FETCHKEY(): invalid handle'); + + eval { + my $val = $copy_zkh->NEXTKEY('data_read_len'); + }; + like($@, qr/invalid handle/, + 'NEXTKEY(): invalid handle'); + + my @keys = keys(%{$zkh}); + is(scalar(@keys), 7, + 'keys(): count of keys from handle'); + + @keys = keys(%{$copy_zkh}); + is(scalar(@keys), 7, + 'keys(): count of keys from copied dereferenced handle'); + + is($attr->FIRSTKEY(), 'data_read_len', + 'FIRSTKEY(): retrieved first key using inner hash'); + + is($attr->NEXTKEY('session_id'), 'pending_watches', + 'NEXTKEY(): retrieved last key using inner hash'); + + is($attr->NEXTKEY('pending_watches'), undef, + 'NEXTKEY(): undef returned after last key using inner hash'); + + ok(scalar(%{$zkh}), + 'scalar(): true value returned for dereferenced handle'); + + ok($zkh->SCALAR(), + 'SCALAR(): true value returned'); + + + ## FETCH() + + eval { + my $val = $copy_zkh->FETCH('data_read_len'); + }; + like($@, qr/invalid handle/, + 'FETCH(): invalid handle'); + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + my $val = $zkh->{'foo'}; + ok(!defined($val), + 'FETCH(): undef returned for invalid element'); + + like($msg, qr/invalid element/, + 'FETCH(): invalid element'); + } + + is($zkh->{'data_read_len'}, 1023, + 'FETCH(): default data read length'); + + is($zkh->{'path_read_len'}, 1023, + 'FETCH(): default path read length'); + + is($zkh->{'hosts'}, $hosts, + 'FETCH(): server hosts'); + + is($zkh->{'session_timeout'}, 10000, + 'FETCH(): default session timeout'); + + ok(defined($zkh->{'session_id'}), + 'FETCH(): session ID'); + + SKIP: { + my $zkh = Net::ZooKeeper->new('0.0.0.0:0'); + + skip 'no valid handle with invalid host', 1 unless (defined($zkh)); + + is($zkh->{'session_id'}, '', + 'FETCH(): empty session ID with invalid host'); + } + + is($zkh->{'pending_watches'}, 0, + 'FETCH(): default pending watch list length'); + + is($attr->FETCH('data_read_len'), 1023, + 'FETCH(): default data read length using inner hash'); + + + ## STORE() + + eval { + my $val = $copy_zkh->STORE('data_read_len', 'foo'); + }; + like($@, qr/invalid handle/, + 'STORE(): invalid handle'); + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + $zkh->{'foo'} = 'foo'; + like($msg, qr/invalid element/, + 'STORE(): invalid element'); + } + + eval { + $zkh->{'data_read_len'} = -3; + }; + like($@, qr/invalid data read length/, + 'STORE(): invalid data read length'); + + eval { + $zkh->{'path_read_len'} = -3; + }; + like($@, qr/invalid path read length/, + 'STORE(): invalid path read length'); + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + $zkh->{'hosts'} = 'foo'; + like($msg, qr/read-only element: hosts/, + 'STORE(): read-only server hosts element'); + } + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + $zkh->{'session_timeout'} = 0; + like($msg, qr/read-only element: session_timeout/, + 'STORE(): read-only session timeout element'); + } + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + $zkh->{'session_id'} = 'foo'; + like($msg, qr/read-only element: session_id/, + 'STORE(): read-only session ID element'); + } + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + $zkh->{'pending_watches'} = 0; + like($msg, qr/read-only element: pending_watches/, + 'STORE(): read-only pending watch list length element'); + } + + $zkh->{'data_read_len'} = 200; + is($zkh->{'data_read_len'}, 200, + 'STORE(): updated data read length'); + + $zkh->{'path_read_len'} = 100; + is($zkh->{'path_read_len'}, 100, + 'STORE(): updated path read length'); + + $attr->STORE('data_read_len', 100); + is($zkh->{'data_read_len'}, 100, + 'STORE(): updated data read length using inner hash'); + + + ## EXISTS() + + eval { + my $val = $copy_zkh->EXISTS('data_read_len'); + }; + like($@, qr/invalid handle/, + 'EXISTS(): invalid handle'); + + ok(!exists($zkh->{'foo'}), + 'exists(): invalid element of handle'); + + ok(exists($zkh->{'data_read_len'}), + 'exists(): data read length'); + + ok(exists($zkh->{'path_read_len'}), + 'exists(): path read length'); + + ok(exists($zkh->{'hosts'}), + 'exists(): server hosts'); + + ok(exists($zkh->{'session_timeout'}), + 'exists(): session timeout'); + + ok(exists($zkh->{'session_id'}), + 'exists(): session ID'); + + ok(exists($zkh->{'pending_watches'}), + 'exists(): pending watch list length'); + + ok($attr->EXISTS('data_read_len'), + 'EXISTS(): data read length using inner hash'); + + + ## DELETE(), CLEAR() + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + delete($zkh->{'data_read_len'}); + like($msg, + qr/deleting elements from hashes of class Net::ZooKeeper not supported/, + 'delete(): deleting hash elements not supported'); + } + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + $zkh->DELETE({'data_read_len'}); + like($msg, + qr/deleting elements from hashes of class Net::ZooKeeper not supported/, + 'DELETE(): deleting hash elements not supported'); + } + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + %{$zkh} = (); + like($msg, qr/clearing hashes of class Net::ZooKeeper not supported/, + 'assign: clearing hashes not supported'); + } + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + $zkh->CLEAR(); + like($msg, qr/clearing hashes of class Net::ZooKeeper not supported/, + 'CLEAR(): clearing hashes not supported'); + } +} + diff --git a/src/contrib/zkperl/t/22_stat_tie.t b/src/contrib/zkperl/t/22_stat_tie.t new file mode 100644 index 0000000..02e7913 --- /dev/null +++ b/src/contrib/zkperl/t/22_stat_tie.t @@ -0,0 +1,438 @@ +# Net::ZooKeeper - Perl extension for Apache ZooKeeper +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +use File::Spec; +use Test::More tests => 66; + +BEGIN { use_ok('Net::ZooKeeper', qw(:all)) }; + + +my $test_dir; +(undef, $test_dir, undef) = File::Spec->splitpath($0); +require File::Spec->catfile($test_dir, 'util.pl'); + +my($hosts, $root_path, $node_path) = zk_test_setup(0); + + +SKIP: { + my $zkh = Net::ZooKeeper->new($hosts); + my $stat = $zkh->stat() if (defined($zkh)); + + skip 'no valid stat handle', 4 unless (defined($stat)); + + + ## DESTROY() + + my $attr = tied(%{$stat}); + + my $ret = $attr->DESTROY(); + ok($ret, + 'stat DESTROY(): destroyed inner stat hash'); + + $ret = $attr->DESTROY(); + ok(!$ret, + 'stat DESTROY(): no action on destroyed inner stat hash'); + + $ret = $stat->DESTROY(); + ok(!$ret, + 'stat DESTROY(): no action on stat handle with destroyed inner hash'); + + undef $stat; + ok(!defined($stat), + 'undef: released stat handle with destroyed inner hash'); +} + +SKIP: { + my $zkh = Net::ZooKeeper->new($hosts); + my $stat = $zkh->stat() if (defined($zkh)); + + skip 'no valid stat handle', 61 unless (defined($stat)); + + + ## TIEHASH(), UNTIE() + + eval { + tie(%{$stat}, 'Net::ZooKeeper::Stat'); + }; + like($@, qr/tying hashes of class Net::ZooKeeper::Stat not supported/, + 'tie(): tying stat hashes not supported'); + + eval { + Net::ZooKeeper::Stat::TIEHASH('Net::ZooKeeper::Stat'); + }; + like($@, qr/tying hashes of class Net::ZooKeeper::Stat not supported/, + 'stat TIEHASH(): tying stat hashes not supported'); + + eval { + untie(%{$stat}); + }; + like($@, qr/untying hashes of class Net::ZooKeeper::Stat not supported/, + 'untie(): untying stat hashes not supported'); + + my $attr = tied(%{$stat}); + + eval { + $attr->UNTIE(0); + }; + like($@, qr/untying hashes of class Net::ZooKeeper::Stat not supported/, + 'stat UNTIE(): untying stat hashes not supported'); + + + ## FIRSTKEY(), NEXTKEY(), SCALAR() + + my $copy_stat; + { + my %copy_stat = %{$stat}; + $copy_stat = \%copy_stat; + } + bless($copy_stat, 'Net::ZooKeeper::Stat'); + is(ref($copy_stat), 'Net::ZooKeeper::Stat', + 'stat FIRSTKEY(), NEXTKEY(): copied dereferenced stat handle'); + + eval { + my $val = $copy_stat->FIRSTKEY(); + }; + like($@, qr/invalid handle/, + 'stat FETCHKEY(): invalid stat handle'); + + eval { + my $val = $copy_stat->NEXTKEY('czxid'); + }; + like($@, qr/invalid handle/, + 'stat NEXTKEY(): invalid stat handle'); + + my @keys = keys(%{$stat}); + is(scalar(@keys), 11, + 'keys(): count of keys from stat handle'); + + @keys = keys(%{$copy_stat}); + is(scalar(@keys), 11, + 'keys(): count of keys from copied dereferenced stat handle'); + + is($attr->FIRSTKEY(), 'czxid', + 'stat FIRSTKEY(): retrieved first key using inner stat hash'); + + is($attr->NEXTKEY('num_children'), 'children_zxid', + 'stat NEXTKEY(): retrieved last key using inner stat hash'); + + is($attr->NEXTKEY('children_zxid'), undef, + 'NEXTKEY(): undef returned after last key using inner stat hash'); + + ok(scalar(%{$stat}), + 'scalar(): true value returned for dereferenced stat handle'); + + ok($stat->SCALAR(), + 'stat SCALAR(): true value returned'); + + + ## FETCH() + + eval { + my $val = $copy_stat->FETCH('version'); + }; + like($@, qr/invalid handle/, + 'stat FETCH(): invalid stat handle'); + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + my $val = $stat->{'foo'}; + ok(!defined($val), + 'stat FETCH(): undef returned for invalid element'); + + like($msg, qr/invalid element/, + 'stat FETCH(): invalid element'); + } + + is($stat->{'czxid'}, 0, + 'stat FETCH(): default node creation ZooKeeper transaction ID'); + + is($stat->{'mzxid'}, 0, + 'stat FETCH(): default data last-modified ZooKeeper transaction ID'); + + is($stat->{'ctime'}, 0, + 'stat FETCH(): default node creation time'); + + is($stat->{'mtime'}, 0, + 'stat FETCH(): default data last-modified time'); + + is($stat->{'version'}, 0, + 'stat FETCH(): default data version'); + + is($stat->{'children_version'}, 0, + 'stat FETCH(): default child node list version'); + + is($stat->{'acl_version'}, 0, + 'stat FETCH(): default ACL version'); + + is($stat->{'ephemeral_owner'}, 0, + 'stat FETCH(): ephemeral node owner session ID'); + + is($stat->{'data_len'}, 0, + 'stat FETCH(): default data length'); + + is($stat->{'num_children'}, 0, + 'stat FETCH(): default child node list length'); + + is($stat->{'children_zxid'}, 0, + 'stat FETCH(): default child node list last-modified ' . + 'ZooKeeper transaction ID'); + + is($attr->FETCH('version'), 0, + 'stat FETCH(): default data version using inner stat hash'); + + + ## STORE() + + eval { + my $val = $copy_stat->STORE('version', 'foo'); + }; + like($@, qr/invalid handle/, + 'stat STORE(): invalid stat handle'); + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + $stat->{'foo'} = 'foo'; + like($msg, qr/invalid element/, + 'stat STORE(): invalid element'); + } + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + $stat->{'czxid'} = 'foo'; + like($msg, qr/read-only element: czxid/, + 'stat STORE(): read-only node creation ' . + 'ZooKeeper transaction ID element'); + } + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + $stat->{'mzxid'} = 'foo'; + like($msg, qr/read-only element: mzxid/, + 'stat STORE(): read-only data last-modified ' . + 'ZooKeeper transaction ID element'); + } + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + $stat->{'ctime'} = 'foo'; + like($msg, qr/read-only element: ctime/, + 'stat STORE(): read-only node creation time element'); + } + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + $stat->{'mtime'} = 'foo'; + like($msg, qr/read-only element: mtime/, + 'stat STORE(): read-only data last-modified time element'); + } + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + $stat->{'version'} = 'foo'; + like($msg, qr/read-only element: version/, + 'stat STORE(): read-only data version element'); + } + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + $stat->{'children_version'} = 'foo'; + like($msg, qr/read-only element: children_version/, + 'stat STORE(): read-only child node list version element'); + } + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + $stat->{'acl_version'} = 'foo'; + like($msg, qr/read-only element: acl_version/, + 'stat STORE(): read-only ACL version element'); + } + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + $stat->{'ephemeral_owner'} = 'foo'; + like($msg, qr/read-only element: ephemeral_owner/, + 'stat STORE(): read-only ephemeral node owner ' . + 'session ID element'); + } + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + $stat->{'data_len'} = 'foo'; + like($msg, qr/read-only element: data_len/, + 'stat STORE(): read-only data length element'); + } + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + $stat->{'num_children'} = 'foo'; + like($msg, qr/read-only element: num_children/, + 'stat STORE(): read-only child node list length element'); + } + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + $stat->{'children_zxid'} = 'foo'; + like($msg, qr/read-only element: children_zxid/, + 'stat STORE(): read-only child node list last-modified ' . + 'ZooKeeper transaction ID element'); + } + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + $attr->STORE('version', 'foo'); + like($msg, qr/read-only element: version/, + 'stat STORE(): read-only data version element using ' . + 'inner stat hash'); + } + + + ## EXISTS() + + eval { + my $val = $copy_stat->EXISTS('version'); + }; + like($@, qr/invalid handle/, + 'stat EXISTS(): invalid stat handle'); + + ok(!exists($stat->{'foo'}), + 'exists(): invalid element of stat handle'); + + ok(exists($stat->{'czxid'}), + 'exists(): node creation ZooKeeper transaction ID'); + + ok(exists($stat->{'mzxid'}), + 'exists(): data last-modified ZooKeeper transaction ID'); + + ok(exists($stat->{'ctime'}), + 'exists(): node creation time'); + + ok(exists($stat->{'mtime'}), + 'exists(): data last-modified time'); + + ok(exists($stat->{'version'}), + 'exists(): data version'); + + ok(exists($stat->{'children_version'}), + 'exists(): child node list version'); + + ok(exists($stat->{'acl_version'}), + 'exists(): ACL version'); + + ok(exists($stat->{'ephemeral_owner'}), + 'exists(): ephemeral node owner session ID'); + + ok(exists($stat->{'data_len'}), + 'exists(): data length'); + + ok(exists($stat->{'num_children'}), + 'exists(): child node list length'); + + ok(exists($stat->{'children_zxid'}), + 'exists(): child node list last-modified ZooKeeper transaction ID'); + + ok($attr->EXISTS('version'), + 'stat EXISTS(): data version using inner stat hash'); + + + ## DELETE(), CLEAR() + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + delete($stat->{'version'}); + like($msg, + qr/deleting elements from hashes of class Net::ZooKeeper::Stat not supported/, + 'delete(): deleting stat hash elements not supported'); + } + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + $stat->DELETE({'version'}); + like($msg, + qr/deleting elements from hashes of class Net::ZooKeeper::Stat not supported/, + 'stat DELETE(): deleting stat hash elements not supported'); + } + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + %{$stat} = (); + like($msg, qr/clearing hashes of class Net::ZooKeeper::Stat not supported/, + 'assign: clearing stat hashes not supported'); + } + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + $stat->CLEAR(); + like($msg, qr/clearing hashes of class Net::ZooKeeper::Stat not supported/, + 'stat CLEAR(): clearing stat hashes not supported'); + } +} + diff --git a/src/contrib/zkperl/t/24_watch_tie.t b/src/contrib/zkperl/t/24_watch_tie.t new file mode 100644 index 0000000..e77879e --- /dev/null +++ b/src/contrib/zkperl/t/24_watch_tie.t @@ -0,0 +1,292 @@ +# Net::ZooKeeper - Perl extension for Apache ZooKeeper +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +use File::Spec; +use Test::More tests => 42; + +BEGIN { use_ok('Net::ZooKeeper', qw(:all)) }; + + +my $test_dir; +(undef, $test_dir, undef) = File::Spec->splitpath($0); +require File::Spec->catfile($test_dir, 'util.pl'); + +my($hosts, $root_path, $node_path) = zk_test_setup(0); + + +SKIP: { + my $zkh = Net::ZooKeeper->new($hosts); + my $watch = $zkh->watch() if (defined($zkh)); + + skip 'no valid watch handle', 4 unless (defined($watch)); + + + ## DESTROY() + + my $attr = tied(%{$watch}); + + my $ret = $attr->DESTROY(); + ok($ret, + 'watch DESTROY(): destroyed inner watch hash'); + + $ret = $attr->DESTROY(); + ok(!$ret, + 'watch DESTROY(): no action on destroyed inner watch hash'); + + $ret = $watch->DESTROY(); + ok(!$ret, + 'watch DESTROY(): no action on watch handle with destroyed inner hash'); + + undef $watch; + ok(!defined($watch), + 'undef: released watch handle with destroyed inner hash'); +} + +SKIP: { + my $zkh = Net::ZooKeeper->new($hosts); + my $watch = $zkh->watch() if (defined($zkh)); + + skip 'no valid watch handle', 37 unless (defined($watch)); + + + ## TIEHASH(), UNTIE() + + eval { + tie(%{$watch}, 'Net::ZooKeeper::Watch'); + }; + like($@, qr/tying hashes of class Net::ZooKeeper::Watch not supported/, + 'tie(): tying watch hashes not supported'); + + eval { + Net::ZooKeeper::Watch::TIEHASH('Net::ZooKeeper::Watch'); + }; + like($@, qr/tying hashes of class Net::ZooKeeper::Watch not supported/, + 'watch TIEHASH(): tying watch hashes not supported'); + + eval { + untie(%{$watch}); + }; + like($@, qr/untying hashes of class Net::ZooKeeper::Watch not supported/, + 'untie(): untying watch hashes not supported'); + + my $attr = tied(%{$watch}); + + eval { + $attr->UNTIE(0); + }; + like($@, qr/untying hashes of class Net::ZooKeeper::Watch not supported/, + 'watch UNTIE(): untying watch hashes not supported'); + + + ## FIRSTKEY(), NEXTKEY(), SCALAR() + + my $copy_watch; + { + my %copy_watch = %{$watch}; + $copy_watch = \%copy_watch; + } + bless($copy_watch, 'Net::ZooKeeper::Watch'); + is(ref($copy_watch), 'Net::ZooKeeper::Watch', + 'watch FIRSTKEY(), NEXTKEY(): copied dereferenced watch handle'); + + eval { + my $val = $copy_watch->FIRSTKEY(); + }; + like($@, qr/invalid handle/, + 'watch FETCHKEY(): invalid watch handle'); + + eval { + my $val = $copy_watch->NEXTKEY('czxid'); + }; + like($@, qr/invalid handle/, + 'watch NEXTKEY(): invalid watch handle'); + + my @keys = keys(%{$watch}); + is(scalar(@keys), 3, + 'keys(): count of keys from watch handle'); + + @keys = keys(%{$copy_watch}); + is(scalar(@keys), 3, + 'keys(): count of keys from copied dereferenced watch handle'); + + is($attr->FIRSTKEY(), 'timeout', + 'watch FIRSTKEY(): retrieved first key using inner watch hash'); + + is($attr->NEXTKEY('event'), 'state', + 'watch NEXTKEY(): retrieved last key using inner watch hash'); + + is($attr->NEXTKEY('state'), undef, + 'NEXTKEY(): undef returned after last key using inner watch hash'); + + ok(scalar(%{$watch}), + 'scalar(): true value returned for dereferenced watch handle'); + + ok($watch->SCALAR(), + 'watch SCALAR(): true value returned'); + + + ## FETCH() + + eval { + my $val = $copy_watch->FETCH('version'); + }; + like($@, qr/invalid handle/, + 'watch FETCH(): invalid watch handle'); + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + my $val = $watch->{'foo'}; + ok(!defined($val), + 'watch FETCH(): undef returned for invalid element'); + + like($msg, qr/invalid element/, + 'watch FETCH(): invalid element'); + } + + is($watch->{'timeout'}, 60000, + 'watch FETCH(): default timeout'); + + is($watch->{'event'}, 0, + 'watch FETCH(): default event'); + + is($watch->{'state'}, 0, + 'watch FETCH(): default state'); + + is($attr->FETCH('timeout'), 60000, + 'watch FETCH(): default timeout using inner watch hash'); + + + ## STORE() + + eval { + my $val = $copy_watch->STORE('version', 'foo'); + }; + like($@, qr/invalid handle/, + 'watch STORE(): invalid watch handle'); + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + $watch->{'foo'} = 'foo'; + like($msg, qr/invalid element/, + 'watch STORE(): invalid element'); + } + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + $watch->{'event'} = 'foo'; + like($msg, qr/read-only element: event/, + 'watch STORE(): read-only event element'); + } + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + $watch->{'state'} = 'foo'; + like($msg, qr/read-only element: state/, + 'watch STORE(): read-only state element'); + } + + $watch->{'timeout'} = 100; + is($watch->{'timeout'}, 100, + 'watch STORE(): updated timeout'); + + $attr->STORE('timeout', 200); + is($watch->{'timeout'}, 200, + 'watch STORE(): updated timeout using inner hash'); + + + ## EXISTS() + + eval { + my $val = $copy_watch->EXISTS('version'); + }; + like($@, qr/invalid handle/, + 'watch EXISTS(): invalid watch handle'); + + ok(!exists($watch->{'foo'}), + 'exists(): invalid element of watch handle'); + + ok(exists($watch->{'timeout'}), + 'exists(): timeout'); + + ok(exists($watch->{'event'}), + 'exists(): event'); + + ok(exists($watch->{'state'}), + 'exists(): state'); + + ok($attr->EXISTS('timeout'), + 'watch EXISTS(): timeout using inner watch hash'); + + + ## DELETE(), CLEAR() + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + delete($watch->{'version'}); + like($msg, + qr/deleting elements from hashes of class Net::ZooKeeper::Watch not supported/, + 'delete(): deleting watch hash elements not supported'); + } + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + $watch->DELETE({'version'}); + like($msg, + qr/deleting elements from hashes of class Net::ZooKeeper::Watch not supported/, + 'watch DELETE(): deleting watch hash elements not supported'); + } + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + %{$watch} = (); + like($msg, qr/clearing hashes of class Net::ZooKeeper::Watch not supported/, + 'assign: clearing watch hashes not supported'); + } + + { + my $msg; + + $SIG{'__WARN__'} = sub { $msg = $_[0]; }; + + $watch->CLEAR(); + like($msg, qr/clearing hashes of class Net::ZooKeeper::Watch not supported/, + 'watch CLEAR(): clearing watch hashes not supported'); + } +} + diff --git a/src/contrib/zkperl/t/30_connect.t b/src/contrib/zkperl/t/30_connect.t new file mode 100644 index 0000000..c2b68bb --- /dev/null +++ b/src/contrib/zkperl/t/30_connect.t @@ -0,0 +1,202 @@ +# Net::ZooKeeper - Perl extension for Apache ZooKeeper +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +use File::Spec; +use Test::More tests => 29; + +BEGIN { use_ok('Net::ZooKeeper', qw(:all)) }; + + +my $test_dir; +(undef, $test_dir, undef) = File::Spec->splitpath($0); +require File::Spec->catfile($test_dir, 'util.pl'); + +my($hosts, $root_path, $node_path) = zk_test_setup(0); + + +## new(), DESTROY() + +Net::ZooKeeper::set_deterministic_conn_order(1); + +my $zkh = Net::ZooKeeper->new($hosts); +isa_ok($zkh, 'Net::ZooKeeper', + 'new(): created handle'); + +SKIP: { + skip 'no valid handle', 3 unless (defined($zkh)); + + my $ret = $zkh->DESTROY(); + ok($ret, + 'DESTROY(): destroyed handle'); + + $ret = $zkh->DESTROY(); + ok(!$ret, + 'DESTROY(): no action on destroyed handle'); + + undef $zkh; + ok(!defined($zkh), + 'undef: released handle'); +} + +Net::ZooKeeper::set_deterministic_conn_order(0); + +SKIP: { + my $zkh = Net::ZooKeeper->new($hosts); + + skip 'no valid handle', 10 unless (defined($zkh)); + + my $copy_zkh = $zkh; + isa_ok($copy_zkh, 'Net::ZooKeeper', + 'assign: copied handle'); + + my $ret = $zkh->exists($root_path); + ok(defined($ret), + 'exists(): no error from original handle'); + + undef $zkh; + ok(!defined($zkh), + 'undef: released original handle'); + + $ret = $copy_zkh->exists($root_path); + ok(defined($ret), + 'exists(): no error from first copy of handle'); + + $zkh = $copy_zkh; + isa_ok($zkh, 'Net::ZooKeeper', + 'assign: re-copied handle'); + + $ret = $copy_zkh->DESTROY(); + ok($ret, + 'DESTROY(): destroyed first copy of handle'); + + eval { + $zkh->exists($root_path); + }; + like($@, qr/invalid handle/, + 'exists(): invalid second copy of handle'); + + undef $copy_zkh; + ok(!defined($copy_zkh), + 'undef: released first copy of handle'); + + $ret = $zkh->DESTROY(); + ok(!$ret, + 'DESTROY(): no action on second copy of destroyed handle'); + + undef $zkh; + ok(!defined($zkh), + 'undef: released second copy of handle'); +} + +SKIP: { + my $zkh = Net::ZooKeeper->new($hosts); + + skip 'no valid handle', 6 unless (defined($zkh)); + + my $copy_zkh; + { + my %copy_zkh = %{$zkh}; + $copy_zkh = \%copy_zkh; + } + bless($copy_zkh, 'Net::ZooKeeper'); + isa_ok($copy_zkh, 'Net::ZooKeeper', + 'FIRSTKEY(), NEXTKEY(): copied dereferenced handle'); + + eval { + $copy_zkh->exists($root_path); + }; + like($@, qr/invalid handle/, + 'exists(): invalid copy of dereferenced handle'); + + $ret = $copy_zkh->DESTROY(); + ok(!$ret, + 'DESTROY(): no action on copy of dereferenced handle'); + + undef $copy_zkh; + ok(!defined($copy_zkh), + 'undef: released copy of dereferenced handle'); + + my $ret = $zkh->exists($root_path); + ok(defined($ret), + 'exists(): no error from original handle'); + + undef $zkh; + ok(!defined($zkh), + 'undef: released original handle'); +} + +Net::ZooKeeper::set_deterministic_conn_order(1); + +my $zkh1 = Net::ZooKeeper->new($hosts, 'session_timeout' => 0x3FFF_FFFF); +isa_ok($zkh1, 'Net::ZooKeeper', + 'new(): created handle with maximum session timeout'); + +SKIP: { + my $ret = $zkh1->exists($root_path) if (defined($zkh1)); + + skip 'no connection to ZooKeeper', 7 unless + (defined($ret) and $ret); + + + ## FETCH() of read-only attributes + + ok(($zkh1->{'session_timeout'} > 0 and + $zkh1->{'session_timeout'} <= 0x3FFF_FFFF), + 'FETCH(): session timeout reset after connection'); + + my $session_id1 = $zkh1->{'session_id'}; + ok((length($session_id1) > 0), + 'FETCH(): non-empty session ID after connection'); + + SKIP: { + skip 'no session ID after connection', 1 unless + (length($session_id1) > 0); + + my @nonzero_bytes = grep($_ != 0, unpack('c' x length($session_id1), + $session_id1)); + ok((@nonzero_bytes > 0), + 'FETCH(): non-zero session ID after connection'); + } + + ## NOTE: to test re-connections with saved session IDs we create a second + ## connection with the same ID while the first is still active; + ## this is bad practice in normal usage + + my $zkh2 = Net::ZooKeeper->new($hosts, + 'session_id' => $session_id1, + 'session_timeout' => 20000); + isa_ok($zkh2, 'Net::ZooKeeper', + 'new(): created handle with session ID and valid session timeout'); + + $ret = $zkh2->exists($root_path); + ok($ret, + 'new(): reconnection with session ID'); + + SKIP: { + skip 'no connection to ZooKeeper', 2 unless ($ret); + + is($zkh2->{'session_timeout'}, 20000, + 'FETCH(): session timeout unchanged after connection'); + + my $session_id2 = $zkh2->{'session_id'}; + ok((length($session_id2) == length($session_id1) + and $session_id2 eq $session_id1), + 'FETCH(): reconnect with session ID'); + } +} + diff --git a/src/contrib/zkperl/t/35_log.t b/src/contrib/zkperl/t/35_log.t new file mode 100644 index 0000000..92821af --- /dev/null +++ b/src/contrib/zkperl/t/35_log.t @@ -0,0 +1,88 @@ +# Net::ZooKeeper - Perl extension for Apache ZooKeeper +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +use File::Spec; +use Test::More tests => 3; + +BEGIN { use_ok('Net::ZooKeeper', qw(:all)) }; + + +my $test_dir; +(undef, $test_dir, undef) = File::Spec->splitpath($0); +require File::Spec->catfile($test_dir, 'util.pl'); + +my($hosts, $root_path, $node_path) = zk_test_setup(0); + + +my $zkh = Net::ZooKeeper->new($hosts); + +Net::ZooKeeper::set_log_level(ZOO_LOG_LEVEL_INFO); + +SKIP: { + skip 'no valid handle', 2 unless (defined($zkh)); + + SKIP: { + my $dup = 0; + + if (open(OLDERR, '>&', fileno(STDERR))) { + if (close(STDERR) and open(STDERR, '+>', undef)) { + $dup = 1; + + my $old_select = select(STDERR); + $| = 1; + select($old_select); + } + else { + open(STDERR, '>&', fileno(OLDERR)); + close(OLDERR); + } + } + + skip 'no duplicated stderr', 2 unless ($dup); + + SKIP: { + $zkh->exists($root_path); + + sleep(1); + + skip 'no seek on stderr', 1 unless (seek(STDERR, 0, 0)); + + my $log = ; + like($log, qr/ZOO_/, + 'exists(): generated log message'); + } + + SKIP: { + $zkh->DESTROY(); + + sleep(1); + + skip 'no seek on stderr', 1 unless (seek(STDERR, 0, 0)); + + my $log = ; + like($log, qr/ZOO_/, + 'DESTROY(): generated log message'); + } + + open(STDERR, '>&', fileno(OLDERR)); + close(OLDERR); + } +} + +Net::ZooKeeper::set_log_level(ZOO_LOG_LEVEL_OFF); + diff --git a/src/contrib/zkperl/t/40_basic.t b/src/contrib/zkperl/t/40_basic.t new file mode 100644 index 0000000..38a8a21 --- /dev/null +++ b/src/contrib/zkperl/t/40_basic.t @@ -0,0 +1,277 @@ +# Net::ZooKeeper - Perl extension for Apache ZooKeeper +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +use File::Spec; +use Test::More tests => 35; + +BEGIN { use_ok('Net::ZooKeeper', qw(:all)) }; + + +my $test_dir; +(undef, $test_dir, undef) = File::Spec->splitpath($0); +require File::Spec->catfile($test_dir, 'util.pl'); + +my($hosts, $root_path, $node_path) = zk_test_setup(0); + + +my $zkh = Net::ZooKeeper->new($hosts); +my $path; + +SKIP: { + my $ret = $zkh->exists($root_path) if (defined($zkh)); + + skip 'no connection to ZooKeeper', 1 unless + (defined($ret) and $ret); + + $path = $zkh->create($node_path, 'foo', 'acl' => ZOO_OPEN_ACL_UNSAFE); + is($path, $node_path, + 'create(): created node'); +} + +SKIP: { + skip 'no connection to ZooKeeper', 21 unless + (defined($path) and $path eq $node_path); + + + ## exists() + + my $ret = $zkh->exists($node_path); + ok($ret, + 'exists(): checked node existence'); + + $ret = $zkh->exists($node_path . '/NONE'); + ok((!$ret and $zkh->get_error() == ZNONODE and $! eq ''), + 'exists(): checked node non-existence'); + + my $stat = $zkh->stat(); + + $ret = $zkh->exists($node_path, 'stat' => $stat); + ok(($ret and $stat->{'data_len'} == 3), + 'exists(): checked node existence with stat handle'); + + + ## get() + + my $node = $zkh->get($node_path); + is($node, 'foo', + 'get(): retrieved node value'); + + $node = $zkh->get($node_path . '/NONE'); + ok((!defined($node) and $zkh->get_error() == ZNONODE and $! eq ''), + 'get(): undef returned for non-extant node'); + + $node = $zkh->get($node_path, 'data_read_len', 2); + is($node, 'fo', + 'get(): retrieved truncated node value'); + + $node = $zkh->get($node_path, 'data_read_len' => 0); + is($node, '', + 'get(): retrieved zero-length node value'); + + $node = $zkh->get($node_path, 'stat' => $stat); + ok(($node eq 'foo' and $stat->{'data_len'} == 3), + 'get(): retrieved node value with stat handle'); + + + ## set() + + $ret = $zkh->set($node_path, 'foo'); + ok($ret, + 'set(): set node value'); + + SKIP: { + my $ret = $zkh->exists($node_path, 'stat' => $stat); + + skip 'invalid node data', 2 unless + ($ret and $stat->{'version'} == 1); + + $ret = $zkh->set($node_path, 'foo', 'version' => $stat->{'version'}); + ok($ret, + 'set(): set node value with matching version'); + + $ret = $zkh->set($node_path, 'foo', 'version' => $stat->{'version'}); + ok((!$ret and $zkh->get_error() == ZBADVERSION and $! eq ''), + 'set(): node value unchanged if non-matching version'); + } + + $ret = $zkh->set($node_path, 'foobaz', 'stat' => $stat); + ok(($ret and $stat->{'data_len'} == 6), + 'set(): retrieved node value with stat handle'); + + + ## create(), delete() + + $path = $zkh->create($node_path, 'foo', 'acl' => ZOO_OPEN_ACL_UNSAFE); + ok((!defined($path) and $zkh->get_error() == ZNODEEXISTS and $! eq ''), + 'create(): undef when attempting to create extant node'); + + $ret = $zkh->delete($node_path . '/NONE'); + ok((!$ret and $zkh->get_error() == ZNONODE and $! eq ''), + 'delete(): no deletion of non-extant node'); + + $ret = $zkh->delete($node_path); + ok($ret, + 'delete(): deleted node'); + + my $path_read_len = length($node_path) - 2; + + $path = $zkh->create($node_path, 'foo', + 'path_read_len' => $path_read_len, + 'acl' => ZOO_OPEN_ACL_UNSAFE); + is($path, substr($node_path, 0, -2), + 'create(): created node with small return path buffer'); + + $path = $zkh->create("$node_path/s", 'foo', + 'flags' => ZOO_SEQUENCE, + 'acl' => ZOO_OPEN_ACL_UNSAFE); + like($path, qr/^$node_path\/s[0-9]+$/, + 'create(): created sequential node'); + + SKIP: { + my $ret = $zkh->exists($path, 'stat' => $stat); + + unless ($ret and $stat->{'version'} == 0) { + my $ret = $zkh->delete($path); + diag(sprintf('unable to delete node %s: %d, %s', + $path, $zkh->get_error(), $!)) unless ($ret); + + skip 'invalid node data', 2; + } + + $ret = $zkh->delete($path, 'version' => ($stat->{'version'} + 1)); + ok((!$ret and $zkh->get_error() == ZBADVERSION and $! eq ''), + 'delete(): node not deleted if non-matching version'); + + $ret = $zkh->delete($path, 'version' => $stat->{'version'}); + ok($ret, + 'delete(): deleted sequential node with matching version'); + } + + $path = $zkh->create("$node_path/e", 'foo', + 'flags' => ZOO_EPHEMERAL, + 'acl' => ZOO_OPEN_ACL_UNSAFE); + is($path, "$node_path/e", + 'create(): created ephemeral node'); + + $path = $zkh->create("$node_path/es", 'foo', + 'flags' => (ZOO_SEQUENCE | ZOO_EPHEMERAL), + 'acl' => ZOO_OPEN_ACL_UNSAFE); + like($path, qr/^$node_path\/es[0-9]+$/, + 'create(): created ephemeral sequential node'); + + undef $zkh; +} + +$zkh = Net::ZooKeeper->new($hosts); + +SKIP: { + my $ret = $zkh->exists($node_path) if (defined($zkh)); + + skip 'no connection to ZooKeeper', 12 unless + (defined($ret) and $ret); + + $ret = $zkh->exists("$node_path/e"); + ok((!$ret and $zkh->get_error() == ZNONODE and $! eq ''), + 'exists(): checked ephemeral node non-extant after reconnection'); + + $ret = $zkh->exists($path); + ok((!$ret and $zkh->get_error() == ZNONODE and $! eq ''), + 'exists(): checked ephemeral sequential node non-extant ' . + 'after reconnection'); + + + ## get_children() + + my @child_paths = ('abc'); + @child_paths = $zkh->get_children($node_path); + ok((@child_paths == 0 and $zkh->get_error() == ZOK), + 'get_children(): retrieved empty list of child nodes'); + + my $num_children = $zkh->get_children($node_path); + ok((defined($num_children) and $num_children == 0), + 'get_children(): retrieved zero count of child nodes'); + + @child_paths = $zkh->get_children($node_path . '/NONE'); + ok((@child_paths == 0 and $zkh->get_error() == ZNONODE and $! eq ''), + 'get_children(): empty list returned for non-extant node'); + + $num_children = $zkh->get_children($node_path . '/NONE'); + ok((!defined($num_children) and $zkh->get_error() == ZNONODE and $! eq ''), + 'get_children(): undef returned for non-extant node'); + + SKIP: { + my $path = $zkh->create("$node_path/c1", 'foo', + 'acl' => ZOO_OPEN_ACL_UNSAFE); + + skip 'no connection to ZooKeeper', 6 unless + (defined($path) and $path eq "$node_path/c1"); + + my @child_paths = ('abc'); + @child_paths = $zkh->get_children($node_path); + ok((@child_paths == 1 and $child_paths[0] eq 'c1'), + 'get_children(): retrieved list of single child node'); + + my $num_children = $zkh->get_children($node_path); + ok((defined($num_children) and $num_children == 1), + 'get_children(): retrieved count of single child node'); + + SKIP: { + my $path = $zkh->create("$node_path/c2", 'foo', + 'acl' => ZOO_OPEN_ACL_UNSAFE); + + skip 'no connection to ZooKeeper', 2 unless + (defined($path) and $path eq "$node_path/c2"); + + my @child_paths = ('abc'); + @child_paths = $zkh->get_children($node_path); + ok((@child_paths == 2 and $child_paths[0] eq 'c1' and + $child_paths[1] eq 'c2'), + 'get_children(): retrieved list of two child nodes'); + + my $num_children = $zkh->get_children($node_path); + ok((defined($num_children) and $num_children == 2), + 'get_children(): retrieved count of two child nodes'); + + my $ret = $zkh->delete("$node_path/c2"); + diag(sprintf('unable to delete node %s: %d, %s', + "$node_path/c2", $zkh->get_error(), $!)) unless + ($ret); + } + + @child_paths = ('abc'); + @child_paths = $zkh->get_children($node_path); + ok((@child_paths == 1 and $child_paths[0] eq 'c1'), + 'get_children(): retrieved list of single child node'); + + $num_children = $zkh->get_children($node_path); + ok((defined($num_children) and $num_children == 1), + 'get_children(): retrieved count of single child node'); + + my $ret = $zkh->delete("$node_path/c1"); + diag(sprintf('unable to delete node %s: %d, %s', + "$node_path/c1", $zkh->get_error(), $!)) unless ($ret); + } + + + ## cleanup + + $ret = $zkh->delete($node_path); + diag(sprintf('unable to delete node %s: %d, %s', + $node_path, $zkh->get_error(), $!)) unless ($ret); +} + diff --git a/src/contrib/zkperl/t/45_class.t b/src/contrib/zkperl/t/45_class.t new file mode 100644 index 0000000..4aa1a57 --- /dev/null +++ b/src/contrib/zkperl/t/45_class.t @@ -0,0 +1,408 @@ +# Net::ZooKeeper - Perl extension for Apache ZooKeeper +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +use File::Spec; +use Test::More tests => 47; + +BEGIN { use_ok('Net::ZooKeeper', qw(:all)) }; + + +my $test_dir; +(undef, $test_dir, undef) = File::Spec->splitpath($0); +require File::Spec->catfile($test_dir, 'util.pl'); + +my($hosts, $root_path, $node_path) = zk_test_setup(0); + + +SKIP: { + my $zkh = Net::ZooKeeper->new($hosts); + + skip 'no valid handle', 15 unless (defined($zkh)); + + my $stat = $zkh->stat(); + my $watch = $zkh->watch(); + + + ## DESTROY() on reblessed handle + + bless($zkh, 'My::ZooKeeper'); + is(ref($zkh), 'My::ZooKeeper', + 'bless(): reblessed handle'); + + eval { + $zkh->EXISTS(); + }; + like($@, qr/Can't locate object method "EXISTS" via package "My::ZooKeeper"/, + 'EXISTS(): not defined on reblessed handle'); + + my $attr = tied(%{$zkh}); + + my $ret = $attr->DESTROY(); + ok($ret, + 'DESTROY(): destroyed inner hash of reblessed handle'); + + $ret = $attr->DESTROY(); + ok(!$ret, + 'DESTROY(): no action on destroyed inner hash of reblessed handle'); + + undef $zkh; + ok(!defined($zkh), + 'undef: released reblessed handle'); + + + ## DESTROY() on reblessed stat handle + + bless($stat, 'My::ZooKeeper::Stat'); + is(ref($stat), 'My::ZooKeeper::Stat', + 'bless(): reblessed stat handle'); + + eval { + $stat->EXISTS(1); + }; + like($@, qr/Can't locate object method "EXISTS" via package "My::ZooKeeper::Stat"/, + 'stat EXISTS(): not defined on reblessed stat handle'); + + $attr = tied(%{$stat}); + + $ret = $attr->DESTROY(); + ok($ret, + 'stat DESTROY(): destroyed inner hash of reblessed stat handle'); + + $ret = $attr->DESTROY(); + ok(!$ret, + 'stat DESTROY(): no action on destroyed inner hash of ' . + 'reblessed stat handle'); + + undef $stat; + ok(!defined($stat), + 'undef: released reblessed stat handle'); + + + ## DESTROY() on reblessed watch handle + + bless($watch, 'My::ZooKeeper::Watch'); + is(ref($watch), 'My::ZooKeeper::Watch', + 'bless(): reblessed watch handle'); + + eval { + $watch->EXISTS(1); + }; + like($@, qr/Can't locate object method "EXISTS" via package "My::ZooKeeper::Watch"/, + 'watch EXISTS(): not defined on reblessed watch handle'); + + $attr = tied(%{$watch}); + + $ret = $attr->DESTROY(); + ok($ret, + 'watch DESTROY(): destroyed inner hash of reblessed watch handle'); + + $ret = $attr->DESTROY(); + ok(!$ret, + 'watch DESTROY(): no action on destroyed inner hash of ' . + 'reblessed watch handle'); + + undef $watch; + ok(!defined($watch), + 'undef: released reblessed watch handle'); +} + +SKIP: { + my $zkh = Net::ZooKeeper->new($hosts); + + skip 'no valid handle', 9 unless (defined($zkh)); + + my $stat = $zkh->stat(); + my $watch = $zkh->watch(); + + + ## UNTIE() on reblessed handle + + bless($zkh, 'My::ZooKeeper'); + is(ref($zkh), 'My::ZooKeeper', + 'bless(): reblessed handle'); + + eval { + untie(%{$zkh}); + }; + like($@, qr/untying hashes of class Net::ZooKeeper not supported/, + 'untie(): untying hashes from reblessed handle not supported'); + + my $attr = tied(%{$zkh}); + + eval { + $attr->UNTIE(0); + }; + like($@, qr/untying hashes of class Net::ZooKeeper not supported/, + 'UNTIE(): untying hashes from reblessed handle not supported'); + + + ## UNTIE() on reblessed stat handle + + bless($stat, 'My::ZooKeeper::Stat'); + is(ref($stat), 'My::ZooKeeper::Stat', + 'bless(): reblessed stat handle'); + + eval { + untie(%{$stat}); + }; + like($@, qr/untying hashes of class Net::ZooKeeper::Stat not supported/, + 'untie(): untying hashes from reblessed stat handle not supported'); + + $attr = tied(%{$stat}); + + eval { + $attr->UNTIE(0); + }; + like($@, qr/untying hashes of class Net::ZooKeeper::Stat not supported/, + 'stat UNTIE(): untying hashes from reblessed stat handle ' . + 'not supported'); + + + ## UNTIE() on reblessed watch handle + + bless($watch, 'My::ZooKeeper::Watch'); + is(ref($watch), 'My::ZooKeeper::Watch', + 'bless(): reblessed watch handle'); + + eval { + untie(%{$watch}); + }; + like($@, qr/untying hashes of class Net::ZooKeeper::Watch not supported/, + 'untie(): untying hashes from reblessed watch handle not supported'); + + $attr = tied(%{$watch}); + + eval { + $attr->UNTIE(0); + }; + like($@, qr/untying hashes of class Net::ZooKeeper::Watch not supported/, + 'watch UNTIE(): untying hashes from reblessed watch handle ' . + 'not supported'); +} + + +package Net::ZooKeeper::Test; + +use Net::ZooKeeper qw(:acls); + +our @ISA = qw(Net::ZooKeeper); + +sub create +{ + my($self, $path, $buf) = @_; + + return $self->SUPER::create($path, $buf, + 'path_read_len' => length($path), + 'acl' => ZOO_OPEN_ACL_UNSAFE); +} + +sub get_first_child +{ + my($self, $path) = @_; + + my @child_paths = $self->get_children($path); + + if (@child_paths > 0) { + return $path . (($path =~ /\/$/) ? '' : '/') . $child_paths[0]; + } + + return undef; +} + +sub stat +{ + my $self = shift; + + my $stat = $self->SUPER::stat(); + + return bless($stat, 'Net::ZooKeeper::Test::Stat'); +} + + +sub watch +{ + my $self = shift; + + my $watch = $self->SUPER::watch(); + + return bless($watch, 'Net::ZooKeeper::Test::Watch'); +} + + +package Net::ZooKeeper::Test::Stat; + +our @ISA = qw(Net::ZooKeeper::Stat); + +sub get_ctime +{ + my $self = shift; + + return $self->{'ctime'}; +} + + +package Net::ZooKeeper::Test::Watch; + +our @ISA = qw(Net::ZooKeeper::Watch); + +sub get_timeout +{ + my $self = shift; + + return $self->{'timeout'}; +} + + +package main; + +my $sub_zkh = Net::ZooKeeper::Test->new($hosts); +isa_ok($sub_zkh, 'Net::ZooKeeper::Test', + 'new(): created subclassed handle'); + +SKIP: { + skip 'no valid subclassed handle', 21 unless (defined($sub_zkh)); + + is($sub_zkh->{'data_read_len'}, 1023, + 'FETCH(): default data read length using subclassed handle'); + + my $path; + + SKIP: { + my $ret = $sub_zkh->exists($root_path); + + skip 'no connection to ZooKeeper', 1 unless + (defined($ret) and $ret); + + $path = $sub_zkh->create($node_path, 'foo', + 'acl' => ZOO_OPEN_ACL_UNSAFE); + is($path, $node_path, + 'create(): created node with subclassed handle'); + } + + SKIP: { + skip 'no connection to ZooKeeper', 1 unless + (defined($path) and $path eq $node_path); + + my $child_path = $sub_zkh->get_first_child($root_path); + is($child_path, $node_path, + 'get_first_child(): retrieved first child with subclassed handle'); + } + + my $sub_stat = $sub_zkh->stat(); + isa_ok($sub_stat, 'Net::ZooKeeper::Test::Stat', + 'stat(): created subclassed stat handle'); + + SKIP: { + skip 'no valid subclassed stat handle', 6 unless + (defined($sub_stat)); + + is($sub_stat->{'ctime'}, 0, + 'stat FETCH(): default ctime using subclassed stat handle'); + + SKIP: { + my $ret = $sub_zkh->exists($node_path, 'stat' => $sub_stat) if + (defined($path) and $path eq $node_path); + + skip 'no connection to ZooKeeper', 2 unless + (defined($ret) and $ret); + + my $ctime = $sub_stat->get_ctime(); + ok($ctime > 0, + 'get_ctime(): retrieved ctime with subclassed stat handle'); + + is($sub_stat->{'ctime'}, $ctime, + 'stat FETCH(): ctime using subclassed stat handle'); + } + + my $ret = $sub_stat->DESTROY(); + ok($ret, + 'stat DESTROY(): destroyed subclassed stat handle'); + + $ret = $sub_stat->DESTROY(); + ok(!$ret, + 'stat DESTROY(): no action on destroyed subclassed stat handle'); + + undef $sub_stat; + ok(!defined($sub_stat), + 'undef: released subclassed stat handle'); + } + + my $sub_watch = $sub_zkh->watch(); + isa_ok($sub_watch, 'Net::ZooKeeper::Test::Watch', + 'watch(): created subclassed watch handle'); + + SKIP: { + skip 'no valid subclassed watch handle', 6 unless + (defined($sub_watch)); + + SKIP: { + my $ret = $sub_zkh->exists($root_path, 'watch' => $sub_watch); + + skip 'no connection to ZooKeeper', 3 unless + (defined($ret) and $ret); + + $sub_watch->{'timeout'} = 50; + + is($sub_watch->get_timeout(), 50, + 'get_timeout(): retrieved timeout with subclassed ' . + 'watch handle'); + + is($sub_watch->{'timeout'}, 50, + 'watch FETCH(): timeout using subclassed stat handle'); + + $ret = $sub_watch->wait(); + ok(!$ret, + 'wait(): watch after checking node existence timed out with ' . + 'subclassed watch handle'); + } + + my $ret = $sub_watch->DESTROY(); + ok($ret, + 'watch DESTROY(): destroyed subclassed watch handle'); + + $ret = $sub_watch->DESTROY(); + ok(!$ret, + 'watch DESTROY(): no action on destroyed subclassed watch handle'); + + undef $sub_watch; + ok(!defined($sub_watch), + 'undef: released subclassed watch handle'); + } + + SKIP: { + skip 'no connection to ZooKeeper', 1 unless + (defined($path) and $path eq $node_path); + + my $ret = $sub_zkh->delete($node_path); + ok($ret, + 'delete(): deleted node with subclassed handle'); + } + + my $ret = $sub_zkh->DESTROY(); + ok($ret, + 'DESTROY(): destroyed subclassed handle'); + + $ret = $sub_zkh->DESTROY(); + ok(!$ret, + 'DESTROY(): no action on destroyed subclassed handle'); + + undef $sub_zkh; + ok(!defined($sub_zkh), + 'undef: released subclassed handle'); +} + diff --git a/src/contrib/zkperl/t/50_access.t b/src/contrib/zkperl/t/50_access.t new file mode 100644 index 0000000..ef61ed6 --- /dev/null +++ b/src/contrib/zkperl/t/50_access.t @@ -0,0 +1,356 @@ +# Net::ZooKeeper - Perl extension for Apache ZooKeeper +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +use File::Spec; +use Test::More tests => 40; + +BEGIN { use_ok('Net::ZooKeeper', qw(:all)) }; + + +my $test_dir; +(undef, $test_dir, undef) = File::Spec->splitpath($0); +require File::Spec->catfile($test_dir, 'util.pl'); + +my($hosts, $root_path, $node_path) = zk_test_setup(0); + +my($username, $password, $digest) = zk_acl_test_setup(); + + +SKIP: { + my $zkh = Net::ZooKeeper->new($hosts); + + my $path = $zkh->create($node_path, 'foo', + 'acl' => ZOO_OPEN_ACL_UNSAFE) if (defined($zkh)); + + skip 'no connection to ZooKeeper', 36 unless + (defined($path) and $path eq $node_path); + + + ## _zk_acl_constant() + + my $no_read_acl = ZOO_OPEN_ACL_UNSAFE; + ok((ref($no_read_acl) eq 'ARRAY' and + @{$no_read_acl} == 1 and + ref($no_read_acl->[0]) eq 'HASH' and + keys(%{$no_read_acl->[0]}) == 3 and + $no_read_acl->[0]->{'perms'} == ZOO_PERM_ALL), + '_zk_acl_constant(): returned default ACL'); + + my $zoo_read_acl_unsafe = ZOO_READ_ACL_UNSAFE; + ok((ref($zoo_read_acl_unsafe) eq 'ARRAY' and + @{$zoo_read_acl_unsafe} == 1 and + ref($zoo_read_acl_unsafe->[0]) eq 'HASH' and + keys(%{$zoo_read_acl_unsafe->[0]}) == 3 and + $zoo_read_acl_unsafe->[0]->{'perms'} == ZOO_PERM_READ), + '_zk_acl_constant(): returned good ACL'); + + my $zoo_creator_all_acl = ZOO_CREATOR_ALL_ACL; + ok((ref($zoo_creator_all_acl) eq 'ARRAY' and + @{$zoo_creator_all_acl} == 1 and + ref($zoo_creator_all_acl->[0]) eq 'HASH' and + keys(%{$zoo_creator_all_acl->[0]}) == 3 and + $zoo_creator_all_acl->[0]->{'perms'} == ZOO_PERM_ALL), + '_zk_acl_constant(): returned good ACL'); + + $no_read_acl->[0]->{'perms'} &= ~ZOO_PERM_READ; + is($no_read_acl->[0]->{'perms'}, ((ZOO_PERM_ALL) & ~ZOO_PERM_READ), + 'assign: altered default ACL'); + + is(ZOO_OPEN_ACL_UNSAFE->[0]->{'perms'}, ZOO_PERM_ALL, + '_zk_acl_constant(): returned unaltered default ACL'); + + my $copy_no_read_acl = $no_read_acl; + is_deeply($copy_no_read_acl, $no_read_acl, + 'assign: copied default ACL'); + + undef $no_read_acl; + ok(!defined($no_read_acl), + 'undef: released original default ACL'); + + is($copy_no_read_acl->[0]->{'perms'}, ((ZOO_PERM_ALL) & ~ZOO_PERM_READ), + 'undef: no change to copied default ACL'); + + $no_read_acl = $copy_no_read_acl; + is_deeply($no_read_acl, $copy_no_read_acl, + 'assign: re-copied default ACL'); + + + ## create() + + my $acl_node_path = "$node_path/a1"; + + $path = $zkh->create($acl_node_path, 'foo', 'acl' => $no_read_acl); + is($path, $acl_node_path, + 'create(): created node with no-read ACL'); + + my $node = $zkh->get($acl_node_path); + + my $skip_acl; + if (defined($node) and $node eq 'foo') { + $skip_acl = 1; + } + elsif(!defined($node) and $zkh->get_error() == ZNOAUTH) { + $skip_acl = 0; + } + else { + $skip_acl = -1; + diag(sprintf('unable to get node with no-read ACL %s: %d, %s', + $acl_node_path, $zkh->get_error(), $!)); + } + + my $ret = $zkh->delete($acl_node_path); + diag(sprintf('unable to delete node with no-read ACL %s: %d, %s', + $acl_node_path, $zkh->get_error(), $!)) unless ($ret); + + my $digest_acl = [ + { + 'perms' => ZOO_PERM_READ, + 'scheme' => 'world', + 'id' => 'anyone' + }, + { + 'perms' => (ZOO_PERM_WRITE | ZOO_PERM_ADMIN), + 'scheme' => 'digest', + 'id' => "$username:$digest" + } + ]; + + $path = $zkh->create($acl_node_path, 'foo', 'acl' => $digest_acl); + is($path, $acl_node_path, + 'create(): created node with digest auth ACL'); + + SKIP: { + skip 'ZooKeeper skipping ACLs', 1 unless (!$skip_acl); + + my $acl_node_path = "$node_path/a2"; + + my $path = $zkh->create($acl_node_path, 'foo', 'acl' => [ + { + 'perms' => ZOO_PERM_WRITE, + 'scheme' => 'foo', + 'id' => 'bar' + } + ]); + ok((!defined($path) and $zkh->get_error() == ZINVALIDACL and $! eq ''), + 'create(): undef when attempting to create node with invalid ACL'); + } + + + ## get_acl() + + my @acl = ('abc'); + @acl = $zkh->get_acl($node_path . '/NONE'); + ok((@acl == 0 and $zkh->get_error() == ZNONODE and $! eq ''), + 'get_acl(): empty list returned for non-extant node'); + + $num_acl_entries = $zkh->get_acl($node_path . '/NONE'); + ok((!defined($num_acl_entries) and $zkh->get_error() == ZNONODE and + $! eq ''), + 'get_acl(): undef returned for non-extant node'); + + @acl = ('abc'); + @acl = $zkh->get_acl($acl_node_path); + is_deeply(\@acl, $digest_acl, + 'get_acl(): retrieved digest ACL'); + + my $stat = $zkh->stat(); + + @acl = ('abc'); + @acl = $zkh->get_acl($node_path, 'stat' => $stat); + is_deeply(\@acl, ZOO_OPEN_ACL_UNSAFE, + 'get_acl(): retrieved ACL'); + + is($stat->{'data_len'}, 3, + 'get_acl(): retrieved ACL with stat handle'); + + SKIP: { + skip 'ZooKeeper not skipping ACLs', 3 unless ($skip_acl > 0); + + my $acl_node_path = "$node_path/a2"; + + my $path = $zkh->create($acl_node_path, 'foo', 'acl' => []); + is($path, $acl_node_path, + 'create(): created node with empty ACL'); + + my @acl = ('abc'); + @acl = $zkh->get_acl($acl_node_path); + ok((@acl == 0 and $zkh->get_error() == ZOK), + 'get_acl(): retrieved empty ACL'); + + my $num_acl_entries = $zkh->get_acl($acl_node_path); + ok((defined($num_acl_entries) and $num_acl_entries == 0), + 'get_acl(): retrieved zero count of ACL entries'); + + my $ret = $zkh->delete($acl_node_path); + diag(sprintf('unable to delete node with empty ACL %s: %d, %s', + $acl_node_path, $zkh->get_error(), $!)) unless ($ret); + } + + + ## set_acl() + + SKIP: { + skip 'ZooKeeper skipping ACLs', 2 unless (!$skip_acl); + + my $ret = $zkh->set_acl($acl_node_path, [ + { + 'perms' => ZOO_PERM_CREATE, + 'scheme' => 'foo', + 'id' => 'bar' + } + ]); + ok((!$ret and $zkh->get_error() == ZINVALIDACL and $! eq ''), + 'set_acl(): invalid ACL'); + + push @{$digest_acl}, { + 'perms' => (ZOO_PERM_CREATE | ZOO_PERM_DELETE), + 'scheme' => 'ip', + 'id' => '0.0.0.0' + }; + + $ret = $zkh->set_acl($acl_node_path, $digest_acl); + ok((!$ret and $zkh->get_error() == ZNOAUTH and $! eq ''), + 'set_acl(): ACL unchanged if no auth'); + } + + + ## add_auth(), set_acl() + + $ret = $zkh->add_auth('digest', ''); + ok($ret, + 'add_auth(): empty digest cert'); + + SKIP: { + skip 'ZooKeeper skipping ACLs', 1 unless (!$skip_acl); + + my $ret = $zkh->set($acl_node_path, 'foo'); + ok((!$ret and $zkh->get_error() == ZNOAUTH and $! eq ''), + 'set(): node value unchanged if no auth'); + } + + $ret = $zkh->add_auth('digest', "$username:$password"); + ok($ret, + 'add_auth(): valid digest cert'); + + SKIP: { + skip 'ZooKeeper skipping ACLs', 13 unless (!$skip_acl); + + my $ret = $zkh->set($acl_node_path, 'baz'); + ok($ret, + 'set(): set node value with auth'); + + my $node = $zkh->get($acl_node_path); + is($node, 'baz', + 'get(): retrieved node value with auth'); + + $ret = $zkh->set_acl($acl_node_path, $digest_acl); + ok($ret, + 'set_acl(): set digest ACL with auth'); + + my $stat = $zkh->stat(); + + my @acl = ('abc'); + @acl = $zkh->get_acl($acl_node_path, 'stat' => $stat); + is_deeply(\@acl, $digest_acl, + 'get_acl(): retrieved digest ACL with auth'); + + is($stat->{'data_len'}, 3, + 'get_acl(): retrieved digest ACL with stat handle and auth'); + + SKIP: { + skip 'invalid node data', 2 unless ($stat->{'version'} == 1); + + my $ret = $zkh->set_acl($acl_node_path, $digest_acl, + 'version' => $stat->{'version'}); + ok($ret, + 'set_acl(): set digest ACL with matching version with auth'); + + $ret = $zkh->set_acl($acl_node_path, $digest_acl, + 'version' => $stat->{'version'}); + ok((!$ret and $zkh->get_error() == ZBADVERSION and $! eq ''), + 'set_acl(): ACL unchanged if non-matching version'); + } + + my $child_node_path = "$acl_node_path/c1"; + + my $path = $zkh->create($child_node_path, 'foo', + 'acl' => ZOO_OPEN_ACL_UNSAFE); + ok((!defined($path) and $zkh->get_error() == ZNOAUTH and $! eq ''), + 'create(): undef when attempting to create node if no auth'); + + $digest_acl->[1]->{'perms'} |= ZOO_PERM_CREATE; + $digest_acl->[2]->{'perms'} &= ~ZOO_PERM_CREATE; + + $ret = $zkh->set_acl($acl_node_path, $digest_acl); + ok($ret, + 'set_acl(): set changed digest ACL with auth'); + + $path = $zkh->create($child_node_path, 'foo', + 'acl' => ZOO_OPEN_ACL_UNSAFE); + is($path, $child_node_path, + 'create(): created node with auth'); + + $ret = $zkh->delete($child_node_path); + ok((!$ret and $zkh->get_error() == ZNOAUTH and $! eq ''), + 'delete(): no deletion of node if no auth'); + + $digest_acl->[1]->{'perms'} |= ZOO_PERM_DELETE; + pop @{$digest_acl}; + + $ret = $zkh->set_acl($acl_node_path, $digest_acl); + ok($ret, + 'set_acl(): set reduced digest ACL with auth'); + + $ret = $zkh->delete($child_node_path); + ok($ret, + 'delete(): deleted node with auth'); + } + + + ## cleanup + + $ret = $zkh->delete($acl_node_path); + diag(sprintf('unable to delete node with digest auth ACL %s: %d, %s', + $acl_node_path, $zkh->get_error(), $!)) unless ($ret); + + $ret = $zkh->delete($node_path); + diag(sprintf('unable to delete node %s: %d, %s', + $node_path, $zkh->get_error(), $!)) unless ($ret); +} + +SKIP: { + my $zkh = Net::ZooKeeper->new($hosts); + + my $ret = $zkh->exists($root_path) if (defined($zkh)); + + skip 'no connection to ZooKeeper', 1 unless + (defined($ret) and $ret); + + + ## add_auth() + + $ret = $zkh->add_auth('foo', 'bar'); + my $err = $zkh->get_error(); + ok((!$ret and + ($err == ZAUTHFAILED or + $err == ZCONNECTIONLOSS or + $err == ZSESSIONEXPIRED) + and $! eq ''), + 'set_acl(): invalid scheme'); +} + diff --git a/src/contrib/zkperl/t/60_watch.t b/src/contrib/zkperl/t/60_watch.t new file mode 100644 index 0000000..7d30602 --- /dev/null +++ b/src/contrib/zkperl/t/60_watch.t @@ -0,0 +1,304 @@ +# Net::ZooKeeper - Perl extension for Apache ZooKeeper +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +use File::Spec; +use Test::More tests => 30; + +BEGIN { use_ok('Net::ZooKeeper', qw(:all)) }; + + +my $test_dir; +(undef, $test_dir, undef) = File::Spec->splitpath($0); +require File::Spec->catfile($test_dir, 'util.pl'); + +my($hosts, $root_path, $node_path) = zk_test_setup(0); + + +SKIP: { + my $zkh = Net::ZooKeeper->new($hosts); + + my $path = $zkh->create($node_path, 'foo', + 'acl' => ZOO_OPEN_ACL_UNSAFE) if (defined($zkh)); + + skip 'no connection to ZooKeeper', 20 unless + (defined($path) and $path eq $node_path); + + + ## exists() + + $zkh->{'watch_timeout'} = 100; + + my $watch = $zkh->watch(); + + my $ret = $zkh->exists($node_path, 'watch' => $watch); + ok($ret, + 'exists(): checked node existence with watch handle'); + + $ret = $watch->wait(); + ok(!$ret, + 'wait(): watch after checking node existence timed out'); + + $ret = $zkh->exists($node_path, 'watch' => $watch); + ok($ret, + 'exists(): checked node existence with renewed watch handle'); + + $ret = $watch->wait(); + ok(!$ret, + 'wait(): watch after checking node existence timed out with ' . + 'renewed watch handle'); + + undef $watch; + ok(!defined($watch), + 'undef: released watch handle'); + + my $pending_watches = $zkh->{'pending_watches'}; + is($pending_watches, 2, + '_zk_release_watches(): report pending watches'); + + + ## get_children() + + $watch = $zkh->watch('timeout' => 50); + + my $num_children = $zkh->get_children($node_path, 'watch' => $watch); + ok((defined($num_children) and $num_children == 0), + 'get_children(): retrieved zero count of child nodes with ' . + 'watch handle'); + + $ret = $watch->wait(); + ok(!$ret, + 'wait(): watch after retrieving child nodes timed out with ' . + 'watch handle'); + + $watch->{'timeout'} = 100; + + my @child_paths = $zkh->get_children($node_path, 'watch' => $watch); + ok((@child_paths == 0), + 'get_children(): retrieved empty list of child nodes with ' . + 'renewed watch handle'); + + $ret = $watch->wait(); + ok(!$ret, + 'wait(): watch after retrieving child nodes timed out with ' . + 'renewed watch handle'); + + $pending_watches = $zkh->{'pending_watches'}; + is($pending_watches, 4, + '_zk_release_watches(): report pending watches'); + + + ## get() + + $watch = $zkh->watch(); + + my $node = $zkh->get($node_path, 'watch' => $watch); + is($node, 'foo', + 'get(): retrieved node value with watch handle'); + + $ret = $watch->wait('timeout' => 0); + ok(!$ret, + 'wait(): watch after retrieving node value timed out with ' . + 'watch handle'); + + $node = $zkh->get($node_path, 'watch' => $watch); + is($node, 'foo', + 'get(): retrieved node value with renewed watch handle'); + + $ret = $watch->wait(); + ok(!$ret, + 'wait(): watch after retrieving node value timed out with ' . + 'renewed watch handle'); + + $pending_watches = $zkh->{'pending_watches'}; + is($pending_watches, 6, + '_zk_release_watches(): all watches pending'); + + + ## _zk_release_watches() + + $ret = $zkh->DESTROY(); + ok($ret, + 'DESTROY(): destroyed handle with pending watches'); + + my $event = $watch->{'event'}; + is($event, 0, + '_zk_release_watches(): watch not destroyed when tied to watch handle'); + + $zkh = Net::ZooKeeper->new($hosts); + + SKIP: { + my $ret = $zkh->exists($node_path, 'watch' => $watch); + + skip 'no connection to ZooKeeper', 2 unless + (defined($ret) and $ret); + + ok($ret, + 'exists(): checked node existence with renewed watch handle ' . + 'from prior connection'); + + $ret = $watch->wait(); + ok(!$ret, + 'wait(): watch after checking node existence timed out with ' . + 'renewed watch handle from prior connection'); + + + } +} + +my $pid = fork(); + +SKIP: { + skip 'unable to fork', 4 unless (defined($pid)); + + my $zkh = Net::ZooKeeper->new($hosts); + + my $ret = $zkh->exists($node_path) if (defined($zkh)); + + if ($pid == 0) { + ## child process + + my $code = 0; + + if (defined($ret) and $ret) { + sleep(1); + + my $ret = $zkh->set($node_path, 'foo'); + + diag(sprintf('set(): failed in child process: %d, %s', + $zkh->get_error(), $!)) unless ($ret); + + $code = !$ret; + + sleep(1); + + my $path = $zkh->create("$node_path/c", 'foo', + 'acl' => ZOO_OPEN_ACL_UNSAFE); + + diag(sprintf('create(): failed in child process: %d, %s', + $zkh->get_error(), $!)) unless + (defined($path) and $path eq "$node_path/c"); + + $code &= !$ret; + + sleep(1); + + $ret = $zkh->delete("$node_path/c"); + + diag(sprintf('delete(): failed in child process: %d, %s', + $zkh->get_error(), $!)) unless ($ret); + + $code &= !$ret; + + sleep(1); + + $ret = $zkh->set($node_path, 'foo'); + + diag(sprintf('set(): failed in child process: %d, %s', + $zkh->get_error(), $!)) unless ($ret); + + $code &= !$ret; + } + + exit($code); + } + else { + ## parent process + + SKIP: { + skip 'no connection to ZooKeeper', 9 unless + (defined($ret) and $ret); + + my $watch = $zkh->watch('timeout' => 5000); + + + ## wait() + + my $ret = $zkh->exists($node_path, 'watch' => $watch); + ok($ret, + 'exists(): checked node existence with watch handle ' . + 'in parent'); + + $ret = $watch->wait(); + ok(($ret and $watch->{'event'} == ZOO_CHANGED_EVENT and + $watch->{'state'} == ZOO_CONNECTED_STATE), + 'wait(): waited for event after checking node existence'); + + my $num_children = $zkh->get_children($node_path, + 'watch' => $watch); + ok((defined($num_children) and $num_children == 0), + 'get_children(): retrieved zero count of child nodes with ' . + 'watch handle in parent'); + + $ret = $watch->wait(); + ok(($ret and $watch->{'event'} == ZOO_CHILD_EVENT and + $watch->{'state'} == ZOO_CONNECTED_STATE), + 'wait(): waited for create child event after ' . + 'retrieving child nodes'); + + my @child_paths = $zkh->get_children($node_path, + 'watch' => $watch); + ok((@child_paths == 1 and $child_paths[0] eq 'c'), + 'get_children(): retrieved list of child nodes with ' . + 'watch handle in parent'); + + $ret = $watch->wait(); + ok(($ret and $watch->{'event'} == ZOO_CHILD_EVENT and + $watch->{'state'} == ZOO_CONNECTED_STATE), + 'wait(): waited for delete child event after ' . + 'retrieving child nodes'); + + my $node = $zkh->get($node_path, 'watch' => $watch); + is($node, 'foo', + 'get(): retrieved node value with watch handle in parent'); + + $ret = $watch->wait(); + ok(($ret and $watch->{'event'} == ZOO_CHANGED_EVENT and + $watch->{'state'} == ZOO_CONNECTED_STATE), + 'wait(): waited for event after retrieving node value'); + + undef $watch; + + my $pending_watches = $zkh->{'pending_watches'}; + is($pending_watches, 0, + '_zk_release_watches(): no watches pending'); + } + + my $reap = waitpid($pid, 0); + + diag(sprintf('child process failed: exit %d, signal %d%s', + ($? >> 8), ($? & 127), + (($? & 128) ? ', core dump' : ''))) if + ($reap == $pid and $? != 0); + } +} + + +## cleanup + +{ + my $zkh = Net::ZooKeeper->new($hosts); + + my $ret = $zkh->exists($node_path) if (defined($zkh)); + + if (defined($ret) and $ret) { + $ret = $zkh->delete($node_path); + diag(sprintf('unable to delete node %s: %d, %s', + $node_path, $zkh->get_error(), $!)) unless ($ret); + } +} + diff --git a/src/contrib/zkperl/t/util.pl b/src/contrib/zkperl/t/util.pl new file mode 100644 index 0000000..1ca738d --- /dev/null +++ b/src/contrib/zkperl/t/util.pl @@ -0,0 +1,62 @@ +# Net::ZooKeeper - Perl extension for Apache ZooKeeper +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +sub zk_test_setup +{ + my $verbose = shift; + + $SIG{'PIPE'} = 'IGNORE'; + + my $hosts = $ENV{'ZK_TEST_HOSTS'}; + unless (defined($hosts) and $hosts =~ /\S/) { + $hosts = 'localhost:0'; + diag('no ZooKeeper hostnames specified in ZK_TEST_HOSTS env var, ' . + "using $hosts") if ($verbose); + } + + my $root_path = $ENV{'ZK_TEST_PATH'}; + if (defined($root_path) and $root_path =~ /^\//) { + $root_path =~ s/\/+/\//g; + $root_path =~ s/\/$//; + } + else { + $root_path = '/'; + diag('no ZooKeeper path specified in ZK_TEST_PATH env var, ' . + 'using root path') if ($verbose); + } + + my $node_path = $root_path . (($root_path =~ /\/$/) ? '' : '/') . + '_net_zookeeper_test'; + + return ($hosts, $root_path, $node_path); +} + +sub zk_acl_test_setup +{ + my $username = '_net_zookeeper_test'; + + my $password = 'test'; + + ## digest is Base64-encoded SHA1 digest of username:password + my $digest = '2qi7Erp2cXYLGcQbXADiwUFaOGo='; + + return ($username, $password, $digest); +} + +1; + diff --git a/src/contrib/zkperl/typemap b/src/contrib/zkperl/typemap new file mode 100644 index 0000000..84636fd --- /dev/null +++ b/src/contrib/zkperl/typemap @@ -0,0 +1,38 @@ +# Net::ZooKeeper - Perl extension for Apache ZooKeeper +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +TYPEMAP +Net::ZooKeeper T_ZK_HANDLE +Net::ZooKeeper::Stat T_ZK_HANDLE +Net::ZooKeeper::Watch T_ZK_HANDLE + +INPUT +T_ZK_HANDLE + if (SvROK($arg) && SvTYPE(SvRV($arg)) == SVt_PVHV && + sv_derived_from($arg, \"${ntype}\")) { + $var = (HV*) SvRV($arg); + } + else { + Perl_croak(aTHX_ + \"$var is not a hash reference of type ${ntype}\"); + } + +OUTPUT +T_ZK_HANDLE + NOT_IMPLEMENTED + diff --git a/src/contrib/zkpython/README b/src/contrib/zkpython/README new file mode 100644 index 0000000..89d9998 --- /dev/null +++ b/src/contrib/zkpython/README @@ -0,0 +1,109 @@ +Early version of ZooKeeper bindings for Python. All functions are imported as methods into the zookeeper module. + +Please do not rely on APIs staying constant in the short term. The handling of exceptions and failure modes is one area that is subject to change. + +DEPENDENCIES: +------------- + +This has only been tested against SVN (i.e. 3.2.0 in development) but should work against 3.1.1. + +You will need the Python development headers installed to build the module - on many package-management systems, these can be found in python-devel. + +Python >= 2.6 is required. We have tested against 2.6. We have not tested against 3.x. + +BUILD AND INSTALL: +------------------- + +To install, make sure that the C client has been built and that the libraries are installed in /usr/local/lib (or change this directory in setup.py). Then run: + +ant install + +from zookeeper/src/contrib/zkpython/. + +To test, run ant test from the same directory. + +You can compile the module without installing by running + +ant compile + +In order to use the module, zookeeper.so must be in your PYTHONPATH or in one of the directories referenced by sys.path. Running ant install should make sure that this is the case, but if you only run ant compile you probably need to add build/contrib/zkpython/* to PYTHONPATH to find the module. The C client libraries must be in a system library path, or LD_LIBRARY_PATH or DYLD_LIBRARY_PATH (Mac OS) for the module to work correctly, otherwise you will see a library not found error when trying to import the module. + +NAMING CONVENTIONS: +-------------------- + +All methods that in the C library are zoo_fn_name have been implemented as zookeeper.fn_name. The exception is any function that has a watch function argument is named without the 'w' prefix (for example, zoo_wexists becomes zookeeper.exists). The variants of these functions without the watch argument (i.e. zoo_exists) have not been implemented on the understanding that they are superseded by the zoo_w* API. + +Enums and integer constants that begin ZOO_int_name are named as zookeeper.int_name. + +PARAMETER CHANGES: +------------------ + +Zookeeper handles are represented as integers to avoid marshalling the entire structure for every call. Therefore they are opaque from Python. + +Any parameter that is used to provide arguments to callback methods is not exposed in the API. Python provides better mechanisms for providing a closure to be called in the future. + +Every callback gets passed the handle of the ZooKeeper instance used to register the callback. + +DATA TYPES: +----------- + +ACL_vectors are lists of dictionaries. Stat structures are dictionaries. String_vectors are lists of strings. + +EXCEPTIONS AND ERROR HANDLING: +------------------------------ + +Currently synchronous calls indicate failure by throwing an exception (note that this includes the synchronous calls to set up asynchronous completion callbacks!). Success is returned as an integer. + +Callbacks signify failure by having the integer response code passed in. + +WHAT'S NEW IN 0.4: +------------------ + +More test coverage. + +Better reference counting, fixing at least two serious bugs. + +Out-of-range zhandles are now checked, fixing a potential security hole. + +Docstrings! Editing and cleanup required, but most of the text is there. + +zookeeper.set_watcher is now implemented correctly. + +zookeeper.client_id is now implemented correctly. zookeeper.init now respects the client_id parameter. + +get_context and set_context have been removed from the API. The context mechanism is used by PyZK to store the callables that are dispatched by C-side watchers. Messing with this from Python-side causes bugs very quickly. You should wrap all desired context up in a callable and then use zookeeper.set_watcher to attach it to the global watcher. + +Many methods now have optional parameters (usually if you can specify a watch, it's optional). The only time where genuinely optional parameters are still mandatory is when a required parameters comes after it. Currently we still respect the ZK C client parameter ordering. For example, you can simply connect with zookeeper.init("host:port") and ignore the other three parameters. + + +WHAT'S NEW IN 0.3: +------------------ + +Some tests in zkpython/test. More to follow! + +A variety of bugfixes. + +Changed the way methods return results - all responses are integers now, for the client to convert to a string if it needs. + +WHAT'S NEW IN 0.2: +------------------ + +The asynchronous API is now implemented (see zookeeper.a*). + +Most enums defined in zookeeper.h are now added as constants to the module. + +_set2 and a few other edge API calls have been implemented. The module is now nearly 100% feature complete! + +A reference count error was tracked down and killed. More probably lurk in there! + +WHAT'S NOT DONE / KNOWN ISSUES / FUTURE WORK: +--------------------------------------------- + +1. There may well be more memory leaks / reference count issues; however I am more confident that common paths are relatively safe. +2. There probably needs to be a more Pythonic Python-side wrapper for these functions (e.g. a zookeeper object, the ability to iterate through a tree of zk nodes) +3. Docstrings need a cleanup. +4. The way exceptions and error codes are returned needs looking at. Currently synchronous calls throw exceptions on everything but ZOK return, but asynchronous completions are simply passed the error code. Async. functions should never throw an exception on the C-side as they are practically impossible to catch. For the sync. functions, exceptions seem more reasonable, but some cases are certainly not exceptional. + +Bug reports / comments very welcome! + +Henry Robinson henry@cloudera.com diff --git a/src/contrib/zkpython/build.xml b/src/contrib/zkpython/build.xml new file mode 100644 index 0000000..029d4f2 --- /dev/null +++ b/src/contrib/zkpython/build.xml @@ -0,0 +1,198 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/contrib/zkpython/ivy.xml b/src/contrib/zkpython/ivy.xml new file mode 100644 index 0000000..6931f46 --- /dev/null +++ b/src/contrib/zkpython/ivy.xml @@ -0,0 +1,43 @@ + + + + + + + + ZKPython + + + + + + + + + + + + + + + + + + diff --git a/src/contrib/zkpython/src/c/pyzk_docstrings.h b/src/contrib/zkpython/src/c/pyzk_docstrings.h new file mode 100644 index 0000000..1f38d53 --- /dev/null +++ b/src/contrib/zkpython/src/c/pyzk_docstrings.h @@ -0,0 +1,594 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifndef PYZK_DOCSTRINGS_H +#define PYZK_DOCSTRINGS_H + +const char pyzk_acreate_doc[] = +"Create a node asynchronously.\n" +"\n" +"This method will create a node in ZooKeeper. A node can only be created if\n" +"it does not already exists. The Create Flags affect the creation of nodes.\n" +"If EPHEMERAL flag is set, the node will automatically get removed if the\n" +"client session goes away. If the SEQUENCE flag is set, a unique\n" +"monotonically increasing sequence number is appended to the path name.\n" +"\n" +" zh: the zookeeper handle obtained by a call to zookeeper.init\n" +" path: The name of the node. Expressed as a file name with slashes \n" +"separating ancestors of the node.\n" +" value: The data to be stored in the node.\n" +" acl: The initial ACL of the node. If None, the ACL of the parent will be\n" +" used.\n" +"\n" +" (Subsequent parameters are optional)\n" +" flags: this parameter can be set to 0 for normal create or an OR\n" +" of the Create Flags\n" +" completion: the routine to invoke when the request completes. The completion\n" +"will be triggered with one of the following codes passed in as the rc argument:\n" +"OK operation completed successfully\n" +"NONODE the parent node does not exist.\n" +"NODEEXISTS the node already exists\n" +"NOAUTH the client does not have permission.\n" +"NOCHILDRENFOREPHEMERALS cannot create children of ephemeral nodes.\n" +"\n" +"RETURNS:\n" +"Returns OK on success or throws of the following errcodes on failure:\n" +"EXCEPTIONS:\n" +"BADARGUMENTS - invalid input parameters\n" +"INVALIDSTATE - zhandle state is either SESSION_EXPIRED_STATE or AUTH_FAILED_STATE\n" +"MARSHALLINGERROR - failed to marshall a request; possibly, out of memory"; + +static const char pyzk_client_id_doc[] = +"Return the client session id, only valid if the connections\n" +" is currently connected (ie. last watcher state is CONNECTED_STATE)"; + +static const char pyzk_state_doc[] = +"Get the state of the zookeeper connection.\n" + "The return value will be one of the State Consts."; + +static const char pyzk_adelete_doc[] = +" Delete a node in zookeeper.\n" +"\n" +" zh: the zookeeper handle obtained by a call to zookeeper.init\n" +" path: the name of the node. Expressed as a file name with slashes \n" +"separating ancestors of the node.\n" +"\n" +"(Subsequent parameters are optional)\n" +" version: the expected version of the node. The function will fail if the\n" +" actual version of the node does not match the expected version.\n" +" If -1 is used the version check will not take place. \n" +" completion: the routine to invoke when the request completes. The completion\n" +"will be triggered with one of the following codes passed in as the rc argument:\n" +"OK operation completed successfully\n" +"NONODE the node does not exist.\n" +"NOAUTH the client does not have permission.\n" +"BADVERSION expected version does not match actual version.\n" +"NOTEMPTY children are present; node cannot be deleted.\n" +"Returns OK on success or one of the following errcodes on failure:\n" +"BADARGUMENTS - invalid input parameters\n" +"INVALIDSTATE - zhandle state is either SESSION_EXPIRED_STATE or AUTH_FAILED_STATE\n" + "MARSHALLINGERROR - failed to marshall a request; possibly, out of memory"; + +static const char pyzk_aexists_doc[] = +" checks the existence of a node in zookeeper.\n" +"\n" +" zh the zookeeper handle obtained by a call to zookeeper.init\n" +" path the name of the node. Expressed as a file name with slashes \n" +"separating ancestors of the node.\n" +"\n" +"(Subsequent parameters are optional)\n" +" watch: if not None, a watch will be set at the server to notify the \n" +"client if the node changes. The watch will be set even if the node does not \n" +"exist. This allows clients to watch for nodes to appear.\n" +"\n" +" completion: the routine to invoke when the request completes. The completion\n" +"will be triggered with one of the following codes passed in as the rc argument:\n" +" OK operation completed successfully\n" +" NONODE the node does not exist.\n" +" NOAUTH the client does not have permission.\n" +" data the data that will be passed to the completion routine when the \n" +"function completes.\n" +" OK on success or one of the following errcodes on failure:\n" +" BADARGUMENTS - invalid input parameters\n" +" INVALIDSTATE - zhandle state is either SESSION_EXPIRED_STATE or AUTH_FAILED_STATE\n" +" MARSHALLINGERROR - failed to marshall a request; possibly, out of memory"; + +static const char pyzk_aget_doc[] = +"Gets the data associated with a node.\n" +"\n" +" zh the zookeeper handle obtained by a call to zookeeper.init\n" +" path the name of the node. Expressed as a file name with slashes \n" +"separating ancestors of the node.\n" +"\n" +"(Subsequent parameters are optional)\n" +" watcher if not None, a watch will be set at the server to notify \n" +"the client if the node changes.\n" +" completion: the routine to invoke when the request completes. The completion\n" +"will be triggered with one of the following codes passed in as the rc argument:\n" +" OK operation completed successfully\n" +" NONODE the node does not exist.\n" +" NOAUTH the client does not have permission.\n" +" data the data that will be passed to the completion routine when \n" +"the function completes.\n" +"Returns OK on success or one of the following errcodes on failure:\n" +" BADARGUMENTS - invalid input parameters\n" +" INVALIDSTATE - zhandle state is either in SESSION_EXPIRED_STATE or AUTH_FAILED_STATE\n" + " MARSHALLINGERROR - failed to marshall a request; possibly, out of memory"; + +static const char pyzk_aset_doc[] = +" Sets the data associated with a node.\n" +"\n" +" zh the zookeeper handle obtained by a call to zookeeper.init\n" +" path the name of the node. Expressed as a file name with slashes \n" +"separating ancestors of the node.\n" +" buffer the buffer holding data to be written to the node.\n" +" buflen the number of bytes from buffer to write.\n" +"\n" +"(Subsequent parameters are optional)\n" +" version the expected version of the node. The function will fail if \n" +"the actual version of the node does not match the expected version. If -1 is \n" +"used the version check will not take place.\n" +"completion: If None, \n" +"the function will execute synchronously. Otherwise, the function will return \n" +"immediately and invoke the completion routine when the request completes.\n" +" completion the routine to invoke when the request completes. The completion\n" +"will be triggered with one of the following codes passed in as the rc argument:\n" +"OK operation completed successfully\n" +"NONODE the node does not exist.\n" +"NOAUTH the client does not have permission.\n" +"BADVERSION expected version does not match actual version.\n" +" data the data that will be passed to the completion routine when \n" +"the function completes.\n" +"Returns OK on success or one of the following errcodes on failure:\n" +"BADARGUMENTS - invalid input parameters\n" +"INVALIDSTATE - zhandle state is either SESSION_EXPIRED_STATE or AUTH_FAILED_STATE\n" +"MARSHALLINGERROR - failed to marshall a request; possibly, out of memory"; + +static const char pyzk_aget_children_doc[] = +" Lists the children of a node.\n" +"\n" +"This function is similar to zoo_aget_children except it allows one specify \n" +"a watcher object rather than a boolean watch flag.\n" +" \n" +" zh the zookeeper handle obtained by a call to zookeeper.init\n" +" path the name of the node. Expressed as a file name with slashes \n" +"separating ancestors of the node.\n" +"\n" +"(Subsequent parameters are optional)\n" +" watcher if non-null, a watch will be set at the server to notify \n" +"the client if the node changes.\n" +"\n" +" completion the routine to invoke when the request completes. The completion\n" +"will be triggered with one of the following codes passed in as the rc argument:\n" +"OK operation completed successfully\n" +"NONODE the node does not exist.\n" +"NOAUTH the client does not have permission.\n" +"\n" +"Returns OK on success or one of the following errcodes on failure:\n" +"BADARGUMENTS - invalid input parameters\n" +"INVALIDSTATE - zhandle state is either SESSION_EXPIRED_STATE or AUTH_FAILED_STATE\n" +"MARSHALLINGERROR - failed to marshall a request; possibly, out of memory"; + +static const char pyzk_async_doc[] = +" Flush leader channel.\n" +"\n" +" zh the zookeeper handle obtained by a call to zookeeper.init\n" +" path the name of the node. Expressed as a file name with slashes\n" +"separating ancestors of the node.\n" +" completion the routine to invoke when the request completes. The completion\n" +"will be triggered with one of the following codes passed in as the rc argument:\n" +"OK operation completed successfully\n" +"NONODE the node does not exist.\n" +"NOAUTH the client does not have permission.\n" +"\n" +"Returns OK on success or one of the following errcodes on failure:\n" +"BADARGUMENTS - invalid input parameters\n" +"INVALIDSTATE - zhandle state is either SESSION_EXPIRED_STATE or AUTH_FAILED_STATE\n" + "MARSHALLINGERROR - failed to marshall a request; possibly, out of memory"; + +const static char pyzk_aget_acl_doc[] = +" Gets the acl associated with a node.\n" +"\n" +" zh: the zookeeper handle obtained by a call to zookeeper.init\n" +" path: the name of the node. Expressed as a file name with slashes \n" +"separating ancestors of the node.\n" +"\n" +"(Subsequent parameters are optional)\n" +" completion: the routine to invoke when the request completes. The completion\n" +"will be triggered with one of the following codes passed in as the rc argument:\n" +"OK operation completed successfully\n" +"NONODE the node does not exist.\n" +"NOAUTH the client does not have permission.\n" +"\n" +"Returns:\n" +" OK on success or one of the following errcodes on failure:\n" +" BADARGUMENTS - invalid input parameters\n" +" INVALIDSTATE - zhandle state is either SESSION_EXPIRED_STATE or AUTH_FAILED_STATE\n" +" MARSHALLINGERROR - failed to marshall a request; possibly, out of memory"; + +const char pyzk_aset_acl_doc[] = +" Sets the acl associated with a node.\n" +"\n" +"PARAMETERS:\n" +" zh: the zookeeper handle obtained by a call to zookeeper.init\n" +" path: the name of the node. Expressed as a file name with slashes \n" +"separating ancestors of the node.\n" +" buffer: the buffer holding the acls to be written to the node.\n" +" completion: the routine to invoke when the request completes. The completion\n" +"will be triggered with one of the following codes passed in as the rc argument:\n" +"OK operation completed successfully\n" +"NONODE the node does not exist.\n" +"NOAUTH the client does not have permission.\n" +"INVALIDACL invalid ACL specified\n" +"BADVERSION expected version does not match actual version.\n" +"" +" Returns OK on success or one of the following errcodes on failure:\n" +" BADARGUMENTS - invalid input parameters\n" +" INVALIDSTATE - zhandle state is either SESSION_EXPIRED_STATE or AUTH_FAILED_STATE\n" +" MARSHALLINGERROR - failed to marshall a request; possibly, out of memory"; + +const char pyzk_zerror_doc[] = +"Returns an error string corresponding to an integer error code.\n" +"\n" +"PARAMETERS:\n" +" err: Error code\n" +"RETURNS:\n" + " string corresponding to the return code\n"; + +const char pyzk_add_auth_doc[] = +" specify application credentials.\n" +"\n" +"The application calls this function to specify its credentials for purposes\n" +"of authentication. The server will use the security provider specified by \n" +"the scheme parameter to authenticate the client connection. If the \n" +"authentication request has failed:\n" +"- the server connection is dropped\n" +"- the watcher is called with the AUTH_FAILED_STATE value as the state \n" +"parameter.\n" +"\n" +"PARAMETERS:\n" +" zh: the zookeeper handle obtained by a call to zookeeper.init\n" +" scheme the id of authentication scheme. Natively supported:\n" +"'digest' password-based authentication\n" +" cert: application credentials. The actual value depends on the scheme.\n" +" completion: the routine to invoke when the request completes. One of \n" +"the following result codes may be passed into the completion callback:\n" +"OK operation completed successfully\n" +"AUTHFAILED authentication failed \n" +"\n" +"RETURNS:\n" +"OK on success or one of the following errcodes on failure:\n" +"BADARGUMENTS - invalid input parameters\n" +"INVALIDSTATE - zhandle state is either SESSION_EXPIRED_STATE or AUTH_FAILED_STATE\n" +"MARSHALLINGERROR - failed to marshall a request; possibly, out of memory\n" + "SYSTEMERROR - a system error occurred\n"; + +const char pyzk_is_unrecoverable_doc[] = +" checks if the current zookeeper connection state can't be recovered.\n" +"\n" +" The application must close the zhandle and try to reconnect.\n" +"\n" +"PARAMETERS:\n" +" zh the zookeeper handle (see zookeeper.init)\n" +"\n" +"RETURNS:\n" + "True if connection is unrecoverable, otherwise False\n"; + +const char pyzk_set_debug_level_doc[] = +"\brief sets the debugging level for the library \n" +"\n" +"PARAMETERS:\n" +" logLevel: One of LOG_LEVEL_ERROR, LOG_LEVEL_WARN, LOG_LEVEL_INFO or LOG_LEVEL_DEBUG\n" +"\n" +"RETURNS:\n" + " None\n"; + +static const char pyzk_set_log_stream_doc[] = +" sets the stream to be used by the library for logging \n" +"\n" +"The zookeeper library uses stderr as its default log stream. Applications\n" +"must make sure the stream is writable. Passing in NULL resets the stream \n" + "to its default value (stderr).\n" +"\n" +"PARAMETERS:\n" +" logStream: a writable file object\n" +"RETURNS:\n" +" None\n"; + +static const char pyzk_deterministic_conn_order_doc[] = +" enable/disable quorum endpoint order randomization\n" +"\n" +"If passed a non-zero value, will make the client connect to quorum peers\n" +"in the order as specified in the zookeeper.init() call.\n" +"A zero value causes zookeeper.init() to permute the peer endpoints\n" +"which is good for more even client connection distribution among the \n" +"quorum peers.\n" +"PARAMETERS:\n" +" yesOrNo\n" +"\n" +"RETURNS:\n" + " None\n"; + +static const char pyzk_create_doc[] = +" create a node synchronously.\n" +"\n" +"This method will create a node in ZooKeeper. A node can only be created if\n" +"it does not already exists. The Create Flags affect the creation of nodes.\n" +"If the EPHEMERAL flag is set, the node will automatically get removed if the\n" +"client session goes away. If the SEQUENCE flag is set, a unique\n" +"monotonically increasing sequence number is appended to the path name.\n" +"\n" +"PARAMETERS:\n" +" zh: the zookeeper handle obtained by a call to zookeeper.init\n" +" path: The name of the node. Expressed as a file name with slashes \n" +"separating ancestors of the node.\n" +" value: The data to be stored in the node.\n" +" acl: The initial ACL of the node. If null, the ACL of the parent will be\n" +" used.\n" +" flags: this parameter can be set to 0 for normal create or an OR\n" +" of the Create Flags\n" +" realpath: the real path that is created (this might be different than the\n" +" path to create because of the SEQUENCE flag.\n" +" the maximum length of real path you would want.\n" +"\n" +"RETURNS:\n" +" The actual znode path that was created (may be different from path due to use of SEQUENTIAL\n" +" flag).\n" +"EXCEPTIONS:\n" +" NONODE the parent node does not exist.\n" +" NODEEXISTS the node already exists\n" +" NOAUTH the client does not have permission.\n" +" NOCHILDRENFOREPHEMERALS cannot create children of ephemeral nodes.\n" +" BADARGUMENTS - invalid input parameters\n" +" INVALIDSTATE - zhandle state is either SESSION_EXPIRED_STATE or AUTH_FAILED_STATE\n" + " MARSHALLINGERROR - failed to marshall a request; possibly, out of memory\n"; + +static const char pyzk_delete_doc[] = +" delete a node in zookeeper synchronously.\n" +"\n" +"PARAMETERS:\n" +" zh the zookeeper handle obtained by a call to zookeeper.init\n" +" path the name of the node. Expressed as a file name with slashes \n" +"separating ancestors of the node.\n" +"\n" +"(Subsequent parameters are optional)\n" +" version: the expected version of the node. The function will fail if the\n" +" actual version of the node does not match the expected version.\n" +" If -1 (the default) is used the version check will not take place. \n" +"\n" +"RETURNS:\n" +"One of the following values is returned.\n" +"OK operation completed successfully\n" +"NONODE the node does not exist.\n" +"NOAUTH the client does not have permission.\n" +"BADVERSION expected version does not match actual version.\n" +"NOTEMPTY children are present; node cannot be deleted.\n" +"BADARGUMENTS - invalid input parameters\n" +"INVALIDSTATE - zhandle state is either SESSION_EXPIRED_STATE or AUTH_FAILED_STATE\n" + "MARSHALLINGERROR - failed to marshall a request; possibly, out of memory\n"; + +static const char pyzk_exists_doc[] = +" checks the existence of a node in zookeeper synchronously.\n" +"\n" +"PARAMETERS:\n" +" zh: the zookeeper handle obtained by a call to zookeeper.init\n" +" path: the name of the node. Expressed as a file name with slashes \n" +"separating ancestors of the node.\n" +"\n" +"(Subsequent parameters are optional)\n" +" watch: if nonzero, a watch will be set at the server to notify the \n" +"client if the node changes. The watch will be set even if the node does not \n" +"exist. This allows clients to watch for nodes to appear.\n" +"\n" +"RETURNS:\n" +" the return stat value of the node.\n" +"EXCEPTIONS:\n" +"OK operation completed successfully\n" +"NONODE the node does not exist.\n" +"NOAUTH the client does not have permission.\n" +"BADARGUMENTS - invalid input parameters\n" +"INVALIDSTATE - zhandle state is either SESSION_EXPIRED_STATE or AUTH_FAILED_STATE\n" + "MARSHALLINGERROR - failed to marshall a request; possibly, out of memory\n"; + + +static const char pyzk_get_children_doc[] = +" lists the children of a node synchronously.\n" +"\n" +"PARAMETERS:\n" +" zh: the zookeeper handle obtained by a call to zookeeper.init\n" +" path: the name of the node. Expressed as a file name with slashes \n" +"separating ancestors of the node.\n" +"\n" +"(subsequent parameters are optional)\n" +" watcher: if non-null, a watch will be set at the server to notify \n" +"the client if the node changes.\n" +"\n" +"RETURNS:\n" +" A list of znode names\n" +"EXCEPTIONS:\n" +"NONODE the node does not exist.\n" +"NOAUTH the client does not have permission.\n" +"BADARGUMENTS - invalid input parameters\n" +"INVALIDSTATE - zhandle state is either SESSION_EXPIRED_STATE or AUTH_FAILED_STATE\n" + "MARSHALLINGERROR - failed to marshall a request; possibly, out of memory\n"; + +static const char pyzk_set_doc[] = +"\n" +" sets the data associated with a node. See set2 function if\n" +"you require access to the stat information associated with the znode.\n" +"\n" +"PARAMETERS:\n" +" zh: the zookeeper handle obtained by a call to zookeeper.init\n" +" path: the name of the node. Expressed as a file name with slashes \n" +"separating ancestors of the node.\n" +" buffer: the buffer holding data to be written to the node.\n" +"\n" +"(subsequent parameters are optional)\n" +" version: the expected version of the node. The function will fail if \n" +"the actual version of the node does not match the expected version. If -1 is \n" +"used the version check will not take place. \n" +"\n" +"RETURNS:\n" +" the return code for the function call.\n" +"OK operation completed successfully\n" +"EXCEPTIONS:\n" +"NONODE the node does not exist.\n" +"NOAUTH the client does not have permission.\n" +"BADVERSION expected version does not match actual version.\n" +"BADARGUMENTS - invalid input parameters\n" +"INVALIDSTATE - zhandle state is either SESSION_EXPIRED_STATE or AUTH_FAILED_STATE\n" + "MARSHALLINGERROR - failed to marshall a request; possibly, out of memory\n"; + +static const char pyzk_get_acl_doc[] = +" gets the acl associated with a node synchronously.\n" +"\n" +"PARAMETERS:\n" +" zh: the zookeeper handle obtained by a call to zookeeper.init\n" +" path: the name of the node. Expressed as a file name with slashes \n" +"separating ancestors of the node.\n" +" acl: the return value of acls on the path.\n" +"RETURNS:" +" returns the stat of the path specified.\n" +"EXCEPTIONS:" +"NONODE the node does not exist.\n" +"NOAUTH the client does not have permission.\n" +"BADARGUMENTS - invalid input parameters\n" +"INVALIDSTATE - zhandle state is either SESSION_EXPIRED_STATE or AUTH_FAILED_STATE\n" + "MARSHALLINGERROR - failed to marshall a request; possibly, out of memory\n"; + + +static const char pyzk_set_acl_doc[] = +" sets the acl associated with a node synchronously.\n" +"\n" +"PARAMETERS:\n" +" zh: the zookeeper handle obtained by a call to zookeeper.init\n" +" path: the name of the node. Expressed as a file name with slashes \n" +"separating ancestors of the node.\n" +" version: the expected version of the path.\n" +" acl: the acl to be set on the path. \n" +"\n" +"RETURNS:\n" +"OK operation completed successfully\n" +"EXCEPTIONS:\n" +"NONODE the node does not exist.\n" +"NOAUTH the client does not have permission.\n" +"INVALIDACL invalid ACL specified\n" +"BADVERSION expected version does not match actual version.\n" +"BADARGUMENTS - invalid input parameters\n" +"INVALIDSTATE - zhandle state is either SESSION_EXPIRED_STATE or AUTH_FAILED_STATE\n" + "MARSHALLINGERROR - failed to marshall a request; possibly, out of memory\n"; + +static const char pyzk_close_doc[] = +" close the zookeeper handle and free up any resources.\n" +"\n" +"After this call, the client session will no longer be valid. The function\n" +"will flush any outstanding send requests before return. As a result it may \n" +"block.\n" +"\n" +"This method should only be called only once on a zookeeper handle. Calling\n" +"twice will cause undefined (and probably undesirable behavior).\n" +"\n" +"PARAMETERS:\n" +" zh: the zookeeper handle obtained by a call to zookeeper.init\n" +"RETURNS:\n" +"Regardless of the error code returned, the zhandle \n" +"will be destroyed and all resources freed. \n" +"OK - success\n" +"EXCEPTIONS:\n" +"BADARGUMENTS - invalid input parameters\n" +"MARSHALLINGERROR - failed to marshall a request; possibly, out of memory\n" +"OPERATIONTIMEOUT - failed to flush the buffers within the specified timeout.\n" +"CONNECTIONLOSS - a network error occurred while attempting to send request to server\n" + "SYSTEMERROR -- a system (OS) error occurred; it's worth checking errno to get details\n"; + +static const char pyzk_set2_doc[] = +"\n" +" sets the data associated with a node, and returns the associated stat structure.\n" +"\n" +"PARAMETERS:\n" +" zh: the zookeeper handle obtained by a call to zookeeper.init\n" +" path: the name of the node. Expressed as a file name with slashes \n" +"separating ancestors of the node.\n" +" buffer: the buffer holding data to be written to the node.\n" +"\n" +"(subsequent parameters are optional)\n" +" version: the expected version of the node. The function will fail if \n" +"the actual version of the node does not match the expected version. If -1 is \n" +"used the version check will not take place. \n" +"\n" +"RETURNS:\n" +" the stat structure for the target znode\n" +"OK operation completed successfully\n" +"EXCEPTIONS:\n" +"NONODE the node does not exist.\n" +"NOAUTH the client does not have permission.\n" +"BADVERSION expected version does not match actual version.\n" +"BADARGUMENTS - invalid input parameters\n" +"INVALIDSTATE - zhandle state is either SESSION_EXPIRED_STATE or AUTH_FAILED_STATE\n" + "MARSHALLINGERROR - failed to marshall a request; possibly, out of memory\n"; + +static const char pyzk_init_doc[] = +"This method creates a new handle and a zookeeper session that corresponds\n" +"to that handle. Session establishment is asynchronous, meaning that the\n" +"session should not be considered established until (and unless) an\n" +"event of state CONNECTED_STATE is received.\n" +"PARAMETERS:\n" +" host: comma separated host:port pairs, each corresponding to a zk\n" +" server. e.g. '127.0.0.1:3000,127.0.0.1:3001,127.0.0.1:3002'\n" +"\n" +"(subsequent parameters are optional)\n" +" fn: the global watcher callback function. When notifications are\n" +" triggered this function will be invoked.\n" +" recv_timeout: \n" +" (clientid, passwd)\n" +" clientid the id of a previously established session that this\n" +" client will be reconnecting to. Clients can access the session id of an established, valid,\n" +" connection by calling zoo_client_id. If\n" +" the specified clientid has expired, or if the clientid is invalid for \n" +" any reason, the returned zhandle_t will be invalid -- the zhandle_t \n" +" state will indicate the reason for failure (typically\n" +" EXPIRED_SESSION_STATE).\n" +"\n" +"RETURNS:\n" +" an integer handle. If it fails to create \n" +" a new zhandle the function throws an exception.\n"; + +static const char pyzk_get_doc[] = +" gets the data associated with a node synchronously.\n" +"\n" +"\n" +"PARAMETERS:\n" +" zh the zookeeper handle obtained by a call to zookeeper.init\n" +" path the name of the node. Expressed as a file name with slashes \n" +"separating ancestors of the node.\n" +"\n" +"(subsequent parameters are optional)\n" +" watcher if not None, a watch will be set at the server to notify \n" +" the client if the node changes.\n" +" bufferlen: This value defaults to 1024*1024 - 1Mb. This method returns \n" +" the minimum of bufferlen and the true length of the znode's data. \n" +"RETURNS:\n" +" the data associated with the node\n" +"OK operation completed successfully\n" +"NONODE the node does not exist.\n" +"NOAUTH the client does not have permission.\n" +"BADARGUMENTS - invalid input parameters\n" +"INVALIDSTATE - zhandle state is either in SESSION_EXPIRED_STATE or AUTH_FAILED_STATE\n" + "MARSHALLINGERROR - failed to marshall a request; possibly, out of memory\n"; + +#endif diff --git a/src/contrib/zkpython/src/c/zookeeper.c b/src/contrib/zkpython/src/c/zookeeper.c new file mode 100644 index 0000000..4474661 --- /dev/null +++ b/src/contrib/zkpython/src/c/zookeeper.c @@ -0,0 +1,1664 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#include +#include +#include + +////////////////////////////////////////////// +// EXCEPTIONS +PyObject *ZooKeeperException = NULL; +PyObject *SystemErrorException; +PyObject *RuntimeInconsistencyException; +PyObject *DataInconsistencyException; +PyObject *ConnectionLossException; +PyObject *MarshallingErrorException; +PyObject *UnimplementedException; +PyObject *OperationTimeoutException; +PyObject *BadArgumentsException; +PyObject *InvalidStateException; + +PyObject *ApiErrorException; +PyObject *NoNodeException; +PyObject *NoAuthException; +PyObject *NodeExistsException; +PyObject *BadVersionException; +PyObject *NoChildrenForEphemeralsException; +PyObject *NotEmptyException; +PyObject *SessionExpiredException; +PyObject *SessionMovedException; +PyObject *InvalidCallbackException; +PyObject *InvalidACLException; +PyObject *AuthFailedException; +PyObject *ClosingException; +PyObject *NothingException; + +PyObject *err_to_exception(int errcode) { + switch (errcode) { + case ZSYSTEMERROR: + return SystemErrorException; + case ZINVALIDSTATE: + return InvalidStateException; + case ZRUNTIMEINCONSISTENCY: + return RuntimeInconsistencyException; + case ZDATAINCONSISTENCY: + return DataInconsistencyException; + case ZCONNECTIONLOSS: + return ConnectionLossException; + case ZMARSHALLINGERROR: + return MarshallingErrorException; + case ZUNIMPLEMENTED: + return UnimplementedException; + case ZOPERATIONTIMEOUT: + return OperationTimeoutException; + case ZBADARGUMENTS: + return BadArgumentsException; + case ZAPIERROR: + return ApiErrorException; + case ZNONODE: + return NoNodeException; + case ZNOAUTH: + return NoAuthException; + case ZBADVERSION: + return BadVersionException; + case ZNOCHILDRENFOREPHEMERALS: + return NoChildrenForEphemeralsException; + case ZNODEEXISTS: + return NodeExistsException; + case ZINVALIDACL: + return InvalidACLException; + case ZAUTHFAILED: + return AuthFailedException; + case ZNOTEMPTY: + return NotEmptyException; + case ZSESSIONEXPIRED: + return SessionExpiredException; + case ZINVALIDCALLBACK: + return InvalidCallbackException; + case ZSESSIONMOVED: + return SessionMovedException; + case ZCLOSING: + return ClosingException; + case ZNOTHING: + return NothingException; + case ZOK: + default: + return NULL; + } +} + + +#define CHECK_ZHANDLE(z) if ( (z) < 0 || (z) >= num_zhandles) { \ + PyErr_SetString( ZooKeeperException, "zhandle out of range" ); \ +return NULL; \ +} else if ( zhandles[(z)] == NULL ) { \ + PyErr_SetString(ZooKeeperException, "zhandle already freed"); \ + return NULL; \ + } + +/* Contains all the state required for a watcher callback - these are + passed to the *dispatch functions as void*, cast to pywatcher_t and + then their callback member is invoked if not NULL */ +typedef struct { + int zhandle; + PyObject *callback; + int permanent; +}pywatcher_t; + +/* This array exists because we need to ref. count the global watchers + for each connection - but they're inaccessible without pulling in + zk_adaptor.h, which I'm trying to avoid. */ +static pywatcher_t **watchers; + +/* We keep an array of zhandles available for use. When a zhandle is + correctly closed, the C client frees the memory so we set the + zhandles[i] entry to NULL. This entry can then be re-used. */ +static zhandle_t** zhandles = NULL; +static int num_zhandles = 0; +static int max_zhandles = 0; +#define REAL_MAX_ZHANDLES 32768 + +/* -------------------------------------------------------------------------- */ +/* zhandles - unique connection ids - tracking */ +/* -------------------------------------------------------------------------- */ + + +/* Allocates an initial zhandle and watcher array */ +int init_zhandles(int num) { + zhandles = malloc(sizeof(zhandle_t*)*num); + watchers = malloc(sizeof(pywatcher_t*)*num); + if (zhandles == NULL || watchers == NULL) { + return 0; + } + max_zhandles = num; + num_zhandles = 0; + memset(zhandles, 0, sizeof(zhandle_t*)*max_zhandles); + return 1; +} + +/* Note that the following zhandle functions are not thread-safe. The + C-Python runtime does not seem to pre-empt a thread that is in a C + module, so there's no need for synchronisation. */ + +/* Doubles the size of the zhandle / watcher array Returns 0 if the + new array would be >= REAL_MAX_ZHANDLES in size. Called when zhandles + is full. Returns 0 if allocation failed or if max num zhandles + exceeded. */ +int resize_zhandles(void) { + zhandle_t **tmp = zhandles; + pywatcher_t ** wtmp = watchers; + if (max_zhandles >= REAL_MAX_ZHANDLES >> 1) { + return 0; + } + max_zhandles *= 2; + zhandles = malloc(sizeof(zhandle_t*)*max_zhandles); + if (zhandles == NULL) { + PyErr_SetString(PyExc_MemoryError, "malloc for new zhandles failed"); + return 0; + } + memset(zhandles, 0, sizeof(zhandle_t*)*max_zhandles); + memcpy(zhandles, tmp, sizeof(zhandle_t*)*max_zhandles/2); + + watchers = malloc(sizeof(pywatcher_t*)*max_zhandles); + if (watchers == NULL) { + PyErr_SetString(PyExc_MemoryError, "malloc for new watchers failed"); + return 0; + } + memset(watchers, 0, sizeof(pywatcher_t*)*max_zhandles); + memcpy(watchers, wtmp, sizeof(pywatcher_t*)*max_zhandles/2); + + free(wtmp); + free(tmp); + return 1; +} + +/* Find a free zhandle - this iterates through the list of open + zhandles, but we expect it to be infrequently called. There are + optimisations that can be made if this turns out to be problematic. + Returns -1 if no free handle is found - resize_handles() can be + called in that case. */ +unsigned int next_zhandle(void) { + int i = 0; + for (i=0;izhandle = zh; ret->callback = cb; ret->permanent = permanent; + return ret; +} + +/* Releases the reference taken in create_pywatcher to the callback, + then frees the allocated pywatcher_t* */ +void free_pywatcher(pywatcher_t *pw) +{ + if (pw == NULL) { + return; + } + Py_DECREF(pw->callback); + + free(pw); +} + +/* Constructs a new stat object. Returns Py_None if stat == NULL or a + dictionary containing all the stat information otherwise. In either + case, takes a reference to the returned object. */ +PyObject *build_stat( const struct Stat *stat ) +{ + if (stat == NULL) { + Py_INCREF(Py_None); + return Py_None; + } + return Py_BuildValue( "{s:K, s:K, s:K, s:K," + "s:i, s:i, s:i, s:K," + "s:i, s:i, s:K}", + "czxid", stat->czxid, + "mzxid", stat->mzxid, + "ctime", stat->ctime, + "mtime", stat->mtime, + "version", stat->version, + "cversion", stat->cversion, + "aversion", stat->aversion, + "ephemeralOwner", stat->ephemeralOwner, + "dataLength", stat->dataLength, + "numChildren", stat->numChildren, + "pzxid", stat->pzxid ); +} + +/* Creates a new list of strings from a String_vector. Returns the + empty list if the String_vector is NULL. Takes a reference to the + returned PyObject and gives that reference to the caller. */ +PyObject *build_string_vector(const struct String_vector *sv) +{ + PyObject *ret; + if (!sv) { + return PyList_New(0); + } + + ret = PyList_New(sv->count); + if (ret) { + int i; + for (i=0;icount;++i) { +#if PY_MAJOR_VERSION >= 3 + PyObject *s = PyUnicode_FromString(sv->data[i]); +#else + PyObject *s = PyString_FromString(sv->data[i]); +#endif + if (!s) { + if (ret != Py_None) { + Py_DECREF(ret); + } + ret = NULL; + break; + } + PyList_SetItem(ret, i, s); + } + } + return ret; +} + +/* Returns 1 if the PyObject is a valid representation of an ACL, and + 0 otherwise. */ +int check_is_acl(PyObject *o) { + int i; + PyObject *entry; + if (o == NULL) { + return 0; + } + if (!PyList_Check(o)) { + return 0; + } + for (i=0;icount); + int i; + for (i=0;icount;++i) { + PyObject *acl = Py_BuildValue( "{s:i, s:s, s:s}", + "perms", acls->data[i].perms, + "scheme", acls->data[i].id.scheme, + "id", acls->data[i].id.id ); + PyList_SetItem(ret, i, acl); + } + return ret; +} + +/* Parse the Python representation of an ACL list into an ACL_vector + (which needs subsequent freeing) */ +int parse_acls(struct ACL_vector *acls, PyObject *pyacls) +{ + PyObject *a; + int i; + if (acls == NULL || pyacls == NULL) { + PyErr_SetString(PyExc_ValueError, "acls or pyacls NULL in parse_acls"); + return 0; + } + + acls->count = PyList_Size( pyacls ); + + // Is this a list? If not, we can't do anything + if (PyList_Check(pyacls) == 0) { + PyErr_SetString(InvalidACLException, "List of ACLs required in parse_acls"); + return 0; + } + + acls->data = (struct ACL *)calloc(acls->count, sizeof(struct ACL)); + if (acls->data == NULL) { + PyErr_SetString(PyExc_MemoryError, "calloc failed in parse_acls"); + return 0; + } + + for (i=0;icount;++i) { + a = PyList_GetItem(pyacls, i); + // a is now a dictionary + PyObject *perms = PyDict_GetItemString( a, "perms" ); +#if PY_MAJOR_VERSION >= 3 + acls->data[i].perms = (int32_t)(PyLong_AsLong(perms)); + acls->data[i].id.id = strdup( PyUnicode_AsUnicode( PyDict_GetItemString( a, "id" ) ) ); + acls->data[i].id.scheme = strdup( PyUnicode_AsUnicode( PyDict_GetItemString( a, "scheme" ) ) ); +#else + acls->data[i].perms = (int32_t)(PyInt_AsLong(perms)); + acls->data[i].id.id = strdup( PyString_AsString( PyDict_GetItemString( a, "id" ) ) ); + acls->data[i].id.scheme = strdup( PyString_AsString( PyDict_GetItemString( a, "scheme" ) ) ); +#endif + } + return 1; +} + +/* Deallocates the memory allocated inside an ACL_vector, but not the + ACL_vector itself */ +void free_acls( struct ACL_vector *acls ) +{ + if (acls == NULL) { + return; + } + int i; + for (i=0;icount;++i) { + free(acls->data[i].id.id); + free(acls->data[i].id.scheme); + } + free(acls->data); +} + +/* -------------------------------------------------------------------------- */ +/* Watcher and callback implementation */ +/* -------------------------------------------------------------------------- */ + +/* Every watcher invocation goes through this dispatch point, which + a) acquires the global interpreter lock + + b) unpacks the PyObject to call from the passed context pointer, + which handily includes the index of the relevant zookeeper handle + to pass back to Python. + + c) Makes the call into Python, checking for error conditions which + we are responsible for detecting and doing something about (we just + print the error and plough right on) + + d) releases the lock after freeing up the context object, which is + only used for one watch invocation (watches are one-shot, unless + 'permanent' != 0) +*/ +void watcher_dispatch(zhandle_t *zzh, int type, int state, + const char *path, void *context) +{ + PyGILState_STATE gstate; + pywatcher_t *pyw = (pywatcher_t*)context; + PyObject *callback = pyw->callback; + if (callback == NULL) { + // This is unexpected + char msg[256]; + sprintf(msg, "pywatcher: %d %p %d", pyw->zhandle, pyw->callback, pyw->permanent); + PyErr_SetString(PyExc_ValueError, msg); + return; + } + + gstate = PyGILState_Ensure(); + PyObject *arglist = Py_BuildValue("(i,i,i,s)", pyw->zhandle,type, state, path); + if (PyObject_CallObject((PyObject*)callback, arglist) == NULL) { + PyErr_Print(); + } + Py_DECREF(arglist); + if (pyw->permanent == 0 && (type != ZOO_SESSION_EVENT || state < 0)) { + free_pywatcher(pyw); + } + PyGILState_Release(gstate); +} + +/* The completion callbacks (from asynchronous calls) are implemented similarly */ + +/* Called when an asynchronous call that returns void completes and + dispatches user provided callback */ +void void_completion_dispatch(int rc, const void *data) +{ + PyGILState_STATE gstate; + pywatcher_t *pyw = (pywatcher_t*)data; + if (pyw == NULL) + return; + PyObject *callback = pyw->callback; + gstate = PyGILState_Ensure(); + PyObject *arglist = Py_BuildValue("(i,i)", pyw->zhandle, rc); + if (PyObject_CallObject((PyObject*)callback, arglist) == NULL) + PyErr_Print(); + Py_DECREF(arglist); + free_pywatcher(pyw); + PyGILState_Release(gstate); +} + +/* Called when an asynchronous call that returns a stat structure + completes and dispatches user provided callback */ +void stat_completion_dispatch(int rc, const struct Stat *stat, const void *data) +{ + PyGILState_STATE gstate; + pywatcher_t *pyw = (pywatcher_t*)data; + if (pyw == NULL) + return; + PyObject *callback = pyw->callback; + gstate = PyGILState_Ensure(); + PyObject *pystat = build_stat(stat); + PyObject *arglist = Py_BuildValue("(i,i,O)", pyw->zhandle,rc, pystat); + Py_DECREF(pystat); + if (PyObject_CallObject((PyObject*)callback, arglist) == NULL) + PyErr_Print(); + Py_DECREF(arglist); + free_pywatcher(pyw); + PyGILState_Release(gstate); +} + +/* Called when an asynchronous call that returns a stat structure and + some untyped data completes and dispatches user provided + callback (used by aget) */ +void data_completion_dispatch(int rc, const char *value, int value_len, const struct Stat *stat, const void *data) +{ + PyGILState_STATE gstate; + pywatcher_t *pyw = (pywatcher_t*)data; + if (pyw == NULL) + return; + PyObject *callback = pyw->callback; + gstate = PyGILState_Ensure(); + PyObject *pystat = build_stat(stat); + PyObject *arglist = Py_BuildValue("(i,i,s#,O)", pyw->zhandle,rc, value,value_len, pystat); + Py_DECREF(pystat); + + if (PyObject_CallObject((PyObject*)callback, arglist) == NULL) + PyErr_Print(); + Py_DECREF(arglist); + free_pywatcher(pyw); + PyGILState_Release(gstate); +} + +/* Called when an asynchronous call that returns a list of strings + completes and dispatches user provided callback */ +void strings_completion_dispatch(int rc, const struct String_vector *strings, const void *data) +{ + PyGILState_STATE gstate; + pywatcher_t *pyw = (pywatcher_t*)data; + if (pyw == NULL) + return; + PyObject *callback = pyw->callback; + gstate = PyGILState_Ensure(); + PyObject *pystrings = build_string_vector(strings); + if (pystrings) + { + PyObject *arglist = Py_BuildValue("(i,i,O)", pyw->zhandle, rc, pystrings); + if (arglist == NULL || PyObject_CallObject((PyObject*)callback, arglist) == NULL) + PyErr_Print(); + Py_DECREF(arglist); + } + else + PyErr_Print(); + Py_DECREF(pystrings); + free_pywatcher(pyw); + PyGILState_Release(gstate); +} + +/* Called when an asynchronous call that returns a single string + completes and dispatches user provided callback */ +void string_completion_dispatch(int rc, const char *value, const void *data) +{ + PyGILState_STATE gstate; + pywatcher_t *pyw = (pywatcher_t*)data; + if (pyw == NULL) { + return; + } + PyObject *callback = pyw->callback; + gstate = PyGILState_Ensure(); + PyObject *arglist = Py_BuildValue("(i,i,s)", pyw->zhandle,rc, value); + if (PyObject_CallObject((PyObject*)callback, arglist) == NULL) + PyErr_Print(); + Py_DECREF(arglist); + free_pywatcher(pyw); + PyGILState_Release(gstate); +} + +/* Called when an asynchronous call that returns a list of ACLs + completes and dispatches user provided callback */ +void acl_completion_dispatch(int rc, struct ACL_vector *acl, struct Stat *stat, const void *data) +{ + PyGILState_STATE gstate; + pywatcher_t *pyw = (pywatcher_t*)data; + if (pyw == NULL) { + return; + } + PyObject *callback = pyw->callback; + gstate = PyGILState_Ensure(); + PyObject *pystat = build_stat(stat); + PyObject *pyacls = build_acls(acl); + PyObject *arglist = Py_BuildValue("(i,i,O,O)", pyw->zhandle,rc, pyacls, pystat); + + Py_DECREF(pystat); + Py_DECREF(pyacls); + + if (PyObject_CallObject((PyObject*)callback, arglist) == NULL) { + PyErr_Print(); + } + Py_DECREF(arglist); + free_pywatcher(pyw); + PyGILState_Release(gstate); +} + +/* -------------------------------------------------------------------------- */ +/* ZOOKEEPER API IMPLEMENTATION */ +/* -------------------------------------------------------------------------- */ + +static PyObject *pyzookeeper_init(PyObject *self, PyObject *args) +{ + const char *host; + PyObject *watcherfn = Py_None; + int recv_timeout = 10000; + // int clientid = -1; + clientid_t cid; + cid.client_id = -1; + const char *passwd; + int handle = next_zhandle(); + if (handle == -1) { + if (resize_zhandles() == 0) { + return NULL; + } + handle = next_zhandle(); + } + + if (handle == -1) { + PyErr_SetString(ZooKeeperException,"Couldn't find a free zhandle, something is very wrong"); + return NULL; + } + + if (!PyArg_ParseTuple(args, "s|Oi(Ls)", &host, &watcherfn, &recv_timeout, &cid.client_id, &passwd)) + return NULL; + + if (cid.client_id != -1) { + strncpy(cid.passwd, passwd, 16*sizeof(char)); + } + pywatcher_t *pyw = NULL; + if (watcherfn != Py_None) { + pyw = create_pywatcher(handle, watcherfn,1); + if (pyw == NULL) { + return NULL; + } + } + watchers[handle] = pyw; + zhandle_t *zh = zookeeper_init( host, watcherfn != Py_None ? watcher_dispatch : NULL, + recv_timeout, cid.client_id == -1 ? 0 : &cid, + pyw, + 0 ); + + if (zh == NULL) + { + PyErr_SetString( ZooKeeperException, "Could not internally obtain zookeeper handle" ); + return NULL; + } + + zhandles[handle] = zh; + return Py_BuildValue( "i", handle); +} + + +/* -------------------------------------------------------------------------- */ +/* Asynchronous API implementation */ +/* -------------------------------------------------------------------------- */ + +/* Asynchronous node creation, returns integer error code */ +PyObject *pyzoo_acreate(PyObject *self, PyObject *args) +{ + int zkhid; char *path; char *value; int valuelen; + struct ACL_vector acl; int flags = 0; + PyObject *completion_callback = Py_None; + PyObject *pyacls = Py_None; + if (!PyArg_ParseTuple(args, "iss#O|iO", &zkhid, &path, + &value, &valuelen, &pyacls, &flags, + &completion_callback)) { + return NULL; + } + CHECK_ZHANDLE(zkhid); + CHECK_ACLS(pyacls); + if (parse_acls(&acl, pyacls) == 0) { + return NULL; + } + void *pyw = NULL; + if (completion_callback != Py_None) { + pyw = create_pywatcher(zkhid, completion_callback, 0); + if (pyw == NULL) { + return NULL; + } + } + int err = zoo_acreate( zhandles[zkhid], + path, + value, + valuelen, + pyacls == Py_None ? NULL : &acl, + flags, + string_completion_dispatch, + pyw); + free_acls(&acl); + if (err != ZOK) + { + PyErr_SetString(err_to_exception(err), zerror(err)); + return NULL; + } + return Py_BuildValue("i", err); +} + +/* Asynchronous node deletion, returns integer error code */ +PyObject *pyzoo_adelete(PyObject *self, PyObject *args) +{ + int zkhid; char *path; int version = -1; + PyObject *completion_callback = Py_None; + if (!PyArg_ParseTuple(args, "is|iO", &zkhid, &path, &version, &completion_callback)) + return NULL; + CHECK_ZHANDLE(zkhid); + + void *pyw = NULL; + if (completion_callback != Py_None) { + pyw = create_pywatcher(zkhid, completion_callback, 0); + if (pyw == NULL) { + return NULL; + } + } + + int err = zoo_adelete( zhandles[zkhid], + path, + version, + void_completion_dispatch, + pyw); + + if (err != ZOK) { + PyErr_SetString(err_to_exception(err), zerror(err)); + return NULL; + } + return Py_BuildValue("i", err); +} + +/* Asynchronous node existence check, returns integer error code */ +PyObject *pyzoo_aexists(PyObject *self, PyObject *args) +{ + int zkhid; char *path; + PyObject *completion_callback = Py_None; + PyObject *exists_watch = Py_None; + if (!PyArg_ParseTuple(args, "is|OO", &zkhid, &path, + &exists_watch, &completion_callback)) + return NULL; + CHECK_ZHANDLE(zkhid); + void *comp_pyw = NULL; + if (completion_callback != Py_None) { + comp_pyw = create_pywatcher(zkhid, completion_callback, 0); + if (comp_pyw == NULL) { + return NULL; + } + } + void *exist_pyw = NULL; + if (exists_watch != Py_None) { + exist_pyw = create_pywatcher(zkhid, exists_watch, 0); + if (exist_pyw == NULL) { + return NULL; + } + } + + int err = zoo_awexists( zhandles[zkhid], + path, + exists_watch != Py_None ? watcher_dispatch : NULL, + exist_pyw, + stat_completion_dispatch, + comp_pyw); + + if (err != ZOK) + { + PyErr_SetString(err_to_exception(err), zerror(err)); + return NULL; + } + return Py_BuildValue("i", err);; +} + +/* Asynchronous node data retrieval, returns integer error code */ +PyObject *pyzoo_aget(PyObject *self, PyObject *args) +{ + int zkhid; char *path; + PyObject *completion_callback = Py_None; + PyObject *get_watch = Py_None; + void *comp_pw = NULL; + void *watch_pw = NULL; + + if (!PyArg_ParseTuple(args, "is|OO", &zkhid, &path, + &get_watch, &completion_callback)) { + return NULL; + } + + CHECK_ZHANDLE(zkhid); + + if (get_watch != Py_None) { + if ((watch_pw = create_pywatcher(zkhid, get_watch, 0)) == NULL) { + return NULL; + } + } + + if (completion_callback != Py_None) { + if ((comp_pw = create_pywatcher(zkhid, completion_callback, 0)) == NULL) { + return NULL; + } + } + + int err = zoo_awget( zhandles[zkhid], + path, + get_watch != Py_None ? watcher_dispatch : NULL, + watch_pw, + data_completion_dispatch, + comp_pw); + + if (err != ZOK) { + PyErr_SetString(err_to_exception(err), zerror(err)); + return NULL; + } + return Py_BuildValue("i", err); +} + +/* Asynchronous node contents update, returns integer error code */ +PyObject *pyzoo_aset(PyObject *self, PyObject *args) +{ + int zkhid; char *path; char *buffer; int buflen; int version=-1; + PyObject *completion_callback = Py_None; + if (!PyArg_ParseTuple(args, "iss#|iO", &zkhid, &path, &buffer, &buflen, &version, &completion_callback)) + return NULL; + CHECK_ZHANDLE(zkhid); + void *pyw = NULL; + if (completion_callback != Py_None) { + pyw = create_pywatcher(zkhid, completion_callback, 0); + if (pyw == NULL) { + return NULL; + } + } + int err = zoo_aset( zhandles[zkhid], + path, + buffer, + buflen, + version, + stat_completion_dispatch, + pyw); + + if (err != ZOK) { + PyErr_SetString(err_to_exception(err), zerror(err)); + return NULL; + } + return Py_BuildValue("i", err); +} + +/* Asynchronous node child retrieval, returns integer error code */ +PyObject *pyzoo_aget_children(PyObject *self, PyObject *args) +{ + int zkhid; char *path; + PyObject *completion_callback = Py_None; + PyObject *get_watch; + if (!PyArg_ParseTuple(args, "is|OO", &zkhid, &path, + &get_watch, &completion_callback)) + return NULL; + CHECK_ZHANDLE(zkhid); + + void *get_pyw = NULL; + if (get_watch != Py_None) { + get_pyw = create_pywatcher(zkhid, get_watch, 0); + if (get_pyw == NULL) { + return NULL; + } + } + + void *pyw = NULL; + if (completion_callback != Py_None) { + pyw = create_pywatcher(zkhid, completion_callback, 0); + if (pyw == NULL) { + return NULL; + } + } + + int err = zoo_awget_children( zhandles[zkhid], + path, + get_watch != Py_None ? watcher_dispatch : NULL, + get_pyw, + strings_completion_dispatch, + pyw); + if (err != ZOK) { + PyErr_SetString(err_to_exception(err), zerror(err)); + return NULL; + } + return Py_BuildValue("i", err);; +} + +/* Asynchronous sync, returns integer error code */ +PyObject *pyzoo_async(PyObject *self, PyObject *args) +{ + int zkhid; char *path; + PyObject *completion_callback = Py_None; + if (!PyArg_ParseTuple(args, "is|O", &zkhid, &path, + &completion_callback)) { + return NULL; + } + CHECK_ZHANDLE(zkhid); + + void *pyw = NULL; + if (completion_callback != Py_None) { + pyw = create_pywatcher(zkhid, completion_callback, 0); + if (pyw == NULL) { + return NULL; + } + } + + int err = zoo_async( zhandles[zkhid], + path, + string_completion_dispatch, + pyw); + + if (err != ZOK) { + PyErr_SetString(err_to_exception(err), zerror(err)); + return NULL; + } + return Py_BuildValue("i", err);; +} + +/* Asynchronous node ACL retrieval, returns integer error code */ +PyObject *pyzoo_aget_acl(PyObject *self, PyObject *args) +{ + int zkhid; char *path; + PyObject *completion_callback = Py_None; + if (!PyArg_ParseTuple(args, "is|O", &zkhid, &path, + &completion_callback)) { + return NULL; + } + CHECK_ZHANDLE(zkhid); + + void *pyw = NULL; + if (completion_callback != Py_None) { + pyw = create_pywatcher(zkhid, completion_callback, 0); + if (pyw == NULL) { + return NULL; + } + } + + int err = zoo_aget_acl( zhandles[zkhid], + path, + acl_completion_dispatch, + pyw); + if (err != ZOK) { + PyErr_SetString(err_to_exception(err), zerror(err)); + return NULL; + } + return Py_BuildValue("i", err);; +} + +/* Asynchronous node ACL update, returns integer error code */ +PyObject *pyzoo_aset_acl(PyObject *self, PyObject *args) +{ + int zkhid; char *path; int version; + PyObject *completion_callback = Py_None, *pyacl; + struct ACL_vector aclv; + if (!PyArg_ParseTuple(args, "isiO|O", &zkhid, &path, &version, + &pyacl, &completion_callback)) { + return NULL; + } + CHECK_ZHANDLE(zkhid); + CHECK_ACLS(pyacl); + if (parse_acls(&aclv, pyacl) == 0) { + return NULL; + } + + void *pyw = NULL; + if (completion_callback != Py_None) { + pyw = create_pywatcher(zkhid, completion_callback, 0); + if (pyw == NULL) { + return NULL; + } + } + + int err = zoo_aset_acl( zhandles[zkhid], + path, + version, + &aclv, + void_completion_dispatch, + pyw); + free_acls(&aclv); + if (err != ZOK) { + PyErr_SetString(err_to_exception(err), zerror(err)); + return NULL; + } + return Py_BuildValue("i", err);; +} + +/* Asynchronous authorization addition, returns integer error code */ +PyObject *pyzoo_add_auth(PyObject *self, PyObject *args) +{ + int zkhid; + char *scheme, *cert; + int certLen; + PyObject *completion_callback; + + if (!PyArg_ParseTuple(args, "iss#O", &zkhid, &scheme, &cert, &certLen, + &completion_callback)) { + return NULL; + } + CHECK_ZHANDLE(zkhid); + + void *pyw = NULL; + if (completion_callback != Py_None) { + pyw = create_pywatcher(zkhid, completion_callback, 0); + if (pyw == NULL) { + return NULL; + } + } + + int err = zoo_add_auth( zhandles[zkhid], + scheme, + cert, + certLen, + void_completion_dispatch, + pyw); + if (err != ZOK) { + PyErr_SetString(err_to_exception(err), zerror(err)); + return NULL; + } + return Py_BuildValue("i", err); +} + +/* -------------------------------------------------------------------------- */ +/* Synchronous API implementation */ +/* -------------------------------------------------------------------------- */ + +/* Synchronous node creation, returns node path string */ +static PyObject *pyzoo_create(PyObject *self, PyObject *args) +{ + char *path; + int zkhid; + char* values; + int valuelen; + PyObject *acl = NULL; + int flags = 0; + char realbuf[256]; + const int maxbuf_len = 256; + if (!PyArg_ParseTuple(args, "iss#O|i",&zkhid, &path, &values, &valuelen,&acl,&flags)) + return NULL; + CHECK_ZHANDLE(zkhid); + struct ACL_vector aclv; + CHECK_ACLS(acl); + if (parse_acls(&aclv,acl) == 0) { + return NULL; + } + zhandle_t *zh = zhandles[zkhid]; + int err = zoo_create(zh, path, values, valuelen, &aclv, flags, realbuf, maxbuf_len); + free_acls(&aclv); + if (err != ZOK) { + PyErr_SetString(err_to_exception(err), zerror(err)); + return NULL; + } + + return Py_BuildValue("s", realbuf); +} + +/* Synchronous node deletion, returns integer error code */ +static PyObject *pyzoo_delete(PyObject *self, PyObject *args) +{ + int zkhid; + char *path; + int version = -1; + if (!PyArg_ParseTuple(args, "is|i",&zkhid,&path,&version)) + return NULL; + CHECK_ZHANDLE(zkhid); + zhandle_t *zh = zhandles[zkhid]; + int err = zoo_delete(zh, path, version); + if (err != ZOK) { + PyErr_SetString(err_to_exception(err), zerror(err)); + return NULL; + } + return Py_BuildValue("i", err); +} + +/* Synchronous node existence check, returns stat if exists, None if + absent */ +static PyObject *pyzoo_exists(PyObject *self, PyObject *args) +{ + int zkhid; char *path; PyObject *watcherfn = Py_None; + struct Stat stat; + if (!PyArg_ParseTuple(args, "is|O", &zkhid, &path, &watcherfn)) { + return NULL; + } + CHECK_ZHANDLE(zkhid); + zhandle_t *zh = zhandles[zkhid]; + pywatcher_t *pw = NULL; + void *callback = NULL; + if (watcherfn != Py_None) { + pw = create_pywatcher(zkhid, watcherfn,0); + callback = watcher_dispatch; + if (pw == NULL) { + return NULL; + } + } + int err = zoo_wexists(zh, path, callback, pw, &stat); + if (err != ZOK && err != ZNONODE) { + PyErr_SetString(err_to_exception(err), zerror(err)); + free_pywatcher(pw); + return NULL; + } + if (err == ZNONODE) { + Py_INCREF(Py_None); + return Py_None; // This isn't exceptional + } + return build_stat(&stat); +} + +/* Synchronous node child retrieval, returns list of children's path + as strings */ +static PyObject *pyzoo_get_children(PyObject *self, PyObject *args) +{ + int zkhid; + char *path; + PyObject *watcherfn = Py_None; + struct String_vector strings; + if (!PyArg_ParseTuple(args, "is|O", &zkhid, &path, &watcherfn)) { + return NULL; + } + CHECK_ZHANDLE(zkhid); + pywatcher_t *pw = NULL; + void *callback = NULL; + if (watcherfn != Py_None) { + pw = create_pywatcher( zkhid, watcherfn, 0 ); + callback = watcher_dispatch; + if (pw == NULL) { + return NULL; + } + } + int err = zoo_wget_children(zhandles[zkhid], path, + callback, + pw, &strings ); + + if (err != ZOK) { + PyErr_SetString(err_to_exception(err), zerror(err)); + free_pywatcher(pw); + return NULL; + } + + PyObject *ret = build_string_vector(&strings); + deallocate_String_vector(&strings); + return ret; +} + +/* Synchronous node data update, returns integer error code */ +static PyObject *pyzoo_set(PyObject *self, PyObject *args) +{ + int zkhid; + char *path; + char *buffer; + int buflen; + int version = -1; + if (!PyArg_ParseTuple(args, "iss#|i", &zkhid, &path, &buffer, &buflen, + &version)) { + return NULL; + } + CHECK_ZHANDLE(zkhid); + + int err = zoo_set(zhandles[zkhid], path, buffer, buflen, version); + if (err != ZOK) { + PyErr_SetString(err_to_exception(err), zerror(err)); + return NULL; + } + + return Py_BuildValue("i", err); +} + +/* Synchronous node data update, returns node's stat data structure */ +static PyObject *pyzoo_set2(PyObject *self, PyObject *args) +{ + int zkhid; + char *path; + char *buffer; + int buflen; + int version = -1; + if (!PyArg_ParseTuple(args, "iss#|i", &zkhid, &path, &buffer, &buflen, + &version)) { + return NULL; + } + CHECK_ZHANDLE(zkhid); + struct Stat stat; + int err = zoo_set2(zhandles[zkhid], path, buffer, buflen, version, &stat); + if (err != ZOK) { + PyErr_SetString(err_to_exception(err), zerror(err)); + return NULL; + } + + return build_stat(&stat); +} + +/* As per ZK documentation, datanodes are limited to 1Mb. Why not do a + stat followed by a get, to determine how big the buffer should be? + Because the znode may get updated between calls, so we can't + guarantee a complete get anyhow. */ +#define GET_BUFFER_SIZE 1024*1024 + +/* pyzoo_get has an extra parameter over the java/C equivalents. If + you set the fourth integer parameter buffer_len, we return + min(buffer_len, datalength) bytes. This is set by default to + GET_BUFFER_SIZE */ +static PyObject *pyzoo_get(PyObject *self, PyObject *args) +{ + int zkhid; + char *path; + char *buffer; + int buffer_len=GET_BUFFER_SIZE; + struct Stat stat; + PyObject *watcherfn = Py_None; + pywatcher_t *pw = NULL; + if (!PyArg_ParseTuple(args, "is|Oi", &zkhid, &path, &watcherfn, &buffer_len)) { + return NULL; + } + CHECK_ZHANDLE(zkhid); + if (watcherfn != Py_None) { + pw = create_pywatcher( zkhid, watcherfn,0 ); + if (pw == NULL) { + return NULL; + } + } + buffer = malloc(sizeof(char)*buffer_len); + if (buffer == NULL) { + free_pywatcher(pw); + PyErr_SetString(PyExc_MemoryError, "buffer could not be allocated in pyzoo_get"); + return NULL; + } + + int err = zoo_wget(zhandles[zkhid], path, + watcherfn != Py_None ? watcher_dispatch : NULL, + pw, buffer, + &buffer_len, &stat); + + if (err != ZOK) { + PyErr_SetString(err_to_exception(err), zerror(err)); + free_pywatcher(pw); + free(buffer); + return NULL; + } + + PyObject *stat_dict = build_stat( &stat ); + PyObject *ret = Py_BuildValue( "(s#,N)", buffer,buffer_len < 0 ? 0 : buffer_len, stat_dict ); + free(buffer); + + return ret; +} + +/* Synchronous node ACL retrieval, returns list of ACLs */ +PyObject *pyzoo_get_acl(PyObject *self, PyObject *args) +{ + int zkhid; + char *path; + struct ACL_vector acl; + struct Stat stat; + if (!PyArg_ParseTuple(args, "is", &zkhid, &path)) + return NULL; + CHECK_ZHANDLE(zkhid); + int err = zoo_get_acl( zhandles[zkhid], path, &acl, &stat ); + if (err != ZOK) { + PyErr_SetString(err_to_exception(err), zerror(err)); + return NULL; + } + PyObject *pystat = build_stat( &stat ); + PyObject *acls = build_acls( &acl ); + PyObject *ret = Py_BuildValue( "(O,O)", pystat, acls ); + Py_DECREF(pystat); + Py_DECREF(acls); + return ret; +} + +/* Synchronous node ACL update, returns integer error code */ +PyObject *pyzoo_set_acl(PyObject *self, PyObject *args) +{ + int zkhid; + char *path; + int version; + PyObject *pyacls; + struct ACL_vector acl; + if (!PyArg_ParseTuple(args, "isiO", &zkhid, &path, &version, &pyacls)) { + return NULL; + } + CHECK_ZHANDLE(zkhid); + if (parse_acls(&acl, pyacls) == 0) { + return NULL; + } + int err = zoo_set_acl(zhandles[zkhid], path, version, &acl ); + free_acls(&acl); + if (err != ZOK) { + PyErr_SetString(err_to_exception(err), zerror(err)); + return NULL; + } + return Py_BuildValue("i", err);; +} + +/* -------------------------------------------------------------------------- */ +/* Session and context methods */ +/* -------------------------------------------------------------------------- */ + +/* Closes a connection, returns integer error code */ +PyObject *pyzoo_close(PyObject *self, PyObject *args) +{ + int zkhid, ret; + if (!PyArg_ParseTuple(args, "i", &zkhid)) { + return NULL; + } + CHECK_ZHANDLE(zkhid); + zhandle_t *handle = zhandles[zkhid]; + Py_BEGIN_ALLOW_THREADS + ret = zookeeper_close(handle); + Py_END_ALLOW_THREADS + zhandles[zkhid] = NULL; // The zk C client frees the zhandle + return Py_BuildValue("i", ret); +} + +/* Returns the ID of current client as a tuple (client_id, passwd) */ +PyObject *pyzoo_client_id(PyObject *self, PyObject *args) +{ + int zkhid; + if (!PyArg_ParseTuple(args, "i", &zkhid)) { + return NULL; + } + CHECK_ZHANDLE(zkhid); + const clientid_t *cid = zoo_client_id(zhandles[zkhid]); + return Py_BuildValue("(L,s)", cid->client_id, cid->passwd); +} + +/* DO NOT USE - context is used internally. This method is not exposed + in the Python module */ +PyObject *pyzoo_get_context(PyObject *self, PyObject *args) +{ + int zkhid; + if (!PyArg_ParseTuple(args, "i", &zkhid)) + return NULL; + CHECK_ZHANDLE(zkhid); + PyObject *context = NULL; + context = (PyObject*)zoo_get_context(zhandles[zkhid]); + if (context) return context; + Py_INCREF(Py_None); + return Py_None; +} + +/* DO NOT USE - context is used internally. This method is not exposed + in the Python module */ +PyObject *pyzoo_set_context(PyObject *self, PyObject *args) +{ + int zkhid; + PyObject *context; + if (!PyArg_ParseTuple(args, "iO", &zkhid, &context)) { + return NULL; + } + CHECK_ZHANDLE(zkhid); + PyObject *py_context = (PyObject*)zoo_get_context(zhandles[zkhid]); + if (py_context != NULL && py_context != Py_None) { + Py_DECREF(py_context); + } + Py_INCREF(context); + zoo_set_context(zhandles[zkhid], (void*)context); + Py_INCREF(Py_None); + return Py_None; +} + + +/* -------------------------------------------------------------------------- */ +/* Miscellaneous methods */ +/* -------------------------------------------------------------------------- */ + +/* Sets the global watcher. Returns None */ +PyObject *pyzoo_set_watcher(PyObject *self, PyObject *args) +{ + int zkhid; + PyObject *watcherfn; + if (!PyArg_ParseTuple(args, "iO", &zkhid, &watcherfn)) { + return NULL; + } + CHECK_ZHANDLE(zkhid); + pywatcher_t *pyw = watchers[zkhid]; + if (pyw != NULL) { + free_pywatcher( pyw ); + } + + // Create a *permanent* watcher object, not deallocated when called + pyw = create_pywatcher(zkhid, watcherfn,1); + if (pyw == NULL) { + return NULL; + } + watchers[zkhid] = pyw; + zoo_set_watcher(zhandles[zkhid], watcher_dispatch); + zoo_set_context(zhandles[zkhid], pyw); + Py_INCREF(Py_None); + return Py_None; +} + +/* Returns an integer code representing the current connection + state */ +PyObject *pyzoo_state(PyObject *self, PyObject *args) +{ + int zkhid; + if (!PyArg_ParseTuple(args,"i",&zkhid)) { + return NULL; + } + CHECK_ZHANDLE(zkhid); + int state = zoo_state(zhandles[zkhid]); + return Py_BuildValue("i",state); +} + + +/* Convert an integer error code into a string */ +PyObject *pyzerror(PyObject *self, PyObject *args) +{ + int rc; + if (!PyArg_ParseTuple(args,"i", &rc)) + return NULL; + return Py_BuildValue("s", zerror(rc)); +} + +/* Returns the integer receive timeout for a connection */ +PyObject *pyzoo_recv_timeout(PyObject *self, PyObject *args) +{ + int zkhid; + if (!PyArg_ParseTuple(args,"i",&zkhid)) + return NULL; + CHECK_ZHANDLE(zkhid); + int recv_timeout = zoo_recv_timeout(zhandles[zkhid]); + return Py_BuildValue("i",recv_timeout); +} + +/* Returns True if connection is unrecoverable, False otherwise */ +PyObject *pyis_unrecoverable(PyObject *self, PyObject *args) +{ + int zkhid; + if (!PyArg_ParseTuple(args,"i",&zkhid)) + return NULL; + CHECK_ZHANDLE(zkhid); + int ret = is_unrecoverable(zhandles[zkhid]); + if (ret == ZINVALIDSTATE) + Py_RETURN_TRUE; + Py_RETURN_FALSE; +} + +/* Set the debug level for logging, returns None */ +PyObject *pyzoo_set_debug_level(PyObject *self, PyObject *args) +{ + int loglevel; + if (!PyArg_ParseTuple(args, "i", &loglevel)) + return NULL; + zoo_set_debug_level((ZooLogLevel)loglevel); + Py_INCREF(Py_None); + return Py_None; +} + +static PyObject *log_stream = NULL; + +/* Set the output file-like object for logging output. Returns Py_None */ +PyObject *pyzoo_set_log_stream(PyObject *self, PyObject *args) +{ + PyObject *pystream = NULL; + if (!PyArg_ParseTuple(args,"O",&pystream)) { + PyErr_SetString(PyExc_ValueError, "Must supply a Python object to set_log_stream"); + return NULL; + } + +#if PY_MAJOR_VERSION >= 3 + extern PyTypeObject PyIOBase_Type; + if (!PyObject_IsInstance(pystream, (PyObject *)&PyIOBase_Type)) { +#else + if(!PyFile_Check(pystream)) { +#endif + + PyErr_SetString(PyExc_ValueError, "Must supply a file object to set_log_stream"); + return NULL; + } + /* Release the previous reference to log_stream that we took */ + if (log_stream != NULL) { + Py_DECREF(log_stream); + } + + log_stream = pystream; + Py_INCREF(log_stream); + +#if PY_MAJOR_VERSION >= 3 + int fd = PyObject_AsFileDescriptor(log_stream); + FILE *fp = fdopen(fd, "w"); +#else + FILE *fp = PyFile_AsFile(log_stream); +#endif + zoo_set_log_stream(fp); + + Py_INCREF(Py_None); + return Py_None; +} + +/* Set the connection order - randomized or in-order. Returns None. */ +PyObject *pyzoo_deterministic_conn_order(PyObject *self, PyObject *args) +{ + int yesOrNo; + if (!PyArg_ParseTuple(args, "i",&yesOrNo)) + return NULL; + zoo_deterministic_conn_order( yesOrNo ); + Py_INCREF(Py_None); + return Py_None; +} + +/* -------------------------------------------------------------------------- */ +/* Module setup */ +/* -------------------------------------------------------------------------- */ + +#include "pyzk_docstrings.h" + +static PyMethodDef ZooKeeperMethods[] = { + {"init", pyzookeeper_init, METH_VARARGS, pyzk_init_doc }, + {"create",pyzoo_create, METH_VARARGS, pyzk_create_doc }, + {"delete",pyzoo_delete, METH_VARARGS, pyzk_delete_doc }, + {"get_children", pyzoo_get_children, METH_VARARGS, pyzk_get_children_doc }, + {"set", pyzoo_set, METH_VARARGS, pyzk_set_doc }, + {"set2", pyzoo_set2, METH_VARARGS, pyzk_set2_doc }, + {"get",pyzoo_get, METH_VARARGS, pyzk_get_doc }, + {"exists",pyzoo_exists, METH_VARARGS, pyzk_exists_doc }, + {"get_acl", pyzoo_get_acl, METH_VARARGS, pyzk_get_acl_doc }, + {"set_acl", pyzoo_set_acl, METH_VARARGS, pyzk_set_acl_doc }, + {"close", pyzoo_close, METH_VARARGS, pyzk_close_doc }, + {"client_id", pyzoo_client_id, METH_VARARGS, pyzk_client_id_doc }, + {"set_watcher", pyzoo_set_watcher, METH_VARARGS }, + {"state", pyzoo_state, METH_VARARGS, pyzk_state_doc }, + {"recv_timeout",pyzoo_recv_timeout, METH_VARARGS }, + {"is_unrecoverable",pyis_unrecoverable, METH_VARARGS, pyzk_is_unrecoverable_doc }, + {"set_debug_level",pyzoo_set_debug_level, METH_VARARGS, pyzk_set_debug_level_doc }, + {"set_log_stream",pyzoo_set_log_stream, METH_VARARGS, pyzk_set_log_stream_doc }, + {"deterministic_conn_order",pyzoo_deterministic_conn_order, METH_VARARGS, pyzk_deterministic_conn_order_doc }, + {"acreate", pyzoo_acreate, METH_VARARGS, pyzk_acreate_doc }, + {"adelete", pyzoo_adelete, METH_VARARGS,pyzk_adelete_doc }, + {"aexists", pyzoo_aexists, METH_VARARGS,pyzk_aexists_doc }, + {"aget", pyzoo_aget, METH_VARARGS, pyzk_aget_doc }, + {"aset", pyzoo_aset, METH_VARARGS, pyzk_aset_doc }, + {"aget_children", pyzoo_aget_children, METH_VARARGS, pyzk_aget_children_doc }, + {"async", pyzoo_async, METH_VARARGS, pyzk_async_doc }, + {"aget_acl", pyzoo_aget_acl, METH_VARARGS, pyzk_aget_acl_doc }, + {"aset_acl", pyzoo_aset_acl, METH_VARARGS, pyzk_aset_acl_doc }, + {"zerror", pyzerror, METH_VARARGS, pyzk_zerror_doc }, + {"add_auth", pyzoo_add_auth, METH_VARARGS, pyzk_add_auth_doc }, + /* DO NOT USE get / set_context. Context is used internally to pass + the python watcher to a dispatch function. If you want context, set + it through set_watcher. */ + // {"get_context", pyzoo_get_context, METH_VARARGS, "" }, + // {"set_context", pyzoo_set_context, METH_VARARGS, "" }, + {NULL, NULL} +}; + +#if PY_MAJOR_VERSION >= 3 +static struct PyModuleDef zookeeper_moddef = { + PyModuleDef_HEAD_INIT, + "zookeeper", + NULL, + 0, + ZooKeeperMethods, + 0, + 0, + 0, + 0 +}; +#endif + +#define ADD_INTCONSTANT(x) PyModule_AddIntConstant(module, #x, ZOO_##x) +#define ADD_INTCONSTANTZ(x) PyModule_AddIntConstant(module, #x, Z##x) + +#define ADD_EXCEPTION(x) x = PyErr_NewException("zookeeper."#x, ZooKeeperException, NULL); \ + Py_INCREF(x); \ + PyModule_AddObject(module, #x, x); + +#if PY_MAJOR_VERSION >= 3 +PyMODINIT_FUNC PyInit_zookeeper(void) { +#else +PyMODINIT_FUNC initzookeeper(void) { +#endif + PyEval_InitThreads(); + +#if PY_MAJOR_VERSION >= 3 + PyObject *module = PyModule_Create(&zookeeper_moddef); +#else + PyObject *module = Py_InitModule("zookeeper", ZooKeeperMethods); +#endif + if (init_zhandles(32) == 0) { + return; // TODO: Is there any way to raise an exception here? + } + + ZooKeeperException = PyErr_NewException("zookeeper.ZooKeeperException", + PyExc_Exception, + NULL); + + PyModule_AddObject(module, "ZooKeeperException", ZooKeeperException); + Py_INCREF(ZooKeeperException); + + int size = 10; + char version_str[size]; + snprintf(version_str, size, "%i.%i.%i", ZOO_MAJOR_VERSION, ZOO_MINOR_VERSION, ZOO_PATCH_VERSION); + + PyModule_AddStringConstant(module, "__version__", version_str); + + ADD_INTCONSTANT(PERM_READ); + ADD_INTCONSTANT(PERM_WRITE); + ADD_INTCONSTANT(PERM_CREATE); + ADD_INTCONSTANT(PERM_DELETE); + ADD_INTCONSTANT(PERM_ALL); + ADD_INTCONSTANT(PERM_ADMIN); + + ADD_INTCONSTANT(EPHEMERAL); + ADD_INTCONSTANT(SEQUENCE); + + ADD_INTCONSTANT(EXPIRED_SESSION_STATE); + ADD_INTCONSTANT(AUTH_FAILED_STATE); + ADD_INTCONSTANT(CONNECTING_STATE); + ADD_INTCONSTANT(ASSOCIATING_STATE); + ADD_INTCONSTANT(CONNECTED_STATE); + + ADD_INTCONSTANT(CREATED_EVENT); + ADD_INTCONSTANT(DELETED_EVENT); + ADD_INTCONSTANT(CHANGED_EVENT); + ADD_INTCONSTANT(CHILD_EVENT); + ADD_INTCONSTANT(SESSION_EVENT); + ADD_INTCONSTANT(NOTWATCHING_EVENT); + + ADD_INTCONSTANT(LOG_LEVEL_ERROR); + ADD_INTCONSTANT(LOG_LEVEL_WARN); + ADD_INTCONSTANT(LOG_LEVEL_INFO); + ADD_INTCONSTANT(LOG_LEVEL_DEBUG); + + ADD_INTCONSTANTZ(SYSTEMERROR); + ADD_INTCONSTANTZ(RUNTIMEINCONSISTENCY); + ADD_INTCONSTANTZ(DATAINCONSISTENCY); + ADD_INTCONSTANTZ(CONNECTIONLOSS); + ADD_INTCONSTANTZ(MARSHALLINGERROR); + ADD_INTCONSTANTZ(UNIMPLEMENTED); + ADD_INTCONSTANTZ(OPERATIONTIMEOUT); + ADD_INTCONSTANTZ(BADARGUMENTS); + ADD_INTCONSTANTZ(INVALIDSTATE); + + ADD_EXCEPTION(SystemErrorException); + ADD_EXCEPTION(RuntimeInconsistencyException); + ADD_EXCEPTION(DataInconsistencyException); + ADD_EXCEPTION(ConnectionLossException); + ADD_EXCEPTION(MarshallingErrorException); + ADD_EXCEPTION(UnimplementedException); + ADD_EXCEPTION(OperationTimeoutException); + ADD_EXCEPTION(BadArgumentsException); + ADD_EXCEPTION(InvalidStateException); + + ADD_INTCONSTANTZ(OK); + ADD_INTCONSTANTZ(APIERROR); + ADD_INTCONSTANTZ(NONODE); + ADD_INTCONSTANTZ(NOAUTH); + ADD_INTCONSTANTZ(BADVERSION); + ADD_INTCONSTANTZ(NOCHILDRENFOREPHEMERALS); + ADD_INTCONSTANTZ(NODEEXISTS); + ADD_INTCONSTANTZ(NOTEMPTY); + ADD_INTCONSTANTZ(SESSIONEXPIRED); + ADD_INTCONSTANTZ(INVALIDCALLBACK); + ADD_INTCONSTANTZ(INVALIDACL); + ADD_INTCONSTANTZ(AUTHFAILED); + ADD_INTCONSTANTZ(CLOSING); + ADD_INTCONSTANTZ(NOTHING); + ADD_INTCONSTANTZ(SESSIONMOVED); + + ADD_EXCEPTION(ApiErrorException); + ADD_EXCEPTION(NoNodeException); + ADD_EXCEPTION(NoAuthException); + ADD_EXCEPTION(BadVersionException); + ADD_EXCEPTION(NoChildrenForEphemeralsException); + ADD_EXCEPTION(NodeExistsException); + ADD_EXCEPTION(NotEmptyException); + ADD_EXCEPTION(SessionExpiredException); + ADD_EXCEPTION(InvalidCallbackException); + ADD_EXCEPTION(InvalidACLException); + ADD_EXCEPTION(AuthFailedException); + ADD_EXCEPTION(ClosingException); + ADD_EXCEPTION(NothingException); + ADD_EXCEPTION(SessionMovedException); + +#if PY_MAJOR_VERSION >= 3 + return module; +#endif +} diff --git a/src/contrib/zkpython/src/examples/README b/src/contrib/zkpython/src/examples/README new file mode 100644 index 0000000..3c53454 --- /dev/null +++ b/src/contrib/zkpython/src/examples/README @@ -0,0 +1,8 @@ + +This folder contains sample showing how you can use ZooKeeper from Python. + +You should also check the following projects: + +* http://github.com/phunt/zk-smoketest +* http://github.com/henryr/pyzk-recipes + diff --git a/src/contrib/zkpython/src/examples/watch_znode_for_changes.py b/src/contrib/zkpython/src/examples/watch_znode_for_changes.py new file mode 100644 index 0000000..07100f0 --- /dev/null +++ b/src/contrib/zkpython/src/examples/watch_znode_for_changes.py @@ -0,0 +1,202 @@ +#!/usr/bin/env python2.6 +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +""" ZNode Change Watcher Skeleton Script + +This script shows you how to write a python program that watches a specific +znode for changes and reacts to them. + +Steps to understand how this script works: + +1. start a standalone ZooKeeper server (by default it listens on localhost:2181) + +Did you know you can deploy "local clusters" by using zkconf[1]? +[1] http://github.com/phunt/zkconf + +2. enter the command line console + +3. create the test node: + [zk: (CONNECTED) 1] create /watch-test dummy-data + Created /watch-test + +4. in another shell start this script in verbose mode + $ python watch_znode_for_changes.py -v + + # you should see a lot of log messages. have a look over them because + # you can easily understand how zookeeper works + +5. update the node data: + + [zk: (CONNECTED) 2] set /watch-test new-data + cZxid = 0xa0000001a + ctime = Fri Jul 09 19:14:45 EEST 2010 + mZxid = 0xa0000001e + mtime = Fri Jul 09 19:18:18 EEST 2010 + pZxid = 0xa0000001a + cversion = 0 + dataVersion = 1 + aclVersion = 0 + ephemeralOwner = 0x0 + dataLength = 8 + numChildren = 0 + + ... and you should see similar log messages: + + 2010-07-09 19:18:18,537:11542(0xb6ea5b70):ZOO_DEBUG@process_completions@1765: Calling a watcher for node [/watch-test], type = -1 event=ZOO_CHANGED_EVENT + 2010-07-09 19:18:18,537 watch_znode_for_changes.py:83 - Running watcher: zh=0 event=3 state=3 path=/watch-test + 2010-07-09 19:18:18,537:11542(0xb6ea5b70):ZOO_DEBUG@zoo_awget@2400: Sending request xid=0x4c374b33 for path [/watch-test] to 127.0.0.1:2181 + 2010-07-09 19:18:18,545:11542(0xb76a6b70):ZOO_DEBUG@zookeeper_process@1980: Queueing asynchronous response + 2010-07-09 19:18:18,545:11542(0xb6ea5b70):ZOO_DEBUG@process_completions@1772: Calling COMPLETION_DATA for xid=0x4c374b33 rc=0 + 2010-07-09 19:18:18,545 watch_znode_for_changes.py:54 - This is where your application does work. + + You can repeat this step multiple times. + +6. that's all. in the end you can delete the node and you should see a ZOO_DELETED_EVENT + +""" + +import logging +import logging.handlers +import signal +import sys +import time +import threading +import zookeeper + +from optparse import OptionParser + +logger = logging.getLogger() + +class MyClass(threading.Thread): + znode = '/watch-test' + + def __init__(self, options, args): + threading.Thread.__init__(self) + + logger.debug('Initializing MyClass thread.') + if options.verbose: + zookeeper.set_debug_level(zookeeper.LOG_LEVEL_DEBUG) + + self.zh = zookeeper.init(options.servers) + if zookeeper.OK != zookeeper.aget(self.zh, self.znode, + self.watcher, self.handler): + logger.critical('Unable to get znode! Exiting.') + sys.exit(1) + + def __del__(self): + zookeeper.close(self.zh) + + def aget(self): + return zookeeper.aget(self.zh, self.znode, self.watcher, self.handler) + + def handler(self, zh, rc, data, stat): + """Handle zookeeper.aget() responses. + + This code handles the zookeeper.aget callback. It does not handle watches. + + Numeric arguments map to constants. See ``DATA`` in ``help(zookeeper)`` + for more information. + + Args: + zh Zookeeper handle that made this request. + rc Return code. + data Data stored in the znode. + + Does not provide a return value. + """ + if zookeeper.OK == rc: + logger.debug('This is where your application does work.') + else: + if zookeeper.NONODE == rc: + # avoid sending too many requests if the node does not yet exists + logger.info('Node not found. Trying again to set the watch.') + time.sleep(1) + + if zookeeper.OK != self.aget(): + logger.critical('Unable to get znode! Exiting.') + sys.exit(1) + + def watcher(self, zh, event, state, path): + """Handle zookeeper.aget() watches. + + This code is called when a znode changes and triggers a data watch. + It is not called to handle the zookeeper.aget call itself. + + Numeric arguments map to constants. See ``DATA`` in ``help(zookeeper)`` + for more information. + + Args: + zh Zookeeper handle that set this watch. + event Event that caused the watch (often called ``type`` elsewhere). + state Connection state. + path Znode that triggered this watch. + + Does not provide a return value. + """ + out = ['Running watcher:', + 'zh=%d' % zh, + 'event=%d' % event, + 'state=%d' % state, + 'path=%s' % path] + logger.debug(' '.join(out)) + if event == zookeeper.CHANGED_EVENT and \ + state == zookeeper.CONNECTED_STATE and \ + self.znode == path: + if zookeeper.OK != self.aget(): + logger.critical('Unable to get znode! Exiting.') + sys.exit(1) + + def run(self): + while True: + time.sleep(86400) + + +def main(argv=None): + # Allow Ctrl-C + signal.signal(signal.SIGINT, signal.SIG_DFL) + + parser = OptionParser() + parser.add_option('-v', '--verbose', + dest='verbose', + default=False, + action='store_true', + help='Verbose logging. (default: %default)') + parser.add_option('-s', '--servers', + dest='servers', + default='localhost:2181', + help='Comma-separated list of host:port pairs. (default: %default)') + + (options, args) = parser.parse_args() + + if options.verbose: + logger.setLevel(logging.DEBUG) + else: + logger.setLevel(logging.INFO) + + formatter = logging.Formatter("%(asctime)s %(filename)s:%(lineno)d - %(message)s") + stream_handler = logging.StreamHandler() + stream_handler.setFormatter(formatter) + logger.addHandler(stream_handler) + + logger.info('Starting Zookeeper python example: %s' % ' '.join(sys.argv)) + + mc = MyClass(options, args) + mc.start() + mc.join() + + +if __name__ == '__main__': + main() diff --git a/src/contrib/zkpython/src/packages/deb/zkpython.control/control b/src/contrib/zkpython/src/packages/deb/zkpython.control/control new file mode 100644 index 0000000..6ec76d0 --- /dev/null +++ b/src/contrib/zkpython/src/packages/deb/zkpython.control/control @@ -0,0 +1,23 @@ +# Licensed to the Apache Software Foundation (ASF) under one or more +# contributor license agreements. See the NOTICE file distributed with +# this work for additional information regarding copyright ownership. +# The ASF licenses this file to You under the Apache License, Version 2.0 +# (the "License"); you may not use this file except in compliance with +# the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +Package: zkpython +Version: @version@ +Section: misc +Priority: optional +Architecture: all +Depends: python +Maintainer: Apache Software Foundation +Description: ZooKeeper python binding library +Distribution: development diff --git a/src/contrib/zkpython/src/packages/rpm/spec/zkpython.spec b/src/contrib/zkpython/src/packages/rpm/spec/zkpython.spec new file mode 100644 index 0000000..d1f9814 --- /dev/null +++ b/src/contrib/zkpython/src/packages/rpm/spec/zkpython.spec @@ -0,0 +1,81 @@ +# Licensed to the Apache Software Foundation (ASF) under one or more +# contributor license agreements. See the NOTICE file distributed with +# this work for additional information regarding copyright ownership. +# The ASF licenses this file to You under the Apache License, Version 2.0 +# (the "License"); you may not use this file except in compliance with +# the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +# +# RPM Spec file for ZooKeeper version @version@ +# + +%define name zkpython +%define version @version@ +%define release @package.release@ + +# Installation Locations +%define _prefix @package.prefix@ + +# Build time settings +%define _build_dir @package.build.dir@ +%define _final_name @final.name@ +%define _python_lib @python.lib@ +%define debug_package %{nil} + +# Disable brp-java-repack-jars for aspect J +%define __os_install_post \ + /usr/lib/rpm/redhat/brp-compress \ + %{!?__debug_package:/usr/lib/rpm/redhat/brp-strip %{__strip}} \ + /usr/lib/rpm/redhat/brp-strip-static-archive %{__strip} \ + /usr/lib/rpm/redhat/brp-strip-comment-note %{__strip} %{__objdump} \ + /usr/lib/rpm/brp-python-bytecompile %{nil} + +# RPM searches perl files for dependancies and this breaks for non packaged perl lib +# like thrift so disable this +%define _use_internal_dependency_generator 0 + +Summary: ZooKeeper python binding library +Group: Development/Libraries +License: Apache License, Version 2.0 +URL: http://zookeeper.apache.org/ +Vendor: Apache Software Foundation +Name: %{name} +Version: %{version} +Release: %{release} +Source0: %{_python_lib} +Prefix: %{_prefix} +Requires: zookeeper-lib == %{version} +AutoReqProv: no +Provides: zkpython + +%description +ZooKeeper python binding library + +%prep +tar fxz %{_python_lib} -C %{_build_dir} + +%build + +######################### +#### INSTALL SECTION #### +######################### +%install + +%pre + +%post + +%preun + +%files +%defattr(-,root,root) +%{_prefix} + diff --git a/src/contrib/zkpython/src/python/setup.py b/src/contrib/zkpython/src/python/setup.py new file mode 100644 index 0000000..c6a1cee --- /dev/null +++ b/src/contrib/zkpython/src/python/setup.py @@ -0,0 +1,36 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +from distutils.core import setup, Extension + +zookeeper_basedir = "../../../" + +zookeepermodule = Extension("zookeeper", + sources=["src/c/zookeeper.c"], + include_dirs=[zookeeper_basedir + "/src/c/include", + zookeeper_basedir + "/build/c", + zookeeper_basedir + "/src/c/generated"], + libraries=["zookeeper_mt"], + library_dirs=[zookeeper_basedir + "/src/c/.libs/", + zookeeper_basedir + "/build/c/.libs/", + zookeeper_basedir + "/build/test/test-cppunit/.libs", + "/usr/local/lib" + ]) + +setup( name="ZooKeeper", + version = "0.4", + description = "ZooKeeper Python bindings", + ext_modules=[zookeepermodule] ) diff --git a/src/contrib/zkpython/src/python/zk.py b/src/contrib/zkpython/src/python/zk.py new file mode 100644 index 0000000..24986e3 --- /dev/null +++ b/src/contrib/zkpython/src/python/zk.py @@ -0,0 +1,76 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +import zookeeper, time, threading + +f = open("out.log","w") +zookeeper.set_log_stream(f) + +connected = False +conn_cv = threading.Condition( ) + +def my_connection_watcher(handle,type,state,path): + global connected, conn_cv + print("Connected, handle is ", handle) + conn_cv.acquire() + connected = True + conn_cv.notifyAll() + conn_cv.release() + +conn_cv.acquire() +print("Connecting to localhost:2181 -- ") +handle = zookeeper.init("localhost:2181", my_connection_watcher, 10000, 0) +while not connected: + conn_cv.wait() +conn_cv.release() + +def my_getc_watch( handle, type, state, path ): + print("Watch fired -- ") + print(type, state, path) + +ZOO_OPEN_ACL_UNSAFE = {"perms":0x1f, "scheme":"world", "id" :"anyone"}; + +try: + zookeeper.create(handle, "/zk-python", "data", [ZOO_OPEN_ACL_UNSAFE], 0) + zookeeper.get_children(handle, "/zk-python", my_getc_watch) + for i in xrange(5): + print("Creating sequence node ", i, " ", zookeeper.create(handle, "/zk-python/sequencenode", "data", [ZOO_OPEN_ACL_UNSAFE], zookeeper.SEQUENCE )) +except: + pass + +def pp_zk(handle,root, indent = 0): + """Pretty print(a zookeeper tree, starting at root)""" + def make_path(child): + if root == "/": + return "/" + child + return root + "/" + child + children = zookeeper.get_children(handle, root, None) + out = "" + for i in xrange(indent): + out += "\t" + out += "|---"+root + " :: " + zookeeper.get(handle, root, None)[0] + print(out) + for child in children: + pp_zk(handle,make_path(child),indent+1) + +print("ZNode tree -- ") +pp_zk(handle,"/") + +print("Getting ACL / Stat for /zk-python --") +(stat, acl) = zookeeper.get_acl(handle, "/zk-python") +print("Stat:: ", stat) +print("Acl:: ", acl) + diff --git a/src/contrib/zkpython/src/test/acl_test.py b/src/contrib/zkpython/src/test/acl_test.py new file mode 100644 index 0000000..1289c8a --- /dev/null +++ b/src/contrib/zkpython/src/test/acl_test.py @@ -0,0 +1,109 @@ +#!/usr/bin/python +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +import zookeeper, zktestbase, unittest, threading + +ZOO_OPEN_ACL_UNSAFE = {"perms":zookeeper.PERM_ALL, "scheme":"world", "id" :"anyone"} +ZOO_ACL_READ = {"perms":zookeeper.PERM_READ, "scheme": "world", + "id":"anyone"} +class ACLTest(zktestbase.TestBase): + """Test whether basic ACL setting and getting work correctly""" + # to do: startup and teardown via scripts? + def setUp(self): + zktestbase.TestBase.setUp(self) + try: + zookeeper.delete(self.handle, "/zk-python-acltest") + zookeeper.delete(self.handle, "/zk-python-aacltest") + except: + pass + + def test_sync_acl(self): + self.assertEqual(self.connected, True) + ret = zookeeper.create(self.handle, "/zk-python-acltest", "nodecontents", [ZOO_OPEN_ACL_UNSAFE], zookeeper.EPHEMERAL) + acls = zookeeper.get_acl(self.handle, "/zk-python-acltest") + self.assertEqual(acls[1], [ZOO_OPEN_ACL_UNSAFE]) + self.assertRaises(zookeeper.InvalidACLException,zookeeper.set_acl,self.handle, "/zk-python-acltest", -1, ZOO_ACL_READ) + zookeeper.set_acl(self.handle, "/zk-python-acltest", -1, [ZOO_ACL_READ]) + acls = zookeeper.get_acl(self.handle, "/zk-python-acltest") + self.assertEqual(acls[1], [ZOO_ACL_READ]) + + + def test_async_acl(self): + self.cv = threading.Condition() + self.cv = threading.Condition() + def aget_callback(handle, rc, acl, stat): + self.cv.acquire() + self.callback_flag = True + self.rc = rc + self.acl = acl + self.stat = stat + self.cv.notify() + self.cv.release() + + def aset_callback(handle, rc): + self.cv.acquire() + self.callback_flag = True + self.rc = rc + self.cv.notify() + self.cv.release() + + self.assertEqual(self.connected, True, "Not connected!") + ret = zookeeper.create(self.handle, "/zk-python-aacltest", "nodecontents", [ZOO_OPEN_ACL_UNSAFE], zookeeper.EPHEMERAL) + + self.cv.acquire() + zookeeper.aget_acl(self.handle, "/zk-python-aacltest", aget_callback) + self.cv.wait(15) + self.cv.release() + + self.assertEqual(self.callback_flag, True, "aget_acl timed out") + self.assertEqual(self.rc, zookeeper.OK, "aget failed") + self.assertEqual(self.acl, [ZOO_OPEN_ACL_UNSAFE], "Wrong ACL returned from aget") + + self.cv.acquire() + self.callback_flag = False + zookeeper.aset_acl(self.handle, "/zk-python-aacltest", -1, [ZOO_ACL_READ], aset_callback) + self.cv.wait(15) + self.cv.release() + + self.assertEqual(self.callback_flag, True, "aset_acl timed out") + self.assertEqual(self.rc, zookeeper.OK, "aset failed") + acls = zookeeper.get_acl(self.handle, "/zk-python-aacltest") + self.assertEqual(acls[1], [ZOO_ACL_READ], "Wrong ACL returned from get when aset") + + def test_invalid_acl(self): + self.assertRaises(zookeeper.InvalidACLException, + zookeeper.create, + self.handle, + "/zk-python-aclverifytest", + "", + None, + zookeeper.EPHEMERAL) + + def test_invalid_acl2(self): + """Verify all required keys are present in the ACL.""" + invalid_acl = [{"schema": "digest", "id": "zebra"}] + self.assertRaises(zookeeper.InvalidACLException, + zookeeper.create, + self.handle, + "/zk-python-aclverifytest", + "", + invalid_acl, + zookeeper.EPHEMERAL) + +if __name__ == '__main__': + unittest.main() diff --git a/src/contrib/zkpython/src/test/async_test.py b/src/contrib/zkpython/src/test/async_test.py new file mode 100644 index 0000000..e813435 --- /dev/null +++ b/src/contrib/zkpython/src/test/async_test.py @@ -0,0 +1,33 @@ +#!/usr/bin/python +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +import zookeeper, zktestbase, unittest, threading + +class AsyncTest(zktestbase.TestBase): + """Test whether async works""" + # to do: startup and teardown via scripts? + def setUp( self ): + zktestbase.TestBase.setUp(self) + + def test_async(self): + self.assertEqual(self.connected, True) + ret = zookeeper.async(self.handle, "/") + self.assertEqual(ret, zookeeper.OK, "async failed") + +if __name__ == '__main__': + unittest.main() diff --git a/src/contrib/zkpython/src/test/callback_test.py b/src/contrib/zkpython/src/test/callback_test.py new file mode 100644 index 0000000..55d7fe1 --- /dev/null +++ b/src/contrib/zkpython/src/test/callback_test.py @@ -0,0 +1,155 @@ +#!/usr/bin/python +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +import zookeeper, zktestbase, unittest, threading, gc + +ZOO_OPEN_ACL_UNSAFE = {"perms":0x1f, "scheme":"world", "id" :"anyone"} + +class CallbackTest(zktestbase.TestBase): + """ + Test whether callbacks (watchers/completions) are correctly invoked + """ + # to do: startup and teardown via scripts? + def setUp(self): + zktestbase.TestBase.setUp(self) + self.cv = threading.Condition() + + def create_callback(self, callback): + """ + Returns a callable which signals cv and then calls callback + """ + def wrapper(*args, **kwargs): + self.cv.acquire() + callback(*args, **kwargs) + self.cv.notify() + self.cv.release() + return wrapper + + def test_none_callback(self): + """ + Test that no errors are raised when None is passed as a callback. + """ + self.ensureCreated("/zk-python-none-callback-test","test") + # To do this we need to issue two operations, waiting on the second + # to ensure that the first completes + zookeeper.get(self.handle, "/zk-python-none-callback-test", None) + (d,s) = zookeeper.get(self.handle, "/zk-python-none-callback-test") + self.assertEqual(d, "test") + + def callback_harness(self, trigger, test): + self.callback_flag = False + self.cv.acquire() + trigger() + self.cv.wait(15) + test() + + def test_dispatch_types(self): + """ + Test all the various dispatch mechanisms internal to the module. + """ + def dispatch_callback(*args, **kwargs): + self.callback_flag = True + self.ensureCreated("/zk-python-dispatch-test") + self.callback_harness( lambda: zookeeper.adelete(self.handle, + "/zk-python-dispatch-test", + -1, + self.create_callback(dispatch_callback)), + lambda: self.assertEqual(True, self.callback_flag, "Void dispatch not fired")) + + + self.ensureCreated("/zk-python-dispatch-test") + self.callback_harness( lambda: zookeeper.aexists(self.handle, + "/zk-python-dispatch-test", + None, + self.create_callback(dispatch_callback)), + lambda: self.assertEqual(True, self.callback_flag, "Stat dispatch not fired")) + + self.callback_harness( lambda: zookeeper.aget(self.handle, + "/zk-python-dispatch-test", + None, + self.create_callback(dispatch_callback)), + lambda: self.assertEqual(True, self.callback_flag, "Data dispatch not fired")) + + self.callback_harness( lambda: zookeeper.aget_children(self.handle, + "/", + None, + self.create_callback( dispatch_callback )), + lambda: self.assertEqual(True, self.callback_flag, "Strings dispatch not fired")) + + self.callback_harness( lambda: zookeeper.async(self.handle, + "/", + self.create_callback( dispatch_callback )), + lambda: self.assertEqual(True, self.callback_flag, "String dispatch not fired")) + + self.callback_harness( lambda: zookeeper.aget_acl(self.handle, + "/", + self.create_callback( dispatch_callback )), + lambda: self.assertEqual(True, self.callback_flag, "ACL dispatch not fired")) + + def test_multiple_watchers(self): + """ + Test whether multiple watchers are correctly called + """ + cv1, cv2 = threading.Condition(), threading.Condition() + def watcher1(*args, **kwargs): + cv1.acquire() + self.watcher1 = True + cv1.notify() + cv1.release() + + def watcher2(*args, **kwargs): + cv2.acquire() + self.watcher2 = True + cv2.notify() + cv2.release() + + nodename = "/zk-python-multiple-watcher-test" + self.ensureCreated(nodename, "test") + cv1.acquire() + cv2.acquire() + zookeeper.get(self.handle, nodename, watcher1) + zookeeper.get(self.handle, nodename, watcher2) + zookeeper.set(self.handle, nodename, "test") + cv1.wait(15) + cv2.wait(15) + self.assertTrue(self.watcher1 and self.watcher2, "One or more watchers failed to fire") + + def test_lose_scope(self): + """ + The idea is to test that the reference counting doesn't + fail when we retain no references outside of the module + """ + self.ensureDeleted("/zk-python-lose-scope-test") + self.ensureCreated("/zk-python-lose-scope-test") + def set_watcher(): + def fn(): self.callback_flag = True + self.callback_flag = False + zookeeper.exists(self.handle, "/zk-python-lose-scope-test", + self.create_callback( lambda handle, type, state, path: fn() ) + ) + + set_watcher() + gc.collect() + self.cv.acquire() + zookeeper.set(self.handle, "/zk-python-lose-scope-test", "test") + self.cv.wait(15) + self.assertEqual(self.callback_flag, True) + + +if __name__ == '__main__': + unittest.main() diff --git a/src/contrib/zkpython/src/test/clientid_test.py b/src/contrib/zkpython/src/test/clientid_test.py new file mode 100644 index 0000000..90c8f0a --- /dev/null +++ b/src/contrib/zkpython/src/test/clientid_test.py @@ -0,0 +1,48 @@ +#!/usr/bin/python +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +import unittest, threading + +import zookeeper, zktestbase + +class ClientidTest(zktestbase.TestBase): + """Test whether clientids work""" + def setUp(self): + pass + + def testclientid(self): + cv = threading.Condition() + self.connected = False + def connection_watcher(handle, type, state, path): + cv.acquire() + self.connected = True + cv.notify() + cv.release() + + cv.acquire() + self.handle = zookeeper.init(self.host, connection_watcher,10000,(123456,"mypassword")) + self.assertEqual(self.handle, zookeeper.OK) + cv.wait(15.0) + cv.release() + self.assertEqual(self.connected, True, "Connection timed out to " + self.host) + (cid,passwd) = zookeeper.client_id(self.handle) + self.assertEqual(cid,123456) + self.assertEqual(passwd,"mypassword") + +if __name__ == '__main__': + unittest.main() diff --git a/src/contrib/zkpython/src/test/close_deadlock_test.py b/src/contrib/zkpython/src/test/close_deadlock_test.py new file mode 100644 index 0000000..921d2cc --- /dev/null +++ b/src/contrib/zkpython/src/test/close_deadlock_test.py @@ -0,0 +1,50 @@ +#!/usr/bin/python +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +import zookeeper, zktestbase, unittest, threading +import time + + +class CloseDeadlockTest(zktestbase.TestBase): + """ + This tests for the issue found in + https://issues.apache.org/jira/browse/ZOOKEEPER-763 + + zookeeper.close blocks on waiting for all completions to + finish. Previously it was doing so while holding teh GIL, stopping + any completions from actually continuing. + + This test is a failure if it does not exit within a few seconds. + """ + def deadlock(): + cv = threading.Condition() + + def callback(*args): + cv.acquire() + cv.notifyAll() + cv.release() + time.sleep(1) + + cv.acquire() + zookeeper.aget(handle, "/", None, callback) + cv.wait() + zookeeper.close(handle) + + +if __name__ == '__main__': + unittest.main() diff --git a/src/contrib/zkpython/src/test/connection_test.py b/src/contrib/zkpython/src/test/connection_test.py new file mode 100644 index 0000000..3913fe3 --- /dev/null +++ b/src/contrib/zkpython/src/test/connection_test.py @@ -0,0 +1,131 @@ +#!/usr/bin/python +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +import unittest, threading, re, sys +if sys.version_info < (3,): + range = xrange + +import zookeeper, zktestbase +ZOO_OPEN_ACL_UNSAFE = {"perms":0x1f, "scheme":"world", "id" :"anyone"} + +class ConnectionTest(zktestbase.TestBase): + """Test whether we can make a connection""" + def setUp(self): + pass + + def testconnection(self): + cv = threading.Condition() + self.connected = False + def connection_watcher(handle, type, state, path): + cv.acquire() + self.connected = True + self.assertEqual(zookeeper.CONNECTED_STATE, state) + self.handle = handle + cv.notify() + cv.release() + + cv.acquire() + ret = zookeeper.init(self.host, connection_watcher) + cv.wait(15.0) + cv.release() + self.assertEqual(self.connected, True, "Connection timed out to " + self.host) + self.assertEqual(zookeeper.CONNECTED_STATE, zookeeper.state(self.handle)) + + self.assertEqual(zookeeper.close(self.handle), zookeeper.OK) + # Trying to close the same handle twice is an error, and the C library will segfault on it + # so make sure this is caught at the Python module layer + self.assertRaises(zookeeper.ZooKeeperException, + zookeeper.close, + self.handle) + + self.assertRaises(zookeeper.ZooKeeperException, + zookeeper.get, + self.handle, + "/") + + def testhandlereuse(self): + """ + Test a) multiple concurrent connections b) reuse of closed handles + """ + cv = threading.Condition() + self.connected = False + def connection_watcher(handle, type, state, path): + cv.acquire() + self.connected = True + self.assertEqual(zookeeper.CONNECTED_STATE, state) + self.handle = handle + cv.notify() + cv.release() + + cv.acquire() + handles = [ zookeeper.init(self.host) for i in range(10) ] + ret = zookeeper.init(self.host, connection_watcher) + cv.wait(15.0) + cv.release() + self.assertEqual(self.connected, True, "Connection timed out to " + self.host) + self.assertEqual(True, self.all( [ zookeeper.state(handle) == zookeeper.CONNECTED_STATE for handle in handles ] ), + "Not all connections succeeded") + oldhandle = handles[3] + zookeeper.close(oldhandle) + newhandle = zookeeper.init(self.host) + + # This assertion tests *internal* behaviour; i.e. that the module + # correctly reuses closed handles. This is therefore implementation + # dependent. + self.assertEqual(newhandle, oldhandle, "Didn't get reused handle") + + def testmanyhandles(self): + """ + Test the ability of the module to support many handles. + """ + # We'd like to do more, but currently the C client doesn't + # work with > 83 handles (fails to create a pipe) on MacOS 10.5.8 + handles = [ zookeeper.init(self.host) for i in range(9) ] + + cv = threading.Condition() + self.connected = False + def connection_watcher(handle, type, state, path): + cv.acquire() + self.connected = True + self.assertEqual(zookeeper.CONNECTED_STATE, state) + self.handle = handle + cv.notify() + cv.release() + + cv.acquire() + ret = zookeeper.init(self.host, connection_watcher) + cv.wait(15.0) + cv.release() + self.assertEqual(self.connected, True, "Connection timed out to " + self.host) + + for i,h in enumerate(handles): + path = "/zkpython-test-handles-%s" % str(i) + self.assertEqual(path, zookeeper.create(h, path, "", [ZOO_OPEN_ACL_UNSAFE], zookeeper.EPHEMERAL)) + + self.assertEqual(True, self.all( zookeeper.close(h) == zookeeper.OK for h in handles )) + + def testversionstringexists(self): + self.assertTrue(hasattr(zookeeper, '__version__')) + self.assertTrue(re.match("\d.\d.\d", zookeeper.__version__)) + + + def tearDown(self): + pass + +if __name__ == '__main__': + unittest.main() diff --git a/src/contrib/zkpython/src/test/create_test.py b/src/contrib/zkpython/src/test/create_test.py new file mode 100644 index 0000000..8ab80f9 --- /dev/null +++ b/src/contrib/zkpython/src/test/create_test.py @@ -0,0 +1,104 @@ +#!/usr/bin/python +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +import zookeeper, zktestbase, unittest, threading + +ZOO_OPEN_ACL_UNSAFE = {"perms":0x1f, "scheme":"world", "id" :"anyone"} + +class CreationTest(zktestbase.TestBase): + """Test whether we can create znodes""" + # to do: startup and teardown via scripts? + def setUp(self): + zktestbase.TestBase.setUp(self) + try: + zookeeper.delete(self.handle, "/zk-python-createtest") + zookeeper.delete(self.handle, "/zk-python-acreatetest") + except: + pass + + def test_sync_create(self): + self.assertEqual(self.connected, True) + ret = zookeeper.create(self.handle, "/zk-python-createtest", "nodecontents", [ZOO_OPEN_ACL_UNSAFE], zookeeper.EPHEMERAL) + self.assertEqual(ret, "/zk-python-createtest") + self.assertRaises(zookeeper.NoChildrenForEphemeralsException, + zookeeper.create, + self.handle, + "/zk-python-createtest/invalid-child", + "", + [ZOO_OPEN_ACL_UNSAFE], + zookeeper.EPHEMERAL) + + def test_sync_create_existing(self): + self.assertEqual(self.connected, True) + ret = zookeeper.create(self.handle, "/zk-python-createtest-existing", "nodecontents", [ZOO_OPEN_ACL_UNSAFE], zookeeper.EPHEMERAL) + self.assertEqual(ret, "/zk-python-createtest-existing") + + self.assertRaises(zookeeper.NodeExistsException, + zookeeper.create, + self.handle, + "/zk-python-createtest-existing", + "nodecontents", + [ZOO_OPEN_ACL_UNSAFE], + zookeeper.EPHEMERAL) + + + def test_exception_paths(self): + """ + Make sure common exceptions due to API misuse are correctly propogated + """ + self.assertRaises(zookeeper.BadArgumentsException, + zookeeper.create, + self.handle, + "/zk-python-badargs-test", + "", + [ZOO_OPEN_ACL_UNSAFE], + -1) + self.assertRaises(zookeeper.InvalidACLException, + zookeeper.create, + self.handle, + "/zk-python-invalidacl-test", + "", + ZOO_OPEN_ACL_UNSAFE) # Error - not a list + + + def test_async_create(self): + self.cv = threading.Condition() + def callback(handle, rc, value): + self.cv.acquire() + self.callback_flag = True + self.rc = rc + self.cv.notify() + self.cv.release() + + self.assertEqual(self.connected, True, "Not connected!") + self.cv.acquire() + + ret = zookeeper.acreate(self.handle, "/zk-python-acreatetest", "nodecontents", + [ZOO_OPEN_ACL_UNSAFE], zookeeper.EPHEMERAL, + callback ) + self.assertEqual(ret, zookeeper.OK, "acreate failed") + while not self.callback_flag: + self.cv.wait(15) + self.cv.release() + + self.assertEqual(self.callback_flag, True, "acreate timed out") + self.assertEqual(self.rc, zookeeper.OK) + + +if __name__ == '__main__': + unittest.main() diff --git a/src/contrib/zkpython/src/test/delete_test.py b/src/contrib/zkpython/src/test/delete_test.py new file mode 100644 index 0000000..913b6a9 --- /dev/null +++ b/src/contrib/zkpython/src/test/delete_test.py @@ -0,0 +1,68 @@ +#!/usr/bin/python +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +import zookeeper, zktestbase, unittest, threading + +class DeletionTest(zktestbase.TestBase): + """Test whether we can delete znodes""" + + def test_sync_delete(self): + ZOO_OPEN_ACL_UNSAFE = {"perms":0x1f, "scheme":"world", "id" :"anyone"} + self.assertEqual(self.connected, True) + ret = zookeeper.create(self.handle, "/zk-python-deletetest", "nodecontents", [ZOO_OPEN_ACL_UNSAFE], zookeeper.EPHEMERAL) + self.assertEqual(ret, "/zk-python-deletetest") + ret = zookeeper.delete(self.handle,"/zk-python-deletetest") + self.assertEqual(ret, zookeeper.OK) + children = zookeeper.get_children(self.handle, "/") + self.assertEqual(False, "zk-python-deletetest" in children) + + # test exception + self.assertRaises(zookeeper.NoNodeException, + zookeeper.delete, + self.handle, + "/zk-python-deletetest") + + def test_async_delete(self): + ZOO_OPEN_ACL_UNSAFE = {"perms":0x1f, "scheme":"world", "id" :"anyone"} + self.assertEqual(self.connected, True) + ret = zookeeper.create(self.handle, "/zk-python-adeletetest", "nodecontents", [ZOO_OPEN_ACL_UNSAFE], zookeeper.EPHEMERAL) + self.assertEqual(ret, "/zk-python-adeletetest") + + self.cv = threading.Condition() + self.callback_flag = False + self.rc = -1 + def callback(handle, rc): + self.cv.acquire() + self.callback_flag = True + self.cv.notify() + self.rc = rc # don't assert this here, as if the assertion fails, the test will block + self.cv.release() + + self.cv.acquire() + ret = zookeeper.adelete(self.handle,"/zk-python-adeletetest",-1,callback) + self.assertEqual(ret, zookeeper.OK, "adelete failed") + while not self.callback_flag: + self.cv.wait(15) + self.cv.release() + + self.assertEqual(self.callback_flag, True, "adelete timed out") + self.assertEqual(self.rc, zookeeper.OK) + + +if __name__ == '__main__': + unittest.main() diff --git a/src/contrib/zkpython/src/test/exists_test.py b/src/contrib/zkpython/src/test/exists_test.py new file mode 100644 index 0000000..ddc6ef3 --- /dev/null +++ b/src/contrib/zkpython/src/test/exists_test.py @@ -0,0 +1,64 @@ +#!/usr/bin/python +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +import zookeeper, zktestbase, unittest, threading + +ZOO_OPEN_ACL_UNSAFE = {"perms":0x1f, "scheme":"world", "id" :"anyone"} +class ExistsTest(zktestbase.TestBase): + def setUp( self ): + zktestbase.TestBase.setUp(self) + try: + zookeeper.create(self.handle, "/zk-python-existstest","existstest", [ZOO_OPEN_ACL_UNSAFE],zookeeper.EPHEMERAL) + zookeeper.create(self.handle, "/zk-python-aexiststest","existstest",[ZOO_OPEN_ACL_UNSAFE],zookeeper.EPHEMERAL) + except: + pass + + def test_sync_exists(self): + self.assertEqual(self.connected, True) + ret = zookeeper.exists(self.handle, "/zk-python-existstest", None) + self.assertNotEqual(ret, None, "/zk-python-existstest does not exist (possibly means creation failure)") + + def test_sync_nexists(self): + self.assertEqual(None, zookeeper.exists(self.handle, "/i-dont-exist", None)) + + + def test_async_exists(self): + self.cv = threading.Condition() + def callback(handle, rc, stat): + self.cv.acquire() + self.callback_flag = True + self.cv.notify() + self.cv.release() + self.rc = rc + + self.assertEqual(self.connected, True) + + self.cv.acquire() + ret = zookeeper.aexists(self.handle, "/zk-python-aexiststest", None, + callback ) + self.assertEqual(ret, zookeeper.OK) + while not self.callback_flag: + self.cv.wait(15) + self.cv.release() + + self.assertEqual(self.callback_flag, True, "aexists timed out") + self.assertEqual(self.rc, zookeeper.OK, "Return code not ok:" + zookeeper.zerror(self.rc)) + + +if __name__ == '__main__': + unittest.main() diff --git a/src/contrib/zkpython/src/test/get_set_test.py b/src/contrib/zkpython/src/test/get_set_test.py new file mode 100644 index 0000000..b77b3b2 --- /dev/null +++ b/src/contrib/zkpython/src/test/get_set_test.py @@ -0,0 +1,211 @@ +#!/usr/bin/python +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +import zookeeper, zktestbase, unittest, threading, sys +if sys.version_info < (3,): + range = xrange + +ZOO_OPEN_ACL_UNSAFE = {"perms":0x1f, "scheme":"world", "id" :"anyone"} + +class GetSetTest(zktestbase.TestBase): + def setUp( self ): + zktestbase.TestBase.setUp(self) + try: + zookeeper.create(self.handle, "/zk-python-getsettest", "on",[ZOO_OPEN_ACL_UNSAFE], zookeeper.EPHEMERAL) + zookeeper.create(self.handle, "/zk-python-agetsettest", + "on",[ZOO_OPEN_ACL_UNSAFE], zookeeper.EPHEMERAL) + except: + pass + + def test_empty_node(self): + """ + Test for a bug when instead of empty string we can get + random data from buffer malloc'ed to hold node contents. + See ZOOKEEPER-1906 for details + """ + NODE_PATH = "/zk-python-test-empty-node" + self.ensureDeleted(NODE_PATH) + zookeeper.create(self.handle, NODE_PATH, "", + [{"perms":0x1f, "scheme":"world", "id" :"anyone"}]) + (data,stat) = zookeeper.get(self.handle, NODE_PATH, None) + self.assertEqual(data, "", "Data is not empty as expected: " + data) + + def test_sync_getset(self): + self.assertEqual(self.connected, True, "Not connected!") + (data,stat) = zookeeper.get(self.handle, "/zk-python-getsettest", None) + self.assertEqual(data, "on", "Data is not 'on' as expected: " + data) + ret = zookeeper.set(self.handle, "/zk-python-getsettest", + "off", stat["version"]) + (data,stat) = zookeeper.get(self.handle, "/zk-python-getsettest", None) + self.assertEqual(data, "off", "Data is not 'off' as expected: " + data) + self.assertRaises(zookeeper.BadVersionException, + zookeeper.set, + self.handle, + "/zk-python-getsettest", + "test", + stat["version"]+1) + stat2 = zookeeper.set2(self.handle, "/zk-python-getsettest", + "set2", stat["version"]) + self.assertNotEqual(stat2, None, "set2 call failed, return should not be None") + self.assertEqual(stat2["numChildren"], 0, + "set2 call failed, numChildren not 0 in set2 call") + (data,stat) = zookeeper.get(self.handle, "/zk-python-getsettest", None) + self.assertEqual(data, "set2", "Data is not 'set2' as expected: " + data) + + def test_stat_deleted_node(self): + """ + Test for a bug that surfaced when trying to build a + stat object from a non-existant node. + + """ + self.ensureDeleted("/zk-python-test-deleteme") + self.assertRaises(zookeeper.NoNodeException, + zookeeper.get, + self.handle, + "/zk-python-test-deleteme") + self.cv = threading.Condition() + def callback(handle, rc, value, stat): + self.cv.acquire() + self.stat = stat + self.rc = rc + self.value = value + self.callback_flag = True + self.cv.notify() + self.cv.release() + self.cv.acquire() + zookeeper.aget(self.handle, "/zk-python-test-deleteme", None, callback) + self.cv.wait(15) + self.assertEqual(self.callback_flag, True, "aget timed out!") + self.assertEqual(self.stat, None, "Stat should be none!") + self.assertEqual(self.value, None, "Value should be none!") + + def test_sync_get_large_datanode(self): + """ + Test that we can retrieve datanode sizes up to + 1Mb with default parameters (depends on ZooKeeper server). + """ + + data = ''.join(["A" for x in range(1024*1023)]) + self.ensureDeleted("/zk-python-test-large-datanode") + zookeeper.create(self.handle, "/zk-python-test-large-datanode", data, + [{"perms":0x1f, "scheme":"world", "id" :"anyone"}]) + (ret,stat) = zookeeper.get(self.handle, "/zk-python-test-large-datanode") + self.assertEqual(len(ret), 1024*1023, + "Should have got 1Mb returned, instead got %s" % len(ret)) + (ret,stat) = zookeeper.get(self.handle, "/zk-python-test-large-datanode",None,500) + self.assertEqual(len(ret), 500, + "Should have got 500 bytes returned, instead got %s" % len(ret)) + + + + def test_async_getset(self): + self.cv = threading.Condition() + def get_callback(handle, rc, value, stat): + self.cv.acquire() + self.callback_flag = True + self.rc = rc + self.value = (value,stat) + self.cv.notify() + self.cv.release() + + def set_callback(handle, rc, stat): + self.cv.acquire() + self.callback_flag = True + self.rc = rc + self.value = stat + self.cv.notify() + self.cv.release() + + self.assertEqual(self.connected, True, "Not connected!") + + self.cv.acquire() + self.callback_flag = False + ret = zookeeper.aset(self.handle, "/zk-python-agetsettest", "off", -1, set_callback) + self.assertEqual(ret, zookeeper.OK, "aset failed") + while not self.callback_flag: + self.cv.wait(15) + self.cv.release() + self.assertEqual(self.callback_flag, True, "aset timed out") + + self.cv.acquire() + self.callback_flag = False + ret = zookeeper.aget(self.handle, "/zk-python-agetsettest", None, get_callback) + self.assertEqual(ret, zookeeper.OK, "aget failed") + self.cv.wait(15) + self.cv.release() + self.assertEqual(self.callback_flag, True, "aget timed out") + self.assertEqual(self.value[0], "off", "Data is not 'off' as expected: " + self.value[0]) + + def test_sync_getchildren(self): + self.ensureCreated("/zk-python-getchildrentest", flags=0) + self.ensureCreated("/zk-python-getchildrentest/child") + children = zookeeper.get_children(self.handle, "/zk-python-getchildrentest") + self.assertEqual(len(children), 1, "Expected to find 1 child, got " + str(len(children))) + + def test_async_getchildren(self): + self.ensureCreated("/zk-python-getchildrentest", flags=0) + self.ensureCreated("/zk-python-getchildrentest/child") + + def gc_callback(handle, rc, children): + self.cv.acquire() + self.rc = rc + self.children = children + self.callback_flag = True + self.cv.notify() + self.cv.release() + + self.cv.acquire() + self.callback_flag = False + zookeeper.aget_children(self.handle, "/zk-python-getchildrentest", None, gc_callback) + self.cv.wait(15) + self.assertEqual(self.callback_flag, True, "aget_children timed out") + self.assertEqual(self.rc, zookeeper.OK, "Return code for aget_children was not OK - %s" % zookeeper.zerror(self.rc)) + self.assertEqual(len(self.children), 1, "Expected to find 1 child, got " + str(len(self.children))) + + + def test_async_getchildren_with_watcher(self): + self.ensureCreated("/zk-python-getchildrentest", flags=0) + self.ensureCreated("/zk-python-getchildrentest/child") + + watched = [] + + def watcher(*args): + self.cv.acquire() + watched.append(args) + self.cv.notify() + self.cv.release() + + def children_callback(*args): + self.cv.acquire() + self.cv.notify() + self.cv.release() + + zookeeper.aget_children( + self.handle, "/zk-python-getchildrentest", watcher, children_callback) + + self.cv.acquire() + self.cv.wait() + self.cv.release() + + self.cv.acquire() + self.ensureCreated("/zk-python-getchildrentest/child2") + self.cv.wait(15) + self.assertTrue(watched) + +if __name__ == '__main__': + unittest.main() diff --git a/src/contrib/zkpython/src/test/run_tests.sh b/src/contrib/zkpython/src/test/run_tests.sh new file mode 100644 index 0000000..18d9240 --- /dev/null +++ b/src/contrib/zkpython/src/test/run_tests.sh @@ -0,0 +1,40 @@ +#!/bin/sh +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +# Usage: run_tests.sh testdir [logdir] +# logdir is optional, defaults to cwd + +# get the number of command-line arguments given +ARGC=$# + +# check to make sure enough arguments were given or exit +if [ $ARGC -lt 2 ]; then + export ZKPY_LOG_DIR="." +else + export ZKPY_LOG_DIR=$2 +fi + +# Find the build directory containing zookeeper.so +SO_PATH=`find ../../../build/ -name "zookeeper.so" | head -1` +PYTHONPATH=`dirname $SO_PATH` +LIB_PATH=../../c/.libs/:../../../build/test/test-cppunit/.libs +for test in `ls $1/*_test.py`; +do + echo "Running $test" + LD_LIBRARY_PATH=$LIB_PATH:$LD_LIBRARY_PATH DYLD_LIBRARY_PATH=$LIB_PATH:$DYLD_LIBRARY_PATH PYTHONPATH=$PYTHONPATH python $test +done diff --git a/src/contrib/zkpython/src/test/zkServer.sh b/src/contrib/zkpython/src/test/zkServer.sh new file mode 100644 index 0000000..51d508f --- /dev/null +++ b/src/contrib/zkpython/src/test/zkServer.sh @@ -0,0 +1,77 @@ +#!/bin/bash +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +if [ "x$1" == "x" ] +then + echo "USAGE: $0 startClean|start|stop hostPorts" + exit 2 +fi + +if [ "x$1" == "xstartClean" ] +then + if [ "x${base_dir}" == "x" ] + then + rm -rf /tmp/zkdata + else + rm -rf ${base_dir}/build/tmp + fi +fi + +if [ "x${base_dir}" == "x" ] +then +zk_base="../../../" +else +zk_base="${base_dir}" +fi + +CLASSPATH="$CLASSPATH:${zk_base}/build/classes" +CLASSPATH="$CLASSPATH:${zk_base}/conf" + +for i in "${zk_base}"/build/lib/*.jar +do + CLASSPATH="$CLASSPATH:$i" +done + +for i in "${zk_base}"/src/java/lib/*.jar +do + CLASSPATH="$CLASSPATH:$i" +done + +# Make sure nothing is left over from before +#fuser -skn tcp 22182/tcp + +case $1 in +start|startClean) + if [ "x${base_dir}" == "x" ] + then + mkdir -p /tmp/zkdata + java -cp $CLASSPATH org.apache.zookeeper.server.ZooKeeperServerMain 22182 /tmp/zkdata &> /tmp/zk.log & + else + mkdir -p ${base_dir}/build/tmp/zkdata + java -cp $CLASSPATH org.apache.zookeeper.server.ZooKeeperServerMain 22182 ${base_dir}/build/tmp/zkdata &> ${base_dir}/build/tmp/zk.log & + fi + sleep 5 + ;; +stop) + # Already killed above + ;; +*) + echo "Unknown command " + $1 + exit 2 +esac + diff --git a/src/contrib/zkpython/src/test/zktestbase.py b/src/contrib/zkpython/src/test/zktestbase.py new file mode 100644 index 0000000..8229418 --- /dev/null +++ b/src/contrib/zkpython/src/test/zktestbase.py @@ -0,0 +1,101 @@ +#!/usr/bin/python +# +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at + +# http://www.apache.org/licenses/LICENSE-2.0 + +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +import os +import unittest, threading, zookeeper +ZOO_OPEN_ACL_UNSAFE = {"perms":0x1f, "scheme":"world", "id" :"anyone"} + +class TestBase(unittest.TestCase): + SERVER_PORT = 22182 + + def __init__(self,methodName='runTest'): + unittest.TestCase.__init__(self,methodName) + self.host = "localhost:%d" % self.SERVER_PORT + self.connected = False + self.handle = -1 + logdir = os.environ.get("ZKPY_LOG_DIR") + logfile = os.path.join(logdir, self.__class__.__name__ + ".log") + try: + f = open(logfile,"w") + zookeeper.set_log_stream(f) + except IOError: + print("Couldn't open " + logfile + " for writing") + + + def setUp(self): + self.callback_flag = False + self.cv = threading.Condition() + self.connected = False + def connection_watcher(handle, type, state, path): + self.cv.acquire() + self.connected = True + self.cv.notify() + self.cv.release() + + self.cv.acquire() + self.handle = zookeeper.init(self.host, connection_watcher) + self.cv.wait(15.0) + self.cv.release() + + if not self.connected: + raise Exception("Couldn't connect to host -", self.host) + + def newConnection(self): + cv = threading.Condition() + self.pending_connection = False + def connection_watcher(handle, type, state, path): + cv.acquire() + self.pending_connection = True + cv.notify() + cv.release() + + cv.acquire() + handle = zookeeper.init(self.host, connection_watcher) + cv.wait(15.0) + cv.release() + + if not self.pending_connection: + raise Exception("Couldn't connect to host -", self.host) + return handle + + def ensureDeleted(self,path): + self.assertEqual(zookeeper.CONNECTED_STATE, zookeeper.state(self.handle), "Not connected!") + try: + self.assertEqual(zookeeper.OK, zookeeper.delete(self.handle, path)) + except zookeeper.NoNodeException: + pass + + def ensureCreated(self,path,data="",flags=zookeeper.EPHEMERAL): + """ + It's possible not to get the flags you want here if the node already exists + """ + self.assertEqual(zookeeper.CONNECTED_STATE, zookeeper.state(self.handle), "Not connected!") + try: + self.assertEqual(path, zookeeper.create(self.handle, path, data, [ZOO_OPEN_ACL_UNSAFE], flags)) + except zookeeper.NodeExistsException: + pass + + def tearDown(self): + if self.connected: + zookeeper.close(self.handle) + + def all(self, iterable): + for element in iterable: + if not element: + return False + return True diff --git a/src/contrib/zktreeutil/Makefile.am b/src/contrib/zktreeutil/Makefile.am new file mode 100644 index 0000000..36da1a5 --- /dev/null +++ b/src/contrib/zktreeutil/Makefile.am @@ -0,0 +1,4 @@ +## Process this file with automake to produce Makefile.in + +SUBDIRS = src + diff --git a/src/contrib/zktreeutil/README.txt b/src/contrib/zktreeutil/README.txt new file mode 100644 index 0000000..43b06fa --- /dev/null +++ b/src/contrib/zktreeutil/README.txt @@ -0,0 +1,74 @@ +========================================== +zktreeutil - Zookeeper Tree Data Utility +Author: Anirban Roy +Organization: Yahoo Inc. +========================================== + +zktreeutil program is intended to manage and manipulate zk-tree data quickly, effi- +ciently and with ease. The utility operates on free-form ZK-tree and hence can be used +for any cluster managed by Zookeeper. Here are the basic functionalities - + +EXPORT: The whole/partial ZK-tree is exported into a XML file. This helps in +capturing a current snapshot of the data for backup/analysis. For a subtree +export, one need to specify the path to the ZK-subtree with proper option. + +IMPORT: The ZK-tree can be imported from XML into ZK cluster. This helps in priming +the new ZK cluster with static configuration. The import can be non-intrusive by +making only the additions in the existing data. The import of subtree is also +possible by optionally providing the path to the ZK-subtree. + +DIFF: Creates a diff between live ZK data vs data saved in XML file. Diff can ignore +some ZK-tree branches (possibly dynamic data) on reading the optional ignore flag +from XML file. Diffing on a ZK-subtree achieved by providing path to ZK-subtree with +diff command. + +UPDATE: Make the incremental changes into the live ZK-tree from saved XML, essentia- +lly after running the diff. + +DUMP: Dumps the ZK-tree on the standard output device reading either from live ZK +server or XML file. Like export, ZK-subtree can be dumped with optionaly +providing the path to the ZK-subtree, and till a certain depth of the (sub)tree. + +The exported ZK data into XML file can be shortened by only keeping the static ZK +nodes which are required to prime a cluster. The dynamic zk nodes (created on-the- +fly) can be ignored by setting a 'ignore' attribute at the root node of the dynamic +subtree (see tests/zk_sample.xml), possibly deleting all inner ZK nodes under that. +Once ignored, the whole subtree is ignored during DIFF, UPDATE and WRITE. + +Pre-requisites +-------------- +1. Linux system with 2.6.X kernel. +2. Zookeeper C client library (locally built at ../../c/.libs) >= 3.X.X +3. Development build libraries (rpm packages): + a. boost-devel >= 1.32.0 + b. libxml2-devel >= 2.7.3 + c. log4cxx0100-devel >= 0.10.0 + +Build instructions +------------------ +1. cd into this directory +2. autoreconf -if +3. ./configure +4. make +5. 'zktreeutil' binary created under src directory + +Limitations +----------- +Current version works with text data only, binary data will be supported in future +versions. + +Testing and usage of zktreeutil +-------------------------------- +1. Run Zookeeper server locally on port 2181 +2. export LD_LIBRARY_PATH=../../c/.libs/:/usr/local/lib/ +3. ./src/zktreeutil --help # show help +4. ./src/zktreeutil --zookeeper=localhost:2181 --import --xmlfile=tests/zk_sample.xml 2>/dev/null # import sample ZK tree +5. ./src/zktreeutil --zookeeper=localhost:2181 --dump --path=/myapp/version-1.0 2>/dev/null # dump Zk subtree +5. ./src/zktreeutil --zookeeper=localhost:2181 --dump --depth=3 2>/dev/null # dump Zk tree till certain depth +6. ./src/zktreeutil --xmlfile=zk_sample.xml -D 2>/dev/null # dump the xml data +7. Change zk_sample.xml with adding/deleting/chaging some nodes +8. ./src/zktreeutil -z localhost:2181 -F -x zk_sample.xml -p /myapp/version-1.0/configuration 2>/dev/null # take a diff of changes +9. ./src/zktreeutil -z localhost:2181 -E 2>/dev/null > zk_sample2.xml # export the mofied ZK tree +10. ./src/zktreeutil -z localhost:2181 -U -x zk_sample.xml -p /myapp/version-1.0/distributions 2>/dev/null # update with incr. changes +11. ./src/zktreeutil --zookeeper=localhost:2181 --import --force --xmlfile=zk_sample2.xml 2>/dev/null # re-prime the ZK tree + diff --git a/src/contrib/zktreeutil/build.xml b/src/contrib/zktreeutil/build.xml new file mode 100644 index 0000000..809d134 --- /dev/null +++ b/src/contrib/zktreeutil/build.xml @@ -0,0 +1,61 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/contrib/zktreeutil/configure.ac b/src/contrib/zktreeutil/configure.ac new file mode 100644 index 0000000..b4a82a7 --- /dev/null +++ b/src/contrib/zktreeutil/configure.ac @@ -0,0 +1,66 @@ +# -*- Autoconf -*- +# Process this file with autoconf to produce a configure script. + +AC_PREREQ(2.59) + +AC_INIT([zktreeutil], [1.0.0]) +AM_INIT_AUTOMAKE(foreign) + +AC_CONFIG_SRCDIR([src]) +AM_CONFIG_HEADER([config.h]) + +PACKAGE=zktreeutil +VERSION=1.0.0 + +AC_SUBST(PACKAGE) +AC_SUBST(VERSION) +BUILD_PATH="`pwd`" + +# Checks for programs. +AC_LANG_CPLUSPLUS +AC_PROG_CXX + +# Checks for libxm2. +AM_PATH_XML2(2.7.3) +XML2_INCLUDE="/usr/include/libxml2" +AC_SUBST(XML2_INCLUDE) + +# Zookeeper C client +ZOOKEEPER_PATH=${BUILD_PATH}/../../c +AC_CHECK_LIB(zookeeper_mt, main, [ZOOKEEPER="-L${ZOOKEEPER_PATH}/.libs -lzookeeper_mt"],,["-L${ZOOKEEPER_PATH}/.libs"]) +if test -z "${ZOOKEEPER}"; then + AC_ERROR("... zookeeper C client not found!") +fi + +AC_SUBST(ZOOKEEPER) +AC_SUBST(ZOOKEEPER_PATH) + +### log4cxx ### + +LOG4CXX_VERSION="0.10.0" +LOG4CXX_INCLUDE="/usr/local/include" +LOG4CXX_LIB_PATH="/usr/local/lib" +AC_CHECK_LIB(log4cxx, main, [LOG4CXX="-L${LOG4CXX_LIB_PATH} -llog4cxx"],,["-L${LOG4CXX_LIB_PATH}"]) +if test -z "${LOG4CXX}"; then + AC_ERROR("... log4cxx not found!") +fi + +AC_SUBST(LOG4CXX) +AC_SUBST(LOG4CXX_VERSION) +AC_SUBST(LOG4CXX_INCLUDE) + +# Checks for header files. +AC_HEADER_DIRENT +AC_HEADER_STDC +AC_CHECK_HEADERS([stdlib.h string.h stdio.h unistd.h boost/shared_ptr.hpp boost/algorithm/string.hpp boost/algorithm/string/split.hpp]) + +# Checks for typedefs, structures, and compiler characteristics. +AC_HEADER_STDBOOL +AC_C_CONST +AC_C_INLINE +AC_TYPE_SIZE_T +AC_C_VOLATILE + +AC_CONFIG_FILES([Makefile]) +AC_CONFIG_FILES([src/Makefile]) +AC_OUTPUT diff --git a/src/contrib/zktreeutil/src/Makefile.am b/src/contrib/zktreeutil/src/Makefile.am new file mode 100644 index 0000000..641077a --- /dev/null +++ b/src/contrib/zktreeutil/src/Makefile.am @@ -0,0 +1,24 @@ +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +AM_CXXFLAGS = -I${ZOOKEEPER_PATH}/include -I${ZOOKEEPER_PATH}/generated \ + -I$(top_srcdir)/include -I${LOG4CXX_INCLUDE} -I/usr/include \ + -I${XML2_INCLUDE} + +bin_PROGRAMS = zktreeutil + +zktreeutil_SOURCES = ZkAdaptor.cc ZkTreeUtil.cc ZkTreeUtilMain.cc +zktreeutil_LDADD = ${ZOOKEEPER} ${XML_LIBS} ${LOG4CXX} diff --git a/src/contrib/zktreeutil/src/SimpleTree.h b/src/contrib/zktreeutil/src/SimpleTree.h new file mode 100644 index 0000000..8226f05 --- /dev/null +++ b/src/contrib/zktreeutil/src/SimpleTree.h @@ -0,0 +1,150 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifndef __SIMPLE_TREE_H__ +#define __SIMPLE_TREE_H__ + +#include +#include + +namespace zktreeutil +{ + using std::vector; + + /** + * \brief A simple tree data-structure template. + */ + template < class KeyType, class DataType > class SimpleTreeNode + { + private: + /** + * \brief The type representing simple-tree node smart-pointer. + */ + typedef boost::shared_ptr< SimpleTreeNode< KeyType, DataType > > SimpleTreeNodeSptr; + + public: + /** + * \brief Constructor. + * + * @param isRoot the flag indicating whether the node is root. + */ + SimpleTreeNode (bool isRoot=false) : isRoot_(isRoot) + { + } + + /** + * \brief Constructor. + * + * @param key the key stored at the tree node + * @param isRoot the flag indicating whether the node is root + */ + SimpleTreeNode (const KeyType& key, bool isRoot=false) : + isRoot_(isRoot), key_(key) + { + } + + /** + * \brief Constructor. + * + * @param key the key stored at the tree node + * @param val the value stored at the tree node + * @param isRoot the flag indicating whether the node is root + */ + SimpleTreeNode (const KeyType& key, const DataType& val, bool isRoot=false) : + isRoot_(isRoot), key_(key), val_(val) + { + } + + /** + * \brief Destructor. + */ + ~SimpleTreeNode () throw() {} + + /** + * \brief Add a child node to this node. + * + * @param node the child node to be added + */ + void addChild (const SimpleTreeNodeSptr node) { children_.push_back (node); } + + /** + * \brief Sets the key of this node. + * + * @param key the key to be set + */ + void setKey (const KeyType& key) { key_ = key; } + + /** + * \brief Sets the data of this node. + * + * @param val the value to be set + */ + void setData (const DataType& val) { val_ = val; } + + /** + * \brief Gets the key of this node. + * + * @return the key of this node + */ + KeyType getKey () const { return key_; } + + /** + * \brief Gets the data of this node. + * + * @return the value of this node + */ + DataType getData () const { return val_; } + + /** + * \brief Gets the i'th of this node. + * + * @param idx the index of the child node + * @return the child node + */ + SimpleTreeNodeSptr getChild (unsigned idx) const { return children_[idx]; } + + /** + * \brief Gets the number of children of this node. + * + * @return the number of children + */ + unsigned numChildren () const { return children_.size(); } + + /** + * \brief Indicates whether this node is root. + * + * @return 'true' if this node is root, 'false' otherwise + */ + bool isRoot () const { return isRoot_; } + + /** + * \brief Indicates whether this node is leaf node. + * + * @return 'true' if this node is leaf node, 'false' otherwise + */ + bool isLeaf () const { return !numChildren(); } + + private: + bool isRoot_; // Flag indicates if the node is root + KeyType key_; // Key of this node + DataType val_; // Value of this node + vector< SimpleTreeNodeSptr > children_; // List of children of this node + }; +} + +#endif // __SIMPLE_TREE_H__ diff --git a/src/contrib/zktreeutil/src/ZkAdaptor.cc b/src/contrib/zktreeutil/src/ZkAdaptor.cc new file mode 100644 index 0000000..1df175a --- /dev/null +++ b/src/contrib/zktreeutil/src/ZkAdaptor.cc @@ -0,0 +1,513 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#include "ZkAdaptor.h" +#include +#include +#include +#include +#include + +// Logger +static log4cxx::LoggerPtr zkLoggerPtr = log4cxx::Logger::getLogger ("zookeeper.core"); + +namespace zktreeutil +{ + /** + * \brief This class provides logic for checking if a request can be retried. + */ + class RetryHandler + { + public: + RetryHandler(const ZooKeeperConfig &zkConfig) : m_zkConfig(zkConfig) + { + if (zkConfig.getAutoReconnect()) + retries = 2; + else + retries = 0; + } + + /** + * \brief Attempts to fix a side effect of the given RC. + * + * @param rc the ZK error code + * @return whether the error code has been handled and the caller should + * retry an operation the caused this error + */ + bool handleRC(int rc) + { + //check if the given error code is recoverable + if (!retryOnError(rc)) + return false; + + std::cerr << "[zktreeuti] Number of retries left: " << retries << std::endl; + if (retries-- > 0) + return true; + else + return false; + } + + private: + /** + * The ZK config. + */ + const ZooKeeperConfig &m_zkConfig; + + /** + * The number of outstanding retries. + */ + int retries; + + /** + * Checks whether the given error entitles this adapter + * to retry the previous operation. + * + * @param zkErrorCode one of the ZK error code + */ + static bool retryOnError(int zkErrorCode) + { + return (zkErrorCode == ZCONNECTIONLOSS || zkErrorCode == ZOPERATIONTIMEOUT); + } + }; + + + // ======================================================================= + + ZooKeeperAdapter::ZooKeeperAdapter(ZooKeeperConfig config) throw(ZooKeeperException) : + m_zkConfig(config), + mp_zkHandle(NULL) + { + // Enforce setting up appropriate ZK log level + if (zkLoggerPtr->isDebugEnabled() +#ifdef LOG4CXX_TRACE + || zkLoggerPtr->isTraceEnabled() +#endif + ) + { + zoo_set_debug_level( ZOO_LOG_LEVEL_DEBUG ); + } else if (zkLoggerPtr->isInfoEnabled()) { + zoo_set_debug_level( ZOO_LOG_LEVEL_INFO ); + } else if (zkLoggerPtr->isWarnEnabled()) { + zoo_set_debug_level( ZOO_LOG_LEVEL_WARN ); + } else { + zoo_set_debug_level( ZOO_LOG_LEVEL_ERROR ); + } + + // Establish the connection + reconnect(); + } + + ZooKeeperAdapter::~ZooKeeperAdapter() + { + try + { + disconnect(); + } + catch (std::exception &e) + { + std::cerr << "[zktreeutil] An exception while disconnecting from ZK: " + << e.what() + << std::endl; + } + } + + void ZooKeeperAdapter::validatePath(const string &path) throw(ZooKeeperException) + { + if (path.find ("/") != 0) + { + std::ostringstream oss; + oss << "Node path must start with '/' but" "it was '" + << path + << "'"; + throw ZooKeeperException (oss.str()); + } + if (path.length() > 1) + { + if (path.rfind ("/") == path.length() - 1) + { + std::ostringstream oss; + oss << "Node path must not end with '/' but it was '" + << path + << "'"; + throw ZooKeeperException (oss.str()); + } + if (path.find( "//" ) != string::npos) + { + std::ostringstream oss; + oss << "Node path must not contain '//' but it was '" + << path + << "'"; + throw ZooKeeperException (oss.str()); + } + } + } + + void ZooKeeperAdapter::disconnect() + { + if (mp_zkHandle != NULL) + { + zookeeper_close (mp_zkHandle); + mp_zkHandle = NULL; + } + } + + void ZooKeeperAdapter::reconnect() throw(ZooKeeperException) + { + // Clear the connection state + disconnect(); + + // Establish a new connection to ZooKeeper + mp_zkHandle = zookeeper_init( m_zkConfig.getHosts().c_str(), + NULL, + m_zkConfig.getLeaseTimeout(), + 0, + NULL, + 0); + if (mp_zkHandle == NULL) + { + // Invalid handle returned + std::ostringstream oss; + oss << "Unable to connect to ZK running at '" + << m_zkConfig.getHosts() + << "'"; + throw ZooKeeperException (oss.str()); + } + + // Enter into connect loop + int64_t connWaitTime = m_zkConfig.getConnectTimeout(); + while (1) + { + int state = zoo_state (mp_zkHandle); + if (state == ZOO_CONNECTED_STATE) + { + // connected + std::cerr << "[zktreeutil] Connected! mp_zkHandle: " + << mp_zkHandle + << std::endl; + return; + } + else if ( state && state != ZOO_CONNECTING_STATE) + { + // Not connecting any more... some other issue + std::ostringstream oss; + oss << "Unable to connect to ZK running at '" + << m_zkConfig.getHosts() + << "'; state=" + << state; + throw ZooKeeperException (oss.str()); + } + + // Still connecting, wait and come back + struct timeval now; + gettimeofday( &now, NULL ); + int64_t milliSecs = -(now.tv_sec * 1000LL + now.tv_usec / 1000); + std::cerr << "[zktreeutil] About to wait 1 sec" << std::endl; + sleep (1); + gettimeofday( &now, NULL ); + milliSecs += now.tv_sec * 1000LL + now.tv_usec / 1000; + connWaitTime -= milliSecs; + // Timed out !!! + if (connWaitTime <= 0) + break; + } + + // Timed out while connecting + std::ostringstream oss; + oss << "Timed out while connecting to ZK running at '" + << m_zkConfig.getHosts() + << "'"; + throw ZooKeeperException (oss.str()); + } + + void ZooKeeperAdapter::verifyConnection() throw(ZooKeeperException) + { + // Check connection state + int state = zoo_state (mp_zkHandle); + if (state != ZOO_CONNECTED_STATE) + { + if (m_zkConfig.getAutoReconnect()) + { + // Trying to reconnect + std::cerr << "[zktreeutil] Trying to reconnect..." << std::endl; + reconnect(); + } + else + { + std::ostringstream oss; + oss << "Disconnected from ZK running at '" + << m_zkConfig.getHosts() + << "'; state=" + << state; + throw ZooKeeperException (oss.str()); + } + } + } + + bool ZooKeeperAdapter::createNode(const string &path, + const string &value, + int flags, + bool createAncestors) throw(ZooKeeperException) + { + const int MAX_PATH_LENGTH = 1024; + char realPath[MAX_PATH_LENGTH]; + realPath[0] = 0; + + int rc; + RetryHandler rh(m_zkConfig); + do + { + verifyConnection(); + rc = zoo_create( mp_zkHandle, + path.c_str(), + value.c_str(), + value.length(), + &ZOO_OPEN_ACL_UNSAFE, + flags, + realPath, + MAX_PATH_LENGTH ); + } while (rc != ZOK && rh.handleRC(rc)); + if (rc != ZOK) // check return status + { + if (rc == ZNODEEXISTS) + { + //the node already exists + std::cerr << "[zktreeutil] ZK node " << path << " already exists" << std::endl; + return false; + } + else if (rc == ZNONODE && createAncestors) + { + std::cerr << "[zktreeutil] Intermediate ZK node missing in path " << path << std::endl; + //one of the ancestors doesn't exist so lets start from the root + //and make sure the whole path exists, creating missing nodes if + //necessary + for (string::size_type pos = 1; pos != string::npos; ) + { + pos = path.find( "/", pos ); + if (pos != string::npos) + { + try + { + createNode( path.substr( 0, pos ), "", 0, true ); + } + catch (ZooKeeperException &e) + { + throw ZooKeeperException( string("Unable to create " "node ") + path, rc ); + } + pos++; + } + else + { + // No more path components + return createNode( path, value, flags, false ); + } + } + } + + // Unexpected error during create + std::cerr << "[zktreeutil] Error in creating ZK node " << path << std::endl; + throw ZooKeeperException( string("Unable to create node ") + path, rc ); + } + + // Success + std::cerr << "[zktreeutil] " << realPath << " has been created" << std::endl; + return true; + } + + bool ZooKeeperAdapter::deleteNode(const string &path, + bool recursive, + int version) throw(ZooKeeperException) + { + // Validate the zk path + validatePath( path ); + + int rc; + RetryHandler rh(m_zkConfig); + do + { + verifyConnection(); + rc = zoo_delete( mp_zkHandle, path.c_str(), version ); + } while (rc != ZOK && rh.handleRC(rc)); + if (rc != ZOK) //check return status + { + if (rc == ZNONODE) + { + std::cerr << "[zktreeutil] ZK Node " + << path + << " does not exist" + << std::endl; + return false; + } + if (rc == ZNOTEMPTY && recursive) + { + std::cerr << "[zktreeutil] ZK Node " + << path + << " not empty; deleting..." + << std::endl; + //get all children and delete them recursively... + vector nodeList = getNodeChildren (path); + for (vector::const_iterator i = nodeList.begin(); + i != nodeList.end(); + ++i) { + deleteNode( *i, true ); + } + //...and finally attempt to delete the node again + return deleteNode( path, false ); + } + + // Unexpected return without success + std::cerr << "[zktreeutil] Unable to delete ZK node " << path << std::endl; + throw ZooKeeperException( string("Unable to delete node ") + path, rc ); + } + + // success + std::cerr << "[zktreeutil] " << path << " has been deleted" << std::endl; + return true; + } + + vector< string > ZooKeeperAdapter::getNodeChildren (const string &path) throw (ZooKeeperException) + { + // Validate the zk path + validatePath( path ); + + String_vector children; + memset( &children, 0, sizeof(children) ); + int rc; + RetryHandler rh(m_zkConfig); + do + { + verifyConnection(); + rc = zoo_get_children( mp_zkHandle, + path.c_str(), + 0, + &children ); + } while (rc != ZOK && rh.handleRC(rc)); + if (rc != ZOK) // check return code + { + std::cerr << "[zktreeutil] Error in fetching children of " << path << std::endl; + throw ZooKeeperException( string("Unable to get children of node ") + path, rc ); + } + else + { + vector< string > nodeList; + for (int i = 0; i < children.count; ++i) + { + //convert each child's path from relative to absolute + string absPath(path); + if (path != "/") + { + absPath.append( "/" ); + } + absPath.append( children.data[i] ); + nodeList.push_back( absPath ); + } + + //make sure the order is always deterministic + sort( nodeList.begin(), nodeList.end() ); + return nodeList; + } + } + + bool ZooKeeperAdapter::nodeExists(const string &path) throw(ZooKeeperException) + { + // Validate the zk path + validatePath( path ); + + struct Stat tmpStat; + struct Stat* stat = &tmpStat; + memset( stat, 0, sizeof(Stat) ); + + int rc; + RetryHandler rh(m_zkConfig); + do { + verifyConnection(); + rc = zoo_exists( mp_zkHandle, + path.c_str(), + 0, + stat ); + } while (rc != ZOK && rh.handleRC(rc)); + if (rc != ZOK) + { + if (rc == ZNONODE) + return false; + // Some error + std::cerr << "[zktreeutil] Error in checking existence of " << path << std::endl; + throw ZooKeeperException( string("Unable to check existence of node ") + path, rc ); + } else { + return true; + } + } + + string ZooKeeperAdapter::getNodeData(const string &path) throw(ZooKeeperException) + { + // Validate the zk path + validatePath( path ); + + const int MAX_DATA_LENGTH = 128 * 1024; + char buffer[MAX_DATA_LENGTH]; + memset( buffer, 0, MAX_DATA_LENGTH ); + struct Stat tmpStat; + struct Stat* stat = &tmpStat; + memset( stat, 0, sizeof(Stat) ); + + int rc; + int len; + RetryHandler rh(m_zkConfig); + do { + verifyConnection(); + len = MAX_DATA_LENGTH - 1; + rc = zoo_get( mp_zkHandle, + path.c_str(), + 0, + buffer, &len, stat ); + } while (rc != ZOK && rh.handleRC(rc)); + if (rc != ZOK) // checl return code + { + std::cerr << "[zktreeutil] Error in fetching value of " << path << std::endl; + throw ZooKeeperException( string("Unable to get data of node ") + path, rc ); + } + + // return data + return string( buffer, buffer + len ); + } + + void ZooKeeperAdapter::setNodeData(const string &path, + const string &value, + int version) throw(ZooKeeperException) + { + // Validate the zk path + validatePath( path ); + + int rc; + RetryHandler rh(m_zkConfig); + do { + verifyConnection(); + rc = zoo_set( mp_zkHandle, + path.c_str(), + value.c_str(), + value.length(), + version); + } while (rc != ZOK && rh.handleRC(rc)); + if (rc != ZOK) // check return code + { + std::cerr << "[zktreeutil] Error in setting value of " << path << std::endl; + throw ZooKeeperException( string("Unable to set data for node ") + path, rc ); + } + // success + } + +} /* end of 'namespace zktreeutil' */ diff --git a/src/contrib/zktreeutil/src/ZkAdaptor.h b/src/contrib/zktreeutil/src/ZkAdaptor.h new file mode 100644 index 0000000..4b68e28 --- /dev/null +++ b/src/contrib/zktreeutil/src/ZkAdaptor.h @@ -0,0 +1,327 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifndef __ZK_ADAPTER_H__ +#define __ZK_ADAPTER_H__ + +#include +#include + +extern "C" { +#include "zookeeper.h" +} + +namespace zktreeutil +{ + using std::string; + using std::vector; + + /** + * \brief A cluster related exception. + */ + class ZooKeeperException : public std::exception + { + public: + + /** + * \brief Constructor. + * + * @param msg the detailed message associated with this exception + */ + ZooKeeperException(const string& msg) : + m_message(msg), + m_zkErrorCode(0) {} + + /** + * \brief Constructor. + * + * @param msg the detailed message associated with this exception + * @param errorCode the ZK error code associated with this exception + */ + ZooKeeperException(const string &msg, int errorCode) : + m_zkErrorCode(errorCode) + { + char tmp[100]; + sprintf( tmp, " (ZK error code: %d)", errorCode ); + m_message = msg + tmp; + } + + /** + * \brief Destructor. + */ + ~ZooKeeperException() throw() {} + + /** + * \brief Returns detailed description of the exception. + */ + const char *what() const throw() + { + return m_message.c_str(); + } + + /** + * \brief Returns the ZK error code. + */ + int getZKErrorCode() const + { + return m_zkErrorCode; + } + + private: + + /** + * The detailed message associated with this exception. + */ + string m_message; + + /** + * The optional error code received from ZK. + */ + int m_zkErrorCode; + + }; + + /** + * \brief This class encapsulates configuration of a ZK client. + */ + class ZooKeeperConfig + { + public: + + /** + * \brief Constructor. + * + * @param hosts the comma separated list of host and port pairs of ZK nodes + * @param leaseTimeout the lease timeout (heartbeat) + * @param autoReconnect whether to allow for auto-reconnect + * @param connectTimeout the connect timeout, in milliseconds; + */ + ZooKeeperConfig(const string &hosts, + int leaseTimeout, + bool autoReconnect = true, + long long int connectTimeout = 15000) + : m_hosts(hosts), + m_leaseTimeout(leaseTimeout), + m_autoReconnect(autoReconnect), + m_connectTimeout(connectTimeout) {} + + /** + * \brief Returns the list of ZK hosts to connect to. + */ + string getHosts() const { return m_hosts; } + + /** + * \brief Returns the lease timeout. + */ + int getLeaseTimeout() const { return m_leaseTimeout; } + + /** + * \brief Returns whether {@link ZooKeeperAdapter} should attempt + * \brief to automatically reconnect in case of a connection failure. + */ + bool getAutoReconnect() const { return m_autoReconnect; } + + /** + * \brief Gets the connect timeout. + * + * @return the connect timeout + */ + long long int getConnectTimeout() const { return m_connectTimeout; } + + private: + + /** + * The host addresses of ZK nodes. + */ + const string m_hosts; + + /** + * The ZK lease timeout. + */ + const int m_leaseTimeout; + + /** + * True if this adapater should attempt to autoreconnect in case + * the current session has been dropped. + */ + const bool m_autoReconnect; + + /** + * How long to wait, in milliseconds, before a connection + * is established to ZK. + */ + const long long int m_connectTimeout; + }; + + /** + * \brief This is a wrapper around ZK C synchrounous API. + */ + class ZooKeeperAdapter + { + public: + /** + * \brief Constructor. + * Attempts to create a ZK adapter, optionally connecting + * to the ZK. Note, that if the connection is to be established + * and the given listener is NULL, some events may be lost, + * as they may arrive asynchronously before this method finishes. + * + * @param config the ZK configuration + * @throw ZooKeeperException if cannot establish connection to the given ZK + */ + ZooKeeperAdapter(ZooKeeperConfig config) throw(ZooKeeperException); + + /** + * \brief Destructor. + */ + ~ZooKeeperAdapter(); + + /** + * \brief Returns the current config. + */ + const ZooKeeperConfig &getZooKeeperConfig() const { return m_zkConfig; } + + /** + * \brief Restablishes connection to the ZK. + * If this adapter is already connected, the current connection + * will be dropped and a new connection will be established. + * + * @throw ZooKeeperException if cannot establish connection to the ZK + */ + void reconnect() throw(ZooKeeperException); + + /** + * \brief Disconnects from the ZK and unregisters {@link #mp_zkHandle}. + */ + void disconnect(); + + /** + * \brief Creates a new node identified by the given path. + * This method will optionally attempt to create all missing ancestors. + * + * @param path the absolute path name of the node to be created + * @param value the initial value to be associated with the node + * @param flags the ZK flags of the node to be created + * @param createAncestors if true and there are some missing ancestor nodes, + * this method will attempt to create them + * + * @return true if the node has been successfully created; false otherwise + * @throw ZooKeeperException if the operation has failed + */ + bool createNode(const string &path, + const string &value = "", + int flags = 0, + bool createAncestors = true) throw(ZooKeeperException); + + /** + * \brief Deletes a node identified by the given path. + * + * @param path the absolute path name of the node to be deleted + * @param recursive if true this method will attempt to remove + * all children of the given node if any exist + * @param version the expected version of the node. The function will + * fail if the actual version of the node does not match + * the expected version + * + * @return true if the node has been deleted; false otherwise + * @throw ZooKeeperException if the operation has failed + */ + bool deleteNode(const string &path, + bool recursive = false, + int version = -1) throw(ZooKeeperException); + + /** + * \brief Retrieves list of all children of the given node. + * + * @param path the absolute path name of the node for which to get children + * @return the list of absolute paths of child nodes, possibly empty + * @throw ZooKeeperException if the operation has failed + */ + vector getNodeChildren( const string &path) throw(ZooKeeperException); + + /** + * \brief Check the existence of path to a znode. + * + * @param path the absolute path name of the znode + * @return TRUE if the znode exists; FALSE otherwise + * @throw ZooKeeperException if the operation has failed + */ + bool nodeExists(const string &path) throw(ZooKeeperException); + + /** + * \brief Gets the given node's data. + * + * @param path the absolute path name of the node to get data from + * + * @return the node's data + * @throw ZooKeeperException if the operation has failed + */ + string getNodeData(const string &path) throw(ZooKeeperException); + + /** + * \brief Sets the given node's data. + * + * @param path the absolute path name of the node to get data from + * @param value the node's data to be set + * @param version the expected version of the node. The function will + * fail if the actual version of the node does not match + * the expected version + * + * @throw ZooKeeperException if the operation has failed + */ + void setNodeData(const string &path, + const string &value, + int version = -1) throw(ZooKeeperException); + + /** + * \brief Validates the given path to a node in ZK. + * + * @param the path to be validated + * + * @throw ZooKeeperException if the given path is not valid + * (for instance it doesn't start with "/") + */ + static void validatePath(const string &path) throw(ZooKeeperException); + + private: + + /** + * Verifies whether the connection is established, + * optionally auto reconnecting. + * + * @throw ZooKeeperConnection if this client is disconnected + * and auto-reconnect failed or was not allowed + */ + void verifyConnection() throw(ZooKeeperException); + + private: + + /** + * The current ZK configuration. + */ + const ZooKeeperConfig m_zkConfig; + + /** + * The current ZK session. + */ + zhandle_t *mp_zkHandle; + }; + +} /* end of 'namespace zktreeutil' */ + +#endif /* __ZK_ADAPTER_H__ */ diff --git a/src/contrib/zktreeutil/src/ZkTreeUtil.cc b/src/contrib/zktreeutil/src/ZkTreeUtil.cc new file mode 100644 index 0000000..270bf31 --- /dev/null +++ b/src/contrib/zktreeutil/src/ZkTreeUtil.cc @@ -0,0 +1,705 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#include "ZkTreeUtil.h" + +#include +#include +#include +#include +#include + +namespace zktreeutil +{ + using std::map; + using std::pair; + + static ZkTreeNodeSptr loadZkTree_ (ZooKeeperAdapterSptr zkHandle, + const string& path) + { + // Extract the node value + string value = zkHandle->getNodeData(path); + + // Extract nodename from the path + string nodename = "/"; + if (path != "/") + { + vector< string > nodes; + boost::split(nodes, path, boost::is_any_of ("/") ); + nodename = nodes[nodes.size()-1]; + } + + // Create tree-node with name and value + ZkTreeNodeSptr nodeSptr = ZkTreeNodeSptr (new ZkTreeNode (nodename, value)); + std::cerr << "[zktreeutil] loaded nodename: " + << nodename + << " value: " + << value + << std::endl; + + // Load all the children + vector< string > cnodes = zkHandle->getNodeChildren (path); + for (unsigned i = 0; i < cnodes.size(); i++) + nodeSptr->addChild (loadZkTree_ (zkHandle, cnodes[i])); + + // Return the constructed node + return nodeSptr; + } + + static ZkTreeNodeSptr loadZkTreeXml_ (xmlNode* xmlNodePtr) + { + // Null check + if (xmlNodePtr == NULL) + { + std::cerr << "[zktreeutil] empty XML node encountered" << std::endl; + exit (-1); + } + + // Get the node name + xmlChar* name = xmlGetProp (xmlNodePtr, BAD_CAST "name"); + string nameStr = (const char*)name; + std::cerr << "[zktreeutil] node name: " << nameStr; + xmlFree (name); + // Get the node value + string valueStr; + xmlChar* value = xmlGetProp (xmlNodePtr, BAD_CAST "value"); + if (value) + { + valueStr = (const char*)value; + std::cerr << " value: " << valueStr; + } + xmlFree (value); + // Get the ignore flag + bool doIgnore = false; + xmlChar* ignore = xmlGetProp (xmlNodePtr, BAD_CAST "ignore"); + if (ignore) + { + string ignoreStr = (const char*) ignore; + if (ignoreStr == "true" || ignoreStr == "yes" || ignoreStr == "1") + { + doIgnore = true; + std::cerr << " "; + } + } + xmlFree (ignore); + std::cerr << std::endl; + + // Create the zk node + ZkTreeNodeSptr nodeSptr = + ZkTreeNodeSptr (new ZkTreeNode (nameStr, + ZkNodeData (valueStr, doIgnore))); + + // Load the children + for (xmlNode* chldNode = xmlNodePtr->children; + chldNode; + chldNode = chldNode->next) + if (chldNode->type == XML_ELEMENT_NODE) + nodeSptr->addChild (loadZkTreeXml_ (chldNode)); + + // Return the loaded node + return nodeSptr; + } + + static void writeZkTree_ (ZooKeeperAdapterSptr zkHandle, + const ZkTreeNodeSptr zkNodeSptr, + const string& path) + { + // Create the path in zk-tree + zkHandle->createNode(path.c_str(), "", 0, false); + std::cerr << "[zktreeutil] created key: " << path << std::endl; + // Set value for the path + string value = zkNodeSptr->getData().value; + if (value != "") + { + zkHandle->setNodeData (path.c_str(), value.c_str()); + std::cerr << "[zktreeutil] set value: " << std::endl; + } + + // Go deep to write the subtree rooted in the node, if not to be ignored + if (!(zkNodeSptr->getData().ignoreUpdate)) + { + for (unsigned i=0; i < zkNodeSptr->numChildren(); i++) + { + ZkTreeNodeSptr childNodeSptr = zkNodeSptr->getChild (i); + // Add the node name into the path and write in zk-tree + string cpath = ((path != "/")? path : "") + + string("/") + + childNodeSptr->getKey(); + writeZkTree_ (zkHandle, childNodeSptr, cpath); + } + } + + return; + } + + static void addTreeZkAction_ (const ZkTreeNodeSptr zkNodeSptr, + const string& path, + vector< ZkAction >& actions) + { + // Create the key + actions.push_back (ZkAction (ZkAction::CREATE, path)); + + // Set value for the new key + if (zkNodeSptr->getData().value != "") + actions.push_back (ZkAction (ZkAction::VALUE, + path, + zkNodeSptr->getData().value)); + + // Add all the children + for (unsigned i=0; i < zkNodeSptr->numChildren(); i++) + { + ZkTreeNodeSptr childSptr = zkNodeSptr->getChild (i); + string cpath = path + string("/") + childSptr->getKey(); + addTreeZkAction_ (childSptr, cpath, actions); + } + + return; + } + + static xmlNodePtr dumpZkTreeXml_ (const ZkTreeNodeSptr zkNodeSptr) + { + // Create xml node with zknode name and value + string nodename = zkNodeSptr->getKey (); + string value = zkNodeSptr->getData().value; + xmlNodePtr node = xmlNewNode(NULL, BAD_CAST "zknode"); + xmlNewProp (node, BAD_CAST "name", BAD_CAST nodename.c_str()); + if (value.length()) + xmlNewProp (node, BAD_CAST "value", BAD_CAST value.c_str()); + + // Add all the children rotted at this node + for (unsigned i=0; i < zkNodeSptr->numChildren(); i++) + xmlAddChild (node, dumpZkTreeXml_ (zkNodeSptr->getChild (i))); + + // Return xml node + return node; + } + + static void dumpZkTree_ (const ZkTreeNodeSptr zkNodeSptr, + int maxLevel, + int level, + vector< bool >& masks) + { + // Check the max. dlevel to be dumped + if (level > maxLevel) + return; + + + // Create branch + for (int i=0; i < level; i++) + { + if ( i== level-1) std::cout << "| "; + else if (masks[i]) std::cout << " "; + else std::cout << "| "; + } + std::cout << std::endl; + for (int i=0; i < level-1; i++) + { + if (masks[i]) std::cout << " "; + else std::cout << "| "; + } + + // Dump the node name and value + std::cout << "|--[" << zkNodeSptr->getKey(); + if (zkNodeSptr->getData().value != "") + std::cout << " => " << zkNodeSptr->getData().value; + std::cout << "]" << std::endl; + + // Dump all the children + for (unsigned i=0; i < zkNodeSptr->numChildren(); i++) + { + // Add mask for last child + if (i == zkNodeSptr->numChildren()-1) + masks.push_back(true); + else + masks.push_back(false); + dumpZkTree_ (zkNodeSptr->getChild (i), maxLevel, level+1, masks); + } + + masks.pop_back(); + return; + } + + static ZkTreeNodeSptr traverseBranch_ (const ZkTreeNodeSptr& zkRootSptr, + const string& path) + { + // Check if the tree is loaded into memory + if (zkRootSptr == NULL) + { + string errMsg = "[zktreeutil] null root passed for traversing"; + std::cout << errMsg << std::endl; + throw std::logic_error (errMsg); + } + + // Split the path and add intermediate znodes + vector< string > nodes; + boost::split(nodes, path, boost::is_any_of ("/") ); + + // Start traversing the tree + ZkTreeNodeSptr currNodeSptr = zkRootSptr; + for (unsigned znode_idx = 1; znode_idx < nodes.size(); znode_idx++) + { + bool found = false; + for (unsigned i=0; i < currNodeSptr->numChildren(); i++) + { + ZkTreeNodeSptr childNodeSptr = currNodeSptr->getChild(i); + if (childNodeSptr->getKey() == nodes[znode_idx]) + { + // Found! go to the znode + currNodeSptr = childNodeSptr; + found = true; + break; + } + } + if (!found) // No such znode found; return NULL node-ptr + { + string errMsg = string("[zktreeutil] unknown znode during traversal: ") + + nodes[znode_idx]; + std::cout << errMsg << std::endl; + throw std::logic_error (errMsg); + } + } + + return currNodeSptr; + } + + static ZkTreeNodeSptr createAncestors_ (const string& path) + { + // Create the root znode + ZkTreeNodeSptr zkRootSptr = ZkTreeNodeSptr (new ZkTreeNode ("/")); + ZkTreeNodeSptr currNodeSptr = zkRootSptr; + // Split the path and add intermediate znodes + vector< string > nodes; + boost::split(nodes, path, boost::is_any_of ("/") ); + for (unsigned i=1; i < nodes.size()-1; i++) + { + ZkTreeNodeSptr childNodeSptr = ZkTreeNodeSptr (new ZkTreeNode (nodes[i])); + currNodeSptr->addChild (childNodeSptr); + currNodeSptr = childNodeSptr; + } + + //Return the root of the branch + return zkRootSptr; + } + + ZooKeeperAdapterSptr ZkTreeUtil::get_zkHandle (const string& zkHosts) + { + try + { + // Create an instance of ZK adapter. + ZooKeeperConfig config (zkHosts, 10000); + ZooKeeperAdapterSptr zkHandleSptr = + ZooKeeperAdapterSptr (new ZooKeeperAdapter (config)); + return zkHandleSptr; + } + catch (const ZooKeeperException &e) + { + std::cerr << "[zktreeutil] zooKeeper exception caught: " + << e.what() + << std::endl; + throw; + } + catch (std::exception &stde) + { + std::cerr << "[zktreeutil] standard exception caught: " + << stde.what() + << std::endl; + throw; + } + catch (...) + { + std::cerr + << "[zktreeutil] unknown exception while connecting to zookeeper" + << std::endl; + throw; + } + } + + + void ZkTreeUtil::loadZkTree (const string& zkHosts, + const string& path, + bool force) + { + // Check if already loaded + if (loaded_ && !force) + { + std::cerr << "[zktreeutil] zk-tree already loaded into memory" + << std::endl; + return; + } + + // Connect to ZK server + ZooKeeperAdapterSptr zkHandle = get_zkHandle (zkHosts); + std::cerr << "[zktreeutil] connected to ZK serverfor reading" + << std::endl; + + // Check the existence of the path to znode + if (!zkHandle->nodeExists (path)) + { + string errMsg = string("[zktreeutil] path does not exists : ") + path; + std::cout << errMsg << std::endl; + throw std::logic_error (errMsg); + } + + // Load the rooted (sub)tree + ZkTreeNodeSptr zkSubrootSptr = loadZkTree_ (zkHandle, path); + + // Create the ancestors before loading the rooted subtree + if (path != "/") + { + zkRootSptr_ = createAncestors_(path); + string ppath = path.substr (0, path.rfind('/')); + ZkTreeNodeSptr parentSptr = traverseBranch_( zkRootSptr_, ppath); + parentSptr->addChild (zkSubrootSptr); + } + else // Loaded entire zk-tree + { + zkRootSptr_ = zkSubrootSptr; + } + + // Set load flag + loaded_ = true; + return; + } + + void ZkTreeUtil::loadZkTreeXml (const string& zkXmlConfig, + bool force) + { + // Check if already loaded + if (loaded_ && !force) + { + std::cerr << "[zktreeutil] zk-tree already loaded into memory" + << std::endl; + return; + } + + // Parse the file and get the DOM + xmlDocPtr docPtr = xmlReadFile(zkXmlConfig.c_str(), NULL, 0); + if (docPtr == NULL) { + std::cerr << "[zktreeutil] could not parse XML file " + << zkXmlConfig + << std::endl; + exit (-1); + } + std::cerr << "[zktreeutil] zk-tree XML parsing successful" + << std::endl; + + // Get the root element node + xmlNodePtr rootPtr = xmlDocGetRootElement(docPtr); + // Create the root zk node + zkRootSptr_ = ZkTreeNodeSptr (new ZkTreeNode ("/")); + // Load the rooted XML tree + for (xmlNode* chldNode = rootPtr->children; + chldNode; + chldNode = chldNode->next) + { + if (chldNode->type == XML_ELEMENT_NODE) + zkRootSptr_->addChild (loadZkTreeXml_ (chldNode)); + } + + // set oad flag + loaded_ = true; + // Cleanup stuff + xmlFreeDoc(docPtr); + xmlCleanupParser(); + return; + } + + void ZkTreeUtil::writeZkTree (const string& zkHosts, + const string& path, + bool force) const + { + // Connect to ZK server + ZooKeeperAdapterSptr zkHandle = get_zkHandle (zkHosts); + std::cerr << "[zktreeutil] connected to ZK server for writing" + << std::endl; + + // Go to the rooted subtree + ZkTreeNodeSptr zkRootSptr = traverseBranch_ (zkRootSptr_, path); + + // Cleanup before write if forceful write enabled + if (force) + { + if (path != "/") // remove the subtree rooted at the znode + { + // Delete the subtree rooted at the znode before write + if (zkHandle->nodeExists (path)) + { + std::cerr << "[zktreeutil] deleting subtree rooted at " + << path + << "..." + << std::endl; + zkHandle->deleteNode (path, true); + } + } + else // remove the rooted znodes + { + std::cerr << "[zktreeutil] deleting rooted zk-tree" + << "..." + << std::endl; + // Get the root's children + vector< string > cnodes = zkHandle->getNodeChildren ("/"); + for (unsigned i=0; i < cnodes.size(); i++) + { + if ( cnodes[i] != "/zookeeper") // reserved for zookeeper use + zkHandle->deleteNode(cnodes[i], true); + } + } + } + + // Start tree construction + writeZkTree_ (zkHandle, zkRootSptr, path); + return; + } + + void ZkTreeUtil::dumpZkTree (bool xml, int depth) const + { + if (xml) + { + // Creates a new document, a node and set it as a root node + xmlDocPtr docPtr = xmlNewDoc(BAD_CAST "1.0"); + xmlNodePtr rootNode = xmlNewNode(NULL, BAD_CAST "root"); + xmlDocSetRootElement(docPtr, rootNode); + + // Add all the rooted children + for (unsigned i=0; i < zkRootSptr_->numChildren(); i++) + xmlAddChild (rootNode, dumpZkTreeXml_ (zkRootSptr_->getChild (i))); + + // Dumping document to stdio or file + xmlSaveFormatFileEnc("-", docPtr, "UTF-8", 1); + + // Cleanup stuff + xmlFreeDoc(docPtr); + xmlCleanupParser(); + return; + } + + // Dump text + std::cout << "/" << std::endl; + vector< bool > masks; + for (unsigned i=0; i < zkRootSptr_->numChildren(); i++) + { + if (i == zkRootSptr_->numChildren()-1) + masks.push_back(true); + else + masks.push_back(false); + dumpZkTree_ (zkRootSptr_->getChild (i), depth, 1, masks); + } + + return; + } + + vector< ZkAction > ZkTreeUtil::diffZkTree (const string& zkHosts, + const string& path) const + { + // Action container + vector< ZkAction > actions; + + if (!loaded_) + { + std::cout << "[zktreeutil] zk-tree not loaded for diff" + << std::endl; + exit (-1); + } + + // Load the rooted subtree from zookeeper + ZooKeeperAdapterSptr zkHandle = get_zkHandle (zkHosts); + std::cerr << "[zktreeutil] connected to ZK server for reading" + << std::endl; + ZkTreeNodeSptr zkLiveRootSptr = loadZkTree_ (zkHandle, path); + + // Go to the saved rooted subtree + ZkTreeNodeSptr zkLoadedRootSptr = + traverseBranch_ (zkRootSptr_, path); + + // Check the root value first + if (zkLoadedRootSptr->getData().value + != zkLiveRootSptr->getData().value) + { + actions.push_back (ZkAction (ZkAction::VALUE, + path, + zkLoadedRootSptr->getData().value, + zkLiveRootSptr->getData().value)); + } + + // Start traversal from root + vector< string > ppaths; + vector< pair< ZkTreeNodeSptr, ZkTreeNodeSptr > > commonNodes; + ppaths.push_back ((path != "/")? path : ""); + commonNodes.push_back (pair< ZkTreeNodeSptr, ZkTreeNodeSptr > + (zkLoadedRootSptr, zkLiveRootSptr)); + + for (unsigned j=0; j < commonNodes.size(); j++) + { + // Get children of loaded tree + map< string, ZkTreeNodeSptr > loadedChildren; + for (unsigned i=0; i < commonNodes[j].first->numChildren(); i++) + { + ZkTreeNodeSptr childSptr = commonNodes[j].first->getChild (i); + loadedChildren[childSptr->getKey()] = childSptr; + } + // Get children of live tree + map< string, ZkTreeNodeSptr > liveChildren; + for (unsigned i=0; i < commonNodes[j].second->numChildren(); i++) + { + ZkTreeNodeSptr childSptr = commonNodes[j].second->getChild (i); + liveChildren[childSptr->getKey()] = childSptr; + } + + // Start comparing the children + for (map< string, ZkTreeNodeSptr >::const_iterator it = + loadedChildren.begin(); + it != loadedChildren.end(); + it++) + { + bool ignoreKey = it->second->getData().ignoreUpdate; + string loadedVal = it->second->getData().value; + // Path to this node + string path = ppaths[j] + string("/") + it->first; + + map< string, ZkTreeNodeSptr >::const_iterator jt = + liveChildren.find (it->first); + if (jt != liveChildren.end()) + { + // Key is present in live zk-tree + string liveVal = jt->second->getData().value; + // Check value for the key, if not ignored + if (!ignoreKey) + { + if (loadedVal != liveVal) + { + // Value differs, set the new value for the key + actions.push_back (ZkAction (ZkAction::VALUE, + path, + loadedVal, + liveVal)); + } + + // Add node to common nodes + ppaths.push_back (path); + commonNodes.push_back (pair< ZkTreeNodeSptr, ZkTreeNodeSptr > + (it->second, jt->second)); + } + + // Remove the live zk node + liveChildren.erase (it->first); + } + else + { + // Add the subtree rooted to this node, if not ignored + if (!ignoreKey) + addTreeZkAction_ (it->second, path, actions); + } + } + + // Remaining live zk nodes to be deleted + for (map< string, ZkTreeNodeSptr >::const_iterator it = liveChildren.begin(); + it != liveChildren.end(); it++) + { + string path = ppaths[j] + string("/") + it->first; + actions.push_back (ZkAction (ZkAction::DELETE, path)); + } + } + // return the diff actions + return actions; + } + + void ZkTreeUtil::executeZkActions (const string& zkHosts, + const vector< ZkAction >& zkActions, + int execFlags) const + { + // Execute the diff zk actions + if (zkActions.size()) + { + // Connect to Zookeeper for writing + ZooKeeperAdapterSptr zkHandleSptr; + if ((execFlags & EXECUTE) + || (execFlags & INTERACTIVE)) + { + zkHandleSptr = get_zkHandle (zkHosts); + std::cerr << "[zktreeutil] connected to ZK server for writing" + << std::endl; + } + + for (unsigned i=0; i < zkActions.size(); i++) + { + if (zkActions[i].action == ZkAction::CREATE) + { + if (execFlags & PRINT) + std::cout << "CREAT- key:" << zkActions[i].key << std::endl; + if (execFlags & EXECUTE) + { + if (execFlags & INTERACTIVE) + { + string resp; + std::cout << "Execute this action?[yes/no]: "; + std::getline(std::cin, resp); + if (resp != "yes") + continue; + } + zkHandleSptr->createNode(zkActions[i].key.c_str(), "", 0, false); + } + } + else if (zkActions[i].action == ZkAction::DELETE) + { + if (execFlags & PRINT) + std::cout << "DELET- key:" << zkActions[i].key << std::endl; + if (execFlags & EXECUTE) + { + if (execFlags & INTERACTIVE) + { + string resp; + std::cout << "Execute this action?[yes/no]: "; + std::getline(std::cin, resp); + if (resp != "yes") + continue; + } + zkHandleSptr->deleteNode(zkActions[i].key.c_str(), true); + } + } + else if (zkActions[i].action == ZkAction::VALUE) + { + if (execFlags & PRINT) + { + std::cout << "VALUE- key:" + << zkActions[i].key + << " value:" << zkActions[i].newval; + if (zkActions[i].oldval != "") + std::cout << " old_value:" << zkActions[i].oldval; + std::cout << std::endl; + } + if (execFlags & EXECUTE) + { + if (execFlags & INTERACTIVE) + { + string resp; + std::cout << "Execute this action?[yes/no]: "; + std::getline(std::cin, resp); + if (resp != "yes") + continue; + } + zkHandleSptr->setNodeData (zkActions[i].key, zkActions[i].newval); + } + } + } + } + + return; + } + +} + diff --git a/src/contrib/zktreeutil/src/ZkTreeUtil.h b/src/contrib/zktreeutil/src/ZkTreeUtil.h new file mode 100644 index 0000000..0a9be03 --- /dev/null +++ b/src/contrib/zktreeutil/src/ZkTreeUtil.h @@ -0,0 +1,262 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifndef __ZK_TREE_UTIL_H__ +#define __ZK_TREE_UTIL_H__ + +#include +#include +#include "SimpleTree.h" +#include "ZkAdaptor.h" + +namespace zktreeutil +{ + +#define ZKTREEUTIL_INF 1000000000 + /** + * \brief A structure containing ZK node data. + */ + struct ZkNodeData + { + /** + * \brief The value string of the ZK node. + */ + string value; + + /** + * \brief The flag indicating whether children of the + * \brief node shduld be ignored during create/diff/update + */ + bool ignoreUpdate; + + /** + * \brief Constructor. + * + * @param val the value string + * @param ignore the flag indicating ignore any update/diff + */ + ZkNodeData (const string& val, bool ignore=false) + : value (val), ignoreUpdate (ignore) {} + + /** + * \brief Constructor. + * + * @param ignore the flag indicating ignore any update/diff + */ + ZkNodeData (bool ignore=false) + : ignoreUpdate (ignore) {} + }; + + /** + * \brief The type representing a ZK Treenode + */ + typedef SimpleTreeNode< string, ZkNodeData > ZkTreeNode; + + /** + * \brief The type representing a ZK Treenode smart-pointer + */ + typedef boost::shared_ptr< ZkTreeNode > ZkTreeNodeSptr; + + /** + * \brief The type representing a ZK Adapter smart-pointer + */ + typedef boost::shared_ptr< ZooKeeperAdapter > ZooKeeperAdapterSptr; + + /** + * \brief A structure defining a particular action on ZK node; + * \brief the action can be any of - + * \brief CREAT- : creates recussively + * \brief DELET- : deletes recursively + * \brief VALUE- : sets to + */ + struct ZkAction + { + /** + * \brief The action type; any of create/delete/setvalue. + */ + enum ZkActionType + { + NONE, + CREATE, + DELETE, + VALUE, + }; + + /** + * \brief action of this instance + */ + ZkActionType action; + + /** + * \brief ZK node key + */ + string key; + + /** + * \brief value to be set, if action is setvalue + */ + string newval; + + /** + * \brief existing value of the ZK node key + */ + string oldval; + + /** + * \brief Constructor. + */ + ZkAction () + : action (ZkAction::NONE) {} + + /** + * \brief Constructor. + * + * @param act the action to be taken + * @param k the key on which action to be taken + */ + ZkAction (ZkActionType act, const string& k) + : action(act), + key(k) {} + + /** + * \brief Constructor. + * + * @param act the action to be taken + * @param k the key on which action to be taken + * @param v the value of the ZK node key + */ + ZkAction (ZkActionType act, const string& k, const string& v) + : action(act), + key(k), + newval(v) {} + + /** + * \brief Constructor. + * + * @param act the action to be taken + * @param k the key on which action to be taken + * @param nv the new value of the ZK node key + * @param ov the old value of the ZK node key + */ + ZkAction (ZkActionType act, const string& k, const string& nv, const string& ov) + : action (act), + key(k), + newval(nv), + oldval(ov) {} + }; + + /** + * \brief The ZK tree utility class; supports loading ZK tree from ZK server OR + * \brief from saved XML file, saving ZK tree into XML file, dumping the ZK tree + * \brief on standard output, creting a diff between saved ZK tree and live ZK + * \brief tree and incremental update of the live ZK tree. + */ + class ZkTreeUtil + { + public: + /** + * \brief Execution flag on ZkAction + */ + enum ZkActionExecuteFlag + { + NONE = 0, + PRINT = 1, + EXECUTE = 2, + INTERACTIVE = 5, + }; + + public: + /** + * \brief Connects to zookeeper and returns a valid ZK handle + * + * @param zkHosts comma separated list of host:port forming ZK quorum + * @param a valid ZK handle + */ + static ZooKeeperAdapterSptr get_zkHandle (const string& zkHosts); + + + public: + /** + * \brief Constructor. + */ + ZkTreeUtil () : loaded_(false) {} + + /** + * \brief loads the ZK tree from ZK server into memory + * + * @param zkHosts comma separated list of host:port forming ZK quorum + * @param path path to the subtree to be loaded into memory + * @param force forces reloading in case tree already loaded into memory + */ + void loadZkTree (const string& zkHosts, const string& path="/", bool force=false); + + /** + * \brief loads the ZK tree from XML file into memory + * + * @param zkXmlConfig ZK tree XML file + * @param force forces reloading in case tree already loaded into memory + */ + void loadZkTreeXml (const string& zkXmlConfig, bool force=false); + + /** + * \brief writes the in-memory ZK tree on to ZK server + * + * @param zkHosts comma separated list of host:port forming ZK quorum + * @param path path to the subtree to be written to ZK tree + * @param force forces cleanup of the ZK tree on the ZK server before writing + */ + void writeZkTree (const string& zkHosts, const string& path="/", bool force=false) const; + + /** + * \brief dupms the in-memory ZK tree on the standard output device; + * + * @param xml flag indicates whether tree should be dumped in XML format + * @param depth the depth of the tree to be dumped for non-xml dump + */ + void dumpZkTree (bool xml=false, int depth=ZKTREEUTIL_INF) const; + + /** + * \brief returns a list of actions after taking a diff of in-memory + * \brief ZK tree and live ZK tree. + * + * @param zkHosts comma separated list of host:port forming ZK quorum + * @param path path to the subtree in consideration while taking diff with ZK tree + * @return a list of ZKAction instances to be performed on live ZK tree + */ + vector< ZkAction > diffZkTree (const string& zkHosts, const string& path="/") const; + + /** + * \brief performs create/delete/setvalue by executing a set of + * ZkActions on a live ZK tree. + * + * @param zkHosts comma separated list of host:port forming ZK quorum + * @param zkActions set of ZkActions + * @param execFlags flags indicating print/execute/interactive etc + */ + void executeZkActions (const string& zkHosts, + const vector< ZkAction >& zkActions, + int execFlags) const; + + private: + + ZkTreeNodeSptr zkRootSptr_; // ZK tree root node + bool loaded_; // Falg indicating whether ZK tree loaded into memory + }; +} + +#endif // __ZK_TREE_UTIL_H__ diff --git a/src/contrib/zktreeutil/src/ZkTreeUtilMain.cc b/src/contrib/zktreeutil/src/ZkTreeUtilMain.cc new file mode 100644 index 0000000..8afebf6 --- /dev/null +++ b/src/contrib/zktreeutil/src/ZkTreeUtilMain.cc @@ -0,0 +1,247 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifdef HAVE_CONFIG_H +#include +#endif + +#include +#ifndef _GNU_SOURCE +#define _GNU_SOURCE +#endif +#include +#include +#include "ZkTreeUtil.h" + +using namespace zktreeutil; + +// The set of "long" options accepted by this program. +static struct option long_options[] = { + {"help", no_argument, 0, 'h'}, + {"import", no_argument, 0, 'I'}, + {"export", no_argument, 0, 'E'}, + {"update", no_argument, 0, 'U'}, + {"diff", no_argument, 0, 'F'}, + {"dump", no_argument, 0, 'D'}, + {"force", no_argument, 0, 'f'}, + {"xmlfile", required_argument, 0, 'x'}, + {"path", required_argument, 0, 'p'}, + {"depth", required_argument, 0, 'd'}, + {"zookeeper", required_argument, 0, 'z'}, + {0, 0, 0, 0} +}; +static char *short_options = "IEUFDfx:p:d:hz:"; + +static void usage(int argc, char *argv[]) +{ + std::cout << "ZK-tree utility for managing ZK-tree with XML import/export," << std::endl; + std::cout << "viewing diff between live and saved ZK-tree and performing" << std::endl; + std::cout << "incremental update of the same." << std::endl; + std::cout << "Usage: " << argv[0] << " [args-and-values]+" << std::endl; + std::cout + << "\t--import or -I: " + << std::endl + << "\t Imports the zookeeper tree from XML file. Must be specified with" + << std::endl + << "\t --zookeeper AND --xmlfile options. Optionally takes --path for" + << std::endl + << "\t importing subtree" + << std::endl; + std::cout + << "\t--export or -E: " + << std::endl + << "\t Exports the zookeeper tree to XML file. Must be specified with" + << std::endl + << "\t --zookeeper option. Optionally takes --path for exporting subtree" + << std::endl; + std::cout + << "\t--update or -U: " + << std::endl + << "\t Updates zookeeper tree with changes from XML file. Update operation" + << std::endl + << "\t is interactive unless specified with --force option. Must be speci-" + << std::endl + << "\t fied with --zookeeper AND --xmlfile options. Optionally takes --path" + << std::endl + << "\t for updating subtree." + << std::endl; + std::cout + << "\t--diff or -F: " + << std::endl + << "\t Creates a list of diff actions on ZK tree based on XML data. Must" + << std::endl + << "\t be specified with --zookeeper OR --xmlfile options. Optionally takes" + << std::endl + << "\t --path for subtree diff" + << std::endl; + std::cout + << "\t--dump or -D: " + << std::endl + << "\t Dumps the entire ZK (sub)tree to standard output. Must be specified" + << std::endl + << "\t with --zookeeper OR --xmlfile options. Optionally takes --path and" + << std::endl + << "\t --depth for dumping subtree." + << std::endl; + std::cout + << "\t--xmlfile= or -x : " + << std::endl + << "\t Zookeeper tree-data XML file." + << std::endl; + std::cout + << "\t--path= or -p : " + << std::endl + << "\t Path to the zookeeper subtree rootnode." + << std::endl; + std::cout + << "\t--depth= or -d : " + << std::endl + << "\t Depth of the ZK tree to be dumped (ignored for XML dump)." + << std::endl; + std::cout + << "\t--force or -f: Forces cleanup before import; also used for forceful" + << std::endl + << "\t update. Optionally be specified with --import and --update." + << std::endl; + std::cout + << "\t--help or -h: " + << std::endl + << "\t prints this message" + << std::endl; + std::cout + << "\t--zookeeper= or -z : " + << std::endl + << "\t specifies information to connect to zookeeper." + << std::endl; +} + +int main(int argc, char **argv) +{ + if (argc == 1) { + usage(argc, argv); + exit(0); + } + + // Parse the arguments. + int op = 0; + bool force = false; + string zkHosts; + string xmlFile; + string path = "/"; + int depth = 0; + while (1) + { + int c = getopt_long(argc, argv, short_options, long_options, 0); + if (c == -1) + break; + + switch (c) { + case 'I': op = c; + break; + case 'E': op = c; + break; + case 'U': op = c; + break; + case 'F': op = c; + break; + case 'D': op = c; + break; + case 'f': force = true; + break; + case 'x': xmlFile = optarg; + break; + case 'p': path = optarg; + break; + case 'd': depth = atoi (optarg); + break; + case 'z': zkHosts = optarg; + break; + case 'h': usage (argc, argv); + exit(0); + } + } + + ZkTreeUtil zkTreeUtil; + switch (op) + { + case 'I': { + if (zkHosts == "" || xmlFile == "") + { + std::cout << "[zktreeutil] missing params; please see usage" << std::endl; + exit (-1); + } + zkTreeUtil.loadZkTreeXml (xmlFile); + zkTreeUtil.writeZkTree (zkHosts, path, force); + std::cout << "[zktreeutil] import successful!" << std::endl; + break; + } + case 'E': { + if (zkHosts == "") + { + std::cout << "[zktreeutil] missing params; please see usage" << std::endl; + exit (-1); + } + zkTreeUtil.loadZkTree (zkHosts, path); + zkTreeUtil.dumpZkTree (true); + break; + } + case 'U': { + if (zkHosts == "" || xmlFile == "") + { + std::cout << "[zktreeutil] missing params; please see usage" << std::endl; + exit (-1); + } + zkTreeUtil.loadZkTreeXml (xmlFile); + vector< ZkAction > zkActions = zkTreeUtil.diffZkTree (zkHosts, path); + int flags = ZkTreeUtil::EXECUTE; + if (!force) flags |= ZkTreeUtil::INTERACTIVE; + zkTreeUtil.executeZkActions (zkHosts, zkActions, flags); + std::cout << "[zktreeutil] update successful!" << std::endl; + break; + } + case 'F': { + if (zkHosts == "" || xmlFile == "") + { + std::cout << "[zktreeutil] missing params; please see usage" << std::endl; + exit (-1); + } + zkTreeUtil.loadZkTreeXml (xmlFile); + vector< ZkAction > zkActions = zkTreeUtil.diffZkTree (zkHosts, path); + zkTreeUtil.executeZkActions (zkHosts, zkActions, ZkTreeUtil::PRINT); + break; + } + case 'D': { + if (zkHosts != "") + zkTreeUtil.loadZkTree (zkHosts, path); + else if (xmlFile != "") + zkTreeUtil.loadZkTreeXml (xmlFile); + else + { + std::cout << "[zktreeutil] missing params; please see usage" << std::endl; + exit (-1); + } + // Dump the ZK tree + if (depth) zkTreeUtil.dumpZkTree (false, depth); + else zkTreeUtil.dumpZkTree (false); + break; + } + } + + exit(0); +} + diff --git a/src/contrib/zktreeutil/tests/zk_sample.xml b/src/contrib/zktreeutil/tests/zk_sample.xml new file mode 100644 index 0000000..6e97daa --- /dev/null +++ b/src/contrib/zktreeutil/tests/zk_sample.xml @@ -0,0 +1,44 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/contrib/zooinspector/NOTICE.txt b/src/contrib/zooinspector/NOTICE.txt new file mode 100644 index 0000000..e0bf2f0 --- /dev/null +++ b/src/contrib/zooinspector/NOTICE.txt @@ -0,0 +1,3 @@ +This contrib module includes icons available under the Eclipse Public Licence Version 1.0 +. from the Eclipse Java Devlopment Platform. +The lib sub-directory includes a binary only jar library developed at http://sourceforge.net/projects/jtoaster/ \ No newline at end of file diff --git a/src/contrib/zooinspector/README.txt b/src/contrib/zooinspector/README.txt new file mode 100644 index 0000000..3c2a58f --- /dev/null +++ b/src/contrib/zooinspector/README.txt @@ -0,0 +1,94 @@ +========================================== +ZooInspector - Browser and Editor for ZooKeeper Instances +Author: Colin Goodheart-Smithe +Date: February 2010 +========================================== + +ZooInspector is a Java Swing based application for browsing and editing ZooKeeper instances. + +Contents +-------- + - Features + - Pre-requisites + - Build Instructions + - Using ZooInspector + - Creating and Using Plugins + +Features +-------- + Below is a list of features in the current release of ZooInspector. + - Load connection settings from a zookeeper properties file + - Plugable DataEncryptionManagers to specify how data should be encrypted and decrypted in the Zookeeper instance + - Browseable tree view of the ZooKeeper instance + - View the data in a node + - View the ACL's currently applied to a node + - View the metadata for a node (Version, Number of Children, Last modified Tiem, etc.) + - Plugable NodeViewers interface + - Ability to save/load and set default Node Viewers + +Pre-requisites +-------------- + - The main zookeeper build script must have been run before building this module + +Build Instructions +------------------ + 1. Open a command line. + 2. cd into this directory + 3. Run command: ant + 4. ZooInspector will be built to ../../../build/contrib/ZooInspector + 5. Copy zookeeper-3.x.x.jar into the lib sub-directory (if you are using zookeeper-3.3.0.jar it will have been + copied to this directory during the build + 6. By default the zookeeper.cmd and zookeeper.sh files expect zookeeper-3.3.0.jar. If you are using another version + you will need to change these files to point to the zookeeper-3.x.x.jar you copied to the lib directory + 7. To run ZooInspector run zooInspector.cmd (on Windows) or zooInspector.sh (on Linux). If you are using + zookeeper-3.3.0.jar and do not require any classpath changes you can run the zookeeper-dev-ZooInspector.jar + directly + +Using ZooInspector +------------------ + To start ZooInspector run zooInspector.cmd (on Windows) or zooInspector.sh (on Linux). If you are using + zookeeper-3.3.0.jar and do not require any classpath changes you can run the zookeeper-dev-ZooInspector.jar + directly. + + Click the play button on the toolbar to bring up the connection dialog. From here you can enter connection + information for your zookeeper instance. You can also load the connection properties from a file. This file can + have the format as a normal zookeeper properties file (i.e. hosts and timeout key-value pairs) and van optional have + an encryptionManager key-value pair to specify the DataEncryptionManager to use for this connection + (DataEncryptionManagers are explained in further detail in the 'Creating and Using Plugins' section below). You can + also set the entered information as the defaults so that when you first start ZooInspector these settings are + automatically loaded into this dialog. Pressing the OK button with connect to your ZooKeeper instance and show the + current node tree on the left of the main panel. + + Clicking a node in the node tree will load the data for that node into the node viewers. Three node viewers are + currently distributed with ZooInspector: + 1. Node Data - This enables you to see the data current stored on that node. This data can be modified and + saved. The data is decrypted and encrypted using the DataEncryptionManager specified on the connection + dialog. + 2. Node Metadata - This enables you to see the metadata associiated with this node. This is Essentially the data + obtained from the Stat object for this node. + 3. Node ACLs - This allows you to see the ACLs currently applied to this node. Currently there is no ability + to change the ACLs on a node, but it is a feature I would like to add. + Other custom Node Viewers can be added, this is explained in the 'Creating and Using Plugins' section below. + + +Creating and Using Plugins +-------------------------- + There are two types of plugin which can be used with ZooInspector: + 1. DataEncryptionManager - This specifies how data should be encrypted and decrypted when working with a + zookeeper instance. + 2. ZooInspectorNodeViewer - This is a GUI panel which provides a view of visualisation on a node. + More information on these interfaces can be found in the javadocs for this module. + + To use a plugin in ZooInspector, build the plugin to a jar and copy the jar to the lib sub-directory. Edit the + zooInspector.cmd and/or zooInspector.sh files to include your new jar on the classpath and run ZooInspector. + + For DataEncryptionManagers, click the play button to open the connection dialog and enter the full class name of + your DataEncryptionManager in the 'Data Encryption Manager' field. You can make this Data Encryption Manager the + default by clicking 'Set As Default'. Click the 'OK' button to instantiate and use your plugin. + + For ZooInspectorNodeViewers, Click the 'Change Node Viewers' button on the toolbar (looks like a tree with a pencil) + and enter the full classname for your Node Viewer in the field left of the 'Add' button, then click the 'Add' + button. The Node Viewer will be instantiated and should appear in the list. You can change the order of the Node + viewers by clicking the up and dpwn buttons and delete a Node Viewer by clicking the delete button. You can save + to configuration to a file or set it as the default if necessary. Then click the 'OK' button and your Node Viewer + should appear in the tabs on the right of the main panel. \ No newline at end of file diff --git a/src/contrib/zooinspector/build.xml b/src/contrib/zooinspector/build.xml new file mode 100644 index 0000000..a242790 --- /dev/null +++ b/src/contrib/zooinspector/build.xml @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Tests failed! + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/contrib/zooinspector/config/defaultConnectionSettings.cfg b/src/contrib/zooinspector/config/defaultConnectionSettings.cfg new file mode 100644 index 0000000..36a34ff --- /dev/null +++ b/src/contrib/zooinspector/config/defaultConnectionSettings.cfg @@ -0,0 +1,21 @@ +# Licensed to the Apache Software Foundation (ASF) under one or more +# contributor license agreements. See the NOTICE file distributed with +# this work for additional information regarding copyright ownership. +# The ASF licenses this file to You under the Apache License, Version 2.0 +# (the "License"); you may not use this file except in compliance with +# the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# +#Default connection for ZooInspector +hosts=localhost\:2181 +encryptionManager=org.apache.zookeeper.inspector.encryption.BasicDataEncryptionManager +timeout=5000 +authScheme= +authData= diff --git a/src/contrib/zooinspector/config/defaultNodeVeiwers.cfg b/src/contrib/zooinspector/config/defaultNodeVeiwers.cfg new file mode 100644 index 0000000..38fe9a8 --- /dev/null +++ b/src/contrib/zooinspector/config/defaultNodeVeiwers.cfg @@ -0,0 +1,17 @@ +# Licensed to the Apache Software Foundation (ASF) under one or more +# contributor license agreements. See the NOTICE file distributed with +# this work for additional information regarding copyright ownership. +# The ASF licenses this file to You under the Apache License, Version 2.0 +# (the "License"); you may not use this file except in compliance with +# the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +org.apache.zookeeper.inspector.gui.nodeviewer.NodeViewerData +org.apache.zookeeper.inspector.gui.nodeviewer.NodeViewerMetaData +org.apache.zookeeper.inspector.gui.nodeviewer.NodeViewerACL diff --git a/src/contrib/zooinspector/icons/edtsrclkup_co.gif b/src/contrib/zooinspector/icons/edtsrclkup_co.gif new file mode 100644 index 0000000000000000000000000000000000000000..94eedf6f92944ef56a7165d98ee6482ad24d00f3 GIT binary patch literal 204 zcmZ?wbhEHb6krfwIKsdXQ?+X1(&P7^zE^TizkPY(?k!y(Zmf8Dr0(0Z6O(Jgr_{$z zZA_S45!jz;(U)n_pJO+nzamx|{omhdZ+pPy1w_LK}lAnr-`SJ62+pK*(^ACOa@_X{KW3$$r zUbOlAiXE5N?74dH#gDtszu$lH{mGl3&)@xg`{~!`Z@=#VMPB~6_u~7*S3h2T`1$R} z?`Q9Re)#(P)3@JWfBgRb^LKTLe^s%6bxA;7sb4jaQ5?`-<Y72H(vk7Xs us!1$fvP8{QU92ZrK%7tARasP&f6JDw8m_8J3W|I7DyXXX9C3DJum%7=h^`F) literal 0 HcmV?d00001 diff --git a/src/contrib/zooinspector/icons/fldr_obj.gif b/src/contrib/zooinspector/icons/fldr_obj.gif new file mode 100644 index 0000000000000000000000000000000000000000..51e703b1b9c671baa2be0f6525edb3b69403370d GIT binary patch literal 216 zcmZ?wbhEHb6krfwIKsg2wj(b5!P~sjn^4pBFDXFJ7TPNb)}zFdzZN zpDc_F4AKlbATf}g46LCK)cR5~=VfGBty!EmMJ+qTijl!k<;;`cOWYDXbj&=28jDUI znIPA;;-J&oD09KqYe6rnb~B%5E3$|tF?k!UrOe@6&xDe6Z(8Y4cFg@2oFwXHJRx@P^{Hj-{g3x~&Wh)&R@kLgN4c literal 0 HcmV?d00001 diff --git a/src/contrib/zooinspector/icons/launch_run.gif b/src/contrib/zooinspector/icons/launch_run.gif new file mode 100644 index 0000000000000000000000000000000000000000..57f410224cf0e125fefdfbfd424b34ca32650ac4 GIT binary patch literal 379 zcmZ?wbhEHb6krfwxXQqw(BP;BL>-Qf6T{aP*iM?lCLeYNChZ zME|t4Kq*J#ax2FU508od{@|VOltj+J(UOww!N5}U3iQCI3ZqHwGu%qFO+M$;f|G|KP zbfEZ?g^__lk3k2d733!dwiyo73p{kh9NV1~0xTMO)-@+?HCpL1C+*_|jkQs$L%3SK zWZD#%Uw+AK^#3sVq2$yax7_cq>g;#(C^lABHOjI%u}OEy<@M@F%Q8AK@K5dOm7mJO z;KV30f4Z*Rd;#G}fjokO)8$r)3o+Lza0p5E$no(>iVJg;1ab?@$%#scNeOe;IkR(c Y3G?y_b8(z@@nG_1@(Z}@>d0UX09ibCp#T5? literal 0 HcmV?d00001 diff --git a/src/contrib/zooinspector/icons/launch_stop.gif b/src/contrib/zooinspector/icons/launch_stop.gif new file mode 100644 index 0000000000000000000000000000000000000000..fbf1686e4b47fd4e9fe639c6b6d7bb49ca09b706 GIT binary patch literal 916 zcma)5Ur1A76hFJWvg?r8zLu)g97e2UJ)cYo*m&hPxr`ObGw zHlGlVw3)yJ-2jSHPy|sC-HKbvwFeR=yJC0B4q@ICkR?%Wb+3=dWKoCD>tJZN&Y})vc0? zTOEK!!^&%5<_m>7ZC_W>bffI*0Q3M>?MO!kHZXwP0@Ip=?UVM1>UuGCF{Xf8sWA(3 z)Kjm6bOcEU|GOtg`5x>V>q(97$0M}V=%K74XBDyf1rJb_8f)3XjPuJ9KnQ?UaVC_s zI}OT#>bSLH<}0q*A08y4I)F~U@`hh_BjWqhz;@}spU0B0JaRKb20rPPmvrzs9h@Tm z1Ot1pchVsPFe=U=z6~%Txx#KZA-Ifg}E3bkV~vIf*ZhHQ@NZ<>v6tiSIG- zJpteVwvnz-wlM@ySr)le222^KbHuRX_{y85@o6sN&lpg|KRX{GE~iCqrTN3WZDOeH zD$FI%!P#(rsFZ_rp2k-}g#b=1?~2ho0qqqLoD>;I_~1$d9PEONHF*}VfWSVLrv4Ma zU5C9K?;ejP?{V90ebMO9v2L@mwpEFe)rKmPps{rBguKlfhzc=G1w^LIbre)@Ii`S<%Te>{Bk z12|TpyR{>mrI{2JXHL%C7O09Mu>554H9&1sF`=rV`q@7GGB8G zKfk`Pt2BF0FFPY+r;7~t)M?XXTxEIZ%$>s~>nhH=Wa(0IS4pnbYt~4*N^x%5yop81 WRg`1b?%krUA_op05^-{5um%7kHK6(c literal 0 HcmV?d00001 diff --git a/src/contrib/zooinspector/icons/refresh.gif b/src/contrib/zooinspector/icons/refresh.gif new file mode 100644 index 0000000000000000000000000000000000000000..3ca04d06ff9c811a6f791d029a802a7be4681ff4 GIT binary patch literal 327 zcmZ?wbhEHb6krfwxXQrrJWa!4-LeYm0=|77MK@5?WI%v@BcT|Ns9CR0WDZSr{1@R2g(Yrh@#$z?O1g zQh|q#RHw+PiyoXB)1AE)3U1~skT{fJ?U6BUYICAZn$5HYp3GD7dKS#fQdLEHHy z6I^aRo~tUt;P2kV6w~t;=?ud9vy7?cE^q z*1q%4_Md-x_|o&km!6%t_VVPl7w2!kK6mTY)%$O+-hXrZ@w-PaKBPA<&u(2-(6RIc zNcPq9H=oX5zOnP@<=ao*J$&)u*_+SB-Al@Q7r*)NC8Bg+ zz;2_n+r|KMbN2{G6a4_&{kGN)4gvc5juAGR#sRMOu1@w&t^vlzRuN`KMgigX?uQ4k zYgk5@s;SFPcrC52W*VWRCnlyRuKMMRsEVpigru?tONzsU2OVNcZfg!)N^s&3;9>A! zDQIQv=+@exGeO}YGc&uwQjf$B2b)>gB6wUn7Bn7go*uf&AmXGW<1{9LBBLK|is)RRH2yZMG-dG{LyHRvkqv*C;prFW}Cb1QH0&9u|R~HDbFBMu_B(%Cf zXj8fH`cmQLIReYF1^)m4&p+|z+lLr1JVKV69Zf3ff)rJI#S8AmOS&g!objY zXp*F{?P9eo9}@`oK{Iw9&}i^SBU4D}c3FLN?5SiQ`V!5RSYo{04T literal 0 HcmV?d00001 diff --git a/src/contrib/zooinspector/icons/search_prev.gif b/src/contrib/zooinspector/icons/search_prev.gif new file mode 100644 index 0000000000000000000000000000000000000000..07164754e5ca231666d9daf7fa4a9d12e378a52a GIT binary patch literal 323 zcmZ?wbhEHb6krfwxXQrr@9+D6zn=X4cJ<${r+>d*`SKk--`OT*-X9 literal 0 HcmV?d00001 diff --git a/src/contrib/zooinspector/icons/trash.gif b/src/contrib/zooinspector/icons/trash.gif new file mode 100644 index 0000000000000000000000000000000000000000..5f47780f0e61161f1fb21701d68f697fe80cbec9 GIT binary patch literal 132 zcmV-~0DJ#ONk%w1VGsZi0Kx|VhLob9uDr9s&%Mjp$JFB5==JpZ{{R30A^8LW000L7 zEC2ui01yBW0009?c&gC8kOf0c0P(oZ7pO)d76c&(n8vM*SB<2ZGNDimwh*AuSJ=4U mZlJf6sN=bQN1>AjWhS3M!*M literal 0 HcmV?d00001 diff --git a/src/contrib/zooinspector/ivy.xml b/src/contrib/zooinspector/ivy.xml new file mode 100644 index 0000000..bc02946 --- /dev/null +++ b/src/contrib/zooinspector/ivy.xml @@ -0,0 +1,48 @@ + + + + + + + + ZooInspector + + + + + + + + + + + + + + + + + + + + diff --git a/src/contrib/zooinspector/lib/jtoaster-1.0.4.jar b/src/contrib/zooinspector/lib/jtoaster-1.0.4.jar new file mode 100644 index 0000000000000000000000000000000000000000..aaf3f6ea06f4b66fbe1719f63dd8f68e6ed05193 GIT binary patch literal 14975 zcma)j1CS-#)@IqZZ5v&-ZQHhO+vswaZQHhOqpP~AOVj<{%-p^==700niHyh-=j6)0 zkSq88_P6AvfI(0IAbx#Tnn;)d{ty%Z5C9nwWdT|VSy6f!0a*!A5hZ0h8PSh%0DuRX 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 + + + + + +Eclipse Public License - Version 1.0 + + + + + + +

    Eclipse Public License - v 1.0

    + +

    THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS ECLIPSE +PUBLIC LICENSE ("AGREEMENT"). ANY USE, REPRODUCTION OR +DISTRIBUTION OF THE PROGRAM CONSTITUTES RECIPIENT'S ACCEPTANCE OF THIS +AGREEMENT.

    + +

    1. DEFINITIONS

    + +

    "Contribution" means:

    + +

    a) in the case of the initial Contributor, the initial +code and documentation distributed under this Agreement, and

    +

    b) in the case of each subsequent Contributor:

    +

    i) changes to the Program, and

    +

    ii) additions to the Program;

    +

    where such changes and/or additions to the Program +originate from and are distributed by that particular Contributor. A +Contribution 'originates' from a Contributor if it was added to the +Program by such Contributor itself or anyone acting on such +Contributor's behalf. Contributions do not include additions to the +Program which: (i) are separate modules of software distributed in +conjunction with the Program under their own license agreement, and (ii) +are not derivative works of the Program.

    + +

    "Contributor" means any person or entity that distributes +the Program.

    + +

    "Licensed Patents" mean patent claims licensable by a +Contributor which are necessarily infringed by the use or sale of its +Contribution alone or when combined with the Program.

    + +

    "Program" means the Contributions distributed in accordance +with this Agreement.

    + +

    "Recipient" means anyone who receives the Program under +this Agreement, including all Contributors.

    + +

    2. GRANT OF RIGHTS

    + +

    a) Subject to the terms of this Agreement, each +Contributor hereby grants Recipient a non-exclusive, worldwide, +royalty-free copyright license to reproduce, prepare derivative works +of, publicly display, publicly perform, distribute and sublicense the +Contribution of such Contributor, if any, and such derivative works, in +source code and object code form.

    + +

    b) Subject to the terms of this Agreement, each +Contributor hereby grants Recipient a non-exclusive, worldwide, +royalty-free patent license under Licensed Patents to make, use, sell, +offer to sell, import and otherwise transfer the Contribution of such +Contributor, if any, in source code and object code form. This patent +license shall apply to the combination of the Contribution and the +Program if, at the time the Contribution is added by the Contributor, +such addition of the Contribution causes such combination to be covered +by the Licensed Patents. The patent license shall not apply to any other +combinations which include the Contribution. No hardware per se is +licensed hereunder.

    + +

    c) Recipient understands that although each Contributor +grants the licenses to its Contributions set forth herein, no assurances +are provided by any Contributor that the Program does not infringe the +patent or other intellectual property rights of any other entity. Each +Contributor disclaims any liability to Recipient for claims brought by +any other entity based on infringement of intellectual property rights +or otherwise. As a condition to exercising the rights and licenses +granted hereunder, each Recipient hereby assumes sole responsibility to +secure any other intellectual property rights needed, if any. For +example, if a third party patent license is required to allow Recipient +to distribute the Program, it is Recipient's responsibility to acquire +that license before distributing the Program.

    + +

    d) Each Contributor represents that to its knowledge it +has sufficient copyright rights in its Contribution, if any, to grant +the copyright license set forth in this Agreement.

    + +

    3. REQUIREMENTS

    + +

    A Contributor may choose to distribute the Program in object code +form under its own license agreement, provided that:

    + +

    a) it complies with the terms and conditions of this +Agreement; and

    + +

    b) its license agreement:

    + +

    i) effectively disclaims on behalf of all Contributors +all warranties and conditions, express and implied, including warranties +or conditions of title and non-infringement, and implied warranties or +conditions of merchantability and fitness for a particular purpose;

    + +

    ii) effectively excludes on behalf of all Contributors +all liability for damages, including direct, indirect, special, +incidental and consequential damages, such as lost profits;

    + +

    iii) states that any provisions which differ from this +Agreement are offered by that Contributor alone and not by any other +party; and

    + +

    iv) states that source code for the Program is available +from such Contributor, and informs licensees how to obtain it in a +reasonable manner on or through a medium customarily used for software +exchange.

    + +

    When the Program is made available in source code form:

    + +

    a) it must be made available under this Agreement; and

    + +

    b) a copy of this Agreement must be included with each +copy of the Program.

    + +

    Contributors may not remove or alter any copyright notices contained +within the Program.

    + +

    Each Contributor must identify itself as the originator of its +Contribution, if any, in a manner that reasonably allows subsequent +Recipients to identify the originator of the Contribution.

    + +

    4. COMMERCIAL DISTRIBUTION

    + +

    Commercial distributors of software may accept certain +responsibilities with respect to end users, business partners and the +like. While this license is intended to facilitate the commercial use of +the Program, the Contributor who includes the Program in a commercial +product offering should do so in a manner which does not create +potential liability for other Contributors. Therefore, if a Contributor +includes the Program in a commercial product offering, such Contributor +("Commercial Contributor") hereby agrees to defend and +indemnify every other Contributor ("Indemnified Contributor") +against any losses, damages and costs (collectively "Losses") +arising from claims, lawsuits and other legal actions brought by a third +party against the Indemnified Contributor to the extent caused by the +acts or omissions of such Commercial Contributor in connection with its +distribution of the Program in a commercial product offering. The +obligations in this section do not apply to any claims or Losses +relating to any actual or alleged intellectual property infringement. In +order to qualify, an Indemnified Contributor must: a) promptly notify +the Commercial Contributor in writing of such claim, and b) allow the +Commercial Contributor to control, and cooperate with the Commercial +Contributor in, the defense and any related settlement negotiations. The +Indemnified Contributor may participate in any such claim at its own +expense.

    + +

    For example, a Contributor might include the Program in a commercial +product offering, Product X. That Contributor is then a Commercial +Contributor. If that Commercial Contributor then makes performance +claims, or offers warranties related to Product X, those performance +claims and warranties are such Commercial Contributor's responsibility +alone. Under this section, the Commercial Contributor would have to +defend claims against the other Contributors related to those +performance claims and warranties, and if a court requires any other +Contributor to pay any damages as a result, the Commercial Contributor +must pay those damages.

    + +

    5. NO WARRANTY

    + +

    EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, THE PROGRAM IS +PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS +OF ANY KIND, EITHER EXPRESS OR IMPLIED INCLUDING, WITHOUT LIMITATION, +ANY WARRANTIES OR CONDITIONS OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY +OR FITNESS FOR A PARTICULAR PURPOSE. Each Recipient is solely +responsible for determining the appropriateness of using and +distributing the Program and assumes all risks associated with its +exercise of rights under this Agreement , including but not limited to +the risks and costs of program errors, compliance with applicable laws, +damage to or loss of data, programs or equipment, and unavailability or +interruption of operations.

    + +

    6. DISCLAIMER OF LIABILITY

    + +

    EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, NEITHER RECIPIENT +NOR ANY CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT, +INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING +WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF +LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING +NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OR +DISTRIBUTION OF THE PROGRAM OR THE EXERCISE OF ANY RIGHTS GRANTED +HEREUNDER, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

    + +

    7. GENERAL

    + +

    If any provision of this Agreement is invalid or unenforceable under +applicable law, it shall not affect the validity or enforceability of +the remainder of the terms of this Agreement, and without further action +by the parties hereto, such provision shall be reformed to the minimum +extent necessary to make such provision valid and enforceable.

    + +

    If Recipient institutes patent litigation against any entity +(including a cross-claim or counterclaim in a lawsuit) alleging that the +Program itself (excluding combinations of the Program with other +software or hardware) infringes such Recipient's patent(s), then such +Recipient's rights granted under Section 2(b) shall terminate as of the +date such litigation is filed.

    + +

    All Recipient's rights under this Agreement shall terminate if it +fails to comply with any of the material terms or conditions of this +Agreement and does not cure such failure in a reasonable period of time +after becoming aware of such noncompliance. If all Recipient's rights +under this Agreement terminate, Recipient agrees to cease use and +distribution of the Program as soon as reasonably practicable. However, +Recipient's obligations under this Agreement and any licenses granted by +Recipient relating to the Program shall continue and survive.

    + +

    Everyone is permitted to copy and distribute copies of this +Agreement, but in order to avoid inconsistency the Agreement is +copyrighted and may only be modified in the following manner. The +Agreement Steward reserves the right to publish new versions (including +revisions) of this Agreement from time to time. No one other than the +Agreement Steward has the right to modify this Agreement. The Eclipse +Foundation is the initial Agreement Steward. The Eclipse Foundation may +assign the responsibility to serve as the Agreement Steward to a +suitable separate entity. Each new version of the Agreement will be +given a distinguishing version number. The Program (including +Contributions) may always be distributed subject to the version of the +Agreement under which it was received. In addition, after a new version +of the Agreement is published, Contributor may elect to distribute the +Program (including its Contributions) under the new version. Except as +expressly stated in Sections 2(a) and 2(b) above, Recipient receives no +rights or licenses to the intellectual property of any Contributor under +this Agreement, whether expressly, by implication, estoppel or +otherwise. All rights in the Program not expressly granted under this +Agreement are reserved.

    + +

    This Agreement is governed by the laws of the State of New York and +the intellectual property laws of the United States of America. No party +to this Agreement will bring a legal action under this Agreement more +than one year after the cause of action arose. Each party waives its +rights to a jury trial in any resulting litigation.

    + + + + diff --git a/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/ZooInspector.java b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/ZooInspector.java new file mode 100644 index 0000000..b637bfd --- /dev/null +++ b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/ZooInspector.java @@ -0,0 +1,66 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.inspector; + +import java.awt.event.WindowAdapter; +import java.awt.event.WindowEvent; + +import javax.swing.JFrame; +import javax.swing.JOptionPane; +import javax.swing.UIManager; + +import org.apache.zookeeper.inspector.gui.ZooInspectorPanel; +import org.apache.zookeeper.inspector.logger.LoggerFactory; +import org.apache.zookeeper.inspector.manager.ZooInspectorManagerImpl; + +/** + * + */ +public class ZooInspector { + /** + * @param args + * - not used. The value of these parameters will have no effect + * on the application + */ + public static void main(String[] args) { + try { + UIManager.setLookAndFeel(UIManager.getSystemLookAndFeelClassName()); + JFrame frame = new JFrame("ZooInspector"); + frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); + final ZooInspectorPanel zooInspectorPanel = new ZooInspectorPanel( + new ZooInspectorManagerImpl()); + frame.addWindowListener(new WindowAdapter() { + @Override + public void windowClosed(WindowEvent e) { + super.windowClosed(e); + zooInspectorPanel.disconnect(true); + } + }); + + frame.setContentPane(zooInspectorPanel); + frame.setSize(1024, 768); + frame.setVisible(true); + } catch (Exception e) { + LoggerFactory.getLogger().error( + "Error occurred loading ZooInspector", e); + JOptionPane.showMessageDialog(null, + "ZooInspector failed to start: " + e.getMessage(), "Error", + JOptionPane.ERROR_MESSAGE); + } + } +} diff --git a/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/encryption/BasicDataEncryptionManager.java b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/encryption/BasicDataEncryptionManager.java new file mode 100644 index 0000000..a9e5ac4 --- /dev/null +++ b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/encryption/BasicDataEncryptionManager.java @@ -0,0 +1,50 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.inspector.encryption; + +/** + * + */ +public class BasicDataEncryptionManager implements DataEncryptionManager { + + /* + * (non-Javadoc) + * + * @see + * org.apache.zookeeper.inspector.encryption.DataEncryptionManager#decryptData + * (byte[]) + */ + public String decryptData(byte[] encrypted) throws Exception { + return new String(encrypted); + } + + /* + * (non-Javadoc) + * + * @see + * org.apache.zookeeper.inspector.encryption.DataEncryptionManager#encryptData + * (java.lang.String) + */ + public byte[] encryptData(String data) throws Exception { + if (data == null) { + return new byte[0]; + } + return data.getBytes(); + } + +} diff --git a/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/encryption/DataEncryptionManager.java b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/encryption/DataEncryptionManager.java new file mode 100644 index 0000000..15a9ee4 --- /dev/null +++ b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/encryption/DataEncryptionManager.java @@ -0,0 +1,39 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.inspector.encryption; + +/** + * A class which describes how data should be encrypted and decrypted + */ +public interface DataEncryptionManager { + /** + * @param data + * - the data to be encrypted + * @return the encrypted data + * @throws Exception + */ + public byte[] encryptData(String data) throws Exception; + + /** + * @param encrypted + * - the data to be decrypted + * @return the decrypted data + * @throws Exception + */ + public String decryptData(byte[] encrypted) throws Exception; +} diff --git a/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/NodeViewersChangeListener.java b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/NodeViewersChangeListener.java new file mode 100644 index 0000000..b0b1e98 --- /dev/null +++ b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/NodeViewersChangeListener.java @@ -0,0 +1,37 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.inspector.gui; + +import java.util.List; + +import org.apache.zookeeper.inspector.gui.nodeviewer.ZooInspectorNodeViewer; + +/** + * A Listener for changes to the configuration of which node viewers are shown + */ +public interface NodeViewersChangeListener { + /** + * Called when the node viewers configuration is changed (i.e node viewers + * are added, removed or the order of the node viewers is changed) + * + * @param newViewers + * - a {@link List} of {@link ZooInspectorNodeViewer}s which are + * to be shown + */ + public void nodeViewersChanged(List newViewers); +} diff --git a/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/ZooInspectorAboutDialog.java b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/ZooInspectorAboutDialog.java new file mode 100644 index 0000000..fbae8f1 --- /dev/null +++ b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/ZooInspectorAboutDialog.java @@ -0,0 +1,80 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.inspector.gui; + +import java.awt.BorderLayout; +import java.awt.Dimension; +import java.awt.FlowLayout; +import java.awt.Frame; +import java.awt.event.ActionEvent; +import java.awt.event.ActionListener; +import java.io.IOException; + +import javax.swing.JButton; +import javax.swing.JDialog; +import javax.swing.JEditorPane; +import javax.swing.JPanel; + +import org.apache.zookeeper.inspector.logger.LoggerFactory; + +/** + * The About Dialog for the application + */ +public class ZooInspectorAboutDialog extends JDialog { + /** + * @param frame + * - the Frame from which the dialog is displayed + */ + public ZooInspectorAboutDialog(Frame frame) { + super(frame); + this.setLayout(new BorderLayout()); + this.setIconImage(ZooInspectorIconResources.getInformationIcon() + .getImage()); + this.setTitle("About ZooInspector"); + this.setModal(true); + this.setAlwaysOnTop(true); + this.setResizable(false); + JPanel panel = new JPanel(); + panel.setLayout(new BorderLayout()); + JEditorPane aboutPane = new JEditorPane(); + aboutPane.setEditable(false); + aboutPane.setOpaque(false); + java.net.URL aboutURL = ZooInspectorAboutDialog.class + .getResource("about.html"); + try { + aboutPane.setPage(aboutURL); + } catch (IOException e) { + LoggerFactory.getLogger().error( + "Error loading about.html, file may be corrupt", e); + } + panel.add(aboutPane, BorderLayout.CENTER); + panel.setPreferredSize(new Dimension(600, 200)); + JPanel buttonsPanel = new JPanel(); + buttonsPanel.setLayout(new FlowLayout(FlowLayout.CENTER, 10, 10)); + JButton okButton = new JButton("OK"); + okButton.addActionListener(new ActionListener() { + public void actionPerformed(ActionEvent e) { + ZooInspectorAboutDialog.this.dispose(); + } + }); + buttonsPanel.add(okButton); + this.add(panel, BorderLayout.CENTER); + this.add(buttonsPanel, BorderLayout.SOUTH); + this.pack(); + } +} diff --git a/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/ZooInspectorConnectionPropertiesDialog.java b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/ZooInspectorConnectionPropertiesDialog.java new file mode 100644 index 0000000..c7db524 --- /dev/null +++ b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/ZooInspectorConnectionPropertiesDialog.java @@ -0,0 +1,321 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.inspector.gui; + +import java.awt.BorderLayout; +import java.awt.GridBagConstraints; +import java.awt.GridBagLayout; +import java.awt.Insets; +import java.awt.event.ActionEvent; +import java.awt.event.ActionListener; +import java.io.File; +import java.io.FileReader; +import java.io.IOException; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Properties; +import java.util.Map.Entry; + +import javax.swing.JButton; +import javax.swing.JComboBox; +import javax.swing.JComponent; +import javax.swing.JDialog; +import javax.swing.JFileChooser; +import javax.swing.JLabel; +import javax.swing.JOptionPane; +import javax.swing.JPanel; +import javax.swing.JTextField; + +import org.apache.zookeeper.inspector.logger.LoggerFactory; +import org.apache.zookeeper.inspector.manager.Pair; + +/** + * The connection properties dialog. This is used to determine the settings for + * connecting to a zookeeper instance + */ +public class ZooInspectorConnectionPropertiesDialog extends JDialog { + + private final HashMap components; + + /** + * @param lastConnectionProps + * - the last connection properties used. if this is the first + * conneciton since starting the applications this will be the + * default settings + * @param connectionPropertiesTemplateAndLabels + * - the connection properties and labels to show in this dialog + * @param zooInspectorPanel + * - the {@link ZooInspectorPanel} linked to this dialog + */ + public ZooInspectorConnectionPropertiesDialog( + Properties lastConnectionProps, + Pair>, Map> connectionPropertiesTemplateAndLabels, + final ZooInspectorPanel zooInspectorPanel) { + final Map> connectionPropertiesTemplate = connectionPropertiesTemplateAndLabels + .getKey(); + final Map connectionPropertiesLabels = connectionPropertiesTemplateAndLabels + .getValue(); + this.setLayout(new BorderLayout()); + this.setTitle("Connection Settings"); + this.setModal(true); + this.setAlwaysOnTop(true); + this.setResizable(false); + final JPanel options = new JPanel(); + final JFileChooser fileChooser = new JFileChooser(); + options.setLayout(new GridBagLayout()); + int i = 0; + components = new HashMap(); + for (Entry> entry : connectionPropertiesTemplate + .entrySet()) { + int rowPos = 2 * i + 1; + JLabel label = new JLabel(connectionPropertiesLabels.get(entry + .getKey())); + GridBagConstraints c1 = new GridBagConstraints(); + c1.gridx = 0; + c1.gridy = rowPos; + c1.gridwidth = 1; + c1.gridheight = 1; + c1.weightx = 0; + c1.weighty = 0; + c1.anchor = GridBagConstraints.WEST; + c1.fill = GridBagConstraints.HORIZONTAL; + c1.insets = new Insets(5, 5, 5, 5); + c1.ipadx = 0; + c1.ipady = 0; + options.add(label, c1); + if (entry.getValue().size() == 0) { + JTextField text = new JTextField(); + GridBagConstraints c2 = new GridBagConstraints(); + c2.gridx = 2; + c2.gridy = rowPos; + c2.gridwidth = 1; + c2.gridheight = 1; + c2.weightx = 0; + c2.weighty = 0; + c2.anchor = GridBagConstraints.WEST; + c2.fill = GridBagConstraints.HORIZONTAL; + c2.insets = new Insets(5, 5, 5, 5); + c2.ipadx = 0; + c2.ipady = 0; + options.add(text, c2); + components.put(entry.getKey(), text); + } else if (entry.getValue().size() == 1) { + JTextField text = new JTextField(entry.getValue().get(0)); + GridBagConstraints c2 = new GridBagConstraints(); + c2.gridx = 2; + c2.gridy = rowPos; + c2.gridwidth = 1; + c2.gridheight = 1; + c2.weightx = 0; + c2.weighty = 0; + c2.anchor = GridBagConstraints.WEST; + c2.fill = GridBagConstraints.HORIZONTAL; + c2.insets = new Insets(5, 5, 5, 5); + c2.ipadx = 0; + c2.ipady = 0; + options.add(text, c2); + components.put(entry.getKey(), text); + } else { + List list = entry.getValue(); + JComboBox combo = new JComboBox(list.toArray(new String[list + .size()])); + combo.setSelectedItem(list.get(0)); + GridBagConstraints c2 = new GridBagConstraints(); + c2.gridx = 2; + c2.gridy = rowPos; + c2.gridwidth = 1; + c2.gridheight = 1; + c2.weightx = 0; + c2.weighty = 0; + c2.anchor = GridBagConstraints.WEST; + c2.fill = GridBagConstraints.HORIZONTAL; + c2.insets = new Insets(5, 5, 5, 5); + c2.ipadx = 0; + c2.ipady = 0; + options.add(combo, c2); + components.put(entry.getKey(), combo); + } + i++; + } + loadConnectionProps(lastConnectionProps); + JPanel buttonsPanel = new JPanel(); + buttonsPanel.setLayout(new GridBagLayout()); + JButton loadPropsFileButton = new JButton("Load from file"); + loadPropsFileButton.addActionListener(new ActionListener() { + + public void actionPerformed(ActionEvent e) { + int result = fileChooser + .showOpenDialog(ZooInspectorConnectionPropertiesDialog.this); + if (result == JFileChooser.APPROVE_OPTION) { + File propsFilePath = fileChooser.getSelectedFile(); + Properties props = new Properties(); + try { + FileReader reader = new FileReader(propsFilePath); + try { + props.load(reader); + loadConnectionProps(props); + } finally { + reader.close(); + } + } catch (IOException ex) { + LoggerFactory + .getLogger() + .error( + "An Error occurred loading connection properties from file", + ex); + JOptionPane + .showMessageDialog( + ZooInspectorConnectionPropertiesDialog.this, + "An Error occurred loading connection properties from file", + "Error", JOptionPane.ERROR_MESSAGE); + } + options.revalidate(); + options.repaint(); + } + + } + }); + GridBagConstraints c3 = new GridBagConstraints(); + c3.gridx = 0; + c3.gridy = 0; + c3.gridwidth = 1; + c3.gridheight = 1; + c3.weightx = 0; + c3.weighty = 1; + c3.anchor = GridBagConstraints.SOUTHWEST; + c3.fill = GridBagConstraints.NONE; + c3.insets = new Insets(5, 5, 5, 5); + c3.ipadx = 0; + c3.ipady = 0; + buttonsPanel.add(loadPropsFileButton, c3); + JButton saveDefaultPropsFileButton = new JButton("Set As Default"); + saveDefaultPropsFileButton.addActionListener(new ActionListener() { + + public void actionPerformed(ActionEvent e) { + + Properties connectionProps = getConnectionProps(); + try { + zooInspectorPanel + .setdefaultConnectionProps(connectionProps); + } catch (IOException ex) { + LoggerFactory + .getLogger() + .error( + "An Error occurred saving the default connection properties file", + ex); + JOptionPane + .showMessageDialog( + ZooInspectorConnectionPropertiesDialog.this, + "An Error occurred saving the default connection properties file", + "Error", JOptionPane.ERROR_MESSAGE); + } + } + }); + GridBagConstraints c6 = new GridBagConstraints(); + c6.gridx = 1; + c6.gridy = 0; + c6.gridwidth = 1; + c6.gridheight = 1; + c6.weightx = 1; + c6.weighty = 1; + c6.anchor = GridBagConstraints.SOUTHWEST; + c6.fill = GridBagConstraints.NONE; + c6.insets = new Insets(5, 5, 5, 5); + c6.ipadx = 0; + c6.ipady = 0; + buttonsPanel.add(saveDefaultPropsFileButton, c6); + JButton okButton = new JButton("OK"); + okButton.addActionListener(new ActionListener() { + + public void actionPerformed(ActionEvent e) { + ZooInspectorConnectionPropertiesDialog.this.dispose(); + Properties connectionProps = getConnectionProps(); + zooInspectorPanel.connect(connectionProps); + } + }); + GridBagConstraints c4 = new GridBagConstraints(); + c4.gridx = 2; + c4.gridy = 0; + c4.gridwidth = 1; + c4.gridheight = 1; + c4.weightx = 0; + c4.weighty = 1; + c4.anchor = GridBagConstraints.SOUTH; + c4.fill = GridBagConstraints.HORIZONTAL; + c4.insets = new Insets(5, 5, 5, 5); + c4.ipadx = 0; + c4.ipady = 0; + buttonsPanel.add(okButton, c4); + JButton cancelButton = new JButton("Cancel"); + cancelButton.addActionListener(new ActionListener() { + + public void actionPerformed(ActionEvent e) { + ZooInspectorConnectionPropertiesDialog.this.dispose(); + } + }); + GridBagConstraints c5 = new GridBagConstraints(); + c5.gridx = 3; + c5.gridy = 0; + c5.gridwidth = 1; + c5.gridheight = 1; + c5.weightx = 0; + c5.weighty = 1; + c5.anchor = GridBagConstraints.SOUTH; + c5.fill = GridBagConstraints.HORIZONTAL; + c5.insets = new Insets(5, 5, 5, 5); + c5.ipadx = 0; + c5.ipady = 0; + buttonsPanel.add(cancelButton, c5); + this.add(options, BorderLayout.CENTER); + this.add(buttonsPanel, BorderLayout.SOUTH); + this.pack(); + } + + private void loadConnectionProps(Properties props) { + if (props != null) { + for (Object key : props.keySet()) { + String propsKey = (String) key; + if (components.containsKey(propsKey)) { + JComponent component = components.get(propsKey); + String value = props.getProperty(propsKey); + if (component instanceof JTextField) { + ((JTextField) component).setText(value); + } else if (component instanceof JComboBox) { + ((JComboBox) component).setSelectedItem(value); + } + } + } + } + } + + private Properties getConnectionProps() { + Properties connectionProps = new Properties(); + for (Entry entry : components.entrySet()) { + String value = null; + JComponent component = entry.getValue(); + if (component instanceof JTextField) { + value = ((JTextField) component).getText(); + } else if (component instanceof JComboBox) { + value = ((JComboBox) component).getSelectedItem().toString(); + } + connectionProps.put(entry.getKey(), value); + } + return connectionProps; + } +} diff --git a/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/ZooInspectorIconResources.java b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/ZooInspectorIconResources.java new file mode 100644 index 0000000..fa45ab3 --- /dev/null +++ b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/ZooInspectorIconResources.java @@ -0,0 +1,118 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.inspector.gui; + +import javax.swing.ImageIcon; + +/** + * A class containing static methods for retrieving {@link ImageIcon}s used in + * the application + */ +public class ZooInspectorIconResources { + + /** + * @return file icon + */ + public static ImageIcon getTreeLeafIcon() { + return new ImageIcon("icons/file_obj.gif"); //$NON-NLS-1$ + } + + /** + * @return folder open icon + */ + public static ImageIcon getTreeOpenIcon() { + return new ImageIcon("icons/fldr_obj.gif"); //$NON-NLS-1$ + } + + /** + * @return folder closed icon + */ + public static ImageIcon getTreeClosedIcon() { + return new ImageIcon("icons/fldr_obj.gif"); //$NON-NLS-1$ + } + + /** + * @return connect icon + */ + public static ImageIcon getConnectIcon() { + return new ImageIcon("icons/launch_run.gif"); //$NON-NLS-1$ + } + + /** + * @return disconnect icon + */ + public static ImageIcon getDisconnectIcon() { + return new ImageIcon("icons/launch_stop.gif"); //$NON-NLS-1$ + } + + /** + * @return save icon + */ + public static ImageIcon getSaveIcon() { + return new ImageIcon("icons/save_edit.gif"); //$NON-NLS-1$ + } + + /** + * @return add icon + */ + public static ImageIcon getAddNodeIcon() { + return new ImageIcon("icons/new_con.gif"); //$NON-NLS-1$ + } + + /** + * @return delete icon + */ + public static ImageIcon getDeleteNodeIcon() { + return new ImageIcon("icons/trash.gif"); //$NON-NLS-1$ + } + + /** + * @return refresh icon + */ + public static ImageIcon getRefreshIcon() { + return new ImageIcon("icons/refresh.gif"); //$NON-NLS-1$ + } + + /** + * @return information icon + */ + public static ImageIcon getInformationIcon() { + return new ImageIcon("icons/info_obj.gif"); //$NON-NLS-1$ + } + + /** + * @return node viewers icon + */ + public static ImageIcon getChangeNodeViewersIcon() { + return new ImageIcon("icons/edtsrclkup_co.gif"); //$NON-NLS-1$ + } + + /** + * @return up icon + */ + public static ImageIcon getUpIcon() { + return new ImageIcon("icons/search_prev.gif"); //$NON-NLS-1$ + } + + /** + * @return down icon + */ + public static ImageIcon getDownIcon() { + return new ImageIcon("icons/search_next.gif"); //$NON-NLS-1$ + } +} diff --git a/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/ZooInspectorNodeViewersDialog.java b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/ZooInspectorNodeViewersDialog.java new file mode 100644 index 0000000..fd0b00a --- /dev/null +++ b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/ZooInspectorNodeViewersDialog.java @@ -0,0 +1,605 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.inspector.gui; + +import java.awt.BorderLayout; +import java.awt.Component; +import java.awt.FlowLayout; +import java.awt.Frame; +import java.awt.GridBagConstraints; +import java.awt.GridBagLayout; +import java.awt.Insets; +import java.awt.datatransfer.Transferable; +import java.awt.event.ActionEvent; +import java.awt.event.ActionListener; +import java.io.File; +import java.io.IOException; +import java.util.ArrayList; +import java.util.Collection; +import java.util.List; + +import javax.swing.DefaultListCellRenderer; +import javax.swing.DefaultListModel; +import javax.swing.DropMode; +import javax.swing.JButton; +import javax.swing.JComponent; +import javax.swing.JDialog; +import javax.swing.JFileChooser; +import javax.swing.JLabel; +import javax.swing.JList; +import javax.swing.JOptionPane; +import javax.swing.JPanel; +import javax.swing.JScrollPane; +import javax.swing.JTextField; +import javax.swing.ListSelectionModel; +import javax.swing.TransferHandler; +import javax.swing.event.ListSelectionEvent; +import javax.swing.event.ListSelectionListener; + +import org.apache.zookeeper.inspector.gui.nodeviewer.ZooInspectorNodeViewer; +import org.apache.zookeeper.inspector.logger.LoggerFactory; +import org.apache.zookeeper.inspector.manager.ZooInspectorManager; + +/** + * A {@link JDialog} for configuring which {@link ZooInspectorNodeViewer}s to + * show in the application + */ +public class ZooInspectorNodeViewersDialog extends JDialog implements + ListSelectionListener { + + private final JButton upButton; + private final JButton downButton; + private final JButton removeButton; + private final JButton addButton; + private final JList viewersList; + private final JButton saveFileButton; + private final JButton loadFileButton; + private final JButton setDefaultsButton; + private final JFileChooser fileChooser = new JFileChooser(new File(".")); + + /** + * @param frame + * - the Frame from which the dialog is displayed + * @param currentViewers + * - the {@link ZooInspectorNodeViewer}s to show + * @param listeners + * - the {@link NodeViewersChangeListener}s which need to be + * notified of changes to the node viewers configuration + * @param manager + * - the {@link ZooInspectorManager} for the application + * + */ + public ZooInspectorNodeViewersDialog(Frame frame, + final List currentViewers, + final Collection listeners, + final ZooInspectorManager manager) { + super(frame); + final List newViewers = new ArrayList( + currentViewers); + this.setLayout(new BorderLayout()); + this.setIconImage(ZooInspectorIconResources.getChangeNodeViewersIcon() + .getImage()); + this.setTitle("About ZooInspector"); + this.setModal(true); + this.setAlwaysOnTop(true); + this.setResizable(true); + final JPanel panel = new JPanel(); + panel.setLayout(new GridBagLayout()); + viewersList = new JList(); + DefaultListModel model = new DefaultListModel(); + for (ZooInspectorNodeViewer viewer : newViewers) { + model.addElement(viewer); + } + viewersList.setModel(model); + viewersList.setCellRenderer(new DefaultListCellRenderer() { + @Override + public Component getListCellRendererComponent(JList list, + Object value, int index, boolean isSelected, + boolean cellHasFocus) { + ZooInspectorNodeViewer viewer = (ZooInspectorNodeViewer) value; + JLabel label = (JLabel) super.getListCellRendererComponent( + list, value, index, isSelected, cellHasFocus); + label.setText(viewer.getTitle()); + return label; + } + }); + viewersList.setDropMode(DropMode.INSERT); + viewersList.enableInputMethods(true); + viewersList.setDragEnabled(true); + viewersList.setSelectionMode(ListSelectionModel.SINGLE_SELECTION); + viewersList.getSelectionModel().addListSelectionListener(this); + viewersList.setTransferHandler(new TransferHandler() { + + @Override + public boolean canImport(TransferHandler.TransferSupport info) { + // we only import NodeViewers + if (!info + .isDataFlavorSupported(ZooInspectorNodeViewer.nodeViewerDataFlavor)) { + return false; + } + + JList.DropLocation dl = (JList.DropLocation) info + .getDropLocation(); + if (dl.getIndex() == -1) { + return false; + } + return true; + } + + @Override + public boolean importData(TransferHandler.TransferSupport info) { + JList.DropLocation dl = (JList.DropLocation) info + .getDropLocation(); + DefaultListModel listModel = (DefaultListModel) viewersList + .getModel(); + int index = dl.getIndex(); + boolean insert = dl.isInsert(); + // Get the string that is being dropped. + Transferable t = info.getTransferable(); + String data; + try { + data = (String) t + .getTransferData(ZooInspectorNodeViewer.nodeViewerDataFlavor); + } catch (Exception e) { + return false; + } + try { + ZooInspectorNodeViewer viewer = (ZooInspectorNodeViewer) Class + .forName(data).newInstance(); + if (listModel.contains(viewer)) { + listModel.removeElement(viewer); + } + if (insert) { + listModel.add(index, viewer); + } else { + listModel.set(index, viewer); + } + return true; + } catch (Exception e) { + LoggerFactory.getLogger().error( + "Error instantiating class: " + data, e); + return false; + } + + } + + @Override + public int getSourceActions(JComponent c) { + return MOVE; + } + + @Override + protected Transferable createTransferable(JComponent c) { + JList list = (JList) c; + ZooInspectorNodeViewer value = (ZooInspectorNodeViewer) list + .getSelectedValue(); + return value; + } + }); + JScrollPane scroller = new JScrollPane(viewersList); + GridBagConstraints c1 = new GridBagConstraints(); + c1.gridx = 0; + c1.gridy = 0; + c1.gridwidth = 3; + c1.gridheight = 3; + c1.weightx = 0; + c1.weighty = 1; + c1.anchor = GridBagConstraints.CENTER; + c1.fill = GridBagConstraints.BOTH; + c1.insets = new Insets(5, 5, 5, 5); + c1.ipadx = 0; + c1.ipady = 0; + panel.add(scroller, c1); + upButton = new JButton(ZooInspectorIconResources.getUpIcon()); + downButton = new JButton(ZooInspectorIconResources.getDownIcon()); + removeButton = new JButton(ZooInspectorIconResources + .getDeleteNodeIcon()); + addButton = new JButton(ZooInspectorIconResources.getAddNodeIcon()); + upButton.setEnabled(false); + downButton.setEnabled(false); + removeButton.setEnabled(false); + addButton.setEnabled(true); + upButton.setToolTipText("Move currently selected node viewer up"); + downButton.setToolTipText("Move currently selected node viewer down"); + removeButton.setToolTipText("Remove currently selected node viewer"); + addButton.setToolTipText("Add node viewer"); + final JTextField newViewerTextField = new JTextField(); + GridBagConstraints c2 = new GridBagConstraints(); + c2.gridx = 3; + c2.gridy = 0; + c2.gridwidth = 1; + c2.gridheight = 1; + c2.weightx = 0; + c2.weighty = 0; + c2.anchor = GridBagConstraints.NORTH; + c2.fill = GridBagConstraints.HORIZONTAL; + c2.insets = new Insets(5, 5, 5, 5); + c2.ipadx = 0; + c2.ipady = 0; + panel.add(upButton, c2); + GridBagConstraints c3 = new GridBagConstraints(); + c3.gridx = 3; + c3.gridy = 2; + c3.gridwidth = 1; + c3.gridheight = 1; + c3.weightx = 0; + c3.weighty = 0; + c3.anchor = GridBagConstraints.NORTH; + c3.fill = GridBagConstraints.HORIZONTAL; + c3.insets = new Insets(5, 5, 5, 5); + c3.ipadx = 0; + c3.ipady = 0; + panel.add(downButton, c3); + GridBagConstraints c4 = new GridBagConstraints(); + c4.gridx = 3; + c4.gridy = 1; + c4.gridwidth = 1; + c4.gridheight = 1; + c4.weightx = 0; + c4.weighty = 0; + c4.anchor = GridBagConstraints.NORTH; + c4.fill = GridBagConstraints.HORIZONTAL; + c4.insets = new Insets(5, 5, 5, 5); + c4.ipadx = 0; + c4.ipady = 0; + panel.add(removeButton, c4); + GridBagConstraints c5 = new GridBagConstraints(); + c5.gridx = 0; + c5.gridy = 3; + c5.gridwidth = 3; + c5.gridheight = 1; + c5.weightx = 0; + c5.weighty = 0; + c5.anchor = GridBagConstraints.CENTER; + c5.fill = GridBagConstraints.BOTH; + c5.insets = new Insets(5, 5, 5, 5); + c5.ipadx = 0; + c5.ipady = 0; + panel.add(newViewerTextField, c5); + GridBagConstraints c6 = new GridBagConstraints(); + c6.gridx = 3; + c6.gridy = 3; + c6.gridwidth = 1; + c6.gridheight = 1; + c6.weightx = 0; + c6.weighty = 0; + c6.anchor = GridBagConstraints.CENTER; + c6.fill = GridBagConstraints.BOTH; + c6.insets = new Insets(5, 5, 5, 5); + c6.ipadx = 0; + c6.ipady = 0; + panel.add(addButton, c6); + upButton.addActionListener(new ActionListener() { + + public void actionPerformed(ActionEvent e) { + DefaultListModel listModel = (DefaultListModel) viewersList + .getModel(); + ZooInspectorNodeViewer viewer = (ZooInspectorNodeViewer) viewersList + .getSelectedValue(); + int index = viewersList.getSelectedIndex(); + if (listModel.contains(viewer)) { + listModel.removeElementAt(index); + listModel.insertElementAt(viewer, index - 1); + viewersList.setSelectedValue(viewer, true); + } + } + }); + downButton.addActionListener(new ActionListener() { + + public void actionPerformed(ActionEvent e) { + DefaultListModel listModel = (DefaultListModel) viewersList + .getModel(); + ZooInspectorNodeViewer viewer = (ZooInspectorNodeViewer) viewersList + .getSelectedValue(); + int index = viewersList.getSelectedIndex(); + if (listModel.contains(viewer)) { + listModel.removeElementAt(index); + listModel.insertElementAt(viewer, index + 1); + viewersList.setSelectedValue(viewer, true); + } + } + }); + removeButton.addActionListener(new ActionListener() { + + public void actionPerformed(ActionEvent e) { + DefaultListModel listModel = (DefaultListModel) viewersList + .getModel(); + ZooInspectorNodeViewer viewer = (ZooInspectorNodeViewer) viewersList + .getSelectedValue(); + int index = viewersList.getSelectedIndex(); + if (listModel.contains(viewer)) { + listModel.removeElement(viewer); + viewersList + .setSelectedIndex(index == listModel.size() ? index - 1 + : index); + } + } + }); + addButton.addActionListener(new ActionListener() { + + public void actionPerformed(ActionEvent e) { + String className = newViewerTextField.getText(); + if (className == null || className.length() == 0) { + JOptionPane + .showMessageDialog( + ZooInspectorNodeViewersDialog.this, + "Please enter the full class name for a Node Viewer and click the add button", + "Input Error", JOptionPane.ERROR_MESSAGE); + } else { + try { + DefaultListModel listModel = (DefaultListModel) viewersList + .getModel(); + ZooInspectorNodeViewer viewer = (ZooInspectorNodeViewer) Class + .forName(className).newInstance(); + if (listModel.contains(viewer)) { + JOptionPane + .showMessageDialog( + ZooInspectorNodeViewersDialog.this, + "Node viewer already exists. Each node viewer can only be added once.", + "Input Error", + JOptionPane.ERROR_MESSAGE); + } else { + listModel.addElement(viewer); + } + } catch (Exception ex) { + LoggerFactory + .getLogger() + .error( + "An error occurred while instaniating the node viewer. ", + ex); + JOptionPane.showMessageDialog( + ZooInspectorNodeViewersDialog.this, + "An error occurred while instaniating the node viewer: " + + ex.getMessage(), "Error", + JOptionPane.ERROR_MESSAGE); + } + } + } + }); + saveFileButton = new JButton("Save"); + loadFileButton = new JButton("Load"); + setDefaultsButton = new JButton("Set As Defaults"); + saveFileButton + .setToolTipText("Save current node viewer configuration to file"); + loadFileButton + .setToolTipText("Load node viewer configuration frm file"); + setDefaultsButton + .setToolTipText("Set current configuration asd defaults"); + GridBagConstraints c7 = new GridBagConstraints(); + c7.gridx = 0; + c7.gridy = 4; + c7.gridwidth = 1; + c7.gridheight = 1; + c7.weightx = 1; + c7.weighty = 0; + c7.anchor = GridBagConstraints.WEST; + c7.fill = GridBagConstraints.VERTICAL; + c7.insets = new Insets(5, 5, 5, 5); + c7.ipadx = 0; + c7.ipady = 0; + panel.add(saveFileButton, c7); + GridBagConstraints c8 = new GridBagConstraints(); + c8.gridx = 1; + c8.gridy = 4; + c8.gridwidth = 1; + c8.gridheight = 1; + c8.weightx = 0; + c8.weighty = 0; + c8.anchor = GridBagConstraints.WEST; + c8.fill = GridBagConstraints.VERTICAL; + c8.insets = new Insets(5, 5, 5, 5); + c8.ipadx = 0; + c8.ipady = 0; + panel.add(loadFileButton, c8); + GridBagConstraints c9 = new GridBagConstraints(); + c9.gridx = 2; + c9.gridy = 4; + c9.gridwidth = 1; + c9.gridheight = 1; + c9.weightx = 0; + c9.weighty = 0; + c9.anchor = GridBagConstraints.WEST; + c9.fill = GridBagConstraints.VERTICAL; + c9.insets = new Insets(5, 5, 5, 5); + c9.ipadx = 0; + c9.ipady = 0; + panel.add(setDefaultsButton, c9); + saveFileButton.addActionListener(new ActionListener() { + + public void actionPerformed(ActionEvent e) { + int result = fileChooser + .showSaveDialog(ZooInspectorNodeViewersDialog.this); + if (result == JFileChooser.APPROVE_OPTION) { + File selectedFile = fileChooser.getSelectedFile(); + int answer = JOptionPane.YES_OPTION; + if (selectedFile.exists()) { + answer = JOptionPane + .showConfirmDialog( + ZooInspectorNodeViewersDialog.this, + "The specified file already exists. do you want to overwrite it?", + "Confirm Overwrite", + JOptionPane.YES_NO_OPTION, + JOptionPane.WARNING_MESSAGE); + } + if (answer == JOptionPane.YES_OPTION) { + DefaultListModel listModel = (DefaultListModel) viewersList + .getModel(); + List nodeViewersClassNames = new ArrayList(); + Object[] modelContents = listModel.toArray(); + for (Object o : modelContents) { + nodeViewersClassNames + .add(((ZooInspectorNodeViewer) o) + .getClass().getCanonicalName()); + } + try { + manager.saveNodeViewersFile(selectedFile, + nodeViewersClassNames); + } catch (IOException ex) { + LoggerFactory + .getLogger() + .error( + "Error saving node veiwer configuration from file.", + ex); + JOptionPane.showMessageDialog( + ZooInspectorNodeViewersDialog.this, + "Error saving node veiwer configuration from file: " + + ex.getMessage(), "Error", + JOptionPane.ERROR_MESSAGE); + } + } + } + } + }); + loadFileButton.addActionListener(new ActionListener() { + + public void actionPerformed(ActionEvent e) { + int result = fileChooser + .showOpenDialog(ZooInspectorNodeViewersDialog.this); + if (result == JFileChooser.APPROVE_OPTION) { + try { + List nodeViewersClassNames = manager + .loadNodeViewersFile(fileChooser + .getSelectedFile()); + List nodeViewers = new ArrayList(); + for (String nodeViewersClassName : nodeViewersClassNames) { + ZooInspectorNodeViewer viewer = (ZooInspectorNodeViewer) Class + .forName(nodeViewersClassName) + .newInstance(); + nodeViewers.add(viewer); + } + DefaultListModel model = new DefaultListModel(); + for (ZooInspectorNodeViewer viewer : nodeViewers) { + model.addElement(viewer); + } + viewersList.setModel(model); + panel.revalidate(); + panel.repaint(); + } catch (Exception ex) { + LoggerFactory + .getLogger() + .error( + "Error loading node veiwer configuration from file.", + ex); + JOptionPane.showMessageDialog( + ZooInspectorNodeViewersDialog.this, + "Error loading node veiwer configuration from file: " + + ex.getMessage(), "Error", + JOptionPane.ERROR_MESSAGE); + } + } + } + }); + setDefaultsButton.addActionListener(new ActionListener() { + + public void actionPerformed(ActionEvent e) { + int answer = JOptionPane + .showConfirmDialog( + ZooInspectorNodeViewersDialog.this, + "Are you sure you want to save this configuration as the default?", + "Confirm Set Defaults", + JOptionPane.YES_NO_OPTION, + JOptionPane.WARNING_MESSAGE); + if (answer == JOptionPane.YES_OPTION) { + DefaultListModel listModel = (DefaultListModel) viewersList + .getModel(); + List nodeViewersClassNames = new ArrayList(); + Object[] modelContents = listModel.toArray(); + for (Object o : modelContents) { + nodeViewersClassNames.add(((ZooInspectorNodeViewer) o) + .getClass().getCanonicalName()); + } + try { + manager + .setDefaultNodeViewerConfiguration(nodeViewersClassNames); + } catch (IOException ex) { + LoggerFactory + .getLogger() + .error( + "Error setting default node veiwer configuration.", + ex); + JOptionPane.showMessageDialog( + ZooInspectorNodeViewersDialog.this, + "Error setting default node veiwer configuration: " + + ex.getMessage(), "Error", + JOptionPane.ERROR_MESSAGE); + } + } + } + }); + + JPanel buttonsPanel = new JPanel(); + buttonsPanel.setLayout(new FlowLayout(FlowLayout.CENTER, 10, 10)); + JButton okButton = new JButton("OK"); + okButton.addActionListener(new ActionListener() { + public void actionPerformed(ActionEvent e) { + ZooInspectorNodeViewersDialog.this.dispose(); + DefaultListModel listModel = (DefaultListModel) viewersList + .getModel(); + newViewers.clear(); + Object[] modelContents = listModel.toArray(); + for (Object o : modelContents) { + newViewers.add((ZooInspectorNodeViewer) o); + } + currentViewers.clear(); + currentViewers.addAll(newViewers); + for (NodeViewersChangeListener listener : listeners) { + listener.nodeViewersChanged(currentViewers); + } + } + }); + buttonsPanel.add(okButton); + JButton cancelButton = new JButton("Cancel"); + cancelButton.addActionListener(new ActionListener() { + public void actionPerformed(ActionEvent e) { + ZooInspectorNodeViewersDialog.this.dispose(); + } + }); + buttonsPanel.add(cancelButton); + this.add(panel, BorderLayout.CENTER); + this.add(buttonsPanel, BorderLayout.SOUTH); + this.pack(); + } + + /* + * (non-Javadoc) + * + * @see + * javax.swing.event.ListSelectionListener#valueChanged(javax.swing.event + * .ListSelectionEvent) + */ + public void valueChanged(ListSelectionEvent e) { + int index = viewersList.getSelectedIndex(); + if (index == -1) { + removeButton.setEnabled(false); + upButton.setEnabled(false); + downButton.setEnabled(false); + } else { + removeButton.setEnabled(true); + if (index == 0) { + upButton.setEnabled(false); + } else { + upButton.setEnabled(true); + } + if (index == ((DefaultListModel) viewersList.getModel()).getSize()) { + downButton.setEnabled(false); + } else { + downButton.setEnabled(true); + } + } + } +} diff --git a/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/ZooInspectorNodeViewersPanel.java b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/ZooInspectorNodeViewersPanel.java new file mode 100644 index 0000000..05c256b --- /dev/null +++ b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/ZooInspectorNodeViewersPanel.java @@ -0,0 +1,140 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.inspector.gui; + +import java.awt.BorderLayout; +import java.util.ArrayList; +import java.util.List; + +import javax.swing.JPanel; +import javax.swing.JTabbedPane; +import javax.swing.event.ChangeEvent; +import javax.swing.event.ChangeListener; +import javax.swing.event.TreeSelectionEvent; +import javax.swing.event.TreeSelectionListener; +import javax.swing.tree.TreePath; + +import org.apache.zookeeper.inspector.gui.nodeviewer.ZooInspectorNodeViewer; +import org.apache.zookeeper.inspector.manager.ZooInspectorManager; +import org.apache.zookeeper.inspector.manager.ZooInspectorNodeManager; + +/** + * This is the {@link JPanel} which contains the {@link ZooInspectorNodeViewer}s + */ +public class ZooInspectorNodeViewersPanel extends JPanel implements + TreeSelectionListener, ChangeListener { + + private final List nodeVeiwers = new ArrayList(); + private final List needsReload = new ArrayList(); + private final JTabbedPane tabbedPane; + private final List selectedNodes = new ArrayList(); + private final ZooInspectorNodeManager zooInspectorManager; + + /** + * @param zooInspectorManager + * - the {@link ZooInspectorManager} for the application + * @param nodeVeiwers + * - the {@link ZooInspectorNodeViewer}s to show + */ + public ZooInspectorNodeViewersPanel( + ZooInspectorNodeManager zooInspectorManager, + List nodeVeiwers) { + this.zooInspectorManager = zooInspectorManager; + this.setLayout(new BorderLayout()); + tabbedPane = new JTabbedPane(JTabbedPane.TOP, + JTabbedPane.WRAP_TAB_LAYOUT); + setNodeViewers(nodeVeiwers); + tabbedPane.addChangeListener(this); + this.add(tabbedPane, BorderLayout.CENTER); + reloadSelectedViewer(); + } + + /** + * @param nodeViewers + * - the {@link ZooInspectorNodeViewer}s to show + */ + public void setNodeViewers(List nodeViewers) { + this.nodeVeiwers.clear(); + this.nodeVeiwers.addAll(nodeViewers); + needsReload.clear(); + tabbedPane.removeAll(); + for (ZooInspectorNodeViewer nodeViewer : nodeVeiwers) { + nodeViewer.setZooInspectorManager(zooInspectorManager); + needsReload.add(true); + tabbedPane.add(nodeViewer.getTitle(), nodeViewer); + } + this.revalidate(); + this.repaint(); + } + + private void reloadSelectedViewer() { + int index = this.tabbedPane.getSelectedIndex(); + if (index != -1 && this.needsReload.get(index)) { + ZooInspectorNodeViewer viewer = this.nodeVeiwers.get(index); + viewer.nodeSelectionChanged(selectedNodes); + this.needsReload.set(index, false); + } + } + + /* + * (non-Javadoc) + * + * @see + * javax.swing.event.TreeSelectionListener#valueChanged(javax.swing.event + * .TreeSelectionEvent) + */ + public void valueChanged(TreeSelectionEvent e) { + TreePath[] paths = e.getPaths(); + selectedNodes.clear(); + for (TreePath path : paths) { + boolean appended = false; + StringBuilder sb = new StringBuilder(); + Object[] pathArray = path.getPath(); + for (Object o : pathArray) { + if (o != null) { + String nodeName = o.toString(); + if (nodeName != null) { + if (nodeName.length() > 0) { + appended = true; + sb.append("/"); //$NON-NLS-1$ + sb.append(o.toString()); + } + } + } + } + if (appended) { + selectedNodes.add(sb.toString()); + } + } + for (int i = 0; i < needsReload.size(); i++) { + this.needsReload.set(i, true); + } + reloadSelectedViewer(); + } + + /* + * (non-Javadoc) + * + * @see + * javax.swing.event.ChangeListener#stateChanged(javax.swing.event.ChangeEvent + * ) + */ + public void stateChanged(ChangeEvent e) { + reloadSelectedViewer(); + } +} diff --git a/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/ZooInspectorPanel.java b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/ZooInspectorPanel.java new file mode 100644 index 0000000..7a4efaf --- /dev/null +++ b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/ZooInspectorPanel.java @@ -0,0 +1,361 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.inspector.gui; + +import java.awt.BorderLayout; +import java.awt.event.ActionEvent; +import java.awt.event.ActionListener; +import java.io.IOException; +import java.util.ArrayList; +import java.util.List; +import java.util.Properties; +import java.util.concurrent.ExecutionException; + +import javax.swing.JButton; +import javax.swing.JOptionPane; +import javax.swing.JPanel; +import javax.swing.JScrollPane; +import javax.swing.JSplitPane; +import javax.swing.JToolBar; +import javax.swing.SwingWorker; + +import org.apache.zookeeper.inspector.gui.nodeviewer.ZooInspectorNodeViewer; +import org.apache.zookeeper.inspector.logger.LoggerFactory; +import org.apache.zookeeper.inspector.manager.ZooInspectorManager; + +/** + * The parent {@link JPanel} for the whole application + */ +public class ZooInspectorPanel extends JPanel implements + NodeViewersChangeListener { + private final JButton refreshButton; + private final JButton disconnectButton; + private final JButton connectButton; + private final ZooInspectorNodeViewersPanel nodeViewersPanel; + private final ZooInspectorTreeViewer treeViewer; + private final ZooInspectorManager zooInspectorManager; + private final JButton addNodeButton; + private final JButton deleteNodeButton; + private final JButton nodeViewersButton; + private final JButton aboutButton; + private final List listeners = new ArrayList(); + { + listeners.add(this); + } + + /** + * @param zooInspectorManager + * - the {@link ZooInspectorManager} for the application + */ + public ZooInspectorPanel(final ZooInspectorManager zooInspectorManager) { + this.zooInspectorManager = zooInspectorManager; + final ArrayList nodeViewers = new ArrayList(); + try { + List defaultNodeViewersClassNames = this.zooInspectorManager + .getDefaultNodeViewerConfiguration(); + for (String className : defaultNodeViewersClassNames) { + nodeViewers.add((ZooInspectorNodeViewer) Class.forName( + className).newInstance()); + } + } catch (Exception ex) { + LoggerFactory.getLogger().error( + "Error loading default node viewers.", ex); + JOptionPane.showMessageDialog(ZooInspectorPanel.this, + "Error loading default node viewers: " + ex.getMessage(), + "Error", JOptionPane.ERROR_MESSAGE); + } + nodeViewersPanel = new ZooInspectorNodeViewersPanel( + zooInspectorManager, nodeViewers); + treeViewer = new ZooInspectorTreeViewer(zooInspectorManager, + nodeViewersPanel); + this.setLayout(new BorderLayout()); + JToolBar toolbar = new JToolBar(); + toolbar.setFloatable(false); + connectButton = new JButton(ZooInspectorIconResources.getConnectIcon()); + disconnectButton = new JButton(ZooInspectorIconResources + .getDisconnectIcon()); + refreshButton = new JButton(ZooInspectorIconResources.getRefreshIcon()); + addNodeButton = new JButton(ZooInspectorIconResources.getAddNodeIcon()); + deleteNodeButton = new JButton(ZooInspectorIconResources + .getDeleteNodeIcon()); + nodeViewersButton = new JButton(ZooInspectorIconResources + .getChangeNodeViewersIcon()); + aboutButton = new JButton(ZooInspectorIconResources + .getInformationIcon()); + toolbar.add(connectButton); + toolbar.add(disconnectButton); + toolbar.add(refreshButton); + toolbar.add(addNodeButton); + toolbar.add(deleteNodeButton); + toolbar.add(nodeViewersButton); + toolbar.add(aboutButton); + aboutButton.setEnabled(true); + connectButton.setEnabled(true); + disconnectButton.setEnabled(false); + refreshButton.setEnabled(false); + addNodeButton.setEnabled(false); + deleteNodeButton.setEnabled(false); + nodeViewersButton.setEnabled(true); + nodeViewersButton.setToolTipText("Change Node Viewers"); + aboutButton.setToolTipText("About ZooInspector"); + connectButton.setToolTipText("Connect"); + disconnectButton.setToolTipText("Disconnect"); + refreshButton.setToolTipText("Refresh"); + addNodeButton.setToolTipText("Add Node"); + deleteNodeButton.setToolTipText("Delete Node"); + connectButton.addActionListener(new ActionListener() { + public void actionPerformed(ActionEvent e) { + ZooInspectorConnectionPropertiesDialog zicpd = new ZooInspectorConnectionPropertiesDialog( + zooInspectorManager.getLastConnectionProps(), + zooInspectorManager.getConnectionPropertiesTemplate(), + ZooInspectorPanel.this); + zicpd.setVisible(true); + } + }); + disconnectButton.addActionListener(new ActionListener() { + public void actionPerformed(ActionEvent e) { + disconnect(); + } + }); + refreshButton.addActionListener(new ActionListener() { + public void actionPerformed(ActionEvent e) { + treeViewer.refreshView(); + } + }); + addNodeButton.addActionListener(new ActionListener() { + public void actionPerformed(ActionEvent e) { + final List selectedNodes = treeViewer + .getSelectedNodes(); + if (selectedNodes.size() == 1) { + final String nodeName = JOptionPane.showInputDialog( + ZooInspectorPanel.this, + "Please Enter a name for the new node", + "Create Node", JOptionPane.INFORMATION_MESSAGE); + if (nodeName != null && nodeName.length() > 0) { + SwingWorker worker = new SwingWorker() { + + @Override + protected Boolean doInBackground() throws Exception { + return ZooInspectorPanel.this.zooInspectorManager + .createNode(selectedNodes.get(0), + nodeName); + } + + @Override + protected void done() { + treeViewer.refreshView(); + } + }; + worker.execute(); + } + } else { + JOptionPane.showMessageDialog(ZooInspectorPanel.this, + "Please select 1 parent node for the new node."); + } + } + }); + deleteNodeButton.addActionListener(new ActionListener() { + public void actionPerformed(ActionEvent e) { + final List selectedNodes = treeViewer + .getSelectedNodes(); + if (selectedNodes.size() == 0) { + JOptionPane.showMessageDialog(ZooInspectorPanel.this, + "Please select at least 1 node to be deleted"); + } else { + int answer = JOptionPane.showConfirmDialog( + ZooInspectorPanel.this, + "Are you sure you want to delete the selected nodes?" + + "(This action cannot be reverted)", + "Confirm Delete", JOptionPane.YES_NO_OPTION, + JOptionPane.WARNING_MESSAGE); + if (answer == JOptionPane.YES_OPTION) { + SwingWorker worker = new SwingWorker() { + + @Override + protected Boolean doInBackground() throws Exception { + for (String nodePath : selectedNodes) { + ZooInspectorPanel.this.zooInspectorManager + .deleteNode(nodePath); + } + return true; + } + + @Override + protected void done() { + treeViewer.refreshView(); + } + }; + worker.execute(); + } + } + } + }); + nodeViewersButton.addActionListener(new ActionListener() { + + public void actionPerformed(ActionEvent e) { + ZooInspectorNodeViewersDialog nvd = new ZooInspectorNodeViewersDialog( + JOptionPane.getRootFrame(), nodeViewers, listeners, + zooInspectorManager); + nvd.setVisible(true); + } + }); + aboutButton.addActionListener(new ActionListener() { + public void actionPerformed(ActionEvent e) { + ZooInspectorAboutDialog zicpd = new ZooInspectorAboutDialog( + JOptionPane.getRootFrame()); + zicpd.setVisible(true); + } + }); + JScrollPane treeScroller = new JScrollPane(treeViewer); + JSplitPane splitPane = new JSplitPane(JSplitPane.HORIZONTAL_SPLIT, + treeScroller, nodeViewersPanel); + splitPane.setResizeWeight(0.25); + this.add(splitPane, BorderLayout.CENTER); + this.add(toolbar, BorderLayout.NORTH); + } + + /** + * @param connectionProps + * the {@link Properties} for connecting to the zookeeper + * instance + */ + public void connect(final Properties connectionProps) { + SwingWorker worker = new SwingWorker() { + + @Override + protected Boolean doInBackground() throws Exception { + zooInspectorManager.setLastConnectionProps(connectionProps); + return zooInspectorManager.connect(connectionProps); + } + + @Override + protected void done() { + try { + if (get()) { + treeViewer.refreshView(); + connectButton.setEnabled(false); + disconnectButton.setEnabled(true); + refreshButton.setEnabled(true); + addNodeButton.setEnabled(true); + deleteNodeButton.setEnabled(true); + } else { + JOptionPane.showMessageDialog(ZooInspectorPanel.this, + "Unable to connect to zookeeper", "Error", + JOptionPane.ERROR_MESSAGE); + } + } catch (InterruptedException e) { + LoggerFactory + .getLogger() + .error( + "Error occurred while connecting to ZooKeeper server", + e); + } catch (ExecutionException e) { + LoggerFactory + .getLogger() + .error( + "Error occurred while connecting to ZooKeeper server", + e); + } + } + + }; + worker.execute(); + } + + /** + * + */ + public void disconnect() { + disconnect(false); + } + + /** + * @param wait + * - set this to true if the method should only return once the + * application has successfully disconnected + */ + public void disconnect(boolean wait) { + SwingWorker worker = new SwingWorker() { + + @Override + protected Boolean doInBackground() throws Exception { + return ZooInspectorPanel.this.zooInspectorManager.disconnect(); + } + + @Override + protected void done() { + try { + if (get()) { + treeViewer.clearView(); + connectButton.setEnabled(true); + disconnectButton.setEnabled(false); + refreshButton.setEnabled(false); + addNodeButton.setEnabled(false); + deleteNodeButton.setEnabled(false); + } + } catch (InterruptedException e) { + LoggerFactory + .getLogger() + .error( + "Error occurred while disconnecting from ZooKeeper server", + e); + } catch (ExecutionException e) { + LoggerFactory + .getLogger() + .error( + "Error occurred while disconnecting from ZooKeeper server", + e); + } + } + + }; + worker.execute(); + if (wait) { + while (!worker.isDone()) { + try { + Thread.sleep(100); + } catch (InterruptedException e) { + LoggerFactory + .getLogger() + .error( + "Error occurred while disconnecting from ZooKeeper server", + e); + } + } + } + } + + /* + * (non-Javadoc) + * + * @seeorg.apache.zookeeper.inspector.gui.NodeViewersChangeListener# + * nodeViewersChanged(java.util.List) + */ + public void nodeViewersChanged(List newViewers) { + this.nodeViewersPanel.setNodeViewers(newViewers); + } + + /** + * @param connectionProps + * @throws IOException + */ + public void setdefaultConnectionProps(Properties connectionProps) + throws IOException { + this.zooInspectorManager.saveDefaultConnectionFile(connectionProps); + } +} diff --git a/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/ZooInspectorTreeViewer.java b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/ZooInspectorTreeViewer.java new file mode 100644 index 0000000..128b358 --- /dev/null +++ b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/ZooInspectorTreeViewer.java @@ -0,0 +1,362 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.inspector.gui; + +import java.awt.BorderLayout; +import java.awt.Color; +import java.awt.event.ActionEvent; +import java.awt.event.ActionListener; +import java.awt.event.MouseAdapter; +import java.awt.event.MouseEvent; +import java.util.ArrayList; +import java.util.Collections; +import java.util.Enumeration; +import java.util.LinkedHashSet; +import java.util.List; +import java.util.Map; +import java.util.Set; + +import javax.swing.JMenuItem; +import javax.swing.JPanel; +import javax.swing.JPopupMenu; +import javax.swing.JTree; +import javax.swing.SwingWorker; +import javax.swing.event.TreeSelectionListener; +import javax.swing.tree.DefaultMutableTreeNode; +import javax.swing.tree.DefaultTreeCellRenderer; +import javax.swing.tree.DefaultTreeModel; +import javax.swing.tree.TreeNode; +import javax.swing.tree.TreePath; + +import org.apache.zookeeper.inspector.manager.NodeListener; +import org.apache.zookeeper.inspector.manager.ZooInspectorManager; + +import com.nitido.utils.toaster.Toaster; + +/** + * A {@link JPanel} for showing the tree view of all the nodes in the zookeeper + * instance + */ +public class ZooInspectorTreeViewer extends JPanel implements NodeListener { + private final ZooInspectorManager zooInspectorManager; + private final JTree tree; + private final Toaster toasterManager; + + /** + * @param zooInspectorManager + * - the {@link ZooInspectorManager} for the application + * @param listener + * - the {@link TreeSelectionListener} to listen for changes in + * the selected node on the node tree + */ + public ZooInspectorTreeViewer( + final ZooInspectorManager zooInspectorManager, + TreeSelectionListener listener) { + this.zooInspectorManager = zooInspectorManager; + this.setLayout(new BorderLayout()); + final JPopupMenu popupMenu = new JPopupMenu(); + final JMenuItem addNotify = new JMenuItem("Add Change Notification"); + this.toasterManager = new Toaster(); + this.toasterManager.setBorderColor(Color.BLACK); + this.toasterManager.setMessageColor(Color.BLACK); + this.toasterManager.setToasterColor(Color.WHITE); + addNotify.addActionListener(new ActionListener() { + public void actionPerformed(ActionEvent e) { + List selectedNodes = getSelectedNodes(); + zooInspectorManager.addWatchers(selectedNodes, + ZooInspectorTreeViewer.this); + } + }); + final JMenuItem removeNotify = new JMenuItem( + "Remove Change Notification"); + removeNotify.addActionListener(new ActionListener() { + public void actionPerformed(ActionEvent e) { + List selectedNodes = getSelectedNodes(); + zooInspectorManager.removeWatchers(selectedNodes); + } + }); + tree = new JTree(new DefaultMutableTreeNode()); + tree.setCellRenderer(new ZooInspectorTreeCellRenderer()); + tree.setEditable(false); + tree.getSelectionModel().addTreeSelectionListener(listener); + tree.addMouseListener(new MouseAdapter() { + @Override + public void mouseClicked(MouseEvent e) { + if (e.isPopupTrigger() || e.getButton() == MouseEvent.BUTTON3) { + // TODO only show add if a selected node isn't being + // watched, and only show remove if a selected node is being + // watched + popupMenu.removeAll(); + popupMenu.add(addNotify); + popupMenu.add(removeNotify); + popupMenu.show(ZooInspectorTreeViewer.this, e.getX(), e + .getY()); + } + } + }); + this.add(tree, BorderLayout.CENTER); + } + + /** + * Refresh the tree view + */ + public void refreshView() { + final Set expandedNodes = new LinkedHashSet(); + int rowCount = tree.getRowCount(); + for (int i = 0; i < rowCount; i++) { + TreePath path = tree.getPathForRow(i); + if (tree.isExpanded(path)) { + expandedNodes.add(path); + } + } + final TreePath[] selectedNodes = tree.getSelectionPaths(); + SwingWorker worker = new SwingWorker() { + + @Override + protected Boolean doInBackground() throws Exception { + tree.setModel(new DefaultTreeModel(new ZooInspectorTreeNode( + "/", null))); + return true; + } + + @Override + protected void done() { + for (TreePath path : expandedNodes) { + tree.expandPath(path); + } + tree.getSelectionModel().setSelectionPaths(selectedNodes); + } + }; + worker.execute(); + } + + /** + * clear the tree view of all nodes + */ + public void clearView() { + tree.setModel(new DefaultTreeModel(new DefaultMutableTreeNode())); + } + + /** + * @author Colin + * + */ + private static class ZooInspectorTreeCellRenderer extends + DefaultTreeCellRenderer { + public ZooInspectorTreeCellRenderer() { + setLeafIcon(ZooInspectorIconResources.getTreeLeafIcon()); + setOpenIcon(ZooInspectorIconResources.getTreeOpenIcon()); + setClosedIcon(ZooInspectorIconResources.getTreeClosedIcon()); + } + } + + /** + * @author Colin + * + */ + private class ZooInspectorTreeNode implements TreeNode { + private final String nodePath; + private final String nodeName; + private final ZooInspectorTreeNode parent; + + public ZooInspectorTreeNode(String nodePath, ZooInspectorTreeNode parent) { + this.parent = parent; + this.nodePath = nodePath; + int index = nodePath.lastIndexOf("/"); + if (index == -1) { + throw new IllegalArgumentException("Invalid node path" + + nodePath); + } + this.nodeName = nodePath.substring(index + 1); + } + + /* + * (non-Javadoc) + * + * @see javax.swing.tree.TreeNode#children() + */ + public Enumeration children() { + List children = zooInspectorManager + .getChildren(this.nodePath); + Collections.sort(children); + List returnChildren = new ArrayList(); + for (String child : children) { + returnChildren.add(new ZooInspectorTreeNode((this.nodePath + .equals("/") ? "" : this.nodePath) + + "/" + child, this)); + } + return Collections.enumeration(returnChildren); + } + + /* + * (non-Javadoc) + * + * @see javax.swing.tree.TreeNode#getAllowsChildren() + */ + public boolean getAllowsChildren() { + return zooInspectorManager.isAllowsChildren(this.nodePath); + } + + /* + * (non-Javadoc) + * + * @see javax.swing.tree.TreeNode#getChildAt(int) + */ + public TreeNode getChildAt(int childIndex) { + String child = zooInspectorManager.getNodeChild(this.nodePath, + childIndex); + if (child != null) { + return new ZooInspectorTreeNode((this.nodePath.equals("/") ? "" + : this.nodePath) + + "/" + child, this); + } + return null; + } + + /* + * (non-Javadoc) + * + * @see javax.swing.tree.TreeNode#getChildCount() + */ + public int getChildCount() { + return zooInspectorManager.getNumChildren(this.nodePath); + } + + /* + * (non-Javadoc) + * + * @see javax.swing.tree.TreeNode#getIndex(javax.swing.tree.TreeNode) + */ + public int getIndex(TreeNode node) { + return zooInspectorManager.getNodeIndex(this.nodePath); + } + + /* + * (non-Javadoc) + * + * @see javax.swing.tree.TreeNode#getParent() + */ + public TreeNode getParent() { + return this.parent; + } + + /* + * (non-Javadoc) + * + * @see javax.swing.tree.TreeNode#isLeaf() + */ + public boolean isLeaf() { + return !zooInspectorManager.hasChildren(this.nodePath); + } + + @Override + public String toString() { + return this.nodeName; + } + + @Override + public int hashCode() { + final int prime = 31; + int result = 1; + result = prime * result + getOuterType().hashCode(); + result = prime * result + + ((nodePath == null) ? 0 : nodePath.hashCode()); + result = prime * result + + ((parent == null) ? 0 : parent.hashCode()); + return result; + } + + @Override + public boolean equals(Object obj) { + if (this == obj) + return true; + if (obj == null) + return false; + if (getClass() != obj.getClass()) + return false; + ZooInspectorTreeNode other = (ZooInspectorTreeNode) obj; + if (!getOuterType().equals(other.getOuterType())) + return false; + if (nodePath == null) { + if (other.nodePath != null) + return false; + } else if (!nodePath.equals(other.nodePath)) + return false; + if (parent == null) { + if (other.parent != null) + return false; + } else if (!parent.equals(other.parent)) + return false; + return true; + } + + private ZooInspectorTreeViewer getOuterType() { + return ZooInspectorTreeViewer.this; + } + + } + + /** + * @return {@link List} of the currently selected nodes + */ + public List getSelectedNodes() { + TreePath[] paths = tree.getSelectionPaths(); + List selectedNodes = new ArrayList(); + if (paths != null) { + for (TreePath path : paths) { + StringBuilder sb = new StringBuilder(); + Object[] pathArray = path.getPath(); + for (Object o : pathArray) { + String nodeName = o.toString(); + if (nodeName.length() > 0) { + sb.append("/"); + sb.append(o.toString()); + } + } + selectedNodes.add(sb.toString()); + } + } + return selectedNodes; + } + + /* + * (non-Javadoc) + * + * @see + * org.apache.zookeeper.inspector.manager.NodeListener#processEvent(java + * .lang.String, java.lang.String, java.util.Map) + */ + public void processEvent(String nodePath, String eventType, + Map eventInfo) { + StringBuilder sb = new StringBuilder(); + sb.append("Node: "); + sb.append(nodePath); + sb.append("\nEvent: "); + sb.append(eventType); + if (eventInfo != null) { + for (Map.Entry entry : eventInfo.entrySet()) { + sb.append("\n"); + sb.append(entry.getKey()); + sb.append(": "); + sb.append(entry.getValue()); + } + } + this.toasterManager.showToaster(ZooInspectorIconResources + .getInformationIcon(), sb.toString()); + } +} diff --git a/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/about.html b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/about.html new file mode 100644 index 0000000..17fb3dc --- /dev/null +++ b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/about.html @@ -0,0 +1,21 @@ + + + + +ZooInspector v0.1 + + +

    ZooInspector was developed by Colin Goodheart-Smithe and is +available under the Apache Software Licence v2.0.

    +     +

    ZooKeeper is available from http://zookeeper.apache.org/ +and is licensed under an Apache Software Licence v2.0

    +

    The ApacheSoftware Licence v2.0 can be found at http://www.apache.org/licenses/LICENSE-2.0

    + + diff --git a/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/nodeviewer/NodeViewerACL.java b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/nodeviewer/NodeViewerACL.java new file mode 100644 index 0000000..5ac203c --- /dev/null +++ b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/nodeviewer/NodeViewerACL.java @@ -0,0 +1,187 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.inspector.gui.nodeviewer; + +import java.awt.BorderLayout; +import java.awt.Color; +import java.awt.GridBagConstraints; +import java.awt.GridBagLayout; +import java.awt.Insets; +import java.util.ArrayList; +import java.util.List; +import java.util.Map; +import java.util.concurrent.ExecutionException; + +import javax.swing.BorderFactory; +import javax.swing.JLabel; +import javax.swing.JPanel; +import javax.swing.JScrollPane; +import javax.swing.JTextField; +import javax.swing.SwingWorker; + +import org.apache.zookeeper.inspector.logger.LoggerFactory; +import org.apache.zookeeper.inspector.manager.ZooInspectorNodeManager; + +/** + * A node viewer for displaying the ACLs currently applied to the selected node + */ +public class NodeViewerACL extends ZooInspectorNodeViewer { + private ZooInspectorNodeManager zooInspectorManager; + private final JPanel aclDataPanel; + private String selectedNode; + + /** + * + */ + public NodeViewerACL() { + this.setLayout(new BorderLayout()); + this.aclDataPanel = new JPanel(); + this.aclDataPanel.setBackground(Color.WHITE); + JScrollPane scroller = new JScrollPane(this.aclDataPanel); + this.add(scroller, BorderLayout.CENTER); + } + + /* + * (non-Javadoc) + * + * @see + * org.apache.zookeeper.inspector.gui.nodeviewer.ZooInspectorNodeViewer# + * getTitle() + */ + @Override + public String getTitle() { + return "Node ACLs"; + } + + /* + * (non-Javadoc) + * + * @see + * org.apache.zookeeper.inspector.gui.nodeviewer.ZooInspectorNodeViewer# + * nodeSelectionChanged(java.util.Set) + */ + @Override + public void nodeSelectionChanged(List selectedNodes) { + this.aclDataPanel.removeAll(); + if (selectedNodes.size() > 0) { + this.selectedNode = selectedNodes.get(0); + SwingWorker>, Void> worker = new SwingWorker>, Void>() { + + @Override + protected List> doInBackground() + throws Exception { + return NodeViewerACL.this.zooInspectorManager + .getACLs(NodeViewerACL.this.selectedNode); + } + + @Override + protected void done() { + List> acls = null; + try { + acls = get(); + } catch (InterruptedException e) { + acls = new ArrayList>(); + LoggerFactory.getLogger().error( + "Error retrieving ACL Information for node: " + + NodeViewerACL.this.selectedNode, e); + } catch (ExecutionException e) { + acls = new ArrayList>(); + LoggerFactory.getLogger().error( + "Error retrieving ACL Information for node: " + + NodeViewerACL.this.selectedNode, e); + } + aclDataPanel.setLayout(new GridBagLayout()); + int j = 0; + for (Map data : acls) { + int rowPos = 2 * j + 1; + JPanel aclPanel = new JPanel(); + aclPanel.setBorder(BorderFactory + .createLineBorder(Color.BLACK)); + aclPanel.setBackground(Color.WHITE); + aclPanel.setLayout(new GridBagLayout()); + int i = 0; + for (Map.Entry entry : data.entrySet()) { + int rowPosACL = 2 * i + 1; + JLabel label = new JLabel(entry.getKey()); + JTextField text = new JTextField(entry.getValue()); + text.setEditable(false); + GridBagConstraints c1 = new GridBagConstraints(); + c1.gridx = 1; + c1.gridy = rowPosACL; + c1.gridwidth = 1; + c1.gridheight = 1; + c1.weightx = 0; + c1.weighty = 0; + c1.anchor = GridBagConstraints.NORTHWEST; + c1.fill = GridBagConstraints.BOTH; + c1.insets = new Insets(5, 5, 5, 5); + c1.ipadx = 0; + c1.ipady = 0; + aclPanel.add(label, c1); + GridBagConstraints c2 = new GridBagConstraints(); + c2.gridx = 3; + c2.gridy = rowPosACL; + c2.gridwidth = 1; + c2.gridheight = 1; + c2.weightx = 0; + c2.weighty = 0; + c2.anchor = GridBagConstraints.NORTHWEST; + c2.fill = GridBagConstraints.BOTH; + c2.insets = new Insets(5, 5, 5, 5); + c2.ipadx = 0; + c2.ipady = 0; + aclPanel.add(text, c2); + i++; + } + GridBagConstraints c = new GridBagConstraints(); + c.gridx = 1; + c.gridy = rowPos; + c.gridwidth = 1; + c.gridheight = 1; + c.weightx = 1; + c.weighty = 1; + c.anchor = GridBagConstraints.NORTHWEST; + c.fill = GridBagConstraints.NONE; + c.insets = new Insets(5, 5, 5, 5); + c.ipadx = 0; + c.ipady = 0; + aclDataPanel.add(aclPanel, c); + } + NodeViewerACL.this.aclDataPanel.revalidate(); + NodeViewerACL.this.aclDataPanel.repaint(); + } + }; + worker.execute(); + } + } + + /* + * (non-Javadoc) + * + * @see + * org.apache.zookeeper.inspector.gui.nodeviewer.ZooInspectorNodeViewer# + * setZooInspectorManager + * (org.apache.zookeeper.inspector.manager.ZooInspectorNodeManager) + */ + @Override + public void setZooInspectorManager( + ZooInspectorNodeManager zooInspectorManager) { + this.zooInspectorManager = zooInspectorManager; + } + +} diff --git a/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/nodeviewer/NodeViewerData.java b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/nodeviewer/NodeViewerData.java new file mode 100644 index 0000000..001cb7b --- /dev/null +++ b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/nodeviewer/NodeViewerData.java @@ -0,0 +1,146 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.inspector.gui.nodeviewer; + +import java.awt.BorderLayout; +import java.awt.event.ActionEvent; +import java.awt.event.ActionListener; +import java.util.List; +import java.util.concurrent.ExecutionException; + +import javax.swing.JButton; +import javax.swing.JOptionPane; +import javax.swing.JScrollPane; +import javax.swing.JTextPane; +import javax.swing.JToolBar; +import javax.swing.SwingWorker; + +import org.apache.zookeeper.inspector.gui.ZooInspectorIconResources; +import org.apache.zookeeper.inspector.logger.LoggerFactory; +import org.apache.zookeeper.inspector.manager.ZooInspectorNodeManager; + +/** + * A node viewer for displaying the data for the currently selected node + */ +public class NodeViewerData extends ZooInspectorNodeViewer { + private ZooInspectorNodeManager zooInspectorManager; + private final JTextPane dataArea; + private final JToolBar toolbar; + private String selectedNode; + + /** + * + */ + public NodeViewerData() { + this.setLayout(new BorderLayout()); + this.dataArea = new JTextPane(); + this.toolbar = new JToolBar(); + this.toolbar.setFloatable(false); + JScrollPane scroller = new JScrollPane(this.dataArea); + scroller + .setHorizontalScrollBarPolicy(JScrollPane.HORIZONTAL_SCROLLBAR_NEVER); + this.add(scroller, BorderLayout.CENTER); + this.add(this.toolbar, BorderLayout.NORTH); + JButton saveButton = new JButton(ZooInspectorIconResources + .getSaveIcon()); + saveButton.addActionListener(new ActionListener() { + + public void actionPerformed(ActionEvent e) { + if (selectedNode != null) { + if (JOptionPane.showConfirmDialog(NodeViewerData.this, + "Are you sure you want to save this node?" + + " (this action cannot be reverted)", + "Confirm Save", JOptionPane.YES_NO_OPTION, + JOptionPane.WARNING_MESSAGE) == JOptionPane.YES_OPTION) { + zooInspectorManager.setData(selectedNode, dataArea + .getText()); + } + } + } + }); + this.toolbar.add(saveButton); + + } + + /* + * (non-Javadoc) + * + * @see + * org.apache.zookeeper.inspector.gui.nodeviewer.ZooInspectorNodeViewer# + * getTitle() + */ + @Override + public String getTitle() { + return "Node Data"; + } + + /* + * (non-Javadoc) + * + * @see + * org.apache.zookeeper.inspector.gui.nodeviewer.ZooInspectorNodeViewer# + * nodeSelectionChanged(java.util.Set) + */ + @Override + public void nodeSelectionChanged(List selectedNodes) { + if (selectedNodes.size() > 0) { + this.selectedNode = selectedNodes.get(0); + SwingWorker worker = new SwingWorker() { + + @Override + protected String doInBackground() throws Exception { + return NodeViewerData.this.zooInspectorManager + .getData(NodeViewerData.this.selectedNode); + } + + @Override + protected void done() { + String data = ""; + try { + data = get(); + } catch (InterruptedException e) { + LoggerFactory.getLogger().error( + "Error retrieving data for node: " + + NodeViewerData.this.selectedNode, e); + } catch (ExecutionException e) { + LoggerFactory.getLogger().error( + "Error retrieving data for node: " + + NodeViewerData.this.selectedNode, e); + } + NodeViewerData.this.dataArea.setText(data); + } + }; + worker.execute(); + } + } + + /* + * (non-Javadoc) + * + * @see + * org.apache.zookeeper.inspector.gui.nodeviewer.ZooInspectorNodeViewer# + * setZooInspectorManager + * (org.apache.zookeeper.inspector.manager.ZooInspectorNodeManager) + */ + @Override + public void setZooInspectorManager( + ZooInspectorNodeManager zooInspectorManager) { + this.zooInspectorManager = zooInspectorManager; + } + +} diff --git a/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/nodeviewer/NodeViewerMetaData.java b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/nodeviewer/NodeViewerMetaData.java new file mode 100644 index 0000000..5c2df8d --- /dev/null +++ b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/nodeviewer/NodeViewerMetaData.java @@ -0,0 +1,186 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.inspector.gui.nodeviewer; + +import java.awt.BorderLayout; +import java.awt.Color; +import java.awt.GridBagConstraints; +import java.awt.GridBagLayout; +import java.awt.Insets; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.concurrent.ExecutionException; + +import javax.swing.JLabel; +import javax.swing.JPanel; +import javax.swing.JScrollPane; +import javax.swing.JTextField; +import javax.swing.SwingWorker; + +import org.apache.zookeeper.data.Stat; +import org.apache.zookeeper.inspector.logger.LoggerFactory; +import org.apache.zookeeper.inspector.manager.ZooInspectorNodeManager; + +/** + * A node viewer for displaying the meta data for the currently selected node. + * The meta data is essentially the information from the {@link Stat} for the + * node + */ +public class NodeViewerMetaData extends ZooInspectorNodeViewer { + private ZooInspectorNodeManager zooInspectorManager; + private final JPanel metaDataPanel; + private String selectedNode; + + /** + * + */ + public NodeViewerMetaData() { + this.setLayout(new BorderLayout()); + this.metaDataPanel = new JPanel(); + this.metaDataPanel.setBackground(Color.WHITE); + JScrollPane scroller = new JScrollPane(this.metaDataPanel); + this.add(scroller, BorderLayout.CENTER); + } + + /* + * (non-Javadoc) + * + * @see + * org.apache.zookeeper.inspector.gui.nodeviewer.ZooInspectorNodeViewer# + * getTitle() + */ + @Override + public String getTitle() { + return "Node Metadata"; + } + + /* + * (non-Javadoc) + * + * @see + * org.apache.zookeeper.inspector.gui.nodeviewer.ZooInspectorNodeViewer# + * nodeSelectionChanged(java.util.Set) + */ + @Override + public void nodeSelectionChanged(List selectedNodes) { + this.metaDataPanel.removeAll(); + if (selectedNodes.size() > 0) { + this.selectedNode = selectedNodes.get(0); + SwingWorker, Void> worker = new SwingWorker, Void>() { + + @Override + protected Map doInBackground() throws Exception { + return NodeViewerMetaData.this.zooInspectorManager + .getNodeMeta(NodeViewerMetaData.this.selectedNode); + } + + @Override + protected void done() { + Map data = null; + try { + data = get(); + } catch (InterruptedException e) { + data = new HashMap(); + LoggerFactory.getLogger().error( + "Error retrieving meta data for node: " + + NodeViewerMetaData.this.selectedNode, + e); + } catch (ExecutionException e) { + data = new HashMap(); + LoggerFactory.getLogger().error( + "Error retrieving meta data for node: " + + NodeViewerMetaData.this.selectedNode, + e); + } + NodeViewerMetaData.this.metaDataPanel + .setLayout(new GridBagLayout()); + JPanel infoPanel = new JPanel(); + infoPanel.setBackground(Color.WHITE); + infoPanel.setLayout(new GridBagLayout()); + int i = 0; + int rowPos = 0; + for (Map.Entry entry : data.entrySet()) { + rowPos = 2 * i + 1; + JLabel label = new JLabel(entry.getKey()); + JTextField text = new JTextField(entry.getValue()); + text.setEditable(false); + GridBagConstraints c1 = new GridBagConstraints(); + c1.gridx = 0; + c1.gridy = rowPos; + c1.gridwidth = 1; + c1.gridheight = 1; + c1.weightx = 0; + c1.weighty = 0; + c1.anchor = GridBagConstraints.WEST; + c1.fill = GridBagConstraints.HORIZONTAL; + c1.insets = new Insets(5, 5, 5, 5); + c1.ipadx = 0; + c1.ipady = 0; + infoPanel.add(label, c1); + GridBagConstraints c2 = new GridBagConstraints(); + c2.gridx = 2; + c2.gridy = rowPos; + c2.gridwidth = 1; + c2.gridheight = 1; + c2.weightx = 0; + c2.weighty = 0; + c2.anchor = GridBagConstraints.WEST; + c2.fill = GridBagConstraints.HORIZONTAL; + c2.insets = new Insets(5, 5, 5, 5); + c2.ipadx = 0; + c2.ipady = 0; + infoPanel.add(text, c2); + i++; + } + GridBagConstraints c = new GridBagConstraints(); + c.gridx = 1; + c.gridy = rowPos; + c.gridwidth = 1; + c.gridheight = 1; + c.weightx = 1; + c.weighty = 1; + c.anchor = GridBagConstraints.NORTHWEST; + c.fill = GridBagConstraints.NONE; + c.insets = new Insets(5, 5, 5, 5); + c.ipadx = 0; + c.ipady = 0; + NodeViewerMetaData.this.metaDataPanel.add(infoPanel, c); + NodeViewerMetaData.this.metaDataPanel.revalidate(); + NodeViewerMetaData.this.metaDataPanel.repaint(); + } + }; + worker.execute(); + } + } + + /* + * (non-Javadoc) + * + * @see + * org.apache.zookeeper.inspector.gui.nodeviewer.ZooInspectorNodeViewer# + * setZooInspectorManager + * (org.apache.zookeeper.inspector.manager.ZooInspectorNodeManager) + */ + @Override + public void setZooInspectorManager( + ZooInspectorNodeManager zooInspectorManager) { + this.zooInspectorManager = zooInspectorManager; + } + +} diff --git a/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/nodeviewer/ZooInspectorNodeViewer.java b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/nodeviewer/ZooInspectorNodeViewer.java new file mode 100644 index 0000000..32119a8 --- /dev/null +++ b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/gui/nodeviewer/ZooInspectorNodeViewer.java @@ -0,0 +1,138 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.inspector.gui.nodeviewer; + +import java.awt.datatransfer.DataFlavor; +import java.awt.datatransfer.Transferable; +import java.awt.datatransfer.UnsupportedFlavorException; +import java.io.IOException; +import java.util.List; + +import javax.swing.JPanel; + +import org.apache.zookeeper.inspector.manager.ZooInspectorNodeManager; + +/** + * A {@link JPanel} for displaying information about the currently selected + * node(s) + */ +public abstract class ZooInspectorNodeViewer extends JPanel implements + Transferable { + /** + * The {@link DataFlavor} used for DnD in the node viewer configuration + * dialog + */ + public static final DataFlavor nodeViewerDataFlavor = new DataFlavor( + ZooInspectorNodeViewer.class, "nodeviewer"); + + /** + * @param zooInspectorManager + */ + public abstract void setZooInspectorManager( + ZooInspectorNodeManager zooInspectorManager); + + /** + * Called whenever the selected nodes in the tree view changes. + * + * @param selectedNodes + * - the nodes currently selected in the tree view + * + */ + public abstract void nodeSelectionChanged(List selectedNodes); + + /** + * @return the title of the node viewer. this will be shown on the tab for + * this node viewer. + */ + public abstract String getTitle(); + + /* + * (non-Javadoc) + * + * @see + * java.awt.datatransfer.Transferable#getTransferData(java.awt.datatransfer + * .DataFlavor) + */ + public Object getTransferData(DataFlavor flavor) + throws UnsupportedFlavorException, IOException { + if (flavor.equals(nodeViewerDataFlavor)) { + return this.getClass().getCanonicalName(); + } else { + return null; + } + } + + /* + * (non-Javadoc) + * + * @see java.awt.datatransfer.Transferable#getTransferDataFlavors() + */ + public DataFlavor[] getTransferDataFlavors() { + return new DataFlavor[] { nodeViewerDataFlavor }; + } + + /* + * (non-Javadoc) + * + * @seejava.awt.datatransfer.Transferable#isDataFlavorSupported(java.awt. + * datatransfer.DataFlavor) + */ + public boolean isDataFlavorSupported(DataFlavor flavor) { + return flavor.equals(nodeViewerDataFlavor); + } + + /* + * (non-Javadoc) + * + * @see java.lang.Object#hashCode() + */ + @Override + public int hashCode() { + final int prime = 31; + int result = 1; + result = prime * result + + ((getTitle() == null) ? 0 : getTitle().hashCode()); + return result; + } + + /* + * (non-Javadoc) + * + * @see java.lang.Object#equals(java.lang.Object) + */ + @Override + public boolean equals(Object obj) { + if (this == obj) + return true; + if (obj == null) + return false; + if (getClass() != obj.getClass()) + return false; + ZooInspectorNodeViewer other = (ZooInspectorNodeViewer) obj; + if (getClass().getCanonicalName() != other.getClass() + .getCanonicalName()) { + return false; + } + if (getTitle() == null) { + if (other.getTitle() != null) + return false; + } else if (!getTitle().equals(other.getTitle())) + return false; + return true; + } +} diff --git a/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/logger/LoggerFactory.java b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/logger/LoggerFactory.java new file mode 100644 index 0000000..e4fae41 --- /dev/null +++ b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/logger/LoggerFactory.java @@ -0,0 +1,36 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.inspector.logger; + +/** + * Provides a {@link Logger} for use across the entire application + * + */ +public class LoggerFactory +{ + private static final org.slf4j.Logger logger = org.slf4j.LoggerFactory.getLogger("org.apache.zookeeper.inspector"); //$NON-NLS-1$ + + /** + * @return {@link Logger} for ZooInspector + */ + public static org.slf4j.Logger getLogger() + { + return logger; + } + +} diff --git a/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/manager/NodeListener.java b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/manager/NodeListener.java new file mode 100644 index 0000000..fe55a45 --- /dev/null +++ b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/manager/NodeListener.java @@ -0,0 +1,37 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.inspector.manager; + +import java.util.Map; + +/** + * A Listener for Events on zookeeper nodes + */ +public interface NodeListener { + /** + * @param nodePath + * - the path of the node + * @param eventType + * - the event type + * @param eventInfo + * - a {@link Map} containing any other information about this + * event + */ + public void processEvent(String nodePath, String eventType, + Map eventInfo); +} diff --git a/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/manager/Pair.java b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/manager/Pair.java new file mode 100644 index 0000000..b72950c --- /dev/null +++ b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/manager/Pair.java @@ -0,0 +1,120 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.inspector.manager; + +/** + * A utility class for storing a pair of objects + * + * @param + * @param + */ +public class Pair { + private K key; + private V value; + + /** + * @param key + * @param value + */ + public Pair(K key, V value) { + this.key = key; + this.value = value; + } + + /** + * + */ + public Pair() { + // Do Nothing + } + + /** + * @return key + */ + public K getKey() { + return key; + } + + /** + * @param key + */ + public void setKey(K key) { + this.key = key; + } + + /** + * @return value + */ + public V getValue() { + return value; + } + + /** + * @param value + */ + public void setValue(V value) { + this.value = value; + } + + @Override + public String toString() { + return "Pair [" + key + ", " + value + "]"; + } + + /* + * (non-Javadoc) + * + * @see java.lang.Object#hashCode() + */ + @Override + public int hashCode() { + final int prime = 31; + int result = 1; + result = prime * result + ((key == null) ? 0 : key.hashCode()); + result = prime * result + ((value == null) ? 0 : value.hashCode()); + return result; + } + + /* + * (non-Javadoc) + * + * @see java.lang.Object#equals(java.lang.Object) + */ + @Override + public boolean equals(Object obj) { + if (this == obj) + return true; + if (obj == null) + return false; + if (getClass() != obj.getClass()) + return false; + Pair other = (Pair) obj; + if (key == null) { + if (other.key != null) + return false; + } else if (!key.equals(other.key)) + return false; + if (value == null) { + if (other.value != null) + return false; + } else if (!value.equals(other.value)) + return false; + return true; + } + +} diff --git a/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/manager/ZooInspectorManager.java b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/manager/ZooInspectorManager.java new file mode 100644 index 0000000..74c3cb2 --- /dev/null +++ b/src/contrib/zooinspector/src/java/org/apache/zookeeper/inspector/manager/ZooInspectorManager.java @@ -0,0 +1,139 @@ +/** + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.zookeeper.inspector.manager; + +import java.io.File; +import java.io.IOException; +import java.util.Collection; +import java.util.List; +import java.util.Map; +import java.util.Properties; + +import javax.swing.JComboBox; +import javax.swing.JTextField; + +/** + * A Manager for all interactions between the application and the Zookeeper + * instance + */ +public interface ZooInspectorManager extends ZooInspectorNodeManager, + ZooInspectorNodeTreeManager { + + /** + * @param connectionProps + * @return true if successfully connected + */ + public boolean connect(Properties connectionProps); + + /** + * @return true if successfully disconnected + */ + public boolean disconnect(); + + /** + * @return a {@link Pair} containing the following: + *

    The Icons used were sourced from the Eclipse project (http://www.eclipse.org) and licensed +under the Eclipse Public Licence v1.0. [http://www.eclipse.org/org/documents/epl-v10.php] +

+ +
+Apache > ZooKeeper > ZooKeeper +
+ +
+ + + + + + + +
+
+  + +
+
+ + + + +
+