gerrit.onap Code Review - dcaegen2/services/sdk.git/blob

   1 /*
   2  * ============LICENSE_START====================================
   3  * DCAEGEN2-SERVICES-SDK
   4  * =========================================================
   5  * Copyright (C) 2019 Nokia. All rights reserved.
   6  * =========================================================
   7  * Licensed under the Apache License, Version 2.0 (the "License");
   8  * you may not use this file except in compliance with the License.
   9  * You may obtain a copy of the License at
  10  *
  11  *       http://www.apache.org/licenses/LICENSE-2.0
  12  *
  13  * Unless required by applicable law or agreed to in writing, software
  14  * distributed under the License is distributed on an "AS IS" BASIS,
  15  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  16  * See the License for the specific language governing permissions and
  17  * limitations under the License.
  18  * ============LICENSE_END=====================================
  19  */
  20
  21 package org.onap.dcaegen2.services.sdk.rest.services.cbs.client.api.streams;
  22
  23 import io.vavr.control.Either;
  24 import io.vavr.control.Try;
  25 import org.onap.dcaegen2.services.sdk.rest.services.annotations.ExperimentalApi;
  26 import org.onap.dcaegen2.services.sdk.rest.services.cbs.client.api.exceptions.StreamParserError;
  27 import org.onap.dcaegen2.services.sdk.rest.services.cbs.client.api.exceptions.StreamParsingException;
  28 import org.onap.dcaegen2.services.sdk.rest.services.cbs.client.model.streams.DataStream;
  29
  30 /**
  31  * A generic data stream parser which parses {@code T} to data stream {@code S}.
  32  *
  33  * @author <a href="mailto:piotr.jaszczyk@nokia.com">Piotr Jaszczyk</a>
  34  * @param <T> input data type, eg. Gson Object
  35  * @param <S> output data type
  36  * @since 1.1.3
  37  */
  38 @ExperimentalApi
  39 public interface StreamParser<T, S extends DataStream> {
  40
  41     /**
  42      * Parse the input data {@code T} producing the {@link DataStream}.
  43      *
  44      * @param input - the input data
  45      * @return Right(parsing result) or Left(parsing error)
  46      */
  47     default Either<StreamParserError, S> parse(T input) {
  48         return Try.of(() -> unsafeParse(input))
  49                 .toEither()
  50                 .mapLeft(StreamParserError::fromThrowable);
  51     }
  52
  53     /**
  54      * Parse the input data {@code T} producing the {@link DataStream}. Will throw StreamParsingException when input
  55      * was invalid.
  56      *
  57      * @param input - the input data
  58      * @return parsing result
  59      * @throws StreamParsingException when parsing was unsuccessful
  60      */
  61     default S unsafeParse(T input) {
  62         return parse(input).getOrElseThrow(StreamParsingException::new);
  63     }
  64 }