Howard M. Lewis Ship
2002-12-27 12:32:59 UTC
So, I'm revisiting the documenation and I start wondering ... maybe we should clean up some of the terminology?
Where did "Visit" come from? It actually predates Tapestry; I was on a project and we were killing trees with useless diagrams. I was busy teaching the other developers about servlets and EJBs and we were on a tight schedule. Anyway, I was pushing the idea that we should collect information that would be used by many different parts of the application into a central object, so that we wouldn't constantly have to getAttribute() and downcast. I prefer keeping things strongly typed.
That started a discussion about what that central object would be called. Somehow, we came up with Visit (i.e., it stores the information about the user's visit). The intent with the name was to make it obvious that it was short-term information, discarded when the user's visit to the application ended.
Despite all that, I think calling it something else, say "Globals" (or what? Suggestions welcome) may simplify adoption.
Also, I don't know why I came up with "Gesture". Gesture in UI terms is an all-encompassing term for any kind of input the user can do: keypress, mouse clicks and drags, etc. But that's not really how Gesture is used in Tapestry, since Gesture should be used when recognizing input (something the engine services do).
How about "EncodingOfURLAndRequestParameters"? EncodedServiceRequest? EncodedRequest? RequestEncoding?
----
Howard Lewis Ship
hlship-***@public.gmane.org
http://tapestry.sf.net
Where did "Visit" come from? It actually predates Tapestry; I was on a project and we were killing trees with useless diagrams. I was busy teaching the other developers about servlets and EJBs and we were on a tight schedule. Anyway, I was pushing the idea that we should collect information that would be used by many different parts of the application into a central object, so that we wouldn't constantly have to getAttribute() and downcast. I prefer keeping things strongly typed.
That started a discussion about what that central object would be called. Somehow, we came up with Visit (i.e., it stores the information about the user's visit). The intent with the name was to make it obvious that it was short-term information, discarded when the user's visit to the application ended.
Despite all that, I think calling it something else, say "Globals" (or what? Suggestions welcome) may simplify adoption.
Also, I don't know why I came up with "Gesture". Gesture in UI terms is an all-encompassing term for any kind of input the user can do: keypress, mouse clicks and drags, etc. But that's not really how Gesture is used in Tapestry, since Gesture should be used when recognizing input (something the engine services do).
How about "EncodingOfURLAndRequestParameters"? EncodedServiceRequest? EncodedRequest? RequestEncoding?
----
Howard Lewis Ship
hlship-***@public.gmane.org
http://tapestry.sf.net