aboutsummaryrefslogtreecommitdiffstats
path: root/services/services-engine/src/main/java/org/onap/policy/apex/service/parameters/eventprotocol/EventProtocolTextTokenDelimitedParameters.java
blob: 32883301e43ef26570d047ddbad2ce84839d53e2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
/*-
 * ============LICENSE_START=======================================================
 *  Copyright (C) 2016-2018 Ericsson. All rights reserved.
 *  Modifications Copyright (C) 2021 AT&T Intellectual Property. All rights reserved.
 * ================================================================================
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
 * SPDX-License-Identifier: Apache-2.0
 * ============LICENSE_END=========================================================
 */

package org.onap.policy.apex.service.parameters.eventprotocol;

import org.onap.policy.common.parameters.annotations.NotBlank;
import org.onap.policy.common.parameters.annotations.NotNull;

/**
 * An event protocol parameter class for token delimited textual event protocols that may be specialized by event
 * protocol plugins that require plugin specific parameters.
 *
 * <p>The following parameters are defined:
 * <ol>
 * <li>startDelimiterToken: the token string that delimits the start of text blocks that contain events.
 * <li>endDelimiterToken: the token string that delimits the end of text blocks that contain events, this parameter is
 * optional and defaults to null.
 * <li>delimiterAtStart: indicates if the first text block should have a delimiter at the start (true), or whether
 * processing of the first block should begin at the start of the text (false). The parameter is optional and defaults
 * to true.
 * </ol>
 *
 * @author Liam Fallon (liam.fallon@ericsson.com)
 */
public abstract class EventProtocolTextTokenDelimitedParameters extends EventProtocolParameters {
    // The delimiter token for text blocks
    private @NotNull @NotBlank String startDelimiterToken = null;
    private String endDelimiterToken = null;
    private boolean delimiterAtStart = true;

    /**
     * Constructor to create an event protocol parameters instance with the name of a sub class of this class.
     */
    protected EventProtocolTextTokenDelimitedParameters() {
        super();
    }

    /**
     * Gets the start delimiter token that delimits events in the text.
     *
     * @return the start delimiter token
     */
    public String getStartDelimiterToken() {
        return startDelimiterToken;
    }

    /**
     * Sets the start delimiter token that delimits events in the text.
     *
     * @param startDelimiterToken
     *        delimiterToken the delimiter token
     */
    public void setStartDelimiterToken(final String startDelimiterToken) {
        this.startDelimiterToken = startDelimiterToken;
    }

    /**
     * Gets the end delimiter token that delimits events in the text.
     *
     * @return the end delimiter token
     */
    public String getEndDelimiterToken() {
        return endDelimiterToken;
    }

    /**
     * Sets the end delimiter token that delimits events in the text.
     *
     * @param endDelimiterToken
     *        delimiterToken the delimiter token
     */
    public void setEndDelimiterToken(final String endDelimiterToken) {
        this.endDelimiterToken = endDelimiterToken;
    }

    /**
     * Check if there must be a delimiter at the start of the first text block.
     *
     * @return true if there must be a delimiter at the start of the text block
     */
    public boolean isDelimiterAtStart() {
        return delimiterAtStart;
    }

    /**
     * Sets if there has to be a delimiter at the start of the first text block.
     *
     * @param delimiterAtStart
     *        true if there must be a delimiter at the start of the text block
     */
    public void setDelimiterAtStart(boolean delimiterAtStart) {
        this.delimiterAtStart = delimiterAtStart;
    }

    @Override
    public String toString() {
        return "EventProtocolTextTokenDelimitedParameters [startDelimiterToken=" + startDelimiterToken
                        + ", endDelimiterToken=" + endDelimiterToken + ", delimiterAtStart=" + delimiterAtStart + "]";
    }
}