MetricsIntValue.java
上传用户:quxuerui
上传日期:2018-01-08
资源大小:41811k
文件大小:3k
源码类别:

网格计算

开发平台:

Java

  1. /**
  2.  * Licensed to the Apache Software Foundation (ASF) under one
  3.  * or more contributor license agreements.  See the NOTICE file
  4.  * distributed with this work for additional information
  5.  * regarding copyright ownership.  The ASF licenses this file
  6.  * to you under the Apache License, Version 2.0 (the
  7.  * "License"); you may not use this file except in compliance
  8.  * with the License.  You may obtain a copy of the License at
  9.  *
  10.  *     http://www.apache.org/licenses/LICENSE-2.0
  11.  *
  12.  * Unless required by applicable law or agreed to in writing, software
  13.  * distributed under the License is distributed on an "AS IS" BASIS,
  14.  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  15.  * See the License for the specific language governing permissions and
  16.  * limitations under the License.
  17.  */
  18. package org.apache.hadoop.metrics.util;
  19. import org.apache.hadoop.metrics.MetricsRecord;
  20. import org.apache.hadoop.util.StringUtils;
  21. import org.apache.commons.logging.Log;
  22. import org.apache.commons.logging.LogFactory;
  23. /**
  24.  * The MetricsIntValue class is for a metric that is not time varied
  25.  * but changes only when it is set. 
  26.  * Each time its value is set, it is published only *once* at the next update
  27.  * call.
  28.  *
  29.  */
  30. public class MetricsIntValue extends MetricsBase {  
  31.   private static final Log LOG =
  32.     LogFactory.getLog("org.apache.hadoop.metrics.util");
  33.   private int value;
  34.   private boolean changed;
  35.   
  36.   
  37.   /**
  38.    * Constructor - create a new metric
  39.    * @param nam the name of the metrics to be used to publish the metric
  40.    * @param registry - where the metrics object will be registered
  41.    */
  42.   public MetricsIntValue(final String nam, final MetricsRegistry registry, final String description) {
  43.     super(nam, description);
  44.     value = 0;
  45.     changed = false;
  46.     registry.add(nam, this);
  47.   }
  48.   
  49.   /**
  50.    * Constructor - create a new metric
  51.    * @param nam the name of the metrics to be used to publish the metric
  52.    * @param registry - where the metrics object will be registered
  53.    * A description of {@link #NO_DESCRIPTION} is used
  54.    */
  55.   public MetricsIntValue(final String nam, MetricsRegistry registry) {
  56.     this(nam, registry, NO_DESCRIPTION);
  57.   }
  58.   
  59.   
  60.   
  61.   /**
  62.    * Set the value
  63.    * @param newValue
  64.    */
  65.   public synchronized void set(final int newValue) {
  66.     value = newValue;
  67.     changed = true;
  68.   }
  69.   
  70.   /**
  71.    * Get value
  72.    * @return the value last set
  73.    */
  74.   public synchronized int get() { 
  75.     return value;
  76.   } 
  77.   
  78.   /**
  79.    * Push the metric to the mr.
  80.    * The metric is pushed only if it was updated since last push
  81.    * 
  82.    * Note this does NOT push to JMX
  83.    * (JMX gets the info via {@link #get()}
  84.    *
  85.    * @param mr
  86.    */
  87.   public synchronized void pushMetric(final MetricsRecord mr) {
  88.     if (changed) {
  89.       try {
  90.         mr.setMetric(getName(), value);
  91.       } catch (Exception e) {
  92.         LOG.info("pushMetric failed for " + getName() + "n" +
  93.             StringUtils.stringifyException(e));
  94.       }
  95.     }
  96.     changed = false;
  97.   }
  98. }