infinispan 0.11.0 → 0.13.0

package/documentation/asciidoc/topics/code_examples/ephemeral-data.js

@@ -1,52 +0,0 @@
-var infinispan = require('infinispan');
-
-var connected = infinispan.client(
-  {port: 11222, host: '127.0.0.1'}
-  {
-    // Configure client connections with authentication and encryption here.
-  }
-);
-
-connected.then(function (client) {
-
-  var clientPutExpiry = client.put('expiry', 'value', {lifespan: '1s'});
-
-  var clientGetMetaAndSize = clientPutExpiry.then(
-    function() {
-      // Compute getWithMetadata and size in parallel.
-      return Promise.all([client.getWithMetadata('expiry'), client.size()]);
-    });
-
-  var showGetMetaAndSize = clientGetMetaAndSize.then(
-    function(values) {
-      console.log('Before expiration:');
-      console.log('getWithMetadata(expiry)=' + JSON.stringify(values[0]));
-      console.log('size=' + values[1]);
-    });
-
-  var clientContainsAndSize = showGetMetaAndSize.then(
-    function() {
-      sleepFor(1100); // Sleep to force expiration.
-      return Promise.all([client.containsKey('expiry'), client.size()]);
-    });
-
-  var showContainsAndSize = clientContainsAndSize.then(
-    function(values) {
-      console.log('After expiration:');
-      console.log('containsKey(expiry)=' + values[0]);
-      console.log('size=' + values[1]);
-    });
-
-  return showContainsAndSize.finally(
-    function() { return client.disconnect(); });
-
-}).catch(function(error) {
-
-  console.log("Got error: " + error.message);
-
-});
-
-function sleepFor(sleepDuration){
-  var now = new Date().getTime();
-  while(new Date().getTime() < now + sleepDuration){ /* Do nothing. */ }
-}

package/documentation/asciidoc/topics/code_examples/hello-world.js

@@ -1,42 +0,0 @@
-var infinispan = require('infinispan');
-
-// Connect to {brandname} Server.
-// Use an existing cache named "myCache".
-var connected = infinispan.client(
-  {port: 11222, host: '127.0.0.1'},
-  {
-    cacheName: 'myCache',
-    clientIntelligence: 'BASIC',
-    authentication: {
-      enabled: true,
-      saslMechanism: 'DIGEST-MD5',
-      userName: 'username',
-      password: 'changeme'
-    }
-  }
-);
-
-connected.then(function (client) {
-
-  console.log('Connected to `myCache`');
-
-  // Add an entry to the cache.
-  var clientPut = client.put('hello', 'world');
-
-  // Retrieve the entry you added.
-  var clientGet = clientPut.then(
-      function() { return client.get('hello'); });
-
-  // Print the value of the entry.
-  var showGet = clientGet.then(
-      function(value) { console.log('get(hello)=' + value); });
-
-  // Disconnect from {brandname} Server.
-  return client.disconnect();
-
-}).catch(function(error) {
-
-  // Log any errors.
-  console.log("Got error: " + error.message);
-
-});

package/documentation/asciidoc/topics/code_examples/key-value-converter.js

@@ -1,67 +0,0 @@
-var infinispan = require('infinispan');
-
-var connected = infinispan.client(
-    {port: 11222, host: '127.0.0.1'}
-    , {
-        dataFormat : {
-            keyType: 'application/json',
-            valueType: 'application/json'
-        }
-    }
-);
-
-connected.then(function (client) {
-    // Include the remote event converter to avoid unnecessary roundtrips.
-    var opts = {
-        converterFactory : {
-            name: "key-value-with-previous-converter-factory"
-        }
-    };
-
-    var clientAddListenerCreate = client.addListener('create', logEvent("Created"), opts);
-
-    var clientAddListeners = clientAddListenerCreate.then(
-        function(listenerId) {
-            // Associate multiple callbacks with a single client-side listener.
-            // To do this, register listeners with the same listener ID.
-            var clientAddListenerModify =
-                client.addListener('modify', logEvent("Modified"), {opts, listenerId: listenerId});
-
-            var clientAddListenerRemove =
-                client.addListener('remove', logEvent("Removed"), {opts, listenerId: listenerId});
-
-            return Promise.all([clientAddListenerModify, clientAddListenerRemove]);
-        });
-
-    var clientCreate = clientAddListeners.then(
-        function() { return client.putIfAbsent('converted', 'v0'); });
-
-    var clientModify = clientCreate.then(
-        function() { return client.replace('converted', 'v1'); });
-
-    var clientRemove = clientModify.then(
-        function() { return client.remove('converted'); });
-
-    var clientRemoveListener =
-        Promise.all([clientAddListenerCreate, clientRemove]).then(
-            function(values) {
-                var listenerId = values[0];
-                return client.removeListener(listenerId);
-            });
-
-    return clientRemoveListener.finally(
-        function() { return client.disconnect(); });
-
-}).catch(function(error) {
-
-    console.log("Got error: " + error.message);
-
-});
-
-function logEvent(prefix) {
-    return function(event) {
-        console.log(prefix + " key: " + event.key);
-        console.log(prefix + " value: " + event.value);
-        console.log(prefix + " previous value: " + event.prev);
-    }
-}

