uniqueapphandler.cpp

/*
   This file is part of KDE Kontact.
 
   Copyright (c) 2003 David Faure <faure@kde.org>
 
   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Library General Public
   License as published by the Free Software Foundation; either
   version 2 of the License, or (at your option) any later version.
 
   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
   Library General Public License for more details.
 
   You should have received a copy of the GNU Library General Public License
   along with this library; see the file COPYING.LIB.  If not, write to
   the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
   Boston, MA 02110-1301, USA.
*/
 
#include "uniqueapphandler.h"
#include <tdestartupinfo.h>
#include <tdeapplication.h>
#include <tdecmdlineargs.h>
#include "core.h"
#include <twin.h>
#include <dcopclient.h>
#include <kdebug.h>
#include <tdelocale.h>
#include <tdeuniqueapplication.h>
 
/*
 Test plan for the various cases of interaction between standalone apps and kontact:
 
 1) start kontact, select "Mail".
 1a) type "korganizer" -> it switches to korganizer
 1b) type "kmail" -> it switches to kmail
 1c) type "kaddressbook" -> it switches to kaddressbook
 1d) type "kmail foo@kde.org" -> it opens a kmail composer, without switching
 1e) type "knode" -> it switches to knode
 1f) type "kaddressbook --new-contact" -> it opens a kaddressbook contact window
 1g) type "knode news://foobar/group" -> it pops up "can't resolve hostname"
 
 2) close kontact. Launch kmail. Launch kontact again.
 2a) click "Mail" icon -> kontact doesn't load a part, but activates the kmail window
 2b) type "kmail foo@kde.org" -> standalone kmail opens composer.
 2c) close kmail, click "Mail" icon -> kontact loads the kmail part.
 2d) type "kmail" -> kontact is brought to front
 
 3) close kontact. Launch korganizer, then kontact.
 3a) both Todo and Calendar activate the running korganizer.
 3b) type "korganizer" -> standalone korganizer is brought to front
 3c) close korganizer, click Calendar or Todo -> kontact loads part.
 3d) type "korganizer" -> kontact is brought to front
 
 4) close kontact. Launch kaddressbook, then kontact.
 4a) "Contacts" icon activate the running kaddressbook.
 4b) type "kaddressbook" -> standalone kaddressbook is brought to front
 4c) close kaddressbook, type "kaddressbook -a foo@kde.org" -> kontact loads part and opens editor
 4d) type "kaddressbook" -> kontact is brought to front
 
 5) close kontact. Launch knode, then kontact.
 5a) "News" icon activate the running knode.
 5b) type "knode" -> standalone knode is brought to front
 5c) close knode, type "knode news://foobar/group" -> kontact loads knode and pops up msgbox
 5d) type "knode" -> kontact is brought to front
 
 6) start "kontact --module summaryplugin"
 6a) type "dcop kmail kmail newInstance" -> kontact switches to kmail (#103775)
 6b) type "kmail" -> kontact is brought to front
 6c) type "kontact" -> kontact is brought to front
 6d) type "kontact --module summaryplugin" -> kontact switches to summary
 
*/
 
using namespace Kontact;
 
int UniqueAppHandler::newInstance()
{
  // This bit is duplicated from TDEUniqueApplication::newInstance()
  if ( tdeApp->mainWidget() ) {
    tdeApp->mainWidget()->show();
    KWin::forceActiveWindow( tdeApp->mainWidget()->winId() );
    TDEStartupInfo::appStarted();
  }
 
  // Then ensure the part appears in kontact
  mPlugin->core()->selectPlugin( mPlugin );
  return 0;
}
 
