[Mulgara-svn] r1649 - in trunk/src/jar: content-rlog/java/org/mulgara/krule/rlog/ast/output query/java/org/mulgara/query query/java/org/mulgara/query/filter/value querylang/java/org/mulgara/itql resolver/java/org/mulgara/resolver store-stringpool/java/org/mulgara/store/stringpool/xa web/java/org/mulgara/webquery

ronald at mulgara.org ronald at mulgara.org
Fri Apr 3 21:20:00 UTC 2009


Author: ronald
Date: 2009-04-03 14:19:59 -0700 (Fri, 03 Apr 2009)
New Revision: 1649

Modified:
   trunk/src/jar/content-rlog/java/org/mulgara/krule/rlog/ast/output/AxiomGenerator.java
   trunk/src/jar/query/java/org/mulgara/query/GraphVariable.java
   trunk/src/jar/query/java/org/mulgara/query/filter/value/AbstractComparable.java
   trunk/src/jar/query/java/org/mulgara/query/filter/value/Var.java
   trunk/src/jar/querylang/java/org/mulgara/itql/TqlInterpreter.java
   trunk/src/jar/querylang/java/org/mulgara/itql/TqlSession.java
   trunk/src/jar/resolver/java/org/mulgara/resolver/ApplyRulesOperation.java
   trunk/src/jar/resolver/java/org/mulgara/resolver/ExternalTransactionUnitTest.java
   trunk/src/jar/resolver/java/org/mulgara/resolver/JotmTransactionStandaloneTest.java
   trunk/src/jar/resolver/java/org/mulgara/resolver/MulgaraTransactionFactory.java
   trunk/src/jar/store-stringpool/java/org/mulgara/store/stringpool/xa/SPDecimalImpl.java
   trunk/src/jar/web/java/org/mulgara/webquery/QueryResponsePage.java
   trunk/src/jar/web/java/org/mulgara/webquery/QueryServlet.java
Log:
A few more small javadoc fixes.

Modified: trunk/src/jar/content-rlog/java/org/mulgara/krule/rlog/ast/output/AxiomGenerator.java
===================================================================
--- trunk/src/jar/content-rlog/java/org/mulgara/krule/rlog/ast/output/AxiomGenerator.java	2009-04-03 21:19:48 UTC (rev 1648)
+++ trunk/src/jar/content-rlog/java/org/mulgara/krule/rlog/ast/output/AxiomGenerator.java	2009-04-03 21:19:59 UTC (rev 1649)
@@ -61,6 +61,7 @@
   /**
    * Creates a new writer for a collection of axioms.
    * @param axioms The axioms to be written.
+   * @param resolverSession the resolver-session
    * @throws LocalizeException If localized nodes could not be accessed.
    */
   public AxiomGenerator(Collection<Axiom> axioms, ResolverSession resolverSession) throws LocalizeException {

Modified: trunk/src/jar/query/java/org/mulgara/query/GraphVariable.java
===================================================================
--- trunk/src/jar/query/java/org/mulgara/query/GraphVariable.java	2009-04-03 21:19:48 UTC (rev 1648)
+++ trunk/src/jar/query/java/org/mulgara/query/GraphVariable.java	2009-04-03 21:19:59 UTC (rev 1649)
@@ -44,7 +44,7 @@
   //
 
   /**
-   * Construct a model from a {@link URL}.
+   * Construct a model from a variable.
    *
    * @param variable The variable this expression represents.
    * @throws IllegalArgumentException if <var>url</var> is <code>null</code>

Modified: trunk/src/jar/query/java/org/mulgara/query/filter/value/AbstractComparable.java
===================================================================
--- trunk/src/jar/query/java/org/mulgara/query/filter/value/AbstractComparable.java	2009-04-03 21:19:48 UTC (rev 1648)
+++ trunk/src/jar/query/java/org/mulgara/query/filter/value/AbstractComparable.java	2009-04-03 21:19:59 UTC (rev 1649)
@@ -54,6 +54,9 @@
 
   /**
    * Equality comparison used for other objects that are explicitly comparable.
+   *
+   * @param v the expression to compare against
+   * @return true if this values equals the expression's value
    */
   public boolean equals(ComparableExpression v) throws QueryException {
     return compare(getValue(), v.getValue()) == 0;
@@ -105,4 +108,4 @@
    */
   protected abstract int compare(Object left, Object right) throws QueryException;
 
-}
\ No newline at end of file
+}

