Class Encoding

• TopLevel.Object
  • dw.crypto.Encoding

Utility class which handles several common character encodings.

Constructor Summary 

This class does not have a constructor, so you cannot create it directly.

Method Summary 

Method	Description
static fromBase64(String)	Decode the given string which represents a sequence of characters encoded in base-64 to a byte array.
static fromHex(String)	Converts a String representing hexadecimal values into an array of bytes of those same values.
static fromURI(String)	Decodes a URL safe string into its original form.
static fromURI(String, String)	Decodes a URL safe string into its original form using the specified encoding.
static toBase64(Bytes)	Convert the given byte array to a string encoded in base-64.
static toBase64URL(Bytes)	Convert the given byte array to a string encoded in base-64 for URLs.
static toHex(Bytes)	Converts an array of bytes into a string representing the hexadecimal values of each byte in order.
static toURI(String)	Encodes a string into its URL safe form according to the “application/x-www-form-urlencoded” encoding scheme using the default encoding.
static toURI(String, String)	Encodes a string into its URL safe form according to the “application/x-www-form-urlencoded” encoding scheme using the specified encoding.

Methods inherited from class Object 

assign, create, create, defineProperties, defineProperty, entries, freeze, fromEntries, getOwnPropertyDescriptor, getOwnPropertyNames, getOwnPropertySymbols, getPrototypeOf, hasOwnProperty, is, isExtensible, isFrozen, isPrototypeOf, isSealed, keys, preventExtensions, propertyIsEnumerable, seal, setPrototypeOf, toLocaleString, toString, valueOf, values

Method Details 

fromBase64(String) 

static fromBase64(string: String): Bytes

Decode the given string which represents a sequence of characters encoded in base-64 to a byte array. This operation supports both the base-64 and base-64 for URL formats. Characters not in the base-64 alphabet are ignored. An exception is thrown if a null value is passed.

Note: This decoding operation is limited to the maximum number of bytes that a Bytes object can hold. See Bytes.

Parameters:

• string - A string consisting of characters in base-64 alphabet to decode.

Returns:

• The decoded array of bytes.

---

fromHex(String) 

static fromHex(string: String): Bytes

Converts a String representing hexadecimal values into an array of bytes of those same values. The returned byte array will be half the length of the passed, as it takes two characters to represent any given byte. An exception is thrown if the passed string has an odd number of character or if any characters in the string are not valid hexadecimal characters. An exception is thrown if a null value is passed.

Note: This decoding operation is limited to the maximum number of bytes that a Bytes object can hold. See Bytes.

Parameters:

• string - A string containing only hex characters to decode.

Returns:

• The decoded array of bytes.

---

fromURI(String) 

static fromURI(string: String): String

Decodes a URL safe string into its original form. Escaped characters are converted back to their original representation. An exception is thrown if URL decoding is unsuccessful or if null is passed.

Parameters:

• string - The string to decode.

Returns:

• The decoded string.

---

fromURI(String, String) 

static fromURI(string: String, encoding: String): String

Decodes a URL safe string into its original form using the specified encoding. Escaped characters are converted back to their original representation. An exception is thrown if URL decoding is unsuccessful or if the specified encoding is unsupported or if null is passed for either argument.

Parameters:

• string - The string to decode.
• encoding - The name of a supported encoding.

Returns:

• The decoded string.

---

toBase64(Bytes) 

static toBase64(bytes: Bytes): String

Convert the given byte array to a string encoded in base-64. This method does not chunk the data by adding line breaks. An exception is thrown if a null value is passed.

Parameters:

• bytes - The array of bytes to encode.

Returns:

• The encoded string containing only Base64 characters.

---

toBase64URL(Bytes) 

static toBase64URL(bytes: Bytes): String

Convert the given byte array to a string encoded in base-64 for URLs. This method does not chunk the data by adding line breaks and it does not add any padding. An exception is thrown if a null value is passed.

Parameters:

• bytes - The array of bytes to encode.

Returns:

• The encoded string containing only Base64URL characters.

---

toHex(Bytes) 

static toHex(bytes: Bytes): String

Converts an array of bytes into a string representing the hexadecimal values of each byte in order. The returned string will be double the length of the passed array, as it takes two characters to represent any given byte. An exception is thrown if a null value is passed.

Parameters:

• bytes - The array of bytes to encode.

Returns:

• The encoded string containing only hex characters.

---

toURI(String) 

static toURI(string: String): String

Encodes a string into its URL safe form according to the "application/x-www-form-urlencoded" encoding scheme using the default encoding. Unsafe characters are escaped. An exception is thrown if a null value is passed.

Parameters:

• string - The string to encode.

Returns:

• The encoded string.

---

toURI(String, String) 

static toURI(string: String, encoding: String): String

Encodes a string into its URL safe form according to the "application/x-www-form-urlencoded" encoding scheme using the specified encoding. Unsafe characters are escaped. An exception is thrown if the specified encoding is unsupported. An exception is thrown if either argument is null.

Parameters:

• string - The string to encode.
• encoding - The name of a supported encoding.

Returns:

• The encoded string.

---