bool UniqueAppHandler::process( const TQCString &fun, const TQByteArray &data,
                                TQCString& replyType, TQByteArray &replyData )
{
  if ( fun == "newInstance()" ) {
    replyType = "int";
 
    TDECmdLineArgs::reset(); // forget options defined by other "applications"
    loadCommandLineOptions(); // implemented by plugin
 
    // This bit is duplicated from TDEUniqueApplication::processDelayed()
    TQDataStream ds( data, IO_ReadOnly );
    TDECmdLineArgs::loadAppArgs( ds );
    if ( !ds.atEnd() ) { // backwards compatibility
      TQCString asn_id;
      ds >> asn_id;
      tdeApp->setStartupId( asn_id );
    }
 
    TQDataStream _replyStream( replyData, IO_WriteOnly );
    _replyStream << newInstance();
 
    // OK, we're done, reload the initial kontact command line options,
    // so that "kontact --module foo" keeps working (#103775).
 
    TDECmdLineArgs::reset(); // forget options defined above
    loadKontactCommandLineOptions();
 
  } else if ( fun == "load()" ) {
    replyType = "bool";
    (void)mPlugin->part(); // load the part without bringing it to front
 
    TQDataStream _replyStream( replyData, IO_WriteOnly );
    _replyStream << true;
  } else {
    return DCOPObject::process( fun, data, replyType, replyData );
  }
  return true;
}
 
QCStringList UniqueAppHandler::interfaces()
{
  QCStringList ifaces = DCOPObject::interfaces();
  ifaces += "Kontact::UniqueAppHandler";
  return ifaces;
}
 
QCStringList UniqueAppHandler::functions()
{
  QCStringList funcs = DCOPObject::functions();
  funcs << "int newInstance()";
  funcs << "bool load()";
  return funcs;
}
 
UniqueAppWatcher::UniqueAppWatcher( UniqueAppHandlerFactoryBase* factory, Plugin* plugin )
    : TQObject( plugin ), mFactory( factory ), mPlugin( plugin )
{
  // The app is running standalone if 1) that name is known to DCOP
  mRunningStandalone = tdeApp->dcopClient()->isApplicationRegistered( plugin->name() );
 
  // and 2) it's not registered by kontact (e.g. in another plugin)
  if ( mRunningStandalone && tdeApp->dcopClient()->findLocalClient( plugin->name() ) )
      mRunningStandalone = false;
 
  if ( mRunningStandalone ) {
    tdeApp->dcopClient()->setNotifications( true );
    connect( tdeApp->dcopClient(), TQ_SIGNAL( applicationRemoved( const TQCString& ) ),
             this, TQ_SLOT( unregisteredFromDCOP( const TQCString& ) ) );
  } else {
    mFactory->createHandler( mPlugin );
  }
}
 
UniqueAppWatcher::~UniqueAppWatcher()
{
  if ( mRunningStandalone )
    tdeApp->dcopClient()->setNotifications( false );
 
  delete mFactory;
}
 
void UniqueAppWatcher::unregisteredFromDCOP( const TQCString& appId )
{
  if ( appId == mPlugin->name() && mRunningStandalone ) {
    disconnect( tdeApp->dcopClient(), TQ_SIGNAL( applicationRemoved( const TQCString& ) ),
                this, TQ_SLOT( unregisteredFromDCOP( const TQCString& ) ) );
    kdDebug(5601) << k_funcinfo << appId << endl;
    mFactory->createHandler( mPlugin );
    tdeApp->dcopClient()->setNotifications( false );
    mRunningStandalone = false;
  }
}
 
static TDECmdLineOptions options[] =
{
    { "module <module>",   I18N_NOOP( "Start with a specific Kontact module" ), 0 },
    { "iconify",   I18N_NOOP( "Start in iconified (minimized) mode" ), 0 },
    { "list", I18N_NOOP( "List all possible modules and exit" ), 0 },
    { "listprofiles", I18N_NOOP( "List all possible profiles and exit" ), 0 },
    { "profile <profile>", I18N_NOOP( "Start with a specific Kontact profile" ), 0 },
    TDECmdLineLastOption
};
 
void Kontact::UniqueAppHandler::loadKontactCommandLineOptions()
{
  TDECmdLineArgs::addCmdLineOptions( options );
  TDEUniqueApplication::addCmdLineOptions();
  TDEApplication::addCmdLineOptions();
}
 
#include "uniqueapphandler.moc"