src/main/java/de/uapcore/lightpit/RequestMapping.java

Wed, 13 May 2020 21:10:23 +0200

author
Mike Becker <universe@uap-core.de>
date
Wed, 13 May 2020 21:10:23 +0200
changeset 45
cc7f082c5ef3
parent 34
824d4042c857
child 70
821c4950b619
permissions
-rw-r--r--

simplifies menu generation, adds submenus and removes VersionsModule (versions will be part of the ProjectsModule)

     1 /*
     2  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
     3  *
     4  * Copyright 2018 Mike Becker. All rights reserved.
     5  *
     6  * Redistribution and use in source and binary forms, with or without
     7  * modification, are permitted provided that the following conditions are met:
     8  *
     9  *   1. Redistributions of source code must retain the above copyright
    10  *      notice, this list of conditions and the following disclaimer.
    11  *
    12  *   2. Redistributions in binary form must reproduce the above copyright
    13  *      notice, this list of conditions and the following disclaimer in the
    14  *      documentation and/or other materials provided with the distribution.
    15  *
    16  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
    17  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
    18  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
    19  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
    20  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
    21  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
    22  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
    23  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
    24  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
    25  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
    26  * POSSIBILITY OF SUCH DAMAGE.
    27  *
    28  */
    29 package de.uapcore.lightpit;
    31 import java.lang.annotation.*;
    34 /**
    35  * Maps requests to methods.
    36  * <p>
    37  * This annotation is used to annotate methods within classes which
    38  * override {@link AbstractLightPITServlet}.
    39  */
    40 @Documented
    41 @Retention(RetentionPolicy.RUNTIME)
    42 @Target(ElementType.METHOD)
    43 public @interface RequestMapping {
    45     /**
    46      * Specifies the HTTP method.
    47      *
    48      * @return the HTTP method handled by the annotated Java method
    49      */
    50     HttpMethod method();
    52     /**
    53      * Specifies the request path relative to the module path.
    54      * <p>
    55      * If a menu key is specified, this is also the path, which is linked
    56      * by the menu entry.
    57      * <p>
    58      * The path must be specified <em>without</em> leading and trailing slash.
    59      *
    60      * @return the request path the annotated method should handle
    61      */
    62     String requestPath() default "";
    64     /**
    65      * Specifies the properties key for the sub menu label.
    66      * An empty string (default) means that no sub menu entry shall be created.
    67      * <p>
    68      * This should only be used for {@link HttpMethod#GET} requests.
    69      *
    70      * @return the properties key
    71      */
    72     String menuKey() default "";
    74     /**
    75      * May be changed to control the ordering of menu items.
    76      *
    77      * @return an integer to control the ordering
    78      */
    79     int menuSequence() default 0;
    80 }

mercurial