Modified: trunk/src/jar/query/java/org/mulgara/query/filter/value/Var.java
===================================================================
--- trunk/src/jar/query/java/org/mulgara/query/filter/value/Var.java	2009-04-03 21:19:48 UTC (rev 1648)
+++ trunk/src/jar/query/java/org/mulgara/query/filter/value/Var.java	2009-04-03 21:19:59 UTC (rev 1649)
@@ -55,7 +55,8 @@
 
   /**
    * Instantiate a variable.
-   * @param name The boolean to wrap
+   *
+   * @param name The variable's name
    */
   public Var(String name) {
     this.name = name;

Modified: trunk/src/jar/querylang/java/org/mulgara/itql/TqlInterpreter.java
===================================================================
--- trunk/src/jar/querylang/java/org/mulgara/itql/TqlInterpreter.java	2009-04-03 21:19:48 UTC (rev 1648)
+++ trunk/src/jar/querylang/java/org/mulgara/itql/TqlInterpreter.java	2009-04-03 21:19:59 UTC (rev 1649)
@@ -924,10 +924,11 @@
 
 
   /**
-   * @see org.mulgara.itql.SableCCInterpreter#toLiteralImpl(PLiteral)
    * Despite onyl being accessed from within this package (both locally and from
    * {@link VariableBuilder}) this method must be public, as it has to appear in
    * the {@link Interpreter} interface.
+   *
+   * @see org.mulgara.itql.SableCCInterpreter#toLiteralImpl(PLiteral)
    */
   public LiteralImpl toLiteralImpl(PLiteral p) {
   
@@ -960,8 +961,8 @@
 
 
   /**
+   * Called by {@link ConstraintExpressionBuilder}
    * @see org.mulgara.itql.SableCCInterpreter#nextAnonVariable()
-   * Called by {@link ConstraintExpressionBuilder}
    */
   public Variable nextAnonVariable() {
     return new Variable("av__" + this.anonSuffix++);

Modified: trunk/src/jar/querylang/java/org/mulgara/itql/TqlSession.java
===================================================================
--- trunk/src/jar/querylang/java/org/mulgara/itql/TqlSession.java	2009-04-03 21:19:48 UTC (rev 1648)
+++ trunk/src/jar/querylang/java/org/mulgara/itql/TqlSession.java	2009-04-03 21:19:59 UTC (rev 1649)
@@ -482,7 +482,7 @@
 
 
   /**
-   * Initiates a session using the given <code>session</code>
+   * Print the message-of-the-day.
    */
   private void motdInitialization() {
     gui.print("TQL Command Line Interface" + EOL);

Modified: trunk/src/jar/resolver/java/org/mulgara/resolver/ApplyRulesOperation.java
===================================================================
--- trunk/src/jar/resolver/java/org/mulgara/resolver/ApplyRulesOperation.java	2009-04-03 21:19:48 UTC (rev 1648)
+++ trunk/src/jar/resolver/java/org/mulgara/resolver/ApplyRulesOperation.java	2009-04-03 21:19:59 UTC (rev 1649)
@@ -60,8 +60,8 @@
   }
 
   /**
+   * Runs the rules over the configured data.
    * @see org.mulgara.resolver.Operation#execute(OperationContext, SystemResolver, DatabaseMetadata)
-   * Runs the rules over the configured data.
    */
   public void execute(OperationContext         operationContext,
                       SystemResolver           systemResolver,

Modified: trunk/src/jar/resolver/java/org/mulgara/resolver/ExternalTransactionUnitTest.java
===================================================================
--- trunk/src/jar/resolver/java/org/mulgara/resolver/ExternalTransactionUnitTest.java	2009-04-03 21:19:48 UTC (rev 1648)
+++ trunk/src/jar/resolver/java/org/mulgara/resolver/ExternalTransactionUnitTest.java	2009-04-03 21:19:59 UTC (rev 1649)
@@ -231,7 +231,7 @@
   }
 
   /**
-   * Test the {@link DatabaseSession#createModel(URI, URI)} method.
+   * Test single-phase commit.
    * As a side-effect, creates the model required by the next tests.
    */
   public void testSimpleOnePhaseCommit() throws URISyntaxException {

Modified: trunk/src/jar/resolver/java/org/mulgara/resolver/JotmTransactionStandaloneTest.java
===================================================================
--- trunk/src/jar/resolver/java/org/mulgara/resolver/JotmTransactionStandaloneTest.java	2009-04-03 21:19:48 UTC (rev 1648)
+++ trunk/src/jar/resolver/java/org/mulgara/resolver/JotmTransactionStandaloneTest.java	2009-04-03 21:19:59 UTC (rev 1649)
@@ -155,7 +155,7 @@
   }
 
   /**
-   * Test the {@link DatabaseSession#createModel(URI, URI)} method.
+   * Test explicit transaction.
    * As a side-effect, creates the model required by the next tests.
    */
   public void testTrivalExplicit() throws URISyntaxException {

Modified: trunk/src/jar/resolver/java/org/mulgara/resolver/MulgaraTransactionFactory.java
===================================================================
--- trunk/src/jar/resolver/java/org/mulgara/resolver/MulgaraTransactionFactory.java	2009-04-03 21:19:48 UTC (rev 1648)
+++ trunk/src/jar/resolver/java/org/mulgara/resolver/MulgaraTransactionFactory.java	2009-04-03 21:19:59 UTC (rev 1649)
@@ -258,7 +258,6 @@
    * can reliably get the current mutex-owner, and we use a lock around the mutex acquisition and
    * release to do atomic tests and settting of additional variables associated with the mutex.
    * 
-   * @param <T> the type of exception to throw on failure
    * @param timeout how many milliseconds to wait for the mutex, or 0 to wait indefinitely
    * @param exc An exception class that is the type that will be thrown in case of failure.
    * @throws T if the mutex could not be acquired, either due to a timeout or due to an interrupt
@@ -295,7 +294,6 @@
   /** 
    * Acquire the mutex, interrupting the existing holder if there is one. 
    * 
-   * @param <T> the type of exception to throw on failure
    * @param timeout how many milliseconds to wait for the mutex, or 0 to wait indefinitely
    * @param exc An exception class that is the type that will be thrown in case of failure.
    * @throws T if the mutex could not be acquired, either due to a timeout or due to an interrupt

Modified: trunk/src/jar/store-stringpool/java/org/mulgara/store/stringpool/xa/SPDecimalImpl.java
===================================================================
--- trunk/src/jar/store-stringpool/java/org/mulgara/store/stringpool/xa/SPDecimalImpl.java	2009-04-03 21:19:48 UTC (rev 1648)
+++ trunk/src/jar/store-stringpool/java/org/mulgara/store/stringpool/xa/SPDecimalImpl.java	2009-04-03 21:19:59 UTC (rev 1649)
@@ -302,8 +302,8 @@
     }
 
     /**
+     * This comparator WILL compare between xsd:decimal and the extending types
      * @see org.mulgara.store.stringpool.SPComparator#compare(ByteBuffer, int, ByteBuffer, int)
-     * This comparator WILL compare between xsd:decimal and the extending types
      */
     public int compare(ByteBuffer d1, int subtypeId1, ByteBuffer d2, int subtypeId2) {
       int c = decode(d1).compareTo(decode(d2));
@@ -444,16 +444,16 @@
     }
 
     /**
+     * @return Always 0, since all data is needed for comparing on this class.
      * @see org.mulgara.store.stringpool.SPComparator#comparePrefix(java.nio.ByteBuffer, java.nio.ByteBuffer, int)
-     * @return Always 0, since all data is needed for comparing on this class.
      */
     public int comparePrefix(ByteBuffer d1, ByteBuffer d2, int d2Size) {
       return 0;
     }
 
     /**
+     * This comparator WILL compare between xsd:decimal and the extending types
      * @see org.mulgara.store.stringpool.SPComparator#compare(ByteBuffer, int, ByteBuffer, int)
-     * This comparator WILL compare between xsd:decimal and the extending types
      */
     public int compare(ByteBuffer d1, int subtypeId1, ByteBuffer d2, int subtypeId2) {
       int c;
@@ -501,4 +501,4 @@
     return this.l < l ? -1 : (this.l > l ? 1 : 0);
   }
 
-}
\ No newline at end of file
+}

Modified: trunk/src/jar/web/java/org/mulgara/webquery/QueryResponsePage.java
===================================================================
--- trunk/src/jar/web/java/org/mulgara/webquery/QueryResponsePage.java	2009-04-03 21:19:48 UTC (rev 1648)
+++ trunk/src/jar/web/java/org/mulgara/webquery/QueryResponsePage.java	2009-04-03 21:19:59 UTC (rev 1649)
@@ -109,6 +109,8 @@
    * @param req The request that asked for this page.
    * @param resp The structure for sending the page back to the client.
    * @param tagMap A map of tags to the values that should replace them
+   * @param headFile the header
+   * @param tailFile the footer
    */
   @SuppressWarnings("unchecked")
   public QueryResponsePage(HttpServletRequest req, HttpServletResponse resp, Map<String,String> tagMap, String headFile, String tailFile) {

Modified: trunk/src/jar/web/java/org/mulgara/webquery/QueryServlet.java
===================================================================
--- trunk/src/jar/web/java/org/mulgara/webquery/QueryServlet.java	2009-04-03 21:19:48 UTC (rev 1648)
+++ trunk/src/jar/web/java/org/mulgara/webquery/QueryServlet.java	2009-04-03 21:19:59 UTC (rev 1649)
@@ -119,6 +119,7 @@
    * Creates the servlet for the named host.
    * @param hostname The host name to use, or <code>null</code> if this is not known.
    * @param servername The name of the current server.
+   * @param server the server
    */
   public QueryServlet(String hostname, String servername, SessionFactoryProvider server) {
     super(server);




More information about the Mulgara-svn mailing list