kyotocabinet-java 0.1.0-java

data/ext/kyotocabinet-java/kyotocabinet_Error_XSYSTEM.h

@@ -0,0 +1,41 @@
+/* DO NOT EDIT THIS FILE - it is machine generated */
+#include <jni.h>
+/* Header for class kyotocabinet_Error_XSYSTEM */
+
+#ifndef _Included_kyotocabinet_Error_XSYSTEM
+#define _Included_kyotocabinet_Error_XSYSTEM
+#ifdef __cplusplus
+extern "C" {
+#endif
+#undef kyotocabinet_Error_XSYSTEM_serialVersionUID
+#define kyotocabinet_Error_XSYSTEM_serialVersionUID -3042686055658047285LL
+#undef kyotocabinet_Error_XSYSTEM_serialVersionUID
+#define kyotocabinet_Error_XSYSTEM_serialVersionUID -3387516993124229948LL
+#undef kyotocabinet_Error_XSYSTEM_serialVersionUID
+#define kyotocabinet_Error_XSYSTEM_serialVersionUID -7034897190745766939LL
+#undef kyotocabinet_Error_XSYSTEM_SUCCESS
+#define kyotocabinet_Error_XSYSTEM_SUCCESS 0L
+#undef kyotocabinet_Error_XSYSTEM_NOIMPL
+#define kyotocabinet_Error_XSYSTEM_NOIMPL 1L
+#undef kyotocabinet_Error_XSYSTEM_INVALID
+#define kyotocabinet_Error_XSYSTEM_INVALID 2L
+#undef kyotocabinet_Error_XSYSTEM_NOREPOS
+#define kyotocabinet_Error_XSYSTEM_NOREPOS 3L
+#undef kyotocabinet_Error_XSYSTEM_NOPERM
+#define kyotocabinet_Error_XSYSTEM_NOPERM 4L
+#undef kyotocabinet_Error_XSYSTEM_BROKEN
+#define kyotocabinet_Error_XSYSTEM_BROKEN 5L
+#undef kyotocabinet_Error_XSYSTEM_DUPREC
+#define kyotocabinet_Error_XSYSTEM_DUPREC 6L
+#undef kyotocabinet_Error_XSYSTEM_NOREC
+#define kyotocabinet_Error_XSYSTEM_NOREC 7L
+#undef kyotocabinet_Error_XSYSTEM_LOGIC
+#define kyotocabinet_Error_XSYSTEM_LOGIC 8L
+#undef kyotocabinet_Error_XSYSTEM_SYSTEM
+#define kyotocabinet_Error_XSYSTEM_SYSTEM 9L
+#undef kyotocabinet_Error_XSYSTEM_MISC
+#define kyotocabinet_Error_XSYSTEM_MISC 15L
+#ifdef __cplusplus
+}
+#endif
+#endif

data/ext/kyotocabinet-java/kyotocabinet_MapReduce.h

@@ -0,0 +1,33 @@
+/* DO NOT EDIT THIS FILE - it is machine generated */
+#include <jni.h>
+/* Header for class kyotocabinet_MapReduce */
+
+#ifndef _Included_kyotocabinet_MapReduce
+#define _Included_kyotocabinet_MapReduce
+#ifdef __cplusplus
+extern "C" {
+#endif
+#undef kyotocabinet_MapReduce_XNOLOCK
+#define kyotocabinet_MapReduce_XNOLOCK 1L
+#undef kyotocabinet_MapReduce_XNOCOMP
+#define kyotocabinet_MapReduce_XNOCOMP 256L
+/*
+ * Class:     kyotocabinet_MapReduce
+ * Method:    execute
+ * Signature: (Lkyotocabinet/DB;Ljava/lang/String;I)Z
+ */
+JNIEXPORT jboolean JNICALL Java_kyotocabinet_MapReduce_execute
+  (JNIEnv *, jobject, jobject, jstring, jint);
+
+/*
+ * Class:     kyotocabinet_MapReduce
+ * Method:    emit
+ * Signature: ([B[B)Z
+ */
+JNIEXPORT jboolean JNICALL Java_kyotocabinet_MapReduce_emit
+  (JNIEnv *, jobject, jbyteArray, jbyteArray);
+
+#ifdef __cplusplus
+}
+#endif
+#endif

