MetricsLongValue.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. /**
  21.  * The MetricsLongValue class is for a metric that is not time varied
  22.  * but changes only when it is set. 
  23.  * Each time its value is set, it is published only *once* at the next update
  24.  * call.
  25.  *
  26.  */
  27. public class MetricsLongValue extends MetricsBase{  
  28.   private long value;
  29.   private boolean changed;
  30.   
  31.   /**
  32.    * Constructor - create a new metric
  33.    * @param nam the name of the metrics to be used to publish the metric
  34.    * @param registry - where the metrics object will be registered
  35.    */
  36.   public MetricsLongValue(final String nam, final MetricsRegistry registry, final String description) {
  37.     super(nam, description);
  38.     value = 0;
  39.     changed = false;
  40.     registry.add(nam, this);
  41.   }
  42.   
  43.   /**
  44.    * Constructor - create a new metric
  45.    * @param nam the name of the metrics to be used to publish the metric
  46.    * @param registry - where the metrics object will be registered
  47.    * A description of {@link #NO_DESCRIPTION} is used
  48.    */
  49.   public MetricsLongValue(final String nam, MetricsRegistry registry) {
  50.     this(nam, registry, NO_DESCRIPTION);
  51.   }
  52.   
  53.   /**
  54.    * Set the value
  55.    * @param newValue
  56.    */
  57.   public synchronized void set(final long newValue) {
  58.     value = newValue;
  59.     changed = true;
  60.   }
  61.   
  62.   /**
  63.    * Get value
  64.    * @return the value last set
  65.    */
  66.   public synchronized long get() { 
  67.     return value;
  68.   } 
  69.  
  70.   /**
  71.    * Push the metric to the mr.
  72.    * The metric is pushed only if it was updated since last push
  73.    * 
  74.    * Note this does NOT push to JMX
  75.    * (JMX gets the info via {@link #get()}
  76.    *
  77.    * @param mr
  78.    */
  79.   public synchronized void pushMetric(final MetricsRecord mr) {
  80.     if (changed) 
  81.       mr.setMetric(getName(), value);
  82.     changed = false;
  83.   }
  84. }