RE : Improving Hanlder writing api

[Roshan Weerasuriya <ro...@opensource.lk>]

>hi all,
>
>The code is commited to the CVS. (Actualy I am sorry fot the late notice, 
>the code was commited on last saturday) You could find these files at,
>1. CVSHome/ws-axis/c/include/axis/common
>2. CVSHome/ws-axis/c/include/axis/soap
>3. CVSHome/ws-axis/c/src/common
>4. CVSHome/ws-axis/c/src/soap
>
>rgds,
>roshan
>
>
>At 09:09 AM 2/25/2004 +0600, you wrote:
>>hi all,
>>
>>The changes include:
>>
>>Adding following methods to the following classes.
>>
>>The following let the handler writer access the Header Block and traverse 
>>through it to get the relavent info.
>>
>>- SoapDeSerializer, IHandlerSoapDeSerializer : let the handler writer get 
>>the HeaderBlock by providing the local name and namespace uri
>>- SoapHeader : let the handler writer get the HeaderBlock by providing 
>>the local name and namespace uri
>>- IHeaderBlock:
>>         BasicNode* getFirstChild()=0;
>>         BasicNode* getLastChild() =0;
>>         BasicNode* getChild(int iChildPosition) =0;
>>
>>- HeaderBlock :
>>         BasicNode* getFirstChild(),
>>         BasicNode* getLastChild(),
>>         BasicNode* getChild(int iChildPosition) // get the child by 
>> giving the positon
>>         getNoOfChildren() // get the no of available children
>>- BasicNode :
>>         //The following let the handler writer traverse throuhg the children
>>         int getNoOfChildren();
>>         BasicNode* getFirstChild();
>>         BasicNode* getLastChild();
>>         BasicNode* getChild(int iChildPosition);
>>
>>- ComplexElement:
>>         int getNoOfChildren();
>>         BasicNode* getChild(int iChildPosition);
>>         BasicNode* getLastChild();
>>         BasicNode* getFirstChild();
>>         NODE_TYPE getNodeType();
>>
>>- CharacterElement:
>>         const AxisChar* getValue();
>>
>>Also some of the following methods are to be used for various other 
>>activities such as when creating header blocks by handlers and client apps.
>>
>>- IHeaderBlock:
>>         BasicNode* createChild(NODE_TYPE eNODE_TYPE,  AxisChar 
>> *pachLocalName, AxisChar *pachPrefix, AxisChar *pachUri, AxisChar* pachValue);
>>         BasicNode* createImmediateChild(NODE_TYPE eNODE_TYPE, AxisChar 
>> *pachLocalName, AxisChar *pachPrefix, AxisChar *pachUri, AxisChar* pachValue);
>>         Attribute* createStdAttribute(HEADER_BLOCK_STD_ATTR_TYPE 
>> eStdAttrType, SOAP_VERSION eSOAP_VERSION);
>>         Attribute* createAttribute(const AxisChar* localname, const 
>> AxisChar* prefix, const AxisChar* uri, const AxisChar* value);
>>         Attribute* createAttribute(const AxisChar *localname, const 
>> AxisChar *prefix, const AxisChar *value);
>>
>>A eg code sample from a client who will add a soap header to the soap 
>>reqest is as following.
>>
>>         .....
>>         //-----------Adding SOAP Header-----------
>>         IHeaderBlock* pIHeaderBlock = 
>> m_pCall->createHeaderBlock("reservation", "m", 
>> "http://travelcompany.example.org/reservation");
>>
>>         pIHeaderBlock->createStdAttribute(ROLE_NEXT, SOAP_VER_1_2);
>>         pIHeaderBlock->createStdAttribute(MUST_UNDERSTAND_TRUE, 
>> SOAP_VER_1_2);
>>
>>         BasicNode* pBasicNode = 
>> pIHeaderBlock->createImmediateChild(ELEMENT_NODE, "reference", "m", "", "");
>>         BasicNode* pBasicNode2 = 
>> pIHeaderBlock->createChild(CHARACTER_NODE, "", "", "", 
>> "uuid:093a2da1-q345-739r-ba5d-pqff98fe8j7d");
>>         pBasicNode->addChild(pBasicNode2);
>>
>>         BasicNode* pBasicNode3 = 
>> pIHeaderBlock->createImmediateChild(ELEMENT_NODE, "dateAndTime", "m", "", "");
>>         BasicNode* pBasicNode4 = 
>> pIHeaderBlock->createChild(CHARACTER_NODE, "", "", "", 
>> "2001-11-29T13:20:00.000-05:00");
>>         pBasicNode3->addChild(pBasicNode4);
>>         //-----------End of Adding SOAP Header-----------
>>         .....
>>
>>
>>A eg code sample from a handler written to process a header is as following.
>>
>>IHeaderBlock* pIHeaderBlock= 
>>pIHandlerSoapDeSerializer->GetHeaderBlock("reservation", 
>>"http://travelcompany.example.org/reservation");
>>if (pIHeaderBlock != NULL) {
>>         BasicNode* pBasicNode= pIHeaderBlock->getFirstChild();
>>         BasicNode* pBasicNode2= pBasicNode->getFirstChild();
>>
>>         const AxisChar* pachHeaderValue;
>>         const AxisChar* pachHeaderValue2;
>>
>>         if((pBasicNode2->getNodeType()) == CHARACTER_NODE) {
>>                 pachHeaderValue= pBasicNode2->getValue();
>>         }
>>
>>         BasicNode* pBasicNode3= pIHeaderBlock->getLastChild();
>>         BasicNode* pBasicNode4 =pBasicNode3->getFirstChild();
>>         if((pBasicNode4->getNodeType()) == CHARACTER_NODE) {
>>                 pachHeaderValue2= pBasicNode4->getValue();
>>         }
>>
>>         .....
>>}
>>
>>If you need any further clarification please come back.
>>
>>rgds,
>>roshan
>>
>>At 02:15 PM 2/24/2004 +0600, you wrote:
>>>hi Jean,
>>>
>>> >I think you are talking about processing messages "à la" JAX-RPC 
>>> message handler ?
>>>This is baiscaly to support hanlder writers, to support processing soap 
>>>headers.
>>>
>>> >I yes when the client side messaging handling is planned ?
>>>The client side handlers are also to be supported in the near future.
>>>
>>>rgds,
>>>roshan
>>>
>>>
>>>At 01:41 PM 2/23/2004 +0000, you wrote:
>>>>Hi Roshan,
>>>>
>>>>I think you are talking about processing messages "à la" JAX-RPC 
>>>>message handler ?
>>>>
>>>>I yes when the client side messaging handling is planned ?
>>>>
>>>>After a quick look on the code it seem to be only for the server side 
>>>>by now (server.wsdd).
>>>>
>>>>For the API looking at JAX-RPC seem to be a good starting point...
>>>>
>>>>Regards,
>>>>
>>>>Jean-Yves
>>>>
>>>>
>>>> >hi all,
>>>> >
>>>> >I have been working on improving the handler writing api, 
>>>> since >currently it doesn't have much support on handler writing.
>>>> >I would like to get your comments if any in this regard.
>>>> >
>>>> >rgds,
>>>> >roshan
>>