/**

  * Back 2 Browser Bytecode Translator

  * Copyright (C) 2012 Jaroslav Tulach <jaroslav.tulach@apidesign.org>

  *

  * 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 <jtulach@netbeans.org>

  */

 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<Resource> 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();

     }

     private static RegisterResource RR;

     static void register(RegisterResource rr) {

         RR = rr;

     }

     /** A running {@link InvocationContext test} can register additional 

      * resources to the associated browser (if any). 

      * 

      * @param content the stream to deliver content from

      * @param mimeType mime type for the HTTP reply

      * @param path suggested path in the server to use

      * @param parameters additional parameters

      * @return the URI the resource is made available at

      * @throws NullPointerException if there is no {@link InvocationContext test} 

      *    currently running

      * @since 0.8

      */

     public static URI register(

         InputStream content, String mimeType, String path, String[] parameters

     ) {

         final Resource r = new Resource(content, mimeType, path, parameters);

         return RR.registerResource(r);

     }

     static interface RegisterResource {

         public URI registerResource(Resource r);

     }

     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;

         }

     }

 }