[u/mrichter/AliRoot.git] / STEER / AliCDBManager.cxx

/**************************************************************************
 * Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
 *                                                                        *
 * Author: The ALICE Off-line Project.                                    *
 * Contributors are mentioned in the code where appropriate.              *
 *                                                                        *
 * Permission to use, copy, modify and distribute this software and its   *
 * documentation strictly for non-commercial purposes is hereby granted   *
 * without fee, provided that the above copyright notice appears in all   *
 * copies and that both the copyright notice and this permission notice   *
 * appear in the supporting documentation. The authors make no claims     *
 * about the suitability of this software for any purpose. It is          *
 * provided "as is" without express or implied warranty.                  *
 **************************************************************************/
//-------------------------------------------------------------------------
//   Implementation of AliCDBManager and AliCDBParam classe
//   Author: Alberto Colla 
//   e-mail: Alberto.Colla@cern.ch
//-------------------------------------------------------------------------

#include "AliCDBManager.h"
#include "AliCDBStorage.h"
#include "AliLog.h"
#include "AliCDBDump.h"
#include "AliCDBLocal.h"
#include "AliCDBGrid.h"
#include "AliCDBEntry.h"
#include "AliCDBMetaData.h"

#include <TObjString.h>
#include <TSystem.h>

ClassImp(AliCDBParam)

ClassImp(AliCDBManager)

AliCDBManager* AliCDBManager::fgInstance = 0x0;

//_____________________________________________________________________________
AliCDBManager* AliCDBManager::Instance() {
// returns AliCDBManager instance (singleton)

	if (!fgInstance) {
		fgInstance = new AliCDBManager();
		fgInstance->Init();
	}

	return fgInstance;
}

//_____________________________________________________________________________
void AliCDBManager::Init() {
// factory registering

	RegisterFactory(new AliCDBDumpFactory());
	RegisterFactory(new AliCDBLocalFactory()); 
	// AliCDBGridFactory is registered only if AliEn libraries are enabled in Root
	if(!gSystem->Exec("root-config --has-alien |grep yes 2>&1 > /dev/null")){ // returns 0 if yes
		AliInfo("AliEn classes enabled in Root. AliCDBGrid factory registered.");
		RegisterFactory(new AliCDBGridFactory());
	}
}
//_____________________________________________________________________________
void AliCDBManager::Destroy() {
// delete ALCDBManager instance and active storages

	if (fgInstance) {
		//fgInstance->Delete();
		delete fgInstance;
		fgInstance = 0x0;
	}
}

//_____________________________________________________________________________
AliCDBManager::AliCDBManager():
	fDefaultStorage(NULL),
	fDrainStorage(NULL),
	fCache(kTRUE),
	fRun(0)
{
// default constuctor
	fFactories.SetOwner(1);
  	fEntryCache.SetOwner(1);
}

//_____________________________________________________________________________
AliCDBManager::~AliCDBManager() {
// destructor
	ClearCache();
	DestroyActiveStorages();
	fDrainStorage = 0x0;
	fDefaultStorage = 0x0;
}

//_____________________________________________________________________________
AliCDBStorage* AliCDBManager::GetActiveStorage(const AliCDBParam* param) {
// get a storage object from the list of active storages 

        return (AliCDBStorage*) fActiveStorages.GetValue(param);
}

//_____________________________________________________________________________
void AliCDBManager::PutActiveStorage(AliCDBParam* param, AliCDBStorage* storage){
// put a storage object into the list of active storages

	fActiveStorages.Add(param, storage);
	AliDebug(1, Form("Active storages: %d", fActiveStorages.GetEntries()));
}

//_____________________________________________________________________________
void AliCDBManager::RegisterFactory(AliCDBStorageFactory* factory) {
// add a storage factory to the list of registerd factories
 
	if (!fFactories.Contains(factory)) {
		fFactories.Add(factory);
	}
}

//_____________________________________________________________________________
Bool_t AliCDBManager::HasStorage(const char* dbString) const {
// check if dbString is a URI valid for one of the registered factories 

	TIter iter(&fFactories);

	AliCDBStorageFactory* factory;
	while ((factory = (AliCDBStorageFactory*) iter.Next())) {

		if (factory->Validate(dbString)) {
			return kTRUE;
		}	
	}

	return kFALSE;
}

//_____________________________________________________________________________
AliCDBParam* AliCDBManager::CreateParameter(const char* dbString) const {
// create AliCDBParam object from URI string

	TIter iter(&fFactories);

        AliCDBStorageFactory* factory;
        while ((factory = (AliCDBStorageFactory*) iter.Next())) {

		AliCDBParam* param = factory->CreateParameter(dbString);
		if (param) {
			return param;
		}
        }

        return NULL;
}

//_____________________________________________________________________________
AliCDBStorage* AliCDBManager::GetStorage(const char* dbString) {
// get storage object from URI string
	
	AliCDBParam* param = CreateParameter(dbString);
	if (!param) {
		return NULL;
	}	

	AliCDBStorage* aStorage = GetStorage(param);

	delete param;
	
	return aStorage;
}

