/* * 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 * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package org.apache.tomcat.buildutil; import java.io.BufferedReader; import java.io.File; import java.io.FileInputStream; import java.io.FileOutputStream; import java.io.IOException; import java.io.InputStreamReader; import java.io.OutputStreamWriter; import java.io.PrintWriter; import java.util.LinkedList; import java.util.List; import org.apache.tools.ant.BuildException; import org.apache.tools.ant.DirectoryScanner; import org.apache.tools.ant.Project; import org.apache.tools.ant.Task; import org.apache.tools.ant.types.FileSet; /** * Ant task to convert a given set of files from Text to HTML. * Inserts an HTML header including pre tags and replaces special characters * with their HTML escaped equivalents. * *

This task is currently used by the ant script to build our examples

* * @author Mark Roth */ public class Txt2Html extends Task { /** The directory to contain the resulting files */ private File todir; /** The file to be converted into HTML */ private final List filesets = new LinkedList<>(); /** * The encoding of the source files (.java and .jsp). Once they use * UTF-8, this will need to be updated. */ private static final String SOURCE_ENCODING = "ISO-8859-1"; /** * Line terminator to be used for separating lines of the generated * HTML page, to be independent from "line.separator" system property. */ private static final String LINE_SEPARATOR = "\r\n"; /** * Sets the directory to contain the resulting files * * @param todir The directory */ public void setTodir( File todir ) { this.todir = todir; } /** * Sets the files to be converted into HTML * * @param fs The fileset to be converted. */ public void addFileset( FileSet fs ) { filesets.add( fs ); } /** * Perform the conversion * * @throws BuildException if an error occurs during execution of * this task. */ @Override public void execute() throws BuildException { int count = 0; // Step through each file and convert. for (FileSet fs : filesets) { DirectoryScanner ds = fs.getDirectoryScanner(getProject()); File basedir = ds.getBasedir(); String[] files = ds.getIncludedFiles(); for( int i = 0; i < files.length; i++ ) { File from = new File( basedir, files[i] ); File to = new File( todir, files[i] + ".html" ); if( !to.exists() || (from.lastModified() > to.lastModified()) ) { log( "Converting file '" + from.getAbsolutePath() + "' to '" + to.getAbsolutePath(), Project.MSG_VERBOSE ); try { convert( from, to ); } catch( IOException e ) { throw new BuildException( "Could not convert '" + from.getAbsolutePath() + "' to '" + to.getAbsolutePath() + "'", e ); } count++; } } if( count > 0 ) { log( "Converted " + count + " file" + (count > 1 ? "s" : "") + " to " + todir.getAbsolutePath() ); } } } /** * Perform the actual copy and conversion * * @param from The input file * @param to The output file * @throws IOException Thrown if an error occurs during the conversion */ private void convert( File from, File to ) throws IOException { // Open files: try (BufferedReader in = new BufferedReader(new InputStreamReader( new FileInputStream(from), SOURCE_ENCODING))) { try (PrintWriter out = new PrintWriter(new OutputStreamWriter( new FileOutputStream(to), "UTF-8"))) { // Output header: out.print("" + "Source Code
" );

                // Convert, line-by-line:
                String line;
                while( (line = in.readLine()) != null ) {
                    StringBuilder result = new StringBuilder();
                    int len = line.length();
                    for( int i = 0; i < len; i++ ) {
                        char c = line.charAt( i );
                        switch( c ) {
                            case '&':
                                result.append( "&" );
                                break;
                            case '<':
                                result.append( "<" );
                                break;
                            default:
                                result.append( c );
                        }
                    }
                    out.print( result.toString() + LINE_SEPARATOR );
                }

                // Output footer:
                out.print( "
" ); } } } }