io.permazen.cli.cmd

Class AbstractKVCommand

java.lang.Object

io.permazen.cli.cmd.AbstractCommand

io.permazen.cli.cmd.AbstractKVCommand

All Implemented Interfaces:

Command, Parser<CliSession.Action>

Direct Known Subclasses:

DecodeKeyCommand, KVGetCommand, KVLoadCommand, KVPutCommand, KVRemoveCommand

public abstract class AbstractKVCommand
extends AbstractCommand

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AbstractKVCommand.BytesParser Parses a byte[] array as hexadecimal or doubly-quoted "C" style string.

Field Summary

Fields

Modifier and Type	Field and Description
static Pattern	CSTRING_PATTERN Matches the doubly-quoted C strings returnd by toCString().
static Pattern	HEXBYTES_PATTERN Matches hexadecimal byte strings.

Fields inherited from class io.permazen.cli.cmd.AbstractCommand

log, name, paramParser

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractKVCommand(String spec)

Method Summary

Modifier and Type	Method and Description
static byte[]	fromCString(String string) Parse a byte[] array encoded as a double-quoted C-string representation by toCString().
protected Parser<?>	getParser(String typeName) Convert parameter spec type name into a Parser.
static String	toCString(byte[] data) Convert a byte[] array into a double-quoted C-string representation, surrounded by double quotes, with non-ASCII bytes, double-quotes, and backslashes escaped with a backslash.

Methods inherited from class io.permazen.cli.cmd.AbstractCommand

getAction, getExprParam, getExprParam, getHelpDetail, getHelpSummary, getName, getSessionModes, getUsage, parse

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface io.permazen.parse.Parser

applyIdentifierScope

Field Detail

CSTRING_PATTERN

public static final Pattern CSTRING_PATTERN

Matches the doubly-quoted C strings returnd by toCString().

HEXBYTES_PATTERN

public static final Pattern HEXBYTES_PATTERN

Matches hexadecimal byte strings.

Constructor Detail

AbstractKVCommand

protected AbstractKVCommand(String spec)

Method Detail

getParser

protected Parser<?> getParser(String typeName)

Description copied from class: AbstractCommand

Convert parameter spec type name into a Parser. Used for custom type names not supported by ParamParser.

The implementation in AbstractCommand supports all FieldTypes registered with the database, plus:

• type for an object type name (returns Integer)
• objid for an object ID of the form 64e8f29755302fe1 (returns ObjId)
• expr for an arbitrary Java expression

Overrides:

getParser in class AbstractCommand

Parameters:

typeName - parameter type name

Returns:

parser for parameters of the specified type

toCString

public static String toCString(byte[] data)

Convert a byte[] array into a double-quoted C-string representation, surrounded by double quotes, with non-ASCII bytes, double-quotes, and backslashes escaped with a backslash.

Supported escapes are \\, \", \b, \f, \t, \n, \r, and \xNN.

Parameters:

data - byte array

Returns:

C string representation

fromCString

public static byte[] fromCString(String string)

Parse a byte[] array encoded as a double-quoted C-string representation by toCString().

Parameters:

string - C string

Returns:

byte array

Throws:

IllegalArgumentException - if string is malformed