//_____________________________________________________________________________
AliCDBStorage* AliCDBManager::GetStorage(const AliCDBParam* param) {
// get storage object from AliCDBParam object

	// if the list of active storages already contains 
	// the requested storage, return it
	AliCDBStorage* aStorage = GetActiveStorage(param);
	if (aStorage) {
		return aStorage;
	}

	TIter iter(&fFactories);

        AliCDBStorageFactory* factory;
        
	// loop on the list of registered factories
	while ((factory = (AliCDBStorageFactory*) iter.Next())) {

		// each factory tries to create its storage from the parameter
		aStorage = factory->Create(param);
		if (aStorage) {
			PutActiveStorage(param->CloneParam(), aStorage);
			// if default storage is not set, set to this storage
			if(!fDefaultStorage){
				fDefaultStorage=aStorage;
				AliInfo(Form("Default storage set to: %s",(param->GetURI()).Data()));
			}
			return aStorage;
		}
        }

        return NULL;
}

//_____________________________________________________________________________
TList* AliCDBManager::GetActiveStorages() {
// return list of active storages

	TList* result = new TList();

	TIter iter(fActiveStorages.GetTable());	
	TPair* aPair;
	while ((aPair = (TPair*) iter.Next())) {
		result->Add(aPair->Value());
	}

	return result;
}

//_____________________________________________________________________________
void AliCDBManager::SetDrain(const char* dbString) {
// set drain storage from URI string

	fDrainStorage = GetStorage(dbString);	
}

//_____________________________________________________________________________
void AliCDBManager::SetDrain(const AliCDBParam* param) {
// set drain storage from AliCDBParam
	
	fDrainStorage = GetStorage(param);
}

//_____________________________________________________________________________
void AliCDBManager::SetDrain(AliCDBStorage* storage) {
// set drain storage from another active storage
	
	fDrainStorage = storage;
}

//_____________________________________________________________________________
Bool_t AliCDBManager::Drain(AliCDBEntry *entry) {
// drain retrieved object to drain storage

	AliInfo("Draining into drain storage...");
	return fDrainStorage->Put(entry);
}

//_____________________________________________________________________________
void AliCDBManager::SetDefaultStorage(const char* dbString) {
// sets default storage from URI string

	fDefaultStorage = GetStorage(dbString);	
}

//_____________________________________________________________________________
void AliCDBManager::SetDefaultStorage(const AliCDBParam* param) {
// set default storage from AliCDBParam object
	
	fDrainStorage = GetStorage(param);
}

//_____________________________________________________________________________
void AliCDBManager::SetDefaultStorage(AliCDBStorage* storage) {
// set default storage from another active storage
	
	fDefaultStorage = storage;
}

//_____________________________________________________________________________
void AliCDBManager::SetSpecificStorage(const char* calibType, const char* dbString) {
// sets storage specific for detector or calibration type (works with AliCDBManager::Get(...))

	AliCDBParam *aPar = CreateParameter(dbString);
	if(!aPar) return;
	SetSpecificStorage(calibType, aPar);
	delete aPar;
}

//_____________________________________________________________________________
void AliCDBManager::SetSpecificStorage(const char* calibType, AliCDBParam* param) {
// sets storage specific for detector or calibration type (works with AliCDBManager::Get(...))
// Default storage should be defined prior to any specific storages, e.g.:
// AliCDBManager::instance()->SetDefaultStorage("alien://");
// AliCDBManager::instance()->SetSpecificStorage("TPC","local://DB_TPC");
// AliCDBManager::instance()->SetSpecificStorage("RICH/Align","local://DB_TPCAlign");

	if(!fDefaultStorage) {
		AliError("Please activate a default storage first!");	
		return;
	}
	
	TObjString *objCalibType = new TObjString(calibType);
	if(fSpecificStorages.Contains(objCalibType)){
		AliWarning(Form("%s storage already activated! It will be replaced by the new one",
					calibType));
		fSpecificStorages.Remove(objCalibType);	
	}
	GetStorage(param);
	fSpecificStorages.Add(objCalibType, param->CloneParam());
}

//_____________________________________________________________________________
AliCDBStorage* AliCDBManager::GetSpecificStorage(const char* calibType) {
// get storage specific for detector or calibration type 

	AliCDBParam *checkPar = (AliCDBParam*) fSpecificStorages.GetValue(calibType);
	if(!checkPar){
		AliError(Form("%s storage not found!",calibType));
		return NULL;
	} else {
		return GetStorage(checkPar);
	}
	
}

//_____________________________________________________________________________
AliCDBParam* AliCDBManager::SelectSpecificStorage(const TString& path) {
// select storage valid for path from the list of specific storages 

	TIter iter(&fSpecificStorages);
	TObjString *aCalibType;
	AliCDBParam* aPar=0;
	while((aCalibType = (TObjString*) iter.Next())){
		if(path.Contains(aCalibType->String(), TString::kIgnoreCase)) {
		 	aPar = (AliCDBParam*) fSpecificStorages.GetValue(aCalibType);
			break;
		}
	}
	return aPar;
}

