Module org.elasticsearch.server

Package org.elasticsearch.script

Class IpFieldScript

java.lang.Object

org.elasticsearch.script.DocBasedScript

org.elasticsearch.script.AbstractFieldScript

org.elasticsearch.script.IpFieldScript

public abstract class IpFieldScript
extends AbstractFieldScript

Script producing IP addresses. Unlike the other AbstractFieldScripts which deal with their native java objects this converts its values to the same format that Lucene uses to store its fields, InetAddressPoint. There are a few compelling reasons to do this:

• Inet4Addresses and Inet6Address are not comparable with one another. That is correct in some contexts, but not for our queries. Our queries must consider the IPv4 address equal to the address that it maps to in IPv6 rfc4291).
• InetAddresses are not ordered, but we need to implement range queries with same same ordering as IpFieldMapper. That also uses InetAddressPoint so it saves us a lot of trouble to use the same representation.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	IpFieldScript.Emit
static interface	IpFieldScript.Factory
static interface	IpFieldScript.LeafFactory

Field Summary

Fields

Modifier and Type	Field	Description
static final ScriptContext<IpFieldScript.Factory>	CONTEXT
static final String[]	PARAMETERS
static final IpFieldScript.Factory	PARSE_FROM_SOURCE

Fields inherited from class org.elasticsearch.script.AbstractFieldScript

fieldName, MAX_VALUES, source

Fields inherited from class org.elasticsearch.script.DocBasedScript

docReader

Constructor Summary

Constructors

Constructor	Description
IpFieldScript(String fieldName, Map<String,Object> params, SearchLookup searchLookup, OnScriptError onScriptError, org.apache.lucene.index.LeafReaderContext ctx)

Method Summary

Modifier and Type	Method	Description
final int	count()	The number of results produced the last time AbstractFieldScript.runForDoc(int) was called.
final void	emit(String v)
protected void	emitFromObject(Object v)
static IpFieldScript.Factory	leafAdapter(Function<SearchLookup,CompositeFieldScript.LeafFactory> parentFactory)
protected void	prepareExecute()
final void	runForDoc(int docId, Consumer<InetAddress> consumer)
final org.apache.lucene.util.BytesRef[]	values()	Values from the last time AbstractFieldScript.runForDoc(int) was called.

Methods inherited from class org.elasticsearch.script.AbstractFieldScript

checkMaxSize, emitFromCompositeScript, emitFromSource, emitValueFromCompositeScript, execute, extractFromSource, getParams, newContext, runForDoc

Methods inherited from class org.elasticsearch.script.DocBasedScript

docAsMap, field, fields, getDoc, setDocument, source

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

CONTEXT

public static final ScriptContext<IpFieldScript.Factory> CONTEXT

PARSE_FROM_SOURCE

public static final IpFieldScript.Factory PARSE_FROM_SOURCE

PARAMETERS

public static final String[] PARAMETERS

Constructor Details

IpFieldScript

public IpFieldScript(String fieldName,
 Map<String,Object> params,
 SearchLookup searchLookup,
 OnScriptError onScriptError,
 org.apache.lucene.index.LeafReaderContext ctx)

Method Details

leafAdapter

public static IpFieldScript.Factory leafAdapter(Function<SearchLookup,CompositeFieldScript.LeafFactory> parentFactory)

prepareExecute

protected void prepareExecute()

Specified by:

prepareExecute in class AbstractFieldScript

runForDoc

public final void runForDoc(int docId,
 Consumer<InetAddress> consumer)

values

public final org.apache.lucene.util.BytesRef[] values()

Values from the last time AbstractFieldScript.runForDoc(int) was called. This array is mutable and will change with the next call of AbstractFieldScript.runForDoc(int). It is also oversized and will contain garbage at all indices at and above count().

All values are IPv6 addresses so they are 16 bytes. IPv4 addresses are encoded by rfc4291.

count

public final int count()

The number of results produced the last time AbstractFieldScript.runForDoc(int) was called.

emitFromObject

protected void emitFromObject(Object v)

Specified by:

emitFromObject in class AbstractFieldScript

emit

public final void emit(String v)