Interface RouteOrBuilder

  • All Superinterfaces:
    com.google.protobuf.MessageLiteOrBuilder, com.google.protobuf.MessageOrBuilder
    All Known Implementing Classes:
    Route, Route.Builder

    public interface RouteOrBuilder
    extends com.google.protobuf.MessageOrBuilder
    • Method Detail

      • getName

        java.lang.String getName()
         Name for the route.
         
        string name = 14;
        Returns:
        The name.
      • getNameBytes

        com.google.protobuf.ByteString getNameBytes()
         Name for the route.
         
        string name = 14;
        Returns:
        The bytes for name.
      • hasMatch

        boolean hasMatch()
         Route matching parameters.
         
        .envoy.config.route.v3.RouteMatch match = 1 [(.validate.rules) = { ... }
        Returns:
        Whether the match field is set.
      • getMatch

        RouteMatch getMatch()
         Route matching parameters.
         
        .envoy.config.route.v3.RouteMatch match = 1 [(.validate.rules) = { ... }
        Returns:
        The match.
      • getMatchOrBuilder

        RouteMatchOrBuilder getMatchOrBuilder()
         Route matching parameters.
         
        .envoy.config.route.v3.RouteMatch match = 1 [(.validate.rules) = { ... }
      • hasRoute

        boolean hasRoute()
         Route request to some upstream cluster.
         
        .envoy.config.route.v3.RouteAction route = 2;
        Returns:
        Whether the route field is set.
      • getRoute

        RouteAction getRoute()
         Route request to some upstream cluster.
         
        .envoy.config.route.v3.RouteAction route = 2;
        Returns:
        The route.
      • getRouteOrBuilder

        RouteActionOrBuilder getRouteOrBuilder()
         Route request to some upstream cluster.
         
        .envoy.config.route.v3.RouteAction route = 2;
      • hasRedirect

        boolean hasRedirect()
         Return a redirect.
         
        .envoy.config.route.v3.RedirectAction redirect = 3;
        Returns:
        Whether the redirect field is set.
      • getRedirect

        RedirectAction getRedirect()
         Return a redirect.
         
        .envoy.config.route.v3.RedirectAction redirect = 3;
        Returns:
        The redirect.
      • getRedirectOrBuilder

        RedirectActionOrBuilder getRedirectOrBuilder()
         Return a redirect.
         
        .envoy.config.route.v3.RedirectAction redirect = 3;
      • hasDirectResponse

        boolean hasDirectResponse()
         Return an arbitrary HTTP response directly, without proxying.
         
        .envoy.config.route.v3.DirectResponseAction direct_response = 7;
        Returns:
        Whether the directResponse field is set.
      • getDirectResponse

        DirectResponseAction getDirectResponse()
         Return an arbitrary HTTP response directly, without proxying.
         
        .envoy.config.route.v3.DirectResponseAction direct_response = 7;
        Returns:
        The directResponse.
      • getDirectResponseOrBuilder

        DirectResponseActionOrBuilder getDirectResponseOrBuilder()
         Return an arbitrary HTTP response directly, without proxying.
         
        .envoy.config.route.v3.DirectResponseAction direct_response = 7;
      • hasFilterAction

        boolean hasFilterAction()
         [#not-implemented-hide:]
         A filter-defined action (e.g., it could dynamically generate the RouteAction).
         [#comment: TODO(samflattery): Remove cleanup in route_fuzz_test.cc when
         implemented]
         
        .envoy.config.route.v3.FilterAction filter_action = 17;
        Returns:
        Whether the filterAction field is set.
      • getFilterAction

        FilterAction getFilterAction()
         [#not-implemented-hide:]
         A filter-defined action (e.g., it could dynamically generate the RouteAction).
         [#comment: TODO(samflattery): Remove cleanup in route_fuzz_test.cc when
         implemented]
         
        .envoy.config.route.v3.FilterAction filter_action = 17;
        Returns:
        The filterAction.
      • getFilterActionOrBuilder

        FilterActionOrBuilder getFilterActionOrBuilder()
         [#not-implemented-hide:]
         A filter-defined action (e.g., it could dynamically generate the RouteAction).
         [#comment: TODO(samflattery): Remove cleanup in route_fuzz_test.cc when
         implemented]
         
        .envoy.config.route.v3.FilterAction filter_action = 17;
      • hasNonForwardingAction

        boolean hasNonForwardingAction()
         [#not-implemented-hide:]
         An action used when the route will generate a response directly,
         without forwarding to an upstream host. This will be used in non-proxy
         xDS clients like the gRPC server. It could also be used in the future
         in Envoy for a filter that directly generates responses for requests.
         
        .envoy.config.route.v3.NonForwardingAction non_forwarding_action = 18;
        Returns:
        Whether the nonForwardingAction field is set.
      • getNonForwardingAction

        NonForwardingAction getNonForwardingAction()
         [#not-implemented-hide:]
         An action used when the route will generate a response directly,
         without forwarding to an upstream host. This will be used in non-proxy
         xDS clients like the gRPC server. It could also be used in the future
         in Envoy for a filter that directly generates responses for requests.
         
        .envoy.config.route.v3.NonForwardingAction non_forwarding_action = 18;
        Returns:
        The nonForwardingAction.
      • getNonForwardingActionOrBuilder

        NonForwardingActionOrBuilder getNonForwardingActionOrBuilder()
         [#not-implemented-hide:]
         An action used when the route will generate a response directly,
         without forwarding to an upstream host. This will be used in non-proxy
         xDS clients like the gRPC server. It could also be used in the future
         in Envoy for a filter that directly generates responses for requests.
         
        .envoy.config.route.v3.NonForwardingAction non_forwarding_action = 18;
      • hasMetadata

        boolean hasMetadata()
         The Metadata field can be used to provide additional information
         about the route. It can be used for configuration, stats, and logging.
         The metadata should go under the filter namespace that will need it.
         For instance, if the metadata is intended for the Router filter,
         the filter name should be specified as ``envoy.filters.http.router``.
         
        .envoy.config.core.v3.Metadata metadata = 4;
        Returns:
        Whether the metadata field is set.
      • getMetadata

        Metadata getMetadata()
         The Metadata field can be used to provide additional information
         about the route. It can be used for configuration, stats, and logging.
         The metadata should go under the filter namespace that will need it.
         For instance, if the metadata is intended for the Router filter,
         the filter name should be specified as ``envoy.filters.http.router``.
         
        .envoy.config.core.v3.Metadata metadata = 4;
        Returns:
        The metadata.
      • getMetadataOrBuilder

        MetadataOrBuilder getMetadataOrBuilder()
         The Metadata field can be used to provide additional information
         about the route. It can be used for configuration, stats, and logging.
         The metadata should go under the filter namespace that will need it.
         For instance, if the metadata is intended for the Router filter,
         the filter name should be specified as ``envoy.filters.http.router``.
         
        .envoy.config.core.v3.Metadata metadata = 4;
      • hasDecorator

        boolean hasDecorator()
         Decorator for the matched route.
         
        .envoy.config.route.v3.Decorator decorator = 5;
        Returns:
        Whether the decorator field is set.
      • getDecorator

        Decorator getDecorator()
         Decorator for the matched route.
         
        .envoy.config.route.v3.Decorator decorator = 5;
        Returns:
        The decorator.
      • getDecoratorOrBuilder

        DecoratorOrBuilder getDecoratorOrBuilder()
         Decorator for the matched route.
         
        .envoy.config.route.v3.Decorator decorator = 5;
      • getTypedPerFilterConfigCount

        int getTypedPerFilterConfigCount()
         This field can be used to provide route specific per filter config. The key should match the
         :ref:`filter config name
         <envoy_v3_api_field_extensions.filters.network.http_connection_manager.v3.HttpFilter.name>`.
         See :ref:`Http filter route specific config <arch_overview_http_filters_per_filter_config>`
         for details.
         [#comment: An entry's value may be wrapped in a
         :ref:`FilterConfig<envoy_v3_api_msg_config.route.v3.FilterConfig>`
         message to specify additional options.]
         
        map<string, .google.protobuf.Any> typed_per_filter_config = 13;
      • containsTypedPerFilterConfig

        boolean containsTypedPerFilterConfig​(java.lang.String key)
         This field can be used to provide route specific per filter config. The key should match the
         :ref:`filter config name
         <envoy_v3_api_field_extensions.filters.network.http_connection_manager.v3.HttpFilter.name>`.
         See :ref:`Http filter route specific config <arch_overview_http_filters_per_filter_config>`
         for details.
         [#comment: An entry's value may be wrapped in a
         :ref:`FilterConfig<envoy_v3_api_msg_config.route.v3.FilterConfig>`
         message to specify additional options.]
         
        map<string, .google.protobuf.Any> typed_per_filter_config = 13;
      • getTypedPerFilterConfig

        @Deprecated
        java.util.Map<java.lang.String,​com.google.protobuf.Any> getTypedPerFilterConfig()
        Deprecated.
      • getTypedPerFilterConfigMap

        java.util.Map<java.lang.String,​com.google.protobuf.Any> getTypedPerFilterConfigMap()
         This field can be used to provide route specific per filter config. The key should match the
         :ref:`filter config name
         <envoy_v3_api_field_extensions.filters.network.http_connection_manager.v3.HttpFilter.name>`.
         See :ref:`Http filter route specific config <arch_overview_http_filters_per_filter_config>`
         for details.
         [#comment: An entry's value may be wrapped in a
         :ref:`FilterConfig<envoy_v3_api_msg_config.route.v3.FilterConfig>`
         message to specify additional options.]
         
        map<string, .google.protobuf.Any> typed_per_filter_config = 13;
      • getTypedPerFilterConfigOrDefault

        com.google.protobuf.Any getTypedPerFilterConfigOrDefault​(java.lang.String key,
                                                                 com.google.protobuf.Any defaultValue)
         This field can be used to provide route specific per filter config. The key should match the
         :ref:`filter config name
         <envoy_v3_api_field_extensions.filters.network.http_connection_manager.v3.HttpFilter.name>`.
         See :ref:`Http filter route specific config <arch_overview_http_filters_per_filter_config>`
         for details.
         [#comment: An entry's value may be wrapped in a
         :ref:`FilterConfig<envoy_v3_api_msg_config.route.v3.FilterConfig>`
         message to specify additional options.]
         
        map<string, .google.protobuf.Any> typed_per_filter_config = 13;
      • getTypedPerFilterConfigOrThrow

        com.google.protobuf.Any getTypedPerFilterConfigOrThrow​(java.lang.String key)
         This field can be used to provide route specific per filter config. The key should match the
         :ref:`filter config name
         <envoy_v3_api_field_extensions.filters.network.http_connection_manager.v3.HttpFilter.name>`.
         See :ref:`Http filter route specific config <arch_overview_http_filters_per_filter_config>`
         for details.
         [#comment: An entry's value may be wrapped in a
         :ref:`FilterConfig<envoy_v3_api_msg_config.route.v3.FilterConfig>`
         message to specify additional options.]
         
        map<string, .google.protobuf.Any> typed_per_filter_config = 13;
      • getRequestHeadersToAddList

        java.util.List<HeaderValueOption> getRequestHeadersToAddList()
         Specifies a set of headers that will be added to requests matching this
         route. Headers specified at this level are applied before headers from the
         enclosing :ref:`envoy_v3_api_msg_config.route.v3.VirtualHost` and
         :ref:`envoy_v3_api_msg_config.route.v3.RouteConfiguration`. For more information, including details on
         header value syntax, see the documentation on :ref:`custom request headers
         <config_http_conn_man_headers_custom_request_headers>`.
         
        repeated .envoy.config.core.v3.HeaderValueOption request_headers_to_add = 9 [(.validate.rules) = { ... }
      • getRequestHeadersToAdd

        HeaderValueOption getRequestHeadersToAdd​(int index)
         Specifies a set of headers that will be added to requests matching this
         route. Headers specified at this level are applied before headers from the
         enclosing :ref:`envoy_v3_api_msg_config.route.v3.VirtualHost` and
         :ref:`envoy_v3_api_msg_config.route.v3.RouteConfiguration`. For more information, including details on
         header value syntax, see the documentation on :ref:`custom request headers
         <config_http_conn_man_headers_custom_request_headers>`.
         
        repeated .envoy.config.core.v3.HeaderValueOption request_headers_to_add = 9 [(.validate.rules) = { ... }
      • getRequestHeadersToAddCount

        int getRequestHeadersToAddCount()
         Specifies a set of headers that will be added to requests matching this
         route. Headers specified at this level are applied before headers from the
         enclosing :ref:`envoy_v3_api_msg_config.route.v3.VirtualHost` and
         :ref:`envoy_v3_api_msg_config.route.v3.RouteConfiguration`. For more information, including details on
         header value syntax, see the documentation on :ref:`custom request headers
         <config_http_conn_man_headers_custom_request_headers>`.
         
        repeated .envoy.config.core.v3.HeaderValueOption request_headers_to_add = 9 [(.validate.rules) = { ... }
      • getRequestHeadersToAddOrBuilderList

        java.util.List<? extends HeaderValueOptionOrBuilder> getRequestHeadersToAddOrBuilderList()
         Specifies a set of headers that will be added to requests matching this
         route. Headers specified at this level are applied before headers from the
         enclosing :ref:`envoy_v3_api_msg_config.route.v3.VirtualHost` and
         :ref:`envoy_v3_api_msg_config.route.v3.RouteConfiguration`. For more information, including details on
         header value syntax, see the documentation on :ref:`custom request headers
         <config_http_conn_man_headers_custom_request_headers>`.
         
        repeated .envoy.config.core.v3.HeaderValueOption request_headers_to_add = 9 [(.validate.rules) = { ... }
      • getRequestHeadersToAddOrBuilder

        HeaderValueOptionOrBuilder getRequestHeadersToAddOrBuilder​(int index)
         Specifies a set of headers that will be added to requests matching this
         route. Headers specified at this level are applied before headers from the
         enclosing :ref:`envoy_v3_api_msg_config.route.v3.VirtualHost` and
         :ref:`envoy_v3_api_msg_config.route.v3.RouteConfiguration`. For more information, including details on
         header value syntax, see the documentation on :ref:`custom request headers
         <config_http_conn_man_headers_custom_request_headers>`.
         
        repeated .envoy.config.core.v3.HeaderValueOption request_headers_to_add = 9 [(.validate.rules) = { ... }
      • getRequestHeadersToRemoveList

        java.util.List<java.lang.String> getRequestHeadersToRemoveList()
         Specifies a list of HTTP headers that should be removed from each request
         matching this route.
         
        repeated string request_headers_to_remove = 12 [(.validate.rules) = { ... }
        Returns:
        A list containing the requestHeadersToRemove.
      • getRequestHeadersToRemoveCount

        int getRequestHeadersToRemoveCount()
         Specifies a list of HTTP headers that should be removed from each request
         matching this route.
         
        repeated string request_headers_to_remove = 12 [(.validate.rules) = { ... }
        Returns:
        The count of requestHeadersToRemove.
      • getRequestHeadersToRemove

        java.lang.String getRequestHeadersToRemove​(int index)
         Specifies a list of HTTP headers that should be removed from each request
         matching this route.
         
        repeated string request_headers_to_remove = 12 [(.validate.rules) = { ... }
        Parameters:
        index - The index of the element to return.
        Returns:
        The requestHeadersToRemove at the given index.
      • getRequestHeadersToRemoveBytes

        com.google.protobuf.ByteString getRequestHeadersToRemoveBytes​(int index)
         Specifies a list of HTTP headers that should be removed from each request
         matching this route.
         
        repeated string request_headers_to_remove = 12 [(.validate.rules) = { ... }
        Parameters:
        index - The index of the value to return.
        Returns:
        The bytes of the requestHeadersToRemove at the given index.
      • getResponseHeadersToAddList

        java.util.List<HeaderValueOption> getResponseHeadersToAddList()
         Specifies a set of headers that will be added to responses to requests
         matching this route. Headers specified at this level are applied before
         headers from the enclosing :ref:`envoy_v3_api_msg_config.route.v3.VirtualHost` and
         :ref:`envoy_v3_api_msg_config.route.v3.RouteConfiguration`. For more information, including
         details on header value syntax, see the documentation on
         :ref:`custom request headers <config_http_conn_man_headers_custom_request_headers>`.
         
        repeated .envoy.config.core.v3.HeaderValueOption response_headers_to_add = 10 [(.validate.rules) = { ... }
      • getResponseHeadersToAdd

        HeaderValueOption getResponseHeadersToAdd​(int index)
         Specifies a set of headers that will be added to responses to requests
         matching this route. Headers specified at this level are applied before
         headers from the enclosing :ref:`envoy_v3_api_msg_config.route.v3.VirtualHost` and
         :ref:`envoy_v3_api_msg_config.route.v3.RouteConfiguration`. For more information, including
         details on header value syntax, see the documentation on
         :ref:`custom request headers <config_http_conn_man_headers_custom_request_headers>`.
         
        repeated .envoy.config.core.v3.HeaderValueOption response_headers_to_add = 10 [(.validate.rules) = { ... }
      • getResponseHeadersToAddCount

        int getResponseHeadersToAddCount()
         Specifies a set of headers that will be added to responses to requests
         matching this route. Headers specified at this level are applied before
         headers from the enclosing :ref:`envoy_v3_api_msg_config.route.v3.VirtualHost` and
         :ref:`envoy_v3_api_msg_config.route.v3.RouteConfiguration`. For more information, including
         details on header value syntax, see the documentation on
         :ref:`custom request headers <config_http_conn_man_headers_custom_request_headers>`.
         
        repeated .envoy.config.core.v3.HeaderValueOption response_headers_to_add = 10 [(.validate.rules) = { ... }
      • getResponseHeadersToAddOrBuilderList

        java.util.List<? extends HeaderValueOptionOrBuilder> getResponseHeadersToAddOrBuilderList()
         Specifies a set of headers that will be added to responses to requests
         matching this route. Headers specified at this level are applied before
         headers from the enclosing :ref:`envoy_v3_api_msg_config.route.v3.VirtualHost` and
         :ref:`envoy_v3_api_msg_config.route.v3.RouteConfiguration`. For more information, including
         details on header value syntax, see the documentation on
         :ref:`custom request headers <config_http_conn_man_headers_custom_request_headers>`.
         
        repeated .envoy.config.core.v3.HeaderValueOption response_headers_to_add = 10 [(.validate.rules) = { ... }
      • getResponseHeadersToAddOrBuilder

        HeaderValueOptionOrBuilder getResponseHeadersToAddOrBuilder​(int index)
         Specifies a set of headers that will be added to responses to requests
         matching this route. Headers specified at this level are applied before
         headers from the enclosing :ref:`envoy_v3_api_msg_config.route.v3.VirtualHost` and
         :ref:`envoy_v3_api_msg_config.route.v3.RouteConfiguration`. For more information, including
         details on header value syntax, see the documentation on
         :ref:`custom request headers <config_http_conn_man_headers_custom_request_headers>`.
         
        repeated .envoy.config.core.v3.HeaderValueOption response_headers_to_add = 10 [(.validate.rules) = { ... }
      • getResponseHeadersToRemoveList

        java.util.List<java.lang.String> getResponseHeadersToRemoveList()
         Specifies a list of HTTP headers that should be removed from each response
         to requests matching this route.
         
        repeated string response_headers_to_remove = 11 [(.validate.rules) = { ... }
        Returns:
        A list containing the responseHeadersToRemove.
      • getResponseHeadersToRemoveCount

        int getResponseHeadersToRemoveCount()
         Specifies a list of HTTP headers that should be removed from each response
         to requests matching this route.
         
        repeated string response_headers_to_remove = 11 [(.validate.rules) = { ... }
        Returns:
        The count of responseHeadersToRemove.
      • getResponseHeadersToRemove

        java.lang.String getResponseHeadersToRemove​(int index)
         Specifies a list of HTTP headers that should be removed from each response
         to requests matching this route.
         
        repeated string response_headers_to_remove = 11 [(.validate.rules) = { ... }
        Parameters:
        index - The index of the element to return.
        Returns:
        The responseHeadersToRemove at the given index.
      • getResponseHeadersToRemoveBytes

        com.google.protobuf.ByteString getResponseHeadersToRemoveBytes​(int index)
         Specifies a list of HTTP headers that should be removed from each response
         to requests matching this route.
         
        repeated string response_headers_to_remove = 11 [(.validate.rules) = { ... }
        Parameters:
        index - The index of the value to return.
        Returns:
        The bytes of the responseHeadersToRemove at the given index.
      • hasTracing

        boolean hasTracing()
         Presence of the object defines whether the connection manager's tracing configuration
         is overridden by this route specific instance.
         
        .envoy.config.route.v3.Tracing tracing = 15;
        Returns:
        Whether the tracing field is set.
      • getTracing

        Tracing getTracing()
         Presence of the object defines whether the connection manager's tracing configuration
         is overridden by this route specific instance.
         
        .envoy.config.route.v3.Tracing tracing = 15;
        Returns:
        The tracing.
      • getTracingOrBuilder

        TracingOrBuilder getTracingOrBuilder()
         Presence of the object defines whether the connection manager's tracing configuration
         is overridden by this route specific instance.
         
        .envoy.config.route.v3.Tracing tracing = 15;
      • hasPerRequestBufferLimitBytes

        boolean hasPerRequestBufferLimitBytes()
         The maximum bytes which will be buffered for retries and shadowing.
         If set, the bytes actually buffered will be the minimum value of this and the
         listener per_connection_buffer_limit_bytes.
         
        .google.protobuf.UInt32Value per_request_buffer_limit_bytes = 16;
        Returns:
        Whether the perRequestBufferLimitBytes field is set.
      • getPerRequestBufferLimitBytes

        com.google.protobuf.UInt32Value getPerRequestBufferLimitBytes()
         The maximum bytes which will be buffered for retries and shadowing.
         If set, the bytes actually buffered will be the minimum value of this and the
         listener per_connection_buffer_limit_bytes.
         
        .google.protobuf.UInt32Value per_request_buffer_limit_bytes = 16;
        Returns:
        The perRequestBufferLimitBytes.
      • getPerRequestBufferLimitBytesOrBuilder

        com.google.protobuf.UInt32ValueOrBuilder getPerRequestBufferLimitBytesOrBuilder()
         The maximum bytes which will be buffered for retries and shadowing.
         If set, the bytes actually buffered will be the minimum value of this and the
         listener per_connection_buffer_limit_bytes.
         
        .google.protobuf.UInt32Value per_request_buffer_limit_bytes = 16;
      • getStatPrefix

        java.lang.String getStatPrefix()
         The human readable prefix to use when emitting statistics for this endpoint.
         The statistics are rooted at vhost.<virtual host name>.route.<stat_prefix>.
         This should be set for highly critical
         endpoints that one wishes to get “per-route” statistics on.
         If not set, endpoint statistics are not generated.
        
         The emitted statistics are the same as those documented for :ref:`virtual clusters <config_http_filters_router_vcluster_stats>`.
        
         .. warning::
        
         We do not recommend setting up a stat prefix for
         every application endpoint. This is both not easily maintainable and
         statistics use a non-trivial amount of memory(approximately 1KiB per route).
         
        string stat_prefix = 19;
        Returns:
        The statPrefix.
      • getStatPrefixBytes

        com.google.protobuf.ByteString getStatPrefixBytes()
         The human readable prefix to use when emitting statistics for this endpoint.
         The statistics are rooted at vhost.<virtual host name>.route.<stat_prefix>.
         This should be set for highly critical
         endpoints that one wishes to get “per-route” statistics on.
         If not set, endpoint statistics are not generated.
        
         The emitted statistics are the same as those documented for :ref:`virtual clusters <config_http_filters_router_vcluster_stats>`.
        
         .. warning::
        
         We do not recommend setting up a stat prefix for
         every application endpoint. This is both not easily maintainable and
         statistics use a non-trivial amount of memory(approximately 1KiB per route).
         
        string stat_prefix = 19;
        Returns:
        The bytes for statPrefix.