buildframework/helium/sf/java/core/src/com/nokia/helium/core/TemplateProcessor.java
author wbernard
Fri, 13 Aug 2010 14:59:05 +0300
changeset 628 7c4a911dc066
parent 587 85df38eb4012
permissions -rw-r--r--
helium_11.0.0-e00f171ca185
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
587
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
     1
/*
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
     2
 * Copyright (c) 2007-2008 Nokia Corporation and/or its subsidiary(-ies).
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
     3
 * All rights reserved.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
     4
 * This component and the accompanying materials are made available
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
     5
 * under the terms of the License "Eclipse Public License v1.0"
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
     6
 * which accompanies this distribution, and is available
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
     7
 * at the URL "http://www.eclipse.org/legal/epl-v10.html".
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
     8
 *
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
     9
 * Initial Contributors:
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    10
 * Nokia Corporation - initial contribution.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    11
 *
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    12
 * Contributors:
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    13
 *
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    14
 * Description:  
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    15
 *
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    16
 */
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    17
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    18
package com.nokia.helium.core;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    19
628
7c4a911dc066 helium_11.0.0-e00f171ca185
wbernard
parents: 587
diff changeset
    20
import java.io.File;
587
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    21
import java.io.FileWriter;
628
7c4a911dc066 helium_11.0.0-e00f171ca185
wbernard
parents: 587
diff changeset
    22
import java.util.HashMap;
587
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    23
import java.util.List;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    24
import java.util.Map;
628
7c4a911dc066 helium_11.0.0-e00f171ca185
wbernard
parents: 587
diff changeset
    25
587
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    26
import org.apache.log4j.Logger;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    27
628
7c4a911dc066 helium_11.0.0-e00f171ca185
wbernard
parents: 587
diff changeset
    28
import freemarker.template.Configuration;
7c4a911dc066 helium_11.0.0-e00f171ca185
wbernard
parents: 587
diff changeset
    29
import freemarker.template.Template;
7c4a911dc066 helium_11.0.0-e00f171ca185
wbernard
parents: 587
diff changeset
    30
587
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    31
/**
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    32
 * Template processor.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    33
 * 
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    34
 */
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    35
public class TemplateProcessor {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    36
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    37
    private Logger log = Logger.getLogger(TemplateProcessor.class);
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    38
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    39
    /**
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    40
     * Create a Map of FreeMarker compatible data from the list of input source.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    41
     * 
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    42
     * @param inputSources
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    43
     * @return
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    44
     * @throws TemplateProcessorException
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    45
     */
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    46
    private HashMap<String, Object> getTemplateMap(
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    47
            List<TemplateInputSource> inputSources) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    48
        HashMap<String, Object> templateMap = new HashMap<String, Object>();
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    49
        try {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    50
            for (TemplateInputSource source : inputSources) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    51
                if (source instanceof XMLTemplateSource) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    52
                    XMLTemplateSource xmlSource = (XMLTemplateSource) source;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    53
                    File inputFile = xmlSource.getSourceLocation();
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    54
                    if (inputFile.exists()) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    55
                        templateMap.put(xmlSource.getSourceName(),
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    56
                                freemarker.ext.dom.NodeModel.parse(inputFile));
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    57
                    } else {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    58
                        log.debug("TemplateProcessor: input file " + inputFile
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    59
                                + " for the template does not exists");
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    60
                    }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    61
                } else if (source instanceof PropertiesSource) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    62
                    PropertiesSource propSource = (PropertiesSource) source;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    63
                    templateMap.put(propSource.getSourceName(), propSource
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    64
                            .getProperties());
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    65
                }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    66
            }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    67
        } catch (java.io.IOException e) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    68
            throw new TemplateProcessorException(
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    69
                    "I/O Error during template conversion: " + e.getMessage());
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    70
        } catch (org.xml.sax.SAXException e1) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    71
            throw new TemplateProcessorException("XML parser error: "
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    72
                    + e1.getMessage());
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    73
        } catch (javax.xml.parsers.ParserConfigurationException e3) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    74
            throw new TemplateProcessorException("Parser error: "
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    75
                    + e3.getMessage());
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    76
        }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    77
        return templateMap;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    78
    }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    79
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    80
    /**
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    81
     * Convert a template.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    82
     * 
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    83
     * @param templateFile
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    84
     * @param outputFile
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    85
     * @param sourceList
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    86
     * @throws TemplateProcessorException
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    87
     */
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    88
    public void convertTemplate(String templateFile, String outputFile,
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    89
            List<TemplateInputSource> sourceList) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    90
        convertTemplate(new File(templateFile), new File(outputFile),
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    91
                sourceList);
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    92
    }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    93
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    94
    /**
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    95
     * Convert a template.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    96
     * 
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    97
     * @param templateFile
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    98
     * @param outputFile
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    99
     * @param sourceList
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   100
     * @throws TemplateProcessorException
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   101
     */
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   102
    public void convertTemplate(File templateFile, File outputFile,
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   103
            List<TemplateInputSource> sourceList) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   104
        if (templateFile != null) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   105
            convertTemplate(templateFile.getParent(), templateFile.getName(),
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   106
                    outputFile.toString(), sourceList);
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   107
        } else {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   108
            throw new TemplateProcessorException("Template file not defined.");
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   109
        }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   110
    }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   111
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   112
    /**
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   113
     * Converts the template to generate xml file to be sent to the server.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   114
     * 
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   115
     * @param templateFile
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   116
     *            - template file to be converted
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   117
     * @param input
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   118
     *            - input source file.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   119
     * @param outputFile
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   120
     *            - location to store the converted file
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   121
     * @param antProperties
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   122
     *            - used as one of the input for conversion.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   123
     * @param inputSourceType
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   124
     *            - source input type (xml / properties from file). Currently
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   125
     *            xml input source is the only one supported.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   126
     * @return - location of the input source.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   127
     * @throws TemplateProcessorException
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   128
     */
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   129
    public void convertTemplate(String templateDir, String templateFile,
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   130
            String outputFile, List<TemplateInputSource> sourceList) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   131
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   132
        Configuration cfg = new Configuration();
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   133
        File templateDirFile = new File(templateDir);
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   134
        if (templateDir != null && templateDirFile.exists()) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   135
            try {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   136
                cfg.setDirectoryForTemplateLoading(templateDirFile);
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   137
                log
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   138
                        .debug("diamonds:TemplateProcessor:adding template directory loader: "
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   139
                                + templateDir);
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   140
            } catch (java.io.IOException ie) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   141
                throw new TemplateProcessorException(
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   142
                        "Template directory configuring error: " + ie);
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   143
            }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   144
        } else {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   145
            throw new TemplateProcessorException(
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   146
                    "Template directory does not exist: "
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   147
                            + templateDirFile.getAbsolutePath());
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   148
        }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   149
        try {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   150
            Template template = cfg.getTemplate(templateFile);
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   151
            Map<String, Object> templateMap = getTemplateMap(sourceList);
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   152
            template.process(templateMap, new FileWriter(outputFile));
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   153
        } catch (freemarker.core.InvalidReferenceException ivx) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   154
            throw new TemplateProcessorException(
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   155
                    "Invalid reference in config: " + ivx);
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   156
        } catch (freemarker.template.TemplateException e2) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   157
            throw new TemplateProcessorException("TemplateException: " + e2);
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   158
        } catch (java.io.IOException e) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   159
            throw new TemplateProcessorException(
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   160
                    "I/O Error during template conversion: " + e);
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   161
        }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   162
    }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   163
}