├── .gitignore ├── .travis.yml ├── CODE_OF_CONDUCT.md ├── CONTRIBUTING.md ├── LICENSE ├── LICENSE-MPL-RabbitMQ ├── LICENSES.txt ├── Makefile ├── README.md ├── erlang.mk ├── include └── rabbit_jms_topic_exchange.hrl ├── rabbitmq-components.mk ├── src ├── rabbit_jms_topic_exchange.erl └── sjx_evaluator.erl └── test ├── rjms_topic_selector_SUITE.erl ├── rjms_topic_selector_unit_SUITE.erl └── sjx_evaluation_SUITE.erl /.gitignore: -------------------------------------------------------------------------------- 1 | .sw? 2 | .*.sw? 3 | *.beam 4 | /.erlang.mk/ 5 | /cover/ 6 | /deps/ 7 | /doc/ 8 | /ebin/ 9 | /escript/ 10 | /escript.lock 11 | /logs/ 12 | /plugins/ 13 | /plugins.lock 14 | /sbin/ 15 | /sbin.lock 16 | 17 | rabbitmq_jms_topic_exchange.d 18 | -------------------------------------------------------------------------------- /.travis.yml: -------------------------------------------------------------------------------- 1 | # vim:sw=2:et: 2 | 3 | os: linux 4 | dist: xenial 5 | language: elixir 6 | notifications: 7 | email: 8 | recipients: 9 | - alerts@rabbitmq.com 10 | on_success: never 11 | on_failure: always 12 | addons: 13 | apt: 14 | packages: 15 | - awscli 16 | cache: 17 | apt: true 18 | env: 19 | global: 20 | - secure: HPosloBroEdylR0kRia0fSV+9jH36OuO0EBMfX4ztRozQ1h1RjuSjo2eFJ75kNafURXyQgSllWD3OsRuM5kcfMCKUMJivAagNL75ZUdRfFJ+/UsIHAsvZjd/cLlb1O2QeJ+4uKVyTR8Zz9jNRG6A+qW7H8CobaMZZpszWJ8nv/zoyhANt19TrCelThANwcfBHN1n+BthSf+cMZuBbwB4fJ9srNVGfZP5Grm3QNk8xbnRXmnnu9wiezOzyn7WqpF3YIgFI7ZzLsIggZI6RLvtYu4of+qzKQ9qyjQyXxUeHZjYnEizNlNyPFgBrfPMDOmFYP5qQ/PM1B7kO5/DyGlr7htoDgUXHfzTsdjTRoROJ8sf/Ds9upeKMSUoUUY80VdfYIh+NtvQ+3M/E5IeM1Qj1QN67QC2BE1cWebYNtiS1L9YUv60kOksTSjcigQ3RlmKZkUBIVbNxW7W0uPDF2yVNRcXaAqTp7uerwsmgnrgR1jrWwB7ZqXFfN0vziVjGYBOrr6KIol3+feNWmK95LfpO074ZLBoJVCMrZeQD9s8TJv2DBrgCUSvzHc02+B1khRZOzqbF3Oj4ynNIFnERzWZgo04zzu7Mk1yTyYIEVVHZ4nyKWDBvtibw6QQdY/3f41jPBBpRUW1cKcPshBWw028AGNFuhZ4S2PNxWKcxvDS4z8= 21 | - secure: JqQCbqJB5N9YoOfU5tHozpPbMnb9Iib7Q8FfacSvOOfl43QeI5ZWScUcpV+GLXJdfl1k0iAwFHfz4jDwzewItWHeQprq8amaFRvZhKckfA8VHqcW42SPqr1/kS5tONcYdeo6wUlRak4sY2j/W6dqdnW9g2JZERJ6xIquETgp1ezF1brphw3Y6/hfD9ZppPaGXAE59eeUCeAVpZDNlHD9jvlYgu9n1TG/xd1snXjVpT7MND6XG5cyWRogw6Hn+185t5aFfU5Gi/oew9+rwSjasjAHdEW/goeHDRrr9+kCGTb9i+zuEYuL8Jvjk7HJoZR5/QybtHpos2NOe7RpU9xqnYGvMuUcLGj0x/8U/SuYKh9uqdN+KBnoDwuN2ILJn/huKmzTXQHcaPzGvU2fl40pSXo/4DNcaWxNoBMYIo6+sSbJofAkASKkWPJxh88odiSJkiOQxYL/S7odsDUo2/OmnrnzXo7cRv2x7mNMRO5LQpc0e2wN7/rhEoCVnhaKA6eMBC2sNmkO6Dl/JasH1g8uOIH7fHARQbSIBUucV7JQkF1hCuxJZMstL+QiTGcwoWss+c0yvhdk8ivsRQ1ByabvJnfg2eiqmXx3wzcJo7Ajp/Rfk2FSY0oPmzh/5tQhj7Z1WcYvODxTty6+Mog7gMS77Q7I4L8mhnaaOaFxLjnzXqc= 22 | 23 | # $base_rmq_ref is used by rabbitmq-components.mk to select the 24 | # appropriate branch for dependencies. 25 | - base_rmq_ref=master 26 | 27 | elixir: 28 | - '1.9' 29 | otp_release: 30 | - '21.3' 31 | - '22.2' 32 | 33 | install: 34 | # This project being an Erlang one (we just set language to Elixir 35 | # to ensure it is installed), we don't want Travis to run mix(1) 36 | # automatically as it will break. 37 | skip 38 | 39 | script: 40 | # $current_rmq_ref is also used by rabbitmq-components.mk to select 41 | # the appropriate branch for dependencies. 42 | - make check-rabbitmq-components.mk 43 | current_rmq_ref="${TRAVIS_PULL_REQUEST_BRANCH:-${TRAVIS_BRANCH}}" 44 | - make xref 45 | current_rmq_ref="${TRAVIS_PULL_REQUEST_BRANCH:-${TRAVIS_BRANCH}}" 46 | - make tests 47 | current_rmq_ref="${TRAVIS_PULL_REQUEST_BRANCH:-${TRAVIS_BRANCH}}" 48 | 49 | after_failure: 50 | - | 51 | cd "$TRAVIS_BUILD_DIR" 52 | if test -d logs && test "$AWS_ACCESS_KEY_ID" && test "$AWS_SECRET_ACCESS_KEY"; then 53 | archive_name="$(basename "$TRAVIS_REPO_SLUG")-$TRAVIS_JOB_NUMBER" 54 | 55 | tar -c --transform "s/^logs/${archive_name}/" -f - logs | \ 56 | xz > "${archive_name}.tar.xz" 57 | 58 | aws s3 cp "${archive_name}.tar.xz" s3://server-release-pipeline/travis-ci-logs/ \ 59 | --region eu-west-1 \ 60 | --acl public-read 61 | fi 62 | -------------------------------------------------------------------------------- /CODE_OF_CONDUCT.md: -------------------------------------------------------------------------------- 1 | # Contributor Code of Conduct 2 | 3 | As contributors and maintainers of this project, and in the interest of fostering an open 4 | and welcoming community, we pledge to respect all people who contribute through reporting 5 | issues, posting feature requests, updating documentation, submitting pull requests or 6 | patches, and other activities. 7 | 8 | We are committed to making participation in this project a harassment-free experience for 9 | everyone, regardless of level of experience, gender, gender identity and expression, 10 | sexual orientation, disability, personal appearance, body size, race, ethnicity, age, 11 | religion, or nationality. 12 | 13 | Examples of unacceptable behavior by participants include: 14 | 15 | * The use of sexualized language or imagery 16 | * Personal attacks 17 | * Trolling or insulting/derogatory comments 18 | * Public or private harassment 19 | * Publishing other's private information, such as physical or electronic addresses, 20 | without explicit permission 21 | * Other unethical or unprofessional conduct 22 | 23 | Project maintainers have the right and responsibility to remove, edit, or reject comments, 24 | commits, code, wiki edits, issues, and other contributions that are not aligned to this 25 | Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors 26 | that they deem inappropriate, threatening, offensive, or harmful. 27 | 28 | By adopting this Code of Conduct, project maintainers commit themselves to fairly and 29 | consistently applying these principles to every aspect of managing this project. Project 30 | maintainers who do not follow or enforce the Code of Conduct may be permanently removed 31 | from the project team. 32 | 33 | This Code of Conduct applies both within project spaces and in public spaces when an 34 | individual is representing the project or its community. 35 | 36 | Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by 37 | contacting a project maintainer at [info@rabbitmq.com](mailto:info@rabbitmq.com). All complaints will 38 | be reviewed and investigated and will result in a response that is deemed necessary and 39 | appropriate to the circumstances. Maintainers are obligated to maintain confidentiality 40 | with regard to the reporter of an incident. 41 | 42 | This Code of Conduct is adapted from the 43 | [Contributor Covenant](https://contributor-covenant.org), version 1.3.0, available at 44 | [contributor-covenant.org/version/1/3/0/](https://contributor-covenant.org/version/1/3/0/) 45 | -------------------------------------------------------------------------------- /CONTRIBUTING.md: -------------------------------------------------------------------------------- 1 | ## Overview 2 | 3 | RabbitMQ projects use pull requests to discuss, collaborate on and accept code contributions. 4 | Pull requests is the primary place of discussing code changes. 5 | 6 | ## How to Contribute 7 | 8 | The process is fairly standard: 9 | 10 | * Fork the repository or repositories you plan on contributing to 11 | * Clone [RabbitMQ umbrella repository](https://github.com/rabbitmq/rabbitmq-public-umbrella) 12 | * `cd umbrella`, `make co` 13 | * Create a branch with a descriptive name in the relevant repositories 14 | * Make your changes, run tests, commit with a [descriptive message](https://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html), push to your fork 15 | * Submit pull requests with an explanation what has been changed and **why** 16 | * Submit a filled out and signed [Contributor Agreement](https://github.com/rabbitmq/ca#how-to-submit) if needed (see below) 17 | * Be patient. We will get to your pull request eventually 18 | 19 | If what you are going to work on is a substantial change, please first ask the core team 20 | of their opinion on [RabbitMQ mailing list](https://groups.google.com/forum/#!forum/rabbitmq-users). 21 | 22 | 23 | ## Code of Conduct 24 | 25 | See [CODE_OF_CONDUCT.md](./CODE_OF_CONDUCT.md). 26 | 27 | 28 | ## Contributor Agreement 29 | 30 | If you want to contribute a non-trivial change, please submit a signed copy of our 31 | [Contributor Agreement](https://github.com/rabbitmq/ca#how-to-submit) around the time 32 | you submit your pull request. This will make it much easier (in some cases, possible) 33 | for the RabbitMQ team at Pivotal to merge your contribution. 34 | 35 | 36 | ## Where to Ask Questions 37 | 38 | If something isn't clear, feel free to ask on our [mailing list](https://groups.google.com/forum/#!forum/rabbitmq-users). 39 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | This package is licensed under the MPL 2.0. For the MPL 2.0, please see LICENSE-MPL-RabbitMQ. 2 | 3 | If you have any questions regarding licensing, please contact us at 4 | info@rabbitmq.com. 5 | -------------------------------------------------------------------------------- /LICENSE-MPL-RabbitMQ: -------------------------------------------------------------------------------- 1 | Mozilla Public License Version 2.0 2 | ================================== 3 | 4 | 1. Definitions 5 | -------------- 6 | 7 | 1.1. "Contributor" 8 | means each individual or legal entity that creates, contributes to 9 | the creation of, or owns Covered Software. 10 | 11 | 1.2. "Contributor Version" 12 | means the combination of the Contributions of others (if any) used 13 | by a Contributor and that particular Contributor's Contribution. 14 | 15 | 1.3. "Contribution" 16 | means Covered Software of a particular Contributor. 17 | 18 | 1.4. "Covered Software" 19 | means Source Code Form to which the initial Contributor has attached 20 | the notice in Exhibit A, the Executable Form of such Source Code 21 | Form, and Modifications of such Source Code Form, in each case 22 | including portions thereof. 23 | 24 | 1.5. "Incompatible With Secondary Licenses" 25 | means 26 | 27 | (a) that the initial Contributor has attached the notice described 28 | in Exhibit B to the Covered Software; or 29 | 30 | (b) that the Covered Software was made available under the terms of 31 | version 1.1 or earlier of the License, but not also under the 32 | terms of a Secondary License. 33 | 34 | 1.6. "Executable Form" 35 | means any form of the work other than Source Code Form. 36 | 37 | 1.7. "Larger Work" 38 | means a work that combines Covered Software with other material, in 39 | a separate file or files, that is not Covered Software. 40 | 41 | 1.8. "License" 42 | means this document. 43 | 44 | 1.9. "Licensable" 45 | means having the right to grant, to the maximum extent possible, 46 | whether at the time of the initial grant or subsequently, any and 47 | all of the rights conveyed by this License. 48 | 49 | 1.10. "Modifications" 50 | means any of the following: 51 | 52 | (a) any file in Source Code Form that results from an addition to, 53 | deletion from, or modification of the contents of Covered 54 | Software; or 55 | 56 | (b) any new file in Source Code Form that contains any Covered 57 | Software. 58 | 59 | 1.11. "Patent Claims" of a Contributor 60 | means any patent claim(s), including without limitation, method, 61 | process, and apparatus claims, in any patent Licensable by such 62 | Contributor that would be infringed, but for the grant of the 63 | License, by the making, using, selling, offering for sale, having 64 | made, import, or transfer of either its Contributions or its 65 | Contributor Version. 66 | 67 | 1.12. "Secondary License" 68 | means either the GNU General Public License, Version 2.0, the GNU 69 | Lesser General Public License, Version 2.1, the GNU Affero General 70 | Public License, Version 3.0, or any later versions of those 71 | licenses. 72 | 73 | 1.13. "Source Code Form" 74 | means the form of the work preferred for making modifications. 75 | 76 | 1.14. "You" (or "Your") 77 | means an individual or a legal entity exercising rights under this 78 | License. For legal entities, "You" includes any entity that 79 | controls, is controlled by, or is under common control with You. For 80 | purposes of this definition, "control" means (a) the power, direct 81 | or indirect, to cause the direction or management of such entity, 82 | whether by contract or otherwise, or (b) ownership of more than 83 | fifty percent (50%) of the outstanding shares or beneficial 84 | ownership of such entity. 85 | 86 | 2. License Grants and Conditions 87 | -------------------------------- 88 | 89 | 2.1. Grants 90 | 91 | Each Contributor hereby grants You a world-wide, royalty-free, 92 | non-exclusive license: 93 | 94 | (a) under intellectual property rights (other than patent or trademark) 95 | Licensable by such Contributor to use, reproduce, make available, 96 | modify, display, perform, distribute, and otherwise exploit its 97 | Contributions, either on an unmodified basis, with Modifications, or 98 | as part of a Larger Work; and 99 | 100 | (b) under Patent Claims of such Contributor to make, use, sell, offer 101 | for sale, have made, import, and otherwise transfer either its 102 | Contributions or its Contributor Version. 103 | 104 | 2.2. Effective Date 105 | 106 | The licenses granted in Section 2.1 with respect to any Contribution 107 | become effective for each Contribution on the date the Contributor first 108 | distributes such Contribution. 109 | 110 | 2.3. Limitations on Grant Scope 111 | 112 | The licenses granted in this Section 2 are the only rights granted under 113 | this License. No additional rights or licenses will be implied from the 114 | distribution or licensing of Covered Software under this License. 115 | Notwithstanding Section 2.1(b) above, no patent license is granted by a 116 | Contributor: 117 | 118 | (a) for any code that a Contributor has removed from Covered Software; 119 | or 120 | 121 | (b) for infringements caused by: (i) Your and any other third party's 122 | modifications of Covered Software, or (ii) the combination of its 123 | Contributions with other software (except as part of its Contributor 124 | Version); or 125 | 126 | (c) under Patent Claims infringed by Covered Software in the absence of 127 | its Contributions. 128 | 129 | This License does not grant any rights in the trademarks, service marks, 130 | or logos of any Contributor (except as may be necessary to comply with 131 | the notice requirements in Section 3.4). 132 | 133 | 2.4. Subsequent Licenses 134 | 135 | No Contributor makes additional grants as a result of Your choice to 136 | distribute the Covered Software under a subsequent version of this 137 | License (see Section 10.2) or under the terms of a Secondary License (if 138 | permitted under the terms of Section 3.3). 139 | 140 | 2.5. Representation 141 | 142 | Each Contributor represents that the Contributor believes its 143 | Contributions are its original creation(s) or it has sufficient rights 144 | to grant the rights to its Contributions conveyed by this License. 145 | 146 | 2.6. Fair Use 147 | 148 | This License is not intended to limit any rights You have under 149 | applicable copyright doctrines of fair use, fair dealing, or other 150 | equivalents. 151 | 152 | 2.7. Conditions 153 | 154 | Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted 155 | in Section 2.1. 156 | 157 | 3. Responsibilities 158 | ------------------- 159 | 160 | 3.1. Distribution of Source Form 161 | 162 | All distribution of Covered Software in Source Code Form, including any 163 | Modifications that You create or to which You contribute, must be under 164 | the terms of this License. You must inform recipients that the Source 165 | Code Form of the Covered Software is governed by the terms of this 166 | License, and how they can obtain a copy of this License. You may not 167 | attempt to alter or restrict the recipients' rights in the Source Code 168 | Form. 169 | 170 | 3.2. Distribution of Executable Form 171 | 172 | If You distribute Covered Software in Executable Form then: 173 | 174 | (a) such Covered Software must also be made available in Source Code 175 | Form, as described in Section 3.1, and You must inform recipients of 176 | the Executable Form how they can obtain a copy of such Source Code 177 | Form by reasonable means in a timely manner, at a charge no more 178 | than the cost of distribution to the recipient; and 179 | 180 | (b) You may distribute such Executable Form under the terms of this 181 | License, or sublicense it under different terms, provided that the 182 | license for the Executable Form does not attempt to limit or alter 183 | the recipients' rights in the Source Code Form under this License. 184 | 185 | 3.3. Distribution of a Larger Work 186 | 187 | You may create and distribute a Larger Work under terms of Your choice, 188 | provided that You also comply with the requirements of this License for 189 | the Covered Software. If the Larger Work is a combination of Covered 190 | Software with a work governed by one or more Secondary Licenses, and the 191 | Covered Software is not Incompatible With Secondary Licenses, this 192 | License permits You to additionally distribute such Covered Software 193 | under the terms of such Secondary License(s), so that the recipient of 194 | the Larger Work may, at their option, further distribute the Covered 195 | Software under the terms of either this License or such Secondary 196 | License(s). 197 | 198 | 3.4. Notices 199 | 200 | You may not remove or alter the substance of any license notices 201 | (including copyright notices, patent notices, disclaimers of warranty, 202 | or limitations of liability) contained within the Source Code Form of 203 | the Covered Software, except that You may alter any license notices to 204 | the extent required to remedy known factual inaccuracies. 205 | 206 | 3.5. Application of Additional Terms 207 | 208 | You may choose to offer, and to charge a fee for, warranty, support, 209 | indemnity or liability obligations to one or more recipients of Covered 210 | Software. However, You may do so only on Your own behalf, and not on 211 | behalf of any Contributor. You must make it absolutely clear that any 212 | such warranty, support, indemnity, or liability obligation is offered by 213 | You alone, and You hereby agree to indemnify every Contributor for any 214 | liability incurred by such Contributor as a result of warranty, support, 215 | indemnity or liability terms You offer. You may include additional 216 | disclaimers of warranty and limitations of liability specific to any 217 | jurisdiction. 218 | 219 | 4. Inability to Comply Due to Statute or Regulation 220 | --------------------------------------------------- 221 | 222 | If it is impossible for You to comply with any of the terms of this 223 | License with respect to some or all of the Covered Software due to 224 | statute, judicial order, or regulation then You must: (a) comply with 225 | the terms of this License to the maximum extent possible; and (b) 226 | describe the limitations and the code they affect. Such description must 227 | be placed in a text file included with all distributions of the Covered 228 | Software under this License. Except to the extent prohibited by statute 229 | or regulation, such description must be sufficiently detailed for a 230 | recipient of ordinary skill to be able to understand it. 231 | 232 | 5. Termination 233 | -------------- 234 | 235 | 5.1. The rights granted under this License will terminate automatically 236 | if You fail to comply with any of its terms. However, if You become 237 | compliant, then the rights granted under this License from a particular 238 | Contributor are reinstated (a) provisionally, unless and until such 239 | Contributor explicitly and finally terminates Your grants, and (b) on an 240 | ongoing basis, if such Contributor fails to notify You of the 241 | non-compliance by some reasonable means prior to 60 days after You have 242 | come back into compliance. Moreover, Your grants from a particular 243 | Contributor are reinstated on an ongoing basis if such Contributor 244 | notifies You of the non-compliance by some reasonable means, this is the 245 | first time You have received notice of non-compliance with this License 246 | from such Contributor, and You become compliant prior to 30 days after 247 | Your receipt of the notice. 248 | 249 | 5.2. If You initiate litigation against any entity by asserting a patent 250 | infringement claim (excluding declaratory judgment actions, 251 | counter-claims, and cross-claims) alleging that a Contributor Version 252 | directly or indirectly infringes any patent, then the rights granted to 253 | You by any and all Contributors for the Covered Software under Section 254 | 2.1 of this License shall terminate. 255 | 256 | 5.3. In the event of termination under Sections 5.1 or 5.2 above, all 257 | end user license agreements (excluding distributors and resellers) which 258 | have been validly granted by You or Your distributors under this License 259 | prior to termination shall survive termination. 260 | 261 | ************************************************************************ 262 | * * 263 | * 6. Disclaimer of Warranty * 264 | * ------------------------- * 265 | * * 266 | * Covered Software is provided under this License on an "as is" * 267 | * basis, without warranty of any kind, either expressed, implied, or * 268 | * statutory, including, without limitation, warranties that the * 269 | * Covered Software is free of defects, merchantable, fit for a * 270 | * particular purpose or non-infringing. The entire risk as to the * 271 | * quality and performance of the Covered Software is with You. * 272 | * Should any Covered Software prove defective in any respect, You * 273 | * (not any Contributor) assume the cost of any necessary servicing, * 274 | * repair, or correction. This disclaimer of warranty constitutes an * 275 | * essential part of this License. No use of any Covered Software is * 276 | * authorized under this License except under this disclaimer. * 277 | * * 278 | ************************************************************************ 279 | 280 | ************************************************************************ 281 | * * 282 | * 7. Limitation of Liability * 283 | * -------------------------- * 284 | * * 285 | * Under no circumstances and under no legal theory, whether tort * 286 | * (including negligence), contract, or otherwise, shall any * 287 | * Contributor, or anyone who distributes Covered Software as * 288 | * permitted above, be liable to You for any direct, indirect, * 289 | * special, incidental, or consequential damages of any character * 290 | * including, without limitation, damages for lost profits, loss of * 291 | * goodwill, work stoppage, computer failure or malfunction, or any * 292 | * and all other commercial damages or losses, even if such party * 293 | * shall have been informed of the possibility of such damages. This * 294 | * limitation of liability shall not apply to liability for death or * 295 | * personal injury resulting from such party's negligence to the * 296 | * extent applicable law prohibits such limitation. Some * 297 | * jurisdictions do not allow the exclusion or limitation of * 298 | * incidental or consequential damages, so this exclusion and * 299 | * limitation may not apply to You. * 300 | * * 301 | ************************************************************************ 302 | 303 | 8. Litigation 304 | ------------- 305 | 306 | Any litigation relating to this License may be brought only in the 307 | courts of a jurisdiction where the defendant maintains its principal 308 | place of business and such litigation shall be governed by laws of that 309 | jurisdiction, without reference to its conflict-of-law provisions. 310 | Nothing in this Section shall prevent a party's ability to bring 311 | cross-claims or counter-claims. 312 | 313 | 9. Miscellaneous 314 | ---------------- 315 | 316 | This License represents the complete agreement concerning the subject 317 | matter hereof. If any provision of this License is held to be 318 | unenforceable, such provision shall be reformed only to the extent 319 | necessary to make it enforceable. Any law or regulation which provides 320 | that the language of a contract shall be construed against the drafter 321 | shall not be used to construe this License against a Contributor. 322 | 323 | 10. Versions of the License 324 | --------------------------- 325 | 326 | 10.1. New Versions 327 | 328 | Mozilla Foundation is the license steward. Except as provided in Section 329 | 10.3, no one other than the license steward has the right to modify or 330 | publish new versions of this License. Each version will be given a 331 | distinguishing version number. 332 | 333 | 10.2. Effect of New Versions 334 | 335 | You may distribute the Covered Software under the terms of the version 336 | of the License under which You originally received the Covered Software, 337 | or under the terms of any subsequent version published by the license 338 | steward. 339 | 340 | 10.3. Modified Versions 341 | 342 | If you create software not governed by this License, and you want to 343 | create a new license for such software, you may create and use a 344 | modified version of this License if you rename the license and remove 345 | any references to the name of the license steward (except to note that 346 | such modified license differs from this License). 347 | 348 | 10.4. Distributing Source Code Form that is Incompatible With Secondary 349 | Licenses 350 | 351 | If You choose to distribute Source Code Form that is Incompatible With 352 | Secondary Licenses under the terms of this version of the License, the 353 | notice described in Exhibit B of this License must be attached. 354 | 355 | Exhibit A - Source Code Form License Notice 356 | ------------------------------------------- 357 | 358 | This Source Code Form is subject to the terms of the Mozilla Public 359 | License, v. 2.0. If a copy of the MPL was not distributed with this 360 | file, You can obtain one at http://mozilla.org/MPL/2.0/. 361 | 362 | If it is not possible or desirable to put the notice in a particular 363 | file, then You may include the notice in a location (such as a LICENSE 364 | file in a relevant directory) where a recipient would be likely to look 365 | for such a notice. 366 | 367 | You may add additional accurate notices of copyright ownership. 368 | 369 | Exhibit B - "Incompatible With Secondary Licenses" Notice 370 | --------------------------------------------------------- 371 | 372 | This Source Code Form is "Incompatible With Secondary Licenses", as 373 | defined by the Mozilla Public License, v. 2.0. 374 | -------------------------------------------------------------------------------- /LICENSES.txt: -------------------------------------------------------------------------------- 1 | open_source_license.txt 2 | 3 | JMS Client for Pivotal RabbitMQ 1.4.6 GA 4 | 5 | =========================================================================== 6 | 7 | The following copyright statements and licenses apply to various open 8 | source software packages (or portions thereof) that are distributed with 9 | this Pivotal Software, Inc. Product. 10 | 11 | The Pivotal Product may also include other Pivotal components, which may 12 | contain additional open source software packages. One or more such 13 | open_source_licenses.txt files may therefore accompany this Pivotal 14 | Product. 15 | 16 | The Pivotal Product that includes this file does not necessarily use all 17 | the open source software packages referred to below and may also only 18 | use portions of a given package. 19 | 20 | 21 | =============== TABLE OF CONTENTS ============================= 22 | 23 | 24 | The following is a listing of the open source components detailed in 25 | this document. This list is provided for your convenience; please read 26 | further if you wish to review the copyright notice(s) and the full text 27 | of the license associated with each component. 28 | 29 | 30 | 31 | 32 | SECTION 1: BSD-STYLE, MIT-STYLE, OR SIMILAR STYLE LICENSES 33 | 34 | >>> slf4j-api-1.7.5 35 | 36 | 37 | 38 | SECTION 2: Apache License, V2.0 39 | 40 | >>> geronimo-jms_1.1_spec-1.1.1 41 | 42 | 43 | 44 | SECTION 3: Mozilla Public License, v2.0 45 | 46 | >>> amqp-client 47 | 48 | 49 | 50 | APPENDIX. Standard License Files 51 | 52 | >>> Apache License, V2.0 53 | 54 | >>> Mozilla Public License, v2.0 55 | 56 | 57 | 58 | --------------- SECTION 1: BSD-STYLE, MIT-STYLE, OR SIMILAR STYLE LICENSES ---------- 59 | 60 | BSD-STYLE, MIT-STYLE, OR SIMILAR STYLE LICENSES are applicable to the following component(s). 61 | 62 | 63 | >>> slf4j-api-1.7.5 64 | 65 | Copyright (c) 2004-2011 QOS.ch 66 | All rights reserved. 67 | 68 | Permission is hereby granted, free of charge, to any person obtaining 69 | a copy of this software and associated documentation files (the 70 | "Software"), to deal in the Software without restriction, including 71 | without limitation the rights to use, copy, modify, merge, publish, 72 | distribute, sublicense, and/or sell copies of the Software, and to 73 | permit persons to whom the Software is furnished to do so, subject to 74 | the following conditions: 75 | 76 | The above copyright notice and this permission notice shall be 77 | included in all copies or substantial portions of the Software. 78 | 79 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, 80 | EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 81 | MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND 82 | NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE 83 | LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION 84 | OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION 85 | WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 86 | 87 | 88 | --------------- SECTION 2: Apache License, V2.0 ---------- 89 | 90 | Apache License, V2.0 is applicable to the following component(s). 91 | 92 | 93 | >>> geronimo-jms_1.1_spec-1.1.1 94 | 95 | Apache Geronimo 96 | Copyright 2003-2008 The Apache Software Foundation 97 | 98 | This product includes software developed by 99 | The Apache Software Foundation (https://www.apache.org/). 100 | 101 | 102 | --------------- SECTION 3: Mozilla Public License, v2.0 ---------- 103 | 104 | Mozilla Public License, v2.0 is applicable to the following component(s). 105 | 106 | 107 | >>> amqp-client 108 | 109 | // The contents of this file are subject to the Mozilla Public License 110 | // Version 1.1 (the "License"); you may not use this file except in 111 | // compliance with the License. You may obtain a copy of the License 112 | // at https://www.mozilla.org/MPL/ 113 | // 114 | // Software distributed under the License is distributed on an "AS IS" 115 | // basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See 116 | // the License for the specific language governing rights and 117 | // limitations under the License. 118 | // 119 | // The Original Code is RabbitMQ. 120 | // 121 | // The Initial Developer of the Original Code is GoPivotal, Inc. 122 | // Copyright (c) 2007-2020 VMware, Inc. or its affiliates. All rights reserved. 123 | 124 | ADDITIONAL LICENSE INFORMATION: 125 | 126 | > Apache 2.0 127 | 128 | amqp-client-3.5.6-sources.jar\com\rabbitmq\tools\json\JSONWriter.java 129 | 130 | /* 131 | Copyright (c) 2006-2007 Frank Carver 132 | Copyright (c) 2007-2020 VMware, Inc. or its affiliates. All Rights Reserved 133 | 134 | Licensed under the Apache License, Version 2.0 (the "License"); 135 | you may not use this file except in compliance with the License. 136 | You may obtain a copy of the License at 137 | 138 | http://www.apache.org/licenses/LICENSE-2.0 139 | 140 | Unless required by applicable law or agreed to in writing, software 141 | distributed under the License is distributed on an "AS IS" BASIS, 142 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 143 | See the License for the specific language governing permissions and 144 | limitations under the License. 145 | 146 | 147 | 148 | > Public Domain 149 | 150 | amqp-client-sources.jar\com\rabbitmq\client\impl\VariableLinkedBlockingQueue.java 151 | 152 | /* 153 | * Modifications Copyright 2015 Pivotal Software, Inc and licenced as per 154 | * the rest of the RabbitMQ Java client. 155 | */ 156 | * Written by Doug Lea with assistance from members of JCP JSR-166 157 | * Expert Group and released to the public domain, as explained at 158 | * https://creativecommons.org/licenses/publicdomain 159 | */ 160 | 161 | 162 | =============== APPENDIX. Standard License Files ============== 163 | 164 | 165 | 166 | --------------- SECTION 1: Apache License, V2.0 ----------- 167 | 168 | Apache License 169 | 170 | Version 2.0, January 2004 171 | http://www.apache.org/licenses/ 172 | 173 | TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 174 | 175 | 1. Definitions. 176 | 177 | "License" shall mean the terms and conditions for use, reproduction, 178 | and distribution as defined by Sections 1 through 9 of this document. 179 | 180 | "Licensor" shall mean the copyright owner or entity authorized by the 181 | copyright owner that is granting the License. 182 | 183 | "Legal Entity" shall mean the union of the acting entity and all other 184 | entities that control, are controlled by, or are under common control 185 | with that entity. For the purposes of this definition, "control" means 186 | (i) the power, direct or indirect, to cause the direction or management 187 | of such entity, whether by contract or otherwise, or (ii) ownership 188 | of fifty percent (50%) or more of the outstanding shares, or (iii) 189 | beneficial ownership of such entity. 190 | 191 | "You" (or "Your") shall mean an individual or Legal Entity exercising 192 | permissions granted by this License. 193 | 194 | "Source" form shall mean the preferred form for making modifications, 195 | including but not limited to software source code, documentation source, 196 | and configuration files. 197 | 198 | "Object" form shall mean any form resulting from mechanical transformation 199 | or translation of a Source form, including but not limited to compiled 200 | object code, generated documentation, and conversions to other media 201 | types. 202 | 203 | "Work" shall mean the work of authorship, whether in Source or 204 | Object form, made available under the License, as indicated by a copyright 205 | notice that is included in or attached to the work (an example is provided 206 | in the Appendix below). 207 | 208 | "Derivative Works" shall mean any work, whether in Source or Object form, 209 | that is based on (or derived from) the Work and for which the editorial 210 | revisions, annotations, elaborations, or other modifications represent, 211 | as a whole, an original work of authorship. For the purposes of this 212 | License, Derivative Works shall not include works that remain separable 213 | from, or merely link (or bind by name) to the interfaces of, the Work 214 | and Derivative Works thereof. 215 | 216 | "Contribution" shall mean any work of authorship, including the 217 | original version of the Work and any modifications or additions to 218 | that Work or Derivative Works thereof, that is intentionally submitted 219 | to Licensor for inclusion in the Work by the copyright owner or by an 220 | individual or Legal Entity authorized to submit on behalf of the copyright 221 | owner. For the purposes of this definition, "submitted" means any form of 222 | electronic, verbal, or written communication sent to the Licensor or its 223 | representatives, including but not limited to communication on electronic 224 | mailing lists, source code control systems, and issue tracking systems 225 | that are managed by, or on behalf of, the Licensor for the purpose of 226 | discussing and improving the Work, but excluding communication that is 227 | conspicuously marked or otherwise designated in writing by the copyright 228 | owner as "Not a Contribution." 229 | 230 | "Contributor" shall mean Licensor and any individual or Legal Entity 231 | on behalf of whom a Contribution has been received by Licensor and 232 | subsequently incorporated within the Work. 233 | 234 | 2. Grant of Copyright License. 235 | Subject to the terms and conditions of this License, each Contributor 236 | hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, 237 | royalty-free, irrevocable copyright license to reproduce, prepare 238 | Derivative Works of, publicly display, publicly perform, sublicense, and 239 | distribute the Work and such Derivative Works in Source or Object form. 240 | 241 | 3. Grant of Patent License. 242 | Subject to the terms and conditions of this License, each Contributor 243 | hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, 244 | royalty- free, irrevocable (except as stated in this section) patent 245 | license to make, have made, use, offer to sell, sell, import, and 246 | otherwise transfer the Work, where such license applies only to those 247 | patent claims licensable by such Contributor that are necessarily 248 | infringed by their Contribution(s) alone or by combination of 249 | their Contribution(s) with the Work to which such Contribution(s) 250 | was submitted. If You institute patent litigation against any entity 251 | (including a cross-claim or counterclaim in a lawsuit) alleging that the 252 | Work or a Contribution incorporated within the Work constitutes direct 253 | or contributory patent infringement, then any patent licenses granted 254 | to You under this License for that Work shall terminate as of the date 255 | such litigation is filed. 256 | 257 | 4. Redistribution. 258 | You may reproduce and distribute copies of the Work or Derivative Works 259 | thereof in any medium, with or without modifications, and in Source or 260 | Object form, provided that You meet the following conditions: 261 | 262 | a. You must give any other recipients of the Work or Derivative Works 263 | a copy of this License; and 264 | 265 | b. You must cause any modified files to carry prominent notices stating 266 | that You changed the files; and 267 | 268 | c. You must retain, in the Source form of any Derivative Works that 269 | You distribute, all copyright, patent, trademark, and attribution 270 | notices from the Source form of the Work, excluding those notices 271 | that do not pertain to any part of the Derivative Works; and 272 | 273 | d. If the Work includes a "NOTICE" text file as part of its 274 | distribution, then any Derivative Works that You distribute must 275 | include a readable copy of the attribution notices contained 276 | within such NOTICE file, excluding those notices that do not 277 | pertain to any part of the Derivative Works, in at least one of 278 | the following places: within a NOTICE text file distributed as part 279 | of the Derivative Works; within the Source form or documentation, 280 | if provided along with the Derivative Works; or, within a display 281 | generated by the Derivative Works, if and wherever such third-party 282 | notices normally appear. The contents of the NOTICE file are for 283 | informational purposes only and do not modify the License. You 284 | may add Your own attribution notices within Derivative Works that 285 | You distribute, alongside or as an addendum to the NOTICE text 286 | from the Work, provided that such additional attribution notices 287 | cannot be construed as modifying the License. You may add Your own 288 | copyright statement to Your modifications and may provide additional 289 | or different license terms and conditions for use, reproduction, or 290 | distribution of Your modifications, or for any such Derivative Works 291 | as a whole, provided Your use, reproduction, and distribution of the 292 | Work otherwise complies with the conditions stated in this License. 293 | 294 | 5. Submission of Contributions. 295 | Unless You explicitly state otherwise, any Contribution intentionally 296 | submitted for inclusion in the Work by You to the Licensor shall be 297 | under the terms and conditions of this License, without any additional 298 | terms or conditions. Notwithstanding the above, nothing herein shall 299 | supersede or modify the terms of any separate license agreement you may 300 | have executed with Licensor regarding such Contributions. 301 | 302 | 6. Trademarks. 303 | This License does not grant permission to use the trade names, trademarks, 304 | service marks, or product names of the Licensor, except as required for 305 | reasonable and customary use in describing the origin of the Work and 306 | reproducing the content of the NOTICE file. 307 | 308 | 7. Disclaimer of Warranty. 309 | Unless required by applicable law or agreed to in writing, Licensor 310 | provides the Work (and each Contributor provides its Contributions) on 311 | an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either 312 | express or implied, including, without limitation, any warranties or 313 | conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR 314 | A PARTICULAR PURPOSE. You are solely responsible for determining the 315 | appropriateness of using or redistributing the Work and assume any risks 316 | associated with Your exercise of permissions under this License. 317 | 318 | 8. Limitation of Liability. 319 | In no event and under no legal theory, whether in tort (including 320 | negligence), contract, or otherwise, unless required by applicable law 321 | (such as deliberate and grossly negligent acts) or agreed to in writing, 322 | shall any Contributor be liable to You for damages, including any direct, 323 | indirect, special, incidental, or consequential damages of any character 324 | arising as a result of this License or out of the use or inability to 325 | use the Work (including but not limited to damages for loss of goodwill, 326 | work stoppage, computer failure or malfunction, or any and all other 327 | commercial damages or losses), even if such Contributor has been advised 328 | of the possibility of such damages. 329 | 330 | 9. Accepting Warranty or Additional Liability. 331 | While redistributing the Work or Derivative Works thereof, You may 332 | choose to offer, and charge a fee for, acceptance of support, warranty, 333 | indemnity, or other liability obligations and/or rights consistent with 334 | this License. However, in accepting such obligations, You may act only 335 | on Your own behalf and on Your sole responsibility, not on behalf of 336 | any other Contributor, and only if You agree to indemnify, defend, and 337 | hold each Contributor harmless for any liability incurred by, or claims 338 | asserted against, such Contributor by reason of your accepting any such 339 | warranty or additional liability. 340 | 341 | END OF TERMS AND CONDITIONS 342 | 343 | 344 | 345 | --------------- SECTION 2: Mozilla Public License, V2.0 ----------- 346 | 347 | Mozilla Public License Version 2.0 348 | ================================== 349 | 350 | 1. Definitions 351 | -------------- 352 | 353 | 1.1. "Contributor" 354 | means each individual or legal entity that creates, contributes to 355 | the creation of, or owns Covered Software. 356 | 357 | 1.2. "Contributor Version" 358 | means the combination of the Contributions of others (if any) used 359 | by a Contributor and that particular Contributor's Contribution. 360 | 361 | 1.3. "Contribution" 362 | means Covered Software of a particular Contributor. 363 | 364 | 1.4. "Covered Software" 365 | means Source Code Form to which the initial Contributor has attached 366 | the notice in Exhibit A, the Executable Form of such Source Code 367 | Form, and Modifications of such Source Code Form, in each case 368 | including portions thereof. 369 | 370 | 1.5. "Incompatible With Secondary Licenses" 371 | means 372 | 373 | (a) that the initial Contributor has attached the notice described 374 | in Exhibit B to the Covered Software; or 375 | 376 | (b) that the Covered Software was made available under the terms of 377 | version 1.1 or earlier of the License, but not also under the 378 | terms of a Secondary License. 379 | 380 | 1.6. "Executable Form" 381 | means any form of the work other than Source Code Form. 382 | 383 | 1.7. "Larger Work" 384 | means a work that combines Covered Software with other material, in 385 | a separate file or files, that is not Covered Software. 386 | 387 | 1.8. "License" 388 | means this document. 389 | 390 | 1.9. "Licensable" 391 | means having the right to grant, to the maximum extent possible, 392 | whether at the time of the initial grant or subsequently, any and 393 | all of the rights conveyed by this License. 394 | 395 | 1.10. "Modifications" 396 | means any of the following: 397 | 398 | (a) any file in Source Code Form that results from an addition to, 399 | deletion from, or modification of the contents of Covered 400 | Software; or 401 | 402 | (b) any new file in Source Code Form that contains any Covered 403 | Software. 404 | 405 | 1.11. "Patent Claims" of a Contributor 406 | means any patent claim(s), including without limitation, method, 407 | process, and apparatus claims, in any patent Licensable by such 408 | Contributor that would be infringed, but for the grant of the 409 | License, by the making, using, selling, offering for sale, having 410 | made, import, or transfer of either its Contributions or its 411 | Contributor Version. 412 | 413 | 1.12. "Secondary License" 414 | means either the GNU General Public License, Version 2.0, the GNU 415 | Lesser General Public License, Version 2.1, the GNU Affero General 416 | Public License, Version 3.0, or any later versions of those 417 | licenses. 418 | 419 | 1.13. "Source Code Form" 420 | means the form of the work preferred for making modifications. 421 | 422 | 1.14. "You" (or "Your") 423 | means an individual or a legal entity exercising rights under this 424 | License. For legal entities, "You" includes any entity that 425 | controls, is controlled by, or is under common control with You. For 426 | purposes of this definition, "control" means (a) the power, direct 427 | or indirect, to cause the direction or management of such entity, 428 | whether by contract or otherwise, or (b) ownership of more than 429 | fifty percent (50%) of the outstanding shares or beneficial 430 | ownership of such entity. 431 | 432 | 2. License Grants and Conditions 433 | -------------------------------- 434 | 435 | 2.1. Grants 436 | 437 | Each Contributor hereby grants You a world-wide, royalty-free, 438 | non-exclusive license: 439 | 440 | (a) under intellectual property rights (other than patent or trademark) 441 | Licensable by such Contributor to use, reproduce, make available, 442 | modify, display, perform, distribute, and otherwise exploit its 443 | Contributions, either on an unmodified basis, with Modifications, or 444 | as part of a Larger Work; and 445 | 446 | (b) under Patent Claims of such Contributor to make, use, sell, offer 447 | for sale, have made, import, and otherwise transfer either its 448 | Contributions or its Contributor Version. 449 | 450 | 2.2. Effective Date 451 | 452 | The licenses granted in Section 2.1 with respect to any Contribution 453 | become effective for each Contribution on the date the Contributor first 454 | distributes such Contribution. 455 | 456 | 2.3. Limitations on Grant Scope 457 | 458 | The licenses granted in this Section 2 are the only rights granted under 459 | this License. No additional rights or licenses will be implied from the 460 | distribution or licensing of Covered Software under this License. 461 | Notwithstanding Section 2.1(b) above, no patent license is granted by a 462 | Contributor: 463 | 464 | (a) for any code that a Contributor has removed from Covered Software; 465 | or 466 | 467 | (b) for infringements caused by: (i) Your and any other third party's 468 | modifications of Covered Software, or (ii) the combination of its 469 | Contributions with other software (except as part of its Contributor 470 | Version); or 471 | 472 | (c) under Patent Claims infringed by Covered Software in the absence of 473 | its Contributions. 474 | 475 | This License does not grant any rights in the trademarks, service marks, 476 | or logos of any Contributor (except as may be necessary to comply with 477 | the notice requirements in Section 3.4). 478 | 479 | 2.4. Subsequent Licenses 480 | 481 | No Contributor makes additional grants as a result of Your choice to 482 | distribute the Covered Software under a subsequent version of this 483 | License (see Section 10.2) or under the terms of a Secondary License (if 484 | permitted under the terms of Section 3.3). 485 | 486 | 2.5. Representation 487 | 488 | Each Contributor represents that the Contributor believes its 489 | Contributions are its original creation(s) or it has sufficient rights 490 | to grant the rights to its Contributions conveyed by this License. 491 | 492 | 2.6. Fair Use 493 | 494 | This License is not intended to limit any rights You have under 495 | applicable copyright doctrines of fair use, fair dealing, or other 496 | equivalents. 497 | 498 | 2.7. Conditions 499 | 500 | Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted 501 | in Section 2.1. 502 | 503 | 3. Responsibilities 504 | ------------------- 505 | 506 | 3.1. Distribution of Source Form 507 | 508 | All distribution of Covered Software in Source Code Form, including any 509 | Modifications that You create or to which You contribute, must be under 510 | the terms of this License. You must inform recipients that the Source 511 | Code Form of the Covered Software is governed by the terms of this 512 | License, and how they can obtain a copy of this License. You may not 513 | attempt to alter or restrict the recipients' rights in the Source Code 514 | Form. 515 | 516 | 3.2. Distribution of Executable Form 517 | 518 | If You distribute Covered Software in Executable Form then: 519 | 520 | (a) such Covered Software must also be made available in Source Code 521 | Form, as described in Section 3.1, and You must inform recipients of 522 | the Executable Form how they can obtain a copy of such Source Code 523 | Form by reasonable means in a timely manner, at a charge no more 524 | than the cost of distribution to the recipient; and 525 | 526 | (b) You may distribute such Executable Form under the terms of this 527 | License, or sublicense it under different terms, provided that the 528 | license for the Executable Form does not attempt to limit or alter 529 | the recipients' rights in the Source Code Form under this License. 530 | 531 | 3.3. Distribution of a Larger Work 532 | 533 | You may create and distribute a Larger Work under terms of Your choice, 534 | provided that You also comply with the requirements of this License for 535 | the Covered Software. If the Larger Work is a combination of Covered 536 | Software with a work governed by one or more Secondary Licenses, and the 537 | Covered Software is not Incompatible With Secondary Licenses, this 538 | License permits You to additionally distribute such Covered Software 539 | under the terms of such Secondary License(s), so that the recipient of 540 | the Larger Work may, at their option, further distribute the Covered 541 | Software under the terms of either this License or such Secondary 542 | License(s). 543 | 544 | 3.4. Notices 545 | 546 | You may not remove or alter the substance of any license notices 547 | (including copyright notices, patent notices, disclaimers of warranty, 548 | or limitations of liability) contained within the Source Code Form of 549 | the Covered Software, except that You may alter any license notices to 550 | the extent required to remedy known factual inaccuracies. 551 | 552 | 3.5. Application of Additional Terms 553 | 554 | You may choose to offer, and to charge a fee for, warranty, support, 555 | indemnity or liability obligations to one or more recipients of Covered 556 | Software. However, You may do so only on Your own behalf, and not on 557 | behalf of any Contributor. You must make it absolutely clear that any 558 | such warranty, support, indemnity, or liability obligation is offered by 559 | You alone, and You hereby agree to indemnify every Contributor for any 560 | liability incurred by such Contributor as a result of warranty, support, 561 | indemnity or liability terms You offer. You may include additional 562 | disclaimers of warranty and limitations of liability specific to any 563 | jurisdiction. 564 | 565 | 4. Inability to Comply Due to Statute or Regulation 566 | --------------------------------------------------- 567 | 568 | If it is impossible for You to comply with any of the terms of this 569 | License with respect to some or all of the Covered Software due to 570 | statute, judicial order, or regulation then You must: (a) comply with 571 | the terms of this License to the maximum extent possible; and (b) 572 | describe the limitations and the code they affect. Such description must 573 | be placed in a text file included with all distributions of the Covered 574 | Software under this License. Except to the extent prohibited by statute 575 | or regulation, such description must be sufficiently detailed for a 576 | recipient of ordinary skill to be able to understand it. 577 | 578 | 5. Termination 579 | -------------- 580 | 581 | 5.1. The rights granted under this License will terminate automatically 582 | if You fail to comply with any of its terms. However, if You become 583 | compliant, then the rights granted under this License from a particular 584 | Contributor are reinstated (a) provisionally, unless and until such 585 | Contributor explicitly and finally terminates Your grants, and (b) on an 586 | ongoing basis, if such Contributor fails to notify You of the 587 | non-compliance by some reasonable means prior to 60 days after You have 588 | come back into compliance. Moreover, Your grants from a particular 589 | Contributor are reinstated on an ongoing basis if such Contributor 590 | notifies You of the non-compliance by some reasonable means, this is the 591 | first time You have received notice of non-compliance with this License 592 | from such Contributor, and You become compliant prior to 30 days after 593 | Your receipt of the notice. 594 | 595 | 5.2. If You initiate litigation against any entity by asserting a patent 596 | infringement claim (excluding declaratory judgment actions, 597 | counter-claims, and cross-claims) alleging that a Contributor Version 598 | directly or indirectly infringes any patent, then the rights granted to 599 | You by any and all Contributors for the Covered Software under Section 600 | 2.1 of this License shall terminate. 601 | 602 | 5.3. In the event of termination under Sections 5.1 or 5.2 above, all 603 | end user license agreements (excluding distributors and resellers) which 604 | have been validly granted by You or Your distributors under this License 605 | prior to termination shall survive termination. 606 | 607 | ************************************************************************ 608 | * * 609 | * 6. Disclaimer of Warranty * 610 | * ------------------------- * 611 | * * 612 | * Covered Software is provided under this License on an "as is" * 613 | * basis, without warranty of any kind, either expressed, implied, or * 614 | * statutory, including, without limitation, warranties that the * 615 | * Covered Software is free of defects, merchantable, fit for a * 616 | * particular purpose or non-infringing. The entire risk as to the * 617 | * quality and performance of the Covered Software is with You. * 618 | * Should any Covered Software prove defective in any respect, You * 619 | * (not any Contributor) assume the cost of any necessary servicing, * 620 | * repair, or correction. This disclaimer of warranty constitutes an * 621 | * essential part of this License. No use of any Covered Software is * 622 | * authorized under this License except under this disclaimer. * 623 | * * 624 | ************************************************************************ 625 | 626 | ************************************************************************ 627 | * * 628 | * 7. Limitation of Liability * 629 | * -------------------------- * 630 | * * 631 | * Under no circumstances and under no legal theory, whether tort * 632 | * (including negligence), contract, or otherwise, shall any * 633 | * Contributor, or anyone who distributes Covered Software as * 634 | * permitted above, be liable to You for any direct, indirect, * 635 | * special, incidental, or consequential damages of any character * 636 | * including, without limitation, damages for lost profits, loss of * 637 | * goodwill, work stoppage, computer failure or malfunction, or any * 638 | * and all other commercial damages or losses, even if such party * 639 | * shall have been informed of the possibility of such damages. This * 640 | * limitation of liability shall not apply to liability for death or * 641 | * personal injury resulting from such party's negligence to the * 642 | * extent applicable law prohibits such limitation. Some * 643 | * jurisdictions do not allow the exclusion or limitation of * 644 | * incidental or consequential damages, so this exclusion and * 645 | * limitation may not apply to You. * 646 | * * 647 | ************************************************************************ 648 | 649 | 8. Litigation 650 | ------------- 651 | 652 | Any litigation relating to this License may be brought only in the 653 | courts of a jurisdiction where the defendant maintains its principal 654 | place of business and such litigation shall be governed by laws of that 655 | jurisdiction, without reference to its conflict-of-law provisions. 656 | Nothing in this Section shall prevent a party's ability to bring 657 | cross-claims or counter-claims. 658 | 659 | 9. Miscellaneous 660 | ---------------- 661 | 662 | This License represents the complete agreement concerning the subject 663 | matter hereof. If any provision of this License is held to be 664 | unenforceable, such provision shall be reformed only to the extent 665 | necessary to make it enforceable. Any law or regulation which provides 666 | that the language of a contract shall be construed against the drafter 667 | shall not be used to construe this License against a Contributor. 668 | 669 | 10. Versions of the License 670 | --------------------------- 671 | 672 | 10.1. New Versions 673 | 674 | Mozilla Foundation is the license steward. Except as provided in Section 675 | 10.3, no one other than the license steward has the right to modify or 676 | publish new versions of this License. Each version will be given a 677 | distinguishing version number. 678 | 679 | 10.2. Effect of New Versions 680 | 681 | You may distribute the Covered Software under the terms of the version 682 | of the License under which You originally received the Covered Software, 683 | or under the terms of any subsequent version published by the license 684 | steward. 685 | 686 | 10.3. Modified Versions 687 | 688 | If you create software not governed by this License, and you want to 689 | create a new license for such software, you may create and use a 690 | modified version of this License if you rename the license and remove 691 | any references to the name of the license steward (except to note that 692 | such modified license differs from this License). 693 | 694 | 10.4. Distributing Source Code Form that is Incompatible With Secondary 695 | Licenses 696 | 697 | If You choose to distribute Source Code Form that is Incompatible With 698 | Secondary Licenses under the terms of this version of the License, the 699 | notice described in Exhibit B of this License must be attached. 700 | 701 | Exhibit A - Source Code Form License Notice 702 | ------------------------------------------- 703 | 704 | This Source Code Form is subject to the terms of the Mozilla Public 705 | License, v. 2.0. If a copy of the MPL was not distributed with this 706 | file, You can obtain one at http://mozilla.org/MPL/2.0/. 707 | 708 | If it is not possible or desirable to put the notice in a particular 709 | file, then You may include the notice in a location (such as a LICENSE 710 | file in a relevant directory) where a recipient would be likely to look 711 | for such a notice. 712 | 713 | Copyright (c) 2007-2020 VMware, Inc. or its affiliates. 714 | 715 | 716 | 717 | =========================================================================== 718 | 719 | To the extent any open source components are licensed under the 720 | GPL and/or LGPL, or other similar licenses that require the 721 | source code and/or modifications to source code to be made 722 | available (as would be noted above), you may obtain a copy of 723 | the source code corresponding to the binaries for such open 724 | source components and modifications thereto, if any, (the 725 | "Source Files"), by downloading the Source Files from Pivotal's website at 726 | https://tanzu.vmware.com/open-source, or by sending a request, 727 | with your name and address to: VMware, Inc., 3401 Hillview Ave, 728 | Palo Alto, CA 94304, Attention: General Counsel. All such requests should 729 | clearly specify: OPEN SOURCE FILES REQUEST, Attention General Counsel. 730 | VMware shall mail a copy of the Source Files to you on a CD or equivalent physical medium. 731 | This offer to obtain a copy of the Source Files is valid for three 732 | years from the date you acquired this Software product. 733 | Alternatively, the Source Files may accompany the VMware product. 734 | 735 | 736 | [RABBITJMS146GASS110315] -------------------------------------------------------------------------------- /Makefile: -------------------------------------------------------------------------------- 1 | PROJECT = rabbitmq_jms_topic_exchange 2 | PROJECT_DESCRIPTION = RabbitMQ JMS topic selector exchange plugin 3 | 4 | DEPS = rabbit_common rabbit 5 | TEST_DEPS = rabbitmq_ct_helpers rabbitmq_ct_client_helpers amqp_client 6 | 7 | DEP_EARLY_PLUGINS = rabbit_common/mk/rabbitmq-early-plugin.mk 8 | DEP_PLUGINS = rabbit_common/mk/rabbitmq-plugin.mk 9 | 10 | # FIXME: Use erlang.mk patched for RabbitMQ, while waiting for PRs to be 11 | # reviewed and merged. 12 | 13 | ERLANG_MK_REPO = https://github.com/rabbitmq/erlang.mk.git 14 | ERLANG_MK_COMMIT = rabbitmq-tmp 15 | 16 | include rabbitmq-components.mk 17 | include erlang.mk 18 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # RabbitMQ JMS Topic Exchange Plugin 2 | 3 | ## This was migrated to https://github.com/rabbitmq/rabbitmq-server 4 | 5 | This repository has been moved to the main unified RabbitMQ "monorepo", including all open issues. You can find the source under [/deps/rabbitmq_jms_topic_exchange](https://github.com/rabbitmq/rabbitmq-server/tree/master/deps/rabbitmq_jms_topic_exchange). 6 | All issues have been transferred. 7 | 8 | ## Overview 9 | 10 | This plugin adds server-side support for [RabbitMQ JMS client](https://github.com/rabbitmq/rabbitmq-jms-client). 11 | This plugin provides support for JMS topic routing and selection based on JMS SQL selection 12 | rules. 13 | 14 | This implementation is based upon the [Java Messaging Service 15 | Specification Version 1.1](https://www.oracle.com/technetwork/java/docs-136352.html). 16 | 17 | ## Project Maturity 18 | 19 | RabbitMQ JMS-related projects are several years old and can be considered 20 | reasonably mature. They have been first open sourced in June 2016. 21 | Some related projects (e.g. a compliance test suite) and documentation are yet to be open sourced. 22 | 23 | ## Supported RabbitMQ Versions 24 | 25 | This plugin targets RabbitMQ `3.6.0` and later versions. 26 | 27 | ## Installation 28 | 29 | This plugin ships with RabbitMQ starting with `3.6.3`. Enable it with 30 | 31 | ``` 32 | [sudo] rabbitmq-plugins enable rabbitmq_jms_topic_exchange 33 | ``` 34 | 35 | 36 | ## Design 37 | 38 | The plugin this generates is a user-written exchange type for RabbitMQ 39 | client use. The exchange type name is "`x_jms_topic`" but this is _not_ 40 | a topic exchange. Instead it works together with a standard topic 41 | exchange to provide the JMS topic selection function. 42 | 43 | When JMS Selectors are used on a Topic Destination consumer, the 44 | destination (queue) is bound to an exchange of type `x_jms_topic`, with 45 | arguments that indicate what the selection criteria are. The 46 | `x_jms_topic` exchange is, in turn, bound to the standard Topic Exchange 47 | used by JMS messaging (this uses the RabbitMQ exchange-to-exchange 48 | binding extension to the AMQP 0-9-1 protocol). 49 | 50 | In this way, normal topic routing can occur, with the overhead of 51 | selection only applying when selection is used, and _after_ the routing 52 | and filtering implied by the topic name. 53 | 54 | ## Building From Source 55 | 56 | Building is no different from [building other RabbitMQ plugins](https://www.rabbitmq.com/plugin-development.html). 57 | 58 | TL;DR: 59 | 60 | git clone https://github.com/rabbitmq/rabbitmq-jms-topic-exchange.git 61 | cd rabbitmq-jms-topic-exchange 62 | make -j dist 63 | ls plugins/* 64 | 65 | ## Copyright and License 66 | 67 | (c) 2007-2020 VMware, Inc. or its affiliates. 68 | 69 | See [LICENSE](./LICENSE) for license information. 70 | -------------------------------------------------------------------------------- /include/rabbit_jms_topic_exchange.hrl: -------------------------------------------------------------------------------- 1 | %% This Source Code Form is subject to the terms of the Mozilla Public 2 | %% License, v. 2.0. If a copy of the MPL was not distributed with this 3 | %% file, You can obtain one at https://mozilla.org/MPL/2.0/. 4 | %% 5 | %% Copyright (c) 2012-2020 VMware, Inc. or its affiliates. All rights reserved. 6 | %% ----------------------------------------------------------------------------- 7 | 8 | %% JMS on Rabbit Topic Selector Exchange plugin definitions 9 | 10 | %% ----------------------------------------------------------------------------- 11 | %% User-defined exchange type name 12 | -define(X_TYPE_NAME, <<"x-jms-topic">>). 13 | 14 | %% ----------------------------------------------------------------------------- 15 | %% mnesia database records 16 | -define(JMS_TOPIC_TABLE, x_jms_topic_table). 17 | -define(JMS_TOPIC_RECORD, x_jms_topic_xs). 18 | 19 | %% Key is x_name -- the exchange name 20 | -record(?JMS_TOPIC_RECORD, {x_name, x_selection_policy = undefined, x_selector_funs}). 21 | %% fields: 22 | %% x_selector_funs 23 | %% a partial map (`dict`) of binding functions: 24 | %% dict: RoutingKey x DestName -/-> BindingSelectorFun 25 | %% (there is no default, but an empty map will be initially inserted) 26 | %% where a BindingSelectorFun has the signature: 27 | %% bsf : Headers -> boolean 28 | %% x_selection_policy 29 | %% not used, retained for backwards compatibility of db records. 30 | %% ----------------------------------------------------------------------------- 31 | 32 | %% ----------------------------------------------------------------------------- 33 | 34 | %% ----------------------------------------------------------------------------- 35 | %% Name of arg on binding used to specify erlang term -- string type 36 | %% private static final String RJMS_COMPILED_SELECTOR_ARG = "rjms_erlang_selector"; 37 | %% in JMS Client. 38 | -define(RJMS_COMPILED_SELECTOR_ARG, <<"rjms_erlang_selector">>). 39 | %% ----------------------------------------------------------------------------- 40 | -------------------------------------------------------------------------------- /rabbitmq-components.mk: -------------------------------------------------------------------------------- 1 | ifeq ($(.DEFAULT_GOAL),) 2 | # Define default goal to `all` because this file defines some targets 3 | # before the inclusion of erlang.mk leading to the wrong target becoming 4 | # the default. 5 | .DEFAULT_GOAL = all 6 | endif 7 | 8 | # PROJECT_VERSION defaults to: 9 | # 1. the version exported by rabbitmq-server-release; 10 | # 2. the version stored in `git-revisions.txt`, if it exists; 11 | # 3. a version based on git-describe(1), if it is a Git clone; 12 | # 4. 0.0.0 13 | 14 | PROJECT_VERSION := $(RABBITMQ_VERSION) 15 | 16 | ifeq ($(PROJECT_VERSION),) 17 | PROJECT_VERSION := $(shell \ 18 | if test -f git-revisions.txt; then \ 19 | head -n1 git-revisions.txt | \ 20 | awk '{print $$$(words $(PROJECT_DESCRIPTION) version);}'; \ 21 | else \ 22 | (git describe --dirty --abbrev=7 --tags --always --first-parent \ 23 | 2>/dev/null || echo rabbitmq_v0_0_0) | \ 24 | sed -e 's/^rabbitmq_v//' -e 's/^v//' -e 's/_/./g' -e 's/-/+/' \ 25 | -e 's/-/./g'; \ 26 | fi) 27 | endif 28 | 29 | # -------------------------------------------------------------------- 30 | # RabbitMQ components. 31 | # -------------------------------------------------------------------- 32 | 33 | # For RabbitMQ repositories, we want to checkout branches which match 34 | # the parent project. For instance, if the parent project is on a 35 | # release tag, dependencies must be on the same release tag. If the 36 | # parent project is on a topic branch, dependencies must be on the same 37 | # topic branch or fallback to `stable` or `master` whichever was the 38 | # base of the topic branch. 39 | 40 | dep_amqp_client = git_rmq rabbitmq-erlang-client $(current_rmq_ref) $(base_rmq_ref) master 41 | dep_amqp10_client = git_rmq rabbitmq-amqp1.0-client $(current_rmq_ref) $(base_rmq_ref) master 42 | dep_amqp10_common = git_rmq rabbitmq-amqp1.0-common $(current_rmq_ref) $(base_rmq_ref) master 43 | dep_rabbit = git_rmq rabbitmq-server $(current_rmq_ref) $(base_rmq_ref) master 44 | dep_rabbit_common = git_rmq rabbitmq-common $(current_rmq_ref) $(base_rmq_ref) master 45 | dep_rabbitmq_amqp1_0 = git_rmq rabbitmq-amqp1.0 $(current_rmq_ref) $(base_rmq_ref) master 46 | dep_rabbitmq_auth_backend_amqp = git_rmq rabbitmq-auth-backend-amqp $(current_rmq_ref) $(base_rmq_ref) master 47 | dep_rabbitmq_auth_backend_cache = git_rmq rabbitmq-auth-backend-cache $(current_rmq_ref) $(base_rmq_ref) master 48 | dep_rabbitmq_auth_backend_http = git_rmq rabbitmq-auth-backend-http $(current_rmq_ref) $(base_rmq_ref) master 49 | dep_rabbitmq_auth_backend_ldap = git_rmq rabbitmq-auth-backend-ldap $(current_rmq_ref) $(base_rmq_ref) master 50 | dep_rabbitmq_auth_backend_oauth2 = git_rmq rabbitmq-auth-backend-oauth2 $(current_rmq_ref) $(base_rmq_ref) master 51 | dep_rabbitmq_auth_mechanism_ssl = git_rmq rabbitmq-auth-mechanism-ssl $(current_rmq_ref) $(base_rmq_ref) master 52 | dep_rabbitmq_aws = git_rmq rabbitmq-aws $(current_rmq_ref) $(base_rmq_ref) master 53 | dep_rabbitmq_boot_steps_visualiser = git_rmq rabbitmq-boot-steps-visualiser $(current_rmq_ref) $(base_rmq_ref) master 54 | dep_rabbitmq_cli = git_rmq rabbitmq-cli $(current_rmq_ref) $(base_rmq_ref) master 55 | dep_rabbitmq_codegen = git_rmq rabbitmq-codegen $(current_rmq_ref) $(base_rmq_ref) master 56 | dep_rabbitmq_consistent_hash_exchange = git_rmq rabbitmq-consistent-hash-exchange $(current_rmq_ref) $(base_rmq_ref) master 57 | dep_rabbitmq_ct_client_helpers = git_rmq rabbitmq-ct-client-helpers $(current_rmq_ref) $(base_rmq_ref) master 58 | dep_rabbitmq_ct_helpers = git_rmq rabbitmq-ct-helpers $(current_rmq_ref) $(base_rmq_ref) master 59 | dep_rabbitmq_delayed_message_exchange = git_rmq rabbitmq-delayed-message-exchange $(current_rmq_ref) $(base_rmq_ref) master 60 | dep_rabbitmq_dotnet_client = git_rmq rabbitmq-dotnet-client $(current_rmq_ref) $(base_rmq_ref) master 61 | dep_rabbitmq_event_exchange = git_rmq rabbitmq-event-exchange $(current_rmq_ref) $(base_rmq_ref) master 62 | dep_rabbitmq_federation = git_rmq rabbitmq-federation $(current_rmq_ref) $(base_rmq_ref) master 63 | dep_rabbitmq_federation_management = git_rmq rabbitmq-federation-management $(current_rmq_ref) $(base_rmq_ref) master 64 | dep_rabbitmq_java_client = git_rmq rabbitmq-java-client $(current_rmq_ref) $(base_rmq_ref) master 65 | dep_rabbitmq_jms_client = git_rmq rabbitmq-jms-client $(current_rmq_ref) $(base_rmq_ref) master 66 | dep_rabbitmq_jms_cts = git_rmq rabbitmq-jms-cts $(current_rmq_ref) $(base_rmq_ref) master 67 | dep_rabbitmq_jms_topic_exchange = git_rmq rabbitmq-jms-topic-exchange $(current_rmq_ref) $(base_rmq_ref) master 68 | dep_rabbitmq_lvc_exchange = git_rmq rabbitmq-lvc-exchange $(current_rmq_ref) $(base_rmq_ref) master 69 | dep_rabbitmq_management = git_rmq rabbitmq-management $(current_rmq_ref) $(base_rmq_ref) master 70 | dep_rabbitmq_management_agent = git_rmq rabbitmq-management-agent $(current_rmq_ref) $(base_rmq_ref) master 71 | dep_rabbitmq_management_exchange = git_rmq rabbitmq-management-exchange $(current_rmq_ref) $(base_rmq_ref) master 72 | dep_rabbitmq_management_themes = git_rmq rabbitmq-management-themes $(current_rmq_ref) $(base_rmq_ref) master 73 | dep_rabbitmq_message_timestamp = git_rmq rabbitmq-message-timestamp $(current_rmq_ref) $(base_rmq_ref) master 74 | dep_rabbitmq_metronome = git_rmq rabbitmq-metronome $(current_rmq_ref) $(base_rmq_ref) master 75 | dep_rabbitmq_mqtt = git_rmq rabbitmq-mqtt $(current_rmq_ref) $(base_rmq_ref) master 76 | dep_rabbitmq_objc_client = git_rmq rabbitmq-objc-client $(current_rmq_ref) $(base_rmq_ref) master 77 | dep_rabbitmq_peer_discovery_aws = git_rmq rabbitmq-peer-discovery-aws $(current_rmq_ref) $(base_rmq_ref) master 78 | dep_rabbitmq_peer_discovery_common = git_rmq rabbitmq-peer-discovery-common $(current_rmq_ref) $(base_rmq_ref) master 79 | dep_rabbitmq_peer_discovery_consul = git_rmq rabbitmq-peer-discovery-consul $(current_rmq_ref) $(base_rmq_ref) master 80 | dep_rabbitmq_peer_discovery_etcd = git_rmq rabbitmq-peer-discovery-etcd $(current_rmq_ref) $(base_rmq_ref) master 81 | dep_rabbitmq_peer_discovery_k8s = git_rmq rabbitmq-peer-discovery-k8s $(current_rmq_ref) $(base_rmq_ref) master 82 | dep_rabbitmq_prometheus = git_rmq rabbitmq-prometheus $(current_rmq_ref) $(base_rmq_ref) master 83 | dep_rabbitmq_random_exchange = git_rmq rabbitmq-random-exchange $(current_rmq_ref) $(base_rmq_ref) master 84 | dep_rabbitmq_recent_history_exchange = git_rmq rabbitmq-recent-history-exchange $(current_rmq_ref) $(base_rmq_ref) master 85 | dep_rabbitmq_routing_node_stamp = git_rmq rabbitmq-routing-node-stamp $(current_rmq_ref) $(base_rmq_ref) master 86 | dep_rabbitmq_rtopic_exchange = git_rmq rabbitmq-rtopic-exchange $(current_rmq_ref) $(base_rmq_ref) master 87 | dep_rabbitmq_server_release = git_rmq rabbitmq-server-release $(current_rmq_ref) $(base_rmq_ref) master 88 | dep_rabbitmq_sharding = git_rmq rabbitmq-sharding $(current_rmq_ref) $(base_rmq_ref) master 89 | dep_rabbitmq_shovel = git_rmq rabbitmq-shovel $(current_rmq_ref) $(base_rmq_ref) master 90 | dep_rabbitmq_shovel_management = git_rmq rabbitmq-shovel-management $(current_rmq_ref) $(base_rmq_ref) master 91 | dep_rabbitmq_stomp = git_rmq rabbitmq-stomp $(current_rmq_ref) $(base_rmq_ref) master 92 | dep_rabbitmq_stream = git_rmq rabbitmq-stream $(current_rmq_ref) $(base_rmq_ref) master 93 | dep_rabbitmq_toke = git_rmq rabbitmq-toke $(current_rmq_ref) $(base_rmq_ref) master 94 | dep_rabbitmq_top = git_rmq rabbitmq-top $(current_rmq_ref) $(base_rmq_ref) master 95 | dep_rabbitmq_tracing = git_rmq rabbitmq-tracing $(current_rmq_ref) $(base_rmq_ref) master 96 | dep_rabbitmq_trust_store = git_rmq rabbitmq-trust-store $(current_rmq_ref) $(base_rmq_ref) master 97 | dep_rabbitmq_test = git_rmq rabbitmq-test $(current_rmq_ref) $(base_rmq_ref) master 98 | dep_rabbitmq_web_dispatch = git_rmq rabbitmq-web-dispatch $(current_rmq_ref) $(base_rmq_ref) master 99 | dep_rabbitmq_web_stomp = git_rmq rabbitmq-web-stomp $(current_rmq_ref) $(base_rmq_ref) master 100 | dep_rabbitmq_web_stomp_examples = git_rmq rabbitmq-web-stomp-examples $(current_rmq_ref) $(base_rmq_ref) master 101 | dep_rabbitmq_web_mqtt = git_rmq rabbitmq-web-mqtt $(current_rmq_ref) $(base_rmq_ref) master 102 | dep_rabbitmq_web_mqtt_examples = git_rmq rabbitmq-web-mqtt-examples $(current_rmq_ref) $(base_rmq_ref) master 103 | dep_rabbitmq_website = git_rmq rabbitmq-website $(current_rmq_ref) $(base_rmq_ref) live master 104 | dep_toke = git_rmq toke $(current_rmq_ref) $(base_rmq_ref) master 105 | 106 | dep_rabbitmq_public_umbrella = git_rmq rabbitmq-public-umbrella $(current_rmq_ref) $(base_rmq_ref) master 107 | 108 | # Third-party dependencies version pinning. 109 | # 110 | # We do that in this file, which is copied in all projects, to ensure 111 | # all projects use the same versions. It avoids conflicts and makes it 112 | # possible to work with rabbitmq-public-umbrella. 113 | 114 | dep_accept = hex 0.3.5 115 | dep_cowboy = hex 2.8.0 116 | dep_cowlib = hex 2.9.1 117 | dep_jsx = hex 2.11.0 118 | dep_lager = hex 3.8.0 119 | dep_prometheus = git https://github.com/deadtrickster/prometheus.erl.git master 120 | dep_ra = git https://github.com/rabbitmq/ra.git master 121 | dep_ranch = hex 1.7.1 122 | dep_recon = hex 2.5.1 123 | dep_observer_cli = hex 1.5.4 124 | dep_stdout_formatter = hex 0.2.4 125 | dep_sysmon_handler = hex 1.3.0 126 | 127 | RABBITMQ_COMPONENTS = amqp_client \ 128 | amqp10_common \ 129 | amqp10_client \ 130 | rabbit \ 131 | rabbit_common \ 132 | rabbitmq_amqp1_0 \ 133 | rabbitmq_auth_backend_amqp \ 134 | rabbitmq_auth_backend_cache \ 135 | rabbitmq_auth_backend_http \ 136 | rabbitmq_auth_backend_ldap \ 137 | rabbitmq_auth_backend_oauth2 \ 138 | rabbitmq_auth_mechanism_ssl \ 139 | rabbitmq_aws \ 140 | rabbitmq_boot_steps_visualiser \ 141 | rabbitmq_cli \ 142 | rabbitmq_codegen \ 143 | rabbitmq_consistent_hash_exchange \ 144 | rabbitmq_ct_client_helpers \ 145 | rabbitmq_ct_helpers \ 146 | rabbitmq_delayed_message_exchange \ 147 | rabbitmq_dotnet_client \ 148 | rabbitmq_event_exchange \ 149 | rabbitmq_federation \ 150 | rabbitmq_federation_management \ 151 | rabbitmq_java_client \ 152 | rabbitmq_jms_client \ 153 | rabbitmq_jms_cts \ 154 | rabbitmq_jms_topic_exchange \ 155 | rabbitmq_lvc_exchange \ 156 | rabbitmq_management \ 157 | rabbitmq_management_agent \ 158 | rabbitmq_management_exchange \ 159 | rabbitmq_management_themes \ 160 | rabbitmq_message_timestamp \ 161 | rabbitmq_metronome \ 162 | rabbitmq_mqtt \ 163 | rabbitmq_objc_client \ 164 | rabbitmq_peer_discovery_aws \ 165 | rabbitmq_peer_discovery_common \ 166 | rabbitmq_peer_discovery_consul \ 167 | rabbitmq_peer_discovery_etcd \ 168 | rabbitmq_peer_discovery_k8s \ 169 | rabbitmq_prometheus \ 170 | rabbitmq_random_exchange \ 171 | rabbitmq_recent_history_exchange \ 172 | rabbitmq_routing_node_stamp \ 173 | rabbitmq_rtopic_exchange \ 174 | rabbitmq_server_release \ 175 | rabbitmq_sharding \ 176 | rabbitmq_shovel \ 177 | rabbitmq_shovel_management \ 178 | rabbitmq_stomp \ 179 | rabbitmq_stream \ 180 | rabbitmq_toke \ 181 | rabbitmq_top \ 182 | rabbitmq_tracing \ 183 | rabbitmq_trust_store \ 184 | rabbitmq_web_dispatch \ 185 | rabbitmq_web_mqtt \ 186 | rabbitmq_web_mqtt_examples \ 187 | rabbitmq_web_stomp \ 188 | rabbitmq_web_stomp_examples \ 189 | rabbitmq_website 190 | 191 | # Erlang.mk does not rebuild dependencies by default, once they were 192 | # compiled once, except for those listed in the `$(FORCE_REBUILD)` 193 | # variable. 194 | # 195 | # We want all RabbitMQ components to always be rebuilt: this eases 196 | # the work on several components at the same time. 197 | 198 | FORCE_REBUILD = $(RABBITMQ_COMPONENTS) 199 | 200 | # Several components have a custom erlang.mk/build.config, mainly 201 | # to disable eunit. Therefore, we can't use the top-level project's 202 | # erlang.mk copy. 203 | NO_AUTOPATCH += $(RABBITMQ_COMPONENTS) 204 | 205 | ifeq ($(origin current_rmq_ref),undefined) 206 | ifneq ($(wildcard .git),) 207 | current_rmq_ref := $(shell (\ 208 | ref=$$(LANG=C git branch --list | awk '/^\* \(.*detached / {ref=$$0; sub(/.*detached [^ ]+ /, "", ref); sub(/\)$$/, "", ref); print ref; exit;} /^\* / {ref=$$0; sub(/^\* /, "", ref); print ref; exit}');\ 209 | if test "$$(git rev-parse --short HEAD)" != "$$ref"; then echo "$$ref"; fi)) 210 | else 211 | current_rmq_ref := master 212 | endif 213 | endif 214 | export current_rmq_ref 215 | 216 | ifeq ($(origin base_rmq_ref),undefined) 217 | ifneq ($(wildcard .git),) 218 | possible_base_rmq_ref := master 219 | ifeq ($(possible_base_rmq_ref),$(current_rmq_ref)) 220 | base_rmq_ref := $(current_rmq_ref) 221 | else 222 | base_rmq_ref := $(shell \ 223 | (git rev-parse --verify -q master >/dev/null && \ 224 | git rev-parse --verify -q $(possible_base_rmq_ref) >/dev/null && \ 225 | git merge-base --is-ancestor $$(git merge-base master HEAD) $(possible_base_rmq_ref) && \ 226 | echo $(possible_base_rmq_ref)) || \ 227 | echo master) 228 | endif 229 | else 230 | base_rmq_ref := master 231 | endif 232 | endif 233 | export base_rmq_ref 234 | 235 | # Repository URL selection. 236 | # 237 | # First, we infer other components' location from the current project 238 | # repository URL, if it's a Git repository: 239 | # - We take the "origin" remote URL as the base 240 | # - The current project name and repository name is replaced by the 241 | # target's properties: 242 | # eg. rabbitmq-common is replaced by rabbitmq-codegen 243 | # eg. rabbit_common is replaced by rabbitmq_codegen 244 | # 245 | # If cloning from this computed location fails, we fallback to RabbitMQ 246 | # upstream which is GitHub. 247 | 248 | # Macro to transform eg. "rabbit_common" to "rabbitmq-common". 249 | rmq_cmp_repo_name = $(word 2,$(dep_$(1))) 250 | 251 | # Upstream URL for the current project. 252 | RABBITMQ_COMPONENT_REPO_NAME := $(call rmq_cmp_repo_name,$(PROJECT)) 253 | RABBITMQ_UPSTREAM_FETCH_URL ?= https://github.com/rabbitmq/$(RABBITMQ_COMPONENT_REPO_NAME).git 254 | RABBITMQ_UPSTREAM_PUSH_URL ?= git@github.com:rabbitmq/$(RABBITMQ_COMPONENT_REPO_NAME).git 255 | 256 | # Current URL for the current project. If this is not a Git clone, 257 | # default to the upstream Git repository. 258 | ifneq ($(wildcard .git),) 259 | git_origin_fetch_url := $(shell git config remote.origin.url) 260 | git_origin_push_url := $(shell git config remote.origin.pushurl || git config remote.origin.url) 261 | RABBITMQ_CURRENT_FETCH_URL ?= $(git_origin_fetch_url) 262 | RABBITMQ_CURRENT_PUSH_URL ?= $(git_origin_push_url) 263 | else 264 | RABBITMQ_CURRENT_FETCH_URL ?= $(RABBITMQ_UPSTREAM_FETCH_URL) 265 | RABBITMQ_CURRENT_PUSH_URL ?= $(RABBITMQ_UPSTREAM_PUSH_URL) 266 | endif 267 | 268 | # Macro to replace the following pattern: 269 | # 1. /foo.git -> /bar.git 270 | # 2. /foo -> /bar 271 | # 3. /foo/ -> /bar/ 272 | subst_repo_name = $(patsubst %/$(1)/%,%/$(2)/%,$(patsubst %/$(1),%/$(2),$(patsubst %/$(1).git,%/$(2).git,$(3)))) 273 | 274 | # Macro to replace both the project's name (eg. "rabbit_common") and 275 | # repository name (eg. "rabbitmq-common") by the target's equivalent. 276 | # 277 | # This macro is kept on one line because we don't want whitespaces in 278 | # the returned value, as it's used in $(dep_fetch_git_rmq) in a shell 279 | # single-quoted string. 280 | dep_rmq_repo = $(if $(dep_$(2)),$(call subst_repo_name,$(PROJECT),$(2),$(call subst_repo_name,$(RABBITMQ_COMPONENT_REPO_NAME),$(call rmq_cmp_repo_name,$(2)),$(1))),$(pkg_$(1)_repo)) 281 | 282 | dep_rmq_commits = $(if $(dep_$(1)), \ 283 | $(wordlist 3,$(words $(dep_$(1))),$(dep_$(1))), \ 284 | $(pkg_$(1)_commit)) 285 | 286 | define dep_fetch_git_rmq 287 | fetch_url1='$(call dep_rmq_repo,$(RABBITMQ_CURRENT_FETCH_URL),$(1))'; \ 288 | fetch_url2='$(call dep_rmq_repo,$(RABBITMQ_UPSTREAM_FETCH_URL),$(1))'; \ 289 | if test "$$$$fetch_url1" != '$(RABBITMQ_CURRENT_FETCH_URL)' && \ 290 | git clone -q -n -- "$$$$fetch_url1" $(DEPS_DIR)/$(call dep_name,$(1)); then \ 291 | fetch_url="$$$$fetch_url1"; \ 292 | push_url='$(call dep_rmq_repo,$(RABBITMQ_CURRENT_PUSH_URL),$(1))'; \ 293 | elif git clone -q -n -- "$$$$fetch_url2" $(DEPS_DIR)/$(call dep_name,$(1)); then \ 294 | fetch_url="$$$$fetch_url2"; \ 295 | push_url='$(call dep_rmq_repo,$(RABBITMQ_UPSTREAM_PUSH_URL),$(1))'; \ 296 | fi; \ 297 | cd $(DEPS_DIR)/$(call dep_name,$(1)) && ( \ 298 | $(foreach ref,$(call dep_rmq_commits,$(1)), \ 299 | git checkout -q $(ref) >/dev/null 2>&1 || \ 300 | ) \ 301 | (echo "error: no valid pathspec among: $(call dep_rmq_commits,$(1))" \ 302 | 1>&2 && false) ) && \ 303 | (test "$$$$fetch_url" = "$$$$push_url" || \ 304 | git remote set-url --push origin "$$$$push_url") 305 | endef 306 | 307 | # -------------------------------------------------------------------- 308 | # Component distribution. 309 | # -------------------------------------------------------------------- 310 | 311 | list-dist-deps:: 312 | @: 313 | 314 | prepare-dist:: 315 | @: 316 | 317 | # -------------------------------------------------------------------- 318 | # Umbrella-specific settings. 319 | # -------------------------------------------------------------------- 320 | 321 | # If the top-level project is a RabbitMQ component, we override 322 | # $(DEPS_DIR) for this project to point to the top-level's one. 323 | # 324 | # We also verify that the guessed DEPS_DIR is actually named `deps`, 325 | # to rule out any situation where it is a coincidence that we found a 326 | # `rabbitmq-components.mk` up upper directories. 327 | 328 | possible_deps_dir_1 = $(abspath ..) 329 | possible_deps_dir_2 = $(abspath ../../..) 330 | 331 | ifeq ($(notdir $(possible_deps_dir_1)),deps) 332 | ifneq ($(wildcard $(possible_deps_dir_1)/../rabbitmq-components.mk),) 333 | deps_dir_overriden = 1 334 | DEPS_DIR ?= $(possible_deps_dir_1) 335 | DISABLE_DISTCLEAN = 1 336 | endif 337 | endif 338 | 339 | ifeq ($(deps_dir_overriden),) 340 | ifeq ($(notdir $(possible_deps_dir_2)),deps) 341 | ifneq ($(wildcard $(possible_deps_dir_2)/../rabbitmq-components.mk),) 342 | deps_dir_overriden = 1 343 | DEPS_DIR ?= $(possible_deps_dir_2) 344 | DISABLE_DISTCLEAN = 1 345 | endif 346 | endif 347 | endif 348 | 349 | ifneq ($(wildcard UMBRELLA.md),) 350 | DISABLE_DISTCLEAN = 1 351 | endif 352 | 353 | # We disable `make distclean` so $(DEPS_DIR) is not accidentally removed. 354 | 355 | ifeq ($(DISABLE_DISTCLEAN),1) 356 | ifneq ($(filter distclean distclean-deps,$(MAKECMDGOALS)),) 357 | SKIP_DEPS = 1 358 | endif 359 | endif 360 | -------------------------------------------------------------------------------- /src/rabbit_jms_topic_exchange.erl: -------------------------------------------------------------------------------- 1 | %% This Source Code Form is subject to the terms of the Mozilla Public 2 | %% License, v. 2.0. If a copy of the MPL was not distributed with this 3 | %% file, You can obtain one at https://mozilla.org/MPL/2.0/. 4 | %% 5 | %% Copyright (c) 2012-2020 VMware, Inc. or its affiliates. All rights reserved. 6 | %% ----------------------------------------------------------------------------- 7 | 8 | %% JMS on Rabbit Selector Exchange plugin 9 | 10 | %% ----------------------------------------------------------------------------- 11 | -module(rabbit_jms_topic_exchange). 12 | 13 | -behaviour(rabbit_exchange_type). 14 | 15 | -include_lib("rabbit_common/include/rabbit.hrl"). 16 | -include_lib("rabbit_common/include/rabbit_framing.hrl"). 17 | -include("rabbit_jms_topic_exchange.hrl"). 18 | 19 | %% Rabbit exchange type functions: 20 | -export([ description/0 21 | , serialise_events/0 22 | , route/2 23 | , validate/1 24 | , create/2 25 | , delete/3 26 | , validate_binding/2 27 | , add_binding/3 28 | , remove_bindings/3 29 | , assert_args_equivalence/2 30 | , policy_changed/2 ]). 31 | 32 | %% Initialisation of database function: 33 | -export([setup_db_schema/0]). 34 | 35 | -export([info/1, info/2]). 36 | 37 | %%---------------------------------------------------------------------------- 38 | 39 | %% Register exchange type 40 | -rabbit_boot_step({ ?MODULE 41 | , [ {description, "exchange type JMS topic selector"} 42 | , {mfa, {rabbit_registry, register, [exchange, ?X_TYPE_NAME, ?MODULE]}} 43 | , {cleanup, {rabbit_registry, unregister, [exchange, ?X_TYPE_NAME]}} 44 | , {requires, rabbit_registry} 45 | , {enables, kernel_ready} ] }). 46 | 47 | %% Initialise database 48 | -rabbit_boot_step({ rabbit_jms_topic_exchange_mnesia 49 | , [ {description, "database exchange type JMS topic selector"} 50 | , {mfa, {?MODULE, setup_db_schema, []}} 51 | , {requires, database} 52 | , {enables, external_infrastructure} ] }). 53 | 54 | %%---------------------------------------------------------------------------- 55 | 56 | % Initialise database table for all exchanges of type <<"x-jms-topic">> 57 | setup_db_schema() -> 58 | case mnesia:create_table( ?JMS_TOPIC_TABLE 59 | , [ {attributes, record_info(fields, ?JMS_TOPIC_RECORD)} 60 | , {record_name, ?JMS_TOPIC_RECORD} 61 | , {type, set} ] 62 | ) of 63 | {atomic, ok} -> ok; 64 | {aborted, {already_exists, ?JMS_TOPIC_TABLE}} -> ok 65 | end. 66 | 67 | %%---------------------------------------------------------------------------- 68 | %% R E F E R E N C E T Y P E I N F O R M A T I O N 69 | 70 | %% -type(binding() :: 71 | %% #binding{source :: rabbit_exchange:name(), 72 | %% destination :: binding_destination(), 73 | %% key :: rabbit_binding:key(), 74 | %% args :: rabbit_framing:amqp_table()}). 75 | %% 76 | %% -type(exchange() :: 77 | %% #exchange{name :: rabbit_exchange:name(), 78 | %% type :: rabbit_exchange:type(), 79 | %% durable :: boolean(), 80 | %% auto_delete :: boolean(), 81 | %% arguments :: rabbit_framing:amqp_table()}). 82 | %% 83 | %% -type(amqp_field_type() :: 84 | %% 'longstr' | 'signedint' | 'decimal' | 'timestamp' | 85 | %% 'table' | 'byte' | 'double' | 'float' | 'long' | 86 | %% 'short' | 'bool' | 'binary' | 'void' | 'array'). 87 | 88 | %%---------------------------------------------------------------------------- 89 | %% E X P O R T E D E X C H A N G E B E H A V I O U R 90 | 91 | % Exchange description 92 | description() -> [ {name, <<"jms-selector">>} 93 | , {description, <<"JMS selector exchange">>} ]. 94 | 95 | % Binding event serialisation 96 | serialise_events() -> false. 97 | 98 | % Route messages 99 | route( #exchange{name = XName} 100 | , #delivery{message = #basic_message{content = MessageContent, routing_keys = RKs}} 101 | ) -> 102 | BindingFuns = get_binding_funs_x(XName), 103 | match_bindings(XName, RKs, MessageContent, BindingFuns). 104 | 105 | 106 | % Before exchange declaration 107 | validate(_X) -> ok. 108 | 109 | % After exchange declaration and recovery 110 | create(transaction, #exchange{name = XName}) -> 111 | add_initial_record(XName); 112 | create(_Tx, _X) -> 113 | ok. 114 | 115 | % Delete an exchange 116 | delete(transaction, #exchange{name = XName}, _Bs) -> 117 | delete_state(XName), 118 | ok; 119 | delete(_Tx, _X, _Bs) -> 120 | ok. 121 | 122 | % Before add binding 123 | validate_binding(_X, _B) -> ok. 124 | 125 | % A new binding has ben added or recovered 126 | add_binding( Tx 127 | , #exchange{name = XName} 128 | , #binding{key = BindingKey, destination = Dest, args = Args} 129 | ) -> 130 | Selector = get_string_arg(Args, ?RJMS_COMPILED_SELECTOR_ARG), 131 | BindGen = generate_binding_fun(Selector), 132 | case {Tx, BindGen} of 133 | {transaction, {ok, BindFun}} -> 134 | add_binding_fun(XName, {{BindingKey, Dest}, BindFun}); 135 | {none, {error, _}} -> 136 | parsing_error(XName, Selector, Dest); 137 | _ -> 138 | ok 139 | end, 140 | ok. 141 | 142 | % Binding removal 143 | remove_bindings( transaction 144 | , #exchange{name = XName} 145 | , Bindings 146 | ) -> 147 | remove_binding_funs(XName, Bindings), 148 | ok; 149 | remove_bindings(_Tx, _X, _Bs) -> 150 | ok. 151 | 152 | % Exchange argument equivalence 153 | assert_args_equivalence(X, Args) -> 154 | rabbit_exchange:assert_args_equivalence(X, Args). 155 | 156 | % Policy change notifications ignored 157 | policy_changed(_X1, _X2) -> ok. 158 | 159 | % Stub for type-specific exchange information 160 | info(_X) -> []. 161 | info(_X, _) -> []. 162 | 163 | 164 | %%---------------------------------------------------------------------------- 165 | %% P R I V A T E F U N C T I O N S 166 | 167 | % Get a string argument from the args or arguments parameters 168 | get_string_arg(Args, ArgName) -> get_string_arg(Args, ArgName, error). 169 | 170 | get_string_arg(Args, ArgName, Default) -> 171 | case rabbit_misc:table_lookup(Args, ArgName) of 172 | {longstr, BinVal} -> binary_to_list(BinVal); 173 | _ -> Default 174 | end. 175 | 176 | % Match bindings for the current message 177 | match_bindings( XName, _RoutingKeys, MessageContent, BindingFuns) -> 178 | MessageHeaders = get_headers(MessageContent), 179 | rabbit_router:match_bindings( XName 180 | , fun(#binding{key = Key, destination = Dest}) -> 181 | binding_fun_match({Key, Dest}, MessageHeaders, BindingFuns) 182 | end 183 | ). 184 | 185 | % Select binding function from Funs dictionary, apply it to Headers and return result (true|false) 186 | binding_fun_match(DictKey, Headers, FunsDict) -> 187 | case dict:find(DictKey, FunsDict) of 188 | {ok, Fun} when is_function(Fun, 1) -> Fun(Headers); 189 | error -> false % do not match if no function found 190 | end. 191 | 192 | % get Headers from message content 193 | get_headers(Content) -> 194 | case (Content#content.properties)#'P_basic'.headers of 195 | undefined -> []; 196 | H -> rabbit_misc:sort_field_table(H) 197 | end. 198 | 199 | % generate the function that checks the message against the selector 200 | generate_binding_fun(ERL) -> 201 | case decode_term(ERL) of 202 | {error, _} -> error; 203 | {ok, ErlTerm} -> check_fun(ErlTerm) 204 | end. 205 | 206 | % build checking function from compiled expression 207 | check_fun(CompiledExp) -> 208 | { ok, 209 | fun(Headers) -> 210 | selector_match(CompiledExp, Headers) 211 | end 212 | }. 213 | 214 | % get an erlang term from a string 215 | decode_term(Str) -> 216 | try 217 | {ok, Ts, _} = erl_scan:string(Str), 218 | {ok, Term} = erl_parse:parse_term(Ts), 219 | {ok, Term} 220 | catch 221 | Err -> {error, {invalid_erlang_term, Err}} 222 | end. 223 | 224 | % Evaluate the selector and check against the Headers 225 | selector_match(Selector, Headers) -> 226 | case sjx_evaluator:evaluate(Selector, Headers) of 227 | true -> true; 228 | _ -> false 229 | end. 230 | 231 | % get binding funs from state (using dirty_reads) 232 | get_binding_funs_x(XName) -> 233 | mnesia:async_dirty( 234 | fun() -> 235 | #?JMS_TOPIC_RECORD{x_selector_funs = BindingFuns} = read_state(XName), 236 | BindingFuns 237 | end, 238 | [] 239 | ). 240 | 241 | add_initial_record(XName) -> 242 | write_state_fun(XName, dict:new()). 243 | 244 | % add binding fun to binding fun dictionary 245 | add_binding_fun(XName, BindingKeyAndFun) -> 246 | #?JMS_TOPIC_RECORD{x_selector_funs = BindingFuns} = read_state_for_update(XName), 247 | write_state_fun(XName, put_item(BindingFuns, BindingKeyAndFun)). 248 | 249 | % remove binding funs from binding fun dictionary 250 | remove_binding_funs(XName, Bindings) -> 251 | BindingKeys = [ {BindingKey, DestName} || #binding{key = BindingKey, destination = DestName} <- Bindings ], 252 | #?JMS_TOPIC_RECORD{x_selector_funs = BindingFuns} = read_state_for_update(XName), 253 | write_state_fun(XName, remove_items(BindingFuns, BindingKeys)). 254 | 255 | % add an item to the dictionary of binding functions 256 | put_item(Dict, {Key, Item}) -> dict:store(Key, Item, Dict). 257 | 258 | % remove a list of keyed items from the dictionary, by key 259 | remove_items(Dict, []) -> Dict; 260 | remove_items(Dict, [Key | Keys]) -> remove_items(dict:erase(Key, Dict), Keys). 261 | 262 | % delete all the state saved for this exchange 263 | delete_state(XName) -> 264 | mnesia:delete(?JMS_TOPIC_TABLE, XName, write). 265 | 266 | % Basic read for update 267 | read_state_for_update(XName) -> read_state(XName, write). 268 | 269 | % Basic read 270 | read_state(XName) -> read_state(XName, read). 271 | 272 | % Lockable read 273 | read_state(XName, Lock) -> 274 | case mnesia:read(?JMS_TOPIC_TABLE, XName, Lock) of 275 | [Rec] -> Rec; 276 | _ -> exchange_state_corrupt_error(XName) 277 | end. 278 | 279 | % Basic write 280 | write_state_fun(XName, BFuns) -> 281 | mnesia:write( ?JMS_TOPIC_TABLE 282 | , #?JMS_TOPIC_RECORD{x_name = XName, x_selector_funs = BFuns} 283 | , write ). 284 | 285 | %%---------------------------------------------------------------------------- 286 | %% E R R O R S 287 | 288 | % state error 289 | exchange_state_corrupt_error(#resource{name = XName}) -> 290 | rabbit_misc:protocol_error( internal_error 291 | , "exchange named '~s' has no saved state or incorrect saved state" 292 | , [XName] ). 293 | 294 | % parsing error 295 | parsing_error(#resource{name = XName}, S, #resource{name = DestName}) -> 296 | rabbit_misc:protocol_error( precondition_failed 297 | , "cannot parse selector '~p' binding destination '~s' to exchange '~s'" 298 | , [S, DestName, XName] ). 299 | 300 | %%---------------------------------------------------------------------------- 301 | -------------------------------------------------------------------------------- /src/sjx_evaluator.erl: -------------------------------------------------------------------------------- 1 | %% This Source Code Form is subject to the terms of the Mozilla Public 2 | %% License, v. 2.0. If a copy of the MPL was not distributed with this 3 | %% file, You can obtain one at https://mozilla.org/MPL/2.0/. 4 | %% 5 | %% Copyright (c) 2012-2020 VMware, Inc. or its affiliates. All rights reserved. 6 | %% ----------------------------------------------------------------------------- 7 | %% Derived from works which were: 8 | %% Copyright (c) 2002, 2012 Tim Watson (watson.timothy@gmail.com) 9 | %% Copyright (c) 2012, 2013 Steve Powell (Zteve.Powell@gmail.com) 10 | %% ----------------------------------------------------------------------------- 11 | 12 | %% Evaluate an SQL expression for filtering purposes 13 | 14 | %% ----------------------------------------------------------------------------- 15 | 16 | -module(sjx_evaluator). 17 | 18 | -export([evaluate/2]). 19 | %% Evaluation function 20 | %% 21 | %% Given Headers (a list of keyed typed values), and a 22 | %% parsed SQL string, evaluate the truth or falsity of the expression. 23 | %% 24 | %% If an identifier is absent from Headers, or the types do not match the comparisons, the 25 | %% expression will evaluate to false. 26 | 27 | -type itemname() :: binary(). 28 | -type itemtype() :: 29 | 'longstr' | 'signedint' | 'byte' | 'double' | 'float' | 'long' | 'short' | 'bool'. 30 | -type itemvalue() :: any(). 31 | 32 | -type tableitem() :: { itemname(), itemtype(), itemvalue() }. 33 | -type table() :: list(tableitem()). 34 | 35 | -type expression() :: any(). 36 | 37 | -spec evaluate(expression(), table()) -> true | false | error. 38 | 39 | 40 | evaluate( true, _Headers ) -> true; 41 | evaluate( false, _Headers ) -> false; 42 | 43 | evaluate( {'not', Exp }, Headers ) -> not3(evaluate(Exp, Headers)); 44 | evaluate( {'ident', Ident }, Headers ) -> lookup_value(Headers, Ident); 45 | evaluate( {'is_null', Exp }, Headers ) -> val_of(Exp, Headers) =:= undefined; 46 | evaluate( {'not_null', Exp }, Headers ) -> val_of(Exp, Headers) =/= undefined; 47 | evaluate( { Op, Exp }, Headers ) -> do_una_op(Op, evaluate(Exp, Headers)); 48 | 49 | evaluate( {'and', Exp1, Exp2 }, Headers ) -> and3(evaluate(Exp1, Headers), evaluate(Exp2, Headers)); 50 | evaluate( {'or', Exp1, Exp2 }, Headers ) -> or3(evaluate(Exp1, Headers), evaluate(Exp2, Headers)); 51 | evaluate( {'like', LHS, Patt, Esc }, Headers ) -> isLike(val_of(LHS, Headers), {Patt, Esc}); 52 | evaluate( {'not_like', LHS, Patt, Esc }, Headers ) -> not3(isLike(val_of(LHS, Headers), {Patt, Esc})); 53 | evaluate( { Op, Exp, {range, From, To} }, Headers ) -> evaluate({ Op, Exp, From, To }, Headers); 54 | evaluate( {'between', Exp, From, To}, Hs ) -> between(evaluate(Exp, Hs), evaluate(From, Hs), evaluate(To, Hs)); 55 | evaluate( {'not_between', Exp, From, To}, Hs ) -> not3(between(evaluate(Exp, Hs), evaluate(From, Hs), evaluate(To, Hs))); 56 | evaluate( { Op, LHS, RHS }, Headers ) -> do_bin_op(Op, evaluate(LHS, Headers), evaluate(RHS, Headers)); 57 | 58 | evaluate( Value, _Headers ) -> Value. 59 | 60 | not3(true ) -> false; 61 | not3(false) -> true; 62 | not3(_ ) -> undefined. 63 | 64 | and3(true, true ) -> true; 65 | and3(false, _ ) -> false; 66 | and3(_, false) -> false; 67 | and3(_, _ ) -> undefined. 68 | 69 | or3(false, false) -> false; 70 | or3(true, _ ) -> true; 71 | or3(_, true ) -> true; 72 | or3(_, _ ) -> undefined. 73 | 74 | do_una_op(_, undefined) -> undefined; 75 | do_una_op('-', E) -> -E; 76 | do_una_op('+', E) -> +E; 77 | do_una_op(_, _) -> error. 78 | 79 | do_bin_op(_, undefined, _) -> undefined; 80 | do_bin_op(_, _, undefined ) -> undefined; 81 | do_bin_op('=' , L, R) -> L == R; 82 | do_bin_op('<>', L, R) -> L /= R; 83 | do_bin_op('>' , L, R) -> L > R; 84 | do_bin_op('<' , L, R) -> L < R; 85 | do_bin_op('>=', L, R) -> L >= R; 86 | do_bin_op('<=', L, R) -> L =< R; 87 | do_bin_op('in', L, R) -> isIn(L, R); 88 | do_bin_op('not_in', L, R) -> not isIn(L, R); 89 | do_bin_op('+' , L, R) -> L + R; 90 | do_bin_op('-' , L, R) -> L - R; 91 | do_bin_op('*' , L, R) -> L * R; 92 | do_bin_op('/' , L, R) when R /= 0 -> L / R; 93 | do_bin_op('/' , L, R) when L > 0 andalso R == 0 -> plus_infinity; 94 | do_bin_op('/' , L, R) when L < 0 andalso R == 0 -> minus_infinity; 95 | do_bin_op('/' , L, R) when L == 0 andalso R == 0 -> nan; 96 | do_bin_op(_,_,_) -> error. 97 | 98 | isLike(undefined, _Patt) -> undefined; 99 | isLike(L, {regex, MP}) -> patt_match(L, MP); 100 | isLike(L, {Patt, Esc}) -> patt_match(L, pattern_of(Patt, Esc)). 101 | 102 | patt_match(L, MP) -> 103 | BS = byte_size(L), 104 | case re:run(L, MP, [{capture, first}]) of 105 | {match, [{0, BS}]} -> true; 106 | _ -> false 107 | end. 108 | 109 | isIn(_L, [] ) -> false; 110 | isIn( L, [L|_]) -> true; 111 | isIn( L, [_|R]) -> isIn(L,R). 112 | 113 | val_of({'ident', Ident}, Hs) -> lookup_value(Hs, Ident); 114 | val_of(Value, _Hs) -> Value. 115 | 116 | between(E, F, T) when E =:= undefined orelse F =:= undefined orelse T =:= undefined -> undefined; 117 | between(Value, Lo, Hi) -> Lo =< Value andalso Value =< Hi. 118 | 119 | lookup_value(Table, Key) -> 120 | case lists:keyfind(Key, 1, Table) of 121 | {_, longstr, Value} -> Value; 122 | {_, signedint, Value} -> Value; 123 | {_, float, Value} -> Value; 124 | {_, double, Value} -> Value; 125 | {_, byte, Value} -> Value; 126 | {_, short, Value} -> Value; 127 | {_, long, Value} -> Value; 128 | {_, bool, Value} -> Value; 129 | false -> undefined 130 | end. 131 | 132 | pattern_of(S, Esc) -> compile_re(gen_re(binary_to_list(S), Esc)). 133 | 134 | gen_re(S, <> ) -> convert(S, [], Ch ); 135 | gen_re(S, no_escape) -> convert(S, [], no_escape); 136 | gen_re(_,_) -> error. 137 | 138 | convert([], Acc, _Esc) -> lists:reverse(Acc); 139 | convert([Esc, Ch | Rest], Acc, Esc) -> convert(Rest, [escape(Ch) | Acc], Esc); 140 | convert([$_ | Rest], Acc, Esc) -> convert(Rest, [$. | Acc], Esc); 141 | convert([$% | Rest], Acc, Esc) -> convert(Rest, [".*" | Acc], Esc); 142 | convert([Ch | Rest], Acc, Esc) -> convert(Rest, [escape(Ch) | Acc], Esc). 143 | 144 | escape($.) -> "\\."; 145 | escape($*) -> "\\*"; 146 | escape($+) -> "\\+"; 147 | escape($?) -> "\\?"; 148 | escape($^) -> "\\^"; 149 | escape($=) -> "\\="; 150 | escape($!) -> "\\!"; 151 | escape($:) -> "\\:"; 152 | escape($$) -> "\\$"; 153 | escape(${) -> "\\{"; 154 | escape($}) -> "\\}"; 155 | escape($() -> "\\("; 156 | escape($)) -> "\\)"; 157 | escape($|) -> "\\|"; 158 | escape($[) -> "\\["; 159 | escape($]) -> "\\]"; 160 | escape($/) -> "\\/"; 161 | escape($\\) -> "\\\\"; 162 | escape(Ch) -> Ch. 163 | 164 | compile_re(error) -> error; 165 | compile_re(MatchMany) -> 166 | case re:compile(MatchMany) 167 | of {ok, Rx} -> Rx; 168 | _ -> error 169 | end. 170 | -------------------------------------------------------------------------------- /test/rjms_topic_selector_SUITE.erl: -------------------------------------------------------------------------------- 1 | %% This Source Code Form is subject to the terms of the Mozilla Public 2 | %% License, v. 2.0. If a copy of the MPL was not distributed with this 3 | %% file, You can obtain one at https://mozilla.org/MPL/2.0/. 4 | %% 5 | %% Copyright (c) 2013-2020 VMware, Inc. or its affiliates. All rights reserved. 6 | %% 7 | 8 | -module(rjms_topic_selector_SUITE). 9 | 10 | -compile(export_all). 11 | 12 | -include_lib("common_test/include/ct.hrl"). 13 | -include_lib("amqp_client/include/amqp_client.hrl"). 14 | -include("rabbit_jms_topic_exchange.hrl"). 15 | 16 | -import(rabbit_ct_client_helpers, [open_connection_and_channel/1, 17 | close_connection_and_channel/2]). 18 | 19 | %% Useful test constructors 20 | -define(BSELECTARG(BinStr), {?RJMS_COMPILED_SELECTOR_ARG, longstr, BinStr}). 21 | -define(BASICMSG(Payload, Hdrs), #'amqp_msg'{props=#'P_basic'{headers=Hdrs}, payload=Payload}). 22 | 23 | all() -> 24 | [ 25 | {group, parallel_tests} 26 | ]. 27 | 28 | groups() -> 29 | [ 30 | {parallel_tests, [parallel], [ 31 | test_topic_selection 32 | ]} 33 | ]. 34 | 35 | %% ------------------------------------------------------------------- 36 | %% Test suite setup/teardown. 37 | %% ------------------------------------------------------------------- 38 | 39 | init_per_suite(Config) -> 40 | rabbit_ct_helpers:log_environment(), 41 | Config1 = rabbit_ct_helpers:set_config(Config, [ 42 | {rmq_nodename_suffix, ?MODULE} 43 | ]), 44 | rabbit_ct_helpers:run_setup_steps(Config1, 45 | rabbit_ct_broker_helpers:setup_steps() ++ 46 | rabbit_ct_client_helpers:setup_steps()). 47 | 48 | end_per_suite(Config) -> 49 | rabbit_ct_helpers:run_teardown_steps(Config, 50 | rabbit_ct_client_helpers:teardown_steps() ++ 51 | rabbit_ct_broker_helpers:teardown_steps()). 52 | 53 | init_per_group(_, Config) -> 54 | Config. 55 | 56 | end_per_group(_, Config) -> 57 | Config. 58 | 59 | init_per_testcase(Testcase, Config) -> 60 | rabbit_ct_helpers:testcase_started(Config, Testcase). 61 | 62 | end_per_testcase(Testcase, Config) -> 63 | rabbit_ct_helpers:testcase_finished(Config, Testcase). 64 | 65 | %% ------------------------------------------------------------------- 66 | %% Test cases. 67 | %% ------------------------------------------------------------------- 68 | 69 | test_topic_selection(Config) -> 70 | {Connection, Channel} = open_connection_and_channel(Config), 71 | #'confirm.select_ok'{} = amqp_channel:call(Channel, #'confirm.select'{}), 72 | 73 | Exchange = declare_rjms_exchange(Channel, "rjms_test_topic_selector_exchange", []), 74 | 75 | %% Declare a queue and bind it 76 | Q = declare_queue(Channel), 77 | bind_queue(Channel, Q, Exchange, <<"select-key">>, [?BSELECTARG(<<"{ident, <<\"boolVal\">>}.">>)]), 78 | 79 | publish_two_messages(Channel, Exchange, <<"select-key">>), 80 | amqp_channel:wait_for_confirms(Channel, 5), 81 | 82 | get_and_check(Channel, Q, 0, <<"true">>), 83 | 84 | close_connection_and_channel(Connection, Channel), 85 | ok. 86 | 87 | 88 | %% ------------------------------------------------------------------- 89 | %% Helpers. 90 | %% ------------------------------------------------------------------- 91 | 92 | %% Declare a rjms_topic_selector exchange, with args 93 | declare_rjms_exchange(Ch, XNameStr, XArgs) -> 94 | Exchange = list_to_binary(XNameStr), 95 | Decl = #'exchange.declare'{ exchange = Exchange 96 | , type = <<"x-jms-topic">> 97 | , arguments = XArgs }, 98 | #'exchange.declare_ok'{} = amqp_channel:call(Ch, Decl), 99 | Exchange. 100 | 101 | %% Bind a selector queue to an exchange 102 | bind_queue(Ch, Q, Ex, RKey, Args) -> 103 | Binding = #'queue.bind'{ queue = Q 104 | , exchange = Ex 105 | , routing_key = RKey 106 | , arguments = Args 107 | }, 108 | #'queue.bind_ok'{} = amqp_channel:call(Ch, Binding), 109 | ok. 110 | 111 | %% Declare a queue, return Q name (as binary) 112 | declare_queue(Ch) -> 113 | #'queue.declare_ok'{queue = Q} = amqp_channel:call(Ch, #'queue.declare'{}), 114 | Q. 115 | 116 | %% Get message from Q and check remaining and payload. 117 | get_and_check(Channel, Queue, ExpectedRemaining, ExpectedPayload) -> 118 | Get = #'basic.get'{queue = Queue}, 119 | {#'basic.get_ok'{delivery_tag = Tag, message_count = Remaining}, Content} 120 | = amqp_channel:call(Channel, Get), 121 | amqp_channel:cast(Channel, #'basic.ack'{delivery_tag = Tag}), 122 | 123 | ExpectedRemaining = Remaining, 124 | ExpectedPayload = Content#amqp_msg.payload, 125 | ok. 126 | 127 | publish_two_messages(Chan, Exch, RoutingKey) -> 128 | Publish = #'basic.publish'{exchange = Exch, routing_key = RoutingKey}, 129 | amqp_channel:cast(Chan, Publish, ?BASICMSG(<<"false">>, [{<<"boolVal">>, 'bool', false}])), 130 | amqp_channel:cast(Chan, Publish, ?BASICMSG(<<"true">>, [{<<"boolVal">>, 'bool', true}])), 131 | ok. 132 | -------------------------------------------------------------------------------- /test/rjms_topic_selector_unit_SUITE.erl: -------------------------------------------------------------------------------- 1 | %% This Source Code Form is subject to the terms of the Mozilla Public 2 | %% License, v. 2.0. If a copy of the MPL was not distributed with this 3 | %% file, You can obtain one at https://mozilla.org/MPL/2.0/. 4 | %% 5 | %% Copyright (c) 2012-2020 VMware, Inc. or its affiliates. All rights reserved. 6 | %% ----------------------------------------------------------------------------- 7 | 8 | %% Unit test file for RJMS Topic Selector plugin 9 | 10 | %% ----------------------------------------------------------------------------- 11 | 12 | -module(rjms_topic_selector_unit_SUITE). 13 | 14 | -compile(export_all). 15 | 16 | -include_lib("common_test/include/ct.hrl"). 17 | -include_lib("eunit/include/eunit.hrl"). 18 | -include("rabbit_jms_topic_exchange.hrl"). 19 | -include_lib("amqp_client/include/amqp_client.hrl"). 20 | 21 | -import(rabbit_jms_topic_exchange, [ description/0 22 | , serialise_events/0 23 | , route/2 24 | , validate/1 25 | , create/2 26 | , delete/3 27 | , validate_binding/2 28 | , add_binding/3 29 | , remove_bindings/3 30 | , assert_args_equivalence/2 31 | , policy_changed/3 ]). 32 | 33 | 34 | all() -> 35 | [ 36 | {group, parallel_tests} 37 | ]. 38 | 39 | groups() -> 40 | [ 41 | {parallel_tests, [parallel], [ 42 | description_test, 43 | serialise_events_test, 44 | validate_test, 45 | create_test, 46 | delete_test, 47 | validate_binding_test, 48 | add_binding_test 49 | ]} 50 | ]. 51 | 52 | %% ------------------------------------------------------------------- 53 | %% Test suite setup/teardown. 54 | %% ------------------------------------------------------------------- 55 | 56 | init_per_suite(Config) -> 57 | Config. 58 | 59 | end_per_suite(Config) -> 60 | Config. 61 | 62 | init_per_group(_, Config) -> 63 | Config. 64 | 65 | end_per_group(_, Config) -> 66 | Config. 67 | 68 | init_per_testcase(_Testcase, Config) -> 69 | Config. 70 | 71 | end_per_testcase(_Testcase, Config) -> 72 | Config. 73 | 74 | %% ------------------------------------------------------------------- 75 | %% Test cases. 76 | %% ------------------------------------------------------------------- 77 | 78 | description_test(_Config) -> 79 | ?assertMatch([{name, _}, {description, _}], description()). 80 | 81 | serialise_events_test(_Config) -> 82 | ?assertMatch(false, serialise_events()). 83 | 84 | validate_test(_Config) -> 85 | ?assertEqual(ok, validate(any_exchange)). 86 | 87 | create_test(_Config) -> 88 | ?assertEqual(ok, create(none, any_exchange)). 89 | 90 | delete_test(_Config) -> 91 | ?assertEqual(ok, delete(none, any_exchange, any_bindings)). 92 | 93 | validate_binding_test(_Config) -> 94 | ?assertEqual(ok, validate_binding(any_exchange, any_bindings)). 95 | 96 | add_binding_test(_Config) -> 97 | ?assertEqual(ok, add_binding(none, dummy_exchange(), dummy_binding())). 98 | 99 | dummy_exchange() -> 100 | #exchange{name = <<"XName">>, arguments = []}. 101 | 102 | dummy_binding() -> 103 | #binding{ key = <<"BindingKey">> 104 | , destination = #resource{name = <<"DName">>} 105 | , args = [{?RJMS_COMPILED_SELECTOR_ARG, longstr, <<"<<\"false\">>.">>}]}. 106 | -------------------------------------------------------------------------------- /test/sjx_evaluation_SUITE.erl: -------------------------------------------------------------------------------- 1 | %% This Source Code Form is subject to the terms of the Mozilla Public 2 | %% License, v. 2.0. If a copy of the MPL was not distributed with this 3 | %% file, You can obtain one at https://mozilla.org/MPL/2.0/. 4 | %% 5 | %% Copyright (c) 2012, 2013 Steve Powell (Zteve.Powell@gmail.com) 6 | %% ----------------------------------------------------------------------------- 7 | 8 | %% Tests for sjx_evaluator 9 | 10 | %% ----------------------------------------------------------------------------- 11 | -module(sjx_evaluation_SUITE). 12 | 13 | -compile(export_all). 14 | 15 | -include_lib("common_test/include/ct.hrl"). 16 | -include_lib("eunit/include/eunit.hrl"). 17 | 18 | -import(sjx_evaluator, [evaluate/2]). 19 | 20 | %% Fixed type info for identifiers 21 | %% 22 | -define(TEST_TYPE_INFO, 23 | [ {<<"JMSType">>, longstr, <<"string">>} 24 | , {<<"JMSCorrelationID">>, longstr, <<"string">>} 25 | , {<<"JMSMessageID">>, longstr, <<"string">>} 26 | , {<<"JMSDeliveryMode">>, longstr, <<"string">>} 27 | , {<<"JMSPriority">>, longstr, <<"number">>} 28 | , {<<"JMSTimestamp">>, longstr, <<"number">>} 29 | ]). 30 | 31 | 32 | all() -> 33 | [ 34 | {group, non_parallel_tests} 35 | ]. 36 | 37 | groups() -> 38 | [ 39 | {non_parallel_tests, [], [ 40 | basic_evaluate_test 41 | ]} 42 | ]. 43 | 44 | %% ------------------------------------------------------------------- 45 | %% Test suite setup/teardown. 46 | %% ------------------------------------------------------------------- 47 | 48 | init_per_suite(Config) -> 49 | Config. 50 | 51 | end_per_suite(Config) -> 52 | Config. 53 | 54 | init_per_group(_, Config) -> 55 | Config. 56 | 57 | end_per_group(_, Config) -> 58 | Config. 59 | 60 | init_per_testcase(_Testcase, Config) -> 61 | Config. 62 | 63 | end_per_testcase(_Testcase, Config) -> 64 | Config. 65 | 66 | %% ------------------------------------------------------------------- 67 | %% Test cases. 68 | %% ------------------------------------------------------------------- 69 | 70 | basic_evaluate_test(_Config) -> 71 | Hs = [{<<"JMSType">>, longstr, <<"car">>}, 72 | {<<"colour">>, longstr, <<"blue">>}, 73 | {<<"altcol">>, longstr, <<"'blue">>}, 74 | {<<"likevar">>, longstr, <<"bl_ue">>}, 75 | {<<"weight">>, signedint, 2501}, 76 | {<<"WeIgHt">>, signedint, 2}, 77 | {<<"afloat">>, float, 3.0e-2}, 78 | {<<"abool">>, bool, false}], 79 | 80 | [ ?_assert( eval(Hs, {'=', {'ident', <<"JMSType">>}, <<"car">>} )) 81 | , ?_assert(not eval(Hs, {'ident', <<"abool">>} )) 82 | , ?_assert( eval(Hs, {'not', {'ident', <<"abool">>}} )) 83 | , ?_assert( eval(Hs, {'=', {'ident', <<"colour">>}, <<"blue">>} )) 84 | , ?_assert( eval(Hs, {'=', {'ident', <<"weight">>}, 2501} )) 85 | , ?_assert( eval(Hs, {'=', {'ident', <<"WeIgHt">>}, 2} )) 86 | , ?_assert( eval(Hs, {'=', 2501, {'ident', <<"weight">>}} )) 87 | , ?_assert( eval(Hs, {'=', {'ident', <<"afloat">>}, 3.0e-2} )) 88 | , ?_assert( eval(Hs, {'>', {'ident', <<"weight">>}, 2500} )) 89 | , ?_assert( eval(Hs, {'<', {'ident', <<"weight">>}, 2502} )) 90 | , ?_assert( eval(Hs, {'>=', {'ident', <<"weight">>}, 2501} )) 91 | , ?_assert( eval(Hs, {'<=', {'ident', <<"weight">>}, 2501} )) 92 | , ?_assert(not eval(Hs, {'<=', {'ident', <<"weight">>}, 2500} )) 93 | , ?_assert( eval(Hs, {'between', {'ident', <<"weight">>}, {'range', 0, 2501}} )) 94 | , ?_assert( eval(Hs, {'between', {'ident', <<"weight">>}, {'range', 2500, 2501}} )) 95 | , ?_assert( eval(Hs, {'between', 17, {'range', 17, 18}} )) 96 | , ?_assert( eval(Hs, {'between', 17, {'range', 17, 17}} )) 97 | , ?_assert( eval(Hs, {'not_between', 16, {'range', 17, 18}} )) 98 | , ?_assert( eval(Hs, {'<', 2500, {'ident', <<"weight">>}} )) 99 | , ?_assert( eval(Hs, {'>', 2502, {'ident', <<"weight">>}} )) 100 | , ?_assert( eval(Hs, {'<=', 2500, {'ident', <<"weight">>}} )) 101 | , ?_assert( eval(Hs, {'>=', 2502, {'ident', <<"weight">>}} )) 102 | , ?_assert( eval(Hs, {'<=', 2501, {'ident', <<"weight">>}} )) 103 | , ?_assert( eval(Hs, {'>=', 2501, {'ident', <<"weight">>}} )) 104 | , ?_assert( eval(Hs, {'like', {'ident', <<"colour">>}, {<<"bl%">>, 'no_escape'}} )) 105 | , ?_assert( eval(Hs, {'like', {'ident', <<"likevar">>}, {<<"b_!_ue">>, <<"!">>}} )) 106 | , ?_assert( eval(Hs, {'like', {'ident', <<"colour">>}, {<<"bl_e">>, 'no_escape'}} )) 107 | , ?_assert( eval(Hs, {'not_like', {'ident', <<"colour">>}, {<<"l%">>, 'no_escape'}} )) 108 | , ?_assert(not eval(Hs, {'not_like', {'ident', <<"colour">>}, {<<"bl%">>, 'no_escape'}} )) 109 | , ?_assert( eval(Hs, {'in', {'ident', <<"colour">>}, [<<"blue">>, <<"green">>]} )) 110 | , ?_assert(not eval(Hs, {'not_in', {'ident', <<"colour">>}, [<<"green">>, <<"blue">>]} )) 111 | , ?_assert(not eval(Hs, {'in', {'ident', <<"colour">>}, [<<"bleen">>, <<"grue">>]} )) 112 | , ?_assert( eval(Hs, {'not_in', {'ident', <<"colour">>}, [<<"grue">>, <<"bleen">>]} )) 113 | , ?_assert( eval(Hs, {'not_like', {'ident', <<"altcol">>}, {<<"bl%">>, 'no_escape'}} )) 114 | , ?_assert( eval(Hs, {'like', {'ident', <<"altcol">>}, {<<"'bl%">>, 'no_escape'}} )) 115 | , ?_assert( eval(Hs, {'or', {'and', {'like', {'ident', <<"colour">>}, {<<"bl%">>, 'no_escape'}} 116 | , {'>', {'ident', <<"weight">>}, 2500}} 117 | , false} )) 118 | , ?_assert(undefined =:= eval(Hs, {'<=', {'ident', <<"missing">>}, 2500} )) 119 | , ?_assert(undefined =:= eval(Hs, {'in', {'ident', <<"missing">>}, [<<"blue">>]} )) 120 | ]. 121 | 122 | eval(Hs, S) -> evaluate(S, Hs). 123 | --------------------------------------------------------------------------------