Page History

Increasingly, programmers view string data strings as a portable means of storing and communicating arbitrary data, including such as numeric values.   A real world example involved storing For example, a real-world system stores the binary values of encrypted passwords as strings in a database. While inefficient, it is generally feasible to convert numeric values to strings and then reverse the process.  However, the binary numeric value Noncharacter data may not be representable in any character setas a string, because not all bit patterns represent valid characters in most character sets.   Consequently, programmers must never convert directly from a binary numeric value not convert noncharacter data to a string. 

Noncompliant Code Example

This noncompliant code example attempts to convert a BigInteger value to a String and then restore it back againto a BigInteger value. The toByteArray() method used returns a byte array containing the two's-complement representation of this BigInteger. The byte array is in big-endian byte - order: the most significant byte is in the zeroth element.   The program uses the String(byte[] bytes) constructor to create the string from the byte array.   The behavior of this constructor when the given bytes are not valid in the default character set is unspecified, which is likely to be the case.   Specifying the character set as a string also has unspecified behavior, although the Java API [API 2014] document claims that the String(byte[], Charset)  method always replaces malformed-input and unmappable-character sequences with this character set's default replacement string.   In any case, converting the String back to a BigInteger is unlikely to reproduce the original value. 

BigInteger x = new BigInteger("530500452766");
byte[] byteArray = x.toByteArray();
String s = new String(byteArray);
byteArray = s.getBytes();
x = new BigInteger(byteArray);

Compliant Solution

This compliant solution first produces a String representation of the BigInteger object and then converts the String object to a byte array. This process is then reversed. Because the textual representation in the String object is generated by the BigInteger class, it contains valid character data in the default character set.

BigInteger x = new BigInteger("530500452766");
String s = x.toString();  // validValid character data
byte[] byteArray = s.getBytes();
String ns = new String(byteArray);  
x = new BigInteger(ns); 

Compliant Solution (

...

Base64)

While Although Java does not provide a Charset that character set that guarantees lossless encoding of byte data, there are many other solutions exist for safely converting an arbitrary byte array into a string and back. Java 8 provides introduced the java.util.Base64 class, which provides encoders and decoders for the Base64 encoding scheme. This compliant solution uses Base64 to safely convert the a number to a string and back without corruption of corrupting the data.:

BigInteger x = new BigInteger("530500452766");
byte[] byteArray = x.toByteArray();
String s = Base64.getEncoder().encodeToString( byteArray);
byteArray = Base64.getDecoder().decode(s);
x = new BigInteger(byteArray);

Risk Assessment

Storing numeric Encoding noncharacter data as a string is likely to result in a loss of data integrity.

Related Guidelines

Bibliography

[API 2006]	Class String
[Seacord 2015]	Image Added STR03-J. Do not encode non-character data as a string LiveLesson

...

Image Modified Image Modified Image Modified