Package org.simpleframework.http.socket
Class DataConverter
java.lang.Object
org.simpleframework.http.socket.DataConverter
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 -
Constructor Summary
ConstructorsConstructorDescriptionConstructor for theDataConverter
object.DataConverter
(String charset) Constructor for theDataConverter
object. -
Method Summary
Modifier and TypeMethodDescriptionconvert
(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.
-
Field Details
-
charset
This is the character encoding used to convert the text data.
-
-
Constructor Details
-
DataConverter
public DataConverter()Constructor for theDataConverter
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
Constructor for theDataConverter
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
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
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
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 fromsize
- this is the number of bytes to be usedtext
- this is the byte array to convert to a string- Returns:
- a string encoded using the specified encoding
-