xoonips/AL/criteria.cc

/*
 * SQL実行結果の範囲指定，並べ替え条件を管理するcriteriaクラスの定義
 * 
 * $Revision$
 * $Log$
 * 
 */
#include <stdlib.h>
#include <string.h>

#include "common.h"
#include "criteria.h"

/**
 * SQLのORDERBYの設定を記憶するクラス
 * 
 * @param column カラム名
 * @param order 昇順，降順の指定(未指定時 orderby::ASC)
 * @ref orderby::ASC
 * @ref orderby::DESC
 * 
 */
orderby::orderby( const char* column = "", int order = orderby::ASC ){
    setValue( &this -> column, column );
    this -> order = order;
    this -> next = 0;
}

/**
 * 
 * デストラクタ
 * 
 * カラム名のメモリ領域を開放する
 * 
 */
orderby::~orderby( ){
    delete this -> column;
}
    
/**
 * 
 * カラム名を返す
 * @return カラム名
 * 
 */
const char* orderby::getColumn( ) const { return column; }

/**
 * 
 * 昇順，または降順を返す
 * @return 昇順，または降順
 * @ref orderby::ASC
 * @ref orderby::DESC
 * 
 */
order_t orderby::getOrder( ) const{ return order; }

/**
 * 
 * SQLの範囲指定(LIMIT)や，ソート順(カラム名と昇順降順)を管理するクラ
 * ス.
 * 
 */
criteria::criteria( )
{
    start = 0;
    rows = 0;
    indexOfOrders = 0;
    ordersLen = 0;
    ordersMax = 16;
    orders = new orderby*[ ordersMax ];
    memset( orders, 0, sizeof( orderby* ) * ordersMax );
}

/**
 * 
 * デストラクタ
 * 
 * addOrderByで追加したorderbyインスタンスの解放を行なう
 *
 * @ref addOrderBy
 * 
 */
criteria::~criteria( )
{
    if( orders != 0 ){
        for( int i = 0; i < ordersLen; i++ ) delete orders[ i ];
        delete[] orders;
    }
}

/**
 * 
 * SQL実行結果として出力する範囲を，開始行と行数で指定する. 
 * 
 * @param start 開始行
 * @param rows 行数
 * 
 */
void criteria::setLimit( int start , int rows )
{
    this -> start = start;
    this -> rows = rows;
}

/**
 * 
 * 昇順降順の条件を追加する．SQL実行時は最初に追加したものを最初のソー
 * ト条件とする．
 * 
 * @param order orderbyのアドレス
 *
 */
void criteria::addOrderBy( orderby *order )
{
    if( ordersMax == ordersLen ){
        //ordersのいっぱいまでデータがあるので，拡張する
        orderby** ptr = new orderby*[ ordersMax * 2 ];
        memset( ptr, 0, sizeof( orderby* ) * ordersMax * 2 );
        memcpy( ptr, orders, sizeof( orderby* ) * ordersMax );
        delete[] orders;
        ordersMax *= 2;
        orders = ptr;
    }
    orders[ ordersLen ] = order;
    ordersLen++;
}

/**
 * 
 * 最初のorderbyを取り出す. 2番目以降のorderbyはnextOrderByで取り出す.<br>
 * ※この関数はスレッドに対して非安全(unsafe)です
 * 
 * @return 最初のorderby
 * @return 0 これ以上のorderbyはない
 * @ref nextOrderBy
 * 
 */
const orderby* criteria::headOrderBy( )
{
    indexOfOrders = 0;
    if( indexOfOrders >= ordersLen ) return 0;
    return orders[ indexOfOrders++ ];
}

/**
 * 
 * orderbyを取り出す.<br>
 * ※この関数はスレッドに対して非安全(unsafe)です
 * 
 * @return orderbyのインスタンス
 * @return 0 これ以上のorderbyはない
 * @ref headNextOrderBy
 * 
 */
const orderby* criteria::nextOrderBy( )
{
    if( indexOfOrders >= ordersLen ) return 0;
    return orders[ indexOfOrders++ ];
}

/**
 * 
 * LIMIT設定，全てのORDERBY設定を削除します.
 * 
 */
void criteria::clearAll( )
{
    memset( orders, 0, sizeof( orderby* ) * ordersMax );
    ordersLen = 0;
    start = rows = 0;
}

/**
 * 
 * LIMITの開始行
 * 
 * @return 
 * 
 */
int criteria::getLimitStart( ) const { return start; }

/**
 * 
 * LIMITの行数
 * 
 * @return 
 * 
 */
int criteria::getLimitRows( ) const{ return rows; }