//_____________________________________________________________________________
AliCDBEntry* AliCDBManager::Get(const AliCDBPath& path, Int_t runNumber, 
	Int_t version, Int_t subVersion) {
// get an AliCDBEntry object from the database

	if(runNumber < 0){
		// RunNumber is not specified. Try with fRun
  		if (fRun < 0){
   	 		AliError("Run number neither specified in query nor set in AliCDBManager! Use AliCDBManager::SetRun.");
    			return NULL;
  		}
		runNumber = fRun;
	}

	return Get(AliCDBId(path, runNumber, runNumber, version, subVersion));
}

//_____________________________________________________________________________
AliCDBEntry* AliCDBManager::Get(const AliCDBPath& path, 
	const AliCDBRunRange& runRange, Int_t version,
	Int_t subVersion) {
// get an AliCDBEntry object from the database!

	return Get(AliCDBId(path, runRange, version, subVersion));
}

//_____________________________________________________________________________
AliCDBEntry* AliCDBManager::Get(const AliCDBId& query) {	
// get an AliCDBEntry object from the database
	
	if(!fDefaultStorage) {
		AliError("No storage set!");
		return NULL;
	}

	// check if query's path and runRange are valid
	// query is invalid also if version is not specified and subversion is!
	if (!query.IsValid()) {
		AliError(Form("Invalid query: %s", query.ToString().Data()));
		return NULL;
	}
	
	// query is not specified if path contains wildcard or run range= [-1,-1]
 	if (!query.IsSpecified()) {
		AliError(Form("Unspecified query: %s", 
				query.ToString().Data()));
                return NULL;
	}

	if(fCache && query.GetFirstRun() != fRun) 
		AliWarning("Run number explicitly set in query: CDB cache temporarily disabled!");

	
  	AliCDBEntry *entry=0;
	
  
  	// first look into map of cached objects
  	if(query.GetFirstRun() == fRun) 
		entry = (AliCDBEntry*) fEntryCache.GetValue(query.GetPath());

  	if(entry) {
		AliInfo(Form("Object %s retrieved from cache !!",query.GetPath().Data()));		
		return entry;
	}
  	
	// Entry is not in cache -> retrieve it from CDB and cache it!!   
	AliCDBStorage *aStorage=0;
	AliCDBParam *aPar=SelectSpecificStorage(query.GetPath());
	
	if(aPar) {
		aStorage=GetStorage(aPar);
		TString str = aPar->GetURI();
		AliDebug(2,Form("Looking into storage: %s",str.Data()));
		
	} else {
		aStorage=GetDefaultStorage();
		AliDebug(2,"Looking into default storage");	
	}
			
	entry = aStorage->Get(query);
  	if (!entry) return NULL;

 	if(fCache && (query.GetFirstRun() == fRun)){
		AliInfo(Form("Caching entry %s !",query.GetPath().Data()));
		CacheEntry(query.GetPath(), entry);
	}
  
  	return entry;
		
}

//_____________________________________________________________________________
TList* AliCDBManager::GetAll(const AliCDBPath& path, Int_t runNumber, 
	Int_t version, Int_t subVersion) {
// get multiple AliCDBEntry objects from the database

	return GetAll(AliCDBId(path, runNumber, runNumber, version, 	
			subVersion));
}

//_____________________________________________________________________________
TList* AliCDBManager::GetAll(const AliCDBPath& path, 
	const AliCDBRunRange& runRange, Int_t version, Int_t subVersion) {
// get multiple AliCDBEntry objects from the database

	return GetAll(AliCDBId(path, runRange, version, subVersion));
}

//_____________________________________________________________________________
TList* AliCDBManager::GetAll(const AliCDBId& query) {
// get multiple AliCDBEntry objects from the database
// Warning: this method works correctly only for queries of the type "Detector/*"
// 		and not for more specific queries e.g. "Detector/Calib/*" !

	if(!fDefaultStorage) {
		AliError("No storage set!");
		return NULL;
	}

	if (!query.IsValid()) {
                AliError(Form("Invalid query: %s", query.ToString().Data()));
                return NULL;
        }

	if(query.GetPath().BeginsWith('*')){
                AliError("Query too generic in this context!");
                return NULL;		
	}

	if (query.IsAnyRange()) {
		AliError(Form("Unspecified run or runrange: %s",
				query.ToString().Data())); 	
		return NULL;
	}	
        
	TObjString objStrLev0(query.GetLevel0());
	AliCDBParam *aPar = (AliCDBParam*) fSpecificStorages.GetValue(&objStrLev0);

	AliCDBStorage *aStorage;	
	if(aPar) {
		aStorage=GetStorage(aPar);
		TString str = aPar->GetURI();
		AliDebug(2,Form("Looking into storage: %s",str.Data()));
		
	} else {
		aStorage=GetDefaultStorage();
		AliDebug(2,"Looking into default storage");	
	}

	TList *result = aStorage->GetAll(query);

        return result;
}

//_____________________________________________________________________________
Bool_t AliCDBManager::Put(TObject* object, AliCDBId& id,  AliCDBMetaData* metaData){
// store an AliCDBEntry object into the database

	AliCDBEntry anEntry(object, id, metaData);
	return Put(&anEntry);

}


