1*b1cdbd2cSJim Jagielski/************************************************************** 2*b1cdbd2cSJim Jagielski * 3*b1cdbd2cSJim Jagielski * Licensed to the Apache Software Foundation (ASF) under one 4*b1cdbd2cSJim Jagielski * or more contributor license agreements. See the NOTICE file 5*b1cdbd2cSJim Jagielski * distributed with this work for additional information 6*b1cdbd2cSJim Jagielski * regarding copyright ownership. The ASF licenses this file 7*b1cdbd2cSJim Jagielski * to you under the Apache License, Version 2.0 (the 8*b1cdbd2cSJim Jagielski * "License"); you may not use this file except in compliance 9*b1cdbd2cSJim Jagielski * with the License. You may obtain a copy of the License at 10*b1cdbd2cSJim Jagielski * 11*b1cdbd2cSJim Jagielski * http://www.apache.org/licenses/LICENSE-2.0 12*b1cdbd2cSJim Jagielski * 13*b1cdbd2cSJim Jagielski * Unless required by applicable law or agreed to in writing, 14*b1cdbd2cSJim Jagielski * software distributed under the License is distributed on an 15*b1cdbd2cSJim Jagielski * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 16*b1cdbd2cSJim Jagielski * KIND, either express or implied. See the License for the 17*b1cdbd2cSJim Jagielski * specific language governing permissions and limitations 18*b1cdbd2cSJim Jagielski * under the License. 19*b1cdbd2cSJim Jagielski * 20*b1cdbd2cSJim Jagielski *************************************************************/ 21*b1cdbd2cSJim Jagielski 22*b1cdbd2cSJim Jagielski 23*b1cdbd2cSJim Jagielski 24*b1cdbd2cSJim Jagielski 25*b1cdbd2cSJim Jagielski#include <com/sun/star/uno/XInterface.idl> 26*b1cdbd2cSJim Jagielski#include <com/sun/star/uno/Exception.idl> 27*b1cdbd2cSJim Jagielski 28*b1cdbd2cSJim Jagielskimodule com { module sun { module star { module container { 29*b1cdbd2cSJim Jagielskiinterface XEnumeration; 30*b1cdbd2cSJim Jagielski}; }; }; }; 31*b1cdbd2cSJim Jagielski 32*b1cdbd2cSJim Jagielskimodule com { module sun { module star { module task { 33*b1cdbd2cSJim Jagielskiinterface XInteractionHandler; 34*b1cdbd2cSJim Jagielski}; }; }; }; 35*b1cdbd2cSJim Jagielski 36*b1cdbd2cSJim Jagielskimodule com { module sun { module star { module xml { module dom { 37*b1cdbd2cSJim Jagielskiinterface XElement; 38*b1cdbd2cSJim Jagielski}; }; }; }; }; 39*b1cdbd2cSJim Jagielski 40*b1cdbd2cSJim Jagielskimodule com { module sun { module star { module deployment { 41*b1cdbd2cSJim Jagielski 42*b1cdbd2cSJim Jagielski/** Objects implementing this interface provide access to the xml root of 43*b1cdbd2cSJim Jagielski one or more update information files for a given set of URLs. 44*b1cdbd2cSJim Jagielski 45*b1cdbd2cSJim Jagielski @since OpenOffice 2.2 46*b1cdbd2cSJim Jagielski*/ 47*b1cdbd2cSJim Jagielskiinterface XUpdateInformationProvider 48*b1cdbd2cSJim Jagielski{ 49*b1cdbd2cSJim Jagielski /** get update information for a specific extension or all available 50*b1cdbd2cSJim Jagielski information from a repository. 51*b1cdbd2cSJim Jagielski 52*b1cdbd2cSJim Jagielski @param repositories 53*b1cdbd2cSJim Jagielski a repository and its mirrors. 54*b1cdbd2cSJim Jagielski @param extensionId 55*b1cdbd2cSJim Jagielski the unique identifier of an extension. If it is not empty and 56*b1cdbd2cSJim Jagielski the update document is an atom feed, only items whose 'term' 57*b1cdbd2cSJim Jagielski attribute of the atom:category tag matches extensionId are returned. 58*b1cdbd2cSJim Jagielski 59*b1cdbd2cSJim Jagielski */ 60*b1cdbd2cSJim Jagielski sequence < com::sun::star::xml::dom::XElement > getUpdateInformation( 61*b1cdbd2cSJim Jagielski [in] sequence< string > repositories, 62*b1cdbd2cSJim Jagielski [in] string extensionId 63*b1cdbd2cSJim Jagielski ) raises ( com::sun::star::uno::Exception ); 64*b1cdbd2cSJim Jagielski 65*b1cdbd2cSJim Jagielski /** interrupts a getUpdateInformation call and let's it return immediatly. 66*b1cdbd2cSJim Jagielski */ 67*b1cdbd2cSJim Jagielski void cancel(); 68*b1cdbd2cSJim Jagielski 69*b1cdbd2cSJim Jagielski /** Sets an interaction handler to be used for further operations. 70*b1cdbd2cSJim Jagielski 71*b1cdbd2cSJim Jagielski <p> 72*b1cdbd2cSJim Jagielski A default interaction handler is available as service 73*b1cdbd2cSJim Jagielski <type scope="com::sun::star::task">InteractionHandler</type>. 74*b1cdbd2cSJim Jagielski The documentation of this service also contains further 75*b1cdbd2cSJim Jagielski information about the interaction handler concept. 76*b1cdbd2cSJim Jagielski </p> 77*b1cdbd2cSJim Jagielski 78*b1cdbd2cSJim Jagielski @see com::sun::star::task::InteractionHandler 79*b1cdbd2cSJim Jagielski 80*b1cdbd2cSJim Jagielski @param handler 81*b1cdbd2cSJim Jagielski The interaction handler to be set 82*b1cdbd2cSJim Jagielski */ 83*b1cdbd2cSJim Jagielski void setInteractionHandler( [in] com::sun::star::task::XInteractionHandler handler ); 84*b1cdbd2cSJim Jagielski 85*b1cdbd2cSJim Jagielski /** get update information for a specific extension or all available 86*b1cdbd2cSJim Jagielski information from a repository. 87*b1cdbd2cSJim Jagielski 88*b1cdbd2cSJim Jagielski @param repositories 89*b1cdbd2cSJim Jagielski a repository and its mirrors. 90*b1cdbd2cSJim Jagielski @param extensionId 91*b1cdbd2cSJim Jagielski the unique identifier of an extension. If it is not empty and 92*b1cdbd2cSJim Jagielski the update document is an atom feed, only items whose 'term' 93*b1cdbd2cSJim Jagielski attribute of the atom:category tag matches extensionId are returned. 94*b1cdbd2cSJim Jagielski 95*b1cdbd2cSJim Jagielski @returns 96*b1cdbd2cSJim Jagielski an enumeration of <type>UpdateInformationEntry</type>. 97*b1cdbd2cSJim Jagielski */ 98*b1cdbd2cSJim Jagielski com::sun::star::container::XEnumeration getUpdateInformationEnumeration( 99*b1cdbd2cSJim Jagielski [in] sequence< string > repositories, 100*b1cdbd2cSJim Jagielski [in] string extensionId 101*b1cdbd2cSJim Jagielski ) raises ( com::sun::star::uno::Exception ); 102*b1cdbd2cSJim Jagielski}; 103*b1cdbd2cSJim Jagielski 104*b1cdbd2cSJim Jagielski}; }; }; }; 105*b1cdbd2cSJim Jagielski 106