package/documentation/asciidoc/topics/code_examples/logging-configuration.js

@@ -1,2 +0,0 @@
-var log4js = require('log4js');
-log4js.configure('path/to/my-log4js.json');

package/documentation/asciidoc/topics/code_examples/multiple-entries.js

@@ -1,64 +0,0 @@
-var infinispan = require('infinispan');
-
-var connected = infinispan.client(
-  {port: 11222, host: '127.0.0.1'},
-  {
-    cacheName: 'myCache',
-    authentication: {
-        enabled: true,
-        saslMechanism: 'DIGEST-MD5',
-        userName: 'username',
-        password: 'changeme'
-    }
-  }
-);
-
-connected.then(function (client) {
-  var data = [
-    {key: 'multi1', value: 'v1'},
-    {key: 'multi2', value: 'v2'},
-    {key: 'multi3', value: 'v3'}];
-
-  var clientPutAll = client.putAll(data);
-
-  var clientGetAll = clientPutAll.then(
-    function() { return client.getAll(['multi2', 'multi3']); });
-
-  var showGetAll = clientGetAll.then(
-    function(entries) {
-      console.log('getAll(multi2, multi3)=%s', JSON.stringify(entries));
-    }
-  );
-
-  var clientIterator = showGetAll.then(
-    function() { return client.iterator(1); });
-
-  var showIterated = clientIterator.then(
-    function(it) {
-      function loop(promise, fn) {
-        // Simple recursive loop over the iterator's next() call.
-        return promise.then(fn).then(function (entry) {
-          return entry.done
-            ? it.close().then(function () { return entry.value; })
-            : loop(it.next(), fn);
-        });
-      }
-
-      return loop(it.next(), function (entry) {
-        console.log('iterator.next()=' + JSON.stringify(entry));
-        return entry;
-      });
-    }
-  );
-
-  var clientClear = showIterated.then(
-    function() { return client.clear(); });
-
-  return clientClear.finally(
-    function() { return client.disconnect(); });
-
-}).catch(function(error) {
-
-  console.log("Got error: " + error.message);
-
-});

package/documentation/asciidoc/topics/code_examples/queries.js

