01: /*
02: * WebSphinx web-crawling toolkit
03: *
04: * Copyright (c) 1998-2002 Carnegie Mellon University. All rights
05: * reserved.
06: *
07: * Redistribution and use in source and binary forms, with or without
08: * modification, are permitted provided that the following conditions
09: * are met:
10: *
11: * 1. Redistributions of source code must retain the above copyright
12: * notice, this list of conditions and the following disclaimer.
13: *
14: * 2. Redistributions in binary form must reproduce the above copyright
15: * notice, this list of conditions and the following disclaimer in
16: * the documentation and/or other materials provided with the
17: * distribution.
18: *
19: * THIS SOFTWARE IS PROVIDED BY CARNEGIE MELLON UNIVERSITY ``AS IS'' AND
20: * ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
21: * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
22: * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL CARNEGIE MELLON UNIVERSITY
23: * NOR ITS EMPLOYEES BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
24: * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
25: * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
26: * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
27: * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
28: * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
29: * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
30: *
31: */
32:
33: package websphinx.workbench;
34:
35: public interface ScriptInterpreter {
36: /**
37: * Return name of language this interpreter handles.
38: * @return Language name, such as "Javascript" or "TCL"
39: */
40: public abstract String getLanguage();
41:
42: /**
43: * Evaluate an expression in the script language.
44: * @param expression Expression to evaluate
45: * @exception ScriptException if execution encounters an error
46: */
47: public abstract Object eval(String expression)
48: throws ScriptException;
49:
50: /**
51: * Construct a procedure or function.
52: * @param args Argument names
53: * @param body Function body
54: * @return Function object suitable for apply()
55: * @exception ScriptException if execution encounters an error
56: */
57: public abstract Object lambda(String[] args, String body)
58: throws ScriptException;
59:
60: /**
61: * Call a procedure or function.
62: * @param func Function object (previously returned by lambda()
63: * @param args Arguments for the function
64: * @exception ScriptException if execution encounters an error
65: */
66: public abstract Object apply(Object func, Object[] args)
67: throws ScriptException;
68:
69: /**
70: * Set a variable in the interpreter's global namespace
71: * @param name Name of variable
72: * @param object New value for variable
73: */
74: public abstract void set(String name, Object object);
75:
76: /**
77: * Get a variable defined in the interpreter's global
78: * namespace
79: * @param name Name of variable to get
80: * @return Value of variable, or null if not defined
81: */
82: public abstract Object get(String name);
83: }
|