Package dev.cel.runtime

Class CelRuntimeImpl.Builder

java.lang.Object

dev.cel.runtime.CelRuntimeImpl.Builder

All Implemented Interfaces:

CelRuntimeBuilder

Enclosing class:

CelRuntimeImpl

public abstract static class CelRuntimeImpl.Builder
extends java.lang.Object
implements CelRuntimeBuilder

Builder for CelRuntimeImpl.

Constructor Summary

Constructors

Constructor	Description
Builder()

Method Summary

Modifier and Type	Method	Description
CelRuntimeImpl.Builder	addFileTypes(com.google.protobuf.DescriptorProtos.FileDescriptorSet fileDescriptorSet)	Add all of the Descriptors.FileDescriptors in a FileDescriptorSet to the use for type-checking, and for object creation at interpretation time.
CelRuntimeImpl.Builder	addFileTypes(com.google.protobuf.Descriptors.FileDescriptor... fileDescriptors)	Add Descriptors.FileDescriptors to the use for type-checking, and for object creation at interpretation time.
CelRuntimeImpl.Builder	addFileTypes(java.lang.Iterable<com.google.protobuf.Descriptors.FileDescriptor> fileDescriptors)	Add Descriptors.FileDescriptors to the use for type-checking, and for object creation at interpretation time.
CelRuntimeImpl.Builder	addFunctionBindings(CelFunctionBinding... bindings)	Add one or more CelFunctionBinding objects to the CEL runtime.
CelRuntimeImpl.Builder	addFunctionBindings(java.lang.Iterable<CelFunctionBinding> bindings)	Bind a collection of CelFunctionBinding objects to the runtime.
CelRuntimeImpl.Builder	addLateBoundFunctions(java.lang.Iterable<java.lang.String> lateBoundFunctionNames)	Adds bindings for functions that are allowed to be late-bound (resolved at execution time).
CelRuntimeImpl.Builder	addLateBoundFunctions(java.lang.String... lateBoundFunctionNames)	Adds bindings for functions that are allowed to be late-bound (resolved at execution time).
CelRuntimeImpl.Builder	addLibraries(CelRuntimeLibrary... libraries)	Adds one or more libraries for runtime.
CelRuntimeImpl.Builder	addLibraries(java.lang.Iterable<? extends CelRuntimeLibrary> libraries)	Adds a collection of libraries for runtime.
CelRuntimeImpl.Builder	addMessageTypes(com.google.protobuf.Descriptors.Descriptor... descriptors)	Add message Descriptors.Descriptors to the builder for type-checking and object creation at interpretation time.
CelRuntimeImpl.Builder	addMessageTypes(java.lang.Iterable<com.google.protobuf.Descriptors.Descriptor> descriptors)	Add message Descriptors.Descriptors to the use for type-checking and object creation at interpretation time.
CelRuntime	build()	Build a new instance of the CelRuntime.
abstract CelRuntimeImpl.Builder	setContainer(dev.cel.common.CelContainer container)	Set the CelContainer to use as the namespace for resolving CEL expression variables and functions.
abstract CelRuntimeImpl.Builder	setExtensionRegistry(com.google.protobuf.ExtensionRegistry extensionRegistry)	Sets a proto ExtensionRegistry to assist with unpacking Any messages containing a proto2 extension field.
abstract CelRuntimeImpl.Builder	setOptions(dev.cel.common.CelOptions options)	Set the CelOptions used to enable fixes and features for this CEL instance.
abstract CelRuntimeImpl.Builder	setPlanner(ProgramPlanner planner)
CelRuntimeImpl.Builder	setStandardEnvironmentEnabled(boolean value)	Enable or disable the standard CEL library functions and variables.
abstract CelRuntimeImpl.Builder	setStandardFunctions(CelStandardFunctions standardFunctions)	Override the standard functions for the runtime.
CelRuntimeImpl.Builder	setTypeFactory(java.util.function.Function<java.lang.String,com.google.protobuf.Message.Builder> typeFactory)	Set a custom type factory for the runtime.
abstract CelRuntimeImpl.Builder	setTypeProvider(dev.cel.common.types.CelTypeProvider celTypeProvider)	Sets the CelTypeProvider for resolving CEL types during evaluation, such as a fully qualified type name to a struct or an enum value.
abstract CelRuntimeImpl.Builder	setValueProvider(CelValueProvider celValueProvider)	Sets the CelValueProvider for resolving struct values during evaluation.

Methods inherited from class java.lang.Object

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

Constructor Detail

Builder

public Builder()

Method Detail

setPlanner

public abstract CelRuntimeImpl.Builder setPlanner(ProgramPlanner planner)

setOptions

public abstract CelRuntimeImpl.Builder setOptions(dev.cel.common.CelOptions options)

