Hi Christian<div>I did try to write my ideas, but landed at reading what is REST and what not - and run out of time.</div><div><br></div><div>So here is draft of some of ideas - unfortunately without clear proposal for next action, but someone will probably take it over and move on.</div>
<div><br></div><div>Jan</div><div><br></div><div><style type="text/css">
    li { list-style: none;  margin: 0; }
    p { margin: 0; }

    span.l { color: red; font-weight: bold; }

    a.mapnode:link {text-decoration: none; color: black; }
    a.mapnode:visited {text-decoration: none; color: black; }
    a.mapnode:active {text-decoration: none; color: black; }
    a.mapnode:hover {text-decoration: none; color: black; background: #eeeee0; }

</style>



<p><span style="color: #000000;font-size: 166%;font-family: Arial, sans-serif; ">JAX-RX and BaseX</span>
</p><ul><li><span style="color: #0033ff;font-size: 150%;font-family: Arial, sans-serif; ">Aim</span>
<ul><li><span style="color: #006600;font-size: 133%;font-family: Arial, sans-serif; ">Summarize ideas and requests regarding JAX-RX interface of BaseX database</span>

</li>

</ul>
</li>
<li><span style="color: #0033ff;font-size: 150%;font-family: Arial, sans-serif; ">Topics</span>
<ul><li><span style="color: #006600;font-size: 133%;font-family: Arial, sans-serif; ">Mixing commands and queries in one request</span>

</li>
<li><span style="color: #006600;font-size: 133%;font-family: Arial, sans-serif; ">Get and relevant post implementation without breaking compatibility</span>

</li>
<li><span style="color: #006600;font-size: 133%;font-family: Arial, sans-serif; ">Are we REST like and do we need it?</span>

</li>
<li><span style="color: #006600;font-size: 133%;font-family: Arial, sans-serif; ">What processing context we need</span>

</li>

</ul>
</li>
<li><span style="color: #0033ff;font-size: 150%;font-family: Arial, sans-serif; ">Typical Use Cases</span>
<ul><li><span style="color: #006600;font-size: 133%;font-family: Arial, sans-serif; ">Add document(s) and optimize</span>
<ul><li><span style="color: #990000;font-size: 116%;font-family: Arial, sans-serif; ">why</span>
<ul><li><p><span style="color: #111111;font-family: Arial, sans-serif; ">Want to be sure, that indexes will be updated after collection has been modified and no one will have a chance to run a query on not optimized collection</span>
</p></li>
</ul>
</li>

</ul>
</li>
<li><span style="color: #006600;font-size: 133%;font-family: Arial, sans-serif; ">Updating query and optimize</span>
<ul><li><span style="color: #990000;font-size: 116%;font-family: Arial, sans-serif; ">why</span>
<ul><li><p><span style="color: #111111;font-family: Arial, sans-serif; ">Want to be sure, that indexes will be updated after collection has been modified and no one will have a chance to run a query on not optimized collection</span>
</p></li>
</ul>
</li>

</ul>
</li>
<li><span style="color: #006600;font-size: 133%;font-family: Arial, sans-serif; ">Query with client defined timeout</span>
<ul><li><span style="color: #990000;font-size: 116%;font-family: Arial, sans-serif; ">why</span>
<ul><li><p><span style="color: #111111;font-family: Arial, sans-serif; ">It is better to quit too long query then risking that one too expensive query would endanger overall server performance</span>
</p><p><span style="color: #111111;font-family: Arial, sans-serif; ">There is no need to get query results too late, when our http connection already timed out</span>
</p></li>
</ul>
</li>

</ul>
</li>
<li><span style="color: #006600;font-size: 133%;font-family: Arial, sans-serif; ">Set of independent simple expression queries</span>

</li>
<li><span style="color: #006600;font-size: 133%;font-family: Arial, sans-serif; ">Mix updating and simple expression queries</span>

</li>
<li><span style="color: #006600;font-size: 133%;font-family: Arial, sans-serif; ">Set of independent commands</span>
<ul><li><span style="color: #990000;font-size: 116%;font-family: Arial, sans-serif; ">why</span>
<ul><li><span style="color: #111111;font-family: Arial, sans-serif; ">Needing to run a batch of tasks, which cannot be interrupted by other clients</span>

</li>

</ul>
</li>

</ul>
</li>

</ul>
</li>
<li><span style="color: #0033ff;font-size: 150%;font-family: Arial, sans-serif; ">Ideas</span>
<ul><li><span style="color: #006600;font-size: 133%;font-family: Arial, sans-serif; ">add timeout parameter to each request</span>

</li>
<li><span style="color: #006600;font-size: 133%;font-family: Arial, sans-serif; ">check, what other timeout-like parameters we may need</span>

</li>
<li><span style="color: #006600;font-size: 133%;font-family: Arial, sans-serif; ">introduce new request element for POST, mixing queries and commands</span>

</li>

</ul>
</li>
<li><span style="color: #0033ff;font-size: 150%;font-family: Arial, sans-serif; ">Possible problems</span>
<ul><li><span style="color: #006600;font-size: 133%;font-family: Arial, sans-serif; ">compatibility with existing design</span>

</li>
<li><span style="color: #006600;font-size: 133%;font-family: Arial, sans-serif; ">wish to pass query result into next command/query</span>

</li>

</ul>
</li>

</ul></div><div><br><br><div class="gmail_quote">2011/2/24 Christian Grün <span dir="ltr">&lt;<a href="mailto:christian.gruen@gmail.com">christian.gruen@gmail.com</a>&gt;</span><br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">
<div class="im">&gt; OK, I understand, that REST allows to perform the (SET) command, but to use<br>
&gt; it with a query, I have to send the query in another, following, request.<br>
&gt; Will this second request keep enough context at the server side to know, it<br>
&gt; shall use that timeout?<br>
<br>
</div>Just recently, I&#39;ve thought about extending the JAX-RX Interface to<br>
allow more than a single query or command, or to allow both commands<br>
and queries; regarding the syntax, this could be easily realized for<br>
the GET method:<br>
<br>
   <a href="http://localhost:8984/basex/jax-rx/factbook?query=1&amp;query=2" target="_blank">http://localhost:8984/basex/jax-rx/factbook?query=1&amp;query=2</a><br>
   <a href="http://localhost:8984/basex/jax-rx/factbook?command=set+timeout+1&amp;query=1&amp;command=info" target="_blank">http://localhost:8984/basex/jax-rx/factbook?command=set+timeout+1&amp;query=1&amp;command=info</a><br>

<br>
On the other hand, I haven&#39;t decided yet how to best realize it for<br>
the POST method without giving up compatibility. One solution could be<br>
to introduce alternative &quot;request&quot; root elements:<br>
<br>
  &lt;request xmlns=&quot;<a href="http://jax-rx.sourceforge.net" target="_blank">http://jax-rx.sourceforge.net</a>&quot;&gt;<br>
    &lt;command&gt;<br>
      &lt;text&gt;set timeout 1&lt;/text&gt;<br>
    &lt;/command&gt;<br>
    &lt;query&gt;<br>
      &lt;text&gt;//name&lt;/text&gt;<br>
      &lt;parameter name=&quot;count&quot; value=&quot;5&quot;/&gt;<br>
    &lt;/query&gt;<br>
  &lt;/request&gt;<br>
<br>
What does everyone think?<br>
<font color="#888888">Christian<br>
</font><div><div></div><div class="h5">_______________________________________________<br>
BaseX-Talk mailing list<br>
<a href="mailto:BaseX-Talk@mailman.uni-konstanz.de">BaseX-Talk@mailman.uni-konstanz.de</a><br>
<a href="https://mailman.uni-konstanz.de/mailman/listinfo/basex-talk" target="_blank">https://mailman.uni-konstanz.de/mailman/listinfo/basex-talk</a><br>
</div></div></blockquote></div><br><br clear="all"><br>-- <br><div name="sig_b0a60a250d" style="margin-top:2em;margin-right:0pt;margin-bottom:2em;margin-left:0pt"><b>Ing. Jan Vlčinský</b><br><small>
CAD programy<br>
Slunečnicová 338/3,  734 01 Karviná Ráj, Czech Republic<br>
tel: +420-597 602 024;
mob: +420-608 979 040<br>
skype: janvlcinsky;
GoogleTalk: <a href="mailto:jan.vlcinsky@gmail.com" target="_blank">jan.vlcinsky@gmail.com</a><br>
<a href="http://cz.linkedin.com/in/vlcinsky" target="_blank">http://cz.linkedin.com/in/vlcinsky</a>
</small></div><br>
</div>