BUG-6533: add immutable implementations of yang.model.api
[yangtools.git] / yang / yang-model-api / src / main / java / org / opendaylight / yangtools / yang / model / api / type / PatternConstraint.java
1 /*
2  * Copyright (c) 2013 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.yangtools.yang.model.api.type;
9
10 import javax.annotation.Nullable;
11 import org.opendaylight.yangtools.yang.model.api.ConstraintMetaDefinition;
12
13 /**
14  * Contains the method for getting the data from the YANG <code>pattern</code>
15  * which is substatement of <code>type</code> statement.
16  */
17 public interface PatternConstraint extends ConstraintMetaDefinition {
18
19     /**
20      * Returns a regular expression (pattern).
21      *
22      * @return string with regular expression which is equal to the argument of
23      *         the YANG <code>pattern</code> substatement
24      */
25     String getRegularExpression();
26
27     /**
28      * All implementations should override this method.
29      * The default definition of this method is used only in YANG 1.0 (RFC6020)
30      * implementations of PatternConstraint which do not support modifier statement.
31      * YANG pattern statement has been changed in YANG 1.1 (RFC7950) and now allows modifier statement.
32      *
33      * @return enum constant which represents the value of modifier statement
34      */
35      // FIXME: version 2.0.0: make this method non-default
36     @Nullable default ModifierKind getModifier() {
37         return null;
38     }
39 }