NativeInt8Array.java revision 1073:06c06c8443fd 
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
26package jdk.nashorn.internal.objects;
27
28import static jdk.nashorn.internal.codegen.CompilerConstants.specialCall;
29
30import java.lang.invoke.MethodHandle;
31import java.lang.invoke.MethodHandles;
32import java.nio.ByteBuffer;
33import jdk.nashorn.internal.objects.annotations.Attribute;
34import jdk.nashorn.internal.objects.annotations.Constructor;
35import jdk.nashorn.internal.objects.annotations.Function;
36import jdk.nashorn.internal.objects.annotations.Property;
37import jdk.nashorn.internal.objects.annotations.ScriptClass;
38import jdk.nashorn.internal.objects.annotations.Where;
39import jdk.nashorn.internal.runtime.JSType;
40import jdk.nashorn.internal.runtime.PropertyMap;
41import jdk.nashorn.internal.runtime.ScriptObject;
42import jdk.nashorn.internal.runtime.arrays.ArrayData;
43import jdk.nashorn.internal.runtime.arrays.TypedArrayData;
44
45/**
46 * Int8Array for the TypedArray extension
47 */
48@ScriptClass("Int8Array")
49public final class NativeInt8Array extends ArrayBufferView {
50    /**
51     * The size in bytes of each element in the array.
52     */
53    @Property(attributes = Attribute.NOT_ENUMERABLE | Attribute.NOT_WRITABLE | Attribute.NOT_CONFIGURABLE, where = Where.CONSTRUCTOR)
54    public static final int BYTES_PER_ELEMENT = 1;
55
56    // initialized by nasgen
57    @SuppressWarnings("unused")
58    private static PropertyMap $nasgenmap$;
59
60    private static final Factory FACTORY = new Factory(BYTES_PER_ELEMENT) {
61        @Override
62        public ArrayBufferView construct(final NativeArrayBuffer buffer, final int byteOffset, final int length) {
63            return new NativeInt8Array(buffer, byteOffset, length);
64        }
65
66        @Override
67        public Int8ArrayData createArrayData(final ByteBuffer nb, final int start, final int end) {
68            return new Int8ArrayData(nb, start, end);
69        }
70
71        @Override
72        public String getClassName() {
73            return "Int8Array";
74        }
75    };
76
77    private static final class Int8ArrayData extends TypedArrayData<ByteBuffer> {
78
79        private static final MethodHandle GET_ELEM = specialCall(MethodHandles.lookup(), Int8ArrayData.class, "getElem", int.class, int.class).methodHandle();
80        private static final MethodHandle SET_ELEM = specialCall(MethodHandles.lookup(), Int8ArrayData.class, "setElem", void.class, int.class, int.class).methodHandle();
81
82        private Int8ArrayData(final ByteBuffer nb, final int start, final int end) {
83            super(((ByteBuffer)nb.position(start).limit(end)).slice(), end - start);
84        }
85
86        @Override
87        protected MethodHandle getGetElem() {
88            return GET_ELEM;
89        }
90
91        @Override
92        protected MethodHandle getSetElem() {
93            return SET_ELEM;
94        }
95
96        @Override
97        public Class<?> getElementType() {
98            return int.class;
99        }
100
101        @Override
102        public Class<?> getBoxedElementType() {
103            return Integer.class;
104        }
105
106        private int getElem(final int index) {
107            try {
108                return nb.get(index);
109            } catch (final IndexOutOfBoundsException e) {
110                throw new ClassCastException(); //force relink - this works for unoptimistic too
111            }
112        }
113
114        private void setElem(final int index, final int elem) {
115            try {
116                nb.put(index, (byte)elem);
117            } catch (final IndexOutOfBoundsException e) {
118                //swallow valid array indexes. it's ok.
119                if (index < 0) {
120                    throw new ClassCastException();
121                }
122            }
123        }
124
125        @Override
126        public int getInt(final int index) {
127            return getElem(index);
128        }
129
130        @Override
131        public int getIntOptimistic(final int index, final int programPoint) {
132            return getElem(index);
133        }
134
135        @Override
136        public long getLong(final int index) {
137            return getInt(index);
138        }
139
140        @Override
141        public long getLongOptimistic(final int index, final int programPoint) {
142            return getElem(index);
143        }
144
145        @Override
146        public double getDouble(final int index) {
147            return getInt(index);
148        }
149
150        @Override
151        public double getDoubleOptimistic(final int index, final int programPoint) {
152            return getElem(index);
153        }
154
155        @Override
156        public Object getObject(final int index) {
157            return getInt(index);
158        }
159
160        @Override
161        public ArrayData set(final int index, final Object value, final boolean strict) {
162            return set(index, JSType.toInt32(value), strict);
163        }
164
165        @Override
166        public ArrayData set(final int index, final int value, final boolean strict) {
167            setElem(index, value);
168            return this;
169        }
170
171        @Override
172        public ArrayData set(final int index, final long value, final boolean strict) {
173            return set(index, (int)value, strict);
174        }
175
176        @Override
177        public ArrayData set(final int index, final double value, final boolean strict) {
178            return set(index, (int)value, strict);
179        }
180    }
181
182
183    /**
184     * Constructor
185     *
186     * @param newObj is this typed array instantiated with the new operator
187     * @param self   self reference
188     * @param args   args
189     *
190     * @return new typed array
191     */
192    @Constructor(arity = 1)
193    public static NativeInt8Array constructor(final boolean newObj, final Object self, final Object... args) {
194        return (NativeInt8Array)constructorImpl(newObj, args, FACTORY);
195    }
196
197    NativeInt8Array(final NativeArrayBuffer buffer, final int byteOffset, final int length) {
198        super(buffer, byteOffset, length);
199    }
200
201    @Override
202    protected Factory factory() {
203        return FACTORY;
204    }
205
206    /**
207     * Set values
208     * @param self   self reference
209     * @param array  multiple values of array's type to set
210     * @param offset optional start index, interpreted  0 if undefined
211     * @return undefined
212     */
213    @Function(attributes = Attribute.NOT_ENUMERABLE)
214    protected static Object set(final Object self, final Object array, final Object offset) {
215        return ArrayBufferView.setImpl(self, array, offset);
216    }
217
218    /**
219     * Returns a new TypedArray view of the ArrayBuffer store for this TypedArray,
220     * referencing the elements at begin, inclusive, up to end, exclusive. If either
221     * begin or end is negative, it refers to an index from the end of the array,
222     * as opposed to from the beginning.
223     * <p>
224     * If end is unspecified, the subarray contains all elements from begin to the end
225     * of the TypedArray. The range specified by the begin and end values is clamped to
226     * the valid index range for the current array. If the computed length of the new
227     * TypedArray would be negative, it is clamped to zero.
228     * <p>
229     * The returned TypedArray will be of the same type as the array on which this
230     * method is invoked.
231     *
232     * @param self self reference
233     * @param begin begin position
234     * @param end end position
235     *
236     * @return sub array
237     */
238    @Function(attributes = Attribute.NOT_ENUMERABLE)
239    protected static NativeInt8Array subarray(final Object self, final Object begin, final Object end) {
240        return (NativeInt8Array)ArrayBufferView.subarrayImpl(self, begin, end);
241    }
242
243    @Override
244    protected ScriptObject getPrototype(final Global global) {
245        return global.getInt8ArrayPrototype();
246    }
247}
248