data/ext/kyotocabinet-java/kyotocabinet_Utility.h

@@ -0,0 +1,101 @@
+/* DO NOT EDIT THIS FILE - it is machine generated */
+#include <jni.h>
+/* Header for class kyotocabinet_Utility */
+
+#ifndef _Included_kyotocabinet_Utility
+#define _Included_kyotocabinet_Utility
+#ifdef __cplusplus
+extern "C" {
+#endif
+/*
+ * Class:     kyotocabinet_Utility
+ * Method:    atoi
+ * Signature: (Ljava/lang/String;)J
+ */
+JNIEXPORT jlong JNICALL Java_kyotocabinet_Utility_atoi
+  (JNIEnv *, jclass, jstring);
+
+/*
+ * Class:     kyotocabinet_Utility
+ * Method:    atoix
+ * Signature: (Ljava/lang/String;)J
+ */
+JNIEXPORT jlong JNICALL Java_kyotocabinet_Utility_atoix
+  (JNIEnv *, jclass, jstring);
+
+/*
+ * Class:     kyotocabinet_Utility
+ * Method:    atof
+ * Signature: (Ljava/lang/String;)D
+ */
+JNIEXPORT jdouble JNICALL Java_kyotocabinet_Utility_atof
+  (JNIEnv *, jclass, jstring);
+
+/*
+ * Class:     kyotocabinet_Utility
+ * Method:    hash_murmur
+ * Signature: ([B)J
+ */
+JNIEXPORT jlong JNICALL Java_kyotocabinet_Utility_hash_1murmur
+  (JNIEnv *, jclass, jbyteArray);
+
+/*
+ * Class:     kyotocabinet_Utility
+ * Method:    hash_fnv
+ * Signature: ([B)J
+ */
+JNIEXPORT jlong JNICALL Java_kyotocabinet_Utility_hash_1fnv
+  (JNIEnv *, jclass, jbyteArray);
+
+/*
+ * Class:     kyotocabinet_Utility
+ * Method:    levdist
+ * Signature: ([B[B)J
+ */
+JNIEXPORT jlong JNICALL Java_kyotocabinet_Utility_levdist___3B_3B
+  (JNIEnv *, jclass, jbyteArray, jbyteArray);
+
+/*
+ * Class:     kyotocabinet_Utility
+ * Method:    levdist
+ * Signature: (Ljava/lang/String;Ljava/lang/String;)J
+ */
+JNIEXPORT jlong JNICALL Java_kyotocabinet_Utility_levdist__Ljava_lang_String_2Ljava_lang_String_2
+  (JNIEnv *, jclass, jstring, jstring);
+
+/*
+ * Class:     kyotocabinet_Utility
+ * Method:    remove_files_recursively
+ * Signature: (Ljava/lang/String;)Z
+ */
+JNIEXPORT jboolean JNICALL Java_kyotocabinet_Utility_remove_1files_1recursively
+  (JNIEnv *, jclass, jstring);
+
+/*
+ * Class:     kyotocabinet_Utility
+ * Method:    version
+ * Signature: ()Ljava/lang/String;
+ */
+JNIEXPORT jstring JNICALL Java_kyotocabinet_Utility_version
+  (JNIEnv *, jclass);
+
+/*
+ * Class:     kyotocabinet_Utility
+ * Method:    init_visitor_NOP
+ * Signature: ()[B
+ */
+JNIEXPORT jbyteArray JNICALL Java_kyotocabinet_Utility_init_1visitor_1NOP
+  (JNIEnv *, jclass);
+
+/*
+ * Class:     kyotocabinet_Utility
+ * Method:    init_visitor_REMOVE
+ * Signature: ()[B
+ */
+JNIEXPORT jbyteArray JNICALL Java_kyotocabinet_Utility_init_1visitor_1REMOVE
+  (JNIEnv *, jclass);
+
+#ifdef __cplusplus
+}
+#endif
+#endif

