Return-Path: Delivered-To: apmail-incubator-oodt-commits-archive@minotaur.apache.org Received: (qmail 19296 invoked from network); 12 Jul 2010 20:27:30 -0000 Received: from unknown (HELO mail.apache.org) (140.211.11.3) by 140.211.11.9 with SMTP; 12 Jul 2010 20:27:30 -0000 Received: (qmail 40979 invoked by uid 500); 12 Jul 2010 20:27:30 -0000 Delivered-To: apmail-incubator-oodt-commits-archive@incubator.apache.org Received: (qmail 40956 invoked by uid 500); 12 Jul 2010 20:27:30 -0000 Mailing-List: contact oodt-commits-help@incubator.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: oodt-dev@incubator.apache.org Delivered-To: mailing list oodt-commits@incubator.apache.org Received: (qmail 40949 invoked by uid 99); 12 Jul 2010 20:27:30 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 12 Jul 2010 20:27:30 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=10.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 12 Jul 2010 20:27:27 +0000 Received: by eris.apache.org (Postfix, from userid 65534) id 55209238899C; Mon, 12 Jul 2010 20:26:34 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r963474 - /incubator/oodt/trunk/catalog/src/main/java/org/apache/oodt/cas/catalog/query/QueryService.java Date: Mon, 12 Jul 2010 20:26:34 -0000 To: oodt-commits@incubator.apache.org From: mattmann@apache.org X-Mailer: svnmailer-1.0.8 Message-Id: <20100712202634.55209238899C@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Author: mattmann Date: Mon Jul 12 20:26:33 2010 New Revision: 963474 URL: http://svn.apache.org/viewvc?rev=963474&view=rev Log: - progress towards OODT-15 One trunk for all OODT components with top level build Added: incubator/oodt/trunk/catalog/src/main/java/org/apache/oodt/cas/catalog/query/QueryService.java - copied, changed from r963466, incubator/oodt/trunk/catalog/src/main/java/org/apache/oodt/cas/catalog/struct/QueryService.java Copied: incubator/oodt/trunk/catalog/src/main/java/org/apache/oodt/cas/catalog/query/QueryService.java (from r963466, incubator/oodt/trunk/catalog/src/main/java/org/apache/oodt/cas/catalog/struct/QueryService.java) URL: http://svn.apache.org/viewvc/incubator/oodt/trunk/catalog/src/main/java/org/apache/oodt/cas/catalog/query/QueryService.java?p2=incubator/oodt/trunk/catalog/src/main/java/org/apache/oodt/cas/catalog/query/QueryService.java&p1=incubator/oodt/trunk/catalog/src/main/java/org/apache/oodt/cas/catalog/struct/QueryService.java&r1=963466&r2=963474&rev=963474&view=diff ============================================================================== --- incubator/oodt/trunk/catalog/src/main/java/org/apache/oodt/cas/catalog/struct/QueryService.java (original) +++ incubator/oodt/trunk/catalog/src/main/java/org/apache/oodt/cas/catalog/query/QueryService.java Mon Jul 12 20:26:33 2010 @@ -1,4 +1,4 @@ -/* +/** * Licensed to the Apache Software Foundation (ASF) under one or more * contributor license agreements. See the NOTICE file distributed with * this work for additional information regarding copyright ownership. @@ -23,43 +23,49 @@ import java.util.Map; //OODT imports import org.apache.oodt.cas.catalog.exception.QueryServiceException; -import org.apache.oodt.cas.catalog.page.IngestReceipt; -import org.apache.oodt.cas.catalog.page.TransactionReceipt; +import org.apache.oodt.cas.catalog.pagination.IngestReceipt; +import org.apache.oodt.cas.catalog.pagination.TransactionReceipt; import org.apache.oodt.cas.catalog.query.QueryExpression; import org.apache.oodt.cas.catalog.term.TermBucket; /** - * @author bfoster - * @version $Revision$ - * - *

- * A Interface for performing queries to a Catalog - *

+ * + * An interface for performing queries to a Catalog. + * */ public interface QueryService { - /** - * Returns all the TransactionIds that fall under the given query - * @param query The query for TransactionIds - * @return Returns a List of TransactionIds that meet the query, otherwise - * an empty List is no TransactionIds are found for the given query - */ - public List query(QueryExpression queryExpression) throws QueryServiceException; - - /** - * Returns a List of TermBuckets ingested for a given TransactionId - * @param transactionId The TransactionId in question - * @return A List of TermBuckets for the given TransactionId or empty list - * if no record of the give TranactionId exists - */ - public List getBuckets(TransactionId transactionId) throws QueryServiceException; - - /** - * Does the same as getBuckets(TransactionId), except is performed over a list - * of TransactionIds - * @param transactionIds A List of TransactionIds for which TermBuckets are wanted - * @return A Map of TransactionIds to TermBuckets - */ - public Map, List> getBuckets(List> transactionIds) throws QueryServiceException; + /** + * Returns all the TransactionIds that fall under the given query + * + * @param query + * The query for TransactionIds + * @return Returns a List of TransactionIds that meet the query, otherwise an + * empty List is no TransactionIds are found for the given query + */ + public List query(QueryExpression queryExpression) + throws QueryServiceException; + + /** + * Returns a List of TermBuckets ingested for a given TransactionId + * + * @param transactionId + * The TransactionId in question + * @return A List of TermBuckets for the given TransactionId or empty list if + * no record of the give TranactionId exists + */ + public List getBuckets(TransactionId transactionId) + throws QueryServiceException; + + /** + * Does the same as getBuckets(TransactionId), except is performed over a list + * of TransactionIds + * + * @param transactionIds + * A List of TransactionIds for which TermBuckets are wanted + * @return A Map of TransactionIds to TermBuckets + */ + public Map, List> getBuckets( + List> transactionIds) throws QueryServiceException; }