Utils.h

//========================================================================================
// 
// $File$
// 
// Owner: Matt Joss
// 
// $Author$
// 
// $DateTime$
// 
// $Revision$
// 
// $Change$
// 
// Copyright 1997-2010 Adobe Systems Incorporated. All rights reserved.
// 
// NOTICE: Adobe permits you to use, modify, and distribute this file in accordance 
// with the terms of the Adobe license agreement accompanying it. If you have received
// this file from a source other than Adobe, then your use, modification, or 
// distribution of it requires the prior written permission of Adobe.
// 
// 
// Purpose:
// This is a helper class for calling methods in interfaces on the kUtilsBoss. The Utils boss is an easy way
// to share Utils across plugins without putting them in Public. 
// The syntax to use is...
// Utils<IFooUtils>()->MyFooMethod()
// 
//========================================================================================

#ifndef __Utils__
#define __Utils__


#include "ShuksanID.h"
#include "InterfacePtr.h"
#include "IPMUnknown.h"
#include "PMTypes.h"
#ifdef DEBUG
 #include "ISession.h"
#endif

class UtilsBoss
{
public:
 static void Purge();
 
 static IPMUnknown * QueryUtils( const PMIID& utilsIID );
};



template <class IFace> 
class Utils
{
public:
 inline Utils() { fFace = UtilsBoss::QueryUtils(IFace::kDefaultIID); }
 inline ~Utils() { if(fFace) fFace->Release(); } 
 
 inline IFace * operator ->() const { return static_cast<IFace*>(fFace); }
 
 inline operator IFace*() { return static_cast<IFace*>(fFace); }
 
 inline bool16 Exists() const { return fFace != nil; }

 inline IFace *QueryUtilInterface() { fFace->AddRef(); return static_cast<IFace*>(fFace); }

private:
 Utils<IFace>& operator=(const Utils<IFace>& other); // don't support this
 Utils<IFace>(const Utils<IFace>& copy); // don't support this

 IPMUnknown* fFace;
};



#endif //__Utils__