Description copied from interface: CelRuntimeBuilder

Set the CelOptions used to enable fixes and features for this CEL instance.

Specified by:

setOptions in interface CelRuntimeBuilder

setStandardFunctions

public abstract CelRuntimeImpl.Builder setStandardFunctions(CelStandardFunctions standardFunctions)

Description copied from interface: CelRuntimeBuilder

Override the standard functions for the runtime. This can be used to subset the standard environment to only expose the desired function overloads to the runtime.

CelRuntimeBuilder.setStandardEnvironmentEnabled(boolean) must be set to false for this to take effect.

Specified by:

setStandardFunctions in interface CelRuntimeBuilder

setExtensionRegistry

public abstract CelRuntimeImpl.Builder setExtensionRegistry(com.google.protobuf.ExtensionRegistry extensionRegistry)

Description copied from interface: CelRuntimeBuilder

Sets a proto ExtensionRegistry to assist with unpacking Any messages containing a proto2 extension field.

Specified by:

setExtensionRegistry in interface CelRuntimeBuilder

setTypeProvider

public abstract CelRuntimeImpl.Builder setTypeProvider(dev.cel.common.types.CelTypeProvider celTypeProvider)

Description copied from interface: CelRuntimeBuilder

Sets the CelTypeProvider for resolving CEL types during evaluation, such as a fully qualified type name to a struct or an enum value.

Specified by:

setTypeProvider in interface CelRuntimeBuilder

setValueProvider

public abstract CelRuntimeImpl.Builder setValueProvider(CelValueProvider celValueProvider)

Description copied from interface: CelRuntimeBuilder

Sets the CelValueProvider for resolving struct values during evaluation. Multiple providers can be combined using CombinedCelValueProvider. Note that if you intend to support proto messages in addition to custom struct values, protobuf value provider must be configured first before the custom value provider.

Note that this option is only supported for planner-based runtime.

Specified by:

setValueProvider in interface CelRuntimeBuilder

setContainer

public abstract CelRuntimeImpl.Builder setContainer(dev.cel.common.CelContainer container)

Description copied from interface: CelRuntimeBuilder

Set the CelContainer to use as the namespace for resolving CEL expression variables and functions.

Specified by:

setContainer in interface CelRuntimeBuilder

addFunctionBindings

@CanIgnoreReturnValue
public CelRuntimeImpl.Builder addFunctionBindings(CelFunctionBinding... bindings)

Description copied from interface: CelRuntimeBuilder

Add one or more CelFunctionBinding objects to the CEL runtime.

Functions with duplicate overload ids will be replaced in favor of the new overload.

Specified by:

addFunctionBindings in interface CelRuntimeBuilder

addFunctionBindings

@CanIgnoreReturnValue
public CelRuntimeImpl.Builder addFunctionBindings(java.lang.Iterable<CelFunctionBinding> bindings)

Description copied from interface: CelRuntimeBuilder

Bind a collection of CelFunctionBinding objects to the runtime.

Functions with duplicate overload ids will be replaced in favor of the new overload.

Specified by:

addFunctionBindings in interface CelRuntimeBuilder

addLateBoundFunctions

@CanIgnoreReturnValue
public CelRuntimeImpl.Builder addLateBoundFunctions(java.lang.String... lateBoundFunctionNames)

Description copied from interface: CelRuntimeBuilder

Adds bindings for functions that are allowed to be late-bound (resolved at execution time).

Specified by:

addLateBoundFunctions in interface CelRuntimeBuilder

addLateBoundFunctions

@CanIgnoreReturnValue
public CelRuntimeImpl.Builder addLateBoundFunctions(java.lang.Iterable<java.lang.String> lateBoundFunctionNames)

Description copied from interface: CelRuntimeBuilder

Adds bindings for functions that are allowed to be late-bound (resolved at execution time).

Specified by:

addLateBoundFunctions in interface CelRuntimeBuilder

addMessageTypes

@CanIgnoreReturnValue
public CelRuntimeImpl.Builder addMessageTypes(com.google.protobuf.Descriptors.Descriptor... descriptors)

Description copied from interface: CelRuntimeBuilder

Add message Descriptors.Descriptors to the builder for type-checking and object creation at interpretation time.

Note, it is valid to combine type factory methods within the runtime. Only the options which have been configured will be used. The type creation search order is as follows:

