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
161
162
163
164
165
166
167
168
169
170
171
172
|
/*************************************************************************
*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* Copyright 2000, 2010 Oracle and/or its affiliates.
*
* OpenOffice.org - a multi-platform office productivity suite
*
* 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 OOX_HELPER_STORAGEBASE_HXX
#define OOX_HELPER_STORAGEBASE_HXX
#include <vector>
#include <map>
#include <boost/shared_ptr.hpp>
#include <rtl/ustring.hxx>
#include <com/sun/star/uno/Reference.hxx>
#include <oox/dllapi.h>
namespace com { namespace sun { namespace star {
namespace embed { class XStorage; }
namespace io { class XInputStream; }
namespace io { class XOutputStream; }
namespace io { class XStream; }
} } }
namespace oox {
// ============================================================================
class StorageBase;
typedef ::boost::shared_ptr< StorageBase > StorageRef;
/** Base class for storage access implementations.
Derived classes will be used to encapsulate storage access implementations
for ZIP storages containing XML streams, and OLE storages containing binary
data streams.
*/
class OOX_DLLPUBLIC StorageBase
{
public:
explicit StorageBase(
const ::com::sun::star::uno::Reference< ::com::sun::star::io::XInputStream >& rxInStream,
bool bBaseStreamAccess );
explicit StorageBase(
const ::com::sun::star::uno::Reference< ::com::sun::star::io::XStream >& rxOutStream,
bool bBaseStreamAccess );
virtual ~StorageBase();
/** Returns true, if the object represents a valid storage. */
bool isStorage() const;
/** Returns the com.sun.star.embed.XStorage interface of the current storage. */
::com::sun::star::uno::Reference< ::com::sun::star::embed::XStorage >
getXStorage() const;
/** Returns the element name of this storage. */
const ::rtl::OUString& getName() const;
/** Returns the full path of this storage. */
::rtl::OUString getPath() const;
/** Fills the passed vector with the names of all elements of this storage. */
void getElementNames( ::std::vector< ::rtl::OUString >& orElementNames ) const;
/** Opens and returns the specified sub storage from the storage.
@param rStorageName
The name of the embedded storage. The name may contain slashes to
open storages from embedded substorages.
@param bCreate
True = create missing sub storages (for export filters).
*/
StorageRef openSubStorage( const ::rtl::OUString& rStorageName, bool bCreate );
/** Opens and returns the specified input stream from the storage.
@param rStreamName
The name of the embedded storage stream. The name may contain
slashes to open streams from embedded substorages. If base stream
access has been enabled in the constructor, the base stream can be
accessed by passing an empty string as stream name.
*/
::com::sun::star::uno::Reference< ::com::sun::star::io::XInputStream >
openInputStream( const ::rtl::OUString& rStreamName );
/** Opens and returns the specified output stream from the storage.
@param rStreamName
The name of the embedded storage stream. The name may contain
slashes to create and open streams in embedded substorages. If base
stream access has been enabled in the constructor, the base stream
can be accessed by passing an empty string as stream name.
*/
::com::sun::star::uno::Reference< ::com::sun::star::io::XOutputStream >
openOutputStream( const ::rtl::OUString& rStreamName );
/** Commits the changes to the storage and all the substorages. (in case it is transacted object)
*/
void commit();
protected:
/** Special constructor for sub storage objects. */
explicit StorageBase( const StorageBase& rParentStorage, const ::rtl::OUString& rStorageName );
private:
StorageBase( const StorageBase& );
StorageBase& operator=( const StorageBase& );
/** Returns true, if the object represents a valid storage. */
virtual bool implIsStorage() const = 0;
/** Returns the com.sun.star.embed.XStorage interface of the current storage. */
virtual ::com::sun::star::uno::Reference< ::com::sun::star::embed::XStorage >
implGetXStorage() const = 0;
/** Returns the names of all elements of this storage. */
virtual void implGetElementNames( ::std::vector< ::rtl::OUString >& orElementNames ) const = 0;
/** Implementation of opening a storage element. */
virtual StorageRef implOpenSubStorage( const ::rtl::OUString& rElementName, bool bCreate ) = 0;
/** Implementation of opening an input stream element. */
virtual ::com::sun::star::uno::Reference< ::com::sun::star::io::XInputStream >
implOpenInputStream( const ::rtl::OUString& rElementName ) = 0;
/** Implementation of opening an output stream element. */
virtual ::com::sun::star::uno::Reference< ::com::sun::star::io::XOutputStream >
implOpenOutputStream( const ::rtl::OUString& rElementName ) = 0;
StorageRef getSubStorage( const ::rtl::OUString& rElementName, bool bCreate );
private:
typedef ::std::map< ::rtl::OUString, StorageRef > SubStorageMap;
typedef ::com::sun::star::uno::Reference< ::com::sun::star::io::XInputStream > XInputStreamRef;
typedef ::com::sun::star::uno::Reference< ::com::sun::star::io::XStream > XStreamRef;
SubStorageMap maSubStorages; /// Map of direct sub storages.
XInputStreamRef mxInStream; /// Cached base input stream (to keep it alive).
XStreamRef mxOutStream; /// Cached base output stream (to keep it alive).
::rtl::OUString maStorageName; /// Name of this storage, if it is a substorage.
const StorageBase* mpParentStorage; /// Parent storage if this is a sub storage.
bool mbBaseStreamAccess; /// True = access base streams with empty stream name.
};
// ============================================================================
} // namespace oox
#endif
|