//_____________________________________________________________________________
Bool_t AliCDBManager::Put(AliCDBEntry* entry){
// store an AliCDBEntry object into the database

	if(!fDefaultStorage) {
		AliError("No storage set!");
		return kFALSE;
	}

	if (!entry){
		AliError("No entry!");
		return kFALSE;
	}

	if (!entry->GetId().IsValid()) {
		AliError(Form("Invalid entry ID: %s", 
			entry->GetId().ToString().Data()));
		return kFALSE;
	}	

	if (!entry->GetId().IsSpecified()) {
		AliError(Form("Unspecified entry ID: %s", 
			entry->GetId().ToString().Data()));
		return kFALSE;
	}

	AliCDBId id = entry->GetId();
	AliCDBParam *aPar = SelectSpecificStorage(id.GetPath());

	AliCDBStorage *aStorage;
	
	if(aPar) {
		aStorage=GetStorage(aPar);
		TString str = aPar->GetURI();
		AliDebug(2,Form("Storing object into storage: %s",str.Data()));
		
	} else {
		aStorage=GetDefaultStorage();
		AliDebug(2,"Storing object into default storage");	
	}

	return aStorage->Put(entry);


}

//_____________________________________________________________________________
void AliCDBManager::CacheEntry(const char* path, AliCDBEntry* entry)
{
// cache AliCDBEntry. Cache is valid until run number is changed.

	AliDebug(2,Form("Filling cache with entry %s",path));
	fEntryCache.Add(new TObjString(path), entry);
	AliDebug(2,Form("Cache entries: %d",fEntryCache.GetEntries()));

}

//_____________________________________________________________________________
void AliCDBManager::SetRun(Long64_t run)
{
// Sets current run number.  
// When the run number changes the caching is cleared.
  
	if (fRun == run)
		return;
  
	fRun = run;
	ClearCache();
}

//_____________________________________________________________________________
void AliCDBManager::ClearCache(){
// clear AliCDBEntry cache

	AliDebug(2,Form("Clearing cache!"));
	fEntryCache.DeleteAll();
	AliDebug(2,Form("Cache entries: %d",fEntryCache.GetEntries()));

}

//_____________________________________________________________________________
void AliCDBManager::DestroyActiveStorages() {
// delete list of active storages

	fActiveStorages.DeleteAll();
	fSpecificStorages.DeleteAll();
}

//_____________________________________________________________________________
void AliCDBManager::DestroyActiveStorage(AliCDBStorage* /*storage*/) {
// destroys active storage

/*
	TIter iter(fActiveStorages.GetTable());	
	TPair* aPair;
	while ((aPair = (TPair*) iter.Next())) {
		if(storage == (AliCDBStorage*) aPair->Value())
			delete fActiveStorages.Remove(aPair->Key());
			storage->Delete(); storage=0x0;
	}
*/	

}

///////////////////////////////////////////////////////////
// AliCDBManager Parameter class                         //
// interface to specific AliCDBParameter class           //
// (AliCDBGridParam, AliCDBLocalParam, AliCDBDumpParam)  //
///////////////////////////////////////////////////////////

AliCDBParam::AliCDBParam() {
// constructor

}

//_____________________________________________________________________________
AliCDBParam::~AliCDBParam() {
// destructor

}
Commit	Line	Data
9e1ceb13	1	/**************************************************************************
	2	* Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
	3	* *
	4	* Author: The ALICE Off-line Project. *
	5	* Contributors are mentioned in the code where appropriate. *
	6	* *
	7	* Permission to use, copy, modify and distribute this software and its *
	8	* documentation strictly for non-commercial purposes is hereby granted *
	9	* without fee, provided that the above copyright notice appears in all *
	10	* copies and that both the copyright notice and this permission notice *
	11	* appear in the supporting documentation. The authors make no claims *
	12	* about the suitability of this software for any purpose. It is *
	13	* provided "as is" without express or implied warranty. *
	14	**************************************************************************/
fdf65bb5	15	//-------------------------------------------------------------------------
	16	// Implementation of AliCDBManager and AliCDBParam classe
	17	// Author: Alberto Colla
	18	// e-mail: Alberto.Colla@cern.ch
	19	//-------------------------------------------------------------------------
9e1ceb13	20
	21	#include "AliCDBManager.h"
	22	#include "AliCDBStorage.h"
	23	#include "AliLog.h"
	24	#include "AliCDBDump.h"
	25	#include "AliCDBLocal.h"
	26	#include "AliCDBGrid.h"
02c4845e	27	#include "AliCDBEntry.h"
02c4845e	28	#include "AliCDBMetaData.h"
9e1ceb13	29
02c4845e	30	#include <TObjString.h>
9e1ceb13	31	#include <TSystem.h>
	32
	33	ClassImp(AliCDBParam)
	34
	35	ClassImp(AliCDBManager)
	36
	37	AliCDBManager* AliCDBManager::fgInstance = 0x0;
	38
	39	//_____________________________________________________________________________
	40	AliCDBManager* AliCDBManager::Instance() {
	41	// returns AliCDBManager instance (singleton)
	42
	43	if (!fgInstance) {
	44	fgInstance = new AliCDBManager();
	45	fgInstance->Init();
	46	}
	47
	48	return fgInstance;
	49	}
	50
	51	//_____________________________________________________________________________
	52	void AliCDBManager::Init() {
	53	// factory registering
	54
	55	RegisterFactory(new AliCDBDumpFactory());
	56	RegisterFactory(new AliCDBLocalFactory());
	57	// AliCDBGridFactory is registered only if AliEn libraries are enabled in Root
	58	if(!gSystem->Exec("root-config --has-alien \|grep yes 2>&1 > /dev/null")){ // returns 0 if yes
	59	AliInfo("AliEn classes enabled in Root. AliCDBGrid factory registered.");
	60	RegisterFactory(new AliCDBGridFactory());
	61	}
	62	}
	63	//_____________________________________________________________________________
	64	void AliCDBManager::Destroy() {
	65	// delete ALCDBManager instance and active storages
	66
	67	if (fgInstance) {
4b5e0dce	68	//fgInstance->Delete();
9e1ceb13	69	delete fgInstance;
	70	fgInstance = 0x0;
	71	}
	72	}
	73
	74	//_____________________________________________________________________________
	75	AliCDBManager::AliCDBManager():
	76	fDefaultStorage(NULL),
