gerrit.onap Code Review - sdc.git/blob

   1 /*
   2  * Copyright © 2016-2018 European Support Limited
   3  *
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at
   7  *
   8  *      http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13  * See the License for the specific language governing permissions and
  14  * limitations under the License.
  15  */
  16
  17 package org.openecomp.sdc.logging.spi;
  18
  19 import java.util.concurrent.Callable;
  20
  21 /**
  22  * Should be used to implement a framework-specific mechanism of managing a per-thread diagnostic context (for instance
  23  * <a href="http://www.slf4j.org/manual.html#mdc">MDC</a>), and propagating it to child threads if needed. Context
  24  * propagation should be used when creating a child thread directly, or submitting tasks for potentially postponed
  25  * execution via an <a href="http://docs.oracle.com/javase/8/docs/api/java/util/concurrent/Executor.html">Executor</a>
  26  * (including any of the <a href="http://docs.oracle.com/javase/8/docs/api/java/util/concurrent/ExecutorService.html">
  27  * executor services</a> and <a href="http://docs.oracle.com/javase/8/docs/api/java/util/concurrent/ForkJoinPool.html">
  28  * ForkJoinPool</a>).
  29  *
  30  * @author evitaliy
  31  * @since 07 Jan 2018
  32  */
  33
  34 public interface LoggingContextService {
  35
  36     void putRequestId(String requestId);
  37
  38     void putServiceName(String serviceName);
  39
  40     void putPartnerName(String partnerName);
  41
  42     /**
  43      * Clear logging thread context
  44      */
  45     void clear();
  46
  47     /**
  48      * Copies logging context of current thread onto a {@link Runnable}, so that the context is available when this
  49      * {@link Runnable} runs in another thread.
  50      */
  51     Runnable copyToRunnable(Runnable runnable);
  52
  53     /**
  54      * Copies logging context of current thread onto a {@link Callable}, so that the context is available when this
  55      * {@link Callable} runs in another thread
  56      */
  57     <V> Callable<V> copyToCallable(Callable<V> callable);
  58 }