org.hibernate.search.bridge.spi.EncodingBridge Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of hibernate-search-engine Show documentation

Core of the Object/Lucene mapper, query engine and index management

There is a newer version: 5.11.12.Final

Show newest version

/*
 * Hibernate Search, full-text search for your domain model
 *
 * License: GNU Lesser General Public License (LGPL), version 2.1 or later
 * See the lgpl.txt file in the root directory or .
 */
package org.hibernate.search.bridge.spi;

import org.hibernate.search.annotations.Field;
import org.hibernate.search.metadata.NumericFieldSettingsDescriptor.NumericEncodingType;

/**
 * Interface implemented by bridges that encode information in a specific format.
 *
 * Those bridges should:
 * 

 * declare the numeric encoding, if any, in order to expose it in the metadata
 * 
declare the null marker, in order to enable {@link Field#indexNullAs()}.
 * 
 *
 * Bridges that do not implement this interface will be attributed a {@code null}
 * numeric encoding and fields with those bridges will use a simple null marker holding
 * a string.
 *
 * @author Yoann Rodiere
 * @hsearch.experimental This contract is currently under active development and may be altered in future releases,
 * breaking existing users.
 */
public interface EncodingBridge {

	/**
	 * Define the numeric encoding to use for the brdige.
	 *
	 * @return the encoding to use for this bridge, or {@link NumericEncodingType#UNKNOWN} if
	 * this bridge does not use numeric encoding.
	 */
	NumericEncodingType getEncodingType();

	/**
	 * @param indexNullAs The value of {@link Field#indexNullAs()}.
	 * @return The marker to use when a value is missing.
	 * @throws IllegalArgumentException If {@code indexNullAs} cannot be encoded in the required format.
	 */
	NullMarker createNullMarker(String indexNullAs) throws IllegalArgumentException;

}