4b5e0dce	77	fDrainStorage(NULL),
	78	fCache(kTRUE),
	79	fRun(0)
9e1ceb13	80	{
9e1ceb13	81	// default constuctor
4b5e0dce	82	fFactories.SetOwner(1);
4b5e0dce	83	fEntryCache.SetOwner(1);
9e1ceb13	84	}
	85
	86	//_____________________________________________________________________________
	87	AliCDBManager::~AliCDBManager() {
	88	// destructor
4b5e0dce	89	ClearCache();
9e1ceb13	90	DestroyActiveStorages();
b05400be	91	fDrainStorage = 0x0;
b05400be	92	fDefaultStorage = 0x0;
9e1ceb13	93	}
	94
	95	//_____________________________________________________________________________
	96	AliCDBStorage* AliCDBManager::GetActiveStorage(const AliCDBParam* param) {
	97	// get a storage object from the list of active storages
	98
	99	return (AliCDBStorage*) fActiveStorages.GetValue(param);
	100	}
	101
	102	//_____________________________________________________________________________
	103	void AliCDBManager::PutActiveStorage(AliCDBParam* param, AliCDBStorage* storage){
	104	// put a storage object into the list of active storages
	105
	106	fActiveStorages.Add(param, storage);
	107	AliDebug(1, Form("Active storages: %d", fActiveStorages.GetEntries()));
	108	}
	109
	110	//_____________________________________________________________________________
	111	void AliCDBManager::RegisterFactory(AliCDBStorageFactory* factory) {
	112	// add a storage factory to the list of registerd factories
	113
	114	if (!fFactories.Contains(factory)) {
	115	fFactories.Add(factory);
	116	}
	117	}
	118
	119	//_____________________________________________________________________________
fdf65bb5	120	Bool_t AliCDBManager::HasStorage(const char* dbString) const {
9e1ceb13	121	// check if dbString is a URI valid for one of the registered factories
	122
	123	TIter iter(&fFactories);
	124
	125	AliCDBStorageFactory* factory;
	126	while ((factory = (AliCDBStorageFactory*) iter.Next())) {
	127
	128	if (factory->Validate(dbString)) {
	129	return kTRUE;
	130	}
	131	}
	132
	133	return kFALSE;
	134	}
	135
	136	//_____________________________________________________________________________
