/*
 * #%L
 * ImageJ software for multidimensional image processing and analysis.
 * %%
 * Copyright (C) 2009 - 2013 Board of Regents of the University of
 * Wisconsin-Madison, Broad Institute of MIT and Harvard, and Max Planck
 * Institute of Molecular Cell Biology and Genetics.
 * %%
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 * 
 * 1. Redistributions of source code must retain the above copyright notice,
 *    this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright notice,
 *    this list of conditions and the following disclaimer in the documentation
 *    and/or other materials provided with the distribution.
 * 
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE
 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGE.
 * 
 * The views and conclusions contained in the software and documentation are
 * those of the authors and should not be interpreted as representing official
 * policies, either expressed or implied, of any organization.
 * #L%
 */

package imagej.script;

import java.io.File;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.io.Reader;
import java.io.Writer;
import java.util.Collection;
import java.util.List;
import java.util.concurrent.Future;

import javax.script.ScriptEngine;
import javax.script.ScriptEngineFactory;
import javax.script.ScriptException;

import org.scijava.plugin.Plugin;
import org.scijava.plugin.SingletonService;

/**
 * Interface for service that works with scripting languages. This service
 * discovers available scripting languages, and provides convenience methods to
 * interact with them.
 * 
 * @author Johannes Schindelin
 */
public interface ScriptService extends SingletonService<ScriptLanguage> {

	// -- Scripting languages --

	/** Gets the index of available scripting languages. */
	ScriptLanguageIndex getIndex();

	/**
	 * Gets the available scripting languages, including wrapped
	 * {@link ScriptEngineFactory} instances available from the Java scripting
	 * framework itself.
	 * <p>
	 * This method is similar to {@link #getInstances()}, except that
	 * {@link #getInstances()} only returns {@link ScriptLanguage} subclasses
	 * annotated with @{@link Plugin}.
	 * </p>
	 */
	List<ScriptLanguage> getLanguages();

	/** TODO */
	ScriptLanguage getByFileExtension(final String fileExtension);

	/** TODO */
	ScriptLanguage getByName(final String name);

	// -- Scripts --

	/** Gets all available scripts. */
	Collection<ScriptInfo> getScripts();

	/**
	 * Gets the {@link ScriptInfo} metadata for the script at the given file, or
	 * null if none.
	 */
	ScriptInfo getScript(File scriptFile);

	/** TODO */
	Future<ScriptModule> run(final File file) throws FileNotFoundException,
		ScriptException;

	/** TODO */
	Future<ScriptModule> run(final String path, final String script)
		throws IOException, ScriptException;

	/** TODO */
	Future<ScriptModule> run(final String path, final Reader reader)
		throws IOException, ScriptException;

	/** TODO */
	boolean canHandleFile(final File file);

	/** TODO */
	boolean canHandleFile(final String fileName);

	/** TODO */
	void initialize(final ScriptEngine engine, final String fileName,
		final Writer writer, final Writer errorWriter);

}

@@ -3127,22 +3127,16 @@
 tension(
-final 
 String f
@@ -3190,22 +3190,16 @@
 tByName(
-final 
 String n
@@ -3485,22 +3485,16 @@
 le%3E run(
-final 
 File fil
@@ -3577,38 +3577,32 @@
 riptModule%3E run(
-final 
 String path, fin
@@ -3597,22 +3597,16 @@
 ng path,
- final
  String 
@@ -3692,22 +3692,16 @@
 le%3E run(
-final 
 String p
@@ -3704,22 +3704,16 @@
 ng path,
- final
  Reader 
@@ -3796,22 +3796,16 @@
 dleFile(
-final 
 File fil
@@ -3845,22 +3845,16 @@
 dleFile(
-final 
 String f
@@ -3894,22 +3894,16 @@
 tialize(
-final 
 ScriptEn
@@ -3914,22 +3914,16 @@
  engine,
- final
  String 
@@ -3935,16 +3935,8 @@
 ame,
-%0A%09%09final
  Wri
@@ -3950,15 +3950,11 @@
 ter,
- final 
+%0A%09%09
 Writ

remove unnecessary final keywords