should BXCollection.listResources always throw an exception?

On Fri, Apr 15, 2011 at 12:19 AM, Meredith Gregory <lgreg.meredith at gmail.com> wrote: > Dear BaseXers, > So far, BaseX has been a lot of fun to work with! Thanks for all your > efforts on this codebase. > i've got a couple of questions, though. > > Whether i've got no documents in a freshly created BXCollection, or i've > ensured that there is at least one document present, a call to listResources > always throws an IndexOutOfBounds exception. Is that the intended behavior? > The reason i'm using this API is that i need to be able to update a single > document in a collection guaranteed to have exactly one document. So, i > thought i would simply ask the BXCollection to list it's resources, grab the > first one (since there should only be one) and then use the id from the list > returned by that API in subsequent queries. Maybe that's not the preferred > approach? Is there a better one? > > Any help would be greatly appreciated. > Best wishes, > --greg > override def getCollection( createIfMissing : Boolean )( > xmlCollStr : String > ) : Option[Collection] = { > try { > // BUGBUG -- LGM the semantics of BXCollection a little > // different than createIfMissing; and requires catching the > // database not found exception > Some( new BXCollection( xmlCollStr, true ) ) > } > catch { > case e : XMLDBException => { > val bxColl = new BXCollection( xmlCollStr, false ) > val document = > bxColl.createResource( > null, XMLResource.RESOURCE_TYPE > ).asInstanceOf[XMLResource] > document.setContent( "<database></database>" ) > bxColl.storeResource( document ) > Some( bxColl ) > } > case _ => None > } > } > override def update( xmlCollStr : String )( > cnxn : CnxnCtxtLabel[Namespace,Var,String] > ) : Unit = { > for( xmlColl <- getCollection( true )( xmlCollStr ) ) { > val resourceList : Array[String] = xmlColl.listResources > if ( resourceList.size == 0 ) { > val document = > xmlColl.createResource( > null, XMLResource.RESOURCE_TYPE > ).asInstanceOf[XMLResource] > document.setContent( xmlIfier.asXML( cnxn ).toString ) > xmlColl.storeResource( document ) > } > else { > val cnxnElem = xmlIfier.asXML( cnxn ) > cnxnElem match { > case cElem : Elem => { > delete( xmlCollStr, resourceList( 0 ) )( cElem ) > insert( xmlCollStr, resourceList( 0 ) )( cElem ) > } > case _ => { > throw new Exception( "record is not an XML element" ) > } > } > } > } > } > <tweet>storing to db : org.basex.api.xmldb.BXDatabase@77dc754 pair : > record(contactMeUsing(email), > {&quot;com.biosimilarity.lift.model.store.MonadicTermTypes_-Ground&quot;:{&quot;v&quot;:{&quot;@class&quot;:&quot;string&quot;,&quot;$&quot;:&quot;for > the win > Mikail.Mauz at gmail.com&quot;},&quot;_-outer&quot;:{&quot;@class&quot;:&quot;com.biosimilarity.lift.model.store.PersistedMonadicTS$TheMTT$&quot;}}}) > in coll : Squibble</tweet> > java.lang.IndexOutOfBoundsException > at java.io.RandomAccessFile.readBytes(Native Method) > at java.io.RandomAccessFile.read(RandomAccessFile.java:322) > at java.io.RandomAccessFile.readFully(RandomAccessFile.java:381) > at org.basex.io.DataAccess.cursor(DataAccess.java:225) > at org.basex.io.DataAccess.readToken(DataAccess.java:147) > at org.basex.data.DiskData.txt(DiskData.java:213) > at org.basex.data.DiskData.text(DiskData.java:181) > at org.basex.api.xmldb.BXCollection.listResources(BXCollection.java:128) > at > com.biosimilarity.lift.model.store.xml.BaseXCnxnStorage$$anonfun$update$1.apply(BaseXXMLPersist.scala:313) > at > com.biosimilarity.lift.model.store.xml.BaseXCnxnStorage$$anonfun$update$1.apply(BaseXXMLPersist.scala:312) > at scala.Option.foreach(Option.scala:185) > at > com.biosimilarity.lift.model.store.xml.BaseXCnxnStorage$class.update(BaseXXMLPersist.scala:312) > at > com.biosimilarity.lift.model.store.PersistedTermStoreScope$PersistedMonadicGeneratorJunction.update(PersistedMonadicTermStore.scala:321) > at > com.biosimilarity.lift.model.store.PersistedTermStoreScope$PersistedMonadicGeneratorJunction$$anonfun$putInStore$3$$anonfun$apply$12$$anonfun$apply$13.apply(PersistedMonadicTermStore.scala:468) > at > com.biosimilarity.lift.model.store.PersistedTermStoreScope$PersistedMonadicGeneratorJunction$$anonfun$putInStore$3$$anonfun$apply$12$$anonfun$apply$13.apply(PersistedMonadicTermStore.scala:459) > at scala.Option.foreach(Option.scala:185) > at > com.biosimilarity.lift.model.store.PersistedTermStoreScope$PersistedMonadicGeneratorJunction$$anonfun$putInStore$3$$anonfun$apply$12.apply(PersistedMonadicTermStore.scala:459) > at > com.biosimilarity.lift.model.store.PersistedTermStoreScope$PersistedMonadicGeneratorJunction$$anonfun$putInStore$3$$anonfun$apply$12.apply(PersistedMonadicTermStore.scala:458) > at scala.Option.foreach(Option.scala:185) > at > com.biosimilarity.lift.model.store.PersistedTermStoreScope$PersistedMonadicGeneratorJunction$$anonfun$putInStore$3.apply(PersistedMonadicTermStore.scala:458) > at > com.biosimilarity.lift.model.store.PersistedTermStoreScope$PersistedMonadicGeneratorJunction$$anonfun$putInStore$3.apply(PersistedMonadicTermStore.scala:458) > at scala.util.continuations.package$.run(package.scala:30) > at scala.concurrent.cpsops$$anonfun$spawn$1.apply$mcV$sp(cpsops.scala:9) > at > scala.concurrent.FJTaskRunners$FJTaskRunner$$anon$1.compute(FJTaskRunners.scala:21) > at jsr166y.forkjoin.RecursiveAction.exec(RecursiveAction.java:247) > at jsr166y.forkjoin.ForkJoinWorkerThread.run(ForkJoinWorkerThread.java:286) > -- > L.G. Meredith > Managing Partner > Biosimilarity LLC > 7329 39th Ave SW > Seattle, WA 98136 > > +1 206.650.3740 > > http://biosimilarity.blogspot.com > > _______________________________________________ > BaseX-Talk mailing list > BaseX-Talk at mailman.uni-konstanz.de > https://mailman.uni-konstanz.de/mailman/listinfo/basex-talk > >

On Fri, Apr 15, 2011 at 10:10 PM, Meredith Gregory <lgreg.meredith at gmail.com> wrote: > Dear Christian, > Thanks! i was coming to that conclusion from reading through the examples on > github, but it is a bit of detective work. It has been hard for me from the > posted code samples and wiki to find a clear indication of which APIs are > supported and the use of which is encouraged and which APIs are not so much > in this category. Admittedly, i've been focused on reading through the > material that looks like it might be applicable to my problem and not on > thoroughly reading your documentation. Is there a page in the wiki or a > readme in the examples codebase that describes the status of the various > APIs? > In this particular case, is there a code sample you can point me to that > would flesh out your proposal a bit more. In particular, though i'm issuing > the count calculation at the XQuery level i need to take action on the basis > of the result at the Java/Scala level. > Best wishes, > --greg

> Dear Meredith, > > could you provide us with a Java example that allows us to quickly > reproduce the bug? Apart from that, please note that we're > discouraging the use of the XML:DB and XQJ APIs, esp. if they are used > in parallel to our own API. Instead, to retrieve the number of > documents, you could as well run an XQuery expression such as the > following one: > > count ( db:open ( "NameOfDB" ) ) > > Hope this helps, > Christian > > ___________________________ > > On Fri, Apr 15, 2011 at 12:19 AM, Meredith Gregory > <lgreg.meredith at gmail.com> wrote: > > Dear BaseXers, > > So far, BaseX has been a lot of fun to work with! Thanks for all your > > efforts on this codebase. > > i've got a couple of questions, though. > > > > Whether i've got no documents in a freshly created BXCollection, or i've > > ensured that there is at least one document present, a call to > listResources > > always throws an IndexOutOfBounds exception. Is that the intended > behavior? > > The reason i'm using this API is that i need to be able to update a > single > > document in a collection guaranteed to have exactly one document. So, i > > thought i would simply ask the BXCollection to list it's resources, grab > the > > first one (since there should only be one) and then use the id from the > list > > returned by that API in subsequent queries. Maybe that's not the > preferred > > approach? Is there a better one? > > > > Any help would be greatly appreciated. > > Best wishes, > > --greg > > override def getCollection( createIfMissing : Boolean )( > > xmlCollStr : String > > ) : Option[Collection] = { > > try { > > // BUGBUG -- LGM the semantics of BXCollection a little > > // different than createIfMissing; and requires catching the > > // database not found exception > > Some( new BXCollection( xmlCollStr, true ) ) > > } > > catch { > > case e : XMLDBException => { > > val bxColl = new BXCollection( xmlCollStr, false ) > > val document = > > bxColl.createResource( > > null, XMLResource.RESOURCE_TYPE > > ).asInstanceOf[XMLResource] > > document.setContent( "<database></database>" ) > > bxColl.storeResource( document ) > > Some( bxColl ) > > } > > case _ => None > > } > > } > > override def update( xmlCollStr : String )( > > cnxn : CnxnCtxtLabel[Namespace,Var,String] > > ) : Unit = { > > for( xmlColl <- getCollection( true )( xmlCollStr ) ) { > > val resourceList : Array[String] = xmlColl.listResources > > if ( resourceList.size == 0 ) { > > val document = > > xmlColl.createResource( > > null, XMLResource.RESOURCE_TYPE > > ).asInstanceOf[XMLResource] > > document.setContent( xmlIfier.asXML( cnxn ).toString ) > > xmlColl.storeResource( document ) > > } > > else { > > val cnxnElem = xmlIfier.asXML( cnxn ) > > cnxnElem match { > > case cElem : Elem => { > > delete( xmlCollStr, resourceList( 0 ) )( cElem ) > > insert( xmlCollStr, resourceList( 0 ) )( cElem ) > > } > > case _ => { > > throw new Exception( "record is not an XML element" ) > > } > > } > > } > > } > > } > > <tweet>storing to db : org.basex.api.xmldb.BXDatabase@77dc754 pair : > > record(contactMeUsing(email), > > > {&quot;com.biosimilarity.lift.model.store.MonadicTermTypes_-Ground&quot;:{&quot;v&quot;:{&quot;@class > &quot;:&quot;string&quot;,&quot;$&quot;:&quot;for > > the win > > Mikail.Mauz at gmail.com&quot;},&quot;_-outer&quot;:{&quot;@class > &quot;:&quot;com.biosimilarity.lift.model.store.PersistedMonadicTS$TheMTT$&quot;}}}) > > in coll : Squibble</tweet> > > java.lang.IndexOutOfBoundsException > > at java.io.RandomAccessFile.readBytes(Native Method) > > at java.io.RandomAccessFile.read(RandomAccessFile.java:322) > > at java.io.RandomAccessFile.readFully(RandomAccessFile.java:381) > > at org.basex.io.DataAccess.cursor(DataAccess.java:225) > > at org.basex.io.DataAccess.readToken(DataAccess.java:147) > > at org.basex.data.DiskData.txt(DiskData.java:213) > > at org.basex.data.DiskData.text(DiskData.java:181) > > at org.basex.api.xmldb.BXCollection.listResources(BXCollection.java:128) > > at > > > com.biosimilarity.lift.model.store.xml.BaseXCnxnStorage$$anonfun$update$1.apply(BaseXXMLPersist.scala:313) > > at > > > com.biosimilarity.lift.model.store.xml.BaseXCnxnStorage$$anonfun$update$1.apply(BaseXXMLPersist.scala:312) > > at scala.Option.foreach(Option.scala:185) > > at > > > com.biosimilarity.lift.model.store.xml.BaseXCnxnStorage$class.update(BaseXXMLPersist.scala:312) > > at > > > com.biosimilarity.lift.model.store.PersistedTermStoreScope$PersistedMonadicGeneratorJunction.update(PersistedMonadicTermStore.scala:321) > > at > > > com.biosimilarity.lift.model.store.PersistedTermStoreScope$PersistedMonadicGeneratorJunction$$anonfun$putInStore$3$$anonfun$apply$12$$anonfun$apply$13.apply(PersistedMonadicTermStore.scala:468) > > at > > > com.biosimilarity.lift.model.store.PersistedTermStoreScope$PersistedMonadicGeneratorJunction$$anonfun$putInStore$3$$anonfun$apply$12$$anonfun$apply$13.apply(PersistedMonadicTermStore.scala:459) > > at scala.Option.foreach(Option.scala:185) > > at > > > com.biosimilarity.lift.model.store.PersistedTermStoreScope$PersistedMonadicGeneratorJunction$$anonfun$putInStore$3$$anonfun$apply$12.apply(PersistedMonadicTermStore.scala:459) > > at > > > com.biosimilarity.lift.model.store.PersistedTermStoreScope$PersistedMonadicGeneratorJunction$$anonfun$putInStore$3$$anonfun$apply$12.apply(PersistedMonadicTermStore.scala:458) > > at scala.Option.foreach(Option.scala:185) > > at > > > com.biosimilarity.lift.model.store.PersistedTermStoreScope$PersistedMonadicGeneratorJunction$$anonfun$putInStore$3.apply(PersistedMonadicTermStore.scala:458) > > at > > > com.biosimilarity.lift.model.store.PersistedTermStoreScope$PersistedMonadicGeneratorJunction$$anonfun$putInStore$3.apply(PersistedMonadicTermStore.scala:458) > > at scala.util.continuations.package$.run(package.scala:30) > > at scala.concurrent.cpsops$$anonfun$spawn$1.apply$mcV$sp(cpsops.scala:9) > > at > > > scala.concurrent.FJTaskRunners$FJTaskRunner$$anon$1.compute(FJTaskRunners.scala:21) > > at jsr166y.forkjoin.RecursiveAction.exec(RecursiveAction.java:247) > > at > jsr166y.forkjoin.ForkJoinWorkerThread.run(ForkJoinWorkerThread.java:286) > > -- > > L.G. Meredith > > Managing Partner > > Biosimilarity LLC > > 7329 39th Ave SW > > Seattle, WA 98136 > > > > +1 206.650.3740 > > > > http://biosimilarity.blogspot.com > > > > _______________________________________________ > > BaseX-Talk mailing list > > BaseX-Talk at mailman.uni-konstanz.de > > https://mailman.uni-konstanz.de/mailman/listinfo/basex-talk > > > > >

On Sun, Apr 17, 2011 at 5:09 AM, Meredith Gregory <lgreg.meredith at gmail.com> wrote: > Dear Christian, > Thanks for that thoughtful reply! i really appreciate it. i think i was just > noting that your wiki page lists 4 distinct APIs. A sentence saying which is > actively supported and the use of which is encouraged might save some people > (like me! ;-) a lot of time. ;-) > Best wishes, > --greg > > On Fri, Apr 15, 2011 at 2:55 PM, Christian Grün <christian.gruen at gmail.com> > wrote: >> >> Hi Greg, >> >> thanks for your mail. You might want to have a look at the following >> page in our Wiki, where some basic examples are listed how our API can >> be accessed (..we invite everyone to actively extend our Wiki pages): >> >> http://docs.basex.org/wiki/Code_Examples >> >> Here is one more example how you can directly request the number of >> documents in the currently opened database: >> >> public final class Test { >> public static void main(final String[] args) throws Exception { >> // single, global database context, >> // which should be used for all database operations >> Context ctx = new Context(); >> // open new database >> new Open("database").execute(ctx); >> // request and count document nodes >> System.out.println(ctx.doc().length); >> // finally close context >> ctx.close(); >> } >> } >> >> We don't have resources to develop a more thorough documentation of >> our API for free. Instead, a comprehensive documentation will be a >> future feature of our commercial portfolio. You also might want to >> have a closer look into the project's JavaDoc. >> >> Hope this helps, >> Christian >> ___________________________ >> >> On Fri, Apr 15, 2011 at 10:10 PM, Meredith Gregory >> <lgreg.meredith at gmail.com> wrote: >> > Dear Christian, >> > Thanks! i was coming to that conclusion from reading through the >> > examples on >> > github, but it is a bit of detective work. It has been hard for me from >> > the >> > posted code samples and wiki to find a clear indication of which APIs >> > are >> > supported and the use of which is encouraged and which APIs are not so >> > much >> > in this category. Admittedly, i've been focused on reading through the >> > material that looks like it might be applicable to my problem and not on >> > thoroughly reading your documentation. Is there a page in the wiki or a >> > readme in the examples codebase that describes the status of the various >> > APIs? >> > In this particular case, is there a code sample you can point me to that >> > would flesh out your proposal a bit more. In particular, though i'm >> > issuing >> > the count calculation at the XQuery level i need to take action on the >> > basis >> > of the result at the Java/Scala level. >> > Best wishes, >> > --greg > > > > -- > L.G. Meredith > Managing Partner > Biosimilarity LLC > 7329 39th Ave SW > Seattle, WA 98136 > > +1 206.650.3740 > > http://biosimilarity.blogspot.com >

> Hi Greg, > > thanks for your mail. You might want to have a look at the following > page in our Wiki, where some basic examples are listed how our API can > be accessed (..we invite everyone to actively extend our Wiki pages): > > http://docs.basex.org/wiki/Code_Examples > > Here is one more example how you can directly request the number of > documents in the currently opened database: > > public final class Test { > public static void main(final String[] args) throws Exception { > // single, global database context, > // which should be used for all database operations > Context ctx = new Context(); > // open new database > new Open("database").execute(ctx); > // request and count document nodes > System.out.println(ctx.doc().length); > // finally close context > ctx.close(); > } > } > > We don't have resources to develop a more thorough documentation of > our API for free. Instead, a comprehensive documentation will be a > future feature of our commercial portfolio. You also might want to > have a closer look into the project's JavaDoc. > > Hope this helps, > Christian > ___________________________ > > On Fri, Apr 15, 2011 at 10:10 PM, Meredith Gregory > <lgreg.meredith at gmail.com> wrote: > > Dear Christian, > > Thanks! i was coming to that conclusion from reading through the examples > on > > github, but it is a bit of detective work. It has been hard for me from > the > > posted code samples and wiki to find a clear indication of which APIs are > > supported and the use of which is encouraged and which APIs are not so > much > > in this category. Admittedly, i've been focused on reading through the > > material that looks like it might be applicable to my problem and not on > > thoroughly reading your documentation. Is there a page in the wiki or a > > readme in the examples codebase that describes the status of the various > > APIs? > > In this particular case, is there a code sample you can point me to that > > would flesh out your proposal a bit more. In particular, though i'm > issuing > > the count calculation at the XQuery level i need to take action on the > basis > > of the result at the Java/Scala level. > > Best wishes, > > --greg >

> Thanks Greg, > > I've updated our docs a little. > Hope this helps, > Christian > ___________________________ > > On Sun, Apr 17, 2011 at 5:09 AM, Meredith Gregory > <lgreg.meredith at gmail.com> wrote: > > Dear Christian, > > Thanks for that thoughtful reply! i really appreciate it. i think i was > just > > noting that your wiki page lists 4 distinct APIs. A sentence saying which > is > > actively supported and the use of which is encouraged might save some > people > > (like me! ;-) a lot of time. ;-) > > Best wishes, > > --greg > > > > On Fri, Apr 15, 2011 at 2:55 PM, Christian Grün < > christian.gruen at gmail.com> > > wrote: > >> > >> Hi Greg, > >> > >> thanks for your mail. You might want to have a look at the following > >> page in our Wiki, where some basic examples are listed how our API can > >> be accessed (..we invite everyone to actively extend our Wiki pages): > >> > >> http://docs.basex.org/wiki/Code_Examples > >> > >> Here is one more example how you can directly request the number of > >> documents in the currently opened database: > >> > >> public final class Test { > >> public static void main(final String[] args) throws Exception { > >> // single, global database context, > >> // which should be used for all database operations > >> Context ctx = new Context(); > >> // open new database > >> new Open("database").execute(ctx); > >> // request and count document nodes > >> System.out.println(ctx.doc().length); > >> // finally close context > >> ctx.close(); > >> } > >> } > >> > >> We don't have resources to develop a more thorough documentation of > >> our API for free. Instead, a comprehensive documentation will be a > >> future feature of our commercial portfolio. You also might want to > >> have a closer look into the project's JavaDoc. > >> > >> Hope this helps, > >> Christian > >> ___________________________ > >> > >> On Fri, Apr 15, 2011 at 10:10 PM, Meredith Gregory > >> <lgreg.meredith at gmail.com> wrote: > >> > Dear Christian, > >> > Thanks! i was coming to that conclusion from reading through the > >> > examples on > >> > github, but it is a bit of detective work. It has been hard for me > from > >> > the > >> > posted code samples and wiki to find a clear indication of which APIs > >> > are > >> > supported and the use of which is encouraged and which APIs are not so > >> > much > >> > in this category. Admittedly, i've been focused on reading through the > >> > material that looks like it might be applicable to my problem and not > on > >> > thoroughly reading your documentation. Is there a page in the wiki or > a > >> > readme in the examples codebase that describes the status of the > various > >> > APIs? > >> > In this particular case, is there a code sample you can point me to > that > >> > would flesh out your proposal a bit more. In particular, though i'm > >> > issuing > >> > the count calculation at the XQuery level i need to take action on the > >> > basis > >> > of the result at the Java/Scala level. > >> > Best wishes, > >> > --greg > > > > > > > > -- > > L.G. Meredith > > Managing Partner > > Biosimilarity LLC > > 7329 39th Ave SW > > Seattle, WA 98136 > > > > +1 206.650.3740 > > > > http://biosimilarity.blogspot.com > > >