// Copyright 2013 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef COMPONENTS_POLICY_CORE_COMMON_SCHEMA_INTERNAL_H_
#define COMPONENTS_POLICY_CORE_COMMON_SCHEMA_INTERNAL_H_
#include "base/values.h"
#include "components/policy/policy_export.h"
namespace policy {
namespace internal {
// These types are used internally by the SchemaOwner parser, and by the
// compile-time code generator. They shouldn't be used directly.
// Represents the type of one policy, or an item of a list policy, or a
// property of a map policy.
struct POLICY_EXPORT SchemaNode {
// The policy type.
base::Value::Type type;
// If |type| is TYPE_DICTIONARY then |extra| is an offset into
// SchemaData::properties_nodes that indexes the PropertiesNode describing
// the entries of this dictionary.
//
// If |type| is TYPE_LIST then |extra| is an offset into
// SchemaData::schema_nodes that indexes the SchemaNode describing the items
// of this list.
//
// If |type| is TYPE_INTEGER or TYPE_STRING, and contains corresponding
// restriction (enumeration of possible values, or range for integer), then
// |extra| is an offset into SchemaData::restriction_nodes that indexes the
// RestrictionNode describing the restriction on the value.
//
// Otherwise extra is -1 and is invalid.
int extra;
};
// Represents an entry of a map policy.
struct POLICY_EXPORT PropertyNode {
// The entry key.
const char* key;
// An offset into SchemaData::schema_nodes that indexes the SchemaNode
// describing the structure of this key.
int schema;
};
// Represents the list of keys of a map policy.
struct POLICY_EXPORT PropertiesNode {
// An offset into SchemaData::property_nodes that indexes the PropertyNode
// describing the first known property of this map policy.
int begin;
// An offset into SchemaData::property_nodes that indexes the PropertyNode
// right beyond the last known property of this map policy.
//
// If |begin == end| then the map policy that this PropertiesNode corresponds
// to does not have known properties.
//
// Note that the range [begin, end) is sorted by PropertyNode::key, so that
// properties can be looked up by binary searching in the range.
int end;
// If this map policy supports keys with any value (besides the well-known
// values described in the range [begin, end)) then |additional| is an offset
// into SchemaData::schema_nodes that indexes the SchemaNode describing the
// structure of the values for those keys. Otherwise |additional| is -1 and
// is invalid.
int additional;
};
// Represents the restriction on TYPE_INTEGER or TYPE_STRING instance of
// base::Value.
union POLICY_EXPORT RestrictionNode {
// Offsets into SchemaData::int_enums or SchemaData::string_enums, the
// entry of which describes the enumeration of all possible values of
// corresponding integer or string value. |offset_begin| being strictly less
// than |offset_end| is assumed.
struct EnumerationRestriction {
int offset_begin;
int offset_end;
} enumeration_restriction;
// For integer type only, represents that all values between |min_value|
// and |max_value| can be choosen. Note that integer type in base::Value
// is bounded, so this can also be used if only one of |min_value| and
// |max_value| is stated. |max_value| being greater or equal to |min_value|
// is assumed.
struct RangedRestriction {
int max_value;
int min_value;
} ranged_restriction;
};
// Contains arrays of related nodes. All of the offsets in these nodes reference
// other nodes in these arrays.
struct POLICY_EXPORT SchemaData {
const SchemaNode* schema_nodes;
const PropertyNode* property_nodes;
const PropertiesNode* properties_nodes;
const RestrictionNode* restriction_nodes;
const int* int_enums;
const char** string_enums;
};
} // namespace internal
} // namespace policy
#endif // COMPONENTS_POLICY_CORE_COMMON_SCHEMA_INTERNAL_H_