From 7b79e23260db34f2bb0a2994a5e64dd39117228c Mon Sep 17 00:00:00 2001 From: Stephan Bergmann Date: Thu, 19 Jan 2017 17:52:02 +0100 Subject: New loplugin:dynexcspec: Add @throws documentation, scripting Change-Id: I3a3f8ad12bad448f0ea2beb698cf4e6636d4595a --- scripting/source/dlgprov/dlgevtatt.hxx | 1 + scripting/source/dlgprov/dlgprov.hxx | 5 +++++ scripting/source/protocolhandler/scripthandler.hxx | 1 + scripting/source/provider/BrowseNodeFactoryImpl.hxx | 1 + scripting/source/provider/MasterScriptProvider.hxx | 1 + scripting/source/provider/ProviderCache.hxx | 5 +++++ scripting/source/provider/URIHelper.hxx | 2 +- scripting/source/stringresource/stringresource.hxx | 16 ++++++++++++++++ scripting/source/vbaevents/eventhelper.cxx | 1 + 9 files changed, 32 insertions(+), 1 deletion(-) (limited to 'scripting/source') diff --git a/scripting/source/dlgprov/dlgevtatt.hxx b/scripting/source/dlgprov/dlgevtatt.hxx index 46cef1442634..34a2d9a888aa 100644 --- a/scripting/source/dlgprov/dlgevtatt.hxx +++ b/scripting/source/dlgprov/dlgevtatt.hxx @@ -52,6 +52,7 @@ namespace dlgprov ListenerHash listenersForTypes; css::uno::Reference< css::uno::XComponentContext > m_xContext; css::uno::Reference< css::script::XEventAttacher > m_xEventAttacher; + /// @throws css::uno::RuntimeException css::uno::Reference< css::script::XScriptListener > getScriptListenerForKey( const OUString& sScriptName ) throw ( css::uno::RuntimeException ); css::uno::Reference< css::script::XScriptEventsSupplier > getFakeVbaEventsSupplier( const css::uno::Reference< css::awt::XControl>& xControl, OUString& sCodeName ); void nestedAttachEvents( const css::uno::Sequence< css::uno::Reference< css::uno::XInterface > >& Objects, const css::uno::Any& Helper, OUString& sDialogCodeName ); diff --git a/scripting/source/dlgprov/dlgprov.hxx b/scripting/source/dlgprov/dlgprov.hxx index f88d0c08e895..b554e531aa38 100644 --- a/scripting/source/dlgprov/dlgprov.hxx +++ b/scripting/source/dlgprov/dlgprov.hxx @@ -54,6 +54,7 @@ namespace dlgprov css::uno::Reference< css::container::XNameContainer > lcl_createControlModel(const css::uno::Reference< css::uno::XComponentContext >& i_xContext); css::uno::Reference< css::resource::XStringResourceManager > lcl_getStringResourceManager(const css::uno::Reference< css::uno::XComponentContext >& i_xContext,const OUString& i_sURL); + /// @throws css::uno::Exception css::uno::Reference< css::container::XNameContainer > lcl_createDialogModel( const css::uno::Reference< css::uno::XComponentContext >& i_xContext, const css::uno::Reference< css::io::XInputStream >& xInput, @@ -94,13 +95,17 @@ namespace dlgprov css::uno::Reference< css::beans::XIntrospectionAccess > inspectHandler( const css::uno::Reference< css::uno::XInterface >& rxHandler ); // helper methods + /// @throws css::uno::Exception css::uno::Reference< css::container::XNameContainer > createDialogModel( const css::uno::Reference< css::io::XInputStream >& xInput, const css::uno::Reference< css::resource::XStringResourceManager >& xStringResourceManager, const css::uno::Any &aDialogSourceURL) throw ( css::uno::Exception ); + /// @throws css::uno::Exception css::uno::Reference< css::awt::XControlModel > createDialogModelForBasic() throw ( css::uno::Exception ); // XDialogProvider / XDialogProvider2 impl method + /// @throws css::lang::IllegalArgumentException + /// @throws css::uno::RuntimeException css::uno::Reference < css::awt::XControl > SAL_CALL createDialogImpl( const OUString& URL, const css::uno::Reference< css::uno::XInterface >& xHandler, diff --git a/scripting/source/protocolhandler/scripthandler.hxx b/scripting/source/protocolhandler/scripthandler.hxx index b550e1c2218d..70fe12843040 100644 --- a/scripting/source/protocolhandler/scripthandler.hxx +++ b/scripting/source/protocolhandler/scripthandler.hxx @@ -91,6 +91,7 @@ public: static OUString impl_getStaticImplementationName(); /* Helper for registry */ + /// @throws css::uno::RuntimeException static css::uno::Reference < css::uno::XInterface > SAL_CALL impl_createInstance( const css::uno::Reference< css::lang::XMultiServiceFactory >& xServiceManager ) diff --git a/scripting/source/provider/BrowseNodeFactoryImpl.hxx b/scripting/source/provider/BrowseNodeFactoryImpl.hxx index 3a87e2d3dee7..db5f4a8ef233 100644 --- a/scripting/source/provider/BrowseNodeFactoryImpl.hxx +++ b/scripting/source/provider/BrowseNodeFactoryImpl.hxx @@ -67,6 +67,7 @@ public: createView( sal_Int16 viewType ) throw ( css::uno::RuntimeException, std::exception ) override; private: + /// @throws css::uno::RuntimeException css::uno::Reference< css::script::browse::XBrowseNode > getOrganizerHierarchy() throw ( css::uno::RuntimeException ); diff --git a/scripting/source/provider/MasterScriptProvider.hxx b/scripting/source/provider/MasterScriptProvider.hxx index 989441a8403c..47ba9689ac8d 100644 --- a/scripting/source/provider/MasterScriptProvider.hxx +++ b/scripting/source/provider/MasterScriptProvider.hxx @@ -49,6 +49,7 @@ class MasterScriptProvider : public t_helper { public: + /// @throws css::uno::RuntimeException explicit MasterScriptProvider( const css::uno::Reference< css::uno::XComponentContext > & xContext ) throw( css::uno::RuntimeException ); diff --git a/scripting/source/provider/ProviderCache.hxx b/scripting/source/provider/ProviderCache.hxx index af244796dc40..967f50cef269 100644 --- a/scripting/source/provider/ProviderCache.hxx +++ b/scripting/source/provider/ProviderCache.hxx @@ -52,20 +52,25 @@ class ProviderCache { public: + /// @throws css::uno::RuntimeException ProviderCache( const css::uno::Reference< css::uno::XComponentContext >& xContext, const css::uno::Sequence< css::uno::Any >& scriptContext ) throw ( css::uno::RuntimeException ); + /// @throws css::uno::RuntimeException ProviderCache( const css::uno::Reference< css::uno::XComponentContext >& xContext, const css::uno::Sequence< css::uno::Any >& scriptContext, const css::uno::Sequence< OUString >& blackList ) throw ( css::uno::RuntimeException ); ~ProviderCache(); css::uno::Reference< css::script::provider::XScriptProvider > getProvider( const OUString& providerName ); + /// @throws css::uno::RuntimeException css::uno::Sequence < css::uno::Reference< css::script::provider::XScriptProvider > > getAllProviders() throw ( css::uno::RuntimeException ); private: + /// @throws css::uno::RuntimeException void populateCache() throw ( css::uno::RuntimeException ); + /// @throws css::uno::RuntimeException css::uno::Reference< css::script::provider::XScriptProvider > createProvider( ProviderDetails& details ) throw ( css::uno::RuntimeException ); bool isInBlackList( const OUString& serviceName ) diff --git a/scripting/source/provider/URIHelper.hxx b/scripting/source/provider/URIHelper.hxx index e23e840b0847..5cd5a3c7e47d 100644 --- a/scripting/source/provider/URIHelper.hxx +++ b/scripting/source/provider/URIHelper.hxx @@ -56,7 +56,7 @@ private: static OUString getLanguagePath(const OUString& rLanguagePart); public: - + /// @throws css::uno::RuntimeException explicit ScriptingFrameworkURIHelper( const css::uno::Reference< css::uno::XComponentContext >& xContext ) throw( css::uno::RuntimeException ); diff --git a/scripting/source/stringresource/stringresource.hxx b/scripting/source/stringresource/stringresource.hxx index f3050b0aecd6..b67403937217 100644 --- a/scripting/source/stringresource/stringresource.hxx +++ b/scripting/source/stringresource/stringresource.hxx @@ -117,17 +117,21 @@ protected: const static sal_Int32 UNIQUE_NUMBER_NEEDS_INITIALISATION = -1; // Checks read only status and throws exception if it's true + /// @throws css::lang::NoSupportException void implCheckReadOnly( const sal_Char* pExceptionMsg ) throw (css::lang::NoSupportException); // Returns the LocalItem for a given locale, if it exists, otherwise NULL // This method compares the locales exactly, no closest match search is performed + /// @throws css::lang::IllegalArgumentException LocaleItem* getItemForLocale( const css::lang::Locale& locale, bool bException ) throw (css::lang::IllegalArgumentException); // Returns the LocalItem for a given locale, if it exists, otherwise NULL // This method performs a closest match search, at least the language must match LocaleItem* getClosestMatchItemForLocale( const css::lang::Locale& locale ); + /// @throws css::lang::IllegalArgumentException + /// @throws css::uno::RuntimeException void implSetCurrentLocale( const css::lang::Locale& locale, bool FindClosestMatch, bool bUseDefaultIfNoMatch ) throw (css::lang::IllegalArgumentException, css::uno::RuntimeException); @@ -136,12 +140,14 @@ protected: void implNotifyListeners(); //=== Impl methods for ...ForLocale methods === + /// @throws css::resource::MissingResourceException OUString SAL_CALL implResolveString( const OUString& ResourceID, LocaleItem* pLocaleItem ) throw (css::resource::MissingResourceException); bool implHasEntryForId( const OUString& ResourceID, LocaleItem* pLocaleItem ); css::uno::Sequence< OUString > implGetResourceIDs( LocaleItem* pLocaleItem ); void implSetString( const OUString& ResourceID, const OUString& Str, LocaleItem* pLocaleItem ); + /// @throws css::resource::MissingResourceException void implRemoveId( const OUString& ResourceID, LocaleItem* pLocaleItem ) throw (css::resource::MissingResourceException); @@ -237,6 +243,8 @@ protected: OUString m_aNameBase; OUString m_aComment; + /// @throws css::uno::Exception + /// @throws css::uno::RuntimeException void SAL_CALL implInitializeCommonParameters( const css::uno::Sequence< css::uno::Any >& aArguments ) throw (css::uno::Exception, css::uno::RuntimeException); @@ -265,6 +273,8 @@ protected: void implWriteLocaleBinary( LocaleItem* pLocaleItem, BinaryOutput& rOut ); + /// @throws css::uno::Exception + /// @throws css::uno::RuntimeException void implStoreAtStorage ( const OUString& aNameBase, @@ -275,6 +285,8 @@ protected: ) throw (css::uno::Exception, css::uno::RuntimeException, std::exception); + /// @throws css::uno::Exception + /// @throws css::uno::RuntimeException void implKillRemovedLocaleFiles ( const OUString& Location, @@ -283,6 +295,8 @@ protected: ) throw (css::uno::Exception, css::uno::RuntimeException, std::exception); + /// @throws css::uno::Exception + /// @throws css::uno::RuntimeException void implKillChangedDefaultFiles ( const OUString& Location, @@ -291,6 +305,8 @@ protected: ) throw (css::uno::Exception, css::uno::RuntimeException, std::exception); + /// @throws css::uno::Exception + /// @throws css::uno::RuntimeException void implStoreAtLocation ( const OUString& Location, diff --git a/scripting/source/vbaevents/eventhelper.cxx b/scripting/source/vbaevents/eventhelper.cxx index b7fc4b530718..017bc3999e11 100644 --- a/scripting/source/vbaevents/eventhelper.cxx +++ b/scripting/source/vbaevents/eventhelper.cxx @@ -620,6 +620,7 @@ protected: private: void setShellFromModel(); + /// @throws RuntimeException void firing_Impl( const ScriptEvent& evt, Any *pSyncRet ) throw( RuntimeException, std::exception ); Reference< frame::XModel > m_xModel; -- cgit