1 /* 2 * Copyright (c) 2010, 2013, Oracle and/or its affiliates. All rights reserved. 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 4 * 5 * This code is free software; you can redistribute it and/or modify it 6 * under the terms of the GNU General Public License version 2 only, as 7 * published by the Free Software Foundation. Oracle designates this 8 * particular file as subject to the "Classpath" exception as provided 9 * by Oracle in the LICENSE file that accompanied this code. 10 * 11 * This code is distributed in the hope that it will be useful, but WITHOUT 12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 14 * version 2 for more details (a copy is included in the LICENSE file that 15 * accompanied this code). 16 * 17 * You should have received a copy of the GNU General Public License version 18 * 2 along with this work; if not, write to the Free Software Foundation, 19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 20 * 21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 22 * or visit www.oracle.com if you need additional information or have any 23 * questions. 24 */ 25 26 package jdk.nashorn.internal.objects; 27 28 import static jdk.nashorn.internal.codegen.CompilerConstants.specialCall; 29 30 import java.lang.invoke.MethodHandle; 31 import java.lang.invoke.MethodHandles; 32 import java.nio.ByteBuffer; 33 import jdk.nashorn.internal.objects.annotations.Attribute; 34 import jdk.nashorn.internal.objects.annotations.Constructor; 35 import jdk.nashorn.internal.objects.annotations.Function; 36 import jdk.nashorn.internal.objects.annotations.Property; 37 import jdk.nashorn.internal.objects.annotations.ScriptClass; 38 import jdk.nashorn.internal.objects.annotations.Where; 39 import jdk.nashorn.internal.runtime.JSType; 40 import jdk.nashorn.internal.runtime.PropertyMap; 41 import jdk.nashorn.internal.runtime.ScriptObject; 42 import jdk.nashorn.internal.runtime.arrays.ArrayData; 43 import jdk.nashorn.internal.runtime.arrays.TypedArrayData; 44 45 /** 46 * Uint8 array for TypedArray extension 47 */ 48 @ScriptClass("Uint8Array") 49 public final class NativeUint8Array extends ArrayBufferView { 50 51 /** 52 * The size in bytes of each element in the array. 53 */ 54 @Property(attributes = Attribute.NOT_ENUMERABLE | Attribute.NOT_WRITABLE | Attribute.NOT_CONFIGURABLE, where = Where.CONSTRUCTOR) 55 public static final int BYTES_PER_ELEMENT = 1; 56 57 // initialized by nasgen 58 @SuppressWarnings("unused") 59 private static PropertyMap $nasgenmap$; 60 61 private static final Factory FACTORY = new Factory(BYTES_PER_ELEMENT) { 62 @Override 63 public ArrayBufferView construct(final NativeArrayBuffer buffer, final int byteOffset, final int length) { 64 return new NativeUint8Array(buffer, byteOffset, length); 65 } 66 67 @Override 68 public Uint8ArrayData createArrayData(final ByteBuffer nb, final int start, final int end) { 69 return new Uint8ArrayData(nb, start, end); 70 } 71 72 @Override 73 public String getClassName() { 74 return "Uint8Array"; 75 } 76 }; 77 78 private static final class Uint8ArrayData extends TypedArrayData<ByteBuffer> { 79 80 private static final MethodHandle GET_ELEM = specialCall(MethodHandles.lookup(), Uint8ArrayData.class, "getElem", int.class, int.class).methodHandle(); 81 private static final MethodHandle SET_ELEM = specialCall(MethodHandles.lookup(), Uint8ArrayData.class, "setElem", void.class, int.class, int.class).methodHandle(); 82 83 private Uint8ArrayData(final ByteBuffer nb, final int start, final int end) { 84 super(((ByteBuffer)nb.position(start).limit(end)).slice(), end - start); 85 } 86 87 @Override 88 protected MethodHandle getGetElem() { 89 return GET_ELEM; 90 } 91 92 @Override 93 protected MethodHandle getSetElem() { 94 return SET_ELEM; 95 } 96 97 private int getElem(final int index) { 98 try { 99 return nb.get(index) & 0xff; 100 } catch (final IndexOutOfBoundsException e) { 101 throw new ClassCastException(); //force relink - this works for unoptimistic too 102 } 103 } 104 105 private void setElem(final int index, final int elem) { 106 try { 107 if (index < nb.limit()) { 108 nb.put(index, (byte) elem); 109 } 110 } catch (final IndexOutOfBoundsException e) { 111 throw new ClassCastException(); 112 } 113 } 114 115 @Override 116 public boolean isUnsigned() { 117 return true; 118 } 119 120 @Override 121 public Class<?> getElementType() { 122 return int.class; 123 } 124 125 @Override 126 public Class<?> getBoxedElementType() { 127 return Integer.class; 128 } 129 130 @Override 131 public int getInt(final int index) { 132 return getElem(index); 133 } 134 135 @Override 136 public int getIntOptimistic(final int index, final int programPoint) { 137 return getElem(index); 138 } 139 140 @Override 141 public long getLong(final int index) { 142 return getInt(index); 143 } 144 145 @Override 146 public long getLongOptimistic(final int index, final int programPoint) { 147 return getElem(index); 148 } 149 150 @Override 151 public double getDouble(final int index) { 152 return getInt(index); 153 } 154 155 @Override 156 public double getDoubleOptimistic(final int index, final int programPoint) { 157 return getElem(index); 158 } 159 160 @Override 161 public Object getObject(final int index) { 162 return getInt(index); 163 } 164 165 @Override 166 public ArrayData set(final int index, final Object value, final boolean strict) { 167 return set(index, JSType.toInt32(value), strict); 168 } 169 170 @Override 171 public ArrayData set(final int index, final int value, final boolean strict) { 172 setElem(index, value); 173 return this; 174 } 175 176 @Override 177 public ArrayData set(final int index, final long value, final boolean strict) { 178 return set(index, (int)value, strict); 179 } 180 181 @Override 182 public ArrayData set(final int index, final double value, final boolean strict) { 183 return set(index, (int)value, strict); 184 } 185 186 } 187 188 /** 189 * Constructor 190 * 191 * @param newObj is this typed array instantiated with the new operator 192 * @param self self reference 193 * @param args args 194 * 195 * @return new typed array 196 */ 197 @Constructor(arity = 1) 198 public static NativeUint8Array constructor(final boolean newObj, final Object self, final Object... args) { 199 return (NativeUint8Array)constructorImpl(newObj, args, FACTORY); 200 } 201 202 NativeUint8Array(final NativeArrayBuffer buffer, final int byteOffset, final int length) { 203 super(buffer, byteOffset, length); 204 } 205 206 @Override 207 protected Factory factory() { 208 return FACTORY; 209 } 210 211 /** 212 * Set values 213 * @param self self reference 214 * @param array multiple values of array's type to set 215 * @param offset optional start index, interpreted 0 if undefined 216 * @return undefined 217 */ 218 @Function(attributes = Attribute.NOT_ENUMERABLE) 219 protected static Object set(final Object self, final Object array, final Object offset) { 220 return ArrayBufferView.setImpl(self, array, offset); 221 } 222 223 /** 224 * Returns a new TypedArray view of the ArrayBuffer store for this TypedArray, 225 * referencing the elements at begin, inclusive, up to end, exclusive. If either 226 * begin or end is negative, it refers to an index from the end of the array, 227 * as opposed to from the beginning. 228 * <p> 229 * If end is unspecified, the subarray contains all elements from begin to the end 230 * of the TypedArray. The range specified by the begin and end values is clamped to 231 * the valid index range for the current array. If the computed length of the new 232 * TypedArray would be negative, it is clamped to zero. 233 * <p> 234 * The returned TypedArray will be of the same type as the array on which this 235 * method is invoked. 236 * 237 * @param self self reference 238 * @param begin begin position 239 * @param end end position 240 * 241 * @return sub array 242 */ 243 @Function(attributes = Attribute.NOT_ENUMERABLE) 244 protected static NativeUint8Array subarray(final Object self, final Object begin, final Object end) { 245 return (NativeUint8Array)ArrayBufferView.subarrayImpl(self, begin, end); 246 } 247 248 @Override 249 protected ScriptObject getPrototype(final Global global) { 250 return global.getUint8ArrayPrototype(); 251 } 252 }