Struct thrift::protocol::TMultiplexedOutputProtocol

pub struct TMultiplexedOutputProtocol { /* fields omitted */ }

TOutputProtocol that prefixes the service name to all outgoing Thrift messages.

A TMultiplexedOutputProtocol should be used when multiple Thrift services send messages over a single I/O channel. By prefixing service identifiers to outgoing messages receivers are able to demux them and route them to the appropriate service processor. Rust receivers must use a TMultiplexedProcessor to process incoming messages, while other languages must use their corresponding multiplexed processor implementations.

For example, given a service TestService and a service call test_call, this implementation would identify messages as originating from TestService:test_call.

Examples

Create and use a TMultiplexedOutputProtocol.

use std::cell::RefCell;
use std::rc::Rc;
use thrift::protocol::{TMessageIdentifier, TMessageType, TOutputProtocol};
use thrift::protocol::{TBinaryOutputProtocol, TMultiplexedOutputProtocol};
use thrift::transport::{TTcpTransport, TTransport};

let mut transport = TTcpTransport::new();
transport.open("localhost:9090").unwrap();
let transport = Rc::new(RefCell::new(Box::new(transport) as Box<TTransport>));

let o_prot = TBinaryOutputProtocol::new(transport, true);
let mut o_prot = TMultiplexedOutputProtocol::new("service_name", Box::new(o_prot));

let ident = TMessageIdentifier::new("svc_call", TMessageType::Call, 1);
o_prot.write_message_begin(&ident).unwrap();

Methods

impl TMultiplexedOutputProtocol

fn new(service_name: &str,
       wrapped: Box<TOutputProtocol>)
       -> TMultiplexedOutputProtocol

Create a TMultiplexedOutputProtocol that identifies outgoing messages as originating from a service named service_name and sends them over the wrapped TOutputProtocol. Outgoing messages are encoded and sent by wrapped, not by this instance.

Trait Implementations

impl TOutputProtocol for TMultiplexedOutputProtocol

fn write_message_begin(&mut self, identifier: &TMessageIdentifier) -> Result<()>

Write the beginning of a Thrift message.

fn write_message_end(&mut self) -> Result<()>

Write the end of a Thrift message.

fn write_struct_begin(&mut self, identifier: &TStructIdentifier) -> Result<()>

Write the beginning of a Thrift struct.

fn write_struct_end(&mut self) -> Result<()>

Write the end of a Thrift struct.

fn write_field_begin(&mut self, identifier: &TFieldIdentifier) -> Result<()>

Write the beginning of a Thrift field.

fn write_field_end(&mut self) -> Result<()>

Write the end of a Thrift field.

fn write_field_stop(&mut self) -> Result<()>

Write a STOP field indicating that all the fields in a struct have been written.

fn write_bytes(&mut self, b: &[u8]) -> Result<()>

Write a fixed-length byte array.

fn write_bool(&mut self, b: bool) -> Result<()>

Write a bool.

fn write_i8(&mut self, i: i8) -> Result<()>

Write an 8-bit signed integer.

fn write_i16(&mut self, i: i16) -> Result<()>

Write a 16-bit signed integer.

fn write_i32(&mut self, i: i32) -> Result<()>

Write a 32-bit signed integer.

fn write_i64(&mut self, i: i64) -> Result<()>

Write a 64-bit signed integer.

fn write_double(&mut self, d: f64) -> Result<()>

Write a 64-bit float.

fn write_string(&mut self, s: &str) -> Result<()>

Write a fixed-length string.

fn write_list_begin(&mut self, identifier: &TListIdentifier) -> Result<()>

Write the beginning of a list.

fn write_list_end(&mut self) -> Result<()>

Write the end of a list.

fn write_set_begin(&mut self, identifier: &TSetIdentifier) -> Result<()>

Write the beginning of a set.

fn write_set_end(&mut self) -> Result<()>

Write the end of a set.

fn write_map_begin(&mut self, identifier: &TMapIdentifier) -> Result<()>

Write the beginning of a map.

fn write_map_end(&mut self) -> Result<()>

Write the end of a map.

fn flush(&mut self) -> Result<()>

Flush buffered bytes to the underlying transport.

fn write_byte(&mut self, b: u8) -> Result<()>

Write an unsigned byte.