Struct thrift::protocol::TMultiplexedOutputProtocol

pub struct TMultiplexedOutputProtocol<P> where
    P: TOutputProtocol,  { /* 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 thrift::protocol::{TMessageIdentifier, TMessageType, TOutputProtocol};
use thrift::protocol::{TBinaryOutputProtocol, TMultiplexedOutputProtocol};
use thrift::transport::TTcpChannel;

let mut channel = TTcpChannel::new();
channel.open("localhost:9090").unwrap();

let protocol = TBinaryOutputProtocol::new(channel, true);
let mut protocol = TMultiplexedOutputProtocol::new("service_name", protocol);

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

Methods

impl<P> TMultiplexedOutputProtocol<P> where
    P: TOutputProtocol, 

pub fn new(service_name: &str, wrapped: P) -> TMultiplexedOutputProtocol<P>

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<P> TOutputProtocol for TMultiplexedOutputProtocol<P> where
    P: TOutputProtocol, 

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.

impl<P: Debug> Debug for TMultiplexedOutputProtocol<P> where
    P: TOutputProtocol, 

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

Formats the value using the given formatter.