Class DataConverter

java.lang.Object
org.simpleframework.http.socket.DataConverter

public class DataConverter extends Object
The DataConverter object is used to convert binary data to text data and vice versa. According to RFC 6455 a particular text frame might include a partial UTF-8 sequence; however, the whole message MUST contain valid UTF-8.
See Also:
  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    private final String
    This is the character encoding used to convert the text data.
  • Constructor Summary

    Constructors
    Constructor
    Description
    Constructor for the DataConverter object.
    Constructor for the DataConverter object.
  • Method Summary

    Modifier and Type
    Method
    Description
    convert(byte[] binary)
    This method is used to convert data using the character encoding specified when constructing the converter.
    convert(byte[] binary, int offset, int size)
    This method is used to convert data using the character encoding specified when constructing the converter.
    byte[]
    This method is used to convert text using the character encoding specified when constructing the converter.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Field Details

    • charset

      private final String charset
      This is the character encoding used to convert the text data.
  • Constructor Details

    • DataConverter

      public DataConverter()
      Constructor for the DataConverter object. By default this uses UTF-8 character encoding to convert text data as this is what is required for RFC 6455 section 5.6.
    • DataConverter

      public DataConverter(String charset)
      Constructor for the DataConverter object. This can be used to specific a character encoding other than UTF-8. However it is not recommended as RFC 6455 section 5.6 suggests the frame must contain valid UTF-8 data.
      Parameters:
      charset - the character encoding to be used
  • Method Details

    • convert

      public byte[] convert(String text)
      This method is used to convert text using the character encoding specified when constructing the converter. Typically this will use UTF-8 as required by RFC 6455.
      Parameters:
      text - this is the string to convert to a byte array
      Returns:
      a byte array decoded using the specified encoding
    • convert

      public String convert(byte[] binary)
      This method is used to convert data using the character encoding specified when constructing the converter. Typically this will use UTF-8 as required by RFC 6455.
      Parameters:
      text - this is the byte array to convert to a string
      Returns:
      a string encoded using the specified encoding
    • convert

      public String convert(byte[] binary, int offset, int size)
      This method is used to convert data using the character encoding specified when constructing the converter. Typically this will use UTF-8 as required by RFC 6455.
      Parameters:
      offset - the is the offset to read the bytes from
      size - this is the number of bytes to be used
      text - this is the byte array to convert to a string
      Returns:
      a string encoded using the specified encoding