AnalyzerGuru.java revision 257
98N/A * CDDL HEADER START 98N/A * The contents of this file are subject to the terms of the 307N/A * Common Development and Distribution License (the "License"). 98N/A * You may not use this file except in compliance with the License. 98N/A * language governing permissions and limitations under the License. 98N/A * When distributing Covered Code, include this CDDL HEADER in each 98N/A * If applicable, add the following below this CDDL HEADER, with the 98N/A * fields enclosed by brackets "[]" replaced with your own identifying 98N/A * information: Portions Copyright [yyyy] [name of copyright owner] 98N/A * Copyright 2007 Sun Microsystems, Inc. All rights reserved. 98N/A * Use is subject to license terms. * Manages and porvides Analyzers as needed. Please see * this</a> page for a great description of the purpose of the AnalyzerGuru. * Created on September 22, 2005 /** The default {@code FileAnalyzerFactory} instance. */ /** Map from file extensions to analyzer factories. */ // TODO: have a comparator /** Map from magic strings to analyzer factories. */ * List of matcher objects which can be used to determine which analyzer /** List of all registered {@code FileAnalyzerFactory} instances. */ * If you write your own analyzer please register it here * Register a {@code FileAnalyzerFactory} instance. "suffix '" +
suffix +
"' used in multiple analyzers";
"magic '" +
magic +
"' used in multiple analyzers";
* Instruct the AnalyzerGuru to use a given analyzer for a given * @param extension the file-extension to add * @param factory a factory which creates * the analyzer to use for the given extension * (if you pass null as the analyzer, you will disable * the analyzer used for that extension) * Get the default Analyzer. * Get an analyzer suited to analyze a file. This function will reuse * analyzers since they are costly. * @param in Input stream containing data to be analyzed * @param file Name of the file to be analyzed * @return An analyzer suited for that file content * @throws java.io.IOException If an error occurs while accessing the * data in the input stream. * Create a Lucene document and fill in the required fields * @param file The file to index * @param in The data to generate the index for * @param path Where the file is located (from source root) * @return The Lucene document to add to the index database * @throws java.io.IOException If an exception occurs while collecting the // date = hr.getLastCommentDate() //RFE // Ignoring any errors while analysing * Get the content type for a named file. * @param in The input stream we want to get the content type for (if * we cannot determine the content type by the filename) * @param file The name of the file * @return The contentType suitable for printing to response.setContentType() or null * if the factory was not found * @throws java.io.IOException If an error occurs while accessing the input * Write a browsable version of the file * @param factory The analyzer factory for this filetype * @param in The input stream containing the data * @param out Where to write the result * @param annotation Annotation information for the file * @throws java.io.IOException If an error occurs while creating the * Get the genre of a file * @param file The file to inpect * @return The genre suitable to decide how to display the file * Get the genre of a bulk of data * @param in A stream containing the data * @return The genre suitable to decide how to display the file * @throws java.io.IOException If an error occurs while getting the content * Get the genre for a named class (this is most likely an analyzer) * @param factory the analyzer factory to get the genre for * @return The genre of this class (null if not found) * Find a {@code FileAnalyzerFactory} with the specified class name. If one * doesn't exist, create one and register it. * @param factoryClassName name of the factory class * @return a file analyzer factory * @throws ClassNotFoundException if there is no class with that name * @throws ClassCastException if the class is not a subclass of {@code * @throws IllegalAccessException if the constructor cannot be accessed * @throws InstantiationException if the class cannot be instantiated * Find a {@code FileAnalyzerFactory} which is an instance of the specified * class. If one doesn't exist, create one and register it. * @param factoryClass the factory class * @return a file analyzer factory * @throws ClassCastException if the class is not a subclass of {@code * @throws IllegalAccessException if the constructor cannot be accessed * @throws InstantiationException if the class cannot be instantiated * Finds a suitable analyser class for file name. If the analyzer cannot * be determined by the file extension, try to look at the data in the * InputStream to find a suitable analyzer. * Use if you just want to find file type. * @param in The input stream containing the data * @param file The file name to get the analyzer for * @return the analyzer factory to use * @throws java.io.IOException If a problem occurs while reading the data * Finds a suitable analyser class for file name. * @param file The file name to get the analyzer for * @return the analyzer factory to use // file doesn't have any of the extensions we know * Finds a suitable analyser class for the data in this stream * @param in The stream containing the data to analyze * @return the analyzer factory to use * @throws java.io.IOException if an error occurs while reading data from * Finds a suitable analyser class for a magic signature * @param signature the magic signature look up * @return the analyzer factory to use * Get an analyzer by looking up the "magic signature" * @param signature the signature to look up * @return the analyzer factory to handle data with this signature // See if text files have the magic sequence if we remove the /** Byte-order markers. */ new String(
new char[] {
0xEF,
0xBB,
0xBF }),
// UTF-8 BOM new String(
new char[] {
0xFE,
0xFF }),
// UTF-16BE BOM new String(
new char[] {
0xFF,
0xFE }),
// UTF-16LE BOM * Strip away the byte-order marker from the string, if it has one. * @param str the string to remove the BOM from * @return a string without the byte-order marker, or <code>null</code> if * the string doesn't start with a BOM