*/
class Customizable : public Configurable {
public:
- virtual ~Customizable() {}
+ ~Customizable() override {}
// Returns the name of this class of Customizable
virtual const char* Name() const = 0;
// potential names (e.g. "PosixEnv", "DefaultEnv") may also wish to override
// this method.
//
+ // Note that IsInstanceOf only uses the "is-a" relationship and not "has-a".
+ // Wrapped classes that have an Inner "has-a" should not be returned.
+ //
// @param name The name of the instance to find.
// Returns true if the class is an instance of the input name.
virtual bool IsInstanceOf(const std::string& name) const {
- return name == Name();
+ if (name.empty()) {
+ return false;
+ } else if (name == Name()) {
+ return true;
+ } else {
+ const char* nickname = NickName();
+ if (nickname != nullptr && name == nickname) {
+ return true;
+ } else {
+ return false;
+ }
+ }
+ }
+
+ const void* GetOptionsPtr(const std::string& name) const override {
+ const void* ptr = Configurable::GetOptionsPtr(name);
+ if (ptr != nullptr) {
+ return ptr;
+ } else {
+ const auto inner = Inner();
+ if (inner != nullptr) {
+ return inner->GetOptionsPtr(name);
+ } else {
+ return nullptr;
+ }
+ }
}
// Returns the named instance of the Customizable as a T*, or nullptr if not
- // found. This method uses IsInstanceOf to find the appropriate class instance
- // and then casts it to the expected return type.
+ // found. This method uses IsInstanceOf/Inner to find the appropriate class
+ // instance and then casts it to the expected return type.
template <typename T>
const T* CheckedCast() const {
if (IsInstanceOf(T::kClassName())) {
return static_cast<const T*>(this);
} else {
- return nullptr;
+ const auto inner = Inner();
+ if (inner != nullptr) {
+ return inner->CheckedCast<T>();
+ } else {
+ return nullptr;
+ }
}
}
if (IsInstanceOf(T::kClassName())) {
return static_cast<T*>(this);
} else {
- return nullptr;
+ auto inner = const_cast<Customizable*>(Inner());
+ if (inner != nullptr) {
+ return inner->CheckedCast<T>();
+ } else {
+ return nullptr;
+ }
}
}
// @see Configurable::GetOption for more details
Status GetOption(const ConfigOptions& config_options, const std::string& name,
std::string* value) const override;
-
#endif // ROCKSDB_LITE
+ // Helper method for getting for parsing the opt_value into the corresponding
+ // options for use in potentially creating a new Customizable object (this
+ // method is primarily a support method for LoadSharedObject et al for new
+ // Customizable objects). The opt_value may be either name-value pairs
+ // separated by ";" (a=b; c=d), or a simple name (a). In order to create a new
+ // Customizable, the ID is determined by:
+ // - If the value is a simple name (e.g. "BlockBasedTable"), the id is this
+ // name;
+ // - Otherwise, if there is a "id=value", the id is set to "value"
+ // - Otherwise, if the input customizable is not null, custom->GetId is used
+ // - Otherwise, an error is returned.
+ //
+ // If the opt_value is name-value pairs, these pairs will be returned in
+ // options (without the id pair). If the ID being returned matches the ID of
+ // the input custom object, then the options from the input object will also
+ // be added to the returned options.
+ //
+ // This method returns non-OK if the ID could not be found, or if the
+ // opt_value could not be parsed into name-value pairs.
+ static Status GetOptionsMap(
+ const ConfigOptions& config_options, const Customizable* custom,
+ const std::string& opt_value, std::string* id,
+ std::unordered_map<std::string, std::string>* options);
+
+ // Helper method to configure a new object with the supplied options.
+ // If the object is not null and invoke_prepare_options=true, the object
+ // will be configured and prepared.
+ // Returns success if the object is properly configured and (optionally)
+ // prepared Returns InvalidArgument if the object is nullptr and there are
+ // options in the map Returns the result of the ConfigureFromMap or
+ // PrepareOptions
+ static Status ConfigureNewObject(
+ const ConfigOptions& config_options, Customizable* object,
+ const std::unordered_map<std::string, std::string>& options);
+
+ // Returns the inner class when a Customizable implements a has-a (wrapped)
+ // relationship. Derived classes that implement a has-a must override this
+ // method in order to get CheckedCast to function properly.
+ virtual const Customizable* Inner() const { return nullptr; }
+
protected:
+ // Generates a ID specific for this instance of the customizable.
+ // The unique ID is of the form <name>:<addr>#pid, where:
+ // - name is the Name() of this object;
+ // - addr is the memory address of this object;
+ // - pid is the process ID of this process ID for this process.
+ // Note that if obj1 and obj2 have the same unique IDs, they must be the
+ // same. However, if an object is deleted and recreated, it may have the
+ // same unique ID as a predecessor
+ //
+ // This method is useful for objects (especially ManagedObjects) that
+ // wish to generate an ID that is specific for this instance and wish to
+ // override the GetId() method.
+ std::string GenerateIndividualId() const;
+
+ // Some classes have both a class name (e.g. PutOperator) and a nickname
+ // (e.g. put). Classes can override this method to return a
+ // nickname. Nicknames can be used by InstanceOf and object creation.
+ virtual const char* NickName() const { return ""; }
// Given a name (e.g. rocksdb.my.type.opt), returns the short name (opt)
std::string GetOptionName(const std::string& long_name) const override;
#ifndef ROCKSDB_LITE