net.sf.saxon.serialize.charcode.package-info Maven / Gradle / Ivy
////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
// Copyright (c) 2018-2023 Saxonica Limited
// This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0.
// If a copy of the MPL was not distributed with this file, You can obtain one at http://mozilla.org/MPL/2.0/.
// This Source Code Form is "Incompatible With Secondary Licenses", as defined by the Mozilla Public License, v. 2.0.
////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
/**
* This package provides classes for handling different character sets, especially
* when serializing the output of a query or transformation.
* Most of the classes in this package are implementations of the interface CharacterSet.
* The sole
* function of these classes is to determine whether a particular character is present in the
* character set or not: if not, Saxon has to replace it with a character reference.
* The actual translation of Unicode characters to characters in the selected encoding
* is left to the Java run-time library. (Note that different versions of Java support
* different sets of encodings, and there is no easy way to find out which encodings
* are supported in a given installation).
* It is possible to configure Saxon to support additional character sets by writing an
* implementation of the CharacterSet interface, and registering this class with the
* Configuration using the call getCharacterSetFactory().setCharacterSetImplementation()
* If an output encoding is requested that Saxon does not recognize, but which the Java
* platform does recognize, then Saxon attempts to determine which characters the encoding
* can represent, so that unsupported characters can be written as numeric character references.
* Saxon wraps the Java CharSet object in a JavaCharacterSet object,
* and tests whether a character is encodable by calling the Java interrogative
* encoding.canEncode(), caching the result locally. Since this mechanism
* appears to have become reliable in JDK 1.5, it is now used much more widely than before,
* and most character sets are now supported in Saxon by relying on this mechanism.
*/
package net.sf.saxon.serialize.charcode;