fdf65bb5	137	AliCDBParam* AliCDBManager::CreateParameter(const char* dbString) const {
9e1ceb13	138	// create AliCDBParam object from URI string
	139
	140	TIter iter(&fFactories);
	141
	142	AliCDBStorageFactory* factory;
	143	while ((factory = (AliCDBStorageFactory*) iter.Next())) {
	144
	145	AliCDBParam* param = factory->CreateParameter(dbString);
	146	if (param) {
	147	return param;
	148	}
	149	}
	150
	151	return NULL;
	152	}
	153
	154	//_____________________________________________________________________________
	155	AliCDBStorage* AliCDBManager::GetStorage(const char* dbString) {
	156	// get storage object from URI string
	157
	158	AliCDBParam* param = CreateParameter(dbString);
	159	if (!param) {
	160	return NULL;
	161	}
	162
	163	AliCDBStorage* aStorage = GetStorage(param);
	164
	165	delete param;
	166
	167	return aStorage;
	168	}
	169
	170	//_____________________________________________________________________________
	171	AliCDBStorage* AliCDBManager::GetStorage(const AliCDBParam* param) {
	172	// get storage object from AliCDBParam object
	173
	174	// if the list of active storages already contains
	175	// the requested storage, return it
	176	AliCDBStorage* aStorage = GetActiveStorage(param);
	177	if (aStorage) {
	178	return aStorage;
	179	}
	180
	181	TIter iter(&fFactories);
	182
	183	AliCDBStorageFactory* factory;
	184
	185	// loop on the list of registered factories
	186	while ((factory = (AliCDBStorageFactory*) iter.Next())) {
	187
	188	// each factory tries to create its storage from the parameter
	189	aStorage = factory->Create(param);
	190	if (aStorage) {
	191	PutActiveStorage(param->CloneParam(), aStorage);
	192	// if default storage is not set, set to this storage
	193	if(!fDefaultStorage){
	194	fDefaultStorage=aStorage;
	195	AliInfo(Form("Default storage set to: %s",(param->GetURI()).Data()));
	196	}
	197	return aStorage;
	198	}
	199	}
	200
	201	return NULL;
202	}
203
204	//_____________________________________________________________________________
205	TList* AliCDBManager::GetActiveStorages() {
206	// return list of active storages
207
208	TList* result = new TList();
209
210	TIter iter(fActiveStorages.GetTable());
211	TPair* aPair;
212	while ((aPair = (TPair*) iter.Next())) {
213	result->Add(aPair->Value());
214	}
215
216	return result;
217	}
218
219	//_____________________________________________________________________________
220	void AliCDBManager::SetDrain(const char* dbString) {
221	// set drain storage from URI string
222
223	fDrainStorage = GetStorage(dbString);
224	}
225
226	//_____________________________________________________________________________
227	void AliCDBManager::SetDrain(const AliCDBParam* param) {
228	// set drain storage from AliCDBParam
229
230	fDrainStorage = GetStorage(param);
231	}
232
233	//_____________________________________________________________________________
234	void AliCDBManager::SetDrain(AliCDBStorage* storage) {
235	// set drain storage from another active storage
236
237	fDrainStorage = storage;
238	}
239
240	//_____________________________________________________________________________
241	Bool_t AliCDBManager::Drain(AliCDBEntry *entry) {
242	// drain retrieved object to drain storage
243
244	AliInfo("Draining into drain storage...");
245	return fDrainStorage->Put(entry);
246	}
247
9e1ceb13	248	//_____________________________________________________________________________
	249	void AliCDBManager::SetDefaultStorage(const char* dbString) {
	250	// sets default storage from URI string
	251
9e1ceb13	252	fDefaultStorage = GetStorage(dbString);
	253	}
	254
	255	//_____________________________________________________________________________
	256	void AliCDBManager::SetDefaultStorage(const AliCDBParam* param) {
	257	// set default storage from AliCDBParam object
	258
9e1ceb13	259	fDrainStorage = GetStorage(param);
	260	}
	261
	262	//_____________________________________________________________________________
	263	void AliCDBManager::SetDefaultStorage(AliCDBStorage* storage) {
	264	// set default storage from another active storage
	265
9e1ceb13	266	fDefaultStorage = storage;
	267	}
	268
02c4845e	269	//_____________________________________________________________________________
024cf675	270	void AliCDBManager::SetSpecificStorage(const char* calibType, const char* dbString) {
024cf675	271	// sets storage specific for detector or calibration type (works with AliCDBManager::Get(...))
02c4845e	272
	273	AliCDBParam *aPar = CreateParameter(dbString);
	274	if(!aPar) return;
024cf675	275	SetSpecificStorage(calibType, aPar);
02c4845e	276	delete aPar;
	277	}
	278
	279	//_____________________________________________________________________________
024cf675	280	void AliCDBManager::SetSpecificStorage(const char* calibType, AliCDBParam* param) {
	281	// sets storage specific for detector or calibration type (works with AliCDBManager::Get(...))
	282	// Default storage should be defined prior to any specific storages, e.g.:
	283	// AliCDBManager::instance()->SetDefaultStorage("alien://");
	284	// AliCDBManager::instance()->SetSpecificStorage("TPC","local://DB_TPC");
	285	// AliCDBManager::instance()->SetSpecificStorage("RICH/Align","local://DB_TPCAlign");
02c4845e	286
	287	if(!fDefaultStorage) {
	288	AliError("Please activate a default storage first!");
	289	return;
	290	}
	291
024cf675	292	TObjString *objCalibType = new TObjString(calibType);
	293	if(fSpecificStorages.Contains(objCalibType)){
	294	AliWarning(Form("%s storage already activated! It will be replaced by the new one",
	295	calibType));
	296	fSpecificStorages.Remove(objCalibType);
02c4845e	297	}
02c4845e	298	GetStorage(param);
024cf675	299	fSpecificStorages.Add(objCalibType, param->CloneParam());
02c4845e	300	}
	301
	302	//_____________________________________________________________________________
024cf675	303	AliCDBStorage* AliCDBManager::GetSpecificStorage(const char* calibType) {
024cf675	304	// get storage specific for detector or calibration type
4b5e0dce	305
024cf675	306	AliCDBParam checkPar = (AliCDBParam) fSpecificStorages.GetValue(calibType);
02c4845e	307	if(!checkPar){
024cf675	308	AliError(Form("%s storage not found!",calibType));
02c4845e	309	return NULL;
	310	} else {
	311	return GetStorage(checkPar);
	312	}
	313
	314	}
	315
024cf675	316	//_____________________________________________________________________________
	317	AliCDBParam* AliCDBManager::SelectSpecificStorage(const TString& path) {
	318	// select storage valid for path from the list of specific storages
	319
	320	TIter iter(&fSpecificStorages);
	321	TObjString *aCalibType;
	322	AliCDBParam* aPar=0;
	323	while((aCalibType = (TObjString*) iter.Next())){
	324	if(path.Contains(aCalibType->String(), TString::kIgnoreCase)) {
	325	aPar = (AliCDBParam*) fSpecificStorages.GetValue(aCalibType);
	326	break;
	327	}
	328	}
	329	return aPar;
	330	}
	331
02c4845e	332	//_____________________________________________________________________________
	333	AliCDBEntry* AliCDBManager::Get(const AliCDBPath& path, Int_t runNumber,
	334	Int_t version, Int_t subVersion) {
	335	// get an AliCDBEntry object from the database
	336
024cf675	337	if(runNumber < 0){
	338	// RunNumber is not specified. Try with fRun
	339	if (fRun < 0){
	340	AliError("Run number neither specified in query nor set in AliCDBManager! Use AliCDBManager::SetRun.");
	341	return NULL;
	342	}
	343	runNumber = fRun;
	344	}
	345
02c4845e	346	return Get(AliCDBId(path, runNumber, runNumber, version, subVersion));
	347	}
	348
	349	//_____________________________________________________________________________
	350	AliCDBEntry* AliCDBManager::Get(const AliCDBPath& path,
	351	const AliCDBRunRange& runRange, Int_t version,
	352	Int_t subVersion) {
	353	// get an AliCDBEntry object from the database!
	354
	355	return Get(AliCDBId(path, runRange, version, subVersion));
	356	}
	357
	358	//_____________________________________________________________________________
	359	AliCDBEntry* AliCDBManager::Get(const AliCDBId& query) {
	360	// get an AliCDBEntry object from the database
	361
	362	if(!fDefaultStorage) {
	363	AliError("No storage set!");
	364	return NULL;
	365	}
	366
	367	// check if query's path and runRange are valid
	368	// query is invalid also if version is not specified and subversion is!
	369	if (!query.IsValid()) {
	370	AliError(Form("Invalid query: %s", query.ToString().Data()));
	371	return NULL;
	372	}
024cf675	373
	374	// query is not specified if path contains wildcard or run range= [-1,-1]
	375	if (!query.IsSpecified()) {
02c4845e	376	AliError(Form("Unspecified query: %s",
	377	query.ToString().Data()));
	378	return NULL;
	379	}
	380
024cf675	381	if(fCache && query.GetFirstRun() != fRun)
	382	AliWarning("Run number explicitly set in query: CDB cache temporarily disabled!");
	383
	384
	385	AliCDBEntry *entry=0;
	386
	387
	388	// first look into map of cached objects
	389	if(query.GetFirstRun() == fRun)
	390	entry = (AliCDBEntry*) fEntryCache.GetValue(query.GetPath());
	391
	392	if(entry) {
	393	AliInfo(Form("Object %s retrieved from cache !!",query.GetPath().Data()));
	394	return entry;
	395	}
	396
	397	// Entry is not in cache -> retrieve it from CDB and cache it!!
	398	AliCDBStorage *aStorage=0;
	399	AliCDBParam *aPar=SelectSpecificStorage(query.GetPath());
02c4845e	400
	401	if(aPar) {
	402	aStorage=GetStorage(aPar);
	403	TString str = aPar->GetURI();
	404	AliDebug(2,Form("Looking into storage: %s",str.Data()));
	405
	406	} else {
	407	aStorage=GetDefaultStorage();
	408	AliDebug(2,"Looking into default storage");
	409	}
	410
024cf675	411	entry = aStorage->Get(query);
	412	if (!entry) return NULL;
	413
	414	if(fCache && (query.GetFirstRun() == fRun)){
	415	AliInfo(Form("Caching entry %s !",query.GetPath().Data()));
	416	CacheEntry(query.GetPath(), entry);
	417	}
	418
	419	return entry;
	420
02c4845e	421	}
	422
	423	//_____________________________________________________________________________
	424	TList* AliCDBManager::GetAll(const AliCDBPath& path, Int_t runNumber,
	425	Int_t version, Int_t subVersion) {
	426	// get multiple AliCDBEntry objects from the database
	427
	428	return GetAll(AliCDBId(path, runNumber, runNumber, version,
	429	subVersion));
	430	}
	431
	432	//_____________________________________________________________________________
	433	TList* AliCDBManager::GetAll(const AliCDBPath& path,
	434	const AliCDBRunRange& runRange, Int_t version, Int_t subVersion) {
	435	// get multiple AliCDBEntry objects from the database
	436
	437	return GetAll(AliCDBId(path, runRange, version, subVersion));
	438	}
	439
	440	//_____________________________________________________________________________
	441	TList* AliCDBManager::GetAll(const AliCDBId& query) {
	442	// get multiple AliCDBEntry objects from the database
024cf675	443	// Warning: this method works correctly only for queries of the type "Detector/*"
024cf675	444	// and not for more specific queries e.g. "Detector/Calib/*" !
02c4845e	445
	446	if(!fDefaultStorage) {
	447	AliError("No storage set!");
	448	return NULL;
	449	}
	450
	451	if (!query.IsValid()) {
	452	AliError(Form("Invalid query: %s", query.ToString().Data()));
	453	return NULL;
	454	}
	455
	456	if(query.GetPath().BeginsWith('*')){
	457	AliError("Query too generic in this context!");
	458	return NULL;
	459	}
	460
	461	if (query.IsAnyRange()) {
	462	AliError(Form("Unspecified run or runrange: %s",
	463	query.ToString().Data()));
	464	return NULL;
	465	}
	466
	467	TObjString objStrLev0(query.GetLevel0());
	468	AliCDBParam aPar = (AliCDBParam) fSpecificStorages.GetValue(&objStrLev0);
024cf675	469
024cf675	470	AliCDBStorage *aStorage;
02c4845e	471	if(aPar) {
	472	aStorage=GetStorage(aPar);
	473	TString str = aPar->GetURI();
	474	AliDebug(2,Form("Looking into storage: %s",str.Data()));
	475
	476	} else {
	477	aStorage=GetDefaultStorage();
	478	AliDebug(2,"Looking into default storage");
	479	}
	480
	481	TList *result = aStorage->GetAll(query);
	482
	483	return result;
	484	}
	485
	486	//_____________________________________________________________________________
	487	Bool_t AliCDBManager::Put(TObject* object, AliCDBId& id, AliCDBMetaData* metaData){
	488	// store an AliCDBEntry object into the database
	489
	490	AliCDBEntry anEntry(object, id, metaData);
	491	return Put(&anEntry);
	492
	493	}
	494
	495
	496	//_____________________________________________________________________________
	497	Bool_t AliCDBManager::Put(AliCDBEntry* entry){
	498	// store an AliCDBEntry object into the database
	499
	500	if(!fDefaultStorage) {
	501	AliError("No storage set!");
	502	return kFALSE;
	503	}
	504
	505	if (!entry){
	506	AliError("No entry!");
	507	return kFALSE;
	508	}
	509
	510	if (!entry->GetId().IsValid()) {
	511	AliError(Form("Invalid entry ID: %s",
	512	entry->GetId().ToString().Data()));
	513	return kFALSE;
	514	}
	515
	516	if (!entry->GetId().IsSpecified()) {
	517	AliError(Form("Unspecified entry ID: %s",
	518	entry->GetId().ToString().Data()));
	519	return kFALSE;
	520	}
	521
	522	AliCDBId id = entry->GetId();
024cf675	523	AliCDBParam *aPar = SelectSpecificStorage(id.GetPath());
024cf675	524
02c4845e	525	AliCDBStorage *aStorage;
	526
	527	if(aPar) {
	528	aStorage=GetStorage(aPar);
	529	TString str = aPar->GetURI();
	530	AliDebug(2,Form("Storing object into storage: %s",str.Data()));
	531
	532	} else {
	533	aStorage=GetDefaultStorage();
	534	AliDebug(2,"Storing object into default storage");
	535	}
	536
	537	return aStorage->Put(entry);
	538
	539
	540	}
9e1ceb13	541
4b5e0dce	542	//_____________________________________________________________________________
	543	void AliCDBManager::CacheEntry(const char* path, AliCDBEntry* entry)
	544	{
	545	// cache AliCDBEntry. Cache is valid until run number is changed.
	546
	547	AliDebug(2,Form("Filling cache with entry %s",path));
	548	fEntryCache.Add(new TObjString(path), entry);
	549	AliDebug(2,Form("Cache entries: %d",fEntryCache.GetEntries()));
	550
	551	}
	552
	553	//_____________________________________________________________________________
	554	void AliCDBManager::SetRun(Long64_t run)
	555	{
4b5e0dce	556	// Sets current run number.
4b5e0dce	557	// When the run number changes the caching is cleared.
4b5e0dce	558
	559	if (fRun == run)
	560	return;
	561
	562	fRun = run;
	563	ClearCache();
	564	}
	565
	566	//_____________________________________________________________________________
	567	void AliCDBManager::ClearCache(){
	568	// clear AliCDBEntry cache
	569
	570	AliDebug(2,Form("Clearing cache!"));
	571	fEntryCache.DeleteAll();
	572	AliDebug(2,Form("Cache entries: %d",fEntryCache.GetEntries()));
	573
	574	}
	575
9e1ceb13	576	//_____________________________________________________________________________
	577	void AliCDBManager::DestroyActiveStorages() {
	578	// delete list of active storages
	579
	580	fActiveStorages.DeleteAll();
02c4845e	581	fSpecificStorages.DeleteAll();
9e1ceb13	582	}
	583
	584	//_____________________________________________________________________________
	585	void AliCDBManager::DestroyActiveStorage(AliCDBStorage* /storage/) {
b05400be	586	// destroys active storage
	587
	588	/*
	589	TIter iter(fActiveStorages.GetTable());
	590	TPair* aPair;
	591	while ((aPair = (TPair*) iter.Next())) {
	592	if(storage == (AliCDBStorage*) aPair->Value())
	593	delete fActiveStorages.Remove(aPair->Key());
	594	storage->Delete(); storage=0x0;
	595	}
	596	*/
9e1ceb13	597
	598	}
	599
	600	///////////////////////////////////////////////////////////
	601	// AliCDBManager Parameter class //
	602	// interface to specific AliCDBParameter class //
	603	// (AliCDBGridParam, AliCDBLocalParam, AliCDBDumpParam) //
	604	///////////////////////////////////////////////////////////
	605
	606	AliCDBParam::AliCDBParam() {
	607	// constructor
	608
	609	}
	610
	611	//_____________________________________________________________________________
	612	AliCDBParam::~AliCDBParam() {
	613	// destructor
	614
	615	}
	616