ddb84d6eca885f3580f5c5cc6f4a76bacfb1a883
[mdsal.git] / binding / mdsal-binding-generator-api / src / main / java / org / opendaylight / mdsal / binding / model / api / type / builder / TypeMemberBuilder.java
1 /*
2  * Copyright (c) 2014 Cisco Systems, Inc. and others.  All rights reserved.
3  *
4  * This program and the accompanying materials are made available under the
5  * terms of the Eclipse Public License v1.0 which accompanies this distribution,
6  * and is available at http://www.eclipse.org/legal/epl-v10.html
7  */
8 package org.opendaylight.mdsal.binding.model.api.type.builder;
9
10 import org.opendaylight.mdsal.binding.model.api.AccessModifier;
11 import org.opendaylight.mdsal.binding.model.api.Type;
12
13 public interface TypeMemberBuilder<T extends TypeMemberBuilder<T>> extends AnnotableTypeBuilder {
14     /**
15      * Returns the name of property.
16      *
17      * @return the name of property.
18      */
19     String getName();
20
21     /**
22      * Adds return Type into Builder definition for Generated Property. The return Type MUST NOT be <code>null</code>,
23      * otherwise the method SHOULD throw {@link IllegalArgumentException}
24      *
25      * @param returnType Return Type of property.
26      */
27     T setReturnType(Type returnType);
28
29     AccessModifier getAccessModifier();
30
31     /**
32      * Sets the access modifier of property.
33      *
34      * @param modifier Access Modifier value.
35      */
36     T setAccessModifier(AccessModifier modifier);
37
38     /**
39      * Adds String definition of comment into Method Signature definition. The comment String MUST NOT contain any
40      * comment specific chars (i.e. "/**" or "//") just plain String text description.
41      *
42      * @param comment Comment String.
43      */
44     T setComment(String comment);
45
46     /**
47      * Sets the flag final for method signature. If this is set the method will be prohibited from overriding. This
48      * setting is irrelevant for methods designated to be defined in interface definitions because interfaces cannot
49      * have a final method.
50      *
51      * @param isFinal Is Final
52      */
53     T setFinal(boolean isFinal);
54
55     T setStatic(boolean isStatic);
56 }