org.apidesign.bck2brwsr.launcher.InvocationContext Maven / Gradle / Ivy

Go to download
/**
 * Back 2 Browser Bytecode Translator
 * Copyright (C) 2012-2015 Jaroslav Tulach 
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, version 2 of the License.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program. Look for COPYING file in the top folder.
 * If not, see http://opensource.org/licenses/GPL-2.0.
 */
package org.apidesign.bck2brwsr.launcher;

import java.io.IOException;
import java.io.InputStream;
import java.net.URI;
import java.util.ArrayList;
import java.util.List;
import java.util.concurrent.CountDownLatch;
import java.util.concurrent.TimeUnit;

/** Represents individual method invocation, its context and its result.
 *
 * @author Jaroslav Tulach 
 */
public final class InvocationContext {
    final CountDownLatch wait = new CountDownLatch(1);
    final Class clazz;
    final String methodName;
    private final Launcher launcher;
    private String result;
    private Throwable exception;
    String html;
    final List resources = new ArrayList<>();

    InvocationContext(Launcher launcher, Class clazz, String methodName) {
        this.launcher = launcher;
        this.clazz = clazz;
        this.methodName = methodName;
    }
    
    /** An HTML fragment to be available for the execution. Useful primarily when
     * executing in a browser via {@link Launcher#createBrowser(java.lang.String)}.
     * @param html the html fragment
     */
    public void setHtmlFragment(String html) {
        this.html = html;
    }
    
    /** HTTP resource to be available during execution. An invocation may
     * perform an HTTP query and obtain a resource relative to the page.
     */
    public void addHttpResource(String relativePath, String mimeType, String[] parameters, InputStream content) {
        if (relativePath == null || mimeType == null || content == null || parameters == null) {
            throw new NullPointerException();
        }
        resources.add(new Resource(content, mimeType, relativePath, parameters));
    }
    
    /** Invokes the associated method. 
     * @return the textual result of the invocation
     */
    public String invoke() throws IOException {
        launcher.runMethod(this);
        return toString();
    }
    
    /** Obtains textual result of the invocation.
     * @return text representing the exception or result value
     */
    @Override
    public String toString() {
        if (exception != null) {
            return exception.toString();
        }
        return result;
    }
    
    /**
     * @param timeOut
     * @throws InterruptedException 
     */
    void await(long timeOut) throws InterruptedException {
        wait.await(timeOut, TimeUnit.MILLISECONDS);
    }
    
    void result(String r, Throwable e) {
        this.result = r;
        this.exception = e;
        wait.countDown();
    }

    static final class Resource {
        final InputStream httpContent;
        final String httpType;
        final String httpPath;
        final String[] parameters;

        Resource(InputStream httpContent, String httpType, String httpPath,
            String[] parameters
        ) {
            httpContent.mark(Integer.MAX_VALUE);
            this.httpContent = httpContent;
            this.httpType = httpType;
            this.httpPath = httpPath;
            this.parameters = parameters;
        }
    }
}