Package io.ably.lib.types

Class ChannelOptions

java.lang.Object

io.ably.lib.types.ChannelOptions

public class ChannelOptions
extends java.lang.Object

Passes additional properties to a Channel or Channel object, such as encryption, ChannelMode and channel parameters.

Field Summary

Fields

Modifier and Type	Field	Description
java.lang.Object	cipherParams	Requests encryption for this channel when not null, and specifies encryption-related parameters (such as algorithm, chaining mode, key length and key).
boolean	encrypted	Whether or not this ChannelOptions is encrypted.
ChannelMode[]	modes	An array of ChannelMode objects.
java.util.Map<java.lang.String,java.lang.String>	params	Channel Parameters that configure the behavior of the channel.

Constructor Summary

Constructors

Constructor	Description
ChannelOptions()

Method Summary

Modifier and Type	Method	Description
static ChannelOptions	fromCipherKey(byte[] key)	Deprecated.
static ChannelOptions	fromCipherKey(java.lang.String base64Key)	Deprecated.
Crypto.CipherParams	getCipherParamsOrDefault()	Internal; returns cipher params or generate default
int	getModeFlags()
boolean	hasModes()
boolean	hasParams()
static ChannelOptions	withCipherKey(byte[] key)	Constructor withCipherKey, that takes a key only.
static ChannelOptions	withCipherKey(java.lang.String base64Key)	Constructor withCipherKey, that takes a key only.

Methods inherited from class java.lang.Object

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

Field Detail

params

public java.util.Map<java.lang.String,java.lang.String> params

Channel Parameters that configure the behavior of the channel.

Spec: TB2c

modes

public ChannelMode[] modes

An array of ChannelMode objects.

Spec: TB2d

cipherParams

public java.lang.Object cipherParams

Requests encryption for this channel when not null, and specifies encryption-related parameters (such as algorithm, chaining mode, key length and key). See an example.

Spec: RSL5a, TB2b

encrypted

public boolean encrypted

Whether or not this ChannelOptions is encrypted.

Constructor Detail

ChannelOptions

public ChannelOptions()

Method Detail

hasModes

public boolean hasModes()

hasParams

public boolean hasParams()

getModeFlags

public int getModeFlags()

fromCipherKey

@Deprecated
public static ChannelOptions fromCipherKey(byte[] key)
                                    throws AblyException

Deprecated.

Deprecated. Use withCipherKey(byte[]) instead.

Create ChannelOptions from the given cipher key.

Parameters:

key - Byte array cipher key.

Returns:

Created ChannelOptions.

Throws:

AblyException - If something goes wrong.

fromCipherKey

@Deprecated
public static ChannelOptions fromCipherKey(java.lang.String base64Key)
                                    throws AblyException

Deprecated.

Deprecated. Use withCipherKey(String) instead.

Create ChannelOptions from the given cipher key.

Parameters:

base64Key - The cipher key as a base64-encoded String,

Returns:

Created ChannelOptions.

Throws:

AblyException - If something goes wrong.

withCipherKey

public static ChannelOptions withCipherKey(byte[] key)
                                    throws AblyException

Constructor withCipherKey, that takes a key only.

Spec: TB3

Parameters:

key - A private key used to encrypt and decrypt payloads.

Returns:

A ChannelOptions object.

Throws:

AblyException - If something goes wrong.

withCipherKey

public static ChannelOptions withCipherKey(java.lang.String base64Key)
                                    throws AblyException

Constructor withCipherKey, that takes a key only.

Spec: TB3

Parameters:

base64Key - A private key used to encrypt and decrypt payloads.

Returns:

A ChannelOptions object.

Throws:

AblyException - If something goes wrong.

getCipherParamsOrDefault

public Crypto.CipherParams getCipherParamsOrDefault()
                                             throws AblyException

Internal; returns cipher params or generate default

Throws:

AblyException