RE: [wsrp][wsia][wsrp-wsia joint interfaces][Draft Spec 0.43]Terminology

From
Eilon Reshef <>
Date
2002-05-23T01:58:27+00:00
ID
001c01c201fe$124b4940$6c00a8c0@eilon
Thread
RE: [wsrp][wsia][wsrp-wsia joint interfaces][Draft Spec 0.43]Terminology
Title: Message

A taxonomy question mainly to the WSRP folks (Thomas, Mike, 
...).

 

I think everybody is pretty much on the same page with regards to the 
term "session" which identifies the transient state. (And, as Rich noted, to 
people that come from an OO background, this would be the same as an object 
instance).

 

The tougher one is the persistent key, which in WSRP is 
typically referred to as "instance", but as Rich noted this may be non-intuitive 
to people from an OO background (who think of transient object instances), and 
hence the need for a new term.

 

Would you find the following, radically 
simplified, suggestion for an operation 
name intrusive:

 

createPortlet

 

Along those 
lines, a portal would call the operation createPortlet, would get back a 
(persistent) portletID and then (optionally) 
call createSession with the portletID.

 

Note that using this taxonomy, a portlet is the "last 
persistent instance". So, multiple instances of the same mail portlet are 
multiple portlets.

 

A few justification points:

1. IBM's RPWS proposal used the term createInstance. However, clearly the 
term "instance" is meaningless by itself - an instance is always an instance of 
something, in this case I assume the intent was a shortcut for 
createPortletInstance. Hence, createPorlet conveys a similar 
meaning.

2. The ability to create a persistent key seems to be only under the 
scope of WSRP and not under WSIA. WSIA supports a persistent key to create 
sessions and to subsequent operations, but wouldn't probably deal with how they 
are created and management (with all the associated issues that are well 
described in Mike's latest summary). Hence, the motivation to use a 
portal-specific name.

 

Any thoughts from hard-core portal people?

 

  

  
-----Original Message-----
From: Rich Thompson 
  [mailto:] 
Sent: Wednesday, May 22, 2002 3:26 
  PM
To: ; 
  
Subject: Re: [wsrp][wsia][wsrp-wsia joint 
  interfaces][Draft Spec 0.43] Terminology

  
Presuming the 2nd case to get dropped relative to the previous 
  set of 
emails, I would propose this section call out 
  how we will refer to these 
things throughout the 
  remainder of the document/API. In particular, I would 
suggest: 
      Session 
  Information - This is carried opaquely in the interface as a 
      "sessionID". 
      => goes away 
      Persistent Information - This is carried 
  opaquely in the interface as 
      a "handle". 

  
Rather than "Manifestation", I would propose using "Entity" to 
  describe the 
thing from which markup may be requested. 
  I think it has the right level of 
opacity (Consumer 
  has no idea what kind of entity it is) while carrying 
appropriate semantics (a thing that may be interacted with). Using 
  these 
terms, there was also an open question at the 
  end of our last call related 
to whether there were 
  both persistent and transient entities ... 

  
If we are going to support explicit lifecycle for both of 
  these, I would 
propose: 
   handle   createEntity(handle, 
  propertyValues) 
   sessionID   
  createSession(handle, propertyValues) 

  
---------------------------------------------------------------- 
  
To subscribe or unsubscribe from this elist use the 
  subscription 
manager: <http://lists.oasis-open.org/ob/adm.pl>