@@ -1,92 +0,0 @@
-const infinispan = require('infinispan');
-const protobuf = require('protobufjs');
-// This example uses async/await paradigma
-(async function () {
-  // User data protobuf definition
-  const cacheValueProtoDef = `package awesomepackage;
-  /**
-   * @TypeId(1000044)
-   */
-  message AwesomeUser {
-      required string name = 1;
-      required int64 age = 2;
-      required bool isVerified =3;
-  }`
-  try {
-    // Creating clients for two caches:
-    // - ___protobuf_metadata for registering .proto file
-    // - queryCache for user data
-    const connectProp = { port: 11222, host: '127.0.0.1' };
-    const commonOpts = {
-      version: '3.0',
-      authentication: {
-        enabled: true,
-        saslMechanism: 'DIGEST-MD5',
-        userName: 'admin',
-        password: 'pass'
-      }
-    };
-    const protoMetaClientOps = {
-      cacheName: '___protobuf_metadata',
-      dataFormat: { keyType: "text/plain", valueType: "text/plain" }
-    }
-    const clientOps = {
-      dataFormat: { keyType: "text/plain", valueType: "application/x-protostream" },
-      cacheName: 'queryCache'
-    }
-    var protoMetaClient = await infinispan.client(connectProp, Object.assign(commonOpts, protoMetaClientOps));
-    var client = await infinispan.client(connectProp, Object.assign(commonOpts, clientOps));
-
-    // Registering protobuf definition on server
-    await protoMetaClient.put("awesomepackage/AwesomeUser.proto", cacheValueProtoDef);
-
-    // Registering protobuf definition on protobufjs
-    const root = protobuf.parse(cacheValueProtoDef).root;
-    const AwesomeUser = root.lookupType(".awesomepackage.AwesomeUser");
-    client.registerProtostreamRoot(root);
-    client.registerProtostreamType(".awesomepackage.AwesomeUser", 1000044);
-
-    // Cleanup and populating the cache
-    await client.clear();
-    for (let i = 0; i < 10; i++) {
-      const payload = { name: "AwesomeName" + i, age: i, isVerified: (Math.random() < 0.5) };
-      const message = AwesomeUser.create(payload);
-      console.log("Creating entry:", message);
-      await client.put(i.toString(), message)
-    }
-    // Run the query
-    const queryStr = `select u.name,u.age from awesomepackage.AwesomeUser u where u.age<20 order by u.name asc`;
-    console.log("Running query:", queryStr);
-    const query = await client.query({ queryString: queryStr });
-    console.log("Query result:");
-    console.log(query);
-  } catch (err) {
-    handleError(err);
-  } finally {
-    if (client) {
-      await client.disconnect();
-    }
-    if (protoMetaClient) {
-      await protoMetaClient.disconnect();
-    }
-  }
-})();
-
-function handleError(err) {
-  if (err.message.includes("'queryCache' not found")) {
-    console.log('*** ERROR ***');
-    console.log(`*** This example needs a cache 'queryCache' with the following config:
-    {
-      "local-cache": {
-        "statistics": true,
-        "encoding": {
-        "key": {
-          "media-type": "text/plain"
-        },
-        "value": {
-          "media-type": "application/x-protostream"
-}}}}`)
-  } else {
-    console.log(err);
-  }
-}

package/documentation/asciidoc/topics/code_examples/register-event-listener.js

@@ -1,64 +0,0 @@
-var infinispan = require('infinispan');
-
-var connected = infinispan.client(
-  {port: 11222, host: '127.0.0.1'}
-  {
-    // Configure client connections with authentication and encryption here.
-  }
-);
-
-connected.then(function (client) {
-
-    var clientAddListenerCreate = client.addListener('create', onCreate);
-
-    var clientAddListeners = clientAddListenerCreate.then(
-        function(listenerId) {
-            // Associate multiple callbacks with a single client-side listener.
-            // To do this, register listeners with the same listener ID.
-            var clientAddListenerModify =
-                client.addListener('modify', onModify, {listenerId: listenerId});
-
-            var clientAddListenerRemove =
-                client.addListener('remove', onRemove, {listenerId: listenerId});
-
-            return Promise.all([clientAddListenerModify, clientAddListenerRemove]);
-        });
-
-    var clientCreate = clientAddListeners.then(
-        function() { return client.putIfAbsent('eventful', 'v0'); });
-
-    var clientModify = clientCreate.then(
-        function() { return client.replace('eventful', 'v1'); });
-
-    var clientRemove = clientModify.then(
-        function() { return client.remove('eventful'); });
-
-    var clientRemoveListener =
-        Promise.all([clientAddListenerCreate, clientRemove]).then(
-            function(values) {
-                var listenerId = values[0];
-                return client.removeListener(listenerId);
-            });
-
-    return clientRemoveListener.finally(
-        function() { return client.disconnect(); });
-
-}).catch(function(error) {
-
-    console.log("Got error: " + error.message);
-
-});
-
-function onCreate(key, version) {
-    console.log('[Event] Created key: ' + key +
-        ' with version: ' + JSON.stringify(version));
-}
-
-function onModify(key, version) {
-    console.log('[Event] Modified key: ' + key +
-        ', version after update: ' + JSON.stringify(version));
-}
-
-function onRemove(key) {
-    console.log('[Event] Removed key: ' + key);
-}

package/documentation/asciidoc/topics/code_examples/sample-script-execute.js

