Struct Txn

Source

pub struct Txn<'lua> {
    pub c: Converters<'lua>,
    pub f: Fetches<'lua>,
    /* private fields */
}

Expand description

The txn class contain all the functions relative to the http or tcp transaction.

Fields§

§c: Converters<'lua>§f: Fetches<'lua>

Implementations§

Source §

impl<'lua> Txn<'lua>

Source

pub fn http(&self) -> Result<Http<'lua>>

Returns an HTTP class object.

Source

pub fn http_req(&self) -> Result<HttpMessage<'lua>>

Returns the request HTTPMessage object.

Source

pub fn http_res(&self) -> Result<HttpMessage<'lua>>

Returns the response HTTPMessage object.

Source

pub fn log(&self, level: LogLevel, msg: impl AsRef<str>) -> Result<()>

Sends a log on the default syslog server if it is configured and on the stderr if it is allowed.

Source

pub fn deflog<S>(&self, msg: &S) -> Result<()>
where S: AsRef<str> + ?Sized,

Sends a log line with the default loglevel for the proxy associated with the transaction.

Source

pub fn get_priv<R: FromLua<'lua>>(&self) -> Result<R>

Returns data stored in the current transaction (with the set_priv()) function.

Source

pub fn set_priv<A: IntoLua<'lua>>(&self, val: A) -> Result<()>

Stores any data in the current HAProxy transaction. This action replaces the old stored data.

Source

pub fn get_var<R: FromLua<'lua>>(&self, name: &str) -> Result<R>

Returns data stored in the variable name.

Source

pub fn set_var<A: IntoLua<'lua>>(&self, name: &str, val: A) -> Result<()>

Store variable name in an HAProxy converting the type.

Source

pub fn set_var_if_exists<A: IntoLua<'lua>>( &self, name: &str, val: A, ) -> Result<()>

Store variable name in an HAProxy if the variable already exists.

Source

pub fn unset_var(&self, name: &str) -> Result<()>

Unsets the variable name.

Source

pub fn set_loglevel(&self, level: LogLevel) -> Result<()>

Changes the log level of the current request. The level must be an integer between 0 and 7.

Methods from Deref<Target = Table<'lua>>§

Source

pub fn set<K, V>(&self, key: K, value: V) -> Result<(), Error>
where K: IntoLua<'lua>, V: IntoLua<'lua>,

Sets a key-value pair in the table.

If the value is nil, this will effectively remove the pair.

This might invoke the __newindex metamethod. Use the raw_set method if that is not desired.

§Examples

Export a value as a global to make it usable from Lua:

let globals = lua.globals();

globals.set("assertions", cfg!(debug_assertions))?;

lua.load(r#"
    if assertions == true then
        -- ...
    elseif assertions == false then
        -- ...
    else
        error("assertions neither on nor off?")
    end
"#).exec()?;

Source

pub fn get<K, V>(&self, key: K) -> Result<V, Error>
where K: IntoLua<'lua>, V: FromLua<'lua>,

Gets the value associated to key from the table.

If no value is associated to key, returns the nil value.

This might invoke the __index metamethod. Use the raw_get method if that is not desired.

§Examples

Query the version of the Lua interpreter:

let globals = lua.globals();

let version: String = globals.get("_VERSION")?;
println!("Lua version: {}", version);

Source

pub fn contains_key<K>(&self, key: K) -> Result<bool, Error>
where K: IntoLua<'lua>,

Checks whether the table contains a non-nil value for key.

This might invoke the __index metamethod.

Source

pub fn push<V>(&self, value: V) -> Result<(), Error>
where V: IntoLua<'lua>,

Appends a value to the back of the table.

This might invoke the __len and __newindex metamethods.

Source

pub fn pop<V>(&self) -> Result<V, Error>
where V: FromLua<'lua>,

Removes the last element from the table and returns it.

This might invoke the __len and __newindex metamethods.

Source

pub fn equals<T>(&self, other: T) -> Result<bool, Error>
where T: AsRef<Table<'lua>>,

Compares two tables for equality.

Tables are compared by reference first. If they are not primitively equals, then mlua will try to invoke the __eq metamethod. mlua will check self first for the metamethod, then other if not found.

§Examples

Compare two tables using __eq metamethod:

let table1 = lua.create_table()?;
table1.set(1, "value")?;

let table2 = lua.create_table()?;
table2.set(2, "value")?;

let always_equals_mt = lua.create_table()?;
always_equals_mt.set("__eq", lua.create_function(|_, (_t1, _t2): (Table, Table)| Ok(true))?)?;
table2.set_metatable(Some(always_equals_mt));

assert!(table1.equals(&table1.clone())?);
assert!(table1.equals(&table2)?);

Source

pub fn raw_set<K, V>(&self, key: K, value: V) -> Result<(), Error>
where K: IntoLua<'lua>, V: IntoLua<'lua>,

Sets a key-value pair without invoking metamethods.

Source

pub fn raw_get<K, V>(&self, key: K) -> Result<V, Error>
where K: IntoLua<'lua>, V: FromLua<'lua>,

Gets the value associated to key without invoking metamethods.

Source

pub fn raw_insert<V>(&self, idx: i64, value: V) -> Result<(), Error>
where V: IntoLua<'lua>,

Inserts element value at position idx to the table, shifting up the elements from table[idx]. The worst case complexity is O(n), where n is the table length.

Source

pub fn raw_push<V>(&self, value: V) -> Result<(), Error>
where V: IntoLua<'lua>,

Appends a value to the back of the table without invoking metamethods.

Source

pub fn raw_pop<V>(&self) -> Result<V, Error>
where V: FromLua<'lua>,

Removes the last element from the table and returns it, without invoking metamethods.

Source

pub fn raw_remove<K>(&self, key: K) -> Result<(), Error>
where K: IntoLua<'lua>,

Removes a key from the table.

If key is an integer, mlua shifts down the elements from table[key+1], and erases element table[key]. The complexity is O(n) in the worst case, where n is the table length.

For other key types this is equivalent to setting table[key] = nil.

Source