reger
12 years ago
commit
c7c706fd9f
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
@ -1,240 +0,0 @@
|
|||||||
Apache License
|
|
||||||
Version 2.0, January 2004
|
|
||||||
http://www.apache.org/licenses/
|
|
||||||
|
|
||||||
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
|
|
||||||
|
|
||||||
1. Definitions.
|
|
||||||
|
|
||||||
"License" shall mean the terms and conditions for use, reproduction,
|
|
||||||
and distribution as defined by Sections 1 through 9 of this document.
|
|
||||||
|
|
||||||
"Licensor" shall mean the copyright owner or entity authorized by
|
|
||||||
the copyright owner that is granting the License.
|
|
||||||
|
|
||||||
"Legal Entity" shall mean the union of the acting entity and all
|
|
||||||
other entities that control, are controlled by, or are under common
|
|
||||||
control with that entity. For the purposes of this definition,
|
|
||||||
"control" means (i) the power, direct or indirect, to cause the
|
|
||||||
direction or management of such entity, whether by contract or
|
|
||||||
otherwise, or (ii) ownership of fifty percent (50%) or more of the
|
|
||||||
outstanding shares, or (iii) beneficial ownership of such entity.
|
|
||||||
|
|
||||||
"You" (or "Your") shall mean an individual or Legal Entity
|
|
||||||
exercising permissions granted by this License.
|
|
||||||
|
|
||||||
"Source" form shall mean the preferred form for making modifications,
|
|
||||||
including but not limited to software source code, documentation
|
|
||||||
source, and configuration files.
|
|
||||||
|
|
||||||
"Object" form shall mean any form resulting from mechanical
|
|
||||||
transformation or translation of a Source form, including but
|
|
||||||
not limited to compiled object code, generated documentation,
|
|
||||||
and conversions to other media types.
|
|
||||||
|
|
||||||
"Work" shall mean the work of authorship, whether in Source or
|
|
||||||
Object form, made available under the License, as indicated by a
|
|
||||||
copyright notice that is included in or attached to the work
|
|
||||||
(an example is provided in the Appendix below).
|
|
||||||
|
|
||||||
"Derivative Works" shall mean any work, whether in Source or Object
|
|
||||||
form, that is based on (or derived from) the Work and for which the
|
|
||||||
editorial revisions, annotations, elaborations, or other modifications
|
|
||||||
represent, as a whole, an original work of authorship. For the purposes
|
|
||||||
of this License, Derivative Works shall not include works that remain
|
|
||||||
separable from, or merely link (or bind by name) to the interfaces of,
|
|
||||||
the Work and Derivative Works thereof.
|
|
||||||
|
|
||||||
"Contribution" shall mean any work of authorship, including
|
|
||||||
the original version of the Work and any modifications or additions
|
|
||||||
to that Work or Derivative Works thereof, that is intentionally
|
|
||||||
submitted to Licensor for inclusion in the Work by the copyright owner
|
|
||||||
or by an individual or Legal Entity authorized to submit on behalf of
|
|
||||||
the copyright owner. For the purposes of this definition, "submitted"
|
|
||||||
means any form of electronic, verbal, or written communication sent
|
|
||||||
to the Licensor or its representatives, including but not limited to
|
|
||||||
communication on electronic mailing lists, source code control systems,
|
|
||||||
and issue tracking systems that are managed by, or on behalf of, the
|
|
||||||
Licensor for the purpose of discussing and improving the Work, but
|
|
||||||
excluding communication that is conspicuously marked or otherwise
|
|
||||||
designated in writing by the copyright owner as "Not a Contribution."
|
|
||||||
|
|
||||||
"Contributor" shall mean Licensor and any individual or Legal Entity
|
|
||||||
on behalf of whom a Contribution has been received by Licensor and
|
|
||||||
subsequently incorporated within the Work.
|
|
||||||
|
|
||||||
2. Grant of Copyright License. Subject to the terms and conditions of
|
|
||||||
this License, each Contributor hereby grants to You a perpetual,
|
|
||||||
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
|
||||||
copyright license to reproduce, prepare Derivative Works of,
|
|
||||||
publicly display, publicly perform, sublicense, and distribute the
|
|
||||||
Work and such Derivative Works in Source or Object form.
|
|
||||||
|
|
||||||
3. Grant of Patent License. Subject to the terms and conditions of
|
|
||||||
this License, each Contributor hereby grants to You a perpetual,
|
|
||||||
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
|
||||||
(except as stated in this section) patent license to make, have made,
|
|
||||||
use, offer to sell, sell, import, and otherwise transfer the Work,
|
|
||||||
where such license applies only to those patent claims licensable
|
|
||||||
by such Contributor that are necessarily infringed by their
|
|
||||||
Contribution(s) alone or by combination of their Contribution(s)
|
|
||||||
with the Work to which such Contribution(s) was submitted. If You
|
|
||||||
institute patent litigation against any entity (including a
|
|
||||||
cross-claim or counterclaim in a lawsuit) alleging that the Work
|
|
||||||
or a Contribution incorporated within the Work constitutes direct
|
|
||||||
or contributory patent infringement, then any patent licenses
|
|
||||||
granted to You under this License for that Work shall terminate
|
|
||||||
as of the date such litigation is filed.
|
|
||||||
|
|
||||||
4. Redistribution. You may reproduce and distribute copies of the
|
|
||||||
Work or Derivative Works thereof in any medium, with or without
|
|
||||||
modifications, and in Source or Object form, provided that You
|
|
||||||
meet the following conditions:
|
|
||||||
|
|
||||||
(a) You must give any other recipients of the Work or
|
|
||||||
Derivative Works a copy of this License; and
|
|
||||||
|
|
||||||
(b) You must cause any modified files to carry prominent notices
|
|
||||||
stating that You changed the files; and
|
|
||||||
|
|
||||||
(c) You must retain, in the Source form of any Derivative Works
|
|
||||||
that You distribute, all copyright, patent, trademark, and
|
|
||||||
attribution notices from the Source form of the Work,
|
|
||||||
excluding those notices that do not pertain to any part of
|
|
||||||
the Derivative Works; and
|
|
||||||
|
|
||||||
(d) If the Work includes a "NOTICE" text file as part of its
|
|
||||||
distribution, then any Derivative Works that You distribute must
|
|
||||||
include a readable copy of the attribution notices contained
|
|
||||||
within such NOTICE file, excluding those notices that do not
|
|
||||||
pertain to any part of the Derivative Works, in at least one
|
|
||||||
of the following places: within a NOTICE text file distributed
|
|
||||||
as part of the Derivative Works; within the Source form or
|
|
||||||
documentation, if provided along with the Derivative Works; or,
|
|
||||||
within a display generated by the Derivative Works, if and
|
|
||||||
wherever such third-party notices normally appear. The contents
|
|
||||||
of the NOTICE file are for informational purposes only and
|
|
||||||
do not modify the License. You may add Your own attribution
|
|
||||||
notices within Derivative Works that You distribute, alongside
|
|
||||||
or as an addendum to the NOTICE text from the Work, provided
|
|
||||||
that such additional attribution notices cannot be construed
|
|
||||||
as modifying the License.
|
|
||||||
|
|
||||||
You may add Your own copyright statement to Your modifications and
|
|
||||||
may provide additional or different license terms and conditions
|
|
||||||
for use, reproduction, or distribution of Your modifications, or
|
|
||||||
for any such Derivative Works as a whole, provided Your use,
|
|
||||||
reproduction, and distribution of the Work otherwise complies with
|
|
||||||
the conditions stated in this License.
|
|
||||||
|
|
||||||
5. Submission of Contributions. Unless You explicitly state otherwise,
|
|
||||||
any Contribution intentionally submitted for inclusion in the Work
|
|
||||||
by You to the Licensor shall be under the terms and conditions of
|
|
||||||
this License, without any additional terms or conditions.
|
|
||||||
Notwithstanding the above, nothing herein shall supersede or modify
|
|
||||||
the terms of any separate license agreement you may have executed
|
|
||||||
with Licensor regarding such Contributions.
|
|
||||||
|
|
||||||
6. Trademarks. This License does not grant permission to use the trade
|
|
||||||
names, trademarks, service marks, or product names of the Licensor,
|
|
||||||
except as required for reasonable and customary use in describing the
|
|
||||||
origin of the Work and reproducing the content of the NOTICE file.
|
|
||||||
|
|
||||||
7. Disclaimer of Warranty. Unless required by applicable law or
|
|
||||||
agreed to in writing, Licensor provides the Work (and each
|
|
||||||
Contributor provides its Contributions) on an "AS IS" BASIS,
|
|
||||||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
|
||||||
implied, including, without limitation, any warranties or conditions
|
|
||||||
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
|
|
||||||
PARTICULAR PURPOSE. You are solely responsible for determining the
|
|
||||||
appropriateness of using or redistributing the Work and assume any
|
|
||||||
risks associated with Your exercise of permissions under this License.
|
|
||||||
|
|
||||||
8. Limitation of Liability. In no event and under no legal theory,
|
|
||||||
whether in tort (including negligence), contract, or otherwise,
|
|
||||||
unless required by applicable law (such as deliberate and grossly
|
|
||||||
negligent acts) or agreed to in writing, shall any Contributor be
|
|
||||||
liable to You for damages, including any direct, indirect, special,
|
|
||||||
incidental, or consequential damages of any character arising as a
|
|
||||||
result of this License or out of the use or inability to use the
|
|
||||||
Work (including but not limited to damages for loss of goodwill,
|
|
||||||
work stoppage, computer failure or malfunction, or any and all
|
|
||||||
other commercial damages or losses), even if such Contributor
|
|
||||||
has been advised of the possibility of such damages.
|
|
||||||
|
|
||||||
9. Accepting Warranty or Additional Liability. While redistributing
|
|
||||||
the Work or Derivative Works thereof, You may choose to offer,
|
|
||||||
and charge a fee for, acceptance of support, warranty, indemnity,
|
|
||||||
or other liability obligations and/or rights consistent with this
|
|
||||||
License. However, in accepting such obligations, You may act only
|
|
||||||
on Your own behalf and on Your sole responsibility, not on behalf
|
|
||||||
of any other Contributor, and only if You agree to indemnify,
|
|
||||||
defend, and hold each Contributor harmless for any liability
|
|
||||||
incurred by, or claims asserted against, such Contributor by reason
|
|
||||||
of your accepting any such warranty or additional liability.
|
|
||||||
|
|
||||||
END OF TERMS AND CONDITIONS
|
|
||||||
|
|
||||||
=========================================================================
|
|
||||||
|
|
||||||
This project contains annotations in the package org.apache.http.annotation
|
|
||||||
which are derived from JCIP-ANNOTATIONS
|
|
||||||
Copyright (c) 2005 Brian Goetz and Tim Peierls.
|
|
||||||
See http://www.jcip.net and the Creative Commons Attribution License
|
|
||||||
(http://creativecommons.org/licenses/by/2.5)
|
|
||||||
Full text: http://creativecommons.org/licenses/by/2.5/legalcode
|
|
||||||
|
|
||||||
License
|
|
||||||
|
|
||||||
THE WORK (AS DEFINED BELOW) IS PROVIDED UNDER THE TERMS OF THIS CREATIVE COMMONS PUBLIC LICENSE ("CCPL" OR "LICENSE"). THE WORK IS PROTECTED BY COPYRIGHT AND/OR OTHER APPLICABLE LAW. ANY USE OF THE WORK OTHER THAN AS AUTHORIZED UNDER THIS LICENSE OR COPYRIGHT LAW IS PROHIBITED.
|
|
||||||
|
|
||||||
BY EXERCISING ANY RIGHTS TO THE WORK PROVIDED HERE, YOU ACCEPT AND AGREE TO BE BOUND BY THE TERMS OF THIS LICENSE. THE LICENSOR GRANTS YOU THE RIGHTS CONTAINED HERE IN CONSIDERATION OF YOUR ACCEPTANCE OF SUCH TERMS AND CONDITIONS.
|
|
||||||
|
|
||||||
1. Definitions
|
|
||||||
|
|
||||||
"Collective Work" means a work, such as a periodical issue, anthology or encyclopedia, in which the Work in its entirety in unmodified form, along with a number of other contributions, constituting separate and independent works in themselves, are assembled into a collective whole. A work that constitutes a Collective Work will not be considered a Derivative Work (as defined below) for the purposes of this License.
|
|
||||||
"Derivative Work" means a work based upon the Work or upon the Work and other pre-existing works, such as a translation, musical arrangement, dramatization, fictionalization, motion picture version, sound recording, art reproduction, abridgment, condensation, or any other form in which the Work may be recast, transformed, or adapted, except that a work that constitutes a Collective Work will not be considered a Derivative Work for the purpose of this License. For the avoidance of doubt, where the Work is a musical composition or sound recording, the synchronization of the Work in timed-relation with a moving image ("synching") will be considered a Derivative Work for the purpose of this License.
|
|
||||||
"Licensor" means the individual or entity that offers the Work under the terms of this License.
|
|
||||||
"Original Author" means the individual or entity who created the Work.
|
|
||||||
"Work" means the copyrightable work of authorship offered under the terms of this License.
|
|
||||||
"You" means an individual or entity exercising rights under this License who has not previously violated the terms of this License with respect to the Work, or who has received express permission from the Licensor to exercise rights under this License despite a previous violation.
|
|
||||||
|
|
||||||
2. Fair Use Rights. Nothing in this license is intended to reduce, limit, or restrict any rights arising from fair use, first sale or other limitations on the exclusive rights of the copyright owner under copyright law or other applicable laws.
|
|
||||||
|
|
||||||
3. License Grant. Subject to the terms and conditions of this License, Licensor hereby grants You a worldwide, royalty-free, non-exclusive, perpetual (for the duration of the applicable copyright) license to exercise the rights in the Work as stated below:
|
|
||||||
|
|
||||||
to reproduce the Work, to incorporate the Work into one or more Collective Works, and to reproduce the Work as incorporated in the Collective Works;
|
|
||||||
to create and reproduce Derivative Works;
|
|
||||||
to distribute copies or phonorecords of, display publicly, perform publicly, and perform publicly by means of a digital audio transmission the Work including as incorporated in Collective Works;
|
|
||||||
to distribute copies or phonorecords of, display publicly, perform publicly, and perform publicly by means of a digital audio transmission Derivative Works.
|
|
||||||
|
|
||||||
For the avoidance of doubt, where the work is a musical composition:
|
|
||||||
Performance Royalties Under Blanket Licenses. Licensor waives the exclusive right to collect, whether individually or via a performance rights society (e.g. ASCAP, BMI, SESAC), royalties for the public performance or public digital performance (e.g. webcast) of the Work.
|
|
||||||
Mechanical Rights and Statutory Royalties. Licensor waives the exclusive right to collect, whether individually or via a music rights agency or designated agent (e.g. Harry Fox Agency), royalties for any phonorecord You create from the Work ("cover version") and distribute, subject to the compulsory license created by 17 USC Section 115 of the US Copyright Act (or the equivalent in other jurisdictions).
|
|
||||||
Webcasting Rights and Statutory Royalties. For the avoidance of doubt, where the Work is a sound recording, Licensor waives the exclusive right to collect, whether individually or via a performance-rights society (e.g. SoundExchange), royalties for the public digital performance (e.g. webcast) of the Work, subject to the compulsory license created by 17 USC Section 114 of the US Copyright Act (or the equivalent in other jurisdictions).
|
|
||||||
|
|
||||||
The above rights may be exercised in all media and formats whether now known or hereafter devised. The above rights include the right to make such modifications as are technically necessary to exercise the rights in other media and formats. All rights not expressly granted by Licensor are hereby reserved.
|
|
||||||
|
|
||||||
4. Restrictions.The license granted in Section 3 above is expressly made subject to and limited by the following restrictions:
|
|
||||||
|
|
||||||
You may distribute, publicly display, publicly perform, or publicly digitally perform the Work only under the terms of this License, and You must include a copy of, or the Uniform Resource Identifier for, this License with every copy or phonorecord of the Work You distribute, publicly display, publicly perform, or publicly digitally perform. You may not offer or impose any terms on the Work that alter or restrict the terms of this License or the recipients' exercise of the rights granted hereunder. You may not sublicense the Work. You must keep intact all notices that refer to this License and to the disclaimer of warranties. You may not distribute, publicly display, publicly perform, or publicly digitally perform the Work with any technological measures that control access or use of the Work in a manner inconsistent with the terms of this License Agreement. The above applies to the Work as incorporated in a Collective Work, but this does not require the Collective Work apart from the Work itself to be made subject to the terms of this License. If You create a Collective Work, upon notice from any Licensor You must, to the extent practicable, remove from the Collective Work any credit as required by clause 4(b), as requested. If You create a Derivative Work, upon notice from any Licensor You must, to the extent practicable, remove from the Derivative Work any credit as required by clause 4(b), as requested.
|
|
||||||
If you distribute, publicly display, publicly perform, or publicly digitally perform the Work or any Derivative Works or Collective Works, You must keep intact all copyright notices for the Work and provide, reasonable to the medium or means You are utilizing: (i) the name of the Original Author (or pseudonym, if applicable) if supplied, and/or (ii) if the Original Author and/or Licensor designate another party or parties (e.g. a sponsor institute, publishing entity, journal) for attribution in Licensor's copyright notice, terms of service or by other reasonable means, the name of such party or parties; the title of the Work if supplied; to the extent reasonably practicable, the Uniform Resource Identifier, if any, that Licensor specifies to be associated with the Work, unless such URI does not refer to the copyright notice or licensing information for the Work; and in the case of a Derivative Work, a credit identifying the use of the Work in the Derivative Work (e.g., "French translation of the Work by Original Author," or "Screenplay based on original Work by Original Author"). Such credit may be implemented in any reasonable manner; provided, however, that in the case of a Derivative Work or Collective Work, at a minimum such credit will appear where any other comparable authorship credit appears and in a manner at least as prominent as such other comparable authorship credit.
|
|
||||||
|
|
||||||
5. Representations, Warranties and Disclaimer
|
|
||||||
|
|
||||||
UNLESS OTHERWISE MUTUALLY AGREED TO BY THE PARTIES IN WRITING, LICENSOR OFFERS THE WORK AS-IS AND MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND CONCERNING THE WORK, EXPRESS, IMPLIED, STATUTORY OR OTHERWISE, INCLUDING, WITHOUT LIMITATION, WARRANTIES OF TITLE, MERCHANTIBILITY, FITNESS FOR A PARTICULAR PURPOSE, NONINFRINGEMENT, OR THE ABSENCE OF LATENT OR OTHER DEFECTS, ACCURACY, OR THE PRESENCE OF ABSENCE OF ERRORS, WHETHER OR NOT DISCOVERABLE. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO SUCH EXCLUSION MAY NOT APPLY TO YOU.
|
|
||||||
|
|
||||||
6. Limitation on Liability. EXCEPT TO THE EXTENT REQUIRED BY APPLICABLE LAW, IN NO EVENT WILL LICENSOR BE LIABLE TO YOU ON ANY LEGAL THEORY FOR ANY SPECIAL, INCIDENTAL, CONSEQUENTIAL, PUNITIVE OR EXEMPLARY DAMAGES ARISING OUT OF THIS LICENSE OR THE USE OF THE WORK, EVEN IF LICENSOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
|
|
||||||
|
|
||||||
7. Termination
|
|
||||||
|
|
||||||
This License and the rights granted hereunder will terminate automatically upon any breach by You of the terms of this License. Individuals or entities who have received Derivative Works or Collective Works from You under this License, however, will not have their licenses terminated provided such individuals or entities remain in full compliance with those licenses. Sections 1, 2, 5, 6, 7, and 8 will survive any termination of this License.
|
|
||||||
Subject to the above terms and conditions, the license granted here is perpetual (for the duration of the applicable copyright in the Work). Notwithstanding the above, Licensor reserves the right to release the Work under different license terms or to stop distributing the Work at any time; provided, however that any such election will not serve to withdraw this License (or any other license that has been, or is required to be, granted under the terms of this License), and this License will continue in full force and effect unless terminated as stated above.
|
|
||||||
|
|
||||||
8. Miscellaneous
|
|
||||||
|
|
||||||
Each time You distribute or publicly digitally perform the Work or a Collective Work, the Licensor offers to the recipient a license to the Work on the same terms and conditions as the license granted to You under this License.
|
|
||||||
Each time You distribute or publicly digitally perform a Derivative Work, Licensor offers to the recipient a license to the original Work on the same terms and conditions as the license granted to You under this License.
|
|
||||||
If any provision of this License is invalid or unenforceable under applicable law, it shall not affect the validity or enforceability of the remainder of the terms of this License, and without further action by the parties to this agreement, such provision shall be reformed to the minimum extent necessary to make such provision valid and enforceable.
|
|
||||||
No term or provision of this License shall be deemed waived and no breach consented to unless such waiver or consent shall be in writing and signed by the party to be charged with such waiver or consent.
|
|
||||||
This License constitutes the entire agreement between the parties with respect to the Work licensed here. There are no understandings, agreements or representations with respect to the Work not specified here. Licensor shall not be bound by any additional provisions that may appear in any communication from You. This License may not be modified without the mutual written agreement of the Licensor and You.
|
|
||||||
Binary file not shown.
@ -1,202 +1,176 @@
|
|||||||
|
Apache License
|
||||||
Apache License
|
Version 2.0, January 2004
|
||||||
Version 2.0, January 2004
|
http://www.apache.org/licenses/
|
||||||
http://www.apache.org/licenses/
|
|
||||||
|
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
|
||||||
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
|
|
||||||
|
1. Definitions.
|
||||||
1. Definitions.
|
|
||||||
|
"License" shall mean the terms and conditions for use, reproduction,
|
||||||
"License" shall mean the terms and conditions for use, reproduction,
|
and distribution as defined by Sections 1 through 9 of this document.
|
||||||
and distribution as defined by Sections 1 through 9 of this document.
|
|
||||||
|
"Licensor" shall mean the copyright owner or entity authorized by
|
||||||
"Licensor" shall mean the copyright owner or entity authorized by
|
the copyright owner that is granting the License.
|
||||||
the copyright owner that is granting the License.
|
|
||||||
|
"Legal Entity" shall mean the union of the acting entity and all
|
||||||
"Legal Entity" shall mean the union of the acting entity and all
|
other entities that control, are controlled by, or are under common
|
||||||
other entities that control, are controlled by, or are under common
|
control with that entity. For the purposes of this definition,
|
||||||
control with that entity. For the purposes of this definition,
|
"control" means (i) the power, direct or indirect, to cause the
|
||||||
"control" means (i) the power, direct or indirect, to cause the
|
direction or management of such entity, whether by contract or
|
||||||
direction or management of such entity, whether by contract or
|
otherwise, or (ii) ownership of fifty percent (50%) or more of the
|
||||||
otherwise, or (ii) ownership of fifty percent (50%) or more of the
|
outstanding shares, or (iii) beneficial ownership of such entity.
|
||||||
outstanding shares, or (iii) beneficial ownership of such entity.
|
|
||||||
|
"You" (or "Your") shall mean an individual or Legal Entity
|
||||||
"You" (or "Your") shall mean an individual or Legal Entity
|
exercising permissions granted by this License.
|
||||||
exercising permissions granted by this License.
|
|
||||||
|
"Source" form shall mean the preferred form for making modifications,
|
||||||
"Source" form shall mean the preferred form for making modifications,
|
including but not limited to software source code, documentation
|
||||||
including but not limited to software source code, documentation
|
source, and configuration files.
|
||||||
source, and configuration files.
|
|
||||||
|
"Object" form shall mean any form resulting from mechanical
|
||||||
"Object" form shall mean any form resulting from mechanical
|
transformation or translation of a Source form, including but
|
||||||
transformation or translation of a Source form, including but
|
not limited to compiled object code, generated documentation,
|
||||||
not limited to compiled object code, generated documentation,
|
and conversions to other media types.
|
||||||
and conversions to other media types.
|
|
||||||
|
"Work" shall mean the work of authorship, whether in Source or
|
||||||
"Work" shall mean the work of authorship, whether in Source or
|
Object form, made available under the License, as indicated by a
|
||||||
Object form, made available under the License, as indicated by a
|
copyright notice that is included in or attached to the work
|
||||||
copyright notice that is included in or attached to the work
|
(an example is provided in the Appendix below).
|
||||||
(an example is provided in the Appendix below).
|
|
||||||
|
"Derivative Works" shall mean any work, whether in Source or Object
|
||||||
"Derivative Works" shall mean any work, whether in Source or Object
|
form, that is based on (or derived from) the Work and for which the
|
||||||
form, that is based on (or derived from) the Work and for which the
|
editorial revisions, annotations, elaborations, or other modifications
|
||||||
editorial revisions, annotations, elaborations, or other modifications
|
represent, as a whole, an original work of authorship. For the purposes
|
||||||
represent, as a whole, an original work of authorship. For the purposes
|
of this License, Derivative Works shall not include works that remain
|
||||||
of this License, Derivative Works shall not include works that remain
|
separable from, or merely link (or bind by name) to the interfaces of,
|
||||||
separable from, or merely link (or bind by name) to the interfaces of,
|
the Work and Derivative Works thereof.
|
||||||
the Work and Derivative Works thereof.
|
|
||||||
|
"Contribution" shall mean any work of authorship, including
|
||||||
"Contribution" shall mean any work of authorship, including
|
the original version of the Work and any modifications or additions
|
||||||
the original version of the Work and any modifications or additions
|
to that Work or Derivative Works thereof, that is intentionally
|
||||||
to that Work or Derivative Works thereof, that is intentionally
|
submitted to Licensor for inclusion in the Work by the copyright owner
|
||||||
submitted to Licensor for inclusion in the Work by the copyright owner
|
or by an individual or Legal Entity authorized to submit on behalf of
|
||||||
or by an individual or Legal Entity authorized to submit on behalf of
|
the copyright owner. For the purposes of this definition, "submitted"
|
||||||
the copyright owner. For the purposes of this definition, "submitted"
|
means any form of electronic, verbal, or written communication sent
|
||||||
means any form of electronic, verbal, or written communication sent
|
to the Licensor or its representatives, including but not limited to
|
||||||
to the Licensor or its representatives, including but not limited to
|
communication on electronic mailing lists, source code control systems,
|
||||||
communication on electronic mailing lists, source code control systems,
|
and issue tracking systems that are managed by, or on behalf of, the
|
||||||
and issue tracking systems that are managed by, or on behalf of, the
|
Licensor for the purpose of discussing and improving the Work, but
|
||||||
Licensor for the purpose of discussing and improving the Work, but
|
excluding communication that is conspicuously marked or otherwise
|
||||||
excluding communication that is conspicuously marked or otherwise
|
designated in writing by the copyright owner as "Not a Contribution."
|
||||||
designated in writing by the copyright owner as "Not a Contribution."
|
|
||||||
|
"Contributor" shall mean Licensor and any individual or Legal Entity
|
||||||
"Contributor" shall mean Licensor and any individual or Legal Entity
|
on behalf of whom a Contribution has been received by Licensor and
|
||||||
on behalf of whom a Contribution has been received by Licensor and
|
subsequently incorporated within the Work.
|
||||||
subsequently incorporated within the Work.
|
|
||||||
|
2. Grant of Copyright License. Subject to the terms and conditions of
|
||||||
2. Grant of Copyright License. Subject to the terms and conditions of
|
this License, each Contributor hereby grants to You a perpetual,
|
||||||
this License, each Contributor hereby grants to You a perpetual,
|
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
||||||
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
copyright license to reproduce, prepare Derivative Works of,
|
||||||
copyright license to reproduce, prepare Derivative Works of,
|
publicly display, publicly perform, sublicense, and distribute the
|
||||||
publicly display, publicly perform, sublicense, and distribute the
|
Work and such Derivative Works in Source or Object form.
|
||||||
Work and such Derivative Works in Source or Object form.
|
|
||||||
|
3. Grant of Patent License. Subject to the terms and conditions of
|
||||||
3. Grant of Patent License. Subject to the terms and conditions of
|
this License, each Contributor hereby grants to You a perpetual,
|
||||||
this License, each Contributor hereby grants to You a perpetual,
|
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
||||||
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
(except as stated in this section) patent license to make, have made,
|
||||||
(except as stated in this section) patent license to make, have made,
|
use, offer to sell, sell, import, and otherwise transfer the Work,
|
||||||
use, offer to sell, sell, import, and otherwise transfer the Work,
|
where such license applies only to those patent claims licensable
|
||||||
where such license applies only to those patent claims licensable
|
by such Contributor that are necessarily infringed by their
|
||||||
by such Contributor that are necessarily infringed by their
|
Contribution(s) alone or by combination of their Contribution(s)
|
||||||
Contribution(s) alone or by combination of their Contribution(s)
|
with the Work to which such Contribution(s) was submitted. If You
|
||||||
with the Work to which such Contribution(s) was submitted. If You
|
institute patent litigation against any entity (including a
|
||||||
institute patent litigation against any entity (including a
|
cross-claim or counterclaim in a lawsuit) alleging that the Work
|
||||||
cross-claim or counterclaim in a lawsuit) alleging that the Work
|
or a Contribution incorporated within the Work constitutes direct
|
||||||
or a Contribution incorporated within the Work constitutes direct
|
or contributory patent infringement, then any patent licenses
|
||||||
or contributory patent infringement, then any patent licenses
|
granted to You under this License for that Work shall terminate
|
||||||
granted to You under this License for that Work shall terminate
|
as of the date such litigation is filed.
|
||||||
as of the date such litigation is filed.
|
|
||||||
|
4. Redistribution. You may reproduce and distribute copies of the
|
||||||
4. Redistribution. You may reproduce and distribute copies of the
|
Work or Derivative Works thereof in any medium, with or without
|
||||||
Work or Derivative Works thereof in any medium, with or without
|
modifications, and in Source or Object form, provided that You
|
||||||
modifications, and in Source or Object form, provided that You
|
meet the following conditions:
|
||||||
meet the following conditions:
|
|
||||||
|
(a) You must give any other recipients of the Work or
|
||||||
(a) You must give any other recipients of the Work or
|
Derivative Works a copy of this License; and
|
||||||
Derivative Works a copy of this License; and
|
|
||||||
|
(b) You must cause any modified files to carry prominent notices
|
||||||
(b) You must cause any modified files to carry prominent notices
|
stating that You changed the files; and
|
||||||
stating that You changed the files; and
|
|
||||||
|
(c) You must retain, in the Source form of any Derivative Works
|
||||||
(c) You must retain, in the Source form of any Derivative Works
|
that You distribute, all copyright, patent, trademark, and
|
||||||
that You distribute, all copyright, patent, trademark, and
|
attribution notices from the Source form of the Work,
|
||||||
attribution notices from the Source form of the Work,
|
excluding those notices that do not pertain to any part of
|
||||||
excluding those notices that do not pertain to any part of
|
the Derivative Works; and
|
||||||
the Derivative Works; and
|
|
||||||
|
(d) If the Work includes a "NOTICE" text file as part of its
|
||||||
(d) If the Work includes a "NOTICE" text file as part of its
|
distribution, then any Derivative Works that You distribute must
|
||||||
distribution, then any Derivative Works that You distribute must
|
include a readable copy of the attribution notices contained
|
||||||
include a readable copy of the attribution notices contained
|
within such NOTICE file, excluding those notices that do not
|
||||||
within such NOTICE file, excluding those notices that do not
|
pertain to any part of the Derivative Works, in at least one
|
||||||
pertain to any part of the Derivative Works, in at least one
|
of the following places: within a NOTICE text file distributed
|
||||||
of the following places: within a NOTICE text file distributed
|
as part of the Derivative Works; within the Source form or
|
||||||
as part of the Derivative Works; within the Source form or
|
documentation, if provided along with the Derivative Works; or,
|
||||||
documentation, if provided along with the Derivative Works; or,
|
within a display generated by the Derivative Works, if and
|
||||||
within a display generated by the Derivative Works, if and
|
wherever such third-party notices normally appear. The contents
|
||||||
wherever such third-party notices normally appear. The contents
|
of the NOTICE file are for informational purposes only and
|
||||||
of the NOTICE file are for informational purposes only and
|
do not modify the License. You may add Your own attribution
|
||||||
do not modify the License. You may add Your own attribution
|
notices within Derivative Works that You distribute, alongside
|
||||||
notices within Derivative Works that You distribute, alongside
|
or as an addendum to the NOTICE text from the Work, provided
|
||||||
or as an addendum to the NOTICE text from the Work, provided
|
that such additional attribution notices cannot be construed
|
||||||
that such additional attribution notices cannot be construed
|
as modifying the License.
|
||||||
as modifying the License.
|
|
||||||
|
You may add Your own copyright statement to Your modifications and
|
||||||
You may add Your own copyright statement to Your modifications and
|
may provide additional or different license terms and conditions
|
||||||
may provide additional or different license terms and conditions
|
for use, reproduction, or distribution of Your modifications, or
|
||||||
for use, reproduction, or distribution of Your modifications, or
|
for any such Derivative Works as a whole, provided Your use,
|
||||||
for any such Derivative Works as a whole, provided Your use,
|
reproduction, and distribution of the Work otherwise complies with
|
||||||
reproduction, and distribution of the Work otherwise complies with
|
the conditions stated in this License.
|
||||||
the conditions stated in this License.
|
|
||||||
|
5. Submission of Contributions. Unless You explicitly state otherwise,
|
||||||
5. Submission of Contributions. Unless You explicitly state otherwise,
|
any Contribution intentionally submitted for inclusion in the Work
|
||||||
any Contribution intentionally submitted for inclusion in the Work
|
by You to the Licensor shall be under the terms and conditions of
|
||||||
by You to the Licensor shall be under the terms and conditions of
|
this License, without any additional terms or conditions.
|
||||||
this License, without any additional terms or conditions.
|
Notwithstanding the above, nothing herein shall supersede or modify
|
||||||
Notwithstanding the above, nothing herein shall supersede or modify
|
the terms of any separate license agreement you may have executed
|
||||||
the terms of any separate license agreement you may have executed
|
with Licensor regarding such Contributions.
|
||||||
with Licensor regarding such Contributions.
|
|
||||||
|
6. Trademarks. This License does not grant permission to use the trade
|
||||||
6. Trademarks. This License does not grant permission to use the trade
|
names, trademarks, service marks, or product names of the Licensor,
|
||||||
names, trademarks, service marks, or product names of the Licensor,
|
except as required for reasonable and customary use in describing the
|
||||||
except as required for reasonable and customary use in describing the
|
origin of the Work and reproducing the content of the NOTICE file.
|
||||||
origin of the Work and reproducing the content of the NOTICE file.
|
|
||||||
|
7. Disclaimer of Warranty. Unless required by applicable law or
|
||||||
7. Disclaimer of Warranty. Unless required by applicable law or
|
agreed to in writing, Licensor provides the Work (and each
|
||||||
agreed to in writing, Licensor provides the Work (and each
|
Contributor provides its Contributions) on an "AS IS" BASIS,
|
||||||
Contributor provides its Contributions) on an "AS IS" BASIS,
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
||||||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
implied, including, without limitation, any warranties or conditions
|
||||||
implied, including, without limitation, any warranties or conditions
|
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
|
||||||
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
|
PARTICULAR PURPOSE. You are solely responsible for determining the
|
||||||
PARTICULAR PURPOSE. You are solely responsible for determining the
|
appropriateness of using or redistributing the Work and assume any
|
||||||
appropriateness of using or redistributing the Work and assume any
|
risks associated with Your exercise of permissions under this License.
|
||||||
risks associated with Your exercise of permissions under this License.
|
|
||||||
|
8. Limitation of Liability. In no event and under no legal theory,
|
||||||
8. Limitation of Liability. In no event and under no legal theory,
|
whether in tort (including negligence), contract, or otherwise,
|
||||||
whether in tort (including negligence), contract, or otherwise,
|
unless required by applicable law (such as deliberate and grossly
|
||||||
unless required by applicable law (such as deliberate and grossly
|
negligent acts) or agreed to in writing, shall any Contributor be
|
||||||
negligent acts) or agreed to in writing, shall any Contributor be
|
liable to You for damages, including any direct, indirect, special,
|
||||||
liable to You for damages, including any direct, indirect, special,
|
incidental, or consequential damages of any character arising as a
|
||||||
incidental, or consequential damages of any character arising as a
|
result of this License or out of the use or inability to use the
|
||||||
result of this License or out of the use or inability to use the
|
Work (including but not limited to damages for loss of goodwill,
|
||||||
Work (including but not limited to damages for loss of goodwill,
|
work stoppage, computer failure or malfunction, or any and all
|
||||||
work stoppage, computer failure or malfunction, or any and all
|
other commercial damages or losses), even if such Contributor
|
||||||
other commercial damages or losses), even if such Contributor
|
has been advised of the possibility of such damages.
|
||||||
has been advised of the possibility of such damages.
|
|
||||||
|
9. Accepting Warranty or Additional Liability. While redistributing
|
||||||
9. Accepting Warranty or Additional Liability. While redistributing
|
the Work or Derivative Works thereof, You may choose to offer,
|
||||||
the Work or Derivative Works thereof, You may choose to offer,
|
and charge a fee for, acceptance of support, warranty, indemnity,
|
||||||
and charge a fee for, acceptance of support, warranty, indemnity,
|
or other liability obligations and/or rights consistent with this
|
||||||
or other liability obligations and/or rights consistent with this
|
License. However, in accepting such obligations, You may act only
|
||||||
License. However, in accepting such obligations, You may act only
|
on Your own behalf and on Your sole responsibility, not on behalf
|
||||||
on Your own behalf and on Your sole responsibility, not on behalf
|
of any other Contributor, and only if You agree to indemnify,
|
||||||
of any other Contributor, and only if You agree to indemnify,
|
defend, and hold each Contributor harmless for any liability
|
||||||
defend, and hold each Contributor harmless for any liability
|
incurred by, or claims asserted against, such Contributor by reason
|
||||||
incurred by, or claims asserted against, such Contributor by reason
|
of your accepting any such warranty or additional liability.
|
||||||
of your accepting any such warranty or additional liability.
|
|
||||||
|
END OF TERMS AND CONDITIONS
|
||||||
END OF TERMS AND CONDITIONS
|
|
||||||
|
|
||||||
APPENDIX: How to apply the Apache License to your work.
|
|
||||||
|
|
||||||
To apply the Apache License to your work, attach the following
|
|
||||||
boilerplate notice, with the fields enclosed by brackets "[]"
|
|
||||||
replaced with your own identifying information. (Don't include
|
|
||||||
the brackets!) The text should be enclosed in the appropriate
|
|
||||||
comment syntax for the file format. We also recommend that a
|
|
||||||
file or class name and description of purpose be included on the
|
|
||||||
same "printed page" as the copyright notice for easier
|
|
||||||
identification within third-party archives.
|
|
||||||
|
|
||||||
Copyright [yyyy] [name of copyright owner]
|
|
||||||
|
|
||||||
Licensed under the Apache License, Version 2.0 (the "License");
|
|
||||||
you may not use this file except in compliance with the License.
|
|
||||||
You may obtain a copy of the License at
|
|
||||||
|
|
||||||
http://www.apache.org/licenses/LICENSE-2.0
|
|
||||||
|
|
||||||
Unless required by applicable law or agreed to in writing, software
|
|
||||||
distributed under the License is distributed on an "AS IS" BASIS,
|
|
||||||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
||||||
See the License for the specific language governing permissions and
|
|
||||||
limitations under the License.
|
|
||||||
Binary file not shown.
Binary file not shown.
@ -0,0 +1,176 @@
|
|||||||
|
Apache License
|
||||||
|
Version 2.0, January 2004
|
||||||
|
http://www.apache.org/licenses/
|
||||||
|
|
||||||
|
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
|
||||||
|
|
||||||
|
1. Definitions.
|
||||||
|
|
||||||
|
"License" shall mean the terms and conditions for use, reproduction,
|
||||||
|
and distribution as defined by Sections 1 through 9 of this document.
|
||||||
|
|
||||||
|
"Licensor" shall mean the copyright owner or entity authorized by
|
||||||
|
the copyright owner that is granting the License.
|
||||||
|
|
||||||
|
"Legal Entity" shall mean the union of the acting entity and all
|
||||||
|
other entities that control, are controlled by, or are under common
|
||||||
|
control with that entity. For the purposes of this definition,
|
||||||
|
"control" means (i) the power, direct or indirect, to cause the
|
||||||
|
direction or management of such entity, whether by contract or
|
||||||
|
otherwise, or (ii) ownership of fifty percent (50%) or more of the
|
||||||
|
outstanding shares, or (iii) beneficial ownership of such entity.
|
||||||
|
|
||||||
|
"You" (or "Your") shall mean an individual or Legal Entity
|
||||||
|
exercising permissions granted by this License.
|
||||||
|
|
||||||
|
"Source" form shall mean the preferred form for making modifications,
|
||||||
|
including but not limited to software source code, documentation
|
||||||
|
source, and configuration files.
|
||||||
|
|
||||||
|
"Object" form shall mean any form resulting from mechanical
|
||||||
|
transformation or translation of a Source form, including but
|
||||||
|
not limited to compiled object code, generated documentation,
|
||||||
|
and conversions to other media types.
|
||||||
|
|
||||||
|
"Work" shall mean the work of authorship, whether in Source or
|
||||||
|
Object form, made available under the License, as indicated by a
|
||||||
|
copyright notice that is included in or attached to the work
|
||||||
|
(an example is provided in the Appendix below).
|
||||||
|
|
||||||
|
"Derivative Works" shall mean any work, whether in Source or Object
|
||||||
|
form, that is based on (or derived from) the Work and for which the
|
||||||
|
editorial revisions, annotations, elaborations, or other modifications
|
||||||
|
represent, as a whole, an original work of authorship. For the purposes
|
||||||
|
of this License, Derivative Works shall not include works that remain
|
||||||
|
separable from, or merely link (or bind by name) to the interfaces of,
|
||||||
|
the Work and Derivative Works thereof.
|
||||||
|
|
||||||
|
"Contribution" shall mean any work of authorship, including
|
||||||
|
the original version of the Work and any modifications or additions
|
||||||
|
to that Work or Derivative Works thereof, that is intentionally
|
||||||
|
submitted to Licensor for inclusion in the Work by the copyright owner
|
||||||
|
or by an individual or Legal Entity authorized to submit on behalf of
|
||||||
|
the copyright owner. For the purposes of this definition, "submitted"
|
||||||
|
means any form of electronic, verbal, or written communication sent
|
||||||
|
to the Licensor or its representatives, including but not limited to
|
||||||
|
communication on electronic mailing lists, source code control systems,
|
||||||
|
and issue tracking systems that are managed by, or on behalf of, the
|
||||||
|
Licensor for the purpose of discussing and improving the Work, but
|
||||||
|
excluding communication that is conspicuously marked or otherwise
|
||||||
|
designated in writing by the copyright owner as "Not a Contribution."
|
||||||
|
|
||||||
|
"Contributor" shall mean Licensor and any individual or Legal Entity
|
||||||
|
on behalf of whom a Contribution has been received by Licensor and
|
||||||
|
subsequently incorporated within the Work.
|
||||||
|
|
||||||
|
2. Grant of Copyright License. Subject to the terms and conditions of
|
||||||
|
this License, each Contributor hereby grants to You a perpetual,
|
||||||
|
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
||||||
|
copyright license to reproduce, prepare Derivative Works of,
|
||||||
|
publicly display, publicly perform, sublicense, and distribute the
|
||||||
|
Work and such Derivative Works in Source or Object form.
|
||||||
|
|
||||||
|
3. Grant of Patent License. Subject to the terms and conditions of
|
||||||
|
this License, each Contributor hereby grants to You a perpetual,
|
||||||
|
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
||||||
|
(except as stated in this section) patent license to make, have made,
|
||||||
|
use, offer to sell, sell, import, and otherwise transfer the Work,
|
||||||
|
where such license applies only to those patent claims licensable
|
||||||
|
by such Contributor that are necessarily infringed by their
|
||||||
|
Contribution(s) alone or by combination of their Contribution(s)
|
||||||
|
with the Work to which such Contribution(s) was submitted. If You
|
||||||
|
institute patent litigation against any entity (including a
|
||||||
|
cross-claim or counterclaim in a lawsuit) alleging that the Work
|
||||||
|
or a Contribution incorporated within the Work constitutes direct
|
||||||
|
or contributory patent infringement, then any patent licenses
|
||||||
|
granted to You under this License for that Work shall terminate
|
||||||
|
as of the date such litigation is filed.
|
||||||
|
|
||||||
|
4. Redistribution. You may reproduce and distribute copies of the
|
||||||
|
Work or Derivative Works thereof in any medium, with or without
|
||||||
|
modifications, and in Source or Object form, provided that You
|
||||||
|
meet the following conditions:
|
||||||
|
|
||||||
|
(a) You must give any other recipients of the Work or
|
||||||
|
Derivative Works a copy of this License; and
|
||||||
|
|
||||||
|
(b) You must cause any modified files to carry prominent notices
|
||||||
|
stating that You changed the files; and
|
||||||
|
|
||||||
|
(c) You must retain, in the Source form of any Derivative Works
|
||||||
|
that You distribute, all copyright, patent, trademark, and
|
||||||
|
attribution notices from the Source form of the Work,
|
||||||
|
excluding those notices that do not pertain to any part of
|
||||||
|
the Derivative Works; and
|
||||||
|
|
||||||
|
(d) If the Work includes a "NOTICE" text file as part of its
|
||||||
|
distribution, then any Derivative Works that You distribute must
|
||||||
|
include a readable copy of the attribution notices contained
|
||||||
|
within such NOTICE file, excluding those notices that do not
|
||||||
|
pertain to any part of the Derivative Works, in at least one
|
||||||
|
of the following places: within a NOTICE text file distributed
|
||||||
|
as part of the Derivative Works; within the Source form or
|
||||||
|
documentation, if provided along with the Derivative Works; or,
|
||||||
|
within a display generated by the Derivative Works, if and
|
||||||
|
wherever such third-party notices normally appear. The contents
|
||||||
|
of the NOTICE file are for informational purposes only and
|
||||||
|
do not modify the License. You may add Your own attribution
|
||||||
|
notices within Derivative Works that You distribute, alongside
|
||||||
|
or as an addendum to the NOTICE text from the Work, provided
|
||||||
|
that such additional attribution notices cannot be construed
|
||||||
|
as modifying the License.
|
||||||
|
|
||||||
|
You may add Your own copyright statement to Your modifications and
|
||||||
|
may provide additional or different license terms and conditions
|
||||||
|
for use, reproduction, or distribution of Your modifications, or
|
||||||
|
for any such Derivative Works as a whole, provided Your use,
|
||||||
|
reproduction, and distribution of the Work otherwise complies with
|
||||||
|
the conditions stated in this License.
|
||||||
|
|
||||||
|
5. Submission of Contributions. Unless You explicitly state otherwise,
|
||||||
|
any Contribution intentionally submitted for inclusion in the Work
|
||||||
|
by You to the Licensor shall be under the terms and conditions of
|
||||||
|
this License, without any additional terms or conditions.
|
||||||
|
Notwithstanding the above, nothing herein shall supersede or modify
|
||||||
|
the terms of any separate license agreement you may have executed
|
||||||
|
with Licensor regarding such Contributions.
|
||||||
|
|
||||||
|
6. Trademarks. This License does not grant permission to use the trade
|
||||||
|
names, trademarks, service marks, or product names of the Licensor,
|
||||||
|
except as required for reasonable and customary use in describing the
|
||||||
|
origin of the Work and reproducing the content of the NOTICE file.
|
||||||
|
|
||||||
|
7. Disclaimer of Warranty. Unless required by applicable law or
|
||||||
|
agreed to in writing, Licensor provides the Work (and each
|
||||||
|
Contributor provides its Contributions) on an "AS IS" BASIS,
|
||||||
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
||||||
|
implied, including, without limitation, any warranties or conditions
|
||||||
|
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
|
||||||
|
PARTICULAR PURPOSE. You are solely responsible for determining the
|
||||||
|
appropriateness of using or redistributing the Work and assume any
|
||||||
|
risks associated with Your exercise of permissions under this License.
|
||||||
|
|
||||||
|
8. Limitation of Liability. In no event and under no legal theory,
|
||||||
|
whether in tort (including negligence), contract, or otherwise,
|
||||||
|
unless required by applicable law (such as deliberate and grossly
|
||||||
|
negligent acts) or agreed to in writing, shall any Contributor be
|
||||||
|
liable to You for damages, including any direct, indirect, special,
|
||||||
|
incidental, or consequential damages of any character arising as a
|
||||||
|
result of this License or out of the use or inability to use the
|
||||||
|
Work (including but not limited to damages for loss of goodwill,
|
||||||
|
work stoppage, computer failure or malfunction, or any and all
|
||||||
|
other commercial damages or losses), even if such Contributor
|
||||||
|
has been advised of the possibility of such damages.
|
||||||
|
|
||||||
|
9. Accepting Warranty or Additional Liability. While redistributing
|
||||||
|
the Work or Derivative Works thereof, You may choose to offer,
|
||||||
|
and charge a fee for, acceptance of support, warranty, indemnity,
|
||||||
|
or other liability obligations and/or rights consistent with this
|
||||||
|
License. However, in accepting such obligations, You may act only
|
||||||
|
on Your own behalf and on Your sole responsibility, not on behalf
|
||||||
|
of any other Contributor, and only if You agree to indemnify,
|
||||||
|
defend, and hold each Contributor harmless for any liability
|
||||||
|
incurred by, or claims asserted against, such Contributor by reason
|
||||||
|
of your accepting any such warranty or additional liability.
|
||||||
|
|
||||||
|
END OF TERMS AND CONDITIONS
|
||||||
Binary file not shown.
@ -1,312 +0,0 @@
|
|||||||
/**
|
|
||||||
* CrawlQueue
|
|
||||||
* Copyright 2013 by Michael Christen
|
|
||||||
* First released 30.08.2013 at http://yacy.net
|
|
||||||
*
|
|
||||||
* This library is free software; you can redistribute it and/or
|
|
||||||
* modify it under the terms of the GNU Lesser General Public
|
|
||||||
* License as published by the Free Software Foundation; either
|
|
||||||
* version 2.1 of the License, or (at your option) any later version.
|
|
||||||
*
|
|
||||||
* This library is distributed in the hope that it will be useful,
|
|
||||||
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
||||||
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
||||||
* Lesser General Public License for more details.
|
|
||||||
*
|
|
||||||
* You should have received a copy of the GNU Lesser General Public License
|
|
||||||
* along with this program in the file lgpl21.txt
|
|
||||||
* If not, see <http://www.gnu.org/licenses/>.
|
|
||||||
*/
|
|
||||||
|
|
||||||
package net.yacy.crawler;
|
|
||||||
|
|
||||||
import java.io.File;
|
|
||||||
import java.io.IOException;
|
|
||||||
import java.util.Iterator;
|
|
||||||
|
|
||||||
import net.yacy.cora.document.encoding.ASCII;
|
|
||||||
import net.yacy.cora.document.encoding.UTF8;
|
|
||||||
import net.yacy.cora.document.id.DigestURL;
|
|
||||||
import net.yacy.cora.federate.yacy.CacheStrategy;
|
|
||||||
import net.yacy.cora.order.Base64Order;
|
|
||||||
import net.yacy.cora.protocol.ClientIdentification;
|
|
||||||
import net.yacy.cora.storage.HandleSet;
|
|
||||||
import net.yacy.cora.util.ConcurrentLog;
|
|
||||||
import net.yacy.cora.util.SpaceExceededException;
|
|
||||||
import net.yacy.crawler.data.Cache;
|
|
||||||
import net.yacy.crawler.data.CrawlProfile;
|
|
||||||
import net.yacy.crawler.data.Latency;
|
|
||||||
import net.yacy.crawler.retrieval.Request;
|
|
||||||
import net.yacy.crawler.robots.RobotsTxt;
|
|
||||||
import net.yacy.kelondro.data.meta.URIMetadataRow;
|
|
||||||
import net.yacy.kelondro.index.BufferedObjectIndex;
|
|
||||||
import net.yacy.kelondro.index.Row;
|
|
||||||
import net.yacy.kelondro.index.RowHandleSet;
|
|
||||||
import net.yacy.kelondro.table.Table;
|
|
||||||
import net.yacy.kelondro.util.MemoryControl;
|
|
||||||
import net.yacy.repository.Blacklist.BlacklistType;
|
|
||||||
import net.yacy.search.Switchboard;
|
|
||||||
|
|
||||||
public class CrawlQueue {
|
|
||||||
|
|
||||||
private static final int EcoFSBufferSize = 1000;
|
|
||||||
private static final int objectIndexBufferSize = 1000;
|
|
||||||
private static final int MAX_DOUBLE_PUSH_CHECK = 100000;
|
|
||||||
|
|
||||||
private BufferedObjectIndex urlFileIndex;
|
|
||||||
private final HandleSet double_push_check;
|
|
||||||
|
|
||||||
public CrawlQueue(
|
|
||||||
final File cachePath,
|
|
||||||
final String filename,
|
|
||||||
final boolean useTailCache,
|
|
||||||
final boolean exceed134217727) {
|
|
||||||
|
|
||||||
// create a stack for newly entered entries
|
|
||||||
if (!(cachePath.exists())) cachePath.mkdir(); // make the path
|
|
||||||
cachePath.mkdirs();
|
|
||||||
final File f = new File(cachePath, filename);
|
|
||||||
try {
|
|
||||||
this.urlFileIndex = new BufferedObjectIndex(new Table(f, Request.rowdef, EcoFSBufferSize, 0, useTailCache, exceed134217727, true), objectIndexBufferSize);
|
|
||||||
} catch (final SpaceExceededException e) {
|
|
||||||
try {
|
|
||||||
this.urlFileIndex = new BufferedObjectIndex(new Table(f, Request.rowdef, 0, 0, false, exceed134217727, true), objectIndexBufferSize);
|
|
||||||
} catch (final SpaceExceededException e1) {
|
|
||||||
ConcurrentLog.logException(e1);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
this.double_push_check = new RowHandleSet(URIMetadataRow.rowdef.primaryKeyLength, URIMetadataRow.rowdef.objectOrder, 0);
|
|
||||||
ConcurrentLog.info("CrawlQueue", "opened queue file with " + this.urlFileIndex.size() + " entries from " + f.toString());
|
|
||||||
}
|
|
||||||
|
|
||||||
public synchronized void close() {
|
|
||||||
if (this.urlFileIndex != null) {
|
|
||||||
this.urlFileIndex.close();
|
|
||||||
this.urlFileIndex = null;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
public void clear() {
|
|
||||||
ConcurrentLog.info("CrawlQueue", "cleaning CrawlQueue with " + this.urlFileIndex.size() + " entries from " + this.urlFileIndex.filename());
|
|
||||||
try {
|
|
||||||
this.urlFileIndex.clear();
|
|
||||||
} catch (final IOException e) {
|
|
||||||
ConcurrentLog.logException(e);
|
|
||||||
}
|
|
||||||
this.double_push_check.clear();
|
|
||||||
}
|
|
||||||
|
|
||||||
public Request get(final byte[] urlhash) throws IOException {
|
|
||||||
assert urlhash != null;
|
|
||||||
if (this.urlFileIndex == null) return null; // case occurs during shutdown
|
|
||||||
final Row.Entry entry = this.urlFileIndex.get(urlhash, false);
|
|
||||||
if (entry == null) return null;
|
|
||||||
return new Request(entry);
|
|
||||||
}
|
|
||||||
|
|
||||||
public int removeAllByProfileHandle(final String profileHandle, final long timeout) throws IOException, SpaceExceededException {
|
|
||||||
// removes all entries with a specific profile hash.
|
|
||||||
// this may last some time
|
|
||||||
// returns number of deletions
|
|
||||||
|
|
||||||
// first find a list of url hashes that shall be deleted
|
|
||||||
final HandleSet urlHashes = new RowHandleSet(this.urlFileIndex.row().primaryKeyLength, Base64Order.enhancedCoder, 100);
|
|
||||||
final long terminate = timeout == Long.MAX_VALUE ? Long.MAX_VALUE : (timeout > 0) ? System.currentTimeMillis() + timeout : Long.MAX_VALUE;
|
|
||||||
synchronized (this) {
|
|
||||||
final Iterator<Row.Entry> i = this.urlFileIndex.rows();
|
|
||||||
Row.Entry rowEntry;
|
|
||||||
Request crawlEntry;
|
|
||||||
while (i.hasNext() && (System.currentTimeMillis() < terminate)) {
|
|
||||||
rowEntry = i.next();
|
|
||||||
crawlEntry = new Request(rowEntry);
|
|
||||||
if (crawlEntry.profileHandle().equals(profileHandle)) {
|
|
||||||
urlHashes.put(crawlEntry.url().hash());
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// then delete all these urls from the queues and the file index
|
|
||||||
return remove(urlHashes);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* this method is only here, because so many import/export methods need it
|
|
||||||
and it was implemented in the previous architecture
|
|
||||||
however, usage is not recommended
|
|
||||||
* @param urlHashes, a list of hashes that shall be removed
|
|
||||||
* @return number of entries that had been removed
|
|
||||||
* @throws IOException
|
|
||||||
*/
|
|
||||||
public synchronized int remove(final HandleSet urlHashes) throws IOException {
|
|
||||||
final int s = this.urlFileIndex.size();
|
|
||||||
int removedCounter = 0;
|
|
||||||
for (final byte[] urlhash: urlHashes) {
|
|
||||||
final Row.Entry entry = this.urlFileIndex.remove(urlhash);
|
|
||||||
if (entry != null) removedCounter++;
|
|
||||||
|
|
||||||
// remove from double-check caches
|
|
||||||
this.double_push_check.remove(urlhash);
|
|
||||||
}
|
|
||||||
if (removedCounter == 0) return 0;
|
|
||||||
assert this.urlFileIndex.size() + removedCounter == s : "urlFileIndex.size() = " + this.urlFileIndex.size() + ", s = " + s;
|
|
||||||
|
|
||||||
return removedCounter;
|
|
||||||
}
|
|
||||||
|
|
||||||
public boolean has(final byte[] urlhashb) {
|
|
||||||
return this.urlFileIndex.has(urlhashb) || this.double_push_check.has(urlhashb);
|
|
||||||
}
|
|
||||||
|
|
||||||
public int size() {
|
|
||||||
return this.urlFileIndex.size();
|
|
||||||
}
|
|
||||||
|
|
||||||
public boolean isEmpty() {
|
|
||||||
return this.urlFileIndex.isEmpty();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* push a crawl request on the balancer stack
|
|
||||||
* @param entry
|
|
||||||
* @return null if this was successful or a String explaining what went wrong in case of an error
|
|
||||||
* @throws IOException
|
|
||||||
* @throws SpaceExceededException
|
|
||||||
*/
|
|
||||||
public String push(final Request entry, CrawlProfile profile, final RobotsTxt robots) throws IOException, SpaceExceededException {
|
|
||||||
assert entry != null;
|
|
||||||
final byte[] hash = entry.url().hash();
|
|
||||||
synchronized (this) {
|
|
||||||
// double-check
|
|
||||||
if (this.double_push_check.has(hash)) return "double occurrence in double_push_check";
|
|
||||||
if (this.urlFileIndex.has(hash)) return "double occurrence in urlFileIndex";
|
|
||||||
|
|
||||||
if (this.double_push_check.size() > MAX_DOUBLE_PUSH_CHECK || MemoryControl.shortStatus()) this.double_push_check.clear();
|
|
||||||
this.double_push_check.put(hash);
|
|
||||||
|
|
||||||
// increase dom counter
|
|
||||||
if (profile != null && profile.domMaxPages() != Integer.MAX_VALUE && profile.domMaxPages() > 0) {
|
|
||||||
profile.domInc(entry.url().getHost());
|
|
||||||
}
|
|
||||||
|
|
||||||
// add to index
|
|
||||||
final int s = this.urlFileIndex.size();
|
|
||||||
this.urlFileIndex.put(entry.toRow());
|
|
||||||
assert s < this.urlFileIndex.size() : "hash = " + ASCII.String(hash) + ", s = " + s + ", size = " + this.urlFileIndex.size();
|
|
||||||
assert this.urlFileIndex.has(hash) : "hash = " + ASCII.String(hash);
|
|
||||||
|
|
||||||
// add the hash to a queue if the host is unknown to get this fast into the balancer
|
|
||||||
// now disabled to prevent that a crawl 'freezes' to a specific domain which hosts a lot of pages; the queues are filled anyway
|
|
||||||
//if (!this.domainStacks.containsKey(entry.url().getHost())) pushHashToDomainStacks(entry.url().getHost(), entry.url().hash());
|
|
||||||
}
|
|
||||||
robots.ensureExist(entry.url(), profile.getAgent(), true); // concurrently load all robots.txt
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get the minimum sleep time for a given url. The result can also be negative to reflect the time since the last access
|
|
||||||
* The time can be as low as Integer.MIN_VALUE to show that there should not be any limitation at all.
|
|
||||||
* @param robots
|
|
||||||
* @param profileEntry
|
|
||||||
* @param crawlURL
|
|
||||||
* @return the sleep time in milliseconds; may be negative for no sleep time
|
|
||||||
*/
|
|
||||||
private long getDomainSleepTime(final RobotsTxt robots, final CrawlProfile profileEntry, final DigestURL crawlURL) {
|
|
||||||
if (profileEntry == null) return 0;
|
|
||||||
long sleeptime = (
|
|
||||||
profileEntry.cacheStrategy() == CacheStrategy.CACHEONLY ||
|
|
||||||
(profileEntry.cacheStrategy() == CacheStrategy.IFEXIST && Cache.has(crawlURL.hash()))
|
|
||||||
) ? Integer.MIN_VALUE : Latency.waitingRemaining(crawlURL, robots, profileEntry.getAgent()); // this uses the robots.txt database and may cause a loading of robots.txt from the server
|
|
||||||
return sleeptime;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* load a robots.txt to get the robots time.
|
|
||||||
* ATTENTION: this method causes that a robots.txt is loaded from the web which may cause a longer delay in execution.
|
|
||||||
* This shall therefore not be called in synchronized environments.
|
|
||||||
* @param robots
|
|
||||||
* @param profileEntry
|
|
||||||
* @param crawlURL
|
|
||||||
* @return
|
|
||||||
*/
|
|
||||||
private long getRobotsTime(final RobotsTxt robots, final DigestURL crawlURL, ClientIdentification.Agent agent) {
|
|
||||||
long sleeptime = Latency.waitingRobots(crawlURL, robots, agent); // this uses the robots.txt database and may cause a loading of robots.txt from the server
|
|
||||||
return sleeptime < 0 ? 0 : sleeptime;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* get the next entry in this crawl queue in such a way that the domain access time delta is maximized
|
|
||||||
* and always above the given minimum delay time. An additional delay time is computed using the robots.txt
|
|
||||||
* crawl-delay time which is always respected. In case the minimum time cannot ensured, this method pauses
|
|
||||||
* the necessary time until the url is released and returned as CrawlEntry object. In case that a profile
|
|
||||||
* for the computed Entry does not exist, null is returned
|
|
||||||
* @param delay true if the requester demands forced delays using explicit thread sleep
|
|
||||||
* @param profile
|
|
||||||
* @return a url in a CrawlEntry object
|
|
||||||
* @throws IOException
|
|
||||||
* @throws SpaceExceededException
|
|
||||||
*/
|
|
||||||
public Request pop(final boolean delay, final CrawlSwitchboard cs, final RobotsTxt robots) throws IOException {
|
|
||||||
// returns a crawl entry from the stack and ensures minimum delta times
|
|
||||||
|
|
||||||
if (this.urlFileIndex.isEmpty()) return null;
|
|
||||||
long sleeptime = 0;
|
|
||||||
Request crawlEntry = null;
|
|
||||||
CrawlProfile profileEntry = null;
|
|
||||||
while (this.urlFileIndex.size() > 0) {
|
|
||||||
synchronized (this) {
|
|
||||||
Row.Entry rowEntry = this.urlFileIndex.removeOne();
|
|
||||||
if (rowEntry == null) return null;
|
|
||||||
crawlEntry = new Request(rowEntry);
|
|
||||||
profileEntry = cs.getActive(UTF8.getBytes(crawlEntry.profileHandle()));
|
|
||||||
if (profileEntry == null) {
|
|
||||||
ConcurrentLog.warn("CrawlQueue", "no profile entry for handle " + crawlEntry.profileHandle());
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
|
|
||||||
// check blacklist (again) because the user may have created blacklist entries after the queue has been filled
|
|
||||||
if (Switchboard.urlBlacklist.isListed(BlacklistType.CRAWLER, crawlEntry.url())) {
|
|
||||||
ConcurrentLog.fine("CrawlQueue", "URL '" + crawlEntry.url() + "' is in blacklist.");
|
|
||||||
continue;
|
|
||||||
}
|
|
||||||
|
|
||||||
// at this point we must check if the crawlEntry has relevance because the crawl profile still exists
|
|
||||||
// if not: return null. A calling method must handle the null value and try again
|
|
||||||
profileEntry = cs.getActive(UTF8.getBytes(crawlEntry.profileHandle()));
|
|
||||||
if (profileEntry == null) {
|
|
||||||
ConcurrentLog.warn("CrawlQueue", "no profile entry for handle " + crawlEntry.profileHandle());
|
|
||||||
continue;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
// depending on the caching policy we need sleep time to avoid DoS-like situations
|
|
||||||
sleeptime = getDomainSleepTime(robots, profileEntry, crawlEntry.url());
|
|
||||||
|
|
||||||
ClientIdentification.Agent agent = profileEntry == null ? ClientIdentification.yacyInternetCrawlerAgent : profileEntry.getAgent();
|
|
||||||
long robotsTime = getRobotsTime(robots, crawlEntry.url(), agent);
|
|
||||||
Latency.updateAfterSelection(crawlEntry.url(), profileEntry == null ? 0 : robotsTime);
|
|
||||||
if (delay && sleeptime > 0) {
|
|
||||||
// force a busy waiting here
|
|
||||||
// in best case, this should never happen if the balancer works propertly
|
|
||||||
// this is only to protection against the worst case, where the crawler could
|
|
||||||
// behave in a DoS-manner
|
|
||||||
ConcurrentLog.info("CrawlQueue", "forcing crawl-delay of " + sleeptime + " milliseconds for " + crawlEntry.url().getHost() + ": " + Latency.waitingRemainingExplain(crawlEntry.url(), robots, agent));
|
|
||||||
long loops = sleeptime / 1000;
|
|
||||||
long rest = sleeptime % 1000;
|
|
||||||
if (loops < 3) {
|
|
||||||
rest = rest + 1000 * loops;
|
|
||||||
loops = 0;
|
|
||||||
}
|
|
||||||
Thread.currentThread().setName("CrawlQueue waiting for " +crawlEntry.url().getHost() + ": " + sleeptime + " milliseconds");
|
|
||||||
synchronized(this) {
|
|
||||||
// must be synchronized here to avoid 'takeover' moves from other threads which then idle the same time which would not be enough
|
|
||||||
if (rest > 0) {try {this.wait(rest);} catch (final InterruptedException e) {}}
|
|
||||||
for (int i = 0; i < loops; i++) {
|
|
||||||
ConcurrentLog.info("CrawlQueue", "waiting for " + crawlEntry.url().getHost() + ": " + (loops - i) + " seconds remaining...");
|
|
||||||
try {this.wait(1000); } catch (final InterruptedException e) {}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
Latency.updateAfterSelection(crawlEntry.url(), robotsTime);
|
|
||||||
}
|
|
||||||
return crawlEntry;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@ -0,0 +1,256 @@
|
|||||||
|
/**
|
||||||
|
* HostQueue
|
||||||
|
* Copyright 2013 by Michael Christen
|
||||||
|
* First released 24.09.2013 at http://yacy.net
|
||||||
|
*
|
||||||
|
* This library is free software; you can redistribute it and/or
|
||||||
|
* modify it under the terms of the GNU Lesser General Public
|
||||||
|
* License as published by the Free Software Foundation; either
|
||||||
|
* version 2.1 of the License, or (at your option) any later version.
|
||||||
|
*
|
||||||
|
* This library is distributed in the hope that it will be useful,
|
||||||
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||||
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
||||||
|
* Lesser General Public License for more details.
|
||||||
|
*
|
||||||
|
* You should have received a copy of the GNU Lesser General Public License
|
||||||
|
* along with this program in the file lgpl21.txt
|
||||||
|
* If not, see <http://www.gnu.org/licenses/>.
|
||||||
|
*/
|
||||||
|
|
||||||
|
package net.yacy.crawler;
|
||||||
|
|
||||||
|
import java.io.File;
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.util.Iterator;
|
||||||
|
|
||||||
|
import net.yacy.cora.document.encoding.ASCII;
|
||||||
|
import net.yacy.cora.order.Base64Order;
|
||||||
|
import net.yacy.cora.storage.HandleSet;
|
||||||
|
import net.yacy.cora.util.ConcurrentLog;
|
||||||
|
import net.yacy.cora.util.SpaceExceededException;
|
||||||
|
import net.yacy.crawler.data.CrawlProfile;
|
||||||
|
import net.yacy.crawler.retrieval.Request;
|
||||||
|
import net.yacy.crawler.robots.RobotsTxt;
|
||||||
|
import net.yacy.kelondro.data.meta.URIMetadataRow;
|
||||||
|
import net.yacy.kelondro.index.BufferedObjectIndex;
|
||||||
|
import net.yacy.kelondro.index.Row;
|
||||||
|
import net.yacy.kelondro.index.RowHandleSet;
|
||||||
|
import net.yacy.kelondro.table.Table;
|
||||||
|
import net.yacy.kelondro.util.MemoryControl;
|
||||||
|
import net.yacy.repository.Blacklist.BlacklistType;
|
||||||
|
import net.yacy.search.Switchboard;
|
||||||
|
|
||||||
|
public class HostQueue {
|
||||||
|
|
||||||
|
public static final String indexSuffix = ".stack";
|
||||||
|
private static final int EcoFSBufferSize = 1000;
|
||||||
|
private static final int objectIndexBufferSize = 1000;
|
||||||
|
private static final int MAX_DOUBLE_PUSH_CHECK = 100000;
|
||||||
|
|
||||||
|
private final String hostHash;
|
||||||
|
private final File queuesPath;
|
||||||
|
private BufferedObjectIndex requestStack;
|
||||||
|
private HandleSet urlHashDoubleCheck;
|
||||||
|
|
||||||
|
public HostQueue(
|
||||||
|
final File queuesPath,
|
||||||
|
final String hostHash,
|
||||||
|
final boolean useTailCache,
|
||||||
|
final boolean exceed134217727) {
|
||||||
|
this.hostHash = hostHash;
|
||||||
|
this.queuesPath = queuesPath;
|
||||||
|
this.urlHashDoubleCheck = new RowHandleSet(URIMetadataRow.rowdef.primaryKeyLength, URIMetadataRow.rowdef.objectOrder, 0);
|
||||||
|
|
||||||
|
// create a stack for newly entered entries
|
||||||
|
if (!(this.queuesPath.exists())) this.queuesPath.mkdir(); // make the path
|
||||||
|
this.queuesPath.mkdirs();
|
||||||
|
final File f = new File(this.queuesPath, this.hostHash + indexSuffix);
|
||||||
|
try {
|
||||||
|
this.requestStack = new BufferedObjectIndex(new Table(f, Request.rowdef, EcoFSBufferSize, 0, useTailCache, exceed134217727, true), objectIndexBufferSize);
|
||||||
|
} catch (final SpaceExceededException e) {
|
||||||
|
try {
|
||||||
|
this.requestStack = new BufferedObjectIndex(new Table(f, Request.rowdef, 0, 0, false, exceed134217727, true), objectIndexBufferSize);
|
||||||
|
} catch (final SpaceExceededException e1) {
|
||||||
|
ConcurrentLog.logException(e1);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
ConcurrentLog.info("Balancer", "opened balancer file with " + this.requestStack.size() + " entries from " + f.toString());
|
||||||
|
}
|
||||||
|
|
||||||
|
public synchronized void close() {
|
||||||
|
int sizeBeforeClose = this.size();
|
||||||
|
if (this.urlHashDoubleCheck != null) {
|
||||||
|
this.urlHashDoubleCheck.clear();
|
||||||
|
this.urlHashDoubleCheck = null;
|
||||||
|
}
|
||||||
|
if (this.requestStack != null) {
|
||||||
|
this.requestStack.close();
|
||||||
|
this.requestStack = null;
|
||||||
|
}
|
||||||
|
if (sizeBeforeClose == 0) {
|
||||||
|
// clean up
|
||||||
|
new File(this.queuesPath, this.hostHash + indexSuffix).delete();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public void clear() {
|
||||||
|
try {
|
||||||
|
this.requestStack.clear();
|
||||||
|
} catch (final IOException e) {
|
||||||
|
ConcurrentLog.logException(e);
|
||||||
|
}
|
||||||
|
this.urlHashDoubleCheck.clear();
|
||||||
|
}
|
||||||
|
|
||||||
|
public Request get(final byte[] urlhash) throws IOException {
|
||||||
|
assert urlhash != null;
|
||||||
|
if (this.requestStack == null) return null; // case occurs during shutdown
|
||||||
|
final Row.Entry entry = this.requestStack.get(urlhash, false);
|
||||||
|
if (entry == null) return null;
|
||||||
|
return new Request(entry);
|
||||||
|
}
|
||||||
|
|
||||||
|
public int removeAllByProfileHandle(final String profileHandle, final long timeout) throws IOException, SpaceExceededException {
|
||||||
|
// first find a list of url hashes that shall be deleted
|
||||||
|
final HandleSet urlHashes = new RowHandleSet(this.requestStack.row().primaryKeyLength, Base64Order.enhancedCoder, 100);
|
||||||
|
final long terminate = timeout == Long.MAX_VALUE ? Long.MAX_VALUE : (timeout > 0) ? System.currentTimeMillis() + timeout : Long.MAX_VALUE;
|
||||||
|
synchronized (this) {
|
||||||
|
final Iterator<Row.Entry> i = this.requestStack.rows();
|
||||||
|
Row.Entry rowEntry;
|
||||||
|
Request crawlEntry;
|
||||||
|
while (i.hasNext() && (System.currentTimeMillis() < terminate)) {
|
||||||
|
rowEntry = i.next();
|
||||||
|
crawlEntry = new Request(rowEntry);
|
||||||
|
if (crawlEntry.profileHandle().equals(profileHandle)) {
|
||||||
|
urlHashes.put(crawlEntry.url().hash());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// then delete all these urls from the queues and the file index
|
||||||
|
return remove(urlHashes);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* remove urls from the queue
|
||||||
|
* @param urlHashes, a list of hashes that shall be removed
|
||||||
|
* @return number of entries that had been removed
|
||||||
|
* @throws IOException
|
||||||
|
*/
|
||||||
|
public synchronized int remove(final HandleSet urlHashes) throws IOException {
|
||||||
|
final int s = this.requestStack.size();
|
||||||
|
int removedCounter = 0;
|
||||||
|
for (final byte[] urlhash: urlHashes) {
|
||||||
|
final Row.Entry entry = this.requestStack.remove(urlhash);
|
||||||
|
if (entry != null) removedCounter++;
|
||||||
|
|
||||||
|
// remove from double-check caches
|
||||||
|
this.urlHashDoubleCheck.remove(urlhash);
|
||||||
|
}
|
||||||
|
if (removedCounter == 0) return 0;
|
||||||
|
assert this.requestStack.size() + removedCounter == s : "urlFileIndex.size() = " + this.requestStack.size() + ", s = " + s;
|
||||||
|
return removedCounter;
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean has(final byte[] urlhashb) {
|
||||||
|
return this.requestStack.has(urlhashb) || this.urlHashDoubleCheck.has(urlhashb);
|
||||||
|
}
|
||||||
|
|
||||||
|
public int size() {
|
||||||
|
return this.requestStack.size();
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean isEmpty() {
|
||||||
|
return this.requestStack.isEmpty();
|
||||||
|
}
|
||||||
|
|
||||||
|
public String push(final Request entry, CrawlProfile profile, final RobotsTxt robots) throws IOException, SpaceExceededException {
|
||||||
|
assert entry != null;
|
||||||
|
final byte[] hash = entry.url().hash();
|
||||||
|
synchronized (this) {
|
||||||
|
// double-check
|
||||||
|
if (this.urlHashDoubleCheck.has(hash)) return "double occurrence in double_push_check";
|
||||||
|
if (this.requestStack.has(hash)) return "double occurrence in urlFileIndex";
|
||||||
|
|
||||||
|
if (this.urlHashDoubleCheck.size() > MAX_DOUBLE_PUSH_CHECK || MemoryControl.shortStatus()) this.urlHashDoubleCheck.clear();
|
||||||
|
this.urlHashDoubleCheck.put(hash);
|
||||||
|
|
||||||
|
// increase dom counter
|
||||||
|
if (profile != null && profile.domMaxPages() != Integer.MAX_VALUE && profile.domMaxPages() > 0) {
|
||||||
|
profile.domInc(entry.url().getHost());
|
||||||
|
}
|
||||||
|
|
||||||
|
// add to index
|
||||||
|
final int s = this.requestStack.size();
|
||||||
|
this.requestStack.put(entry.toRow());
|
||||||
|
assert s < this.requestStack.size() : "hash = " + ASCII.String(hash) + ", s = " + s + ", size = " + this.requestStack.size();
|
||||||
|
assert this.requestStack.has(hash) : "hash = " + ASCII.String(hash);
|
||||||
|
|
||||||
|
// add the hash to a queue if the host is unknown to get this fast into the balancer
|
||||||
|
// now disabled to prevent that a crawl 'freezes' to a specific domain which hosts a lot of pages; the queues are filled anyway
|
||||||
|
//if (!this.domainStacks.containsKey(entry.url().getHost())) pushHashToDomainStacks(entry.url().getHost(), entry.url().hash());
|
||||||
|
}
|
||||||
|
robots.ensureExist(entry.url(), profile.getAgent(), true); // concurrently load all robots.txt
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
public Request pop() throws IOException {
|
||||||
|
// returns a crawl entry from the stack and ensures minimum delta times
|
||||||
|
|
||||||
|
Request crawlEntry = null;
|
||||||
|
while (!this.requestStack.isEmpty()) {
|
||||||
|
synchronized (this) {
|
||||||
|
Row.Entry rowEntry = this.requestStack.removeOne();
|
||||||
|
if (rowEntry == null) return null;
|
||||||
|
crawlEntry = new Request(rowEntry);
|
||||||
|
|
||||||
|
// check blacklist (again) because the user may have created blacklist entries after the queue has been filled
|
||||||
|
if (Switchboard.urlBlacklist.isListed(BlacklistType.CRAWLER, crawlEntry.url())) {
|
||||||
|
ConcurrentLog.fine("CRAWLER", "URL '" + crawlEntry.url() + "' is in blacklist.");
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (crawlEntry == null) return null;
|
||||||
|
return crawlEntry;
|
||||||
|
}
|
||||||
|
|
||||||
|
public Iterator<Request> iterator() throws IOException {
|
||||||
|
return new EntryIterator();
|
||||||
|
}
|
||||||
|
|
||||||
|
private class EntryIterator implements Iterator<Request> {
|
||||||
|
|
||||||
|
private Iterator<Row.Entry> rowIterator;
|
||||||
|
|
||||||
|
public EntryIterator() throws IOException {
|
||||||
|
this.rowIterator = HostQueue.this.requestStack.rows();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public boolean hasNext() {
|
||||||
|
return (this.rowIterator == null) ? false : this.rowIterator.hasNext();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public Request next() {
|
||||||
|
final Row.Entry entry = this.rowIterator.next();
|
||||||
|
try {
|
||||||
|
return (entry == null) ? null : new Request(entry);
|
||||||
|
} catch (final IOException e) {
|
||||||
|
ConcurrentLog.logException(e);
|
||||||
|
this.rowIterator = null;
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void remove() {
|
||||||
|
if (this.rowIterator != null) this.rowIterator.remove();
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
@ -0,0 +1,169 @@
|
|||||||
|
/**
|
||||||
|
* HostQueues
|
||||||
|
* Copyright 2013 by Michael Christen
|
||||||
|
* First released 24.09.2013 at http://yacy.net
|
||||||
|
*
|
||||||
|
* This library is free software; you can redistribute it and/or
|
||||||
|
* modify it under the terms of the GNU Lesser General Public
|
||||||
|
* License as published by the Free Software Foundation; either
|
||||||
|
* version 2.1 of the License, or (at your option) any later version.
|
||||||
|
*
|
||||||
|
* This library is distributed in the hope that it will be useful,
|
||||||
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||||
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
||||||
|
* Lesser General Public License for more details.
|
||||||
|
*
|
||||||
|
* You should have received a copy of the GNU Lesser General Public License
|
||||||
|
* along with this program in the file lgpl21.txt
|
||||||
|
* If not, see <http://www.gnu.org/licenses/>.
|
||||||
|
*/
|
||||||
|
|
||||||
|
package net.yacy.crawler;
|
||||||
|
|
||||||
|
import java.io.File;
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.util.ArrayList;
|
||||||
|
import java.util.HashMap;
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.Map;
|
||||||
|
import java.util.Set;
|
||||||
|
|
||||||
|
import net.yacy.cora.document.encoding.ASCII;
|
||||||
|
import net.yacy.cora.order.Base64Order;
|
||||||
|
import net.yacy.cora.storage.HandleSet;
|
||||||
|
import net.yacy.cora.util.SpaceExceededException;
|
||||||
|
import net.yacy.crawler.data.CrawlProfile;
|
||||||
|
import net.yacy.crawler.retrieval.Request;
|
||||||
|
import net.yacy.crawler.robots.RobotsTxt;
|
||||||
|
import net.yacy.kelondro.data.word.Word;
|
||||||
|
import net.yacy.kelondro.index.RowHandleSet;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* wrapper for single HostQueue queues; this is a collection of such queues.
|
||||||
|
* All these queues are stored in a common directory for the queue stacks
|
||||||
|
*/
|
||||||
|
public class HostQueues {
|
||||||
|
|
||||||
|
private final File queuesPath;
|
||||||
|
private final boolean useTailCache;
|
||||||
|
private final boolean exceed134217727;
|
||||||
|
private final Map<String, HostQueue> queues;
|
||||||
|
|
||||||
|
public HostQueues(
|
||||||
|
final File queuesPath,
|
||||||
|
final boolean useTailCache,
|
||||||
|
final boolean exceed134217727) {
|
||||||
|
this.queuesPath = queuesPath;
|
||||||
|
this.useTailCache = useTailCache;
|
||||||
|
this.exceed134217727 = exceed134217727;
|
||||||
|
|
||||||
|
// create a stack for newly entered entries
|
||||||
|
if (!(queuesPath.exists())) queuesPath.mkdir(); // make the path
|
||||||
|
this.queuesPath.mkdirs();
|
||||||
|
this.queues = new HashMap<String, HostQueue>();
|
||||||
|
String[] list = this.queuesPath.list();
|
||||||
|
for (String queuefile: list) {
|
||||||
|
if (queuefile.endsWith(HostQueue.indexSuffix)) {
|
||||||
|
String hosthash = queuefile.substring(0, queuefile.length() - HostQueue.indexSuffix.length());
|
||||||
|
HostQueue queue = new HostQueue(this.queuesPath, hosthash, this.useTailCache, this.exceed134217727);
|
||||||
|
this.queues.put(hosthash, queue);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public synchronized void close() {
|
||||||
|
for (HostQueue queue: this.queues.values()) queue.close();
|
||||||
|
this.queues.clear();
|
||||||
|
}
|
||||||
|
|
||||||
|
public void clear() {
|
||||||
|
for (HostQueue queue: this.queues.values()) queue.clear();
|
||||||
|
this.queues.clear();
|
||||||
|
}
|
||||||
|
|
||||||
|
public Request get(final byte[] urlhash) throws IOException {
|
||||||
|
String hosthash = ASCII.String(urlhash, 6, 6);
|
||||||
|
HostQueue queue = this.queues.get(hosthash);
|
||||||
|
if (queue == null) return null;
|
||||||
|
return queue.get(urlhash);
|
||||||
|
}
|
||||||
|
|
||||||
|
public int removeAllByProfileHandle(final String profileHandle, final long timeout) throws IOException, SpaceExceededException {
|
||||||
|
int c = 0;
|
||||||
|
for (HostQueue queue: this.queues.values()) c += queue.removeAllByProfileHandle(profileHandle, timeout);
|
||||||
|
return c;
|
||||||
|
}
|
||||||
|
|
||||||
|
public synchronized int remove(final HandleSet urlHashes) throws IOException {
|
||||||
|
Map<String, HandleSet> removeLists = new HashMap<String, HandleSet>();
|
||||||
|
for (byte[] urlhash: urlHashes) {
|
||||||
|
String hosthash = ASCII.String(urlhash, 6, 6);
|
||||||
|
HandleSet removeList = removeLists.get(hosthash);
|
||||||
|
if (removeList == null) {
|
||||||
|
removeList = new RowHandleSet(Word.commonHashLength, Base64Order.enhancedCoder, 100);
|
||||||
|
removeLists.put(hosthash, removeList);
|
||||||
|
}
|
||||||
|
try {removeList.put(urlhash);} catch (SpaceExceededException e) {}
|
||||||
|
}
|
||||||
|
int c = 0;
|
||||||
|
for (Map.Entry<String, HandleSet> entry: removeLists.entrySet()) {
|
||||||
|
HostQueue queue = this.queues.get(entry.getKey());
|
||||||
|
if (queue != null) c += queue.remove(entry.getValue());
|
||||||
|
}
|
||||||
|
return c;
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean has(final byte[] urlhashb) {
|
||||||
|
String hosthash = ASCII.String(urlhashb, 6, 6);
|
||||||
|
HostQueue queue = this.queues.get(hosthash);
|
||||||
|
if (queue == null) return false;
|
||||||
|
return queue.has(urlhashb);
|
||||||
|
}
|
||||||
|
|
||||||
|
public int size() {
|
||||||
|
int c = 0;
|
||||||
|
for (HostQueue queue: this.queues.values()) c += queue.size();
|
||||||
|
return c;
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean isEmpty() {
|
||||||
|
for (HostQueue queue: this.queues.values()) if (!queue.isEmpty()) return false;
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* push a request to one of the host queues. If the queue does not exist, it is created
|
||||||
|
* @param entry
|
||||||
|
* @param profile
|
||||||
|
* @param robots
|
||||||
|
* @return null if everything is ok or a string with an error message if the push is not allowed according to the crawl profile or robots
|
||||||
|
* @throws IOException
|
||||||
|
* @throws SpaceExceededException
|
||||||
|
*/
|
||||||
|
public String push(final Request entry, CrawlProfile profile, final RobotsTxt robots) throws IOException, SpaceExceededException {
|
||||||
|
String hosthash = ASCII.String(entry.url().hash(), 6, 6);
|
||||||
|
HostQueue queue = this.queues.get(hosthash);
|
||||||
|
if (queue == null) {
|
||||||
|
queue = new HostQueue(this.queuesPath, hosthash, this.useTailCache, this.exceed134217727);
|
||||||
|
this.queues.put(hosthash, queue);
|
||||||
|
}
|
||||||
|
return queue.push(entry, profile, robots);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* remove one request from all stacks except from those as listed in notFromHost
|
||||||
|
* @param notFromHost do not collect from these hosts
|
||||||
|
* @return a list of requests
|
||||||
|
* @throws IOException
|
||||||
|
*/
|
||||||
|
public List<Request> pop(Set<String> notFromHost) throws IOException {
|
||||||
|
ArrayList<Request> requests = new ArrayList<Request>();
|
||||||
|
for (Map.Entry<String, HostQueue> entry: this.queues.entrySet()) {
|
||||||
|
if (notFromHost.contains(entry.getKey())) continue;
|
||||||
|
Request r = entry.getValue().pop();
|
||||||
|
if (r != null) requests.add(r);
|
||||||
|
}
|
||||||
|
return requests;
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
Loading…
Reference in new issue