xref: /aoo41x/main/framework/inc/macros/debug/targeting.hxx (revision f8e07b45)

/**************************************************************
 *
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the License is distributed on an
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 * KIND, either express or implied.  See the License for the
 * specific language governing permissions and limitations
 * under the License.
 *
 *************************************************************/



#ifndef __FRAMEWORK_MACROS_DEBUG_TARGETING_HXX_
#define __FRAMEWORK_MACROS_DEBUG_TARGETING_HXX_

//*****************************************************************************************************************
//	special macros for targeting of frames
//*****************************************************************************************************************

#ifdef	ENABLE_TARGETINGDEBUG

	//_____________________________________________________________________________________________________________
	//	includes
	//_____________________________________________________________________________________________________________

	#ifndef _RTL_STRBUF_HXX_
	#include <rtl/strbuf.hxx>
	#endif

	/*_____________________________________________________________________________________________________________
		LOGFILE_TARGETING

		For follow macros we need a special log file. If user forget to specify anyone, we must do it for him!
	_____________________________________________________________________________________________________________*/

	#ifndef	LOGFILE_TARGETING
		#define	LOGFILE_TARGETSTEPS		"targetsteps.log"
		#define	LOGFILE_TARGETPARAM		"targetparam.log"
	#endif

	/*_____________________________________________________________________________________________________________
		LOG_PARAMETER_FINDFRAME( SSERVICE, SFRAMENAME, STARGETNAME, NSEARCHFLAGS )

		Log format for parameter e.g.: Desktop::findFrame( "frame1", 23 ) my name is "desktop"
		Log format for steps     e.g.: desktop--

		With this macro you can log informations about search parameter of method "findFrame()" of an service.
		Use it at beginning of search only!
	_____________________________________________________________________________________________________________*/

	#define	LOG_PARAMETER_FINDFRAME( SSERVICE, SFRAMENAME, STARGETNAME, NSEARCHFLAGS )							\
				/* Use new scope to prevent code against multiple variable defines! */							\
				{																								\
					::rtl::OStringBuffer sBufferParam(256);														\
					::rtl::OStringBuffer sBufferSteps(256);														\
					sBufferParam.append( SSERVICE												);				\
					sBufferParam.append( "::findFrame( \""										);				\
					sBufferParam.append( U2B( STARGETNAME )										);				\
					sBufferParam.append( "\", "													);				\
					sBufferParam.append( ::rtl::OString::valueOf( sal_Int32( NSEARCHFLAGS ) )	);				\
					sBufferParam.append( " ) my name is \""										);				\
					sBufferParam.append( U2B( SFRAMENAME )										);				\
					sBufferParam.append( "\"\n"													);				\
					sBufferSteps.append( U2B( SFRAMENAME )										);				\
					sBufferSteps.append( "--"													);				\
					WRITE_LOGFILE( LOGFILE_TARGETPARAM, sBufferParam.makeStringAndClear() )						\
					WRITE_LOGFILE( LOGFILE_TARGETSTEPS, sBufferSteps.makeStringAndClear() )						\
				}

	/*_____________________________________________________________________________________________________________
		LOG_PARAMETER_QUERYDISPATCH( SSERVICE, SFRAMENAME, AURL, STARGETNAME, NSEARCHFLAGS )

		With this macro you can log informations about search parameter of method "queryDispatch()" of an service.
		Use it at beginning of search only!
	_____________________________________________________________________________________________________________*/

	#define	LOG_PARAMETER_QUERYDISPATCH( SSERVICE, SFRAMENAME, AURL, STARGETNAME, NSEARCHFLAGS )						\
				/* Use new scope to prevent code against multiple variable defines! */									\
				{																										\
					::rtl::OStringBuffer sBuffer(1024);																	\
					sBuffer.append( "[ "													);							\
					sBuffer.append( U2B( SFRAMENAME )										);							\
					sBuffer.append( "] "													);							\
					sBuffer.append( SSERVICE												);							\
					sBuffer.append( "::queryDispatch( \""									);							\
					sBuffer.append( U2B( AURL.Complete )									);							\
					sBuffer.append( "\", \""												);							\
					sBuffer.append( U2B( STARGETNAME )										);							\
					sBuffer.append( "\", "													);							\
					sBuffer.append( ::rtl::OString::valueOf( sal_Int32( NSEARCHFLAGS ) )	);							\
					sBuffer.append( " )\n"													);							\
					WRITE_LOGFILE( LOGFILE_TARGETPARAM, sBuffer.makeStringAndClear() )									\
				}

	/*_____________________________________________________________________________________________________________
		LOG_PARAMETER_LOADCOMPONENTFROMURL( SSERVICE, SFRAMENAME, SURL, STARGETNAME, NSEARCHFLAGS, SEQPARAMETER )

		With this macro you can log informations about search parameter of method "loadComponentFromURL()" of an service.
		Use it at beginning of search only!
	_____________________________________________________________________________________________________________*/

	#define	LOG_PARAMETER_LOADCOMPONENTFROMURL( SSERVICE, SFRAMENAME, SURL, STARGETNAME, NSEARCHFLAGS, SEQPARAMETER )	\
				/* Use new scope to prevent code against multiple variable defines! */									\
				{																										\
					::rtl::OStringBuffer sBuffer(1024);																	\
					sBuffer.append( "[ "													);							\
					sBuffer.append( U2B( SFRAMENAME )										);							\
					sBuffer.append( "] "													);							\
					sBuffer.append( SSERVICE												);							\
					sBuffer.append( "::loadComponentFromURL( \""							);							\
					sBuffer.append( U2B( SURL )												);							\
					sBuffer.append( "\", \""												);							\
					sBuffer.append( U2B( STARGETNAME )										);							\
					sBuffer.append( "\", "													);							\
					sBuffer.append( ::rtl::OString::valueOf( sal_Int32( NSEARCHFLAGS ) )	);							\
					sBuffer.append( ", "													);							\
					sal_Int32 nCount = SEQPARAMETER.getLength();														\
					for( sal_Int32 nParameter=0; nParameter<nCount; ++nParameter )										\
					{																									\
						sBuffer.append( U2B( SEQPARAMETER[nParameter].Name ));											\
						if( nParameter<(nCount-1) )																		\
						{																								\
							sBuffer.append( " | " );																	\
						}																								\
					}																									\
					sBuffer.append( " )\n"													);							\
					WRITE_LOGFILE( LOGFILE_TARGETPARAM, sBuffer.makeStringAndClear() )									\
				}

	/*_____________________________________________________________________________________________________________
		LOG_RESULT_FINDFRAME( SSERVICE, SFRAMENAME, XFRAME )

		With this macro you can log informations about search result of "findFrame()".
		Use it at the end of this method only!
	_____________________________________________________________________________________________________________*/

	#define	LOG_RESULT_FINDFRAME( SSERVICE, SFRAMENAME, XFRAME )														\
				/* Use new scope to prevent code against multiple variable defines! */									\
				{																										\
					::rtl::OStringBuffer sBufferParam(256);																\
					::rtl::OStringBuffer sBufferSteps(256);																\
					sBufferParam.append( SSERVICE				);														\
					sBufferParam.append( "::findFrame() at \""	);														\
					sBufferParam.append( U2B( SFRAMENAME )		);														\
					sBufferParam.append( "\" "					);														\
					if( XFRAME.is() == sal_True )																		\
					{																									\
						sBufferParam.append( "return with valid frame.\n"		);										\
						sBufferSteps.append( "OK ["								);										\
						sBufferSteps.append( U2B( XFRAME->getName() )			);										\
						sBufferSteps.append( "]\n"								);										\
					}																									\
					else																								\
					{																									\
						sBufferParam.append( "return with NULL frame!\n");												\
						sBufferSteps.append( "??\n"						);												\
					}																									\
					WRITE_LOGFILE( LOGFILE_TARGETPARAM, sBufferParam.makeStringAndClear() )								\
					WRITE_LOGFILE( LOGFILE_TARGETSTEPS, sBufferSteps.makeStringAndClear() )								\
				}

	/*_____________________________________________________________________________________________________________
		LOG_RESULT_QUERYDISPATCH( SSERVICE, SFRAMENAME, XDISPATCHER )

		With this macro you can log informations about search result of "queryDispatch()".
		Use it at the end of this method only!
	_____________________________________________________________________________________________________________*/

	#define	LOG_RESULT_QUERYDISPATCH( SSERVICE, SFRAMENAME, XDISPATCHER )												\
				/* Use new scope to prevent code against multiple variable defines! */									\
				{																										\
					::rtl::OStringBuffer sBuffer(1024);																	\
					sBuffer.append( "[ "				);																\
					sBuffer.append( U2B( SFRAMENAME )	);																\
					sBuffer.append( "] "				);																\
					sBuffer.append( SSERVICE			);																\
					if( XDISPATCHER.is() == sal_True )																	\
					{																									\
						sBuffer.append( "::queryDispatch() return with valid dispatcher."	);							\
					}																									\
					else																								\
					{																									\
						sBuffer.append( "::queryDispatch() return with NULL dispatcher!"	);							\
					}																									\
					sBuffer.append( "\n" );																				\
					WRITE_LOGFILE( LOGFILE_TARGETPARAM, sBuffer.makeStringAndClear() )									\
				}

	/*_____________________________________________________________________________________________________________
		LOG_RESULT_LOADCOMPONENTFROMURL( SSERVICE, SFRAMENAME, XCOMPONENT )

		With this macro you can log informations about search result of "loadComponentFromURL()".
		Use it at the end of this method only!
	_____________________________________________________________________________________________________________*/

	#define	LOG_RESULT_LOADCOMPONENTFROMURL( SSERVICE, SFRAMENAME, XCOMPONENT )											\
				/* Use new scope to prevent code against multiple variable defines! */									\
				{																										\
					::rtl::OStringBuffer sBuffer(1024);																	\
					sBuffer.append( "[ "				);																\
					sBuffer.append( U2B( SFRAMENAME )	);																\
					sBuffer.append( "] "				);																\
					sBuffer.append( SSERVICE			);																\
					if( XCOMPONENT.is() == sal_True )																	\
					{																									\
						sBuffer.append( "::loadComponentFromURL() return with valid component."	);						\
					}																									\
					else																								\
					{																									\
						sBuffer.append( "::loadComponentFromURL() return with NULL component!"	);						\
					}																									\
					sBuffer.append( "\n" );																				\
					WRITE_LOGFILE( LOGFILE_TARGETPARAM, sBuffer.makeStringAndClear() )									\
				}

