Public Review Comment: Reuse of MarkupRespone and MarkupParams forgetResource()

[Richard Jacob <richard.jacob@de.ibm.com>]

The latest discussions around getResource() concerning what input params to
gR() mean, which output params are valid for gR() underline the probable
confusion the reuse of the gM() structures introduces.
I think it would be clearer in a) the object model and b) in the spec if we
seperated those structures even though some of the fields are similar for
both cases. The reuse of the xsd types doesn't buy us that much and on the
other hand makes the wording in the spec more complicated since both cases
must be considered/described in the field description.

Therefor I propose to introduce the following types:

ResourceParams (would replace MarkupParams as the input to gR()
[R] boolean secureClientCommuncation
[R] string locales[]
[R] string mimeTypes[]
[R] string portletMode (--> refers to the current portlet mode)
[R] string portletWindowState (--> refers to the current portlet window
state)
[O] ClientData clientData
[O] NavigationalContext portletNavigationalContext (--> the portlet's
current navContext)
[O] string resourceState (--> the state encoded in the resource URL)
[O] string markupCharacterSets[]
[O] string validateTag
[O] string validNewPortletModes[]
[O] string validNewPortletWindowStates[]
[O] Extension extensions[]

ResourceResponse
[R] ResourceContext resourceContext
[O] SessionContext sessionContext
[O] Extension extensions[]

ResourceContext
[O] boolean useCachedMarkup
[O] string mimeType
[O] string resourceString
[O] base64Binary resourceBinary
[O] string locale
[O] boolean requiresRewriting
[O] CacheControl cacheControl
[O] string ccppProfileWarning
[O] Extension extensions[]


Mit freundlichen Gruessen / best regards,

        Richard Jacob
______________________________________________________
IBM Lab Boeblingen, Germany
Dept.8288, WebSphere Portal Server Development
WSRP Technical Lead
WSRP Standardization
Phone: ++49 7031 16-3469  -  Fax: ++49 7031 16-4888
Email: mailto:richard.jacob@de.ibm.com