View Javadoc

1   /* Copyright (c) 2008 Sascha Kohlmann
2    *
3    * This program is free software: you can redistribute it and/or modify
4    * it under the terms of the GNU Affero General Public License as published by
5    * the Free Software Foundation, either version 3 of the License, or
6    * (at your option) any later version.
7    *
8    * This program is distributed in the hope that it will be useful,
9    * but WITHOUT ANY WARRANTY; without even the implied warranty of
10   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
11   * GNU Affero General Public License for more details.
12   *
13   * You should have received a copy of the GNU Affero General Public License
14   * along with this program.  If not, see <http://www.gnu.org/licenses/>.
15   */
16  package net.sf.eos;
17  
18  import java.lang.annotation.Documented;
19  import java.lang.annotation.ElementType;
20  import java.lang.annotation.Retention;
21  import java.lang.annotation.RetentionPolicy;
22  import java.lang.annotation.Target;
23  
24  /**
25   * The presence of this annotation on a method parameter indicates that
26   * {@code null} is an acceptable value for that parameter. Cause of undefined
27   * semantic it must not be used for parameters of primitive types.
28   *
29   * <p><strong>Note:</strong> experimental - inspired by <em>guice</em></p>
30   *
31   * @author Sascha Kohlmann
32   * @since 0.1.0
33   */
34  @Experimental
35  @Documented
36  @Retention(RetentionPolicy.RUNTIME)
37  @Target(ElementType.PARAMETER)
38  public @interface Nullable { }