156ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson/*
256ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * Copyright (C) 2010 Google Inc.
356ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson *
456ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * Licensed under the Apache License, Version 2.0 (the "License");
556ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * you may not use this file except in compliance with the License.
656ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * You may obtain a copy of the License at
756ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson *
856ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * http://www.apache.org/licenses/LICENSE-2.0
956ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson *
1056ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * Unless required by applicable law or agreed to in writing, software
1156ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * distributed under the License is distributed on an "AS IS" BASIS,
1256ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
1356ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * See the License for the specific language governing permissions and
1456ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * limitations under the License.
1556ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson */
1656ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson
1756ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodsonpackage com.google.clearsilver.jsilver.template;
1856ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson
1956ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodsonimport com.google.clearsilver.jsilver.exceptions.JSilverInterpreterException;
2056ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson
2156ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson/**
2256ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson * An executable macro. This exhibits all the same characteristics of a Template.
2356ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson */
2456ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodsonpublic interface Macro extends Template {
2556ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson
2656ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson  /**
2756ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson   * Name of macro (e.g. showTable). Used to generate error messages.
2856ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson   */
2956ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson  String getMacroName();
3056ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson
3156ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson  /**
3256ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson   * Get the name of the nth argument defined in the macro. Throws exception if the argument is not
3356ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson   * found.
3456ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson   */
3556ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson  String getArgumentName(int index) throws JSilverInterpreterException;
3656ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson
3756ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson  /**
3856ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson   * Return the number of arguments this macro expects. Must be equal to the number of arguments
3956ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson   * supplied.
4056ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson   */
4156ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson  int getArgumentCount();
4256ed4167b942ec265f9cee70ac4d71d10b3835ceBen Dodson}
43