Coverage Report

Created: 2025-11-16 09:57

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/libreoffice/ucb/source/ucp/tdoc/tdoc_content.hxx
Line
Count
Source
1
/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
2
/*
3
 * This file is part of the LibreOffice project.
4
 *
5
 * This Source Code Form is subject to the terms of the Mozilla Public
6
 * License, v. 2.0. If a copy of the MPL was not distributed with this
7
 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
8
 *
9
 * This file incorporates work covered by the following license notice:
10
 *
11
 *   Licensed to the Apache Software Foundation (ASF) under one or more
12
 *   contributor license agreements. See the NOTICE file distributed
13
 *   with this work for additional information regarding copyright
14
 *   ownership. The ASF licenses this file to you under the Apache
15
 *   License, Version 2.0 (the "License"); you may not use this file
16
 *   except in compliance with the License. You may obtain a copy of
17
 *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
18
 */
19
20
#pragma once
21
22
#include <sal/config.h>
23
24
#include <string_view>
25
26
#include <ucbhelper/contenthelper.hxx>
27
#include <com/sun/star/ucb/XContentCreator.hpp>
28
#include <utility>
29
#include "tdoc_provider.hxx"
30
31
namespace com::sun::star {
32
    namespace sdbc  { class XRow; }
33
    namespace io    { class XInputStream; class XOutputStream; }
34
    namespace beans { struct PropertyValue; }
35
    namespace ucb   { struct OpenCommandArgument2; struct TransferInfo;
36
                      struct ContentInfo; }
37
}
38
39
namespace tdoc_ucp
40
{
41
42
43
enum ContentType { STREAM, FOLDER, DOCUMENT, ROOT };
44
45
class ContentProperties
46
{
47
public:
48
    ContentProperties()
49
3.78k
    : m_eType( STREAM )
50
3.78k
    {}
51
52
    ContentProperties( const ContentType & rType, OUString aTitle )
53
0
    : m_eType( rType ),
54
0
      m_aContentType( rType == STREAM
55
0
        ? TDOC_STREAM_CONTENT_TYPE
56
0
        : rType == FOLDER
57
0
            ? TDOC_FOLDER_CONTENT_TYPE
58
0
            : rType == DOCUMENT
59
0
                ? TDOC_DOCUMENT_CONTENT_TYPE
60
0
                : TDOC_ROOT_CONTENT_TYPE ),
61
0
      m_aTitle(std::move( aTitle ))
62
0
    {}
63
64
0
    ContentType getType() const { return m_eType; }
65
66
    // Properties
67
68
0
    const OUString & getContentType() const { return m_aContentType; }
69
70
0
    bool getIsFolder()   const { return m_eType > STREAM; }
71
0
    bool getIsDocument() const { return !getIsFolder(); }
72
73
0
    const OUString & getTitle() const { return m_aTitle; }
74
0
    void setTitle( const OUString & rTitle ) { m_aTitle = rTitle; }
75
76
    css::uno::Sequence< css::ucb::ContentInfo >
77
    getCreatableContentsInfo() const;
78
79
    bool isContentCreator() const;
80
81
private:
82
    ContentType   m_eType;
83
    OUString m_aContentType;
84
    OUString m_aTitle;
85
};
86
87
88
class Content : public ::ucbhelper::ContentImplHelper,
89
                public css::ucb::XContentCreator
90
{
91
    enum ContentState { TRANSIENT,  // created via createNewContent,
92
                                        // but did not process "insert" yet
93
                        PERSISTENT, // processed "insert"
94
                        DEAD        // processed "delete" / document was closed
95
                      };
96
97
    ContentProperties m_aProps;
98
    ContentState      m_eState;
99
    ContentProvider*  m_pProvider;
100
101
private:
102
    Content( const css::uno::Reference< css::uno::XComponentContext >& rxContext,
103
             ContentProvider* pProvider,
104
             const css::uno::Reference< css::ucb::XContentIdentifier >& Identifier,
105
            ContentProperties aProps );
106
    Content( const css::uno::Reference< css::uno::XComponentContext >& rxContext,
107
             ContentProvider* pProvider,
108
             const css::uno::Reference< css::ucb::XContentIdentifier >& Identifier,
109
             const css::ucb::ContentInfo& Info );
110
111
    virtual css::uno::Sequence< css::beans::Property >
112
    getProperties( const css::uno::Reference< css::ucb::XCommandEnvironment > & xEnv ) override;
113
    virtual css::uno::Sequence< css::ucb::CommandInfo >
114
    getCommands( const css::uno::Reference< css::ucb::XCommandEnvironment > & xEnv ) override;
115
    virtual OUString getParentURL() override;
116
117
    static bool hasData( ContentProvider const * pProvider, const Uri & rUri );
118
0
    bool hasData( const Uri & rUri ) const { return hasData( m_pProvider, rUri ); }
119
120
    static bool loadData( ContentProvider const * pProvider,
121
                          const Uri & rUri,
122
                          ContentProperties& rProps );
123
    /// @throws css::ucb::CommandFailedException
124
    /// @throws css::task::DocumentPasswordRequest
125
    /// @throws css::uno::RuntimeException
126
    bool storeData( const css::uno::Reference< css::io::XInputStream >& xData,
127
                    const css::uno::Reference< css::ucb::XCommandEnvironment >& xEnv );
128
    void renameData( const css::uno::Reference< css::ucb::XContentIdentifier >& xOldId,
129
                     const css::uno::Reference< css::ucb::XContentIdentifier >& xNewId );
130
    bool removeData();
131
132
    bool copyData( const Uri & rSourceUri, const OUString & rNewName );
133
134
    css::uno::Reference< css::ucb::XContentIdentifier >
135
    makeNewIdentifier( const OUString& rTitle );
136
137
    typedef rtl::Reference< Content > ContentRef;
138
    typedef std::vector< ContentRef > ContentRefList;
139
    void queryChildren( ContentRefList& rChildren );
140
141
    bool exchangeIdentity(
142
                const css::uno::Reference< css::ucb::XContentIdentifier >& xNewId );
143
144
    css::uno::Reference< css::sdbc::XRow >
145
    getPropertyValues( const css::uno::Sequence< css::beans::Property >& rProperties );
146
    css::uno::Sequence< css::uno::Any >
147
    /// @throws css::uno::Exception
148
    setPropertyValues(
149
            const css::uno::Sequence< css::beans::PropertyValue >& rValues,
150
            const css::uno::Reference< css::ucb::XCommandEnvironment > & xEnv );
151
152
    /// @throws css::uno::Exception
153
    css::uno::Any
154
    open( const css::ucb::OpenCommandArgument2& rArg,
155
          const css::uno::Reference< css::ucb::XCommandEnvironment >& xEnv );
156
157
    /// @throws css::uno::Exception
158
    void insert( const css::uno::Reference< css::io::XInputStream >& xData,
159
                 sal_Int32 nNameClashResolve,
160
                 const css::uno::Reference< css::ucb::XCommandEnvironment > & xEnv );
161
162
    /// @throws css::uno::Exception
163
    void destroy( bool bDeletePhysical,
164
                  const css::uno::Reference< css::ucb::XCommandEnvironment > & xEnv );
165
166
    /// @throws css::uno::Exception
167
    void transfer( const css::ucb::TransferInfo& rInfo,
168
                   const css::uno::Reference< css::ucb::XCommandEnvironment > & xEnv );
169
170
    static css::uno::Reference< css::sdbc::XRow >
171
    getPropertyValues( const css::uno::Reference< css::uno::XComponentContext >& rxContext,
172
                       const css::uno::Sequence< css::beans::Property >& rProperties,
173
                       const ContentProperties& rData,
174
                       ContentProvider* pProvider,
175
                       const OUString& rContentId );
176
177
178
    static bool commitStorage(
179
        const css::uno::Reference< css::embed::XStorage > & xStorage );
180
181
    static bool closeOutputStream(
182
        const css::uno::Reference< css::io::XOutputStream > & xOut );
183
184
    /// @throws css::ucb::CommandFailedException
185
    /// @throws css::task::DocumentPasswordRequest
186
    /// @throws css::uno::RuntimeException
187
    css::uno::Reference< css::io::XInputStream >
188
    getInputStream( const css::uno::Reference< css::ucb::XCommandEnvironment > & xEnv );
189
190
    /// @throws css::ucb::CommandFailedException
191
    /// @throws css::task::DocumentPasswordRequest
192
    /// @throws css::uno::RuntimeException
193
    css::uno::Reference< css::io::XOutputStream >
194
    getTruncatedOutputStream(
195
        const css::uno::Reference< css::ucb::XCommandEnvironment > & xEnv );
196
197
    css::uno::Reference< css::ucb::XContent >
198
    queryChildContent( std::u16string_view rRelativeChildUri );
199
200
    /// @throws css::ucb::CommandFailedException
201
    /// @throws css::task::DocumentPasswordRequest
202
    /// @throws css::uno::RuntimeException
203
    css::uno::Reference< css::io::XStream >
204
    getStream( const css::uno::Reference< css::ucb::XCommandEnvironment > & xEnv );
205
206
public:
207
    // Create existing content. Fail, if not already exists.
208
    static rtl::Reference<Content> create(
209
            const css::uno::Reference< css::uno::XComponentContext >& rxContext,
210
            ContentProvider* pProvider,
211
            const css::uno::Reference< css::ucb::XContentIdentifier >& Identifier );
212
213
    // Create new content. Fail, if already exists.
214
    static rtl::Reference<Content> create(
215
            const css::uno::Reference< css::uno::XComponentContext >& rxContext,
216
            ContentProvider* pProvider,
217
            const css::uno::Reference< css::ucb::XContentIdentifier >& Identifier,
218
            const css::ucb::ContentInfo& Info );
219
220
    virtual ~Content() override;
221
222
    // XInterface
223
    virtual css::uno::Any SAL_CALL queryInterface( const css::uno::Type & rType ) override;
224
    virtual void SAL_CALL acquire()
225
        noexcept override;
226
    virtual void SAL_CALL release()
227
        noexcept override;
228
229
    // XTypeProvider
230
    virtual css::uno::Sequence< sal_Int8 > SAL_CALL getImplementationId() override;
231
    virtual css::uno::Sequence< css::uno::Type > SAL_CALL getTypes() override;
232
233
    // XServiceInfo
234
    virtual OUString SAL_CALL
235
    getImplementationName() override;
236
    virtual css::uno::Sequence< OUString > SAL_CALL
237
    getSupportedServiceNames() override;
238
239
    // XContent
240
    virtual OUString SAL_CALL
241
    getContentType() override;
242
    virtual css::uno::Reference< css::ucb::XContentIdentifier > SAL_CALL
243
    getIdentifier() override;
244
245
    // XCommandProcessor
246
    virtual css::uno::Any SAL_CALL
247
    execute( const css::ucb::Command& aCommand,
248
             sal_Int32 CommandId,
249
             const css::uno::Reference< css::ucb::XCommandEnvironment >& Environment ) override;
250
    virtual void SAL_CALL
251
    abort( sal_Int32 CommandId ) override;
252
253
254
    // Additional interfaces
255
256
257
    // XContentCreator
258
    virtual css::uno::Sequence< css::ucb::ContentInfo > SAL_CALL
259
    queryCreatableContentsInfo() override;
260
    virtual css::uno::Reference< css::ucb::XContent > SAL_CALL
261
    createNewContent( const css::ucb::ContentInfo& Info ) override;
262
263
264
    // Non-interface methods.
265
266
267
    static css::uno::Reference< css::sdbc::XRow >
268
    getPropertyValues( const css::uno::Reference< css::uno::XComponentContext >& rxContext,
269
                       const css::uno::Sequence< css::beans::Property >& rProperties,
270
                       ContentProvider* pProvider,
271
                       const OUString& rContentId );
272
273
    void notifyDocumentClosed();
274
    void notifyChildRemoved( std::u16string_view rRelativeChildUri );
275
    void notifyChildInserted( std::u16string_view rRelativeChildUri );
276
277
    rtl::Reference< ContentProvider > getContentProvider() const
278
0
    { return rtl::Reference< ContentProvider >( m_pProvider ); }
279
};
280
281
} // namespace tdoc_ucp
282
283
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */