qarm/qarmtrandefinition.cpp

Go to the documentation of this file.

/*
 * Copyright (c) 2005 MyARM GbR, Germany
 * All rights reserved.
 * 
 * Redistribution and use in source and binary forms, with or 
 * without modification, are permitted provided that the 
 * following conditions are met:
 * 1. Redistributions of source code must retain the above
 *    copyright notice, this list of conditions and the
 *    following disclaimer.
 * 2. Redistributions in binary form must reproduce the above
 *    copyright notice, this list of conditions and the
 *    following disclaimer in the documentation and/or other
 *    materials provided with the distribution.
 * 3. All advertising materials mentioning features or use of
 *    this software must display the following acknowledgement:
 *        This product includes software developed by
 *        MyARM GbR and its contributors.
 * 4. Neither the name of MyARM GbR nor the names of its
 *    contributors may be used to endorse or promote products
 *    derived from this software without specific prior written
 *    permission.
 * 
 * THIS SOFTWARE IS PROVIDED BY MYARM GBR. AND CONTRIBUTORS 
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT
 * NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
 * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
 * SHALL MYARM OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
 * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
 * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
 * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
 * THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
 * OF SUCH DAMAGE.
 */


#include <QArmTranDefinition>
#include <QArmAppDefinition>
#include <QArmMetricList>

#include "myarmsdk.h"
#include "myarmsdk_dynload.h"

/*---------------------------------------------------------------------------*/

QArmTranDefinition::QArmTranDefinition(const QString              & _tranname,
                                       const QArmAppDefinition    * _app,
                                       const QArmIdentityPropList * _identity_props,
                                       const QArmContextNameList  * _context_names,
                                       const QArmMetricList       * _metric_bindings)
  : QArmDefinition(_tranname) {

  // Properties and/or metric bindings valid and available
  bool identity = (_identity_props != 0) && (_identity_props->count() > 0);
  bool context  = (_context_names != 0) && (_context_names->count() > 0);
  bool metrics  = (_metric_bindings != 0) && (_metric_bindings->count() > 0);
  int num_sb = 0;

  armsdk_buffer4_t sdk_buf4;
  armsdk_subbuffer_metric_bindings_t sdk_sb_metric_bindings;
  armsdk_subbuffer_tran_identity_t sdk_sb_tran_identity;

  // Identity and context properties are handled with the same subbuffer.
  if(identity || context) {
    // Initialize identity properties subbuffer.
    armsdk_tran_identity_initialize(&sdk_sb_tran_identity);

    // Add the subbuffer to the buffer4 structure. It registers the pointer
    // to the identity subbuffer. The content is filled in later.
    num_sb = addSubbuffer(num_sb, sdk_buf4, ARM_SDKSB(sdk_sb_tran_identity));
  }

  // Transaction identity properties are filled first.
  // Only use properties in case they are provided.
  if(identity) {
    // Iterate through the identity props and fill our array with values.
    QArmIdentityPropListIterator it( *_identity_props );
    int i = 0;
    while(it.hasNext()) {
      it.next();
      // Fill in identity property names and values.
      armsdk_tran_identity_set(&sdk_sb_tran_identity, 
                               i,
                               it.key().toAscii().constData(),
                               it.value()->toAscii().constData());
      i++;
    } //end for
  }

  // Transaction context names have to be handled similar.
  if(context) {
    // Context property names (no values).
    QArmContextNameListIterator it(*_context_names);
    int j = 0;
    while(it.hasNext()) {
      armsdk_tran_identity_context_name_set(&sdk_sb_tran_identity,
                                            j,
                                            it.next().toAscii().constData());
      j++;
    }
  }

  // Check for metric bindings.
  if(metrics) {
    // Initialize metric bindings subbuffer.
    armsdk_metric_binding_initialize(&sdk_sb_metric_bindings);

    // Traverse the list of metrics and fill the array.
    QArmMetricListIterator it(*_metric_bindings);
    int j = 0;
    while(it.hasNext()) {
      armsdk_metric_binding_set(&sdk_sb_metric_bindings,
                                j,
                                it.next()->getMetricId());
      j++;
    }
    num_sb = addSubbuffer(num_sb, sdk_buf4, ARM_SDKSB(sdk_sb_metric_bindings));
  }
  
  // Here we register:
  // - The transaction identity properties defined here.
  // - The transaction context property names that will be filled with
  //   content during start.
  // - The metric "bindings" that will be filled with content during start.
  arm_register_transaction(_app->getId(),/* in */
                           m_name.toAscii().constData(),/* transaction name*/
                           ARM_ID_NONE, 
                           ARM_FLAG_NONE,
                           (num_sb > 0) ? &sdk_buf4.header : ARM_BUF4_NONE,
                           &m_id);/* out */
}

/*---------------------------------------------------------------------------*/

QArmTranDefinition::~QArmTranDefinition() {
}

---