1 /*******************************************************************************
\r
2 * ============LICENSE_START====================================================
\r
4 * * ===========================================================================
\r
5 * * Copyright © 2017 AT&T Intellectual Property. All rights reserved.
\r
6 * * Copyright © 2017 Amdocs
\r
7 * * ===========================================================================
\r
8 * * Licensed under the Apache License, Version 2.0 (the "License");
\r
9 * * you may not use this file except in compliance with the License.
\r
10 * * You may obtain a copy of the License at
\r
12 * * http://www.apache.org/licenses/LICENSE-2.0
\r
14 * * Unless required by applicable law or agreed to in writing, software
\r
15 * * distributed under the License is distributed on an "AS IS" BASIS,
\r
16 * * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
\r
17 * * See the License for the specific language governing permissions and
\r
18 * * limitations under the License.
\r
19 * * ============LICENSE_END====================================================
\r
21 * * ECOMP is a trademark and service mark of AT&T Intellectual Property.
\r
23 ******************************************************************************/
\r
24 package com.att.inno.env;
\r
30 * A Trans is like an Env, however, it's purpose it to track the Transient
\r
31 * Data associated with Transactions, or other short term elements.
\r
33 * Any Object implementing Trans should expect to go in an out of scope quickly
\r
35 * Implementations should also overload the concepts of "Start", etc and build up
\r
36 * and Audit Log, so it can implement "metric" below
\r
38 * All Transactions (i.e. a call to a service) will need these items.
\r
42 public interface Trans extends Env {
\r
44 * Add a completed entry in the Audit Trail for tracking purposes.
\r
48 public void checkpoint(String text);
\r
51 * Add a completed entry in the Audit Trail for tracking purposes, and combine flag with "CHECKPOINT"
\r
55 public void checkpoint(String text, int additionalFlag);
\r
58 * Output an Audit Trail onto the StringBuilder
\r
60 * Load metrics into an array of floats from passed in Flags
\r
66 public Metric auditTrail(LogTarget lt, int indent, StringBuilder sb, int ... flag);
\r
68 public Metric auditTrail(int indent, StringBuilder sb, int ... flag);
\r
70 public class Metric {
\r
71 public float[] buckets;
\r