Class UTF7Charset
- All Implemented Interfaces:
Comparable<Charset>
- Direct Known Subclasses:
UTF7OptionalCharset
- Since:
- 2005-06-10
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionprotected class
The Decoder inner class handles the decoding of the UTF7 charset.protected class
The Encoder inner class handles the encoding of the UTF7 charset. -
Constructor Summary
ConstructorsConstructorDescriptionConstructs an instance of the UTF7Charset.UTF7Charset
(String canonicalName, String[] aliases, boolean optionalDirect) Constructs an instance of the UTF7Charset, specifying whether the O-set characters are to be encoded directly or using a shift sequence. -
Method Summary
Modifier and TypeMethodDescriptionboolean
Tells whether or not this charset supports encoding.boolean
Tells whether or not this charset contains the given charset.Constructs a new decoder for this charset.Constructs a new encoder for this charset.Methods inherited from class java.nio.charset.Charset
aliases, availableCharsets, compareTo, decode, defaultCharset, displayName, displayName, encode, encode, equals, forName, hashCode, isRegistered, isSupported, name, toString
-
Constructor Details
-
UTF7Charset
public UTF7Charset()Constructs an instance of the UTF7Charset. O-set characters are not directly encoded. -
UTF7Charset
Constructs an instance of the UTF7Charset, specifying whether the O-set characters are to be encoded directly or using a shift sequence.- Parameters:
canonicalName
- The canonical name of this charsetaliases
- An array of this charset's aliases, or null if it has no aliasesoptionalDirect
- if true, O-set characters are encoded directly, otherwise they are encoded using a shift sequence.- Throws:
IllegalCharsetNameException
- If the canonical name or any of the aliases are illegal
-
-
Method Details
-
contains
Tells whether or not this charset contains the given charset.A charset C is said to contain a charset D if, and only if, every character representable in D is also representable in C. If this relationship holds then it is guaranteed that every string that can be encoded in D can also be encoded in C without performing any replacements.
That C contains D does not imply that each character representable in C by a particular byte sequence is represented in D by the same byte sequence, although sometimes this is the case.
Every charset contains itself.
This method computes an approximation of the containment relation: If it returns true then the given charset is known to be contained by this charset; if it returns false, however, then it is not necessarily the case that the given charset is not contained in this charset.
-
canEncode
public boolean canEncode()Tells whether or not this charset supports encoding. -
newDecoder
Constructs a new decoder for this charset.- Specified by:
newDecoder
in classCharset
- Returns:
- A new decoder for this charset
-
newEncoder
Constructs a new encoder for this charset.- Specified by:
newEncoder
in classCharset
- Returns:
- A new encoder for this charset
- Throws:
UnsupportedOperationException
- If this charset does not support encoding
-