aboutsummaryrefslogtreecommitdiffstats
path: root/services/services-engine/src/main/java/org/onap/policy/apex/service/parameters/eventprotocol/EventProtocolTextTokenDelimitedParameters.java
blob: f9328f4187c508df358dc23114ed1ba3ae9c85d3 (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
119
120
121
122
123
124
125
126
127
128
129
130
131
132
/*-
 * ============LICENSE_START=======================================================
 *  Copyright (C) 2016-2018 Ericsson. 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.GroupValidationResult;
import org.onap.policy.common.parameters.ValidationStatus;

/**
 * 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 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.
     */
    public 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 + "]";
    }

    /**
     * {@inheritDoc}.
     */
    @Override
    public GroupValidationResult validate() {
        final GroupValidationResult result = super.validate();

        if (startDelimiterToken == null || startDelimiterToken.length() == 0) {
            result.setResult("startDelimiterToken", ValidationStatus.INVALID,
                            "text start delimiter token not specified or is blank\n");
        }

        return result;
    }
}