/usr/include/libcmis-0.4/libcmis/document.hxx is in libcmis-dev 0.4.1-7.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | /* libcmis
* Version: MPL 1.1 / GPLv2+ / LGPLv2+
*
* The contents of this file are subject to the Mozilla Public License Version
* 1.1 (the "License"); you may not use this file except in compliance with
* the License or as specified alternatively below. You may obtain a copy of
* the License at http://www.mozilla.org/MPL/
*
* Software distributed under the License is distributed on an "AS IS" basis,
* WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
* for the specific language governing rights and limitations under the
* License.
*
* Major Contributor(s):
* Copyright (C) 2011 SUSE <cbosdonnat@suse.com>
*
*
* All Rights Reserved.
*
* For minor contributions see the git repository.
*
* Alternatively, the contents of this file may be used under the terms of
* either the GNU General Public License Version 2 or later (the "GPLv2+"), or
* the GNU Lesser General Public License Version 2 or later (the "LGPLv2+"),
* in which case the provisions of the GPLv2+ or the LGPLv2+ are applicable
* instead of those above.
*/
#ifndef _DOCUMENT_HXX_
#define _DOCUMENT_HXX_
#include <iostream>
#include <string>
#include <vector>
#include <boost/shared_ptr.hpp>
#include "exception.hxx"
#include "object.hxx"
namespace libcmis
{
class Folder;
class Session;
/** Interface for a CMIS Document object.
*/
class Document : public virtual Object
{
public:
Document( Session* session ) : Object( session ) { }
virtual ~Document( ) { }
/** Get the folder parents for the document.
Note that an unfiled document will have no parent folder.
@return the parents folder if any.
*/
virtual std::vector< boost::shared_ptr< Folder > > getParents( ) throw ( Exception ) = 0;
/** Get the content stream without using a temporary file.
<p>The stream may not contain anything if there is
no content or if something wrong happened during the
download.</p>
@param streamId of the rendition
@return
An input stream to read the data from.
@throws Exception
if anything wrong happened during the file transfer.
In such a case, the content of the stream can't be
guaranteed.
*/
virtual boost::shared_ptr< std::istream > getContentStream( std::string streamId = std::string( ) )
throw ( Exception ) = 0;
/** Set or replace the content stream of the document.
@param is the output stream containing the new data for the content stream
@param contentType the mime-type of the new content stream
@param filename the filename to set for the file
@param overwrite if set to false, don't overwrite the content stream if one is already set.
@throw Exception if anything happens during the upload like a wrong authentication,
no rights to set the stream, server doesn't have the ContentStreamUpdatability
capability.
*/
virtual void setContentStream( boost::shared_ptr< std::ostream > os, std::string contentType,
std::string filename, bool overwrite = true ) throw ( Exception ) = 0;
/** Get the content mime type.
*/
virtual std::string getContentType( );
/** Get the content stream filename.
*/
virtual std::string getContentFilename( );
/** Get the content length in bytes.
*/
virtual long getContentLength( );
/** Checks out the document and returns the object corresponding to the
created Private Working Copy.
\return the Private Working Copy document
*/
virtual boost::shared_ptr< Document > checkOut( ) throw ( Exception ) = 0;
/** Cancels the checkout if the document is a private working copy, or
throws an exception.
*/
virtual void cancelCheckout( ) throw ( Exception ) = 0;
/** Check in the private working copy and create a new version or throw
an exception.
The current object will be updated to reflect the changes performed
on the server side.
\param isMajor defines it the version to create is a major or minor one
\param comment contains the checkin comment
\param properties the properties to set the new version
\param stream the content stream to set for the new version
\param contentType the mime type of the stream to set
\return the document with the new version
*/
virtual boost::shared_ptr< Document > checkIn( bool isMajor, std::string comment,
const std::map< std::string, PropertyPtr >& properties,
boost::shared_ptr< std::ostream > stream,
std::string contentType, std::string fileName ) throw ( Exception ) = 0;
virtual std::vector< boost::shared_ptr< Document > > getAllVersions( ) throw ( Exception ) = 0;
// virtual methods form Object
virtual std::vector< std::string > getPaths( );
virtual std::string toString( );
};
typedef ::boost::shared_ptr< Document > DocumentPtr;
}
#endif
|