Return-Path: X-Original-To: apmail-hive-commits-archive@www.apache.org Delivered-To: apmail-hive-commits-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id E9AB61040F for ; Thu, 24 Oct 2013 20:34:21 +0000 (UTC) Received: (qmail 21247 invoked by uid 500); 24 Oct 2013 20:33:59 -0000 Delivered-To: apmail-hive-commits-archive@hive.apache.org Received: (qmail 21124 invoked by uid 500); 24 Oct 2013 20:33:53 -0000 Mailing-List: contact commits-help@hive.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: hive-dev@hive.apache.org Delivered-To: mailing list commits@hive.apache.org Received: (qmail 20930 invoked by uid 99); 24 Oct 2013 20:33:47 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 24 Oct 2013 20:33:47 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=5.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; Thu, 24 Oct 2013 20:33:43 +0000 Received: from eris.apache.org (localhost [127.0.0.1]) by eris.apache.org (Postfix) with ESMTP id 425A32388B56; Thu, 24 Oct 2013 20:33:22 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r1535535 - in /hive/trunk/hcatalog: core/src/main/java/org/apache/hive/hcatalog/data/ core/src/main/java/org/apache/hive/hcatalog/data/schema/ core/src/main/java/org/apache/hive/hcatalog/data/transfer/ core/src/main/java/org/apache/hive/hca... Date: Thu, 24 Oct 2013 20:33:21 -0000 To: commits@hive.apache.org From: thejas@apache.org X-Mailer: svnmailer-1.0.9 Message-Id: <20131024203322.425A32388B56@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Author: thejas Date: Thu Oct 24 20:33:21 2013 New Revision: 1535535 URL: http://svn.apache.org/r1535535 Log: HIVE-5216 : Need to annotate public API in HCatalog (Eugene Koifman via Thejas Nair) Modified: hive/trunk/hcatalog/core/src/main/java/org/apache/hive/hcatalog/data/HCatRecord.java hive/trunk/hcatalog/core/src/main/java/org/apache/hive/hcatalog/data/schema/HCatSchema.java hive/trunk/hcatalog/core/src/main/java/org/apache/hive/hcatalog/data/transfer/HCatReader.java hive/trunk/hcatalog/core/src/main/java/org/apache/hive/hcatalog/data/transfer/HCatWriter.java hive/trunk/hcatalog/core/src/main/java/org/apache/hive/hcatalog/mapreduce/HCatOutputFormat.java hive/trunk/hcatalog/hcatalog-pig-adapter/src/main/java/org/apache/hive/hcatalog/pig/HCatLoader.java hive/trunk/hcatalog/hcatalog-pig-adapter/src/main/java/org/apache/hive/hcatalog/pig/HCatStorer.java hive/trunk/hcatalog/webhcat/svr/src/main/java/org/apache/hive/hcatalog/templeton/Main.java Modified: hive/trunk/hcatalog/core/src/main/java/org/apache/hive/hcatalog/data/HCatRecord.java URL: http://svn.apache.org/viewvc/hive/trunk/hcatalog/core/src/main/java/org/apache/hive/hcatalog/data/HCatRecord.java?rev=1535535&r1=1535534&r2=1535535&view=diff ============================================================================== --- hive/trunk/hcatalog/core/src/main/java/org/apache/hive/hcatalog/data/HCatRecord.java (original) +++ hive/trunk/hcatalog/core/src/main/java/org/apache/hive/hcatalog/data/HCatRecord.java Thu Oct 24 20:33:21 2013 @@ -22,6 +22,8 @@ package org.apache.hive.hcatalog.data; import java.util.List; import java.util.Map; +import org.apache.hadoop.hive.common.classification.InterfaceAudience; +import org.apache.hadoop.hive.common.classification.InterfaceStability; import org.apache.hive.hcatalog.common.HCatException; import org.apache.hive.hcatalog.data.schema.HCatSchema; @@ -31,6 +33,8 @@ import org.apache.hive.hcatalog.data.sch * HCatRecord is designed only to be used as in-memory representation only. * Don't use it to store data on the physical device. */ +@InterfaceAudience.Public +@InterfaceStability.Evolving public abstract class HCatRecord implements HCatRecordable { public abstract Object get(String fieldName, HCatSchema recordSchema) throws HCatException; Modified: hive/trunk/hcatalog/core/src/main/java/org/apache/hive/hcatalog/data/schema/HCatSchema.java URL: http://svn.apache.org/viewvc/hive/trunk/hcatalog/core/src/main/java/org/apache/hive/hcatalog/data/schema/HCatSchema.java?rev=1535535&r1=1535534&r2=1535535&view=diff ============================================================================== --- hive/trunk/hcatalog/core/src/main/java/org/apache/hive/hcatalog/data/schema/HCatSchema.java (original) +++ hive/trunk/hcatalog/core/src/main/java/org/apache/hive/hcatalog/data/schema/HCatSchema.java Thu Oct 24 20:33:21 2013 @@ -25,12 +25,15 @@ import java.util.HashMap; import java.util.List; import java.util.Map; +import org.apache.hadoop.hive.common.classification.InterfaceAudience; +import org.apache.hadoop.hive.common.classification.InterfaceStability; import org.apache.hive.hcatalog.common.HCatException; /** * HCatSchema. This class is NOT thread-safe. */ - +@InterfaceAudience.Public +@InterfaceStability.Evolving public class HCatSchema implements Serializable { private static final long serialVersionUID = 1L; Modified: hive/trunk/hcatalog/core/src/main/java/org/apache/hive/hcatalog/data/transfer/HCatReader.java URL: http://svn.apache.org/viewvc/hive/trunk/hcatalog/core/src/main/java/org/apache/hive/hcatalog/data/transfer/HCatReader.java?rev=1535535&r1=1535534&r2=1535535&view=diff ============================================================================== --- hive/trunk/hcatalog/core/src/main/java/org/apache/hive/hcatalog/data/transfer/HCatReader.java (original) +++ hive/trunk/hcatalog/core/src/main/java/org/apache/hive/hcatalog/data/transfer/HCatReader.java Thu Oct 24 20:33:21 2013 @@ -24,6 +24,8 @@ import java.util.Map; import java.util.Map.Entry; import org.apache.hadoop.conf.Configuration; +import org.apache.hadoop.hive.common.classification.InterfaceAudience; +import org.apache.hadoop.hive.common.classification.InterfaceStability; import org.apache.hive.hcatalog.common.HCatException; import org.apache.hive.hcatalog.data.HCatRecord; import org.apache.hive.hcatalog.data.transfer.state.StateProvider; @@ -32,7 +34,8 @@ import org.apache.hive.hcatalog.data.tra * This abstract class is internal to HCatalog and abstracts away the notion of * underlying system from which reads will be done. */ - +@InterfaceAudience.Public +@InterfaceStability.Evolving public abstract class HCatReader { /** Modified: hive/trunk/hcatalog/core/src/main/java/org/apache/hive/hcatalog/data/transfer/HCatWriter.java URL: http://svn.apache.org/viewvc/hive/trunk/hcatalog/core/src/main/java/org/apache/hive/hcatalog/data/transfer/HCatWriter.java?rev=1535535&r1=1535534&r2=1535535&view=diff ============================================================================== --- hive/trunk/hcatalog/core/src/main/java/org/apache/hive/hcatalog/data/transfer/HCatWriter.java (original) +++ hive/trunk/hcatalog/core/src/main/java/org/apache/hive/hcatalog/data/transfer/HCatWriter.java Thu Oct 24 20:33:21 2013 @@ -24,6 +24,8 @@ import java.util.Map; import java.util.Map.Entry; import org.apache.hadoop.conf.Configuration; +import org.apache.hadoop.hive.common.classification.InterfaceAudience; +import org.apache.hadoop.hive.common.classification.InterfaceStability; import org.apache.hive.hcatalog.common.HCatException; import org.apache.hive.hcatalog.data.HCatRecord; import org.apache.hive.hcatalog.data.transfer.state.StateProvider; @@ -33,7 +35,8 @@ import org.apache.hive.hcatalog.data.tra * HCatalog from external systems. Don't try to instantiate this directly. * Instead, use {@link DataTransferFactory} */ - +@InterfaceAudience.Public +@InterfaceStability.Evolving public abstract class HCatWriter { protected Configuration conf; Modified: hive/trunk/hcatalog/core/src/main/java/org/apache/hive/hcatalog/mapreduce/HCatOutputFormat.java URL: http://svn.apache.org/viewvc/hive/trunk/hcatalog/core/src/main/java/org/apache/hive/hcatalog/mapreduce/HCatOutputFormat.java?rev=1535535&r1=1535534&r2=1535535&view=diff ============================================================================== --- hive/trunk/hcatalog/core/src/main/java/org/apache/hive/hcatalog/mapreduce/HCatOutputFormat.java (original) +++ hive/trunk/hcatalog/core/src/main/java/org/apache/hive/hcatalog/mapreduce/HCatOutputFormat.java Thu Oct 24 20:33:21 2013 @@ -28,6 +28,8 @@ import java.util.Map; import org.apache.hadoop.conf.Configuration; import org.apache.hadoop.fs.Path; import org.apache.hadoop.fs.permission.FsPermission; +import org.apache.hadoop.hive.common.classification.InterfaceAudience; +import org.apache.hadoop.hive.common.classification.InterfaceStability; import org.apache.hadoop.hive.conf.HiveConf; import org.apache.hadoop.hive.ql.metadata.HiveStorageHandler; import org.apache.hadoop.hive.metastore.HiveMetaStoreClient; @@ -52,6 +54,8 @@ import org.slf4j.LoggerFactory; /** The OutputFormat to use to write data to HCatalog. The key value is ignored and * should be given as null. The value is the HCatRecord to write.*/ +@InterfaceAudience.Public +@InterfaceStability.Evolving public class HCatOutputFormat extends HCatBaseOutputFormat { static final private Logger LOG = LoggerFactory.getLogger(HCatOutputFormat.class); Modified: hive/trunk/hcatalog/hcatalog-pig-adapter/src/main/java/org/apache/hive/hcatalog/pig/HCatLoader.java URL: http://svn.apache.org/viewvc/hive/trunk/hcatalog/hcatalog-pig-adapter/src/main/java/org/apache/hive/hcatalog/pig/HCatLoader.java?rev=1535535&r1=1535534&r2=1535535&view=diff ============================================================================== --- hive/trunk/hcatalog/hcatalog-pig-adapter/src/main/java/org/apache/hive/hcatalog/pig/HCatLoader.java (original) +++ hive/trunk/hcatalog/hcatalog-pig-adapter/src/main/java/org/apache/hive/hcatalog/pig/HCatLoader.java Thu Oct 24 20:33:21 2013 @@ -27,6 +27,8 @@ import java.util.Map.Entry; import java.util.Properties; import org.apache.hadoop.fs.Path; +import org.apache.hadoop.hive.common.classification.InterfaceAudience; +import org.apache.hadoop.hive.common.classification.InterfaceStability; import org.apache.hadoop.hive.metastore.api.FieldSchema; import org.apache.hadoop.hive.ql.metadata.Table; import org.apache.hadoop.mapreduce.InputFormat; @@ -49,7 +51,8 @@ import org.apache.pig.impl.util.UDFConte /** * Pig {@link org.apache.pig.LoadFunc} to read data from HCat */ - +@InterfaceAudience.Public +@InterfaceStability.Evolving public class HCatLoader extends HCatBaseLoader { private static final String PARTITION_FILTER = "partition.filter"; // for future use Modified: hive/trunk/hcatalog/hcatalog-pig-adapter/src/main/java/org/apache/hive/hcatalog/pig/HCatStorer.java URL: http://svn.apache.org/viewvc/hive/trunk/hcatalog/hcatalog-pig-adapter/src/main/java/org/apache/hive/hcatalog/pig/HCatStorer.java?rev=1535535&r1=1535534&r2=1535535&view=diff ============================================================================== --- hive/trunk/hcatalog/hcatalog-pig-adapter/src/main/java/org/apache/hive/hcatalog/pig/HCatStorer.java (original) +++ hive/trunk/hcatalog/hcatalog-pig-adapter/src/main/java/org/apache/hive/hcatalog/pig/HCatStorer.java Thu Oct 24 20:33:21 2013 @@ -27,6 +27,8 @@ import java.util.Map.Entry; import java.util.Properties; import org.apache.hadoop.conf.Configuration; +import org.apache.hadoop.hive.common.classification.InterfaceAudience; +import org.apache.hadoop.hive.common.classification.InterfaceStability; import org.apache.hadoop.hive.shims.ShimLoader; import org.apache.hadoop.mapreduce.Job; import org.apache.hadoop.mapreduce.OutputFormat; @@ -48,7 +50,8 @@ import org.apache.pig.impl.util.UDFConte * HCatStorer. * */ - +@InterfaceAudience.Public +@InterfaceStability.Evolving public class HCatStorer extends HCatBaseStorer { // Signature for wrapped storer, see comments in LoadFuncBasedInputDriver.initialize Modified: hive/trunk/hcatalog/webhcat/svr/src/main/java/org/apache/hive/hcatalog/templeton/Main.java URL: http://svn.apache.org/viewvc/hive/trunk/hcatalog/webhcat/svr/src/main/java/org/apache/hive/hcatalog/templeton/Main.java?rev=1535535&r1=1535534&r2=1535535&view=diff ============================================================================== --- hive/trunk/hcatalog/webhcat/svr/src/main/java/org/apache/hive/hcatalog/templeton/Main.java (original) +++ hive/trunk/hcatalog/webhcat/svr/src/main/java/org/apache/hive/hcatalog/templeton/Main.java Thu Oct 24 20:33:21 2013 @@ -28,6 +28,8 @@ import java.util.HashMap; import org.apache.commons.logging.Log; import org.apache.commons.logging.LogFactory; +import org.apache.hadoop.hive.common.classification.InterfaceAudience; +import org.apache.hadoop.hive.common.classification.InterfaceStability; import org.apache.hadoop.hdfs.web.AuthFilter; import org.apache.hadoop.security.UserGroupInformation; import org.apache.hadoop.util.GenericOptionsParser; @@ -45,6 +47,8 @@ import org.slf4j.bridge.SLF4JBridgeHandl /** * The main executable that starts up and runs the Server. */ +@InterfaceAudience.LimitedPrivate("Integration Tests") +@InterfaceStability.Unstable public class Main { public static final String SERVLET_PATH = "templeton"; private static final Log LOG = LogFactory.getLog(Main.class);