axis-java-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Davanum Srinivas (JIRA)" <>
Subject [jira] Resolved: (AXIS2-2281) Adding configurable parameter for Metadata Exchange
Date Thu, 15 Mar 2007 15:29:09 GMT


Davanum Srinivas resolved AXIS2-2281.

    Resolution: Fixed

Fixed svn revision 518662


> Adding configurable parameter for Metadata Exchange
> ---------------------------------------------------
>                 Key: AXIS2-2281
>                 URL:
>             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
>    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=""             
>                  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"
>   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:
For additional commands, e-mail:

View raw message