Apache
/
hbase
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

HBASE-22344 Documented the deprecation of public and limited private APIs (#208) 

Signed-off-by: stack <stack@apache.org>
This commit is contained in:
Jan Hentschel 2019-06-17 22:02:23 +02:00 committed by GitHub
parent 214553d17a
commit 5da5deb59d
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
31 changed files with 332 additions and 91 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
hbase-client/src/main/java/org/apache/hadoop/hbase/HColumnDescriptor.java
View File

@ -162,7 +162,10 @@ public class HColumnDescriptor implements ColumnFamilyDescriptor, Comparable<HCo
* name: i.e. 'printable' and ends in a ':' (Null passes are allowed because
* <code>b</code> can be null when deserializing). Cannot start with a '.'
* either. Also Family can not be an empty value or equal "recovered.edits".
* @deprecated Use {@link ColumnFamilyDescriptorBuilder#isLegalColumnFamilyName(byte[])}.
* @deprecated since 2.0.0 and will be removed in 3.0.0. Use
* {@link ColumnFamilyDescriptorBuilder#isLegalColumnFamilyName(byte[])} instead.
* @see ColumnFamilyDescriptorBuilder#isLegalColumnFamilyName(byte[])
* @see <a href="https://issues.apache.org/jira/browse/HBASE-18008">HBASE-18008</a>
*/
@Deprecated
public static byte [] isLegalFamilyName(final byte [] b) {

24
hbase-client/src/main/java/org/apache/hadoop/hbase/HTableDescriptor.java
View File

@ -598,9 +598,11 @@ public class HTableDescriptor implements TableDescriptor, Comparable<HTableDescr
/**
* Returns an unmodifiable collection of all the {@link HColumnDescriptor}
* of all the column families of the table.
* @deprecated Use {@link #getColumnFamilies}.
* @deprecated since 2.0.0 and will be removed in 3.0.0. Use {@link #getColumnFamilies()} instead.
* @return Immutable collection of {@link HColumnDescriptor} of all the
* column families.
* @see #getColumnFamilies()
* @see <a href="https://issues.apache.org/jira/browse/HBASE-18008">HBASE-18008</a>
*/
@Deprecated
public Collection<HColumnDescriptor> getFamilies() {
@ -707,8 +709,9 @@ public class HTableDescriptor implements TableDescriptor, Comparable<HTableDescr
* of the table.
*
* @return Array of all the HColumnDescriptors of the current table
*
* @deprecated since 2.0.0 and will be removed in 3.0.0.
* @see #getFamilies()
* @see <a href="https://issues.apache.org/jira/browse/HBASE-18008">HBASE-18008</a>
*/
@Deprecated
@Override
@ -724,7 +727,10 @@ public class HTableDescriptor implements TableDescriptor, Comparable<HTableDescr
* @param column Column family name
* @return Column descriptor for the passed family name or the family on
* passed in column.
* @deprecated Use {@link #getColumnFamily(byte[])}.
* @deprecated since 2.0.0 and will be removed in 3.0.0. Use {@link #getColumnFamily(byte[])}
* instead.
* @see #getColumnFamily(byte[])
* @see <a href="https://issues.apache.org/jira/browse/HBASE-18008">HBASE-18008</a>
*/
@Deprecated
public HColumnDescriptor getFamily(final byte[] column) {
@ -857,12 +863,20 @@ public class HTableDescriptor implements TableDescriptor, Comparable<HTableDescr
public static final HTableDescriptor NAMESPACE_TABLEDESC
= new HTableDescriptor(TableDescriptorBuilder.NAMESPACE_TABLEDESC);
/**
* @deprecated since 0.94.1
* @see <a href="https://issues.apache.org/jira/browse/HBASE-6188">HBASE-6188</a>
*/
@Deprecated
public HTableDescriptor setOwner(User owner) {
getDelegateeForModification().setOwner(owner);
return this;
}
/**
* @deprecated since 0.94.1
* @see <a href="https://issues.apache.org/jira/browse/HBASE-6188">HBASE-6188</a>
*/
// used by admin.rb:alter(table_name,*args) to update owner.
@Deprecated
public HTableDescriptor setOwnerString(String ownerString) {
@ -870,6 +884,10 @@ public class HTableDescriptor implements TableDescriptor, Comparable<HTableDescr
return this;
}
/**
* @deprecated since 0.94.1
* @see <a href="https://issues.apache.org/jira/browse/HBASE-6188">HBASE-6188</a>
*/
@Override
@Deprecated
public String getOwnerString() {

12
hbase-client/src/main/java/org/apache/hadoop/hbase/client/Admin.java
View File

@ -708,8 +708,10 @@ public interface Admin extends Abortable, Closeable {
* array we'll assign to a random server. A server name is made of host, port and
* startcode. Here is an example: <code> host187.example.com,60020,1289493121758</code>
* @throws IOException if we can't find a region named <code>encodedRegionName</code>
* @deprecated Use {@link #move(byte[], ServerName)} instead. And if you want to move the region
* to a random server, please use {@link #move(byte[])}.
* @deprecated since 2.2.0 and will be removed in 4.0.0. Use {@link #move(byte[], ServerName)}
* instead. And if you want to move the region to a random server, please use
* {@link #move(byte[])}.
* @see <a href="https://issues.apache.org/jira/browse/HBASE-22108">HBASE-22108</a>
*/
@Deprecated
default void move(byte[] encodedRegionName, byte[] destServerName) throws IOException {
@ -1213,7 +1215,8 @@ public interface Admin extends Abortable, Closeable {
* @return <code>true</code> if aborted, <code>false</code> if procedure already completed or does
* not exist
* @throws IOException if a remote or network exception occurs
* @deprecated Since 2.1.1 -- to be removed.
* @deprecated since 2.1.1 and will be removed in 4.0.0.
* @see <a href="https://issues.apache.org/jira/browse/HBASE-21223">HBASE-21223</a>
*/
@Deprecated
default boolean abortProcedure(long procId, boolean mayInterruptIfRunning) throws IOException {
@ -1233,7 +1236,8 @@ public interface Admin extends Abortable, Closeable {
* @param mayInterruptIfRunning if the proc completed at least one step, should it be aborted?
* @return <code>true</code> if aborted, <code>false</code> if procedure already completed or does not exist
* @throws IOException if a remote or network exception occurs
* @deprecated Since 2.1.1 -- to be removed.
* @deprecated since 2.1.1 and will be removed in 4.0.0.
* @see <a href="https://issues.apache.org/jira/browse/HBASE-21223">HBASE-21223</a>
*/
@Deprecated
Future<Boolean> abortProcedureAsync(long procId, boolean mayInterruptIfRunning)

3
hbase-client/src/main/java/org/apache/hadoop/hbase/client/AsyncAdmin.java
View File

@ -976,7 +976,8 @@ public interface AsyncAdmin {
* @param mayInterruptIfRunning if the proc completed at least one step, should it be aborted?
* @return true if aborted, false if procedure already completed or does not exist. the value is
* wrapped by {@link CompletableFuture}
* @deprecated Since 2.1.1 -- to be removed.
* @deprecated since 2.1.1 and will be removed in 4.0.0.
* @see <a href="https://issues.apache.org/jira/browse/HBASE-21223">HBASE-21223</a>
*/
@Deprecated
CompletableFuture<Boolean> abortProcedure(long procId, boolean mayInterruptIfRunning);

51
hbase-client/src/main/java/org/apache/hadoop/hbase/client/Scan.java
View File

@ -182,7 +182,9 @@ public class Scan extends Query {
public Scan() {}
/**
* @deprecated use {@code new Scan().withStartRow(startRow).setFilter(filter)} instead.
* @deprecated since 2.0.0 and will be removed in 3.0.0. Use
* {@code new Scan().withStartRow(startRow).setFilter(filter)} instead.
* @see <a href="https://issues.apache.org/jira/browse/HBASE-17320">HBASE-17320</a>
*/
@Deprecated
public Scan(byte[] startRow, Filter filter) {
@ -196,7 +198,9 @@ public class Scan extends Query {
* If the specified row does not exist, the Scanner will start from the next closest row after the
* specified row.
* @param startRow row to start scanner at or after
* @deprecated use {@code new Scan().withStartRow(startRow)} instead.
* @deprecated since 2.0.0 and will be removed in 3.0.0. Use
* {@code new Scan().withStartRow(startRow)} instead.
* @see <a href="https://issues.apache.org/jira/browse/HBASE-17320">HBASE-17320</a>
*/
@Deprecated
public Scan(byte[] startRow) {
@ -207,7 +211,9 @@ public class Scan extends Query {
* Create a Scan operation for the range of rows specified.
* @param startRow row to start scanner at or after (inclusive)
* @param stopRow row to stop scanner before (exclusive)
* @deprecated use {@code new Scan().withStartRow(startRow).withStopRow(stopRow)} instead.
* @deprecated since 2.0.0 and will be removed in 3.0.0. Use
* {@code new Scan().withStartRow(startRow).withStopRow(stopRow)} instead.
* @see <a href="https://issues.apache.org/jira/browse/HBASE-17320">HBASE-17320</a>
*/
@Deprecated
public Scan(byte[] startRow, byte[] stopRow) {
@ -409,8 +415,11 @@ public class Scan extends Query {
* @return this
* @throws IllegalArgumentException if startRow does not meet criteria for a row key (when length
* exceeds {@link HConstants#MAX_ROW_LENGTH})
* @deprecated use {@link #withStartRow(byte[])} instead. This method may change the inclusive of
* the stop row to keep compatible with the old behavior.
* @deprecated since 2.0.0 and will be removed in 3.0.0. Use {@link #withStartRow(byte[])}
* instead. This method may change the inclusive of the stop row to keep compatible with the old
* behavior.
* @see #withStartRow(byte[])
* @see <a href="https://issues.apache.org/jira/browse/HBASE-17320">HBASE-17320</a>
*/
@Deprecated
public Scan setStartRow(byte[] startRow) {
@ -469,8 +478,11 @@ public class Scan extends Query {
* @return this
* @throws IllegalArgumentException if stopRow does not meet criteria for a row key (when length
* exceeds {@link HConstants#MAX_ROW_LENGTH})
* @deprecated use {@link #withStopRow(byte[])} instead. This method may change the inclusive of
* the stop row to keep compatible with the old behavior.
* @deprecated since 2.0.0 and will be removed in 3.0.0. Use {@link #withStopRow(byte[])} instead.
* This method may change the inclusive of the stop row to keep compatible with the old
* behavior.
* @see #withStopRow(byte[])
* @see <a href="https://issues.apache.org/jira/browse/HBASE-17320">HBASE-17320</a>
*/
@Deprecated
public Scan setStopRow(byte[] stopRow) {
@ -587,8 +599,10 @@ public class Scan extends Query {
/**
* Get all available versions.
* @return this
* @deprecated It is easy to misunderstand with column family's max versions, so use
* {@link #readAllVersions()} instead.
* @deprecated since 2.0.0 and will be removed in 3.0.0. It is easy to misunderstand with column
* family's max versions, so use {@link #readAllVersions()} instead.
* @see #readAllVersions()
* @see <a href="https://issues.apache.org/jira/browse/HBASE-17125">HBASE-17125</a>
*/
@Deprecated
public Scan setMaxVersions() {
@ -599,8 +613,10 @@ public class Scan extends Query {
* Get up to the specified number of versions of each column.
* @param maxVersions maximum versions for each column
* @return this
* @deprecated It is easy to misunderstand with column family's max versions, so use
* {@link #readVersions(int)} instead.
* @deprecated since 2.0.0 and will be removed in 3.0.0. It is easy to misunderstand with column
* family's max versions, so use {@link #readVersions(int)} instead.
* @see #readVersions(int)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-17125">HBASE-17125</a>
*/
@Deprecated
public Scan setMaxVersions(int maxVersions) {
@ -1023,12 +1039,13 @@ public class Scan extends Query {
* better performance for small scan. [HBASE-9488]. Generally, if the scan range is within one
* data block(64KB), it could be considered as a small scan.
* @param small
* @deprecated since 2.0.0. Use {@link #setLimit(int)} and {@link #setReadType(ReadType)} instead.
* And for the one rpc optimization, now we will also fetch data when openScanner, and
* if the number of rows reaches the limit then we will close the scanner
* automatically which means we will fall back to one rpc.
* @deprecated since 2.0.0 and will be removed in 3.0.0. Use {@link #setLimit(int)} and
* {@link #setReadType(ReadType)} instead. And for the one rpc optimization, now we will also
* fetch data when openScanner, and if the number of rows reaches the limit then we will close
* the scanner automatically which means we will fall back to one rpc.
* @see #setLimit(int)
* @see #setReadType(ReadType)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-17045">HBASE-17045</a>
*/
@Deprecated
public Scan setSmall(boolean small) {
@ -1040,7 +1057,9 @@ public class Scan extends Query {
/**
* Get whether this scan is a small scan
* @return true if small scan
* @deprecated since 2.0.0. See the comment of {@link #setSmall(boolean)}
* @deprecated since 2.0.0 and will be removed in 3.0.0. See the comment of
* {@link #setSmall(boolean)}
* @see <a href="https://issues.apache.org/jira/browse/HBASE-17045">HBASE-17045</a>
*/
@Deprecated
public boolean isSmall() {

26
hbase-client/src/main/java/org/apache/hadoop/hbase/client/SnapshotDescription.java
View File

@ -37,7 +37,10 @@ public class SnapshotDescription {
}
/**
* @deprecated Use the version with the TableName instance instead
* @deprecated since 2.0.0 and will be removed in 3.0.0. Use the version with the TableName
* instance instead.
* @see #SnapshotDescription(String, TableName)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-16892">HBASE-16892</a>
*/
@Deprecated
public SnapshotDescription(String name, String table) {
@ -49,7 +52,10 @@ public class SnapshotDescription {
}
/**
* @deprecated Use the version with the TableName instance instead
* @deprecated since 2.0.0 and will be removed in 3.0.0. Use the version with the TableName
* instance instead.
* @see #SnapshotDescription(String, TableName, SnapshotType)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-16892">HBASE-16892</a>
*/
@Deprecated
public SnapshotDescription(String name, String table, SnapshotType type) {
@ -61,7 +67,10 @@ public class SnapshotDescription {
}
/**
* @deprecated Use the version with the TableName instance instead
* @deprecated since 2.0.0 and will be removed in 3.0.0. Use the version with the TableName
* instance instead.
* @see #SnapshotDescription(String, TableName, SnapshotType, String)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-16892">HBASE-16892</a>
*/
@Deprecated
public SnapshotDescription(String name, String table, SnapshotType type, String owner) {
@ -73,7 +82,10 @@ public class SnapshotDescription {
}
/**
* @deprecated Use the version with the TableName instance instead
* @deprecated since 2.0.0 and will be removed in 3.0.0. Use the version with the TableName
* instance instead.
* @see #SnapshotDescription(String, TableName, SnapshotType, String, long, int)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-16892">HBASE-16892</a>
*/
@Deprecated
public SnapshotDescription(String name, String table, SnapshotType type, String owner,
@ -96,7 +108,11 @@ public class SnapshotDescription {
}
/**
* @deprecated Use getTableName() or getTableNameAsString() instead.
* @deprecated since 2.0.0 and will be removed in 3.0.0. Use {@link #getTableName()} or
* {@link #getTableNameAsString()} instead.
* @see #getTableName()
* @see #getTableNameAsString()
* @see <a href="https://issues.apache.org/jira/browse/HBASE-16892">HBASE-16892</a>
*/
@Deprecated
public String getTable() {

4
hbase-client/src/main/java/org/apache/hadoop/hbase/client/TableDescriptor.java
View File

@ -176,6 +176,10 @@ public interface TableDescriptor {
*/
TableName getTableName();
/**
* @deprecated since 2.0.0 and will be removed in 3.0.0.
* @see <a href="https://issues.apache.org/jira/browse/HBASE-15583">HBASE-15583</a>
*/
@Deprecated
String getOwnerString();

25
hbase-client/src/main/java/org/apache/hadoop/hbase/client/TableDescriptorBuilder.java
View File

@ -291,8 +291,9 @@ public class TableDescriptorBuilder {
/**
* Table descriptor for namespace table
* @deprecated We have folded the data in namespace table into meta table, so do not use it any
* more.
* @deprecated since 3.0.0 and will be removed in 4.0.0. We have folded the data in namespace
* table into meta table, so do not use it any more.
* @see <a href="https://issues.apache.org/jira/browse/HBASE-21154">HBASE-21154</a>
*/
@Deprecated
public static final TableDescriptor NAMESPACE_TABLEDESC =
@ -458,12 +459,20 @@ public class TableDescriptorBuilder {
return this;
}
/**
* @deprecated since 2.0.0 and will be removed in 3.0.0.
* @see <a href="https://issues.apache.org/jira/browse/HBASE-15583">HBASE-15583</a>
*/
@Deprecated
public TableDescriptorBuilder setOwner(User owner) {
desc.setOwner(owner);
return this;
}
/**
* @deprecated since 2.0.0 and will be removed in 3.0.0.
* @see <a href="https://issues.apache.org/jira/browse/HBASE-15583">HBASE-15583</a>
*/
@Deprecated
public TableDescriptorBuilder setOwnerString(String ownerString) {
desc.setOwnerString(ownerString);
@ -1502,17 +1511,29 @@ public class TableDescriptorBuilder {
}
}
/**
* @deprecated since 2.0.0 and will be removed in 3.0.0.
* @see <a href="https://issues.apache.org/jira/browse/HBASE-15583">HBASE-15583</a>
*/
@Deprecated
public ModifyableTableDescriptor setOwner(User owner) {
return setOwnerString(owner != null ? owner.getShortName() : null);
}
/**
* @deprecated since 2.0.0 and will be removed in 3.0.0.
* @see <a href="https://issues.apache.org/jira/browse/HBASE-15583">HBASE-15583</a>
*/
// used by admin.rb:alter(table_name,*args) to update owner.
@Deprecated
public ModifyableTableDescriptor setOwnerString(String ownerString) {
return setValue(OWNER_KEY, ownerString);
}
/**
* @deprecated since 2.0.0 and will be removed in 3.0.0.
* @see <a href="https://issues.apache.org/jira/browse/HBASE-15583">HBASE-15583</a>
*/
@Override
@Deprecated
public String getOwnerString() {

3
hbase-client/src/main/java/org/apache/hadoop/hbase/filter/FirstKeyValueMatchingQualifiersFilter.java
View File

@ -43,7 +43,8 @@ import org.apache.hbase.thirdparty.com.google.protobuf.UnsafeByteOperations;
* caveat, this filter is only useful for special cases
* like org.apache.hadoop.hbase.mapreduce.RowCounter.
* <p>
* @deprecated Deprecated in 2.0. See HBASE-13347
* @deprecated Deprecated in 2.0.0 and will be removed in 3.0.0.
* @see <a href="https://issues.apache.org/jira/browse/HBASE-13347">HBASE-13347</a>
*/
@InterfaceAudience.Public
@Deprecated

10
hbase-common/src/main/java/org/apache/hadoop/hbase/AuthUtil.java
View File

@ -72,12 +72,13 @@ import org.slf4j.LoggerFactory;
* for kerberized applications. For more, please refer
* <a href="http://hbase.apache.org/book.html#hbase.secure.configuration">Client-side Configuration for Secure Operation</a>
*
* @deprecated since 2.2.0, to be removed in hbase-3.0.0.
* @deprecated since 2.2.0, to be marked as
* {@link org.apache.yetus.audience.InterfaceAudience.Private} in 4.0.0.
* @see <a href="https://issues.apache.org/jira/browse/HBASE-20886">HBASE-20886</a>
*/
@Deprecated
@InterfaceAudience.Public
public final class AuthUtil {
// TODO: Mark this class InterfaceAudience.Private from 3.0.0
private static final Logger LOG = LoggerFactory.getLogger(AuthUtil.class);
/** Prefix character to denote group names */
@ -214,11 +215,12 @@ public final class AuthUtil {
* Checks if security is enabled and if so, launches chore for refreshing kerberos ticket.
* @param conf the hbase service configuration
* @return a ScheduledChore for renewals, if needed, and null otherwise.
* @deprecated Deprecated since 2.2.0, this method will be internal use only after 3.0.0.
* @deprecated Deprecated since 2.2.0, this method will be
* {@link org.apache.yetus.audience.InterfaceAudience.Private} use only after 4.0.0.
* @see <a href="https://issues.apache.org/jira/browse/HBASE-20886">HBASE-20886</a>
*/
@Deprecated
public static ScheduledChore getAuthChore(Configuration conf) throws IOException {
// TODO: Mark this method InterfaceAudience.Private from 3.0.0
User user = loginClientAsService(conf);
return getAuthRenewalChore(user.getUGI());
}

8
hbase-common/src/main/java/org/apache/hadoop/hbase/HBaseConfiguration.java
View File

@ -39,7 +39,9 @@ public class HBaseConfiguration extends Configuration {
/**
* Instantiating HBaseConfiguration() is deprecated. Please use
* HBaseConfiguration#create() to construct a plain Configuration
* @deprecated Please use create() instead.
* @deprecated since 0.90.0. Please use {@link #create()} instead.
* @see #create()
* @see <a href="https://issues.apache.org/jira/browse/HBASE-2036">HBASE-2036</a>
*/
@Deprecated
public HBaseConfiguration() {
@ -53,7 +55,9 @@ public class HBaseConfiguration extends Configuration {
/**
* Instantiating HBaseConfiguration() is deprecated. Please use
* HBaseConfiguration#create(conf) to construct a plain Configuration
* @deprecated Please user create(conf) instead.
* @deprecated since 0.90.0. Please use {@link #create(Configuration)} instead.
* @see #create(Configuration)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-2036">HBASE-2036</a>
*/
@Deprecated
public HBaseConfiguration(final Configuration c) {

5
hbase-common/src/main/java/org/apache/hadoop/hbase/TableName.java
View File

@ -82,8 +82,9 @@ public final class TableName implements Comparable<TableName> {
/**
* The Namespace table's name.
* @deprecated We have folded the data in namespace table into meta table, so do not use it any
* more.
* @deprecated since 3.0.0 and will be removed in 4.0.0. We have folded the data in namespace
* table into meta table, so do not use it any more.
* @see <a href="https://issues.apache.org/jira/browse/HBASE-21154">HBASE-21154</a>
*/
@Deprecated
public static final TableName NAMESPACE_TABLE_NAME =

4
hbase-common/src/main/java/org/apache/hadoop/hbase/io/ImmutableBytesWritable.java
View File

@ -117,7 +117,9 @@ implements WritableComparable<ImmutableBytesWritable> {
/**
* @return the number of valid bytes in the buffer
* @deprecated use {@link #getLength()} instead
* @deprecated since 0.98.5. Use {@link #getLength()} instead
* @see #getLength()
* @see <a href="https://issues.apache.org/jira/browse/HBASE-11561">HBASE-11561</a>
*/
@Deprecated
public int getSize() {

18
hbase-common/src/main/java/org/apache/hadoop/hbase/util/Bytes.java
View File

@ -226,7 +226,9 @@ public class Bytes implements Comparable<Bytes> {
/**
* @return the number of valid bytes in the buffer
* @deprecated use {@link #getLength()} instead
* @deprecated since 2.0.0 and will be removed in 3.0.0. Use {@link #getLength()} instead.
* @see #getLength()
* @see <a href="https://issues.apache.org/jira/browse/HBASE-11862">HBASE-11862</a>
*/
@Deprecated
public int getSize() {
@ -1319,7 +1321,9 @@ public class Bytes implements Comparable<Bytes> {
* @param offset Offset into array at which vint begins.
* @throws java.io.IOException e
* @return deserialized long from buffer.
* @deprecated Use {@link #readAsVLong(byte[],int)} instead.
* @deprecated since 0.98.12. Use {@link #readAsVLong(byte[],int)} instead.
* @see #readAsVLong(byte[], int)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-6919">HBASE-6919</a>
*/
@Deprecated
public static long readVLong(final byte [] buffer, final int offset)
@ -2102,7 +2106,10 @@ public class Bytes implements Comparable<Bytes> {
* arr[-1] = -Inf and arr[N] = Inf for an N-element array. The above
* means that this function can return 2N + 1 different values
* ranging from -(N + 1) to N - 1.
* @deprecated {@link Bytes#binarySearch(byte[][], byte[], int, int)}
* @deprecated since 2.0.0 and will be removed in 3.0.0. Use
* {@link #binarySearch(byte[][], byte[], int, int)} instead.
* @see #binarySearch(byte[][], byte[], int, int)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-13450">HBASE-13450</a>
*/
@Deprecated
public static int binarySearch(byte [][]arr, byte []key, int offset,
@ -2160,7 +2167,10 @@ public class Bytes implements Comparable<Bytes> {
* means that this function can return 2N + 1 different values
* ranging from -(N + 1) to N - 1.
* @return the index of the block
* @deprecated Use {@link Bytes#binarySearch(Cell[], Cell, CellComparator)}
* @deprecated since 2.0.0 and will be removed in 3.0.0. Use
* {@link #binarySearch(Cell[], Cell, CellComparator)} instead.
* @see #binarySearch(Cell[], Cell, CellComparator)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-13450">HBASE-13450</a>
*/
@Deprecated
public static int binarySearch(byte[][] arr, Cell key, RawComparator<Cell> comparator) {

5
hbase-common/src/main/java/org/apache/hadoop/hbase/util/Counter.java
View File

@ -25,7 +25,10 @@ import org.apache.yetus.audience.InterfaceAudience;
/**
* High scalable counter. Thread safe.
* @deprecated use {@link java.util.concurrent.atomic.LongAdder} instead.
* @deprecated since 2.0.0 and will be removed in 3.0.0. Use
* {@link java.util.concurrent.atomic.LongAdder} instead.
* @see java.util.concurrent.atomic.LongAdder
* @see <a href="https://issues.apache.org/jira/browse/HBASE-7612">HBASE-7612</a>
*/
@InterfaceAudience.Public
@Deprecated

6
hbase-mapreduce/src/main/java/org/apache/hadoop/hbase/mapred/TableOutputFormat.java
View File

@ -57,8 +57,10 @@ public class TableOutputFormat extends FileOutputFormat<ImmutableBytesWritable,
/**
* Instantiate a TableRecordWriter with the HBase HClient for writing.
*
* @deprecated Please use {@code #TableRecordWriter(JobConf)} This version does not clean up
* connections and will leak connections (removed in 2.0)
* @deprecated since 2.0.0 and will be removed in 3.0.0. Please use
* {@code #TableRecordWriter(JobConf)} instead. This version does not clean up connections and
* will leak connections (removed in 2.0).
* @see <a href="https://issues.apache.org/jira/browse/HBASE-16774">HBASE-16774</a>
*/
@Deprecated
public TableRecordWriter(final BufferedMutator mutator) throws IOException {

2
hbase-mapreduce/src/main/java/org/apache/hadoop/hbase/mapreduce/CellCreator.java
View File

@ -87,6 +87,8 @@ public class CellCreator {
* @param visExpression visibility expression to be associated with cell
* @return created Cell
* @throws IOException
* @deprecated since 0.98.9
* @see <a href="https://issues.apache.org/jira/browse/HBASE-10560">HBASE-10560</a>
*/
@Deprecated
public Cell create(byte[] row, int roffset, int rlength, byte[] family, int foffset, int flength,

5
hbase-mapreduce/src/main/java/org/apache/hadoop/hbase/mapreduce/HFileOutputFormat2.java
View File

@ -120,7 +120,10 @@ public class HFileOutputFormat2
/**
* The modification for the returned HTD doesn't affect the inner TD.
* @return A clone of inner table descriptor
* @deprecated use {@link #getTableDescriptor}
* @deprecated since 2.0.0 and will be removed in 3.0.0. Use {@link #getTableDescriptor()}
* instead.
* @see #getTableDescriptor()
* @see <a href="https://issues.apache.org/jira/browse/HBASE-18241">HBASE-18241</a>
*/
@Deprecated
public HTableDescriptor getHTableDescriptor() {

9
hbase-mapreduce/src/main/java/org/apache/hadoop/hbase/mapreduce/SimpleTotalOrderPartitioner.java
View File

@ -49,8 +49,17 @@ public class SimpleTotalOrderPartitioner<VALUE> extends Partitioner<ImmutableByt
implements Configurable {
private final static Logger LOG = LoggerFactory.getLogger(SimpleTotalOrderPartitioner.class);
/**
* @deprecated since 0.90.0
* @see <a href="https://issues.apache.org/jira/browse/HBASE-1923">HBASE-1923</a>
*/
@Deprecated
public static final String START = "hbase.simpletotalorder.start";
/**
* @deprecated since 0.90.0
* @see <a href="https://issues.apache.org/jira/browse/HBASE-1923">HBASE-1923</a>
*/
@Deprecated
public static final String END = "hbase.simpletotalorder.end";

10
hbase-mapreduce/src/main/java/org/apache/hadoop/hbase/mapreduce/TableMapReduceUtil.java
View File

@ -552,7 +552,10 @@ public class TableMapReduceUtil {
* @param job The job that requires the permission.
* @param quorumAddress string that contains the 3 required configuratins
* @throws IOException When the authentication token cannot be obtained.
* @deprecated Since 1.2.0, use {@link #initCredentialsForCluster(Job, Configuration)} instead.
* @deprecated Since 1.2.0 and will be removed in 3.0.0. Use
* {@link #initCredentialsForCluster(Job, Configuration)} instead.
* @see #initCredentialsForCluster(Job, Configuration)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-14886">HBASE-14886</a>
*/
@Deprecated
public static void initCredentialsForCluster(Job job, String quorumAddress)
@ -874,7 +877,10 @@ public class TableMapReduceUtil {
* Add the jars containing the given classes to the job's configuration
* such that JobClient will ship them to the cluster and add them to
* the DistributedCache.
* @deprecated rely on {@link #addDependencyJars(Job)} instead.
* @deprecated since 1.3.0 and will be removed in 3.0.0. Use {@link #addDependencyJars(Job)}
* instead.
* @see #addDependencyJars(Job)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-8386">HBASE-8386</a>
*/
@Deprecated
public static void addDependencyJars(Configuration conf,

5
hbase-replication/src/main/java/org/apache/hadoop/hbase/replication/ReplicationPeer.java
View File

@ -107,7 +107,10 @@ public interface ReplicationPeer {
void registerPeerConfigListener(ReplicationPeerConfigListener listener);
/**
* @deprecated Use {@link #registerPeerConfigListener(ReplicationPeerConfigListener)} instead.
* @deprecated since 2.1.0 and will be removed in 4.0.0. Use
* {@link #registerPeerConfigListener(ReplicationPeerConfigListener)} instead.
* @see #registerPeerConfigListener(ReplicationPeerConfigListener)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-10573">HBASE-19573</a>
*/
@Deprecated
default void trackPeerConfigChanges(ReplicationPeerConfigListener listener) {

7
hbase-server/src/main/java/org/apache/hadoop/hbase/coprocessor/RegionObserver.java
View File

@ -1030,7 +1030,12 @@ public interface RegionObserver {
* @param oldCell old cell containing previous value
* @param newCell the new cell containing the computed value
* @return the new cell, possibly changed
* @deprecated Use {@link #postIncrementBeforeWAL} or {@link #postAppendBeforeWAL} instead.
* @deprecated since 2.2.0 and will be removedin 4.0.0. Use
* {@link #postIncrementBeforeWAL(ObserverContext, Mutation, List)} or
* {@link #postAppendBeforeWAL(ObserverContext, Mutation, List)} instead.
* @see #postIncrementBeforeWAL(ObserverContext, Mutation, List)
* @see #postAppendBeforeWAL(ObserverContext, Mutation, List)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-21643">HBASE-21643</a>
*/
@Deprecated
default Cell postMutationBeforeWAL(ObserverContext<RegionCoprocessorEnvironment> ctx,

4
hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/RowTooBigException.java
View File

@ -25,7 +25,9 @@ import org.apache.yetus.audience.InterfaceAudience;
* set and row size appears to exceed max configured size (configurable via
* hbase.table.max.rowsize).
*
* @deprecated use {@link org.apache.hadoop.hbase.client.RowTooBigException} instead.
* @deprecated since 0.99.0. Use {@link org.apache.hadoop.hbase.client.RowTooBigException} instead.
* @see org.apache.hadoop.hbase.client.RowTooBigException
* @see <a href="https://issues.apache.org/jira/browse/HBASE-11893">HBASE-11893</a>
*/
@InterfaceAudience.Public
@Deprecated

4
hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/RpcSchedulerFactory.java
View File

@ -36,6 +36,10 @@ public interface RpcSchedulerFactory {
*/
RpcScheduler create(Configuration conf, PriorityFunction priority, Abortable server);
/**
* @deprecated since 1.0.0.
* @see <a href="https://issues.apache.org/jira/browse/HBASE-12028">HBASE-12028</a>
*/
@Deprecated
RpcScheduler create(Configuration conf, PriorityFunction priority);
}

4
hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/SimpleRpcSchedulerFactory.java
View File

@ -32,6 +32,10 @@ import org.apache.hadoop.hbase.ipc.SimpleRpcScheduler;
@InterfaceAudience.LimitedPrivate({HBaseInterfaceAudience.COPROC, HBaseInterfaceAudience.PHOENIX})
@InterfaceStability.Evolving
public class SimpleRpcSchedulerFactory implements RpcSchedulerFactory {
/**
* @deprecated since 1.0.0.
* @see <a href="https://issues.apache.org/jira/browse/HBASE-12028">HBASE-12028</a>
*/
@Override
@Deprecated
public RpcScheduler create(Configuration conf, PriorityFunction priority) {

14
hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreFileReader.java
View File

@ -187,13 +187,14 @@ public class StoreFileReader {
}
/**
* @deprecated Do not write further code which depends on this call. Instead
* use getStoreFileScanner() which uses the StoreFileScanner class/interface
* which is the preferred way to scan a store with higher level concepts.
* @deprecated since 2.0.0 and will be removed in 3.0.0. Do not write further code which depends
* on this call. Instead use getStoreFileScanner() which uses the StoreFileScanner
* class/interface which is the preferred way to scan a store with higher level concepts.
*
* @param cacheBlocks should we cache the blocks?
* @param pread use pread (for concurrent small readers)
* @return the underlying HFileScanner
* @see <a href="https://issues.apache.org/jira/browse/HBASE-15296">HBASE-15296</a>
*/
@Deprecated
public HFileScanner getScanner(boolean cacheBlocks, boolean pread) {
@ -201,9 +202,9 @@ public class StoreFileReader {
}
/**
* @deprecated Do not write further code which depends on this call. Instead
* use getStoreFileScanner() which uses the StoreFileScanner class/interface
* which is the preferred way to scan a store with higher level concepts.
* @deprecated since 2.0.0 and will be removed in 3.0.0. Do not write further code which depends
* on this call. Instead use getStoreFileScanner() which uses the StoreFileScanner
* class/interface which is the preferred way to scan a store with higher level concepts.
*
* @param cacheBlocks
* should we cache the blocks?
@ -212,6 +213,7 @@ public class StoreFileReader {
* @param isCompaction
* is scanner being used for compaction?
* @return the underlying HFileScanner
* @see <a href="https://issues.apache.org/jira/browse/HBASE-15296">HBASE-15296</a>
*/
@Deprecated
public HFileScanner getScanner(boolean cacheBlocks, boolean pread,

25
hbase-server/src/main/java/org/apache/hadoop/hbase/security/access/AccessController.java
View File

@ -1981,7 +1981,10 @@ public class AccessController implements MasterCoprocessor, RegionCoprocessor,
/* ---- Protobuf AccessControlService implementation ---- */
/**
* @deprecated Use {@link Admin#grant(UserPermission, boolean)} instead.
* @deprecated since 2.2.0 and will be removed in 4.0.0. Use
* {@link Admin#grant(UserPermission, boolean)} instead.
* @see Admin#grant(UserPermission, boolean)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-21739">HBASE-21739</a>
*/
@Deprecated
@Override
@ -2024,7 +2027,10 @@ public class AccessController implements MasterCoprocessor, RegionCoprocessor,
}
/**
* @deprecated Use {@link Admin#revoke(UserPermission)} instead.
* @deprecated since 2.2.0 and will be removed in 4.0.0. Use {@link Admin#revoke(UserPermission)}
* instead.
* @see Admin#revoke(UserPermission)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-21739">HBASE-21739</a>
*/
@Deprecated
@Override
@ -2064,7 +2070,10 @@ public class AccessController implements MasterCoprocessor, RegionCoprocessor,
}
/**
* @deprecated Use {@link Admin#getUserPermissions(GetUserPermissionsRequest)} instead.
* @deprecated since 2.2.0 and will be removed in 4.0.0. Use
* {@link Admin#getUserPermissions(GetUserPermissionsRequest)} instead.
* @see Admin#getUserPermissions(GetUserPermissionsRequest)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-21911">HBASE-21911</a>
*/
@Deprecated
@Override
@ -2115,7 +2124,10 @@ public class AccessController implements MasterCoprocessor, RegionCoprocessor,
}
/**
* @deprecated Use {@link Admin#hasUserPermissions(List)} instead.
* @deprecated since 2.2.0 and will be removed 4.0.0. Use {@link Admin#hasUserPermissions(List)}
* instead.
* @see Admin#hasUserPermissions(List)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-22117">HBASE-22117</a>
*/
@Deprecated
@Override
@ -2448,7 +2460,10 @@ public class AccessController implements MasterCoprocessor, RegionCoprocessor,
}
/**
* @deprecated Use {@link Admin#hasUserPermissions(String, List)} instead.
* @deprecated since 2.2.0 and will be removed in 4.0.0. Use
* {@link Admin#hasUserPermissions(String, List)} instead.
* @see Admin#hasUserPermissions(String, List)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-22117">HBASE-22117</a>
*/
@Deprecated
@Override

4
hbase-server/src/main/java/org/apache/hadoop/hbase/tool/LoadIncrementalHFiles.java
View File

@ -154,7 +154,9 @@ public class LoadIncrementalHFiles extends Configured implements Tool {
* the case where a region has split during the process of the load. When this happens, the HFile
* is split into two physical parts across the new region boundary, and each part is added back
* into the queue. The import process finishes when the queue is empty.
* @deprecated Use {@link BulkLoadHFiles} instead.
* @deprecated since 2.2.0 and will be removed in 4.0.0. Use {@link BulkLoadHFiles} instead.
* @see BulkLoadHFiles
* @see <a href="https://issues.apache.org/jira/browse/HBASE-21782">HBASE-21782</a>
*/
@InterfaceAudience.Public
@Deprecated

10
hbase-server/src/main/java/org/apache/hadoop/hbase/wal/WALEdit.java
View File

@ -91,7 +91,10 @@ public class WALEdit implements HeapSize {
}
/**
* @deprecated Since 2.0.1. Use {@link #WALEdit(int, boolean)} instead.
* @deprecated since 2.0.1 and will be removed in 4.0.0. Use {@link #WALEdit(int, boolean)}
* instead.
* @see #WALEdit(int, boolean)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-20781">HBASE-20781</a>
*/
@Deprecated
public WALEdit(boolean isReplay) {
@ -99,7 +102,10 @@ public class WALEdit implements HeapSize {
}
/**
* @deprecated Since 2.0.1. Use {@link #WALEdit(int, boolean)} instead.
* @deprecated since 2.0.1 and will be removed in 4.0.0. Use {@link #WALEdit(int, boolean)}
* instead.
* @see #WALEdit(int, boolean)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-20781">HBASE-20781</a>
*/
@Deprecated
public WALEdit(int cellCount) {

5
hbase-server/src/test/java/org/apache/hadoop/hbase/HBaseTestCase.java
View File

@ -47,7 +47,10 @@ import junit.framework.TestCase;
/**
* Abstract HBase test class. Initializes a few things that can come in handly
* like an HBaseConfiguration and filesystem.
* @deprecated Write junit4 unit tests using {@link HBaseTestingUtility}
* @deprecated since 2.0.0 and will be removed in 3.0.0. Write junit4 unit tests using
* {@link HBaseTestingUtility}.
* @see HBaseTestingUtility
* @see <a href="https://issues.apache.org/jira/browse/HBASE-11912">HBASE-11912</a>
*/
@Deprecated
public abstract class HBaseTestCase extends TestCase {

106
hbase-server/src/test/java/org/apache/hadoop/hbase/HBaseTestingUtility.java
View File

@ -181,7 +181,8 @@ public class HBaseTestingUtility extends HBaseZKTestingUtility {
* System property key to get test directory value. Name is as it is because mini dfs has
* hard-codings to put test data here. It should NOT be used directly in HBase, as it's a property
* used in mini dfs.
* @deprecated can be used only with mini dfs
* @deprecated since 2.0.0 and will be removed in 3.0.0. Can be used only with mini dfs.
* @see <a href="https://issues.apache.org/jira/browse/HBASE-19410">HBASE-19410</a>
*/
@Deprecated
private static final String TEST_DIRECTORY_KEY = "test.build.data";
@ -357,8 +358,11 @@ public class HBaseTestingUtility extends HBaseZKTestingUtility {
}
/**
* @deprecated use {@link HBaseTestingUtility#HBaseTestingUtility()} instead
* @deprecated since 2.0.0 and will be removed in 3.0.0. Use {@link #HBaseTestingUtility()}
* instead.
* @return a normal HBaseTestingUtility
* @see #HBaseTestingUtility()
* @see <a href="https://issues.apache.org/jira/browse/HBASE-19841">HBASE-19841</a>
*/
@Deprecated
public static HBaseTestingUtility createLocalHTU() {
@ -366,8 +370,11 @@ public class HBaseTestingUtility extends HBaseZKTestingUtility {
}
/**
* @deprecated use {@link HBaseTestingUtility#HBaseTestingUtility(Configuration)} instead
* @deprecated since 2.0.0 and will be removed in 3.0.0. Use
* {@link #HBaseTestingUtility(Configuration)} instead.
* @return a normal HBaseTestingUtility
* @see #HBaseTestingUtility(Configuration)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-19841">HBASE-19841</a>
*/
@Deprecated
public static HBaseTestingUtility createLocalHTU(Configuration c) {
@ -787,7 +794,10 @@ public class HBaseTestingUtility extends HBaseZKTestingUtility {
* @param createWALDir Whether to create a new WAL directory.
* @return The mini HBase cluster created.
* @see #shutdownMiniCluster()
* @deprecated Use {@link #startMiniCluster(StartMiniClusterOption)} instead.
* @deprecated since 2.2.0 and will be removed in 4.0.0. Use
* {@link #startMiniCluster(StartMiniClusterOption)} instead.
* @see #startMiniCluster(StartMiniClusterOption)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-21071">HBASE-21071</a>
*/
@Deprecated
public MiniHBaseCluster startMiniCluster(boolean createWALDir) throws Exception {
@ -803,7 +813,10 @@ public class HBaseTestingUtility extends HBaseZKTestingUtility {
* @param createRootDir Whether to create a new root or data directory path.
* @return The mini HBase cluster created.
* @see #shutdownMiniCluster()
* @deprecated Use {@link #startMiniCluster(StartMiniClusterOption)} instead.
* @deprecated since 2.2.0 and will be removed in 4.0.0. Use
* {@link #startMiniCluster(StartMiniClusterOption)} instead.
* @see #startMiniCluster(StartMiniClusterOption)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-21071">HBASE-21071</a>
*/
@Deprecated
public MiniHBaseCluster startMiniCluster(int numSlaves, boolean createRootDir)
@ -821,7 +834,10 @@ public class HBaseTestingUtility extends HBaseZKTestingUtility {
* @param createWALDir Whether to create a new WAL directory.
* @return The mini HBase cluster created.
* @see #shutdownMiniCluster()
* @deprecated Use {@link #startMiniCluster(StartMiniClusterOption)} instead.
* @deprecated since 2.2.0 and will be removed in 4.0.0. Use
* {@link #startMiniCluster(StartMiniClusterOption)} instead.
* @see #startMiniCluster(StartMiniClusterOption)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-21071">HBASE-21071</a>
*/
@Deprecated
public MiniHBaseCluster startMiniCluster(int numSlaves, boolean createRootDir,
@ -840,7 +856,10 @@ public class HBaseTestingUtility extends HBaseZKTestingUtility {
* @param createRootDir Whether to create a new root or data directory path.
* @return The mini HBase cluster created.
* @see #shutdownMiniCluster()
* @deprecated Use {@link #startMiniCluster(StartMiniClusterOption)} instead.
* @deprecated since 2.2.0 and will be removed in 4.0.0. Use
* {@link #startMiniCluster(StartMiniClusterOption)} instead.
* @see #startMiniCluster(StartMiniClusterOption)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-21071">HBASE-21071</a>
*/
@Deprecated
public MiniHBaseCluster startMiniCluster(int numMasters, int numSlaves, boolean createRootDir)
@ -858,7 +877,10 @@ public class HBaseTestingUtility extends HBaseZKTestingUtility {
* @param numSlaves Slave node number, for both HBase region server and HDFS data node.
* @return The mini HBase cluster created.
* @see #shutdownMiniCluster()
* @deprecated Use {@link #startMiniCluster(StartMiniClusterOption)} instead.
* @deprecated since 2.2.0 and will be removed in 4.0.0. Use
* {@link #startMiniCluster(StartMiniClusterOption)} instead.
* @see #startMiniCluster(StartMiniClusterOption)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-21071">HBASE-21071</a>
*/
@Deprecated
public MiniHBaseCluster startMiniCluster(int numMasters, int numSlaves) throws Exception {
@ -877,7 +899,10 @@ public class HBaseTestingUtility extends HBaseZKTestingUtility {
* @param createRootDir Whether to create a new root or data directory path.
* @return The mini HBase cluster created.
* @see #shutdownMiniCluster()
* @deprecated Use {@link #startMiniCluster(StartMiniClusterOption)} instead.
* @deprecated since 2.2.0 and will be removed in 4.0.0. Use
* {@link #startMiniCluster(StartMiniClusterOption)} instead.
* @see #startMiniCluster(StartMiniClusterOption)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-21071">HBASE-21071</a>
*/
@Deprecated
public MiniHBaseCluster startMiniCluster(int numMasters, int numSlaves, String[] dataNodeHosts,
@ -897,7 +922,10 @@ public class HBaseTestingUtility extends HBaseZKTestingUtility {
* HDFS data node number.
* @return The mini HBase cluster created.
* @see #shutdownMiniCluster()
* @deprecated Use {@link #startMiniCluster(StartMiniClusterOption)} instead.
* @deprecated since 2.2.0 and will be removed in 4.0.0. Use
* {@link #startMiniCluster(StartMiniClusterOption)} instead.
* @see #startMiniCluster(StartMiniClusterOption)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-21071">HBASE-21071</a>
*/
@Deprecated
public MiniHBaseCluster startMiniCluster(int numMasters, int numSlaves, String[] dataNodeHosts)
@ -916,7 +944,10 @@ public class HBaseTestingUtility extends HBaseZKTestingUtility {
* @param numDataNodes Number of datanodes.
* @return The mini HBase cluster created.
* @see #shutdownMiniCluster()
* @deprecated Use {@link #startMiniCluster(StartMiniClusterOption)} instead.
* @deprecated since 2.2.0 and will be removed in 4.0.0. Use
* {@link #startMiniCluster(StartMiniClusterOption)} instead.
* @see #startMiniCluster(StartMiniClusterOption)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-21071">HBASE-21071</a>
*/
@Deprecated
public MiniHBaseCluster startMiniCluster(int numMasters, int numRegionServers, int numDataNodes)
@ -938,7 +969,10 @@ public class HBaseTestingUtility extends HBaseZKTestingUtility {
* @param rsClass The class to use as HRegionServer, or null for default.
* @return The mini HBase cluster created.
* @see #shutdownMiniCluster()
* @deprecated Use {@link #startMiniCluster(StartMiniClusterOption)} instead.
* @deprecated since 2.2.0 and will be removed in 4.0.0. Use
* {@link #startMiniCluster(StartMiniClusterOption)} instead.
* @see #startMiniCluster(StartMiniClusterOption)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-21071">HBASE-21071</a>
*/
@Deprecated
public MiniHBaseCluster startMiniCluster(int numMasters, int numSlaves, String[] dataNodeHosts,
@ -965,7 +999,10 @@ public class HBaseTestingUtility extends HBaseZKTestingUtility {
* @param rsClass The class to use as HRegionServer, or null for default.
* @return The mini HBase cluster created.
* @see #shutdownMiniCluster()
* @deprecated Use {@link #startMiniCluster(StartMiniClusterOption)} instead.
* @deprecated since 2.2.0 and will be removed in 4.0.0. Use
* {@link #startMiniCluster(StartMiniClusterOption)} instead.
* @see #startMiniCluster(StartMiniClusterOption)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-21071">HBASE-21071</a>
*/
@Deprecated
public MiniHBaseCluster startMiniCluster(int numMasters, int numRegionServers, int numDataNodes,
@ -994,7 +1031,10 @@ public class HBaseTestingUtility extends HBaseZKTestingUtility {
* @param createWALDir Whether to create a new WAL directory.
* @return The mini HBase cluster created.
* @see #shutdownMiniCluster()
* @deprecated Use {@link #startMiniCluster(StartMiniClusterOption)} instead.
* @deprecated since 2.2.0 and will be removed in 4.0.0. Use
* {@link #startMiniCluster(StartMiniClusterOption)} instead.
* @see #startMiniCluster(StartMiniClusterOption)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-21071">HBASE-21071</a>
*/
@Deprecated
public MiniHBaseCluster startMiniCluster(int numMasters, int numRegionServers, int numDataNodes,
@ -1135,7 +1175,10 @@ public class HBaseTestingUtility extends HBaseZKTestingUtility {
* @param numRegionServers Number of region servers.
* @return The mini HBase cluster created.
* @see #shutdownMiniHBaseCluster()
* @deprecated Use {@link #startMiniHBaseCluster(StartMiniClusterOption)} instead.
* @deprecated since 2.2.0 and will be removed in 4.0.0. Use
* {@link #startMiniHBaseCluster(StartMiniClusterOption)} instead.
* @see #startMiniHBaseCluster(StartMiniClusterOption)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-21071">HBASE-21071</a>
*/
@Deprecated
public MiniHBaseCluster startMiniHBaseCluster(int numMasters, int numRegionServers)
@ -1154,7 +1197,10 @@ public class HBaseTestingUtility extends HBaseZKTestingUtility {
* @param rsPorts Ports that RegionServer should use.
* @return The mini HBase cluster created.
* @see #shutdownMiniHBaseCluster()
* @deprecated Use {@link #startMiniHBaseCluster(StartMiniClusterOption)} instead.
* @deprecated since 2.2.0 and will be removed in 4.0.0. Use
* {@link #startMiniHBaseCluster(StartMiniClusterOption)} instead.
* @see #startMiniHBaseCluster(StartMiniClusterOption)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-21071">HBASE-21071</a>
*/
@Deprecated
public MiniHBaseCluster startMiniHBaseCluster(int numMasters, int numRegionServers,
@ -1177,7 +1223,10 @@ public class HBaseTestingUtility extends HBaseZKTestingUtility {
* @param createWALDir Whether to create a new WAL directory.
* @return The mini HBase cluster created.
* @see #shutdownMiniHBaseCluster()
* @deprecated Use {@link #startMiniHBaseCluster(StartMiniClusterOption)} instead.
* @deprecated since 2.2.0 and will be removed in 4.0.0. Use
* {@link #startMiniHBaseCluster(StartMiniClusterOption)} instead.
* @see #startMiniHBaseCluster(StartMiniClusterOption)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-21071">HBASE-21071</a>
*/
@Deprecated
public MiniHBaseCluster startMiniHBaseCluster(int numMasters, int numRegionServers,
@ -1822,8 +1871,10 @@ public class HBaseTestingUtility extends HBaseZKTestingUtility {
/**
* Modify a table, synchronous.
* @deprecated just use {@link Admin#modifyTable(TableDescriptor)} directly as it is synchronous
* now.
* @deprecated since 3.0.0 and will be removed in 4.0.0. Just use
* {@link Admin#modifyTable(TableDescriptor)} directly as it is synchronous now.
* @see Admin#modifyTable(TableDescriptor)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-22002">HBASE-22002</a>
*/
@Deprecated
public static void modifyTableSync(Admin admin, TableDescriptor desc)
@ -1883,6 +1934,12 @@ public class HBaseTestingUtility extends HBaseZKTestingUtility {
public static final byte [] START_KEY_BYTES = {FIRST_CHAR, FIRST_CHAR, FIRST_CHAR};
public static final String START_KEY = new String(START_KEY_BYTES, HConstants.UTF8_CHARSET);
/**
* @deprecated since 2.0.0 and will be removed in 3.0.0. Use
* {@link #createTableDescriptor(TableName, int, int, int, KeepDeletedCells)} instead.
* @see #createTableDescriptor(TableName, int, int, int, KeepDeletedCells)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-13893">HBASE-13893</a>
*/
@Deprecated
public HTableDescriptor createTableDescriptor(final String name,
final int minVersions, final int versions, final int ttl, KeepDeletedCells keepDeleted) {
@ -1894,6 +1951,10 @@ public class HBaseTestingUtility extends HBaseZKTestingUtility {
* Create a table of name <code>name</code>.
* @param name Name to give table.
* @return Column descriptor.
* @deprecated since 2.0.0 and will be removed in 3.0.0. Use
* {@link #createTableDescriptor(TableName, int, int, int, KeepDeletedCells)} instead.
* @see #createTableDescriptor(TableName, int, int, int, KeepDeletedCells)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-13893">HBASE-13893</a>
*/
@Deprecated
public HTableDescriptor createTableDescriptor(final String name) {
@ -1995,8 +2056,11 @@ public class HBaseTestingUtility extends HBaseZKTestingUtility {
* @throws IOException
* @return A region on which you must call
{@link HBaseTestingUtility#closeRegionAndWAL(HRegion)} when done.
* @deprecated use
* {@link #createLocalHRegion(TableName, byte[], byte[], boolean, Durability, WAL, byte[]...)}
* @deprecated since 2.0.0 and will be removed in 3.0.0. Use
* {@link #createLocalHRegion(TableName, byte[], byte[], boolean, Durability, WAL, byte[]...)}
* instead.
* @see #createLocalHRegion(TableName, byte[], byte[], boolean, Durability, WAL, byte[]...)
* @see <a href="https://issues.apache.org/jira/browse/HBASE-13893">HBASE-13893</a>
*/
@Deprecated
public HRegion createLocalHRegion(byte[] tableName, byte[] startKey, byte[] stopKey,