1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/json/src/main/java/net/java/html/json/Component.java Tue Dec 15 23:19:35 2015 +0100
1.3 @@ -0,0 +1,77 @@
1.4 +/**
1.5 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
1.6 + *
1.7 + * Copyright 2013-2014 Oracle and/or its affiliates. All rights reserved.
1.8 + *
1.9 + * Oracle and Java are registered trademarks of Oracle and/or its affiliates.
1.10 + * Other names may be trademarks of their respective owners.
1.11 + *
1.12 + * The contents of this file are subject to the terms of either the GNU
1.13 + * General Public License Version 2 only ("GPL") or the Common
1.14 + * Development and Distribution License("CDDL") (collectively, the
1.15 + * "License"). You may not use this file except in compliance with the
1.16 + * License. You can obtain a copy of the License at
1.17 + * http://www.netbeans.org/cddl-gplv2.html
1.18 + * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
1.19 + * specific language governing permissions and limitations under the
1.20 + * License. When distributing the software, include this License Header
1.21 + * Notice in each file and include the License file at
1.22 + * nbbuild/licenses/CDDL-GPL-2-CP. Oracle designates this
1.23 + * particular file as subject to the "Classpath" exception as provided
1.24 + * by Oracle in the GPL Version 2 section of the License file that
1.25 + * accompanied this code. If applicable, add the following below the
1.26 + * License Header, with the fields enclosed by brackets [] replaced by
1.27 + * your own identifying information:
1.28 + * "Portions Copyrighted [year] [name of copyright owner]"
1.29 + *
1.30 + * Contributor(s):
1.31 + *
1.32 + * The Original Software is NetBeans. The Initial Developer of the Original
1.33 + * Software is Oracle. Portions Copyright 2013-2014 Oracle. All Rights Reserved.
1.34 + *
1.35 + * If you wish your version of this file to be governed by only the CDDL
1.36 + * or only the GPL Version 2, indicate your decision by adding
1.37 + * "[Contributor] elects to include this software in this distribution
1.38 + * under the [CDDL or GPL Version 2] license." If you do not indicate a
1.39 + * single choice of license, a recipient has the option to distribute
1.40 + * your version of this file under either the CDDL, the GPL Version 2 or
1.41 + * to extend the choice of license to its licensees as provided above.
1.42 + * However, if you add GPL Version 2 code and therefore, elected the GPL
1.43 + * Version 2 license, then the option applies only if the new code is
1.44 + * made subject to such option by the copyright holder.
1.45 + */
1.46 +package net.java.html.json;
1.47 +
1.48 +import java.lang.annotation.ElementType;
1.49 +import java.lang.annotation.Retention;
1.50 +import java.lang.annotation.RetentionPolicy;
1.51 +import java.lang.annotation.Target;
1.52 +
1.53 +/** Defines a reusable piece of code and UI. Put the annotation on a
1.54 + * method that accepts a class generated by the {@link Model} annotation
1.55 + * and returns another class generated with the help of the
1.56 + * {@link Model} annotation. The first annotation describes the
1.57 + * input parameters. The latter one the internal structure of the
1.58 + * {@link #template() declarative UI snippet}.
1.59 + */
1.60 +@Target(ElementType.METHOD)
1.61 +@Retention(RetentionPolicy.SOURCE)
1.62 +public @interface Component {
1.63 + /**
1.64 + * Gives the component a name.
1.65 + * @return name that one uses from the UI to reference this component
1.66 + */
1.67 + public String name();
1.68 + /**
1.69 + * Location of associated file with UI. Usually (but not always) a fragment
1.70 + * of HTML that
1.71 + * @return
1.72 + */
1.73 + public String template();
1.74 + /**
1.75 + * Technologies that should be preferred when processing the
1.76 + * {@link #template} of this component.
1.77 + * @return ids of technologies to prefer inside of the component
1.78 + */
1.79 + public String[] techIds() default {};
1.80 +}