@@ -1,33 +0,0 @@
-var infinispan = require('infinispan');
-var readFile = Promise.denodeify(require('fs').readFile);
-
-var connected = infinispan.client(
-  {port: 11222, host: '127.0.0.1'}
-  {
-    // Configure client connections with authentication and encryption here.
-  }
-);
-
-connected.then(function (client) {
-
-  var addScriptFile = readFile('sample-script.js').then(
-    function(file) {
-      return client.addScript('sample-script', file.toString());
-    });
-
-  var clientExecute = addScriptFile.then(
-    function() {
-      return client.execute('sample-script', {k: 'exec-key', v: 'exec-value'});
-    });
-
-  var showExecute = clientExecute.then(
-    function(ret) { console.log('Script execution returned: ' + ret); });
-
-  return showExecute.finally(
-    function() { return client.disconnect(); });
-
-}).catch(function(error) {
-
-  console.log("Got error: " + error.message);
-
-});

package/documentation/asciidoc/topics/code_examples/sample-script.js

@@ -1,3 +0,0 @@
-// mode=local,language=javascript,parameters=[k, v],datatype='text/plain; charset=utf-8'
-cache.put(k, v);
-cache.get(k);

package/documentation/asciidoc/topics/code_examples/single-entries.js

@@ -1,49 +0,0 @@
-var infinispan = require('infinispan');
-
-var connected = infinispan.client(
-  {port: 11222, host: '127.0.0.1'},
-  {
-    cacheName: 'myCache',
-    authentication: {
-        enabled: true,
-        saslMechanism: 'DIGEST-MD5',
-        userName: 'username',
-        password: 'changeme'
-    }
-  }
-);
-
-connected.then(function (client) {
-
-  var clientPut = client.put('key', 'value');
-
-  var clientGet = clientPut.then(
-      function() { return client.get('key'); });
-
-  var showGet = clientGet.then(
-      function(value) { console.log('get(key)=' + value); });
-
-  var clientRemove = showGet.then(
-      function() { return client.remove('key'); });
-
-  var showRemove = clientRemove.then(
-      function(success) { console.log('remove(key)=' + success); });
-
-  var clientStats = showRemove.then(
-    function() { return client.stats(); });
-
-  var showStats = clientStats.then(
-    function(stats) {
-      console.log('Number of stores: ' + stats.stores);
-      console.log('Number of cache hits: ' + stats.hits);
-      console.log('All statistics: ' + JSON.stringify(stats, null, " "));
-    });
-
-  return showStats.finally(
-      function() { return client.disconnect(); });
-
-}).catch(function(error) {
-
-  console.log("Got error: " + error.message);
-
-});

package/documentation/asciidoc/topics/config_examples/logging.json

@@ -1,14 +0,0 @@
-{
-  "appenders": {
-    "test": {
-      "type": "fileSync",
-      "filename": "my-log-file.log"
-    }
-  },
-  "categories": {
-    "default": {
-      "appenders": ["test"],
-      "level": "trace"
-    }
-  }
-}

package/documentation/asciidoc/topics/proc_configuring_authentication.adoc

@@ -1,16 +0,0 @@
-[id='configuring-authentication_{context}']
-= Configuring authentication
-
-{brandname} Server uses different SASL mechanisms to authenticate {hr_js} client connections.
-
-.Prerequisites
-
-* Create {brandname} users.
-* Add the SASL authentication mechanism to the Hot Rod connector in your {brandname} Server configuration.
-
-.Procedure
-
-. Open the {hr_js} client configuration for editing.
-. Add an `authentication` method that sets the `enabled: true` flag.
-. Specify a value for the `saslMechanism` parameter that matches the SASL authentication mechanism for the Hot Rod connector.
-. Configure any parameters specific to the SASL authentication mechanism as appropriate.

package/documentation/asciidoc/topics/proc_configuring_connections.adoc

