Slashdot Mirror

← Back to Stories (view on slashdot.org)

Naming Bi-Directional Streams In an API?

Posted by timothy on from the will-never-forget-what-me-old-dad-used-to-say dept.

DingoTango writes "My coworker and I are designing an infrastructure API to manage data streams. It will allow a client developer to set up streams going to and from some invoked server functionality, and allow a server developer to write services that both consume and produce streaming data. Our quite civil disagreement involves naming: From the perspective of the client platform, the client's output stream goes to the server, and input stream comes from it. For the purpose of any ensuing discussion, let's call this the 'Local' perspective. However, if the client developer considers the service to be a widget, then the stream going to the service is the input stream and the stream coming from it is the output. Let's call this the 'Widget' perspective. As this is an infrastructure utility, we aren't able to name the streams according to function. What say ye, Slashdot? Is there any precedence, experience, or ungrounded yet vociferous opinion that will resolve this for us?"

6 of 61 comments (clear)

  1. server-client by Anonymous Coward · · Score: 3, Insightful

    Why not call them the "client to server" stream and the "server to client" stream?

  2. UploadStream and DownloadStream? by snikulin · · Score: 3, Interesting

    UploadStream: data goes to a server.
    DownloadStream: data goes from the server.

  3. socket syntax by chaostaco · · Score: 3, Insightful

    The syntax from socket programming, like send, receive, and listen, seems well suited for situations where both sides can act as clients or servers. Both sides would use the same syntax, each naming things from its own perspective.

  4. Excuse me sir, this is a news site... by NevarMore · · Score: 3, Informative

    ...I think you want StackOverflow which is a few clicks that way ------>

    1. Re:Excuse me sir, this is a news site... by subreality · · Score: 3, Insightful

      Not really. Ask Slashdot has always had a little niche for this.

      It's a fun question, too. I'd suggest naming them directions that don't correspond to client-server relationships in such an obvious way. So, instead of Up and Down, go for North and South, whichever way feels more appropriate to the situation. In and Out might be a good pair, depending what you want to visualize.

      How about Hitherwise and Yonderborne?

  5. car and cdr, obviously by decora · · Score: 3, Insightful

    although "eat me" "drink me" is a close second