Stock.h

浏览该文件的文档.

/*
 * Stock.h
 *
 *  Created on: 2011-11-9
 *      Author: fasiondog
 */

#ifndef STOCK_H_
#define STOCK_H_

#include "StockWeight.h"
#include "KQuery.h"
#include "TimeLineRecord.h"
#include "TransRecord.h"

namespace hku {

class HKU_API StockManager;
class KDataDriver;
typedef shared_ptr<KDataDriver> KDataDriverPtr;
class HKU_API KData;

class HKU_API Stock {
    friend class StockManager;

private:
    static const string default_market;
    static const string default_code;
    static const string default_market_code;
    static const string default_name;
    static const hku_uint32 default_type;
    static const bool default_valid;
    static const Datetime default_startDate;
    static const Datetime default_lastDate;
    static const price_t default_tick;
    static const price_t default_tickValue;
    static const price_t default_unit;
    static const int default_precision;
    static const size_t default_minTradeNumber;
    static const size_t default_maxTradeNumber;

public:
    Stock();

    Stock(const Stock&);
    Stock(const string& market, const string& code, const string& name);

    Stock(const string& market, const string& code,
          const string& name, hku_uint32 type, bool valid,
          const Datetime& startDate, const Datetime& lastDate);
    Stock(const string& market, const string& code,
          const string& name, hku_uint32 type, bool valid,
          const Datetime& startDate, const Datetime& lastDate,
          price_t tick, price_t tickValue, int precision,
          size_t minTradeNumber, size_t maxTradeNumber);
    virtual ~Stock();
    Stock& operator=(const Stock&);
    bool operator==(const Stock&) const;
    bool operator!=(const Stock&) const;

    hku_uint64 id() const;

    const string& market() const;

    const string& code() const;

    const string& market_code() const;

    const string& name() const;

    hku_uint32 type() const;

    bool valid() const;

    Datetime startDatetime() const;

    Datetime lastDatetime() const;

    price_t tick() const;

    price_t tickValue() const;

    price_t unit() const;

    int precision() const;

    size_t atom() const;

    size_t minTradeNumber() const;

    size_t maxTradeNumber() const;

    StockWeightList getWeight() const;

    StockWeightList getWeight(const Datetime& start,
                    const Datetime& end = Null<Datetime>()) const;

    size_t getCount(KQuery::KType dataType = KQuery::DAY) const;

    price_t getMarketValue(const Datetime&, KQuery::KType) const;

    bool getIndexRange(const KQuery&, size_t& out_start, size_t& out_end) const;

    KRecord getKRecord(size_t pos,
                       KQuery::KType dataType = KQuery::DAY) const;

    KRecord getKRecordByDate(const Datetime&, KQuery::KType ktype = KQuery::DAY) const;

    KData getKData(const KQuery&) const;

    KRecordList getKRecordList(size_t start, size_t end, KQuery::KType) const;

    DatetimeList getDatetimeList(size_t start, size_t end, KQuery::KType) const;

    DatetimeList getDatetimeList(const KQuery& query) const;

    TimeLineList getTimeLineList(const KQuery& query) const;

    TransList getTransList(const KQuery& query) const;

    void setWeightList(const StockWeightList&);

    void setKDataDriver(const KDataDriverPtr& kdataDriver);

    KDataDriverPtr getKDataDriver() const;

    void loadKDataToBuffer(KQuery::KType);

    void releaseKDataBuffer(KQuery::KType);

    bool isBuffer(KQuery::KType) const;

    bool isNull() const;

    void realtimeUpdate(const KRecord&);

    string toString() const;

private:
    bool _getIndexRangeByIndex(const KQuery&, size_t& out_start, size_t& out_end) const;
    bool _getIndexRangeByDateFromBuffer(const KQuery&, size_t&, size_t&) const;

private:
    struct HKU_API Data;
    shared_ptr<Data> m_data;
    KDataDriverPtr m_kdataDriver;
};

struct HKU_API Stock::Data {
    string        m_market;      //所属的市场简称
    string        m_code;        //证券代码
    string        m_market_code; //市场简称证券代码
    string        m_name;        //证券名称
    hku_uint32    m_type;        //证券类型
    bool          m_valid;       //当前证券是否有效
    Datetime      m_startDate;   //证券起始日期
    Datetime      m_lastDate;    //证券最后日期

    StockWeightList m_weightList; //权息信息列表

    price_t m_tick;
    price_t m_tickValue;
    price_t m_unit;
    int     m_precision;
    size_t  m_minTradeNumber;
    size_t  m_maxTradeNumber;

    //KRecordListPtr pKData[KQuery::INVALID_KTYPE];
    map<string, KRecordListPtr> pKData;

    Data();
    Data(const string& market, const string& code,
          const string& name, hku_uint32 type, bool valid,
          const Datetime& startDate, const Datetime& lastDate,
          price_t tick, price_t tickValue, int precision,
          size_t minTradeNumber, size_t maxTradeNumber);

    virtual ~Data();
};

HKU_API std::ostream& operator <<(std::ostream &os, const Stock& stock);

typedef vector<Stock> StockList;


/* 用于将Stock实例作为map的key，一般建议使用stock.id做键值，
 * 否则map还要利用拷贝构造函数，创建新对象，效率低 */
bool operator < (const Stock& s1, const Stock& s2);
inline bool operator < (const Stock& s1, const Stock& s2) {
    return s1.id() < s2.id();
}

inline hku_uint64 Stock::id() const {
    return isNull() ? 0 : (hku_int64)m_data.get();
}

inline StockWeightList Stock::getWeight() const {
    return m_data ? m_data->m_weightList : StockWeightList();
}

inline bool Stock::operator==(const Stock& stock) const {
    return (*this != stock) ? false : true;
}

} /* namespace */

#endif /* STOCK_H_ */