Struct LocationConf

pub struct LocationConf {

    pub upstream: Option<String>,
    pub path: Option<String>,
    pub host: Option<String>,
    pub proxy_set_headers: Option<Vec<String>>,
    pub proxy_add_headers: Option<Vec<String>>,
    pub rewrite: Option<String>,
    pub weight: Option<u16>,
    pub plugins: Option<Vec<String>>,
    pub client_max_body_size: Option<ByteSize>,
    pub max_processing: Option<i32>,
    pub includes: Option<Vec<String>>,
    pub grpc_web: Option<bool>,
    pub enable_reverse_proxy_headers: Option<bool>,
    pub remark: Option<String>,
}

Configuration for a location/route that handles incoming requests

Fields

upstream: Option<String>

Name of the upstream service to proxy requests to

path: Option<String>

URL path pattern to match requests against Can start with:

• “=” for exact match
• “~” for regex match
• No prefix for prefix match

host: Option<String>

Host/domain name to match requests against

proxy_set_headers: Option<Vec<String>>

Headers to set on proxied requests (overwrites existing)

proxy_add_headers: Option<Vec<String>>

Headers to add to proxied requests (appends to existing)

rewrite: Option<String>

URL rewrite rule in format “pattern replacement”

weight: Option<u16>

Manual weight for location matching priority Higher weight = higher priority

plugins: Option<Vec<String>>

List of plugins to apply to requests matching this location

client_max_body_size: Option<ByteSize>

Maximum allowed size of request body

max_processing: Option<i32>

Maximum number of concurrent requests being processed

includes: Option<Vec<String>>

List of included configuration files

grpc_web: Option<bool>

Whether to enable gRPC-Web protocol support

enable_reverse_proxy_headers: Option<bool>

Whether to enable reverse proxy headers

remark: Option<String>

Optional description/notes about this location

Implementations

impl LocationConf

pub fn hash_key(&self) -> String

Generates a unique hash key for this location configuration Used for caching and comparison purposes

pub fn get_weight(&self) -> u16

Calculates the matching priority weight for this location Higher weight = higher priority Weight is based on:

• Path match type (exact=1024, prefix=512, regex=256)
• Path length (up to 64)
• Host presence (+128)

Returns either the manual weight if set, or calculated weight

Trait Implementations

impl Clone for LocationConf

fn clone(&self) -> LocationConf

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for LocationConf

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for LocationConf

fn default() -> LocationConf

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for LocationConf

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Hash for LocationConf

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Serialize for LocationConf

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.