launcher/api/src/main/java/org/apidesign/bck2brwsr/launcher/InvocationContext.java
2 * Back 2 Browser Bytecode Translator
3 * Copyright (C) 2012 Jaroslav Tulach <jaroslav.tulach@apidesign.org>
5 * This program is free software: you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation, version 2 of the License.
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
14 * You should have received a copy of the GNU General Public License
15 * along with this program. Look for COPYING file in the top folder.
16 * If not, see http://opensource.org/licenses/GPL-2.0.
18 package org.apidesign.bck2brwsr.launcher;
20 import java.io.IOException;
21 import java.io.InputStream;
23 import java.util.ArrayList;
24 import java.util.List;
25 import java.util.concurrent.CountDownLatch;
26 import java.util.concurrent.TimeUnit;
28 /** Represents individual method invocation, its context and its result.
30 * @author Jaroslav Tulach <jtulach@netbeans.org>
32 public final class InvocationContext {
33 final CountDownLatch wait = new CountDownLatch(1);
35 final String methodName;
36 private final Launcher launcher;
37 private String result;
38 private Throwable exception;
40 final List<Resource> resources = new ArrayList<Resource>();
42 InvocationContext(Launcher launcher, Class<?> clazz, String methodName) {
43 this.launcher = launcher;
45 this.methodName = methodName;
48 /** An HTML fragment to be available for the execution. Useful primarily when
49 * executing in a browser via {@link Launcher#createBrowser(java.lang.String)}.
50 * @param html the html fragment
52 public void setHtmlFragment(String html) {
56 /** HTTP resource to be available during execution. An invocation may
57 * perform an HTTP query and obtain a resource relative to the page.
59 public void addHttpResource(String relativePath, String mimeType, String[] parameters, InputStream content) {
60 if (relativePath == null || mimeType == null || content == null || parameters == null) {
61 throw new NullPointerException();
63 resources.add(new Resource(content, mimeType, relativePath, parameters));
66 /** Invokes the associated method.
67 * @return the textual result of the invocation
69 public String invoke() throws IOException {
70 launcher.runMethod(this);
74 /** Obtains textual result of the invocation.
75 * @return text representing the exception or result value
78 public String toString() {
79 if (exception != null) {
80 return exception.toString();
87 * @throws InterruptedException
89 void await(long timeOut) throws InterruptedException {
90 wait.await(timeOut, TimeUnit.MILLISECONDS);
93 void result(String r, Throwable e) {
99 static final class Resource {
100 final InputStream httpContent;
101 final String httpType;
102 final String httpPath;
103 final String[] parameters;
105 Resource(InputStream httpContent, String httpType, String httpPath,
108 httpContent.mark(Integer.MAX_VALUE);
109 this.httpContent = httpContent;
110 this.httpType = httpType;
111 this.httpPath = httpPath;
112 this.parameters = parameters;