You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@xmlbeans.apache.org by xm...@xml.apache.org on 2005/03/01 01:33:44 UTC

[Apache XMLBeans Wiki] Updated: XmlBeansV1Faq

   Date: 2005-02-28T16:33:44
   Editor: KevinKrouse
   Wiki: Apache XMLBeans Wiki
   Page: XmlBeansV1Faq
   URL: http://wiki.apache.org/xmlbeans/XmlBeansV1Faq

   updating links for 2.0.0 release

Change Log:

------------------------------------------------------------------------------
@@ -13,9 +13,9 @@
    * [#latestVersion What is the latest version of XMLBeans?]
    * [#gettingStartedDoc How do I get started coding with XMLBeans?]
    * [#xmlbeansSource How can I get the latest XMLBeans source code in CVS?]
-   * [#buildingXMLBeansV1 How do I build XMLBeans V1 from source?]
+   * [#buildingXMLBeans How do I build XMLBeans from source?]
    * [#viewXMLBeansOnline Can I view the XMLBeans Source Code online, without having CVS on my machine?]
-   * [#viewJavaDoc Is the XMLBeans V1 javadoc available online?]
+   * [#viewJavaDoc Is the XMLBeans javadoc available online?]
    * [#scompFindingJavac The scomp program can't find javac and fails with java.io.IOException on Windows!]
 
  * '''[#generalXbeans General XMLBeans Questions]'''
@@ -65,11 +65,7 @@
 [[Anchor(latestVersion)]]
 '''What is the latest version of XMLBeans?'''
 
-XMLBeans Version 1 is current stable codeline.  It basically represents the codeline that BEA originally submitted to Apache plus some useful bug fixes.  The 1.0.3 release requires jdk1.4 and is available at http://xmlbeans.apache.org/sourceAndBinaries/.  See the XMLBeans website or the FAQ for information on how to build XMLBeans V1 from source.  
-
-For jdk1.3 users, there is a version of the 1.0.3 release compatible with jdk1.3 only available in cvs under the branch name 'xmlbeans-jdk13_branch'.
-
-XMLBeans Version 2 is in process and is not expected to be beta ready until late summer or early fall 2004.  
+XMLBeans Version 2.0.0-beta1 is the most recent release.  The 1.0.4 release is the latest stable maintanance release.  You will need jdk1.4 for the 2.0.0-beta1 and 1.0.4 release.  For jdk1.3 users, there is a version of the 1.0.4 release compatible with jdk1.3.
 
 ----
 [[Anchor(downloadBinary)]]
@@ -80,18 +76,18 @@
 [[Anchor(gettingStartedDoc)]]
 '''How do I get started coding with XMLBeans?'''
 
-This [http://xmlbeans.apache.org/docs/guide/conGettingStartedwithXMLBeans.html document] (http://xmlbeans.apache.org/docs/guide/conGettingStartedwithXMLBeans.html) is a good place to get started.
+You can find lots of [http://xmlbeans.apache.org/documentation/index.html documentation] on the XMLBeans' website.  The [http://xmlbeans.apache.org/docs/2.0.0/guide/conGettingStartedwithXMLBeans.html Getting Started] guide (http://xmlbeans.apache.org/docs/2.0.0/guide/conGettingStartedwithXMLBeans.html) is a good introduction to XMLBeans.  Another excellent place to start is the [http://xmlbeans.apache.org/documentation/tutorial_getstarted.html tutorial].
 
 ----
 [[Anchor(xmlbeansSource)]]
-How can I get the latest XMLBeans source code in CVS?
+How can I get the latest XMLBeans source code in svn?
 
-[http://xmlbeans.apache.org/sourceAndBinaries/index.html#XMLBeans+Source XMLBeans Source Code Information]
+[http://xmlbeans.apache.org/sourceAndBinaries/index.html#XMLBeans+Source XMLBeans Source Code Information].  You will need a Subversion (svn) client.
 ----
 [[Anchor(viewJavaDoc)]]
-'''Is the XMLBeans V1 javadoc available online?'''
+'''Is the XMLBeans javadoc available online?'''
 
-Yes, you can view the XMLBeans V1 !JavaDoc here, http://xmlbeans.apache.org/docs/reference/index.html.
+Yes, you can view the XMLBeans [http://xmlbeans.apache.org/docs/2.0.0/reference/index.html 2.0.0-beta1 JavaDocs] or the [http://xmlbeans.apache.org/docs/1.0.4/reference/index.html 1.0.4 JavaDocs].
 ----
 [[Anchor(scompFindingJavac)]]
 '''The scomp program can't find javac and fails with java.io.IOException on Windows!'''
@@ -120,15 +116,15 @@
 BUILD FAILED
 }}}
 ----
-[[Anchor(buildingXMLBeansV1)]]
-'''How do I build XMLBeans V1?'''
+[[Anchor(buildingXMLBeans)]]
+'''How do I build XMLBeans?'''
 
-[http://xmlbeans.apache.org/sourceAndBinaries/index.html#Building+XMLBeans+Version+1.0 Building XMLBeans V1]
+[http://xmlbeans.apache.org/sourceAndBinaries/index.html#Building+XMLBeans Building XMLBeans].  You will need [http://ant.apache.org/ Ant] installed and JDK 1.4.
 ----
 [[Anchor(viewXMLBeansOnline)]]
-'''Can I view the XMLBeans source code online, without having CVS on my machine?'''
+'''Can I view the XMLBeans source code online, without having svn on my machine?'''
 
-Yes you can use the CVSView to browse or link to the XMLBeans source code.  [http://cvs.apache.org/viewcvs.cgi/xml-xmlbeans/v1/ Link to XMLBeans V1 via CVSView]
+Yes you can use the CVS/SVNView to browse or link to the XMLBeans source code.  [http://svn.apache.org/viewcvs.cgi/xmlbeans/trunk/ Link to XMLBeans main dev trunk]
 
 ----
 [[Anchor(generalXbeans)]]
@@ -139,11 +135,11 @@
 
   '''User Derived Schema Types'''
 
-  When you compile XML schema, the resulting API is made up of two categories of types: built-in types that mirror those in the schema specification and others that are generated from user-derived schema types. This topic provides an overview of the Java types generated for user-derived types, describing the methods the Java types provide ...  [http://xmlbeans.apache.org/docs/guide/conJavaTypesGeneratedFromUserDerived.html Java Types Generated from User-Derived Schema Types]
+  When you compile XML schema, the resulting API is made up of two categories of types: built-in types that mirror those in the schema specification and others that are generated from user-derived schema types. This topic provides an overview of the Java types generated for user-derived types, describing the methods the Java types provide ...  [http://xmlbeans.apache.org/docs/2.0.0/guide/conJavaTypesGeneratedFromUserDerived.html Java Types Generated from User-Derived Schema Types]
 
   '''Built in Types'''
 
-  Just as with types in XML schema, the XMLBeans types based on schema are arranged in a hierarchy. In general, the hierarchy of XMLBean types mirrors the hierarchy of the schema types themselves. XML schema types all inherit from xs:anyType (which is at the root of the hierarchy); XMLBeans types inherit from !XmlObject ... [XMLBeans Support for Built-In Schema Types http://xmlbeans.apache.org/docs/guide/conXMLBeansSupportBuiltInSchemaTypes.html]
+  Just as with types in XML schema, the XMLBeans types based on schema are arranged in a hierarchy. In general, the hierarchy of XMLBean types mirrors the hierarchy of the schema types themselves. XML schema types all inherit from xs:anyType (which is at the root of the hierarchy); XMLBeans types inherit from !XmlObject ... [http://xmlbeans.apache.org/docs/2.0.0/guide/conXMLBeansSupportBuiltInSchemaTypes.html XMLBeans Support for Built-In Schema Types]
 
 ----
 [[Anchor(configPackageName)]]
@@ -187,7 +183,7 @@
 [[Anchor(suggestedPrefixes)]] 
 '''How can I influence the namespace prefix used when saving/printing out my XML?'''
 
-XMLBeans V1 does not keep the prefixes when the original XML is loaded into the underlying XML store.  If you need/want a specific prefix to be associated with a namespace you can use the {{{setSaveSuggestedPrefixes(...)}}} !XmlOption.  
+XMLBeans does not keep the prefixes when the original XML is loaded into the underlying XML store.  If you need/want a specific prefix to be associated with a namespace you can use the {{{setSaveSuggestedPrefixes(...)}}} !XmlOption.  
 
 Here is a code example from this helpful post, http://nagoya.apache.org/eyebrowse/ReadMsg?listName=xmlbeans-user@xml.apache.org&msgNo=33 :
 {{{
@@ -203,16 +199,18 @@
 [[Anchor(selectPath)]]
 '''Is selectPath(...) on !XmlObject and !XmlCursor working?'''
 
-!XmlBeans has a built in engine for very simple XPath expressions. For more advanced XPath expressions Jaxen engine can be used if xbean_xpath.jar is on the classpath. xbean_xpath.jar is available in build\private\lib by running 'ant xbean_xpath.jar'.
+!XmlBeans has a built in engine for very simple XPath expressions.  To use more advanced XPath or XQuery expressions in 2.0.0-beta1, you will need [http://saxon.sf.net/ Saxon] (version 8.2) on the classpath.
+
+To use more advanced XPath expressions in 1.0.4, the Jaxen engine can be used if xbean_xpath.jar is on the classpath. The xbean_xpath.jar is available in build\private\lib by running 'ant xbean_xpath.jar'.
 
 ----
 [[Anchor(execQuery)]]
 '''Is execQuery(...) on !XmlObject and !XmlCursor working?'''
 
-At the moment !XmlBeans doesn't have an XQuery engine, Dutta Satadip is researching open source XQuery alternatives that the Apache !XmlBeans api could interface with. If you know of a good open source XQuery engine alternative please contact Dutta ( s-dutta at sbcglobal.net ). However the !XmlBeans included in BEA's Weblogic 8.x executes xqueries using a BEA's proprietary XQuery engine.
+Yes!  The !XmlBeans 2.0.0-beta1 release uses [http://saxon.sf.net/ Saxon] (version 8.2) as it's XQuery engine so you will need it on your classpath.
+
+For the 1.0.4 release, there is no open source XQuery integration.  However, the !XmlBeans included in BEA's Weblogic 8.x executes xqueries using a BEA's proprietary XQuery engine.
 
-[[Anchor(xmlOptionsAnt)]]
-'''How can I modify the XMLOptions used to generate XMLBeans and still use the Ant xmlbean task?'''
 ----
 [[Anchor(somQuestions)]]
 === Schema Object Model Questions ===
@@ -220,7 +218,7 @@
 [[Anchor(introToSTS)]]
 '''Is there an introduction document on the XMLBeans Schema Type System?'''
 
-This [http://xmlbeans.apache.org/docs/guide/conIntroToTheSchemaTypeSystem.html document] is a good starting place to learn about programming against the XMLBeans Schema Type System.
+This [http://xmlbeans.apache.org/docs/2.0.0/guide/conIntroToTheSchemaTypeSystem.html document] is a good starting place to learn about programming against the XMLBeans Schema Type System.
 
 ----
 [[Anchor(schemaType2Javaname)]]
@@ -251,12 +249,12 @@
 [[Anchor(navigatingXmlCursor)]]
 '''Is there documentation on navigating with !XmlCursor?'''
 
-This document, http://xmlbeans.apache.org/docs/guide/conNavigatingXMLwithCursors.html, discusses using !XmlCursor to navigate a document.
+This document, http://xmlbeans.apache.org/docs/2.0.0/guide/conNavigatingXMLwithCursors.html, discusses using !XmlCursor to navigate a document.
 
 ----
 [[Anchor(usingBookmarks)]]
 '''How do I use Bookmarks to annotate XML?'''
 
-This [http://xmlbeans.apache.org/docs/guide/conUsingBookmarksToAnnotateXML.html document], http://xmlbeans.apache.org/docs/guide/conUsingBookmarksToAnnotateXML.html, discusses using bookmarks to annotate xml.
+This [http://xmlbeans.apache.org/docs/2.0.0/guide/conUsingBookmarksToAnnotateXML.html document], http://xmlbeans.apache.org/docs/2.0.0/guide/conUsingBookmarksToAnnotateXML.html, discusses using bookmarks to annotate xml.
 
 ----

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@xmlbeans.apache.org
For additional commands, e-mail: commits-help@xmlbeans.apache.org