UTF8ByteArrayUtils.java
上传用户:quxuerui
上传日期:2018-01-08
资源大小:41811k
文件大小:8k
源码类别:

网格计算

开发平台:

Java

  1. /**
  2.  * Licensed to the Apache Software Foundation (ASF) under one
  3.  * or more contributor license agreements.  See the NOTICE file
  4.  * distributed with this work for additional information
  5.  * regarding copyright ownership.  The ASF licenses this file
  6.  * to you under the Apache License, Version 2.0 (the
  7.  * "License"); you may not use this file except in compliance
  8.  * with the License.  You may obtain a copy of the License at
  9.  *
  10.  *     http://www.apache.org/licenses/LICENSE-2.0
  11.  *
  12.  * Unless required by applicable law or agreed to in writing, software
  13.  * distributed under the License is distributed on an "AS IS" BASIS,
  14.  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  15.  * See the License for the specific language governing permissions and
  16.  * limitations under the License.
  17.  */
  18. package org.apache.hadoop.streaming;
  19. import java.io.IOException;
  20. import org.apache.hadoop.io.Text;
  21. import org.apache.hadoop.util.LineReader;
  22. /**
  23.  * General utils for byte array containing UTF-8 encoded strings
  24.  * @deprecated use {@link org.apache.hadoop.util.UTF8ByteArrayUtils} and
  25.  * {@link StreamKeyValUtil} instead
  26.  */
  27. public class UTF8ByteArrayUtils {
  28.   /**
  29.    * Find the first occured tab in a UTF-8 encoded string
  30.    * @param utf a byte array containing a UTF-8 encoded string
  31.    * @param start starting offset
  32.    * @param length no. of bytes
  33.    * @return position that first tab occures otherwise -1
  34.    * @deprecated use {@link StreamKeyValUtil#findTab(byte[], int, int)}
  35.    */
  36.   @Deprecated
  37.   public static int findTab(byte [] utf, int start, int length) {
  38.     return StreamKeyValUtil.findTab(utf, start, length);      
  39.   }
  40.   
  41.   /**
  42.    * Find the first occurrence of the given byte b in a UTF-8 encoded string
  43.    * @param utf a byte array containing a UTF-8 encoded string
  44.    * @param start starting offset
  45.    * @param end ending position
  46.    * @param b the byte to find
  47.    * @return position that first byte occures otherwise -1
  48.    * @deprecated use 
  49.    * {@link org.apache.hadoop.util.UTF8ByteArrayUtils#findByte(byte[], int,
  50.    *  int, byte)}
  51.    */
  52.   @Deprecated
  53.   public static int findByte(byte [] utf, int start, int end, byte b) {
  54.     return org.apache.hadoop.util.UTF8ByteArrayUtils.findByte(utf, start, end, b);
  55.   }
  56.   /**
  57.    * Find the first occurrence of the given bytes b in a UTF-8 encoded string
  58.    * @param utf a byte array containing a UTF-8 encoded string
  59.    * @param start starting offset
  60.    * @param end ending position
  61.    * @param b the bytes to find
  62.    * @return position that first byte occures otherwise -1
  63.    * @deprecated use 
  64.    * {@link org.apache.hadoop.util.UTF8ByteArrayUtils#findBytes(byte[], int, 
  65.    * int, byte[])}
  66.    */
  67.   @Deprecated
  68.   public static int findBytes(byte [] utf, int start, int end, byte[] b) {
  69.     return org.apache.hadoop.util.UTF8ByteArrayUtils.findBytes(utf, start, end, b);      
  70.   }
  71.     
  72.   /**
  73.    * Find the nth occurrence of the given byte b in a UTF-8 encoded string
  74.    * @param utf a byte array containing a UTF-8 encoded string
  75.    * @param start starting offset
  76.    * @param length the length of byte array
  77.    * @param b the byte to find
  78.    * @param n the desired occurrence of the given byte
  79.    * @return position that nth occurrence of the given byte if exists; otherwise -1
  80.    * @deprecated use 
  81.    * {@link org.apache.hadoop.util.UTF8ByteArrayUtils#findNthByte(byte[], int, 
  82.    * int, byte, int)}
  83.    */
  84.   @Deprecated
  85.   public static int findNthByte(byte [] utf, int start, int length, byte b, int n) {
  86.     return org.apache.hadoop.util.UTF8ByteArrayUtils.findNthByte(utf, start,
  87.         length, b, n);
  88.   }
  89.   
  90.   /**
  91.    * Find the nth occurrence of the given byte b in a UTF-8 encoded string
  92.    * @param utf a byte array containing a UTF-8 encoded string
  93.    * @param b the byte to find
  94.    * @param n the desired occurrence of the given byte
  95.    * @return position that nth occurrence of the given byte if exists; otherwise -1
  96.    * @deprecated use 
  97.    * {@link org.apache.hadoop.util.UTF8ByteArrayUtils#findNthByte(byte[], 
  98.    * byte, int)}
  99.    */
  100.   @Deprecated
  101.   public static int findNthByte(byte [] utf, byte b, int n) {
  102.     return org.apache.hadoop.util.UTF8ByteArrayUtils.findNthByte(utf, b, n);      
  103.   }
  104.     
  105.   /**
  106.    * Find the first occured tab in a UTF-8 encoded string
  107.    * @param utf a byte array containing a UTF-8 encoded string
  108.    * @return position that first tab occures otherwise -1
  109.    * @deprecated use {@link StreamKeyValUtil#findTab(byte[])}
  110.    */
  111.   @Deprecated
  112.   public static int findTab(byte [] utf) {
  113.     return StreamKeyValUtil.findTab(utf);
  114.   }
  115.   /**
  116.    * split a UTF-8 byte array into key and value 
  117.    * assuming that the delimilator is at splitpos. 
  118.    * @param utf utf-8 encoded string
  119.    * @param start starting offset
  120.    * @param length no. of bytes
  121.    * @param key contains key upon the method is returned
  122.    * @param val contains value upon the method is returned
  123.    * @param splitPos the split pos
  124.    * @param separatorLength the length of the separator between key and value
  125.    * @deprecated use 
  126.    * {@link StreamKeyValUtil#splitKeyVal(byte[], int, int, Text, Text, 
  127.    * int, int)}
  128.    * @throws IOException
  129.    */
  130.   @Deprecated
  131.   public static void splitKeyVal(byte[] utf, int start, int length, 
  132.                                  Text key, Text val, int splitPos,
  133.                                  int separatorLength) throws IOException {
  134.     StreamKeyValUtil.splitKeyVal(utf, start, 
  135.         length, key, val, splitPos, separatorLength);
  136.   }
  137.   /**
  138.    * split a UTF-8 byte array into key and value 
  139.    * assuming that the delimilator is at splitpos. 
  140.    * @param utf utf-8 encoded string
  141.    * @param start starting offset
  142.    * @param length no. of bytes
  143.    * @param key contains key upon the method is returned
  144.    * @param val contains value upon the method is returned
  145.    * @param splitPos the split pos
  146.    * @deprecated use 
  147.    * {@link StreamKeyValUtil#splitKeyVal(byte[], int, int, Text, Text, int)}
  148.    * @throws IOException
  149.    */
  150.   @Deprecated
  151.   public static void splitKeyVal(byte[] utf, int start, int length, 
  152.                                  Text key, Text val, int splitPos) throws IOException {
  153.     StreamKeyValUtil.splitKeyVal(utf, start, length, key, val, splitPos);
  154.   }
  155.   
  156.   /**
  157.    * split a UTF-8 byte array into key and value 
  158.    * assuming that the delimilator is at splitpos. 
  159.    * @param utf utf-8 encoded string
  160.    * @param key contains key upon the method is returned
  161.    * @param val contains value upon the method is returned
  162.    * @param splitPos the split pos
  163.    * @param separatorLength the length of the separator between key and value
  164.    * @deprecated use 
  165.    * {@link StreamKeyValUtil#splitKeyVal(byte[], Text, Text, int, int)}
  166.    * @throws IOException
  167.    */
  168.   @Deprecated
  169.   public static void splitKeyVal(byte[] utf, Text key, Text val, int splitPos, 
  170.                                  int separatorLength) 
  171.     throws IOException {
  172.     StreamKeyValUtil.splitKeyVal(utf, key, val, splitPos, separatorLength);
  173.   }
  174.   /**
  175.    * split a UTF-8 byte array into key and value 
  176.    * assuming that the delimilator is at splitpos. 
  177.    * @param utf utf-8 encoded string
  178.    * @param key contains key upon the method is returned
  179.    * @param val contains value upon the method is returned
  180.    * @param splitPos the split pos
  181.    * @deprecated use 
  182.    * {@link StreamKeyValUtil#splitKeyVal(byte[], Text, Text, int)}
  183.    * @throws IOException
  184.    */
  185.   @Deprecated
  186.   public static void splitKeyVal(byte[] utf, Text key, Text val, int splitPos) 
  187.     throws IOException {
  188.     StreamKeyValUtil.splitKeyVal(utf, key, val, splitPos);
  189.   }
  190.   
  191.   /**
  192.    * Read a utf8 encoded line from a data input stream. 
  193.    * @param lineReader LineReader to read the line from.
  194.    * @param out Text to read into
  195.    * @return number of bytes read
  196.    * @deprecated use 
  197.    * {@link StreamKeyValUtil#readLine(LineReader, Text)} 
  198.    * @throws IOException
  199.    */
  200.   @Deprecated
  201.   public static int readLine(LineReader lineReader, Text out) 
  202.   throws IOException {
  203.     return StreamKeyValUtil.readLine(lineReader, out);
  204.   }
  205. }