1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
|
/*************************************************************************
*
* $RCSfile: Package.idl,v $
*
* $Revision: 1.5 $
*
* last change: $Author: hr $ $Date: 2003-03-26 13:54:44 $
*
* 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): Martin Gallwey (gallwey@sun.com)
*
*
************************************************************************/
#ifndef __com_sun_star_packages_Package_idl__
#define __com_sun_star_packages_Package_idl__
#ifndef __com_sun_star_lang_XInitialization_idl__
#include <com/sun/star/lang/XInitialization.idl>
#endif
#ifndef __com_sun_star_container_XHierarchicalNameAccess_idl__
#include <com/sun/star/container/XHierarchicalNameAccess.idl>
#endif
#ifndef __com_sun_star_lang_XSingleServiceFactory_idl__
#include <com/sun/star/lang/XSingleServiceFactory.idl>
#endif
#ifndef __com_sun_star_util_XChangesBatch_idl__
#include <com/sun/star/util/XChangesBatch.idl>
#endif
//=============================================================================
module com { module sun { module star { module packages {
//=============================================================================
/** The <type>Package</type> is a service that provides access to a set of
files and folders contained within a Package. One instance of the
Package service exists for each Package file to be manipulated.
Each instance is created with an argument which specifies the URL of
the Package file to which the user requires access. If the instance is
created without arguments, it must be initialised with the
<type scope="com::sun::star::lang">XInitialization</type> service methods
before it is a valid instance of the service.
*/
service Package
{
/**
A Package can be initialised with one of the following:
1. A file URL referring to a package.
2. An XInputStream referring to a package (it must also
support an XSeekable interface).
3. An XStream referring to a package. The XInputStream must support
an XSeekable interface, and the XOutputStream must support an
XTruncate interface.
It will throw a css::uno::Exception if initialised with bad data or
if the package has an invalid format (for example, a corrupt central d
irectory record if the file is a ZIP file).
*/
interface com::sun::star::lang::XInitialization;
/**
This interface is used to get access to any entry within the package
For example:
getByHierarchicalName ("folder/subfolder/file1.txt");
This will return a PackageStream which refers to the specified stream.
This is also used to get access to a particular folder within the
Package. For example:
getByHierarchicalName ("folder/subfolder/");
This will return a PackageFolder which describes the contents of the specified
folder.
Calls to methods of XHierarchicalNameAccess must NOT have a leading slash.
*/
interface com::sun::star::container::XHierarchicalNameAccess;
/**
This interface is used to create new PackageStream or PackageFolder
implementation objects for addition to the Package.
createInstance - creates a new stream implementation object (when first
created, the new object is not part of the Package). It must be added
to the PackageFolder in which it will reside using the methods in the
PackageFolder service.
createInstanceWithArguments - This accepts one boolean value as an
argument. If it set to true, a PackageFolder implementation is created,
if it is set to false, a PackageStream implementation is created.
Creating and inserting a new stream would be done as follows:
1. xNewStream = package->createInstanceWithArguments( false );
2. xDataStream = new MyStreamImpl(). (wherever the data comes from)
3. xNewStream->setInputStream( xDataStream );
4. parentFolder->insertByName( "image.png", xNewStream );
Replacing an existing stream would be very similar, except that the
call ->insertByName would be replaced by ->replaceByName.
*/
interface com::sun::star::lang::XSingleServiceFactory;
/**
This interface is used to commit any changes to the Package. A new
Package file will be written with any new or changed streams/folders and
omitting any PackageStream or PackageFolder that has been removed.
*/
interface com::sun::star::util::XChangesBatch;
};
}; }; }; };
#endif
|
