/* 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.
 */

parcel Lucy;

/** Multiple Analyzers in series.
 *
 * A PolyAnalyzer is a series of [Analyzers](cfish:Analyzer),
 * each of which will be called upon to "analyze" text in turn.  You can
 * either provide the Analyzers yourself, or you can specify a supported
 * language, in which case a PolyAnalyzer consisting of a
 * [](cfish:CaseFolder), a
 * [](cfish:RegexTokenizer), and a
 * [](cfish:SnowballStemmer) will be generated for you.
 *
 * The language parameter is DEPRECATED. Use
 * [](cfish:EasyAnalyzer) instead.
 *
 * Supported languages:
 *
 *     en => English,
 *     da => Danish,
 *     de => German,
 *     es => Spanish,
 *     fi => Finnish,
 *     fr => French,
 *     hu => Hungarian,
 *     it => Italian,
 *     nl => Dutch,
 *     no => Norwegian,
 *     pt => Portuguese,
 *     ro => Romanian,
 *     ru => Russian,
 *     sv => Swedish,
 *     tr => Turkish,
 */
public class Lucy::Analysis::PolyAnalyzer inherits Lucy::Analysis::Analyzer {

    Vector  *analyzers;

    /** Create a new PolyAnalyzer.
     *
     * @param language An ISO code from the list of supported languages.
     * DEPRECATED, use [](cfish:EasyAnalyzer) instead.
     * @param analyzers An array of Analyzers.  The order of the analyzers
     * matters.  Don't put a SnowballStemmer before a RegexTokenizer (can't stem whole
     * documents or paragraphs -- just individual words), or a SnowballStopFilter
     * after a SnowballStemmer (stemmed words, e.g. "themselv", will not appear in a
     * stoplist).  In general, the sequence should be: tokenize, normalize,
     * stopalize, stem.
     */
    public inert incremented PolyAnalyzer*
    new(String *language = NULL, Vector *analyzers = NULL);

    /** Initialize a PolyAnalyzer.
     *
     * @param language An ISO code from the list of supported languages.
     * DEPRECATED, use [](cfish:EasyAnalyzer) instead.
     * @param analyzers An array of Analyzers.  The order of the analyzers
     * matters.  Don't put a SnowballStemmer before a RegexTokenizer (can't stem whole
     * documents or paragraphs -- just individual words), or a SnowballStopFilter
     * after a SnowballStemmer (stemmed words, e.g. "themselv", will not appear in a
     * stoplist).  In general, the sequence should be: tokenize, normalize,
     * stopalize, stem.
     */
    public inert PolyAnalyzer*
    init(PolyAnalyzer *self, String *language = NULL,
         Vector *analyzers = NULL);

    /** Getter for "analyzers" member.
     */
    public Vector*
    Get_Analyzers(PolyAnalyzer *self);

    public incremented Inversion*
    Transform(PolyAnalyzer *self, Inversion *inversion);

    public incremented Inversion*
    Transform_Text(PolyAnalyzer *self, String *text);

    public bool
    Equals(PolyAnalyzer *self, Obj *other);

    public incremented Obj*
    Dump(PolyAnalyzer *self);

    public incremented PolyAnalyzer*
    Load(PolyAnalyzer *self, Obj *dump);

    public void
    Destroy(PolyAnalyzer *self);
}