com.aliyun.tair.tairdoc.TairDoc Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of alibabacloud-tairjedis-sdk Show documentation
Show all versions of alibabacloud-tairjedis-sdk Show documentation
Aliyun Tair Redis client for Java
Copyright (C) Alibaba Cloud Computing
All rights reserved.
版权所有 （C）阿里云计算有限公司
http://www.aliyun.com
package com.aliyun.tair.tairdoc;
import java.util.List;
import com.aliyun.tair.ModuleCommand;
import com.aliyun.tair.tairdoc.params.JsonsetParams;
import com.aliyun.tair.tairdoc.params.JsongetParams;
import redis.clients.jedis.BuilderFactory;
import redis.clients.jedis.Jedis;
import redis.clients.jedis.JedisPool;
import redis.clients.jedis.util.SafeEncoder;
import static redis.clients.jedis.Protocol.toByteArray;
public class TairDoc {
private Jedis jedis;
private JedisPool jedisPool;
public TairDoc(Jedis jedis) {
this.jedis = jedis;
}
public TairDoc(JedisPool jedisPool) {
this.jedisPool = jedisPool;
}
private Jedis getJedis() {
if (jedisPool != null) {
return jedisPool.getResource();
}
return jedis;
}
private void releaseJedis(Jedis jedis) {
if (jedisPool != null) {
jedis.close();
}
}
/**
* JSON.SET [NX|XX]
* Sets the JSON value at `path` in `key`
*
* For new Redis keys the `path` must be the root. For existing keys, when the entire `path` exists,
* the value that it contains is replaced with the `json` value.
*
* `NX` - only set the key if it does not already exists
* `XX` - only set the key if it already exists
*
* Reply: Simple String `OK` if executed correctly, or Null if the specified `NX` or `XX`
* conditions were not met.
*/
public String jsonset(final String key, final String path, final String json) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONSET, key, path, json);
return BuilderFactory.STRING.build(obj);
} finally {
releaseJedis(jedis);
}
}
public String jsonset(final String key, final String path, final String json, final JsonsetParams params) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONSET,
params.getByteParams(SafeEncoder.encode(key), SafeEncoder.encode(path), SafeEncoder.encode(json)));
return BuilderFactory.STRING.build(obj);
} finally {
releaseJedis(jedis);
}
}
public String jsonset(final byte[] key, final byte[] path, final byte[] json) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONSET, key, path, json);
return BuilderFactory.STRING.build(obj);
} finally {
releaseJedis(jedis);
}
}
public String jsonset(final byte[] key, final byte[] path, final byte[] json, final JsonsetParams params) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONSET, params.getByteParams(key, path, json));
return BuilderFactory.STRING.build(obj);
} finally {
releaseJedis(jedis);
}
}
/**
* JSON.GET [PATH] [FORMAT ] [ROOTNAME ] [ARRNAME ]
* Return the value at `path` in JSON serialized form.
*
* `PATH` the path of json
* `FORMAT` doc format，XML or YAML
* `ROOTNAME` XML root name
* `ARRNAME` XML array name
*
* Reply: Bulk String, specifically the JSON serialization or XML/YAML.
*/
public String jsonget(final String key) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONGET, key);
return BuilderFactory.STRING.build(obj);
} finally {
releaseJedis(jedis);
}
}
public String jsonget(final String key, final String path) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONGET, key, path);
return BuilderFactory.STRING.build(obj);
} finally {
releaseJedis(jedis);
}
}
public String jsonget(final String key, final String path, final JsongetParams params) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONGET,
params.getByteParams(SafeEncoder.encode(key), SafeEncoder.encode(path)));
return BuilderFactory.STRING.build(obj);
} finally {
releaseJedis(jedis);
}
}
public byte[] jsonget(final byte[] key) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONGET, key);
return BuilderFactory.BYTE_ARRAY.build(obj);
} finally {
releaseJedis(jedis);
}
}
public byte[] jsonget(final byte[] key, final byte[] path) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONGET, key, path);
return BuilderFactory.BYTE_ARRAY.build(obj);
} finally {
releaseJedis(jedis);
}
}
public byte[] jsonget(final byte[] key, final byte[] path, final JsongetParams params) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONGET,
params.getByteParams(key, path));
return BuilderFactory.BYTE_ARRAY.build(obj);
} finally {
releaseJedis(jedis);
}
}
/**
* JSON.MGET [ ...]
* Returns the values at `path` from multiple `key`s. Non-existing keys and non-existing paths
* are reported as null.
* Reply: Array of Bulk Strings, specifically the JSON serialization of
* the value at each key's path.
*/
public List jsonmget(String... args) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONMGET, args);
return BuilderFactory.STRING_LIST.build(obj);
} finally {
releaseJedis(jedis);
}
}
public List jsonmget(byte[]... args) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONMGET, args);
return BuilderFactory.BYTE_ARRAY_LIST.build(obj);
} finally {
releaseJedis(jedis);
}
}
/**
* JSON.DEL [path]
* Delete a value.
*
* `path` defaults to root if not provided. Non-existing keys as well as non-existing paths are
* ignored. Deleting an object's root is equivalent to deleting the key from Redis.
*
* Reply: Integer, specifically the number of paths deleted (0 or 1).
*/
public Long jsondel(final String key) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONDEL, key);
return BuilderFactory.LONG.build(obj);
} finally {
releaseJedis(jedis);
}
}
public Long jsondel(final String key, final String path) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONDEL, key, path);
return BuilderFactory.LONG.build(obj);
} finally {
releaseJedis(jedis);
}
}
public Long jsondel(final byte[] key) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONDEL, key);
return BuilderFactory.LONG.build(obj);
} finally {
releaseJedis(jedis);
}
}
public Long jsondel(final byte[] key, final byte[] path) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONDEL, key, path);
return BuilderFactory.LONG.build(obj);
} finally {
releaseJedis(jedis);
}
}
/**
* JSON.TYPE [path]
* Reports the type of JSON value at `path`.
* `path` defaults to root if not provided. If the `key` or `path` do not exist, null is returned.
* Reply: Simple string, specifically the type.
*/
public String jsontype(final String key) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONTYPE, key);
return BuilderFactory.STRING.build(obj);
} finally {
releaseJedis(jedis);
}
}
public String jsontype(final String key, final String path) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONTYPE, key, path);
return BuilderFactory.STRING.build(obj);
} finally {
releaseJedis(jedis);
}
}
public byte[] jsontype(final byte[] key) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONTYPE, key);
return BuilderFactory.BYTE_ARRAY.build(obj);
} finally {
releaseJedis(jedis);
}
}
public byte[] jsontype(final byte[] key, final byte[] path) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONTYPE, key, path);
return BuilderFactory.BYTE_ARRAY.build(obj);
} finally {
releaseJedis(jedis);
}
}
/**
* JSON.NUMICRBY [path]
* long value range: [-2^53, 2^53] [-9007199254740992, 9007199254740992]
* double value range: [Double.MIN_VALUE, Double.MAX_VALUE]
*
* Increments the value stored under `path` by `value`.
* `path` must exist path and must be a number value.
* Reply: int number, specifically the resulting.
*/
public Double jsonnumincrBy(final String key, final Double value) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONNUMINCRBY, SafeEncoder.encode(key), toByteArray(value));
return BuilderFactory.DOUBLE.build(obj);
} finally {
releaseJedis(jedis);
}
}
public Double jsonnumincrBy(final String key, final String path, final Double value) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONNUMINCRBY, SafeEncoder.encode(key),
SafeEncoder.encode(path), toByteArray(value));
return BuilderFactory.DOUBLE.build(obj);
} finally {
releaseJedis(jedis);
}
}
public Double jsonnumincrBy(final byte[] key, final Double value) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONNUMINCRBY, key, toByteArray(value));
return BuilderFactory.DOUBLE.build(obj);
} finally {
releaseJedis(jedis);
}
}
public Double jsonnumincrBy(final byte[] key, final byte[] path, final Double value) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONNUMINCRBY, key, path, toByteArray(value));
return BuilderFactory.DOUBLE.build(obj);
} finally {
releaseJedis(jedis);
}
}
/**
* JSON.STRAPPEND [path]
* Append the `json-string` value(s) the string at `path`.
* `path` defaults to root if not provided.
* Reply: Integer, -1 : key not exists, other: specifically the string's new length.
*/
public Long jsonstrAppend(final String key, final String json) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONSTRAPPEND, key, json);
return BuilderFactory.LONG.build(obj);
} finally {
releaseJedis(jedis);
}
}
public Long jsonstrAppend(final String key, final String path, final String json) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONSTRAPPEND, key, path, json);
return BuilderFactory.LONG.build(obj);
} finally {
releaseJedis(jedis);
}
}
public Long jsonstrAppend(final byte[] key, final byte[] json) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONSTRAPPEND, key, json);
return BuilderFactory.LONG.build(obj);
} finally {
releaseJedis(jedis);
}
}
public Long jsonstrAppend(final byte[] key, final byte[] path, final byte[] json) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONSTRAPPEND, key, path, json);
return BuilderFactory.LONG.build(obj);
} finally {
releaseJedis(jedis);
}
}
/**
* JSON.STRLEN [path]
* Report the length of the JSON value at `path` in `key`.
*
* `path` defaults to root if not provided. If the `key` or `path` do not exist, null is returned.
*
* Reply: Integer, specifically the length of the value.
*/
public Long jsonstrlen(final String key) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONSTRLEN, key);
return BuilderFactory.LONG.build(obj);
} finally {
releaseJedis(jedis);
}
}
public Long jsonstrlen(final String key, final String path) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONSTRLEN, key, path);
return BuilderFactory.LONG.build(obj);
} finally {
releaseJedis(jedis);
}
}
public Long jsonstrlen(final byte[] key) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONSTRLEN, key);
return BuilderFactory.LONG.build(obj);
} finally {
releaseJedis(jedis);
}
}
public Long jsonstrlen(final byte[] key, final byte[] path) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONSTRLEN, key, path);
return BuilderFactory.LONG.build(obj);
} finally {
releaseJedis(jedis);
}
}
/**
* JSON.ARRAPPEND [ ...]
* Append the `json` value(s) into the array at `path` after the last element in it.
* Reply: Integer, specifically the array's new size
*/
public Long jsonarrAppend(String... args) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONARRAPPEND, args);
return BuilderFactory.LONG.build(obj);
} finally {
releaseJedis(jedis);
}
}
public Long jsonarrAppend(byte[]... args) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONARRAPPEND, args);
return BuilderFactory.LONG.build(obj);
} finally {
releaseJedis(jedis);
}
}
/**
* JSON.ARRPOP [index]
* Remove and return element from the index in the array.
*
* `path` the array pointer. `index` is the position in the array to start
* popping from (defaults to -1, meaning the last element). Out of range indices are rounded to
* their respective array ends. Popping an empty array yields null.
*
* Reply: Bulk String, specifically the popped JSON value.
*/
public String jsonarrPop(final String key, final String path) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONARRPOP, key, path);
return BuilderFactory.STRING.build(obj);
} finally {
releaseJedis(jedis);
}
}
public String jsonarrPop(final String key, final String path, int index) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONARRPOP, key, path, String.valueOf(index));
return BuilderFactory.STRING.build(obj);
} finally {
releaseJedis(jedis);
}
}
public byte[] jsonarrPop(final byte[] key, final byte[] path) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONARRPOP, key, path);
return BuilderFactory.BYTE_ARRAY.build(obj);
} finally {
releaseJedis(jedis);
}
}
public byte[] jsonarrPop(final byte[] key, final byte[] path, int index) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONARRPOP, key, path, toByteArray(index));
return BuilderFactory.BYTE_ARRAY.build(obj);
} finally {
releaseJedis(jedis);
}
}
/**
* JSON.ARRINSERT [ ...]
* Insert the `json` value(s) into the array at `path` before the `index` (shifts to the right).
*
* The index must be in the array's range. Inserting at `index` 0 prepends to the array.
* Negative index values are interpreted as starting from the end.
*
* Reply: Integer, specifically the array's new size
*/
public Long jsonarrInsert(String... args) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONARRINSERT, args);
return BuilderFactory.LONG.build(obj);
} finally {
releaseJedis(jedis);
}
}
public Long jsonarrInsert(byte[]... args) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONARRINSERT, args);
return BuilderFactory.LONG.build(obj);
} finally {
releaseJedis(jedis);
}
}
/**
* JSON.ARRLEN [path]
* Report the length of the array at `path` in `key`.
*
* `path` defaults to root if not provided. If the `key` or `path` do not exist, null is returned.
*
* Reply: Integer, specifically the length of the array.
*/
public Long jsonArrLen(final String key) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONARRLEN, key);
return BuilderFactory.LONG.build(obj);
} finally {
releaseJedis(jedis);
}
}
public Long jsonArrLen(final String key, final String path) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONARRLEN, key, path);
return BuilderFactory.LONG.build(obj);
} finally {
releaseJedis(jedis);
}
}
public Long jsonArrLen(final byte[] key) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONARRLEN, key);
return BuilderFactory.LONG.build(obj);
} finally {
releaseJedis(jedis);
}
}
public Long jsonArrLen(final byte[] key, final byte[] path) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONARRLEN, key, path);
return BuilderFactory.LONG.build(obj);
} finally {
releaseJedis(jedis);
}
}
/**
* JSON.ARRTRIM
* Trim an array so that it contains only the specified inclusive range of elements.
*
* Reply: Integer, specifically the array's new size.
*/
public Long jsonarrTrim(final String key, final String path, final int start, final int stop) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONARRTRIM, key, path, String.valueOf(start),
String.valueOf(stop));
return BuilderFactory.LONG.build(obj);
} finally {
releaseJedis(jedis);
}
}
public Long jsonarrTrim(final byte[] key, final byte[] path, final int start, final int stop) {
Jedis jedis = getJedis();
try {
Object obj = jedis.sendCommand(ModuleCommand.JSONARRTRIM, key, path, toByteArray(start),
toByteArray(stop));
return BuilderFactory.LONG.build(obj);
} finally {
releaseJedis(jedis);
}
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy