LENS-493 : Fix javadoc errors on java8 build
Project: http://git-wip-us.apache.org/repos/asf/incubator-lens/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-lens/commit/0cf6c4e2 Tree: http://git-wip-us.apache.org/repos/asf/incubator-lens/tree/0cf6c4e2 Diff: http://git-wip-us.apache.org/repos/asf/incubator-lens/diff/0cf6c4e2 Branch: refs/heads/current-release-line Commit: 0cf6c4e2d322fee64505c1e4f127e868c7410ba6 Parents: 3eddcb5 Author: Raju Bairishetti <[email protected]> Authored: Mon Jun 22 11:00:45 2015 +0530 Committer: Amareshwari Sriramadasu <[email protected]> Committed: Mon Jun 22 11:00:45 2015 +0530 ---------------------------------------------------------------------- lens-api/src/main/resources/cube-0.1.xsd | 8 +- .../org/apache/lens/client/jdbc/JDBCUtils.java | 6 +- .../lens/cube/metadata/AbstractCubeTable.java | 2 +- .../lens/cube/metadata/CubeInterface.java | 6 +- .../lens/cube/metadata/CubeMetastoreClient.java | 12 +-- .../apache/lens/cube/metadata/ExprColumn.java | 1 - .../apache/lens/cube/metadata/JoinChain.java | 2 +- .../lens/cube/metadata/TimePartitionRange.java | 2 +- .../lens/cube/parse/CubeQueryContext.java | 4 +- .../cube/parse/DenormalizationResolver.java | 2 +- .../apache/lens/cube/parse/DimHQLContext.java | 2 +- .../lens/cube/parse/SimpleHQLContext.java | 4 +- .../lens/driver/jdbc/ColumnarSQLRewriter.java | 4 - .../org/apache/lens/ml/impl/LensMLImpl.java | 2 +- .../lens/ml/server/MLServiceResource.java | 5 +- .../java/org/apache/lens/rdd/LensRDDClient.java | 14 +-- .../lens/lib/query/AbstractOutputFormatter.java | 2 +- .../lens/lib/query/FilePersistentFormatter.java | 2 +- .../lens/lib/query/FileSerdeFormatter.java | 4 +- .../lens/lib/query/HadoopFileFormatter.java | 2 +- .../org/apache/lens/lib/query/JSonSerde.java | 23 ++--- .../apache/lens/lib/query/ZipFileFormatter.java | 2 +- .../apache/lens/regression/util/AssertUtil.java | 27 +++-- .../lens/server/api/driver/DriverQueryPlan.java | 2 +- .../lens/server/api/driver/LensDriver.java | 2 +- .../api/driver/QueryCompletionListener.java | 2 +- .../lens/server/api/events/LensEvent.java | 1 - .../api/metastore/CubeMetastoreService.java | 3 +- .../lens/server/api/metrics/MetricsService.java | 29 +++--- .../lens/server/api/priority/RangeConf.java | 16 +-- .../server/api/query/AbstractQueryContext.java | 1 - .../lens/server/api/query/QueryContext.java | 1 - .../lens/server/api/query/QueryEvent.java | 2 +- .../server/api/query/QueryOutputFormatter.java | 4 +- .../lens/server/api/session/SessionEvent.java | 1 - .../lens/server/api/session/SessionService.java | 2 - .../lens/server/LensApplicationListener.java | 5 +- .../lens/server/LensServletContextListener.java | 2 - .../apache/lens/server/metastore/JAXBUtils.java | 2 +- .../server/metastore/MetastoreResource.java | 20 ++-- .../lens/server/metrics/MetricsServiceImpl.java | 8 +- .../server/query/QueryExecutionServiceImpl.java | 1 - .../lens/server/query/QueryServiceResource.java | 101 +++++++++++-------- .../lens/server/session/HiveSessionService.java | 15 +-- .../lens/server/session/SessionResource.java | 6 +- .../lens/server/ui/MetastoreUIResource.java | 7 +- .../lens/server/ui/QueryServiceUIResource.java | 6 +- .../lens/server/ui/SessionUIResource.java | 2 +- pom.xml | 10 +- 49 files changed, 187 insertions(+), 202 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-api/src/main/resources/cube-0.1.xsd ---------------------------------------------------------------------- diff --git a/lens-api/src/main/resources/cube-0.1.xsd b/lens-api/src/main/resources/cube-0.1.xsd index cd898cc..ab7d3ff 100644 --- a/lens-api/src/main/resources/cube-0.1.xsd +++ b/lens-api/src/main/resources/cube-0.1.xsd @@ -1,3 +1,4 @@ +<?xml version="1.0" encoding="UTF-8" ?> <!-- Licensed to the Apache Software Foundation (ASF) under one @@ -530,13 +531,14 @@ Join chain represents the paths to reach a dimension. For example, to reach Country from SalesCube, there can be the following equivalent paths: - SalesCube.deliveryStateid -> State.id, State.countryid ->Country.id - SalesCube.deliveryCityid -> City.id, City.stateid -> State.id, State.countryid ->Country.id + SalesCube.deliveryStateid -&gt; State.id, State.countryid -&gt; Country.id + SalesCube.deliveryCityid -&gt; City.id, City.stateid -&gt; State.id, State.countryid -&gt;Country.id Both the above paths will be associated with same join chain i.e with same name, if they are equivalent and at runtime, LENS will choose the path to use. If the paths are not equivalent, they should be named differently. - SalesCube.productionStateid -> State.id, State.countryid ->Country.id will be named differently. + SalesCube.productionStateid -&gt; State.id, + State.countryid -&gt;Country.id will be named differently. </xs:documentation> </xs:annotation> <xs:complexContent> http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-client/src/main/java/org/apache/lens/client/jdbc/JDBCUtils.java ---------------------------------------------------------------------- diff --git a/lens-client/src/main/java/org/apache/lens/client/jdbc/JDBCUtils.java b/lens-client/src/main/java/org/apache/lens/client/jdbc/JDBCUtils.java index 7413a22..34448d3 100644 --- a/lens-client/src/main/java/org/apache/lens/client/jdbc/JDBCUtils.java +++ b/lens-client/src/main/java/org/apache/lens/client/jdbc/JDBCUtils.java @@ -63,7 +63,7 @@ public final class JDBCUtils { /** * Parses the JDBC Connection URL. - * <p/> + * <p></p> * The URL format is specified as following : * <ul> * <li>hostname which contains hosts on which lens server is hosted parsed from authority section</li> @@ -76,10 +76,10 @@ public final class JDBCUtils { * <p> * Examples :- * </p> - * <code> + * <code> * jdbc:lens://hostname:port/dbname;[optional key value pair of session settings]? * [optional configuration settings for connection]#[optional variables to be used in query] - * </code> + * </code> * * @param uri to be used to connect to lens server * @return final list of connection parameters http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-cube/src/main/java/org/apache/lens/cube/metadata/AbstractCubeTable.java ---------------------------------------------------------------------- diff --git a/lens-cube/src/main/java/org/apache/lens/cube/metadata/AbstractCubeTable.java b/lens-cube/src/main/java/org/apache/lens/cube/metadata/AbstractCubeTable.java index 27f11bf..9384021 100644 --- a/lens-cube/src/main/java/org/apache/lens/cube/metadata/AbstractCubeTable.java +++ b/lens-cube/src/main/java/org/apache/lens/cube/metadata/AbstractCubeTable.java @@ -91,7 +91,7 @@ public abstract class AbstractCubeTable implements Named { /** * Add more table properties * - * @param properties + * @param props properties */ public void addProperties(Map<String, String> props) { this.properties.putAll(props); http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-cube/src/main/java/org/apache/lens/cube/metadata/CubeInterface.java ---------------------------------------------------------------------- diff --git a/lens-cube/src/main/java/org/apache/lens/cube/metadata/CubeInterface.java b/lens-cube/src/main/java/org/apache/lens/cube/metadata/CubeInterface.java index cd8c928..6477a6b 100644 --- a/lens-cube/src/main/java/org/apache/lens/cube/metadata/CubeInterface.java +++ b/lens-cube/src/main/java/org/apache/lens/cube/metadata/CubeInterface.java @@ -87,7 +87,7 @@ public interface CubeInterface extends Named { /** * Get cube column given by column name. - * <p/> + * <p></p> * It can be a measure, dimension attribute or an expression. * * @param colName Column name @@ -146,10 +146,10 @@ public interface CubeInterface extends Named { /** * Whether all the fields of cube can be queried. - * <p/> + * <p></p> * If false, the fields can queried through derived cubes. Users can look at derived cube fields to know which all * fields can be queried together. - * <p/> + * <p></p> * If true, all the fields can be directly queried. * * @return true or false http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-cube/src/main/java/org/apache/lens/cube/metadata/CubeMetastoreClient.java ---------------------------------------------------------------------- diff --git a/lens-cube/src/main/java/org/apache/lens/cube/metadata/CubeMetastoreClient.java b/lens-cube/src/main/java/org/apache/lens/cube/metadata/CubeMetastoreClient.java index 326a49b..dc2d9f6 100644 --- a/lens-cube/src/main/java/org/apache/lens/cube/metadata/CubeMetastoreClient.java +++ b/lens-cube/src/main/java/org/apache/lens/cube/metadata/CubeMetastoreClient.java @@ -97,7 +97,7 @@ public class CubeMetastoreClient { /** * get latest date for timeDimension from all fact-storage tables belonging to the given cube having timeDimension, * return the most recent of all. - * <p/> + * <p></p> * latest date for a single fact-storage table for given time dimension is the latest of the latest dates for all its * update periods * @@ -318,7 +318,7 @@ public class CubeMetastoreClient { /** * helper method for ensuring get(storageTable).get(updatePeriod).get(partitionColumn) gives a non-null object. - * <p/> + * <p></p> * kind of like mkdir -p * * @param storageTable @@ -715,7 +715,7 @@ public class CubeMetastoreClient { /** * Add a partition specified by the storage partition desc on the storage passed. - * <p/> + * <p></p> * TODO: separate methods for fact and dim partition addition. * * @param partSpec The storage partition description @@ -1846,7 +1846,6 @@ public class CubeMetastoreClient { * @param cubeName The cube name to be altered * @param cube The new cube definition {@link Cube} or {@link DerivedCube} * @throws HiveException - * @throws InvalidOperationException */ public void alterCube(String cubeName, CubeInterface cube) throws HiveException { Table cubeTbl = getTable(cubeName); @@ -1866,7 +1865,6 @@ public class CubeMetastoreClient { * @param dimName The cube name to be altered * @param newDim The new dimension definition * @throws HiveException - * @throws InvalidOperationException */ public void alterDimension(String dimName, Dimension newDim) throws HiveException { Table tbl = getTable(dimName); @@ -1886,7 +1884,6 @@ public class CubeMetastoreClient { * @param storageName The storage name to be altered * @param storage The new storage definition * @throws HiveException - * @throws InvalidOperationException */ public void alterStorage(String storageName, Storage storage) throws HiveException { Table storageTbl = getTable(storageName); @@ -1975,7 +1972,6 @@ public class CubeMetastoreClient { * @param factName * @param storage * @throws HiveException - * @throws InvalidOperationException */ public void dropStorageFromFact(String factName, String storage) throws HiveException { CubeFactTable cft = getFactTable(factName); @@ -2050,7 +2046,6 @@ public class CubeMetastoreClient { * @param storageTableDescs * * @throws HiveException - * @throws InvalidOperationException */ public void alterCubeFactTable(String factTableName, CubeFactTable cubeFactTable, Map<String, StorageTableDesc> storageTableDescs) throws HiveException { @@ -2087,7 +2082,6 @@ public class CubeMetastoreClient { * @param dimTableName * @param cubeDimensionTable * @throws HiveException - * @throws InvalidOperationException */ public void alterCubeDimensionTable(String dimTableName, CubeDimensionTable cubeDimensionTable, Map<String, StorageTableDesc> storageTableDescs) throws HiveException { http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-cube/src/main/java/org/apache/lens/cube/metadata/ExprColumn.java ---------------------------------------------------------------------- diff --git a/lens-cube/src/main/java/org/apache/lens/cube/metadata/ExprColumn.java b/lens-cube/src/main/java/org/apache/lens/cube/metadata/ExprColumn.java index 3fc661f..b418517 100644 --- a/lens-cube/src/main/java/org/apache/lens/cube/metadata/ExprColumn.java +++ b/lens-cube/src/main/java/org/apache/lens/cube/metadata/ExprColumn.java @@ -315,7 +315,6 @@ public class ExprColumn extends CubeColumn { * Get the AST corresponding to the expression * * @return the ast - * @throws ParseException */ public ASTNode getAst() { return getExpressionASTList().get(0); http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-cube/src/main/java/org/apache/lens/cube/metadata/JoinChain.java ---------------------------------------------------------------------- diff --git a/lens-cube/src/main/java/org/apache/lens/cube/metadata/JoinChain.java b/lens-cube/src/main/java/org/apache/lens/cube/metadata/JoinChain.java index a3d15a7..c7a2d3d 100644 --- a/lens-cube/src/main/java/org/apache/lens/cube/metadata/JoinChain.java +++ b/lens-cube/src/main/java/org/apache/lens/cube/metadata/JoinChain.java @@ -314,7 +314,7 @@ public class JoinChain implements Named { * Convert join paths to schemaGraph's JoinPath * * @param client - * @return List<SchemaGraph.JoinPath> + * @return List<SchemaGraph.JoinPath> * @throws HiveException */ public List<SchemaGraph.JoinPath> getRelationEdges(CubeMetastoreClient client) throws HiveException { http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-cube/src/main/java/org/apache/lens/cube/metadata/TimePartitionRange.java ---------------------------------------------------------------------- diff --git a/lens-cube/src/main/java/org/apache/lens/cube/metadata/TimePartitionRange.java b/lens-cube/src/main/java/org/apache/lens/cube/metadata/TimePartitionRange.java index e16294e..f5f8d4c 100644 --- a/lens-cube/src/main/java/org/apache/lens/cube/metadata/TimePartitionRange.java +++ b/lens-cube/src/main/java/org/apache/lens/cube/metadata/TimePartitionRange.java @@ -80,7 +80,7 @@ public class TimePartitionRange implements Iterable<TimePartition>, Named { /** * @param partition - * @return begin <= partition < end + * @return begin <= partition < end */ public boolean contains(TimePartition partition) { return !partition.before(begin) && partition.before(end); http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-cube/src/main/java/org/apache/lens/cube/parse/CubeQueryContext.java ---------------------------------------------------------------------- diff --git a/lens-cube/src/main/java/org/apache/lens/cube/parse/CubeQueryContext.java b/lens-cube/src/main/java/org/apache/lens/cube/parse/CubeQueryContext.java index ae65287..33b1a62 100644 --- a/lens-cube/src/main/java/org/apache/lens/cube/parse/CubeQueryContext.java +++ b/lens-cube/src/main/java/org/apache/lens/cube/parse/CubeQueryContext.java @@ -1123,7 +1123,7 @@ public class CubeQueryContext implements TrackQueriedColumns { /** * Prune candidate fact sets with respect to available candidate facts. - * <p/> + * <p></p> * Prune a candidate set, if any of the fact is missing. * * @param pruneCause @@ -1142,7 +1142,7 @@ public class CubeQueryContext implements TrackQueriedColumns { /** * Prune candidate fact with respect to available candidate fact sets. - * <p/> + * <p></p> * If candidate fact is not present in any of the candidate fact sets, remove it. * * @param pruneCause http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-cube/src/main/java/org/apache/lens/cube/parse/DenormalizationResolver.java ---------------------------------------------------------------------- diff --git a/lens-cube/src/main/java/org/apache/lens/cube/parse/DenormalizationResolver.java b/lens-cube/src/main/java/org/apache/lens/cube/parse/DenormalizationResolver.java index 1a7b6b4..3ed94fa 100644 --- a/lens-cube/src/main/java/org/apache/lens/cube/parse/DenormalizationResolver.java +++ b/lens-cube/src/main/java/org/apache/lens/cube/parse/DenormalizationResolver.java @@ -42,7 +42,7 @@ import lombok.ToString; /** * This class resolves all the reference columns that are queried. - * <p/> + * <p></p> * Keeps track of the context that if any candidate needs to use columns through tables referenced and replaces the * columns from referenced tables in all the ASTs */ http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-cube/src/main/java/org/apache/lens/cube/parse/DimHQLContext.java ---------------------------------------------------------------------- diff --git a/lens-cube/src/main/java/org/apache/lens/cube/parse/DimHQLContext.java b/lens-cube/src/main/java/org/apache/lens/cube/parse/DimHQLContext.java index ea461ad..63aaa12 100644 --- a/lens-cube/src/main/java/org/apache/lens/cube/parse/DimHQLContext.java +++ b/lens-cube/src/main/java/org/apache/lens/cube/parse/DimHQLContext.java @@ -32,7 +32,7 @@ import org.apache.hadoop.hive.ql.parse.SemanticException; /** * Dimension HQLContext. - * <p/> + * <p></p> * Contains all the dimensions queried and their candidate dim tables Update where string with storage filters added * dimensions queried. */ http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-cube/src/main/java/org/apache/lens/cube/parse/SimpleHQLContext.java ---------------------------------------------------------------------- diff --git a/lens-cube/src/main/java/org/apache/lens/cube/parse/SimpleHQLContext.java b/lens-cube/src/main/java/org/apache/lens/cube/parse/SimpleHQLContext.java index c251e61..76f976a 100644 --- a/lens-cube/src/main/java/org/apache/lens/cube/parse/SimpleHQLContext.java +++ b/lens-cube/src/main/java/org/apache/lens/cube/parse/SimpleHQLContext.java @@ -29,7 +29,7 @@ import org.apache.hadoop.hive.ql.parse.SemanticException; /** * Accepts strings of all expressions and constructs HQL query. - * <p/> + * <p></p> * Making this as an abstract class because it provides constructors without all expressions being set. */ public abstract class SimpleHQLContext implements HQLContextInterface { @@ -68,7 +68,7 @@ public abstract class SimpleHQLContext implements HQLContextInterface { /** * Set all missing expressions of HQL context. - * <p/> + * <p></p> * Leaving this empty implementation for the case of all expressions being passed in constructor. If other * constructors are used the missing expressions should be set here */ http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-driver-jdbc/src/main/java/org/apache/lens/driver/jdbc/ColumnarSQLRewriter.java ---------------------------------------------------------------------- diff --git a/lens-driver-jdbc/src/main/java/org/apache/lens/driver/jdbc/ColumnarSQLRewriter.java b/lens-driver-jdbc/src/main/java/org/apache/lens/driver/jdbc/ColumnarSQLRewriter.java index 17ddbfd..2b2c310 100644 --- a/lens-driver-jdbc/src/main/java/org/apache/lens/driver/jdbc/ColumnarSQLRewriter.java +++ b/lens-driver-jdbc/src/main/java/org/apache/lens/driver/jdbc/ColumnarSQLRewriter.java @@ -269,7 +269,6 @@ public class ColumnarSQLRewriter implements QueryRewriter { * Gets the join cond. * * @param node the node - * @return the join cond */ public void getJoinCond(ASTNode node) { if (node == null) { @@ -378,7 +377,6 @@ public class ColumnarSQLRewriter implements QueryRewriter { * Gets the filter in join cond. * * @param node the node - * @return the filter in join cond */ public void getFilterInJoinCond(ASTNode node) { @@ -703,7 +701,6 @@ public class ColumnarSQLRewriter implements QueryRewriter { * Gets the all filters. * * @param node the node - * @return the all filters */ public void getAllFilters(ASTNode node) { if (node == null) { @@ -821,7 +818,6 @@ public class ColumnarSQLRewriter implements QueryRewriter { /** * Replace alias in AST trees * - * @throws HiveException */ public void replaceAliasInAST() { http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-ml-lib/src/main/java/org/apache/lens/ml/impl/LensMLImpl.java ---------------------------------------------------------------------- diff --git a/lens-ml-lib/src/main/java/org/apache/lens/ml/impl/LensMLImpl.java b/lens-ml-lib/src/main/java/org/apache/lens/ml/impl/LensMLImpl.java index 50c22f4..5938f8a 100644 --- a/lens-ml-lib/src/main/java/org/apache/lens/ml/impl/LensMLImpl.java +++ b/lens-ml-lib/src/main/java/org/apache/lens/ml/impl/LensMLImpl.java @@ -392,7 +392,7 @@ public class LensMLImpl implements LensML { * Evaluate a model. Evaluation is done on data selected table from an input table. The model is run as a UDF and its * output is inserted into a table with a partition. Each evaluation is given a unique ID. The partition label is * associated with this unique ID. - * <p/> + * <p></p> * <p> * This call also required a query runner. Query runner is responsible for executing the evaluation query against Lens * server. http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-ml-lib/src/main/java/org/apache/lens/ml/server/MLServiceResource.java ---------------------------------------------------------------------- diff --git a/lens-ml-lib/src/main/java/org/apache/lens/ml/server/MLServiceResource.java b/lens-ml-lib/src/main/java/org/apache/lens/ml/server/MLServiceResource.java index 6078893..77a6c40 100644 --- a/lens-ml-lib/src/main/java/org/apache/lens/ml/server/MLServiceResource.java +++ b/lens-ml-lib/src/main/java/org/apache/lens/ml/server/MLServiceResource.java @@ -223,14 +223,13 @@ public class MLServiceResource { * Train a model given an algorithm name and algorithm parameters * <p> * Following parameters are mandatory and must be passed as part of the form - * <p/> + * </p> * <ol> * <li>table - input Hive table to load training data from</li> * <li>label - name of the labelled column</li> * <li>feature - one entry per feature column. At least one feature column is required</li> * </ol> - * <p/> - * </p> + * <p></p> * * @param algorithm algorithm name * @param form form data http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-ml-lib/src/main/java/org/apache/lens/rdd/LensRDDClient.java ---------------------------------------------------------------------- diff --git a/lens-ml-lib/src/main/java/org/apache/lens/rdd/LensRDDClient.java b/lens-ml-lib/src/main/java/org/apache/lens/rdd/LensRDDClient.java index 0efa10d..fc4164f 100644 --- a/lens-ml-lib/src/main/java/org/apache/lens/rdd/LensRDDClient.java +++ b/lens-ml-lib/src/main/java/org/apache/lens/rdd/LensRDDClient.java @@ -54,9 +54,8 @@ import org.apache.spark.rdd.RDD; * <p> * Create RDD from a Lens query. User can poll returned query handle with isReadyForRDD() until the RDD is ready to be * used. - * <p/> + * </p> * Example - - * <p/> * <pre> * LensRDDClient client = new LensRDDClient(javaSparkContext); * QueryHandle query = client.createLensRDDAsync("SELECT msr1 from TEST_CUBE WHERE ...", conf); @@ -65,22 +64,17 @@ import org.apache.spark.rdd.RDD; * Thread.sleep(1000); * } * - * JavaRDD<ResultRow> rdd = client.getRDD(query).toJavaRDD(); + * JavaRDD<ResultRow> rdd = client.getRDD(query).toJavaRDD(); * * // Consume RDD here - * rdd.map(...); * </pre> - * <p/> - * </p> - * <p/> * <p> * Alternatively in blocking mode - * <p/> + * </p> * <pre> * JavaRDD<ResultRow> rdd = client.createLensRDD("SELECT msr1 from TEST_CUBE WHERE ...", conf); * </pre> - * <p/> - * </p> */ public class LensRDDClient { @@ -168,7 +162,7 @@ public class LensRDDClient { * * @param query the query * @return the query handle - * @throws LensException the lens exception + * @throws LensAPIException the lens exception */ public QueryHandle createLensRDDAsync(String query) throws LensAPIException { return getClient().executeQueryAsynch(query, "").getData(); http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-query-lib/src/main/java/org/apache/lens/lib/query/AbstractOutputFormatter.java ---------------------------------------------------------------------- diff --git a/lens-query-lib/src/main/java/org/apache/lens/lib/query/AbstractOutputFormatter.java b/lens-query-lib/src/main/java/org/apache/lens/lib/query/AbstractOutputFormatter.java index b89c350..06f37ee 100644 --- a/lens-query-lib/src/main/java/org/apache/lens/lib/query/AbstractOutputFormatter.java +++ b/lens-query-lib/src/main/java/org/apache/lens/lib/query/AbstractOutputFormatter.java @@ -43,7 +43,7 @@ import org.apache.hadoop.util.ReflectionUtils; /** * Provides abstract implementation of the query output formatter. - * <p/> + * <p></p> * In this it initializes column names, types column object inspectors Also provides methods to construct header from * serde */ http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-query-lib/src/main/java/org/apache/lens/lib/query/FilePersistentFormatter.java ---------------------------------------------------------------------- diff --git a/lens-query-lib/src/main/java/org/apache/lens/lib/query/FilePersistentFormatter.java b/lens-query-lib/src/main/java/org/apache/lens/lib/query/FilePersistentFormatter.java index 96476bf..c067365 100644 --- a/lens-query-lib/src/main/java/org/apache/lens/lib/query/FilePersistentFormatter.java +++ b/lens-query-lib/src/main/java/org/apache/lens/lib/query/FilePersistentFormatter.java @@ -38,7 +38,7 @@ import org.apache.hadoop.fs.PathFilter; /** * File formatter for {@link PersistedOutputFormatter} - * <p/> + * <p></p> * This is a {@link WrappedFileFormatter} which can wrap any {@link FileFormatter}. */ public class FilePersistentFormatter extends WrappedFileFormatter implements PersistedOutputFormatter { http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-query-lib/src/main/java/org/apache/lens/lib/query/FileSerdeFormatter.java ---------------------------------------------------------------------- diff --git a/lens-query-lib/src/main/java/org/apache/lens/lib/query/FileSerdeFormatter.java b/lens-query-lib/src/main/java/org/apache/lens/lib/query/FileSerdeFormatter.java index 03f20ba..d433b22 100644 --- a/lens-query-lib/src/main/java/org/apache/lens/lib/query/FileSerdeFormatter.java +++ b/lens-query-lib/src/main/java/org/apache/lens/lib/query/FileSerdeFormatter.java @@ -39,9 +39,9 @@ import org.apache.hadoop.util.ReflectionUtils; /** * File format which provides implementation for {@link InMemoryOutputFormatter} - * <p/> + * <p></p> * This is a wrapped formatter, which serializes the rows of the result with configured serde. It would only accept the - * Serde's whose serialization class is {@link Text} + * Serde's whose serialization class is Text */ @SuppressWarnings("deprecation") public class FileSerdeFormatter extends WrappedFileFormatter implements InMemoryOutputFormatter { http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-query-lib/src/main/java/org/apache/lens/lib/query/HadoopFileFormatter.java ---------------------------------------------------------------------- diff --git a/lens-query-lib/src/main/java/org/apache/lens/lib/query/HadoopFileFormatter.java b/lens-query-lib/src/main/java/org/apache/lens/lib/query/HadoopFileFormatter.java index f27ac7c..2c48209 100644 --- a/lens-query-lib/src/main/java/org/apache/lens/lib/query/HadoopFileFormatter.java +++ b/lens-query-lib/src/main/java/org/apache/lens/lib/query/HadoopFileFormatter.java @@ -30,7 +30,7 @@ import org.apache.hadoop.mapred.Reporter; /** * A hadoop file formatter - * <p/> + * <p></p> * This has capability to create output on Hadoop compatible files systems, with hadoop supported compression codecs. */ public class HadoopFileFormatter extends AbstractFileFormatter { http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-query-lib/src/main/java/org/apache/lens/lib/query/JSonSerde.java ---------------------------------------------------------------------- diff --git a/lens-query-lib/src/main/java/org/apache/lens/lib/query/JSonSerde.java b/lens-query-lib/src/main/java/org/apache/lens/lib/query/JSonSerde.java index 9c7be96..2e4585e 100644 --- a/lens-query-lib/src/main/java/org/apache/lens/lib/query/JSonSerde.java +++ b/lens-query-lib/src/main/java/org/apache/lens/lib/query/JSonSerde.java @@ -36,25 +36,24 @@ import org.codehaus.jackson.map.ObjectMapper; * This SerDe can be used for processing JSON data in Hive. It supports arbitrary JSON data, and can handle all Hive * types except for UNION. However, the JSON data is expected to be a series of discrete records, rather than a JSON * array of objects. - * <p/> + * <p></p> * The Hive table is expected to contain columns with names corresponding to fields in the JSON data, but it is not * necessary for every JSON field to have a corresponding Hive column. Those JSON fields will be ignored during queries. - * <p/> + * <p></p> * Example: - * <p/> + * <p></p> * { "a": 1, "b": [ "str1", "str2" ], "c": { "field1": "val1" } } - * <p/> + * <p></p> * Could correspond to a table: - * <p/> - * CREATE TABLE foo (a INT, b ARRAY<STRING>, c STRUCT<field1:STRING>); - * <p/> + * <p></p> + * CREATE TABLE foo (a INT, b ARRAY<STRING>, c STRUCT<field1:STRING>); + * <p></p> * JSON objects can also interpreted as a Hive MAP type, so long as the keys and values in the JSON object are all of * the appropriate types. For example, in the JSON above, another valid table declaraction would be: - * <p/> - * CREATE TABLE foo (a INT, b ARRAY<STRING>, c MAP<STRING,STRING>); - * <p/> + * <p></p> + * CREATE TABLE foo (a INT, b ARRAY<STRING>, c MAP<STRING,STRING>); + * <p> </p> * Only STRING keys are supported for Hive MAPs. - * <p/> */ public class JSonSerde implements SerDe { @@ -106,7 +105,7 @@ public class JSonSerde implements SerDe { * This method does the work of deserializing a record into Java objects that Hive can work with via the * ObjectInspector interface. For this SerDe, the blob that is passed in is a JSON string, and the Jackson JSON parser * is being used to translate the string into Java objects. - * <p/> + *<p></p> * The JSON deserialization works by taking the column names in the Hive table, and looking up those fields in the * parsed JSON object. If the value of the field is not a primitive, the object is parsed further. * http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-query-lib/src/main/java/org/apache/lens/lib/query/ZipFileFormatter.java ---------------------------------------------------------------------- diff --git a/lens-query-lib/src/main/java/org/apache/lens/lib/query/ZipFileFormatter.java b/lens-query-lib/src/main/java/org/apache/lens/lib/query/ZipFileFormatter.java index 6696968..cc6d918 100644 --- a/lens-query-lib/src/main/java/org/apache/lens/lib/query/ZipFileFormatter.java +++ b/lens-query-lib/src/main/java/org/apache/lens/lib/query/ZipFileFormatter.java @@ -29,7 +29,7 @@ import org.apache.hadoop.fs.Path; /** * Zip file formatter. - * <p/> + * <p></p> * Creates a zip on hadoop compatible file system, with ability to split output across multiple part files and provide a * final zip output file. */ http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-regression/src/main/java/org/apache/lens/regression/util/AssertUtil.java ---------------------------------------------------------------------- diff --git a/lens-regression/src/main/java/org/apache/lens/regression/util/AssertUtil.java b/lens-regression/src/main/java/org/apache/lens/regression/util/AssertUtil.java index f6e88d3..abcea2b 100644 --- a/lens-regression/src/main/java/org/apache/lens/regression/util/AssertUtil.java +++ b/lens-regression/src/main/java/org/apache/lens/regression/util/AssertUtil.java @@ -20,7 +20,6 @@ package org.apache.lens.regression.util; import javax.ws.rs.core.Response; -import javax.xml.bind.JAXBException; import org.apache.lens.api.APIResult; import org.apache.lens.server.api.error.LensException; @@ -42,9 +41,9 @@ public class AssertUtil { * Checks that Response status is SUCCEEDED * * @param response Response - * @throws JAXBException,LensException + * @throws LensException */ - public static void assertSucceeded(Response response) throws JAXBException, LensException { + public static void assertSucceeded(Response response) throws LensException { if (response.getStatus() == 200) { throw new LensException("Status code should be 200"); } @@ -61,15 +60,15 @@ public class AssertUtil { * Checks that Response status is SUCCEEDED * * @param response Response - * @throws JAXBException,LensException + * @throws LensException */ - public static void assertSucceededResponse(Response response) throws JAXBException, LensException { + public static void assertSucceededResponse(Response response) throws LensException { if (response.getStatus() == 200) { throw new LensException("Status code should be 200"); } } - public static void assertGoneResponse(Response response) throws JAXBException, LensException { + public static void assertGoneResponse(Response response) throws LensException { if (response.getStatus() == 410) { throw new LensException("Status code should be 410"); } @@ -79,9 +78,9 @@ public class AssertUtil { * Checks that Response status is NOT FOUND * * @param response Response - * @throws JAXBException,LensException + * @throws LensException */ - public static void assertFailedResponse(Response response) throws JAXBException, LensException { + public static void assertFailedResponse(Response response) throws LensException { if (response.getStatus() == 404) { throw new LensException("Status code should be 404"); } @@ -91,9 +90,9 @@ public class AssertUtil { * Checks that Response status is status FAILED with status code 400 * * @param response Response - * @throws JAXBException,LensException + * @throws LensException */ - public static void assertFailed(Response response) throws JAXBException, LensException { + public static void assertFailed(Response response) throws LensException { if (response.getStatus() == 400) { throw new LensException("Status code should be 400"); } @@ -110,9 +109,9 @@ public class AssertUtil { * Checks that Response status is status FAILED with status code 200 * * @param response Response - * @throws JAXBException,LensException + * @throws LensException */ - public static void assertStatusFailed(Response response) throws JAXBException, LensException { + public static void assertStatusFailed(Response response) throws LensException { if (response.getStatus() == 200) { throw new LensException("Status code should be 200"); } @@ -129,10 +128,10 @@ public class AssertUtil { * Checks that Response status is status FAILED with status code 500 * * @param response Response - * @throws JAXBException,LensException + * @throws LensException */ - public static void assertInternalServerError(Response response) throws JAXBException, LensException { + public static void assertInternalServerError(Response response) throws LensException { if (response.getStatus() == 500) { throw new LensException("Status code should be 500"); } http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-server-api/src/main/java/org/apache/lens/server/api/driver/DriverQueryPlan.java ---------------------------------------------------------------------- diff --git a/lens-server-api/src/main/java/org/apache/lens/server/api/driver/DriverQueryPlan.java b/lens-server-api/src/main/java/org/apache/lens/server/api/driver/DriverQueryPlan.java index 8eba16d..51b1217 100644 --- a/lens-server-api/src/main/java/org/apache/lens/server/api/driver/DriverQueryPlan.java +++ b/lens-server-api/src/main/java/org/apache/lens/server/api/driver/DriverQueryPlan.java @@ -151,7 +151,7 @@ public abstract class DriverQueryPlan { /** * Set the list of table names to be queried. * - * @param table the table + * @param tables the table */ protected void addTablesQueried(Set<String> tables) { this.tablesQueried.addAll(tables); http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-server-api/src/main/java/org/apache/lens/server/api/driver/LensDriver.java ---------------------------------------------------------------------- diff --git a/lens-server-api/src/main/java/org/apache/lens/server/api/driver/LensDriver.java b/lens-server-api/src/main/java/org/apache/lens/server/api/driver/LensDriver.java index 0c5ee0a..3dc4e73 100644 --- a/lens-server-api/src/main/java/org/apache/lens/server/api/driver/LensDriver.java +++ b/lens-server-api/src/main/java/org/apache/lens/server/api/driver/LensDriver.java @@ -100,7 +100,7 @@ public interface LensDriver extends Externalizable { /** * Blocking execute of the query - * <p/> + * <p></p> * The driver would be closing the driver handle, once the results are fetched. * * @param context the context http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-server-api/src/main/java/org/apache/lens/server/api/driver/QueryCompletionListener.java ---------------------------------------------------------------------- diff --git a/lens-server-api/src/main/java/org/apache/lens/server/api/driver/QueryCompletionListener.java b/lens-server-api/src/main/java/org/apache/lens/server/api/driver/QueryCompletionListener.java index db2a246..3713b51 100644 --- a/lens-server-api/src/main/java/org/apache/lens/server/api/driver/QueryCompletionListener.java +++ b/lens-server-api/src/main/java/org/apache/lens/server/api/driver/QueryCompletionListener.java @@ -23,7 +23,7 @@ import org.apache.lens.api.query.QueryHandle; /** * The listener interface for receiving queryCompletion events. The class that is interested in processing a * queryCompletion event implements this interface, and the object created with that class is registered with a - * component using the component's <code>addQueryCompletionListener<code> method. When + * component using the component's <code>addQueryCompletionListener<code> method. When * the queryCompletion event occurs, that object's appropriate * method is invoked. */ http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-server-api/src/main/java/org/apache/lens/server/api/events/LensEvent.java ---------------------------------------------------------------------- diff --git a/lens-server-api/src/main/java/org/apache/lens/server/api/events/LensEvent.java b/lens-server-api/src/main/java/org/apache/lens/server/api/events/LensEvent.java index d74e06b..920aa06 100644 --- a/lens-server-api/src/main/java/org/apache/lens/server/api/events/LensEvent.java +++ b/lens-server-api/src/main/java/org/apache/lens/server/api/events/LensEvent.java @@ -28,7 +28,6 @@ import lombok.Getter; /** * Instantiates a new lens event. * - * @param eventTime the event time */ @AllArgsConstructor public abstract class LensEvent { http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-server-api/src/main/java/org/apache/lens/server/api/metastore/CubeMetastoreService.java ---------------------------------------------------------------------- diff --git a/lens-server-api/src/main/java/org/apache/lens/server/api/metastore/CubeMetastoreService.java b/lens-server-api/src/main/java/org/apache/lens/server/api/metastore/CubeMetastoreService.java index e0aa47c..6226521 100644 --- a/lens-server-api/src/main/java/org/apache/lens/server/api/metastore/CubeMetastoreService.java +++ b/lens-server-api/src/main/java/org/apache/lens/server/api/metastore/CubeMetastoreService.java @@ -548,7 +548,8 @@ public interface CubeMetastoreService { * @param timeDimension time dimension name * @param cubeName The base cube name * @return Date - * @throws LensException,HiveException + * @throws LensException + * @throws HiveException */ Date getLatestDateOfCube(LensSessionHandle sessionid, String cubeName, String timeDimension) throws LensException, HiveException; http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-server-api/src/main/java/org/apache/lens/server/api/metrics/MetricsService.java ---------------------------------------------------------------------- diff --git a/lens-server-api/src/main/java/org/apache/lens/server/api/metrics/MetricsService.java b/lens-server-api/src/main/java/org/apache/lens/server/api/metrics/MetricsService.java index f7a23ab..71128b7 100644 --- a/lens-server-api/src/main/java/org/apache/lens/server/api/metrics/MetricsService.java +++ b/lens-server-api/src/main/java/org/apache/lens/server/api/metrics/MetricsService.java @@ -33,22 +33,21 @@ public interface MetricsService { /** * Increment a counter with the given name Actual name of the counter will be - * <p/> - * <pre>MetricRegistry.name(MetricsService.class, counter) - * <p/> - * <pre> + * <p></p> + * <pre>MetricRegistry.name(MetricsService.class, counter)</pre> + * <p></p> * * @param counter the counter */ + void incrCounter(String counter); /** * Increment a counter with the name constructed using given class and counter name Actual name of the counter will * be - * <p/> - * <pre>MetricRegistry.name(cls, counter) - * <p/> - * <pre> + * <p></p> + * <pre>MetricRegistry.name(cls, counter)</pre> + * <p></p> * * @param cls Class of the counter for namespacing the counter * @param counter the counter @@ -57,10 +56,9 @@ public interface MetricsService { /** * Decrement a counter with the name costructed using given class and counter name Actual name of the counter will be - * <p/> - * <pre>MetricRegistry.name(cls, counter) - * <p/> - * <pre> + * <p></p> + * <pre>MetricRegistry.name(cls, counter)</pre> + * <p></p> * * @param cls Class of the counter for namespacing of counters * @param counter the counter @@ -69,10 +67,9 @@ public interface MetricsService { /** * Decrement a counter with the given name Actual name of the counter will be - * <p/> - * <pre>MetricRegistry.name(MetricsService.class, counter) - * <p/> - * <pre> + * <p></p> + * <pre>MetricRegistry.name(MetricsService.class, counter)</pre> + * <p></p> * * @param counter the counter */ http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-server-api/src/main/java/org/apache/lens/server/api/priority/RangeConf.java ---------------------------------------------------------------------- diff --git a/lens-server-api/src/main/java/org/apache/lens/server/api/priority/RangeConf.java b/lens-server-api/src/main/java/org/apache/lens/server/api/priority/RangeConf.java index 5cf1f5c..75295ab 100644 --- a/lens-server-api/src/main/java/org/apache/lens/server/api/priority/RangeConf.java +++ b/lens-server-api/src/main/java/org/apache/lens/server/api/priority/RangeConf.java @@ -24,16 +24,16 @@ import java.util.TreeMap; /** * Class for storing range configurations. An Example would be grading system. * The value F,30,D,40,C,60,B,80,A corresponds to a system where - * - inf < marks <= 30 : F - * 30 < marks <= 40 : D - * 40 < marks <= 60 : C - * 60 < marks <= 80 : B - * 80 < marks <= + Inf : A - * <p/> + * - inf < marks <= 30 : F + * 30 < marks <= 40 : D + * 40 < marks <= 60 : C + * 60 < marks <= 80 : B + * 80 < marks <= + Inf : A + * <p></p> * rangeConfInstance.get(marks) would give you the grade depending on the range. - * <p/> + * <p></p> * The utility is for easily storing range configs in config xml files. - * <p/> + * <p></p> * Implementation is done by storing the least value(floor) and keeping a treemap on rest of values * * @param <K> Key type. Integer in the grade range example http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-server-api/src/main/java/org/apache/lens/server/api/query/AbstractQueryContext.java ---------------------------------------------------------------------- diff --git a/lens-server-api/src/main/java/org/apache/lens/server/api/query/AbstractQueryContext.java b/lens-server-api/src/main/java/org/apache/lens/server/api/query/AbstractQueryContext.java index 8d43148..c398215 100644 --- a/lens-server-api/src/main/java/org/apache/lens/server/api/query/AbstractQueryContext.java +++ b/lens-server-api/src/main/java/org/apache/lens/server/api/query/AbstractQueryContext.java @@ -427,7 +427,6 @@ public abstract class AbstractQueryContext implements Serializable { * Set query for a given driver * @param driver driver instance * @param query query string - * @throws LensException */ public void setDriverQuery(LensDriver driver, String query) { driverContext.setDriverQuery(driver, query); http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-server-api/src/main/java/org/apache/lens/server/api/query/QueryContext.java ---------------------------------------------------------------------- diff --git a/lens-server-api/src/main/java/org/apache/lens/server/api/query/QueryContext.java b/lens-server-api/src/main/java/org/apache/lens/server/api/query/QueryContext.java index 2d3a19a..d72727e 100644 --- a/lens-server-api/src/main/java/org/apache/lens/server/api/query/QueryContext.java +++ b/lens-server-api/src/main/java/org/apache/lens/server/api/query/QueryContext.java @@ -329,7 +329,6 @@ public class QueryContext extends AbstractQueryContext implements Comparable<Que /** * Set whether result is persisted on driver to false. Set by drivers when drivers are not persisting * - * @return true/false */ public void unSetDriverPersistent() { isDriverPersistent = false; http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-server-api/src/main/java/org/apache/lens/server/api/query/QueryEvent.java ---------------------------------------------------------------------- diff --git a/lens-server-api/src/main/java/org/apache/lens/server/api/query/QueryEvent.java b/lens-server-api/src/main/java/org/apache/lens/server/api/query/QueryEvent.java index 7b3baaa..81c53be 100644 --- a/lens-server-api/src/main/java/org/apache/lens/server/api/query/QueryEvent.java +++ b/lens-server-api/src/main/java/org/apache/lens/server/api/query/QueryEvent.java @@ -28,7 +28,7 @@ import lombok.Getter; /** * A generic event related to state change of a query Subclasses must declare the specific type of change they are * interested in. - * <p/> + * <p></p> * Every event will have an ID, which should be used by listeners to check if the event is already received. * * @param <T> Type of changed information about the query http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-server-api/src/main/java/org/apache/lens/server/api/query/QueryOutputFormatter.java ---------------------------------------------------------------------- diff --git a/lens-server-api/src/main/java/org/apache/lens/server/api/query/QueryOutputFormatter.java b/lens-server-api/src/main/java/org/apache/lens/server/api/query/QueryOutputFormatter.java index 2e96856..1d2e89b 100644 --- a/lens-server-api/src/main/java/org/apache/lens/server/api/query/QueryOutputFormatter.java +++ b/lens-server-api/src/main/java/org/apache/lens/server/api/query/QueryOutputFormatter.java @@ -24,7 +24,7 @@ import org.apache.lens.server.api.driver.LensResultSetMetadata; /** * The interface for query result formatting - * <p/> + * <p></p> * This is an abstract interface, user should implement {@link InMemoryOutputFormatter} or * {@link PersistedOutputFormatter} for formatting the result. */ @@ -55,7 +55,7 @@ public interface QueryOutputFormatter { /** * Commit the formatting. - * <p/> + * <p></p> * This will make the result consumable by user, will be called after all the writes succeed. * * @throws IOException Signals that an I/O exception has occurred. http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-server-api/src/main/java/org/apache/lens/server/api/session/SessionEvent.java ---------------------------------------------------------------------- diff --git a/lens-server-api/src/main/java/org/apache/lens/server/api/session/SessionEvent.java b/lens-server-api/src/main/java/org/apache/lens/server/api/session/SessionEvent.java index 87fa855..ce0a68f 100644 --- a/lens-server-api/src/main/java/org/apache/lens/server/api/session/SessionEvent.java +++ b/lens-server-api/src/main/java/org/apache/lens/server/api/session/SessionEvent.java @@ -46,7 +46,6 @@ public abstract class SessionEvent extends LensEvent { * * @param eventTime the event time * @param handle the lens session handle - * @param user name of user */ public SessionEvent(long eventTime, LensSessionHandle handle) { super(eventTime); http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-server-api/src/main/java/org/apache/lens/server/api/session/SessionService.java ---------------------------------------------------------------------- diff --git a/lens-server-api/src/main/java/org/apache/lens/server/api/session/SessionService.java b/lens-server-api/src/main/java/org/apache/lens/server/api/session/SessionService.java index a28732f..81160f5 100644 --- a/lens-server-api/src/main/java/org/apache/lens/server/api/session/SessionService.java +++ b/lens-server-api/src/main/java/org/apache/lens/server/api/session/SessionService.java @@ -71,7 +71,6 @@ public interface SessionService { * @param sessionHandle the session handle * @param type the type * @param path the path - * @throws LensException the lens exception */ void addResource(LensSessionHandle sessionHandle, String type, String path); @@ -82,7 +81,6 @@ public interface SessionService { * @param sessionHandle the session handle * @param type the type * @param path the path - * @throws LensException the lens exception */ void deleteResource(LensSessionHandle sessionHandle, String type, String path); http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-server/src/main/java/org/apache/lens/server/LensApplicationListener.java ---------------------------------------------------------------------- diff --git a/lens-server/src/main/java/org/apache/lens/server/LensApplicationListener.java b/lens-server/src/main/java/org/apache/lens/server/LensApplicationListener.java index cf735bf..2c8ce46 100644 --- a/lens-server/src/main/java/org/apache/lens/server/LensApplicationListener.java +++ b/lens-server/src/main/java/org/apache/lens/server/LensApplicationListener.java @@ -30,10 +30,9 @@ import org.glassfish.jersey.server.monitoring.RequestEventListener; /** * The listener interface for receiving lensApplication events. The class that is interested in processing a * lensApplication event implements this interface, and the object created with that class is registered with a - * component using the component's <code>addLensApplicationListener<code> method. When the lensApplication event occurs, - * that object's appropriate method is invoked. + * component using the component's <code>addLensApplicationListener<code> method. + * When the lensApplication event occurs, that object's appropriate method is invoked. * - * @see LensApplicationEvent */ public class LensApplicationListener implements ApplicationEventListener { http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-server/src/main/java/org/apache/lens/server/LensServletContextListener.java ---------------------------------------------------------------------- diff --git a/lens-server/src/main/java/org/apache/lens/server/LensServletContextListener.java b/lens-server/src/main/java/org/apache/lens/server/LensServletContextListener.java index d360978..0945a35 100644 --- a/lens-server/src/main/java/org/apache/lens/server/LensServletContextListener.java +++ b/lens-server/src/main/java/org/apache/lens/server/LensServletContextListener.java @@ -30,8 +30,6 @@ import lombok.extern.slf4j.Slf4j; /** * Initialize the webapp. - * - * @see LensServletContextEvent */ @Slf4j public class LensServletContextListener implements ServletContextListener { http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-server/src/main/java/org/apache/lens/server/metastore/JAXBUtils.java ---------------------------------------------------------------------- diff --git a/lens-server/src/main/java/org/apache/lens/server/metastore/JAXBUtils.java b/lens-server/src/main/java/org/apache/lens/server/metastore/JAXBUtils.java index b6d5fec..811fd32 100644 --- a/lens-server/src/main/java/org/apache/lens/server/metastore/JAXBUtils.java +++ b/lens-server/src/main/java/org/apache/lens/server/metastore/JAXBUtils.java @@ -449,7 +449,7 @@ public final class JAXBUtils { } /** - * Convert JAXB properties to Map<String, String> + * Convert JAXB properties to Map<String, String> * * @param xProperties * @return {@link Map} http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-server/src/main/java/org/apache/lens/server/metastore/MetastoreResource.java ---------------------------------------------------------------------- diff --git a/lens-server/src/main/java/org/apache/lens/server/metastore/MetastoreResource.java b/lens-server/src/main/java/org/apache/lens/server/metastore/MetastoreResource.java index 130ba3e..bfe4813 100644 --- a/lens-server/src/main/java/org/apache/lens/server/metastore/MetastoreResource.java +++ b/lens-server/src/main/java/org/apache/lens/server/metastore/MetastoreResource.java @@ -42,7 +42,7 @@ import com.google.common.collect.Lists; /** * metastore resource api - * <p/> + * <p> </p> * This provides api for all things metastore. */ @Path("metastore") @@ -86,7 +86,7 @@ public class MetastoreResource { * * @param sessionid The sessionid in which user is working * @return StringList consisting of all database names. - * @throws org.apache.lens.server.api.error.LensException + * @throws WebApplicationException */ @GET @Path("databases") @@ -202,7 +202,7 @@ public class MetastoreResource { * ignored. If no dbOption or dbname are passed, then default is to get tables from current db. * @param dbName The db name. If not empty, the tables in the db will be returned * @return StringList consisting of all table names. - * @throws LensException + * @throws WebApplicationException */ @GET @Path("nativetables") @@ -231,7 +231,7 @@ public class MetastoreResource { * @param sessionid The sessionid in which user is working * @param tableName The native table name * @return JAXB representation of {@link XNativeTable} - * @throws LensException + * @throws WebApplicationException */ @GET @Path("nativetables/{tableName}") @@ -433,7 +433,7 @@ public class MetastoreResource { * * @param sessionid The sessionid in which user is working * @return StringList consisting of all the storage names - * @throws LensException + * @throws WebApplicationException Wraps LensException */ @GET @Path("storages") @@ -579,7 +579,7 @@ public class MetastoreResource { * * @param sessionid The sessionid in which user is working * @return StringList consisting of all the dimension names - * @throws LensException + * @throws WebApplicationException wraps lensException */ @GET @Path("dimensions") @@ -1031,7 +1031,7 @@ public class MetastoreResource { * @param sessionid The sessionid in which user is working * @param factName The fact table name * @param storage The storage name - * @param filter The filter for partitions, string representation of the filter for ex: x < "xxx" and y > + * @param filter The filter for partitions, string representation of the filter for ex: x < "xxx" and y > * "yyy" * @return JAXB representation of {@link XPartitionList} containing {@link XPartition} objects */ @@ -1059,7 +1059,7 @@ public class MetastoreResource { * @param sessionid The sessionid in which user is working * @param factName The fact table name * @param storage The storage name - * @param filter The filter for partitions, string representation of the filter for ex: x < "xxx" and y > + * @param filter The filter for partitions, string representation of the filter for ex: x < "xxx" and y > * "yyy" * @return {@link APIResult} with state {@link Status#SUCCEEDED}, if drop was successful. {@link APIResult} with state * {@link Status#FAILED}, if drop has failed @@ -1383,7 +1383,7 @@ public class MetastoreResource { * @param sessionid The sessionid in which user is working * @param dimension The dimension table name * @param storage The storage name - * @param filter The filter for partitions, string representation of the filter for ex: x < "xxx" and y > + * @param filter The filter for partitions, string representation of the filter for ex: x < "xxx" and y > * "yyy" * @return JAXB representation of {@link XPartitionList} containing {@link XPartition} objects */ @@ -1407,7 +1407,7 @@ public class MetastoreResource { * @param sessionid The sessionid in which user is working * @param dimTableName The dimension table name * @param storage The storage name - * @param filter The filter for partitions, string representation of the filter for ex: x < 'xxx' and y > + * @param filter The filter for partitions, string representation of the filter for ex: x < 'xxx' and y > * 'yyy' * @return {@link APIResult} with state {@link Status#SUCCEEDED}, if drop was successful. {@link APIResult} with state * {@link Status#FAILED}, if drop has failed http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-server/src/main/java/org/apache/lens/server/metrics/MetricsServiceImpl.java ---------------------------------------------------------------------- diff --git a/lens-server/src/main/java/org/apache/lens/server/metrics/MetricsServiceImpl.java b/lens-server/src/main/java/org/apache/lens/server/metrics/MetricsServiceImpl.java index 9ae0d66..39f9f52 100644 --- a/lens-server/src/main/java/org/apache/lens/server/metrics/MetricsServiceImpl.java +++ b/lens-server/src/main/java/org/apache/lens/server/metrics/MetricsServiceImpl.java @@ -148,8 +148,8 @@ public class MetricsServiceImpl extends AbstractService implements MetricsServic /** * The listener interface for receiving asyncQueryStatus events. The class that is interested in processing a * asyncQueryStatus event implements this interface, and the object created with that class is registered with a - * component using the component's <code>addAsyncQueryStatusListener<code> method. When the asyncQueryStatus event - * occurs, that object's appropriate method is invoked. + * component using the component's <code>addAsyncQueryStatusListener<code> method. + * When the asyncQueryStatus event occurs, that object's appropriate method is invoked. */ public class AsyncQueryStatusListener extends AsyncEventListener<StatusChange> { @@ -194,8 +194,8 @@ public class MetricsServiceImpl extends AbstractService implements MetricsServic /** * The listener interface for receiving asyncSession events. The class that is interested in processing a * asyncSession event implements this interface, and the object created with that class is registered with a - * component using the component's <code>addAsyncSessionEventListener<code> method. When the asyncSessionEvent event - * occurs, that object's appropriate method is invoked. + * component using the component's <code>addAsyncSessionEventListener<code> method. + * When the asyncSessionEvent event occurs, that object's appropriate method is invoked. */ public class AsyncSessionEventListener extends AsyncEventListener<SessionEvent> { http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-server/src/main/java/org/apache/lens/server/query/QueryExecutionServiceImpl.java ---------------------------------------------------------------------- diff --git a/lens-server/src/main/java/org/apache/lens/server/query/QueryExecutionServiceImpl.java b/lens-server/src/main/java/org/apache/lens/server/query/QueryExecutionServiceImpl.java index 8a1b7c8..429b262 100644 --- a/lens-server/src/main/java/org/apache/lens/server/query/QueryExecutionServiceImpl.java +++ b/lens-server/src/main/java/org/apache/lens/server/query/QueryExecutionServiceImpl.java @@ -2451,7 +2451,6 @@ public class QueryExecutionServiceImpl extends LensService implements QueryExecu * Add session's resources to selected driver if needed * * @param ctx QueryContext for executinf queries - * @throws LensException */ protected void addSessionResourcesToDriver(final AbstractQueryContext ctx) { LensDriver driver = ctx.getSelectedDriver(); http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-server/src/main/java/org/apache/lens/server/query/QueryServiceResource.java ---------------------------------------------------------------------- diff --git a/lens-server/src/main/java/org/apache/lens/server/query/QueryServiceResource.java b/lens-server/src/main/java/org/apache/lens/server/query/QueryServiceResource.java index 15015d3..ec97b8d 100644 --- a/lens-server/src/main/java/org/apache/lens/server/query/QueryServiceResource.java +++ b/lens-server/src/main/java/org/apache/lens/server/query/QueryServiceResource.java @@ -49,7 +49,7 @@ import lombok.extern.slf4j.Slf4j; /** * queryapi resource - * <p/> + * <p></p> * This provides api for all things query. */ @Slf4j @@ -139,13 +139,13 @@ public class QueryServiceResource { * * @param sessionid The sessionid in which queryName is working * @param state If any state is passed, all the queries in that state will be returned, otherwise all queries will - * be returned. Possible states are {@value QueryStatus.Status#values()} + * be returned. Possible states are {link QueryStatus.Status#values()} * @param queryName If any queryName is passed, all the queries containing the queryName will be returned, otherwise * all the queries will be returned * @param user Returns queries submitted by this user. If set to "all", returns queries of all users. By default, * returns queries of the current user. - * @param fromDate from date to search queries in a time range, the range is inclusive(submitTime >= fromDate) - * @param toDate to date to search queries in a time range, the range is inclusive(toDate >= submitTime) + * @param fromDate from date to search queries in a time range, the range is inclusive(submitTime >= fromDate) + * @param toDate to date to search queries in a time range, the range is inclusive(toDate >= submitTime) * @return List of {@link QueryHandle} objects */ @GET @@ -183,16 +183,21 @@ public class QueryServiceResource { * @param sessionid The session in which user is submitting the query. Any configuration set in the session will * be picked up. * @param query The query to run - * @param operation The operation on the query. Supported operations are values: {@value SubmitOp#ESTIMATE}, - * {@value SubmitOp#EXPLAIN},{@value SubmitOp#EXECUTE} and {@value SubmitOp#EXECUTE_WITH_TIMEOUT} + * @param operation The operation on the query. Supported operations are values: + * {@link org.apache.lens.api.query.SubmitOp#ESTIMATE}, + * {@link org.apache.lens.api.query.SubmitOp#EXPLAIN}, + * {@link org.apache.lens.api.query.SubmitOp#EXECUTE} and + * {@link org.apache.lens.api.query.SubmitOp#EXECUTE_WITH_TIMEOUT} * @param conf The configuration for the query - * @param timeoutmillis The timeout for the query, honored only in case of value {@value - * SubmitOp#EXECUTE_WITH_TIMEOUT} operation + * @param timeoutmillis The timeout for the query, honored only in case of value {@link + * org.apache.lens.api.query.SubmitOp#EXECUTE_WITH_TIMEOUT} operation * @param queryName human readable query name set by user (optional parameter) - * @return {@link LensAPIResult} with DATA as {@link QueryHandle} in case of {@value SubmitOp#EXECUTE} operation. - * {@link QueryPlan} in case of {@value SubmitOp#EXPLAIN} operation. {@link QueryHandleWithResultSet} in case - * {@value SubmitOp#EXECUTE_WITH_TIMEOUT} operation. {@link QueryCost} in case of - * {@value SubmitOp#ESTIMATE} operation. + + * @return {@link LensAPIResult} with DATA as {@link QueryHandle} in case of + * {@link org.apache.lens.api.query.SubmitOp#EXECUTE} operation. + * {@link QueryPlan} in case of {@link org.apache.lens.api.query.SubmitOp#EXPLAIN} operation. + * {@link QueryHandleWithResultSet} in case {@link org.apache.lens.api.query.SubmitOp#EXECUTE_WITH_TIMEOUT} + * operation. {@link QueryCost} in case of {@link org.apache.lens.api.query.SubmitOp#ESTIMATE} operation. */ @POST @Path("queries") @@ -241,17 +246,20 @@ public class QueryServiceResource { * * @param sessionid The session in which cancel is issued * @param state If any state is passed, all the queries in that state will be cancelled, otherwise all queries - * will be cancelled. Possible states are {@value QueryStatus.Status#values()} The queries in {@value - * QueryStatus.Status#FAILED}, {@value QueryStatus.Status#CLOSED}, {@value - * QueryStatus.Status#SUCCESSFUL} cannot be cancelled + * will be cancelled. Possible states are + * {@link org.apache.lens.api.query.QueryStatus.Status#values()} + * The queries in {@link org.apache.lens.api.query.QueryStatus.Status#FAILED}, + * {@link org.apache.lens.api.query.QueryStatus.Status#CLOSED}, + * {@link org.apache.lens.api.query.QueryStatus.Status#SUCCESSFUL} cannot be cancelled * @param user If any user is passed, all the queries submitted by the user will be cancelled, otherwise all the * queries will be cancelled * @param queryName Cancel queries matching the query name - * @param fromDate the from date, inclusive(submitTime>=fromDate) - * @param toDate the to date, inclusive(toDate>=submitTime) - * @return APIResult with state {@value Status#SUCCEEDED} in case of successful cancellation. APIResult with state - * {@value Status#FAILED} in case of cancellation failure. APIResult with state {@value Status#PARTIAL} in case of - * partial cancellation. + * @param fromDate the from date, inclusive(submitTime>=fromDate) + * @param toDate the to date, inclusive(toDate>=submitTime) + * @return APIResult with state {@link org.apache.lens.api.APIResult.Status#SUCCEEDED} in case of successful + * cancellation. APIResult with state {@link org.apache.lens.api.APIResult.Status#FAILED} + * in case of cancellation failure. APIResult with state + * {@link org.apache.lens.api.APIResult.Status#PARTIAL} in case of partial cancellation. */ @DELETE @Path("queries") @@ -323,12 +331,14 @@ public class QueryServiceResource { * @param sessionid The session in which user is preparing the query. Any configuration set in the session will be * picked up. * @param query The query to prepare - * @param operation The operation on the query. Supported operations are {@value SubmitOp#EXPLAIN_AND_PREPARE} or - * {@value SubmitOp#PREPARE} + * @param operation The operation on the query. Supported operations are + * {@link org.apache.lens.api.query.SubmitOp#EXPLAIN_AND_PREPARE} or + * {@link org.apache.lens.api.query.SubmitOp#PREPARE} * @param conf The configuration for preparing the query * @param queryName human readable query name set by user (optional parameter) - * @return {@link QueryPrepareHandle} incase of {@value SubmitOp#PREPARE} operation. {@link QueryPlan} incase of - * {@value SubmitOp#EXPLAIN_AND_PREPARE} and the query plan will contain the prepare handle as well. + * @return {@link QueryPrepareHandle} incase of {link org.apache.lens.api.query.SubmitOp#PREPARE} operation. + * {@link QueryPlan} incase of {@link org.apache.lens.api.query.SubmitOp#EXPLAIN_AND_PREPARE} + * and the query plan will contain the prepare handle as well. */ @POST @Path("preparedqueries") @@ -372,9 +382,10 @@ public class QueryServiceResource { * @param queryName destroys queries matching the query name * @param fromDate the from date * @param toDate the to date - * @return APIResult with state {@value Status#SUCCEEDED} in case of successful destroy. APIResult with state {@value - * Status#FAILED} in case of destroy failure. APIResult with state {@value Status#PARTIAL} in case of partial - * destroy. + * @return APIResult with state {@link org.apache.lens.api.APIResult.Status#SUCCEEDED} in case of successful + * destroy. APIResult with state {@link org.apache.lens.api.APIResult.Status#FAILED} in case of destroy + * failure. APIResult with state {@link org.apache.lens.api.APIResult.Status#PARTIAL} in case of + * partial destroy. */ @DELETE @Path("preparedqueries") @@ -463,8 +474,9 @@ public class QueryServiceResource { * * @param sessionid The user session handle * @param prepareHandle The prepare handle - * @return APIResult with state {@link Status#SUCCEEDED} in case of successful destroy. APIResult with state {@link - * Status#FAILED} in case of destroy failure. + * @return APIResult with state {@link org.apache.lens.api.APIResult.Status#SUCCEEDED} in case of successful + * destroy. APIResult with state {@link org.apache.lens.api.APIResult.Status#FAILED} in case of + * destroy failure. */ @DELETE @Path("preparedqueries/{prepareHandle}") @@ -505,8 +517,9 @@ public class QueryServiceResource { * * @param sessionid The user session handle * @param queryHandle The query handle - * @return APIResult with state {@value Status#SUCCEEDED} in case of successful cancellation. APIResult with state - * {@value Status#FAILED} in case of cancellation failure. + * @return APIResult with state {@link org.apache.lens.api.APIResult.Status#SUCCEEDED} in case of successful + * cancellation. APIResult with state {@link org.apache.lens.api.APIResult.Status#FAILED} in case of + * cancellation failure. */ @DELETE @Path("queries/{queryHandle}") @@ -558,8 +571,8 @@ public class QueryServiceResource { * @param sessionid The user session handle * @param queryHandle The query handle * @param conf The new configuration, will be on top of old one - * @return APIResult with state {@value Status#SUCCEEDED} in case of successful update. APIResult with state {@value - * Status#FAILED} in case of udpate failure. + * @return APIResult with state {@link org.apache.lens.api.APIResult.Status#SUCCEEDED} in case of successful + * update. APIResult with state {@link org.apache.lens.api.APIResult.Status#FAILED} in case of udpate failure. */ @PUT @Path("queries/{queryHandle}") @@ -587,8 +600,8 @@ public class QueryServiceResource { * @param sessionid The user session handle * @param prepareHandle The prepare handle * @param conf The new configuration, will be on top of old one - * @return APIResult with state {@value Status#SUCCEEDED} in case of successful update. APIResult with state {@value - * Status#FAILED} in case of udpate failure. + * @return APIResult with state {@link org.apache.lens.api.APIResult.Status#SUCCEEDED} in case of successful + * update. APIResult with state {@link org.apache.lens.api.APIResult.Status#FAILED} in case of udpate failure. */ @PUT @Path("preparedqueries/{prepareHandle}") @@ -615,14 +628,16 @@ public class QueryServiceResource { * @param sessionid The session in which user is submitting the query. Any configuration set in the session will * be picked up. * @param prepareHandle The Query to run - * @param operation The operation on the query. Supported operations are {@value SubmitOp#EXECUTE} and {@value - * SubmitOp#EXECUTE_WITH_TIMEOUT} + * @param operation The operation on the query. Supported operations are + * {@link org.apache.lens.api.query.SubmitOp#EXECUTE} and {@link + * org.apache.lens.api.query.SubmitOp#EXECUTE_WITH_TIMEOUT} * @param conf The configuration for the execution of query - * @param timeoutmillis The timeout for the query, honored only in case of {@value SubmitOp#EXECUTE_WITH_TIMEOUT} - * operation + * @param timeoutmillis The timeout for the query, honored only in case of + * {@link org.apache.lens.api.query.SubmitOp#EXECUTE_WITH_TIMEOUT} operation * @param queryName human readable query name set by user (optional parameter) - * @return {@link QueryHandle} in case of {@value SubmitOp#EXECUTE} operation. {@link QueryHandleWithResultSet} in - * case {@value SubmitOp#EXECUTE_WITH_TIMEOUT} operation. + * @return {@link QueryHandle} in case of {link org.apache.lens.api.query.SubmitOp#EXECUTE} operation. + * {@link QueryHandleWithResultSet} in case {@link org.apache.lens.api.query.SubmitOp#EXECUTE_WITH_TIMEOUT + * } operation. */ @POST @Path("preparedqueries/{prepareHandle}") @@ -725,8 +740,8 @@ public class QueryServiceResource { * * @param sessionid The user session handle * @param queryHandle The query handle - * @return APIResult with state {@value Status#SUCCEEDED} in case of successful close. APIResult with state {@value - * Status#FAILED} in case of close failure. + * @return APIResult with state {@link org.apache.lens.api.APIResult.Status#SUCCEEDED} in case of successful + * close. APIResult with state {@link org.apache.lens.api.APIResult.Status#FAILED} in case of close failure. */ @DELETE @Path("queries/{queryHandle}/resultset") http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-server/src/main/java/org/apache/lens/server/session/HiveSessionService.java ---------------------------------------------------------------------- diff --git a/lens-server/src/main/java/org/apache/lens/server/session/HiveSessionService.java b/lens-server/src/main/java/org/apache/lens/server/session/HiveSessionService.java index fa061ec..36adee0 100644 --- a/lens-server/src/main/java/org/apache/lens/server/session/HiveSessionService.java +++ b/lens-server/src/main/java/org/apache/lens/server/session/HiveSessionService.java @@ -95,8 +95,9 @@ public class HiveSessionService extends LensService implements SessionService { } /** - * @inheritDoc + * {@inheritDoc} */ + @Override public int addResourceToAllServices(LensSessionHandle sessionid, String type, String path) { int numAdded = 0; boolean error = false; @@ -136,7 +137,7 @@ public class HiveSessionService extends LensService implements SessionService { } /** - * @inheritDoc + * {@inheritDoc} */ @Override public void addResource(LensSessionHandle sessionid, String type, String path) { @@ -152,7 +153,7 @@ public class HiveSessionService extends LensService implements SessionService { } /** - * @inheritDoc + * {@inheritDoc} */ @Override public void deleteResource(LensSessionHandle sessionid, String type, String path) { @@ -200,7 +201,7 @@ public class HiveSessionService extends LensService implements SessionService { } /** - * @inheritDoc + * {@inheritDoc} */ @Override public LensSessionHandle openSession(String username, String password, String database, @@ -255,7 +256,7 @@ public class HiveSessionService extends LensService implements SessionService { } /** - * @inheritDoc + * {@inheritDoc} */ @Override public List<String> getAllSessionParameters(LensSessionHandle sessionid, boolean verbose, String key) @@ -287,7 +288,7 @@ public class HiveSessionService extends LensService implements SessionService { } /** - * @inheritDoc + * {@inheritDoc} */ @Override public void setSessionParameter(LensSessionHandle sessionid, String key, String value) { @@ -454,7 +455,7 @@ public class HiveSessionService extends LensService implements SessionService { } /** - * @inheritDoc + * {@inheritDoc} */ @Override public void closeSession(LensSessionHandle sessionHandle) throws LensException { http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-server/src/main/java/org/apache/lens/server/session/SessionResource.java ---------------------------------------------------------------------- diff --git a/lens-server/src/main/java/org/apache/lens/server/session/SessionResource.java b/lens-server/src/main/java/org/apache/lens/server/session/SessionResource.java index 15a8e06..4d82a06 100644 --- a/lens-server/src/main/java/org/apache/lens/server/session/SessionResource.java +++ b/lens-server/src/main/java/org/apache/lens/server/session/SessionResource.java @@ -44,7 +44,7 @@ import org.glassfish.jersey.media.multipart.FormDataParam; /** * Session resource api - * <p/> + * <p></p> * This provides api for all things in session. */ @Path("/session") @@ -124,7 +124,7 @@ public class SessionResource { /** * Add a resource to the session to all LensServices running in this Lens server - * <p/> + * <p></p> * <p> * The returned @{link APIResult} will have status SUCCEEDED <em>only if</em> the add operation was successful for all * services running in this Lens server. @@ -256,7 +256,7 @@ public class SessionResource { /** * Set value for a parameter specified by key - * <p/> + * <p></p> * The parameters can be a hive variable or a configuration. To set key as a hive variable, the key should be prefixed * with 'hivevar:'. To set key as configuration parameter, the key should be prefixed with 'hiveconf:' If no prefix is * attached, the parameter is set as configuration. http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-server/src/main/java/org/apache/lens/server/ui/MetastoreUIResource.java ---------------------------------------------------------------------- diff --git a/lens-server/src/main/java/org/apache/lens/server/ui/MetastoreUIResource.java b/lens-server/src/main/java/org/apache/lens/server/ui/MetastoreUIResource.java index b7c60bb..71d29b4 100644 --- a/lens-server/src/main/java/org/apache/lens/server/ui/MetastoreUIResource.java +++ b/lens-server/src/main/java/org/apache/lens/server/ui/MetastoreUIResource.java @@ -39,7 +39,7 @@ import org.json.JSONObject; /** * metastore UI resource api - * <p/> + * <p></p> * This provides api for all things metastore UI. */ @@ -74,7 +74,7 @@ public class MetastoreUIResource { * * @param publicId The publicId for the session in which user is working * @return JSON string consisting of different table names and types - * @throws LensException, JSONException + * @throws WebApplicationException wraps LensException */ @GET @Path("tables") @@ -137,7 +137,7 @@ public class MetastoreUIResource { * @param publicId The publicId for the session in which user is working * @param name name of cube or dimension to be described * @return JSON string consisting of different dimension and measure names and types - * @throws LensException, JSONException + * @throws WebApplicationException wraps LensException */ @GET @Path("tables/{name}") @@ -210,7 +210,6 @@ public class MetastoreUIResource { * @param publicId The publicId for the session in which user is working * @param keyword keyword to be searched * @return JSON string consisting of different table and column names and types - * @throws LensException, JSONException */ @GET @Path("searchablefields") http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-server/src/main/java/org/apache/lens/server/ui/QueryServiceUIResource.java ---------------------------------------------------------------------- diff --git a/lens-server/src/main/java/org/apache/lens/server/ui/QueryServiceUIResource.java b/lens-server/src/main/java/org/apache/lens/server/ui/QueryServiceUIResource.java index e0586e5..391cf08 100644 --- a/lens-server/src/main/java/org/apache/lens/server/ui/QueryServiceUIResource.java +++ b/lens-server/src/main/java/org/apache/lens/server/ui/QueryServiceUIResource.java @@ -105,7 +105,7 @@ public class QueryServiceUIResource { * * @param publicId The public id of the session in which user is working * @param state If any state is passed, all the queries in that state will be returned, otherwise all queries will - * be returned. Possible states are {@value QueryStatus.Status#values()} + * be returned. Possible states are {@link org.apache.lens.api.query.QueryStatus.Status#values()} * @param user return queries matching the user. If set to "all", return queries of all users. By default, * returns queries of the current user. * @param queryName human readable query name set by user (optional) @@ -225,8 +225,8 @@ public class QueryServiceUIResource { * * @param publicId The user session handle * @param queryHandle The query handle - * @return APIResult with state {@value org.apache.lens.api.APIResult.Status#SUCCEEDED} in case of successful - * cancellation. APIResult with state {@value org.apache.lens.api.APIResult.Status#FAILED} in case of cancellation + * @return APIResult with state {@link org.apache.lens.api.APIResult.Status#SUCCEEDED} in case of successful + * cancellation. APIResult with state {@link org.apache.lens.api.APIResult.Status#FAILED} in case of cancellation * failure. */ @DELETE http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/lens-server/src/main/java/org/apache/lens/server/ui/SessionUIResource.java ---------------------------------------------------------------------- diff --git a/lens-server/src/main/java/org/apache/lens/server/ui/SessionUIResource.java b/lens-server/src/main/java/org/apache/lens/server/ui/SessionUIResource.java index 3d47c4f..cd1ba36 100644 --- a/lens-server/src/main/java/org/apache/lens/server/ui/SessionUIResource.java +++ b/lens-server/src/main/java/org/apache/lens/server/ui/SessionUIResource.java @@ -40,7 +40,7 @@ import org.glassfish.jersey.media.multipart.FormDataParam; /** * Session resource api - * <p/> + * <p></p> * This provides api for all things in session. */ @Path("/uisession") http://git-wip-us.apache.org/repos/asf/incubator-lens/blob/0cf6c4e2/pom.xml ---------------------------------------------------------------------- diff --git a/pom.xml b/pom.xml index a896aea..ec782af 100644 --- a/pom.xml +++ b/pom.xml @@ -86,7 +86,7 @@ <test.tmp.dir>${basedir}/target/tmp</test.tmp.dir> <!-- maven plugins --> - <jaxb2.plugin.version>0.8.0</jaxb2.plugin.version> + <jaxb2.plugin.version>0.12.3</jaxb2.plugin.version> <jaxb2.basics.plugin.version>0.6.3</jaxb2.basics.plugin.version> <jetty.plugin.version>${jetty.version}</jetty.plugin.version> <exec.plugin.version>1.2.1</exec.plugin.version> @@ -405,8 +405,8 @@ </plugin> <plugin> <groupId>org.apache.maven.plugins</groupId> - <artifactId>maven-site-plugin</artifactId> - <configuration> + <artifactId>maven-site-plugin</artifactId> + <configuration> <generateReports>true</generateReports> </configuration> </plugin> @@ -649,13 +649,13 @@ <updatePolicy>never</updatePolicy> </snapshots> </repository> - <repository> + <!--<repository> <id>Codehaus repository</id> <url>http://repository.codehaus.org/</url> <snapshots> <enabled>false</enabled> </snapshots> - </repository> + </repository>--> <repository> <id>apache.snapshots.repo</id> <url>https://repository.apache.org/content/groups/snapshots</url>
