[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