[ https://issues.apache.org/jira/browse/PROTON-26?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13468498#comment-13468498 ]
Rafael H. Schloming commented on PROTON-26: ------------------------------------------- The reason the transport uses input/output rather than read/write is because read/write would have exactly the opposite of the usual semantics with respect to its arguments. A "read" operation typically populates the passed in array with data, whereas the "input" operation is actually providing input in the passed in array that is consumed by the transport. Likewise a "write" operation usually consumes/copies bytes from the passed in array whereas the "output" operation is actually filling the passed in array with output from the transport. Reversing the names (input -> write, output -> read) to make the semantics similar with respect to the arguments would also be confusing as you'd be calling Transport.read in order to produce output to write to the network. As it is now it's pretty easy to remember that you read from the network to provide input to the transport and when the transport supplies output, you write to the network. > Engine api naming proposal > -------------------------- > > Key: PROTON-26 > URL: https://issues.apache.org/jira/browse/PROTON-26 > Project: Qpid Proton > Issue Type: Improvement > Components: proton-c > Reporter: Justin Ross > Attachments: engine-naming-01.patch, > proton-engine-naming-proposal-2.pdf > > > See > https://docs.google.com/spreadsheet/ccc?key=0ArGmVtK1EBOMdEw0bkp4OE5UOWpRRkx3RzVoTjliX0E#gid=0 -- This message is automatically generated by JIRA. If you think it was sent incorrectly, please contact your JIRA administrators For more information on JIRA, see: http://www.atlassian.com/software/jira