/************************************************************************* * * $RCSfile: framecontainer.cxx,v $ * * $Revision: 1.15 $ * * last change: $Author: mba $ $Date: 2001-08-22 08:13:27 $ * * The Contents of this file are made available subject to the terms of * either of the following licenses * * - GNU Lesser General Public License Version 2.1 * - Sun Industry Standards Source License Version 1.1 * * Sun Microsystems Inc., October, 2000 * * GNU Lesser General Public License Version 2.1 * ============================================= * Copyright 2000 by Sun Microsystems, Inc. * 901 San Antonio Road, Palo Alto, CA 94303, USA * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License version 2.1, as published by the Free Software Foundation. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 59 Temple Place, Suite 330, Boston, * MA 02111-1307 USA * * * Sun Industry Standards Source License Version 1.1 * ================================================= * The contents of this file are subject to the Sun Industry Standards * Source License Version 1.1 (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.openoffice.org/license.html. * * Software provided under this License is provided on an "AS IS" basis, * WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, * WITHOUT LIMITATION, WARRANTIES THAT THE SOFTWARE IS FREE OF DEFECTS, * MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE, OR NON-INFRINGING. * See the License for the specific provisions governing your rights and * obligations concerning the Software. * * The Initial Developer of the Original Code is: Sun Microsystems, Inc. * * Copyright: 2000 by Sun Microsystems, Inc. * * All Rights Reserved. * * Contributor(s): _______________________________________ * * ************************************************************************/ //_________________________________________________________________________________________________________________ // my own includes //_________________________________________________________________________________________________________________ #ifndef __FRAMEWORK_FRAMECONTAINER_HXX_ #include #endif #ifndef __FRAMEWORK_THREADHELP_TRANSACTIONGUARD_HXX_ #include #endif #ifndef __FRAMEWORK_THREADHELP_WRITEGUARD_HXX_ #include #endif #ifndef __FRAMEWORK_THREADHELP_READGUARD_HXX_ #include #endif //_________________________________________________________________________________________________________________ // interface includes //_________________________________________________________________________________________________________________ #ifndef _COM_SUN_STAR_FRAME_FRAMESEARCH_FLAG_HPP_ #include #endif //_________________________________________________________________________________________________________________ // includes of other projects //_________________________________________________________________________________________________________________ #ifndef _SV_SVAPP_HXX #include #endif //_________________________________________________________________________________________________________________ // namespace //_________________________________________________________________________________________________________________ namespace framework{ using namespace ::std ; using namespace ::rtl ; using namespace ::com::sun::star::uno ; using namespace ::com::sun::star::frame ; //_________________________________________________________________________________________________________________ // non exported const //_________________________________________________________________________________________________________________ //_________________________________________________________________________________________________________________ // non exported definitions //_________________________________________________________________________________________________________________ //_________________________________________________________________________________________________________________ // declarations //_________________________________________________________________________________________________________________ //***************************************************************************************************************** // constructor //***************************************************************************************************************** FrameContainer::FrameContainer() // initialize base classes first. // Order is neccessary for right initilization of his and OUR member ... m_aLock, m_aTransactionManager ... : ThreadHelpBase ( &Application::GetSolarMutex() ) , TransactionBase( ) { // Make object ready for working. // change working mode from E_INIT to E_WORK // We don't must look for current set modi - // a ctor couldn't be called more then ones ... I think so :-) m_aTransactionManager.setWorkingMode( E_WORK ); } //***************************************************************************************************************** // destructor //***************************************************************************************************************** FrameContainer::~FrameContainer() { // Disable object for working! // All further requests will be refused ... // but I think it's alittle bit superflous by using in dtor ... // May be - it's neccessary? // So we wait for current working reader/writer till they finish her work. m_aTransactionManager.setWorkingMode( E_BEFORECLOSE ); // Disable possible active quit timer! // He can be active for owner=desktop only. impl_disableQuitTimer(); // Don't forget to free memory! impl_clear(); m_aTransactionManager.setWorkingMode( E_CLOSE ); } //***************************************************************************************************************** // public method //***************************************************************************************************************** void FrameContainer::append( const Reference< XFrame >& xFrame ) { // Safe impossible cases // a) This method is not defined for ALL incoming parameters! // b) Warn programmer at already existing elements in container. // c) Warn programmer if an already existing frame has no component inside! // These frames are created (e.g. by dispatch()) but not used ... LOG_ASSERT2( implcp_append( xFrame ), "FrameContainer::append()", "Invalid parameter detected!" ) LOG_ASSERT2( exist(xFrame)==sal_True, "FrameContainer::append()", "New frame already exist in container!" ) // Register transaction. Reject wrong calls. TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS ); /* SAFE AREA ----------------------------------------------------------------------------------------------- */ WriteGuard aWriteLock( m_aLock ); // Append new frame to container. m_aContainer.push_back( xFrame ); } //***************************************************************************************************************** // public method //***************************************************************************************************************** void FrameContainer::remove( const Reference< XFrame >& xFrame ) { // Safe impossible cases // a) This method is not defined for ALL incoming parameters! // b) Warn programmer at non existing elements in container. LOG_ASSERT2( implcp_remove( xFrame ) , "FrameContainer::remove()", "Invalid parameter detected!" ) LOG_ASSERT2( exist(xFrame)==sal_False , "FrameContainer::remove()", "Frame to remove not exist in container!" ) // Register transaction. Reject wrong calls. TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS ); /* SAFE AREA ----------------------------------------------------------------------------------------------- */ WriteGuard aWriteLock( m_aLock ); // Search frame and remove it from container if he exist. TFrameIterator aSearchedItem = find( m_aContainer.begin(), m_aContainer.end(), xFrame ); if( aSearchedItem != m_aContainer.end() ) { m_aContainer.erase( aSearchedItem ); // If removed frame the current active frame - reset state variable. if( m_xActiveFrame == xFrame ) { m_xActiveFrame = Reference< XFrame >(); } // We don't need the write lock any longer ... // downgrade to read access. aWriteLock.downgrade(); // If last frame was removed and special quit timer is enabled by the desktop // we must terminate the desktop by using this timer! if ( ( m_aContainer.size() < 1 ) && ( m_rQuitTimer.isValid() == sal_True ) ) { m_rQuitTimer->start(); } } } //***************************************************************************************************************** // public method //***************************************************************************************************************** sal_Bool FrameContainer::exist( const Reference< XFrame >& xFrame ) const { // Safe impossible cases // This method is not defined for ALL incoming parameters! LOG_ASSERT2( implcp_exist( xFrame ), "FrameContainer::exist()", "Invalid parameter detected!" ) // Register transaction. Reject wrong calls. TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS ); /* SAFE AREA ----------------------------------------------------------------------------------------------- */ ReadGuard aReadLock( m_aLock ); // Search for given frame. return( find( m_aContainer.begin(), m_aContainer.end(), xFrame ) != m_aContainer.end() ); } //***************************************************************************************************************** // public method //***************************************************************************************************************** void FrameContainer::clear() { // Register transaction. Reject wrong calls. TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS ); /* SAFE AREA ----------------------------------------------------------------------------------------------- */ WriteGuard aWriteLock( m_aLock ); impl_clear(); } //***************************************************************************************************************** // public method //***************************************************************************************************************** sal_uInt32 FrameContainer::getCount() const { // Register transaction. Reject wrong calls. TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS ); /* SAFE AREA ----------------------------------------------------------------------------------------------- */ ReadGuard aReadLock( m_aLock ); return( (sal_uInt32)m_aContainer.size() ); } //***************************************************************************************************************** // public method //***************************************************************************************************************** Reference< XFrame > FrameContainer::operator[]( sal_uInt32 nIndex ) const { // Safe impossible cases // a) This method is not defined for ALL incoming parameters! LOG_ASSERT2( implcp_IndexOperator( nIndex, getCount() ), "FrameContainer::operator[]()", "Invalid parameter detected!" ) // Register transaction. Reject wrong calls. TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS ); /* SAFE AREA ----------------------------------------------------------------------------------------------- */ ReadGuard aReadLock( m_aLock ); Reference< XFrame > xFrame; try { // Get element form container WITH automatic test of ranges! // If index not valid, a out_of_range exception is thrown. xFrame = m_aContainer.at( nIndex ); } catch( std::out_of_range& ) { // The index is not valid for current container-content - we must handle this case! // We can return the default value ... LOG_EXCEPTION( "FrameContainer::operator[]", "Exception catched ...", DECLARE_ASCII("::std::out_of_range") ) } return xFrame; } //***************************************************************************************************************** // public method //***************************************************************************************************************** Sequence< Reference< XFrame > > FrameContainer::getAllElements() const { // Register transaction. Reject wrong calls. TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS ); /* SAFE AREA ----------------------------------------------------------------------------------------------- */ ReadGuard aReadLock( m_aLock ); sal_uInt32 nCount = (sal_uInt32)m_aContainer.size(); Sequence< Reference< XFrame > > lElements ( nCount ); for( sal_uInt32 nPosition=0; nPosition0 ); } //***************************************************************************************************************** // public method //***************************************************************************************************************** void FrameContainer::setActive( const Reference< XFrame >& xFrame ) { // Safe impossible cases // a) This method is not defined for ALL incoming parameters! // b) The new active frame MUST exist in container. LOG_ASSERT2( implcp_setActive( xFrame ) , "FrameContainer::setActive()", "Invalid parameter detected!" ) LOG_ASSERT2( xFrame.is()==sal_True && exist(xFrame)==sal_False , "FrameContainer::setActive()", "The new active frame is not a member of current container!You cant activate it." ) // Register transaction. Reject wrong calls. TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS ); /* SAFE AREA ----------------------------------------------------------------------------------------------- */ WriteGuard aWriteLock( m_aLock ); m_xActiveFrame = xFrame; } //***************************************************************************************************************** // public method //***************************************************************************************************************** Reference< XFrame > FrameContainer::getActive() const { // Register transaction. Reject wrong calls. TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS ); /* SAFE AREA ----------------------------------------------------------------------------------------------- */ ReadGuard aReadLock( m_aLock ); return m_xActiveFrame; } //***************************************************************************************************************** // public method //***************************************************************************************************************** void FrameContainer::enableQuitTimer( const Reference< XDesktop >& xDesktop ) { // Register transaction. Reject wrong calls. TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS ); /* SAFE AREA ----------------------------------------------------------------------------------------------- */ WriteGuard aWriteLock( m_aLock ); // If no current timer exist - create a new one. if( m_rQuitTimer.isEmpty() == sal_True ) { m_rQuitTimer.bind( new AsyncQuit( xDesktop ) ); } } //***************************************************************************************************************** // public method //***************************************************************************************************************** void FrameContainer::disableQuitTimer() { // Register transaction. Reject wrong calls. TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS ); /* SAFE AREA ----------------------------------------------------------------------------------------------- */ WriteGuard aWriteLock( m_aLock ); // Delete current quit timer. // If user wish to create it again he must do it with "enableQuitTimer()". impl_disableQuitTimer(); } //***************************************************************************************************************** // public method //***************************************************************************************************************** Reference< XFrame > FrameContainer::searchDeepDown( const OUString& sName ) const { // Check incoming parameter. LOG_ASSERT2( implcp_searchDeepDown( sName ), "FrameContainer::searchDeepDown()", "Invalid parameter detected!" ) // Register transaction. Reject wrong calls. TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS ); /* SAFE AREA ----------------------------------------------------------------------------------------------- */ ReadGuard aReadLock( m_aLock ); // Step over all child frames. But if direct child isn't the right one search on his children first - before // you go to next direct child of this container! Reference< XFrame > xSearchedFrame; for( TConstFrameIterator pIterator=m_aContainer.begin(); pIterator!=m_aContainer.end(); ++pIterator ) { if( (*pIterator)->getName() == sName ) { xSearchedFrame = *pIterator; break; } else { xSearchedFrame = (*pIterator)->findFrame( sName, FrameSearchFlag::CHILDREN ); if( xSearchedFrame.is() == sal_True ) { break; } } } return xSearchedFrame; } //***************************************************************************************************************** // public method //***************************************************************************************************************** Reference< XFrame > FrameContainer::searchFlatDown( const OUString& sName ) const { // Check incoming parameter. LOG_ASSERT2( implcp_searchFlatDown( sName ), "FrameContainer::searchFlatDown()", "Invalid parameter detected!" ) // Register transaction. Reject wrong calls. TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS ); /* SAFE AREA ----------------------------------------------------------------------------------------------- */ ReadGuard aReadLock( m_aLock ); // Step over all direct child frames first. // Even right frame wasn't found, start search at children of direct children. Reference< XFrame > xSearchedFrame; for( TConstFrameIterator pIterator=m_aContainer.begin(); pIterator!=m_aContainer.end(); ++pIterator ) { if( (*pIterator)->getName() == sName ) { xSearchedFrame = *pIterator; break; } } if( xSearchedFrame.is() == sal_False ) { for( pIterator=m_aContainer.begin(); pIterator!=m_aContainer.end(); ++pIterator ) { xSearchedFrame = (*pIterator)->findFrame( sName, FrameSearchFlag::CHILDREN | FrameSearchFlag::SIBLINGS ); if( xSearchedFrame.is() == sal_True ) { break; } } } return xSearchedFrame; } //***************************************************************************************************************** // public method //***************************************************************************************************************** Reference< XFrame > FrameContainer::searchDirectChildren( const OUString& sName ) const { // Check incoming parameter. LOG_ASSERT2( implcp_searchDirectChildren( sName ), "FrameContainer::searchDirectChildren()", "Invalid parameter detected!" ) // Register transaction. Reject wrong calls. TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS ); /* SAFE AREA ----------------------------------------------------------------------------------------------- */ ReadGuard aReadLock( m_aLock ); // Step over all current container items and search for right target. Reference< XFrame > xSearchedFrame; for( TConstFrameIterator pIterator=m_aContainer.begin(); pIterator!=m_aContainer.end(); ++pIterator ) { if( (*pIterator)->getName() == sName ) { xSearchedFrame = *pIterator; break; } } return xSearchedFrame; } //***************************************************************************************************************** // private method //***************************************************************************************************************** void FrameContainer::impl_clear() { /*ATTENTION: Don't use any lock here ... because our "owner" should make it threadsafe! */ // Clear the container ... m_aContainer.erase( m_aContainer.begin(), m_aContainer.end() ); m_aContainer.clear(); // ... and don't forget to reset the active frame. // Its an reference to a valid container-item. // But no container item => no active frame! m_xActiveFrame = Reference< XFrame >(); // If special quit timer is used - we must terminate the desktop. // He is the owner of this container and can't work without any visible tasks/frames! if( m_rQuitTimer.isValid() == sal_True ) { m_rQuitTimer->start(); } } //***************************************************************************************************************** // private method //***************************************************************************************************************** void FrameContainer::impl_disableQuitTimer() { /*ATTENTION: Don't use any lock here ... because our "owner" should make it threadsafe! */ if( m_rQuitTimer.isValid() == sal_True ) { m_rQuitTimer.unbind(); } } } // namespace framework