com.caoccao.javet.values.virtual.V8VirtualIterator Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of javet-linux-arm64 Show documentation
Javet is Java + V8 (JAVa + V + EighT). It is an awesome way of embedding Node.js and V8 in Java.
There is a newer version: 4.0.0
/*
 * Copyright (c) 2023-2024. caoccao.com Sam Cao
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package com.caoccao.javet.values.virtual;

import com.caoccao.javet.exceptions.JavetException;
import com.caoccao.javet.interop.V8Runtime;
import com.caoccao.javet.interop.callback.IJavetDirectCallable;
import com.caoccao.javet.interop.callback.JavetCallbackContext;
import com.caoccao.javet.interop.callback.JavetCallbackType;
import com.caoccao.javet.interop.proxy.IJavetDirectProxyHandler;
import com.caoccao.javet.utils.V8ValueUtils;
import com.caoccao.javet.values.V8Value;
import com.caoccao.javet.values.primitive.V8ValueString;
import com.caoccao.javet.values.reference.V8ValueArray;
import com.caoccao.javet.values.reference.V8ValueSymbol;
import com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol;

import java.util.Iterator;
import java.util.Objects;
import java.util.Optional;

/**
 * The type V8 virtual iterator.
 *
 * @param  the type parameter for internal iterable
 * @param  the type parameter for external exception
 * @since 2.2.1
 */
public class V8VirtualIterator
        implements IJavetDirectProxyHandler {
    /**
     * The constant FUNCTION_NEXT.
     *
     * @since 2.2.1
     */
    protected static final String FUNCTION_NEXT = "next";
    /**
     * The constant PROPERTY_DONE.
     *
     * @since 2.2.1
     */
    protected static final String PROPERTY_DONE = "done";
    /**
     * The constant PROPERTY_VALUE.
     *
     * @since 2.2.1
     */
    protected static final String PROPERTY_VALUE = "value";
    /**
     * The Iterable.
     *
     * @since 2.2.1
     */
    protected Iterator iterator;
    /**
     * The V8 runtime.
     *
     * @since 2.2.1
     */
    protected V8Runtime v8Runtime;
    /**
     * The Value.
     *
     * @since 2.2.1
     */
    protected T value;

    /**
     * Instantiates a new V8 virtual iterator.
     *
     * @param iterator the iterable
     * @since 2.2.1
     */
    public V8VirtualIterator(Iterator iterator) {
        this.iterator = Objects.requireNonNull(iterator);
        value = null;
        v8Runtime = null;
    }

    @Override
    public V8Runtime getV8Runtime() {
        return v8Runtime;
    }

    /**
     * Next.
     *
     * @param thisObject the this object
     * @param v8Values   the V8 values
     * @return the V8 value
     * @since 2.2.1
     */
    protected V8Value next(V8Value thisObject, V8Value... v8Values) {
        if (iterator != null) {
            if (iterator.hasNext()) {
                value = iterator.next();
            } else {
                iterator = null;
                value = null;
            }
        }
        return thisObject;
    }

    @Override
    public V8Value proxyGet(V8Value target, V8Value property, V8Value receiver) throws JavetException, E {
        if (property instanceof V8ValueString) {
            String propertyName = ((V8ValueString) property).getValue();
            if (FUNCTION_NEXT.equals(propertyName)) {
                return v8Runtime.createV8ValueFunction(
                        new JavetCallbackContext(
                                FUNCTION_NEXT, this, JavetCallbackType.DirectCallThisAndResult,
                                (IJavetDirectCallable.ThisAndResult) this::next));
            }
            if (PROPERTY_DONE.equals(propertyName)) {
                return v8Runtime.createV8ValueBoolean(iterator == null);
            }
            if (PROPERTY_VALUE.equals(propertyName)) {
                if (iterator == null) {
                    return v8Runtime.createV8ValueUndefined();
                }
                return v8Runtime.toV8Value(value);
            }
        }
        if (property instanceof V8ValueSymbol) {
            V8ValueSymbol propertySymbol = (V8ValueSymbol) property;
            String description = propertySymbol.getDescription();
            if (V8ValueBuiltInSymbol.SYMBOL_PROPERTY_ITERATOR.equals(description)) {
                return v8Runtime.createV8ValueFunction(new JavetCallbackContext(
                        FUNCTION_NEXT, this, JavetCallbackType.DirectCallThisAndResult,
                        (IJavetDirectCallable.ThisAndResult) (thisObject, v8Values) -> thisObject));
            }
        }
        return IJavetDirectProxyHandler.super.proxyGet(target, property, receiver);
    }

    @Override
    public V8ValueArray proxyOwnKeys(V8Value target) throws JavetException, E {
        return V8ValueUtils.createV8ValueArray(
                v8Runtime,
                v8Runtime.createV8ValueString(PROPERTY_DONE),
                v8Runtime.createV8ValueString(PROPERTY_VALUE));
    }

    @Override
    public void setV8Runtime(V8Runtime v8Runtime) {
        this.v8Runtime = v8Runtime;
    }

    @Override
    public V8Value symbolToPrimitive(V8Value... v8Values) throws JavetException, E {
        return v8Runtime.createV8ValueString(
                Optional.ofNullable(iterator)
                        .map(Object::toString)
                        .orElse(String.valueOf((Object) null)));
    }
}