Examples of org.apache.harmony.pack200.Codec

org.apache.harmony.pack200.Codec
A codec allows a sequence of bytes to be decoded into integer values (or vice versa). It uses a variable-length encoding and a modified sign representation such that small numbers are represented as a single byte, whilst larger numbers take more bytes to encode. The number may be signed or unsigned; if it is unsigned, it can be weighted towards positive numbers or equally distributed using a one's complement. The codec also supports delta coding, where a sequence of numbers is represented as a series of first-order differences. So a delta encoding of the integers [1..10] would be represented as a sequence of 10x1s. This allows the absolute value of a coded integer to fall outside of the 'small number' range, whilst still being encoded as a single byte. A codec is configured with four parameters:

B

The maximum number of bytes that each value is encoded as. B must be a value between [1..5]. For a pass-through coding (where each byte is encoded as itself, aka {@link #BYTE1}, B is 1 (each byte takes a maximum of 1 byte).

H

The radix of the integer. Values are defined as a sequence of values, where value n is multiplied by H^ⁿ. So the number 1234 may be represented as the sequence 4 3 2 1 with a radix (H) of 10. Note that other permutations are also possible; 43 2 1 will also encode 1234. The co-parameter L is defined as 256-H. This is important because only the last value in a sequence may be < L; all prior values must be > L.

S

Whether the codec represents signed values (or not). This may have 3 values; 0 (unsigned), 1 (signed, ones complement) or 2 (signed, but not sure what the difference is) TODO Update documentation when I know what the difference is

D

Whether the codec represents a delta encoding. This may be 0 (no delta) or 1 (delta encoding). A delta encoding of 1 indicates that values are cumulative; a sequence of 1 1 1 1 1 will represent the sequence 1 2 3 4 5. For this reason, the codec supports two variants of decode; one {@link #decode(InputStream,long) with} and one{@link #decode(InputStream) without} a last parameter. If thecodec is a non-delta encoding, then the value is ignored if passed. If the codec is a delta encoding, it is a run-time error to call the value without the extra parameter, and the previous value should be returned. (It was designed this way to support multi-threaded access without requiring a new instance of the Codec to be cloned for each use.)

Codecs are notated as (B,H,S,D) and either D or S,D may be omitted if zero. Thus {@link #BYTE1} is denoted (1,256,0,0) or (1,256). The{@link #toString()} method prints out the condensed form of the encoding.Often, the last character in the name ( {@link #BYTE1}, {@link #UNSIGNED5}) gives a clue as to the B value. Those that start with U ( {@link #UDELTA5}, {@link #UNSIGNED5}) are unsigned; otherwise, in most cases, they are signed. The presence of the word Delta ( {@link #DELTA5}, {@link #UDELTA5}) indicates a delta encoding is used. This codec is really quite cool for storing compressed information, and could be used entirely separately from the Pack200 implementation for efficient transfer of integer data if required. Note that all information is byte-oriented; for decoding float/double information, the bit values are converted (not cast) into a long type. Note that long values are used throughout even though most may be cast to ints; this is primarily to avoid having to worry about signed values, even if it would be more efficient to do so. There are a number of standard codecs ( {@link #UDELTA5}, {@link #UNSIGNED5}, {@link #BYTE1}, {@link #CHAR3}) that are used in the implementation of many bands; but there are a variety of other ones, and indeed the specification assumes that other combinations of values can result in more specific and efficient formats. There are also a sequence of canonical encodings defined by the Pack200 specification, which allow a codec to be referred to by canonical number. TODO Add links to canonical numbers when this has been done. @author Alex Blewitt @version $Revision: $

    for (int i = 0; i < 255; i++)
      decode(Codec.BYTE1, new byte[] { (byte) i }, i, 0);
  }


  public void testByte1Delta() throws Exception {
    Codec BYTE1D = new BHSDCodec(1, 256, 0, 1);
    long last = 0;
    for (int i = 1; i < 255; i++)
      last = decode(BYTE1D, new byte[] { (byte) 1 }, i, last);
  }

View Full Code Here

    long last = 0;
    for (int i = 1; i < 255; i++)
      last = decode(BYTE1D, new byte[] { (byte) 1 }, i, last);
  }
  public void testByte1DeltaException() throws Exception {
    Codec BYTE1D = new BHSDCodec(1, 256, 0, 1);
    try {
      BYTE1D.decode(new ByteArrayInputStream(new byte[] { (byte) 1 }));
      fail("Decoding with a delta stream and not passing a last value should throw exception");
    } catch (Pack200Exception e) {
      assertTrue(true);
    }
  }

View Full Code Here

    } catch (Pack200Exception e) {
      assertTrue(true);
    }
  }
  public void testByte1Signed() throws Exception {
    Codec BYTE1S2 = new BHSDCodec(1,256,2);
    decode(BYTE1S2,new byte[] { 0 }, 0, 0);
    decode(BYTE1S2,new byte[] { 1 }, 1, 0);
    decode(BYTE1S2,new byte[] { 2 }, 2, 0);
    decode(BYTE1S2,new byte[] { 3 }, -1, 0);
    decode(BYTE1S2,new byte[] { 4 }, 3, 0);

View Full Code Here

     *             invalid
     */
    public int[] decodeBandInt(String name, InputStream in, BHSDCodec codec,
            int count) throws IOException, Pack200Exception {
        int[] band;
        Codec codecUsed = codec;
        if (codec.getB() == 1 || count == 0) {
            return codec.decodeInts(count, in);
        }
        int[] getFirst = codec.decodeInts(1, in);
        if (getFirst.length == 0) {
            return getFirst;
        }
        int first = getFirst[0];
        if (codec.isSigned() && first >= -256 && first <= -1) {
            // Non-default codec should be used
            codecUsed = CodecEncoding.getCodec((-1 - first), header
                    .getBandHeadersInputStream(), codec);
            band = codecUsed.decodeInts(count, in);
        } else if (!codec.isSigned() && first >= codec.getL()
                && first <= codec.getL() + 255) {
            // Non-default codec should be used
            codecUsed = CodecEncoding.getCodec(first - codec.getL(), header
                    .getBandHeadersInputStream(), codec);
            band = codecUsed.decodeInts(count, in);
        } else {
            // First element should not be discarded
            band = codec.decodeInts(count - 1, in, first);
        }
        if (codecUsed instanceof BHSDCodec && ((BHSDCodec) codecUsed).isDelta()) {
            BHSDCodec bhsd = (BHSDCodec) codecUsed;
            long cardinality = bhsd.cardinality();
            for (int i = 0; i < band.length; i++) {
                while (band[i] > bhsd.largest()) {
                    band[i] -= cardinality;
                }
                while (band[i] < bhsd.smallest()) {
                    band[i] += cardinality;
                }
            }
        } else if (codecUsed instanceof PopulationCodec) {
            PopulationCodec popCodec = (PopulationCodec) codecUsed;
            long[] favoured = (long[]) popCodec.getFavoured().clone();
            Arrays.sort(favoured);
            for (int i = 0; i < band.length; i++) {
                boolean favouredValue = Arrays.binarySearch(favoured, band[i]) > -1;
                Codec theCodec = favouredValue ? popCodec.getFavouredCodec()
                        : popCodec.getUnfavouredCodec();
                if (theCodec instanceof BHSDCodec
                        && ((BHSDCodec) theCodec).isDelta()) {
                    BHSDCodec bhsd = (BHSDCodec) theCodec;
                    long cardinality = bhsd.cardinality();

View Full Code Here

 * 
 */
public class CodecEncodingTest extends TestCase {
  
    public void testCanonicalEncodings() throws IOException, Pack200Exception { 
    Codec defaultCodec = new BHSDCodec(2,16,0,0);
    assertEquals(defaultCodec,CodecEncoding.getCodec(0,null, defaultCodec));
    Map map = new HashMap();
    // These are the canonical encodings specified by the Pack200 spec
    map.put(new Integer(1), "(1,256)");
    map.put(new Integer(2), "(1,256,1)");

View Full Code Here

    for (int i = 0; i < 255; i++)
      decode(Codec.BYTE1, new byte[] { (byte) i }, i, 0);
  }


  public void testByte1Delta() throws Exception {
    Codec BYTE1D = new BHSDCodec(1, 256, 0, 1);
    long last = 0;
    for (int i = 1; i < 255; i++)
      last = decode(BYTE1D, new byte[] { (byte) 1 }, i, last);
  }

View Full Code Here

    long last = 0;
    for (int i = 1; i < 255; i++)
      last = decode(BYTE1D, new byte[] { (byte) 1 }, i, last);
  }
  public void testByte1DeltaException() throws Exception {
    Codec BYTE1D = new BHSDCodec(1, 256, 0, 1);
    try {
      BYTE1D.decode(new ByteArrayInputStream(new byte[] { (byte) 1 }));
      fail("Decoding with a delta stream and not passing a last value should throw exception");
    } catch (Pack200Exception e) {
      assertTrue(true);
    }
  }

View Full Code Here

    } catch (Pack200Exception e) {
      assertTrue(true);
    }
  }
  public void testByte1Signed() throws Exception {
    Codec BYTE1S2 = new BHSDCodec(1,256,2);
    decode(BYTE1S2,new byte[] { 0 }, 0, 0);
    decode(BYTE1S2,new byte[] { 1 }, 1, 0);
    decode(BYTE1S2,new byte[] { 2 }, 2, 0);
    decode(BYTE1S2,new byte[] { 3 }, -1, 0);
    decode(BYTE1S2,new byte[] { 4 }, 3, 0);

View Full Code Here

 *
 */
public class CodecEncodingTest extends TestCase {


    public void testCanonicalEncodings() throws IOException, Pack200Exception {
        Codec defaultCodec = new BHSDCodec(2, 16, 0, 0);
        assertEquals(defaultCodec, CodecEncoding
                .getCodec(0, null, defaultCodec));
        Map map = new HashMap();
        // These are the canonical encodings specified by the Pack200 spec
        map.put(new Integer(1), "(1,256)");

View Full Code Here

        for (int i = 1; i <= 115; i++) {
            assertEquals(i, CodecEncoding.getSpecifier(CodecEncoding.getCodec(i, null, null), null)[0]);
        }


        // Test a range of non-canonical codecs
        Codec c1 = new BHSDCodec(2, 125, 0, 1);
        int[] specifiers = CodecEncoding.getSpecifier(c1, null);
        assertEquals(3, specifiers.length);
        assertEquals(116, specifiers[0]);
        byte[] bytes = new byte[] {(byte) specifiers[1], (byte) specifiers[2]};
        InputStream in = new ByteArrayInputStream(bytes);

View Full Code Here

0 1 2 3 4 5 6 7 8 9

TOP

Related Classes of org.apache.harmony.pack200.Codec

org.ajax4jsf.resource.ResourceBuilderImpl

org.apache.bcel.classfile.ConstantNameAndType

org.apache.bcel.classfile.Unknown

org.apache.cassandra.db.ConsistencyLevel

org.apache.cassandra.db.marshal.AbstractType

org.apache.cassandra.service.pager.PagingState

org.apache.harmony.pack200.Archive

org.apache.harmony.pack200.AttributeDefinitionBands.AttributeDefinition

org.apache.harmony.pack200.AttributeLayout

org.apache.harmony.pack200.BandSet

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.