Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Xerces Wiki" for change 
notification.

The "gsoc_xs_override_proposal" page has been changed by uswick.
http://wiki.apache.org/xerces/gsoc_xs_override_proposal?action=diff&rev1=15&rev2=16

--------------------------------------------------

  }}}
  
   . .Here “schemaLocation” indicates the location of the overriding schema 
document while “Content” corresponds to the types/groups/attributes/elements 
this schema will be overriding on the schemas available at corresponding 
“schemaLocation” . xs:override semantics are very much similar to 
class/prototypical inheritance where after successful application , 
corresponding overridden schemas replaces their old schemas by the new 
overriding schemas contained within a <xs:override> element. Following 
describes the criteria of xs:override on a general overview. Implementing 
thsese sematics on XML schema composition framework ,can be be considered the 
main objective of the project.
- 
    . {{{
  1.override only applies if the schema component within <xs:override> exists 
in the overridden schema (corresponding to the respective schema Location 
defined). If this condition is not true, there’s no effect  on the overriden 
schema  location and overriding grammer won’t exist in the final schema 
representation.
  }}}
@@ -50, +49 @@

   . Xerces2-j  XMLSchema processing and supporting structures are mainly 
handled by classes located in  org.apache.xerces.impl.xs  package.  Primarily 
XMLSchemaFactory  and XMLScehmaLoader  are responsible for loading(ie:- 
#loadGrammar() )  and handling schemas from a set of sources. Actually 
XMLSchemaLoader acts as an wrapper  that provides necessary inputs for a 
XSDHandler (org.apache.xerces.impl.xs.traversers)  instance which will inturn 
be  coordinating the construction of a grammar object corresponding to a schema 
throughout several stages. XSDHandler instance is responsible for parsing each 
schema source (including the ones’s that are imported resulting in other 
grammers) , preprocessing/resoving /loading grammers etc.
  
   . XSDHandler#parseSchema()  is responsible for coordinating these critical 
stages of schema composition which includes ,
+   . a) constructTrees – constructs XSschema objects .Attempts to resolve 
<include>,<redefine> schema components and builds a dependency map .
  
-  . a) constructTrees – constructs XSschema objects .Attempts to resolve 
<include>,<redefine> schema components and builds a dependency map .
+   . b) buildGlobalNameRegistries - builds registries for all 
globally-referenceable names. Keeps track of <redefine> component mapping.
  
-  . b) buildGlobalNameRegistries - builds registries for all 
globally-referenceable names. Keeps track of <redefine> component mapping.
+   . c) traverseSchemas – traverse globally declared elements with appropriate 
traverser object (ie:-SimpleType/ComplexType/Attribute traversers) and handle 
them accordingly.
  
-  . c) traverseSchemas – traverse globally declared elements with appropriate 
traverser object (ie:-SimpleType/ComplexType/Attribute traversers) and handle 
them accordingly.
+   . d) traverseLocalElements-Traverse all the deferred local elements
  
-  . d) traverseLocalElements-Traverse all the deferred local elements
+   . e) resolving ID/Key references
  
-  . e) resolving ID/Key references
+   . f) storing imported grammars and building the Grammer Pool
  
-  . f) storing imported grammars and building the Grammer Pool
+  .  . xs:override implementation intends to extend this functionality to 
implement <override> structure semantics. Also several supporting structures 
will be needed so that <override>  schema components will be identified during 
schema processing. For example extending of following class structures.
+   . •    org.apache.xerces.impl.xs.SchemaSymbols – keeps track of collection 
of symbols used in parsing Schema Grammer. Need to introduce new <override> 
grammer symbols to this.
  
+   . •    org.apache.xerces.impl.xs.XSDDescription  - keeps track of all 
information specific to XML Schema grammars. This can be used to indicate the 
Schema processor that the current schema document is overridden by another 
scheama document.
-  .
- xs:override implementation intends to extend this functionality to implement 
<override> structure semantics. Also several supporting structures will be 
needed so that <override>  schema components will be identified during schema 
processing. For example extending of following class structures.
  
-  . •    org.apache.xerces.impl.xs.SchemaSymbols – keeps track of collection 
of symbols used in parsing Schema Grammer. Need to introduce new <override> 
grammer symbols to this.
- 
-  . •    org.apache.xerces.impl.xs.XSDDescription  - keeps track of all 
information specific to XML Schema grammars. This can be used to indicate the 
Schema processor that the current schema document is overridden by another 
scheama document.
- 
- Additionally Xs:override implementation may require quite a few new 
components/data structures to be added to org.apache.xerces.impl.xs package  
inorder to handle different scenarios regarding <override> semantics as was 
described in the beginning.
+  . Additionally Xs:override implementation may require quite a few new 
components/data structures to be added to org.apache.xerces.impl.xs package  
inorder to handle different scenarios regarding <override> semantics as was 
described in the beginning.
  
  == Things I have Done So far ==
   . Since this project is about implementing a XMLSchema 1.1 specification 
construct , I had to go through this specification docs several times to 
understand the exact structure and semantics of the component I’m going to 
implement which I think is of vital  importance when it comes to the design and 
implementation. Previous discussions (that has happened in Xerces-j-dev mail 
archives) about this xs:override support , online articles and tutorials also 
helped a lot in this cause. I also interacted with Xerces mailing list 
(especially with my mentor) to clarify critical points and implementation 
details. Since knowing Xerces and it’s internal framework(XNI) is obviously 
essential for the implementation I had to dig into various documentation, API 
information ,samples  , regarding Xerces Design,architecture and especially XML 
schema processing. I did download the source code of Xerces2-j from trunk and 
build the code inorder to try and test  out some samples to get a hang on the 
flow of things related to schema loading and  processing.Running through 
several samples (xs.QuerryXS , jaxp.SourceValidator, xni samples,etc) and 
debugging them , really gave me a good inisght into to  Xerces framework...
@@ -94, +90 @@

   * Documentation (java docs + design details) on xs:override 
implementation/API
  
  == Community Interaction ==
- Initially i had trouble selecting a project since the project i was keeping 
in mind was already undertaken. Xerces-2j mailing list was really helpfull in 
this ,giving me lot of feedback on available projects  that was not even 
initally declared as Summer projects for 2010 .  I  was later able to get lot 
of insight on xs:override specification semantics and implementation details 
through the interaction on mails from  xerces-j dev community . Through this I 
managed to digg into and clarify lot of details that would be very helpful 
through out my project and has definitely been a much needed guidance in 
writing this proposal as well.
+  . Initially i had trouble selecting a project since the project i was 
keeping in mind was already undertaken. Xerces-2j mailing list was really 
helpfull in this ,giving me lot of feedback on available projects  that was not 
even initally declared as Summer projects for 2010 .  I  was later able to get 
lot of insight on xs:override specification semantics and implementation 
details through the interaction on mails from  xerces-j dev community . Through 
this I managed to digg into and clarify lot of details that would be very 
helpful through out my project and has definitely been a much needed guidance 
in writing this proposal as well.
  
  == About me ==
   . I'm a Computer Science Engineering undergraduate (final year),of  the 
department of Computer Science and Engineering, University of Moratuwa, Sri 
Lanka . I'm very much passionate about Computer science  and am especially 
interested in  subject areas  related to Compiler Theory ,Distributed Systems 
and Enterprise Middelware and also Artificial Intelligence.I do have experience 
in open source development and related aspects and always loved working in such 
a dynamic and encouraging environment .

---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to