1 /*

     2 * Copyright (c) 2007 Nokia Corporation and/or its subsidiary(-ies). 

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:  Interface for localisation enhancements

    15  *

    16 */

    17 

    18 

    19 package com.nokia.tools.themeinstaller.localisation;

    20 

    21 import java.io.File;

    22 import java.io.IOException;

    23 

    24 /**

    25  * Interface for localisation enhancements.

    26  */

    27 public interface ILocalisation

    28     {

    29 

    30     /**

    31      * Get localisation settings of the theme.

    32      * @return Localisation settings

    33      */

    34     public Settings getSettings();

    35 

    36     /**

    37      * Find and compose a DTD file according to the provided localisation

    38      * settings. The temp-DTD file is deleted in the JVM exit.

    39      * @param aFileName Main dtd file name

    40      * @param aLanguage Language id of the language install

    41      * @return The composed DTD-file containing the main DTD file and

    42      * the extra entities from other DTD-files.

    43      * @throws IOException if reading/writing from/to DTD files fail.

    44      */

    45     public File composeDTD( String aFileName, int aLanguage ) throws IOException;

    46 

    47     /**

    48      * Find a DTD file according to the provided localisation settings.

    49      * @param aFileName DTD file name

    50      * @return The DTD file

    51      * @throws IOException if reading DTD files fail.

    52      */

    53     public File findDTD( String aFileName ) throws IOException;

    54 

    55     }