Rename connection to listener or similar

[geek]

Instead of server.connection() can we rename it to server.listener() or server.connectionListener()? Since its not creating a real connection to anything and is more about setting up a listener I think its more specific to rename it.

[ggoodman]

Perhaps a method name prefixed by define would be appropriate to avoid misleading users into thinking that calling server.connection() will actually result in their server actively listening.

Perhaps a note should be added at the bottom of the server.connection() docs section clarifying the two-phase approach for defining then starting connections / listeners.

[AdriVanHoudt]

Since server.connection() has a property listener (http://hapijs.com/api#serverconnectionoptions) it would be weird to call it listener()

[nvcexploder]

Does each server.connection represent an http server? They all have their own routing table and request lifecycle. If so I'm not sure that either is the appropriate name.

[nlf]

yeah.. this is an awkward one.. i feel like @hueniverse had mentioned using realm as terminology somewhere, maybe that's appropriate here?

[ggoodman]

Just throwing a new term out there for brainstorming: responder.

On Fri Nov 21 2014 at 3:54:23 PM Nathan LaFreniere notifications@github.com
wrote:

yeah.. this is an awkward one.. i feel like @hueniverse
https://github.com/hueniverse had mentioned using realm as terminology
somewhere, maybe that's appropriate here?

—
Reply to this email directly or view it on GitHub
#2192 (comment).

[nvcexploder]

@geek made a good comment a bit ago, what about origin, speaking specifically of: http://tools.ietf.org/html/rfc6454

tl; dr: "Roughly speaking, two URIs are part of the same
origin (i.e., represent the same principal) if they have the same
scheme, host, and port." -@geek

[nlf]

that's not bad at all, i like origin and bonus points for having a fitting definition

[geek]

server.origin()
server.origins

[nvcexploder]

That's all @geek - the TLDR is a direct quote from him.

[nvcexploder]

The quote was totally @geek's (edit to add quotations)

[geek]

@nvcexploder that was lifted from the rfc: http://tools.ietf.org/html/rfc6454#section-3.2

[nvcexploder]

SHSHSHHHHHHHhhhhhhh.

[hueniverse]

I don't like origin. It's weird.

Connections make sense to me. I am going to stick with it for now. If someone comes up with a better name, we can add it as alias and keep it compatible.