source: trunk/gsdl/src/recpt/OIDtools.h@ 248

/**********************************************************************
 *
 * OIDtools.h -- 
 * Copyright (C) 1999  The New Zealand Digital Library Project
 *
 * PUT COPYRIGHT NOTICE HERE
 *
 * $Id: OIDtools.h 248 1999-04-30 01:59:44Z sjboddie $
 *
 *********************************************************************/


#ifndef OIDTOOLS_H
#define OIDTOOLS_H

#include "text_t.h"
#include "recptproto.h"

// get first four characters of whatever string is passed in 
// OID. This returns the CLSU, HASH etc.
void get_head (const text_t &OID, text_t &head);

// returns (in top) the top level of OID (i.e. everything
// up until the first dot)
void get_top (const text_t &OID, text_t &top);

// checks if OID is top level (i.e. contains no dots)
bool is_top (const text_t &OID);

// is_classification checks OID to see if it's a classification
// or a document. I'm not sure how to do this - for now I'll just assume 
// all documents start with HASH and classifications start with something
// else.
bool is_classification (const text_t &OID);

// get_parents_array loads the parents array with all the parents of the
// document or classification specified by OID
// note that this function doesn't clear the parents array
void get_parents_array (const text_t &OID, text_tarray &parents);

// get_info does a protocol call and returns (in response) the info 
// associated with OID. The metadata array should be loaded with whatever
// metadata fields are to be requested
bool get_info (const text_t &OID, const text_t &collection,
           const text_tarray &metadata, recptproto *collectproto,
           FilterResponse_t &response, ostream &logout);

// get_children does a protocol call and returns (in response) the OIDs and 
// metadata of all the children of OID. The metadata array should be loaded
// with whatever metadata fields are to be requested.
bool get_children (const text_t &OID, const text_t &collection, 
           const text_tarray &metadata, recptproto *collectproto, 
           FilterResponse_t &response, ostream &logout);

// get_first_child does a protocol call and returns (in child) the OID
// of the first child of OID if it exists
bool get_first_child (const text_t &OID, text_t &child, const text_t &collection, 
              recptproto *collectproto, ostream logout);

// get_parent returns the parent of the document or classification
// specified by OID
text_t get_parent (text_t OID);

// takes an OID like ".2.3 and replaces the " with parent
void translate_parent (text_t &OID, const text_t &parent);

// shrink_parent does the opposite to translate_parent
void shrink_parent (text_t &OID);

// checks if OID uses ".fc", ".lc", ".pr", ".ns",
// or ".ps" syntax (first child, last child, parent,
// next sibling, previous sibling)
bool needs_translating (const text_t &OID);

#endif