use std::str; use std::io::{IoResult, MemWriter, MemReader}; use std::mem; use std::vec; use types::Oid; pub static PROTOCOL_VERSION: i32 = 0x0003_0000; pub static CANCEL_CODE: i32 = 80877102; pub static SSL_CODE: i32 = 80877103; pub enum BackendMessage { AuthenticationOk, AuthenticationKerberosV5, AuthenticationCleartextPassword, AuthenticationMD5Password { salt: ~[u8] }, AuthenticationSCMCredential, AuthenticationGSS, AuthenticationSSPI, BackendKeyData { process_id: i32, secret_key: i32 }, BindComplete, CloseComplete, CommandComplete { tag: ~str }, DataRow { row: ~[Option<~[u8]>] }, EmptyQueryResponse, ErrorResponse { fields: ~[(u8, ~str)] }, NoData, NoticeResponse { fields: ~[(u8, ~str)] }, NotificationResponse { pid: i32, channel: ~str, payload: ~str }, ParameterDescription { types: ~[Oid] }, ParameterStatus { parameter: ~str, value: ~str }, ParseComplete, PortalSuspended, ReadyForQuery { state: u8 }, RowDescription { descriptions: ~[RowDescriptionEntry] } } pub struct RowDescriptionEntry { name: ~str, table_oid: Oid, column_id: i16, type_oid: Oid, type_size: i16, type_modifier: i32, format: i16 } pub enum FrontendMessage<'a> { Bind { portal: &'a str, statement: &'a str, formats: &'a [i16], values: &'a [Option<~[u8]>], result_formats: &'a [i16] }, CancelRequest { code: i32, process_id: i32, secret_key: i32, }, Close { variant: u8, name: &'a str }, Describe { variant: u8, name: &'a str }, Execute { portal: &'a str, max_rows: i32 }, Parse { name: &'a str, query: &'a str, param_types: &'a [i32] }, PasswordMessage { password: &'a str }, Query { query: &'a str }, StartupMessage { version: i32, parameters: &'a [(~str, ~str)] }, SslRequest { code: i32 }, Sync, Terminate } #[doc(hidden)] trait WriteCStr { fn write_cstr(&mut self, s: &str) -> IoResult<()>; } impl WriteCStr for W { fn write_cstr(&mut self, s: &str) -> IoResult<()> { if_ok!(self.write(s.as_bytes())); self.write_u8(0) } } #[doc(hidden)] pub trait WriteMessage { fn write_message(&mut self, &FrontendMessage) -> IoResult<()> ; } impl WriteMessage for W { fn write_message(&mut self, message: &FrontendMessage) -> IoResult<()> { debug!("Writing message {:?}", message); let mut buf = MemWriter::new(); let mut ident = None; match *message { Bind { portal, statement, formats, values, result_formats } => { ident = Some('B'); if_ok!(buf.write_cstr(portal)); if_ok!(buf.write_cstr(statement)); if_ok!(buf.write_be_i16(formats.len() as i16)); for format in formats.iter() { if_ok!(buf.write_be_i16(*format)); } if_ok!(buf.write_be_i16(values.len() as i16)); for value in values.iter() { match *value { None => { if_ok!(buf.write_be_i32(-1)); } Some(ref value) => { if_ok!(buf.write_be_i32(value.len() as i32)); if_ok!(buf.write(*value)); } } } if_ok!(buf.write_be_i16(result_formats.len() as i16)); for format in result_formats.iter() { if_ok!(buf.write_be_i16(*format)); } } CancelRequest { code, process_id, secret_key } => { if_ok!(buf.write_be_i32(code)); if_ok!(buf.write_be_i32(process_id)); if_ok!(buf.write_be_i32(secret_key)); } Close { variant, name } => { ident = Some('C'); if_ok!(buf.write_u8(variant)); if_ok!(buf.write_cstr(name)); } Describe { variant, name } => { ident = Some('D'); if_ok!(buf.write_u8(variant)); if_ok!(buf.write_cstr(name)); } Execute { portal, max_rows } => { ident = Some('E'); if_ok!(buf.write_cstr(portal)); if_ok!(buf.write_be_i32(max_rows)); } Parse { name, query, param_types } => { ident = Some('P'); if_ok!(buf.write_cstr(name)); if_ok!(buf.write_cstr(query)); if_ok!(buf.write_be_i16(param_types.len() as i16)); for ty in param_types.iter() { if_ok!(buf.write_be_i32(*ty)); } } PasswordMessage { password } => { ident = Some('p'); if_ok!(buf.write_cstr(password)); } Query { query } => { ident = Some('Q'); if_ok!(buf.write_cstr(query)); } StartupMessage { version, parameters } => { if_ok!(buf.write_be_i32(version)); for &(ref k, ref v) in parameters.iter() { if_ok!(buf.write_cstr(k.as_slice())); if_ok!(buf.write_cstr(v.as_slice())); } if_ok!(buf.write_u8(0)); } SslRequest { code } => if_ok!(buf.write_be_i32(code)), Sync => { ident = Some('S'); } Terminate => { ident = Some('X'); } } match ident { Some(ident) => if_ok!(self.write_u8(ident as u8)), None => () } let buf = buf.unwrap(); // add size of length value if_ok!(self.write_be_i32((buf.len() + mem::size_of::()) as i32)); if_ok!(self.write(buf)); Ok(()) } } #[doc(hidden)] trait ReadCStr { fn read_cstr(&mut self) -> IoResult<~str>; } impl ReadCStr for R { fn read_cstr(&mut self) -> IoResult<~str> { let mut buf = if_ok!(self.read_until(0)); buf.pop(); Ok(str::from_utf8_owned(buf).unwrap()) } } #[doc(hidden)] pub trait ReadMessage { fn read_message(&mut self) -> IoResult; } impl ReadMessage for R { fn read_message(&mut self) -> IoResult { debug!("Reading message"); let ident = if_ok!(self.read_u8()); // subtract size of length value let len = if_ok!(self.read_be_i32()) as uint - mem::size_of::(); let mut buf = MemReader::new(if_ok!(self.read_bytes(len))); let ret = match ident as char { '1' => ParseComplete, '2' => BindComplete, '3' => CloseComplete, 'A' => NotificationResponse { pid: if_ok!(buf.read_be_i32()), channel: if_ok!(buf.read_cstr()), payload: if_ok!(buf.read_cstr()) }, 'C' => CommandComplete { tag: if_ok!(buf.read_cstr()) }, 'D' => if_ok!(read_data_row(&mut buf)), 'E' => ErrorResponse { fields: if_ok!(read_fields(&mut buf)) }, 'I' => EmptyQueryResponse, 'K' => BackendKeyData { process_id: if_ok!(buf.read_be_i32()), secret_key: if_ok!(buf.read_be_i32()) }, 'n' => NoData, 'N' => NoticeResponse { fields: if_ok!(read_fields(&mut buf)) }, 'R' => if_ok!(read_auth_message(&mut buf)), 's' => PortalSuspended, 'S' => ParameterStatus { parameter: if_ok!(buf.read_cstr()), value: if_ok!(buf.read_cstr()) }, 't' => if_ok!(read_parameter_description(&mut buf)), 'T' => if_ok!(read_row_description(&mut buf)), 'Z' => ReadyForQuery { state: if_ok!(buf.read_u8()) }, ident => fail!("Unknown message identifier `{}`", ident) }; debug!("Read message {:?}", ret); Ok(ret) } } fn read_fields(buf: &mut MemReader) -> IoResult<~[(u8, ~str)]> { let mut fields = ~[]; loop { let ty = if_ok!(buf.read_u8()); if ty == 0 { break; } fields.push((ty, if_ok!(buf.read_cstr()))); } Ok(fields) } fn read_data_row(buf: &mut MemReader) -> IoResult { let len = if_ok!(buf.read_be_i16()) as uint; let mut values = vec::with_capacity(len); for _ in range(0, len) { let val = match if_ok!(buf.read_be_i32()) { -1 => None, len => Some(if_ok!(buf.read_bytes(len as uint))) }; values.push(val); } Ok(DataRow { row: values }) } fn read_auth_message(buf: &mut MemReader) -> IoResult { Ok(match if_ok!(buf.read_be_i32()) { 0 => AuthenticationOk, 2 => AuthenticationKerberosV5, 3 => AuthenticationCleartextPassword, 5 => AuthenticationMD5Password { salt: if_ok!(buf.read_bytes(4)) }, 6 => AuthenticationSCMCredential, 7 => AuthenticationGSS, 9 => AuthenticationSSPI, val => fail!("Invalid authentication identifier `{}`", val) }) } fn read_parameter_description(buf: &mut MemReader) -> IoResult { let len = if_ok!(buf.read_be_i16()) as uint; let mut types = vec::with_capacity(len); for _ in range(0, len) { types.push(if_ok!(buf.read_be_u32())); } Ok(ParameterDescription { types: types }) } fn read_row_description(buf: &mut MemReader) -> IoResult { let len = if_ok!(buf.read_be_i16()) as uint; let mut types = vec::with_capacity(len); for _ in range(0, len) { types.push(RowDescriptionEntry { name: if_ok!(buf.read_cstr()), table_oid: if_ok!(buf.read_be_u32()), column_id: if_ok!(buf.read_be_i16()), type_oid: if_ok!(buf.read_be_u32()), type_size: if_ok!(buf.read_be_i16()), type_modifier: if_ok!(buf.read_be_i32()), format: if_ok!(buf.read_be_i16()) }); } Ok(RowDescription { descriptions: types }) }