You are viewing a plain text version of this content. The canonical link for it is here.
Posted to java-dev@axis.apache.org by "Davanum Srinivas (JIRA)" <ji...@apache.org> on 2007/03/15 16:29:09 UTC

[jira] Resolved: (AXIS2-2281) Adding configurable parameter for Metadata Exchange

     [ https://issues.apache.org/jira/browse/AXIS2-2281?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Davanum Srinivas resolved AXIS2-2281.
-------------------------------------

    Resolution: Fixed

Fixed svn revision 518662

thanks,
dims

> Adding configurable parameter for Metadata Exchange
> ---------------------------------------------------
>
>                 Key: AXIS2-2281
>                 URL: https://issues.apache.org/jira/browse/AXIS2-2281
>             Project: Axis 2.0 (Axis2)
>          Issue Type: Improvement
>          Components: modules
>    Affects Versions: 1.2
>            Reporter: Gee Chia
>             Fix For: 1.2
>
>         Attachments: JIRA2281and2267PatchMar13, MEXPatchJira2281
>
>
> This JIRA is to add configrable parameter for Metadata Exchange function. Following are the two 
> configuration requirements that currently identified:
> a. Once "metadataExchange" module is engaged globally in axis2.xml, we need a way
>    to disable GetMetadata request for a service. 
> b. When a GetMetadata request is issued, the /mex:Metadata element returns multiple 
>    /mex:MetadataSection units. A MetadatSection could be either the embedded XML (inline),
>    an endpoint reference to a Metadata Resource i.e. MetadataReference, 
>    or a URL i.e. Location element. The WS-MEX spec does not define what output forms: inline, Location
>    or MetadataReference should be returned for a GetMetadata request. Currently, MexMessageReceiver
>    just default to generating Metadata Sections for all the 3 possible output forms as stated 
>    in the spec. We need a way to configure the Metadata Section content to return for a GetMetadata 
>    request. For example, if there is large amount of data, large amount of inline xml might not be
>    desirable. The <outputform> allows to configure only GetMetadata response with Metadata Sections
>    of Metadata Reference and Location instead of actual information. 
>    
> Solution implemented:
>  Adding "metadataExchange" element parameter configuration in axis2.xml and services.xml,
>  allows to support the above configuration needs as well as future needs.
>  Following are the configurables items:                                       
>     enable attribute - possible values: "false". This is used to disable
>                         MEX support for a service. When disabled,      
>                         MexDisabledException will be returned to the    
>                         sender of GetMetadata request.                  
>     outputform element contains optional "dialect" attribute and    
>                  required "forms" attribute. possible values for "forms":      
>                  inline,location,reference.If not configured, default is       
>                  inline,location, and reference.  
>   
>  Note that the outputform only avoided unnessary processing in creating Metadata sections
>  for data format that is not needed.                             
>      
>   As an example, 
>   <parameter name="metadataExchange" locked="false">   
>        <outputform dialect="http://schemas.xmlsoap.org/wsdl/"             
>                  forms="inline,location" />                             
>        <outputform forms="reference,location" /> 
>   </parameter>                          
>  
>   If the above configuration is added to the axis2.xml, this means the GetMetadata response
>   will contain Metadata Sections of actual WSDL data, and URL for the WSDL dialect, and
>   for other dialects such as policy, schema, etc., only Metadata Sections with 
>   MetadataReference and Location will be included in the response.
>  The order of precedence for the output form  will be similar to the data locator look-up:
>          a. dialect specific at service level i.e. configured in services.xml    
>          b. service level  i.e. without dialect attribute specified
>          c. dialect specific at global level i,e, configured in axis2.xml
>          d. service level  i.e. without dialect attribute specified
>          e. default output forms to all: inline, location, reference
> Summary of code changes:
> New class:  org.apache.axis2.mex.MexDisabledException
> Modified classes:
>   MexConstants - adding constants for configurable items  refere in  "metadataExchange" parameter
>   MexMessageReceiver -  Access the parameter axis configuration and service configuration 
>                                               Check if MEX is disabled before processing
>                                                Call MexUtil.determineOutputForm(..) instead of default to 
>                                                 all 3 output forms. 
>  MexUtil: Added APIs: determineOutputForm(..), check_MEX_disabled()
>                                               

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


---------------------------------------------------------------------
To unsubscribe, e-mail: axis-dev-unsubscribe@ws.apache.org
For additional commands, e-mail: axis-dev-help@ws.apache.org