| career | drupal | java | mac | mysql | perl | scala | uml | unix  

Tomcat example source code file (

This example Tomcat source code file ( is included in the "Java Source Code Warehouse" project. The intent of this project is to help you "Learn Java by Example" TM.

Java - Tomcat tags/keywords

charsetmapper, charsetmapper, default_resource, inputstream, inputstream, io, properties, properties, string, string, throwable, util

The Tomcat source code

 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * See the License for the specific language governing permissions and
 * limitations under the License.

package org.apache.catalina.util;

import java.util.Locale;
import java.util.Properties;

 * Utility class that attempts to map from a Locale to the corresponding
 * character set to be used for interpreting input text (or generating
 * output text) when the Content-Type header does not include one.  You
 * can customize the behavior of this class by modifying the mapping data
 * it loads, or by subclassing it (to change the algorithm) and then using
 * your own version for a particular web application.
 * @author Craig R. McClanahan
 * @version $Date: 2006-10-24 05:17:11 +0200 (mar., 24 oct. 2006) $ $Version$

public class CharsetMapper {

    // ---------------------------------------------------- Manifest Constants

     * Default properties resource name.
    public static final String DEFAULT_RESOURCE =

    // ---------------------------------------------------------- Constructors

     * Construct a new CharsetMapper using the default properties resource.
    public CharsetMapper() {

     * Construct a new CharsetMapper using the specified properties resource.
     * @param name Name of a properties resource to be loaded
     * @exception IllegalArgumentException if the specified properties
     *  resource could not be loaded for any reason.
    public CharsetMapper(String name) {
        try {
            InputStream stream =
        } catch (Throwable t) {
            throw new IllegalArgumentException(t.toString());

    // ---------------------------------------------------- Instance Variables

     * The mapping properties that have been initialized from the specified or
     * default properties resource.
    private Properties map = new Properties();

    // ------------------------------------------------------- Public Methods

     * Calculate the name of a character set to be assumed, given the specified
     * Locale and the absence of a character set specified as part of the
     * content type header.
     * @param locale The locale for which to calculate a character set
    public String getCharset(Locale locale) {
        // Match full language_country_variant first, then language_country, 
        // then language only
        String charset = map.getProperty(locale.toString());
        if (charset == null) {
            charset = map.getProperty(locale.getLanguage() + "_" 
                    + locale.getCountry());
            if (charset == null) {
                charset = map.getProperty(locale.getLanguage());
        return (charset);

     * The deployment descriptor can have a
     * locale-encoding-mapping-list element which describes the
     * webapp's desired mapping from locale to charset.  This method
     * gets called when processing the web.xml file for a context
     * @param locale The locale for a character set
     * @param charset The charset to be associated with the locale
    public void addCharsetMappingFromDeploymentDescriptor(String locale, String charset) {
        map.put(locale, charset);


Other Tomcat examples (source code examples)

Here is a short list of links related to this Tomcat source code file:

... this post is sponsored by my books ...

#1 New Release!

FP Best Seller


new blog posts


Copyright 1998-2021 Alvin Alexander,
All Rights Reserved.

A percentage of advertising revenue from
pages under the /java/jwarehouse URI on this website is
paid back to open source projects.