lucee.runtime.search.SearchEngine Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of lucee Show documentation
Building the Lucee Loader JAR
There is a newer version: 6.2.0.164-RC
/**
 * Copyright (c) 2014, the Railo Company Ltd.
 * Copyright (c) 2015, Lucee Association Switzerland
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either 
 * version 2.1 of the License, or (at your option) any later version.
 * 
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 * 
 * You should have received a copy of the GNU Lesser General Public 
 * License along with this library.  If not, see .
 * 
 */
package lucee.runtime.search;

import java.io.IOException;

import lucee.commons.io.res.Resource;
import lucee.runtime.config.Config;
import lucee.runtime.type.Query;

/**
 * interface for a Search Engine
 */
public interface SearchEngine {

	/**
	 * overwrite allowed
	 */
	public static final boolean ALLOW_OVERWRITE = true;

	/**
	 * overwrite denied
	 */
	public static final boolean DENY_OVERWRITE = false;

	public abstract void init(Config config, Resource searchDir) throws IOException, SearchException;

	/**
	 * returns a collection by name
	 * 
	 * @param name name of the desired collection (case insensitive)
	 * @return returns lucene collection object matching name
	 * @throws SearchException if no matching Collection exist
	 */
	public abstract SearchCollection getCollectionByName(String name) throws SearchException;

	/**
	 * @return returns all collections as a query object
	 * @throws SearchException if no matching Collection exist
	 */
	public abstract Query getCollectionsAsQuery() throws SearchException;

	/**
	 * Creates a new Collection and Store it (creating always a spellindex)
	 * 
	 * @param name The Name of the Collection
	 * @param path the path to store
	 * @param language The language of the collection
	 * @param allowOverwrite Allow Overwrite
	 * @return New SearchCollection
	 * @throws SearchException Search Exception
	 */
	public abstract SearchCollection createCollection(String name, Resource path, String language, boolean allowOverwrite) throws SearchException;

	/**
	 * @return returns the directory of the search storage
	 */
	public abstract Resource getDirectory();

	/*
	 * * return XML Element Matching index id
	 * 
	 * @param collElement XML Collection Element
	 * 
	 * @param id
	 * 
	 * @return XML Element
	 */
	// public abstract Element getIndexElement(Element collElement, String id);

	/**
	 * @return returns the Name of the search engine to display in admin
	 */
	public abstract String getDisplayName();

	public abstract SearchData createSearchData(int suggestionMax);

}