• Custom type factory (CelRuntimeBuilder.setTypeFactory(java.util.function.Function<java.lang.String, com.google.protobuf.Message.Builder>))
• Custom descriptor set {#addMessageTypes)

Specified by:

addMessageTypes in interface CelRuntimeBuilder

addMessageTypes

@CanIgnoreReturnValue
public CelRuntimeImpl.Builder addMessageTypes(java.lang.Iterable<com.google.protobuf.Descriptors.Descriptor> descriptors)

Description copied from interface: CelRuntimeBuilder

Add message Descriptors.Descriptors to the use for type-checking and object creation at interpretation time.

Note, it is valid to combine type factory methods within the runtime. Only the options which have been configured will be used. The type creation search order is as follows:

• Custom type factory (CelRuntimeBuilder.setTypeFactory(java.util.function.Function<java.lang.String, com.google.protobuf.Message.Builder>))
• Custom descriptor set {#addMessageTypes)

Specified by:

addMessageTypes in interface CelRuntimeBuilder

addFileTypes

@CanIgnoreReturnValue
public CelRuntimeImpl.Builder addFileTypes(com.google.protobuf.DescriptorProtos.FileDescriptorSet fileDescriptorSet)

Description copied from interface: CelRuntimeBuilder

Add all of the Descriptors.FileDescriptors in a FileDescriptorSet to the use for type-checking, and for object creation at interpretation time.

Note, it is valid to combine type factory methods within the runtime. Only the options which have been configured will be used. The type creation search order is as follows:

• Custom type factory (CelRuntimeBuilder.setTypeFactory(java.util.function.Function<java.lang.String, com.google.protobuf.Message.Builder>))
• Custom descriptor set {CelRuntimeBuilder.addMessageTypes(com.google.protobuf.Descriptors.Descriptor...))

Specified by:

addFileTypes in interface CelRuntimeBuilder

addFileTypes

@CanIgnoreReturnValue
public CelRuntimeImpl.Builder addFileTypes(com.google.protobuf.Descriptors.FileDescriptor... fileDescriptors)

Description copied from interface: CelRuntimeBuilder

Add Descriptors.FileDescriptors to the use for type-checking, and for object creation at interpretation time.

Note, it is valid to combine type factory methods within the runtime. Only the options which have been configured will be used. The type creation search order is as follows:

• Custom type factory (CelRuntimeBuilder.setTypeFactory(java.util.function.Function<java.lang.String, com.google.protobuf.Message.Builder>))
• Custom descriptor set {CelRuntimeBuilder.addMessageTypes(com.google.protobuf.Descriptors.Descriptor...))

Specified by:

addFileTypes in interface CelRuntimeBuilder

addFileTypes

@CanIgnoreReturnValue
public CelRuntimeImpl.Builder addFileTypes(java.lang.Iterable<com.google.protobuf.Descriptors.FileDescriptor> fileDescriptors)

Description copied from interface: CelRuntimeBuilder

Add Descriptors.FileDescriptors to the use for type-checking, and for object creation at interpretation time.

Note, it is valid to combine type factory methods within the runtime. Only the options which have been configured will be used. The type creation search order is as follows:

• Custom type factory (CelRuntimeBuilder.setTypeFactory(java.util.function.Function<java.lang.String, com.google.protobuf.Message.Builder>))
• Custom descriptor set {CelRuntimeBuilder.addMessageTypes(com.google.protobuf.Descriptors.Descriptor...))

Specified by:

addFileTypes in interface CelRuntimeBuilder

addLibraries

@CanIgnoreReturnValue
public CelRuntimeImpl.Builder addLibraries(CelRuntimeLibrary... libraries)

Description copied from interface: CelRuntimeBuilder

Adds one or more libraries for runtime.

Specified by:

addLibraries in interface CelRuntimeBuilder

addLibraries

@CanIgnoreReturnValue
public CelRuntimeImpl.Builder addLibraries(java.lang.Iterable<? extends CelRuntimeLibrary> libraries)

Description copied from interface: CelRuntimeBuilder

Adds a collection of libraries for runtime.

Specified by:

addLibraries in interface CelRuntimeBuilder

setTypeFactory

public CelRuntimeImpl.Builder setTypeFactory(java.util.function.Function<java.lang.String,com.google.protobuf.Message.Builder> typeFactory)

Description copied from interface: CelRuntimeBuilder

Set a custom type factory for the runtime.

Note: it is valid to combine type factory methods within the runtime. Only the options which have been configured will be used.

The type creation search order is as follows:

• Custom type factory (#setTypeFactory)
• Custom descriptor set {CelRuntimeBuilder.addMessageTypes(com.google.protobuf.Descriptors.Descriptor...))

Specified by:

setTypeFactory in interface CelRuntimeBuilder

setStandardEnvironmentEnabled

public CelRuntimeImpl.Builder setStandardEnvironmentEnabled(boolean value)

Description copied from interface: CelRuntimeBuilder

Enable or disable the standard CEL library functions and variables.

Specified by:

setStandardEnvironmentEnabled in interface CelRuntimeBuilder

build

public CelRuntime build()

Description copied from interface: CelRuntimeBuilder

Build a new instance of the CelRuntime.

Specified by:

build in interface CelRuntimeBuilder