#else	// #ifdef ENABLE_TARGETINGDEBUG

	/*_____________________________________________________________________________________________________________
		If right testmode is'nt set - implements these macro empty!
	_____________________________________________________________________________________________________________*/

	#undef	LOGFILE_TARGETPARAM
	#undef	LOGFILE_TARGETSTEPS
	#define	LOG_PARAMETER_FINDFRAME( SSERVICE, SFRAMENAME, STARGETNAME, NSEARCHFLAGS )
	#define	LOG_PARAMETER_QUERYDISPATCH( SSERVICE, SFRAMENAME, AURL, STARGETNAME, NSEARCHFLAGS )
	#define	LOG_PARAMETER_LOADCOMPONENTFROMURL( SSERVICE, SFRAMENAME, SURL, STARGETNAME, NSEARCHFLAGS, SEQPARAMETER )
	#define	LOG_RESULT_FINDFRAME( SSERVICE, SFRAMENAME, XFRAME )
	#define	LOG_RESULT_QUERYDISPATCH( SSERVICE, SFRAMENAME, XDISPATCHER )
	#define	LOG_RESULT_LOADCOMPONENTFROMURL( SSERVICE, SFRAMENAME, XCOMPONENT )

#endif	// #ifdef ENABLE_TARGETINGDEBUG

//*****************************************************************************************************************
//	end of file
//*****************************************************************************************************************

#endif	// #ifndef __FRAMEWORK_MACROS_DEBUG_TARGETING_HXX_