Method call

src/meta/TSMeta.java:899–988

@return A TSMeta object loaded with UIDMetas if successful @throws HBaseException if there was a storage issue @throws JSONException if the data was corrupted @throws NoSuchUniqueName if one of the UIDMeta objects does not exist

(final TSMeta meta)

     * @throws NoSuchUniqueName if one of the UIDMeta objects does not exist
     */
    @Override
    public Deferred<TSMeta> call(final TSMeta meta) throws Exception {
      if (meta == null) {
        return Deferred.fromResult(null);
      }
      
      // split up the tags
      final List<byte[]> tags = UniqueId.getTagsFromTSUID(tsuid);
      meta.tags = new ArrayList<UIDMeta>(tags.size());
      
      // initialize with empty objects, otherwise the "set" operations in 
      // the callback won't work. Each UIDMeta will be given an index so that 
      // the callback can store it in the proper location
      for (int i = 0; i < tags.size(); i++) {
        meta.tags.add(new UIDMeta());
      }
      
      // list of fetch calls that we can wait on for completion
      ArrayList<Deferred<Object>> uid_group = 
        new ArrayList<Deferred<Object>>(tags.size() + 1);
      
      /**
       * Callback for each getUIDMeta request that will place the resulting 
       * meta data in the proper location. The meta should always be either an
       * actual stored value or a default. On creation, this callback will have
       * an index to associate the UIDMeta with the proper location.
       */
      final class UIDMetaCB implements Callback<Object, UIDMeta> {

        final int index;
        
        public UIDMetaCB(final int index) {
          this.index = index;
        }
        
        /**
         * @return null always since we don't care about the result, just that
         * the callback has completed.
         */
        @Override
        public Object call(final UIDMeta uid_meta) throws Exception {
          if (index < 0) {
            meta.metric = uid_meta;
          } else {
            meta.tags.set(index, uid_meta);
          }
          return null;
        }
        
      }
      
      // for the UIDMeta indexes: -1 means metric, >= 0 means tag. Each 
      // getUIDMeta request must be added to the uid_group array so that we
      // can wait for them to complete before returning the TSMeta object, 
      // otherwise the caller may get a TSMeta with missing UIDMetas
      uid_group.add(UIDMeta.getUIDMeta(tsdb, UniqueIdType.METRIC, 
        tsuid.substring(0, TSDB.metrics_width() * 2)).addCallback(
            new UIDMetaCB(-1)));