mirror of
https://github.com/chromium/crashpad.git
synced 2024-12-27 15:32:10 +08:00
0a4ea0b52d
All minidump objects now own their all of their children, rather than having them maintain weak pointers and requiring callers to maintain ownership. The only weak object in the entire tree now is the “extra memory” added to a MinidumpMemoryListWriter by its AddExtraMemory() method. Extra memory aliases objects owned elsewhere in the tree, typically by a MinidumpThreadWriter as stack memory. Non-“extra” memory added to a MinidumpMemoryListWriter by its AddMemory() method is strongly owned. Many objects are now deleted through base pointers, and in those cases, the base classes now have public virtual destructors. The ultimate base, MinidumpWritable, is still protected to guard against direct instantiation and deletion, and thus its destructor does not need to be virtual. This updates mini_chromium to eeb3b6a4f020 specifically for that revision, which includes necessary updates to scoped_ptr. It also picks up: eeb3b6a4f020 Update base/move.h and base/memory/scoped_ptr.h to match 67ad2efafaba More porting to Windows be27a006421e AUTHORS: Fix link post-git migration flag day. 05f5b1503230 Add codereview.settings to mini_chromium. a32c2b199811 Beginnings of Windows support in mini_chromium TEST=minidump_test R=rsesek@chromium.org Review URL: https://codereview.chromium.org/674153002
127 lines
4.5 KiB
C++
127 lines
4.5 KiB
C++
// Copyright 2014 The Crashpad Authors. All rights reserved.
|
||
//
|
||
// Licensed under the Apache License, Version 2.0 (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.apache.org/licenses/LICENSE-2.0
|
||
//
|
||
// Unless required by applicable law or agreed to in writing, software
|
||
// distributed under the License is distributed on an "AS IS" BASIS,
|
||
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||
// See the License for the specific language governing permissions and
|
||
// limitations under the License.
|
||
|
||
#ifndef CRASHPAD_MINIDUMP_MINIDUMP_SIMPLE_STRING_DICTIONARY_WRITER_H_
|
||
#define CRASHPAD_MINIDUMP_MINIDUMP_SIMPLE_STRING_DICTIONARY_WRITER_H_
|
||
|
||
#include <sys/types.h>
|
||
|
||
#include <string>
|
||
#include <map>
|
||
#include <vector>
|
||
|
||
#include "base/basictypes.h"
|
||
#include "base/memory/scoped_ptr.h"
|
||
#include "minidump/minidump_extensions.h"
|
||
#include "minidump/minidump_string_writer.h"
|
||
#include "minidump/minidump_writable.h"
|
||
|
||
namespace crashpad {
|
||
|
||
//! \brief The writer for a MinidumpSimpleStringDictionaryEntry object in a
|
||
//! minidump file.
|
||
//!
|
||
//! Because MinidumpSimpleStringDictionaryEntry objects only appear as elements
|
||
//! of MinidumpSimpleStringDictionary objects, this class does not write any
|
||
//! data on its own. It makes its MinidumpSimpleStringDictionaryEntry data
|
||
//! available to its MinidumpSimpleStringDictionaryWriter parent, which writes
|
||
//! it as part of a MinidumpSimpleStringDictionary.
|
||
class MinidumpSimpleStringDictionaryEntryWriter final
|
||
: public internal::MinidumpWritable {
|
||
public:
|
||
MinidumpSimpleStringDictionaryEntryWriter();
|
||
~MinidumpSimpleStringDictionaryEntryWriter() override;
|
||
|
||
//! \brief Returns a MinidumpSimpleStringDictionaryEntry referencing this
|
||
//! object’s data.
|
||
//!
|
||
//! This method is expected to be called by a
|
||
//! MinidumpSimpleStringDictionaryWriter in order to obtain a
|
||
//! MinidumpSimpleStringDictionaryEntry to include in its list.
|
||
//!
|
||
//! \note Valid in #kStateWritable.
|
||
const MinidumpSimpleStringDictionaryEntry*
|
||
MinidumpSimpleStringDictionaryEntry() const;
|
||
|
||
//! \brief Sets the strings to be written as the entry object’s key and value.
|
||
//!
|
||
//! \note Valid in #kStateMutable.
|
||
void SetKeyValue(const std::string& key, const std::string& value);
|
||
|
||
//! \brief Retrieves the key to be written.
|
||
//!
|
||
//! \note Valid in any state.
|
||
const std::string& Key() const { return key_.UTF8(); }
|
||
|
||
protected:
|
||
// MinidumpWritable:
|
||
|
||
bool Freeze() override;
|
||
size_t SizeOfObject() override;
|
||
std::vector<MinidumpWritable*> Children() override;
|
||
bool WriteObject(FileWriterInterface* file_writer) override;
|
||
|
||
private:
|
||
struct MinidumpSimpleStringDictionaryEntry entry_;
|
||
internal::MinidumpUTF8StringWriter key_;
|
||
internal::MinidumpUTF8StringWriter value_;
|
||
|
||
DISALLOW_COPY_AND_ASSIGN(MinidumpSimpleStringDictionaryEntryWriter);
|
||
};
|
||
|
||
//! \brief The writer for a MinidumpSimpleStringDictionary object in a minidump
|
||
//! file, containing a list of MinidumpSimpleStringDictionaryEntry objects.
|
||
//!
|
||
//! Because this class writes a representatin of a dictionary, the order of
|
||
//! entries is insignificant. Entries may be written in any order.
|
||
class MinidumpSimpleStringDictionaryWriter final
|
||
: public internal::MinidumpWritable {
|
||
public:
|
||
MinidumpSimpleStringDictionaryWriter();
|
||
~MinidumpSimpleStringDictionaryWriter() override;
|
||
|
||
//! \brief Adds a MinidumpSimpleStringDictionaryEntryWriter to the
|
||
//! MinidumpSimpleStringDictionary.
|
||
//!
|
||
//! This object takes ownership of \a entry and becomes its parent in the
|
||
//! overall tree of internal::MinidumpWritable objects.
|
||
//!
|
||
//! If the key contained in \a entry duplicates the key of an entry already
|
||
//! present in the MinidumpSimpleStringDictionary, the new \a entry will
|
||
//! replace the previous one.
|
||
//!
|
||
//! \note Valid in #kStateMutable.
|
||
void AddEntry(scoped_ptr<MinidumpSimpleStringDictionaryEntryWriter> entry);
|
||
|
||
protected:
|
||
// MinidumpWritable:
|
||
|
||
bool Freeze() override;
|
||
size_t SizeOfObject() override;
|
||
std::vector<MinidumpWritable*> Children() override;
|
||
bool WriteObject(FileWriterInterface* file_writer) override;
|
||
|
||
private:
|
||
MinidumpSimpleStringDictionary simple_string_dictionary_base_;
|
||
|
||
// This object owns the MinidumpSimpleStringDictionaryEntryWriter objects.
|
||
std::map<std::string, MinidumpSimpleStringDictionaryEntryWriter*> entries_;
|
||
|
||
DISALLOW_COPY_AND_ASSIGN(MinidumpSimpleStringDictionaryWriter);
|
||
};
|
||
|
||
} // namespace crashpad
|
||
|
||
#endif // CRASHPAD_MINIDUMP_MINIDUMP_SIMPLE_STRING_DICTIONARY_WRITER_H_
|