diff options
Diffstat (limited to 'forms/source/xforms/model.hxx')
-rw-r--r-- | forms/source/xforms/model.hxx | 438 |
1 files changed, 438 insertions, 0 deletions
diff --git a/forms/source/xforms/model.hxx b/forms/source/xforms/model.hxx new file mode 100644 index 000000000000..5dc19c7aadf3 --- /dev/null +++ b/forms/source/xforms/model.hxx @@ -0,0 +1,438 @@ +/************************************************************************* + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2008 by Sun Microsystems, Inc. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * $RCSfile: model.hxx,v $ + * $Revision: 1.6 $ + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org 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 version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************/ + +#ifndef _MODEL_HXX +#define _MODEL_HXX + + +// include for parent class(es) +#include <cppuhelper/implbase4.hxx> +#include <propertysetbase.hxx> +#include <com/sun/star/xforms/XModel.hpp> +#include <com/sun/star/xforms/XFormsUIHelper1.hpp> +#include <com/sun/star/util/XUpdatable.hpp> +#include <com/sun/star/lang/XUnoTunnel.hpp> + + +// includes for member variables +#include <com/sun/star/uno/Reference.hxx> +#include <map> + + +// forward declaractions +namespace com { namespace sun { namespace star +{ + namespace xml { namespace dom { class XDocument; } } + namespace xml { namespace dom { class XNode; } } + namespace uno { template<typename T> class Sequence; } + namespace lang { class IndexOutOfBoundsException; } + namespace lang { class IllegalArgumentException; } + namespace beans { class XPropertySet; } + namespace container { class XSet; } + namespace container { class XNameContainer; } + namespace frame { class XModel; } +} } } +namespace rtl { class OUString; } +namespace xforms +{ + class Binding; + class MIP; + class BindingCollection; + class SubmissionCollection; + class InstanceCollection; + class EvaluationContext; +} + + +namespace xforms +{ + +/** An XForms Model. Contains: + * # (set of) instance data (XML DOM tree) + * # (set of) bindings + * # (set of) submissions + * # (NOT YET IMPLEMENTED) actions (set of) + * + * See http://www.w3.org/TR/xforms/ for more information. + */ +typedef cppu::ImplInheritanceHelper4< + PropertySetBase, + com::sun::star::xforms::XModel, + com::sun::star::xforms::XFormsUIHelper1, + com::sun::star::util::XUpdatable, + com::sun::star::lang::XUnoTunnel +> Model_t; +class Model : public Model_t +{ + // a number of local typedefs, to make the remaining header readable + typedef com::sun::star::uno::Reference<com::sun::star::xml::dom::XDocument> XDocument_t; + typedef com::sun::star::uno::Reference<com::sun::star::xml::dom::XNode> XNode_t; + typedef com::sun::star::lang::IndexOutOfBoundsException IndexOutOfBoundsException_t; + typedef com::sun::star::lang::IllegalArgumentException IllegalArgumentException_t; + typedef com::sun::star::uno::Reference<com::sun::star::beans::XPropertySet> XPropertySet_t; + typedef com::sun::star::uno::Reference<com::sun::star::xforms::XDataTypeRepository> XDataTypeRepository_t; + typedef com::sun::star::uno::Reference<com::sun::star::container::XNameContainer> XNameContainer_t; + typedef com::sun::star::uno::Reference<com::sun::star::xforms::XSubmission> XSubmission_t; + typedef com::sun::star::uno::Reference<com::sun::star::frame::XModel> Frame_XModel_t; + typedef com::sun::star::uno::Reference<com::sun::star::xforms::XModel> XModel_t; + typedef com::sun::star::uno::Reference<com::sun::star::task::XInteractionHandler> XInteractionHandler_t; + + typedef com::sun::star::uno::Reference<com::sun::star::container::XSet> XSet_t; + typedef com::sun::star::beans::PropertyVetoException PropertyVetoException_t; + typedef com::sun::star::beans::UnknownPropertyException UnknownPropertyException_t; + typedef com::sun::star::util::VetoException VetoException_t; + typedef com::sun::star::lang::WrappedTargetException WrappedTargetException_t; + typedef com::sun::star::uno::RuntimeException RuntimeException_t; + typedef com::sun::star::uno::Any Any_t; + typedef com::sun::star::uno::Sequence<sal_Int8> IntSequence_t; + typedef std::multimap<XNode_t,std::pair<void*,MIP> > MIPs_t; + + +private: + + rtl::OUString msID; /// the model ID + BindingCollection* mpBindings; /// the bindings + SubmissionCollection* mpSubmissions; /// the submissions + InstanceCollection* mpInstances; /// the instance(s) + + XDataTypeRepository_t mxDataTypes; /// the XSD data-types used + XDocument_t mxForeignSchema; /// the XSD-schema part we cannot + /// map onto data types + rtl::OUString msSchemaRef; /// xforms:model/@schema attribute + + XNameContainer_t mxNamespaces; /// namespaces for entire model + + + // references to mpBindings/mpSubmissions, for UNO reference counting + XSet_t mxBindings; + XSet_t mxSubmissions; + XSet_t mxInstances; + + MIPs_t maMIPs; /// map nodes to their MIPs + + bool mbInitialized; /// has model been initialized ? + bool mbExternalData; /// is the data of this model to be considered an ingegral part of the document? + + void initializePropertySet(); + + void ensureAtLeastOneInstance(); + + +public: + + /// create a new model with an empty, default instance + Model(); + virtual ~Model() throw(); + + // get Model implementation from API object + static Model* getModel( const com::sun::star::uno::Reference<com::sun::star::xforms::XModel>& ); + + xforms::EvaluationContext getEvaluationContext(); + + + static IntSequence_t getUnoTunnelID(); + + + // get/set that part of the schema, that we can't interpret as data types + XDocument_t getForeignSchema() const; + void setForeignSchema( const XDocument_t& ); + + // get/set the xforms:model/@schema attribute + rtl::OUString getSchemaRef() const; + void setSchemaRef( const rtl::OUString& ); + + // get/set namespaces for entire model + XNameContainer_t getNamespaces() const; + void setNamespaces( const XNameContainer_t& ); + + // get/set the ExternalData property + bool getExternalData() const; + void setExternalData( bool _bData ); + + +#if OSL_DEBUG_LEVEL > 1 + void dbg_assertInvariant() const; +#endif + + + // + // MIP (model item property) management + // + + // register MIPs which apply to a given node; only to be called by bindings + // (The pTag parameter serves only to be able to remove the MIPs + // that were added using the same tag. No functions will be + // performed on it; hence the void* type.) + void addMIP( void* pTag, const XNode_t&, const MIP& ); + void removeMIPs( void* pTag ); + + /// query which MIPs appy to the given node + MIP queryMIP( const XNode_t& xNode ) const; + + /// re-bind all bindings + void rebind(); + + /// call defer notifications on all bindings + void deferNotifications( bool ); + + /// set a data value in the instance + /// (also defers notifications) + bool setSimpleContent( const XNode_t&, const rtl::OUString& ); + + /// load instance data + void loadInstance( sal_Int32 nInstance ); + void loadInstances(); + + /// has model been initialized? + bool isInitialized() const; + + /// is model currently valid (for submission)? + bool isValid() const; + + + + // + // XModel + // implement the xforms::XModel implementation + // + + + virtual rtl::OUString SAL_CALL getID() + throw( RuntimeException_t ); + + virtual void SAL_CALL setID( const rtl::OUString& sID ) + throw( RuntimeException_t ); + + virtual void SAL_CALL initialize() + throw( RuntimeException_t ); + + virtual void SAL_CALL rebuild() + throw( RuntimeException_t ); + + virtual void SAL_CALL recalculate() + throw( RuntimeException_t ); + + virtual void SAL_CALL revalidate() + throw( RuntimeException_t ); + + virtual void SAL_CALL refresh() + throw( RuntimeException_t ); + + virtual void SAL_CALL submit( const rtl::OUString& sID ) + throw( VetoException_t, WrappedTargetException_t, RuntimeException_t ); + + virtual void SAL_CALL submitWithInteraction( const ::rtl::OUString& id, const XInteractionHandler_t& _rxHandler ) + throw( VetoException_t, WrappedTargetException_t, RuntimeException_t ); + + virtual XDataTypeRepository_t SAL_CALL getDataTypeRepository( ) + throw( RuntimeException_t ); + + + // XModel: instance management + + virtual XSet_t SAL_CALL getInstances() + throw( RuntimeException_t ); + + virtual XDocument_t SAL_CALL getInstanceDocument( const rtl::OUString& ) + throw( RuntimeException_t ); + + virtual XDocument_t SAL_CALL getDefaultInstance() + throw( RuntimeException_t ); + + + + // XModel: binding management + + virtual XPropertySet_t SAL_CALL createBinding() + throw( RuntimeException_t ); + + virtual XPropertySet_t SAL_CALL cloneBinding( const XPropertySet_t& ) + throw( RuntimeException_t ); + + virtual XPropertySet_t SAL_CALL getBinding( const rtl::OUString& ) + throw( RuntimeException_t ); + + virtual XSet_t SAL_CALL getBindings() + throw( RuntimeException_t ); + + + // XModel: submission management + + virtual XSubmission_t SAL_CALL createSubmission() + throw( RuntimeException_t ); + + virtual XSubmission_t SAL_CALL cloneSubmission( const XPropertySet_t& ) + throw( RuntimeException_t ); + + virtual XSubmission_t SAL_CALL getSubmission( const rtl::OUString& ) + throw( RuntimeException_t ); + + virtual XSet_t SAL_CALL getSubmissions() + throw( RuntimeException_t ); + + + + // + // XFormsUIHelper1 & friends: + // (implementation in model_ui.cxx) + // + + /// determine a reasonable control service for a given node + /// (based on data type MIP assigned to the node) + virtual rtl::OUString SAL_CALL getDefaultServiceNameForNode( const XNode_t& xNode ) throw (RuntimeException_t); + + /// call getDefaultBindingExpressionForNode with default evaluation context + virtual rtl::OUString SAL_CALL getDefaultBindingExpressionForNode( const XNode_t& xNode ) throw (RuntimeException_t); + + /// determine a reasonable default binding expression for a given node + /// and a given evaluation context + /// @returns expression, or empty string if no expression could be derived + rtl::OUString getDefaultBindingExpressionForNode( + const XNode_t&, + const EvaluationContext& ); + + virtual rtl::OUString SAL_CALL getNodeDisplayName( const XNode_t&, + sal_Bool bDetail ) + throw( RuntimeException_t ); + + virtual rtl::OUString SAL_CALL getNodeName( const XNode_t& ) + throw( RuntimeException_t ); + + virtual rtl::OUString SAL_CALL getBindingName( const XPropertySet_t&, + sal_Bool bDetail ) + throw( RuntimeException_t ); + + virtual rtl::OUString SAL_CALL getSubmissionName( const XPropertySet_t&, + sal_Bool bDetail ) + throw( RuntimeException_t ); + + virtual XPropertySet_t SAL_CALL cloneBindingAsGhost( const XPropertySet_t& ) + throw( RuntimeException_t ); + + virtual void SAL_CALL removeBindingIfUseless( const XPropertySet_t& ) + throw( RuntimeException_t ); + + virtual XDocument_t SAL_CALL newInstance( const rtl::OUString& sName, + const rtl::OUString& sURL, + sal_Bool bURLOnce ) + throw( RuntimeException_t ); + + virtual void SAL_CALL renameInstance( const rtl::OUString& sFrom, + const rtl::OUString& sTo, + const rtl::OUString& sURL, + sal_Bool bURLOnce ) + throw( RuntimeException_t ); + + virtual void SAL_CALL removeInstance( const rtl::OUString& sName ) + throw( RuntimeException_t ); + + + virtual XModel_t SAL_CALL newModel( const Frame_XModel_t& xComponent, + const rtl::OUString& sName ) + throw( RuntimeException_t ); + virtual void SAL_CALL renameModel( const Frame_XModel_t& xComponent, + const rtl::OUString& sFrom, + const rtl::OUString& sTo ) + throw( RuntimeException_t ); + + virtual void SAL_CALL removeModel( const Frame_XModel_t& xComponent, + const rtl::OUString& sName ) + throw( RuntimeException_t ); + + + virtual XNode_t SAL_CALL createElement( const XNode_t& xParent, + const rtl::OUString& sName ) + throw( RuntimeException_t ); + + virtual XNode_t SAL_CALL createAttribute( const XNode_t& xParent, + const rtl::OUString& sName ) + throw( RuntimeException_t ); + + virtual XNode_t SAL_CALL renameNode( const XNode_t& xNode, + const rtl::OUString& sName ) + throw( RuntimeException_t ); + + virtual XPropertySet_t SAL_CALL getBindingForNode( const XNode_t&, + sal_Bool bCreate ) + throw( RuntimeException_t ); + + virtual void SAL_CALL removeBindingForNode( const XNode_t& ) + throw( RuntimeException_t ); + + virtual rtl::OUString SAL_CALL getResultForExpression( + const XPropertySet_t& xBinding, + sal_Bool bIsBindingExpression, + const rtl::OUString& sExpression ) + throw( RuntimeException_t ); + + virtual sal_Bool SAL_CALL isValidXMLName( const rtl::OUString& sName ) + throw( RuntimeException_t ); + + virtual sal_Bool SAL_CALL isValidPrefixName( const rtl::OUString& sName ) + throw( RuntimeException_t ); + + virtual void SAL_CALL setNodeValue( + const XNode_t& xNode, + const rtl::OUString& sValue ) + throw( RuntimeException_t ); + + + // + // XUpdatable + // + +public: + virtual void SAL_CALL update() + throw( RuntimeException_t ); + + // + // XUnoTunnel + // + +public: + virtual sal_Int64 SAL_CALL getSomething( const IntSequence_t& ) + throw( RuntimeException_t ); + + // + // XTypeProvider::getImplementationId + // + +public: + virtual IntSequence_t SAL_CALL getImplementationId() + throw( RuntimeException_t ); + +}; + +// finally, allow 'shifting' of Model objects into/out of Any +void operator <<= ( com::sun::star::uno::Any&, const xforms::Model* ); +bool operator >>= ( xforms::Model*, const com::sun::star::uno::Any& ); + +} // namespace +#endif |