data/ext/kyotocabinet-java/kyotocabinet_ValueIterator.h

@@ -0,0 +1,21 @@
+/* DO NOT EDIT THIS FILE - it is machine generated */
+#include <jni.h>
+/* Header for class kyotocabinet_ValueIterator */
+
+#ifndef _Included_kyotocabinet_ValueIterator
+#define _Included_kyotocabinet_ValueIterator
+#ifdef __cplusplus
+extern "C" {
+#endif
+/*
+ * Class:     kyotocabinet_ValueIterator
+ * Method:    next
+ * Signature: ()[B
+ */
+JNIEXPORT jbyteArray JNICALL Java_kyotocabinet_ValueIterator_next
+  (JNIEnv *, jobject);
+
+#ifdef __cplusplus
+}
+#endif
+#endif

data/ext/kyotocabinet-java/overview.html

@@ -0,0 +1,177 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+
+<head>
+<meta http-equiv="Content-Language" content="en" />
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="author" content="FAL Labs" />
+<meta name="keywords" content="Kyoto Cabinet, Java" />
+<meta name="description" content="API specifications of Java binding" />
+<link rel="contents" href="./" />
+<link rev="made" href="mailto:info@fallabs.com" />
+<title>Java Binding of Kyoto Cabinet</title>
+</head>
+
+<body>
+
+<h1>Java Binding of Kyoto Cabinet.</h1>
+
+<div>Kyoto Cabinet is a straightforward implementation of DBM.</div>
+
+<h2>Introduction</h2>
+
+<p>Kyoto Cabinet is a library of routines for managing a database.  The database is a simple data file containing records, each is a pair of a key and a value.  Every key and value is serial bytes with variable length.  Both binary data and character string can be used as a key and a value.  Each key must be unique within a database.  There is neither concept of data tables nor data types.  Records are organized in hash table or B+ tree.</p>
+
+<p>The following access methods are provided to the database: storing a record with a key and a value, deleting a record by a key, retrieving a record by a key.  Moreover, traversal access to every key are provided.  These access methods are similar to ones of the original DBM (and its followers: NDBM and GDBM) library defined in the UNIX standard.  Kyoto Cabinet is an alternative for the DBM because of its higher performance.</p>
+
+<p>Each operation of the hash database has the time complexity of "O(1)".  Therefore, in theory, the performance is constant regardless of the scale of the database.  In practice, the performance is determined by the speed of the main memory or the storage device.  If the size of the database is less than the capacity of the main memory, the performance will seem on-memory speed, which is faster than std::map of STL.  Of course, the database size can be greater than the capacity of the main memory and the upper limit is 8 exabytes.  Even in that case, each operation needs only one or two seeking of the storage device.</p>
+
+<p>Each operation of the B+ tree database has the time complexity of "O(log N)".  Therefore, in theory, the performance is logarithmic to the scale of the database.  Although the performance of random access of the B+ tree database is slower than that of the hash database, the B+ tree database supports sequential access in order of the keys, which realizes forward matching search for strings and range search for integers.  The performance of sequential access is much faster than that of random access.</p>
+
+<p>This library wraps the polymorphic database of the C++ API.  So, you can select the internal data structure by specifying the database name in runtime.  This library is thread-safe.</p>
+
+<h2>Installation</h2>
+
+<p>Install the latest version of Kyoto Cabinet beforehand and get the package of the Java binding of Kyoto Cabinet.  JDK 6 or later is also required.</p>
+
+<p>Enter the directory of the extracted package then perform installation.</p>
+
+<pre style="margin: 0em 0.8em; padding: 0.3em; background: #eeeeff none; border: 1px solid #cccccc; font-size: 90%;">./configure
+make
+make check
+su
+make install
+</pre>
+
+<p>When a series of work finishes, the JAR file `kyotocabinet.jar' and the shared object files `libjkyotocabinet.so' and so on are installed under `/usr/local/lib'.</p>
+
+<p>Let the class search path include `/usr/local/lib/kyotocabinet.jar' and let the library search path include `/usr/local/lib'.</p>
+
+<pre style="margin: 0em 0.8em; padding: 0.3em; background: #eeeeff none; border: 1px solid #cccccc; font-size: 90%;">CLASSPATH="$CLASSPATH:/usr/local/lib/kyotocabinet.jar"
+LD_LIBRARY_PATH="$LD_LIBRARY_PATH:/usr/local/lib"
+export CLASSPATH LD_LIBRARY_PATH
+</pre>
+
+<p>The above settings can be specified by options of the runtime command.</p>
+
+<pre style="margin: 0em 0.8em; padding: 0.3em; background: #eeeeff none; border: 1px solid #cccccc; font-size: 90%;">java -cp .:kyotocabinet.jar -Djava.library.path=.:/usr/local/lib FooBarBaz ...
+</pre>
+
+<p>All symbols of Kyoto Cabinet are defined in the package `kyotocabinet'.  You can access them without any prefix by importing the package.</p>
+
+<pre style="margin: 0em 0.8em; padding: 0.3em; background: #eeeeff none; border: 1px solid #cccccc; font-size: 90%;">import kyotocabinet.*;
+</pre>
+
+<h2>Example</h2>
+
+<p>The following code is a typical example to use a database. </p>
+
+<pre style="margin: 0em 0.8em; padding: 0.3em; background: #eeeeff none; border: 1px solid #cccccc; font-size: 90%;">import kyotocabinet.*;
+
+public class KCDBEX1 {
+  public static void main(String[] args) {
+
+    // create the object
+    DB db = new DB();
+
+    // open the database
+    if (!db.open("casket.kch", DB.OWRITER | DB.OCREATE)){
+      System.err.println("open error: " + db.error());
+    }
+
+    // store records
+    if (!db.set("foo", "hop") ||
+        !db.set("bar", "step") ||
+        !db.set("baz", "jump")){
+      System.err.println("set error: " + db.error());
+    }
+
+    // retrieve records
+    String value = db.get("foo");
+    if (value != null){
+      System.out.println(value);
+    } else {
+      System.err.println("set error: " + db.error());
+    }
+
+    // traverse records
+    Cursor cur = db.cursor();
+    cur.jump();
+    String[] rec;
+    while ((rec = cur.get_str(true)) != null) {
+      System.out.println(rec[0] + ":" + rec[1]);
+    }
+    cur.disable();
+
+    // close the database
+    if(!db.close()){
+      System.err.println("close error: " + db.error());
+    }
+
+  }
+}
+</pre>
+
+<p>The following code is a more complex example, which uses the Visitor pattern.</p>
+
+<pre style="margin: 0em 0.8em; padding: 0.3em; background: #eeeeff none; border: 1px solid #cccccc; font-size: 90%;">import kyotocabinet.*;
+
+public class KCDBEX2 {
+  public static void main(String[] args) {
+
+    // create the object
+    DB db = new DB();
+
+    // open the database
+    if (!db.open("casket.kch", DB.OREADER)) {
+      System.err.println("open error: " + db.error());
+    }
+
+    // define the visitor
+    class VisitorImpl implements Visitor {
+      public byte[] visit_full(byte[] key, byte[] value) {
+        System.out.println(new String(key) + ":" + new String(value));
+        return NOP;
+      }
+      public byte[] visit_empty(byte[] key) {
+        System.err.println(new String(key) + " is missing");
+        return NOP;
+      }
+    }
+    Visitor visitor = new VisitorImpl();
+
+    // retrieve a record with visitor
+    if (!db.accept("foo".getBytes(), visitor, false) ||
+        !db.accept("dummy".getBytes(), visitor, false)) {
+      System.err.println("accept error: " + db.error());
+    }
+
+    // traverse records with visitor
+    if (!db.iterate(visitor, false)) {
+      System.err.println("iterate error: " + db.error());
+    }
+
+    // close the database
+    if(!db.close()){
+      System.err.println("close error: " + db.error());
+    }
+
+  }
+}
+</pre>
+
+<h2>License</h2>
+
+<div>Copyright (C) 2009-2011 FAL Labs</div>
+
+<p>Kyoto Cabinet is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version.</p>
+
+<p>Kyoto Cabinet 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 General Public License for more details.</p>
+
+</body>
+
+</html>

data/kyotocabinet-java.gemspec

@@ -0,0 +1,129 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "kyotocabinet-java"
+  s.version = "0.1.0"
+  s.platform = "java"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Clayton Wheeler"]
+  s.date = "2012-06-26"
+  s.description = "Wrapper for Kyoto Cabinet's Java library for use with JRuby, to provide the same interface as the native kyotocabinet-ruby gem for MRI."
+  s.email = "cswh@umich.edu"
+  s.extensions = ["ext/kyotocabinet-java/configure"]
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    "Gemfile",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "ext/kyotocabinet-java/.gitignore",
+    "ext/kyotocabinet-java/COPYING",
+    "ext/kyotocabinet-java/Cursor.java",
+    "ext/kyotocabinet-java/DB.java",
+    "ext/kyotocabinet-java/Error.java",
+    "ext/kyotocabinet-java/FileProcessor.java",
+    "ext/kyotocabinet-java/Loader.java",
+    "ext/kyotocabinet-java/Makefile.in",
+    "ext/kyotocabinet-java/MapReduce.java",
+    "ext/kyotocabinet-java/README",
+    "ext/kyotocabinet-java/Test.java",
+    "ext/kyotocabinet-java/Utility.java",
+    "ext/kyotocabinet-java/VCmakefile",
+    "ext/kyotocabinet-java/ValueIterator.java",
+    "ext/kyotocabinet-java/Visitor.java",
+    "ext/kyotocabinet-java/configure.in",
+    "ext/kyotocabinet-java/doc/allclasses-frame.html",
+    "ext/kyotocabinet-java/doc/allclasses-noframe.html",
+    "ext/kyotocabinet-java/doc/constant-values.html",
+    "ext/kyotocabinet-java/doc/index-all.html",
+    "ext/kyotocabinet-java/doc/index.html",
+    "ext/kyotocabinet-java/doc/kyotocabinet/Cursor.html",
+    "ext/kyotocabinet-java/doc/kyotocabinet/DB.html",
+    "ext/kyotocabinet-java/doc/kyotocabinet/Error.html",
+    "ext/kyotocabinet-java/doc/kyotocabinet/FileProcessor.html",
+    "ext/kyotocabinet-java/doc/kyotocabinet/MapReduce.html",
+    "ext/kyotocabinet-java/doc/kyotocabinet/Test.html",
+    "ext/kyotocabinet-java/doc/kyotocabinet/Utility.html",
+    "ext/kyotocabinet-java/doc/kyotocabinet/ValueIterator.html",
+    "ext/kyotocabinet-java/doc/kyotocabinet/Visitor.html",
+    "ext/kyotocabinet-java/doc/kyotocabinet/package-frame.html",
+    "ext/kyotocabinet-java/doc/kyotocabinet/package-summary.html",
+    "ext/kyotocabinet-java/doc/kyotocabinet/package-tree.html",
+    "ext/kyotocabinet-java/doc/overview-summary.html",
+    "ext/kyotocabinet-java/doc/overview-tree.html",
+    "ext/kyotocabinet-java/doc/package-list",
+    "ext/kyotocabinet-java/doc/resources/background.gif",
+    "ext/kyotocabinet-java/doc/resources/tab.gif",
+    "ext/kyotocabinet-java/doc/resources/titlebar.gif",
+    "ext/kyotocabinet-java/doc/resources/titlebar_end.gif",
+    "ext/kyotocabinet-java/doc/serialized-form.html",
+    "ext/kyotocabinet-java/doc/stylesheet.css",
+    "ext/kyotocabinet-java/example/KCDBEX1.java",
+    "ext/kyotocabinet-java/example/KCDBEX2.java",
+    "ext/kyotocabinet-java/example/Makefile",
+    "ext/kyotocabinet-java/kyotocabinet.cc",
+    "ext/kyotocabinet-java/kyotocabinet_Cursor.h",
+    "ext/kyotocabinet-java/kyotocabinet_DB.h",
+    "ext/kyotocabinet-java/kyotocabinet_Error.h",
+    "ext/kyotocabinet-java/kyotocabinet_Error_XBROKEN.h",
+    "ext/kyotocabinet-java/kyotocabinet_Error_XDUPREC.h",
+    "ext/kyotocabinet-java/kyotocabinet_Error_XINVALID.h",
+    "ext/kyotocabinet-java/kyotocabinet_Error_XLOGIC.h",
+    "ext/kyotocabinet-java/kyotocabinet_Error_XMISC.h",
+    "ext/kyotocabinet-java/kyotocabinet_Error_XNOIMPL.h",
+    "ext/kyotocabinet-java/kyotocabinet_Error_XNOPERM.h",
+    "ext/kyotocabinet-java/kyotocabinet_Error_XNOREC.h",
+    "ext/kyotocabinet-java/kyotocabinet_Error_XNOREPOS.h",
+    "ext/kyotocabinet-java/kyotocabinet_Error_XSUCCESS.h",
+    "ext/kyotocabinet-java/kyotocabinet_Error_XSYSTEM.h",
+    "ext/kyotocabinet-java/kyotocabinet_MapReduce.h",
+    "ext/kyotocabinet-java/kyotocabinet_Utility.h",
+    "ext/kyotocabinet-java/kyotocabinet_ValueIterator.h",
+    "ext/kyotocabinet-java/overview.html",
+    "kyotocabinet-java.gemspec",
+    "lib/kyotocabinet-java.rb",
+    "lib/kyotocabinet-java/version.rb"
+  ]
+  s.homepage = "http://github.com/csw/kyotocabinet-java"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.24"
+  s.summary = "Kyoto Cabinet Java library for JRuby"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<shoulda>, [">= 0"])
+      s.add_development_dependency(%q<rdoc>, ["~> 3.12"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.1.3"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.8.4"])
+      s.add_development_dependency(%q<simplecov>, [">= 0"])
+      s.add_development_dependency(%q<jruby-openssl>, [">= 0"])
+    else
+      s.add_dependency(%q<shoulda>, [">= 0"])
+      s.add_dependency(%q<rdoc>, ["~> 3.12"])
+      s.add_dependency(%q<bundler>, ["~> 1.1.3"])
+      s.add_dependency(%q<jeweler>, ["~> 1.8.4"])
+      s.add_dependency(%q<simplecov>, [">= 0"])
+      s.add_dependency(%q<jruby-openssl>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<shoulda>, [">= 0"])
+    s.add_dependency(%q<rdoc>, ["~> 3.12"])
+    s.add_dependency(%q<bundler>, ["~> 1.1.3"])
+    s.add_dependency(%q<jeweler>, ["~> 1.8.4"])
+    s.add_dependency(%q<simplecov>, [">= 0"])
+    s.add_dependency(%q<jruby-openssl>, [">= 0"])
+  end
+end
+