@@ -1,25 +0,0 @@
-[id='configuring-connections_{context}']
-= Configuring {brandname} connections
-Configure {hr_js} clients to connect to {brandname} Server.
-
-If you add multiple server addresses to the configuration, the {hr_js} client loops through them until it finds a node to which it can connect.
-
-However, you only need to add one {brandname} Server address for the client to receive the entire cluster topology.
-If the {hr_js} client connects to a single server instance that is a member of a cluster, the client gets the address information for all nodes.
-
-Because {hr_js} clients are topology aware, if a connection to one {brandname} Server breaks, the client retries any incomplete operations on other nodes in the cluster.
-Likewise, if client listener that is registered on one {brandname} Server fails or leaves the cluster, the client transparently migrates the listener registration to another node in the cluster so that it can continue receiving events.
-
-.Prerequisites
-
-* Install the {hr_js} client.
-* Have at least one running {brandname} Server instance.
-
-.Procedure
-
-* Specify hostnames and ports for {brandname} Server in the client configuration.
-+
-[source,javascript,options="nowrap",subs=attributes+]
-----
-include::code_examples/connection-multiple-servers.js[]
-----

package/documentation/asciidoc/topics/proc_configuring_connections_xsite.adoc

@@ -1,18 +0,0 @@
-[id='configuring-connections-cross-site_{context}']
-= Defining {brandname} clusters in client configuration
-When you set up {brandname} clusters in separate data centers to perform cross-site replication, you can add connection details for the different sites to the client configuration.
-
-.Prerequisites
-
-* Install the {hr_js} client.
-* Configure {brandname} for cross-site replication.
-
-.Procedure
-
-. Add a `clusters` definition to your configuration.
-. Add `name` and `servers` definitions for each {brandname} cluster.
-+
-[source,javascript,options="nowrap",subs=attributes+]
-----
-include::code_examples/connection-xsite.js[]
-----

package/documentation/asciidoc/topics/proc_configuring_data_formats.adoc

@@ -1,30 +0,0 @@
-[id='configuring-data-formats_{context}']
-= Configuring data formats
-{hr_js} clients can handle keys and values as native JavaScript Object Notation (JSON) objects or as String objects.
-By default, clients handle entries as String objects.
-If you want to transmit data to {brandname} Server in JSON format, then you must configure the {hr_js} client.
-
-//Community content
-ifdef::community[]
-Starting at version 0.6, {hr_js} clients support native JSON objects as keys and values.
-Earlier versions of the client support keys and values as String only.
-endif::community[]
-
-[NOTE]
-====
-Script operations support String key/value pairs and String parameters only.
-====
-
-.Procedure
-
-. Add a `dataFormat` configuration to your client.
-. Set the data format for keys and values as appropriate with the `keyType` and `valueType` parameters.
-
-Keys and values can have different media types.
-For JSON objects, specify `application/json`.
-For String objects, specify `text/plain` or omit the parameter to use the default.
-
-[source,javascript,options="nowrap",subs=attributes+]
-----
-include::code_examples/data-types.js[]
-----

package/documentation/asciidoc/topics/proc_configuring_encryption.adoc

@@ -1,15 +0,0 @@
-[id='configuring-encryption_{context}']
-= Configuring encryption
-
-{brandname} Server can enforce different types of SSL/TLS encryption to secure {hr_js} client connections.
-
-.Prerequisites
-
-* Create a trust store that {hr_js} clients can use to verify {brandname} Server identities.
-* If you configure {brandname} Server to validate or authenticate client certificates, create a keystore as appropriate.
-
-.Procedure
-
-. Open the {hr_js} client configuration for editing.
-. Add an `ssl` method that sets the `enabled: true` flag.
-. Provide any other configuration specific to the type of encryption you use.

package/documentation/asciidoc/topics/proc_configuring_logging.adoc

@@ -1,28 +0,0 @@
-[id='configuring-logging_{context}']
-= Configuring logging
-
-{hr_js} clients use `log4js`, which you can modify by providing configuration in JSON format.
-
-.Procedure
-
-. Create a logging configuration in JSON format.
-+
-For example, the following JSON configures an appender that writes TRACE level log events to file:
-+
-[source,json,options="nowrap",subs=attributes+]
-----
-include::config_examples/logging.json[]
-----
-+
-. Add the `var log4js = require('log4js')` statement to the {hr_js} client configuration.
-. Specify the path to your JSON logging configuration with the `log4js.configure()` method, as in the following example:
-+
-[source,javascript,options="nowrap",subs=attributes+]
-----
-include::code_examples/logging-configuration.js[]
-----
-
-[role="_additional-resources"]
-.Additional resources
-* link:https://www.npmjs.com/package/log4js[log4js]
-* link:https://github.com/log4js-node/log4js-node/tree/master/examples[log4js-node examples]