| 1 |
Notes added by Monty: |
| 2 |
|
| 3 |
This is HandlerSocket version 1.0.6 (See ChangeLog file) |
| 4 |
The original code can be found at: |
| 5 |
|
| 6 |
https://github.com/ahiguti/HandlerSocket-Plugin-for-MySQL |
| 7 |
|
| 8 |
----------------------------------------------------------------------------- |
| 9 |
HandlerSocket plugin for MySQL |
| 10 |
|
| 11 |
Copyright (c) 2010 DeNA Co.,Ltd. |
| 12 |
All rights reserved. |
| 13 |
|
| 14 |
Redistribution and use in source and binary forms, with or without |
| 15 |
modification, are permitted provided that the following conditions are met: |
| 16 |
|
| 17 |
* Redistributions of source code must retain the above copyright |
| 18 |
notice, this list of conditions and the following disclaimer. |
| 19 |
* Redistributions in binary form must reproduce the above copyright |
| 20 |
notice, this list of conditions and the following disclaimer in the |
| 21 |
documentation and/or other materials provided with the distribution. |
| 22 |
* Neither the name of DeNA Co.,Ltd. nor the names of its contributors |
| 23 |
may be used to endorse or promote products derived from this software |
| 24 |
without specific prior written permission. |
| 25 |
|
| 26 |
THIS SOFTWARE IS PROVIDED BY DeNA Co.,Ltd. "AS IS" AND ANY EXPRESS OR |
| 27 |
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF |
| 28 |
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO |
| 29 |
EVENT SHALL DeNA Co.,Ltd. BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
| 30 |
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, |
| 31 |
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; |
| 32 |
OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, |
| 33 |
WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR |
| 34 |
OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF |
| 35 |
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
| 36 |
|
| 37 |
|
| 38 |
----------------------------------------------------------------------------- |
| 39 |
About HandlerSocket |
| 40 |
|
| 41 |
HandlerSocket is a NoSQL plugin for MySQL. It works as a daemon inside the |
| 42 |
mysqld process, accept tcp connections, and execute requests from clients. |
| 43 |
HandlerSocket does not support SQL queries. Instead, it supports simple CRUD |
| 44 |
operations on tables. |
| 45 |
|
| 46 |
Because of the following reasons, HandlerSocket is much faster than the |
| 47 |
mysqld/libmysql pair in some circumstances: |
| 48 |
|
| 49 |
- HandlerSocket manipulates data without parsing SQL, which causes less |
| 50 |
CPU usage. |
| 51 |
- HandlerSocket reads many requests from clients and executes their |
| 52 |
requests in bulk, which causes less CPU and disk usage. |
| 53 |
- HandlerSocket client/server protocol is more compact than the |
| 54 |
mysql/libmysql pair, which causes less network usage. |
| 55 |
|
| 56 |
The current version of HandlerSocket only works with GNU/Linux. The source |
| 57 |
archive of HandlerSocket includes a C++ and a Perl client libraries. |
| 58 |
Here is a list of client libraries for other languages: |
| 59 |
|
| 60 |
- PHP |
| 61 |
http://openpear.org/package/Net_HandlerSocket |
| 62 |
http://github.com/tz-lom/HSPHP |
| 63 |
http://code.google.com/p/php-handlersocket/ |
| 64 |
- Java |
| 65 |
http://code.google.com/p/hs4j/ |
| 66 |
http://code.google.com/p/handlersocketforjava/ |
| 67 |
- Python |
| 68 |
http://pypi.python.org/pypi/python-handler-socket |
| 69 |
https://code.launchpad.net/~songofacandy/+junk/pyhandlersocket |
| 70 |
- Ruby |
| 71 |
https://github.com/winebarrel/ruby-handlersocket |
| 72 |
https://github.com/miyucy/handlersocket |
| 73 |
- JavaScript |
| 74 |
https://github.com/koichik/node-handlersocket |
| 75 |
- Scala |
| 76 |
https://github.com/fujohnwang/hs2client |
| 77 |
|
| 78 |
The home of HandlerSocket is here: |
| 79 |
https://github.com/ahiguti/HandlerSocket-Plugin-for-MySQL |
| 80 |
|
| 81 |
More documents are available in docs-en/ and docs-ja/ directories. |
| 82 |
|