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.htmlpage.api;
20 import java.lang.annotation.ElementType;
21 import java.lang.annotation.Retention;
22 import java.lang.annotation.RetentionPolicy;
23 import java.lang.annotation.Target;
25 /** Static methods in classes annotated by {@link Model} or {@link Page}
26 * can be marked by this annotation establish a JSON communication point.
27 * The associated model page then gets new method to invoke a network
30 * @author Jaroslav Tulach <jtulach@netbeans.org>
32 @Retention(RetentionPolicy.SOURCE)
33 @Target(ElementType.METHOD)
34 public @interface OnReceive {
35 /** The URL to connect to. Can contain variable names surrounded by '{' and '}'.
36 * Those parameters will then become variables of the associated method.
38 * @return the (possibly parametrized) url to connect to
42 /** Support for <a href="http://en.wikipedia.org/wiki/JSONP">JSONP</a> requires
43 * a callback from the server generated page to a function defined in the
44 * system. The name of such function is usually specified as a property
45 * (of possibly different names). By defining the <code>jsonp</code> attribute
46 * one turns on the <a href="http://en.wikipedia.org/wiki/JSONP">JSONP</a>
47 * transmission and specifies the name of the property. The property should
48 * also be used in the {@link #url()} attribute on appropriate place.
50 * @return name of a property to carry the name of <a href="http://en.wikipedia.org/wiki/JSONP">JSONP</a>
53 String jsonp() default "";